@fabricorg/platform 0.1.2 → 0.2.0

package/dist/actions/index.cjs

@@ -0,0 +1,48 @@
+'use strict';
+
+var chunkKQEBNUZI_cjs = require('../chunk-KQEBNUZI.cjs');
+
+
+
+Object.defineProperty(exports, "ACTOR_TYPES", {
+  enumerable: true,
+  get: function () { return chunkKQEBNUZI_cjs.ACTOR_TYPES; }
+});
+Object.defineProperty(exports, "assertActionId", {
+  enumerable: true,
+  get: function () { return chunkKQEBNUZI_cjs.assertActionId; }
+});
+Object.defineProperty(exports, "assertActorType", {
+  enumerable: true,
+  get: function () { return chunkKQEBNUZI_cjs.assertActorType; }
+});
+Object.defineProperty(exports, "getRegisteredActionIds", {
+  enumerable: true,
+  get: function () { return chunkKQEBNUZI_cjs.getRegisteredActionIds; }
+});
+Object.defineProperty(exports, "isActorType", {
+  enumerable: true,
+  get: function () { return chunkKQEBNUZI_cjs.isActorType; }
+});
+Object.defineProperty(exports, "isRegisteredActionId", {
+  enumerable: true,
+  get: function () { return chunkKQEBNUZI_cjs.isRegisteredActionId; }
+});
+Object.defineProperty(exports, "registerAction", {
+  enumerable: true,
+  get: function () { return chunkKQEBNUZI_cjs.registerAction; }
+});
+Object.defineProperty(exports, "registerActionIfMissing", {
+  enumerable: true,
+  get: function () { return chunkKQEBNUZI_cjs.registerActionIfMissing; }
+});
+Object.defineProperty(exports, "resolveAction", {
+  enumerable: true,
+  get: function () { return chunkKQEBNUZI_cjs.resolveAction; }
+});
+Object.defineProperty(exports, "resolveRegisteredAction", {
+  enumerable: true,
+  get: function () { return chunkKQEBNUZI_cjs.resolveRegisteredAction; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/actions/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/actions/index.d.cts

@@ -0,0 +1,116 @@
+type ActionId = `${string}.${string}`;
+interface SchemaParseIssue {
+    path: PropertyKey[];
+    message: string;
+}
+type SchemaParseResult<T = unknown> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: {
+        issues: SchemaParseIssue[];
+    };
+};
+interface SchemaValidator<T = unknown> {
+    parse(input: unknown): T;
+    safeParse(input: unknown): SchemaParseResult<T>;
+}
+type ActorType = "natural_person" | "agent" | "system" | "service_account" | "external_system" | "integration";
+declare const ACTOR_TYPES: readonly ActorType[];
+declare function isActorType(value: string): value is ActorType;
+declare function assertActorType(value: string): asserts value is ActorType;
+type ActionStatus = "pending" | "running" | "completed" | "failed" | "blocked_by_policy" | "waiting_for_approval" | "validation_failed";
+interface FabricRuntimeServices {
+    readonly [serviceName: string]: unknown;
+}
+interface ActionContext<TDb = unknown> {
+    actionInvocationId: string;
+    tenantId: string;
+    spaceId: string;
+    actorId: string;
+    actorType: ActorType;
+    correlationId: string;
+    causationId?: string;
+    db: TDb;
+    services?: FabricRuntimeServices;
+}
+interface ActionResult {
+    success: boolean;
+    data?: Record<string, unknown>;
+    error?: string;
+}
+type ActionHandler<TDb = unknown> = (ctx: ActionContext<TDb>, params: unknown) => Promise<ActionResult>;
+interface AdapterStepRetryPolicy {
+    idempotent: boolean;
+    maxAttempts?: number;
+    initialDelayMs?: number;
+    backoffMultiplier?: number;
+    maxDelayMs?: number;
+}
+interface AdapterStep {
+    adapterType: string;
+    operation: string;
+    retryPolicy?: AdapterStepRetryPolicy;
+    getInput: (params: unknown, handlerResult: Record<string, unknown>) => Record<string, unknown> | undefined;
+}
+interface ActionStateMachineBinding {
+    entityType: string;
+    targetState: string | ((params: unknown) => string);
+    getEntityId: (params: unknown) => string | undefined;
+}
+interface ActionDefinition<TDb = unknown> {
+    actionId: ActionId;
+    namespace: string;
+    version: number;
+    schema: SchemaValidator;
+    handler?: ActionHandler<TDb>;
+    requiredRoles?: string[];
+    requiredPermissions?: string[];
+    policies?: `${string}.v${number}`[];
+    emitsEvents: string[];
+    idempotent: boolean;
+    mutatesDomain: boolean;
+    stateMachine?: ActionStateMachineBinding;
+    adapterSteps?: AdapterStep[];
+    /**
+     * If "saga", the action is a multi-step orchestration. The worker dispatches
+     * to a registered saga implementation instead of running `handler` directly.
+     */
+    kind?: "atomic" | "saga";
+}
+interface SagaContext {
+    actionInvocationId: string;
+    tenantId: string;
+    spaceId: string;
+    parameters: unknown;
+    sleep?: (delayMs: number) => Promise<void>;
+    query?: <T = unknown>(model: string, operation: string, args: unknown) => Promise<T>;
+}
+interface SagaChildActionInput {
+    suffix: string;
+    actionId: string;
+    parameters: Record<string, unknown>;
+}
+type SagaRunChild = (input: SagaChildActionInput) => Promise<Record<string, unknown>>;
+interface SagaCompletionEvent {
+    eventType: string;
+    subjectType: string;
+    subjectId: string;
+    payload: unknown;
+    eventSchemaVersion?: number;
+}
+interface SagaCompletion {
+    resultData: Record<string, unknown>;
+    event?: SagaCompletionEvent;
+}
+type SagaImplementation = (ctx: SagaContext, runChild: SagaRunChild) => Promise<SagaCompletion>;
+declare function assertActionId(actionId: string): asserts actionId is ActionId;
+declare function registerAction(definition: ActionDefinition): void;
+declare function resolveAction(actionId: ActionId): ActionDefinition | undefined;
+declare function isRegisteredActionId(actionId: string): actionId is ActionId;
+declare function resolveRegisteredAction(actionId: string): ActionDefinition | undefined;
+declare function getRegisteredActionIds(): ActionId[];
+declare function registerActionIfMissing(definition: ActionDefinition): void;
+
+export { ACTOR_TYPES, type ActionContext, type ActionDefinition, type ActionHandler, type ActionId, type ActionResult, type ActionStateMachineBinding, type ActionStatus, type ActorType, type AdapterStep, type AdapterStepRetryPolicy, type FabricRuntimeServices, type SagaChildActionInput, type SagaCompletion, type SagaCompletionEvent, type SagaContext, type SagaImplementation, type SagaRunChild, type SchemaParseIssue, type SchemaParseResult, type SchemaValidator, assertActionId, assertActorType, getRegisteredActionIds, isActorType, isRegisteredActionId, registerAction, registerActionIfMissing, resolveAction, resolveRegisteredAction };

package/dist/adapters/index.cjs

@@ -0,0 +1,28 @@
+'use strict';
+
+var chunkNPVIFZQV_cjs = require('../chunk-NPVIFZQV.cjs');
+
+
+
+Object.defineProperty(exports, "AdapterRegistry", {
+  enumerable: true,
+  get: function () { return chunkNPVIFZQV_cjs.AdapterRegistry; }
+});
+Object.defineProperty(exports, "MissingAdapterRegistrationError", {
+  enumerable: true,
+  get: function () { return chunkNPVIFZQV_cjs.MissingAdapterRegistrationError; }
+});
+Object.defineProperty(exports, "executeWithAdapterRetry", {
+  enumerable: true,
+  get: function () { return chunkNPVIFZQV_cjs.executeWithAdapterRetry; }
+});
+Object.defineProperty(exports, "getRetryDelayMs", {
+  enumerable: true,
+  get: function () { return chunkNPVIFZQV_cjs.getRetryDelayMs; }
+});
+Object.defineProperty(exports, "resolveAdapterRetryPolicy", {
+  enumerable: true,
+  get: function () { return chunkNPVIFZQV_cjs.resolveAdapterRetryPolicy; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/adapters/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/adapters/index.d.cts

@@ -0,0 +1,83 @@
+interface AdapterExecutionContext {
+    tenantId: string;
+    spaceId: string;
+    actionInvocationId: string;
+    adapterInvocationId: string;
+    correlationId: string;
+    causationId?: string;
+    attempt: number;
+    maxAttempts: number;
+}
+interface AdapterExecutionResult {
+    success: boolean;
+    correlationId?: string;
+    error?: string;
+}
+type AdapterExecutor = (input: Record<string, unknown>, context: AdapterExecutionContext) => Promise<AdapterExecutionResult>;
+interface AdapterRetryPolicy {
+    /** External calls must explicitly opt into retry by being idempotent. */
+    idempotent: boolean;
+    /** Total attempts including the first call. Non-idempotent policies are forced to 1. */
+    maxAttempts?: number;
+    /** First backoff delay in milliseconds. */
+    initialDelayMs?: number;
+    /** Exponential multiplier applied after each failed attempt. */
+    backoffMultiplier?: number;
+    /** Upper bound for any single retry delay in milliseconds. */
+    maxDelayMs?: number;
+}
+interface ResolvedAdapterRetryPolicy {
+    idempotent: boolean;
+    maxAttempts: number;
+    initialDelayMs: number;
+    backoffMultiplier: number;
+    maxDelayMs: number;
+}
+interface AdapterCircuitBreakerConfig {
+    mode: "monitor" | "enforce";
+    failureThreshold: number;
+    windowMs: number;
+    cooldownMs: number;
+    minimumSamples?: number;
+}
+interface AdapterImplementation {
+    adapterType: string;
+    operation: string;
+    vendor: string;
+    /** Whether this adapter operation can be safely retried by default. */
+    idempotent: boolean;
+    retryPolicy?: AdapterRetryPolicy;
+    /** Defaults to monitor-only; enforce mode must be explicitly configured. */
+    circuitBreaker?: AdapterCircuitBreakerConfig;
+    execute: AdapterExecutor;
+}
+interface AdapterAttempt<T> {
+    attempt: number;
+    result?: T;
+    error?: string;
+    willRetry: boolean;
+    nextDelayMs?: number;
+}
+interface ExecuteWithRetryOptions<T> {
+    policy?: AdapterRetryPolicy;
+    defaultIdempotent: boolean;
+    execute: (attempt: number, maxAttempts: number) => Promise<T>;
+    isSuccessful: (result: T) => boolean;
+    getError: (result: T) => string | undefined;
+    sleep?: (delayMs: number) => Promise<void>;
+    onAttempt?: (attempt: AdapterAttempt<T>) => Promise<void> | void;
+}
+declare class MissingAdapterRegistrationError extends Error {
+    constructor(adapterType: string, operation: string);
+}
+declare class AdapterRegistry {
+    private readonly adapters;
+    register(adapter: AdapterImplementation): void;
+    resolve(adapterType: string, operation: string): AdapterImplementation | undefined;
+    require(adapterType: string, operation: string): AdapterImplementation;
+}
+declare function resolveAdapterRetryPolicy(policy: AdapterRetryPolicy | undefined, defaultIdempotent: boolean): ResolvedAdapterRetryPolicy;
+declare function getRetryDelayMs(attempt: number, policy: ResolvedAdapterRetryPolicy): number;
+declare function executeWithAdapterRetry<T>(options: ExecuteWithRetryOptions<T>): Promise<T>;
+
+export { type AdapterAttempt, type AdapterCircuitBreakerConfig, type AdapterExecutionContext, type AdapterExecutionResult, type AdapterExecutor, type AdapterImplementation, AdapterRegistry, type AdapterRetryPolicy, type ExecuteWithRetryOptions, MissingAdapterRegistrationError, type ResolvedAdapterRetryPolicy, executeWithAdapterRetry, getRetryDelayMs, resolveAdapterRetryPolicy };

package/dist/chunk-7KJHGAZY.cjs

@@ -0,0 +1,99 @@
+'use strict';
+
+var assert = require('assert');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var assert__default = /*#__PURE__*/_interopDefault(assert);
+
+// displays/index.ts
+var registry = /* @__PURE__ */ new Map();
+function registerDisplayRenderer(eventType, renderer) {
+  registry.set(eventType, renderer);
+}
+function resolveDisplayRenderer(eventType) {
+  return registry.get(eventType);
+}
+function denormalizeDisplaySnapshot(payload) {
+  if (payload !== null && typeof payload === "object" && "_displaySnapshot" in payload && payload._displaySnapshot !== null && typeof payload._displaySnapshot === "object" && "title" in payload._displaySnapshot) {
+    return payload._displaySnapshot;
+  }
+  if (payload !== null && typeof payload === "object" && "_projectionSnapshot" in payload && payload._projectionSnapshot !== null && typeof payload._projectionSnapshot === "object" && "display" in payload._projectionSnapshot && payload._projectionSnapshot.display !== null && typeof payload._projectionSnapshot.display === "object" && "title" in payload._projectionSnapshot.display) {
+    const snapshot = payload._projectionSnapshot;
+    return {
+      ...snapshot.display,
+      _cachedDisplay: {
+        source: "projection_snapshot",
+        cursor: snapshot.eventCursor,
+        checksum: snapshot.checksum,
+        generatedAt: snapshot.updatedAt
+      }
+    };
+  }
+  return void 0;
+}
+async function renderEventDisplay(eventType, payload, ctx) {
+  const snapshot = denormalizeDisplaySnapshot(payload);
+  if (snapshot) {
+    return snapshot;
+  }
+  const renderer = resolveDisplayRenderer(eventType);
+  if (!renderer) {
+    return {
+      title: eventType,
+      subtitle: "No display renderer registered for this event type."
+    };
+  }
+  return await renderer(payload, ctx);
+}
+async function _runInlineTests() {
+  const testEventType = "__TestEvent__";
+  registerDisplayRenderer(testEventType, (payload) => ({
+    title: `Test: ${payload.name}`,
+    subtitle: "registered renderer"
+  }));
+  const renderer = resolveDisplayRenderer(testEventType);
+  assert__default.default.ok(renderer, "resolveDisplayRenderer should return the registered renderer");
+  const result = await renderEventDisplay(testEventType, { name: "Alice" });
+  assert__default.default.strictEqual(result.title, "Test: Alice");
+  assert__default.default.strictEqual(result.subtitle, "registered renderer");
+  const snapshot = {
+    title: "Snapshot Title",
+    subtitle: "snapshot subtitle",
+    stateLabel: "archived",
+    primaryFacts: [{ label: "ID", value: "123" }]
+  };
+  const snapshotResult = await renderEventDisplay(testEventType, {
+    _displaySnapshot: snapshot
+  });
+  assert__default.default.deepStrictEqual(snapshotResult, snapshot);
+  const fallback = await renderEventDisplay("__UnknownEvent__", {});
+  assert__default.default.strictEqual(fallback.title, "__UnknownEvent__");
+  assert__default.default.strictEqual(fallback.subtitle, "No display renderer registered for this event type.");
+  registerDisplayRenderer("__AsyncEvent__", async (_payload, ctx) => {
+    return {
+      title: `Async: ${ctx?.tenantId ?? "no-ctx"}`
+    };
+  });
+  const asyncResult = await renderEventDisplay(
+    "__AsyncEvent__",
+    {},
+    { tenantId: "t-1", spaceId: "s-1", db: {} }
+  );
+  assert__default.default.strictEqual(asyncResult.title, "Async: t-1");
+  console.log("\u2705 display engine inline tests passed");
+}
+if ((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-7KJHGAZY.cjs', document.baseURI).href)) === `file://${process.argv[1]}`) {
+  _runInlineTests().catch((err) => {
+    console.error("\u274C display engine inline tests failed", err);
+    process.exit(1);
+  });
+}
+
+exports.denormalizeDisplaySnapshot = denormalizeDisplaySnapshot;
+exports.registerDisplayRenderer = registerDisplayRenderer;
+exports.renderEventDisplay = renderEventDisplay;
+exports.resolveDisplayRenderer = resolveDisplayRenderer;
+//# sourceMappingURL=chunk-7KJHGAZY.cjs.map
+//# sourceMappingURL=chunk-7KJHGAZY.cjs.map

package/dist/chunk-7KJHGAZY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../displays/index.ts"],"names":["assert"],"mappings":"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","file":"chunk-7KJHGAZY.cjs","sourcesContent":["import assert from \"node:assert\";\n\nexport interface DisplayDescriptor {\n\ttitle: string;\n\tsubtitle?: string;\n\tstateLabel?: string;\n\tprimaryFacts?: Array<{ label: string; value: string }>;\n}\n\nexport interface CachedDisplayDescriptor extends DisplayDescriptor {\n\t_cachedDisplay?: {\n\t\tsource: \"event_payload\" | \"projection_snapshot\";\n\t\tcursor?: string | null;\n\t\tchecksum?: string;\n\t\tgeneratedAt?: string;\n\t};\n}\n\nexport type DisplayDatabaseClient = any;\n\nexport interface DisplayContext<TDb = DisplayDatabaseClient> {\n\ttenantId: string;\n\tspaceId: string;\n\tdb: TDb;\n}\n\nexport type DisplayRenderer = (\n\tpayload: unknown,\n\tctx?: DisplayContext,\n) => DisplayDescriptor | Promise<DisplayDescriptor>;\n\nexport interface DisplayRendererRegistration {\n\teventType: string;\n\trenderer: DisplayRenderer;\n}\n\nconst registry = new Map<string, DisplayRenderer>();\n\nexport function registerDisplayRenderer(eventType: string, renderer: DisplayRenderer): void {\n\tregistry.set(eventType, renderer);\n}\n\nexport function resolveDisplayRenderer(eventType: string): DisplayRenderer | undefined {\n\treturn registry.get(eventType);\n}\n\nexport function denormalizeDisplaySnapshot(payload: unknown): CachedDisplayDescriptor | undefined {\n\tif (\n\t\tpayload !== null &&\n\t\ttypeof payload === \"object\" &&\n\t\t\"_displaySnapshot\" in payload &&\n\t\tpayload._displaySnapshot !== null &&\n\t\ttypeof payload._displaySnapshot === \"object\" &&\n\t\t\"title\" in payload._displaySnapshot\n\t) {\n\t\treturn payload._displaySnapshot as CachedDisplayDescriptor;\n\t}\n\n\tif (\n\t\tpayload !== null &&\n\t\ttypeof payload === \"object\" &&\n\t\t\"_projectionSnapshot\" in payload &&\n\t\tpayload._projectionSnapshot !== null &&\n\t\ttypeof payload._projectionSnapshot === \"object\" &&\n\t\t\"display\" in payload._projectionSnapshot &&\n\t\tpayload._projectionSnapshot.display !== null &&\n\t\ttypeof payload._projectionSnapshot.display === \"object\" &&\n\t\t\"title\" in payload._projectionSnapshot.display\n\t) {\n\t\tconst snapshot = payload._projectionSnapshot as {\n\t\t\tdisplay: DisplayDescriptor;\n\t\t\teventCursor?: string | null;\n\t\t\tchecksum?: string;\n\t\t\tupdatedAt?: string;\n\t\t};\n\t\treturn {\n\t\t\t...snapshot.display,\n\t\t\t_cachedDisplay: {\n\t\t\t\tsource: \"projection_snapshot\",\n\t\t\t\tcursor: snapshot.eventCursor,\n\t\t\t\tchecksum: snapshot.checksum,\n\t\t\t\tgeneratedAt: snapshot.updatedAt,\n\t\t\t},\n\t\t};\n\t}\n\treturn undefined;\n}\n\nexport async function renderEventDisplay(\n\teventType: string,\n\tpayload: unknown,\n\tctx?: DisplayContext,\n): Promise<CachedDisplayDescriptor> {\n\tconst snapshot = denormalizeDisplaySnapshot(payload);\n\tif (snapshot) {\n\t\treturn snapshot;\n\t}\n\n\tconst renderer = resolveDisplayRenderer(eventType);\n\tif (!renderer) {\n\t\treturn {\n\t\t\ttitle: eventType,\n\t\t\tsubtitle: \"No display renderer registered for this event type.\",\n\t\t};\n\t}\n\n\treturn await renderer(payload, ctx);\n}\n\n// Inline test: verify registry round-trip, snapshot denormalization, and fallback.\nasync function _runInlineTests(): Promise<void> {\n\tconst testEventType = \"__TestEvent__\";\n\n\t// 1. Registry round-trip\n\tregisterDisplayRenderer(testEventType, (payload) => ({\n\t\ttitle: `Test: ${(payload as { name: string }).name}`,\n\t\tsubtitle: \"registered renderer\",\n\t}));\n\n\tconst renderer = resolveDisplayRenderer(testEventType);\n\tassert.ok(renderer, \"resolveDisplayRenderer should return the registered renderer\");\n\n\tconst result = await renderEventDisplay(testEventType, { name: \"Alice\" });\n\tassert.strictEqual(result.title, \"Test: Alice\");\n\tassert.strictEqual(result.subtitle, \"registered renderer\");\n\n\t// 2. Snapshot denormalization takes precedence over renderer\n\tconst snapshot: DisplayDescriptor = {\n\t\ttitle: \"Snapshot Title\",\n\t\tsubtitle: \"snapshot subtitle\",\n\t\tstateLabel: \"archived\",\n\t\tprimaryFacts: [{ label: \"ID\", value: \"123\" }],\n\t};\n\tconst snapshotResult = await renderEventDisplay(testEventType, {\n\t\t_displaySnapshot: snapshot,\n\t});\n\tassert.deepStrictEqual(snapshotResult, snapshot);\n\n\t// 3. Fallback for unregistered event type\n\tconst fallback = await renderEventDisplay(\"__UnknownEvent__\", {});\n\tassert.strictEqual(fallback.title, \"__UnknownEvent__\");\n\tassert.strictEqual(fallback.subtitle, \"No display renderer registered for this event type.\");\n\n\t// 4. Async renderer with context\n\tregisterDisplayRenderer(\"__AsyncEvent__\", async (_payload, ctx) => {\n\t\treturn {\n\t\t\ttitle: `Async: ${ctx?.tenantId ?? \"no-ctx\"}`,\n\t\t};\n\t});\n\tconst asyncResult = await renderEventDisplay(\n\t\t\"__AsyncEvent__\",\n\t\t{},\n\t\t{ tenantId: \"t-1\", spaceId: \"s-1\", db: {} },\n\t);\n\tassert.strictEqual(asyncResult.title, \"Async: t-1\");\n\n\tconsole.log(\"✅ display engine inline tests passed\");\n}\n\nif (import.meta.url === `file://${process.argv[1]}`) {\n\t_runInlineTests().catch((err) => {\n\t\tconsole.error(\"❌ display engine inline tests failed\", err);\n\t\tprocess.exit(1);\n\t});\n}\n"]}

package/dist/chunk-GB2PSZ33.cjs

@@ -0,0 +1,74 @@
+'use strict';
+
+// state-machines/engine.ts
+var registry = /* @__PURE__ */ new Map();
+function registerStateMachine(def) {
+  if (registry.has(def.entityType)) {
+    throw new Error(`State machine for entity type "${def.entityType}" is already registered.`);
+  }
+  registry.set(def.entityType, def);
+}
+function registerStateMachineIfMissing(def) {
+  if (!registry.has(def.entityType)) {
+    registerStateMachine(def);
+  }
+}
+function resolveStateMachine(entityType) {
+  return registry.get(entityType);
+}
+function validateTransition(entityType, from, to, actionId) {
+  const sm = registry.get(entityType);
+  if (!sm) {
+    return {
+      valid: false,
+      error: `No state machine registered for entity type "${entityType}".`
+    };
+  }
+  const fromDef = sm.states[from];
+  if (!fromDef) {
+    return {
+      valid: false,
+      error: `State "${from}" does not exist in state machine for entity type "${entityType}".`
+    };
+  }
+  const toDef = sm.states[to];
+  if (!toDef) {
+    return {
+      valid: false,
+      error: `State "${to}" does not exist in state machine for entity type "${entityType}".`
+    };
+  }
+  const transitionExists = sm.transitions.some(
+    (t) => t.from === from && t.to === to && t.causedByAction === actionId
+  );
+  if (!transitionExists) {
+    return {
+      valid: false,
+      error: `Transition from "${from}" to "${to}" via action "${actionId}" is not defined for entity type "${entityType}".`
+    };
+  }
+  return { valid: true };
+}
+function getAllowedTransitions(entityType, from) {
+  const sm = registry.get(entityType);
+  if (!sm) {
+    return [];
+  }
+  return sm.transitions.filter((t) => t.from === from).map((t) => ({ to: t.to, causedByAction: t.causedByAction }));
+}
+function getEntityStateClass(entityType, state) {
+  const sm = registry.get(entityType);
+  if (!sm) {
+    return void 0;
+  }
+  return sm.states[state]?.stateClass;
+}
+
+exports.getAllowedTransitions = getAllowedTransitions;
+exports.getEntityStateClass = getEntityStateClass;
+exports.registerStateMachine = registerStateMachine;
+exports.registerStateMachineIfMissing = registerStateMachineIfMissing;
+exports.resolveStateMachine = resolveStateMachine;
+exports.validateTransition = validateTransition;
+//# sourceMappingURL=chunk-GB2PSZ33.cjs.map
+//# sourceMappingURL=chunk-GB2PSZ33.cjs.map

package/dist/chunk-GB2PSZ33.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../state-machines/engine.ts"],"names":[],"mappings":"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","file":"chunk-GB2PSZ33.cjs","sourcesContent":["import type { StateClass, StateDefinition } from \"./index\";\n\nexport interface StateMachineDefinition {\n\tentityType: string;\n\tstates: Record<string, StateDefinition>;\n\ttransitions: Array<{\n\t\tfrom: string;\n\t\tto: string;\n\t\tcausedByAction: string;\n\t\tguard?: (ctx: TransitionContext) => boolean | Promise<boolean>;\n\t}>;\n}\n\nexport type StateMachineDatabaseClient = any;\n\nexport interface TransitionContext<TDb = StateMachineDatabaseClient> {\n\tentity: Record<string, unknown>;\n\tactionInvocationId: string;\n\tactorId: string;\n\tparameters: unknown;\n\tdb: TDb;\n}\n\nconst registry = new Map<string, StateMachineDefinition>();\n\n/**\n * Register a state-machine definition for an entity type.\n * Throws if a definition for this entity type is already registered.\n */\nexport function registerStateMachine(def: StateMachineDefinition): void {\n\tif (registry.has(def.entityType)) {\n\t\tthrow new Error(`State machine for entity type \"${def.entityType}\" is already registered.`);\n\t}\n\tregistry.set(def.entityType, def);\n}\n\n/**\n * Register a state-machine definition only if one for this entity type\n * is not already registered. Idempotent — safe to call multiple times.\n */\nexport function registerStateMachineIfMissing(def: StateMachineDefinition): void {\n\tif (!registry.has(def.entityType)) {\n\t\tregisterStateMachine(def);\n\t}\n}\n\n/**\n * Resolve a previously registered state-machine definition by entity type.\n */\nexport function resolveStateMachine(entityType: string): StateMachineDefinition | undefined {\n\treturn registry.get(entityType);\n}\n\n/**\n * Validate whether a transition is allowed for the given entity type,\n * from state, to state, and action ID.\n */\nexport function validateTransition(\n\tentityType: string,\n\tfrom: string,\n\tto: string,\n\tactionId: string,\n): { valid: boolean; error?: string } {\n\tconst sm = registry.get(entityType);\n\tif (!sm) {\n\t\treturn {\n\t\t\tvalid: false,\n\t\t\terror: `No state machine registered for entity type \"${entityType}\".`,\n\t\t};\n\t}\n\n\tconst fromDef = sm.states[from];\n\tif (!fromDef) {\n\t\treturn {\n\t\t\tvalid: false,\n\t\t\terror: `State \"${from}\" does not exist in state machine for entity type \"${entityType}\".`,\n\t\t};\n\t}\n\n\tconst toDef = sm.states[to];\n\tif (!toDef) {\n\t\treturn {\n\t\t\tvalid: false,\n\t\t\terror: `State \"${to}\" does not exist in state machine for entity type \"${entityType}\".`,\n\t\t};\n\t}\n\n\tconst transitionExists = sm.transitions.some(\n\t\t(t) => t.from === from && t.to === to && t.causedByAction === actionId,\n\t);\n\tif (!transitionExists) {\n\t\treturn {\n\t\t\tvalid: false,\n\t\t\terror: `Transition from \"${from}\" to \"${to}\" via action \"${actionId}\" is not defined for entity type \"${entityType}\".`,\n\t\t};\n\t}\n\n\treturn { valid: true };\n}\n\n/**\n * Get all allowed transitions from a given state for an entity type.\n */\nexport function getAllowedTransitions(\n\tentityType: string,\n\tfrom: string,\n): Array<{ to: string; causedByAction: string }> {\n\tconst sm = registry.get(entityType);\n\tif (!sm) {\n\t\treturn [];\n\t}\n\treturn sm.transitions\n\t\t.filter((t) => t.from === from)\n\t\t.map((t) => ({ to: t.to, causedByAction: t.causedByAction }));\n}\n\n/**\n * Get the StateClass of a given state for an entity type.\n */\nexport function getEntityStateClass(entityType: string, state: string): StateClass | undefined {\n\tconst sm = registry.get(entityType);\n\tif (!sm) {\n\t\treturn undefined;\n\t}\n\treturn sm.states[state]?.stateClass;\n}\n"]}

package/dist/chunk-JAXDEK5Z.cjs

@@ -0,0 +1,63 @@
+'use strict';
+
+// events/index.ts
+var subjectTypeRegistry = /* @__PURE__ */ new Set([
+  "ActionInvocation",
+  "PolicyEvaluation",
+  "AdapterInvocation"
+]);
+var eventTypeRegistry = /* @__PURE__ */ new Set([
+  "ComplianceBlocked",
+  "StateTransitioned",
+  "AdapterInvocationStarted",
+  "AdapterInvocationSucceeded",
+  "AdapterInvocationFailed",
+  "WebhookReceived"
+]);
+var dynamicSubjectTypes = /* @__PURE__ */ new Set();
+var dynamicEventTypes = /* @__PURE__ */ new Set();
+function registerSubjectType(type) {
+  dynamicSubjectTypes.add(type);
+}
+function isValidSubjectType(type) {
+  return subjectTypeRegistry.has(type) || dynamicSubjectTypes.has(type);
+}
+function getRegisteredSubjectTypes() {
+  return Array.from(/* @__PURE__ */ new Set([...subjectTypeRegistry, ...dynamicSubjectTypes]));
+}
+function registerEventType(type) {
+  dynamicEventTypes.add(type);
+}
+function isValidEventType(type) {
+  return eventTypeRegistry.has(type) || dynamicEventTypes.has(type);
+}
+function getRegisteredEventTypes() {
+  return Array.from(/* @__PURE__ */ new Set([...eventTypeRegistry, ...dynamicEventTypes]));
+}
+function createEventTypeRegistry(initialEventTypes = []) {
+  const eventTypes = new Set(initialEventTypes);
+  return {
+    register(eventType) {
+      if (!eventType) {
+        throw new Error("Event type cannot be empty");
+      }
+      eventTypes.add(eventType);
+    },
+    has(eventType) {
+      return eventTypes.has(eventType);
+    },
+    list() {
+      return Array.from(eventTypes).sort();
+    }
+  };
+}
+
+exports.createEventTypeRegistry = createEventTypeRegistry;
+exports.getRegisteredEventTypes = getRegisteredEventTypes;
+exports.getRegisteredSubjectTypes = getRegisteredSubjectTypes;
+exports.isValidEventType = isValidEventType;
+exports.isValidSubjectType = isValidSubjectType;
+exports.registerEventType = registerEventType;
+exports.registerSubjectType = registerSubjectType;
+//# sourceMappingURL=chunk-JAXDEK5Z.cjs.map
+//# sourceMappingURL=chunk-JAXDEK5Z.cjs.map

package/dist/chunk-JAXDEK5Z.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../events/index.ts"],"names":[],"mappings":";;;AAmBA,IAAM,mBAAA,uBAA0B,GAAA,CAAY;AAAA,EAC3C,kBAAA;AAAA,EACA,kBAAA;AAAA,EACA;AACD,CAAC,CAAA;AAED,IAAM,iBAAA,uBAAwB,GAAA,CAAY;AAAA,EACzC,mBAAA;AAAA,EACA,mBAAA;AAAA,EACA,0BAAA;AAAA,EACA,4BAAA;AAAA,EACA,yBAAA;AAAA,EACA;AACD,CAAC,CAAA;AAED,IAAM,mBAAA,uBAA0B,GAAA,EAAY;AAC5C,IAAM,iBAAA,uBAAwB,GAAA,EAAY;AAMnC,SAAS,oBAAoB,IAAA,EAAoB;AACvD,EAAA,mBAAA,CAAoB,IAAI,IAAI,CAAA;AAC7B;AAEO,SAAS,mBAAmB,IAAA,EAAuB;AACzD,EAAA,OAAO,oBAAoB,GAAA,CAAI,IAAI,CAAA,IAAK,mBAAA,CAAoB,IAAI,IAAI,CAAA;AACrE;AAEO,SAAS,yBAAA,GAAsC;AACrD,EAAA,OAAO,KAAA,CAAM,IAAA,iBAAK,IAAI,GAAA,CAAI,CAAC,GAAG,mBAAA,EAAqB,GAAG,mBAAmB,CAAC,CAAC,CAAA;AAC5E;AAEO,SAAS,kBAAkB,IAAA,EAAoB;AACrD,EAAA,iBAAA,CAAkB,IAAI,IAAI,CAAA;AAC3B;AAEO,SAAS,iBAAiB,IAAA,EAAuB;AACvD,EAAA,OAAO,kBAAkB,GAAA,CAAI,IAAI,CAAA,IAAK,iBAAA,CAAkB,IAAI,IAAI,CAAA;AACjE;AAEO,SAAS,uBAAA,GAAoC;AACnD,EAAA,OAAO,KAAA,CAAM,IAAA,iBAAK,IAAI,GAAA,CAAI,CAAC,GAAG,iBAAA,EAAmB,GAAG,iBAAiB,CAAC,CAAC,CAAA;AACxE;AAQO,SAAS,uBAAA,CAAwB,iBAAA,GAA8B,EAAC,EAAsB;AAC5F,EAAA,MAAM,UAAA,GAAa,IAAI,GAAA,CAAI,iBAAiB,CAAA;AAC5C,EAAA,OAAO;AAAA,IACN,SAAS,SAAA,EAAW;AACnB,MAAA,IAAI,CAAC,SAAA,EAAW;AACf,QAAA,MAAM,IAAI,MAAM,4BAA4B,CAAA;AAAA,MAC7C;AACA,MAAA,UAAA,CAAW,IAAI,SAAS,CAAA;AAAA,IACzB,CAAA;AAAA,IACA,IAAI,SAAA,EAAW;AACd,MAAA,OAAO,UAAA,CAAW,IAAI,SAAS,CAAA;AAAA,IAChC,CAAA;AAAA,IACA,IAAA,GAAO;AACN,MAAA,OAAO,KAAA,CAAM,IAAA,CAAK,UAAU,CAAA,CAAE,IAAA,EAAK;AAAA,IACpC;AAAA,GACD;AACD","file":"chunk-JAXDEK5Z.cjs","sourcesContent":["export interface AssetEventEnvelope<TPayload = unknown> {\n\tid: string;\n\ttenantId: string;\n\tspaceId: string;\n\teventType: string;\n\teventSchemaVersion: number;\n\tsubjectType: string;\n\tsubjectId: string;\n\tactorId: string;\n\tactorType: string;\n\tactionInvocationId?: string;\n\tpayload: TPayload;\n\tsequence: number;\n\toccurredAt: Date;\n\trecordedAt: Date;\n\tcorrelationId: string;\n\tcausationId?: string;\n}\n\nconst subjectTypeRegistry = new Set<string>([\n\t\"ActionInvocation\",\n\t\"PolicyEvaluation\",\n\t\"AdapterInvocation\",\n]);\n\nconst eventTypeRegistry = new Set<string>([\n\t\"ComplianceBlocked\",\n\t\"StateTransitioned\",\n\t\"AdapterInvocationStarted\",\n\t\"AdapterInvocationSucceeded\",\n\t\"AdapterInvocationFailed\",\n\t\"WebhookReceived\",\n]);\n\nconst dynamicSubjectTypes = new Set<string>();\nconst dynamicEventTypes = new Set<string>();\n\nexport type AssetEventSubjectType = string;\nexport type AssetEventType = string;\nexport type AssetEventActorType = \"natural_person\" | \"agent\" | \"adapter\" | \"system\" | \"service_account\" | \"external_system\" | \"integration\";\n\nexport function registerSubjectType(type: string): void {\n\tdynamicSubjectTypes.add(type);\n}\n\nexport function isValidSubjectType(type: string): boolean {\n\treturn subjectTypeRegistry.has(type) || dynamicSubjectTypes.has(type);\n}\n\nexport function getRegisteredSubjectTypes(): string[] {\n\treturn Array.from(new Set([...subjectTypeRegistry, ...dynamicSubjectTypes]));\n}\n\nexport function registerEventType(type: string): void {\n\tdynamicEventTypes.add(type);\n}\n\nexport function isValidEventType(type: string): boolean {\n\treturn eventTypeRegistry.has(type) || dynamicEventTypes.has(type);\n}\n\nexport function getRegisteredEventTypes(): string[] {\n\treturn Array.from(new Set([...eventTypeRegistry, ...dynamicEventTypes]));\n}\n\nexport interface EventTypeRegistry {\n\tregister(eventType: string): void;\n\thas(eventType: string): boolean;\n\tlist(): string[];\n}\n\nexport function createEventTypeRegistry(initialEventTypes: string[] = []): EventTypeRegistry {\n\tconst eventTypes = new Set(initialEventTypes);\n\treturn {\n\t\tregister(eventType) {\n\t\t\tif (!eventType) {\n\t\t\t\tthrow new Error(\"Event type cannot be empty\");\n\t\t\t}\n\t\t\teventTypes.add(eventType);\n\t\t},\n\t\thas(eventType) {\n\t\t\treturn eventTypes.has(eventType);\n\t\t},\n\t\tlist() {\n\t\t\treturn Array.from(eventTypes).sort();\n\t\t},\n\t};\n}\n"]}

package/dist/chunk-KQEBNUZI.cjs

@@ -0,0 +1,70 @@
+'use strict';
+
+// actions/index.ts
+var ACTOR_TYPES = [
+  "natural_person",
+  "agent",
+  "system",
+  "service_account",
+  "external_system",
+  "integration"
+];
+function isActorType(value) {
+  return ACTOR_TYPES.includes(value);
+}
+function assertActorType(value) {
+  if (!isActorType(value)) {
+    throw new Error(`Invalid actorType: ${value}`);
+  }
+}
+var registry = /* @__PURE__ */ new Map();
+function assertActionId(actionId) {
+  if (!/^[a-z][a-z0-9-]*\.[a-z][a-z0-9_]*$/.test(actionId)) {
+    throw new Error(`Invalid action ID: ${actionId}`);
+  }
+}
+function registerAction(definition) {
+  assertActionId(definition.actionId);
+  if (registry.has(definition.actionId)) {
+    throw new Error(`Action "${definition.actionId}" is already registered`);
+  }
+  if (definition.mutatesDomain && definition.emitsEvents.length === 0) {
+    throw new Error(
+      `Action "${definition.actionId}" mutates domain but emits no events. Every mutating action must emit at least one AssetEvent.`
+    );
+  }
+  registry.set(definition.actionId, definition);
+}
+function resolveAction(actionId) {
+  return registry.get(actionId);
+}
+function isRegisteredActionId(actionId) {
+  return registry.has(actionId);
+}
+function resolveRegisteredAction(actionId) {
+  if (!isRegisteredActionId(actionId)) {
+    return void 0;
+  }
+  return resolveAction(actionId);
+}
+function getRegisteredActionIds() {
+  return Array.from(registry.keys());
+}
+function registerActionIfMissing(definition) {
+  if (!registry.has(definition.actionId)) {
+    registerAction(definition);
+  }
+}
+
+exports.ACTOR_TYPES = ACTOR_TYPES;
+exports.assertActionId = assertActionId;
+exports.assertActorType = assertActorType;
+exports.getRegisteredActionIds = getRegisteredActionIds;
+exports.isActorType = isActorType;
+exports.isRegisteredActionId = isRegisteredActionId;
+exports.registerAction = registerAction;
+exports.registerActionIfMissing = registerActionIfMissing;
+exports.resolveAction = resolveAction;
+exports.resolveRegisteredAction = resolveRegisteredAction;
+//# sourceMappingURL=chunk-KQEBNUZI.cjs.map
+//# sourceMappingURL=chunk-KQEBNUZI.cjs.map

package/dist/chunk-KQEBNUZI.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../actions/index.ts"],"names":[],"mappings":";;;AAwBO,IAAM,WAAA,GAAoC;AAAA,EAChD,gBAAA;AAAA,EACA,OAAA;AAAA,EACA,QAAA;AAAA,EACA,iBAAA;AAAA,EACA,iBAAA;AAAA,EACA;AACD;AAEO,SAAS,YAAY,KAAA,EAAmC;AAC9D,EAAA,OAAQ,WAAA,CAAkC,SAAS,KAAK,CAAA;AACzD;AAEO,SAAS,gBAAgB,KAAA,EAA2C;AAC1E,EAAA,IAAI,CAAC,WAAA,CAAY,KAAK,CAAA,EAAG;AACxB,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mBAAA,EAAsB,KAAK,CAAA,CAAE,CAAA;AAAA,EAC9C;AACD;AAsHA,IAAM,QAAA,uBAAe,GAAA,EAAgC;AAE9C,SAAS,eAAe,QAAA,EAAgD;AAC9E,EAAA,IAAI,CAAC,oCAAA,CAAqC,IAAA,CAAK,QAAQ,CAAA,EAAG;AACzD,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mBAAA,EAAsB,QAAQ,CAAA,CAAE,CAAA;AAAA,EACjD;AACD;AAEO,SAAS,eAAe,UAAA,EAAoC;AAClE,EAAA,cAAA,CAAe,WAAW,QAAQ,CAAA;AAElC,EAAA,IAAI,QAAA,CAAS,GAAA,CAAI,UAAA,CAAW,QAAQ,CAAA,EAAG;AACtC,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,QAAA,EAAW,UAAA,CAAW,QAAQ,CAAA,uBAAA,CAAyB,CAAA;AAAA,EACxE;AAEA,EAAA,IAAI,UAAA,CAAW,aAAA,IAAiB,UAAA,CAAW,WAAA,CAAY,WAAW,CAAA,EAAG;AACpE,IAAA,MAAM,IAAI,KAAA;AAAA,MACT,CAAA,QAAA,EAAW,WAAW,QAAQ,CAAA,8FAAA;AAAA,KAE/B;AAAA,EACD;AAEA,EAAA,QAAA,CAAS,GAAA,CAAI,UAAA,CAAW,QAAA,EAAU,UAAU,CAAA;AAC7C;AAEO,SAAS,cAAc,QAAA,EAAkD;AAC/E,EAAA,OAAO,QAAA,CAAS,IAAI,QAAQ,CAAA;AAC7B;AAEO,SAAS,qBAAqB,QAAA,EAAwC;AAC5E,EAAA,OAAO,QAAA,CAAS,IAAI,QAAoB,CAAA;AACzC;AAEO,SAAS,wBAAwB,QAAA,EAAgD;AACvF,EAAA,IAAI,CAAC,oBAAA,CAAqB,QAAQ,CAAA,EAAG;AACpC,IAAA,OAAO,MAAA;AAAA,EACR;AAEA,EAAA,OAAO,cAAc,QAAQ,CAAA;AAC9B;AAEO,SAAS,sBAAA,GAAqC;AACpD,EAAA,OAAO,KAAA,CAAM,IAAA,CAAK,QAAA,CAAS,IAAA,EAAM,CAAA;AAClC;AAEO,SAAS,wBAAwB,UAAA,EAAoC;AAC3E,EAAA,IAAI,CAAC,QAAA,CAAS,GAAA,CAAI,UAAA,CAAW,QAAQ,CAAA,EAAG;AACvC,IAAA,cAAA,CAAe,UAAU,CAAA;AAAA,EAC1B;AACD","file":"chunk-KQEBNUZI.cjs","sourcesContent":["export type ActionId = `${string}.${string}`;\n\nexport interface SchemaParseIssue {\n\tpath: PropertyKey[];\n\tmessage: string;\n}\n\nexport type SchemaParseResult<T = unknown> =\n\t| { success: true; data: T }\n\t| { success: false; error: { issues: SchemaParseIssue[] } };\n\nexport interface SchemaValidator<T = unknown> {\n\tparse(input: unknown): T;\n\tsafeParse(input: unknown): SchemaParseResult<T>;\n}\n\nexport type ActorType =\n\t| \"natural_person\"\n\t| \"agent\"\n\t| \"system\"\n\t| \"service_account\"\n\t| \"external_system\"\n\t| \"integration\";\n\nexport const ACTOR_TYPES: readonly ActorType[] = [\n\t\"natural_person\",\n\t\"agent\",\n\t\"system\",\n\t\"service_account\",\n\t\"external_system\",\n\t\"integration\",\n] as const;\n\nexport function isActorType(value: string): value is ActorType {\n\treturn (ACTOR_TYPES as readonly string[]).includes(value);\n}\n\nexport function assertActorType(value: string): asserts value is ActorType {\n\tif (!isActorType(value)) {\n\t\tthrow new Error(`Invalid actorType: ${value}`);\n\t}\n}\n\nexport type ActionStatus =\n\t| \"pending\"\n\t| \"running\"\n\t| \"completed\"\n\t| \"failed\"\n\t| \"blocked_by_policy\"\n\t| \"waiting_for_approval\"\n\t| \"validation_failed\";\n\nexport interface FabricRuntimeServices {\n\treadonly [serviceName: string]: unknown;\n}\n\nexport interface ActionContext<TDb = unknown> {\n\tactionInvocationId: string;\n\ttenantId: string;\n\tspaceId: string;\n\tactorId: string;\n\tactorType: ActorType;\n\tcorrelationId: string;\n\tcausationId?: string;\n\tdb: TDb;\n\tservices?: FabricRuntimeServices;\n}\n\nexport interface ActionResult {\n\tsuccess: boolean;\n\tdata?: Record<string, unknown>;\n\terror?: string;\n}\n\nexport type ActionHandler<TDb = unknown> = (\n\tctx: ActionContext<TDb>,\n\tparams: unknown,\n) => Promise<ActionResult>;\n\nexport interface AdapterStepRetryPolicy {\n\tidempotent: boolean;\n\tmaxAttempts?: number;\n\tinitialDelayMs?: number;\n\tbackoffMultiplier?: number;\n\tmaxDelayMs?: number;\n}\n\nexport interface AdapterStep {\n\tadapterType: string;\n\toperation: string;\n\tretryPolicy?: AdapterStepRetryPolicy;\n\tgetInput: (\n\t\tparams: unknown,\n\t\thandlerResult: Record<string, unknown>,\n\t) => Record<string, unknown> | undefined;\n}\n\nexport interface ActionStateMachineBinding {\n\tentityType: string;\n\ttargetState: string | ((params: unknown) => string);\n\tgetEntityId: (params: unknown) => string | undefined;\n}\n\nexport interface ActionDefinition<TDb = unknown> {\n\tactionId: ActionId;\n\tnamespace: string;\n\tversion: number;\n\tschema: SchemaValidator;\n\thandler?: ActionHandler<TDb>;\n\trequiredRoles?: string[];\n\trequiredPermissions?: string[];\n\tpolicies?: `${string}.v${number}`[];\n\temitsEvents: string[];\n\tidempotent: boolean;\n\tmutatesDomain: boolean;\n\tstateMachine?: ActionStateMachineBinding;\n\tadapterSteps?: AdapterStep[];\n\t/**\n\t * If \"saga\", the action is a multi-step orchestration. The worker dispatches\n\t * to a registered saga implementation instead of running `handler` directly.\n\t */\n\tkind?: \"atomic\" | \"saga\";\n}\n\nexport interface SagaContext {\n\tactionInvocationId: string;\n\ttenantId: string;\n\tspaceId: string;\n\tparameters: unknown;\n\tsleep?: (delayMs: number) => Promise<void>;\n\tquery?: <T = unknown>(model: string, operation: string, args: unknown) => Promise<T>;\n}\n\nexport interface SagaChildActionInput {\n\tsuffix: string;\n\tactionId: string;\n\tparameters: Record<string, unknown>;\n}\n\nexport type SagaRunChild = (input: SagaChildActionInput) => Promise<Record<string, unknown>>;\n\nexport interface SagaCompletionEvent {\n\teventType: string;\n\tsubjectType: string;\n\tsubjectId: string;\n\tpayload: unknown;\n\teventSchemaVersion?: number;\n}\n\nexport interface SagaCompletion {\n\tresultData: Record<string, unknown>;\n\tevent?: SagaCompletionEvent;\n}\n\nexport type SagaImplementation = (\n\tctx: SagaContext,\n\trunChild: SagaRunChild,\n) => Promise<SagaCompletion>;\n\nconst registry = new Map<ActionId, ActionDefinition>();\n\nexport function assertActionId(actionId: string): asserts actionId is ActionId {\n\tif (!/^[a-z][a-z0-9-]*\\.[a-z][a-z0-9_]*$/.test(actionId)) {\n\t\tthrow new Error(`Invalid action ID: ${actionId}`);\n\t}\n}\n\nexport function registerAction(definition: ActionDefinition): void {\n\tassertActionId(definition.actionId);\n\n\tif (registry.has(definition.actionId)) {\n\t\tthrow new Error(`Action \"${definition.actionId}\" is already registered`);\n\t}\n\n\tif (definition.mutatesDomain && definition.emitsEvents.length === 0) {\n\t\tthrow new Error(\n\t\t\t`Action \"${definition.actionId}\" mutates domain but emits no events. ` +\n\t\t\t\t`Every mutating action must emit at least one AssetEvent.`,\n\t\t);\n\t}\n\n\tregistry.set(definition.actionId, definition);\n}\n\nexport function resolveAction(actionId: ActionId): ActionDefinition | undefined {\n\treturn registry.get(actionId);\n}\n\nexport function isRegisteredActionId(actionId: string): actionId is ActionId {\n\treturn registry.has(actionId as ActionId);\n}\n\nexport function resolveRegisteredAction(actionId: string): ActionDefinition | undefined {\n\tif (!isRegisteredActionId(actionId)) {\n\t\treturn undefined;\n\t}\n\n\treturn resolveAction(actionId);\n}\n\nexport function getRegisteredActionIds(): ActionId[] {\n\treturn Array.from(registry.keys());\n}\n\nexport function registerActionIfMissing(definition: ActionDefinition): void {\n\tif (!registry.has(definition.actionId)) {\n\t\tregisterAction(definition);\n\t}\n}\n"]}

package/dist/chunk-LHCSVEFT.cjs

@@ -0,0 +1,8 @@
+'use strict';
+
+// privacy/index.ts
+var PLATFORM_PRIVACY_POLICY_VERSION = "fabric-platform-privacy-v1";
+
+exports.PLATFORM_PRIVACY_POLICY_VERSION = PLATFORM_PRIVACY_POLICY_VERSION;
+//# sourceMappingURL=chunk-LHCSVEFT.cjs.map
+//# sourceMappingURL=chunk-LHCSVEFT.cjs.map