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

package/dist/web/schemas/bundleAssetPolicy.d.cts

@@ -0,0 +1,10 @@
+//#region src/web/schemas/bundleAssetPolicy.d.ts
+export declare const BUNDLE_ASSET_POLICY_PATH = "/bundle-asset-policy.json";
+export declare const BUNDLE_ASSET_POLICY_VERSION = 1;
+export interface BundleAssetPolicy {
+  version: typeof BUNDLE_ASSET_POLICY_VERSION;
+  optional: string[];
+}
+export declare function parseBundleAssetPolicy(value: unknown): BundleAssetPolicy | undefined;
+//#endregion
+//# sourceMappingURL=bundleAssetPolicy.d.cts.map

package/dist/web/schemas/bundleAssetPolicy.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundleAssetPolicy.d.cts","names":[],"sources":["../../../src/web/schemas/bundleAssetPolicy.ts"],"mappings":";qBAAa;qBACA;iBAEI;EACf,gBAAgB;EAChB;;wBAGc,uBAAuB,iBAAiB"}

package/dist/web/schemas/bundleAssetPolicy.d.mts

@@ -0,0 +1,10 @@
+//#region src/web/schemas/bundleAssetPolicy.d.ts
+export declare const BUNDLE_ASSET_POLICY_PATH = "/bundle-asset-policy.json";
+export declare const BUNDLE_ASSET_POLICY_VERSION = 1;
+export interface BundleAssetPolicy {
+  version: typeof BUNDLE_ASSET_POLICY_VERSION;
+  optional: string[];
+}
+export declare function parseBundleAssetPolicy(value: unknown): BundleAssetPolicy | undefined;
+//#endregion
+//# sourceMappingURL=bundleAssetPolicy.d.mts.map

package/dist/web/schemas/bundleAssetPolicy.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundleAssetPolicy.d.mts","names":[],"sources":["../../../src/web/schemas/bundleAssetPolicy.ts"],"mappings":";qBAAa;qBACA;iBAEI;EACf,gBAAgB;EAChB;;wBAGc,uBAAuB,iBAAiB"}

package/dist/web/schemas/bundleAssetPolicy.mjs

@@ -0,0 +1,18 @@
+//#region src/web/schemas/bundleAssetPolicy.ts
+const BUNDLE_ASSET_POLICY_PATH = "/bundle-asset-policy.json";
+const BUNDLE_ASSET_POLICY_VERSION = 1;
+function parseBundleAssetPolicy(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+	const candidate = value;
+	if (Object.keys(candidate).sort().join(",") !== "optional,version" || candidate.version !== 1 || !Array.isArray(candidate.optional)) return;
+	const optional = candidate.optional;
+	if (optional.some((asset) => typeof asset !== "string" || !asset.startsWith("/") || asset.includes("\\") || asset.includes("?") || asset.includes("#")) || new Set(optional).size !== optional.length) return;
+	return {
+		version: 1,
+		optional: [...optional].sort((a, b) => a.localeCompare(b))
+	};
+}
+//#endregion
+export { BUNDLE_ASSET_POLICY_PATH, BUNDLE_ASSET_POLICY_VERSION, parseBundleAssetPolicy };
+
+//# sourceMappingURL=bundleAssetPolicy.mjs.map

package/dist/web/schemas/bundleAssetPolicy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundleAssetPolicy.mjs","names":[],"sources":["../../../src/web/schemas/bundleAssetPolicy.ts"],"sourcesContent":["export const BUNDLE_ASSET_POLICY_PATH = '/bundle-asset-policy.json';\nexport const BUNDLE_ASSET_POLICY_VERSION = 1;\n\nexport interface BundleAssetPolicy {\n  version: typeof BUNDLE_ASSET_POLICY_VERSION;\n  optional: string[];\n}\n\nexport function parseBundleAssetPolicy(value: unknown): BundleAssetPolicy | undefined {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) return undefined;\n  const candidate = value as Record<string, unknown>;\n  if (\n    Object.keys(candidate).sort().join(',') !== 'optional,version' ||\n    candidate.version !== BUNDLE_ASSET_POLICY_VERSION ||\n    !Array.isArray(candidate.optional)\n  ) {\n    return undefined;\n  }\n  const optional = candidate.optional;\n  if (\n    optional.some(\n      (asset) =>\n        typeof asset !== 'string' ||\n        !asset.startsWith('/') ||\n        asset.includes('\\\\') ||\n        asset.includes('?') ||\n        asset.includes('#'),\n    ) ||\n    new Set(optional).size !== optional.length\n  ) {\n    return undefined;\n  }\n  return { version: BUNDLE_ASSET_POLICY_VERSION, optional: [...optional].sort((a, b) => a.localeCompare(b)) };\n}\n"],"mappings":";AAAA,MAAa,2BAA2B;AACxC,MAAa,8BAA8B;AAO3C,SAAgB,uBAAuB,OAA+C;CACpF,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GAAG,OAAO,KAAA;CAChF,MAAM,YAAY;CAClB,IACE,OAAO,KAAK,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,MAAM,sBAC5C,UAAU,YAAA,KACV,CAAC,MAAM,QAAQ,UAAU,QAAQ,GAEjC;CAEF,MAAM,WAAW,UAAU;CAC3B,IACE,SAAS,MACN,UACC,OAAO,UAAU,YACjB,CAAC,MAAM,WAAW,GAAG,KACrB,MAAM,SAAS,IAAI,KACnB,MAAM,SAAS,GAAG,KAClB,MAAM,SAAS,GAAG,CACtB,KACA,IAAI,IAAI,QAAQ,CAAC,CAAC,SAAS,SAAS,QAEpC;CAEF,OAAO;EAAE,SAAA;EAAsC,UAAU,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;CAAE;AAC5G"}

package/dist/web/services/sessionRegistry/index.cjs

