@allbluecn/kernel 0.2.0 → 0.2.2

package/dist/src-B6_ZEkl9.js

@@ -0,0 +1,316 @@
+//#region src/define-plugin.ts
+const PLUGIN_ID_RE = /^@[a-z0-9-]+\/[a-z0-9-]+$/;
+function definePlugin(def) {
+	if (!PLUGIN_ID_RE.test(def.id)) throw new Error(`插件 id 必须形如 '@scope/name'（小写），收到: ${def.id}`);
+	if (!/^\d+\.\d+\.\d+/.test(def.version)) throw new Error(`插件 version 必须是语义化版本，收到: ${def.version}`);
+	return deepFreeze(def);
+}
+function deepFreeze(value) {
+	if (value && typeof value === "object" && !Object.isFrozen(value)) {
+		Object.freeze(value);
+		for (const key of Object.keys(value)) deepFreeze(value[key]);
+	}
+	return value;
+}
+//#endregion
+//#region src/define-profile.ts
+const PROFILE_ID_RE = /^[a-z0-9][a-z0-9-]*$/;
+function defineProfile(profile) {
+	if (!PROFILE_ID_RE.test(profile.id)) throw new Error(`profile id 只允许小写字母/数字/连字符，收到: ${profile.id}`);
+	const seen = /* @__PURE__ */ new Set();
+	for (const plugin of profile.plugins) {
+		if (seen.has(plugin.id)) throw new Error(`profile 中存在重复插件 id: ${plugin.id}`);
+		seen.add(plugin.id);
+	}
+	return Object.freeze({
+		...profile,
+		plugins: Object.freeze([...profile.plugins])
+	});
+}
+//#endregion
+//#region src/resolve-order.ts
+function resolvePluginOrder(plugins) {
+	const byId = /* @__PURE__ */ new Map();
+	for (const plugin of plugins) {
+		if (byId.has(plugin.id)) throw new Error(`重复插件 id: ${plugin.id}`);
+		byId.set(plugin.id, plugin);
+	}
+	for (const plugin of plugins) for (const dep of plugin.dependencies ?? []) if (!byId.has(dep)) throw new Error(`插件 ${plugin.id} 依赖的 ${dep} 未在 profile 中声明`);
+	const declarationIndex = new Map(plugins.map((p, i) => [p.id, i]));
+	const inDegree = /* @__PURE__ */ new Map();
+	const dependents = /* @__PURE__ */ new Map();
+	for (const plugin of plugins) {
+		inDegree.set(plugin.id, plugin.dependencies?.length ?? 0);
+		for (const dep of plugin.dependencies ?? []) dependents.set(dep, [...dependents.get(dep) ?? [], plugin.id]);
+	}
+	const ready = plugins.filter((p) => (inDegree.get(p.id) ?? 0) === 0).sort((a, b) => declarationIndex.get(a.id) - declarationIndex.get(b.id)).map((p) => p.id);
+	const orderIds = [];
+	while (ready.length > 0) {
+		const id = ready.shift();
+		orderIds.push(id);
+		for (const dependent of dependents.get(id) ?? []) {
+			const next = (inDegree.get(dependent) ?? 0) - 1;
+			inDegree.set(dependent, next);
+			if (next === 0) ready.push(dependent);
+		}
+	}
+	if (orderIds.length !== plugins.length) {
+		const cyclePath = findCyclePath(plugins.filter((p) => !orderIds.includes(p.id)).map((p) => p.id), byId);
+		throw new Error(`检测到依赖环: ${cyclePath.join(" -> ")}`);
+	}
+	return {
+		order: orderIds.map((id) => byId.get(id)),
+		ids: orderIds
+	};
+}
+function findCyclePath(cyclicIds, byId) {
+	const start = cyclicIds[0];
+	const path = [start];
+	const visited = /* @__PURE__ */ new Set([start]);
+	let current = start;
+	while (true) {
+		const deps = byId.get(current)?.dependencies ?? [];
+		const next = deps.find((d) => cyclicIds.includes(d)) ?? deps[0];
+		if (!next) break;
+		if (next === start || visited.has(next)) {
+			path.push(next);
+			return path;
+		}
+		visited.add(next);
+		path.push(next);
+		current = next;
+	}
+	return path;
+}
+//#endregion
+//#region src/assemble-input.ts
+function parseProfileImports(source) {
+	const map = /* @__PURE__ */ new Map();
+	const re = /import\s+([A-Za-z_$][\w$]*)\s+from\s+['"]([^'"]+)['"]/g;
+	let m;
+	while ((m = re.exec(source)) !== null) map.set(m[1], m[2]);
+	return map;
+}
+function resolveImportSpecifiers(input) {
+	const byId = /* @__PURE__ */ new Map();
+	input.resolved.order.forEach((plugin, index) => {
+		const localName = input.pluginLocalNames[index];
+		if (!localName) throw new Error(`插件 ${plugin.id} 在 profile 源码中找不到对应标识符`);
+		const specifier = input.imports.get(localName);
+		if (!specifier) throw new Error(`标识符 ${localName} 没有 default import（约定：profile 中插件必须以 default import 引入）`);
+		byId.set(plugin.id, specifier);
+	});
+	return byId;
+}
+//#endregion
+//#region src/generate-assembly.ts
+function generateAssemblyCode(input) {
+	const { profileId, profileModulePath, resolved } = input;
+	const ids = resolved.ids.map((id) => `'${id}'`).join(", ");
+	return [
+		`// AUTO-GENERATED by @allbluecn/kernel — DO NOT EDIT`,
+		`// profile: ${profileId} (validated: ${resolved.order.length} plugins)`,
+		`// 拓扑序（被依赖者在前）：${resolved.ids.join(" -> ")}`,
+		`import type { ProfileDefinition } from '@allbluecn/kernel'`,
+		``,
+		`export { default as profile } from '${profileModulePath}'`,
+		``,
+		`export const pluginIds: string[] = [${ids}]`,
+		``,
+		`declare const _profile: ProfileDefinition`
+	].join("\n");
+}
+const HEADER = "// AUTO-GENERATED by @allbluecn/kernel — DO NOT EDIT";
+const ALL_FEATURES = [
+	"billing",
+	"hostedAi",
+	"sso",
+	"audit",
+	"permissions",
+	"license",
+	"versionHistory",
+	"automation",
+	"templates",
+	"analytics",
+	"globalSearch",
+	"compliance"
+];
+function generateAssemblyFiles(input) {
+	const specifiers = resolveImportSpecifiers(input);
+	const { resolved } = input;
+	const importLines = resolved.order.map((p, i) => {
+		return `import ${input.pluginLocalNames[i]} from '${specifiers.get(p.id)}'`;
+	});
+	const pluginList = input.pluginLocalNames.slice(0, resolved.order.length).join(", ");
+	const middlewareParts = resolved.order.map((p, i) => {
+		return `  ...${input.pluginLocalNames[i]}.contributes.serverMiddleware ?? [],`;
+	}).join("\n");
+	const pluginsGen = [
+		HEADER,
+		`// profile: ${input.profileId} (validated: ${resolved.order.length} plugins)`,
+		`// 拓扑序：${resolved.ids.join(" -> ")}`,
+		...importLines,
+		`import { defineProfile, type ProfileDefinition } from '@allbluecn/kernel'`,
+		``,
+		`export const profile: ProfileDefinition = defineProfile({`,
+		`  id: '${input.profileId}',`,
+		`  plugins: [${pluginList}],`,
+		`})`,
+		``,
+		`export const pluginIds: string[] = [${resolved.ids.map((i) => `'${i}'`).join(", ")}]`,
+		``,
+		`export const pluginMiddleware: unknown[] = [`,
+		middlewareParts,
+		`]`
+	].join("\n");
+	const implLines = ALL_FEATURES.map((f) => {
+		return `  ${f}: ${resolved.order.some((p) => p.contributes.services?.[f] !== void 0)},`;
+	});
+	const modulesGen = [
+		HEADER,
+		`import type { ProFeature } from '@allbluecn/kernel'`,
+		``,
+		`export const activePluginIds = [${resolved.ids.map((i) => `'${i}'`).join(", ")}] as const`,
+		`export type ActivePluginId = (typeof activePluginIds)[number]`,
+		``,
+		`export const implementedModules: Record<ProFeature, boolean> = {`,
+		...implLines,
+		`}`
+	].join("\n");
+	const uiImports = [];
+	const navItems = [];
+	const settingsTabs = [];
+	const widgets = [];
+	for (let i = 0; i < resolved.order.length; i++) {
+		const p = resolved.order[i];
+		const local = input.pluginLocalNames[i];
+		const spec = specifiers.get(p.id);
+		const slots = p.contributes.uiSlots;
+		if (!slots) continue;
+		for (const [key] of Object.entries(slots.navItems ?? {})) {
+			uiImports.push(`import { ${key} } from '${spec}/ui'`);
+			navItems.push(key);
+		}
+		if (slots.settingsTabs?.length) {
+			uiImports.push(`import { ${local}SettingsTabs } from '${spec}/ui'`);
+			settingsTabs.push(`...${local}SettingsTabs`);
+		}
+		for (const [key] of Object.entries(slots.dashboardWidgets ?? {})) {
+			uiImports.push(`import { ${key} } from '${spec}/ui'`);
+			widgets.push(key);
+		}
+	}
+	const uiGen = [
+		HEADER,
+		...uiImports,
+		`import { type ComponentType } from 'react'`,
+		`import type { SettingsTabContribution } from '@allbluecn/kernel'`,
+		``,
+		`export const navItems: ComponentType[] = [${navItems.join(", ")}]`,
+		`export const settingsTabs: SettingsTabContribution[] = [${settingsTabs.join(", ")}]`,
+		`export const dashboardWidgets: ComponentType[] = [${widgets.join(", ")}]`
+	].join("\n");
+	const routeFiles = /* @__PURE__ */ new Map();
+	for (let i = 0; i < resolved.order.length; i++) {
+		const p = resolved.order[i];
+		const spec = specifiers.get(p.id);
+		p.contributes.routes?.forEach((r, j) => {
+			const file = routeContributionToFile(r.path);
+			const varName = `${input.pluginLocalNames[i]}_route_${j}`;
+			const routePath = r.path.endsWith("/") ? r.path.slice(0, -1) : r.path;
+			const lines = [
+				HEADER,
+				`import { createFileRoute } from '@tanstack/react-router'`,
+				`import type { PluginRouteContext } from '@allbluecn/kernel'`,
+				`import { ${varName} } from '${spec}/routes'`,
+				``,
+				`export const Route = createFileRoute('${routePath}')({`,
+				...r.beforeLoad ? [`  beforeLoad: ((ctx: PluginRouteContext) => ${varName}.beforeLoad(ctx)) as any,`] : [],
+				...r.loader ? [`  loader: ((ctx: PluginRouteContext) => ${varName}.loader(ctx)) as any,`] : [],
+				...r.validateSearch ? [`  validateSearch: ${varName}.validateSearch as any,`] : [],
+				`  component: ${varName}.Component as any,`,
+				`})`
+			];
+			routeFiles.set(file, lines.join("\n"));
+		});
+	}
+	return {
+		pluginsGen,
+		modulesGen,
+		uiGen,
+		routeFiles
+	};
+}
+function routeContributionToFile(path) {
+	if (path.endsWith("/")) return `src/routes${path.slice(0, -1) || ""}/index.tsx`;
+	return `src/routes${path}/route.tsx`;
+}
+//#endregion
+//#region src/dump-modules.ts
+function dumpModules(profileId, resolved) {
+	const lines = [`profile: ${profileId} (${resolved.order.length} plugins)`];
+	for (const plugin of resolved.order) {
+		const c = plugin.contributes;
+		const parts = [];
+		if (c.routes?.length) parts.push(`routes:${c.routes.length}`);
+		if (c.serverMiddleware?.length) parts.push(`middleware:${c.serverMiddleware.length}`);
+		if (c.queryOptions && Object.keys(c.queryOptions).length) parts.push(`queries:${Object.keys(c.queryOptions).length}`);
+		if (c.uiSlots && Object.keys(c.uiSlots).length) parts.push(`ui-slots:${Object.keys(c.uiSlots).length}`);
+		if (c.features?.length) parts.push(`features:${c.features.length}`);
+		if (c.aiTools?.length) parts.push(`ai-tools:${c.aiTools.length}`);
+		if (c.prisma?.models.length) parts.push(`prisma-models:${c.prisma.models.length}`);
+		lines.push(`${plugin.id}@${plugin.version} — ${parts.length ? parts.join(" ") : "no contributions"}`);
+	}
+	return lines.join("\n");
+}
+//#endregion
+//#region src/pro-contract/billing.ts
+var BillingUnavailableError = class BillingUnavailableError extends Error {
+	constructor(message = "计费模块不可用") {
+		super(message);
+		this.name = "BillingUnavailableError";
+		Object.setPrototypeOf(this, BillingUnavailableError.prototype);
+	}
+};
+var WebhookSignatureError = class WebhookSignatureError extends Error {
+	constructor(message = "Webhook 签名验证失败") {
+		super(message);
+		this.name = "WebhookSignatureError";
+		Object.setPrototypeOf(this, WebhookSignatureError.prototype);
+	}
+};
+var SeatsExceededError = class SeatsExceededError extends Error {
+	current;
+	max;
+	constructor(current, max) {
+		super(`席位不足：当前 ${current}/${max}`);
+		this.name = "SeatsExceededError";
+		this.current = current;
+		this.max = max;
+		Object.setPrototypeOf(this, SeatsExceededError.prototype);
+	}
+};
+//#endregion
+//#region src/pro-contract/hosted-ai.ts
+var HostedAiError = class extends Error {
+	code;
+	details;
+	constructor(code, message, details) {
+		super(message);
+		this.code = code;
+		this.details = details;
+		this.name = "HostedAiError";
+	}
+};
+//#endregion
+//#region src/server-seam.ts
+let seam = null;
+function registerServerSeam(impl) {
+	seam = impl;
+}
+function getServerSeam() {
+	if (!seam) throw new Error("ServerSeam 未注册：宿主需在 start.ts 中调用 registerServerSeam()");
+	return seam;
+}
+//#endregion
+export { SeatsExceededError as a, generateAssemblyCode as c, resolveImportSpecifiers as d, resolvePluginOrder as f, BillingUnavailableError as i, generateAssemblyFiles as l, definePlugin as m, registerServerSeam as n, WebhookSignatureError as o, defineProfile as p, HostedAiError as r, dumpModules as s, getServerSeam as t, parseProfileImports as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allbluecn/kernel",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "license": "AGPL-3.0-or-later",
   "type": "module",
   "description": "AllBlue 插件协议：类型定义 + 构建期装配器（零运行时）",
@@ -15,14 +15,9 @@
   "bin": {
     "allblue": "./dist/bin.js"
   },
-  "files": ["dist"],
-  "scripts": {
-    "build": "tsdown",
-    "lint": "tsc --noEmit",
-    "test": "vitest",
-    "test:run": "vitest run",
-    "typecheck": "tsc --noEmit"
-  },
+  "files": [
+    "dist"
+  ],
   "peerDependencies": {
     "@tanstack/react-start": "1.168.46",
     "@tanstack/ai": "0.43.0",
@@ -37,5 +32,12 @@
     "tsdown": "^0.22.0",
     "typescript": "^7",
     "vitest": "4.1.5"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "lint": "tsc --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
-}
+}

