@zhipu/zp-cli 0.0.0 → 0.0.2

package/dist/config-BZc9pg7J.mjs

@@ -0,0 +1,105 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createJiti } from "jiti";
+//#region src/utils/config.ts
+const CONFIG_FILE_PREFIX = "zpc.config";
+const SCHEMA_FILE_NAME = `${CONFIG_FILE_PREFIX}.schema.json`;
+const CONFIG_FORMATS = [
+	"ts",
+	"mts",
+	"cts",
+	"js",
+	"mjs",
+	"cjs",
+	"json"
+];
+function defineConfig(config) {
+	return config;
+}
+function isConfigFormat(value) {
+	return CONFIG_FORMATS.includes(value);
+}
+function configFileName(format) {
+	return `${CONFIG_FILE_PREFIX}.${format}`;
+}
+function templateFileName(format) {
+	return `${configFileName(format)}.template`;
+}
+const jiti = createJiti(import.meta.url);
+function listConfigFiles(dir) {
+	return CONFIG_FORMATS.map((format) => path.join(dir, configFileName(format))).filter((file) => fs.existsSync(file));
+}
+function findConfigFile(dir) {
+	return listConfigFiles(dir)[0];
+}
+async function loadConfig(dir) {
+	const file = findConfigFile(dir);
+	if (!file) throw new Error(`[config] 在 ${dir} 找不到 ${CONFIG_FILE_PREFIX}.{${CONFIG_FORMATS.join(",")}}，请先运行 zpc init`);
+	let loaded;
+	try {
+		loaded = await readConfigFile(file);
+	} catch (err) {
+		const message = err instanceof Error ? err.message : String(err);
+		throw new Error(`[config] 无法加载 ${file}: ${message}`);
+	}
+	return {
+		file,
+		config: validateConfig(loaded, file)
+	};
+}
+async function readConfigFile(file) {
+	if (file.endsWith(".json")) return JSON.parse(fs.readFileSync(file, "utf8"));
+	return await jiti.import(file, { default: true });
+}
+function validateConfig(config, source) {
+	if (!isPlainObject(config)) throw new Error(`[config] ${source} 必须导出一个对象`);
+	if (!isSafeName(config.projectName)) throw new Error(`[config] ${source} 缺少合法 projectName`);
+	const api = optionalAppList(config.api, "api", source);
+	const web = optionalAppList(config.web, "web", source);
+	if (api.length === 0 && web.length === 0) throw new Error(`[config] ${source} 中没有 api / web 项目`);
+	return {
+		projectName: config.projectName,
+		...api.length ? { api } : {},
+		...web.length ? { web } : {}
+	};
+}
+function optionalAppList(value, kind, source) {
+	if (value == null) return [];
+	if (!Array.isArray(value)) throw new Error(`[config] ${source} 中 ${kind} 必须是数组`);
+	return value.map((item, index) => parseAppConfig(item, `${source} ${kind}[${index}]`));
+}
+function parseAppConfig(item, label) {
+	if (!isPlainObject(item)) throw new Error(`[config] ${label} 必须是对象`);
+	if (typeof item.path !== "string" || item.path.trim() === "") throw new Error(`[config] ${label} 缺少 path`);
+	if (!isSafeName(item.name)) throw new Error(`[config] ${label} 缺少合法 name`);
+	const parsed = {
+		path: item.path,
+		name: item.name
+	};
+	if (item.proxy != null) {
+		if (typeof item.proxy !== "string") throw new Error(`[config] ${label} 的 proxy 必须是字符串`);
+		parsed.proxy = item.proxy;
+	}
+	if (item.buildEnv != null) parsed.buildEnv = parseEnvMap(item.buildEnv, `${label} buildEnv`);
+	if (item.env != null) parsed.env = parseEnvMap(item.env, `${label} env`);
+	return parsed;
+}
+function parseEnvMap(value, label) {
+	if (!isPlainObject(value)) throw new Error(`[config] ${label} 必须是对象`);
+	const out = {};
+	for (const [key, entry] of Object.entries(value)) {
+		if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) throw new Error(`[config] ${label} 含非法环境变量名: ${key}`);
+		if (typeof entry !== "string" && typeof entry !== "number" && typeof entry !== "boolean") throw new Error(`[config] ${label}.${key} 必须是 string / number / boolean`);
+		out[key] = entry;
+	}
+	return out;
+}
+function isPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isSafeName(name) {
+	if (typeof name !== "string" || name === "" || name === "." || name === "..") return false;
+	return !name.includes("/") && !name.includes("\\") && !name.includes(String.fromCharCode(0));
+}
+//#endregion
+export { findConfigFile as a, loadConfig as c, defineConfig as i, templateFileName as l, SCHEMA_FILE_NAME as n, isConfigFormat as o, configFileName as r, listConfigFiles as s, CONFIG_FORMATS as t };

package/dist/index.d.mts