@@ -0,0 +1,107 @@
+//#region src/web/services/sessionRegistry/index.ts
+/** Overrides the runtime directory the hub and its session servers share. */
+const REGISTRY_DIR_ENV = "DOOMPI_RUNTIME_DIR";
+/** The version a lineage sidecar must carry to be read at all. */
+const SESSION_LINEAGE_RECORD_VERSION = 1;
+/** The version a hub advertisement must carry to be read at all. */
+const HUB_ADVERTISEMENT_VERSION = 1;
+const DEFAULT_RUN_DIR_SEGMENT = ".doompi/run";
+const SESSIONS_SEGMENT = "sessions";
+const LINEAGE_EXTENSION = ".lineage.json";
+const HUB_ADVERTISEMENT_FILE = "hub.json";
+/**
+* The single definition of where the session registry lives.
+*
+* The hub, the session server, and any package that spawns a session must land
+* on the same directory or a spawned session never appears in the rail. This
+* used to be copied into each of them; it lives here so there is one answer.
+*/
+function resolveRegistryDir(input) {
+	if (input.flagValue) return input.flagValue;
+	if (input.envValue) return input.envValue;
+	return `${input.homeDir}/${DEFAULT_RUN_DIR_SEGMENT}`;
+}
+/** The lineage sidecar's path, beside the session's own record file. */
+function sessionLineagePath(registryDir, sessionId) {
+	return `${registryDir}/${SESSIONS_SEGMENT}/${sessionId}${LINEAGE_EXTENSION}`;
+}
+/**
+* Reads a lineage sidecar's contents.
+*
+* Every failure means the same thing to a caller: this session has no known
+* parent. A torn write, a version this build predates, or a file that is not
+* JSON at all are all normal, because the sidecar is written by a separate
+* process that may be mid-write or newer than the reader.
+*/
+function parseSessionLineage(raw) {
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		return;
+	}
+	if (typeof parsed !== "object" || parsed === null) return void 0;
+	const record = parsed;
+	if (record.version !== 1) return void 0;
+	if (typeof record.parentSessionId !== "string" || record.parentSessionId === "") return void 0;
+	const provenance = typeof record.provenance === "string" ? record.provenance : "";
+	return {
+		version: 1,
+		parentSessionId: record.parentSessionId,
+		provenance
+	};
+}
+/** Where the hub publishes its local address, at the registry root. */
+function hubAdvertisementPath(registryDir) {
+	return `${registryDir}/${HUB_ADVERTISEMENT_FILE}`;
+}
+/**
+* Reads a hub advertisement's contents.
+*
+* Like the lineage sidecar, every failure collapses to "no hub advertised",
+* because a caller can do nothing different with a torn write than with a
+* missing file. The url is required to be a loopback http origin: this file is
+* a discovery hint for local processes, and honouring an arbitrary address out
+* of it would let anything that can write the registry directory redirect a
+* session-create call to a host of its choosing.
+*/
+function parseHubAdvertisement(raw) {
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		return;
+	}
+	if (typeof parsed !== "object" || parsed === null) return void 0;
+	const record = parsed;
+	if (record.version !== 1) return void 0;
+	if (typeof record.url !== "string" || !isLoopbackHttpUrl(record.url)) return void 0;
+	if (typeof record.pid !== "number" || !Number.isInteger(record.pid) || record.pid <= 0) return void 0;
+	return {
+		version: 1,
+		url: record.url,
+		pid: record.pid
+	};
+}
+/** Whether a url is plain http to this machine, which is all this file may name. */
+function isLoopbackHttpUrl(value) {
+	let url;
+	try {
+		url = new URL(value);
+	} catch {
+		return false;
+	}
+	if (url.protocol !== "http:") return false;
+	return url.hostname === "127.0.0.1" || url.hostname === "localhost" || url.hostname === "[::1]" || url.hostname === "::1";
+}
+//#endregion
+exports.HUB_ADVERTISEMENT_VERSION = HUB_ADVERTISEMENT_VERSION;
+exports.REGISTRY_DIR_ENV = REGISTRY_DIR_ENV;
+exports.SESSION_LINEAGE_RECORD_VERSION = SESSION_LINEAGE_RECORD_VERSION;
+exports.hubAdvertisementPath = hubAdvertisementPath;
+exports.parseHubAdvertisement = parseHubAdvertisement;
+exports.parseSessionLineage = parseSessionLineage;
+exports.resolveRegistryDir = resolveRegistryDir;
+exports.sessionLineagePath = sessionLineagePath;
+
+//# sourceMappingURL=index.cjs.map

