@nextclaw/app-runtime 0.2.0 → 0.3.0

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

@@ -0,0 +1,28 @@
+import { AppRemoteRegistryResolution } from "./app-remote-registry.types.js";
+import { AppRegistryConfigService } from "./app-registry-config.service.js";
+
+//#region src/registry/app-remote-registry-client.service.d.ts
+declare class AppRemoteRegistryClientService {
+  private readonly configService;
+  constructor(configService?: AppRegistryConfigService);
+  resolve: (params: {
+    appId: string;
+    version?: string;
+    registryUrl?: string;
+  }) => Promise<AppRemoteRegistryResolution>;
+  downloadBundle: (params: {
+    resolution: AppRemoteRegistryResolution;
+    targetDirectory: string;
+  }) => Promise<{
+    bundlePath: string;
+  }>;
+  private parseDocument;
+  private parseVersion;
+  private parsePublisher;
+  private readRequiredString;
+  private readOptionalString;
+  private normalizeBundleFileName;
+  private normalizeRegistryUrl;
+}
+//#endregion
+export { AppRemoteRegistryClientService };

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

@@ -0,0 +1,114 @@
+import { AppRegistryConfigService } from "./app-registry-config.service.js";
+import { writeFile } from "node:fs/promises";
+import { createHash } from "node:crypto";
+import path from "node:path";
+//#region src/registry/app-remote-registry-client.service.ts
+var AppRemoteRegistryClientService = class {
+	constructor(configService = new AppRegistryConfigService()) {
+		this.configService = configService;
+	}
+	resolve = async (params) => {
+		const { appId, version: requestedVersion, registryUrl: overrideRegistryUrl } = params;
+		const registryUrl = overrideRegistryUrl ? this.normalizeRegistryUrl(overrideRegistryUrl) : (await this.configService.getSnapshot()).currentUrl;
+		const metadataUrl = new URL(encodeURIComponent(appId), registryUrl).toString();
+		const response = await fetch(metadataUrl);
+		if (!response.ok) throw new Error(`无法从 registry 拉取 ${appId} metadata：${response.status} ${response.statusText}`);
+		const document = this.parseDocument(await response.json(), appId);
+		const version = requestedVersion ?? document["dist-tags"].latest;
+		const versionRecord = document.versions[version];
+		if (!versionRecord) throw new Error(`registry ${registryUrl} 未提供 ${appId}@${version}。`);
+		return {
+			registryUrl,
+			metadataUrl,
+			appId,
+			version,
+			description: versionRecord.description ?? document.description,
+			publisher: versionRecord.publisher,
+			permissions: versionRecord.permissions,
+			bundleUrl: new URL(versionRecord.dist.bundle, metadataUrl).toString(),
+			sha256: versionRecord.dist.sha256
+		};
+	};
+	downloadBundle = async (params) => {
+		const { resolution, targetDirectory } = params;
+		const response = await fetch(resolution.bundleUrl);
+		if (!response.ok) throw new Error(`无法下载 bundle：${resolution.bundleUrl} (${response.status} ${response.statusText})`);
+		const bundleBytes = Buffer.from(await response.arrayBuffer());
+		const actualSha256 = createHash("sha256").update(bundleBytes).digest("hex");
+		if (actualSha256 !== resolution.sha256) throw new Error(`bundle checksum 校验失败：期望 ${resolution.sha256}，实际 ${actualSha256}`);
+		const bundlePath = path.join(targetDirectory, `${this.normalizeBundleFileName(resolution.appId)}-${resolution.version}.napp`);
+		await writeFile(bundlePath, bundleBytes);
+		return { bundlePath };
+	};
+	parseDocument = (rawDocument, appId) => {
+		if (!rawDocument || typeof rawDocument !== "object" || Array.isArray(rawDocument)) throw new Error(`registry ${appId} metadata 必须是对象。`);
+		const candidate = rawDocument;
+		const name = this.readRequiredString(candidate.name, "name");
+		if (name !== appId) throw new Error(`registry 返回的包名与请求不一致：请求 ${appId}，收到 ${name}`);
+		const distTags = candidate["dist-tags"];
+		if (!distTags || typeof distTags !== "object" || Array.isArray(distTags)) throw new Error("registry metadata 缺少 dist-tags。");
+		const versions = candidate.versions;
+		if (!versions || typeof versions !== "object" || Array.isArray(versions)) throw new Error("registry metadata 缺少 versions。");
+		return {
+			name,
+			description: this.readOptionalString(candidate.description, "description"),
+			"dist-tags": { latest: this.readRequiredString(distTags.latest, "dist-tags.latest") },
+			versions: Object.fromEntries(Object.entries(versions).map(([version, rawVersion]) => [version, this.parseVersion(rawVersion, name, version)]))
+		};
+	};
+	parseVersion = (rawVersion, appId, version) => {
+		if (!rawVersion || typeof rawVersion !== "object" || Array.isArray(rawVersion)) throw new Error(`registry metadata 的 versions.${version} 必须是对象。`);
+		const candidate = rawVersion;
+		const name = this.readRequiredString(candidate.name, `versions.${version}.name`);
+		const parsedVersion = this.readRequiredString(candidate.version, `versions.${version}.version`);
+		if (name !== appId || parsedVersion !== version) throw new Error(`registry metadata 的 versions.${version} 与 app id/version 不一致。`);
+		const dist = candidate.dist;
+		if (!dist || typeof dist !== "object" || Array.isArray(dist)) throw new Error(`registry metadata 的 versions.${version}.dist 必须是对象。`);
+		const distCandidate = dist;
+		return {
+			name,
+			version: parsedVersion,
+			description: this.readOptionalString(candidate.description, `versions.${version}.description`),
+			publisher: this.parsePublisher(candidate.publisher, version),
+			permissions: candidate.permissions,
+			dist: {
+				bundle: this.readRequiredString(distCandidate.bundle, `versions.${version}.dist.bundle`),
+				sha256: this.readRequiredString(distCandidate.sha256, `versions.${version}.dist.sha256`)
+			}
+		};
+	};
+	parsePublisher = (rawPublisher, version) => {
+		if (rawPublisher === void 0) return;
+		if (!rawPublisher || typeof rawPublisher !== "object" || Array.isArray(rawPublisher)) throw new Error(`versions.${version}.publisher 必须是对象。`);
+		const candidate = rawPublisher;
+		return {
+			id: this.readRequiredString(candidate.id, `versions.${version}.publisher.id`),
+			name: this.readRequiredString(candidate.name, `versions.${version}.publisher.name`),
+			url: this.readOptionalString(candidate.url, `versions.${version}.publisher.url`)
+		};
+	};
+	readRequiredString = (value, fieldName) => {
+		if (typeof value !== "string" || !value.trim()) throw new Error(`${fieldName} 必须是非空字符串。`);
+		return value.trim();
+	};
+	readOptionalString = (value, fieldName) => {
+		if (value === void 0) return;
+		return this.readRequiredString(value, fieldName);
+	};
+	normalizeBundleFileName = (appId) => {
+		return appId.replace(/[^a-zA-Z0-9._-]+/g, "-");
+	};
+	normalizeRegistryUrl = (registryUrl) => {
+		let normalized;
+		try {
+			normalized = new URL(registryUrl);
+		} catch {
+			throw new Error(`非法 registry URL：${registryUrl}`);
+		}
+		if (normalized.protocol !== "http:" && normalized.protocol !== "https:") throw new Error(`registry URL 只支持 http/https：${registryUrl}`);
+		const text = normalized.toString();
+		return text.endsWith("/") ? text : `${text}/`;
+	};
+};
+//#endregion
+export { AppRemoteRegistryClientService };

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

