@graphrefly/ts 0.0.0 → 0.0.1

package/dist/cqrs/messaging.js

@@ -0,0 +1,274 @@
+import {
+  depBatch
+} from "../chunk-WQIA3GFB.js";
+import "../chunk-S6HXABGL.js";
+import "../chunk-DGUM43GV.js";
+
+// src/cqrs/messaging.ts
+function cqrsMessagingRecipe(graph, opts) {
+  const name = opts.name ?? "cqrsMessaging";
+  const runtime = graph.node(
+    [opts.deliveries],
+    (ctx) => {
+      for (const raw of depBatch(ctx, 0) ?? []) {
+        const page = raw;
+        for (const message of page.messages) {
+          const delivery = messageDelivery(page, message);
+          const command = cqrsMessageCommand(message, delivery, opts.policy);
+          if (command === void 0) {
+            ctx.down([["DATA", { kind: "issue", issue: messageIssue(message, delivery) }]]);
+          } else {
+            ctx.down([["DATA", { kind: "command", command }]]);
+          }
+        }
+      }
+    },
+    {
+      name: `${name}/runtime`,
+      factory: "cqrsMessagingRuntime",
+      partial: true,
+      completeWhenDepsComplete: false,
+      errorWhenDepsError: false
+    }
+  );
+  const issues = project(
+    graph,
+    runtime,
+    `${name}/issues`,
+    "cqrsMessagingIssues",
+    (fact) => fact.kind === "issue" ? fact.issue : void 0
+  );
+  const commands = project(
+    graph,
+    runtime,
+    `${name}/commands`,
+    "cqrsMessagingCommands",
+    (fact) => fact.kind === "command" ? fact.command : void 0
+  );
+  const ackCommands = cqrsMessageAckCommands(graph, {
+    name: `${name}/ackCommands`,
+    commands,
+    status: opts.status,
+    issues,
+    ackRejected: opts.policy?.ackRejected ?? true
+  });
+  return {
+    commands,
+    ackCommands,
+    ...opts.events === void 0 || opts.policy?.outboxTopic === void 0 ? {} : {
+      outboxCommands: cqrsEventOutboxCommands(graph, opts.events, opts.policy.outboxTopic, {
+        name: `${name}/outboxCommands`
+      })
+    },
+    issues
+  };
+}
+function cqrsMessageCommand(message, delivery, policy) {
+  const mapped = policy?.command?.(message, delivery);
+  if (mapped !== void 0) return commandWithDelivery(mapped, delivery);
+  if (!isObjectRecord(message.payload)) return void 0;
+  const id = stringField(message.payload, "id") ?? delivery.commandId;
+  const type = stringField(message.payload, "type");
+  if (type === void 0) return void 0;
+  return commandWithDelivery(
+    {
+      id,
+      type,
+      payload: message.payload.payload,
+      aggregateId: stringField(message.payload, "aggregateId"),
+      correlationId: stringField(message.payload, "correlationId"),
+      causationId: stringField(message.payload, "causationId"),
+      metadata: {
+        ...objectField(message.payload, "metadata") ?? {}
+      }
+    },
+    delivery
+  );
+}
+function cqrsMessageAckCommands(graph, opts) {
+  return graph.node(
+    opts.issues === void 0 ? [opts.commands, opts.status] : [opts.commands, opts.status, opts.issues],
+    (ctx) => {
+      const deliveries = ctx.state.get() ?? /* @__PURE__ */ new Map();
+      for (const raw of depBatch(ctx, 0) ?? []) {
+        const command = raw;
+        const delivery = commandDelivery(command);
+        if (delivery !== void 0) pushDelivery(deliveries, command.id, delivery);
+      }
+      for (const raw of depBatch(ctx, 1) ?? []) {
+        const status = raw;
+        if (status.state === "rejected" && opts.ackRejected === false) continue;
+        if (status.commandId === void 0) continue;
+        const delivery = shiftDelivery(deliveries, status.commandId);
+        if (delivery === void 0) continue;
+        ctx.down([["DATA", ackCommand(delivery, ackCommandId("cqrs", delivery, "status"))]]);
+      }
+      if (opts.issues !== void 0) {
+        for (const raw of depBatch(ctx, 2) ?? []) {
+          const issue = raw;
+          const delivery = issueDelivery(issue);
+          if (delivery !== void 0) {
+            ctx.down([["DATA", ackCommand(delivery, ackCommandId("cqrs", delivery, "issue"))]]);
+          }
+        }
+      }
+      ctx.state.set(deliveries);
+    },
+    {
+      name: opts.name ?? "cqrsMessaging/ackCommands",
+      factory: "cqrsMessagingAckCommands",
+      partial: true,
+      completeWhenDepsComplete: false,
+      errorWhenDepsError: false
+    }
+  );
+}
+function cqrsEventOutboxCommands(graph, events, topic, opts = {}) {
+  return graph.node(
+    [events],
+    (ctx) => {
+      for (const event of depBatch(ctx, 0) ?? []) {
+        const typed = event;
+        ctx.down([
+          [
+            "DATA",
+            {
+              kind: "publish",
+              topic,
+              payload: typed,
+              key: typed.aggregateId,
+              commandId: `${typed.id}:cqrs-outbox`,
+              idempotencyKey: typed.id
+            }
+          ]
+        ]);
+      }
+    },
+    {
+      name: opts.name ?? "cqrsMessaging/outboxCommands",
+      factory: "cqrsMessagingOutboxCommands",
+      completeWhenDepsComplete: false,
+      errorWhenDepsError: false
+    }
+  );
+}
+function project(graph, runtime, name, factory, pick) {
+  return graph.node(
+    [runtime],
+    (ctx) => {
+      for (const fact of depBatch(ctx, 0) ?? []) {
+        const value = pick(fact);
+        if (value !== void 0) ctx.down([["DATA", value]]);
+      }
+    },
+    { name, factory, partial: true, completeWhenDepsComplete: false, errorWhenDepsError: false }
+  );
+}
+function messageIssue(message, delivery) {
+  return {
+    kind: "issue",
+    code: "cqrs-message-lowering-rejected",
+    message: "CQRS messaging recipe could not lower retained message to a command fact",
+    severity: "error",
+    source: "cqrs.messaging",
+    metadata: {
+      messageBus: {
+        topic: delivery.topic,
+        seq: delivery.seq,
+        subscriptionId: delivery.subscriptionId,
+        commandId: delivery.commandId
+      }
+    },
+    details: message
+  };
+}
+function ackCommand(delivery, commandId) {
+  return {
+    kind: "ack",
+    topic: delivery.topic,
+    subscriptionId: delivery.subscriptionId,
+    seq: delivery.seq,
+    commandId
+  };
+}
+function ackCommandId(namespace, delivery, reason) {
+  return `${namespace}:${delivery.topic}:${delivery.subscriptionId}:${delivery.seq}:${reason}-ack`;
+}
+function commandWithDelivery(command, delivery) {
+  return {
+    ...command,
+    metadata: {
+      ...command.metadata ?? {},
+      messageBus: delivery
+    }
+  };
+}
+function messageDelivery(page, message) {
+  return {
+    topic: page.topic,
+    seq: message.seq,
+    subscriptionId: page.subscriptionId,
+    commandId: isObjectRecord(message.payload) && typeof message.payload.id === "string" ? message.payload.id : message.commandId ?? `${page.topic}:${message.seq}`
+  };
+}
+function pushDelivery(deliveries, commandId, delivery) {
+  const queue = deliveries.get(commandId) ?? [];
+  deliveries.set(commandId, [...queue, delivery]);
+}
+function shiftDelivery(deliveries, commandId) {
+  const queue = deliveries.get(commandId);
+  if (queue === void 0 || queue.length === 0) return void 0;
+  const [first, ...rest] = queue;
+  if (rest.length === 0) deliveries.delete(commandId);
+  else deliveries.set(commandId, rest);
+  return first;
+}
+function issueDelivery(issue) {
+  const metadata = isObjectRecord(issue.metadata) ? issue.metadata : void 0;
+  const messageBus = isObjectRecord(metadata?.messageBus) ? metadata.messageBus : void 0;
+  if (messageBus === void 0) return void 0;
+  if (typeof messageBus.topic !== "string" || typeof messageBus.seq !== "number") return void 0;
+  if (typeof messageBus.subscriptionId !== "string") return void 0;
+  if (typeof messageBus.commandId !== "string") return void 0;
+  return {
+    topic: messageBus.topic,
+    seq: messageBus.seq,
+    subscriptionId: messageBus.subscriptionId,
+    commandId: messageBus.commandId
+  };
+}
+function commandDelivery(command) {
+  const metadata = isObjectRecord(command.metadata) ? command.metadata : void 0;
+  const messageBus = isObjectRecord(metadata?.messageBus) ? metadata.messageBus : void 0;
+  if (messageBus === void 0) return void 0;
+  return messageBusDelivery(messageBus);
+}
+function messageBusDelivery(messageBus) {
+  if (typeof messageBus.topic !== "string" || typeof messageBus.seq !== "number") return void 0;
+  if (typeof messageBus.subscriptionId !== "string") return void 0;
+  const commandId = typeof messageBus.commandId === "string" ? messageBus.commandId : "";
+  return {
+    topic: messageBus.topic,
+    seq: messageBus.seq,
+    subscriptionId: messageBus.subscriptionId,
+    commandId
+  };
+}
+function stringField(record, key) {
+  const value = record[key];
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function objectField(record, key) {
+  const value = record[key];
+  return isObjectRecord(value) ? value : void 0;
+}
+function isObjectRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+export {
+  cqrsEventOutboxCommands,
+  cqrsMessageAckCommands,
+  cqrsMessageCommand,
+  cqrsMessagingRecipe
+};
+//# sourceMappingURL=messaging.js.map

package/dist/cqrs/messaging.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cqrs/messaging.ts"],"sourcesContent":["/**\n * Optional CQRS-over-messageBus recipe (D350/D351/D353).\n *\n * Retained message delivery is lowered to CQRS command facts. Ack commands are\n * derived only after visible CQRS accepted/rejected/error/audit material exists.\n */\n\nimport type { CqrsCommand, CqrsError, CqrsEvent, CqrsStatus } from \"../cqrs/index.js\";\nimport { depBatch } from \"../ctx/types.js\";\nimport type { DataIssue } from \"../data/index.js\";\nimport type { Graph } from \"../graph/graph.js\";\nimport type {\n\tMessageBusAvailablePage,\n\tMessageBusCommand,\n\tMessageBusMessage,\n} from \"../messaging/index.js\";\nimport type { Node } from \"../node/node.js\";\n\nexport interface CqrsMessagingPolicy<TPayload = unknown, TCommand = unknown> {\n\treadonly command?: (\n\t\tmessage: MessageBusMessage<TPayload>,\n\t\tdelivery: MessageBusDelivery,\n\t) => CqrsCommand<TCommand> | undefined;\n\treadonly ackRejected?: boolean;\n\treadonly outboxTopic?: string;\n}\n\nexport interface CqrsMessagingRecipeOptions<\n\tTPayload = unknown,\n\tTCommand = unknown,\n\tTEvent = unknown,\n> {\n\treadonly name?: string;\n\treadonly deliveries: Node<MessageBusAvailablePage<TPayload>>;\n\treadonly status: Node<CqrsStatus>;\n\treadonly errors?: Node<CqrsError>;\n\treadonly events?: Node<CqrsEvent<TEvent>>;\n\treadonly policy?: CqrsMessagingPolicy<TPayload, TCommand>;\n}\n\nexport interface CqrsMessagingRecipeBundle<TCommand = unknown> {\n\treadonly commands: Node<CqrsCommand<TCommand>>;\n\treadonly ackCommands: Node<MessageBusCommand>;\n\treadonly outboxCommands?: Node<MessageBusCommand>;\n\treadonly issues: Node<DataIssue>;\n}\n\ntype CqrsMessagingFact<TCommand> =\n\t| { readonly kind: \"command\"; readonly command: CqrsCommand<TCommand> }\n\t| { readonly kind: \"issue\"; readonly issue: DataIssue };\n\nexport interface MessageBusDelivery {\n\treadonly topic: string;\n\treadonly seq: number;\n\treadonly subscriptionId: string;\n\treadonly commandId: string;\n}\n\n/** Build the optional D350/D351 CQRS messaging recipe. */\nexport function cqrsMessagingRecipe<TPayload = unknown, TCommand = unknown, TEvent = unknown>(\n\tgraph: Graph,\n\topts: CqrsMessagingRecipeOptions<TPayload, TCommand, TEvent>,\n): CqrsMessagingRecipeBundle<TCommand> {\n\tconst name = opts.name ?? \"cqrsMessaging\";\n\tconst runtime = graph.node<CqrsMessagingFact<TCommand>>(\n\t\t[opts.deliveries],\n\t\t(ctx) => {\n\t\t\tfor (const raw of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst page = raw as MessageBusAvailablePage<TPayload>;\n\t\t\t\tfor (const message of page.messages) {\n\t\t\t\t\tconst delivery = messageDelivery(page, message);\n\t\t\t\t\tconst command = cqrsMessageCommand(message, delivery, opts.policy);\n\t\t\t\t\tif (command === undefined) {\n\t\t\t\t\t\tctx.down([[\"DATA\", { kind: \"issue\", issue: messageIssue(message, delivery) }]]);\n\t\t\t\t\t} else {\n\t\t\t\t\t\tctx.down([[\"DATA\", { kind: \"command\", command }]]);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tname: `${name}/runtime`,\n\t\t\tfactory: \"cqrsMessagingRuntime\",\n\t\t\tpartial: true,\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n\tconst issues = project(graph, runtime, `${name}/issues`, \"cqrsMessagingIssues\", (fact) =>\n\t\tfact.kind === \"issue\" ? fact.issue : undefined,\n\t);\n\tconst commands = project(graph, runtime, `${name}/commands`, \"cqrsMessagingCommands\", (fact) =>\n\t\tfact.kind === \"command\" ? fact.command : undefined,\n\t);\n\tconst ackCommands = cqrsMessageAckCommands(graph, {\n\t\tname: `${name}/ackCommands`,\n\t\tcommands,\n\t\tstatus: opts.status,\n\t\tissues,\n\t\tackRejected: opts.policy?.ackRejected ?? true,\n\t});\n\treturn {\n\t\tcommands,\n\t\tackCommands,\n\t\t...(opts.events === undefined || opts.policy?.outboxTopic === undefined\n\t\t\t? {}\n\t\t\t: {\n\t\t\t\t\toutboxCommands: cqrsEventOutboxCommands(graph, opts.events, opts.policy.outboxTopic, {\n\t\t\t\t\t\tname: `${name}/outboxCommands`,\n\t\t\t\t\t}),\n\t\t\t\t}),\n\t\tissues,\n\t};\n}\n\nexport function cqrsMessageCommand<TPayload = unknown, TCommand = unknown>(\n\tmessage: MessageBusMessage<TPayload>,\n\tdelivery: MessageBusDelivery,\n\tpolicy?: CqrsMessagingPolicy<TPayload, TCommand>,\n): CqrsCommand<TCommand> | undefined {\n\tconst mapped = policy?.command?.(message, delivery);\n\tif (mapped !== undefined) return commandWithDelivery(mapped, delivery);\n\tif (!isObjectRecord(message.payload)) return undefined;\n\tconst id = stringField(message.payload, \"id\") ?? delivery.commandId;\n\tconst type = stringField(message.payload, \"type\");\n\tif (type === undefined) return undefined;\n\treturn commandWithDelivery(\n\t\t{\n\t\t\tid,\n\t\t\ttype,\n\t\t\tpayload: message.payload.payload as TCommand,\n\t\t\taggregateId: stringField(message.payload, \"aggregateId\"),\n\t\t\tcorrelationId: stringField(message.payload, \"correlationId\"),\n\t\t\tcausationId: stringField(message.payload, \"causationId\"),\n\t\t\tmetadata: {\n\t\t\t\t...(objectField(message.payload, \"metadata\") ?? {}),\n\t\t\t},\n\t\t},\n\t\tdelivery,\n\t);\n}\n\nexport function cqrsMessageAckCommands(\n\tgraph: Graph,\n\topts: {\n\t\treadonly name?: string;\n\t\treadonly commands: Node<CqrsCommand>;\n\t\treadonly status: Node<CqrsStatus>;\n\t\treadonly issues?: Node<DataIssue>;\n\t\treadonly ackRejected?: boolean;\n\t},\n): Node<MessageBusCommand> {\n\treturn graph.node<MessageBusCommand>(\n\t\topts.issues === undefined\n\t\t\t? [opts.commands, opts.status]\n\t\t\t: [opts.commands, opts.status, opts.issues],\n\t\t(ctx) => {\n\t\t\tconst deliveries =\n\t\t\t\tctx.state.get<Map<string, MessageBusDelivery[]>>() ??\n\t\t\t\tnew Map<string, MessageBusDelivery[]>();\n\t\t\tfor (const raw of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst command = raw as CqrsCommand;\n\t\t\t\tconst delivery = commandDelivery(command);\n\t\t\t\tif (delivery !== undefined) pushDelivery(deliveries, command.id, delivery);\n\t\t\t}\n\t\t\tfor (const raw of depBatch(ctx, 1) ?? []) {\n\t\t\t\tconst status = raw as CqrsStatus;\n\t\t\t\tif (status.state === \"rejected\" && opts.ackRejected === false) continue;\n\t\t\t\tif (status.commandId === undefined) continue;\n\t\t\t\tconst delivery = shiftDelivery(deliveries, status.commandId);\n\t\t\t\tif (delivery === undefined) continue;\n\t\t\t\tctx.down([[\"DATA\", ackCommand(delivery, ackCommandId(\"cqrs\", delivery, \"status\"))]]);\n\t\t\t}\n\t\t\tif (opts.issues !== undefined) {\n\t\t\t\tfor (const raw of depBatch(ctx, 2) ?? []) {\n\t\t\t\t\tconst issue = raw as DataIssue;\n\t\t\t\t\tconst delivery = issueDelivery(issue);\n\t\t\t\t\tif (delivery !== undefined) {\n\t\t\t\t\t\tctx.down([[\"DATA\", ackCommand(delivery, ackCommandId(\"cqrs\", delivery, \"issue\"))]]);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\tctx.state.set(deliveries);\n\t\t},\n\t\t{\n\t\t\tname: opts.name ?? \"cqrsMessaging/ackCommands\",\n\t\t\tfactory: \"cqrsMessagingAckCommands\",\n\t\t\tpartial: true,\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n}\n\nexport function cqrsEventOutboxCommands<TEvent>(\n\tgraph: Graph,\n\tevents: Node<CqrsEvent<TEvent>>,\n\ttopic: string,\n\topts: { readonly name?: string } = {},\n): Node<MessageBusCommand> {\n\treturn graph.node<MessageBusCommand>(\n\t\t[events],\n\t\t(ctx) => {\n\t\t\tfor (const event of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst typed = event as CqrsEvent<TEvent>;\n\t\t\t\tctx.down([\n\t\t\t\t\t[\n\t\t\t\t\t\t\"DATA\",\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tkind: \"publish\",\n\t\t\t\t\t\t\ttopic,\n\t\t\t\t\t\t\tpayload: typed,\n\t\t\t\t\t\t\tkey: typed.aggregateId,\n\t\t\t\t\t\t\tcommandId: `${typed.id}:cqrs-outbox`,\n\t\t\t\t\t\t\tidempotencyKey: typed.id,\n\t\t\t\t\t\t} satisfies MessageBusCommand,\n\t\t\t\t\t],\n\t\t\t\t]);\n\t\t\t}\n\t\t},\n\t\t{\n\t\t\tname: opts.name ?? \"cqrsMessaging/outboxCommands\",\n\t\t\tfactory: \"cqrsMessagingOutboxCommands\",\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n}\n\nfunction project<T, TCommand>(\n\tgraph: Graph,\n\truntime: Node<CqrsMessagingFact<TCommand>>,\n\tname: string,\n\tfactory: string,\n\tpick: (fact: CqrsMessagingFact<TCommand>) => T | undefined,\n): Node<T> {\n\treturn graph.node<T>(\n\t\t[runtime],\n\t\t(ctx) => {\n\t\t\tfor (const fact of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst value = pick(fact as CqrsMessagingFact<TCommand>);\n\t\t\t\tif (value !== undefined) ctx.down([[\"DATA\", value]]);\n\t\t\t}\n\t\t},\n\t\t{ name, factory, partial: true, completeWhenDepsComplete: false, errorWhenDepsError: false },\n\t);\n}\n\nfunction messageIssue(message: MessageBusMessage, delivery: MessageBusDelivery): DataIssue {\n\treturn {\n\t\tkind: \"issue\",\n\t\tcode: \"cqrs-message-lowering-rejected\",\n\t\tmessage: \"CQRS messaging recipe could not lower retained message to a command fact\",\n\t\tseverity: \"error\",\n\t\tsource: \"cqrs.messaging\",\n\t\tmetadata: {\n\t\t\tmessageBus: {\n\t\t\t\ttopic: delivery.topic,\n\t\t\t\tseq: delivery.seq,\n\t\t\t\tsubscriptionId: delivery.subscriptionId,\n\t\t\t\tcommandId: delivery.commandId,\n\t\t\t},\n\t\t},\n\t\tdetails: message,\n\t};\n}\n\nfunction ackCommand(delivery: MessageBusDelivery, commandId: string): MessageBusCommand {\n\treturn {\n\t\tkind: \"ack\",\n\t\ttopic: delivery.topic,\n\t\tsubscriptionId: delivery.subscriptionId,\n\t\tseq: delivery.seq,\n\t\tcommandId,\n\t};\n}\n\nfunction ackCommandId(namespace: string, delivery: MessageBusDelivery, reason: string): string {\n\treturn `${namespace}:${delivery.topic}:${delivery.subscriptionId}:${delivery.seq}:${reason}-ack`;\n}\n\nfunction commandWithDelivery<TCommand>(\n\tcommand: CqrsCommand<TCommand>,\n\tdelivery: MessageBusDelivery,\n): CqrsCommand<TCommand> {\n\treturn {\n\t\t...command,\n\t\tmetadata: {\n\t\t\t...(command.metadata ?? {}),\n\t\t\tmessageBus: delivery,\n\t\t},\n\t};\n}\n\nfunction messageDelivery(\n\tpage: MessageBusAvailablePage,\n\tmessage: MessageBusMessage,\n): MessageBusDelivery {\n\treturn {\n\t\ttopic: page.topic,\n\t\tseq: message.seq,\n\t\tsubscriptionId: page.subscriptionId,\n\t\tcommandId:\n\t\t\tisObjectRecord(message.payload) && typeof message.payload.id === \"string\"\n\t\t\t\t? message.payload.id\n\t\t\t\t: (message.commandId ?? `${page.topic}:${message.seq}`),\n\t};\n}\n\nfunction pushDelivery(\n\tdeliveries: Map<string, MessageBusDelivery[]>,\n\tcommandId: string,\n\tdelivery: MessageBusDelivery,\n): void {\n\tconst queue = deliveries.get(commandId) ?? [];\n\tdeliveries.set(commandId, [...queue, delivery]);\n}\n\nfunction shiftDelivery(\n\tdeliveries: Map<string, MessageBusDelivery[]>,\n\tcommandId: string,\n): MessageBusDelivery | undefined {\n\tconst queue = deliveries.get(commandId);\n\tif (queue === undefined || queue.length === 0) return undefined;\n\tconst [first, ...rest] = queue;\n\tif (rest.length === 0) deliveries.delete(commandId);\n\telse deliveries.set(commandId, rest);\n\treturn first;\n}\n\nfunction issueDelivery(issue: DataIssue): MessageBusDelivery | undefined {\n\tconst metadata = isObjectRecord(issue.metadata) ? issue.metadata : undefined;\n\tconst messageBus = isObjectRecord(metadata?.messageBus) ? metadata.messageBus : undefined;\n\tif (messageBus === undefined) return undefined;\n\tif (typeof messageBus.topic !== \"string\" || typeof messageBus.seq !== \"number\") return undefined;\n\tif (typeof messageBus.subscriptionId !== \"string\") return undefined;\n\tif (typeof messageBus.commandId !== \"string\") return undefined;\n\treturn {\n\t\ttopic: messageBus.topic,\n\t\tseq: messageBus.seq,\n\t\tsubscriptionId: messageBus.subscriptionId,\n\t\tcommandId: messageBus.commandId,\n\t};\n}\n\nfunction commandDelivery(command: CqrsCommand): MessageBusDelivery | undefined {\n\tconst metadata = isObjectRecord(command.metadata) ? command.metadata : undefined;\n\tconst messageBus = isObjectRecord(metadata?.messageBus) ? metadata.messageBus : undefined;\n\tif (messageBus === undefined) return undefined;\n\treturn messageBusDelivery(messageBus);\n}\n\nfunction messageBusDelivery(messageBus: Record<string, unknown>): MessageBusDelivery | undefined {\n\tif (typeof messageBus.topic !== \"string\" || typeof messageBus.seq !== \"number\") return undefined;\n\tif (typeof messageBus.subscriptionId !== \"string\") return undefined;\n\tconst commandId = typeof messageBus.commandId === \"string\" ? messageBus.commandId : \"\";\n\treturn {\n\t\ttopic: messageBus.topic,\n\t\tseq: messageBus.seq,\n\t\tsubscriptionId: messageBus.subscriptionId,\n\t\tcommandId,\n\t};\n}\n\nfunction stringField(record: Record<string, unknown>, key: string): string | undefined {\n\tconst value = record[key];\n\treturn typeof value === \"string\" && value.length > 0 ? value : undefined;\n}\n\nfunction objectField(\n\trecord: Record<string, unknown>,\n\tkey: string,\n): Record<string, unknown> | undefined {\n\tconst value = record[key];\n\treturn isObjectRecord(value) ? value : undefined;\n}\n\nfunction isObjectRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n"],"mappings":"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","names":[]}

