@saltify/milky-generator 0.2.1 → 0.3.1

package/README.md

@@ -16,14 +16,10 @@ milkygen
 
 ## 命令
 
-### 查看可用 generator
-
-```
-milkygen list
-```
-
 ### 生成内容
 
+> 别名：`g`, `gen`
+
 ```
 milkygen generate <generator> [--output <file>] [--version <version>]
 ```
@@ -44,6 +40,21 @@ milkygen generate rust/serde --version 1.2.1
   - `latest`: 默认值，使用 npm `latest` 标签对应版本的协议定义。
   - 具体版本号: **只能使用 `1.2.1` 及以上版本**，因为协议定义在 `1.2.1` 版本中才正式发布。
   - `local`: 使用当前包依赖中的本地协议定义。不建议使用，因为可能与发布版本不一致。
+- `--cdn`: 指定从哪个 CDN 获取协议定义，默认为 `unpkg`。可用值请使用 `milkygen list-cdns` 命令查看。
+
+### 查看可用 generator
+
+> 别名：`l`
+
+```
+milkygen list
+```
+
+### 查看可用 CDN
+
+```
+milkygen list-cdns
+```
 
 ### 查看 CLI 版本
 

package/dist/cli.mjs

@@ -29461,7 +29461,7 @@ var import_cjs = (/* @__PURE__ */ __commonJSMin(((exports) => {
 		}
 	});
 })))();
-var version = "0.2.1";
+var version = "0.3.1";
 var description = "Milky codegen CLI";
 //#endregion
 //#region src/cli.ts
@@ -29499,11 +29499,24 @@ const generators = [
 		generate: generateTypeScriptZodSpec
 	}
 ];
-async function resolveProtocolOfVersion(version) {
-	if (version === "latest") return await fetch("https://cdn.jsdelivr.net/npm/@saltify/milky-protocol/dist/protocol.json").then((res) => res.json());
-	else if (version === "local") return ir;
+const cdns = [
+	{
+		name: "unpkg",
+		generateUrl: (packageName, version) => `https://unpkg.com/${packageName}@${version}/dist/protocol.json`
+	},
+	{
+		name: "esmsh",
+		generateUrl: (packageName, version) => `https://esm.sh/${packageName}@${version}/dist/protocol.json`
+	},
+	{
+		name: "jsdelivr",
+		generateUrl: (packageName, version) => `https://cdn.jsdelivr.net/npm/${packageName}@${version}/dist/protocol.json`
+	}
+];
+async function resolveProtocolOfVersion(version, cdn) {
+	if (version === "local") return ir;
 	else {
-		const response = await fetch(`https://cdn.jsdelivr.net/npm/@saltify/milky-protocol@${version}/dist/protocol.json`);
+		const response = await fetch(cdn.generateUrl("@saltify/milky-protocol", version));
 		if (!response.ok) throw new Error(`Failed to fetch protocol of version ${version}: ${response.status} ${response.statusText}`);
 		return await response.json();
 	}
@@ -29518,25 +29531,33 @@ function serializeOutput(output) {
 	cmds: {
 		generate: (0, import_cjs.command)({
 			name: "generate",
+			aliases: ["g", "gen"],
 			description: "Generate a spec from Milky IR.",
 			args: {
 				generator: (0, import_cjs.positional)({
+					displayName: "generator",
 					type: import_cjs.string,
-					description: "The canonical name of the generator to run. Use \"list\" to see all available generators."
+					description: "Name of the generator to run. Use \"list\" for all available generators."
 				}),
 				output: (0, import_cjs.option)({
 					type: import_cjs.string,
 					long: "output",
 					short: "o",
-					description: "The output file path. If not specified, the generated spec will be printed to stdout.",
+					description: "The output file path. The generator writes to stdout if not provided.",
 					defaultValue: () => ""
 				}),
 				version: (0, import_cjs.option)({
 					type: import_cjs.string,
 					long: "version",
 					short: "v",
-					description: "The version of the Milky IR to use. If not specified, the latest version (the version published with `latest` tag on npm) will be used.",
+					description: "The version of the Milky IR to use. Latest stable version if not specified.",
 					defaultValue: () => "latest"
+				}),
+				cdn: (0, import_cjs.option)({
+					type: import_cjs.string,
+					long: "cdn",
+					description: `The CDN to fetch the protocol definition from. "${cdns[0].name}" if not specified.`,
+					defaultValue: () => cdns[0].name
 				})
 			},
 			handler: async (args) => {
@@ -29546,7 +29567,13 @@ function serializeOutput(output) {
 					console.error("Use \"milkygen list\" to see all available generators.");
 					process.exit(1);
 				}
-				const protocol = await resolveProtocolOfVersion(args.version);
+				const cdnSpec = cdns.find((c) => c.name === args.cdn);
+				if (!cdnSpec) {
+					console.error(`Unknown CDN: ${args.cdn}`);
+					console.error(`Use "milkygen list-cdns" to see all supported CDNs.`);
+					process.exit(1);
+				}
+				const protocol = await resolveProtocolOfVersion(args.version, cdnSpec);
 				const content = serializeOutput(await spec.generate(protocol));
 				if (args.output.length === 0) {
 					process.stdout.write(content);
@@ -29563,6 +29590,7 @@ function serializeOutput(output) {
 		}),
 		list: (0, import_cjs.command)({
 			name: "list",
+			aliases: ["l"],
 			description: "List all available generators.",
 			args: {},
 			handler: () => {
@@ -29572,8 +29600,20 @@ function serializeOutput(output) {
 				});
 			}
 		}),
+		"list-cdns": (0, import_cjs.command)({
+			name: "list-cdns",
+			description: "List all supported CDNs to fetch protocol definitions from.",
+			args: {},
+			handler: () => {
+				console.log("Supported CDNs:");
+				cdns.forEach((cdn) => {
+					console.log(`  - ${cdn.name}`);
+				});
+			}
+		}),
 		version: (0, import_cjs.command)({
 			name: "version",
+			aliases: ["v"],
 			description: "Print the version of milkygen.",
 			args: {},
 			handler: () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@saltify/milky-generator",
   "type": "module",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Milky codegen CLI",
   "bin": {
     "milkygen": "dist/cli.mjs"