@nextclaw/app-runtime 0.5.0 → 0.7.0

package/dist/index.js

@@ -2,6 +2,7 @@ import { AppManifestService } from "./manifest/app-manifest.service.js";
 import { AppBundleService } from "./bundle/app-bundle.service.js";
 import { HostBridgeServer } from "./bridge/host-bridge.service.js";
 import { AppTsHttpScaffoldTemplateService } from "./scaffold/app-ts-http-scaffold-template.service.js";
+import { AppTsHttpLiteScaffoldTemplateService } from "./scaffold/app-ts-http-lite-scaffold-template.service.js";
 import { AppScaffoldService } from "./scaffold/app-scaffold.service.js";
 import { CreateCommand } from "./commands/create.controller.js";
 import { UiServerService } from "./ui/ui-server.service.js";
@@ -12,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";
@@ -35,8 +38,8 @@ 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 { AppPublishValidationService } from "./publish/app-publish-validation.service.js";
+import { ValidatePublishCommand } from "./commands/validate-publish.controller.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, AppRegistryConfigService, AppRegistryService, AppRemoteRegistryClientService, AppRuntimeCliService, AppRuntimeOptionsService, AppRuntimeToolchainService, AppScaffoldService, 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, WasmMainRunnerService, WasmSidecarClientService, WasmtimeWasiHttpComponentService };
+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.5.0";
+var version = "0.7.0";
 //#endregion
 export { version };

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

@@ -0,0 +1,40 @@
+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";
+
+//#region src/publish/app-publish-validation.service.d.ts
+type AppPublishValidationWarningCode = "main-entry-large" | "bundle-large";
+type AppPublishValidationWarning = {
+  code: AppPublishValidationWarningCode;
+  message: string;
+};
+type AppPublishValidationResult = {
+  ok: boolean;
+  appDirectory: string;
+  metadataPath: string;
+  appId: string;
+  version: string;
+  distributionMode: AppDistributionMode;
+  mainKind: string;
+  mainEntryPath: string;
+  mainEntrySizeBytes: number;
+  bundleSizeBytes: number;
+  bundleFilePaths: string[];
+  warnings: AppPublishValidationWarning[];
+};
+declare class AppPublishValidationService {
+  private readonly manifestService;
+  private readonly metadataService;
+  private readonly bundleService;
+  constructor(manifestService?: AppManifestService, metadataService?: AppMarketplaceMetadataService, bundleService?: AppBundleService);
+  validate: (params: {
+    appDirectory: string;
+    metadataPath?: string;
+    mode?: AppDistributionMode;
+  }) => Promise<AppPublishValidationResult>;
+  private buildWarnings;
+  private formatBytes;
+}
+//#endregion
+export { AppPublishValidationResult, AppPublishValidationService, AppPublishValidationWarning, AppPublishValidationWarningCode };

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

@@ -0,0 +1,80 @@
+import { AppManifestService } from "../manifest/app-manifest.service.js";
+import { AppBundleService } from "../bundle/app-bundle.service.js";
+import { AppMarketplaceMetadataService } from "./app-marketplace-metadata.service.js";
+import { mkdtemp, rm, stat } from "node:fs/promises";
+import path from "node:path";
+import { tmpdir } from "node:os";
+//#region src/publish/app-publish-validation.service.ts
+const MAIN_ENTRY_WARN_BYTES = 10 * 1024 * 1024;
+const BUNDLE_WARN_BYTES = 5 * 1024 * 1024;
+var AppPublishValidationService = class {
+	constructor(manifestService = new AppManifestService(), metadataService = new AppMarketplaceMetadataService(), bundleService = new AppBundleService()) {
+		this.manifestService = manifestService;
+		this.metadataService = metadataService;
+		this.bundleService = bundleService;
+	}
+	validate = async (params) => {
+		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 = inputMetadataPath ? path.resolve(inputMetadataPath) : path.join(appDirectory, "marketplace.json");
+		await this.metadataService.load({
+			appDirectory,
+			manifest: bundle.manifest,
+			metadataPath
+		});
+		const tempDirectory = await mkdtemp(path.join(tmpdir(), "napp-validate-publish-"));
+		try {
+			const packResult = await this.bundleService.packAppDirectory({
+				appDirectory,
+				outputPath: path.join(tempDirectory, `${bundle.manifest.id}-${bundle.manifest.version}.napp`),
+				mode: distributionMode
+			});
+			const mainEntryStats = await stat(bundle.mainEntryPath);
+			const warnings = this.buildWarnings({
+				mainEntrySizeBytes: mainEntryStats.size,
+				bundleSizeBytes: packResult.sizeBytes
+			});
+			return {
+				ok: true,
+				appDirectory,
+				metadataPath,
+				appId: bundle.manifest.id,
+				version: bundle.manifest.version,
+				distributionMode,
+				mainKind: bundle.manifest.main.kind,
+				mainEntryPath: bundle.mainEntryPath,
+				mainEntrySizeBytes: mainEntryStats.size,
+				bundleSizeBytes: packResult.sizeBytes,
+				bundleFilePaths: packResult.filePaths,
+				warnings
+			};
+		} finally {
+			await rm(tempDirectory, {
+				recursive: true,
+				force: true
+			});
+		}
+	};
+	buildWarnings = (params) => {
+		const { bundleSizeBytes, mainEntrySizeBytes } = params;
+		const warnings = [];
+		if (mainEntrySizeBytes > MAIN_ENTRY_WARN_BYTES) warnings.push({
+			code: "main-entry-large",
+			message: `main entry is ${this.formatBytes(mainEntrySizeBytes)}, which is larger than the ${this.formatBytes(MAIN_ENTRY_WARN_BYTES)} warning threshold.`
+		});
+		if (bundleSizeBytes > BUNDLE_WARN_BYTES) warnings.push({
+			code: "bundle-large",
+			message: `packed .napp is ${this.formatBytes(bundleSizeBytes)}, which is larger than the ${this.formatBytes(BUNDLE_WARN_BYTES)} warning threshold.`
+		});
+		return warnings;
+	};
+	formatBytes = (value) => {
+		if (value < 1024) return `${value} B`;
+		if (value < 1024 * 1024) return `${(value / 1024).toFixed(1)} KB`;
+		return `${(value / (1024 * 1024)).toFixed(1)} MB`;
+	};
+};
+//#endregion
+export { AppPublishValidationService };

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/dist/scaffold/app-scaffold.service.d.ts