package/dist/cqrs/work-queue.cjs

@@ -0,0 +1,329 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/cqrs/work-queue.ts
+var work_queue_exports = {};
+__export(work_queue_exports, {
+  cqrsSubmitCommand: () => cqrsSubmitCommand,
+  cqrsWorkQueueDispositionCommand: () => cqrsWorkQueueDispositionCommand,
+  cqrsWorkQueueRecipe: () => cqrsWorkQueueRecipe
+});
+module.exports = __toCommonJS(work_queue_exports);
+
+// src/protocol/messages.ts
+var SENTINEL = void 0;
+
+// src/ctx/types.ts
+function depWaves(ctx, depIndex) {
+  return ctx.waveData[depIndex] ?? [];
+}
+function depBatch(ctx, depIndex) {
+  const waves = depWaves(ctx, depIndex);
+  if (waves.length === 0) return null;
+  const flattened = waves.flat().filter((v) => v !== SENTINEL);
+  return flattened.length === 0 ? [] : flattened;
+}
+
+// src/cqrs/work-queue.ts
+function cqrsWorkQueueRecipe(graph, opts) {
+  const name = opts.name ?? "cqrsWorkQueue";
+  const deps = opts.errors === void 0 ? [opts.records, opts.status] : [opts.records, opts.status, opts.errors];
+  const runtime = graph.node(
+    deps,
+    (ctx) => {
+      const state = ctx.state.get() ?? emptyState();
+      for (const raw of depBatch(ctx, 0) ?? []) {
+        reduceRecord(ctx, state, raw, opts);
+      }
+      if (opts.errors !== void 0) {
+        for (const raw of depBatch(ctx, 2) ?? []) {
+          const error = raw;
+          if (error.commandId !== void 0) state.errors.set(error.commandId, error);
+        }
+      }
+      for (const raw of depBatch(ctx, 1) ?? []) {
+        reduceStatus(ctx, state, raw, opts);
+      }
+      ctx.state.set(state);
+    },
+    {
+      name: `${name}/runtime`,
+      factory: "cqrsWorkQueueRuntime",
+      partial: true,
+      completeWhenDepsComplete: false,
+      errorWhenDepsError: false
+    }
+  );
+  return {
+    attempts: project(
+      graph,
+      runtime,
+      `${name}/attempts`,
+      "cqrsWorkQueueAttempts",
+      (fact) => fact.kind === "attempt" ? fact.attempt : void 0
+    ),
+    dispatches: project(
+      graph,
+      runtime,
+      `${name}/dispatches`,
+      "cqrsWorkQueueDispatches",
+      (fact) => fact.kind === "dispatch" ? fact.command : void 0
+    ),
+    commands: project(
+      graph,
+      runtime,
+      `${name}/commands`,
+      "cqrsWorkQueueCommands",
+      (fact) => fact.kind === "command" ? fact.command : void 0
+    ),
+    issues: project(
+      graph,
+      runtime,
+      `${name}/issues`,
+      "cqrsWorkQueueIssues",
+      (fact) => fact.kind === "issue" ? fact.issue : void 0
+    )
+  };
+}
+function cqrsSubmitCommand(command, opts = {}) {
+  const payload = {
+    kind: "cqrs-queued-command",
+    command,
+    idempotencyKey: opts.idempotencyKey ?? command.id,
+    sourceRefs: opts.sourceRefs,
+    policyRefs: opts.policyRefs,
+    actorRefs: opts.actorRefs,
+    auditRefs: opts.auditRefs,
+    metadata: opts.metadata
+  };
+  return {
+    kind: "submit",
+    commandId: opts.commandId ?? `${command.id}:cqrs-work-queue-submit`,
+    workId: opts.workId ?? `cqrs:${command.id}`,
+    payload,
+    idempotencyKey: opts.idempotencyKey ?? command.id,
+    sourceRefs: opts.sourceRefs,
+    policyRefs: opts.policyRefs,
+    actorRefs: opts.actorRefs,
+    auditRefs: opts.auditRefs
+  };
+}
+function cqrsWorkQueueDispositionCommand(attempt, outcome, policy) {
+  if (outcome.kind === "release") {
+    return {
+      kind: "release",
+      commandId: dispositionCommandId(attempt, "release"),
+      workId: attempt.workId,
+      leaseId: attempt.leaseId,
+      attempt: attempt.queueAttempt,
+      workerId: attempt.workerId,
+      reason: outcome.reason ?? policy?.releaseReason?.(attempt)
+    };
+  }
+  if (outcome.kind === "accepted") {
+    return completeCommand(attempt, {
+      kind: "cqrs-accepted-result",
+      commandId: outcome.status.commandId,
+      commandType: outcome.status.commandType,
+      eventCount: outcome.status.eventCount,
+      cursor: outcome.status.cursor
+    });
+  }
+  const code = outcome.status.errorCode;
+  if (code === "handler-threw" || code === "clock-threw" || code === void 0) {
+    return {
+      kind: "fail",
+      commandId: dispositionCommandId(attempt, "fail"),
+      workId: attempt.workId,
+      leaseId: attempt.leaseId,
+      attempt: attempt.queueAttempt,
+      workerId: attempt.workerId,
+      error: outcome.error ?? {
+        kind: "issue",
+        code: code ?? "cqrs-outcome-ambiguous",
+        message: "CQRS rejected without deterministic rejection evidence"
+      },
+      retryable: code === void 0 ? true : policy?.retryableFailure?.(code, outcome) ?? true
+    };
+  }
+  return completeCommand(attempt, {
+    kind: "cqrs-rejected-result",
+    commandId: outcome.status.commandId,
+    commandType: outcome.status.commandType,
+    errorCode: code,
+    error: outcome.error,
+    eventCount: outcome.status.eventCount,
+    cursor: outcome.status.cursor
+  });
+}
+function completeCommand(attempt, result) {
+  return {
+    kind: "complete",
+    commandId: dispositionCommandId(attempt, "complete"),
+    workId: attempt.workId,
+    leaseId: attempt.leaseId,
+    attempt: attempt.queueAttempt,
+    workerId: attempt.workerId,
+    result
+  };
+}
+function reduceRecord(ctx, state, record, opts) {
+  if (record.kind === "work-admitted") {
+    if (isQueuedPayload(record.payload)) state.payloads.set(record.workId, record.payload);
+    else emit(ctx, { kind: "issue", issue: queueIssue(record, "cqrs-queue-malformed-payload") });
+    return;
+  }
+  if (record.kind !== "work-claimed") return;
+  if (opts.workerId !== void 0 && record.workerId !== opts.workerId) return;
+  const payload = state.payloads.get(record.workId);
+  if (payload === void 0) {
+    emit(ctx, { kind: "issue", issue: queueIssue(record, "cqrs-claim-without-payload") });
+    emit(ctx, {
+      kind: "command",
+      command: {
+        kind: "release",
+        commandId: `cqrs:${record.workId}:${record.leaseId}:${record.attempt}:release-no-payload`,
+        workId: record.workId,
+        leaseId: record.leaseId,
+        attempt: record.attempt,
+        workerId: record.workerId,
+        reason: "cqrs-claim-without-payload"
+      }
+    });
+    return;
+  }
+  const attempt = {
+    kind: "cqrs-work-queue-attempt",
+    workId: record.workId,
+    leaseId: record.leaseId,
+    queueAttempt: record.attempt,
+    workerId: record.workerId,
+    command: payload.command,
+    payload,
+    sourceRefs: [...payload.sourceRefs ?? [], `work-queue-record:${record.recordSeq}`]
+  };
+  pushActiveClaim(state, payload.command.id, attempt);
+  emit(ctx, { kind: "attempt", attempt });
+  emit(ctx, { kind: "dispatch", command: payload.command });
+}
+function reduceStatus(ctx, state, status, opts) {
+  if (status.commandId === void 0) return;
+  const attempt = shiftActiveClaim(state, status.commandId);
+  if (attempt === void 0) {
+    emit(ctx, {
+      kind: "issue",
+      issue: {
+        kind: "issue",
+        code: "cqrs-status-without-active-queue-claim",
+        message: "CQRS workQueue recipe observed a CQRS status without an active queue claim; no queue disposition was emitted",
+        severity: "error",
+        source: "cqrs.workQueue",
+        refs: [`cqrs-command:${status.commandId}`],
+        details: status
+      }
+    });
+    return;
+  }
+  const claimKey = queueClaimKey(attempt);
+  if (state.terminalClaims.has(claimKey)) {
+    emit(ctx, {
+      kind: "issue",
+      issue: {
+        kind: "issue",
+        code: "cqrs-duplicate-terminal-outcome-for-queue-claim",
+        message: `CQRS queue claim '${claimKey}' already produced a terminal queue disposition`,
+        refs: [`cqrs-command:${status.commandId}`, `work-queue-work:${attempt.workId}`]
+      }
+    });
+    return;
+  }
+  state.terminalClaims.add(claimKey);
+  const command = cqrsWorkQueueDispositionCommand(
+    attempt,
+    status.state === "accepted" ? { kind: "accepted", status } : { kind: "rejected", status, error: state.errors.get(status.commandId) },
+    opts.policy
+  );
+  emit(ctx, { kind: "command", command });
+}
+function emptyState() {
+  return {
+    payloads: /* @__PURE__ */ new Map(),
+    activeClaims: /* @__PURE__ */ new Map(),
+    errors: /* @__PURE__ */ new Map(),
+    terminalClaims: /* @__PURE__ */ new Set()
+  };
+}
+function pushActiveClaim(state, commandId, attempt) {
+  const claims = state.activeClaims.get(commandId) ?? [];
+  state.activeClaims.set(commandId, [...claims, attempt]);
+}
+function shiftActiveClaim(state, commandId) {
+  const claims = state.activeClaims.get(commandId);
+  if (claims === void 0 || claims.length === 0) return void 0;
+  const [first, ...rest] = claims;
+  if (rest.length === 0) state.activeClaims.delete(commandId);
+  else state.activeClaims.set(commandId, rest);
+  return first;
+}
+function queueClaimKey(attempt) {
+  return `${attempt.workId}:${attempt.leaseId}:${attempt.queueAttempt}`;
+}
+function dispositionCommandId(attempt, kind) {
+  return `${attempt.command.id}:${attempt.workId}:${attempt.leaseId}:${attempt.queueAttempt}:cqrs-queue-${kind}`;
+}
+function project(graph, runtime, name, factory, pick) {
+  return graph.node(
+    [runtime],
+    (ctx) => {
+      for (const fact of depBatch(ctx, 0) ?? []) {
+        const value = pick(fact);
+        if (value !== void 0) ctx.down([["DATA", value]]);
+      }
+    },
+    { name, factory, partial: true, completeWhenDepsComplete: false, errorWhenDepsError: false }
+  );
+}
+function emit(ctx, fact) {
+  ctx.down([["DATA", fact]]);
+}
+function isQueuedPayload(value) {
+  if (!isObjectRecord(value) || value.kind !== "cqrs-queued-command") return false;
+  return isObjectRecord(value.command) && typeof value.command.id === "string";
+}
+function queueIssue(record, code) {
+  return {
+    kind: "issue",
+    code,
+    message: `CQRS workQueue recipe could not map record '${record.kind}'`,
+    severity: "error",
+    source: "cqrs.workQueue",
+    refs: record.workId === void 0 ? void 0 : [`work-queue-work:${record.workId}`],
+    details: record
+  };
+}
+function isObjectRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cqrsSubmitCommand,
+  cqrsWorkQueueDispositionCommand,
+  cqrsWorkQueueRecipe
+});
+//# sourceMappingURL=work-queue.cjs.map