package/dist/web/services/sessionRegistry/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../src/web/services/sessionRegistry/index.ts"],"sourcesContent":["import type { HubAdvertisement, RegistryDirInput, SessionLineageRecord } from '../../types/sessionRegistry';\n\n/** Overrides the runtime directory the hub and its session servers share. */\nexport const REGISTRY_DIR_ENV = 'DOOMPI_RUNTIME_DIR';\n\n/** The version a lineage sidecar must carry to be read at all. */\nexport const SESSION_LINEAGE_RECORD_VERSION = 1;\n\n/** The version a hub advertisement must carry to be read at all. */\nexport const HUB_ADVERTISEMENT_VERSION = 1;\n\nconst DEFAULT_RUN_DIR_SEGMENT = '.doompi/run';\nconst SESSIONS_SEGMENT = 'sessions';\nconst LINEAGE_EXTENSION = '.lineage.json';\nconst HUB_ADVERTISEMENT_FILE = 'hub.json';\n\n/**\n * The single definition of where the session registry lives.\n *\n * The hub, the session server, and any package that spawns a session must land\n * on the same directory or a spawned session never appears in the rail. This\n * used to be copied into each of them; it lives here so there is one answer.\n */\nexport function resolveRegistryDir(input: RegistryDirInput): string {\n  if (input.flagValue) return input.flagValue;\n  if (input.envValue) return input.envValue;\n  return `${input.homeDir}/${DEFAULT_RUN_DIR_SEGMENT}`;\n}\n\n/** The lineage sidecar's path, beside the session's own record file. */\nexport function sessionLineagePath(registryDir: string, sessionId: string): string {\n  return `${registryDir}/${SESSIONS_SEGMENT}/${sessionId}${LINEAGE_EXTENSION}`;\n}\n\n/**\n * Reads a lineage sidecar's contents.\n *\n * Every failure means the same thing to a caller: this session has no known\n * parent. A torn write, a version this build predates, or a file that is not\n * JSON at all are all normal, because the sidecar is written by a separate\n * process that may be mid-write or newer than the reader.\n */\nexport function parseSessionLineage(raw: string): SessionLineageRecord | undefined {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n  if (typeof parsed !== 'object' || parsed === null) return undefined;\n  const record = parsed as Partial<SessionLineageRecord>;\n  if (record.version !== SESSION_LINEAGE_RECORD_VERSION) return undefined;\n  if (typeof record.parentSessionId !== 'string' || record.parentSessionId === '') return undefined;\n  const provenance = typeof record.provenance === 'string' ? record.provenance : '';\n  return { version: SESSION_LINEAGE_RECORD_VERSION, parentSessionId: record.parentSessionId, provenance };\n}\n\n/** Where the hub publishes its local address, at the registry root. */\nexport function hubAdvertisementPath(registryDir: string): string {\n  return `${registryDir}/${HUB_ADVERTISEMENT_FILE}`;\n}\n\n/**\n * Reads a hub advertisement's contents.\n *\n * Like the lineage sidecar, every failure collapses to \"no hub advertised\",\n * because a caller can do nothing different with a torn write than with a\n * missing file. The url is required to be a loopback http origin: this file is\n * a discovery hint for local processes, and honouring an arbitrary address out\n * of it would let anything that can write the registry directory redirect a\n * session-create call to a host of its choosing.\n */\nexport function parseHubAdvertisement(raw: string): HubAdvertisement | undefined {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n  if (typeof parsed !== 'object' || parsed === null) return undefined;\n  const record = parsed as Partial<HubAdvertisement>;\n  if (record.version !== HUB_ADVERTISEMENT_VERSION) return undefined;\n  if (typeof record.url !== 'string' || !isLoopbackHttpUrl(record.url)) return undefined;\n  if (typeof record.pid !== 'number' || !Number.isInteger(record.pid) || record.pid <= 0) return undefined;\n  return { version: HUB_ADVERTISEMENT_VERSION, url: record.url, pid: record.pid };\n}\n\n/** Whether a url is plain http to this machine, which is all this file may name. */\nfunction isLoopbackHttpUrl(value: string): boolean {\n  let url: URL;\n  try {\n    url = new URL(value);\n  } catch {\n    return false;\n  }\n  if (url.protocol !== 'http:') return false;\n  return (\n    url.hostname === '127.0.0.1' || url.hostname === 'localhost' || url.hostname === '[::1]' || url.hostname === '::1'\n  );\n}\n"],"mappings":";;AAGA,MAAa,mBAAmB;;AAGhC,MAAa,iCAAiC;;AAG9C,MAAa,4BAA4B;AAEzC,MAAM,0BAA0B;AAChC,MAAM,mBAAmB;AACzB,MAAM,oBAAoB;AAC1B,MAAM,yBAAyB;;;;;;;;AAS/B,SAAgB,mBAAmB,OAAiC;CAClE,IAAI,MAAM,WAAW,OAAO,MAAM;CAClC,IAAI,MAAM,UAAU,OAAO,MAAM;CACjC,OAAO,GAAG,MAAM,QAAQ,GAAG;AAC7B;;AAGA,SAAgB,mBAAmB,aAAqB,WAA2B;CACjF,OAAO,GAAG,YAAY,GAAG,iBAAiB,GAAG,YAAY;AAC3D;;;;;;;;;AAUA,SAAgB,oBAAoB,KAA+C;CACjF,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MAAM,GAAG;CACzB,QAAQ;EACN;CACF;CACA,IAAI,OAAO,WAAW,YAAY,WAAW,MAAM,OAAO,KAAA;CAC1D,MAAM,SAAS;CACf,IAAI,OAAO,YAAA,GAA4C,OAAO,KAAA;CAC9D,IAAI,OAAO,OAAO,oBAAoB,YAAY,OAAO,oBAAoB,IAAI,OAAO,KAAA;CACxF,MAAM,aAAa,OAAO,OAAO,eAAe,WAAW,OAAO,aAAa;CAC/E,OAAO;EAAE,SAAA;EAAyC,iBAAiB,OAAO;EAAiB;CAAW;AACxG;;AAGA,SAAgB,qBAAqB,aAA6B;CAChE,OAAO,GAAG,YAAY,GAAG;AAC3B;;;;;;;;;;;AAYA,SAAgB,sBAAsB,KAA2C;CAC/E,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MAAM,GAAG;CACzB,QAAQ;EACN;CACF;CACA,IAAI,OAAO,WAAW,YAAY,WAAW,MAAM,OAAO,KAAA;CAC1D,MAAM,SAAS;CACf,IAAI,OAAO,YAAA,GAAuC,OAAO,KAAA;CACzD,IAAI,OAAO,OAAO,QAAQ,YAAY,CAAC,kBAAkB,OAAO,GAAG,GAAG,OAAO,KAAA;CAC7E,IAAI,OAAO,OAAO,QAAQ,YAAY,CAAC,OAAO,UAAU,OAAO,GAAG,KAAK,OAAO,OAAO,GAAG,OAAO,KAAA;CAC/F,OAAO;EAAE,SAAA;EAAoC,KAAK,OAAO;EAAK,KAAK,OAAO;CAAI;AAChF;;AAGA,SAAS,kBAAkB,OAAwB;CACjD,IAAI;CACJ,IAAI;EACF,MAAM,IAAI,IAAI,KAAK;CACrB,QAAQ;EACN,OAAO;CACT;CACA,IAAI,IAAI,aAAa,SAAS,OAAO;CACrC,OACE,IAAI,aAAa,eAAe,IAAI,aAAa,eAAe,IAAI,aAAa,WAAW,IAAI,aAAa;AAEjH"}

package/dist/web/services/sessionRegistry/index.d.cts

@@ -0,0 +1,42 @@
+import { HubAdvertisement, RegistryDirInput, SessionLineageRecord } from "../../types/sessionRegistry.cjs";
+//#region src/web/services/sessionRegistry/index.d.ts
+/** Overrides the runtime directory the hub and its session servers share. */
+export declare const REGISTRY_DIR_ENV = "DOOMPI_RUNTIME_DIR";
+/** The version a lineage sidecar must carry to be read at all. */
+export declare const SESSION_LINEAGE_RECORD_VERSION = 1;
+/** The version a hub advertisement must carry to be read at all. */
+export declare const HUB_ADVERTISEMENT_VERSION = 1;
+/**
+ * The single definition of where the session registry lives.
+ *
+ * The hub, the session server, and any package that spawns a session must land
+ * on the same directory or a spawned session never appears in the rail. This
+ * used to be copied into each of them; it lives here so there is one answer.
+ */
+export declare function resolveRegistryDir(input: RegistryDirInput): string;
+/** The lineage sidecar's path, beside the session's own record file. */
+export declare function sessionLineagePath(registryDir: string, sessionId: string): string;
+/**
+ * Reads a lineage sidecar's contents.
+ *
+ * Every failure means the same thing to a caller: this session has no known
+ * parent. A torn write, a version this build predates, or a file that is not
+ * JSON at all are all normal, because the sidecar is written by a separate
+ * process that may be mid-write or newer than the reader.
+ */
+export declare function parseSessionLineage(raw: string): SessionLineageRecord | undefined;
+/** Where the hub publishes its local address, at the registry root. */
+export declare function hubAdvertisementPath(registryDir: string): string;
+/**
+ * Reads a hub advertisement's contents.
+ *
+ * Like the lineage sidecar, every failure collapses to "no hub advertised",
+ * because a caller can do nothing different with a torn write than with a
+ * missing file. The url is required to be a loopback http origin: this file is
+ * a discovery hint for local processes, and honouring an arbitrary address out
+ * of it would let anything that can write the registry directory redirect a
+ * session-create call to a host of its choosing.
+ */
+export declare function parseHubAdvertisement(raw: string): HubAdvertisement | undefined;
+//#endregion
+//# sourceMappingURL=index.d.cts.map

