@aigne/aos 0.2.0-beta

package/dist/auto-surface/value-dsl.cjs

@@ -0,0 +1,80 @@
+const require_dsl_shared = require('../dsl-shared.cjs');
+
+//#region src/auto-surface/value-dsl.ts
+var AutoSurfaceValueDslCompileError = class extends Error {
+	constructor(message, line, column = 1) {
+		super(`${line}:${column} ${message}`);
+		this.line = line;
+		this.column = column;
+		this.name = "AutoSurfaceValueDslCompileError";
+	}
+};
+const LAYERS = new Set([
+	"system",
+	"package",
+	"instance",
+	"user"
+]);
+function compileAutoSurfaceValueDsl(source) {
+	const values = [];
+	const declaration = require_dsl_shared.parseDeclaration(source, {
+		kind: "surface-values",
+		expected: "Expected surface-values <layer> {",
+		fieldKeywords: ["value"],
+		error: parseSharedError
+	});
+	const layer = declaration.id;
+	if (!LAYERS.has(layer)) throw new AutoSurfaceValueDslCompileError(`Unsupported value layer: ${declaration.id}`, declaration.idToken.line, declaration.idToken.column);
+	for (const field of declaration.fields) values.push(parseValueField(field));
+	const files = {};
+	for (const entry of values) {
+		const file = `${layer}/${entry.path}.value.json`;
+		if (Object.hasOwn(files, file)) throw new AutoSurfaceValueDslCompileError(`Duplicate auto-surface value path: ${entry.path}`, entry.line, entry.column);
+		files[file] = { value: entry.value };
+	}
+	return {
+		layer,
+		files,
+		values
+	};
+}
+function formatAutoSurfaceValueDsl(source) {
+	const compiled = compileAutoSurfaceValueDsl(source);
+	const lines = [`surface-values ${compiled.layer} {`];
+	for (const entry of compiled.values) lines.push(`  value ${entry.path} ${JSON.stringify(entry.value)}`);
+	lines.push("}");
+	return `${lines.join("\n")}\n`;
+}
+function normalizeValuePath(path, line, column) {
+	const normalized = path.replace(/^\//, "").replace(/\/$/, "");
+	if (!normalized || normalized.includes("..")) throw new AutoSurfaceValueDslCompileError("value path cannot be empty or contain traversal", line, column);
+	return normalized;
+}
+function parseValueField(field) {
+	const path = field.values[0];
+	if (path?.type !== "word" || field.values.length < 2) throw new AutoSurfaceValueDslCompileError("Expected value <path> <json>", field.name.line, field.name.column);
+	return {
+		path: normalizeValuePath(path.value, path.line, path.column),
+		value: parseJsonValue(joinDslValues(field.values.slice(1)), field.name.line, path.column),
+		line: field.name.line,
+		column: path.column
+	};
+}
+function joinDslValues(tokens) {
+	return tokens.map((token) => token.value).join(" ");
+}
+function parseSharedError(message, line, column = 1) {
+	return new AutoSurfaceValueDslCompileError(message, line, column);
+}
+function parseJsonValue(source, line, column) {
+	try {
+		return JSON.parse(source);
+	} catch (error) {
+		throw new AutoSurfaceValueDslCompileError(`Invalid JSON value: ${error instanceof Error ? error.message : String(error)}`, line, column);
+	}
+}
+
+//#endregion
+exports.AutoSurfaceValueDslCompileError = AutoSurfaceValueDslCompileError;
+exports.compileAutoSurfaceValueDsl = compileAutoSurfaceValueDsl;
+exports.formatAutoSurfaceValueDsl = formatAutoSurfaceValueDsl;

package/dist/auto-surface/value-dsl.d.cts

@@ -0,0 +1,24 @@
+import { AutoSurfaceLayer } from "./types.cjs";
+
+//#region src/auto-surface/value-dsl.d.ts
+interface AutoSurfaceValueDslCompileResult {
+  layer: AutoSurfaceLayer;
+  files: Record<string, unknown>;
+  values: AutoSurfaceValueDslEntry[];
+}
+interface AutoSurfaceValueDslEntry {
+  path: string;
+  value: unknown;
+  line: number;
+  column: number;
+}
+declare class AutoSurfaceValueDslCompileError extends Error {
+  readonly line: number;
+  readonly column: number;
+  constructor(message: string, line: number, column?: number);
+}
+declare function compileAutoSurfaceValueDsl(source: string): AutoSurfaceValueDslCompileResult;
+declare function formatAutoSurfaceValueDsl(source: string): string;
+//#endregion
+export { AutoSurfaceValueDslCompileError, AutoSurfaceValueDslCompileResult, AutoSurfaceValueDslEntry, compileAutoSurfaceValueDsl, formatAutoSurfaceValueDsl };
+//# sourceMappingURL=value-dsl.d.cts.map

package/dist/auto-surface/value-dsl.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-dsl.d.cts","names":[],"sources":["../../src/auto-surface/value-dsl.ts"],"mappings":";;;UAGiB,gCAAA;EACf,KAAA,EAAO,gBAAA;EACP,KAAA,EAAO,MAAA;EACP,MAAA,EAAQ,wBAAA;AAAA;AAAA,UAGO,wBAAA;EACf,IAAA;EACA,KAAA;EACA,IAAA;EACA,MAAA;AAAA;AAAA,cAGW,+BAAA,SAAwC,KAAA;EAAA,SAGxC,IAAA;EAAA,SACA,MAAA;cAFT,OAAA,UACS,IAAA,UACA,MAAA;AAAA;AAAA,iBASG,0BAAA,CAA2B,MAAA,WAAiB,gCAAA;AAAA,iBAuC5C,yBAAA,CAA0B,MAAA"}

package/dist/auto-surface/value-dsl.d.mts

@@ -0,0 +1,24 @@
+import { AutoSurfaceLayer } from "./types.mjs";
+
+//#region src/auto-surface/value-dsl.d.ts
+interface AutoSurfaceValueDslCompileResult {
+  layer: AutoSurfaceLayer;
+  files: Record<string, unknown>;
+  values: AutoSurfaceValueDslEntry[];
+}
+interface AutoSurfaceValueDslEntry {
+  path: string;
+  value: unknown;
+  line: number;
+  column: number;
+}
+declare class AutoSurfaceValueDslCompileError extends Error {
+  readonly line: number;
+  readonly column: number;
+  constructor(message: string, line: number, column?: number);
+}
+declare function compileAutoSurfaceValueDsl(source: string): AutoSurfaceValueDslCompileResult;
+declare function formatAutoSurfaceValueDsl(source: string): string;
+//#endregion
+export { AutoSurfaceValueDslCompileError, AutoSurfaceValueDslCompileResult, AutoSurfaceValueDslEntry, compileAutoSurfaceValueDsl, formatAutoSurfaceValueDsl };
+//# sourceMappingURL=value-dsl.d.mts.map

package/dist/auto-surface/value-dsl.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-dsl.d.mts","names":[],"sources":["../../src/auto-surface/value-dsl.ts"],"mappings":";;;UAGiB,gCAAA;EACf,KAAA,EAAO,gBAAA;EACP,KAAA,EAAO,MAAA;EACP,MAAA,EAAQ,wBAAA;AAAA;AAAA,UAGO,wBAAA;EACf,IAAA;EACA,KAAA;EACA,IAAA;EACA,MAAA;AAAA;AAAA,cAGW,+BAAA,SAAwC,KAAA;EAAA,SAGxC,IAAA;EAAA,SACA,MAAA;cAFT,OAAA,UACS,IAAA,UACA,MAAA;AAAA;AAAA,iBASG,0BAAA,CAA2B,MAAA,WAAiB,gCAAA;AAAA,iBAuC5C,yBAAA,CAA0B,MAAA"}

package/dist/auto-surface/value-dsl.mjs

@@ -0,0 +1,79 @@
+import { parseDeclaration } from "../dsl-shared.mjs";
+
+//#region src/auto-surface/value-dsl.ts
+var AutoSurfaceValueDslCompileError = class extends Error {
+	constructor(message, line, column = 1) {
+		super(`${line}:${column} ${message}`);
+		this.line = line;
+		this.column = column;
+		this.name = "AutoSurfaceValueDslCompileError";
+	}
+};
+const LAYERS = new Set([
+	"system",
+	"package",
+	"instance",
+	"user"
+]);
+function compileAutoSurfaceValueDsl(source) {
+	const values = [];
+	const declaration = parseDeclaration(source, {
+		kind: "surface-values",
+		expected: "Expected surface-values <layer> {",
+		fieldKeywords: ["value"],
+		error: parseSharedError
+	});
+	const layer = declaration.id;
+	if (!LAYERS.has(layer)) throw new AutoSurfaceValueDslCompileError(`Unsupported value layer: ${declaration.id}`, declaration.idToken.line, declaration.idToken.column);
+	for (const field of declaration.fields) values.push(parseValueField(field));
+	const files = {};
+	for (const entry of values) {
+		const file = `${layer}/${entry.path}.value.json`;
+		if (Object.hasOwn(files, file)) throw new AutoSurfaceValueDslCompileError(`Duplicate auto-surface value path: ${entry.path}`, entry.line, entry.column);
+		files[file] = { value: entry.value };
+	}
+	return {
+		layer,
+		files,
+		values
+	};
+}
+function formatAutoSurfaceValueDsl(source) {
+	const compiled = compileAutoSurfaceValueDsl(source);
+	const lines = [`surface-values ${compiled.layer} {`];
+	for (const entry of compiled.values) lines.push(`  value ${entry.path} ${JSON.stringify(entry.value)}`);
+	lines.push("}");
+	return `${lines.join("\n")}\n`;
+}
+function normalizeValuePath(path, line, column) {
+	const normalized = path.replace(/^\//, "").replace(/\/$/, "");
+	if (!normalized || normalized.includes("..")) throw new AutoSurfaceValueDslCompileError("value path cannot be empty or contain traversal", line, column);
+	return normalized;
+}
+function parseValueField(field) {
+	const path = field.values[0];
+	if (path?.type !== "word" || field.values.length < 2) throw new AutoSurfaceValueDslCompileError("Expected value <path> <json>", field.name.line, field.name.column);
+	return {
+		path: normalizeValuePath(path.value, path.line, path.column),
+		value: parseJsonValue(joinDslValues(field.values.slice(1)), field.name.line, path.column),
+		line: field.name.line,
+		column: path.column
+	};
+}
+function joinDslValues(tokens) {
+	return tokens.map((token) => token.value).join(" ");
+}
+function parseSharedError(message, line, column = 1) {
+	return new AutoSurfaceValueDslCompileError(message, line, column);
+}
+function parseJsonValue(source, line, column) {
+	try {
+		return JSON.parse(source);
+	} catch (error) {
+		throw new AutoSurfaceValueDslCompileError(`Invalid JSON value: ${error instanceof Error ? error.message : String(error)}`, line, column);
+	}
+}
+
+//#endregion
+export { AutoSurfaceValueDslCompileError, compileAutoSurfaceValueDsl, formatAutoSurfaceValueDsl };
+//# sourceMappingURL=value-dsl.mjs.map

package/dist/auto-surface/value-dsl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-dsl.mjs","names":[],"sources":["../../src/auto-surface/value-dsl.ts"],"sourcesContent":["import { type DslField, type DslToken, parseDeclaration } from \"../dsl-shared.js\";\nimport type { AutoSurfaceLayer } from \"./types.js\";\n\nexport interface AutoSurfaceValueDslCompileResult {\n  layer: AutoSurfaceLayer;\n  files: Record<string, unknown>;\n  values: AutoSurfaceValueDslEntry[];\n}\n\nexport interface AutoSurfaceValueDslEntry {\n  path: string;\n  value: unknown;\n  line: number;\n  column: number;\n}\n\nexport class AutoSurfaceValueDslCompileError extends Error {\n  constructor(\n    message: string,\n    readonly line: number,\n    readonly column = 1,\n  ) {\n    super(`${line}:${column} ${message}`);\n    this.name = \"AutoSurfaceValueDslCompileError\";\n  }\n}\n\nconst LAYERS = new Set<AutoSurfaceLayer>([\"system\", \"package\", \"instance\", \"user\"]);\n\nexport function compileAutoSurfaceValueDsl(source: string): AutoSurfaceValueDslCompileResult {\n  const values: AutoSurfaceValueDslEntry[] = [];\n\n  const declaration = parseDeclaration(source, {\n    kind: \"surface-values\",\n    expected: \"Expected surface-values <layer> {\",\n    fieldKeywords: [\"value\"],\n    error: parseSharedError,\n  });\n\n  const layer = declaration.id as AutoSurfaceLayer;\n  if (!LAYERS.has(layer)) {\n    throw new AutoSurfaceValueDslCompileError(\n      `Unsupported value layer: ${declaration.id}`,\n      declaration.idToken.line,\n      declaration.idToken.column,\n    );\n  }\n\n  for (const field of declaration.fields) {\n    values.push(parseValueField(field));\n  }\n\n  const files: Record<string, unknown> = {};\n  for (const entry of values) {\n    const file = `${layer}/${entry.path}.value.json`;\n    if (Object.hasOwn(files, file)) {\n      throw new AutoSurfaceValueDslCompileError(\n        `Duplicate auto-surface value path: ${entry.path}`,\n        entry.line,\n        entry.column,\n      );\n    }\n    files[file] = { value: entry.value };\n  }\n\n  return { layer, files, values };\n}\n\nexport function formatAutoSurfaceValueDsl(source: string): string {\n  const compiled = compileAutoSurfaceValueDsl(source);\n  const lines = [`surface-values ${compiled.layer} {`];\n  for (const entry of compiled.values) {\n    lines.push(`  value ${entry.path} ${JSON.stringify(entry.value)}`);\n  }\n  lines.push(\"}\");\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\nfunction normalizeValuePath(path: string, line: number, column: number): string {\n  const normalized = path.replace(/^\\//, \"\").replace(/\\/$/, \"\");\n  if (!normalized || normalized.includes(\"..\")) {\n    throw new AutoSurfaceValueDslCompileError(\n      \"value path cannot be empty or contain traversal\",\n      line,\n      column,\n    );\n  }\n  return normalized;\n}\n\nfunction parseValueField(field: DslField): AutoSurfaceValueDslEntry {\n  const path = field.values[0];\n  if (path?.type !== \"word\" || field.values.length < 2) {\n    throw new AutoSurfaceValueDslCompileError(\n      \"Expected value <path> <json>\",\n      field.name.line,\n      field.name.column,\n    );\n  }\n\n  return {\n    path: normalizeValuePath(path.value, path.line, path.column),\n    value: parseJsonValue(joinDslValues(field.values.slice(1)), field.name.line, path.column),\n    line: field.name.line,\n    column: path.column,\n  };\n}\n\nfunction joinDslValues(tokens: DslToken[]): string {\n  return tokens.map((token) => token.value).join(\" \");\n}\n\nfunction parseSharedError(message: string, line: number, column = 1): Error {\n  return new AutoSurfaceValueDslCompileError(message, line, column);\n}\n\nfunction parseJsonValue(source: string, line: number, column: number): unknown {\n  try {\n    return JSON.parse(source);\n  } catch (error) {\n    throw new AutoSurfaceValueDslCompileError(\n      `Invalid JSON value: ${error instanceof Error ? error.message : String(error)}`,\n      line,\n      column,\n    );\n  }\n}\n"],"mappings":";;;AAgBA,IAAa,kCAAb,cAAqD,MAAM;CACzD,YACE,SACA,AAAS,MACT,AAAS,SAAS,GAClB;AACA,QAAM,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU;EAH5B;EACA;AAGT,OAAK,OAAO;;;AAIhB,MAAM,SAAS,IAAI,IAAsB;CAAC;CAAU;CAAW;CAAY;CAAO,CAAC;AAEnF,SAAgB,2BAA2B,QAAkD;CAC3F,MAAM,SAAqC,EAAE;CAE7C,MAAM,cAAc,iBAAiB,QAAQ;EAC3C,MAAM;EACN,UAAU;EACV,eAAe,CAAC,QAAQ;EACxB,OAAO;EACR,CAAC;CAEF,MAAM,QAAQ,YAAY;AAC1B,KAAI,CAAC,OAAO,IAAI,MAAM,CACpB,OAAM,IAAI,gCACR,4BAA4B,YAAY,MACxC,YAAY,QAAQ,MACpB,YAAY,QAAQ,OACrB;AAGH,MAAK,MAAM,SAAS,YAAY,OAC9B,QAAO,KAAK,gBAAgB,MAAM,CAAC;CAGrC,MAAM,QAAiC,EAAE;AACzC,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,KAAK;AACpC,MAAI,OAAO,OAAO,OAAO,KAAK,CAC5B,OAAM,IAAI,gCACR,sCAAsC,MAAM,QAC5C,MAAM,MACN,MAAM,OACP;AAEH,QAAM,QAAQ,EAAE,OAAO,MAAM,OAAO;;AAGtC,QAAO;EAAE;EAAO;EAAO;EAAQ;;AAGjC,SAAgB,0BAA0B,QAAwB;CAChE,MAAM,WAAW,2BAA2B,OAAO;CACnD,MAAM,QAAQ,CAAC,kBAAkB,SAAS,MAAM,IAAI;AACpD,MAAK,MAAM,SAAS,SAAS,OAC3B,OAAM,KAAK,WAAW,MAAM,KAAK,GAAG,KAAK,UAAU,MAAM,MAAM,GAAG;AAEpE,OAAM,KAAK,IAAI;AACf,QAAO,GAAG,MAAM,KAAK,KAAK,CAAC;;AAG7B,SAAS,mBAAmB,MAAc,MAAc,QAAwB;CAC9E,MAAM,aAAa,KAAK,QAAQ,OAAO,GAAG,CAAC,QAAQ,OAAO,GAAG;AAC7D,KAAI,CAAC,cAAc,WAAW,SAAS,KAAK,CAC1C,OAAM,IAAI,gCACR,mDACA,MACA,OACD;AAEH,QAAO;;AAGT,SAAS,gBAAgB,OAA2C;CAClE,MAAM,OAAO,MAAM,OAAO;AAC1B,KAAI,MAAM,SAAS,UAAU,MAAM,OAAO,SAAS,EACjD,OAAM,IAAI,gCACR,gCACA,MAAM,KAAK,MACX,MAAM,KAAK,OACZ;AAGH,QAAO;EACL,MAAM,mBAAmB,KAAK,OAAO,KAAK,MAAM,KAAK,OAAO;EAC5D,OAAO,eAAe,cAAc,MAAM,OAAO,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,KAAK,OAAO;EACzF,MAAM,MAAM,KAAK;EACjB,QAAQ,KAAK;EACd;;AAGH,SAAS,cAAc,QAA4B;AACjD,QAAO,OAAO,KAAK,UAAU,MAAM,MAAM,CAAC,KAAK,IAAI;;AAGrD,SAAS,iBAAiB,SAAiB,MAAc,SAAS,GAAU;AAC1E,QAAO,IAAI,gCAAgC,SAAS,MAAM,OAAO;;AAGnE,SAAS,eAAe,QAAgB,MAAc,QAAyB;AAC7E,KAAI;AACF,SAAO,KAAK,MAAM,OAAO;UAClB,OAAO;AACd,QAAM,IAAI,gCACR,uBAAuB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,IAC7E,MACA,OACD"}

