@fabricorg/platform 1.9.0 → 1.10.1

package/dist/manifest/index.js

@@ -1,8 +1,220 @@
-export { MODULE_MANIFEST_VERSION, exportModuleManifest, exportModuleManifestBundle, isJsonSchemaExportableValidator, normalizeModuleManifest, normalizeModuleManifestBundle } from '../chunk-PDN5DOLQ.js';
-import '../chunk-WNZP53GI.js';
-import '../chunk-ZAEVQSB5.js';
-import '../chunk-MLBALEUR.js';
-import '../chunk-LFE74IJX.js';
-import '../chunk-B5DOGDPG.js';
-//# sourceMappingURL=index.js.map
+import { assertSurfaceDeclaration } from "../discovery/index.js";
+import { getEventTypeName, getModuleDependencyNamespace, getObjectTypeName } from "../modules/index.js";
+//#region manifest/index.ts
+/**
+* Version of the module manifest contract. Bump when the serialized shape
+* changes in a way consumers must detect.
+*/
+const MODULE_MANIFEST_VERSION = 2;
+function normalizeModuleManifest(manifest) {
+	const version = manifest.manifestVersion;
+	if (version !== 1 && version !== 2) throw new Error(`Unsupported module manifest version: ${String(version)}`);
+	const views = "views" in manifest && Array.isArray(manifest.views) ? manifest.views : [];
+	if (Array.isArray(manifest.actions)) for (const [index, action] of manifest.actions.entries()) assertSurfaceDeclaration(action, `Module "${manifest.namespace}" action[${index}] "${action?.actionId ?? "unknown"}"`);
+	for (const [index, view] of views.entries()) assertSurfaceDeclaration(view, `Module "${manifest.namespace}" view[${index}] "${view?.name ?? "unknown"}"`);
+	return {
+		...manifest,
+		manifestVersion: 2,
+		views
+	};
+}
+function normalizeModuleManifestBundle(bundle) {
+	const version = bundle.manifestVersion;
+	if (version !== 1 && version !== 2) throw new Error(`Unsupported module manifest bundle version: ${String(version)}`);
+	return {
+		manifestVersion: 2,
+		modules: bundle.modules.map((manifest) => normalizeModuleManifest(manifest))
+	};
+}
+function isJsonSchemaExportableValidator(schema) {
+	return typeof schema.toJSONSchema === "function";
+}
+function isRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function exportDependency(dependency) {
+	const namespace = getModuleDependencyNamespace(dependency);
+	if (typeof dependency === "string") return { namespace };
+	const normalized = { namespace };
+	if (dependency.version !== void 0) normalized.version = dependency.version;
+	if (dependency.optional !== void 0) normalized.optional = dependency.optional;
+	return normalized;
+}
+function exportObjectType(objectType) {
+	if (typeof objectType === "string") return { type: objectType };
+	const normalized = { type: getObjectTypeName(objectType) };
+	if (objectType.displayName !== void 0) normalized.displayName = objectType.displayName;
+	if (objectType.idPrefix !== void 0) normalized.idPrefix = objectType.idPrefix;
+	if (objectType.schema !== void 0) normalized.schema = cloneJson(objectType.schema);
+	if (objectType.semantics !== void 0) normalized.semantics = cloneJson(objectType.semantics);
+	if (objectType.relations !== void 0) normalized.relations = objectType.relations.map((relation) => ({ ...relation }));
+	if (objectType.invariants !== void 0) normalized.invariants = objectType.invariants.map((invariant) => ({ ...invariant }));
+	return normalized;
+}
+function cloneJson(value) {
+	if (Array.isArray(value)) return value.map((item) => cloneJson(item));
+	if (value !== null && typeof value === "object") return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, cloneJson(child)]));
+	return value;
+}
+function exportEventType(eventType) {
+	if (typeof eventType === "string") return {
+		eventType,
+		schemaVersion: 1
+	};
+	const normalized = {
+		eventType: getEventTypeName(eventType),
+		schemaVersion: eventType.schemaVersion
+	};
+	if (eventType.description !== void 0) normalized.description = eventType.description;
+	if (eventType.schema !== void 0) normalized.schema = cloneJson(eventType.schema);
+	return normalized;
+}
+function exportAction(action) {
+	assertSurfaceDeclaration(action, `Action "${action?.actionId ?? "unknown"}"`);
+	const manifest = {
+		actionId: action.actionId,
+		version: action.version,
+		kind: action.kind ?? "atomic",
+		idempotent: action.idempotent,
+		mutatesDomain: action.mutatesDomain,
+		emitsEvents: [...action.emitsEvents]
+	};
+	if (action.surface !== void 0) manifest.surface = action.surface;
+	if (action.surfaceReason !== void 0) manifest.surfaceReason = action.surfaceReason;
+	if (action.policies !== void 0) manifest.policies = [...action.policies];
+	if (action.requiredRoles !== void 0) manifest.requiredRoles = [...action.requiredRoles];
+	if (action.requiredPermissions !== void 0) manifest.requiredPermissions = [...action.requiredPermissions];
+	if (action.eventPhase !== void 0) manifest.eventPhase = action.eventPhase;
+	if (action.execution !== void 0) manifest.execution = cloneJson(action.execution);
+	if (isJsonSchemaExportableValidator(action.schema)) try {
+		manifest.parameterSchema = action.schema.toJSONSchema();
+		manifest.parameterSchemaFormat = "json-schema";
+	} catch {}
+	if (action.resultSchema && isJsonSchemaExportableValidator(action.resultSchema)) try {
+		manifest.resultSchema = action.resultSchema.toJSONSchema();
+		manifest.resultSchemaFormat = "json-schema";
+	} catch {}
+	if (action.stateMachine !== void 0) {
+		const binding = { entityType: action.stateMachine.entityType };
+		if (typeof action.stateMachine.targetState === "string") binding.targetState = action.stateMachine.targetState;
+		manifest.stateMachine = binding;
+	}
+	if (action.adapterSteps !== void 0) manifest.adapterSteps = action.adapterSteps.map((step) => {
+		const exported = {
+			adapterType: step.adapterType,
+			operation: step.operation
+		};
+		if (step.retryPolicy !== void 0) exported.retryPolicy = { ...step.retryPolicy };
+		return exported;
+	});
+	return manifest;
+}
+function exportPolicy(policy) {
+	if (!isRecord(policy) || typeof policy.policyId !== "string") return;
+	if (typeof policy.evaluate === "function") {
+		const exported = {
+			type: "code",
+			policyId: policy.policyId,
+			version: typeof policy.version === "number" ? policy.version : 1
+		};
+		if (typeof policy.previewSafe === "boolean") exported.previewSafe = policy.previewSafe;
+		return exported;
+	}
+	if (typeof policy.kind === "string" && typeof policy.policyVersion === "number") {
+		const exported = {
+			type: "data",
+			policyId: policy.policyId,
+			policyVersion: policy.policyVersion,
+			kind: policy.kind
+		};
+		if (isRecord(policy.dataDefinition)) exported.dataDefinition = policy.dataDefinition;
+		if (typeof policy.codeEvaluatorPolicyId === "string") exported.codeEvaluatorPolicyId = policy.codeEvaluatorPolicyId;
+		if (isRecord(policy.fallback)) exported.fallback = policy.fallback;
+		return exported;
+	}
+}
+function exportStateMachine(machine) {
+	if (!isRecord(machine) || typeof machine.entityType !== "string" || !isRecord(machine.states) || !Array.isArray(machine.transitions)) return;
+	const definition = machine;
+	return {
+		entityType: definition.entityType,
+		states: Object.values(definition.states),
+		transitions: definition.transitions.map((transition) => ({
+			from: transition.from,
+			to: transition.to,
+			causedByAction: transition.causedByAction,
+			hasGuard: typeof transition.guard === "function"
+		}))
+	};
+}
+function exportView(view) {
+	assertSurfaceDeclaration(view, `View "${view?.name ?? "unknown"}"`);
+	const output = {
+		name: view.name,
+		version: view.version,
+		shape: cloneJson(view.shape),
+		consumes: view.consumes.map((consumption) => ({
+			eventType: consumption.eventType,
+			schemaVersions: [...consumption.schemaVersions]
+		})),
+		scope: view.scope,
+		snapshotVersion: view.snapshotVersion
+	};
+	if (view.surface !== void 0) output.surface = view.surface;
+	if (view.surfaceReason !== void 0) output.surfaceReason = view.surfaceReason;
+	if (view.parameterSchema !== void 0) output.parameterSchema = cloneJson(view.parameterSchema);
+	if (view.compatibleSnapshotVersions) output.compatibleSnapshotVersions = [...view.compatibleSnapshotVersions];
+	if (view.usage) output.usage = cloneJson(view.usage);
+	return output;
+}
+/**
+* Export a stable, JSON-serializable manifest of a module's ontology.
+*
+* This is a pure function of the module object: it does not read or mutate the
+* global module/action/policy/state-machine registries, and the module does
+* not need to be registered first. Declaration order is preserved everywhere
+* (nothing is sorted), so the same module object always produces a
+* byte-identical `JSON.stringify` result.
+*
+* The manifest contains definitions only — never raw parameter values,
+* secrets, or runtime data. Function fields are elided (`handler`,
+* policy `evaluate`, transition `guard` → `hasGuard`, dynamic `targetState`,
+* adapter `getInput`).
+*/
+function exportModuleManifest(module) {
+	const manifest = {
+		manifestVersion: 2,
+		namespace: module.namespace,
+		dependencies: (module.dependencies ?? []).map(exportDependency),
+		objectTypes: (module.objectTypes ?? []).map(exportObjectType),
+		subjectTypes: [...module.subjectTypes ?? []],
+		idPrefixes: (module.idPrefixes ?? []).map((registration) => ({
+			prefix: registration.prefix,
+			name: registration.name
+		})),
+		eventTypes: (module.eventTypes ?? []).map(exportEventType),
+		actions: (module.actions ?? []).map(exportAction),
+		policies: (module.policies ?? []).map(exportPolicy).filter((policy) => policy !== void 0),
+		stateMachines: (module.stateMachines ?? []).map(exportStateMachine).filter((machine) => machine !== void 0),
+		views: (module.views ?? []).map(exportView)
+	};
+	if (module.version !== void 0) manifest.version = module.version;
+	if (module.displayName !== void 0) manifest.displayName = module.displayName;
+	if (module.description !== void 0) manifest.description = module.description;
+	if (module.capability !== void 0) manifest.capability = cloneJson(module.capability);
+	return manifest;
+}
+/**
+* Export manifests for a set of modules, preserving the input order.
+* Like {@link exportModuleManifest}, this is pure and registry-free.
+*/
+function exportModuleManifestBundle(modules) {
+	return {
+		manifestVersion: 2,
+		modules: modules.map(exportModuleManifest)
+	};
+}
+//#endregion
+export { MODULE_MANIFEST_VERSION, exportModuleManifest, exportModuleManifestBundle, isJsonSchemaExportableValidator, normalizeModuleManifest, normalizeModuleManifestBundle };
+
 //# sourceMappingURL=index.js.map

