@nextclaw/app-runtime 0.2.0 → 0.4.0

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

@@ -0,0 +1,67 @@
+import { AppDocumentGrantMap } from "../permissions/app-permissions.types.js";
+
+//#region src/cli/app-runtime-options.service.d.ts
+type RuntimeCliOptions = {
+  host: string;
+  port: number;
+  json: boolean;
+  documentGrantMap: AppDocumentGrantMap;
+};
+type CreateCliOptions = {
+  json: boolean;
+};
+type PackCliOptions = {
+  json: boolean;
+  outputPath?: string;
+};
+type JsonOnlyCliOptions = {
+  json: boolean;
+};
+type InstallCliOptions = {
+  json: boolean;
+  registryUrl?: string;
+};
+type UpdateCliOptions = {
+  json: boolean;
+  registryUrl?: string;
+  version?: string;
+};
+type UninstallCliOptions = {
+  json: boolean;
+  purgeData: boolean;
+};
+type GrantCliOptions = {
+  json: boolean;
+  documentGrantMap: AppDocumentGrantMap;
+};
+type RevokeCliOptions = {
+  json: boolean;
+  documentScopeIds: string[];
+};
+type PublishCliOptions = {
+  json: boolean;
+  metadataPath?: string;
+  apiBaseUrl?: string;
+  token?: string;
+};
+declare class AppRuntimeOptionsService {
+  readTarget: (command: string, rawArgs: string[]) => {
+    target: string;
+    optionArgs: string[];
+  };
+  readCreateOptions: (rawArgs: string[]) => CreateCliOptions;
+  readPackOptions: (rawArgs: string[]) => PackCliOptions;
+  readJsonOnlyOptions: (rawArgs: string[]) => JsonOnlyCliOptions;
+  readInstallOptions: (rawArgs: string[]) => InstallCliOptions;
+  readUpdateOptions: (rawArgs: string[]) => UpdateCliOptions;
+  readUninstallOptions: (rawArgs: string[]) => UninstallCliOptions;
+  readRuntimeOptions: (rawArgs: string[]) => RuntimeCliOptions;
+  readGrantOptions: (rawArgs: string[]) => GrantCliOptions;
+  readRevokeOptions: (rawArgs: string[]) => RevokeCliOptions;
+  readPublishOptions: (rawArgs: string[]) => PublishCliOptions;
+  private assignDocumentGrant;
+  private readDocumentScopeId;
+  private requireOptionValue;
+}
+//#endregion
+export { AppRuntimeOptionsService, CreateCliOptions, GrantCliOptions, InstallCliOptions, JsonOnlyCliOptions, PackCliOptions, PublishCliOptions, RevokeCliOptions, RuntimeCliOptions, UninstallCliOptions, UpdateCliOptions };

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