@@ -1,4 +1,24 @@
-//#region src/index.d.ts
-declare function fn(): string;
+//#region src/utils/config.d.ts
+declare const CONFIG_FORMATS: readonly ["ts", "mts", "cts", "js", "mjs", "cjs", "json"];
+type ConfigFormat = (typeof CONFIG_FORMATS)[number];
+type ZpcEnvMap = Record<string, string | number | boolean>;
+interface ZpcAppConfig {
+  /** 相对项目根的源码目录 */
+  path: string;
+  /** 打包 / 部署目录名 */
+  name: string;
+  /** api 对外路径前缀；web 未写 buildEnv.VITE_API_PROXY 时也可作回退 */
+  proxy?: string;
+  /** 仅构建期注入 */
+  buildEnv?: ZpcEnvMap;
+  /** 仅运行时注入（pm2） */
+  env?: ZpcEnvMap;
+}
+interface ZpcConfig {
+  projectName: string;
+  api?: ZpcAppConfig[];
+  web?: ZpcAppConfig[];
+}
+declare function defineConfig(config: ZpcConfig): ZpcConfig;
 //#endregion
-export { fn };
+export { type ConfigFormat, type ZpcAppConfig, type ZpcConfig, type ZpcEnvMap, defineConfig };

package/dist/index.mjs

@@ -1,6 +1,2 @@
-//#region src/index.ts
-function fn() {
-	return "Hello, tsdown!";
-}
-//#endregion
-export { fn };
+import { i as defineConfig } from "./config-BZc9pg7J.mjs";
+export { defineConfig };

package/package.json

@@ -1,37 +1,92 @@
 {
   "name": "@zhipu/zp-cli",
-  "version": "0.0.0",
+  "version": "0.0.2",
   "description": "内部单命令部署工具",
   "bin": {
     "zpc": "./dist/cli.mjs"
   },
   "files": [
-    "dist"
+    "dist",
+    "src/templates"
   ],
   "type": "module",
   "exports": {
     ".": "./dist/index.mjs",
-    "./cli": "./dist/cli.mjs",
     "./package.json": "./package.json"
   },
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "@commander-js/extra-typings": "^15.0.0",
+    "@vue-tui/components": "^0.3.0",
+    "@vue-tui/runtime": "^0.3.0",
+    "chalk": "^6.0.0",
+    "commander": "^15.0.0",
+    "jiti": "^2.7.0",
+    "strip-ansi": "^7.2.0",
+    "vue": "^3.5.41"
+  },
   "devDependencies": {
     "@types/node": "^26.1.1",
+    "@vitejs/plugin-vue": "^6.0.8",
+    "@vue-tui/testing": "^0.3.0",
     "bumpp": "^11.1.0",
     "oxfmt": "^0.64.0",
     "typescript": "^7.0.2",
+    "unplugin-vue": "^7.2.0",
     "vite": "npm:@voidzero-dev/vite-plus-core@0.2.6",
-    "vite-plus": "0.2.6"
+    "vite-plus": "0.2.6",
+    "node": "runtime:25.9.0"
   },
   "devEngines": {
     "packageManager": {
       "name": "pnpm",
       "version": "11.22.0",
       "onFail": "download"
+    },
+    "runtime": {
+      "name": "node",
+      "version": "25.9.0",
+      "onFail": "download"
     }
   },
