feat: update SDK build process and add OpenAPI patch script

Author: elvisdragonmao

README.md

@@ -72,7 +72,17 @@ The output files will be in `tsp-output/schema/openapi.yaml`. You can preview us
 -   [Prism](https://prismjs.com/) - For API documentation preview and testing. Run `pnpm start` and open <http://localhost:4010>.
 -   [Yaak](https://yaak.app/) - Import the `yaak` folder.
 
-## Publish SDK
+## SDK
+
+### Build
+
+```bash
+pnpm compile
+pnpm generate:sdk
+pnpm build:sdk
+```
+
+### Publish
 
 ```bash
 git checkout main

README.zh.md

@@ -9,11 +9,6 @@ module.exports = {
 			enumGenerationType: "enum",
 			clean: true,
 			prettier: true
-		},
-		override: {
-			formData: {
-				file: "File"
-			}
 		}
 	}
 };

orval.config.js

@@ -7,13 +7,14 @@
 	"type": "module",
 	"packageManager": "pnpm@10.18.1+sha512.77a884a165cbba2d8d1c19e3b4880eee6d2fcabd0d879121e282196b80042351d5eb3ca0935fa599da1dc51265cc68816ad2bddd2a2de5ea9fdf92adbec7cd34",
 	"scripts": {
-		"build": "pnpm run format && pnpm run compile && pnpm run yaak",
+		"build": "pnpm run compile && pnpm run yaak",
 		"format": "tsp format **/*.tsp",
-		"compile": "tsp compile .",
+		"compile": "tsp compile . && node scripts/patch-openapi.js",
 		"clean": "rm -rf tsp-output yaak",
 		"start": "pnpm exec prism mock tsp-output/schema/openapi.1.0.0.yaml --port 4010 --host 0.0.0.0",
 		"yaak": "node scripts/generate-yaak.js",
-		"generate:sdk": "orval --config orval.config.js"
+		"generate:sdk": "orval --config orval.config.js",
+		"build:sdk": "pnpm --filter @nycu-sdc/core-system-sdk run build"
 	},
 	"devDependencies": {
 		"@stoplight/prism-cli": "^5.14.2",

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nycu-sdc/core-system-sdk",
-	"version": "0.1.3",
+	"version": "0.1.4",
 	"author": {
 		"name": "NYCU SDC",
 		"email": "contact@sdc.nycu.club",

packages/sdk/package.json

@@ -0,0 +1,28 @@
+import { readFileSync, writeFileSync } from "fs";
+import yaml from "js-yaml";
+
+const OPENAPI_PATH = "./tsp-output/schema/openapi.1.0.0.yaml";
+
+const spec = yaml.load(readFileSync(OPENAPI_PATH, "utf8"));
+
+// 1. 強制指定 requestBody 是 multipart
+const upload = spec.paths?.["/forms/{id}/cover"]?.post;
+
+if (upload?.requestBody) {
+	upload.requestBody.content = {
+		"multipart/form-data": upload.requestBody.content?.["application/json"] ?? upload.requestBody.content?.[Object.keys(upload.requestBody.content)[0]]
+	};
+}
+
+// 2. 強制指定 binary 欄位
+const schema = spec.components?.schemas?.["Forms.FormCoverUploadRequest"];
+
+if (schema?.properties?.coverImage) {
+	schema.properties.coverImage = {
+		type: "string",
+		format: "binary"
+	};
+}
+
+writeFileSync(OPENAPI_PATH, yaml.dump(spec, { lineWidth: -1 }), "utf8");
+console.log("😉 Patched OpenAPI spec successfully.");