@@ -0,0 +1,242 @@
+//#region src/cli/app-runtime-options.service.ts
+var AppRuntimeOptionsService = class {
+	readTarget = (command, rawArgs) => {
+		const [target, ...optionArgs] = rawArgs;
+		if (!target || target.startsWith("--")) throw new Error(`${command} 缺少目标参数。`);
+		return {
+			target,
+			optionArgs
+		};
+	};
+	readCreateOptions = (rawArgs) => {
+		const options = { json: false };
+		for (const current of rawArgs) {
+			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
+			switch (current) {
+				case "--json":
+					options.json = true;
+					break;
+				default: throw new Error(`未知参数：${current}`);
+			}
+		}
+		return options;
+	};
+	readPackOptions = (rawArgs) => {
+		const options = { json: false };
+		for (let index = 0; index < rawArgs.length; index += 1) {
+			const current = rawArgs[index];
+			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
+			const nextValue = rawArgs[index + 1];
+			switch (current) {
+				case "--json":
+					options.json = true;
+					break;
+				case "--out":
+					options.outputPath = this.requireOptionValue(current, nextValue);
+					index += 1;
+					break;
+				default: throw new Error(`未知参数：${current}`);
+			}
+		}
+		return options;
+	};
+	readJsonOnlyOptions = (rawArgs) => {
+		const options = { json: false };
+		for (const current of rawArgs) {
+			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
+			switch (current) {
+				case "--json":
+					options.json = true;
+					break;
+				default: throw new Error(`未知参数：${current}`);
+			}
+		}
+		return options;
+	};
+	readInstallOptions = (rawArgs) => {
+		const options = { json: false };
+		for (let index = 0; index < rawArgs.length; index += 1) {
+			const current = rawArgs[index];
+			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
+			const nextValue = rawArgs[index + 1];
+			switch (current) {
+				case "--json":
+					options.json = true;
+					break;
+				case "--registry":
+					options.registryUrl = this.requireOptionValue(current, nextValue);
+					index += 1;
+					break;
+				default: throw new Error(`未知参数：${current}`);
+			}
+		}
+		return options;
+	};
+	readUpdateOptions = (rawArgs) => {
+		const options = { json: false };
+		for (let index = 0; index < rawArgs.length; index += 1) {
+			const current = rawArgs[index];
+			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
+			const nextValue = rawArgs[index + 1];
+			switch (current) {
+				case "--json":
+					options.json = true;
+					break;
+				case "--registry":
+					options.registryUrl = this.requireOptionValue(current, nextValue);
+					index += 1;
+					break;
+				case "--version":
+					options.version = this.requireOptionValue(current, nextValue);
+					index += 1;
+					break;
+				default: throw new Error(`未知参数：${current}`);
+			}
+		}
+		return options;
+	};
+	readUninstallOptions = (rawArgs) => {
+		const options = {
+			json: false,
+			purgeData: false
+		};
+		for (const current of rawArgs) {
+			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
+			switch (current) {
+				case "--json":
+					options.json = true;
+					break;
+				case "--purge-data":
+					options.purgeData = true;
+					break;
+				default: throw new Error(`未知参数：${current}`);
+			}
+		}
+		return options;
+	};
+	readRuntimeOptions = (rawArgs) => {
+		const options = {
+			host: "127.0.0.1",
+			port: 3100,
+			json: false,
+			documentGrantMap: {}
+		};
+		for (let index = 0; index < rawArgs.length; index += 1) {
+			const current = rawArgs[index];
+			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
+			const nextValue = rawArgs[index + 1];
+			switch (current) {
+				case "--host":
+					options.host = this.requireOptionValue(current, nextValue);
+					index += 1;
+					break;
+				case "--port":
+					options.port = Number.parseInt(this.requireOptionValue(current, nextValue), 10);
+					if (Number.isNaN(options.port) || options.port < 0) throw new Error("--port 必须是非负整数。");
+					index += 1;
+					break;
+				case "--json":
+					options.json = true;
+					break;
+				case "--document":
+					this.assignDocumentGrant(options.documentGrantMap, this.requireOptionValue(current, nextValue));
+					index += 1;
+					break;
+				default: throw new Error(`未知参数：${current}`);
+			}
+		}
+		return options;
+	};
+	readGrantOptions = (rawArgs) => {
+		const options = {
+			json: false,
+			documentGrantMap: {}
+		};
+		for (let index = 0; index < rawArgs.length; index += 1) {
+			const current = rawArgs[index];
+			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
+			const nextValue = rawArgs[index + 1];
+			switch (current) {
+				case "--json":
+					options.json = true;
+					break;
+				case "--document":
+					this.assignDocumentGrant(options.documentGrantMap, this.requireOptionValue(current, nextValue));
+					index += 1;
+					break;
+				default: throw new Error(`未知参数：${current}`);
+			}
+		}
+		if (Object.keys(options.documentGrantMap).length === 0) throw new Error("grant 至少需要一个 --document scope=/path。");
+		return options;
+	};
+	readRevokeOptions = (rawArgs) => {
+		const options = {
+			json: false,
+			documentScopeIds: []
+		};
+		for (let index = 0; index < rawArgs.length; index += 1) {
+			const current = rawArgs[index];
+			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
+			const nextValue = rawArgs[index + 1];
+			switch (current) {
+				case "--json":
+					options.json = true;
+					break;
+				case "--document":
+					options.documentScopeIds.push(this.readDocumentScopeId(this.requireOptionValue(current, nextValue)));
+					index += 1;
+					break;
+				default: throw new Error(`未知参数：${current}`);
+			}
+		}
+		if (options.documentScopeIds.length === 0) throw new Error("revoke 至少需要一个 --document scope。");
+		return options;
+	};
+	readPublishOptions = (rawArgs) => {
+		const options = { json: false };
+		for (let index = 0; index < rawArgs.length; index += 1) {
+			const current = rawArgs[index];
+			if (!current?.startsWith("--")) throw new Error(`未知参数：${current}`);
+			const nextValue = rawArgs[index + 1];
+			switch (current) {
+				case "--json":
+					options.json = true;
+					break;
+				case "--meta":
+					options.metadataPath = this.requireOptionValue(current, nextValue);
+					index += 1;
+					break;
+				case "--api-base":
+					options.apiBaseUrl = this.requireOptionValue(current, nextValue);
+					index += 1;
+					break;
+				case "--token":
+					options.token = this.requireOptionValue(current, nextValue);
+					index += 1;
+					break;
+				default: throw new Error(`未知参数：${current}`);
+			}
+		}
+		return options;
+	};
+	assignDocumentGrant = (documentGrantMap, rawGrant) => {
+		const delimiterIndex = rawGrant.indexOf("=");
+		if (delimiterIndex < 1) throw new Error("--document 必须使用 scopeId=/absolute/or/relative/path 格式。");
+		const scopeId = rawGrant.slice(0, delimiterIndex).trim();
+		const directoryPath = rawGrant.slice(delimiterIndex + 1).trim();
+		if (!scopeId || !directoryPath) throw new Error("--document 缺少 scopeId 或 path。");
+		documentGrantMap[scopeId] = directoryPath;
+	};
+	readDocumentScopeId = (scopeId) => {
+		const normalized = scopeId.trim();
+		if (!normalized || normalized.includes("=")) throw new Error("--document 必须使用 scopeId 格式。");
+		return normalized;
+	};
+	requireOptionValue = (flag, nextValue) => {
+		if (!nextValue || nextValue.startsWith("--")) throw new Error(`${flag} 缺少值。`);
+		return nextValue;
+	};
+};
+//#endregion
+export { AppRuntimeOptionsService };

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

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

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

