@nextclaw/app-runtime 0.9.13 → 0.9.15

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

@@ -0,0 +1,48 @@
+import { AppManifestService } from "./app-manifest.service.js";
+import { AppBundleService } from "./app-bundle.service.js";
+import { AppDocumentGrantMap } from "../types/app-permissions.types.js";
+import { AppHomeService } from "./app-home.service.js";
+import { AppRegistryService } from "./app-registry.service.js";
+import { AppBuildService } from "./app-build.service.js";
+import { AppRegistryConfigService } from "./app-registry-config.service.js";
+import { AppRemoteRegistryClientService } from "./app-remote-registry-client.service.js";
+import { AppActivationResult, AppInfoResult, AppInstallProgressHandler, AppInstallResult, AppLaunchResolution, AppRollbackResult, AppUninstallResult, AppUpdateResult, InstalledAppListItem } from "../types/app-installation.types.js";
+
+//#region src/services/app-installation.service.d.ts
+declare class AppInstallationService {
+  private readonly appHomeService;
+  private readonly bundleService;
+  private readonly manifestService;
+  private readonly buildService;
+  private readonly registryService;
+  private readonly registryConfigService;
+  private readonly remoteRegistryClient;
+  private readonly installSourceService;
+  constructor(appHomeService?: AppHomeService, bundleService?: AppBundleService, manifestService?: AppManifestService, buildService?: AppBuildService, registryService?: AppRegistryService, registryConfigService?: AppRegistryConfigService, remoteRegistryClient?: AppRemoteRegistryClientService);
+  install: (appSource: string, options?: {
+    registryUrl?: string;
+    onProgress?: AppInstallProgressHandler;
+  }) => Promise<AppInstallResult>;
+  update: (appId: string, options?: {
+    version?: string;
+    registryUrl?: string;
+    onProgress?: AppInstallProgressHandler;
+  }) => Promise<AppUpdateResult>;
+  uninstall: (appId: string, purgeData: boolean) => Promise<AppUninstallResult>;
+  list: () => Promise<InstalledAppListItem[]>;
+  reconcileFilesystem: () => Promise<void>;
+  info: (appId: string) => Promise<AppInfoResult>;
+  setEnabled: (appId: string, enabled: boolean) => Promise<AppActivationResult>;
+  rollback: (appId: string, version: string) => Promise<AppRollbackResult>;
+  resolveLaunch: (appReference: string, explicitDocumentGrantMap: AppDocumentGrantMap) => Promise<AppLaunchResolution>;
+  persistGrants: (appId: string | undefined, documentGrantMap: AppDocumentGrantMap) => Promise<void>;
+  private copyToImmutableInstallDirectory;
+  private materializeDistribution;
+  private reconcileGeneratedSiblings;
+  private readDirectories;
+  private pathExists;
+  private isMissingFileError;
+}
+//#endregion
+export { AppInstallationService };
+//# sourceMappingURL=app-installation.service.d.ts.map

package/dist/services/app-installation.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-installation.service.d.ts","names":[],"sources":["../../src/services/app-installation.service.ts"],"mappings":";;;;;;;;;;;cA6Ba,sBAAA;EAAA,iBAIQ,cAAA;EAAA,iBACA,aAAA;EAAA,iBACA,eAAA;EAAA,iBACA,YAAA;EAAA,iBACA,eAAA;EAAA,iBACA,qBAAA;EAAA,iBAGA,oBAAA;EAAA,iBAXF,oBAAA;cAGE,cAAA,GAAgB,cAAA,EAChB,aAAA,GAAe,gBAAA,EACf,eAAA,GAAiB,kBAAA,EACjB,YAAA,GAAc,eAAA,EACd,eAAA,GAAiB,kBAAA,EACjB,qBAAA,GAAuB,wBAAA,EAGvB,oBAAA,GAAsB,8BAAA;EAUzC,OAAA,GACE,SAAA,UACA,OAAA;IACE,WAAA;IACA,UAAA,GAAa,yBAAA;EAAA,MAEd,OAAA,CAAQ,gBAAA;EAoIX,MAAA,GACE,KAAA,UACA,OAAA;IACE,OAAA;IACA,WAAA;IACA,UAAA,GAAa,yBAAA;EAAA,MAEd,OAAA,CAAQ,eAAA;EAiFX,SAAA,GACE,KAAA,UACA,SAAA,cACC,OAAA,CAAQ,kBAAA;EAwDX,IAAA,QAAiB,OAAA,CAAQ,oBAAA;EAkBzB,mBAAA,QAAgC,OAAA;EAiBhC,IAAA,GAAc,KAAA,aAAgB,OAAA,CAAQ,aAAA;EAmCtC,UAAA,GAAoB,KAAA,UAAe,OAAA,cAAmB,OAAA,CAAQ,mBAAA;EAS9D,QAAA,GAAkB,KAAA,UAAe,OAAA,aAAkB,OAAA,CAAQ,iBAAA;EAgC3D,aAAA,GACE,YAAA,UACA,wBAAA,EAA0B,mBAAA,KACzB,OAAA,CAAQ,mBAAA;EA2BX,aAAA,GACE,KAAA,sBACA,gBAAA,EAAkB,mBAAA,KACjB,OAAA;EAAA,QAOK,+BAAA;EAAA,QA4BA,uBAAA;EAAA,QAoBA,0BAAA;EAAA,QAyBA,eAAA;EAAA,QAaA,UAAA;EAAA,QASA,kBAAA;AAAA"}

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