package/dist/src-Dvcggyr-.js

@@ -1,122 +0,0 @@
-//#region src/define-plugin.ts
-const PLUGIN_ID_RE = /^@[a-z0-9-]+\/[a-z0-9-]+$/;
-function definePlugin(def) {
-	if (!PLUGIN_ID_RE.test(def.id)) throw new Error(`插件 id 必须形如 '@scope/name'（小写），收到: ${def.id}`);
-	if (!/^\d+\.\d+\.\d+/.test(def.version)) throw new Error(`插件 version 必须是语义化版本，收到: ${def.version}`);
-	return deepFreeze(def);
-}
-function deepFreeze(value) {
-	if (value && typeof value === "object" && !Object.isFrozen(value)) {
-		Object.freeze(value);
-		for (const key of Object.keys(value)) deepFreeze(value[key]);
-	}
-	return value;
-}
-//#endregion
-//#region src/define-profile.ts
-const PROFILE_ID_RE = /^[a-z0-9][a-z0-9-]*$/;
-function defineProfile(profile) {
-	if (!PROFILE_ID_RE.test(profile.id)) throw new Error(`profile id 只允许小写字母/数字/连字符，收到: ${profile.id}`);
-	const seen = /* @__PURE__ */ new Set();
-	for (const plugin of profile.plugins) {
-		if (seen.has(plugin.id)) throw new Error(`profile 中存在重复插件 id: ${plugin.id}`);
-		seen.add(plugin.id);
-	}
-	return Object.freeze({
-		...profile,
-		plugins: Object.freeze([...profile.plugins])
-	});
-}
-//#endregion
-//#region src/resolve-order.ts
-function resolvePluginOrder(plugins) {
-	const byId = /* @__PURE__ */ new Map();
-	for (const plugin of plugins) {
-		if (byId.has(plugin.id)) throw new Error(`重复插件 id: ${plugin.id}`);
-		byId.set(plugin.id, plugin);
-	}
-	for (const plugin of plugins) for (const dep of plugin.dependencies ?? []) if (!byId.has(dep)) throw new Error(`插件 ${plugin.id} 依赖的 ${dep} 未在 profile 中声明`);
-	const declarationIndex = new Map(plugins.map((p, i) => [p.id, i]));
-	const inDegree = /* @__PURE__ */ new Map();
-	const dependents = /* @__PURE__ */ new Map();
-	for (const plugin of plugins) {
-		inDegree.set(plugin.id, plugin.dependencies?.length ?? 0);
-		for (const dep of plugin.dependencies ?? []) dependents.set(dep, [...dependents.get(dep) ?? [], plugin.id]);
-	}
-	const ready = plugins.filter((p) => (inDegree.get(p.id) ?? 0) === 0).sort((a, b) => declarationIndex.get(a.id) - declarationIndex.get(b.id)).map((p) => p.id);
-	const orderIds = [];
-	while (ready.length > 0) {
-		const id = ready.shift();
-		orderIds.push(id);
-		for (const dependent of dependents.get(id) ?? []) {
-			const next = (inDegree.get(dependent) ?? 0) - 1;
-			inDegree.set(dependent, next);
-			if (next === 0) ready.push(dependent);
-		}
-	}
-	if (orderIds.length !== plugins.length) {
-		const cyclePath = findCyclePath(plugins.filter((p) => !orderIds.includes(p.id)).map((p) => p.id), byId);
-		throw new Error(`检测到依赖环: ${cyclePath.join(" -> ")}`);
-	}
-	return {
-		order: orderIds.map((id) => byId.get(id)),
-		ids: orderIds
-	};
-}
-function findCyclePath(cyclicIds, byId) {
-	const start = cyclicIds[0];
-	const path = [start];
-	const visited = /* @__PURE__ */ new Set([start]);
-	let current = start;
-	while (true) {
-		const deps = byId.get(current)?.dependencies ?? [];
-		const next = deps.find((d) => cyclicIds.includes(d)) ?? deps[0];
-		if (!next) break;
-		if (next === start || visited.has(next)) {
-			path.push(next);
-			return path;
-		}
-		visited.add(next);
-		path.push(next);
-		current = next;
-	}
-	return path;
-}
-//#endregion
-//#region src/generate-assembly.ts
-function generateAssemblyCode(input) {
-	const { profileId, profileModulePath, resolved } = input;
-	const ids = resolved.ids.map((id) => `'${id}'`).join(", ");
-	return [
-		`// AUTO-GENERATED by @allbluecn/kernel — DO NOT EDIT`,
-		`// profile: ${profileId} (validated: ${resolved.order.length} plugins)`,
-		`// 拓扑序（被依赖者在前）：${resolved.ids.join(" -> ")}`,
-		`import type { ProfileDefinition } from '@allbluecn/kernel'`,
-		``,
-		`export { default as profile } from '${profileModulePath}'`,
-		``,
-		`export const pluginIds: string[] = [${ids}]`,
-		``,
-		`declare const _profile: ProfileDefinition`
-	].join("\n");
-}
-//#endregion
-//#region src/dump-modules.ts
-function dumpModules(profileId, resolved) {
-	const lines = [`profile: ${profileId} (${resolved.order.length} plugins)`];
-	for (const plugin of resolved.order) {
-		const c = plugin.contributes;
-		const parts = [];
-		if (c.routes?.length) parts.push(`routes:${c.routes.length}`);
-		if (c.serverMiddleware?.length) parts.push(`middleware:${c.serverMiddleware.length}`);
-		if (c.queryOptions && Object.keys(c.queryOptions).length) parts.push(`queries:${Object.keys(c.queryOptions).length}`);
-		if (c.uiSlots && Object.keys(c.uiSlots).length) parts.push(`ui-slots:${Object.keys(c.uiSlots).length}`);
-		if (c.features?.length) parts.push(`features:${c.features.length}`);
-		if (c.aiTools?.length) parts.push(`ai-tools:${c.aiTools.length}`);
-		if (c.prisma?.models.length) parts.push(`prisma-models:${c.prisma.models.length}`);
-		lines.push(`${plugin.id}@${plugin.version} — ${parts.length ? parts.join(" ") : "no contributions"}`);
-	}
-	return lines.join("\n");
-}
-//#endregion
-export { definePlugin as a, defineProfile as i, generateAssemblyCode as n, resolvePluginOrder as r, dumpModules as t };