package/dist/web/services/sessionRegistry/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../../src/web/services/sessionRegistry/index.ts"],"mappings":";;;qBAGa;;qBAGA;;qBAGA;;;;;;;;wBAcG,mBAAmB,OAAO;;wBAO1B,mBAAmB,qBAAqB;;;;;;;;;wBAYxC,oBAAoB,cAAc;;wBAgBlC,qBAAqB;;;;;;;;;;;wBAcrB,sBAAsB,cAAc"}

package/dist/web/services/sessionRegistry/index.d.mts

@@ -0,0 +1,42 @@
+import { HubAdvertisement, RegistryDirInput, SessionLineageRecord } from "../../types/sessionRegistry.mjs";
+//#region src/web/services/sessionRegistry/index.d.ts
+/** Overrides the runtime directory the hub and its session servers share. */
+export declare const REGISTRY_DIR_ENV = "DOOMPI_RUNTIME_DIR";
+/** The version a lineage sidecar must carry to be read at all. */
+export declare const SESSION_LINEAGE_RECORD_VERSION = 1;
+/** The version a hub advertisement must carry to be read at all. */
+export declare const HUB_ADVERTISEMENT_VERSION = 1;
+/**
+ * The single definition of where the session registry lives.
+ *
+ * The hub, the session server, and any package that spawns a session must land
+ * on the same directory or a spawned session never appears in the rail. This
+ * used to be copied into each of them; it lives here so there is one answer.
+ */
+export declare function resolveRegistryDir(input: RegistryDirInput): string;
+/** The lineage sidecar's path, beside the session's own record file. */
+export declare function sessionLineagePath(registryDir: string, sessionId: string): string;
+/**
+ * Reads a lineage sidecar's contents.
+ *
+ * Every failure means the same thing to a caller: this session has no known
+ * parent. A torn write, a version this build predates, or a file that is not
+ * JSON at all are all normal, because the sidecar is written by a separate
+ * process that may be mid-write or newer than the reader.
+ */
+export declare function parseSessionLineage(raw: string): SessionLineageRecord | undefined;
+/** Where the hub publishes its local address, at the registry root. */
+export declare function hubAdvertisementPath(registryDir: string): string;
+/**
+ * Reads a hub advertisement's contents.
+ *
+ * Like the lineage sidecar, every failure collapses to "no hub advertised",
+ * because a caller can do nothing different with a torn write than with a
+ * missing file. The url is required to be a loopback http origin: this file is
+ * a discovery hint for local processes, and honouring an arbitrary address out
+ * of it would let anything that can write the registry directory redirect a
+ * session-create call to a host of its choosing.
+ */
+export declare function parseHubAdvertisement(raw: string): HubAdvertisement | undefined;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/web/services/sessionRegistry/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/web/services/sessionRegistry/index.ts"],"mappings":";;;qBAGa;;qBAGA;;qBAGA;;;;;;;;wBAcG,mBAAmB,OAAO;;wBAO1B,mBAAmB,qBAAqB;;;;;;;;;wBAYxC,oBAAoB,cAAc;;wBAgBlC,qBAAqB;;;;;;;;;;;wBAcrB,sBAAsB,cAAc"}

package/dist/web/services/sessionRegistry/index.mjs

@@ -0,0 +1,100 @@
+//#region src/web/services/sessionRegistry/index.ts
+/** Overrides the runtime directory the hub and its session servers share. */
+const REGISTRY_DIR_ENV = "DOOMPI_RUNTIME_DIR";
+/** The version a lineage sidecar must carry to be read at all. */
+const SESSION_LINEAGE_RECORD_VERSION = 1;
+/** The version a hub advertisement must carry to be read at all. */
+const HUB_ADVERTISEMENT_VERSION = 1;
+const DEFAULT_RUN_DIR_SEGMENT = ".doompi/run";
+const SESSIONS_SEGMENT = "sessions";
+const LINEAGE_EXTENSION = ".lineage.json";
+const HUB_ADVERTISEMENT_FILE = "hub.json";
+/**
+* The single definition of where the session registry lives.
+*
+* The hub, the session server, and any package that spawns a session must land
+* on the same directory or a spawned session never appears in the rail. This
+* used to be copied into each of them; it lives here so there is one answer.
+*/
+function resolveRegistryDir(input) {
+	if (input.flagValue) return input.flagValue;
+	if (input.envValue) return input.envValue;
+	return `${input.homeDir}/${DEFAULT_RUN_DIR_SEGMENT}`;
+}
+/** The lineage sidecar's path, beside the session's own record file. */
+function sessionLineagePath(registryDir, sessionId) {
+	return `${registryDir}/${SESSIONS_SEGMENT}/${sessionId}${LINEAGE_EXTENSION}`;
+}
+/**
+* Reads a lineage sidecar's contents.
+*
+* Every failure means the same thing to a caller: this session has no known
+* parent. A torn write, a version this build predates, or a file that is not
+* JSON at all are all normal, because the sidecar is written by a separate
+* process that may be mid-write or newer than the reader.
+*/
+function parseSessionLineage(raw) {
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		return;
+	}
+	if (typeof parsed !== "object" || parsed === null) return void 0;
+	const record = parsed;
+	if (record.version !== 1) return void 0;
+	if (typeof record.parentSessionId !== "string" || record.parentSessionId === "") return void 0;
+	const provenance = typeof record.provenance === "string" ? record.provenance : "";
+	return {
+		version: 1,
+		parentSessionId: record.parentSessionId,
+		provenance
+	};
+}
+/** Where the hub publishes its local address, at the registry root. */
+function hubAdvertisementPath(registryDir) {
+	return `${registryDir}/${HUB_ADVERTISEMENT_FILE}`;
+}
+/**
+* Reads a hub advertisement's contents.
+*
+* Like the lineage sidecar, every failure collapses to "no hub advertised",
+* because a caller can do nothing different with a torn write than with a
+* missing file. The url is required to be a loopback http origin: this file is
+* a discovery hint for local processes, and honouring an arbitrary address out
+* of it would let anything that can write the registry directory redirect a
+* session-create call to a host of its choosing.
+*/
+function parseHubAdvertisement(raw) {
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		return;
+	}
+	if (typeof parsed !== "object" || parsed === null) return void 0;
+	const record = parsed;
+	if (record.version !== 1) return void 0;
+	if (typeof record.url !== "string" || !isLoopbackHttpUrl(record.url)) return void 0;
+	if (typeof record.pid !== "number" || !Number.isInteger(record.pid) || record.pid <= 0) return void 0;
+	return {
+		version: 1,
+		url: record.url,
+		pid: record.pid
+	};
+}
+/** Whether a url is plain http to this machine, which is all this file may name. */
+function isLoopbackHttpUrl(value) {
+	let url;
+	try {
+		url = new URL(value);
+	} catch {
+		return false;
+	}
+	if (url.protocol !== "http:") return false;
+	return url.hostname === "127.0.0.1" || url.hostname === "localhost" || url.hostname === "[::1]" || url.hostname === "::1";
+}
+//#endregion
+export { HUB_ADVERTISEMENT_VERSION, REGISTRY_DIR_ENV, SESSION_LINEAGE_RECORD_VERSION, hubAdvertisementPath, parseHubAdvertisement, parseSessionLineage, resolveRegistryDir, sessionLineagePath };
+
+//# sourceMappingURL=index.mjs.map

