@graphrefly/ts 0.0.0 → 0.0.1

package/dist/cqrs/work-queue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cqrs/work-queue.ts","../../src/protocol/messages.ts","../../src/ctx/types.ts"],"sourcesContent":["/**\n * Optional CQRS-over-workQueue recipe (D350/D352/D353).\n *\n * The CQRS core remains synchronous graph-visible command/event truth. This\n * recipe only maps queue claims to CQRS command facts and maps visible CQRS\n * outcomes back to generic workQueue disposition commands.\n */\n\nimport type { CqrsCommand, CqrsError, CqrsErrorCode, CqrsStatus } from \"../cqrs/index.js\";\nimport { type Ctx, depBatch } from \"../ctx/types.js\";\nimport type { DataIssue } from \"../data/index.js\";\nimport type { Graph } from \"../graph/graph.js\";\nimport type { Node } from \"../node/node.js\";\nimport type { WorkQueueCommand, WorkQueueRecord } from \"../work-queue/index.js\";\n\nexport interface CqrsQueuedCommandPayload<TCommand = unknown> {\n\treadonly kind: \"cqrs-queued-command\";\n\treadonly command: CqrsCommand<TCommand>;\n\treadonly idempotencyKey?: string;\n\treadonly sourceRefs?: readonly string[];\n\treadonly policyRefs?: readonly string[];\n\treadonly actorRefs?: readonly string[];\n\treadonly auditRefs?: readonly string[];\n\treadonly metadata?: Record<string, unknown>;\n}\n\nexport interface CqrsWorkQueueAttempt<TCommand = unknown> {\n\treadonly kind: \"cqrs-work-queue-attempt\";\n\treadonly workId: string;\n\treadonly leaseId: string;\n\treadonly queueAttempt: number;\n\treadonly workerId: string;\n\treadonly command: CqrsCommand<TCommand>;\n\treadonly payload: CqrsQueuedCommandPayload<TCommand>;\n\treadonly sourceRefs?: readonly string[];\n}\n\nexport type CqrsWorkQueueAcceptedOutcome = {\n\treadonly kind: \"accepted\";\n\treadonly status: CqrsStatus;\n};\n\nexport type CqrsWorkQueueRejectedOutcome = {\n\treadonly kind: \"rejected\";\n\treadonly status: CqrsStatus;\n\treadonly error?: CqrsError;\n};\n\nexport type CqrsWorkQueueReleaseOutcome = {\n\treadonly kind: \"release\";\n\treadonly reason?: string;\n};\n\nexport type CqrsWorkQueueOutcome =\n\t| CqrsWorkQueueAcceptedOutcome\n\t| CqrsWorkQueueRejectedOutcome\n\t| CqrsWorkQueueReleaseOutcome;\n\nexport interface CqrsWorkQueuePolicy {\n\t/**\n\t * D352: handler-threw and clock-threw fail retryable:true by default. A\n\t * policy may classify a known deterministic handler failure as nonretryable.\n\t */\n\treadonly retryableFailure?: (\n\t\terrorCode: CqrsErrorCode,\n\t\toutcome: CqrsWorkQueueRejectedOutcome,\n\t) => boolean;\n\treadonly releaseReason?: (attempt: CqrsWorkQueueAttempt) => string | undefined;\n}\n\nexport interface CqrsWorkQueueRecipeOptions<TCommand = unknown> {\n\treadonly name?: string;\n\treadonly records: Node<WorkQueueRecord<CqrsQueuedCommandPayload<TCommand>>>;\n\treadonly status: Node<CqrsStatus>;\n\treadonly errors?: Node<CqrsError>;\n\treadonly workerId?: string;\n\treadonly policy?: CqrsWorkQueuePolicy;\n}\n\nexport interface CqrsWorkQueueRecipeBundle<TCommand = unknown> {\n\treadonly attempts: Node<CqrsWorkQueueAttempt<TCommand>>;\n\treadonly dispatches: Node<CqrsCommand<TCommand>>;\n\treadonly commands: Node<WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>>>;\n\treadonly issues: Node<DataIssue>;\n}\n\ntype CqrsQueueFact<TCommand> =\n\t| { readonly kind: \"attempt\"; readonly attempt: CqrsWorkQueueAttempt<TCommand> }\n\t| { readonly kind: \"dispatch\"; readonly command: CqrsCommand<TCommand> }\n\t| {\n\t\t\treadonly kind: \"command\";\n\t\t\treadonly command: WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>>;\n\t  }\n\t| { readonly kind: \"issue\"; readonly issue: DataIssue };\n\ninterface CqrsQueueState<TCommand> {\n\treadonly payloads: Map<string, CqrsQueuedCommandPayload<TCommand>>;\n\treadonly activeClaims: Map<string, CqrsWorkQueueAttempt<TCommand>[]>;\n\treadonly errors: Map<string, CqrsError>;\n\treadonly terminalClaims: Set<string>;\n}\n\n/** Build the optional D350/D352 CQRS workQueue recipe. */\nexport function cqrsWorkQueueRecipe<TCommand = unknown>(\n\tgraph: Graph,\n\topts: CqrsWorkQueueRecipeOptions<TCommand>,\n): CqrsWorkQueueRecipeBundle<TCommand> {\n\tconst name = opts.name ?? \"cqrsWorkQueue\";\n\tconst deps =\n\t\topts.errors === undefined\n\t\t\t? [opts.records, opts.status]\n\t\t\t: [opts.records, opts.status, opts.errors];\n\tconst runtime = graph.node<CqrsQueueFact<TCommand>>(\n\t\tdeps,\n\t\t(ctx) => {\n\t\t\tconst state = ctx.state.get<CqrsQueueState<TCommand>>() ?? emptyState<TCommand>();\n\t\t\tfor (const raw of depBatch(ctx, 0) ?? []) {\n\t\t\t\treduceRecord(ctx, state, raw as WorkQueueRecord<CqrsQueuedCommandPayload<TCommand>>, opts);\n\t\t\t}\n\t\t\tif (opts.errors !== undefined) {\n\t\t\t\tfor (const raw of depBatch(ctx, 2) ?? []) {\n\t\t\t\t\tconst error = raw as CqrsError;\n\t\t\t\t\tif (error.commandId !== undefined) state.errors.set(error.commandId, error);\n\t\t\t\t}\n\t\t\t}\n\t\t\tfor (const raw of depBatch(ctx, 1) ?? []) {\n\t\t\t\treduceStatus(ctx, state, raw as CqrsStatus, opts);\n\t\t\t}\n\t\t\tctx.state.set(state);\n\t\t},\n\t\t{\n\t\t\tname: `${name}/runtime`,\n\t\t\tfactory: \"cqrsWorkQueueRuntime\",\n\t\t\tpartial: true,\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n\treturn {\n\t\tattempts: project(graph, runtime, `${name}/attempts`, \"cqrsWorkQueueAttempts\", (fact) =>\n\t\t\tfact.kind === \"attempt\" ? fact.attempt : undefined,\n\t\t),\n\t\tdispatches: project(graph, runtime, `${name}/dispatches`, \"cqrsWorkQueueDispatches\", (fact) =>\n\t\t\tfact.kind === \"dispatch\" ? fact.command : undefined,\n\t\t),\n\t\tcommands: project(graph, runtime, `${name}/commands`, \"cqrsWorkQueueCommands\", (fact) =>\n\t\t\tfact.kind === \"command\" ? fact.command : undefined,\n\t\t),\n\t\tissues: project(graph, runtime, `${name}/issues`, \"cqrsWorkQueueIssues\", (fact) =>\n\t\t\tfact.kind === \"issue\" ? fact.issue : undefined,\n\t\t),\n\t};\n}\n\nexport function cqrsSubmitCommand<TCommand>(\n\tcommand: CqrsCommand<TCommand>,\n\topts: {\n\t\treadonly workId?: string;\n\t\treadonly commandId?: string;\n\t\treadonly idempotencyKey?: string;\n\t\treadonly sourceRefs?: readonly string[];\n\t\treadonly policyRefs?: readonly string[];\n\t\treadonly actorRefs?: readonly string[];\n\t\treadonly auditRefs?: readonly string[];\n\t\treadonly metadata?: Record<string, unknown>;\n\t} = {},\n): WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>> {\n\tconst payload: CqrsQueuedCommandPayload<TCommand> = {\n\t\tkind: \"cqrs-queued-command\",\n\t\tcommand,\n\t\tidempotencyKey: opts.idempotencyKey ?? command.id,\n\t\tsourceRefs: opts.sourceRefs,\n\t\tpolicyRefs: opts.policyRefs,\n\t\tactorRefs: opts.actorRefs,\n\t\tauditRefs: opts.auditRefs,\n\t\tmetadata: opts.metadata,\n\t};\n\treturn {\n\t\tkind: \"submit\",\n\t\tcommandId: opts.commandId ?? `${command.id}:cqrs-work-queue-submit`,\n\t\tworkId: opts.workId ?? `cqrs:${command.id}`,\n\t\tpayload,\n\t\tidempotencyKey: opts.idempotencyKey ?? command.id,\n\t\tsourceRefs: opts.sourceRefs,\n\t\tpolicyRefs: opts.policyRefs,\n\t\tactorRefs: opts.actorRefs,\n\t\tauditRefs: opts.auditRefs,\n\t};\n}\n\nexport function cqrsWorkQueueDispositionCommand<TCommand>(\n\tattempt: CqrsWorkQueueAttempt<TCommand>,\n\toutcome: CqrsWorkQueueOutcome,\n\tpolicy?: CqrsWorkQueuePolicy,\n): WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>> {\n\tif (outcome.kind === \"release\") {\n\t\treturn {\n\t\t\tkind: \"release\",\n\t\t\tcommandId: dispositionCommandId(attempt, \"release\"),\n\t\t\tworkId: attempt.workId,\n\t\t\tleaseId: attempt.leaseId,\n\t\t\tattempt: attempt.queueAttempt,\n\t\t\tworkerId: attempt.workerId,\n\t\t\treason: outcome.reason ?? policy?.releaseReason?.(attempt),\n\t\t};\n\t}\n\tif (outcome.kind === \"accepted\") {\n\t\treturn completeCommand(attempt, {\n\t\t\tkind: \"cqrs-accepted-result\",\n\t\t\tcommandId: outcome.status.commandId,\n\t\t\tcommandType: outcome.status.commandType,\n\t\t\teventCount: outcome.status.eventCount,\n\t\t\tcursor: outcome.status.cursor,\n\t\t});\n\t}\n\tconst code = outcome.status.errorCode;\n\tif (code === \"handler-threw\" || code === \"clock-threw\" || code === undefined) {\n\t\treturn {\n\t\t\tkind: \"fail\",\n\t\t\tcommandId: dispositionCommandId(attempt, \"fail\"),\n\t\t\tworkId: attempt.workId,\n\t\t\tleaseId: attempt.leaseId,\n\t\t\tattempt: attempt.queueAttempt,\n\t\t\tworkerId: attempt.workerId,\n\t\t\terror: outcome.error ?? {\n\t\t\t\tkind: \"issue\",\n\t\t\t\tcode: code ?? \"cqrs-outcome-ambiguous\",\n\t\t\t\tmessage: \"CQRS rejected without deterministic rejection evidence\",\n\t\t\t},\n\t\t\tretryable: code === undefined ? true : (policy?.retryableFailure?.(code, outcome) ?? true),\n\t\t};\n\t}\n\treturn completeCommand(attempt, {\n\t\tkind: \"cqrs-rejected-result\",\n\t\tcommandId: outcome.status.commandId,\n\t\tcommandType: outcome.status.commandType,\n\t\terrorCode: code,\n\t\terror: outcome.error,\n\t\teventCount: outcome.status.eventCount,\n\t\tcursor: outcome.status.cursor,\n\t});\n}\n\nfunction completeCommand<TCommand>(\n\tattempt: CqrsWorkQueueAttempt<TCommand>,\n\tresult: unknown,\n): WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>> {\n\treturn {\n\t\tkind: \"complete\",\n\t\tcommandId: dispositionCommandId(attempt, \"complete\"),\n\t\tworkId: attempt.workId,\n\t\tleaseId: attempt.leaseId,\n\t\tattempt: attempt.queueAttempt,\n\t\tworkerId: attempt.workerId,\n\t\tresult,\n\t};\n}\n\nfunction reduceRecord<TCommand>(\n\tctx: Ctx,\n\tstate: CqrsQueueState<TCommand>,\n\trecord: WorkQueueRecord<CqrsQueuedCommandPayload<TCommand>>,\n\topts: CqrsWorkQueueRecipeOptions<TCommand>,\n): void {\n\tif (record.kind === \"work-admitted\") {\n\t\tif (isQueuedPayload(record.payload)) state.payloads.set(record.workId, record.payload);\n\t\telse emit(ctx, { kind: \"issue\", issue: queueIssue(record, \"cqrs-queue-malformed-payload\") });\n\t\treturn;\n\t}\n\tif (record.kind !== \"work-claimed\") return;\n\tif (opts.workerId !== undefined && record.workerId !== opts.workerId) return;\n\tconst payload = state.payloads.get(record.workId);\n\tif (payload === undefined) {\n\t\temit(ctx, { kind: \"issue\", issue: queueIssue(record, \"cqrs-claim-without-payload\") });\n\t\temit(ctx, {\n\t\t\tkind: \"command\",\n\t\t\tcommand: {\n\t\t\t\tkind: \"release\",\n\t\t\t\tcommandId: `cqrs:${record.workId}:${record.leaseId}:${record.attempt}:release-no-payload`,\n\t\t\t\tworkId: record.workId,\n\t\t\t\tleaseId: record.leaseId,\n\t\t\t\tattempt: record.attempt,\n\t\t\t\tworkerId: record.workerId,\n\t\t\t\treason: \"cqrs-claim-without-payload\",\n\t\t\t},\n\t\t});\n\t\treturn;\n\t}\n\tconst attempt: CqrsWorkQueueAttempt<TCommand> = {\n\t\tkind: \"cqrs-work-queue-attempt\",\n\t\tworkId: record.workId,\n\t\tleaseId: record.leaseId,\n\t\tqueueAttempt: record.attempt,\n\t\tworkerId: record.workerId,\n\t\tcommand: payload.command,\n\t\tpayload,\n\t\tsourceRefs: [...(payload.sourceRefs ?? []), `work-queue-record:${record.recordSeq}`],\n\t};\n\tpushActiveClaim(state, payload.command.id, attempt);\n\temit(ctx, { kind: \"attempt\", attempt });\n\temit(ctx, { kind: \"dispatch\", command: payload.command });\n}\n\nfunction reduceStatus<TCommand>(\n\tctx: Ctx,\n\tstate: CqrsQueueState<TCommand>,\n\tstatus: CqrsStatus,\n\topts: CqrsWorkQueueRecipeOptions<TCommand>,\n): void {\n\tif (status.commandId === undefined) return;\n\tconst attempt = shiftActiveClaim(state, status.commandId);\n\tif (attempt === undefined) {\n\t\temit(ctx, {\n\t\t\tkind: \"issue\",\n\t\t\tissue: {\n\t\t\t\tkind: \"issue\",\n\t\t\t\tcode: \"cqrs-status-without-active-queue-claim\",\n\t\t\t\tmessage:\n\t\t\t\t\t\"CQRS workQueue recipe observed a CQRS status without an active queue claim; no queue disposition was emitted\",\n\t\t\t\tseverity: \"error\",\n\t\t\t\tsource: \"cqrs.workQueue\",\n\t\t\t\trefs: [`cqrs-command:${status.commandId}`],\n\t\t\t\tdetails: status,\n\t\t\t},\n\t\t});\n\t\treturn;\n\t}\n\tconst claimKey = queueClaimKey(attempt);\n\tif (state.terminalClaims.has(claimKey)) {\n\t\temit(ctx, {\n\t\t\tkind: \"issue\",\n\t\t\tissue: {\n\t\t\t\tkind: \"issue\",\n\t\t\t\tcode: \"cqrs-duplicate-terminal-outcome-for-queue-claim\",\n\t\t\t\tmessage: `CQRS queue claim '${claimKey}' already produced a terminal queue disposition`,\n\t\t\t\trefs: [`cqrs-command:${status.commandId}`, `work-queue-work:${attempt.workId}`],\n\t\t\t},\n\t\t});\n\t\treturn;\n\t}\n\tstate.terminalClaims.add(claimKey);\n\tconst command = cqrsWorkQueueDispositionCommand(\n\t\tattempt,\n\t\tstatus.state === \"accepted\"\n\t\t\t? { kind: \"accepted\", status }\n\t\t\t: { kind: \"rejected\", status, error: state.errors.get(status.commandId) },\n\t\topts.policy,\n\t);\n\temit(ctx, { kind: \"command\", command });\n}\n\nfunction emptyState<TCommand>(): CqrsQueueState<TCommand> {\n\treturn {\n\t\tpayloads: new Map(),\n\t\tactiveClaims: new Map(),\n\t\terrors: new Map(),\n\t\tterminalClaims: new Set(),\n\t};\n}\n\nfunction pushActiveClaim<TCommand>(\n\tstate: CqrsQueueState<TCommand>,\n\tcommandId: string,\n\tattempt: CqrsWorkQueueAttempt<TCommand>,\n): void {\n\tconst claims = state.activeClaims.get(commandId) ?? [];\n\tstate.activeClaims.set(commandId, [...claims, attempt]);\n}\n\nfunction shiftActiveClaim<TCommand>(\n\tstate: CqrsQueueState<TCommand>,\n\tcommandId: string,\n): CqrsWorkQueueAttempt<TCommand> | undefined {\n\tconst claims = state.activeClaims.get(commandId);\n\tif (claims === undefined || claims.length === 0) return undefined;\n\tconst [first, ...rest] = claims;\n\tif (rest.length === 0) state.activeClaims.delete(commandId);\n\telse state.activeClaims.set(commandId, rest);\n\treturn first;\n}\n\nfunction queueClaimKey(attempt: CqrsWorkQueueAttempt): string {\n\treturn `${attempt.workId}:${attempt.leaseId}:${attempt.queueAttempt}`;\n}\n\nfunction dispositionCommandId(attempt: CqrsWorkQueueAttempt, kind: string): string {\n\treturn `${attempt.command.id}:${attempt.workId}:${attempt.leaseId}:${attempt.queueAttempt}:cqrs-queue-${kind}`;\n}\n\nfunction project<T, TCommand>(\n\tgraph: Graph,\n\truntime: Node<CqrsQueueFact<TCommand>>,\n\tname: string,\n\tfactory: string,\n\tpick: (fact: CqrsQueueFact<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 CqrsQueueFact<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 emit<TCommand>(ctx: Ctx, fact: CqrsQueueFact<TCommand>): void {\n\tctx.down([[\"DATA\", fact]]);\n}\n\nfunction isQueuedPayload<TCommand>(value: unknown): value is CqrsQueuedCommandPayload<TCommand> {\n\tif (!isObjectRecord(value) || value.kind !== \"cqrs-queued-command\") return false;\n\treturn isObjectRecord(value.command) && typeof value.command.id === \"string\";\n}\n\nfunction queueIssue(record: WorkQueueRecord<unknown>, code: string): DataIssue {\n\treturn {\n\t\tkind: \"issue\",\n\t\tcode,\n\t\tmessage: `CQRS workQueue recipe could not map record '${record.kind}'`,\n\t\tseverity: \"error\",\n\t\tsource: \"cqrs.workQueue\",\n\t\trefs: record.workId === undefined ? undefined : [`work-queue-work:${record.workId}`],\n\t\tdetails: record,\n\t};\n}\n\nfunction isObjectRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n","/**\n * Wave-protocol message types and the tier const table.\n *\n * Canonical authority: ~/src/graphrefly/spec/rules.jsonl\n *   R-msg-format, R-msg-closed-set, R-tier (D34), R-data-payload, R-sentinel.\n */\n\n/** Opaque pause-lock / pull identifier (R-pause-lockset, R-pull). */\nexport type LockId = string | symbol;\n\n/** Explicit pull demand payload (D269/D272). Params are holder-visible context, never DATA-up. */\nexport interface PullDemand {\n\treadonly pullId: LockId;\n\treadonly params?: unknown;\n}\n\n/**\n * The CLOSED set of 11 message types (R-msg-closed-set / D9 + D269 + START handshake).\n * No open set, no user-defined custom types. Adding a type is a spec change.\n */\nexport type Message =\n\t| readonly [\"START\"]\n\t| readonly [\"DIRTY\"]\n\t| readonly [\"DATA\", unknown]\n\t| readonly [\"RESOLVED\"]\n\t| readonly [\"INVALIDATE\"]\n\t| readonly [\"COMPLETE\"]\n\t| readonly [\"ERROR\", unknown]\n\t| readonly [\"TEARDOWN\"]\n\t| readonly [\"PAUSE\", LockId]\n\t| readonly [\"RESUME\", LockId]\n\t| readonly [\"PULL\", PullDemand];\n\n/** One array of messages delivered in one call = one Wave (R-wave-boundary). */\nexport type Wave = readonly Message[];\n\n/** The message-type tag (the first tuple element). */\nexport type MessageType = Message[0];\n\n/**\n * SENTINEL = absence-of-DATA (R-sentinel / D16). TS representation is `undefined`.\n * Never a valid DATA payload; `null` IS a valid DATA value (domain-level absence).\n */\nexport const SENTINEL = undefined;\n\n/** R-data-payload: ERROR payloads must not collide with terminal metadata shorthand. */\nexport function isInvalidErrorPayload(v: unknown): boolean {\n\treturn v === SENTINEL || typeof v === \"boolean\";\n}\n\n/** R-data-payload / D78: host-language failures that collide with ctx.terminal shorthand become diagnostics. */\nexport function errorPayload(reason: unknown, fallback = \"error without a valid payload\"): unknown {\n\treturn isInvalidErrorPayload(reason) ? new Error(fallback) : reason;\n}\n\nexport const TIER_START = 0;\nexport const TIER_CONTROL = 1;\nexport const TIER_NOTIFICATION = 2;\nexport const TIER_VALUE = 3;\nexport const TIER_SETTLE = 4;\nexport const TIER_TERMINAL = 5;\nexport const TIER_TEARDOWN = 6;\n\n/**\n * Tier const table (R-tier / D34). Tiers below value dispatch immediately; value\n * and above are batch-deferred. This is a compile-time const table (D18), not runtime config.\n */\nconst TIER: Record<MessageType, number> = {\n\tSTART: TIER_START,\n\tPAUSE: TIER_CONTROL,\n\tRESUME: TIER_CONTROL,\n\tPULL: TIER_CONTROL,\n\tDIRTY: TIER_NOTIFICATION,\n\tDATA: TIER_VALUE,\n\tRESOLVED: TIER_VALUE,\n\tINVALIDATE: TIER_SETTLE,\n\tCOMPLETE: TIER_TERMINAL,\n\tERROR: TIER_TERMINAL,\n\tTEARDOWN: TIER_TEARDOWN,\n};\n\nexport function messageTier(t: MessageType): number {\n\treturn TIER[t];\n}\n\n/** Value and above are deferred inside a batch (DATA/RESOLVED/INVALIDATE/terminal/teardown). */\nexport function isDeferredTier(t: MessageType): boolean {\n\treturn TIER[t] >= TIER_VALUE;\n}\n\n/** Value-tier messages (DATA/RESOLVED) occupy the tier-3 slot. */\nexport function isValueTier(t: MessageType): boolean {\n\treturn TIER[t] === TIER_VALUE;\n}\n\n/** The pause buffer holds the settle slice only: value-tier DATA/RESOLVED plus INVALIDATE. */\nexport function isPauseBufferedTier(t: MessageType): boolean {\n\tconst tier = TIER[t];\n\treturn tier === TIER_VALUE || tier === TIER_SETTLE;\n}\n\n/**\n * A TERMINAL message = tier 5 (COMPLETE | ERROR), R-tier / D34. Detected via the CENTRAL tier\n * table, NOT a per-variant `=== \"COMPLETE\" || === \"ERROR\"` check — so terminal routing stays\n * driven by the one const table (feedback_use_tier_for_signal_routing); discriminate COMPLETE vs\n * ERROR within the tier by the message type only where the handling actually differs.\n */\nexport function isTerminal(t: MessageType): boolean {\n\treturn TIER[t] === TIER_TERMINAL;\n}\n\n/**\n * ctx.up carries control/demand tiers only (R-ctx-up / D269): DIRTY, PAUSE, RESUME, PULL,\n * INVALIDATE, TEARDOWN. DATA/RESOLVED (tier 3) and COMPLETE/ERROR (tier 5) are\n * down-only.\n */\nexport function isUpAllowed(t: MessageType): boolean {\n\tconst tier = TIER[t];\n\treturn tier !== TIER_VALUE && tier !== TIER_TERMINAL;\n}\n","/**\n * The fn-invocation context and per-dep input shapes.\n *\n * Canonical authority: ~/src/graphrefly/spec/rules.jsonl\n *   R-fn-contract (D8/D27), R-ctx-state (D23/D29), R-cleanup-hooks (D28), R-ctx-up.\n */\n\nimport type { Dispatcher } from \"../dispatcher/index.js\";\nimport type { EnvironmentDrivers } from \"../graph/environment.js\";\nimport type { Node } from \"../node/node.js\";\nimport { type Message, type PullDemand, SENTINEL, type Wave } from \"../protocol/messages.js\";\n\n/** A downstream sink callback (the only way to connect to a node's output). */\nexport type Sink = (msg: Message, delivery?: DeliveryMeta) => void;\n\n/** Internal delivery metadata used to preserve the upstream `ctx.down(msgs)` wave boundary. */\nexport interface DeliveryMeta {\n\treadonly wave: object;\n\treadonly last: boolean;\n}\n\n/**\n * Internal current-value reader. It is deliberately a symbol-backed implementation detail:\n * raw ctx exposes `waveData` + `terminal`; helpers below derive from that plus this dep cache.\n */\nexport const CTX_DEP_CACHE: unique symbol = Symbol(\"graphrefly.ctx.depCache\");\n\nexport interface CtxDepCache {\n\treadonly latest: readonly unknown[];\n}\n\n/** Internal node-construction binding for graph-local helper-created deps. */\nexport const CTX_NODE_BINDING: unique symbol = Symbol(\"graphrefly.ctx.nodeBinding\");\n\nexport interface CtxNodeBinding {\n\treadonly dispatcher: Dispatcher;\n\tcreate<T>(factory: () => Node<T>): Node<T>;\n}\n\n/** Per-dep wave projections: dep -> waves -> values/SENTINEL markers. */\nexport type WaveData = readonly (readonly (readonly unknown[])[])[];\n\n/** Terminal metadata parallel to `waveData`: false = none, true = COMPLETE, otherwise ERROR payload. */\nexport type TerminalData = readonly unknown[];\n\nexport function isTerminalNone(t: unknown): boolean {\n\treturn t === false || t === undefined;\n}\n\nexport function isTerminalComplete(t: unknown): t is true {\n\treturn t === true;\n}\n\nexport function isTerminalError(t: unknown): boolean {\n\treturn !isTerminalNone(t) && !isTerminalComplete(t);\n}\n\nexport function terminalErrorValue(t: unknown): unknown {\n\treturn isTerminalError(t) ? t : undefined;\n}\n\n/**\n * Per-node private cross-wave state (R-ctx-state / D23,D29). Default fresh-lifecycle\n * wipe; `persist(true)` keeps it across lifecycle transitions.\n */\nexport interface CtxState {\n\tget<S = unknown>(): S | undefined;\n\tset<S = unknown>(v: S): void;\n\tpersist(on?: boolean): void;\n}\n\n/**\n * Deferred SELF-rewire (R-rewire-deferred / D47). A node fn may, DURING its run, request a\n * mutation of its OWN dep set; the request is QUEUED and applied at the committed wave boundary\n * (after the current wave settles / batch commit / final-lock RESUME) as a fresh wave, reusing\n * R-rewire surgical/Option-C semantics (D42). This is the ONLY legal self-triggered rewire — an\n * IMMEDIATE in-fn `node.subscribeDep/unsubscribeDep/replaceDeps` is the D37 mid-fn feedback-cycle ERROR. An\n * added cached dep pushes `[DIRTY,DATA]` on the boundary wave (R-push-subscribe); a removed dep\n * is drained and, if it loses its last subscriber, `_deactivate`s + fires `onDeactivation`\n * (input-side teardown — the basis for higher-order operator cancellation / abortInFlight).\n */\nexport interface RewireNext {\n\t/** Defer subscribing to a dep (paired with the re-supplied fn — positional fn-deps lock, SD-1). */\n\tsubscribeDep(dep: Node<unknown>, fn: NodeFn): void;\n\t/** Defer unsubscribing from a dep (its source is torn down if it loses its last subscriber). */\n\tunsubscribeDep(dep: Node<unknown>, fn: NodeFn): void;\n\t/** Defer replacing the whole dep set (surgical: kept deps untouched, removed drained, added fresh-subscribe). */\n\treplaceDeps(deps: Node<unknown>[], fn: NodeFn): void;\n}\n\n/**\n * The single argument to a node fn: `(ctx) => void` (R-fn-contract / D8). All emission\n * is explicit via `ctx.down`; there is no return-value framing.\n */\nexport interface Ctx {\n\t/**\n\t * Emit upstream toward deps — control tiers only (R-ctx-up). IMMEDIATE. `towardDep` (a dep index)\n\t * routes the wave up ONE declared edge (R-up-routing directed-up); omitted = broadcast up all deps.\n\t * A pull DEMAND is `up([[PULL, { pullId, params }]])` — but for a SELF-demand (demanding a dep\n\t * this fn also reads) use {@link Ctx.upNext} instead, since an immediate demand whose delivery loops back\n\t * re-enters this fn mid-wave (D37 / R-reentrancy).\n\t */\n\tup(msgs: Wave, towardDep?: number): void;\n\t/** Emit downstream toward sinks. */\n\tdown(msgs: Wave): void;\n\t/**\n\t * The single raw dep-value input surface (R-ctx-wave-data / D77): dep -> upstream waves ->\n\t * per-wave DATA payloads and INVALIDATE/SENTINEL markers. `waveData[i] = []` means dep i\n\t * delivered no wave to this invocation; `waveData[i] = [[]]` means RESOLVED-only.\n\t */\n\twaveData: WaveData;\n\t/** Terminal metadata for the same invocation; terminal values never enter `waveData`. */\n\tterminal: TerminalData;\n\tstate: CtxState;\n\t/** Release external resources on deactivation (R-cleanup-hooks). */\n\tonDeactivation(fn: () => void): void;\n\t/** Flush on INVALIDATE (R-cleanup-hooks). */\n\tonInvalidate(fn: () => void): void;\n\t/** Graph-owned environment drivers for source/adapter boundaries (D130/D131). */\n\tenvironment(): EnvironmentDrivers;\n\t/** Holder-visible context for a PULL-caused invocation (D272); absent for ordinary waves. */\n\treadonly pull?: PullDemand;\n\t/**\n\t * Deferred SELF-rewire (R-rewire-deferred / D47) — the substrate affordance higher-order\n\t * operators (switchMap/mergeMap/concatMap/exhaustMap/flatMap) use to grow/shrink their own\n\t * inner-source dep set in response to their own data. Always present; see {@link RewireNext}.\n\t */\n\trewireNext: RewireNext;\n\t/**\n\t * Deferred up — the boundary-deferred form of {@link Ctx.up} (R-up-routing / R-pull / D59). Routes\n\t * `msgs` up from this node at the COMMITTED wave boundary (broadcast, or up the single `towardDep`\n\t * edge), riding the same R-rewire-deferred (D47) drain as {@link RewireNext}. This is the\n\t * SELF-DEMAND path: a consumer issues `ctx.upNext([[PULL, { pullId, params }]])` to demand a pull\n\t * dep it ALSO reads — the cone-routed PULL reaches the pullId-holder, whose delivery loops back as a\n\t * FRESH wave (not a mid-fn re-entry → no D37). The consumer accepts one-wave latency (the\n\t * HTTP-request model). No node reference needed: the author writes the pullId verbatim.\n\t */\n\tupNext(msgs: Wave, towardDep?: number): void;\n\t/**\n\t * Read a dep's latest value by index (dynamicNode only, R-dynamic-node / D35).\n\t * Present only on dynamicNode fns; all declared deps still participate in wave\n\t * tracking. Under D49/R-resolved-undirty an unread dep's change still fires the fn,\n\t * which re-emits its (unchanged) output as a DATA occurrence — there is NO equals-\n\t * absorption; pair with distinctUntilChanged to suppress unchanged re-emits (opt-in).\n\t */\n\ttrack?(depIndex: number): unknown;\n\t[CTX_DEP_CACHE]?: CtxDepCache;\n\t[CTX_NODE_BINDING]?: CtxNodeBinding;\n}\n\n/** A node fn (R-fn-contract). Registered in a dispatcher pool, indexed by Handle. */\nexport type NodeFn = (ctx: Ctx) => void;\n\n/** Number of declared dep slots visible in this invocation. */\nexport function depCount(ctx: Ctx): number {\n\treturn ctx.waveData.length;\n}\n\n/** DATA/SENTINEL projection batches delivered by one dep in this invocation. */\nexport function depWaves(ctx: Ctx, depIndex: number): readonly (readonly unknown[])[] {\n\treturn ctx.waveData[depIndex] ?? [];\n}\n\n/** Flattened DATA projection for old event-counting operator bodies; null = no wave. */\nexport function depBatch(ctx: Ctx, depIndex: number): readonly unknown[] | null {\n\tconst waves = depWaves(ctx, depIndex);\n\tif (waves.length === 0) return null;\n\tconst flattened = waves.flat().filter((v) => v !== SENTINEL);\n\treturn flattened.length === 0 ? [] : flattened;\n}\n\n/** Latest cached DATA for a dep, derived from implementation-owned dep cache. */\nexport function depLatest(ctx: Ctx, depIndex: number): unknown {\n\treturn ctx[CTX_DEP_CACHE]?.latest[depIndex];\n}\n\n/** Terminal metadata for one dep: false = none, true = COMPLETE, otherwise ERROR payload. */\nexport function depTerminal(ctx: Ctx, depIndex: number): unknown {\n\tconst t = ctx.terminal[depIndex];\n\treturn t === undefined ? false : t;\n}\n"],"mappings":"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","names":[]}

