@nextclaw/app-runtime 0.5.0 → 0.7.0

package/README.md

@@ -10,8 +10,9 @@
 - `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 publish <app-dir>`：把应用目录发布到官方 apps registry
+- `napp pack <app-dir>`：把应用目录打成 `.napp` 分发包，默认使用轻量 `source` 模式
+- `napp validate-publish <app-dir>`：本地做发布前校验并输出体积/包内容 warning
+- `napp publish <app-dir>`：把应用目录发布到官方 apps registry，默认发布轻量 `source` 分发包
 - `napp install <app-dir|bundle.napp|app-id[@version]>`：从本地或 registry 安装应用
 - `napp update <app-id>`：更新已安装应用
 - `napp uninstall <app-id>`：卸载已安装应用
@@ -43,8 +44,8 @@ napp --version
 manifest.json
 main/
   app.wasm
-  package.json     # ts-http 模板存在
-  src/             # ts-http 模板存在
+  package.json     # ts-http / ts-http-lite 模板存在
+  src/             # ts-http / ts-http-lite 模板存在
 ui/
   index.html
 assets/
@@ -58,7 +59,7 @@ assets/
 - WASI HTTP 业务 API：`/api/*`
 - 权限词汇：`documentAccess`、`allowedDomains`、`storage`、`capabilities`
 - 当前 Wasm 执行底座：Node 原生 `WebAssembly` 与 Wasmtime `serve`
-- 分发包形态：`.napp`（底层为 zip）
+- 分发包形态：`.napp`（底层为 zip，支持 `source` / `bundle` 双模式）
 - 安装目录：`~/.nextclaw/apps/packages/<app-id>/<version>/`
 - 用户数据目录：`~/.nextclaw/apps/data/<app-id>/`
 - 本地 registry：`~/.nextclaw/apps/registry.json`
@@ -74,11 +75,22 @@ 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
@@ -120,6 +132,11 @@ napp permissions nextclaw.my-first-napp
 napp run nextclaw.my-first-napp
 ```
 
+模板选择建议：
+
+- `ts-http`：默认推荐，开发体验优先，适合大多数普通前后端小应用
+- `ts-http-lite`：体积优先，继续走官方 WASI HTTP 路线，但不使用默认 Hono 路由层
+
 已有示例应用：
 
 ```bash
