@agimon-ai/doompi-core 0.0.1-alpha.70

package/dist/server/serverFacetLoader.cjs

@@ -0,0 +1,220 @@
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+const require_headless = require("../schemas/headless.cjs");
+const require_serverFacet = require("../schemas/serverFacet.cjs");
+const require_serverBundle = require("../schemas/serverBundle.cjs");
+let _deepseek_ai_cordis = require("@deepseek-ai/cordis");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let node_url = require("node:url");
+//#region src/server/serverFacetLoader.ts
+/** Normalize operator-selected directories without falling back after descriptor errors. */
+function resolveServerBundleSource(options) {
+	const registration = options.registration;
+	const selected = (options.directoryOverride || void 0) ?? registration?.apiDirectory;
+	if (selected === void 0) return { kind: "empty" };
+	const directory = node_fs.default.realpathSync(selected);
+	if (registration !== void 0 && directory === node_fs.default.realpathSync(registration.apiDirectory) && registration.serverBundle !== void 0) return {
+		kind: "descriptor",
+		directory,
+		generation: registration.generation,
+		fingerprint: registration.serverBundle.fingerprint
+	};
+	const descriptorPath = node_path.default.join(directory, require_serverBundle.DOOM_SERVER_BUNDLE_FILE);
+	if (node_fs.default.existsSync(descriptorPath)) {
+		const descriptor = require_serverBundle.parseDoomServerBundle(JSON.parse(node_fs.default.readFileSync(containedFile(directory, require_serverBundle.DOOM_SERVER_BUNDLE_FILE), "utf8")));
+		return {
+			kind: "descriptor",
+			directory,
+			generation: descriptor.generation,
+			fingerprint: descriptor.fingerprint
+		};
+	}
+	throw new Error(`Server bundle descriptor is missing: ${descriptorPath}`);
+}
+function containedFile(directory, relativeFile) {
+	const resolved = node_fs.default.realpathSync(node_path.default.resolve(directory, relativeFile));
+	const relative = node_path.default.relative(directory, resolved);
+	if (relative === ".." || relative.startsWith(`..${node_path.default.sep}`) || node_path.default.isAbsolute(relative)) throw new Error(`Server bundle file escapes its generation: ${relativeFile}`);
+	return resolved;
+}
+/** Explicit new-generation reader. Missing or corrupt descriptors never select legacy modules. */
+async function loadServerBundle(scope, options) {
+	const directory = node_fs.default.realpathSync(options.directory);
+	const descriptor = require_serverBundle.parseDoomServerBundle(JSON.parse(node_fs.default.readFileSync(containedFile(directory, require_serverBundle.DOOM_SERVER_BUNDLE_FILE), "utf8")));
+	if (descriptor.generation !== options.generation || descriptor.fingerprint !== options.fingerprint) throw new Error("Server bundle does not match the admitted generation");
+	const facets = [];
+	for (const declaration of descriptor.entries) {
+		if (!declaration.scopes.includes(scope)) continue;
+		const eligible = declaration.owners.some((owner) => owner.majorMode === options.majorMode && (owner.layer === "default" || options.activeLayers.includes(owner.layer)));
+		if (!(scope === "session" && options.retainCandidates === true) && !eligible) continue;
+		try {
+			const file = containedFile(directory, declaration.module);
+			const imported = await import((0, node_url.pathToFileURL)(file).href);
+			if (!require_serverFacet.isDoomServerFacet(imported.default)) throw new Error("default export is not a server object facet");
+			facets.push({
+				declaration,
+				facet: imported.default,
+				...scope === "session" && options.retainCandidates ? {
+					retained: true,
+					initiallyEligible: eligible
+				} : {}
+			});
+		} catch (error) {
+			const message = `Server facet '${declaration.packageName}' could not load (${error instanceof Error ? error.message : String(error)})`;
+			if (declaration.required && eligible) throw new Error(message, { cause: error });
+			options.onNotice?.(message);
+		}
+	}
+	return {
+		descriptor,
+		facets
+	};
+}
+/**
+* Binds registrations to the Cordis fiber that calls the host service.
+*
+* The host itself is shared, but Cordis traceable services rebind `ctx` to the
+* caller. That lets a facet's registration unwind even when `apply` throws
+* before it can return its disposer.
+*/
+var ScopedDoomServerHost = class extends _deepseek_ai_cordis.Service {
+	host;
+	scope;
+	context;
+	constructor(ctx, host) {
+		super(ctx, require_serverFacet.DOOM_SERVER_HOST_SERVICE);
+		this.host = host;
+		this.scope = host.scope;
+		this.context = host.context;
+	}
+	registerApi(api) {
+		const headless = this.scope === "session" ? require_headless.readDoomHeadlessHost(this.ctx) : void 0;
+		if (headless) {
+			const activity = headless.registerActivity({
+				name: `api:${api.basePath}`,
+				start: () => {
+					const registration = this.host.registerApi(api);
+					if (registration.mounted !== true) {
+						registration.dispose();
+						throw new Error(`package API '${api.basePath}' did not mount.`);
+					}
+					return () => {
+						registration.dispose();
+					};
+				}
+			});
+			return {
+				mounted: true,
+				dispose: () => activity.dispose()
+			};
+		}
+		const registration = this.host.registerApi(api);
+		if (registration.mounted !== true) {
+			registration.dispose();
+			throw new Error(`package API '${api.basePath}' did not mount.`);
+		}
+		this.ctx.effect(() => () => registration.dispose(), "server facet API registration");
+		return registration;
+	}
+	registerChannel(channel) {
+		const registration = this.host.registerChannel(channel);
+		if (registration.mounted !== true) {
+			registration.dispose();
+			throw new Error(`hub channel '${channel.frameType}' did not mount.`);
+		}
+		this.ctx.effect(() => () => registration.dispose(), "server facet channel registration");
+		return registration;
+	}
+	registerMethod = (definition, handler) => {
+		const registration = this.host.registerMethod(definition, handler);
+		if (registration.mounted !== true) {
+			registration.dispose();
+			throw new Error(`plugin method '${definition.service}.${definition.method}' did not mount.`);
+		}
+		this.ctx.effect(() => () => registration.dispose(), "server facet method registration");
+		return registration;
+	};
+	mounted() {
+		return this.host.mounted();
+	}
+	mountedChannels() {
+		return this.host.mountedChannels();
+	}
+};
+/** Publishes the host service from inside a mounted plugin, so it unwinds with the root. */
+function serverHostProvider(context, host) {
+	new ScopedDoomServerHost(context, host);
+}
+/**
+* Installs server facets into a cordis root that provides the server host.
+*
+* A cordis root rather than plain calls, because a facet is a Doom
+* contribution like any other: it may inject services a host provides later,
+* and it unwinds through the same fiber disposal the Pi facet uses. One root
+* per host process, created here, so no host has to know cordis to run one.
+*
+* Facets are awaited one at a time and each is a single fiber, because a
+* facet declares its `inject` on itself. `fiber.await()` therefore settles
+* once `apply` has run, and the caller can read a complete mount table before
+* deciding whether to open a listener.
+*/
+async function installServerFacets(options) {
+	const notice = options.onNotice ?? (() => {});
+	const root = new _deepseek_ai_cordis.Context();
+	await root.plugin(serverHostProvider, options.host).await();
+	try {
+		await options.prepare?.(root);
+	} catch (error) {
+		await root.fiber.dispose();
+		throw error;
+	}
+	if (options.facets.some((candidate) => "retained" in candidate && candidate.retained === true) && !require_headless.readDoomHeadlessHost(root)) {
+		await root.fiber.dispose();
+		throw new Error("Retained server candidates require a gated headless host");
+	}
+	const installed = [];
+	const installedPackages = [];
+	const disposeInstalled = async () => {
+		for (const fiber of [...installed].reverse()) await fiber.dispose();
+	};
+	for (const candidate of options.facets) {
+		const facet = "declaration" in candidate ? candidate.facet : candidate;
+		const declaration = "declaration" in candidate ? candidate.declaration : void 0;
+		let fiber;
+		try {
+			fiber = (declaration ? root.extend({ [require_headless.DOOM_HEADLESS_OWNER]: declaration }) : root).plugin(facet);
+			await fiber.await();
+			installed.push(fiber);
+			if (declaration) installedPackages.push(declaration.packageName);
+		} catch (error) {
+			await fiber?.dispose();
+			const message = `${declaration === void 0 ? "a server facet" : `server facet '${declaration.packageName}'`} did not install (${error instanceof Error ? error.message : String(error)})`;
+			if (declaration?.required === true && !("initiallyEligible" in candidate && candidate.initiallyEligible === false)) {
+				await disposeInstalled();
+				await root.fiber.dispose();
+				throw new Error(message, { cause: error });
+			}
+			notice(message);
+		}
+	}
+	let disposePromise;
+	return {
+		root,
+		installedPackages,
+		dispose: () => {
+			disposePromise ??= (async () => {
+				await disposeInstalled();
+				await root.fiber.dispose();
+			})();
+			return disposePromise;
+		}
+	};
+}
+//#endregion
+exports.installServerFacets = installServerFacets;
+exports.loadServerBundle = loadServerBundle;
+exports.resolveServerBundleSource = resolveServerBundleSource;
+
+//# sourceMappingURL=serverFacetLoader.cjs.map