package/dist/web/services/sessionRegistry/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/web/services/sessionRegistry/index.ts"],"sourcesContent":["import type { HubAdvertisement, RegistryDirInput, SessionLineageRecord } from '../../types/sessionRegistry';\n\n/** Overrides the runtime directory the hub and its session servers share. */\nexport const REGISTRY_DIR_ENV = 'DOOMPI_RUNTIME_DIR';\n\n/** The version a lineage sidecar must carry to be read at all. */\nexport const SESSION_LINEAGE_RECORD_VERSION = 1;\n\n/** The version a hub advertisement must carry to be read at all. */\nexport const HUB_ADVERTISEMENT_VERSION = 1;\n\nconst DEFAULT_RUN_DIR_SEGMENT = '.doompi/run';\nconst SESSIONS_SEGMENT = 'sessions';\nconst LINEAGE_EXTENSION = '.lineage.json';\nconst HUB_ADVERTISEMENT_FILE = 'hub.json';\n\n/**\n * The single definition of where the session registry lives.\n *\n * The hub, the session server, and any package that spawns a session must land\n * on the same directory or a spawned session never appears in the rail. This\n * used to be copied into each of them; it lives here so there is one answer.\n */\nexport function resolveRegistryDir(input: RegistryDirInput): string {\n  if (input.flagValue) return input.flagValue;\n  if (input.envValue) return input.envValue;\n  return `${input.homeDir}/${DEFAULT_RUN_DIR_SEGMENT}`;\n}\n\n/** The lineage sidecar's path, beside the session's own record file. */\nexport function sessionLineagePath(registryDir: string, sessionId: string): string {\n  return `${registryDir}/${SESSIONS_SEGMENT}/${sessionId}${LINEAGE_EXTENSION}`;\n}\n\n/**\n * Reads a lineage sidecar's contents.\n *\n * Every failure means the same thing to a caller: this session has no known\n * parent. A torn write, a version this build predates, or a file that is not\n * JSON at all are all normal, because the sidecar is written by a separate\n * process that may be mid-write or newer than the reader.\n */\nexport function parseSessionLineage(raw: string): SessionLineageRecord | undefined {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n  if (typeof parsed !== 'object' || parsed === null) return undefined;\n  const record = parsed as Partial<SessionLineageRecord>;\n  if (record.version !== SESSION_LINEAGE_RECORD_VERSION) return undefined;\n  if (typeof record.parentSessionId !== 'string' || record.parentSessionId === '') return undefined;\n  const provenance = typeof record.provenance === 'string' ? record.provenance : '';\n  return { version: SESSION_LINEAGE_RECORD_VERSION, parentSessionId: record.parentSessionId, provenance };\n}\n\n/** Where the hub publishes its local address, at the registry root. */\nexport function hubAdvertisementPath(registryDir: string): string {\n  return `${registryDir}/${HUB_ADVERTISEMENT_FILE}`;\n}\n\n/**\n * Reads a hub advertisement's contents.\n *\n * Like the lineage sidecar, every failure collapses to \"no hub advertised\",\n * because a caller can do nothing different with a torn write than with a\n * missing file. The url is required to be a loopback http origin: this file is\n * a discovery hint for local processes, and honouring an arbitrary address out\n * of it would let anything that can write the registry directory redirect a\n * session-create call to a host of its choosing.\n */\nexport function parseHubAdvertisement(raw: string): HubAdvertisement | undefined {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n  if (typeof parsed !== 'object' || parsed === null) return undefined;\n  const record = parsed as Partial<HubAdvertisement>;\n  if (record.version !== HUB_ADVERTISEMENT_VERSION) return undefined;\n  if (typeof record.url !== 'string' || !isLoopbackHttpUrl(record.url)) return undefined;\n  if (typeof record.pid !== 'number' || !Number.isInteger(record.pid) || record.pid <= 0) return undefined;\n  return { version: HUB_ADVERTISEMENT_VERSION, url: record.url, pid: record.pid };\n}\n\n/** Whether a url is plain http to this machine, which is all this file may name. */\nfunction isLoopbackHttpUrl(value: string): boolean {\n  let url: URL;\n  try {\n    url = new URL(value);\n  } catch {\n    return false;\n  }\n  if (url.protocol !== 'http:') return false;\n  return (\n    url.hostname === '127.0.0.1' || url.hostname === 'localhost' || url.hostname === '[::1]' || url.hostname === '::1'\n  );\n}\n"],"mappings":";;AAGA,MAAa,mBAAmB;;AAGhC,MAAa,iCAAiC;;AAG9C,MAAa,4BAA4B;AAEzC,MAAM,0BAA0B;AAChC,MAAM,mBAAmB;AACzB,MAAM,oBAAoB;AAC1B,MAAM,yBAAyB;;;;;;;;AAS/B,SAAgB,mBAAmB,OAAiC;CAClE,IAAI,MAAM,WAAW,OAAO,MAAM;CAClC,IAAI,MAAM,UAAU,OAAO,MAAM;CACjC,OAAO,GAAG,MAAM,QAAQ,GAAG;AAC7B;;AAGA,SAAgB,mBAAmB,aAAqB,WAA2B;CACjF,OAAO,GAAG,YAAY,GAAG,iBAAiB,GAAG,YAAY;AAC3D;;;;;;;;;AAUA,SAAgB,oBAAoB,KAA+C;CACjF,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MAAM,GAAG;CACzB,QAAQ;EACN;CACF;CACA,IAAI,OAAO,WAAW,YAAY,WAAW,MAAM,OAAO,KAAA;CAC1D,MAAM,SAAS;CACf,IAAI,OAAO,YAAA,GAA4C,OAAO,KAAA;CAC9D,IAAI,OAAO,OAAO,oBAAoB,YAAY,OAAO,oBAAoB,IAAI,OAAO,KAAA;CACxF,MAAM,aAAa,OAAO,OAAO,eAAe,WAAW,OAAO,aAAa;CAC/E,OAAO;EAAE,SAAA;EAAyC,iBAAiB,OAAO;EAAiB;CAAW;AACxG;;AAGA,SAAgB,qBAAqB,aAA6B;CAChE,OAAO,GAAG,YAAY,GAAG;AAC3B;;;;;;;;;;;AAYA,SAAgB,sBAAsB,KAA2C;CAC/E,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MAAM,GAAG;CACzB,QAAQ;EACN;CACF;CACA,IAAI,OAAO,WAAW,YAAY,WAAW,MAAM,OAAO,KAAA;CAC1D,MAAM,SAAS;CACf,IAAI,OAAO,YAAA,GAAuC,OAAO,KAAA;CACzD,IAAI,OAAO,OAAO,QAAQ,YAAY,CAAC,kBAAkB,OAAO,GAAG,GAAG,OAAO,KAAA;CAC7E,IAAI,OAAO,OAAO,QAAQ,YAAY,CAAC,OAAO,UAAU,OAAO,GAAG,KAAK,OAAO,OAAO,GAAG,OAAO,KAAA;CAC/F,OAAO;EAAE,SAAA;EAAoC,KAAK,OAAO;EAAK,KAAK,OAAO;CAAI;AAChF;;AAGA,SAAS,kBAAkB,OAAwB;CACjD,IAAI;CACJ,IAAI;EACF,MAAM,IAAI,IAAI,KAAK;CACrB,QAAQ;EACN,OAAO;CACT;CACA,IAAI,IAAI,aAAa,SAAS,OAAO;CACrC,OACE,IAAI,aAAa,eAAe,IAAI,aAAa,eAAe,IAAI,aAAa,WAAW,IAAI,aAAa;AAEjH"}