@@ -159,6 +176,22 @@ assets/
   checksums.json
 ```
 
+## 分发模式
+
+`.napp` 仍然是统一容器，但现在支持两种分发模式：
+
+- `source`：默认模式。包里主要是用户源码、UI、资源和 manifest；安装时本地物化成运行态，适合轻量分发。
+- `bundle`：显式模式。包里直接带运行态 `main/app.wasm`，适合高级用户、确定性发布或离线场景。
+
+命令示例：
+
+```bash
+napp validate-publish ./my-first-napp --mode source
+napp pack ./my-first-napp --mode source
+napp publish ./my-first-napp --mode source
+napp pack ./my-first-napp --mode bundle
+```
+
 ## Registry Metadata 结构
 
 registry 按 npm 风格使用一个 base URL，再按 app id 拉取 metadata 文档。metadata 的最小结构如下：
@@ -179,6 +212,7 @@ registry 按 npm 风格使用一个 base URL，再按 app id 拉取 metadata 文
         "name": "NextClaw Official"
       },
       "dist": {
+        "kind": "source",
         "bundle": "./-/hello-notes-0.2.0.napp",
         "sha256": "<sha256>"
       }

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

@@ -1,5 +1,5 @@
 import { AppManifestService } from "../manifest/app-manifest.service.js";
-import { AppBundleExtractResult, AppBundlePackResult } from "./app-bundle.types.js";
+import { AppBundleExtractResult, AppBundlePackResult, AppDistributionMode } from "./app-bundle.types.js";
 
 //#region src/bundle/app-bundle.service.d.ts
 declare class AppBundleService {
@@ -8,14 +8,19 @@ declare class AppBundleService {
   packAppDirectory: (params: {
     appDirectory: string;
     outputPath?: string;
+    mode?: AppDistributionMode;
   }) => Promise<AppBundlePackResult>;
   extractBundle: (params: {
     bundlePath: string;
     targetDirectory: string;
   }) => Promise<AppBundleExtractResult>;
-  private collectAppFiles;
+  private collectRuntimeFiles;
+  private collectSourceFiles;
   private collectDirectoryPaths;
+  private collectSourceDirectoryPaths;
+  private shouldExcludeSourcePath;
   private buildMetadata;
+  private normalizeMetadata;
   private buildChecksums;
   private computeSha256;
   private normalizeBundleFileName;

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

@@ -9,9 +9,11 @@ var AppBundleService = class {
 		this.manifestService = manifestService;
 	}
 	packAppDirectory = async (params) => {
-		const bundle = await this.manifestService.load(params.appDirectory);
-		const appFiles = await this.collectAppFiles(bundle.appDirectory);
-		const metadata = this.buildMetadata(bundle.manifest.id, bundle.manifest.name, bundle.manifest.version);
+		const { appDirectory, outputPath, mode: requestedMode } = params;
+		const bundle = await this.manifestService.load(appDirectory);
+		const mode = requestedMode ?? "bundle";
+		const { appFiles, filePaths } = mode === "source" ? await this.collectSourceFiles(bundle) : await this.collectRuntimeFiles(bundle);
+		const metadata = this.buildMetadata(bundle.manifest.id, bundle.manifest.name, bundle.manifest.version, mode);
 		const bundleJsonPath = ".napp/bundle.json";
 		const checksumsJsonPath = ".napp/checksums.json";
 		const bundleJsonBytes = strToU8(`${JSON.stringify(metadata, null, 2)}\n`);
@@ -25,12 +27,14 @@ var AppBundleService = class {
 			[bundleJsonPath]: bundleJsonBytes,
 			[checksumsJsonPath]: checksumsJsonBytes
 		}, { level: 9 });
-		const outputPath = params.outputPath ? path.resolve(params.outputPath) : path.join(path.dirname(bundle.appDirectory), `${this.normalizeBundleFileName(bundle.manifest.id)}-${bundle.manifest.version}.napp`);
-		await mkdir(path.dirname(outputPath), { recursive: true });
-		await writeFile(outputPath, Buffer.from(archiveBytes));
+		const resolvedOutputPath = outputPath ? path.resolve(outputPath) : path.join(path.dirname(bundle.appDirectory), `${this.normalizeBundleFileName(bundle.manifest.id)}-${bundle.manifest.version}.napp`);
+		await mkdir(path.dirname(resolvedOutputPath), { recursive: true });
+		await writeFile(resolvedOutputPath, Buffer.from(archiveBytes));
 		return {
-			bundlePath: outputPath,
-			metadata
+			bundlePath: resolvedOutputPath,
+			metadata,
+			sizeBytes: archiveBytes.byteLength,
+			filePaths
 		};
 	};
 	extractBundle = async (params) => {
@@ -49,7 +53,8 @@ var AppBundleService = class {
 			await mkdir(path.dirname(targetPath), { recursive: true });
 			await writeFile(targetPath, Buffer.from(archive[entryName]));
 		}
-		const metadata = await this.readJsonFile(path.join(targetDirectory, ".napp", "bundle.json"), "bundle metadata");
+		const rawMetadata = await this.readJsonFile(path.join(targetDirectory, ".napp", "bundle.json"), "bundle metadata");
+		const metadata = this.normalizeMetadata(rawMetadata);
 		const checksums = await this.readJsonFile(path.join(targetDirectory, ".napp", "checksums.json"), "bundle checksums");
 		await this.verifyChecksums(targetDirectory, checksums);
 		await this.manifestService.load(targetDirectory);
@@ -59,15 +64,36 @@ 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);
+	collectRuntimeFiles = 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
+		};
+	};
+	collectSourceFiles = async (bundle) => {
+		const filePaths = /* @__PURE__ */ new Set();
+		await this.collectSourceDirectoryPaths(bundle.appDirectory, bundle.appDirectory, filePaths);
+		const sortedPaths = Array.from(filePaths).sort((left, right) => left.localeCompare(right));
+		const appFiles = {};
+		for (const relativePath of sortedPaths) {
+			if (bundle.manifest.main.kind === "wasi-http-component" && relativePath === bundle.manifest.main.entry) {
+				appFiles[relativePath] = SOURCE_WASM_PLACEHOLDER_BYTES;
+				continue;
+			}
+			appFiles[relativePath] = new Uint8Array(await readFile(path.join(bundle.appDirectory, relativePath)));
+		}
+		return {
+			appFiles,
+			filePaths: sortedPaths
+		};
 	};
 	collectDirectoryPaths = async (directoryPath, appDirectory, filePaths) => {
 		try {
@@ -85,9 +111,32 @@ var AppBundleService = class {
 			return;
 		}
 	};
-	buildMetadata = (appId, name, version) => {
+	collectSourceDirectoryPaths = async (directoryPath, appDirectory, filePaths) => {
+		try {
+			const entries = await readdir(directoryPath, { withFileTypes: true });
+			for (const entry of entries) {
+				const entryPath = path.join(directoryPath, entry.name);
+				const relativePath = path.relative(appDirectory, entryPath).replace(/\\/g, "/");
+				if (entry.isDirectory()) {
+					if (this.shouldExcludeSourcePath(relativePath)) continue;
+					await this.collectSourceDirectoryPaths(entryPath, appDirectory, filePaths);
+					continue;
+				}
+				if (!entry.isFile()) continue;
+				if (this.shouldExcludeSourcePath(relativePath)) continue;
+				filePaths.add(relativePath);
+			}
+		} catch {
+			return;
+		}
+	};
+	shouldExcludeSourcePath = (relativePath) => {
+		return relativePath === ".napp" || relativePath.startsWith(".napp/") || relativePath === "main/node_modules" || relativePath.startsWith("main/node_modules/") || relativePath === "main/dist" || relativePath.startsWith("main/dist/") || relativePath === "main/generated" || relativePath.startsWith("main/generated/");
+	};
+	buildMetadata = (appId, name, version, distributionMode) => {
 		return {
 			bundleFormatVersion: 1,
+			distributionMode,
 			appId,
 			name,
 			version,
@@ -95,6 +144,17 @@ var AppBundleService = class {
 			checksumsFile: ".napp/checksums.json"
 		};
 	};
+	normalizeMetadata = (rawMetadata) => {
+		return {
+			bundleFormatVersion: 1,
+			distributionMode: rawMetadata.distributionMode === "source" ? "source" : "bundle",
+			appId: String(rawMetadata.appId ?? ""),
+			name: String(rawMetadata.name ?? ""),
+			version: String(rawMetadata.version ?? ""),
+			entryManifest: "manifest.json",
+			checksumsFile: ".napp/checksums.json"
+		};
+	};
 	buildChecksums = (files) => {
 		const entries = Object.entries(files).sort(([left], [right]) => left.localeCompare(right));
 		return {
@@ -129,5 +189,6 @@ var AppBundleService = class {
 		}
 	};
 };
+const SOURCE_WASM_PLACEHOLDER_BYTES = Uint8Array.from(Buffer.from("AGFzbQEAAAABBwFgAn9/AX8DAgEABxMBD3N1bW1hcml6ZV9ub3RlcwAACg0BCwAgACABakHIAWoL", "base64"));
 //#endregion
 export { AppBundleService };

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

@@ -1,6 +1,8 @@
 //#region src/bundle/app-bundle.types.d.ts
+type AppDistributionMode = "bundle" | "source";
 type AppBundleMetadata = {
   bundleFormatVersion: 1;
+  distributionMode: AppDistributionMode;
   appId: string;
   name: string;
   version: string;
@@ -14,6 +16,8 @@ type AppBundleChecksums = {
 type AppBundlePackResult = {
   bundlePath: string;
   metadata: AppBundleMetadata;
+  sizeBytes: number;
+  filePaths: string[];
 };
 type AppBundleExtractResult = {
   appDirectory: string;
@@ -21,4 +25,4 @@ type AppBundleExtractResult = {
   checksums: AppBundleChecksums;
 };
 //#endregion
-export { AppBundleChecksums, AppBundleExtractResult, AppBundleMetadata, AppBundlePackResult };
+export { AppBundleChecksums, AppBundleExtractResult, AppBundleMetadata, AppBundlePackResult, AppDistributionMode };

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

@@ -14,6 +14,7 @@ declare class AppRuntimeCliService {
   private handleDev;
   private handlePack;
   private handlePublish;
+  private handleValidatePublish;
   private handleInstall;
   private handleUpdate;
   private handleUninstall;

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

@@ -1,5 +1,7 @@
 import { version } from "../package.js";
 import { CreateCommand } from "../commands/create.controller.js";
+import { AppRuntimeToolchainService } from "../runtime/app-runtime-toolchain.service.js";
+import { AppBuildService } from "../runtime/app-build.service.js";
 import { RunCommand } from "../commands/run.controller.js";
 import { DevCommand } from "../commands/dev.controller.js";
 import { GrantCommand } from "../commands/grant.controller.js";
@@ -14,8 +16,7 @@ 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 { AppRuntimeToolchainService } from "../runtime/app-runtime-toolchain.service.js";
-import { AppBuildService } from "../runtime/app-build.service.js";
+import { ValidatePublishCommand } from "../commands/validate-publish.controller.js";
 import { AppRuntimeOptionsService } from "./app-runtime-options.service.js";
 //#region src/cli/app-runtime-cli.service.ts
 var AppRuntimeCliService = class {
@@ -64,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;
@@ -187,6 +191,7 @@ var AppRuntimeCliService = class {
 		await new PackCommand().run({
 			appDirectory: target,
 			outputPath: options.outputPath,
+			mode: options.mode,
 			json: options.json,
 			write: this.write
 		});
@@ -199,6 +204,18 @@ var AppRuntimeCliService = class {
 			metadataPath: options.metadataPath,
 			apiBaseUrl: options.apiBaseUrl,
 			token: options.token,
+			mode: options.mode,
+			json: options.json,
+			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,
+			mode: options.mode,
 			json: options.json,
 			write: this.write
 		});
@@ -322,13 +339,14 @@ var AppRuntimeCliService = class {
 		});
 	};
 	writeUsage = () => {
-		this.write("Usage: napp create <app-dir> [--template starter|ts-http] [--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 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 pack <app-dir> [--mode source|bundle] [--out bundle.napp] [--json]\n");
+		this.write("       napp publish <app-dir> [--mode source|bundle] [--meta marketplace.json] [--api-base <url>] [--token <token>] [--json]\n");
+		this.write("       napp validate-publish <app-dir> [--mode source|bundle] [--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,3 +1,4 @@
+import { AppDistributionMode } from "../bundle/app-bundle.types.js";
 import { AppDocumentGrantMap } from "../permissions/app-permissions.types.js";
 import { AppScaffoldTemplate } from "../scaffold/app-scaffold.service.js";
 
@@ -16,6 +17,7 @@ type CreateCliOptions = {
 type PackCliOptions = {
   json: boolean;
   outputPath?: string;
+  mode: AppDistributionMode;
 };
 type BuildCliOptions = {
   json: boolean;
@@ -50,6 +52,7 @@ type PublishCliOptions = {
   metadataPath?: string;
   apiBaseUrl?: string;
   token?: string;
+  mode: AppDistributionMode;
 };
 declare class AppRuntimeOptionsService {
   readTarget: (command: string, rawArgs: string[]) => {
@@ -68,6 +71,7 @@ declare class AppRuntimeOptionsService {
   readGrantOptions: (rawArgs: string[]) => GrantCliOptions;
   readRevokeOptions: (rawArgs: string[]) => RevokeCliOptions;
   readPublishOptions: (rawArgs: string[]) => PublishCliOptions;
+  private readDistributionMode;
   private assignDocumentGrant;
   private readDocumentScopeId;
   private requireOptionValue;

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

@@ -31,11 +31,14 @@ var AppRuntimeOptionsService = class {
 		return options;
 	};
 	readCreateTemplate = (rawTemplate) => {
-		if (rawTemplate === "starter" || rawTemplate === "ts-http") return rawTemplate;
-		throw new Error("--template 只支持 starter 或 ts-http。");
+		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 };
+		const options = {
+			json: false,
+			mode: "source"
+		};
 		for (let index = 0; index < rawArgs.length; index += 1) {
 			const current = rawArgs[index];
 			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
@@ -48,6 +51,10 @@ var AppRuntimeOptionsService = class {
 					options.outputPath = this.requireOptionValue(current, nextValue);
 					index += 1;
 					break;
+				case "--mode":
+					options.mode = this.readDistributionMode(this.requireOptionValue(current, nextValue));
+					index += 1;
+					break;
 				default: throw new Error(`未知参数：${current}`);
 			}
 		}
@@ -231,7 +238,10 @@ var AppRuntimeOptionsService = class {
 		return options;
 	};
 	readPublishOptions = (rawArgs) => {
-		const options = { json: false };
+		const options = {
+			json: false,
+			mode: "source"
+		};
 		for (let index = 0; index < rawArgs.length; index += 1) {
 			const current = rawArgs[index];
 			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
@@ -252,11 +262,19 @@ var AppRuntimeOptionsService = class {
 					options.token = this.requireOptionValue(current, nextValue);
 					index += 1;
 					break;
+				case "--mode":
+					options.mode = this.readDistributionMode(this.requireOptionValue(current, nextValue));
+					index += 1;
+					break;
 				default: throw new Error(`未知参数：${current}`);
 			}
 		}
 		return options;
 	};
+	readDistributionMode = (rawMode) => {
+		if (rawMode === "source" || rawMode === "bundle") return rawMode;
+		throw new Error("--mode 只支持 source 或 bundle。");
+	};
 	assignDocumentGrant = (documentGrantMap, rawGrant) => {
 		const delimiterIndex = rawGrant.indexOf("=");
 		if (delimiterIndex < 1) throw new Error("--document 必须使用 scopeId=/absolute/or/relative/path 格式。");

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

@@ -7,6 +7,7 @@ declare class PackCommand {
   run: (params: {
     appDirectory: string;
     outputPath?: string;
+    mode: "source" | "bundle";
     json: boolean;
     write: (text: string) => void;
   }) => Promise<void>;

package/dist/commands/pack.controller.js

@@ -5,10 +5,11 @@ var PackCommand = class {
 		this.bundleService = bundleService;
 	}
 	run = async (params) => {
-		const { appDirectory, outputPath, json, write } = params;
+		const { appDirectory, outputPath, mode, json, write } = params;
 		const result = await this.bundleService.packAppDirectory({
 			appDirectory,
-			outputPath
+			outputPath,
+			mode
 		});
 		if (json) {
 			write(`${JSON.stringify({
@@ -17,7 +18,7 @@ var PackCommand = class {
 			}, null, 2)}\n`);
 			return;
 		}
-		write(`Packed ${result.metadata.name} ${result.metadata.version}\n`);
+		write(`Packed ${result.metadata.name} ${result.metadata.version} (${result.metadata.distributionMode})\n`);
 		write(`Bundle: ${result.bundlePath}\n`);
 	};
 };

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

@@ -9,6 +9,7 @@ declare class PublishCommand {
     metadataPath?: string;
     apiBaseUrl?: string;
     token?: string;
+    mode: "source" | "bundle";
     json: boolean;
     write: (text: string) => void;
   }) => Promise<void>;

package/dist/commands/publish.controller.js

@@ -5,12 +5,13 @@ var PublishCommand = class {
 		this.publishService = publishService;
 	}
 	run = async (params) => {
-		const { appDirectory, metadataPath, apiBaseUrl, token, json, write } = params;
+		const { appDirectory, metadataPath, apiBaseUrl, token, mode, json, write } = params;
 		const result = await this.publishService.publish({
 			appDirectory,
 			metadataPath,
 			apiBaseUrl,
-			token
+			token,
+			mode
 		});
 		if (json) {
 			write(`${JSON.stringify({
@@ -20,7 +21,7 @@ var PublishCommand = class {
 			return;
 		}
 		write(`${result.created ? "Published" : "Updated"} ${result.item.name} (${result.item.appId}) ${result.item.latestVersion}\n`);
-		write(`Bundle: ${result.bundle.path}\n`);
+		write(`Distribution: ${result.distribution.path} (${result.distribution.mode})\n`);
 		if (result.item.webUrl) write(`Details: ${result.item.webUrl}\n`);
 		write(`Install: ${result.item.install.command}\n`);
 	};

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

@@ -0,0 +1,16 @@
+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;
+    mode: "source" | "bundle";
+    json: boolean;
+    write: (text: string) => void;
+  }) => Promise<void>;
+}
+//#endregion
+export { ValidatePublishCommand };

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