package/dist/manifest/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"file":"index.js","names":[],"sources":["../../manifest/index.ts"],"sourcesContent":["import { assertSurfaceDeclaration, type SurfaceDeclaration } from \"../discovery\";\nimport type {\n\tActionExecutionContract,\n\tActionDefinition,\n\tAdapterStepRetryPolicy,\n\tSchemaValidator,\n} from \"../actions\";\nimport {\n\tgetEventTypeName,\n\tgetModuleDependencyNamespace,\n\tgetObjectTypeName,\n\ttype FabricModule,\n\ttype CapabilityMetadata,\n\ttype DeclarativeInvariant,\n\ttype ModuleDependency,\n\ttype ModuleDependencyInput,\n\ttype ObjectRelationDefinition,\n} from \"../modules\";\nimport type { JsonValue, PortableJsonSchema } from \"../objects\";\nimport type {\n\tDataPolicyDefinition,\n\tPolicyFallbackDefinition,\n\tPolicyKind,\n} from \"../policies\";\nimport type { StateDefinition, StateMachineDefinition } from \"../state-machines\";\nimport type { ViewContract } from \"../projections\";\n\n/**\n * Version of the module manifest contract. Bump when the serialized shape\n * changes in a way consumers must detect.\n */\nexport const MODULE_MANIFEST_VERSION = 2 as const;\n\nexport interface ModuleManifestObjectType {\n\ttype: string;\n\tdisplayName?: string;\n\tidPrefix?: string;\n\tschema?: PortableJsonSchema;\n\tsemantics?: Record<string, JsonValue>;\n\trelations?: ObjectRelationDefinition[];\n\tinvariants?: DeclarativeInvariant[];\n}\n\nexport interface ModuleManifestIdPrefix {\n\tprefix: string;\n\tname: string;\n}\n\nexport interface ModuleManifestEventType {\n\teventType: string;\n\tschemaVersion: number;\n\tdescription?: string;\n\tschema?: PortableJsonSchema;\n}\n\nexport interface ModuleManifestActionStateMachine {\n\tentityType: string;\n\t/** Present only when the binding declares a static target state. */\n\ttargetState?: string;\n}\n\nexport interface ModuleManifestAdapterStep {\n\tadapterType: string;\n\toperation: string;\n\tretryPolicy?: AdapterStepRetryPolicy;\n}\n\nexport interface ModuleManifestAction extends SurfaceDeclaration {\n\tactionId: string;\n\tversion: number;\n\tkind: \"atomic\" | \"saga\";\n\tidempotent: boolean;\n\tmutatesDomain: boolean;\n\temitsEvents: string[];\n\tpolicies?: string[];\n\trequiredRoles?: string[];\n\trequiredPermissions?: string[];\n\teventPhase?: \"before_adapters\" | \"after_adapters\";\n\texecution?: ActionExecutionContract;\n\t/**\n\t * JSON Schema for the action parameters, present only when the action's\n\t * `schema` validator implements {@link JsonSchemaExportableValidator}.\n\t */\n\tparameterSchema?: unknown;\n\tparameterSchemaFormat?: \"json-schema\";\n\tresultSchema?: unknown;\n\tresultSchemaFormat?: \"json-schema\";\n\tstateMachine?: ModuleManifestActionStateMachine;\n\tadapterSteps?: ModuleManifestAdapterStep[];\n}\n\nexport interface ModuleManifestCodePolicy {\n\ttype: \"code\";\n\tpolicyId: string;\n\tversion: number;\n\tpreviewSafe?: boolean;\n}\n\nexport interface ModuleManifestDataPolicy {\n\ttype: \"data\";\n\tpolicyId: string;\n\tpolicyVersion: number;\n\tkind: PolicyKind;\n\tdataDefinition?: DataPolicyDefinition;\n\tcodeEvaluatorPolicyId?: string;\n\tfallback?: PolicyFallbackDefinition;\n}\n\nexport type ModuleManifestPolicy = ModuleManifestCodePolicy | ModuleManifestDataPolicy;\n\nexport interface ModuleManifestStateMachineTransition {\n\tfrom: string;\n\tto: string;\n\tcausedByAction: string;\n\t/** `true` when the transition declares a guard function. The guard itself is never serialized. */\n\thasGuard: boolean;\n}\n\nexport interface ModuleManifestStateMachine {\n\tentityType: string;\n\t/** States in declaration order (`Object.values` order of the definition record). */\n\tstates: StateDefinition[];\n\ttransitions: ModuleManifestStateMachineTransition[];\n}\n\nexport interface ModuleManifestView extends SurfaceDeclaration {\n\tname: string;\n\tversion: string;\n\tshape: PortableJsonSchema;\n\tparameterSchema?: PortableJsonSchema;\n\tconsumes: Array<{ eventType: string; schemaVersions: number[] }>;\n\tscope: \"tenant-space\";\n\tsnapshotVersion: number;\n\tcompatibleSnapshotVersions?: number[];\n\tusage?: ViewContract[\"usage\"];\n}\n\n/**\n * Stable, JSON-serializable description of a {@link FabricModule}'s ontology:\n * object types, subject types, id prefixes, event types, actions, policies,\n * and state machines. Intended for downstream tooling (semantics exporters,\n * docs generators, tool generators) that cannot consume live module code.\n *\n * The manifest contains definitions only — never raw parameter values,\n * secrets, or runtime data. Function fields (`handler`, `evaluate`, `guard`,\n * dynamic `targetState`, adapter `getInput`) are never serialized.\n */\nexport interface ModuleManifest {\n\tmanifestVersion: typeof MODULE_MANIFEST_VERSION;\n\tnamespace: string;\n\tversion?: string;\n\tdisplayName?: string;\n\tdescription?: string;\n\tcapability?: CapabilityMetadata;\n\tdependencies: ModuleDependency[];\n\tobjectTypes: ModuleManifestObjectType[];\n\tsubjectTypes: string[];\n\tidPrefixes: ModuleManifestIdPrefix[];\n\teventTypes: ModuleManifestEventType[];\n\tactions: ModuleManifestAction[];\n\tpolicies: ModuleManifestPolicy[];\n\tstateMachines: ModuleManifestStateMachine[];\n\tviews: ModuleManifestView[];\n}\n\nexport interface ModuleManifestBundle {\n\tmanifestVersion: typeof MODULE_MANIFEST_VERSION;\n\t/** Manifests in the input module order. */\n\tmodules: ModuleManifest[];\n}\n\n/** Manifest v1 remains accepted by v2 readers; missing v2 fields normalize to absence. */\nexport type ModuleManifestObjectTypeV1 = Omit<\n\tModuleManifestObjectType,\n\t\"schema\" | \"semantics\" | \"relations\" | \"invariants\"\n>;\nexport type ModuleManifestActionV1 = Omit<\n\tModuleManifestAction,\n\t\"resultSchema\" | \"resultSchemaFormat\"\n>;\nexport type ModuleManifestV1 = Omit<\n\tModuleManifest,\n\t\"manifestVersion\" | \"objectTypes\" | \"actions\" | \"views\"\n> & {\n\tmanifestVersion: 1;\n\tobjectTypes: ModuleManifestObjectTypeV1[];\n\tactions: ModuleManifestActionV1[];\n};\nexport type ModuleManifestBundleV1 = Omit<ModuleManifestBundle, \"manifestVersion\" | \"modules\"> & {\n\tmanifestVersion: 1;\n\tmodules: ModuleManifestV1[];\n};\n\nexport function normalizeModuleManifest(\n\tmanifest: ModuleManifest | ModuleManifestV1,\n): ModuleManifest {\n\tconst version: number = manifest.manifestVersion;\n\tif (version !== 1 && version !== MODULE_MANIFEST_VERSION) {\n\t\tthrow new Error(`Unsupported module manifest version: ${String(version)}`);\n\t}\n\tconst views = \"views\" in manifest && Array.isArray(manifest.views) ? manifest.views : [];\n\t// Preserve the normalizer's legacy tolerance for absent/non-array fields.\n\tif (Array.isArray(manifest.actions))\n\t\tfor (const [index, action] of manifest.actions.entries())\n\t\t\tassertSurfaceDeclaration(action, `Module \"${manifest.namespace}\" action[${index}] \"${action?.actionId ?? \"unknown\"}\"`);\n\tfor (const [index, view] of views.entries())\n\t\tassertSurfaceDeclaration(view, `Module \"${manifest.namespace}\" view[${index}] \"${view?.name ?? \"unknown\"}\"`);\n\treturn {\n\t\t...manifest,\n\t\tmanifestVersion: MODULE_MANIFEST_VERSION,\n\t\tviews,\n\t};\n}\n\nexport function normalizeModuleManifestBundle(\n\tbundle: ModuleManifestBundle | ModuleManifestBundleV1,\n): ModuleManifestBundle {\n\tconst version: number = bundle.manifestVersion;\n\tif (version !== 1 && version !== MODULE_MANIFEST_VERSION) {\n\t\tthrow new Error(`Unsupported module manifest bundle version: ${String(version)}`);\n\t}\n\treturn {\n\t\tmanifestVersion: MODULE_MANIFEST_VERSION,\n\t\tmodules: bundle.modules.map((manifest) => normalizeModuleManifest(manifest)),\n\t};\n}\n\n/**\n * A {@link SchemaValidator} that can also export its parameter schema as JSON\n * Schema (for example a Zod 4 schema via `z.toJSONSchema`). Keeps the platform\n * zero-dependency while letting schema-bearing actions flow into manifests.\n */\nexport interface JsonSchemaExportableValidator extends SchemaValidator {\n\ttoJSONSchema(): Record<string, unknown>;\n}\n\nexport function isJsonSchemaExportableValidator(\n\tschema: SchemaValidator,\n): schema is JsonSchemaExportableValidator {\n\treturn (\n\t\ttypeof (schema as Partial<JsonSchemaExportableValidator>).toJSONSchema === \"function\"\n\t);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction exportDependency(dependency: ModuleDependencyInput): ModuleDependency {\n\tconst namespace = getModuleDependencyNamespace(dependency);\n\tif (typeof dependency === \"string\") {\n\t\treturn { namespace };\n\t}\n\tconst normalized: ModuleDependency = { namespace };\n\tif (dependency.version !== undefined) normalized.version = dependency.version;\n\tif (dependency.optional !== undefined) normalized.optional = dependency.optional;\n\treturn normalized;\n}\n\nfunction exportObjectType(\n\tobjectType: NonNullable<FabricModule[\"objectTypes\"]>[number],\n): ModuleManifestObjectType {\n\tif (typeof objectType === \"string\") {\n\t\treturn { type: objectType };\n\t}\n\tconst normalized: ModuleManifestObjectType = { type: getObjectTypeName(objectType) };\n\tif (objectType.displayName !== undefined) normalized.displayName = objectType.displayName;\n\tif (objectType.idPrefix !== undefined) normalized.idPrefix = objectType.idPrefix;\n\tif (objectType.schema !== undefined) normalized.schema = cloneJson(objectType.schema);\n\tif (objectType.semantics !== undefined) normalized.semantics = cloneJson(objectType.semantics);\n\tif (objectType.relations !== undefined) {\n\t\tnormalized.relations = objectType.relations.map((relation) => ({ ...relation }));\n\t}\n\tif (objectType.invariants !== undefined) {\n\t\tnormalized.invariants = objectType.invariants.map((invariant) => ({ ...invariant }));\n\t}\n\treturn normalized;\n}\n\nfunction cloneJson<T>(value: T): T {\n\tif (Array.isArray(value)) return value.map((item) => cloneJson(item)) as T;\n\tif (value !== null && typeof value === \"object\") {\n\t\treturn Object.fromEntries(\n\t\t\tObject.entries(value as Record<string, unknown>).map(([key, child]) => [key, cloneJson(child)]),\n\t\t) as T;\n\t}\n\treturn value;\n}\n\nfunction exportEventType(\n\teventType: NonNullable<FabricModule[\"eventTypes\"]>[number],\n): ModuleManifestEventType {\n\tif (typeof eventType === \"string\") {\n\t\t// String registrations carry no explicit schema version; the events\n\t\t// registry treats the bare name as the initial version of the type.\n\t\treturn { eventType, schemaVersion: 1 };\n\t}\n\tconst normalized: ModuleManifestEventType = {\n\t\teventType: getEventTypeName(eventType),\n\t\tschemaVersion: eventType.schemaVersion,\n\t};\n\tif (eventType.description !== undefined) normalized.description = eventType.description;\n\tif (eventType.schema !== undefined) normalized.schema = cloneJson(eventType.schema);\n\treturn normalized;\n}\n\nfunction exportAction(action: ActionDefinition): ModuleManifestAction {\n\tassertSurfaceDeclaration(action, `Action \"${action?.actionId ?? \"unknown\"}\"`);\n\tconst manifest: ModuleManifestAction = {\n\t\tactionId: action.actionId,\n\t\tversion: action.version,\n\t\tkind: action.kind ?? \"atomic\",\n\t\tidempotent: action.idempotent,\n\t\tmutatesDomain: action.mutatesDomain,\n\t\temitsEvents: [...action.emitsEvents],\n\t};\n\n\tif (action.surface !== undefined) manifest.surface = action.surface;\n\tif (action.surfaceReason !== undefined) manifest.surfaceReason = action.surfaceReason;\n\tif (action.policies !== undefined) manifest.policies = [...action.policies];\n\tif (action.requiredRoles !== undefined) manifest.requiredRoles = [...action.requiredRoles];\n\tif (action.requiredPermissions !== undefined) {\n\t\tmanifest.requiredPermissions = [...action.requiredPermissions];\n\t}\n\tif (action.eventPhase !== undefined) manifest.eventPhase = action.eventPhase;\n\tif (action.execution !== undefined) manifest.execution = cloneJson(action.execution);\n\n\tif (isJsonSchemaExportableValidator(action.schema)) {\n\t\ttry {\n\t\t\tmanifest.parameterSchema = action.schema.toJSONSchema();\n\t\t\tmanifest.parameterSchemaFormat = \"json-schema\";\n\t\t} catch {\n\t\t\t// Runtime-valid schemas that cannot be represented portably remain executable;\n\t\t\t// build-time consumers see the schema as unavailable rather than crashing export.\n\t\t}\n\t}\n\tif (action.resultSchema && isJsonSchemaExportableValidator(action.resultSchema)) {\n\t\ttry {\n\t\t\tmanifest.resultSchema = action.resultSchema.toJSONSchema();\n\t\t\tmanifest.resultSchemaFormat = \"json-schema\";\n\t\t} catch {\n\t\t\t// See parameter-schema behavior above.\n\t\t}\n\t}\n\n\tif (action.stateMachine !== undefined) {\n\t\tconst binding: ModuleManifestActionStateMachine = {\n\t\t\tentityType: action.stateMachine.entityType,\n\t\t};\n\t\tif (typeof action.stateMachine.targetState === \"string\") {\n\t\t\tbinding.targetState = action.stateMachine.targetState;\n\t\t}\n\t\tmanifest.stateMachine = binding;\n\t}\n\n\tif (action.adapterSteps !== undefined) {\n\t\tmanifest.adapterSteps = action.adapterSteps.map((step) => {\n\t\t\tconst exported: ModuleManifestAdapterStep = {\n\t\t\t\tadapterType: step.adapterType,\n\t\t\t\toperation: step.operation,\n\t\t\t};\n\t\t\tif (step.retryPolicy !== undefined) exported.retryPolicy = { ...step.retryPolicy };\n\t\t\treturn exported;\n\t\t});\n\t}\n\n\treturn manifest;\n}\n\nfunction exportPolicy(policy: unknown): ModuleManifestPolicy | undefined {\n\tif (!isRecord(policy) || typeof policy.policyId !== \"string\") {\n\t\treturn undefined;\n\t}\n\n\t// Code evaluator: identified by its `evaluate` function (never serialized).\n\tif (typeof policy.evaluate === \"function\") {\n\t\tconst exported: ModuleManifestCodePolicy = {\n\t\t\ttype: \"code\",\n\t\t\tpolicyId: policy.policyId,\n\t\t\tversion: typeof policy.version === \"number\" ? policy.version : 1,\n\t\t};\n\t\tif (typeof policy.previewSafe === \"boolean\") exported.previewSafe = policy.previewSafe;\n\t\treturn exported;\n\t}\n\n\t// Declarative runtime policy definition: pure data, serialized as-is.\n\tif (typeof policy.kind === \"string\" && typeof policy.policyVersion === \"number\") {\n\t\tconst exported: ModuleManifestDataPolicy = {\n\t\t\ttype: \"data\",\n\t\t\tpolicyId: policy.policyId,\n\t\t\tpolicyVersion: policy.policyVersion,\n\t\t\tkind: policy.kind as PolicyKind,\n\t\t};\n\t\tif (isRecord(policy.dataDefinition)) {\n\t\t\texported.dataDefinition = policy.dataDefinition as unknown as DataPolicyDefinition;\n\t\t}\n\t\tif (typeof policy.codeEvaluatorPolicyId === \"string\") {\n\t\t\texported.codeEvaluatorPolicyId = policy.codeEvaluatorPolicyId;\n\t\t}\n\t\tif (isRecord(policy.fallback)) {\n\t\t\texported.fallback = policy.fallback as unknown as PolicyFallbackDefinition;\n\t\t}\n\t\treturn exported;\n\t}\n\n\t// Unknown policy shape: omit rather than guess.\n\treturn undefined;\n}\n\nfunction exportStateMachine(machine: unknown): ModuleManifestStateMachine | undefined {\n\tif (\n\t\t!isRecord(machine) ||\n\t\ttypeof machine.entityType !== \"string\" ||\n\t\t!isRecord(machine.states) ||\n\t\t!Array.isArray(machine.transitions)\n\t) {\n\t\treturn undefined;\n\t}\n\n\tconst definition = machine as unknown as StateMachineDefinition;\n\treturn {\n\t\tentityType: definition.entityType,\n\t\tstates: Object.values(definition.states),\n\t\ttransitions: definition.transitions.map((transition) => ({\n\t\t\tfrom: transition.from,\n\t\t\tto: transition.to,\n\t\t\tcausedByAction: transition.causedByAction,\n\t\t\thasGuard: typeof transition.guard === \"function\",\n\t\t})),\n\t};\n}\n\nfunction exportView(view: ViewContract): ModuleManifestView {\n\tassertSurfaceDeclaration(view, `View \"${view?.name ?? \"unknown\"}\"`);\n\tconst output: ModuleManifestView = {\n\t\tname: view.name,\n\t\tversion: view.version,\n\t\tshape: cloneJson(view.shape),\n\t\tconsumes: view.consumes.map((consumption) => ({\n\t\t\teventType: consumption.eventType,\n\t\t\tschemaVersions: [...consumption.schemaVersions],\n\t\t})),\n\t\tscope: view.scope,\n\t\tsnapshotVersion: view.snapshotVersion,\n\t};\n\tif (view.surface !== undefined) output.surface = view.surface;\n\tif (view.surfaceReason !== undefined) output.surfaceReason = view.surfaceReason;\n\tif (view.parameterSchema !== undefined) output.parameterSchema = cloneJson(view.parameterSchema);\n\tif (view.compatibleSnapshotVersions) output.compatibleSnapshotVersions = [...view.compatibleSnapshotVersions];\n\tif (view.usage) output.usage = cloneJson(view.usage);\n\treturn output;\n}\n\n/**\n * Export a stable, JSON-serializable manifest of a module's ontology.\n *\n * This is a pure function of the module object: it does not read or mutate the\n * global module/action/policy/state-machine registries, and the module does\n * not need to be registered first. Declaration order is preserved everywhere\n * (nothing is sorted), so the same module object always produces a\n * byte-identical `JSON.stringify` result.\n *\n * The manifest contains definitions only — never raw parameter values,\n * secrets, or runtime data. Function fields are elided (`handler`,\n * policy `evaluate`, transition `guard` → `hasGuard`, dynamic `targetState`,\n * adapter `getInput`).\n */\nexport function exportModuleManifest(module: FabricModule<unknown>): ModuleManifest {\n\tconst manifest: ModuleManifest = {\n\t\tmanifestVersion: MODULE_MANIFEST_VERSION,\n\t\tnamespace: module.namespace,\n\t\tdependencies: (module.dependencies ?? []).map(exportDependency),\n\t\tobjectTypes: (module.objectTypes ?? []).map(exportObjectType),\n\t\tsubjectTypes: [...(module.subjectTypes ?? [])],\n\t\tidPrefixes: (module.idPrefixes ?? []).map((registration) => ({\n\t\t\tprefix: registration.prefix,\n\t\t\tname: registration.name,\n\t\t})),\n\t\teventTypes: (module.eventTypes ?? []).map(exportEventType),\n\t\tactions: (module.actions ?? []).map(exportAction),\n\t\tpolicies: (module.policies ?? [])\n\t\t\t.map(exportPolicy)\n\t\t\t.filter((policy): policy is ModuleManifestPolicy => policy !== undefined),\n\t\tstateMachines: (module.stateMachines ?? [])\n\t\t\t.map(exportStateMachine)\n\t\t\t.filter((machine): machine is ModuleManifestStateMachine => machine !== undefined),\n\t\tviews: (module.views ?? []).map(exportView),\n\t};\n\n\tif (module.version !== undefined) manifest.version = module.version;\n\tif (module.displayName !== undefined) manifest.displayName = module.displayName;\n\tif (module.description !== undefined) manifest.description = module.description;\n\tif (module.capability !== undefined) manifest.capability = cloneJson(module.capability);\n\n\treturn manifest;\n}\n\n/**\n * Export manifests for a set of modules, preserving the input order.\n * Like {@link exportModuleManifest}, this is pure and registry-free.\n */\nexport function exportModuleManifestBundle(\n\tmodules: FabricModule<unknown>[],\n): ModuleManifestBundle {\n\treturn {\n\t\tmanifestVersion: MODULE_MANIFEST_VERSION,\n\t\tmodules: modules.map(exportModuleManifest),\n\t};\n}\n"],"mappings":"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"}