package/dist/web/services/testing/channels.cjs

@@ -0,0 +1,11 @@
+//#region src/web/services/testing/channels.ts
+function driveChannel(channel, sessionId, payload) {
+	const parsed = channel.parse(payload);
+	if (parsed === null) return { accepted: false };
+	channel.apply(sessionId, parsed);
+	return { accepted: true };
+}
+//#endregion
+exports.driveChannel = driveChannel;
+
+//# sourceMappingURL=channels.cjs.map

package/dist/web/services/testing/channels.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.cjs","names":[],"sources":["../../../../src/web/services/testing/channels.ts"],"sourcesContent":["import type { SessionChannelContribution } from '../../types/webPlugin';\n\nexport interface ChannelDelivery {\n  accepted: boolean;\n}\n\nexport function driveChannel(\n  channel: SessionChannelContribution,\n  sessionId: string,\n  payload: unknown,\n): ChannelDelivery {\n  const parsed: unknown = channel.parse(payload);\n  if (parsed === null) return { accepted: false };\n  channel.apply(sessionId, parsed);\n  return { accepted: true };\n}\n"],"mappings":";AAMA,SAAgB,aACd,SACA,WACA,SACiB;CACjB,MAAM,SAAkB,QAAQ,MAAM,OAAO;CAC7C,IAAI,WAAW,MAAM,OAAO,EAAE,UAAU,MAAM;CAC9C,QAAQ,MAAM,WAAW,MAAM;CAC/B,OAAO,EAAE,UAAU,KAAK;AAC1B"}

package/dist/web/services/testing/channels.d.cts

@@ -0,0 +1,8 @@
+import { SessionChannelContribution } from "../../types/webPlugin.cjs";
+//#region src/web/services/testing/channels.d.ts
+export interface ChannelDelivery {
+  accepted: boolean;
+}
+export declare function driveChannel(channel: SessionChannelContribution, sessionId: string, payload: unknown): ChannelDelivery;
+//#endregion
+//# sourceMappingURL=channels.d.cts.map

package/dist/web/services/testing/channels.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.cts","names":[],"sources":["../../../../src/web/services/testing/channels.ts"],"mappings":";;iBAEiB;EACf;;wBAGc,aACd,SAAS,4BACT,mBACA,mBACC"}

package/dist/web/services/testing/channels.d.mts

@@ -0,0 +1,8 @@
+import { SessionChannelContribution } from "../../types/webPlugin.mjs";
+//#region src/web/services/testing/channels.d.ts
+export interface ChannelDelivery {
+  accepted: boolean;
+}
+export declare function driveChannel(channel: SessionChannelContribution, sessionId: string, payload: unknown): ChannelDelivery;
+//#endregion
+//# sourceMappingURL=channels.d.mts.map

package/dist/web/services/testing/channels.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.mts","names":[],"sources":["../../../../src/web/services/testing/channels.ts"],"mappings":";;iBAEiB;EACf;;wBAGc,aACd,SAAS,4BACT,mBACA,mBACC"}

package/dist/web/services/testing/channels.mjs