package/dist/cqrs/work-queue.d.cts

@@ -0,0 +1,90 @@
+import { CqrsCommand, CqrsStatus, CqrsError, CqrsErrorCode } from './index.cjs';
+import { DataIssue } from '../data/index.cjs';
+import { d as Graph } from '../graph-DCEWh4T2.cjs';
+import { N as Node } from '../types-CcPIn7sy.cjs';
+import { WorkQueueCommand, WorkQueueRecord } from '../work-queue/index.cjs';
+import '../core/index.cjs';
+import '../messages-CAzUPPJM.cjs';
+import '../codec-BB7p8fJc.cjs';
+import '../describe-DYMw_l1C.cjs';
+import '../messaging/index.cjs';
+
+/**
+ * Optional CQRS-over-workQueue recipe (D350/D352/D353).
+ *
+ * The CQRS core remains synchronous graph-visible command/event truth. This
+ * recipe only maps queue claims to CQRS command facts and maps visible CQRS
+ * outcomes back to generic workQueue disposition commands.
+ */
+
+interface CqrsQueuedCommandPayload<TCommand = unknown> {
+    readonly kind: "cqrs-queued-command";
+    readonly command: CqrsCommand<TCommand>;
+    readonly idempotencyKey?: string;
+    readonly sourceRefs?: readonly string[];
+    readonly policyRefs?: readonly string[];
+    readonly actorRefs?: readonly string[];
+    readonly auditRefs?: readonly string[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface CqrsWorkQueueAttempt<TCommand = unknown> {
+    readonly kind: "cqrs-work-queue-attempt";
+    readonly workId: string;
+    readonly leaseId: string;
+    readonly queueAttempt: number;
+    readonly workerId: string;
+    readonly command: CqrsCommand<TCommand>;
+    readonly payload: CqrsQueuedCommandPayload<TCommand>;
+    readonly sourceRefs?: readonly string[];
+}
+type CqrsWorkQueueAcceptedOutcome = {
+    readonly kind: "accepted";
+    readonly status: CqrsStatus;
+};
+type CqrsWorkQueueRejectedOutcome = {
+    readonly kind: "rejected";
+    readonly status: CqrsStatus;
+    readonly error?: CqrsError;
+};
+type CqrsWorkQueueReleaseOutcome = {
+    readonly kind: "release";
+    readonly reason?: string;
+};
+type CqrsWorkQueueOutcome = CqrsWorkQueueAcceptedOutcome | CqrsWorkQueueRejectedOutcome | CqrsWorkQueueReleaseOutcome;
+interface CqrsWorkQueuePolicy {
+    /**
+     * D352: handler-threw and clock-threw fail retryable:true by default. A
+     * policy may classify a known deterministic handler failure as nonretryable.
+     */
+    readonly retryableFailure?: (errorCode: CqrsErrorCode, outcome: CqrsWorkQueueRejectedOutcome) => boolean;
+    readonly releaseReason?: (attempt: CqrsWorkQueueAttempt) => string | undefined;
+}
+interface CqrsWorkQueueRecipeOptions<TCommand = unknown> {
+    readonly name?: string;
+    readonly records: Node<WorkQueueRecord<CqrsQueuedCommandPayload<TCommand>>>;
+    readonly status: Node<CqrsStatus>;
+    readonly errors?: Node<CqrsError>;
+    readonly workerId?: string;
+    readonly policy?: CqrsWorkQueuePolicy;
+}
+interface CqrsWorkQueueRecipeBundle<TCommand = unknown> {
+    readonly attempts: Node<CqrsWorkQueueAttempt<TCommand>>;
+    readonly dispatches: Node<CqrsCommand<TCommand>>;
+    readonly commands: Node<WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>>>;
+    readonly issues: Node<DataIssue>;
+}
+/** Build the optional D350/D352 CQRS workQueue recipe. */
+declare function cqrsWorkQueueRecipe<TCommand = unknown>(graph: Graph, opts: CqrsWorkQueueRecipeOptions<TCommand>): CqrsWorkQueueRecipeBundle<TCommand>;
+declare function cqrsSubmitCommand<TCommand>(command: CqrsCommand<TCommand>, opts?: {
+    readonly workId?: string;
+    readonly commandId?: string;
+    readonly idempotencyKey?: string;
+    readonly sourceRefs?: readonly string[];
+    readonly policyRefs?: readonly string[];
+    readonly actorRefs?: readonly string[];
+    readonly auditRefs?: readonly string[];
+    readonly metadata?: Record<string, unknown>;
+}): WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>>;
+declare function cqrsWorkQueueDispositionCommand<TCommand>(attempt: CqrsWorkQueueAttempt<TCommand>, outcome: CqrsWorkQueueOutcome, policy?: CqrsWorkQueuePolicy): WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>>;
+
+export { type CqrsQueuedCommandPayload, type CqrsWorkQueueAcceptedOutcome, type CqrsWorkQueueAttempt, type CqrsWorkQueueOutcome, type CqrsWorkQueuePolicy, type CqrsWorkQueueRecipeBundle, type CqrsWorkQueueRecipeOptions, type CqrsWorkQueueRejectedOutcome, type CqrsWorkQueueReleaseOutcome, cqrsSubmitCommand, cqrsWorkQueueDispositionCommand, cqrsWorkQueueRecipe };

package/dist/cqrs/work-queue.d.ts

@@ -0,0 +1,90 @@
+import { CqrsCommand, CqrsStatus, CqrsError, CqrsErrorCode } from './index.js';
+import { DataIssue } from '../data/index.js';
+import { d as Graph } from '../graph-D-1-SQeC.js';
+import { N as Node } from '../types-BsJvElYZ.js';
+import { WorkQueueCommand, WorkQueueRecord } from '../work-queue/index.js';
+import '../core/index.js';
+import '../messages-CAzUPPJM.js';
+import '../codec-BB7p8fJc.js';
+import '../describe-BpyJuWkw.js';
+import '../messaging/index.js';
+
+/**
+ * Optional CQRS-over-workQueue recipe (D350/D352/D353).
+ *
+ * The CQRS core remains synchronous graph-visible command/event truth. This
+ * recipe only maps queue claims to CQRS command facts and maps visible CQRS
+ * outcomes back to generic workQueue disposition commands.
+ */
+
+interface CqrsQueuedCommandPayload<TCommand = unknown> {
+    readonly kind: "cqrs-queued-command";
+    readonly command: CqrsCommand<TCommand>;
+    readonly idempotencyKey?: string;
+    readonly sourceRefs?: readonly string[];
+    readonly policyRefs?: readonly string[];
+    readonly actorRefs?: readonly string[];
+    readonly auditRefs?: readonly string[];
+    readonly metadata?: Record<string, unknown>;
+}
+interface CqrsWorkQueueAttempt<TCommand = unknown> {
+    readonly kind: "cqrs-work-queue-attempt";
+    readonly workId: string;
+    readonly leaseId: string;
+    readonly queueAttempt: number;
+    readonly workerId: string;
+    readonly command: CqrsCommand<TCommand>;
+    readonly payload: CqrsQueuedCommandPayload<TCommand>;
+    readonly sourceRefs?: readonly string[];
+}
+type CqrsWorkQueueAcceptedOutcome = {
+    readonly kind: "accepted";
+    readonly status: CqrsStatus;
+};
+type CqrsWorkQueueRejectedOutcome = {
+    readonly kind: "rejected";
+    readonly status: CqrsStatus;
+    readonly error?: CqrsError;
+};
+type CqrsWorkQueueReleaseOutcome = {
+    readonly kind: "release";
+    readonly reason?: string;
+};
+type CqrsWorkQueueOutcome = CqrsWorkQueueAcceptedOutcome | CqrsWorkQueueRejectedOutcome | CqrsWorkQueueReleaseOutcome;
+interface CqrsWorkQueuePolicy {
+    /**
+     * D352: handler-threw and clock-threw fail retryable:true by default. A
+     * policy may classify a known deterministic handler failure as nonretryable.
+     */
+    readonly retryableFailure?: (errorCode: CqrsErrorCode, outcome: CqrsWorkQueueRejectedOutcome) => boolean;
+    readonly releaseReason?: (attempt: CqrsWorkQueueAttempt) => string | undefined;
+}
+interface CqrsWorkQueueRecipeOptions<TCommand = unknown> {
+    readonly name?: string;
+    readonly records: Node<WorkQueueRecord<CqrsQueuedCommandPayload<TCommand>>>;
+    readonly status: Node<CqrsStatus>;
+    readonly errors?: Node<CqrsError>;
+    readonly workerId?: string;
+    readonly policy?: CqrsWorkQueuePolicy;
+}
+interface CqrsWorkQueueRecipeBundle<TCommand = unknown> {
+    readonly attempts: Node<CqrsWorkQueueAttempt<TCommand>>;
+    readonly dispatches: Node<CqrsCommand<TCommand>>;
+    readonly commands: Node<WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>>>;
+    readonly issues: Node<DataIssue>;
+}
+/** Build the optional D350/D352 CQRS workQueue recipe. */
+declare function cqrsWorkQueueRecipe<TCommand = unknown>(graph: Graph, opts: CqrsWorkQueueRecipeOptions<TCommand>): CqrsWorkQueueRecipeBundle<TCommand>;
+declare function cqrsSubmitCommand<TCommand>(command: CqrsCommand<TCommand>, opts?: {
+    readonly workId?: string;
+    readonly commandId?: string;
+    readonly idempotencyKey?: string;
+    readonly sourceRefs?: readonly string[];
+    readonly policyRefs?: readonly string[];
+    readonly actorRefs?: readonly string[];
+    readonly auditRefs?: readonly string[];
+    readonly metadata?: Record<string, unknown>;
+}): WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>>;
+declare function cqrsWorkQueueDispositionCommand<TCommand>(attempt: CqrsWorkQueueAttempt<TCommand>, outcome: CqrsWorkQueueOutcome, policy?: CqrsWorkQueuePolicy): WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>>;
+
+export { type CqrsQueuedCommandPayload, type CqrsWorkQueueAcceptedOutcome, type CqrsWorkQueueAttempt, type CqrsWorkQueueOutcome, type CqrsWorkQueuePolicy, type CqrsWorkQueueRecipeBundle, type CqrsWorkQueueRecipeOptions, type CqrsWorkQueueRejectedOutcome, type CqrsWorkQueueReleaseOutcome, cqrsSubmitCommand, cqrsWorkQueueDispositionCommand, cqrsWorkQueueRecipe };

package/dist/cqrs/work-queue.js

@@ -0,0 +1,292 @@
+import {
+  depBatch
+} from "../chunk-WQIA3GFB.js";
+import "../chunk-S6HXABGL.js";
+import "../chunk-DGUM43GV.js";
+
+// 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;
+}
+export {
+  cqrsSubmitCommand,
+  cqrsWorkQueueDispositionCommand,
+  cqrsWorkQueueRecipe
+};
+//# sourceMappingURL=work-queue.js.map

package/dist/cqrs/work-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cqrs/work-queue.ts"],"sourcesContent":["/**\n * Optional CQRS-over-workQueue recipe (D350/D352/D353).\n *\n * The CQRS core remains synchronous graph-visible command/event truth. This\n * recipe only maps queue claims to CQRS command facts and maps visible CQRS\n * outcomes back to generic workQueue disposition commands.\n */\n\nimport type { CqrsCommand, CqrsError, CqrsErrorCode, CqrsStatus } from \"../cqrs/index.js\";\nimport { type Ctx, depBatch } from \"../ctx/types.js\";\nimport type { DataIssue } from \"../data/index.js\";\nimport type { Graph } from \"../graph/graph.js\";\nimport type { Node } from \"../node/node.js\";\nimport type { WorkQueueCommand, WorkQueueRecord } from \"../work-queue/index.js\";\n\nexport interface CqrsQueuedCommandPayload<TCommand = unknown> {\n\treadonly kind: \"cqrs-queued-command\";\n\treadonly command: CqrsCommand<TCommand>;\n\treadonly idempotencyKey?: string;\n\treadonly sourceRefs?: readonly string[];\n\treadonly policyRefs?: readonly string[];\n\treadonly actorRefs?: readonly string[];\n\treadonly auditRefs?: readonly string[];\n\treadonly metadata?: Record<string, unknown>;\n}\n\nexport interface CqrsWorkQueueAttempt<TCommand = unknown> {\n\treadonly kind: \"cqrs-work-queue-attempt\";\n\treadonly workId: string;\n\treadonly leaseId: string;\n\treadonly queueAttempt: number;\n\treadonly workerId: string;\n\treadonly command: CqrsCommand<TCommand>;\n\treadonly payload: CqrsQueuedCommandPayload<TCommand>;\n\treadonly sourceRefs?: readonly string[];\n}\n\nexport type CqrsWorkQueueAcceptedOutcome = {\n\treadonly kind: \"accepted\";\n\treadonly status: CqrsStatus;\n};\n\nexport type CqrsWorkQueueRejectedOutcome = {\n\treadonly kind: \"rejected\";\n\treadonly status: CqrsStatus;\n\treadonly error?: CqrsError;\n};\n\nexport type CqrsWorkQueueReleaseOutcome = {\n\treadonly kind: \"release\";\n\treadonly reason?: string;\n};\n\nexport type CqrsWorkQueueOutcome =\n\t| CqrsWorkQueueAcceptedOutcome\n\t| CqrsWorkQueueRejectedOutcome\n\t| CqrsWorkQueueReleaseOutcome;\n\nexport interface CqrsWorkQueuePolicy {\n\t/**\n\t * D352: handler-threw and clock-threw fail retryable:true by default. A\n\t * policy may classify a known deterministic handler failure as nonretryable.\n\t */\n\treadonly retryableFailure?: (\n\t\terrorCode: CqrsErrorCode,\n\t\toutcome: CqrsWorkQueueRejectedOutcome,\n\t) => boolean;\n\treadonly releaseReason?: (attempt: CqrsWorkQueueAttempt) => string | undefined;\n}\n\nexport interface CqrsWorkQueueRecipeOptions<TCommand = unknown> {\n\treadonly name?: string;\n\treadonly records: Node<WorkQueueRecord<CqrsQueuedCommandPayload<TCommand>>>;\n\treadonly status: Node<CqrsStatus>;\n\treadonly errors?: Node<CqrsError>;\n\treadonly workerId?: string;\n\treadonly policy?: CqrsWorkQueuePolicy;\n}\n\nexport interface CqrsWorkQueueRecipeBundle<TCommand = unknown> {\n\treadonly attempts: Node<CqrsWorkQueueAttempt<TCommand>>;\n\treadonly dispatches: Node<CqrsCommand<TCommand>>;\n\treadonly commands: Node<WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>>>;\n\treadonly issues: Node<DataIssue>;\n}\n\ntype CqrsQueueFact<TCommand> =\n\t| { readonly kind: \"attempt\"; readonly attempt: CqrsWorkQueueAttempt<TCommand> }\n\t| { readonly kind: \"dispatch\"; readonly command: CqrsCommand<TCommand> }\n\t| {\n\t\t\treadonly kind: \"command\";\n\t\t\treadonly command: WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>>;\n\t  }\n\t| { readonly kind: \"issue\"; readonly issue: DataIssue };\n\ninterface CqrsQueueState<TCommand> {\n\treadonly payloads: Map<string, CqrsQueuedCommandPayload<TCommand>>;\n\treadonly activeClaims: Map<string, CqrsWorkQueueAttempt<TCommand>[]>;\n\treadonly errors: Map<string, CqrsError>;\n\treadonly terminalClaims: Set<string>;\n}\n\n/** Build the optional D350/D352 CQRS workQueue recipe. */\nexport function cqrsWorkQueueRecipe<TCommand = unknown>(\n\tgraph: Graph,\n\topts: CqrsWorkQueueRecipeOptions<TCommand>,\n): CqrsWorkQueueRecipeBundle<TCommand> {\n\tconst name = opts.name ?? \"cqrsWorkQueue\";\n\tconst deps =\n\t\topts.errors === undefined\n\t\t\t? [opts.records, opts.status]\n\t\t\t: [opts.records, opts.status, opts.errors];\n\tconst runtime = graph.node<CqrsQueueFact<TCommand>>(\n\t\tdeps,\n\t\t(ctx) => {\n\t\t\tconst state = ctx.state.get<CqrsQueueState<TCommand>>() ?? emptyState<TCommand>();\n\t\t\tfor (const raw of depBatch(ctx, 0) ?? []) {\n\t\t\t\treduceRecord(ctx, state, raw as WorkQueueRecord<CqrsQueuedCommandPayload<TCommand>>, opts);\n\t\t\t}\n\t\t\tif (opts.errors !== undefined) {\n\t\t\t\tfor (const raw of depBatch(ctx, 2) ?? []) {\n\t\t\t\t\tconst error = raw as CqrsError;\n\t\t\t\t\tif (error.commandId !== undefined) state.errors.set(error.commandId, error);\n\t\t\t\t}\n\t\t\t}\n\t\t\tfor (const raw of depBatch(ctx, 1) ?? []) {\n\t\t\t\treduceStatus(ctx, state, raw as CqrsStatus, opts);\n\t\t\t}\n\t\t\tctx.state.set(state);\n\t\t},\n\t\t{\n\t\t\tname: `${name}/runtime`,\n\t\t\tfactory: \"cqrsWorkQueueRuntime\",\n\t\t\tpartial: true,\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n\treturn {\n\t\tattempts: project(graph, runtime, `${name}/attempts`, \"cqrsWorkQueueAttempts\", (fact) =>\n\t\t\tfact.kind === \"attempt\" ? fact.attempt : undefined,\n\t\t),\n\t\tdispatches: project(graph, runtime, `${name}/dispatches`, \"cqrsWorkQueueDispatches\", (fact) =>\n\t\t\tfact.kind === \"dispatch\" ? fact.command : undefined,\n\t\t),\n\t\tcommands: project(graph, runtime, `${name}/commands`, \"cqrsWorkQueueCommands\", (fact) =>\n\t\t\tfact.kind === \"command\" ? fact.command : undefined,\n\t\t),\n\t\tissues: project(graph, runtime, `${name}/issues`, \"cqrsWorkQueueIssues\", (fact) =>\n\t\t\tfact.kind === \"issue\" ? fact.issue : undefined,\n\t\t),\n\t};\n}\n\nexport function cqrsSubmitCommand<TCommand>(\n\tcommand: CqrsCommand<TCommand>,\n\topts: {\n\t\treadonly workId?: string;\n\t\treadonly commandId?: string;\n\t\treadonly idempotencyKey?: string;\n\t\treadonly sourceRefs?: readonly string[];\n\t\treadonly policyRefs?: readonly string[];\n\t\treadonly actorRefs?: readonly string[];\n\t\treadonly auditRefs?: readonly string[];\n\t\treadonly metadata?: Record<string, unknown>;\n\t} = {},\n): WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>> {\n\tconst payload: CqrsQueuedCommandPayload<TCommand> = {\n\t\tkind: \"cqrs-queued-command\",\n\t\tcommand,\n\t\tidempotencyKey: opts.idempotencyKey ?? command.id,\n\t\tsourceRefs: opts.sourceRefs,\n\t\tpolicyRefs: opts.policyRefs,\n\t\tactorRefs: opts.actorRefs,\n\t\tauditRefs: opts.auditRefs,\n\t\tmetadata: opts.metadata,\n\t};\n\treturn {\n\t\tkind: \"submit\",\n\t\tcommandId: opts.commandId ?? `${command.id}:cqrs-work-queue-submit`,\n\t\tworkId: opts.workId ?? `cqrs:${command.id}`,\n\t\tpayload,\n\t\tidempotencyKey: opts.idempotencyKey ?? command.id,\n\t\tsourceRefs: opts.sourceRefs,\n\t\tpolicyRefs: opts.policyRefs,\n\t\tactorRefs: opts.actorRefs,\n\t\tauditRefs: opts.auditRefs,\n\t};\n}\n\nexport function cqrsWorkQueueDispositionCommand<TCommand>(\n\tattempt: CqrsWorkQueueAttempt<TCommand>,\n\toutcome: CqrsWorkQueueOutcome,\n\tpolicy?: CqrsWorkQueuePolicy,\n): WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>> {\n\tif (outcome.kind === \"release\") {\n\t\treturn {\n\t\t\tkind: \"release\",\n\t\t\tcommandId: dispositionCommandId(attempt, \"release\"),\n\t\t\tworkId: attempt.workId,\n\t\t\tleaseId: attempt.leaseId,\n\t\t\tattempt: attempt.queueAttempt,\n\t\t\tworkerId: attempt.workerId,\n\t\t\treason: outcome.reason ?? policy?.releaseReason?.(attempt),\n\t\t};\n\t}\n\tif (outcome.kind === \"accepted\") {\n\t\treturn completeCommand(attempt, {\n\t\t\tkind: \"cqrs-accepted-result\",\n\t\t\tcommandId: outcome.status.commandId,\n\t\t\tcommandType: outcome.status.commandType,\n\t\t\teventCount: outcome.status.eventCount,\n\t\t\tcursor: outcome.status.cursor,\n\t\t});\n\t}\n\tconst code = outcome.status.errorCode;\n\tif (code === \"handler-threw\" || code === \"clock-threw\" || code === undefined) {\n\t\treturn {\n\t\t\tkind: \"fail\",\n\t\t\tcommandId: dispositionCommandId(attempt, \"fail\"),\n\t\t\tworkId: attempt.workId,\n\t\t\tleaseId: attempt.leaseId,\n\t\t\tattempt: attempt.queueAttempt,\n\t\t\tworkerId: attempt.workerId,\n\t\t\terror: outcome.error ?? {\n\t\t\t\tkind: \"issue\",\n\t\t\t\tcode: code ?? \"cqrs-outcome-ambiguous\",\n\t\t\t\tmessage: \"CQRS rejected without deterministic rejection evidence\",\n\t\t\t},\n\t\t\tretryable: code === undefined ? true : (policy?.retryableFailure?.(code, outcome) ?? true),\n\t\t};\n\t}\n\treturn completeCommand(attempt, {\n\t\tkind: \"cqrs-rejected-result\",\n\t\tcommandId: outcome.status.commandId,\n\t\tcommandType: outcome.status.commandType,\n\t\terrorCode: code,\n\t\terror: outcome.error,\n\t\teventCount: outcome.status.eventCount,\n\t\tcursor: outcome.status.cursor,\n\t});\n}\n\nfunction completeCommand<TCommand>(\n\tattempt: CqrsWorkQueueAttempt<TCommand>,\n\tresult: unknown,\n): WorkQueueCommand<CqrsQueuedCommandPayload<TCommand>> {\n\treturn {\n\t\tkind: \"complete\",\n\t\tcommandId: dispositionCommandId(attempt, \"complete\"),\n\t\tworkId: attempt.workId,\n\t\tleaseId: attempt.leaseId,\n\t\tattempt: attempt.queueAttempt,\n\t\tworkerId: attempt.workerId,\n\t\tresult,\n\t};\n}\n\nfunction reduceRecord<TCommand>(\n\tctx: Ctx,\n\tstate: CqrsQueueState<TCommand>,\n\trecord: WorkQueueRecord<CqrsQueuedCommandPayload<TCommand>>,\n\topts: CqrsWorkQueueRecipeOptions<TCommand>,\n): void {\n\tif (record.kind === \"work-admitted\") {\n\t\tif (isQueuedPayload(record.payload)) state.payloads.set(record.workId, record.payload);\n\t\telse emit(ctx, { kind: \"issue\", issue: queueIssue(record, \"cqrs-queue-malformed-payload\") });\n\t\treturn;\n\t}\n\tif (record.kind !== \"work-claimed\") return;\n\tif (opts.workerId !== undefined && record.workerId !== opts.workerId) return;\n\tconst payload = state.payloads.get(record.workId);\n\tif (payload === undefined) {\n\t\temit(ctx, { kind: \"issue\", issue: queueIssue(record, \"cqrs-claim-without-payload\") });\n\t\temit(ctx, {\n\t\t\tkind: \"command\",\n\t\t\tcommand: {\n\t\t\t\tkind: \"release\",\n\t\t\t\tcommandId: `cqrs:${record.workId}:${record.leaseId}:${record.attempt}:release-no-payload`,\n\t\t\t\tworkId: record.workId,\n\t\t\t\tleaseId: record.leaseId,\n\t\t\t\tattempt: record.attempt,\n\t\t\t\tworkerId: record.workerId,\n\t\t\t\treason: \"cqrs-claim-without-payload\",\n\t\t\t},\n\t\t});\n\t\treturn;\n\t}\n\tconst attempt: CqrsWorkQueueAttempt<TCommand> = {\n\t\tkind: \"cqrs-work-queue-attempt\",\n\t\tworkId: record.workId,\n\t\tleaseId: record.leaseId,\n\t\tqueueAttempt: record.attempt,\n\t\tworkerId: record.workerId,\n\t\tcommand: payload.command,\n\t\tpayload,\n\t\tsourceRefs: [...(payload.sourceRefs ?? []), `work-queue-record:${record.recordSeq}`],\n\t};\n\tpushActiveClaim(state, payload.command.id, attempt);\n\temit(ctx, { kind: \"attempt\", attempt });\n\temit(ctx, { kind: \"dispatch\", command: payload.command });\n}\n\nfunction reduceStatus<TCommand>(\n\tctx: Ctx,\n\tstate: CqrsQueueState<TCommand>,\n\tstatus: CqrsStatus,\n\topts: CqrsWorkQueueRecipeOptions<TCommand>,\n): void {\n\tif (status.commandId === undefined) return;\n\tconst attempt = shiftActiveClaim(state, status.commandId);\n\tif (attempt === undefined) {\n\t\temit(ctx, {\n\t\t\tkind: \"issue\",\n\t\t\tissue: {\n\t\t\t\tkind: \"issue\",\n\t\t\t\tcode: \"cqrs-status-without-active-queue-claim\",\n\t\t\t\tmessage:\n\t\t\t\t\t\"CQRS workQueue recipe observed a CQRS status without an active queue claim; no queue disposition was emitted\",\n\t\t\t\tseverity: \"error\",\n\t\t\t\tsource: \"cqrs.workQueue\",\n\t\t\t\trefs: [`cqrs-command:${status.commandId}`],\n\t\t\t\tdetails: status,\n\t\t\t},\n\t\t});\n\t\treturn;\n\t}\n\tconst claimKey = queueClaimKey(attempt);\n\tif (state.terminalClaims.has(claimKey)) {\n\t\temit(ctx, {\n\t\t\tkind: \"issue\",\n\t\t\tissue: {\n\t\t\t\tkind: \"issue\",\n\t\t\t\tcode: \"cqrs-duplicate-terminal-outcome-for-queue-claim\",\n\t\t\t\tmessage: `CQRS queue claim '${claimKey}' already produced a terminal queue disposition`,\n\t\t\t\trefs: [`cqrs-command:${status.commandId}`, `work-queue-work:${attempt.workId}`],\n\t\t\t},\n\t\t});\n\t\treturn;\n\t}\n\tstate.terminalClaims.add(claimKey);\n\tconst command = cqrsWorkQueueDispositionCommand(\n\t\tattempt,\n\t\tstatus.state === \"accepted\"\n\t\t\t? { kind: \"accepted\", status }\n\t\t\t: { kind: \"rejected\", status, error: state.errors.get(status.commandId) },\n\t\topts.policy,\n\t);\n\temit(ctx, { kind: \"command\", command });\n}\n\nfunction emptyState<TCommand>(): CqrsQueueState<TCommand> {\n\treturn {\n\t\tpayloads: new Map(),\n\t\tactiveClaims: new Map(),\n\t\terrors: new Map(),\n\t\tterminalClaims: new Set(),\n\t};\n}\n\nfunction pushActiveClaim<TCommand>(\n\tstate: CqrsQueueState<TCommand>,\n\tcommandId: string,\n\tattempt: CqrsWorkQueueAttempt<TCommand>,\n): void {\n\tconst claims = state.activeClaims.get(commandId) ?? [];\n\tstate.activeClaims.set(commandId, [...claims, attempt]);\n}\n\nfunction shiftActiveClaim<TCommand>(\n\tstate: CqrsQueueState<TCommand>,\n\tcommandId: string,\n): CqrsWorkQueueAttempt<TCommand> | undefined {\n\tconst claims = state.activeClaims.get(commandId);\n\tif (claims === undefined || claims.length === 0) return undefined;\n\tconst [first, ...rest] = claims;\n\tif (rest.length === 0) state.activeClaims.delete(commandId);\n\telse state.activeClaims.set(commandId, rest);\n\treturn first;\n}\n\nfunction queueClaimKey(attempt: CqrsWorkQueueAttempt): string {\n\treturn `${attempt.workId}:${attempt.leaseId}:${attempt.queueAttempt}`;\n}\n\nfunction dispositionCommandId(attempt: CqrsWorkQueueAttempt, kind: string): string {\n\treturn `${attempt.command.id}:${attempt.workId}:${attempt.leaseId}:${attempt.queueAttempt}:cqrs-queue-${kind}`;\n}\n\nfunction project<T, TCommand>(\n\tgraph: Graph,\n\truntime: Node<CqrsQueueFact<TCommand>>,\n\tname: string,\n\tfactory: string,\n\tpick: (fact: CqrsQueueFact<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 CqrsQueueFact<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 emit<TCommand>(ctx: Ctx, fact: CqrsQueueFact<TCommand>): void {\n\tctx.down([[\"DATA\", fact]]);\n}\n\nfunction isQueuedPayload<TCommand>(value: unknown): value is CqrsQueuedCommandPayload<TCommand> {\n\tif (!isObjectRecord(value) || value.kind !== \"cqrs-queued-command\") return false;\n\treturn isObjectRecord(value.command) && typeof value.command.id === \"string\";\n}\n\nfunction queueIssue(record: WorkQueueRecord<unknown>, code: string): DataIssue {\n\treturn {\n\t\tkind: \"issue\",\n\t\tcode,\n\t\tmessage: `CQRS workQueue recipe could not map record '${record.kind}'`,\n\t\tseverity: \"error\",\n\t\tsource: \"cqrs.workQueue\",\n\t\trefs: record.workId === undefined ? undefined : [`work-queue-work:${record.workId}`],\n\t\tdetails: record,\n\t};\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/data/index.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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/data/index.ts
+var data_exports = {};
+module.exports = __toCommonJS(data_exports);
+//# sourceMappingURL=index.cjs.map

package/dist/data/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/data/index.ts"],"sourcesContent":["/**\n * Passive DATA-level result vocabulary (D184).\n *\n * These shapes are ordinary payload facts. They are not protocol ERROR messages and\n * carry no wave terminal or lifecycle semantics.\n */\n\nexport interface DataIssue {\n\treadonly kind: \"issue\";\n\treadonly code: string;\n\treadonly message: string;\n\treadonly severity?: \"info\" | \"warning\" | \"error\";\n\treadonly source?: string;\n\treadonly subjectId?: string;\n\treadonly correlationId?: string;\n\treadonly causationId?: string;\n\treadonly path?: readonly (string | number)[];\n\treadonly refs?: readonly string[];\n\treadonly retryable?: boolean;\n\treadonly details?: unknown;\n\treadonly metadata?: Record<string, unknown>;\n}\n\nexport interface DataOk<T> {\n\treadonly kind: \"ok\";\n\treadonly value: T;\n\treadonly issues?: readonly DataIssue[];\n\treadonly metadata?: Record<string, unknown>;\n}\n\nexport interface DataError<E extends DataIssue = DataIssue> {\n\treadonly kind: \"error\";\n\treadonly error: E;\n\treadonly issues?: readonly DataIssue[];\n\treadonly metadata?: Record<string, unknown>;\n}\n\nexport type DataResult<T, E extends DataIssue = DataIssue> = DataOk<T> | DataError<E>;\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}