@@ -0,0 +1,16 @@
+import { AppDocumentGrantMap } from "../permissions/app-permissions.types.js";
+import { AppGrantService } from "../permissions/app-grant.service.js";
+
+//#region src/commands/grant.controller.d.ts
+declare class GrantCommand {
+  private readonly grantService;
+  constructor(grantService?: AppGrantService);
+  run: (params: {
+    appId: string;
+    documentGrantMap: AppDocumentGrantMap;
+    json: boolean;
+    write: (text: string) => void;
+  }) => Promise<void>;
+}
+//#endregion
+export { GrantCommand };

package/dist/commands/grant.controller.js

@@ -0,0 +1,25 @@
+import { AppGrantService } from "../permissions/app-grant.service.js";
+//#region src/commands/grant.controller.ts
+var GrantCommand = class {
+	constructor(grantService = new AppGrantService()) {
+		this.grantService = grantService;
+	}
+	run = async (params) => {
+		const { appId, documentGrantMap, json, write } = params;
+		const results = await Promise.all(Object.entries(documentGrantMap).map(([scopeId, directoryPath]) => this.grantService.grantDocumentScope({
+			appId,
+			scopeId,
+			directoryPath
+		})));
+		if (json) {
+			write(`${JSON.stringify({
+				ok: true,
+				grants: results
+			}, null, 2)}\n`);
+			return;
+		}
+		for (const result of results) write(`Granted ${result.scopeId} -> ${result.grantedPath}\n`);
+	};
+};
+//#endregion
+export { GrantCommand };

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

@@ -0,0 +1,14 @@
+import { AppInstallationService } from "../install/app-installation.service.js";
+
+//#region src/commands/info.controller.d.ts
+declare class InfoCommand {
+  private readonly installationService;
+  constructor(installationService?: AppInstallationService);
+  run: (params: {
+    appId: string;
+    json: boolean;
+    write: (text: string) => void;
+  }) => Promise<void>;
+}
+//#endregion
+export { InfoCommand };

package/dist/commands/info.controller.js

@@ -0,0 +1,27 @@
+import { AppInstallationService } from "../install/app-installation.service.js";
+//#region src/commands/info.controller.ts
+var InfoCommand = class {
+	constructor(installationService = new AppInstallationService()) {
+		this.installationService = installationService;
+	}
+	run = async (params) => {
+		const { appId, json, write } = params;
+		const result = await this.installationService.info(appId);
+		if (json) {
+			write(`${JSON.stringify({
+				ok: true,
+				app: result
+			}, null, 2)}\n`);
+			return;
+		}
+		write(`App: ${result.name} (${result.appId})\n`);
+		write(`Active version: ${result.activeVersion}\n`);
+		write(`Data: ${result.dataDirectory}\n`);
+		write(`Installed versions: ${result.installedVersions.map((item) => item.version).join(", ")}\n`);
+		const activeVersion = result.installedVersions.find((item) => item.version === result.activeVersion);
+		if (activeVersion?.registryUrl) write(`Registry: ${activeVersion.registryUrl}\n`);
+		if (activeVersion?.publisher) write(`Publisher: ${activeVersion.publisher.name} (${activeVersion.publisher.id})\n`);
+	};
+};
+//#endregion
+export { InfoCommand };

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