@@ -0,0 +1,11 @@
+//#region src/web/services/testing/channels.ts
+function driveChannel(channel, sessionId, payload) {
+	const parsed = channel.parse(payload);
+	if (parsed === null) return { accepted: false };
+	channel.apply(sessionId, parsed);
+	return { accepted: true };
+}
+//#endregion
+export { driveChannel };
+
+//# sourceMappingURL=channels.mjs.map

package/dist/web/services/testing/channels.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.mjs","names":[],"sources":["../../../../src/web/services/testing/channels.ts"],"sourcesContent":["import type { SessionChannelContribution } from '../../types/webPlugin';\n\nexport interface ChannelDelivery {\n  accepted: boolean;\n}\n\nexport function driveChannel(\n  channel: SessionChannelContribution,\n  sessionId: string,\n  payload: unknown,\n): ChannelDelivery {\n  const parsed: unknown = channel.parse(payload);\n  if (parsed === null) return { accepted: false };\n  channel.apply(sessionId, parsed);\n  return { accepted: true };\n}\n"],"mappings":";AAMA,SAAgB,aACd,SACA,WACA,SACiB;CACjB,MAAM,SAAkB,QAAQ,MAAM,OAAO;CAC7C,IAAI,WAAW,MAAM,OAAO,EAAE,UAAU,MAAM;CAC9C,QAAQ,MAAM,WAAW,MAAM;CAC/B,OAAO,EAAE,UAAU,KAAK;AAC1B"}

package/dist/web/services/testing/index.cjs

@@ -0,0 +1,27 @@
+let react = require("react");
+let react_dom_server = require("react-dom/server");
+//#region src/web/services/testing/index.ts
+/** Tag-stripped text, so an assertion reads the page rather than the markup. */
+function textOf(html) {
+	return html.replaceAll(/<[^>]*>/gu, " ").replaceAll(/\s+/gu, " ").trim();
+}
+function renderPlugin(component, props) {
+	try {
+		const html = (0, react_dom_server.renderToStaticMarkup)((0, react.createElement)(component, props));
+		return {
+			html,
+			error: void 0,
+			includes: (text) => textOf(html).includes(text)
+		};
+	} catch (error) {
+		return {
+			html: "",
+			error: error instanceof Error ? error : new Error(String(error)),
+			includes: () => false
+		};
+	}
+}
+//#endregion
+exports.renderPlugin = renderPlugin;
+
+//# sourceMappingURL=index.cjs.map

package/dist/web/services/testing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["renderToStaticMarkup","createElement"],"sources":["../../../../src/web/services/testing/index.ts"],"sourcesContent":["import { createElement } from 'react';\nimport type { ComponentType } from 'react';\nimport { renderToStaticMarkup } from 'react-dom/server';\n\n/**\n * One plugin component, rendered.\n *\n * No plugin component in the repository is imported by any test: stores and\n * pure helpers are covered per package, and the components are exercised only\n * by the browser suite. So the ordinary failures go unseen until a page is\n * opened, and the most ordinary of all is a component that throws on a state\n * the plugin can reach, which the host then catches and replaces with a\n * fallback nobody notices.\n *\n * Static markup rather than a DOM, matching the shared components package. It\n * proves a component mounts, reads the props the host actually sends, and puts\n * the expected text on the page. Clicks, effects, and Radix portals need a real\n * browser and stay with the Playwright suite.\n *\n * Callers pass components as values, never as JSX, so a plugin package needs no\n * JSX configuration in the project that holds its tests.\n */\n\nexport interface RenderedPlugin {\n  /** The markup, or an empty string when the component threw. */\n  html: string;\n  /** What the component threw, which the host would have swallowed. */\n  error: Error | undefined;\n  /** Whether the rendered markup contains this text, ignoring the tags around it. */\n  includes(text: string): boolean;\n}\n\n/** Tag-stripped text, so an assertion reads the page rather than the markup. */\nfunction textOf(html: string): string {\n  return html\n    .replaceAll(/<[^>]*>/gu, ' ')\n    .replaceAll(/\\s+/gu, ' ')\n    .trim();\n}\n\nexport function renderPlugin<Props extends object>(component: ComponentType<Props>, props: Props): RenderedPlugin {\n  try {\n    const html = renderToStaticMarkup(createElement(component, props));\n    return { html, error: undefined, includes: (text) => textOf(html).includes(text) };\n  } catch (error) {\n    // Returned rather than rethrown: the host catches a throwing item and keeps\n    // the page up, so a test wanting to prove that needs the error as a value.\n    return {\n      html: '',\n      error: error instanceof Error ? error : new Error(String(error)),\n      includes: () => false,\n    };\n  }\n}\n"],"mappings":";;;;AAiCA,SAAS,OAAO,MAAsB;CACpC,OAAO,KACJ,WAAW,aAAa,GAAG,CAAC,CAC5B,WAAW,SAAS,GAAG,CAAC,CACxB,KAAK;AACV;AAEA,SAAgB,aAAmC,WAAiC,OAA8B;CAChH,IAAI;EACF,MAAM,QAAA,GAAOA,iBAAAA,qBAAAA,EAAAA,GAAqBC,MAAAA,cAAAA,CAAc,WAAW,KAAK,CAAC;EACjE,OAAO;GAAE;GAAM,OAAO,KAAA;GAAW,WAAW,SAAS,OAAO,IAAI,CAAC,CAAC,SAAS,IAAI;EAAE;CACnF,SAAS,OAAO;EAGd,OAAO;GACL,MAAM;GACN,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;GAC/D,gBAAgB;EAClB;CACF;AACF"}

package/dist/web/services/testing/index.d.cts

@@ -0,0 +1,31 @@
+import { ComponentType } from "react";
+//#region src/web/services/testing/index.d.ts
+/**
+ * One plugin component, rendered.
+ *
+ * No plugin component in the repository is imported by any test: stores and
+ * pure helpers are covered per package, and the components are exercised only
+ * by the browser suite. So the ordinary failures go unseen until a page is
+ * opened, and the most ordinary of all is a component that throws on a state
+ * the plugin can reach, which the host then catches and replaces with a
+ * fallback nobody notices.
+ *
+ * Static markup rather than a DOM, matching the shared components package. It
+ * proves a component mounts, reads the props the host actually sends, and puts
+ * the expected text on the page. Clicks, effects, and Radix portals need a real
+ * browser and stay with the Playwright suite.
+ *
+ * Callers pass components as values, never as JSX, so a plugin package needs no
+ * JSX configuration in the project that holds its tests.
+ */
+export interface RenderedPlugin {
+  /** The markup, or an empty string when the component threw. */
+  html: string;
+  /** What the component threw, which the host would have swallowed. */
+  error: Error | undefined;
+  /** Whether the rendered markup contains this text, ignoring the tags around it. */
+  includes(text: string): boolean;
+}
+export declare function renderPlugin<Props extends object>(component: ComponentType<Props>, props: Props): RenderedPlugin;
+//#endregion
+//# sourceMappingURL=index.d.cts.map