@@ -0,0 +1,411 @@
+import { AppManifestService } from "./app-manifest.service.js";
+import { isAppComponentManifestBundle, isAppStandaloneManifestBundle } from "../types/app-manifest.types.js";
+import { AppBundleService } from "./app-bundle.service.js";
+import { AppHomeService } from "./app-home.service.js";
+import { AppBuildService } from "./app-build.service.js";
+import { AppRegistryConfigService } from "./app-registry-config.service.js";
+import { AppRemoteRegistryClientService } from "./app-remote-registry-client.service.js";
+import { AppRegistryService } from "./app-registry.service.js";
+import { AppInstallSourceService } from "./app-install-source.service.js";
+import { randomUUID } from "node:crypto";
+import { access, cp, mkdir, readdir, rename, rm } from "node:fs/promises";
+import path from "node:path";
+//#region src/services/app-installation.service.ts
+var AppInstallationService = class {
+	installSourceService;
+	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;
+		this.installSourceService = new AppInstallSourceService(this.manifestService, this.remoteRegistryClient);
+	}
+	install = async (appSource, options) => {
+		const { onProgress, registryUrl } = options ?? {};
+		await onProgress?.("resolving");
+		const source = await this.installSourceService.resolve(appSource, registryUrl);
+		const tempDirectory = await this.appHomeService.createTemporaryDirectory("napp-install-");
+		try {
+			if (source.kind === "registry") await onProgress?.("downloading");
+			const bundlePath = source.kind === "directory" ? (await this.bundleService.packAppDirectory({
+				appDirectory: source.appDirectory,
+				outputPath: path.join(tempDirectory, "app.napp")
+			})).bundlePath : source.kind === "bundle" ? source.bundlePath : (await this.remoteRegistryClient.downloadBundle({
+				resolution: source.registryResolution,
+				targetDirectory: tempDirectory
+			})).bundlePath;
+			await onProgress?.("verifying");
+			const extractedDirectory = path.join(tempDirectory, "bundle");
+			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}`);
+			await onProgress?.("installing");
+			const dataDirectory = this.appHomeService.getAppDataDirectory(manifestBundle.manifest.id);
+			await this.copyToImmutableInstallDirectory({
+				appId: manifestBundle.manifest.id,
+				appVersion: manifestBundle.manifest.version,
+				extractedDirectory,
+				installDirectory
+			});
+			await mkdir(dataDirectory, { recursive: true });
+			await onProgress?.("finalizing");
+			let registryRecord;
+			try {
+				registryRecord = await this.registryService.upsertInstallation({
+					appId: manifestBundle.manifest.id,
+					name: manifestBundle.manifest.name,
+					description: manifestBundle.manifest.description,
+					version: manifestBundle.manifest.version,
+					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.schemaVersion === 1 ? manifestBundle.manifest.permissions ?? {} : {},
+					registryUrl: source.kind === "registry" ? source.registryResolution.registryUrl : void 0,
+					bundleUrl: source.kind === "registry" ? source.registryResolution.bundleUrl : void 0,
+					sha256: source.kind === "registry" ? source.registryResolution.sha256 : void 0,
+					publisher: source.kind === "registry" ? source.registryResolution.publisher : void 0,
+					manifestSchemaVersion: manifestBundle.manifest.schemaVersion,
+					components: isAppComponentManifestBundle(manifestBundle) ? manifestBundle.components.map((component) => ({
+						...component,
+						componentDirectory: path.join(installDirectory, component.path),
+						manifestPath: path.join(installDirectory, component.path, component.kind === "panel" ? "panel-app.json" : "service-app.json")
+					})) : void 0,
+					primaryPanelId: isAppComponentManifestBundle(manifestBundle) ? manifestBundle.primaryPanelId : void 0
+				});
+			} catch (error) {
+				await rm(installDirectory, {
+					recursive: true,
+					force: true
+				});
+				throw error;
+			}
+			const activeVersionRecord = registryRecord.installedVersions[registryRecord.activeVersion];
+			return {
+				appId: registryRecord.appId,
+				name: registryRecord.name,
+				version: registryRecord.activeVersion,
+				installDirectory,
+				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,
+				sha256: registryRecord.installedVersions[registryRecord.activeVersion]?.sha256,
+				publisher: registryRecord.installedVersions[registryRecord.activeVersion]?.publisher,
+				enabled: registryRecord.enabled,
+				manifestSchemaVersion: activeVersionRecord?.manifestSchemaVersion ?? 1,
+				components: activeVersionRecord?.components,
+				primaryPanelId: activeVersionRecord?.primaryPanelId
+			};
+		} finally {
+			await rm(tempDirectory, {
+				recursive: true,
+				force: true
+			});
+		}
+	};
+	update = async (appId, options) => {
+		const { onProgress, registryUrl: requestedRegistryUrl, version } = options ?? {};
+		await onProgress?.("resolving");
+		const appRecord = await this.registryService.getApp(appId);
+		if (!appRecord) throw new Error(`未找到已安装应用：${appId}`);
+		const activeVersionRecord = appRecord.installedVersions[appRecord.activeVersion];
+		const registryUrl = requestedRegistryUrl ?? activeVersionRecord?.registryUrl ?? (await this.registryConfigService.getSnapshot()).currentUrl;
+		const resolution = await this.remoteRegistryClient.resolve({
+			appId,
+			version,
+			registryUrl
+		});
+		if (resolution.version === appRecord.activeVersion) {
+			if (!activeVersionRecord) throw new Error(`已安装应用缺少激活版本：${appId}`);
+			return {
+				appId: appRecord.appId,
+				name: appRecord.name,
+				version: appRecord.activeVersion,
+				previousVersion: appRecord.activeVersion,
+				installDirectory: activeVersionRecord.installDirectory,
+				dataDirectory: appRecord.dataDirectory,
+				sourceKind: activeVersionRecord.sourceKind,
+				sourceRef: activeVersionRecord.sourceRef,
+				permissions: activeVersionRecord.permissions,
+				registryUrl: activeVersionRecord.registryUrl,
+				bundleUrl: activeVersionRecord.bundleUrl,
+				sha256: activeVersionRecord.sha256,
+				publisher: activeVersionRecord.publisher,
+				enabled: appRecord.enabled,
+				manifestSchemaVersion: activeVersionRecord.manifestSchemaVersion,
+				components: activeVersionRecord.components,
+				primaryPanelId: activeVersionRecord.primaryPanelId,
+				updated: false
+			};
+		}
+		const installedTarget = appRecord.installedVersions[resolution.version];
+		if (installedTarget) {
+			await onProgress?.("verifying");
+			await onProgress?.("installing");
+			await this.rollback(appId, resolution.version);
+			await onProgress?.("finalizing");
+			return {
+				appId: appRecord.appId,
+				name: appRecord.name,
+				version: resolution.version,
+				previousVersion: appRecord.activeVersion,
+				installDirectory: installedTarget.installDirectory,
+				dataDirectory: appRecord.dataDirectory,
+				sourceKind: installedTarget.sourceKind,
+				distributionMode: installedTarget.distributionMode,
+				sourceRef: installedTarget.sourceRef,
+				permissions: installedTarget.permissions,
+				registryUrl: installedTarget.registryUrl,
+				bundleUrl: installedTarget.bundleUrl,
+				sha256: installedTarget.sha256,
+				publisher: installedTarget.publisher,
+				enabled: appRecord.enabled,
+				manifestSchemaVersion: installedTarget.manifestSchemaVersion,
+				components: installedTarget.components,
+				primaryPanelId: installedTarget.primaryPanelId,
+				updated: true
+			};
+		}
+		return {
+			...await this.install(`${appId}@${resolution.version}`, {
+				registryUrl,
+				onProgress
+			}),
+			previousVersion: appRecord.activeVersion,
+			updated: true
+		};
+	};
+	uninstall = async (appId, purgeData) => {
+		const appRecord = await this.registryService.getApp(appId);
+		if (!appRecord) throw new Error(`未找到已安装应用：${appId}`);
+		const removedVersions = Object.keys(appRecord.installedVersions).sort((left, right) => left.localeCompare(right));
+		const stagedPaths = [];
+		const stagePath = async (originalPath) => {
+			if (!await this.pathExists(originalPath)) return;
+			const stagedPath = `${originalPath}.uninstalling-${randomUUID()}`;
+			await rename(originalPath, stagedPath);
+			stagedPaths.push({
+				originalPath,
+				stagedPath
+			});
+		};
+		const restoreStagedPaths = async () => {
+			for (const entry of [...stagedPaths].reverse()) if (await this.pathExists(entry.stagedPath)) await rename(entry.stagedPath, entry.originalPath);
+		};
+		try {
+			for (const versionRecord of Object.values(appRecord.installedVersions)) await stagePath(versionRecord.installDirectory);
+			if (purgeData) await stagePath(appRecord.dataDirectory);
+			if (!await this.registryService.removeApp(appId)) throw new Error(`卸载过程中应用记录已发生变化：${appId}`);
+		} catch (error) {
+			try {
+				await restoreStagedPaths();
+			} catch (restoreError) {
+				throw new AggregateError([error, restoreError], `卸载 ${appId} 失败，且无法完全恢复已暂存文件。`);
+			}
+			throw error;
+		}
+		await Promise.all(stagedPaths.map((entry) => rm(entry.stagedPath, {
+			recursive: true,
+			force: true
+		})));
+		return {
+			appId,
+			removedVersions,
+			dataRemoved: purgeData
+		};
+	};
+	list = async () => {
+		return (await this.registryService.listApps()).map((appRecord) => ({
+			appId: appRecord.appId,
+			name: appRecord.name,
+			activeVersion: appRecord.activeVersion,
+			sourceKind: appRecord.installedVersions[appRecord.activeVersion]?.sourceKind ?? "directory",
+			distributionMode: appRecord.installedVersions[appRecord.activeVersion]?.distributionMode,
+			enabled: appRecord.enabled,
+			manifestSchemaVersion: appRecord.installedVersions[appRecord.activeVersion]?.manifestSchemaVersion ?? 1,
+			primaryPanelId: appRecord.installedVersions[appRecord.activeVersion]?.primaryPanelId
+		}));
+	};
+	reconcileFilesystem = async () => {
+		await this.appHomeService.ensureBaseDirectories();
+		const appRecords = await this.registryService.listApps();
+		const referencedInstallPaths = new Set(appRecords.flatMap((record) => Object.values(record.installedVersions).map((version) => path.resolve(version.installDirectory))));
+		const referencedDataPaths = new Set(appRecords.map((record) => path.resolve(record.dataDirectory)));
+		const packageDirectories = await this.readDirectories(this.appHomeService.getPackagesDirectory());
+		for (const appDirectory of packageDirectories) await this.reconcileGeneratedSiblings(appDirectory, referencedInstallPaths);
+		await this.reconcileGeneratedSiblings(this.appHomeService.getDataDirectory(), referencedDataPaths);
+	};
+	info = async (appId) => {
+		const appRecord = await this.registryService.getApp(appId);
+		if (!appRecord) throw new Error(`未找到已安装应用：${appId}`);
+		const installedVersions = Object.values(appRecord.installedVersions).sort((left, right) => left.version.localeCompare(right.version));
+		return {
+			appId: appRecord.appId,
+			name: appRecord.name,
+			description: appRecord.description,
+			activeVersion: appRecord.activeVersion,
+			enabled: appRecord.enabled,
+			dataDirectory: appRecord.dataDirectory,
+			installedVersions: installedVersions.map((versionRecord) => ({
+				version: versionRecord.version,
+				installDirectory: versionRecord.installDirectory,
+				sourceKind: versionRecord.sourceKind,
+				distributionMode: versionRecord.distributionMode,
+				sourceRef: versionRecord.sourceRef,
+				installedAt: versionRecord.installedAt,
+				permissions: versionRecord.permissions,
+				registryUrl: versionRecord.registryUrl,
+				bundleUrl: versionRecord.bundleUrl,
+				sha256: versionRecord.sha256,
+				publisher: versionRecord.publisher,
+				manifestSchemaVersion: versionRecord.manifestSchemaVersion,
+				components: versionRecord.components,
+				primaryPanelId: versionRecord.primaryPanelId
+			})),
+			grants: appRecord.grants
+		};
+	};
+	setEnabled = async (appId, enabled) => {
+		const appRecord = await this.registryService.setEnabled(appId, enabled);
+		return {
+			appId: appRecord.appId,
+			activeVersion: appRecord.activeVersion,
+			enabled: appRecord.enabled
+		};
+	};
+	rollback = async (appId, version) => {
+		const currentRecord = await this.registryService.getApp(appId);
+		if (!currentRecord) throw new Error(`未找到已安装应用：${appId}`);
+		if (currentRecord.activeVersion === version) return {
+			appId,
+			activeVersion: version,
+			previousVersion: version,
+			enabled: currentRecord.enabled,
+			rolledBack: false
+		};
+		const targetVersion = currentRecord.installedVersions[version];
+		if (!targetVersion) throw new Error(`应用 ${appId} 未安装版本 ${version}。`);
+		const targetManifest = await this.manifestService.load(targetVersion.installDirectory);
+		if (targetManifest.manifest.id !== appId || targetManifest.manifest.version !== version) throw new Error(`回滚目标 ${appId}@${version} 校验失败。`);
+		const appRecord = await this.registryService.activateVersion(appId, version);
+		return {
+			appId,
+			activeVersion: appRecord.activeVersion,
+			previousVersion: currentRecord.activeVersion,
+			enabled: appRecord.enabled,
+			rolledBack: true
+		};
+	};
+	resolveLaunch = async (appReference, explicitDocumentGrantMap) => {
+		const sourceType = await this.installSourceService.detectLocal(appReference, false);
+		if (sourceType.kind === "directory") return {
+			appDirectory: sourceType.appDirectory,
+			documentGrantMap: explicitDocumentGrantMap
+		};
+		const appRecord = await this.registryService.getApp(appReference);
+		if (!appRecord) throw new Error(`未找到应用目录，也未找到已安装应用：${appReference}`);
+		const activeVersion = appRecord.installedVersions[appRecord.activeVersion];
+		if (!activeVersion) throw new Error(`已安装应用缺少激活版本：${appReference}`);
+		return {
+			appDirectory: activeVersion.installDirectory,
+			appId: appRecord.appId,
+			dataDirectory: appRecord.dataDirectory,
+			documentGrantMap: {
+				...appRecord.grants,
+				...explicitDocumentGrantMap
+			}
+		};
+	};
+	persistGrants = async (appId, documentGrantMap) => {
+		if (!appId || Object.keys(documentGrantMap).length === 0) return;
+		await this.registryService.updateGrants(appId, documentGrantMap);
+	};
+	copyToImmutableInstallDirectory = async (params) => {
+		const { appId, appVersion, extractedDirectory, installDirectory } = params;
+		if (await this.pathExists(installDirectory)) throw new Error(`应用版本目录已存在，不能覆盖不可变版本：${appId}@${appVersion}`);
+		await mkdir(path.dirname(installDirectory), { recursive: true });
+		const stagedInstallDirectory = `${installDirectory}.staging-${randomUUID()}`;
+		try {
+			await cp(extractedDirectory, stagedInstallDirectory, { recursive: true });
+			const stagedManifest = await this.manifestService.load(stagedInstallDirectory);
+			if (stagedManifest.manifest.id !== appId || stagedManifest.manifest.version !== appVersion) throw new Error("staging manifest 与已验证 bundle 身份不一致。");
+			await rename(stagedInstallDirectory, installDirectory);
+		} catch (error) {
+			await rm(stagedInstallDirectory, {
+				recursive: true,
+				force: true
+			});
+			throw error;
+		}
+	};
+	materializeDistribution = async (params) => {
+		if (params.distributionMode !== "source") return;
+		const manifestBundle = await this.manifestService.load(params.appDirectory);
+		if (!isAppStandaloneManifestBundle(manifestBundle)) throw new Error("schema v2 组合包不允许运行安装期 build。");
+		if (manifestBundle.manifest.main.kind !== "wasi-http-component") return;
+		await this.buildService.build({
+			appDirectory: params.appDirectory,
+			install: true
+		});
+	};
+	reconcileGeneratedSiblings = async (parentDirectory, referencedPaths) => {
+		for (const entry of await this.readDirectories(parentDirectory)) {
+			const entryName = path.basename(entry);
+			const stagingMarker = ".staging-";
+			const uninstallingMarker = ".uninstalling-";
+			if (entryName.includes(stagingMarker)) {
+				await rm(entry, {
+					recursive: true,
+					force: true
+				});
+				continue;
+			}
+			const markerIndex = entryName.indexOf(uninstallingMarker);
+			if (markerIndex < 0) continue;
+			const originalPath = path.join(parentDirectory, entryName.slice(0, markerIndex));
+			if (referencedPaths.has(path.resolve(originalPath)) && !await this.pathExists(originalPath)) await rename(entry, originalPath);
+			else await rm(entry, {
+				recursive: true,
+				force: true
+			});
+		}
+	};
+	readDirectories = async (directory) => {
+		try {
+			return (await readdir(directory, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => path.join(directory, entry.name));
+		} catch (error) {
+			if (this.isMissingFileError(error)) return [];
+			throw error;
+		}
+	};
+	pathExists = async (targetPath) => {
+		try {
+			await access(targetPath);
+			return true;
+		} catch {
+			return false;
+		}
+	};
+	isMissingFileError = (error) => typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+};
+//#endregion
+export { AppInstallationService };
+
+//# sourceMappingURL=app-installation.service.js.map

package/dist/services/app-installation.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-installation.service.js","names":[],"sources":["../../src/services/app-installation.service.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { access, cp, mkdir, readdir, rename, rm } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { AppBundleService } from \"#app-runtime/services/app-bundle.service.js\";\nimport { AppManifestService } from \"#app-runtime/services/app-manifest.service.js\";\nimport {\n  isAppComponentManifestBundle,\n  isAppStandaloneManifestBundle,\n} from \"#app-runtime/types/app-manifest.types.js\";\nimport { AppHomeService } from \"#app-runtime/services/app-home.service.js\";\nimport { AppBuildService } from \"#app-runtime/services/app-build.service.js\";\nimport type { AppDistributionMode } from \"#app-runtime/types/app-bundle.types.js\";\nimport type { AppDocumentGrantMap } from \"#app-runtime/types/app-permissions.types.js\";\nimport { AppRegistryConfigService } from \"#app-runtime/services/app-registry-config.service.js\";\nimport { AppRemoteRegistryClientService } from \"#app-runtime/services/app-remote-registry-client.service.js\";\nimport { AppRegistryService } from \"#app-runtime/services/app-registry.service.js\";\nimport { AppInstallSourceService } from \"#app-runtime/services/app-install-source.service.js\";\nimport type {\n  AppInfoResult,\n  AppInstallProgressHandler,\n  AppActivationResult,\n  AppInstallResult,\n  AppLaunchResolution,\n  AppUpdateResult,\n  AppRollbackResult,\n  AppUninstallResult,\n  InstalledAppListItem,\n} from \"#app-runtime/types/app-installation.types.js\";\n\nexport class AppInstallationService {\n  private readonly installSourceService: AppInstallSourceService;\n\n  constructor(\n    private readonly appHomeService: AppHomeService = new AppHomeService(),\n    private readonly bundleService: AppBundleService = new AppBundleService(),\n    private readonly manifestService: AppManifestService = new AppManifestService(),\n    private readonly buildService: AppBuildService = new AppBuildService(),\n    private readonly registryService: AppRegistryService = new AppRegistryService(appHomeService),\n    private readonly registryConfigService: AppRegistryConfigService = new AppRegistryConfigService(\n      appHomeService,\n    ),\n    private readonly remoteRegistryClient: AppRemoteRegistryClientService = new AppRemoteRegistryClientService(\n      new AppRegistryConfigService(appHomeService),\n    ),\n  ) {\n    this.installSourceService = new AppInstallSourceService(\n      this.manifestService,\n      this.remoteRegistryClient,\n    );\n  }\n\n  install = async (\n    appSource: string,\n    options?: {\n      registryUrl?: string;\n      onProgress?: AppInstallProgressHandler;\n    },\n  ): Promise<AppInstallResult> => {\n    const { onProgress, registryUrl } = options ?? {};\n    await onProgress?.(\"resolving\");\n    const source = await this.installSourceService.resolve(appSource, registryUrl);\n    const tempDirectory = await this.appHomeService.createTemporaryDirectory(\"napp-install-\");\n    try {\n      if (source.kind === \"registry\") {\n        await onProgress?.(\"downloading\");\n      }\n      const bundlePath =\n        source.kind === \"directory\"\n          ? (await this.bundleService.packAppDirectory({\n              appDirectory: source.appDirectory,\n              outputPath: path.join(tempDirectory, \"app.napp\"),\n            })).bundlePath\n          : source.kind === \"bundle\"\n            ? source.bundlePath\n            : (\n                await this.remoteRegistryClient.downloadBundle({\n                  resolution: source.registryResolution,\n                  targetDirectory: tempDirectory,\n                })\n              ).bundlePath;\n      await onProgress?.(\"verifying\");\n      const extractedDirectory = path.join(tempDirectory, \"bundle\");\n      const extractedMetadata = await this.bundleService.extractBundle({\n        bundlePath,\n        targetDirectory: extractedDirectory,\n      });\n      await this.materializeDistribution({\n        appDirectory: extractedDirectory,\n        distributionMode: extractedMetadata.metadata.distributionMode,\n      });\n      const manifestBundle = await this.manifestService.load(extractedDirectory);\n      const installDirectory = this.appHomeService.getInstallDirectory(\n        manifestBundle.manifest.id,\n        manifestBundle.manifest.version,\n      );\n      if (\n        source.kind === \"registry\" &&\n        manifestBundle.manifest.id !== source.registryResolution.appId\n      ) {\n        throw new Error(\n          `bundle manifest.appId 与 registry 请求不一致：期望 ${source.registryResolution.appId}，实际 ${manifestBundle.manifest.id}`,\n        );\n      }\n      await onProgress?.(\"installing\");\n      const dataDirectory = this.appHomeService.getAppDataDirectory(manifestBundle.manifest.id);\n      await this.copyToImmutableInstallDirectory({\n        appId: manifestBundle.manifest.id,\n        appVersion: manifestBundle.manifest.version,\n        extractedDirectory,\n        installDirectory,\n      });\n      await mkdir(dataDirectory, { recursive: true });\n      await onProgress?.(\"finalizing\");\n      let registryRecord;\n      try {\n        registryRecord = await this.registryService.upsertInstallation({\n          appId: manifestBundle.manifest.id,\n          name: manifestBundle.manifest.name,\n          description: manifestBundle.manifest.description,\n          version: manifestBundle.manifest.version,\n          installDirectory,\n          dataDirectory,\n          sourceKind: source.kind,\n          distributionMode:\n            source.kind === \"registry\"\n              ? source.registryResolution.distributionMode\n              : extractedMetadata.metadata.distributionMode,\n          sourceRef: source.sourceRef,\n          installedAt: new Date().toISOString(),\n          permissions: manifestBundle.manifest.schemaVersion === 1\n            ? manifestBundle.manifest.permissions ?? {}\n            : {},\n          registryUrl:\n            source.kind === \"registry\" ? source.registryResolution.registryUrl : undefined,\n          bundleUrl:\n            source.kind === \"registry\" ? source.registryResolution.bundleUrl : undefined,\n          sha256: source.kind === \"registry\" ? source.registryResolution.sha256 : undefined,\n          publisher:\n            source.kind === \"registry\" ? source.registryResolution.publisher : undefined,\n          manifestSchemaVersion: manifestBundle.manifest.schemaVersion,\n          components: isAppComponentManifestBundle(manifestBundle)\n            ? manifestBundle.components.map((component) => ({\n                ...component,\n                componentDirectory: path.join(installDirectory, component.path),\n                manifestPath: path.join(\n                  installDirectory,\n                  component.path,\n                  component.kind === \"panel\" ? \"panel-app.json\" : \"service-app.json\",\n                ),\n              }))\n            : undefined,\n          primaryPanelId: isAppComponentManifestBundle(manifestBundle)\n            ? manifestBundle.primaryPanelId\n            : undefined,\n        });\n      } catch (error) {\n        await rm(installDirectory, { recursive: true, force: true });\n        throw error;\n      }\n      const activeVersionRecord = registryRecord.installedVersions[registryRecord.activeVersion];\n      return {\n        appId: registryRecord.appId,\n        name: registryRecord.name,\n        version: registryRecord.activeVersion,\n        installDirectory,\n        dataDirectory,\n        sourceKind: source.kind,\n        sourceRef: source.sourceRef,\n        distributionMode:\n          registryRecord.installedVersions[registryRecord.activeVersion]?.distributionMode,\n        permissions:\n          registryRecord.installedVersions[registryRecord.activeVersion]?.permissions ?? {},\n        registryUrl:\n          registryRecord.installedVersions[registryRecord.activeVersion]?.registryUrl,\n        bundleUrl:\n          registryRecord.installedVersions[registryRecord.activeVersion]?.bundleUrl,\n        sha256: registryRecord.installedVersions[registryRecord.activeVersion]?.sha256,\n        publisher:\n          registryRecord.installedVersions[registryRecord.activeVersion]?.publisher,\n        enabled: registryRecord.enabled,\n        manifestSchemaVersion: activeVersionRecord?.manifestSchemaVersion ?? 1,\n        components: activeVersionRecord?.components,\n        primaryPanelId: activeVersionRecord?.primaryPanelId,\n      };\n    } finally {\n      await rm(tempDirectory, { recursive: true, force: true });\n    }\n  };\n\n  update = async (\n    appId: string,\n    options?: {\n      version?: string;\n      registryUrl?: string;\n      onProgress?: AppInstallProgressHandler;\n    },\n  ): Promise<AppUpdateResult> => {\n    const { onProgress, registryUrl: requestedRegistryUrl, version } = options ?? {};\n    await onProgress?.(\"resolving\");\n    const appRecord = await this.registryService.getApp(appId);\n    if (!appRecord) {\n      throw new Error(`未找到已安装应用：${appId}`);\n    }\n    const activeVersionRecord = appRecord.installedVersions[appRecord.activeVersion];\n    const registryUrl =\n      requestedRegistryUrl ??\n      activeVersionRecord?.registryUrl ??\n      (await this.registryConfigService.getSnapshot()).currentUrl;\n    const resolution = await this.remoteRegistryClient.resolve({\n      appId,\n      version,\n      registryUrl,\n    });\n    if (resolution.version === appRecord.activeVersion) {\n      if (!activeVersionRecord) {\n        throw new Error(`已安装应用缺少激活版本：${appId}`);\n      }\n      return {\n        appId: appRecord.appId,\n        name: appRecord.name,\n        version: appRecord.activeVersion,\n        previousVersion: appRecord.activeVersion,\n        installDirectory: activeVersionRecord.installDirectory,\n        dataDirectory: appRecord.dataDirectory,\n        sourceKind: activeVersionRecord.sourceKind,\n        sourceRef: activeVersionRecord.sourceRef,\n        permissions: activeVersionRecord.permissions,\n        registryUrl: activeVersionRecord.registryUrl,\n        bundleUrl: activeVersionRecord.bundleUrl,\n        sha256: activeVersionRecord.sha256,\n        publisher: activeVersionRecord.publisher,\n        enabled: appRecord.enabled,\n        manifestSchemaVersion: activeVersionRecord.manifestSchemaVersion,\n        components: activeVersionRecord.components,\n        primaryPanelId: activeVersionRecord.primaryPanelId,\n        updated: false,\n      };\n    }\n    const installedTarget = appRecord.installedVersions[resolution.version];\n    if (installedTarget) {\n      await onProgress?.(\"verifying\");\n      await onProgress?.(\"installing\");\n      await this.rollback(appId, resolution.version);\n      await onProgress?.(\"finalizing\");\n      return {\n        appId: appRecord.appId,\n        name: appRecord.name,\n        version: resolution.version,\n        previousVersion: appRecord.activeVersion,\n        installDirectory: installedTarget.installDirectory,\n        dataDirectory: appRecord.dataDirectory,\n        sourceKind: installedTarget.sourceKind,\n        distributionMode: installedTarget.distributionMode,\n        sourceRef: installedTarget.sourceRef,\n        permissions: installedTarget.permissions,\n        registryUrl: installedTarget.registryUrl,\n        bundleUrl: installedTarget.bundleUrl,\n        sha256: installedTarget.sha256,\n        publisher: installedTarget.publisher,\n        enabled: appRecord.enabled,\n        manifestSchemaVersion: installedTarget.manifestSchemaVersion,\n        components: installedTarget.components,\n        primaryPanelId: installedTarget.primaryPanelId,\n        updated: true,\n      };\n    }\n    const installResult = await this.install(`${appId}@${resolution.version}`, {\n      registryUrl,\n      onProgress,\n    });\n    return {\n      ...installResult,\n      previousVersion: appRecord.activeVersion,\n      updated: true,\n    };\n  };\n\n  uninstall = async (\n    appId: string,\n    purgeData: boolean,\n  ): Promise<AppUninstallResult> => {\n    const appRecord = await this.registryService.getApp(appId);\n    if (!appRecord) {\n      throw new Error(`未找到已安装应用：${appId}`);\n    }\n    const removedVersions = Object.keys(appRecord.installedVersions).sort((left, right) =>\n      left.localeCompare(right),\n    );\n    const stagedPaths: Array<{ originalPath: string; stagedPath: string }> = [];\n    const stagePath = async (originalPath: string): Promise<void> => {\n      if (!await this.pathExists(originalPath)) {\n        return;\n      }\n      const stagedPath = `${originalPath}.uninstalling-${randomUUID()}`;\n      await rename(originalPath, stagedPath);\n      stagedPaths.push({ originalPath, stagedPath });\n    };\n    const restoreStagedPaths = async (): Promise<void> => {\n      for (const entry of [...stagedPaths].reverse()) {\n        if (await this.pathExists(entry.stagedPath)) {\n          await rename(entry.stagedPath, entry.originalPath);\n        }\n      }\n    };\n    try {\n      for (const versionRecord of Object.values(appRecord.installedVersions)) {\n        await stagePath(versionRecord.installDirectory);\n      }\n      if (purgeData) {\n        await stagePath(appRecord.dataDirectory);\n      }\n      const removedRecord = await this.registryService.removeApp(appId);\n      if (!removedRecord) {\n        throw new Error(`卸载过程中应用记录已发生变化：${appId}`);\n      }\n    } catch (error) {\n      try {\n        await restoreStagedPaths();\n      } catch (restoreError) {\n        throw new AggregateError(\n          [error, restoreError],\n          `卸载 ${appId} 失败，且无法完全恢复已暂存文件。`,\n        );\n      }\n      throw error;\n    }\n    await Promise.all(stagedPaths.map((entry) =>\n      rm(entry.stagedPath, { recursive: true, force: true }),\n    ));\n    return {\n      appId,\n      removedVersions,\n      dataRemoved: purgeData,\n    };\n  };\n\n  list = async (): Promise<InstalledAppListItem[]> => {\n    const appRecords = await this.registryService.listApps();\n    return appRecords.map((appRecord) => ({\n      appId: appRecord.appId,\n      name: appRecord.name,\n      activeVersion: appRecord.activeVersion,\n      sourceKind:\n        appRecord.installedVersions[appRecord.activeVersion]?.sourceKind ?? \"directory\",\n      distributionMode:\n        appRecord.installedVersions[appRecord.activeVersion]?.distributionMode,\n      enabled: appRecord.enabled,\n      manifestSchemaVersion:\n        appRecord.installedVersions[appRecord.activeVersion]?.manifestSchemaVersion ?? 1,\n      primaryPanelId:\n        appRecord.installedVersions[appRecord.activeVersion]?.primaryPanelId,\n    }));\n  };\n\n  reconcileFilesystem = async (): Promise<void> => {\n    await this.appHomeService.ensureBaseDirectories();\n    const appRecords = await this.registryService.listApps();\n    const referencedInstallPaths = new Set(appRecords.flatMap((record) =>\n      Object.values(record.installedVersions).map((version) => path.resolve(version.installDirectory))));\n    const referencedDataPaths = new Set(appRecords.map((record) => path.resolve(record.dataDirectory)));\n\n    const packageDirectories = await this.readDirectories(this.appHomeService.getPackagesDirectory());\n    for (const appDirectory of packageDirectories) {\n      await this.reconcileGeneratedSiblings(appDirectory, referencedInstallPaths);\n    }\n    await this.reconcileGeneratedSiblings(\n      this.appHomeService.getDataDirectory(),\n      referencedDataPaths,\n    );\n  };\n\n  info = async (appId: string): Promise<AppInfoResult> => {\n    const appRecord = await this.registryService.getApp(appId);\n    if (!appRecord) {\n      throw new Error(`未找到已安装应用：${appId}`);\n    }\n    const installedVersions = Object.values(appRecord.installedVersions).sort((left, right) =>\n      left.version.localeCompare(right.version),\n    );\n    return {\n      appId: appRecord.appId,\n      name: appRecord.name,\n      description: appRecord.description,\n      activeVersion: appRecord.activeVersion,\n      enabled: appRecord.enabled,\n      dataDirectory: appRecord.dataDirectory,\n      installedVersions: installedVersions.map((versionRecord) => ({\n        version: versionRecord.version,\n        installDirectory: versionRecord.installDirectory,\n        sourceKind: versionRecord.sourceKind,\n        distributionMode: versionRecord.distributionMode,\n        sourceRef: versionRecord.sourceRef,\n        installedAt: versionRecord.installedAt,\n        permissions: versionRecord.permissions,\n        registryUrl: versionRecord.registryUrl,\n        bundleUrl: versionRecord.bundleUrl,\n        sha256: versionRecord.sha256,\n        publisher: versionRecord.publisher,\n        manifestSchemaVersion: versionRecord.manifestSchemaVersion,\n        components: versionRecord.components,\n        primaryPanelId: versionRecord.primaryPanelId,\n      })),\n      grants: appRecord.grants,\n    };\n  };\n\n  setEnabled = async (appId: string, enabled: boolean): Promise<AppActivationResult> => {\n    const appRecord = await this.registryService.setEnabled(appId, enabled);\n    return {\n      appId: appRecord.appId,\n      activeVersion: appRecord.activeVersion,\n      enabled: appRecord.enabled,\n    };\n  };\n\n  rollback = async (appId: string, version: string): Promise<AppRollbackResult> => {\n    const currentRecord = await this.registryService.getApp(appId);\n    if (!currentRecord) {\n      throw new Error(`未找到已安装应用：${appId}`);\n    }\n    if (currentRecord.activeVersion === version) {\n      return {\n        appId,\n        activeVersion: version,\n        previousVersion: version,\n        enabled: currentRecord.enabled,\n        rolledBack: false,\n      };\n    }\n    const targetVersion = currentRecord.installedVersions[version];\n    if (!targetVersion) {\n      throw new Error(`应用 ${appId} 未安装版本 ${version}。`);\n    }\n    const targetManifest = await this.manifestService.load(targetVersion.installDirectory);\n    if (targetManifest.manifest.id !== appId || targetManifest.manifest.version !== version) {\n      throw new Error(`回滚目标 ${appId}@${version} 校验失败。`);\n    }\n    const appRecord = await this.registryService.activateVersion(appId, version);\n    return {\n      appId,\n      activeVersion: appRecord.activeVersion,\n      previousVersion: currentRecord.activeVersion,\n      enabled: appRecord.enabled,\n      rolledBack: true,\n    };\n  };\n\n  resolveLaunch = async (\n    appReference: string,\n    explicitDocumentGrantMap: AppDocumentGrantMap,\n  ): Promise<AppLaunchResolution> => {\n    const sourceType = await this.installSourceService.detectLocal(appReference, false);\n    if (sourceType.kind === \"directory\") {\n      return {\n        appDirectory: sourceType.appDirectory,\n        documentGrantMap: explicitDocumentGrantMap,\n      };\n    }\n    const appRecord = await this.registryService.getApp(appReference);\n    if (!appRecord) {\n      throw new Error(`未找到应用目录，也未找到已安装应用：${appReference}`);\n    }\n    const activeVersion = appRecord.installedVersions[appRecord.activeVersion];\n    if (!activeVersion) {\n      throw new Error(`已安装应用缺少激活版本：${appReference}`);\n    }\n    return {\n      appDirectory: activeVersion.installDirectory,\n      appId: appRecord.appId,\n      dataDirectory: appRecord.dataDirectory,\n      documentGrantMap: {\n        ...appRecord.grants,\n        ...explicitDocumentGrantMap,\n      },\n    };\n  };\n\n  persistGrants = async (\n    appId: string | undefined,\n    documentGrantMap: AppDocumentGrantMap,\n  ): Promise<void> => {\n    if (!appId || Object.keys(documentGrantMap).length === 0) {\n      return;\n    }\n    await this.registryService.updateGrants(appId, documentGrantMap);\n  };\n\n  private copyToImmutableInstallDirectory = async (params: {\n    appId: string;\n    appVersion: string;\n    extractedDirectory: string;\n    installDirectory: string;\n  }): Promise<void> => {\n    const { appId, appVersion, extractedDirectory, installDirectory } = params;\n    if (await this.pathExists(installDirectory)) {\n      throw new Error(`应用版本目录已存在，不能覆盖不可变版本：${appId}@${appVersion}`);\n    }\n    await mkdir(path.dirname(installDirectory), { recursive: true });\n    const stagedInstallDirectory = `${installDirectory}.staging-${randomUUID()}`;\n    try {\n      await cp(extractedDirectory, stagedInstallDirectory, { recursive: true });\n      const stagedManifest = await this.manifestService.load(stagedInstallDirectory);\n      if (\n        stagedManifest.manifest.id !== appId ||\n        stagedManifest.manifest.version !== appVersion\n      ) {\n        throw new Error(\"staging manifest 与已验证 bundle 身份不一致。\");\n      }\n      await rename(stagedInstallDirectory, installDirectory);\n    } catch (error) {\n      await rm(stagedInstallDirectory, { recursive: true, force: true });\n      throw error;\n    }\n  };\n\n  private materializeDistribution = async (params: {\n    appDirectory: string;\n    distributionMode: AppDistributionMode;\n  }): Promise<void> => {\n    if (params.distributionMode !== \"source\") {\n      return;\n    }\n    const manifestBundle = await this.manifestService.load(params.appDirectory);\n    if (!isAppStandaloneManifestBundle(manifestBundle)) {\n      throw new Error(\"schema v2 组合包不允许运行安装期 build。\");\n    }\n    if (manifestBundle.manifest.main.kind !== \"wasi-http-component\") {\n      return;\n    }\n    await this.buildService.build({\n      appDirectory: params.appDirectory,\n      install: true,\n    });\n  };\n\n  private reconcileGeneratedSiblings = async (\n    parentDirectory: string,\n    referencedPaths: Set<string>,\n  ): Promise<void> => {\n    for (const entry of await this.readDirectories(parentDirectory)) {\n      const entryName = path.basename(entry);\n      const stagingMarker = \".staging-\";\n      const uninstallingMarker = \".uninstalling-\";\n      if (entryName.includes(stagingMarker)) {\n        await rm(entry, { recursive: true, force: true });\n        continue;\n      }\n      const markerIndex = entryName.indexOf(uninstallingMarker);\n      if (markerIndex < 0) {\n        continue;\n      }\n      const originalPath = path.join(parentDirectory, entryName.slice(0, markerIndex));\n      if (referencedPaths.has(path.resolve(originalPath)) && !await this.pathExists(originalPath)) {\n        await rename(entry, originalPath);\n      } else {\n        await rm(entry, { recursive: true, force: true });\n      }\n    }\n  };\n\n  private readDirectories = async (directory: string): Promise<string[]> => {\n    try {\n      return (await readdir(directory, { withFileTypes: true }))\n        .filter((entry) => entry.isDirectory())\n        .map((entry) => path.join(directory, entry.name));\n    } catch (error) {\n      if (this.isMissingFileError(error)) {\n        return [];\n      }\n      throw error;\n    }\n  };\n\n  private pathExists = async (targetPath: string): Promise<boolean> => {\n    try {\n      await access(targetPath);\n      return true;\n    } catch {\n      return false;\n    }\n  };\n\n  private isMissingFileError = (error: unknown): boolean =>\n    typeof error === \"object\" && error !== null &&\n    \"code\" in error && (error as { code?: unknown }).code === \"ENOENT\";\n}\n"],"mappings":"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"}

package/dist/services/app-instance.service.d.ts

@@ -0,0 +1,34 @@
+import { AppManifestSummary, AppStandaloneManifestBundle } from "../types/app-manifest.types.js";
+import { AppManifestService } from "./app-manifest.service.js";
+import { AppDocumentGrantMap, AppPermissionSummary } from "../types/app-permissions.types.js";
+import { AppPermissionsService } from "./app-permissions.service.js";
+import { MainRunResult, WasmDocumentSummaryInput } from "../types/main-runner.types.js";
+import { WasmMainRunnerService } from "./wasm-main-runner.service.js";
+
+//#region src/services/app-instance.service.d.ts
+type AppRunResult = {
+  action: string;
+  input: WasmDocumentSummaryInput;
+  output: MainRunResult;
+  observedAt: string;
+};
+declare class AppInstanceService {
+  readonly bundle: AppStandaloneManifestBundle;
+  private readonly permissionsService;
+  private readonly mainRunner;
+  private readonly manifestService;
+  private permissions?;
+  constructor(bundle: AppStandaloneManifestBundle, permissionsService?: AppPermissionsService, mainRunner?: WasmMainRunnerService, manifestService?: AppManifestService);
+  initialize: (documentGrantMap: AppDocumentGrantMap, context?: {
+    appId?: string;
+  }) => Promise<void>;
+  summarizeManifest: () => AppManifestSummary;
+  summarizePermissions: () => AppPermissionSummary;
+  runAction: (action?: string) => Promise<AppRunResult>;
+  private collectDocumentSummaryInput;
+  private collectDirectorySummary;
+  private getPermissions;
+}
+//#endregion
+export { AppInstanceService, AppRunResult };
+//# sourceMappingURL=app-instance.service.d.ts.map

package/dist/services/app-instance.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-instance.service.d.ts","names":[],"sources":["../../src/services/app-instance.service.ts"],"mappings":";;;;;;;;KAaY,YAAA;EACV,MAAA;EACA,KAAA,EAAO,wBAAA;EACP,MAAA,EAAQ,aAAA;EACR,UAAA;AAAA;AAAA,cAGW,kBAAA;EAAA,SAIA,MAAA,EAAQ,2BAAA;EAAA,iBACA,kBAAA;EAAA,iBACA,UAAA;EAAA,iBACA,eAAA;EAAA,QANX,WAAA;cAGG,MAAA,EAAQ,2BAAA,EACA,kBAAA,GAAoB,qBAAA,EACpB,UAAA,GAAY,qBAAA,EACZ,eAAA,GAAiB,kBAAA;EAGpC,UAAA,GACE,gBAAA,EAAkB,mBAAA,EAClB,OAAA;IACE,KAAA;EAAA,MAED,OAAA;EAQH,iBAAA,QARU,kBAAA;EAYV,oBAAA,QAA2B,oBAAA;EAI3B,SAAA,GAAmB,MAAA,cAAkB,OAAA,CAAQ,YAAA;EAAA,QAuBrC,2BAAA;EAAA,QAiBA,uBAAA;EAAA,QA6BA,cAAA;AAAA"}

package/dist/{host → services}/app-instance.service.js

@@ -1,9 +1,9 @@
-import { AppManifestService } from "../manifest/app-manifest.service.js";
-import { AppPermissionsService } from "../permissions/app-permissions.service.js";
-import { WasmMainRunnerService } from "../runtime/wasm-main-runner.service.js";
+import { AppManifestService } from "./app-manifest.service.js";
+import { AppPermissionsService } from "./app-permissions.service.js";
+import { WasmMainRunnerService } from "./wasm-main-runner.service.js";
 import { readFile, readdir } from "node:fs/promises";
 import path from "node:path";
-//#region src/host/app-instance.service.ts
+//#region src/services/app-instance.service.ts
 var AppInstanceService = class {
 	permissions;
 	constructor(bundle, permissionsService = new AppPermissionsService(), mainRunner = new WasmMainRunnerService(), manifestService = new AppManifestService()) {

package/dist/services/app-instance.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-instance.service.js","names":[],"sources":["../../src/services/app-instance.service.ts"],"sourcesContent":["import { readdir, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { AppStandaloneManifestBundle } from \"#app-runtime/types/app-manifest.types.js\";\nimport { AppManifestService } from \"#app-runtime/services/app-manifest.service.js\";\nimport { AppPermissionsService } from \"#app-runtime/services/app-permissions.service.js\";\nimport type {\n  AppDocumentGrantMap,\n  AppPermissionSummary,\n  ResolvedPermissions,\n} from \"#app-runtime/types/app-permissions.types.js\";\nimport { WasmMainRunnerService } from \"#app-runtime/services/wasm-main-runner.service.js\";\nimport type { MainRunResult, WasmDocumentSummaryInput } from \"#app-runtime/types/main-runner.types.js\";\n\nexport type AppRunResult = {\n  action: string;\n  input: WasmDocumentSummaryInput;\n  output: MainRunResult;\n  observedAt: string;\n};\n\nexport class AppInstanceService {\n  private permissions?: ResolvedPermissions;\n\n  constructor(\n    readonly bundle: AppStandaloneManifestBundle,\n    private readonly permissionsService: AppPermissionsService = new AppPermissionsService(),\n    private readonly mainRunner: WasmMainRunnerService = new WasmMainRunnerService(),\n    private readonly manifestService: AppManifestService = new AppManifestService(),\n  ) {}\n\n  initialize = async (\n    documentGrantMap: AppDocumentGrantMap,\n    context?: {\n      appId?: string;\n    },\n  ): Promise<void> => {\n    this.permissions = await this.permissionsService.resolve(\n      this.bundle,\n      documentGrantMap,\n      context,\n    );\n  };\n\n  summarizeManifest = () => {\n    return this.manifestService.summarize(this.bundle);\n  };\n\n  summarizePermissions = (): AppPermissionSummary => {\n    return this.permissionsService.summarize(this.bundle, this.getPermissions());\n  };\n\n  runAction = async (action?: string): Promise<AppRunResult> => {\n    if (this.bundle.manifest.main.kind !== \"wasm\") {\n      throw new Error(\"当前应用不支持 __napp/run action，请通过 /api/* 调用 WASI HTTP 后端。\");\n    }\n    const expectedAction = this.bundle.manifest.main.action;\n    if (action && action !== expectedAction) {\n      throw new Error(`当前应用只支持动作 ${expectedAction}。`);\n    }\n\n    const input = await this.collectDocumentSummaryInput();\n    const output = await this.mainRunner.runDocumentSummary({\n      bundle: this.bundle,\n      input,\n    });\n\n    return {\n      action: expectedAction,\n      input,\n      output,\n      observedAt: new Date().toISOString(),\n    };\n  };\n\n  private collectDocumentSummaryInput = async (): Promise<WasmDocumentSummaryInput> => {\n    const permissions = this.getPermissions();\n    let documentCount = 0;\n    let textBytes = 0;\n\n    for (const grant of permissions.documentAccess) {\n      const scopeSummary = await this.collectDirectorySummary(grant.path);\n      documentCount += scopeSummary.documentCount;\n      textBytes += scopeSummary.textBytes;\n    }\n\n    return {\n      documentCount,\n      textBytes,\n    };\n  };\n\n  private collectDirectorySummary = async (\n    directoryPath: string,\n  ): Promise<WasmDocumentSummaryInput> => {\n    const entries = await readdir(directoryPath, { withFileTypes: true });\n    let documentCount = 0;\n    let textBytes = 0;\n\n    for (const entry of entries) {\n      const entryPath = path.join(directoryPath, entry.name);\n      if (entry.isDirectory()) {\n        const childSummary = await this.collectDirectorySummary(entryPath);\n        documentCount += childSummary.documentCount;\n        textBytes += childSummary.textBytes;\n        continue;\n      }\n      if (!entry.isFile()) {\n        continue;\n      }\n      const content = await readFile(entryPath, \"utf-8\");\n      documentCount += 1;\n      textBytes += Buffer.byteLength(content, \"utf-8\");\n    }\n\n    return {\n      documentCount,\n      textBytes,\n    };\n  };\n\n  private getPermissions = (): ResolvedPermissions => {\n    if (!this.permissions) {\n      throw new Error(\"应用实例尚未初始化权限。\");\n    }\n    return this.permissions;\n  };\n}\n"],"mappings":";;;;;;AAoBA,IAAa,qBAAb,MAAgC;CAC9B;CAEA,YACE,QACA,qBAA6D,IAAI,uBAAuB,EACxF,aAAqD,IAAI,uBAAuB,EAChF,kBAAuD,IAAI,oBAAoB,EAC/E;AAJS,OAAA,SAAA;AACQ,OAAA,qBAAA;AACA,OAAA,aAAA;AACA,OAAA,kBAAA;;CAGnB,aAAa,OACX,kBACA,YAGkB;AAClB,OAAK,cAAc,MAAM,KAAK,mBAAmB,QAC/C,KAAK,QACL,kBACA,QACD;;CAGH,0BAA0B;AACxB,SAAO,KAAK,gBAAgB,UAAU,KAAK,OAAO;;CAGpD,6BAAmD;AACjD,SAAO,KAAK,mBAAmB,UAAU,KAAK,QAAQ,KAAK,gBAAgB,CAAC;;CAG9E,YAAY,OAAO,WAA2C;AAC5D,MAAI,KAAK,OAAO,SAAS,KAAK,SAAS,OACrC,OAAM,IAAI,MAAM,wDAAwD;EAE1E,MAAM,iBAAiB,KAAK,OAAO,SAAS,KAAK;AACjD,MAAI,UAAU,WAAW,eACvB,OAAM,IAAI,MAAM,aAAa,eAAe,GAAG;EAGjD,MAAM,QAAQ,MAAM,KAAK,6BAA6B;AAMtD,SAAO;GACL,QAAQ;GACR;GACA,QARa,MAAM,KAAK,WAAW,mBAAmB;IACtD,QAAQ,KAAK;IACb;IACD,CAAC;GAMA,6BAAY,IAAI,MAAM,EAAC,aAAa;GACrC;;CAGH,8BAAsC,YAA+C;EACnF,MAAM,cAAc,KAAK,gBAAgB;EACzC,IAAI,gBAAgB;EACpB,IAAI,YAAY;AAEhB,OAAK,MAAM,SAAS,YAAY,gBAAgB;GAC9C,MAAM,eAAe,MAAM,KAAK,wBAAwB,MAAM,KAAK;AACnE,oBAAiB,aAAa;AAC9B,gBAAa,aAAa;;AAG5B,SAAO;GACL;GACA;GACD;;CAGH,0BAAkC,OAChC,kBACsC;EACtC,MAAM,UAAU,MAAM,QAAQ,eAAe,EAAE,eAAe,MAAM,CAAC;EACrE,IAAI,gBAAgB;EACpB,IAAI,YAAY;AAEhB,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,YAAY,KAAK,KAAK,eAAe,MAAM,KAAK;AACtD,OAAI,MAAM,aAAa,EAAE;IACvB,MAAM,eAAe,MAAM,KAAK,wBAAwB,UAAU;AAClE,qBAAiB,aAAa;AAC9B,iBAAa,aAAa;AAC1B;;AAEF,OAAI,CAAC,MAAM,QAAQ,CACjB;GAEF,MAAM,UAAU,MAAM,SAAS,WAAW,QAAQ;AAClD,oBAAiB;AACjB,gBAAa,OAAO,WAAW,SAAS,QAAQ;;AAGlD,SAAO;GACL;GACA;GACD;;CAGH,uBAAoD;AAClD,MAAI,CAAC,KAAK,YACR,OAAM,IAAI,MAAM,eAAe;AAEjC,SAAO,KAAK"}

package/dist/{manifest → services}/app-manifest.service.d.ts

@@ -1,18 +1,28 @@
-import { AppManifestBundle, AppManifestSummary } from "./app-manifest.types.js";
+import { AppManifestBundle, AppManifestSummary } from "../types/app-manifest.types.js";
 
-//#region src/manifest/app-manifest.service.d.ts
+//#region src/services/app-manifest.service.d.ts
 declare class AppManifestService {
   load: (appDirectory: string) => Promise<AppManifestBundle>;
   summarize: (bundle: AppManifestBundle) => AppManifestSummary;
+  private loadStandaloneBundle;
+  private loadComponentBundle;
   private parseManifest;
+  private parseCommonManifest;
   private parseMain;
   private parseUi;
+  private parseComponents;
+  private parseEngines;
+  private parsePresentation;
+  private readComponentId;
   private parsePermissions;
   private parseDocumentAccess;
   private parseStringArray;
   private parseStorage;
   private parseCapabilities;
   private assertResolvedFile;
+  private assertResolvedDirectory;
+  private resolveInside;
+  private normalizeRelativePath;
   private assertObject;
   private readRequiredString;
   private readOptionalString;

package/dist/services/app-manifest.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-manifest.service.d.ts","names":[],"sources":["../../src/services/app-manifest.service.ts"],"mappings":";;;cAmBa,kBAAA;EACX,IAAA,GAAc,YAAA,aAAuB,OAAA,CAAQ,iBAAA;EAU7C,SAAA,GAAa,MAAA,EAAQ,iBAAA,KAAoB,kBAAA;EAAA,QAoCjC,oBAAA;EAAA,QA8BA,mBAAA;EAAA,QA8DA,aAAA;EAAA,QAyBA,mBAAA;EAAA,QAcA,SAAA;EAAA,QAoBA,OAAA;EAAA,QAKA,eAAA;EAAA,QA+BA,YAAA;EAAA,QAUA,iBAAA;EAAA,QAeA,eAAA;EAAA,QA0BA,gBAAA;EAAA,QAaA,mBAAA;EAAA,QAwBA,gBAAA;EAAA,QAUA,YAAA;EAAA,QAQA,iBAAA;EAAA,QAYA,kBAAA;EAAA,QAaA,uBAAA;EAAA,QAcA,aAAA;EAAA,QAUA,qBAAA;EAAA,QAWA,YAAA;EAAA,QAOA,kBAAA;EAAA,QAOA,kBAAA;EAAA,QAIA,UAAA;EAAA,QAOA,WAAA;AAAA"}