package/dist/server/serverFacetLoader.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverFacetLoader.cjs","names":["fs","path","DOOM_SERVER_BUNDLE_FILE","parseDoomServerBundle","pathToFileURL","isDoomServerFacet","Service","DOOM_SERVER_HOST_SERVICE","readDoomHeadlessHost","Context","DOOM_HEADLESS_OWNER"],"sources":["../../src/server/serverFacetLoader.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport { Context, Service, type Fiber } from '@deepseek-ai/cordis';\n\nimport { DOOM_HEADLESS_OWNER, readDoomHeadlessHost } from '../schemas/headless';\nimport type { DoomApiScope } from '../schemas/packageApi';\nimport {\n  DOOM_SERVER_BUNDLE_FILE,\n  type DoomServerBundle,\n  type DoomServerBundleEntry,\n  parseDoomServerBundle,\n} from '../schemas/serverBundle';\nimport {\n  DOOM_SERVER_HOST_SERVICE,\n  type DoomServerFacet,\n  type DoomServerHostService,\n  isDoomServerFacet,\n} from '../schemas/serverFacet';\n\nexport type ServerBundleSource =\n  | {\n      readonly kind: 'descriptor';\n      readonly directory: string;\n      readonly generation: string;\n      readonly fingerprint: string;\n    }\n  | { readonly kind: 'empty' };\n\n/** Normalize operator-selected directories without falling back after descriptor errors. */\nexport function resolveServerBundleSource(options: {\n  registration?: {\n    readonly apiDirectory: string;\n    readonly generation: string;\n    readonly serverBundle?: { readonly path: string; readonly fingerprint: string };\n  };\n  directoryOverride?: string;\n}): ServerBundleSource {\n  const registration = options.registration;\n  const override = options.directoryOverride || undefined;\n  const selected = override ?? registration?.apiDirectory;\n  if (selected === undefined) return { kind: 'empty' };\n  const directory = fs.realpathSync(selected);\n  const isRegisteredDirectory = registration !== undefined && directory === fs.realpathSync(registration.apiDirectory);\n  if (isRegisteredDirectory && registration.serverBundle !== undefined) {\n    // The registration already declares this as new format, even when the file\n    // was removed after admission. loadServerBundle must reject, never downgrade.\n    return {\n      kind: 'descriptor',\n      directory,\n      generation: registration.generation,\n      fingerprint: registration.serverBundle.fingerprint,\n    };\n  }\n  const descriptorPath = path.join(directory, DOOM_SERVER_BUNDLE_FILE);\n  if (fs.existsSync(descriptorPath)) {\n    const descriptor = parseDoomServerBundle(\n      JSON.parse(fs.readFileSync(containedFile(directory, DOOM_SERVER_BUNDLE_FILE), 'utf8')),\n    );\n    return { kind: 'descriptor', directory, generation: descriptor.generation, fingerprint: descriptor.fingerprint };\n  }\n  throw new Error(`Server bundle descriptor is missing: ${descriptorPath}`);\n}\n\nexport interface LoadServerBundleOptions {\n  /** Already admitted generation directory, not a repository selected by a request. */\n  readonly directory: string;\n  readonly generation: string;\n  readonly fingerprint: string;\n  readonly majorMode: string;\n  readonly activeLayers: readonly string[];\n  readonly onNotice?: (message: string) => void;\n  /** Only a session host with declarative contribution gating may retain all candidates. */\n  readonly retainCandidates?: boolean;\n}\n\nexport interface LoadedServerFacet {\n  readonly declaration: DoomServerBundleEntry;\n  readonly facet: DoomServerFacet;\n  readonly retained?: true;\n  readonly initiallyEligible?: boolean;\n}\n\nexport interface LoadedServerBundle {\n  readonly descriptor: DoomServerBundle;\n  readonly facets: readonly LoadedServerFacet[];\n}\n\nfunction containedFile(directory: string, relativeFile: string): string {\n  const resolved = fs.realpathSync(path.resolve(directory, relativeFile));\n  const relative = path.relative(directory, resolved);\n  if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {\n    throw new Error(`Server bundle file escapes its generation: ${relativeFile}`);\n  }\n  return resolved;\n}\n\n/** Explicit new-generation reader. Missing or corrupt descriptors never select legacy modules. */\nexport async function loadServerBundle(\n  scope: DoomApiScope,\n  options: LoadServerBundleOptions,\n): Promise<LoadedServerBundle> {\n  const directory = fs.realpathSync(options.directory);\n  const descriptor = parseDoomServerBundle(\n    JSON.parse(fs.readFileSync(containedFile(directory, DOOM_SERVER_BUNDLE_FILE), 'utf8')),\n  );\n  if (descriptor.generation !== options.generation || descriptor.fingerprint !== options.fingerprint) {\n    throw new Error('Server bundle does not match the admitted generation');\n  }\n  const facets: LoadedServerFacet[] = [];\n  for (const declaration of descriptor.entries) {\n    if (!declaration.scopes.includes(scope)) continue;\n    const eligible = declaration.owners.some(\n      (owner) =>\n        owner.majorMode === options.majorMode &&\n        (owner.layer === 'default' || options.activeLayers.includes(owner.layer)),\n    );\n    if (!(scope === 'session' && options.retainCandidates === true) && !eligible) continue;\n    try {\n      const file = containedFile(directory, declaration.module);\n      const imported = (await import(pathToFileURL(file).href)) as { default?: unknown };\n      if (!isDoomServerFacet(imported.default)) throw new Error('default export is not a server object facet');\n      facets.push({\n        declaration,\n        facet: imported.default,\n        ...(scope === 'session' && options.retainCandidates\n          ? { retained: true as const, initiallyEligible: eligible }\n          : {}),\n      });\n    } catch (error) {\n      const message = `Server facet '${declaration.packageName}' could not load (${error instanceof Error ? error.message : String(error)})`;\n      if (declaration.required && eligible) throw new Error(message, { cause: error });\n      options.onNotice?.(message);\n    }\n  }\n  return { descriptor, facets };\n}\nexport interface InstallServerFacetsOptions {\n  host: DoomServerHostService;\n  facets: readonly (DoomServerFacet | LoadedServerFacet)[];\n  onNotice?: (message: string) => void;\n  /** Install additional typed services before any package facet is applied. */\n  prepare?: (root: Context) => void | Promise<void>;\n}\n\nexport interface InstalledServerFacets {\n  /** The cordis root the facets were installed into, for a host that provides more services. */\n  readonly root: Context;\n  readonly installedPackages: readonly string[];\n  dispose(): Promise<void>;\n}\n\n/**\n * Binds registrations to the Cordis fiber that calls the host service.\n *\n * The host itself is shared, but Cordis traceable services rebind `ctx` to the\n * caller. That lets a facet's registration unwind even when `apply` throws\n * before it can return its disposer.\n */\nclass ScopedDoomServerHost extends Service<DoomServerHostService> implements DoomServerHostService {\n  readonly scope: DoomServerHostService['scope'];\n  readonly context: DoomServerHostService['context'];\n\n  constructor(\n    ctx: Context,\n    private readonly host: DoomServerHostService,\n  ) {\n    super(ctx, DOOM_SERVER_HOST_SERVICE);\n    this.scope = host.scope;\n    this.context = host.context;\n  }\n\n  registerApi(api: Parameters<DoomServerHostService['registerApi']>[0]) {\n    const headless = this.scope === 'session' ? readDoomHeadlessHost(this.ctx) : undefined;\n    if (headless) {\n      const activity = headless.registerActivity({\n        name: `api:${api.basePath}`,\n        start: () => {\n          const registration = this.host.registerApi(api);\n          if (registration.mounted !== true) {\n            registration.dispose();\n            throw new Error(`package API '${api.basePath}' did not mount.`);\n          }\n          return () => {\n            registration.dispose();\n          };\n        },\n      });\n      return {\n        mounted: true,\n        dispose: () => activity.dispose(),\n      };\n    }\n    const registration = this.host.registerApi(api);\n    if (registration.mounted !== true) {\n      registration.dispose();\n      throw new Error(`package API '${api.basePath}' did not mount.`);\n    }\n    this.ctx.effect(() => () => registration.dispose(), 'server facet API registration');\n    return registration;\n  }\n\n  registerChannel(channel: Parameters<DoomServerHostService['registerChannel']>[0]) {\n    const registration = this.host.registerChannel(channel);\n    if (registration.mounted !== true) {\n      registration.dispose();\n      throw new Error(`hub channel '${channel.frameType}' did not mount.`);\n    }\n    this.ctx.effect(() => () => registration.dispose(), 'server facet channel registration');\n    return registration;\n  }\n\n  registerMethod: DoomServerHostService['registerMethod'] = (definition, handler) => {\n    const registration = this.host.registerMethod(definition, handler);\n    if (registration.mounted !== true) {\n      registration.dispose();\n      throw new Error(`plugin method '${definition.service}.${definition.method}' did not mount.`);\n    }\n    this.ctx.effect(() => () => registration.dispose(), 'server facet method registration');\n    return registration;\n  };\n\n  mounted(): readonly string[] {\n    return this.host.mounted();\n  }\n\n  mountedChannels(): readonly string[] {\n    return this.host.mountedChannels();\n  }\n}\n\n/** Publishes the host service from inside a mounted plugin, so it unwinds with the root. */\nfunction serverHostProvider(context: Context, host: DoomServerHostService): void {\n  new ScopedDoomServerHost(context, host);\n}\n\n/**\n * Installs server facets into a cordis root that provides the server host.\n *\n * A cordis root rather than plain calls, because a facet is a Doom\n * contribution like any other: it may inject services a host provides later,\n * and it unwinds through the same fiber disposal the Pi facet uses. One root\n * per host process, created here, so no host has to know cordis to run one.\n *\n * Facets are awaited one at a time and each is a single fiber, because a\n * facet declares its `inject` on itself. `fiber.await()` therefore settles\n * once `apply` has run, and the caller can read a complete mount table before\n * deciding whether to open a listener.\n */\nexport async function installServerFacets(options: InstallServerFacetsOptions): Promise<InstalledServerFacets> {\n  const notice = options.onNotice ?? ((): void => {});\n  const root = new Context();\n  await root.plugin(serverHostProvider, options.host).await();\n  try {\n    await options.prepare?.(root);\n  } catch (error) {\n    await root.fiber.dispose();\n    throw error;\n  }\n  if (\n    options.facets.some((candidate) => 'retained' in candidate && candidate.retained === true) &&\n    !readDoomHeadlessHost(root)\n  ) {\n    await root.fiber.dispose();\n    throw new Error('Retained server candidates require a gated headless host');\n  }\n  const installed: Fiber[] = [];\n  const installedPackages: string[] = [];\n\n  const disposeInstalled = async (): Promise<void> => {\n    for (const fiber of [...installed].reverse()) await fiber.dispose();\n  };\n\n  for (const candidate of options.facets) {\n    const facet = 'declaration' in candidate ? candidate.facet : candidate;\n    const declaration = 'declaration' in candidate ? candidate.declaration : undefined;\n    let fiber: Fiber | undefined;\n    try {\n      const scope = declaration ? root.extend({ [DOOM_HEADLESS_OWNER]: declaration }) : root;\n      fiber = scope.plugin(facet);\n      await fiber.await();\n      installed.push(fiber);\n      if (declaration) installedPackages.push(declaration.packageName);\n    } catch (error) {\n      await fiber?.dispose();\n      const message = `${declaration === undefined ? 'a server facet' : `server facet '${declaration.packageName}'`} did not install (${error instanceof Error ? error.message : String(error)})`;\n      if (\n        declaration?.required === true &&\n        !('initiallyEligible' in candidate && candidate.initiallyEligible === false)\n      ) {\n        await disposeInstalled();\n        await root.fiber.dispose();\n        throw new Error(message, { cause: error });\n      }\n      notice(message);\n    }\n  }\n\n  let disposePromise: Promise<void> | undefined;\n  return {\n    root,\n    installedPackages,\n    dispose: () => {\n      disposePromise ??= (async () => {\n        await disposeInstalled();\n        await root.fiber.dispose();\n      })();\n      return disposePromise;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/server/serverFacetLoader.d.cts

@@ -0,0 +1,77 @@
+import { DoomApiScope } from "../schemas/packageApi.cjs";
+import { DoomServerBundle, DoomServerBundleEntry } from "../schemas/serverBundle.cjs";
+import { DoomServerFacet, DoomServerHostService } from "../schemas/serverFacet.cjs";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/server/serverFacetLoader.d.ts
+export type ServerBundleSource = {
+  readonly kind: 'descriptor';
+  readonly directory: string;
+  readonly generation: string;
+  readonly fingerprint: string;
+} | {
+  readonly kind: 'empty';
+};
+/** Normalize operator-selected directories without falling back after descriptor errors. */
+export declare function resolveServerBundleSource(options: {
+  registration?: {
+    readonly apiDirectory: string;
+    readonly generation: string;
+    readonly serverBundle?: {
+      readonly path: string;
+      readonly fingerprint: string;
+    };
+  };
+  directoryOverride?: string;
+}): ServerBundleSource;
+export interface LoadServerBundleOptions {
+  /** Already admitted generation directory, not a repository selected by a request. */
+  readonly directory: string;
+  readonly generation: string;
+  readonly fingerprint: string;
+  readonly majorMode: string;
+  readonly activeLayers: readonly string[];
+  readonly onNotice?: (message: string) => void;
+  /** Only a session host with declarative contribution gating may retain all candidates. */
+  readonly retainCandidates?: boolean;
+}
+export interface LoadedServerFacet {
+  readonly declaration: DoomServerBundleEntry;
+  readonly facet: DoomServerFacet;
+  readonly retained?: true;
+  readonly initiallyEligible?: boolean;
+}
+export interface LoadedServerBundle {
+  readonly descriptor: DoomServerBundle;
+  readonly facets: readonly LoadedServerFacet[];
+}
+/** Explicit new-generation reader. Missing or corrupt descriptors never select legacy modules. */
+export declare function loadServerBundle(scope: DoomApiScope, options: LoadServerBundleOptions): Promise<LoadedServerBundle>;
+export interface InstallServerFacetsOptions {
+  host: DoomServerHostService;
+  facets: readonly (DoomServerFacet | LoadedServerFacet)[];
+  onNotice?: (message: string) => void;
+  /** Install additional typed services before any package facet is applied. */
+  prepare?: (root: Context) => void | Promise<void>;
+}
+export interface InstalledServerFacets {
+  /** The cordis root the facets were installed into, for a host that provides more services. */
+  readonly root: Context;
+  readonly installedPackages: readonly string[];
+  dispose(): Promise<void>;
+}
+/**
+ * Installs server facets into a cordis root that provides the server host.
+ *
+ * A cordis root rather than plain calls, because a facet is a Doom
+ * contribution like any other: it may inject services a host provides later,
+ * and it unwinds through the same fiber disposal the Pi facet uses. One root
+ * per host process, created here, so no host has to know cordis to run one.
+ *
+ * Facets are awaited one at a time and each is a single fiber, because a
+ * facet declares its `inject` on itself. `fiber.await()` therefore settles
+ * once `apply` has run, and the caller can read a complete mount table before
+ * deciding whether to open a listener.
+ */
+export declare function installServerFacets(options: InstallServerFacetsOptions): Promise<InstalledServerFacets>;
+//#endregion
+//# sourceMappingURL=serverFacetLoader.d.cts.map

package/dist/server/serverFacetLoader.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverFacetLoader.d.cts","names":[],"sources":["../../src/server/serverFacetLoader.ts"],"mappings":";;;;;YAqBY;WAEG;WACA;WACA;WACA;;WAEA;;;wBAGC,0BAA0B;EACxC;aACW;aACA;aACA;eAA0B;eAAuB;;;EAE5D;IACE;iBA2Ba;;WAEN;WACA;WACA;WACA;WACA;WACA,YAAY;;WAEZ;;iBAGM;WACN,aAAa;WACb,OAAO;WACP;WACA;;iBAGM;WACN,YAAY;WACZ,iBAAiB;;;wBAaN,iBACpB,OAAO,cACP,SAAS,0BACR,QAAQ;iBAoCM;EACf,MAAM;EACN,kBAAkB,kBAAkB;EACpC,YAAY;;EAEZ,WAAW,MAAM,mBAAmB;;iBAGrB;;WAEN,MAAM;WACN;EACT,WAAW;;;;;;;;;;;;;;;wBAoGS,oBAAoB,SAAS,6BAA6B,QAAQ"}

package/dist/server/serverFacetLoader.d.mts

@@ -0,0 +1,77 @@
+import { DoomApiScope } from "../schemas/packageApi.mjs";
+import { DoomServerBundle, DoomServerBundleEntry } from "../schemas/serverBundle.mjs";
+import { DoomServerFacet, DoomServerHostService } from "../schemas/serverFacet.mjs";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/server/serverFacetLoader.d.ts
+export type ServerBundleSource = {
+  readonly kind: 'descriptor';
+  readonly directory: string;
+  readonly generation: string;
+  readonly fingerprint: string;
+} | {
+  readonly kind: 'empty';
+};
+/** Normalize operator-selected directories without falling back after descriptor errors. */
+export declare function resolveServerBundleSource(options: {
+  registration?: {
+    readonly apiDirectory: string;
+    readonly generation: string;
+    readonly serverBundle?: {
+      readonly path: string;
+      readonly fingerprint: string;
+    };
+  };
+  directoryOverride?: string;
+}): ServerBundleSource;
+export interface LoadServerBundleOptions {
+  /** Already admitted generation directory, not a repository selected by a request. */
+  readonly directory: string;
+  readonly generation: string;
+  readonly fingerprint: string;
+  readonly majorMode: string;
+  readonly activeLayers: readonly string[];
+  readonly onNotice?: (message: string) => void;
+  /** Only a session host with declarative contribution gating may retain all candidates. */
+  readonly retainCandidates?: boolean;
+}
+export interface LoadedServerFacet {
+  readonly declaration: DoomServerBundleEntry;
+  readonly facet: DoomServerFacet;
+  readonly retained?: true;
+  readonly initiallyEligible?: boolean;
+}
+export interface LoadedServerBundle {
+  readonly descriptor: DoomServerBundle;
+  readonly facets: readonly LoadedServerFacet[];
+}
+/** Explicit new-generation reader. Missing or corrupt descriptors never select legacy modules. */
+export declare function loadServerBundle(scope: DoomApiScope, options: LoadServerBundleOptions): Promise<LoadedServerBundle>;
+export interface InstallServerFacetsOptions {
+  host: DoomServerHostService;
+  facets: readonly (DoomServerFacet | LoadedServerFacet)[];
+  onNotice?: (message: string) => void;
+  /** Install additional typed services before any package facet is applied. */
+  prepare?: (root: Context) => void | Promise<void>;
+}
+export interface InstalledServerFacets {
+  /** The cordis root the facets were installed into, for a host that provides more services. */
+  readonly root: Context;
+  readonly installedPackages: readonly string[];
+  dispose(): Promise<void>;
+}
+/**
+ * Installs server facets into a cordis root that provides the server host.
+ *
+ * A cordis root rather than plain calls, because a facet is a Doom
+ * contribution like any other: it may inject services a host provides later,
+ * and it unwinds through the same fiber disposal the Pi facet uses. One root
+ * per host process, created here, so no host has to know cordis to run one.
+ *
+ * Facets are awaited one at a time and each is a single fiber, because a
+ * facet declares its `inject` on itself. `fiber.await()` therefore settles
+ * once `apply` has run, and the caller can read a complete mount table before
+ * deciding whether to open a listener.
+ */
+export declare function installServerFacets(options: InstallServerFacetsOptions): Promise<InstalledServerFacets>;
+//#endregion
+//# sourceMappingURL=serverFacetLoader.d.mts.map

package/dist/server/serverFacetLoader.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverFacetLoader.d.mts","names":[],"sources":["../../src/server/serverFacetLoader.ts"],"mappings":";;;;;YAqBY;WAEG;WACA;WACA;WACA;;WAEA;;;wBAGC,0BAA0B;EACxC;aACW;aACA;aACA;eAA0B;eAAuB;;;EAE5D;IACE;iBA2Ba;;WAEN;WACA;WACA;WACA;WACA;WACA,YAAY;;WAEZ;;iBAGM;WACN,aAAa;WACb,OAAO;WACP;WACA;;iBAGM;WACN,YAAY;WACZ,iBAAiB;;;wBAaN,iBACpB,OAAO,cACP,SAAS,0BACR,QAAQ;iBAoCM;EACf,MAAM;EACN,kBAAkB,kBAAkB;EACpC,YAAY;;EAEZ,WAAW,MAAM,mBAAmB;;iBAGrB;;WAEN,MAAM;WACN;EACT,WAAW;;;;;;;;;;;;;;;wBAoGS,oBAAoB,SAAS,6BAA6B,QAAQ"}

package/dist/server/serverFacetLoader.mjs

@@ -0,0 +1,215 @@
+import { DOOM_HEADLESS_OWNER, readDoomHeadlessHost } from "../schemas/headless.mjs";
+import { DOOM_SERVER_HOST_SERVICE, isDoomServerFacet } from "../schemas/serverFacet.mjs";
+import { DOOM_SERVER_BUNDLE_FILE, parseDoomServerBundle } from "../schemas/serverBundle.mjs";
+import { Context, Service } from "@deepseek-ai/cordis";
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+//#region src/server/serverFacetLoader.ts
+/** Normalize operator-selected directories without falling back after descriptor errors. */
+function resolveServerBundleSource(options) {
+	const registration = options.registration;
+	const selected = (options.directoryOverride || void 0) ?? registration?.apiDirectory;
+	if (selected === void 0) return { kind: "empty" };
+	const directory = fs.realpathSync(selected);
+	if (registration !== void 0 && directory === fs.realpathSync(registration.apiDirectory) && registration.serverBundle !== void 0) return {
+		kind: "descriptor",
+		directory,
+		generation: registration.generation,
+		fingerprint: registration.serverBundle.fingerprint
+	};
+	const descriptorPath = path.join(directory, DOOM_SERVER_BUNDLE_FILE);
+	if (fs.existsSync(descriptorPath)) {
+		const descriptor = parseDoomServerBundle(JSON.parse(fs.readFileSync(containedFile(directory, DOOM_SERVER_BUNDLE_FILE), "utf8")));
+		return {
+			kind: "descriptor",
+			directory,
+			generation: descriptor.generation,
+			fingerprint: descriptor.fingerprint
+		};
+	}
+	throw new Error(`Server bundle descriptor is missing: ${descriptorPath}`);
+}
+function containedFile(directory, relativeFile) {
+	const resolved = fs.realpathSync(path.resolve(directory, relativeFile));
+	const relative = path.relative(directory, resolved);
+	if (relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) throw new Error(`Server bundle file escapes its generation: ${relativeFile}`);
+	return resolved;
+}
+/** Explicit new-generation reader. Missing or corrupt descriptors never select legacy modules. */
+async function loadServerBundle(scope, options) {
+	const directory = fs.realpathSync(options.directory);
+	const descriptor = parseDoomServerBundle(JSON.parse(fs.readFileSync(containedFile(directory, DOOM_SERVER_BUNDLE_FILE), "utf8")));
+	if (descriptor.generation !== options.generation || descriptor.fingerprint !== options.fingerprint) throw new Error("Server bundle does not match the admitted generation");
+	const facets = [];
+	for (const declaration of descriptor.entries) {
+		if (!declaration.scopes.includes(scope)) continue;
+		const eligible = declaration.owners.some((owner) => owner.majorMode === options.majorMode && (owner.layer === "default" || options.activeLayers.includes(owner.layer)));
+		if (!(scope === "session" && options.retainCandidates === true) && !eligible) continue;
+		try {
+			const file = containedFile(directory, declaration.module);
+			const imported = await import(pathToFileURL(file).href);
+			if (!isDoomServerFacet(imported.default)) throw new Error("default export is not a server object facet");
+			facets.push({
+				declaration,
+				facet: imported.default,
+				...scope === "session" && options.retainCandidates ? {
+					retained: true,
+					initiallyEligible: eligible
+				} : {}
+			});
+		} catch (error) {
+			const message = `Server facet '${declaration.packageName}' could not load (${error instanceof Error ? error.message : String(error)})`;
+			if (declaration.required && eligible) throw new Error(message, { cause: error });
+			options.onNotice?.(message);
+		}
+	}
+	return {
+		descriptor,
+		facets
+	};
+}
+/**
+* Binds registrations to the Cordis fiber that calls the host service.
+*
+* The host itself is shared, but Cordis traceable services rebind `ctx` to the
+* caller. That lets a facet's registration unwind even when `apply` throws
+* before it can return its disposer.
+*/
+var ScopedDoomServerHost = class extends Service {
+	host;
+	scope;
+	context;
+	constructor(ctx, host) {
+		super(ctx, DOOM_SERVER_HOST_SERVICE);
+		this.host = host;
+		this.scope = host.scope;
+		this.context = host.context;
+	}
+	registerApi(api) {
+		const headless = this.scope === "session" ? readDoomHeadlessHost(this.ctx) : void 0;
+		if (headless) {
+			const activity = headless.registerActivity({
+				name: `api:${api.basePath}`,
+				start: () => {
+					const registration = this.host.registerApi(api);
+					if (registration.mounted !== true) {
+						registration.dispose();
+						throw new Error(`package API '${api.basePath}' did not mount.`);
+					}
+					return () => {
+						registration.dispose();
+					};
+				}
+			});
+			return {
+				mounted: true,
+				dispose: () => activity.dispose()
+			};
+		}
+		const registration = this.host.registerApi(api);
+		if (registration.mounted !== true) {
+			registration.dispose();
+			throw new Error(`package API '${api.basePath}' did not mount.`);
+		}
+		this.ctx.effect(() => () => registration.dispose(), "server facet API registration");
+		return registration;
+	}
+	registerChannel(channel) {
+		const registration = this.host.registerChannel(channel);
+		if (registration.mounted !== true) {
+			registration.dispose();
+			throw new Error(`hub channel '${channel.frameType}' did not mount.`);
+		}
+		this.ctx.effect(() => () => registration.dispose(), "server facet channel registration");
+		return registration;
+	}
+	registerMethod = (definition, handler) => {
+		const registration = this.host.registerMethod(definition, handler);
+		if (registration.mounted !== true) {
+			registration.dispose();
+			throw new Error(`plugin method '${definition.service}.${definition.method}' did not mount.`);
+		}
+		this.ctx.effect(() => () => registration.dispose(), "server facet method registration");
+		return registration;
+	};
+	mounted() {
+		return this.host.mounted();
+	}
+	mountedChannels() {
+		return this.host.mountedChannels();
+	}
+};
+/** Publishes the host service from inside a mounted plugin, so it unwinds with the root. */
+function serverHostProvider(context, host) {
+	new ScopedDoomServerHost(context, host);
+}
+/**
+* Installs server facets into a cordis root that provides the server host.
+*
+* A cordis root rather than plain calls, because a facet is a Doom
+* contribution like any other: it may inject services a host provides later,
+* and it unwinds through the same fiber disposal the Pi facet uses. One root
+* per host process, created here, so no host has to know cordis to run one.
+*
+* Facets are awaited one at a time and each is a single fiber, because a
+* facet declares its `inject` on itself. `fiber.await()` therefore settles
+* once `apply` has run, and the caller can read a complete mount table before
+* deciding whether to open a listener.
+*/
+async function installServerFacets(options) {
+	const notice = options.onNotice ?? (() => {});
+	const root = new Context();
+	await root.plugin(serverHostProvider, options.host).await();
+	try {
+		await options.prepare?.(root);
+	} catch (error) {
+		await root.fiber.dispose();
+		throw error;
+	}
+	if (options.facets.some((candidate) => "retained" in candidate && candidate.retained === true) && !readDoomHeadlessHost(root)) {
+		await root.fiber.dispose();
+		throw new Error("Retained server candidates require a gated headless host");
+	}
+	const installed = [];
+	const installedPackages = [];
+	const disposeInstalled = async () => {
+		for (const fiber of [...installed].reverse()) await fiber.dispose();
+	};
+	for (const candidate of options.facets) {
+		const facet = "declaration" in candidate ? candidate.facet : candidate;
+		const declaration = "declaration" in candidate ? candidate.declaration : void 0;
+		let fiber;
+		try {
+			fiber = (declaration ? root.extend({ [DOOM_HEADLESS_OWNER]: declaration }) : root).plugin(facet);
+			await fiber.await();
+			installed.push(fiber);
+			if (declaration) installedPackages.push(declaration.packageName);
+		} catch (error) {
+			await fiber?.dispose();
+			const message = `${declaration === void 0 ? "a server facet" : `server facet '${declaration.packageName}'`} did not install (${error instanceof Error ? error.message : String(error)})`;
+			if (declaration?.required === true && !("initiallyEligible" in candidate && candidate.initiallyEligible === false)) {
+				await disposeInstalled();
+				await root.fiber.dispose();
+				throw new Error(message, { cause: error });
+			}
+			notice(message);
+		}
+	}
+	let disposePromise;
+	return {
+		root,
+		installedPackages,
+		dispose: () => {
+			disposePromise ??= (async () => {
+				await disposeInstalled();
+				await root.fiber.dispose();
+			})();
+			return disposePromise;
+		}
+	};
+}
+//#endregion
+export { installServerFacets, loadServerBundle, resolveServerBundleSource };
+
+//# sourceMappingURL=serverFacetLoader.mjs.map