package/dist/blocklet/activation.cjs

@@ -0,0 +1,94 @@
+let _aigne_afs = require("@aigne/afs");
+
+//#region src/blocklet/activation.ts
+/**
+* AOS Blocklet activation — creates Runtime AFS and configures mounts + routes.
+*
+* Wraps core createBlockletAFS with AOS-level concerns:
+* - Domain registration via ActivationHooks
+* - Credential injection via ActivationHooks
+* - Route loading from Runtime AFS
+* - Clean deactivation with rollback
+*/
+function collectDomainBindTargets(info) {
+	const targets = [];
+	for (const site of info.manifest.sites ?? []) {
+		if (site.domain) targets.push({
+			kind: "domain",
+			value: site.domain
+		});
+		for (const alias of site.aliases ?? []) targets.push({
+			kind: "alias",
+			value: alias
+		});
+	}
+	return targets;
+}
+/**
+* Activate a blocklet: create Runtime AFS, seed data, register domains.
+*
+* Returns the activated state that can be passed to deactivateBlocklet() later.
+*/
+async function activateBlocklet(options) {
+	const { info, globalAFS, dataPath, hooks, createProvider } = options;
+	const { afs: runtimeAFS, ownedProviders } = await (0, _aigne_afs.createBlockletAFS)(info.mountPath, dataPath, globalAFS, {
+		manifest: info.manifest,
+		createProvider,
+		blockletDiskPath: info.diskPath
+	});
+	await (0, _aigne_afs.seedBlockletData)(runtimeAFS);
+	await (0, _aigne_afs.seedRoutes)(runtimeAFS);
+	await (0, _aigne_afs.seedMountFiles)(runtimeAFS, info.manifest);
+	const registeredDomains = [];
+	if (info.manifest.sites && hooks?.onDomainBind) {
+		const bindTargets = collectDomainBindTargets(info);
+		const bindResults = await Promise.all(bindTargets.map(async (target) => {
+			try {
+				await hooks.onDomainBind(info.id, target.value);
+				return {
+					ok: true,
+					target
+				};
+			} catch {
+				return {
+					ok: false,
+					target
+				};
+			}
+		}));
+		const firstFailure = bindResults.find((result) => !result.ok);
+		if (firstFailure) {
+			for (const result of bindResults) {
+				if (!result.ok) continue;
+				try {
+					await hooks.onDomainUnbind?.(info.id, result.target.value);
+				} catch {}
+			}
+			throw new Error(`Failed to bind ${firstFailure.target.kind} "${firstFailure.target.value}" for blocklet "${info.id}"`);
+		}
+		registeredDomains.push(...bindResults.map((result) => result.target.value));
+	}
+	await globalAFS.mount(runtimeAFS, info.mountPath, { replace: true });
+	return {
+		info,
+		runtimeAFS,
+		ownedProviders,
+		domains: registeredDomains
+	};
+}
+/**
+* Deactivate a blocklet: unregister domains, close owned providers, unmount.
+*/
+async function deactivateBlocklet(activated, globalAFS, hooks) {
+	if (hooks?.onDomainUnbind) for (const domain of activated.domains) try {
+		await hooks.onDomainUnbind(activated.info.id, domain);
+	} catch {}
+	for (const provider of activated.ownedProviders) try {
+		await provider.close?.();
+	} catch {}
+	await globalAFS.unmount(activated.info.mountPath);
+}
+
+//#endregion
+exports.activateBlocklet = activateBlocklet;
+exports.deactivateBlocklet = deactivateBlocklet;