+  "inlinedDependencies": {
+    "@alcalzone/ansi-tokenize": "0.3.0",
+    "@babel/parser": "7.29.8",
+    "@commander-js/extra-typings": "15.0.0",
+    "@vue-tui/components": "0.3.0",
+    "@vue-tui/runtime": "0.3.0",
+    "@vue/compiler-core": "3.5.41",
+    "@vue/compiler-dom": "3.5.41",
+    "@vue/reactivity": "3.5.41",
+    "@vue/runtime-core": "3.5.41",
+    "@vue/runtime-dom": "3.5.41",
+    "@vue/shared": "3.5.41",
+    "ansi-escapes": "7.3.0",
+    "ansi-styles": "6.2.3",
+    "chalk": [
+      "5.6.2",
+      "6.0.0"
+    ],
+    "cli-boxes": "3.0.0",
+    "cli-truncate": "6.1.1",
+    "commander": "15.0.0",
+    "entities": "7.0.1",
+    "environment": "1.1.0",
+    "estree-walker": "2.0.2",
+    "get-east-asian-width": "1.6.0",
+    "is-fullwidth-code-point": "5.1.0",
+    "jiti": "2.7.0",
+    "patch-console": "2.0.0",
+    "signal-exit": "4.1.0",
+    "slice-ansi": "9.0.0",
+    "source-map-js": "1.2.1",
+    "string-width": "8.2.2",
+    "vue": "3.5.41",
+    "wrap-ansi": "10.0.1",
+    "yoga-layout": "3.2.1"
+  },
   "scripts": {
     "build": "vp pack",
     "dev": "vp pack --watch",

package/src/templates/nginx-proxy.conf.template

@@ -0,0 +1,16 @@
+# generated by zpc deploy
+# owned-by: {{ownerId}}
+location {{loc}} {
+    proxy_pass http://127.0.0.1:{{port}}/;
+    proxy_http_version 1.1;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_set_header Upgrade $http_upgrade;
+    proxy_set_header Connection "upgrade";
+}
+
+location = {{exact}} {
+    return 301 {{loc}};
+}

package/src/templates/zpc.config.cjs.template

@@ -0,0 +1,20 @@
+/** @type {import("@zhipu/zp-cli").ZpcConfig} */
+module.exports = {
+  projectName: "my-project",
+  api: [
+    {
+      path: "api",
+      name: "api",
+      proxy: "/api",
+      env: {
+        PORT: 3000,
+      },
+    },
+  ],
+  web: [
+    {
+      path: "web",
+      name: "web",
+    },
+  ],
+};

package/src/templates/zpc.config.cts.template

@@ -0,0 +1,21 @@
+import { defineConfig } from "@zhipu/zp-cli";
+
+export default defineConfig({
+  projectName: "my-project",
+  api: [
+    {
+      path: "api",
+      name: "api",
+      proxy: "/api",
+      env: {
+        PORT: 3000,
+      },
+    },
+  ],
+  web: [
+    {
+      path: "web",
+      name: "web",
+    },
+  ],
+});

package/src/templates/zpc.config.js.template

@@ -0,0 +1,21 @@
+import { defineConfig } from "@zhipu/zp-cli";
+
+export default defineConfig({
+  projectName: "my-project",
+  api: [
+    {
+      path: "api",
+      name: "api",
+      proxy: "/api",
+      env: {
+        PORT: 3000,
+      },
+    },
+  ],
+  web: [
+    {
+      path: "web",
+      name: "web",
+    },
+  ],
+});

package/src/templates/zpc.config.json.template

@@ -0,0 +1,20 @@
+{
+  "$schema": "./zpc.config.schema.json",
+  "projectName": "my-project",
+  "api": [
+    {
+      "path": "api",
+      "name": "api",
+      "proxy": "/api",
+      "env": {
+        "PORT": 3000
+      }
+    }
+  ],
+  "web": [
+    {
+      "path": "web",
+      "name": "web"
+    }
+  ]
+}

package/src/templates/zpc.config.mjs.template

@@ -0,0 +1,21 @@
+import { defineConfig } from "@zhipu/zp-cli";
+
+export default defineConfig({
+  projectName: "my-project",
+  api: [
+    {
+      path: "api",
+      name: "api",
+      proxy: "/api",
+      env: {
+        PORT: 3000,
+      },
+    },
+  ],
+  web: [
+    {
+      path: "web",
+      name: "web",
+    },
+  ],
+});

package/src/templates/zpc.config.mts.template

@@ -0,0 +1,21 @@
+import { defineConfig } from "@zhipu/zp-cli";
+
+export default defineConfig({
+  projectName: "my-project",
+  api: [
+    {
+      path: "api",
+      name: "api",
+      proxy: "/api",
+      env: {
+        PORT: 3000,
+      },
+    },
+  ],
+  web: [
+    {
+      path: "web",
+      name: "web",
+    },
+  ],
+});

package/src/templates/zpc.config.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "zpc.config",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["projectName"],
+  "anyOf": [{ "required": ["api"] }, { "required": ["web"] }],
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "projectName": {
+      "type": "string",
+      "minLength": 1,
+      "description": "项目名，部署路径为 <root>/<projectName>/<name>"
+    },
+    "api": {
+      "$ref": "#/definitions/appList"
+    },
+    "web": {
+      "$ref": "#/definitions/appList"
+    }
+  },
+  "definitions": {
+    "appList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/app"
+      }
+    },
+    "app": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "name"],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "description": "相对项目根的源码目录"
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "description": "打包 / 部署目录名"
+        },
+        "proxy": {
+          "type": "string",
+          "description": "api 对外路径前缀；web 未写 buildEnv.VITE_API_PROXY 时也可作回退"
+        },
+        "buildEnv": {
+          "$ref": "#/definitions/envMap",
+          "description": "仅构建期注入"
+        },
+        "env": {
+          "$ref": "#/definitions/envMap",
+          "description": "仅运行时注入（pm2）"
+        }
+      }
+    },
+    "envMap": {
+      "type": "object",
+      "additionalProperties": {
+        "type": ["string", "number", "boolean"]
+      }
+    }
+  }
+}

package/src/templates/zpc.config.ts.template

@@ -0,0 +1,21 @@
+import { defineConfig } from "@zhipu/zp-cli";
+
+export default defineConfig({
+  projectName: "my-project",
+  api: [
+    {
+      path: "api",
+      name: "api",
+      proxy: "/api",
+      env: {
+        PORT: 3000,
+      },
+    },
+  ],
+  web: [
+    {
+      path: "web",
+      name: "web",
+    },
+  ],
+});