@nextclaw/app-runtime 0.4.1 → 0.6.0

package/README.md

@@ -6,9 +6,12 @@
 
 - `napp create <app-dir>`：生成一个最小可跑的微应用骨架
 - `napp inspect <app-dir>`：校验应用目录与 manifest
+- `napp doctor`：检查本机 NApp/WASI HTTP 开发运行环境
+- `napp build <app-dir> --install`：安装模板依赖并构建 TS/WASI HTTP 后端
 - `napp run <app-dir|app-id>`：启动本地宿主，支持目录运行和已安装应用运行
 - `napp dev <app-dir>`：当前等价于 `run`
 - `napp pack <app-dir>`：把应用目录打成 `.napp` bundle
+- `napp validate-publish <app-dir>`：本地做发布前校验并输出体积/包内容 warning
 - `napp publish <app-dir>`：把应用目录发布到官方 apps registry
 - `napp install <app-dir|bundle.napp|app-id[@version]>`：从本地或 registry 安装应用
 - `napp update <app-id>`：更新已安装应用
@@ -33,7 +36,7 @@ napp --help
 napp --version
 ```
 
-第一版先聚焦“独立可运行的微应用宿主 + 可分发、可安装、可更新、可授权的 CLI/runtime 闭环”，不接入现有 NextClaw 主产品路由、服务或 GUI app store。
+当前版本先聚焦“独立可运行的微应用宿主 + 可分发、可安装、可更新、可授权的 CLI/runtime 闭环”。普通用户入口推荐通过 NextClaw 的 `nextclaw-app-runtime` skill 编排这些命令。
 
 ## 应用目录
 
@@ -41,6 +44,8 @@ napp --version
 manifest.json
 main/
   app.wasm
+  package.json     # ts-http / ts-http-lite 模板存在
+  src/             # ts-http / ts-http-lite 模板存在
 ui/
   index.html
 assets/
@@ -48,11 +53,12 @@ assets/
 
 ## 当前 MVP 范围
 
-- `main` 执行形态：`wasm`
+- `main` 执行形态：`wasm` 或 `wasi-http-component`
 - UI 装载：本地静态服务
 - 宿主桥接：`/__napp/*`
+- WASI HTTP 业务 API：`/api/*`
 - 权限词汇：`documentAccess`、`allowedDomains`、`storage`、`capabilities`
-- 当前 Wasm 执行底座：Node 原生 `WebAssembly`
+- 当前 Wasm 执行底座：Node 原生 `WebAssembly` 与 Wasmtime `serve`
 - 分发包形态：`.napp`（底层为 zip）
 - 安装目录：`~/.nextclaw/apps/packages/<app-id>/<version>/`
 - 用户数据目录：`~/.nextclaw/apps/data/<app-id>/`
@@ -65,12 +71,26 @@ assets/
 开发者工作流：
 
 ```bash
-napp create ./my-first-napp
+napp doctor
+napp create ./my-first-napp --template ts-http
+napp build ./my-first-napp --install
 napp inspect ./my-first-napp
+napp validate-publish ./my-first-napp
+napp run ./my-first-napp --data ./my-first-napp/.napp/data
 napp pack ./my-first-napp
 napp publish ./my-first-napp
 ```
 
+体积优先工作流：
+
+```bash
+napp doctor
+napp create ./my-small-napp --template ts-http-lite
+napp build ./my-small-napp --install
+napp validate-publish ./my-small-napp
+napp run ./my-small-napp --data ./my-small-napp/.napp/data
+```
+
 本地安装工作流：
 
 ```bash
@@ -112,6 +132,11 @@ napp permissions nextclaw.my-first-napp
 napp run nextclaw.my-first-napp
 ```
 
+模板选择建议：
+
+- `ts-http`：默认推荐，开发体验优先，适合大多数普通前后端小应用
+- `ts-http-lite`：体积优先，继续走官方 WASI HTTP 路线，但不使用默认 Hono 路由层
+
 已有示例应用：
 
 ```bash

package/dist/bundle/app-bundle.service.js

@@ -10,7 +10,7 @@ var AppBundleService = class {
 	}
 	packAppDirectory = async (params) => {
 		const bundle = await this.manifestService.load(params.appDirectory);
-		const appFiles = await this.collectAppFiles(bundle.appDirectory);
+		const { appFiles, filePaths } = await this.collectAppFiles(bundle);
 		const metadata = this.buildMetadata(bundle.manifest.id, bundle.manifest.name, bundle.manifest.version);
 		const bundleJsonPath = ".napp/bundle.json";
 		const checksumsJsonPath = ".napp/checksums.json";
@@ -30,7 +30,9 @@ var AppBundleService = class {
 		await writeFile(outputPath, Buffer.from(archiveBytes));
 		return {
 			bundlePath: outputPath,
-			metadata
+			metadata,
+			sizeBytes: archiveBytes.byteLength,
+			filePaths
 		};
 	};
 	extractBundle = async (params) => {
@@ -59,15 +61,19 @@ var AppBundleService = class {
 			checksums
 		};
 	};
-	collectAppFiles = async (appDirectory) => {
-		const filePaths = new Set(["manifest.json"]);
-		await this.collectDirectoryPaths(path.join(appDirectory, "main"), appDirectory, filePaths);
-		await this.collectDirectoryPaths(path.join(appDirectory, "ui"), appDirectory, filePaths);
-		await this.collectDirectoryPaths(path.join(appDirectory, "assets"), appDirectory, filePaths);
+	collectAppFiles = async (bundle) => {
+		const appDirectory = bundle.appDirectory;
+		const filePaths = new Set([path.relative(appDirectory, bundle.manifestPath), path.relative(appDirectory, bundle.mainEntryPath)]);
+		await this.collectDirectoryPaths(bundle.uiDirectoryPath, appDirectory, filePaths);
+		await this.collectDirectoryPaths(bundle.assetsDirectoryPath, appDirectory, filePaths);
+		if (bundle.iconPath) filePaths.add(path.relative(appDirectory, bundle.iconPath));
 		const sortedPaths = Array.from(filePaths).sort((left, right) => left.localeCompare(right));
 		const appFiles = {};
 		for (const relativePath of sortedPaths) appFiles[relativePath] = new Uint8Array(await readFile(path.join(appDirectory, relativePath)));
-		return appFiles;
+		return {
+			appFiles,
+			filePaths: sortedPaths
+		};
 	};
 	collectDirectoryPaths = async (directoryPath, appDirectory, filePaths) => {
 		try {

package/dist/bundle/app-bundle.types.d.ts

@@ -14,6 +14,8 @@ type AppBundleChecksums = {
 type AppBundlePackResult = {
   bundlePath: string;
   metadata: AppBundleMetadata;
+  sizeBytes: number;
+  filePaths: string[];
 };
 type AppBundleExtractResult = {
   appDirectory: string;

package/dist/cli/app-runtime-cli.service.d.ts

@@ -8,10 +8,13 @@ declare class AppRuntimeCliService {
   private dispatch;
   private handleCreate;
   private handleInspect;
+  private handleBuild;
+  private handleDoctor;
   private handleRun;
   private handleDev;
   private handlePack;
   private handlePublish;
+  private handleValidatePublish;
   private handleInstall;
   private handleUpdate;
   private handleUninstall;

package/dist/cli/app-runtime-cli.service.js

@@ -14,6 +14,9 @@ import { RegistryCommand } from "../commands/registry.controller.js";
 import { RevokeCommand } from "../commands/revoke.controller.js";
 import { UninstallCommand } from "../commands/uninstall.controller.js";
 import { UpdateCommand } from "../commands/update.controller.js";
+import { ValidatePublishCommand } from "../commands/validate-publish.controller.js";
+import { AppRuntimeToolchainService } from "../runtime/app-runtime-toolchain.service.js";
+import { AppBuildService } from "../runtime/app-build.service.js";
 import { AppRuntimeOptionsService } from "./app-runtime-options.service.js";
 //#region src/cli/app-runtime-cli.service.ts
 var AppRuntimeCliService = class {
@@ -44,6 +47,12 @@ var AppRuntimeCliService = class {
 			case "inspect":
 				await this.handleInspect(restArgs);
 				return;
+			case "build":
+				await this.handleBuild(restArgs);
+				return;
+			case "doctor":
+				await this.handleDoctor(restArgs);
+				return;
 			case "run":
 				await this.handleRun(restArgs);
 				return;
@@ -56,6 +65,9 @@ var AppRuntimeCliService = class {
 			case "publish":
 				await this.handlePublish(restArgs);
 				return;
+			case "validate-publish":
+				await this.handleValidatePublish(restArgs);
+				return;
 			case "install":
 				await this.handleInstall(restArgs);
 				return;
@@ -93,6 +105,7 @@ var AppRuntimeCliService = class {
 		const options = this.optionsService.readCreateOptions(optionArgs);
 		await new CreateCommand().run({
 			appDirectory: target,
+			template: options.template,
 			json: options.json,
 			write: this.write
 		});
@@ -106,6 +119,46 @@ var AppRuntimeCliService = class {
 			write: this.write
 		});
 	};
+	handleBuild = async (restArgs) => {
+		const { target, optionArgs } = this.optionsService.readTarget("build", restArgs);
+		const options = this.optionsService.readBuildOptions(optionArgs);
+		const result = await new AppBuildService().build({
+			appDirectory: target,
+			install: options.install
+		});
+		if (options.json) {
+			this.write(`${JSON.stringify({
+				ok: true,
+				build: result
+			}, null, 2)}\n`);
+			return;
+		}
+		if (!result.built) {
+			this.write(`Build skipped: ${result.skippedReason ?? result.mainKind}\n`);
+			return;
+		}
+		this.write(`Built ${result.mainKind} app\n`);
+		this.write(`Main: ${result.mainEntryPath}\n`);
+		if (result.installedDependencies) this.write("Dependencies: installed\n");
+	};
+	handleDoctor = async (restArgs) => {
+		const options = this.optionsService.readJsonOnlyOptions(restArgs);
+		const result = await new AppRuntimeToolchainService().doctor();
+		if (options.json) {
+			this.write(`${JSON.stringify({
+				ok: result.ok,
+				doctor: result
+			}, null, 2)}\n`);
+			if (!result.ok) process.exitCode = 1;
+			return;
+		}
+		this.write(`NApp runtime doctor: ${result.ok ? "ok" : "not ready"}\n`);
+		for (const tool of result.tools) {
+			this.write(`${tool.ok ? "ok" : "missing"} ${tool.name}${tool.version ? ` ${tool.version}` : ""}\n`);
+			if (!tool.ok) this.write(`  ${tool.installHint}\n`);
+		}
+		if (!result.ok) process.exitCode = 1;
+	};
 	handleRun = async (restArgs) => {
 		const { target, optionArgs } = this.optionsService.readTarget("run", restArgs);
 		const options = this.optionsService.readRuntimeOptions(optionArgs);
@@ -113,6 +166,7 @@ var AppRuntimeCliService = class {
 			appReference: target,
 			host: options.host,
 			port: options.port,
+			dataDirectory: options.dataDirectory,
 			json: options.json,
 			documentGrantMap: options.documentGrantMap,
 			write: this.write
@@ -125,6 +179,7 @@ var AppRuntimeCliService = class {
 			appReference: target,
 			host: options.host,
 			port: options.port,
+			dataDirectory: options.dataDirectory,
 			json: options.json,
 			documentGrantMap: options.documentGrantMap,
 			write: this.write
@@ -152,6 +207,16 @@ var AppRuntimeCliService = class {
 			write: this.write
 		});
 	};
+	handleValidatePublish = async (restArgs) => {
+		const { target, optionArgs } = this.optionsService.readTarget("validate-publish", restArgs);
+		const options = this.optionsService.readPublishOptions(optionArgs);
+		await new ValidatePublishCommand().run({
+			appDirectory: target,
+			metadataPath: options.metadataPath,
+			json: options.json,
+			write: this.write
+		});
+	};
 	handleInstall = async (restArgs) => {
 		const { target, optionArgs } = this.optionsService.readTarget("install", restArgs);
 		const options = this.optionsService.readInstallOptions(optionArgs);
@@ -271,11 +336,14 @@ var AppRuntimeCliService = class {
 		});
 	};
 	writeUsage = () => {
-		this.write("Usage: napp create <app-dir> [--json]\n");
+		this.write("Usage: napp create <app-dir> [--template starter|ts-http|ts-http-lite] [--json]\n");
 		this.write("       napp inspect <app-dir> [--json]\n");
-		this.write("       napp <run|dev> <app-dir|app-id> [--host 127.0.0.1] [--port 3100] [--json] [--document scope=/path]\n");
+		this.write("       napp build <app-dir> [--install] [--json]\n");
+		this.write("       napp doctor [--json]\n");
+		this.write("       napp <run|dev> <app-dir|app-id> [--host 127.0.0.1] [--port 3100] [--data /path] [--json] [--document scope=/path]\n");
 		this.write("       napp pack <app-dir> [--out bundle.napp] [--json]\n");
 		this.write("       napp publish <app-dir> [--meta marketplace.json] [--api-base <url>] [--token <token>] [--json]\n");
+		this.write("       napp validate-publish <app-dir> [--meta marketplace.json] [--json]\n");
 		this.write("       napp install <app-dir|bundle.napp|app-id[@version]> [--registry <url>] [--json]\n");
 		this.write("       napp update <app-id> [--version <version>] [--registry <url>] [--json]\n");
 		this.write("       napp uninstall <app-id> [--purge-data] [--json]\n");

package/dist/cli/app-runtime-options.service.d.ts

@@ -1,19 +1,26 @@
 import { AppDocumentGrantMap } from "../permissions/app-permissions.types.js";
+import { AppScaffoldTemplate } from "../scaffold/app-scaffold.service.js";
 
 //#region src/cli/app-runtime-options.service.d.ts
 type RuntimeCliOptions = {
   host: string;
   port: number;
+  dataDirectory?: string;
   json: boolean;
   documentGrantMap: AppDocumentGrantMap;
 };
 type CreateCliOptions = {
   json: boolean;
+  template: AppScaffoldTemplate;
 };
 type PackCliOptions = {
   json: boolean;
   outputPath?: string;
 };
+type BuildCliOptions = {
+  json: boolean;
+  install: boolean;
+};
 type JsonOnlyCliOptions = {
   json: boolean;
 };
@@ -50,7 +57,9 @@ declare class AppRuntimeOptionsService {
     optionArgs: string[];
   };
   readCreateOptions: (rawArgs: string[]) => CreateCliOptions;
+  private readCreateTemplate;
   readPackOptions: (rawArgs: string[]) => PackCliOptions;
+  readBuildOptions: (rawArgs: string[]) => BuildCliOptions;
   readJsonOnlyOptions: (rawArgs: string[]) => JsonOnlyCliOptions;
   readInstallOptions: (rawArgs: string[]) => InstallCliOptions;
   readUpdateOptions: (rawArgs: string[]) => UpdateCliOptions;
@@ -64,4 +73,4 @@ declare class AppRuntimeOptionsService {
   private requireOptionValue;
 }
 //#endregion
-export { AppRuntimeOptionsService, CreateCliOptions, GrantCliOptions, InstallCliOptions, JsonOnlyCliOptions, PackCliOptions, PublishCliOptions, RevokeCliOptions, RuntimeCliOptions, UninstallCliOptions, UpdateCliOptions };
+export { AppRuntimeOptionsService, BuildCliOptions, CreateCliOptions, GrantCliOptions, InstallCliOptions, JsonOnlyCliOptions, PackCliOptions, PublishCliOptions, RevokeCliOptions, RuntimeCliOptions, UninstallCliOptions, UpdateCliOptions };

package/dist/cli/app-runtime-options.service.js

@@ -9,18 +9,31 @@ var AppRuntimeOptionsService = class {
 		};
 	};
 	readCreateOptions = (rawArgs) => {
-		const options = { json: false };
-		for (const current of rawArgs) {
+		const options = {
+			json: false,
+			template: "starter"
+		};
+		for (let index = 0; index < rawArgs.length; index += 1) {
+			const current = rawArgs[index];
 			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
+			const nextValue = rawArgs[index + 1];
 			switch (current) {
 				case "--json":
 					options.json = true;
 					break;
+				case "--template":
+					options.template = this.readCreateTemplate(this.requireOptionValue(current, nextValue));
+					index += 1;
+					break;
 				default: throw new Error(`未知参数：${current}`);
 			}
 		}
 		return options;
 	};
+	readCreateTemplate = (rawTemplate) => {
+		if (rawTemplate === "starter" || rawTemplate === "ts-http" || rawTemplate === "ts-http-lite") return rawTemplate;
+		throw new Error("--template 只支持 starter、ts-http 或 ts-http-lite。");
+	};
 	readPackOptions = (rawArgs) => {
 		const options = { json: false };
 		for (let index = 0; index < rawArgs.length; index += 1) {
@@ -40,6 +53,25 @@ var AppRuntimeOptionsService = class {
 		}
 		return options;
 	};
+	readBuildOptions = (rawArgs) => {
+		const options = {
+			json: false,
+			install: false
+		};
+		for (const current of rawArgs) {
+			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
+			switch (current) {
+				case "--json":
+					options.json = true;
+					break;
+				case "--install":
+					options.install = true;
+					break;
+				default: throw new Error(`未知参数：${current}`);
+			}
+		}
+		return options;
+	};
 	readJsonOnlyOptions = (rawArgs) => {
 		const options = { json: false };
 		for (const current of rawArgs) {
@@ -118,6 +150,7 @@ var AppRuntimeOptionsService = class {
 		const options = {
 			host: "127.0.0.1",
 			port: 3100,
+			dataDirectory: void 0,
 			json: false,
 			documentGrantMap: {}
 		};
@@ -138,6 +171,10 @@ var AppRuntimeOptionsService = class {
 				case "--json":
 					options.json = true;
 					break;
+				case "--data":
+					options.dataDirectory = this.requireOptionValue(current, nextValue);
+					index += 1;
+					break;
 				case "--document":
 					this.assignDocumentGrant(options.documentGrantMap, this.requireOptionValue(current, nextValue));
 					index += 1;

package/dist/commands/create.controller.d.ts

@@ -1,4 +1,4 @@
-import { AppScaffoldService } from "../scaffold/app-scaffold.service.js";
+import { AppScaffoldService, AppScaffoldTemplate } from "../scaffold/app-scaffold.service.js";
 
 //#region src/commands/create.controller.d.ts
 declare class CreateCommand {
@@ -6,6 +6,7 @@ declare class CreateCommand {
   constructor(scaffoldService?: AppScaffoldService);
   run: (params: {
     appDirectory: string;
+    template: AppScaffoldTemplate;
     json: boolean;
     write: (text: string) => void;
   }) => Promise<void>;

package/dist/commands/create.controller.js

@@ -5,8 +5,8 @@ var CreateCommand = class {
 		this.scaffoldService = scaffoldService;
 	}
 	run = async (params) => {
-		const { appDirectory, json, write } = params;
-		const result = await this.scaffoldService.scaffold(appDirectory);
+		const { appDirectory, template, json, write } = params;
+		const result = await this.scaffoldService.scaffold(appDirectory, { template });
 		if (json) {
 			write(`${JSON.stringify({
 				ok: true,
@@ -15,6 +15,7 @@ var CreateCommand = class {
 			return;
 		}
 		write(`Created app scaffold at ${result.appDirectory}\n`);
+		write(`Template: ${result.template}\n`);
 		write(`Manifest: ${result.manifestPath}\n`);
 		write("Next: napp inspect <app-dir> && napp run <app-dir>\n");
 	};

package/dist/commands/inspect.controller.js

@@ -17,7 +17,8 @@ var InspectCommand = class {
 		}
 		write(`App: ${summary.name} (${summary.id})\n`);
 		write(`Version: ${summary.version}\n`);
-		write(`Action: ${summary.action}\n`);
+		write(`Main Kind: ${summary.mainKind}\n`);
+		if (summary.action) write(`Action: ${summary.action}\n`);
 		write(`Main: ${summary.mainEntryPath}\n`);
 		write(`UI: ${summary.uiEntryPath}\n`);
 	};

package/dist/commands/run.controller.js

@@ -2,6 +2,7 @@ import { AppManifestService } from "../manifest/app-manifest.service.js";
 import { AppHostService } from "../host/app-host.service.js";
 import { AppInstanceService } from "../host/app-instance.service.js";
 import { AppInstallationService } from "../install/app-installation.service.js";
+import { WasmtimeWasiHttpComponentService } from "../runtime/wasmtime-wasi-http-component.service.js";
 //#region src/commands/run.controller.ts
 var RunCommand = class {
 	constructor(manifestService = new AppManifestService(), installationService = new AppInstallationService()) {
@@ -9,19 +10,35 @@ var RunCommand = class {
 		this.installationService = installationService;
 	}
 	run = async (params) => {
-		const { appReference, host, port, json, documentGrantMap, write } = params;
+		const { appReference, host, port, dataDirectory, json, documentGrantMap, write } = params;
 		const launch = await this.installationService.resolveLaunch(appReference, documentGrantMap);
 		const bundle = await this.manifestService.load(launch.appDirectory);
 		const appInstance = new AppInstanceService(bundle);
 		await appInstance.initialize(launch.documentGrantMap, { appId: launch.appId });
 		await this.installationService.persistGrants(launch.appId, launch.documentGrantMap);
-		const appHost = new AppHostService(appInstance);
-		const hostHandle = await appHost.start({
-			host,
-			port
-		});
+		const wasiHttpComponentService = bundle.manifest.main.kind === "wasi-http-component" ? new WasmtimeWasiHttpComponentService() : void 0;
+		const effectiveDataDirectory = dataDirectory ?? launch.dataDirectory;
+		if (wasiHttpComponentService) {
+			if (!effectiveDataDirectory) throw new Error("wasi-http-component 应用需要通过 --data /path 指定后端数据目录。");
+			await wasiHttpComponentService.start({
+				wasmPath: bundle.mainEntryPath,
+				dataDirectory: effectiveDataDirectory
+			});
+		}
+		const appHost = new AppHostService(appInstance, wasiHttpComponentService);
+		let hostHandle;
+		try {
+			hostHandle = await appHost.start({
+				host,
+				port
+			});
+		} catch (error) {
+			await wasiHttpComponentService?.stop();
+			throw error;
+		}
 		const shutdown = async () => {
 			await appHost.stop();
+			await wasiHttpComponentService?.stop();
 			process.exit(0);
 		};
 		process.once("SIGINT", () => {
@@ -36,7 +53,8 @@ var RunCommand = class {
 				host: hostHandle,
 				app: {
 					appId: launch.appId ?? bundle.manifest.id,
-					appDirectory: launch.appDirectory
+					appDirectory: launch.appDirectory,
+					dataDirectory: effectiveDataDirectory
 				}
 			}, null, 2)}\n`);
 			return;

package/dist/commands/validate-publish.controller.d.ts

@@ -0,0 +1,15 @@
+import { AppPublishValidationService } from "../publish/app-publish-validation.service.js";
+
+//#region src/commands/validate-publish.controller.d.ts
+declare class ValidatePublishCommand {
+  private readonly validationService;
+  constructor(validationService?: AppPublishValidationService);
+  run: (params: {
+    appDirectory: string;
+    metadataPath?: string;
+    json: boolean;
+    write: (text: string) => void;
+  }) => Promise<void>;
+}
+//#endregion
+export { ValidatePublishCommand };

package/dist/commands/validate-publish.controller.js

@@ -0,0 +1,31 @@
+import { AppPublishValidationService } from "../publish/app-publish-validation.service.js";
+//#region src/commands/validate-publish.controller.ts
+var ValidatePublishCommand = class {
+	constructor(validationService = new AppPublishValidationService()) {
+		this.validationService = validationService;
+	}
+	run = async (params) => {
+		const { appDirectory, metadataPath, json, write } = params;
+		const result = await this.validationService.validate({
+			appDirectory,
+			metadataPath
+		});
+		if (json) {
+			write(`${JSON.stringify({
+				ok: true,
+				validation: result
+			}, null, 2)}\n`);
+			return;
+		}
+		write(`Publish validation ok for ${result.appId}@${result.version}\n`);
+		write(`Main kind: ${result.mainKind}\n`);
+		write(`Main: ${result.mainEntryPath}\n`);
+		write(`Metadata: ${result.metadataPath}\n`);
+		write(`Bundle size: ${result.bundleSizeBytes} bytes\n`);
+		write(`Main entry size: ${result.mainEntrySizeBytes} bytes\n`);
+		write(`Bundle files (${result.bundleFilePaths.length}): ${result.bundleFilePaths.join(", ")}\n`);
+		if (result.warnings.length > 0) for (const warning of result.warnings) write(`Warning [${warning.code}]: ${warning.message}\n`);
+	};
+};
+//#endregion
+export { ValidatePublishCommand };

package/dist/host/app-host.service.d.ts

@@ -1,4 +1,5 @@
 import { AppInstanceService } from "./app-instance.service.js";
+import { WasmtimeWasiHttpComponentService } from "../runtime/wasmtime-wasi-http-component.service.js";
 
 //#region src/host/app-host.service.d.ts
 type AppHostStartOptions = {
@@ -13,10 +14,11 @@ type AppHostHandle = {
 };
 declare class AppHostService {
   private readonly appInstance;
+  private readonly wasiHttpComponentService?;
   private server?;
   private readonly bridgeServer;
   private readonly uiServer;
-  constructor(appInstance: AppInstanceService);
+  constructor(appInstance: AppInstanceService, wasiHttpComponentService?: WasmtimeWasiHttpComponentService | undefined);
   start: (options: AppHostStartOptions) => Promise<AppHostHandle>;
   stop: () => Promise<void>;
   private handleRequest;

package/dist/host/app-host.service.js

@@ -6,8 +6,9 @@ var AppHostService = class {
 	server;
 	bridgeServer;
 	uiServer;
-	constructor(appInstance) {
+	constructor(appInstance, wasiHttpComponentService) {
 		this.appInstance = appInstance;
+		this.wasiHttpComponentService = wasiHttpComponentService;
 		this.bridgeServer = new HostBridgeServer(appInstance);
 		this.uiServer = new UiServerService(appInstance.bundle);
 	}
@@ -48,6 +49,9 @@ var AppHostService = class {
 	};
 	handleRequest = async (request, response) => {
 		try {
+			if (this.wasiHttpComponentService) {
+				if (await this.wasiHttpComponentService.handleRequest(request, response)) return;
+			}
 			if (await this.bridgeServer.handle(request, response)) return;
 			await this.uiServer.handle(request, response);
 		} catch (error) {

package/dist/host/app-instance.service.js

@@ -22,6 +22,7 @@ var AppInstanceService = class {
 		return this.permissionsService.summarize(this.bundle, this.getPermissions());
 	};
 	runAction = async (action) => {
+		if (this.bundle.manifest.main.kind !== "wasm") throw new Error("当前应用不支持 __napp/run action，请通过 /api/* 调用 WASI HTTP 后端。");
 		const expectedAction = this.bundle.manifest.main.action;
 		if (action && action !== expectedAction) throw new Error(`当前应用只支持动作 ${expectedAction}。`);
 		const input = await this.collectDocumentSummaryInput();

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AppDocumentAccessMode, AppDocumentAccessScope, AppMainManifest, AppManifest, AppManifestBundle, AppManifestSummary, AppPermissions, AppUiManifest } from "./manifest/app-manifest.types.js";
+import { AppCoreWasmMainManifest, AppDocumentAccessMode, AppDocumentAccessScope, AppMainManifest, AppManifest, AppManifestBundle, AppManifestSummary, AppPermissions, AppUiManifest, AppWasiHttpComponentMainManifest } from "./manifest/app-manifest.types.js";
 import { AppManifestService } from "./manifest/app-manifest.service.js";
 import { AppBundleChecksums, AppBundleExtractResult, AppBundleMetadata, AppBundlePackResult } from "./bundle/app-bundle.types.js";
 import { AppBundleService } from "./bundle/app-bundle.service.js";
@@ -10,7 +10,10 @@ import { WasmSidecarClientService } from "./sidecar/wasm-sidecar-client.service.
 import { WasmMainRunnerService } from "./runtime/wasm-main-runner.service.js";
 import { AppInstanceService, AppRunResult } from "./host/app-instance.service.js";
 import { HostBridgeServer } from "./bridge/host-bridge.service.js";
-import { AppRuntimeOptionsService, CreateCliOptions, GrantCliOptions, InstallCliOptions, JsonOnlyCliOptions, PackCliOptions, PublishCliOptions, RevokeCliOptions, RuntimeCliOptions, UninstallCliOptions, UpdateCliOptions } from "./cli/app-runtime-options.service.js";
+import { AppScaffoldFile, AppTsHttpScaffoldTemplateService } from "./scaffold/app-ts-http-scaffold-template.service.js";
+import { AppTsHttpLiteScaffoldTemplateService } from "./scaffold/app-ts-http-lite-scaffold-template.service.js";
+import { AppScaffoldResult, AppScaffoldService, AppScaffoldTemplate } from "./scaffold/app-scaffold.service.js";
+import { AppRuntimeOptionsService, BuildCliOptions, CreateCliOptions, GrantCliOptions, InstallCliOptions, JsonOnlyCliOptions, PackCliOptions, PublishCliOptions, RevokeCliOptions, RuntimeCliOptions, UninstallCliOptions, UpdateCliOptions } from "./cli/app-runtime-options.service.js";
 import { AppRuntimeCliService } from "./cli/app-runtime-cli.service.js";
 import { CreateCommand } from "./commands/create.controller.js";
 import { AppHomeService } from "./paths/app-home.service.js";
@@ -38,6 +41,11 @@ import { RegistryCommand } from "./commands/registry.controller.js";
 import { RevokeCommand } from "./commands/revoke.controller.js";
 import { UpdateCommand } from "./commands/update.controller.js";
 import { UninstallCommand } from "./commands/uninstall.controller.js";
+import { AppPublishValidationResult, AppPublishValidationService, AppPublishValidationWarning, AppPublishValidationWarningCode } from "./publish/app-publish-validation.service.js";
+import { ValidatePublishCommand } from "./commands/validate-publish.controller.js";
+import { WasmtimeWasiHttpComponentHandle, WasmtimeWasiHttpComponentService, WasmtimeWasiHttpComponentStartOptions } from "./runtime/wasmtime-wasi-http-component.service.js";
 import { AppHostHandle, AppHostService, AppHostStartOptions } from "./host/app-host.service.js";
+import { AppRuntimeCommandResult, AppRuntimeDoctorResult, AppRuntimeToolStatus, AppRuntimeToolchainService } from "./runtime/app-runtime-toolchain.service.js";
+import { AppBuildResult, AppBuildService } from "./runtime/app-build.service.js";
 import { UiServerService } from "./ui/ui-server.service.js";
-export { AppBundleChecksums, AppBundleExtractResult, AppBundleMetadata, AppBundlePackResult, AppBundleService, AppDocumentAccessMode, AppDocumentAccessScope, AppDocumentGrantMap, AppDocumentGrantMutationResult, AppDocumentGrantState, AppGrantService, AppHomeService, AppHostHandle, AppHostService, AppHostStartOptions, AppInfoResult, AppInstallResult, AppInstallSourceKind, AppInstallationService, AppInstalledPermissionState, AppInstanceService, AppLaunchResolution, AppMainManifest, AppManifest, AppManifestBundle, AppManifestService, AppManifestSummary, AppMarketplaceClientService, AppMarketplaceMetadata, AppMarketplaceMetadataService, AppPermissionSummary, AppPermissions, AppPermissionsService, AppPublishFile, AppPublishPayload, AppPublishResult, AppPublishService, AppPublisher, AppRegistry, AppRegistryAppRecord, AppRegistryConfig, AppRegistryConfigService, AppRegistryConfigSnapshot, AppRegistryInstalledVersion, AppRegistryService, AppRemoteRegistryClientService, AppRemoteRegistryDocument, AppRemoteRegistryResolution, AppRemoteRegistryVersion, AppRunResult, AppRuntimeCliService, AppRuntimeOptionsService, AppUiManifest, AppUninstallResult, AppUpdateResult, CreateCliOptions, CreateCommand, DEFAULT_APP_MARKETPLACE_API_BASE, DEFAULT_APP_REGISTRY_URL, GrantCliOptions, GrantCommand, HostBridgeServer, InfoCommand, InstallCliOptions, InstallCommand, InstalledAppListItem, JsonOnlyCliOptions, ListCommand, MainRunRequest, MainRunResult, MainRunnerService, PackCliOptions, PackCommand, PermissionsCommand, PlatformAuthStateService, PlatformPublishAuthState, PublishCliOptions, PublishCommand, RegistryCommand, ResolvedDocumentGrant, ResolvedPermissions, RevokeCliOptions, RevokeCommand, RuntimeCliOptions, UiServerService, UninstallCliOptions, UninstallCommand, UpdateCliOptions, UpdateCommand, WasmDocumentSummaryInput, WasmMainRunnerService, WasmSidecarClientService };
+export { AppBuildResult, AppBuildService, AppBundleChecksums, AppBundleExtractResult, AppBundleMetadata, AppBundlePackResult, AppBundleService, AppCoreWasmMainManifest, AppDocumentAccessMode, AppDocumentAccessScope, AppDocumentGrantMap, AppDocumentGrantMutationResult, AppDocumentGrantState, AppGrantService, AppHomeService, AppHostHandle, AppHostService, AppHostStartOptions, AppInfoResult, AppInstallResult, AppInstallSourceKind, AppInstallationService, AppInstalledPermissionState, AppInstanceService, AppLaunchResolution, AppMainManifest, AppManifest, AppManifestBundle, AppManifestService, AppManifestSummary, AppMarketplaceClientService, AppMarketplaceMetadata, AppMarketplaceMetadataService, AppPermissionSummary, AppPermissions, AppPermissionsService, AppPublishFile, AppPublishPayload, AppPublishResult, AppPublishService, AppPublishValidationResult, AppPublishValidationService, AppPublishValidationWarning, AppPublishValidationWarningCode, AppPublisher, AppRegistry, AppRegistryAppRecord, AppRegistryConfig, AppRegistryConfigService, AppRegistryConfigSnapshot, AppRegistryInstalledVersion, AppRegistryService, AppRemoteRegistryClientService, AppRemoteRegistryDocument, AppRemoteRegistryResolution, AppRemoteRegistryVersion, AppRunResult, AppRuntimeCliService, AppRuntimeCommandResult, AppRuntimeDoctorResult, AppRuntimeOptionsService, AppRuntimeToolStatus, AppRuntimeToolchainService, AppScaffoldFile, AppScaffoldResult, AppScaffoldService, AppScaffoldTemplate, AppTsHttpLiteScaffoldTemplateService, AppTsHttpScaffoldTemplateService, AppUiManifest, AppUninstallResult, AppUpdateResult, AppWasiHttpComponentMainManifest, BuildCliOptions, CreateCliOptions, CreateCommand, DEFAULT_APP_MARKETPLACE_API_BASE, DEFAULT_APP_REGISTRY_URL, GrantCliOptions, GrantCommand, HostBridgeServer, InfoCommand, InstallCliOptions, InstallCommand, InstalledAppListItem, JsonOnlyCliOptions, ListCommand, MainRunRequest, MainRunResult, MainRunnerService, PackCliOptions, PackCommand, PermissionsCommand, PlatformAuthStateService, PlatformPublishAuthState, PublishCliOptions, PublishCommand, RegistryCommand, ResolvedDocumentGrant, ResolvedPermissions, RevokeCliOptions, RevokeCommand, RuntimeCliOptions, UiServerService, UninstallCliOptions, UninstallCommand, UpdateCliOptions, UpdateCommand, ValidatePublishCommand, WasmDocumentSummaryInput, WasmMainRunnerService, WasmSidecarClientService, WasmtimeWasiHttpComponentHandle, WasmtimeWasiHttpComponentService, WasmtimeWasiHttpComponentStartOptions };