package/dist/blocklet/activation.d.cts

@@ -0,0 +1,30 @@
+import { ActivatedBlocklet, ActivationHooks, BlockletInfo } from "./types.cjs";
+import * as _aigne_afs3 from "@aigne/afs";
+import { AFS, AFSModule } from "@aigne/afs";
+
+//#region src/blocklet/activation.d.ts
+interface ActivateBlockletOptions {
+  /** The blocklet to activate */
+  info: BlockletInfo;
+  /** The global AFS instance */
+  globalAFS: AFS;
+  /** Data directory path for this blocklet (runtime-specific) */
+  dataPath: string;
+  /** Platform-specific hooks */
+  hooks?: ActivationHooks;
+  /** Provider factory for owned mounts */
+  createProvider?: (mount: _aigne_afs3.MountConfig) => Promise<AFSModule>;
+}
+/**
+ * Activate a blocklet: create Runtime AFS, seed data, register domains.
+ *
+ * Returns the activated state that can be passed to deactivateBlocklet() later.
+ */
+declare function activateBlocklet(options: ActivateBlockletOptions): Promise<ActivatedBlocklet>;
+/**
+ * Deactivate a blocklet: unregister domains, close owned providers, unmount.
+ */
+declare function deactivateBlocklet(activated: ActivatedBlocklet, globalAFS: AFS, hooks?: ActivationHooks): Promise<void>;
+//#endregion
+export { ActivateBlockletOptions, activateBlocklet, deactivateBlocklet };
+//# sourceMappingURL=activation.d.cts.map