package/dist/modules/index.cjs

@@ -1,44 +1,283 @@
-'use strict';
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_events_index = require("../events/index.cjs");
+const require_discovery_index = require("../discovery/index.cjs");
+const require_objects_index = require("../objects/index.cjs");
+const require_projections_index = require("../projections/index.cjs");
+//#region modules/index.ts
+function getModuleDependencyNamespace(dependency) {
+	return typeof dependency === "string" ? dependency : dependency.namespace;
+}
+function getObjectTypeName(objectType) {
+	return typeof objectType === "string" ? objectType : objectType.type;
+}
+function getEventTypeName(eventType) {
+	return typeof eventType === "string" ? eventType : eventType.eventType;
+}
+function validateModuleNamespace(namespace) {
+	if (!namespace) throw new Error("Module namespace cannot be empty");
+	if (!/^[a-z][a-z0-9-]*$/.test(namespace)) throw new Error(`Invalid module namespace: "${namespace}". Must be lowercase letters, numbers, and hyphens only.`);
+}
+function createModuleRegistry(modules = []) {
+	const orderedModules = validateAndOrderFabricModules(modules);
+	const registered = new Map(orderedModules.map((module) => [module.namespace, module]));
+	const actions = new Map(orderedModules.flatMap((module) => (module.actions ?? []).map((action) => [action.actionId, action])));
+	const policies = new Map(orderedModules.flatMap((module) => (module.policies ?? []).map((policy) => {
+		const evaluator = policy;
+		return [evaluator.policyId, evaluator];
+	})));
+	const machines = new Map(orderedModules.flatMap((module) => (module.stateMachines ?? []).map((machine) => {
+		const definition = machine;
+		return [definition.entityType, definition];
+	})));
+	const views = new Map(orderedModules.flatMap((module) => (module.views ?? []).map((view) => [require_projections_index.viewContractKey(view), view])));
+	return {
+		modules: registered,
+		orderedModules,
+		resolveAction: (actionId) => actions.get(actionId),
+		resolvePolicy: (policyId) => policies.get(policyId),
+		resolveStateMachine: (entityType) => machines.get(entityType),
+		resolveView: (name, version) => views.get(`${name}@${version}`)
+	};
+}
+function validateIdentifierList(values, label, namespace) {
+	for (const value of values ?? []) if (!value) throw new Error(`Module "${namespace}" has an empty ${label} entry.`);
+}
+function assertJsonValue(value, path) {
+	if (value === null || typeof value === "string" || typeof value === "boolean") return;
+	if (typeof value === "number" && Number.isFinite(value)) return;
+	if (Array.isArray(value)) {
+		value.forEach((item, index) => assertJsonValue(item, `${path}[${index}]`));
+		return;
+	}
+	if (typeof value === "object") {
+		for (const [key, child] of Object.entries(value)) assertJsonValue(child, `${path}.${key}`);
+		return;
+	}
+	throw new Error(`${path} must contain JSON-serializable values.`);
+}
+function qualifiedObjectType(namespace, type) {
+	return `${namespace}.${type}`;
+}
+function validateObjectDefinition(objectType, namespace, context) {
+	if (typeof objectType === "string") return;
+	if (objectType.schema !== void 0) require_objects_index.assertPortableJsonSchema(objectType.schema, `Module "${namespace}" object "${objectType.type}" schema`);
+	if (objectType.semantics !== void 0) assertJsonValue(objectType.semantics, `Module "${namespace}" object "${objectType.type}" semantics`);
+	const relationNames = /* @__PURE__ */ new Set();
+	for (const relation of objectType.relations ?? []) {
+		if (!/^[a-z][a-zA-Z0-9]*$/.test(relation.name)) throw new Error(`Module "${namespace}" object "${objectType.type}" has invalid relation name "${relation.name}".`);
+		if (relationNames.has(relation.name)) throw new Error(`Module "${namespace}" object "${objectType.type}" has duplicate relation "${relation.name}".`);
+		relationNames.add(relation.name);
+		if (!/^[a-z][a-z0-9-]*\.[A-Z][a-zA-Z0-9]*$/.test(relation.target)) throw new Error(`Relation "${relation.name}" target "${relation.target}" must be module-qualified.`);
+		if (context.availableObjectTypes && !context.availableObjectTypes.has(relation.target)) throw new Error(`Relation "${relation.name}" targets missing object type "${relation.target}".`);
+		if (relation.required && relation.onTargetDelete === "set-null") throw new Error(`Required relation "${relation.name}" cannot use onTargetDelete "set-null".`);
+	}
+	const invariantIds = /* @__PURE__ */ new Set();
+	for (const invariant of objectType.invariants ?? []) {
+		if (!invariant.id.trim() || !invariant.description.trim()) throw new Error(`Module "${namespace}" object "${objectType.type}" has an invariant without an id or description.`);
+		if (invariantIds.has(invariant.id)) throw new Error(`Module "${namespace}" object "${objectType.type}" has duplicate invariant "${invariant.id}".`);
+		invariantIds.add(invariant.id);
+		if (invariant.required && !invariant.enforcementRef?.trim()) throw new Error(`Required invariant "${invariant.id}" must declare enforcementRef.`);
+	}
+}
+function validateCapabilityWorkflows(module, context) {
+	const workflows = module.capability?.workflows ?? [];
+	const actionsById = new Map((module.actions ?? []).map((action) => [action.actionId, action]));
+	const names = /* @__PURE__ */ new Set();
+	for (const workflow of workflows) {
+		if (!/^[A-Za-z][A-Za-z0-9_-]*$/.test(workflow.name)) throw new Error(`Module "${module.namespace}" declares invalid workflow name "${workflow.name}".`);
+		if (names.has(workflow.name)) throw new Error(`Module "${module.namespace}" declares duplicate workflow "${workflow.name}".`);
+		names.add(workflow.name);
+		if (!/^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)*$/.test(workflow.taskQueue)) throw new Error(`Module "${module.namespace}" workflow "${workflow.name}" declares invalid task queue "${workflow.taskQueue}".`);
+		if (workflow.startedBy !== void 0) {
+			if (!(context.plannedEventTypes?.has(workflow.startedBy) ?? (module.eventTypes ?? []).some((eventType) => getEventTypeName(eventType) === workflow.startedBy))) throw new Error(`Module "${module.namespace}" workflow "${workflow.name}" is started by unknown event type "${workflow.startedBy}".`);
+		}
+		const timerNames = /* @__PURE__ */ new Set();
+		for (const timer of workflow.timers ?? []) {
+			if (!timer.name.trim() || !timer.configKey.trim()) throw new Error(`Module "${module.namespace}" workflow "${workflow.name}" has a timer without a name or configKey.`);
+			if (timerNames.has(timer.name)) throw new Error(`Module "${module.namespace}" workflow "${workflow.name}" declares duplicate timer "${timer.name}".`);
+			timerNames.add(timer.name);
+		}
+		const steps = /* @__PURE__ */ new Set();
+		for (const compensation of workflow.compensations ?? []) {
+			if (!compensation.step.trim()) throw new Error(`Module "${module.namespace}" workflow "${workflow.name}" has a compensation without a step.`);
+			if (steps.has(compensation.step)) throw new Error(`Module "${module.namespace}" workflow "${workflow.name}" declares duplicate compensation for step "${compensation.step}".`);
+			steps.add(compensation.step);
+			const compensatingAction = actionsById.get(compensation.actionId);
+			if (!compensatingAction) throw new Error(`Module "${module.namespace}" workflow "${workflow.name}" compensates step "${compensation.step}" with unknown action "${compensation.actionId}".`);
+			if (!compensatingAction.idempotent || compensatingAction.execution?.idempotency === "prohibited") throw new Error(`Module "${module.namespace}" workflow "${workflow.name}" compensates step "${compensation.step}" with non-idempotent action "${compensation.actionId}"; a reversal must be safely repeatable.`);
+		}
+	}
+}
+function validateManifest(module, context = {}) {
+	validateModuleNamespace(module.namespace);
+	const dependencies = (module.dependencies ?? []).map(getModuleDependencyNamespace);
+	const objectTypes = (module.objectTypes ?? []).map(getObjectTypeName);
+	const eventTypes = (module.eventTypes ?? []).map(getEventTypeName);
+	if (module.capability) {
+		if (!module.capability.displayName.trim() || !module.capability.description.trim()) throw new Error(`Module "${module.namespace}" capability requires displayName and description.`);
+		for (const namespace of Object.keys(module.capability.extensions ?? {})) if (!/^[a-z][a-z0-9.-]*\.[a-z0-9.-]+\/v[1-9][0-9]*$/.test(namespace)) throw new Error(`Module "${module.namespace}" capability has invalid extension namespace "${namespace}".`);
+		for (const port of module.capability.requirements?.ports ?? []) if (!/^[a-z][a-z0-9-]*(?:\.[a-z0-9-]+)*$/.test(port.name)) throw new Error(`Module "${module.namespace}" capability has invalid port requirement "${port.name}".`);
+		validateCapabilityWorkflows(module, context);
+	}
+	for (const eventType of module.eventTypes ?? []) if (typeof eventType !== "string" && eventType.schema) require_objects_index.assertPortableJsonSchema(eventType.schema, `Event "${eventType.eventType}" schema`);
+	for (const action of module.actions ?? []) {
+		if (action.execution?.idempotency === "required" && !action.idempotent) throw new Error(`Action "${action.actionId}" requires idempotency but is not declared idempotent.`);
+		if (action.execution?.connectivity === "offline-capturable" && action.execution.idempotency === "prohibited") throw new Error(`Offline action "${action.actionId}" cannot prohibit idempotency.`);
+		if (action.execution?.completionDeadlineMs !== void 0 && !(typeof action.execution.completionDeadlineMs === "number" && action.execution.completionDeadlineMs > 0)) throw new Error(`Action "${action.actionId}" completionDeadlineMs must be a positive number of milliseconds.`);
+		if (action.execution?.completion === "immediate" && action.execution.completionDeadlineMs !== void 0) throw new Error(`Immediate action "${action.actionId}" cannot declare a completion deadline; nothing external completes it.`);
+	}
+	for (const view of module.views ?? []) if (view.usage?.collection?.filterSchema) require_objects_index.assertPortableJsonSchema(view.usage.collection.filterSchema, `View "${view.name}" filter schema`);
+	for (const dependency of dependencies) {
+		validateModuleNamespace(dependency);
+		if (dependency === module.namespace) throw new Error(`Module "${module.namespace}" cannot depend on itself.`);
+		if (context.availableNamespaces && !context.availableNamespaces.has(dependency)) throw new Error(`Module "${module.namespace}" depends on missing module "${dependency}".`);
+	}
+	validateIdentifierList(objectTypes, "objectTypes", module.namespace);
+	validateIdentifierList(module.subjectTypes, "subjectTypes", module.namespace);
+	validateIdentifierList(eventTypes, "eventTypes", module.namespace);
+	for (const objectType of objectTypes) if (!/^[A-Z][a-zA-Z0-9]*$/.test(objectType)) throw new Error(`Invalid object type: "${objectType}". Object types must be PascalCase alphanumeric.`);
+	for (const objectType of module.objectTypes ?? []) {
+		if (typeof objectType !== "string") for (const relation of objectType.relations ?? []) {
+			const targetNamespace = relation.target.slice(0, relation.target.indexOf("."));
+			if (targetNamespace !== module.namespace && !dependencies.includes(targetNamespace)) throw new Error(`Module "${module.namespace}" relation "${relation.name}" targets module "${targetNamespace}" without declaring it as a dependency.`);
+		}
+		validateObjectDefinition(objectType, module.namespace, context);
+	}
+	for (const action of module.actions ?? []) {
+		require_discovery_index.assertSurfaceDeclaration(action, `Action "${action?.actionId ?? "unknown"}"`);
+		let parameterSchema;
+		try {
+			parameterSchema = action.schema.toJSONSchema?.();
+		} catch {
+			parameterSchema = void 0;
+		}
+		if (parameterSchema !== void 0) require_objects_index.assertPortableJsonSchema(parameterSchema, `Action "${action.actionId}" parameters`);
+		let resultSchema;
+		try {
+			resultSchema = action.resultSchema?.toJSONSchema?.();
+		} catch {
+			resultSchema = void 0;
+		}
+		if (resultSchema !== void 0) require_objects_index.assertPortableJsonSchema(resultSchema, `Action "${action.actionId}" result`);
+		if (!/^[a-z][a-z0-9-]*\.[a-z][a-z0-9_]*$/.test(action.actionId)) throw new Error(`Invalid action ID: ${action.actionId}`);
+		if (action.namespace !== module.namespace) throw new Error(`Action "${action.actionId}" declares namespace "${action.namespace}" but is registered by module "${module.namespace}".`);
+		if (!action.actionId.startsWith(`${module.namespace}.`)) throw new Error(`Action "${action.actionId}" must start with module namespace "${module.namespace}."`);
+		if (action.mutatesDomain && action.emitsEvents.length === 0) throw new Error(`Action "${action.actionId}" mutates domain but emits no events. Every mutating action must emit at least one AssetEvent.`);
+		if (action.admitSubmission !== void 0 && typeof action.admitSubmission !== "function") throw new Error(`Action "${action.actionId}" declares admitSubmission that is not a function.`);
+	}
+	const viewKeys = /* @__PURE__ */ new Set();
+	for (const view of module.views ?? []) {
+		require_discovery_index.assertSurfaceDeclaration(view, `View "${view?.name ?? "unknown"}"`);
+		if (!view.name.startsWith(`${module.namespace}/`) || !/^[a-z][a-z0-9-]*\/[a-z][a-z0-9/_-]*$/.test(view.name)) throw new Error(`View "${view.name}" must start with module namespace "${module.namespace}/" and use lowercase path segments.`);
+		if (!view.version.trim()) throw new Error(`View "${view.name}" must declare a version.`);
+		const key = `${view.name}@${view.version}`;
+		if (viewKeys.has(key)) throw new Error(`Module "${module.namespace}" has duplicate view contract "${key}".`);
+		viewKeys.add(key);
+		require_objects_index.assertPortableJsonSchema(view.shape, `View "${key}" shape`);
+		if (view.parameterSchema !== void 0) require_objects_index.assertPortableJsonSchema(view.parameterSchema, `View "${key}" parameters`);
+		if (!Number.isInteger(view.snapshotVersion) || view.snapshotVersion < 1) throw new Error(`View "${key}" snapshotVersion must be a positive integer.`);
+		if ((view.compatibleSnapshotVersions?.some((version) => version !== view.snapshotVersion) ?? false) && !view.upgradeSnapshot) throw new Error(`View "${key}" declares older compatible snapshots but no upgradeSnapshot function.`);
+		for (const consumption of view.consumes) {
+			const isPlanned = context.plannedEventTypes?.has(consumption.eventType) ?? false;
+			const isModuleEvent = eventTypes.includes(consumption.eventType);
+			if (!isPlanned && !isModuleEvent) throw new Error(`View "${key}" consumes unknown event type "${consumption.eventType}".`);
+			if (consumption.schemaVersions.length === 0 || consumption.schemaVersions.some((version) => !Number.isInteger(version) || version < 1)) throw new Error(`View "${key}" must declare positive consumed schema versions for "${consumption.eventType}".`);
+		}
+	}
+}
+function sortModulesByDependency(modules, registeredNamespaces = /* @__PURE__ */ new Set()) {
+	const modulesByNamespace = /* @__PURE__ */ new Map();
+	for (const module of modules) {
+		validateModuleNamespace(module.namespace);
+		if (modulesByNamespace.has(module.namespace)) throw new Error(`Duplicate FabricModule namespace "${module.namespace}".`);
+		modulesByNamespace.set(module.namespace, module);
+	}
+	const sorted = [];
+	const visiting = /* @__PURE__ */ new Set();
+	const visited = /* @__PURE__ */ new Set();
+	function visit(module, path) {
+		if (visited.has(module.namespace)) return;
+		if (visiting.has(module.namespace)) throw new Error(`Cyclic Fabric module dependency detected: ${[...path, module.namespace].join(" -> ")}`);
+		visiting.add(module.namespace);
+		for (const dependency of (module.dependencies ?? []).map(getModuleDependencyNamespace)) {
+			const dependencyModule = modulesByNamespace.get(dependency);
+			if (!dependencyModule) {
+				if (registeredNamespaces.has(dependency)) continue;
+				throw new Error(`Module "${module.namespace}" depends on missing module "${dependency}".`);
+			}
+			visit(dependencyModule, [...path, module.namespace]);
+		}
+		visiting.delete(module.namespace);
+		visited.add(module.namespace);
+		sorted.push(module);
+	}
+	for (const module of modules) visit(module, []);
+	return sorted;
+}
+function assertAcyclicRelations(modules) {
+	const relationKinds = [
+		{
+			label: "owned containment",
+			include: (relation) => relation.semantics === "owned"
+		},
+		{
+			label: "cascade-delete",
+			include: (relation) => relation.onTargetDelete === "cascade"
+		},
+		{
+			label: "required-construction",
+			include: (relation) => relation.required === true
+		}
+	];
+	for (const kind of relationKinds) {
+		const edges = /* @__PURE__ */ new Map();
+		for (const module of modules) for (const objectType of module.objectTypes ?? []) {
+			if (typeof objectType === "string") continue;
+			const source = qualifiedObjectType(module.namespace, objectType.type);
+			edges.set(source, (objectType.relations ?? []).filter(kind.include).map((relation) => relation.target));
+		}
+		const visiting = /* @__PURE__ */ new Set();
+		const visited = /* @__PURE__ */ new Set();
+		const visit = (node, path) => {
+			if (visiting.has(node)) throw new Error(`${kind.label} relation cycle detected: ${[...path, node].join(" -> ")}`);
+			if (visited.has(node)) return;
+			visiting.add(node);
+			for (const target of edges.get(node) ?? []) visit(target, [...path, node]);
+			visiting.delete(node);
+			visited.add(node);
+		};
+		for (const node of edges.keys()) visit(node, []);
+	}
+}
+function validateAndOrderFabricModules(modules) {
+	const availableNamespaces = new Set(modules.map((module) => module.namespace));
+	const plannedEventTypes = new Set(modules.flatMap((module) => (module.eventTypes ?? []).map(getEventTypeName)));
+	for (const eventType of require_events_index.createEventContractRegistry().eventTypes()) plannedEventTypes.add(eventType);
+	const availableObjectTypes = /* @__PURE__ */ new Set([...modules.flatMap((module) => (module.objectTypes ?? []).map((objectType) => qualifiedObjectType(module.namespace, getObjectTypeName(objectType))))]);
+	for (const module of modules) validateManifest(module, {
+		availableNamespaces,
+		plannedEventTypes,
+		availableObjectTypes
+	});
+	assertAcyclicRelations(modules);
+	return sortModulesByDependency(modules);
+}
+/** @deprecated Use createModuleRegistry(); registration is now explicit and instance-scoped. */
+function registerFabricModules(modules) {
+	return validateAndOrderFabricModules(modules);
+}
+/** @deprecated Use createModuleRegistry([module]); registration is now explicit and instance-scoped. */
+function registerFabricModule(module) {
+	validateAndOrderFabricModules([module]);
+}
+//#endregion
+exports.createModuleRegistry = createModuleRegistry;
+exports.getEventTypeName = getEventTypeName;
+exports.getModuleDependencyNamespace = getModuleDependencyNamespace;
+exports.getObjectTypeName = getObjectTypeName;
+exports.registerFabricModule = registerFabricModule;
+exports.registerFabricModules = registerFabricModules;
+exports.validateAndOrderFabricModules = validateAndOrderFabricModules;
+exports.validateModuleNamespace = validateModuleNamespace;
 