@@ -0,0 +1,15 @@
+import { AppInstallationService } from "../install/app-installation.service.js";
+
+//#region src/commands/install.controller.d.ts
+declare class InstallCommand {
+  private readonly installationService;
+  constructor(installationService?: AppInstallationService);
+  run: (params: {
+    appSource: string;
+    registryUrl?: string;
+    json: boolean;
+    write: (text: string) => void;
+  }) => Promise<void>;
+}
+//#endregion
+export { InstallCommand };

package/dist/commands/install.controller.js

@@ -0,0 +1,24 @@
+import { AppInstallationService } from "../install/app-installation.service.js";
+//#region src/commands/install.controller.ts
+var InstallCommand = class {
+	constructor(installationService = new AppInstallationService()) {
+		this.installationService = installationService;
+	}
+	run = async (params) => {
+		const { appSource, registryUrl, json, write } = params;
+		const result = await this.installationService.install(appSource, { registryUrl });
+		if (json) {
+			write(`${JSON.stringify({
+				ok: true,
+				installation: result
+			}, null, 2)}\n`);
+			return;
+		}
+		write(`Installed ${result.name} (${result.appId}) ${result.version}\n`);
+		write(`Code: ${result.installDirectory}\n`);
+		write(`Data: ${result.dataDirectory}\n`);
+		if (result.registryUrl) write(`Registry: ${result.registryUrl}\n`);
+	};
+};
+//#endregion
+export { InstallCommand };

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

@@ -0,0 +1,13 @@
+import { AppInstallationService } from "../install/app-installation.service.js";
+
+//#region src/commands/list.controller.d.ts
+declare class ListCommand {
+  private readonly installationService;
+  constructor(installationService?: AppInstallationService);
+  run: (params: {
+    json: boolean;
+    write: (text: string) => void;
+  }) => Promise<void>;
+}
+//#endregion
+export { ListCommand };

package/dist/commands/list.controller.js

@@ -0,0 +1,25 @@
+import { AppInstallationService } from "../install/app-installation.service.js";
+//#region src/commands/list.controller.ts
+var ListCommand = class {
+	constructor(installationService = new AppInstallationService()) {
+		this.installationService = installationService;
+	}
+	run = async (params) => {
+		const { json, write } = params;
+		const result = await this.installationService.list();
+		if (json) {
+			write(`${JSON.stringify({
+				ok: true,
+				apps: result
+			}, null, 2)}\n`);
+			return;
+		}
+		if (result.length === 0) {
+			write("No installed apps.\n");
+			return;
+		}
+		for (const appItem of result) write(`${appItem.appId} ${appItem.activeVersion} ${appItem.sourceKind} ${appItem.name}\n`);
+	};
+};
+//#endregion
+export { ListCommand };

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

@@ -0,0 +1,15 @@
+import { AppBundleService } from "../bundle/app-bundle.service.js";
+
+//#region src/commands/pack.controller.d.ts
+declare class PackCommand {
+  private readonly bundleService;
+  constructor(bundleService?: AppBundleService);
+  run: (params: {
+    appDirectory: string;
+    outputPath?: string;
+    json: boolean;
+    write: (text: string) => void;
+  }) => Promise<void>;
+}
+//#endregion
+export { PackCommand };

package/dist/commands/pack.controller.js

@@ -0,0 +1,25 @@
+import { AppBundleService } from "../bundle/app-bundle.service.js";
+//#region src/commands/pack.controller.ts
+var PackCommand = class {
+	constructor(bundleService = new AppBundleService()) {
+		this.bundleService = bundleService;
+	}
+	run = async (params) => {
+		const { appDirectory, outputPath, json, write } = params;
+		const result = await this.bundleService.packAppDirectory({
+			appDirectory,
+			outputPath
+		});
+		if (json) {
+			write(`${JSON.stringify({
+				ok: true,
+				bundle: result
+			}, null, 2)}\n`);
+			return;
+		}
+		write(`Packed ${result.metadata.name} ${result.metadata.version}\n`);
+		write(`Bundle: ${result.bundlePath}\n`);
+	};
+};
+//#endregion
+export { PackCommand };

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

@@ -0,0 +1,14 @@
+import { AppGrantService } from "../permissions/app-grant.service.js";
+
+//#region src/commands/permissions.controller.d.ts
+declare class PermissionsCommand {
+  private readonly grantService;
+  constructor(grantService?: AppGrantService);
+  run: (params: {
+    appId: string;
+    json: boolean;
+    write: (text: string) => void;
+  }) => Promise<void>;
+}
+//#endregion
+export { PermissionsCommand };