package/dist/blocklet/activation.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation.d.cts","names":[],"sources":["../../src/blocklet/activation.ts"],"mappings":";;;;;UAwBiB,uBAAA;EAUuD;EARtE,IAAA,EAAM,YAAA;EAQ+D;EANrE,SAAA,EAAW,GAAA;EAFX;EAIA,QAAA;EAFA;EAIA,KAAA,GAAQ,eAAA;EAFR;EAIA,cAAA,IAAkB,KAAA,EAFK,WAAA,CAEuB,WAAA,KAAgB,OAAA,CAAQ,SAAA;AAAA;;;;;;iBAwBlD,gBAAA,CACpB,OAAA,EAAS,uBAAA,GACR,OAAA,CAAQ,iBAAA;;AAFX;;iBAyEsB,kBAAA,CACpB,SAAA,EAAW,iBAAA,EACX,SAAA,EAAW,GAAA,EACX,KAAA,GAAQ,eAAA,GACP,OAAA"}

package/dist/blocklet/activation.d.mts

@@ -0,0 +1,30 @@
+import { ActivatedBlocklet, ActivationHooks, BlockletInfo } from "./types.mjs";
+import * as _aigne_afs3 from "@aigne/afs";
+import { AFS, AFSModule } from "@aigne/afs";
+
+//#region src/blocklet/activation.d.ts
+interface ActivateBlockletOptions {
+  /** The blocklet to activate */
+  info: BlockletInfo;
+  /** The global AFS instance */
+  globalAFS: AFS;
+  /** Data directory path for this blocklet (runtime-specific) */
+  dataPath: string;
+  /** Platform-specific hooks */
+  hooks?: ActivationHooks;
+  /** Provider factory for owned mounts */
+  createProvider?: (mount: _aigne_afs3.MountConfig) => Promise<AFSModule>;
+}
+/**
+ * Activate a blocklet: create Runtime AFS, seed data, register domains.
+ *
+ * Returns the activated state that can be passed to deactivateBlocklet() later.
+ */
+declare function activateBlocklet(options: ActivateBlockletOptions): Promise<ActivatedBlocklet>;
+/**
+ * Deactivate a blocklet: unregister domains, close owned providers, unmount.
+ */
+declare function deactivateBlocklet(activated: ActivatedBlocklet, globalAFS: AFS, hooks?: ActivationHooks): Promise<void>;
+//#endregion
+export { ActivateBlockletOptions, activateBlocklet, deactivateBlocklet };
+//# sourceMappingURL=activation.d.mts.map