package/dist/web/services/testing/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../../src/web/services/testing/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;iBAuBiB;;EAEf;;EAEA,OAAO;;EAEP,SAAS;;wBAWK,aAAa,sBAAsB,WAAW,cAAc,QAAQ,OAAO,QAAQ"}

package/dist/web/services/testing/index.d.mts

@@ -0,0 +1,31 @@
+import { ComponentType } from "react";
+//#region src/web/services/testing/index.d.ts
+/**
+ * One plugin component, rendered.
+ *
+ * No plugin component in the repository is imported by any test: stores and
+ * pure helpers are covered per package, and the components are exercised only
+ * by the browser suite. So the ordinary failures go unseen until a page is
+ * opened, and the most ordinary of all is a component that throws on a state
+ * the plugin can reach, which the host then catches and replaces with a
+ * fallback nobody notices.
+ *
+ * Static markup rather than a DOM, matching the shared components package. It
+ * proves a component mounts, reads the props the host actually sends, and puts
+ * the expected text on the page. Clicks, effects, and Radix portals need a real
+ * browser and stay with the Playwright suite.
+ *
+ * Callers pass components as values, never as JSX, so a plugin package needs no
+ * JSX configuration in the project that holds its tests.
+ */
+export interface RenderedPlugin {
+  /** The markup, or an empty string when the component threw. */
+  html: string;
+  /** What the component threw, which the host would have swallowed. */
+  error: Error | undefined;
+  /** Whether the rendered markup contains this text, ignoring the tags around it. */
+  includes(text: string): boolean;
+}
+export declare function renderPlugin<Props extends object>(component: ComponentType<Props>, props: Props): RenderedPlugin;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/web/services/testing/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/web/services/testing/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;iBAuBiB;;EAEf;;EAEA,OAAO;;EAEP,SAAS;;wBAWK,aAAa,sBAAsB,WAAW,cAAc,QAAQ,OAAO,QAAQ"}

package/dist/web/services/testing/index.mjs

@@ -0,0 +1,27 @@
+import { createElement } from "react";
+import { renderToStaticMarkup } from "react-dom/server";
+//#region src/web/services/testing/index.ts
+/** Tag-stripped text, so an assertion reads the page rather than the markup. */
+function textOf(html) {
+	return html.replaceAll(/<[^>]*>/gu, " ").replaceAll(/\s+/gu, " ").trim();
+}
+function renderPlugin(component, props) {
+	try {
+		const html = renderToStaticMarkup(createElement(component, props));
+		return {
+			html,
+			error: void 0,
+			includes: (text) => textOf(html).includes(text)
+		};
+	} catch (error) {
+		return {
+			html: "",
+			error: error instanceof Error ? error : new Error(String(error)),
+			includes: () => false
+		};
+	}
+}
+//#endregion
+export { renderPlugin };
+
+//# sourceMappingURL=index.mjs.map

package/dist/web/services/testing/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/web/services/testing/index.ts"],"sourcesContent":["import { createElement } from 'react';\nimport type { ComponentType } from 'react';\nimport { renderToStaticMarkup } from 'react-dom/server';\n\n/**\n * One plugin component, rendered.\n *\n * No plugin component in the repository is imported by any test: stores and\n * pure helpers are covered per package, and the components are exercised only\n * by the browser suite. So the ordinary failures go unseen until a page is\n * opened, and the most ordinary of all is a component that throws on a state\n * the plugin can reach, which the host then catches and replaces with a\n * fallback nobody notices.\n *\n * Static markup rather than a DOM, matching the shared components package. It\n * proves a component mounts, reads the props the host actually sends, and puts\n * the expected text on the page. Clicks, effects, and Radix portals need a real\n * browser and stay with the Playwright suite.\n *\n * Callers pass components as values, never as JSX, so a plugin package needs no\n * JSX configuration in the project that holds its tests.\n */\n\nexport interface RenderedPlugin {\n  /** The markup, or an empty string when the component threw. */\n  html: string;\n  /** What the component threw, which the host would have swallowed. */\n  error: Error | undefined;\n  /** Whether the rendered markup contains this text, ignoring the tags around it. */\n  includes(text: string): boolean;\n}\n\n/** Tag-stripped text, so an assertion reads the page rather than the markup. */\nfunction textOf(html: string): string {\n  return html\n    .replaceAll(/<[^>]*>/gu, ' ')\n    .replaceAll(/\\s+/gu, ' ')\n    .trim();\n}\n\nexport function renderPlugin<Props extends object>(component: ComponentType<Props>, props: Props): RenderedPlugin {\n  try {\n    const html = renderToStaticMarkup(createElement(component, props));\n    return { html, error: undefined, includes: (text) => textOf(html).includes(text) };\n  } catch (error) {\n    // Returned rather than rethrown: the host catches a throwing item and keeps\n    // the page up, so a test wanting to prove that needs the error as a value.\n    return {\n      html: '',\n      error: error instanceof Error ? error : new Error(String(error)),\n      includes: () => false,\n    };\n  }\n}\n"],"mappings":";;;;AAiCA,SAAS,OAAO,MAAsB;CACpC,OAAO,KACJ,WAAW,aAAa,GAAG,CAAC,CAC5B,WAAW,SAAS,GAAG,CAAC,CACxB,KAAK;AACV;AAEA,SAAgB,aAAmC,WAAiC,OAA8B;CAChH,IAAI;EACF,MAAM,OAAO,qBAAqB,cAAc,WAAW,KAAK,CAAC;EACjE,OAAO;GAAE;GAAM,OAAO,KAAA;GAAW,WAAW,SAAS,OAAO,IAAI,CAAC,CAAC,SAAS,IAAI;EAAE;CACnF,SAAS,OAAO;EAGd,OAAO;GACL,MAAM;GACN,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;GAC/D,gBAAgB;EAClB;CACF;AACF"}