@nextclaw/app-runtime 0.6.0 → 0.7.1-beta.0

package/README.md

@@ -10,9 +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 pack <app-dir>`：把应用目录打成 `.napp` 分发包，默认使用轻量 `source` 模式
 - `napp validate-publish <app-dir>`：本地做发布前校验并输出体积/包内容 warning
-- `napp publish <app-dir>`：把应用目录发布到官方 apps registry
+- `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>`：卸载已安装应用
@@ -59,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`
@@ -176,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 的最小结构如下：
@@ -196,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, filePaths } = await this.collectAppFiles(bundle);
-		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,11 +27,11 @@ 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,
+			bundlePath: resolvedOutputPath,
 			metadata,
 			sizeBytes: archiveBytes.byteLength,
 			filePaths
@@ -51,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);
@@ -61,7 +64,7 @@ var AppBundleService = class {
 			checksums
 		};
 	};
-	collectAppFiles = async (bundle) => {
+	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);
@@ -75,6 +78,23 @@ var AppBundleService = class {
 			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 {
 			const entries = await readdir(directoryPath, { withFileTypes: true });
@@ -91,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,
@@ -101,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 {
@@ -135,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;
@@ -23,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.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";
@@ -15,8 +17,6 @@ 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 {
@@ -191,6 +191,7 @@ var AppRuntimeCliService = class {
 		await new PackCommand().run({
 			appDirectory: target,
 			outputPath: options.outputPath,
+			mode: options.mode,
 			json: options.json,
 			write: this.write
 		});
@@ -203,6 +204,7 @@ var AppRuntimeCliService = class {
 			metadataPath: options.metadataPath,
 			apiBaseUrl: options.apiBaseUrl,
 			token: options.token,
+			mode: options.mode,
 			json: options.json,
 			write: this.write
 		});
@@ -213,6 +215,7 @@ var AppRuntimeCliService = class {
 		await new ValidatePublishCommand().run({
 			appDirectory: target,
 			metadataPath: options.metadataPath,
+			mode: options.mode,
 			json: options.json,
 			write: this.write
 		});
@@ -341,9 +344,9 @@ var AppRuntimeCliService = class {
 		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 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

@@ -35,7 +35,10 @@ var AppRuntimeOptionsService = class {
 		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

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

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

@@ -5,10 +5,11 @@ var ValidatePublishCommand = class {
 		this.validationService = validationService;
 	}
 	run = async (params) => {
-		const { appDirectory, metadataPath, json, write } = params;
+		const { appDirectory, metadataPath, mode, json, write } = params;
 		const result = await this.validationService.validate({
 			appDirectory,
-			metadataPath
+			metadataPath,
+			mode
 		});
 		if (json) {
 			write(`${JSON.stringify({
@@ -18,6 +19,7 @@ var ValidatePublishCommand = class {
 			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`);

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";
@@ -22,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";
@@ -45,7 +47,5 @@ import { AppPublishValidationResult, AppPublishValidationService, AppPublishVali
 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, 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 };
+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 };

package/dist/index.js

@@ -13,6 +13,8 @@ import { WasmSidecarClientService } from "./sidecar/wasm-sidecar-client.service.
 import { WasmMainRunnerService } from "./runtime/wasm-main-runner.service.js";
 import { AppInstanceService } from "./host/app-instance.service.js";
 import { AppHomeService } from "./paths/app-home.service.js";
+import { AppRuntimeToolchainService } from "./runtime/app-runtime-toolchain.service.js";
+import { AppBuildService } from "./runtime/app-build.service.js";
 import { DEFAULT_APP_REGISTRY_URL } from "./registry/app-remote-registry.types.js";
 import { AppRegistryConfigService } from "./registry/app-registry-config.service.js";
 import { AppRemoteRegistryClientService } from "./registry/app-remote-registry-client.service.js";
@@ -38,8 +40,6 @@ import { UninstallCommand } from "./commands/uninstall.controller.js";
 import { UpdateCommand } from "./commands/update.controller.js";
 import { AppPublishValidationService } from "./publish/app-publish-validation.service.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 "./cli/app-runtime-options.service.js";
 import { AppRuntimeCliService } from "./cli/app-runtime-cli.service.js";
 export { AppBuildService, AppBundleService, AppGrantService, AppHomeService, AppHostService, AppInstallationService, AppInstanceService, AppManifestService, AppMarketplaceClientService, AppMarketplaceMetadataService, AppPermissionsService, AppPublishService, AppPublishValidationService, AppRegistryConfigService, AppRegistryService, AppRemoteRegistryClientService, AppRuntimeCliService, AppRuntimeOptionsService, AppRuntimeToolchainService, AppScaffoldService, AppTsHttpLiteScaffoldTemplateService, AppTsHttpScaffoldTemplateService, CreateCommand, DEFAULT_APP_MARKETPLACE_API_BASE, DEFAULT_APP_REGISTRY_URL, GrantCommand, HostBridgeServer, InfoCommand, InstallCommand, ListCommand, MainRunnerService, PackCommand, PermissionsCommand, PlatformAuthStateService, PublishCommand, RegistryCommand, RevokeCommand, UiServerService, UninstallCommand, UpdateCommand, ValidatePublishCommand, WasmMainRunnerService, WasmSidecarClientService, WasmtimeWasiHttpComponentService };

package/dist/install/app-installation.service.d.ts

@@ -3,6 +3,7 @@ import { AppBundleService } from "../bundle/app-bundle.service.js";
 import { AppDocumentGrantMap } from "../permissions/app-permissions.types.js";
 import { AppHomeService } from "../paths/app-home.service.js";
 import { AppRegistryService } from "../registry/app-registry.service.js";
+import { 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 "./app-installation.types.js";
@@ -12,10 +13,11 @@ declare class AppInstallationService {
   private readonly appHomeService;
   private readonly bundleService;
   private readonly manifestService;
+  private readonly buildService;
   private readonly registryService;
   private readonly registryConfigService;
   private readonly remoteRegistryClient;
-  constructor(appHomeService?: AppHomeService, bundleService?: AppBundleService, manifestService?: AppManifestService, registryService?: AppRegistryService, registryConfigService?: AppRegistryConfigService, remoteRegistryClient?: AppRemoteRegistryClientService);
+  constructor(appHomeService?: AppHomeService, bundleService?: AppBundleService, manifestService?: AppManifestService, buildService?: AppBuildService, registryService?: AppRegistryService, registryConfigService?: AppRegistryConfigService, remoteRegistryClient?: AppRemoteRegistryClientService);
   install: (appSource: string, options?: {
     registryUrl?: string;
   }) => Promise<AppInstallResult>;
@@ -32,6 +34,7 @@ declare class AppInstallationService {
   private detectLocalSourceType;
   private parseRegistrySpec;
   private looksLikePath;
+  private materializeDistribution;
 }
 //#endregion
 export { AppInstallationService };

package/dist/install/app-installation.service.js

@@ -1,6 +1,7 @@
 import { AppManifestService } from "../manifest/app-manifest.service.js";
 import { AppBundleService } from "../bundle/app-bundle.service.js";
 import { AppHomeService } from "../paths/app-home.service.js";
+import { 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 { AppRegistryService } from "../registry/app-registry.service.js";
@@ -8,10 +9,11 @@ import { access, cp, mkdir, rm } from "node:fs/promises";
 import path from "node:path";
 //#region src/install/app-installation.service.ts
 var AppInstallationService = class {
-	constructor(appHomeService = new AppHomeService(), bundleService = new AppBundleService(), manifestService = new AppManifestService(), registryService = new AppRegistryService(appHomeService), registryConfigService = new AppRegistryConfigService(appHomeService), remoteRegistryClient = new AppRemoteRegistryClientService(new AppRegistryConfigService(appHomeService))) {
+	constructor(appHomeService = new AppHomeService(), bundleService = new AppBundleService(), manifestService = new AppManifestService(), buildService = new AppBuildService(), registryService = new AppRegistryService(appHomeService), registryConfigService = new AppRegistryConfigService(appHomeService), remoteRegistryClient = new AppRemoteRegistryClientService(new AppRegistryConfigService(appHomeService))) {
 		this.appHomeService = appHomeService;
 		this.bundleService = bundleService;
 		this.manifestService = manifestService;
+		this.buildService = buildService;
 		this.registryService = registryService;
 		this.registryConfigService = registryConfigService;
 		this.remoteRegistryClient = remoteRegistryClient;
@@ -28,10 +30,14 @@ var AppInstallationService = class {
 				targetDirectory: tempDirectory
 			})).bundlePath;
 			const extractedDirectory = path.join(tempDirectory, "bundle");
-			await this.bundleService.extractBundle({
+			const extractedMetadata = await this.bundleService.extractBundle({
 				bundlePath,
 				targetDirectory: extractedDirectory
 			});
+			await this.materializeDistribution({
+				appDirectory: extractedDirectory,
+				distributionMode: extractedMetadata.metadata.distributionMode
+			});
 			const manifestBundle = await this.manifestService.load(extractedDirectory);
 			const installDirectory = this.appHomeService.getInstallDirectory(manifestBundle.manifest.id, manifestBundle.manifest.version);
 			if (source.kind === "registry" && manifestBundle.manifest.id !== source.registryResolution.appId) throw new Error(`bundle manifest.appId 与 registry 请求不一致：期望 ${source.registryResolution.appId}，实际 ${manifestBundle.manifest.id}`);
@@ -51,6 +57,7 @@ var AppInstallationService = class {
 				installDirectory,
 				dataDirectory,
 				sourceKind: source.kind,
+				distributionMode: source.kind === "registry" ? source.registryResolution.distributionMode : extractedMetadata.metadata.distributionMode,
 				sourceRef: source.sourceRef,
 				installedAt: (/* @__PURE__ */ new Date()).toISOString(),
 				permissions: manifestBundle.manifest.permissions ?? {},
@@ -67,6 +74,7 @@ var AppInstallationService = class {
 				dataDirectory,
 				sourceKind: source.kind,
 				sourceRef: source.sourceRef,
+				distributionMode: registryRecord.installedVersions[registryRecord.activeVersion]?.distributionMode,
 				permissions: registryRecord.installedVersions[registryRecord.activeVersion]?.permissions ?? {},
 				registryUrl: registryRecord.installedVersions[registryRecord.activeVersion]?.registryUrl,
 				bundleUrl: registryRecord.installedVersions[registryRecord.activeVersion]?.bundleUrl,
@@ -138,7 +146,8 @@ var AppInstallationService = class {
 			appId: appRecord.appId,
 			name: appRecord.name,
 			activeVersion: appRecord.activeVersion,
-			sourceKind: appRecord.installedVersions[appRecord.activeVersion]?.sourceKind ?? "directory"
+			sourceKind: appRecord.installedVersions[appRecord.activeVersion]?.sourceKind ?? "directory",
+			distributionMode: appRecord.installedVersions[appRecord.activeVersion]?.distributionMode
 		}));
 	};
 	info = async (appId) => {
@@ -155,6 +164,7 @@ var AppInstallationService = class {
 				version: versionRecord.version,
 				installDirectory: versionRecord.installDirectory,
 				sourceKind: versionRecord.sourceKind,
+				distributionMode: versionRecord.distributionMode,
 				sourceRef: versionRecord.sourceRef,
 				installedAt: versionRecord.installedAt,
 				permissions: versionRecord.permissions,
@@ -251,6 +261,14 @@ var AppInstallationService = class {
 	looksLikePath = (appSource) => {
 		return appSource.startsWith(".") || appSource.startsWith("/") || appSource.includes(path.sep);
 	};
+	materializeDistribution = async (params) => {
+		if (params.distributionMode !== "source") return;
+		if ((await this.manifestService.load(params.appDirectory)).manifest.main.kind !== "wasi-http-component") return;
+		await this.buildService.build({
+			appDirectory: params.appDirectory,
+			install: true
+		});
+	};
 };
 //#endregion
 export { AppInstallationService };

package/dist/install/app-installation.types.d.ts

@@ -1,4 +1,5 @@
 import { AppPermissions } from "../manifest/app-manifest.types.js";
+import { AppDistributionMode } from "../bundle/app-bundle.types.js";
 import { AppDocumentGrantMap } from "../permissions/app-permissions.types.js";
 import { AppPublisher } from "../registry/app-remote-registry.types.js";
 import { AppInstallSourceKind } from "../registry/app-registry.types.js";
@@ -11,6 +12,7 @@ type AppInstallResult = {
   installDirectory: string;
   dataDirectory: string;
   sourceKind: AppInstallSourceKind;
+  distributionMode?: AppDistributionMode;
   sourceRef: string;
   permissions: AppPermissions;
   registryUrl?: string;
@@ -28,6 +30,7 @@ type AppInfoResult = {
     version: string;
     installDirectory: string;
     sourceKind: AppInstallSourceKind;
+    distributionMode?: AppDistributionMode;
     sourceRef: string;
     installedAt: string;
     permissions: AppPermissions;
@@ -43,6 +46,7 @@ type InstalledAppListItem = {
   name: string;
   activeVersion: string;
   sourceKind: AppInstallSourceKind;
+  distributionMode?: AppDistributionMode;
 };
 type AppUninstallResult = {
   appId: string;

package/dist/package.js

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "0.6.0";
+var version = "0.7.1-beta.0";
 //#endregion
 export { version };

package/dist/publish/app-publish-validation.service.d.ts

@@ -1,4 +1,5 @@
 import { AppManifestService } from "../manifest/app-manifest.service.js";
+import { AppDistributionMode } from "../bundle/app-bundle.types.js";
 import { AppBundleService } from "../bundle/app-bundle.service.js";
 import { AppMarketplaceMetadataService } from "./app-marketplace-metadata.service.js";
 
@@ -14,6 +15,7 @@ type AppPublishValidationResult = {
   metadataPath: string;
   appId: string;
   version: string;
+  distributionMode: AppDistributionMode;
   mainKind: string;
   mainEntryPath: string;
   mainEntrySizeBytes: number;
@@ -29,6 +31,7 @@ declare class AppPublishValidationService {
   validate: (params: {
     appDirectory: string;
     metadataPath?: string;
+    mode?: AppDistributionMode;
   }) => Promise<AppPublishValidationResult>;
   private buildWarnings;
   private formatBytes;

package/dist/publish/app-publish-validation.service.js

@@ -14,9 +14,11 @@ var AppPublishValidationService = class {
 		this.bundleService = bundleService;
 	}
 	validate = async (params) => {
-		const appDirectory = path.resolve(params.appDirectory);
+		const { appDirectory: inputAppDirectory, metadataPath: inputMetadataPath, mode } = params;
+		const appDirectory = path.resolve(inputAppDirectory);
+		const distributionMode = mode ?? "source";
 		const bundle = await this.manifestService.load(appDirectory);
-		const metadataPath = params.metadataPath ? path.resolve(params.metadataPath) : path.join(appDirectory, "marketplace.json");
+		const metadataPath = inputMetadataPath ? path.resolve(inputMetadataPath) : path.join(appDirectory, "marketplace.json");
 		await this.metadataService.load({
 			appDirectory,
 			manifest: bundle.manifest,
@@ -26,7 +28,8 @@ var AppPublishValidationService = class {
 		try {
 			const packResult = await this.bundleService.packAppDirectory({
 				appDirectory,
-				outputPath: path.join(tempDirectory, `${bundle.manifest.id}-${bundle.manifest.version}.napp`)
+				outputPath: path.join(tempDirectory, `${bundle.manifest.id}-${bundle.manifest.version}.napp`),
+				mode: distributionMode
 			});
 			const mainEntryStats = await stat(bundle.mainEntryPath);
 			const warnings = this.buildWarnings({
@@ -39,6 +42,7 @@ var AppPublishValidationService = class {
 				metadataPath,
 				appId: bundle.manifest.id,
 				version: bundle.manifest.version,
+				distributionMode,
 				mainKind: bundle.manifest.main.kind,
 				mainEntryPath: bundle.mainEntryPath,
 				mainEntrySizeBytes: mainEntryStats.size,

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

@@ -1,4 +1,5 @@
 import { AppManifestService } from "../manifest/app-manifest.service.js";
+import { AppDistributionMode } from "../bundle/app-bundle.types.js";
 import { AppBundleService } from "../bundle/app-bundle.service.js";
 import { AppPublishResult } from "./app-publish.types.js";
 import { AppMarketplaceClientService } from "./app-marketplace-client.service.js";
@@ -18,6 +19,7 @@ declare class AppPublishService {
     metadataPath?: string;
     apiBaseUrl?: string;
     token?: string;
+    mode?: AppDistributionMode;
   }) => Promise<AppPublishResult>;
   private resolvePublishActor;
   private fetchCurrentPlatformUser;

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

@@ -18,6 +18,7 @@ var AppPublishService = class {
 	}
 	publish = async (params) => {
 		const { appDirectory: inputAppDirectory, metadataPath, apiBaseUrl, token } = params;
+		const distributionMode = params.mode ?? "source";
 		const appDirectory = path.resolve(inputAppDirectory);
 		const manifestBundle = await this.manifestService.load(appDirectory);
 		const metadata = await this.metadataService.load({
@@ -30,7 +31,10 @@ var AppPublishService = class {
 			explicitToken: token,
 			appId: manifestBundle.manifest.id
 		});
-		const bundle = await this.bundleService.packAppDirectory({ appDirectory });
+		const bundle = await this.bundleService.packAppDirectory({
+			appDirectory,
+			mode: distributionMode
+		});
 		const bundleBytes = Buffer.from(await readFile(bundle.bundlePath));
 		const bundleSha256 = createHash("sha256").update(bundleBytes).digest("hex");
 		const publishFiles = await this.metadataService.collectPublishFiles({
@@ -52,6 +56,7 @@ var AppPublishService = class {
 			homepage: metadata.homepage,
 			featured: metadata.featured ?? false,
 			publisher: actor.publisher,
+			distributionMode,
 			manifest: manifestBundle.manifest,
 			permissions: manifestBundle.manifest.permissions ?? {},
 			bundleBase64: bundleBytes.toString("base64"),
@@ -67,9 +72,10 @@ var AppPublishService = class {
 				apiBaseUrl,
 				token: actor.token
 			}),
-			bundle: {
+			distribution: {
 				path: bundle.bundlePath,
-				sha256: bundleSha256
+				sha256: bundleSha256,
+				mode: distributionMode
 			}
 		};
 	};

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

@@ -1,4 +1,5 @@
 import { AppManifest, AppPermissions } from "../manifest/app-manifest.types.js";
+import { AppDistributionMode } from "../bundle/app-bundle.types.js";
 import { AppPublisher } from "../registry/app-remote-registry.types.js";
 
 //#region src/publish/app-publish.types.d.ts
@@ -35,6 +36,7 @@ type AppPublishPayload = {
   homepage?: string;
   featured: boolean;
   publisher: AppPublisher;
+  distributionMode: AppDistributionMode;
   manifest: AppManifest;
   permissions: AppPermissions;
   bundleBase64: string;
@@ -56,9 +58,10 @@ type AppPublishResult = {
       registry: string;
     };
   };
-  bundle: {
+  distribution: {
     path: string;
     sha256: string;
+    mode: AppDistributionMode;
   };
   fileCount: number;
 };

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

@@ -22,6 +22,7 @@ declare class AppRegistryService {
     sourceKind: AppInstallSourceKind;
     sourceRef: string;
     installedAt: string;
+    distributionMode?: AppRegistryInstalledVersion["distributionMode"];
     permissions: AppPermissions;
     registryUrl?: string;
     bundleUrl?: string;

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

@@ -36,7 +36,7 @@ var AppRegistryService = class {
 		return appRecord.installedVersions[appRecord.activeVersion];
 	};
 	upsertInstallation = async (params) => {
-		const { appId, name, description, version, installDirectory, dataDirectory, sourceKind, sourceRef, installedAt, permissions, registryUrl, bundleUrl, sha256, publisher } = params;
+		const { appId, name, description, version, installDirectory, dataDirectory, sourceKind, sourceRef, installedAt, distributionMode, permissions, registryUrl, bundleUrl, sha256, publisher } = params;
 		const registry = await this.load();
 		const currentRecord = registry.apps[appId];
 		const nextRecord = {
@@ -53,6 +53,7 @@ var AppRegistryService = class {
 					sourceKind,
 					sourceRef,
 					installedAt,
+					distributionMode,
 					permissions,
 					registryUrl,
 					bundleUrl,

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

@@ -1,4 +1,5 @@
 import { AppPermissions } from "../manifest/app-manifest.types.js";
+import { AppDistributionMode } from "../bundle/app-bundle.types.js";
 import { AppDocumentGrantMap } from "../permissions/app-permissions.types.js";
 import { AppPublisher } from "./app-remote-registry.types.js";
 
@@ -10,6 +11,7 @@ type AppRegistryInstalledVersion = {
   sourceKind: AppInstallSourceKind;
   sourceRef: string;
   installedAt: string;
+  distributionMode?: AppDistributionMode;
   permissions: AppPermissions;
   registryUrl?: string;
   bundleUrl?: string;

package/dist/registry/app-remote-registry-client.service.js

@@ -25,7 +25,8 @@ var AppRemoteRegistryClientService = class {
 			description: versionRecord.description ?? document.description,
 			publisher: versionRecord.publisher,
 			permissions: versionRecord.permissions,
-			bundleUrl: new URL(versionRecord.dist.bundle, metadataUrl).toString(),
+			distributionMode: versionRecord.dist.kind === "source" ? "source" : "bundle",
+			bundleUrl: new URL(versionRecord.dist.artifact ?? versionRecord.dist.source ?? versionRecord.dist.bundle, metadataUrl).toString(),
 			sha256: versionRecord.dist.sha256
 		};
 	};
@@ -72,7 +73,10 @@ var AppRemoteRegistryClientService = class {
 			publisher: this.parsePublisher(candidate.publisher, version),
 			permissions: candidate.permissions,
 			dist: {
+				kind: distCandidate.kind === "source" || distCandidate.kind === "bundle" ? distCandidate.kind : void 0,
+				artifact: this.readOptionalString(distCandidate.artifact, `versions.${version}.dist.artifact`),
 				bundle: this.readRequiredString(distCandidate.bundle, `versions.${version}.dist.bundle`),
+				source: this.readOptionalString(distCandidate.source, `versions.${version}.dist.source`),
 				sha256: this.readRequiredString(distCandidate.sha256, `versions.${version}.dist.sha256`)
 			}
 		};

package/dist/registry/app-remote-registry.types.d.ts

@@ -1,4 +1,5 @@
 import { AppPermissions } from "../manifest/app-manifest.types.js";
+import { AppDistributionMode } from "../bundle/app-bundle.types.js";
 
 //#region src/registry/app-remote-registry.types.d.ts
 declare const DEFAULT_APP_REGISTRY_URL = "https://apps-registry.nextclaw.io/api/v1/apps/registry/";
@@ -25,7 +26,10 @@ type AppRemoteRegistryVersion = {
   publisher?: AppPublisher;
   permissions?: AppPermissions;
   dist: {
+    kind?: AppDistributionMode;
+    artifact?: string;
     bundle: string;
+    source?: string;
     sha256: string;
   };
 };
@@ -45,6 +49,7 @@ type AppRemoteRegistryResolution = {
   description?: string;
   publisher?: AppPublisher;
   permissions?: AppPermissions;
+  distributionMode: AppDistributionMode;
   bundleUrl: string;
   sha256: string;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/app-runtime",
-  "version": "0.6.0",
+  "version": "0.7.1-beta.0",
   "private": false,
   "description": "Standalone micro app runtime and CLI for NextClaw apps.",
   "type": "module",