package/dist/commands/permissions.controller.js

@@ -0,0 +1,26 @@
+import { AppGrantService } from "../permissions/app-grant.service.js";
+//#region src/commands/permissions.controller.ts
+var PermissionsCommand = class {
+	constructor(grantService = new AppGrantService()) {
+		this.grantService = grantService;
+	}
+	run = async (params) => {
+		const { appId, json, write } = params;
+		const result = await this.grantService.summarize(appId);
+		if (json) {
+			write(`${JSON.stringify({
+				ok: true,
+				permissions: result
+			}, null, 2)}\n`);
+			return;
+		}
+		write(`Permissions: ${result.name} (${result.appId}) ${result.activeVersion}\n`);
+		if (result.documentAccess.length === 0) write("Document access: none\n");
+		else for (const scope of result.documentAccess) write(`Document ${scope.id} ${scope.mode} ${scope.granted ? scope.grantedPath : "[missing]"}\n`);
+		write(`Allowed domains: ${result.allowedDomains.length > 0 ? result.allowedDomains.join(", ") : "none"}\n`);
+		write(`Storage: ${result.storage.enabled ? result.storage.namespace ?? "enabled" : "disabled"}\n`);
+		write(`Host bridge: ${result.capabilities.hostBridge ? "enabled" : "disabled"}\n`);
+	};
+};
+//#endregion
+export { PermissionsCommand };

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

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

package/dist/commands/publish.controller.js

@@ -0,0 +1,29 @@
+import { AppPublishService } from "../publish/app-publish.service.js";
+//#region src/commands/publish.controller.ts
+var PublishCommand = class {
+	constructor(publishService = new AppPublishService()) {
+		this.publishService = publishService;
+	}
+	run = async (params) => {
+		const { appDirectory, metadataPath, apiBaseUrl, token, json, write } = params;
+		const result = await this.publishService.publish({
+			appDirectory,
+			metadataPath,
+			apiBaseUrl,
+			token
+		});
+		if (json) {
+			write(`${JSON.stringify({
+				ok: true,
+				publish: result
+			}, null, 2)}\n`);
+			return;
+		}
+		write(`${result.created ? "Published" : "Updated"} ${result.item.name} (${result.item.appId}) ${result.item.latestVersion}\n`);
+		write(`Bundle: ${result.bundle.path}\n`);
+		if (result.item.webUrl) write(`Details: ${result.item.webUrl}\n`);
+		write(`Install: ${result.item.install.command}\n`);
+	};
+};
+//#endregion
+export { PublishCommand };

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

@@ -0,0 +1,16 @@
+import { AppRegistryConfigService } from "../registry/app-registry-config.service.js";
+
+//#region src/commands/registry.controller.d.ts
+declare class RegistryCommand {
+  private readonly configService;
+  constructor(configService?: AppRegistryConfigService);
+  run: (params: {
+    action: "get" | "set" | "reset";
+    registryUrl?: string;
+    json: boolean;
+    write: (text: string) => void;
+  }) => Promise<void>;
+  private requireRegistryUrl;
+}
+//#endregion
+export { RegistryCommand };

package/dist/commands/registry.controller.js

@@ -0,0 +1,27 @@
+import { AppRegistryConfigService } from "../registry/app-registry-config.service.js";
+//#region src/commands/registry.controller.ts
+var RegistryCommand = class {
+	constructor(configService = new AppRegistryConfigService()) {
+		this.configService = configService;
+	}
+	run = async (params) => {
+		const { action, registryUrl, json, write } = params;
+		const snapshot = action === "set" ? await this.configService.setRegistryUrl(this.requireRegistryUrl(registryUrl)) : action === "reset" ? await this.configService.resetRegistryUrl() : await this.configService.getSnapshot();
+		if (json) {
+			write(`${JSON.stringify({
+				ok: true,
+				registry: snapshot
+			}, null, 2)}\n`);
+			return;
+		}
+		write(`Registry: ${snapshot.currentUrl}\n`);
+		write(`Source: ${snapshot.source}\n`);
+		write(`Default: ${snapshot.defaultUrl}\n`);
+	};
+	requireRegistryUrl = (registryUrl) => {
+		if (!registryUrl) throw new Error("registry set 缺少 URL。");
+		return registryUrl;
+	};
+};
+//#endregion
+export { RegistryCommand };