@@ -1,7 +1,8 @@
 import { AppTsHttpScaffoldTemplateService } from "./app-ts-http-scaffold-template.service.js";
+import { AppTsHttpLiteScaffoldTemplateService } from "./app-ts-http-lite-scaffold-template.service.js";
 
 //#region src/scaffold/app-scaffold.service.d.ts
-type AppScaffoldTemplate = "starter" | "ts-http";
+type AppScaffoldTemplate = "starter" | "ts-http" | "ts-http-lite";
 type AppScaffoldResult = {
   appDirectory: string;
   manifestPath: string;
@@ -9,7 +10,8 @@ type AppScaffoldResult = {
 };
 declare class AppScaffoldService {
   private readonly tsHttpTemplateService;
-  constructor(tsHttpTemplateService?: AppTsHttpScaffoldTemplateService);
+  private readonly tsHttpLiteTemplateService;
+  constructor(tsHttpTemplateService?: AppTsHttpScaffoldTemplateService, tsHttpLiteTemplateService?: AppTsHttpLiteScaffoldTemplateService);
   scaffold: (targetDirectory: string, options?: {
     template?: AppScaffoldTemplate;
   }) => Promise<AppScaffoldResult>;

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

@@ -1,10 +1,12 @@
 import { AppTsHttpScaffoldTemplateService } from "./app-ts-http-scaffold-template.service.js";
+import { AppTsHttpLiteScaffoldTemplateService } from "./app-ts-http-lite-scaffold-template.service.js";
 import { access, mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
 //#region src/scaffold/app-scaffold.service.ts
 var AppScaffoldService = class {
-	constructor(tsHttpTemplateService = new AppTsHttpScaffoldTemplateService()) {
+	constructor(tsHttpTemplateService = new AppTsHttpScaffoldTemplateService(), tsHttpLiteTemplateService = new AppTsHttpLiteScaffoldTemplateService()) {
 		this.tsHttpTemplateService = tsHttpTemplateService;
+		this.tsHttpLiteTemplateService = tsHttpLiteTemplateService;
 	}
 	scaffold = async (targetDirectory, options) => {
 		const appDirectory = path.resolve(targetDirectory);
@@ -27,6 +29,17 @@ var AppScaffoldService = class {
 				template
 			};
 		}
+		if (template === "ts-http-lite") {
+			await this.writeTemplateFiles(appDirectory, this.tsHttpLiteTemplateService.buildFiles({
+				appId,
+				appName
+			}));
+			return {
+				appDirectory,
+				manifestPath,
+				template
+			};
+		}
 		await Promise.all([
 			writeFile(manifestPath, `${JSON.stringify(this.buildManifest(appId, appName), null, 2)}\n`, "utf-8"),
 			writeFile(path.join(appDirectory, "marketplace.json"), `${JSON.stringify(this.buildMarketplaceMetadata(appName), null, 2)}\n`, "utf-8"),

package/dist/scaffold/app-ts-http-lite-scaffold-template.service.d.ts

@@ -0,0 +1,18 @@
+import { AppScaffoldFile, AppTsHttpScaffoldTemplateService } from "./app-ts-http-scaffold-template.service.js";
+
+//#region src/scaffold/app-ts-http-lite-scaffold-template.service.d.ts
+declare class AppTsHttpLiteScaffoldTemplateService {
+  private readonly standardTemplateService;
+  constructor(standardTemplateService?: AppTsHttpScaffoldTemplateService);
+  buildFiles: (params: {
+    appId: string;
+    appName: string;
+  }) => AppScaffoldFile[];
+  private buildMainPackageJson;
+  private buildMarketplaceMetadata;
+  private buildReadme;
+  private buildComponentSource;
+  private normalizeSlug;
+}
+//#endregion
+export { AppTsHttpLiteScaffoldTemplateService };