@@ -0,0 +1,52 @@
+import { AppPermissions } from "../manifest/app-manifest.types.js";
+
+//#region src/registry/app-remote-registry.types.d.ts
+declare const DEFAULT_APP_REGISTRY_URL = "https://registry.nextclaw.com/";
+type AppPublisher = {
+  id: string;
+  name: string;
+  url?: string;
+};
+type AppRegistryConfig = {
+  schemaVersion: 1;
+  registry: {
+    url: string;
+  };
+};
+type AppRegistryConfigSnapshot = {
+  defaultUrl: string;
+  currentUrl: string;
+  source: "default" | "config" | "env";
+};
+type AppRemoteRegistryVersion = {
+  name: string;
+  version: string;
+  description?: string;
+  publisher?: AppPublisher;
+  permissions?: AppPermissions;
+  dist: {
+    bundle: string;
+    sha256: string;
+  };
+};
+type AppRemoteRegistryDocument = {
+  name: string;
+  description?: string;
+  "dist-tags": {
+    latest: string;
+  };
+  versions: Record<string, AppRemoteRegistryVersion>;
+};
+type AppRemoteRegistryResolution = {
+  registryUrl: string;
+  metadataUrl: string;
+  appId: string;
+  version: string;
+  description?: string;
+  publisher?: AppPublisher;
+  permissions?: AppPermissions;
+  bundleUrl: string;
+  sha256: string;
+};
+//#endregion
+export { AppPublisher, AppRegistryConfig, AppRegistryConfigSnapshot, AppRemoteRegistryDocument, AppRemoteRegistryResolution, AppRemoteRegistryVersion, DEFAULT_APP_REGISTRY_URL };

package/dist/registry/app-remote-registry.types.js

@@ -0,0 +1,4 @@
+//#region src/registry/app-remote-registry.types.ts
+const DEFAULT_APP_REGISTRY_URL = "https://registry.nextclaw.com/";
+//#endregion
+export { DEFAULT_APP_REGISTRY_URL };

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

@@ -0,0 +1,19 @@
+//#region src/scaffold/app-scaffold.service.d.ts
+type AppScaffoldResult = {
+  appDirectory: string;
+  manifestPath: string;
+};
+declare class AppScaffoldService {
+  scaffold: (targetDirectory: string) => Promise<AppScaffoldResult>;
+  private assertTargetDoesNotExist;
+  private buildAppId;
+  private buildAppName;
+  private normalizeSlug;
+  private buildManifest;
+  private buildWatSource;
+  private buildUiHtml;
+  private buildUiController;
+  private buildIconSvg;
+}
+//#endregion
+export { AppScaffoldService };

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

@@ -255,6 +255,6 @@ await loadManifest();
 `;
 	};
 };
-const APP_WASM_BASE64 = "AGFzbQEAAAABBwFgAn9/AX8DAgEABxMBD3N1bW1hcml6ZV9ub3RlcwAACg0BCwAgACABagsQQQQK";
+const APP_WASM_BASE64 = "AGFzbQEAAAABBwFgAn9/AX8DAgEABxMBD3N1bW1hcml6ZV9ub3RlcwAACg0BCwAgACABakHIAWoL";
 //#endregion
 export { AppScaffoldService };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/app-runtime",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "private": false,
   "description": "Standalone micro app runtime and CLI for NextClaw apps.",
   "type": "module",
@@ -38,7 +38,9 @@
     "dist",
     "README.md"
   ],
-  "dependencies": {},
+  "dependencies": {
+    "fflate": "^0.8.2"
+  },
   "devDependencies": {
     "@types/node": "^20.17.6",
     "prettier": "^3.3.3",