@@ -0,0 +1,33 @@
+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, mode, json, write } = params;
+		const result = await this.validationService.validate({
+			appDirectory,
+			metadataPath,
+			mode
+		});
+		if (json) {
+			write(`${JSON.stringify({
+				ok: true,
+				validation: result
+			}, null, 2)}\n`);
+			return;
+		}
+		write(`Publish validation ok for ${result.appId}@${result.version}\n`);
+		write(`Distribution mode: ${result.distributionMode}\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/index.d.ts

@@ -1,6 +1,6 @@
 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 { AppBundleChecksums, AppBundleExtractResult, AppBundleMetadata, AppBundlePackResult, AppDistributionMode } from "./bundle/app-bundle.types.js";
 import { AppBundleService } from "./bundle/app-bundle.service.js";
 import { AppDocumentGrantMap, AppDocumentGrantMutationResult, AppDocumentGrantState, AppInstalledPermissionState, AppPermissionSummary, ResolvedDocumentGrant, ResolvedPermissions } from "./permissions/app-permissions.types.js";
 import { AppPermissionsService } from "./permissions/app-permissions.service.js";
@@ -11,6 +11,7 @@ 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 { 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";
@@ -21,6 +22,8 @@ import { AppInstallSourceKind, AppRegistry, AppRegistryAppRecord, AppRegistryIns
 import { AppRegistryService } from "./registry/app-registry.service.js";
 import { AppGrantService } from "./permissions/app-grant.service.js";
 import { GrantCommand } from "./commands/grant.controller.js";
+import { AppRuntimeCommandResult, AppRuntimeDoctorResult, AppRuntimeToolStatus, AppRuntimeToolchainService } from "./runtime/app-runtime-toolchain.service.js";
+import { AppBuildResult, AppBuildService } from "./runtime/app-build.service.js";
 import { AppRegistryConfigService } from "./registry/app-registry-config.service.js";
 import { AppRemoteRegistryClientService } from "./registry/app-remote-registry-client.service.js";
 import { AppInfoResult, AppInstallResult, AppLaunchResolution, AppUninstallResult, AppUpdateResult, InstalledAppListItem } from "./install/app-installation.types.js";
@@ -40,9 +43,9 @@ 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 { 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, AppPublisher, AppRegistry, AppRegistryAppRecord, AppRegistryConfig, AppRegistryConfigService, AppRegistryConfigSnapshot, AppRegistryInstalledVersion, AppRegistryService, AppRemoteRegistryClientService, AppRemoteRegistryDocument, AppRemoteRegistryResolution, AppRemoteRegistryVersion, AppRunResult, AppRuntimeCliService, AppRuntimeCommandResult, AppRuntimeDoctorResult, AppRuntimeOptionsService, AppRuntimeToolStatus, AppRuntimeToolchainService, AppScaffoldFile, AppScaffoldResult, AppScaffoldService, AppScaffoldTemplate, 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, WasmDocumentSummaryInput, WasmMainRunnerService, WasmSidecarClientService, WasmtimeWasiHttpComponentHandle, WasmtimeWasiHttpComponentService, WasmtimeWasiHttpComponentStartOptions };
+export { AppBuildResult, AppBuildService, AppBundleChecksums, AppBundleExtractResult, AppBundleMetadata, AppBundlePackResult, AppBundleService, AppCoreWasmMainManifest, AppDistributionMode, 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 };