package/dist/blocklet/activation.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation.d.mts","names":[],"sources":["../../src/blocklet/activation.ts"],"mappings":";;;;;UAwBiB,uBAAA;EAUuD;EARtE,IAAA,EAAM,YAAA;EAQ+D;EANrE,SAAA,EAAW,GAAA;EAFX;EAIA,QAAA;EAFA;EAIA,KAAA,GAAQ,eAAA;EAFR;EAIA,cAAA,IAAkB,KAAA,EAFK,WAAA,CAEuB,WAAA,KAAgB,OAAA,CAAQ,SAAA;AAAA;;;;;;iBAwBlD,gBAAA,CACpB,OAAA,EAAS,uBAAA,GACR,OAAA,CAAQ,iBAAA;;AAFX;;iBAyEsB,kBAAA,CACpB,SAAA,EAAW,iBAAA,EACX,SAAA,EAAW,GAAA,EACX,KAAA,GAAQ,eAAA,GACP,OAAA"}

package/dist/blocklet/activation.mjs

@@ -0,0 +1,94 @@
+import { createBlockletAFS, seedBlockletData, seedMountFiles, seedRoutes } from "@aigne/afs";
+
+//#region src/blocklet/activation.ts
+/**
+* AOS Blocklet activation — creates Runtime AFS and configures mounts + routes.
+*
+* Wraps core createBlockletAFS with AOS-level concerns:
+* - Domain registration via ActivationHooks
+* - Credential injection via ActivationHooks
+* - Route loading from Runtime AFS
+* - Clean deactivation with rollback
+*/
+function collectDomainBindTargets(info) {
+	const targets = [];
+	for (const site of info.manifest.sites ?? []) {
+		if (site.domain) targets.push({
+			kind: "domain",
+			value: site.domain
+		});
+		for (const alias of site.aliases ?? []) targets.push({
+			kind: "alias",
+			value: alias
+		});
+	}
+	return targets;
+}
+/**
+* Activate a blocklet: create Runtime AFS, seed data, register domains.
+*
+* Returns the activated state that can be passed to deactivateBlocklet() later.
+*/
+async function activateBlocklet(options) {
+	const { info, globalAFS, dataPath, hooks, createProvider } = options;
+	const { afs: runtimeAFS, ownedProviders } = await createBlockletAFS(info.mountPath, dataPath, globalAFS, {
+		manifest: info.manifest,
+		createProvider,
+		blockletDiskPath: info.diskPath
+	});
+	await seedBlockletData(runtimeAFS);
+	await seedRoutes(runtimeAFS);
+	await seedMountFiles(runtimeAFS, info.manifest);
+	const registeredDomains = [];
+	if (info.manifest.sites && hooks?.onDomainBind) {
+		const bindTargets = collectDomainBindTargets(info);
+		const bindResults = await Promise.all(bindTargets.map(async (target) => {
+			try {
+				await hooks.onDomainBind(info.id, target.value);
+				return {
+					ok: true,
+					target
+				};
+			} catch {
+				return {
+					ok: false,
+					target
+				};
+			}
+		}));
+		const firstFailure = bindResults.find((result) => !result.ok);
+		if (firstFailure) {
+			for (const result of bindResults) {
+				if (!result.ok) continue;
+				try {
+					await hooks.onDomainUnbind?.(info.id, result.target.value);
+				} catch {}
+			}
+			throw new Error(`Failed to bind ${firstFailure.target.kind} "${firstFailure.target.value}" for blocklet "${info.id}"`);
+		}
+		registeredDomains.push(...bindResults.map((result) => result.target.value));
+	}
+	await globalAFS.mount(runtimeAFS, info.mountPath, { replace: true });
+	return {
+		info,
+		runtimeAFS,
+		ownedProviders,
+		domains: registeredDomains
+	};
+}
+/**
+* Deactivate a blocklet: unregister domains, close owned providers, unmount.
+*/
+async function deactivateBlocklet(activated, globalAFS, hooks) {
+	if (hooks?.onDomainUnbind) for (const domain of activated.domains) try {
+		await hooks.onDomainUnbind(activated.info.id, domain);
+	} catch {}
+	for (const provider of activated.ownedProviders) try {
+		await provider.close?.();
+	} catch {}
+	await globalAFS.unmount(activated.info.mountPath);
+}
+
+//#endregion
+export { activateBlocklet, deactivateBlocklet };
+//# sourceMappingURL=activation.mjs.map

