nextclaw 0.33.2 → 0.34.0

package/dist/cli/app/index.js

@@ -13,6 +13,7 @@ import { NextclawDistributionService, NextclawServiceRuntime, readLearningLoopRu
 import { access, mkdtemp, readFile, rm, stat } from "node:fs/promises";
 import { McpServiceAppRuntimeService, buildServiceActionId, getServiceAppManifestPath, mergeServiceAppRuntimeActions, readServiceAppManifest } from "@nextclaw/kernel";
 import { promisify } from "node:util";
+import { AppPublishService, AppPublishValidationService } from "@nextclaw/app-runtime";
 var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 //#endregion
@@ -4607,13 +4608,165 @@ var AppRestartCommandController = class {
 	};
 };
 //#endregion
+//#region src/cli/app/services/app-publishing.service.ts
+var AppPublishingService = class {
+	constructor(validationService = new AppPublishValidationService(), publishService = new AppPublishService()) {
+		this.validationService = validationService;
+		this.publishService = publishService;
+	}
+	validate = async (params) => {
+		const result = await this.validationService.validate({
+			appDirectory: params.appDirectory,
+			metadataPath: params.metadataPath,
+			mode: "bundle"
+		});
+		if (result.profile !== "components") throw new Error("nextclaw app publish 只支持由 Panel App 或 Service App 组成的 schema v2 Mini App。");
+		if (result.distributionMode !== "bundle") throw new Error("NextClaw Mini App 只支持 bundle 分发。");
+		return result;
+	};
+	publish = async (params) => {
+		const validation = await this.validate(params);
+		if (validation.warnings.length > 0 && !params.allowWarnings) {
+			const warningList = validation.warnings.map((warning) => `[${warning.code}] ${warning.message}`).join("; ");
+			throw new Error(`发布校验包含警告：${warningList}。确认后可使用 --allow-warnings 继续。`);
+		}
+		const tempDirectory = await mkdtemp(path.join(tmpdir(), "nextclaw-app-publish-"));
+		try {
+			const result = await this.publishService.publish({
+				appDirectory: params.appDirectory,
+				metadataPath: params.metadataPath,
+				bundleOutputPath: path.join(tempDirectory, "artifact.napp"),
+				mode: "bundle"
+			});
+			const { item } = result;
+			return {
+				validation,
+				publish: {
+					created: result.created,
+					item: {
+						slug: item.slug,
+						appId: item.appId,
+						ownerScope: item.ownerScope,
+						appName: item.appName,
+						publishStatus: item.publishStatus,
+						name: item.name,
+						latestVersion: item.latestVersion,
+						webUrl: item.publishStatus === "published" ? item.webUrl : void 0
+					},
+					fileCount: result.fileCount
+				}
+			};
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			throw new Error(message.replace(/缺少 marketplace publish token。请先登录 NextClaw，或传入 --token。?/g, "发布需要 NextClaw 平台登录态。请先运行 nextclaw login。").replace(/，或传入 --token。?/g, "。"));
+		} finally {
+			await rm(tempDirectory, {
+				recursive: true,
+				force: true
+			});
+		}
+	};
+};
+//#endregion
+//#region src/cli/app/controllers/app-publish-command.controller.ts
+const PLATFORM_APPS_URL = "https://platform.nextclaw.io/apps";
+var AppPublishCommandController = class {
+	constructor(appPublishingService = new AppPublishingService()) {
+		this.appPublishingService = appPublishingService;
+	}
+	publish = async (target, options) => {
+		const { allowWarnings, json, meta } = options;
+		try {
+			const result = await this.appPublishingService.publish({
+				appDirectory: target,
+				metadataPath: meta,
+				allowWarnings
+			});
+			process.stdout.write(json ? `${JSON.stringify({
+				ok: true,
+				...result
+			}, null, 2)}\n` : this.format(result));
+		} catch (error) {
+			this.writeError(error, Boolean(json));
+			process.exitCode = 1;
+		}
+	};
+	format = (result) => {
+		const { item } = result.publish;
+		if (item.publishStatus === "pending") return [
+			`Submitted ${item.name} (${item.appId}) ${item.latestVersion} for review.`,
+			"Status: pending",
+			"The app will appear in the App Marketplace after approval.",
+			`Manage submissions: ${PLATFORM_APPS_URL}`,
+			""
+		].join("\n");
+		return [
+			`${result.publish.created ? "Published" : "Updated"} ${item.name} (${item.appId}) ${item.latestVersion}.`,
+			"Status: published",
+			item.webUrl ? `Details: ${item.webUrl}` : "",
+			`Manage apps: ${PLATFORM_APPS_URL}`,
+			""
+		].filter((line, index, lines) => line || index === lines.length - 1).join("\n");
+	};
+	writeError = (error, json) => {
+		const message = error instanceof Error ? error.message : String(error);
+		process.stdout.write(json ? `${JSON.stringify({
+			ok: false,
+			error: { message }
+		}, null, 2)}\n` : `Mini App publish failed: ${message}\n`);
+	};
+};
+//#endregion
+//#region src/cli/app/controllers/app-validate-publish-command.controller.ts
+var AppValidatePublishCommandController = class {
+	constructor(appPublishingService = new AppPublishingService()) {
+		this.appPublishingService = appPublishingService;
+	}
+	validate = async (target, options) => {
+		try {
+			const validation = await this.appPublishingService.validate({
+				appDirectory: target,
+				metadataPath: options.meta
+			});
+			process.stdout.write(options.json ? `${JSON.stringify({
+				ok: true,
+				validation
+			}, null, 2)}\n` : this.format(validation));
+		} catch (error) {
+			this.writeError(error, Boolean(options.json));
+			process.exitCode = 1;
+		}
+	};
+	format = (validation) => {
+		const lines = [
+			`Mini App publish validation passed: ${validation.appId}@${validation.version}`,
+			`Components: ${validation.componentCount ?? 0}`,
+			`Bundle size: ${validation.bundleSizeBytes} bytes`,
+			`Metadata: ${validation.metadataPath}`
+		];
+		for (const warning of validation.warnings) lines.push(`Warning [${warning.code}]: ${warning.message}`);
+		return `${lines.join("\n")}\n`;
+	};
+	writeError = (error, json) => {
+		const message = error instanceof Error ? error.message : String(error);
+		process.stdout.write(json ? `${JSON.stringify({
+			ok: false,
+			error: { message }
+		}, null, 2)}\n` : `Mini App publish validation failed: ${message}\n`);
+	};
+};
+//#endregion
 //#region src/cli/app/register-app-commands.ts
 function registerAppCommands(program) {
-	const app = program.command("app").description("Inspect and validate lightweight NextClaw apps");
+	const app = program.command("app").description("Develop, validate, and publish NextClaw apps");
 	const appCheck = new AppCheckCommandController();
 	const appDev = new AppDevCommandController();
 	const appCall = new AppCallCommandController();
 	const appRestart = new AppRestartCommandController();
+	const appValidatePublish = new AppValidatePublishCommandController();
+	const appPublish = new AppPublishCommandController();
+	app.command("validate-publish <app-dir>").description("Validate a NextClaw Mini App before Marketplace submission").option("--meta <path>", "Use a custom marketplace metadata file").option("--json", "Output JSON", false).action(async (target, opts) => appValidatePublish.validate(target, opts));
+	app.command("publish <app-dir>").description("Submit a NextClaw Mini App to the App Marketplace").option("--meta <path>", "Use a custom marketplace metadata file").option("--allow-warnings", "Submit after reviewing validation warnings", false).option("--json", "Output JSON", false).action(async (target, opts) => appPublish.publish(target, opts));
 	app.command("check <app-dir>").description("Check a Panel App or Service App directory").option("--json", "Output JSON", false).action(async (target, opts) => appCheck.check(target, opts));
 	app.command("dev <service-app-dir>").description("Start a Service App through the real runtime and inspect its actions").option("--json", "Output JSON", false).action(async (target, opts) => appDev.dev(target, opts));
 	app.command("call <service-app-dir> <action-name>").description("Call a Service App action through the real runtime").option("--input <json>", "JSON object input for the action").option("--json", "Output JSON", false).action(async (target, actionName, opts) => appCall.call(target, actionName, opts));