-var chunkDBTAUI6C_cjs = require('../chunk-DBTAUI6C.cjs');
-require('../chunk-IFW43ELT.cjs');
-require('../chunk-SNTV45LH.cjs');
-require('../chunk-D4SWRBUH.cjs');
-require('../chunk-2AE6TMAX.cjs');
-
-
-
-Object.defineProperty(exports, "createModuleRegistry", {
-  enumerable: true,
-  get: function () { return chunkDBTAUI6C_cjs.createModuleRegistry; }
-});
-Object.defineProperty(exports, "getEventTypeName", {
-  enumerable: true,
-  get: function () { return chunkDBTAUI6C_cjs.getEventTypeName; }
-});
-Object.defineProperty(exports, "getModuleDependencyNamespace", {
-  enumerable: true,
-  get: function () { return chunkDBTAUI6C_cjs.getModuleDependencyNamespace; }
-});
-Object.defineProperty(exports, "getObjectTypeName", {
-  enumerable: true,
-  get: function () { return chunkDBTAUI6C_cjs.getObjectTypeName; }
-});
-Object.defineProperty(exports, "registerFabricModule", {
-  enumerable: true,
-  get: function () { return chunkDBTAUI6C_cjs.registerFabricModule; }
-});
-Object.defineProperty(exports, "registerFabricModules", {
-  enumerable: true,
-  get: function () { return chunkDBTAUI6C_cjs.registerFabricModules; }
-});
-Object.defineProperty(exports, "validateAndOrderFabricModules", {
-  enumerable: true,
-  get: function () { return chunkDBTAUI6C_cjs.validateAndOrderFabricModules; }
-});
-Object.defineProperty(exports, "validateModuleNamespace", {
-  enumerable: true,
-  get: function () { return chunkDBTAUI6C_cjs.validateModuleNamespace; }
-});
-//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map