package/dist/blocklet/activation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation.mjs","names":[],"sources":["../../src/blocklet/activation.ts"],"sourcesContent":["/**\n * AOS Blocklet activation — creates Runtime AFS and configures mounts + routes.\n *\n * Wraps core createBlockletAFS with AOS-level concerns:\n * - Domain registration via ActivationHooks\n * - Credential injection via ActivationHooks\n * - Route loading from Runtime AFS\n * - Clean deactivation with rollback\n */\n\nimport {\n  type AFS,\n  type AFSModule,\n  createBlockletAFS,\n  seedBlockletData,\n  seedMountFiles,\n  seedRoutes,\n} from \"@aigne/afs\";\nimport type { ActivatedBlocklet, ActivationHooks, BlockletInfo } from \"./types.js\";\n\n// ---------------------------------------------------------------------------\n// Activation\n// ---------------------------------------------------------------------------\n\nexport interface ActivateBlockletOptions {\n  /** The blocklet to activate */\n  info: BlockletInfo;\n  /** The global AFS instance */\n  globalAFS: AFS;\n  /** Data directory path for this blocklet (runtime-specific) */\n  dataPath: string;\n  /** Platform-specific hooks */\n  hooks?: ActivationHooks;\n  /** Provider factory for owned mounts */\n  createProvider?: (mount: import(\"@aigne/afs\").MountConfig) => Promise<AFSModule>;\n}\n\ninterface DomainBindTarget {\n  kind: \"domain\" | \"alias\";\n  value: string;\n}\n\nfunction collectDomainBindTargets(info: BlockletInfo): DomainBindTarget[] {\n  const targets: DomainBindTarget[] = [];\n  for (const site of info.manifest.sites ?? []) {\n    if (site.domain) targets.push({ kind: \"domain\", value: site.domain });\n    for (const alias of site.aliases ?? []) {\n      targets.push({ kind: \"alias\", value: alias });\n    }\n  }\n  return targets;\n}\n\n/**\n * Activate a blocklet: create Runtime AFS, seed data, register domains.\n *\n * Returns the activated state that can be passed to deactivateBlocklet() later.\n */\nexport async function activateBlocklet(\n  options: ActivateBlockletOptions,\n): Promise<ActivatedBlocklet> {\n  const { info, globalAFS, dataPath, hooks, createProvider } = options;\n\n  // 1. Create Runtime AFS via core factory\n  const { afs: runtimeAFS, ownedProviders } = await createBlockletAFS(\n    info.mountPath,\n    dataPath,\n    globalAFS,\n    {\n      manifest: info.manifest,\n      createProvider,\n      blockletDiskPath: info.diskPath,\n    },\n  );\n\n  // 2. Seed data + routes + mount files\n  await seedBlockletData(runtimeAFS);\n  await seedRoutes(runtimeAFS);\n  await seedMountFiles(runtimeAFS, info.manifest);\n\n  // 3. Register domains from manifest.sites\n  const registeredDomains: string[] = [];\n  if (info.manifest.sites && hooks?.onDomainBind) {\n    const bindTargets = collectDomainBindTargets(info);\n    const bindResults = await Promise.all(\n      bindTargets.map(async (target) => {\n        try {\n          await hooks.onDomainBind!(info.id, target.value);\n          return { ok: true as const, target };\n        } catch {\n          return { ok: false as const, target };\n        }\n      }),\n    );\n\n    const firstFailure = bindResults.find((result) => !result.ok);\n    if (firstFailure) {\n      for (const result of bindResults) {\n        if (!result.ok) continue;\n        try {\n          await hooks.onDomainUnbind?.(info.id, result.target.value);\n        } catch {\n          /* best effort */\n        }\n      }\n      throw new Error(\n        `Failed to bind ${firstFailure.target.kind} \"${firstFailure.target.value}\" for blocklet \"${info.id}\"`,\n      );\n    }\n\n    registeredDomains.push(...bindResults.map((result) => result.target.value));\n  }\n\n  // 4. Replace mount in global AFS with Runtime AFS\n  await globalAFS.mount(runtimeAFS, info.mountPath, { replace: true });\n\n  return {\n    info,\n    runtimeAFS,\n    ownedProviders,\n    domains: registeredDomains,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Deactivation\n// ---------------------------------------------------------------------------\n\n/**\n * Deactivate a blocklet: unregister domains, close owned providers, unmount.\n */\nexport async function deactivateBlocklet(\n  activated: ActivatedBlocklet,\n  globalAFS: AFS,\n  hooks?: ActivationHooks,\n): Promise<void> {\n  // 1. Unregister domains\n  if (hooks?.onDomainUnbind) {\n    for (const domain of activated.domains) {\n      try {\n        await hooks.onDomainUnbind(activated.info.id, domain);\n      } catch {\n        /* best effort */\n      }\n    }\n  }\n\n  // 2. Close owned providers\n  for (const provider of activated.ownedProviders) {\n    try {\n      await provider.close?.();\n    } catch {\n      /* best effort */\n    }\n  }\n\n  // 3. Unmount from global AFS\n  await globalAFS.unmount(activated.info.mountPath);\n}\n"],"mappings":";;;;;;;;;;;;AA0CA,SAAS,yBAAyB,MAAwC;CACxE,MAAM,UAA8B,EAAE;AACtC,MAAK,MAAM,QAAQ,KAAK,SAAS,SAAS,EAAE,EAAE;AAC5C,MAAI,KAAK,OAAQ,SAAQ,KAAK;GAAE,MAAM;GAAU,OAAO,KAAK;GAAQ,CAAC;AACrE,OAAK,MAAM,SAAS,KAAK,WAAW,EAAE,CACpC,SAAQ,KAAK;GAAE,MAAM;GAAS,OAAO;GAAO,CAAC;;AAGjD,QAAO;;;;;;;AAQT,eAAsB,iBACpB,SAC4B;CAC5B,MAAM,EAAE,MAAM,WAAW,UAAU,OAAO,mBAAmB;CAG7D,MAAM,EAAE,KAAK,YAAY,mBAAmB,MAAM,kBAChD,KAAK,WACL,UACA,WACA;EACE,UAAU,KAAK;EACf;EACA,kBAAkB,KAAK;EACxB,CACF;AAGD,OAAM,iBAAiB,WAAW;AAClC,OAAM,WAAW,WAAW;AAC5B,OAAM,eAAe,YAAY,KAAK,SAAS;CAG/C,MAAM,oBAA8B,EAAE;AACtC,KAAI,KAAK,SAAS,SAAS,OAAO,cAAc;EAC9C,MAAM,cAAc,yBAAyB,KAAK;EAClD,MAAM,cAAc,MAAM,QAAQ,IAChC,YAAY,IAAI,OAAO,WAAW;AAChC,OAAI;AACF,UAAM,MAAM,aAAc,KAAK,IAAI,OAAO,MAAM;AAChD,WAAO;KAAE,IAAI;KAAe;KAAQ;WAC9B;AACN,WAAO;KAAE,IAAI;KAAgB;KAAQ;;IAEvC,CACH;EAED,MAAM,eAAe,YAAY,MAAM,WAAW,CAAC,OAAO,GAAG;AAC7D,MAAI,cAAc;AAChB,QAAK,MAAM,UAAU,aAAa;AAChC,QAAI,CAAC,OAAO,GAAI;AAChB,QAAI;AACF,WAAM,MAAM,iBAAiB,KAAK,IAAI,OAAO,OAAO,MAAM;YACpD;;AAIV,SAAM,IAAI,MACR,kBAAkB,aAAa,OAAO,KAAK,IAAI,aAAa,OAAO,MAAM,kBAAkB,KAAK,GAAG,GACpG;;AAGH,oBAAkB,KAAK,GAAG,YAAY,KAAK,WAAW,OAAO,OAAO,MAAM,CAAC;;AAI7E,OAAM,UAAU,MAAM,YAAY,KAAK,WAAW,EAAE,SAAS,MAAM,CAAC;AAEpE,QAAO;EACL;EACA;EACA;EACA,SAAS;EACV;;;;;AAUH,eAAsB,mBACpB,WACA,WACA,OACe;AAEf,KAAI,OAAO,eACT,MAAK,MAAM,UAAU,UAAU,QAC7B,KAAI;AACF,QAAM,MAAM,eAAe,UAAU,KAAK,IAAI,OAAO;SAC/C;AAOZ,MAAK,MAAM,YAAY,UAAU,eAC/B,KAAI;AACF,QAAM,SAAS,SAAS;SAClB;AAMV,OAAM,UAAU,QAAQ,UAAU,KAAK,UAAU"}