@graphrefly/ts 0.0.0 → 0.0.1

package/dist/chunk-VTHLCFN4.js

@@ -0,0 +1,368 @@
+import {
+  eventMessageIssue
+} from "./chunk-QFY4AFY4.js";
+import {
+  depBatch
+} from "./chunk-WQIA3GFB.js";
+
+// src/patterns/event-flow.ts
+function eventFlow(graph, opts) {
+  const name = opts.name ?? opts.flowId ?? "eventFlow";
+  const flowId = opts.flowId ?? name;
+  const now = opts.now ?? Date.now;
+  const sources = normalizeSources(opts.sources);
+  const runtime = graph.node(
+    sources.map((source) => source.node),
+    (ctx) => {
+      const state = ctx.state.get() ?? {
+        recordSeq: 0,
+        auditSeq: 0,
+        highWater: /* @__PURE__ */ new Map()
+      };
+      ctx.state.persist(true);
+      for (let i = 0; i < sources.length; i++) {
+        const source = sources[i];
+        for (const raw of depBatch(ctx, i) ?? []) {
+          reduceEventSource(
+            raw,
+            source.source,
+            flowId,
+            now(),
+            state,
+            (fact) => ctx.down([["DATA", fact]])
+          );
+        }
+      }
+      ctx.state.set(state);
+    },
+    {
+      name: `${name}/runtime`,
+      factory: "eventFlowRuntime",
+      meta: { flowId, sources: sources.map((source) => source.source) },
+      partial: true,
+      completeWhenDepsComplete: false,
+      errorWhenDepsError: false
+    }
+  );
+  return {
+    records: runtimeProjection(graph, runtime, "record", `${name}/records`, "eventFlowRecords"),
+    status: runtimeProjection(graph, runtime, "status", `${name}/status`, "eventFlowStatus"),
+    issues: runtimeProjection(graph, runtime, "issue", `${name}/issues`, "eventFlowIssues"),
+    audit: runtimeProjection(graph, runtime, "audit", `${name}/audit`, "eventFlowAudit"),
+    highWater: runtimeProjection(
+      graph,
+      runtime,
+      "high-water",
+      `${name}/highWater`,
+      "eventFlowHighWater"
+    )
+  };
+}
+function eventFlowProjection(graph, flowOrRecords, opts) {
+  const records = isEventFlowBundle(flowOrRecords) ? flowOrRecords.records : flowOrRecords;
+  const name = opts.name ?? opts.projectionId ?? "eventFlowProjection";
+  const projectionId = opts.projectionId ?? name;
+  const now = opts.now ?? Date.now;
+  const runtime = graph.node(
+    [records],
+    (ctx) => {
+      const state = ctx.state.get() ?? {
+        value: opts.initial,
+        highWater: emptyHighWater(projectionId),
+        sourceHighWater: /* @__PURE__ */ new Map()
+      };
+      ctx.state.persist(true);
+      for (const raw of depBatch(ctx, 0) ?? []) {
+        const record = raw;
+        try {
+          state.value = opts.reduce(state.value, record);
+          state.highWater = projectionHighWater(projectionId, record, state.sourceHighWater);
+          ctx.down([
+            ["DATA", { kind: "frame", frame: { state: state.value, highWater: state.highWater } }],
+            [
+              "DATA",
+              {
+                kind: "status",
+                status: {
+                  kind: "projected",
+                  projectionId,
+                  recordSeq: record.recordSeq,
+                  timestampMs: now()
+                }
+              }
+            ],
+            ["DATA", { kind: "high-water", highWater: state.highWater }]
+          ]);
+        } catch (error) {
+          const issue = dataIssue(
+            "event-flow-projection-threw",
+            error instanceof Error ? error.message : "eventFlowProjection reducer threw",
+            { projectionId, record }
+          );
+          ctx.down([
+            ["DATA", { kind: "issue", issue }],
+            [
+              "DATA",
+              {
+                kind: "status",
+                status: {
+                  kind: "rejected",
+                  projectionId,
+                  recordSeq: record.recordSeq,
+                  issueCode: issue.code,
+                  timestampMs: now()
+                }
+              }
+            ]
+          ]);
+        }
+      }
+      ctx.state.set(state);
+    },
+    {
+      name: `${name}/runtime`,
+      factory: "eventFlowProjectionRuntime",
+      meta: { projectionId },
+      completeWhenDepsComplete: false,
+      errorWhenDepsError: false
+    }
+  );
+  return {
+    frames: projectionRuntime(
+      graph,
+      runtime,
+      "frame",
+      `${name}/frames`,
+      "eventFlowProjectionFrames"
+    ),
+    snapshot: projectionRuntime(
+      graph,
+      runtime,
+      "frame",
+      `${name}/snapshot`,
+      "eventFlowProjectionSnapshot",
+      (fact) => fact.frame.state
+    ),
+    status: projectionRuntime(
+      graph,
+      runtime,
+      "status",
+      `${name}/status`,
+      "eventFlowProjectionStatus"
+    ),
+    issues: projectionRuntime(
+      graph,
+      runtime,
+      "issue",
+      `${name}/issues`,
+      "eventFlowProjectionIssues"
+    ),
+    highWater: projectionRuntime(
+      graph,
+      runtime,
+      "high-water",
+      `${name}/highWater`,
+      "eventFlowProjectionHighWater"
+    )
+  };
+}
+function reduceEventSource(raw, source, flowId, timestampMs, state, emit) {
+  const normalized = normalizeInput(raw, source);
+  if (normalized.issue !== void 0) {
+    const status2 = {
+      kind: "rejected",
+      flowId,
+      source: normalized.source,
+      issueCode: normalized.issue.code,
+      timestampMs
+    };
+    const audit2 = auditRecord(flowId, state, "rejected", timestampMs, {
+      source: normalized.source,
+      issueCode: normalized.issue.code
+    });
+    emit({ kind: "issue", issue: normalized.issue });
+    emit({ kind: "status", status: status2 });
+    emit({ kind: "audit", audit: audit2 });
+    emit({ kind: "high-water", highWater: highWaterSnapshot(flowId, state) });
+    return;
+  }
+  const recordSeq = ++state.recordSeq;
+  const record = {
+    recordSeq,
+    flowId,
+    event: normalized.event,
+    source: normalized.source,
+    observedAtMs: timestampMs,
+    ...normalized.event.correlationId === void 0 ? {} : { correlationId: normalized.event.correlationId },
+    ...normalized.event.causationId === void 0 ? {} : { causationId: normalized.event.causationId }
+  };
+  state.highWater.set(sourceKey(normalized.source), {
+    source: normalized.source.source,
+    ...normalized.source.topic === void 0 ? {} : { topic: normalized.source.topic },
+    ...normalized.source.seq === void 0 ? {} : { seq: normalized.source.seq },
+    messageId: normalized.event.id,
+    recordSeq
+  });
+  const audit = auditRecord(flowId, state, "recorded", timestampMs, {
+    source: normalized.source,
+    eventId: normalized.event.id,
+    eventType: normalized.event.type
+  });
+  const highWater = highWaterSnapshot(flowId, state);
+  const status = {
+    kind: "recorded",
+    flowId,
+    recordSeq,
+    eventId: normalized.event.id,
+    eventType: normalized.event.type,
+    source: normalized.source,
+    timestampMs
+  };
+  emit({ kind: "record", record });
+  emit({ kind: "status", status });
+  emit({ kind: "audit", audit });
+  emit({ kind: "high-water", highWater });
+}
+function normalizeInput(raw, source) {
+  const envelope = messageEnvelopeOf(raw);
+  const value = envelope?.payload ?? raw;
+  const sourceRef = envelope === void 0 ? { source, ...eventIdOf(value) === void 0 ? {} : { messageId: eventIdOf(value) } } : {
+    source,
+    topic: envelope.topic,
+    seq: envelope.seq,
+    messageId: envelope.payload.id,
+    ...envelope.idempotencyKey === void 0 ? {} : { idempotencyKey: envelope.idempotencyKey }
+  };
+  const issue = eventMessageIssue(value);
+  if (issue !== void 0) {
+    return {
+      source: sourceRef,
+      issue: dataIssue(issue.code, issue.message, { source: sourceRef, value })
+    };
+  }
+  return { event: value, source: sourceRef };
+}
+function messageEnvelopeOf(value) {
+  if (!isRecord(value)) return void 0;
+  if (typeof value.topic !== "string" || !Number.isInteger(value.seq) || typeof value.timestampMs !== "number" || !("payload" in value)) {
+    return void 0;
+  }
+  const payloadIssue = eventMessageIssue(value.payload);
+  return payloadIssue === void 0 ? value : void 0;
+}
+function normalizeSources(sources) {
+  if (sources.length === 0) throw new Error("eventFlow: sources must be non-empty");
+  return sources.map((source, index) => {
+    if (isRecord(source) && "node" in source) {
+      if (typeof source.source !== "string" || source.source.length === 0) {
+        throw new Error("eventFlow: source name must be non-empty");
+      }
+      return source;
+    }
+    return { source: `source-${index}`, node: source };
+  });
+}
+function runtimeProjection(graph, runtime, kind, name, factory) {
+  return graph.node(
+    [runtime],
+    (ctx) => {
+      for (const fact of depBatch(ctx, 0) ?? []) {
+        const typed = fact;
+        if (typed.kind === kind) ctx.down([["DATA", valueOfRuntimeFact(typed)]]);
+      }
+    },
+    { name, factory, completeWhenDepsComplete: false, errorWhenDepsError: false }
+  );
+}
+function projectionRuntime(graph, runtime, kind, name, factory, map = valueOfRuntimeFact) {
+  return graph.node(
+    [runtime],
+    (ctx) => {
+      for (const fact of depBatch(ctx, 0) ?? []) {
+        const typed = fact;
+        if (typed.kind === kind) ctx.down([["DATA", map(typed)]]);
+      }
+    },
+    { name, factory, completeWhenDepsComplete: false, errorWhenDepsError: false }
+  );
+}
+function valueOfRuntimeFact(fact) {
+  if ("record" in fact) return fact.record;
+  if ("status" in fact) return fact.status;
+  if ("issue" in fact) return fact.issue;
+  if ("audit" in fact) return fact.audit;
+  if ("highWater" in fact) return fact.highWater;
+  if ("frame" in fact) return fact.frame;
+  return void 0;
+}
+function auditRecord(flowId, state, outcome, timestampMs, opts) {
+  return {
+    seq: ++state.auditSeq,
+    flowId,
+    outcome,
+    ...opts.eventId === void 0 ? {} : { eventId: opts.eventId },
+    ...opts.eventType === void 0 ? {} : { eventType: opts.eventType },
+    ...opts.issueCode === void 0 ? {} : { issueCode: opts.issueCode },
+    ...opts.source === void 0 ? {} : { source: opts.source },
+    highWater: highWaterSnapshot(flowId, state),
+    timestampMs
+  };
+}
+function highWaterSnapshot(flowId, state) {
+  return {
+    flowId,
+    recordSeq: state.recordSeq,
+    auditSeq: state.auditSeq,
+    sources: [...state.highWater.values()].sort(
+      (a, b) => a.source.localeCompare(b.source) || (a.topic ?? "").localeCompare(b.topic ?? "")
+    )
+  };
+}
+function emptyHighWater(flowId) {
+  return { flowId, recordSeq: 0, auditSeq: 0, sources: [] };
+}
+function projectionHighWater(flowId, record, sourceHighWater) {
+  sourceHighWater.set(sourceKey(record.source), {
+    source: record.source.source,
+    ...record.source.topic === void 0 ? {} : { topic: record.source.topic },
+    ...record.source.seq === void 0 ? {} : { seq: record.source.seq },
+    messageId: record.event.id,
+    recordSeq: record.recordSeq
+  });
+  return {
+    flowId,
+    recordSeq: record.recordSeq,
+    auditSeq: 0,
+    sources: [...sourceHighWater.values()].sort(
+      (a, b) => a.source.localeCompare(b.source) || (a.topic ?? "").localeCompare(b.topic ?? "")
+    )
+  };
+}
+function sourceKey(source) {
+  return `${source.source}\0${source.topic ?? ""}`;
+}
+function eventIdOf(value) {
+  return isRecord(value) && typeof value.id === "string" ? value.id : void 0;
+}
+function dataIssue(code, message, details) {
+  return {
+    kind: "issue",
+    code,
+    message,
+    severity: "error",
+    source: "eventFlow",
+    ...details === void 0 ? {} : { details }
+  };
+}
+function isEventFlowBundle(value) {
+  return isRecord(value) && "records" in value && "highWater" in value;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+export {
+  eventFlow,
+  eventFlowProjection
+};
+//# sourceMappingURL=chunk-VTHLCFN4.js.map

package/dist/chunk-VTHLCFN4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/patterns/event-flow.ts"],"sourcesContent":["/**\n * Event-flow projector helpers (D326/D329/D331).\n *\n * eventFlow consumes declared graph sources that emit EventMessage or\n * MessageEnvelope<EventMessage>. It records projection facts and high-water over\n * source coordinates; it does not own topics, subscriptions, cursors, retention,\n * ack/seek/close, queues, workers, or dead-letter policy.\n */\n\nimport { depBatch } from \"../ctx/types.js\";\nimport type { DataIssue } from \"../data/index.js\";\nimport type { Graph } from \"../graph/graph.js\";\nimport type { EventMessage, MessageEnvelope } from \"../messaging/index.js\";\nimport { eventMessageIssue } from \"../messaging/index.js\";\nimport type { Node } from \"../node/node.js\";\n\nexport interface EventFlowSource<T = unknown> {\n\treadonly source: string;\n\treadonly node: Node<EventMessage<T> | MessageEnvelope<EventMessage<T>> | unknown>;\n}\n\nexport type EventFlowSourceInput<T = unknown> =\n\t| Node<EventMessage<T> | MessageEnvelope<EventMessage<T>> | unknown>\n\t| EventFlowSource<T>;\n\nexport interface EventFlowSourceRef {\n\treadonly source: string;\n\treadonly topic?: string;\n\treadonly seq?: number;\n\treadonly messageId?: string;\n\treadonly idempotencyKey?: string;\n}\n\nexport interface EventFlowRecord<T = unknown> {\n\treadonly recordSeq: number;\n\treadonly flowId: string;\n\treadonly event: EventMessage<T>;\n\treadonly source: EventFlowSourceRef;\n\treadonly observedAtMs: number;\n\treadonly correlationId?: string;\n\treadonly causationId?: string;\n}\n\nexport interface EventFlowStatus {\n\treadonly kind: \"recorded\" | \"rejected\" | \"projection-ready\" | \"projection-stale\";\n\treadonly flowId: string;\n\treadonly recordSeq?: number;\n\treadonly eventId?: string;\n\treadonly eventType?: string;\n\treadonly source?: EventFlowSourceRef;\n\treadonly issueCode?: string;\n\treadonly timestampMs: number;\n}\n\nexport interface EventFlowAuditRecord {\n\treadonly seq: number;\n\treadonly flowId: string;\n\treadonly outcome: \"recorded\" | \"rejected\";\n\treadonly eventId?: string;\n\treadonly eventType?: string;\n\treadonly issueCode?: string;\n\treadonly source?: EventFlowSourceRef;\n\treadonly highWater: EventFlowHighWater;\n\treadonly timestampMs: number;\n}\n\nexport interface EventFlowSourceHighWater {\n\treadonly source: string;\n\treadonly topic?: string;\n\treadonly seq?: number;\n\treadonly messageId?: string;\n\treadonly recordSeq: number;\n}\n\nexport interface EventFlowHighWater {\n\treadonly flowId: string;\n\treadonly recordSeq: number;\n\treadonly auditSeq: number;\n\treadonly sources: readonly EventFlowSourceHighWater[];\n}\n\nexport interface EventFlowOptions<T = unknown> {\n\treadonly flowId?: string;\n\treadonly name?: string;\n\treadonly sources: readonly EventFlowSourceInput<T>[];\n\treadonly now?: () => number;\n}\n\nexport interface EventFlowBundle<T = unknown> {\n\treadonly records: Node<EventFlowRecord<T>>;\n\treadonly status: Node<EventFlowStatus>;\n\treadonly issues: Node<DataIssue>;\n\treadonly audit: Node<EventFlowAuditRecord>;\n\treadonly highWater: Node<EventFlowHighWater>;\n}\n\nexport interface EventFlowProjectionFrame<TState> {\n\treadonly state: TState;\n\treadonly highWater: EventFlowHighWater;\n}\n\nexport interface EventFlowProjectionStatus {\n\treadonly kind: \"projected\" | \"rejected\";\n\treadonly projectionId: string;\n\treadonly recordSeq?: number;\n\treadonly issueCode?: string;\n\treadonly timestampMs: number;\n}\n\nexport interface EventFlowProjectionOptions<TState, TPayload = unknown> {\n\treadonly projectionId?: string;\n\treadonly name?: string;\n\treadonly initial: TState;\n\treadonly reduce: (state: TState, record: EventFlowRecord<TPayload>) => TState;\n\treadonly now?: () => number;\n}\n\nexport interface EventFlowProjectionBundle<TState> {\n\treadonly snapshot: Node<TState>;\n\treadonly frames: Node<EventFlowProjectionFrame<TState>>;\n\treadonly status: Node<EventFlowProjectionStatus>;\n\treadonly issues: Node<DataIssue>;\n\treadonly highWater: Node<EventFlowHighWater>;\n}\n\ntype EventFlowRuntimeFact<T = unknown> =\n\t| { readonly kind: \"record\"; readonly record: EventFlowRecord<T> }\n\t| { readonly kind: \"status\"; readonly status: EventFlowStatus }\n\t| { readonly kind: \"issue\"; readonly issue: DataIssue }\n\t| { readonly kind: \"audit\"; readonly audit: EventFlowAuditRecord }\n\t| { readonly kind: \"high-water\"; readonly highWater: EventFlowHighWater };\n\ninterface EventFlowRuntimeState {\n\trecordSeq: number;\n\tauditSeq: number;\n\thighWater: Map<string, EventFlowSourceHighWater>;\n}\n\nexport function eventFlow<T = unknown>(\n\tgraph: Graph,\n\topts: EventFlowOptions<T>,\n): EventFlowBundle<T> {\n\tconst name = opts.name ?? opts.flowId ?? \"eventFlow\";\n\tconst flowId = opts.flowId ?? name;\n\tconst now = opts.now ?? Date.now;\n\tconst sources = normalizeSources(opts.sources);\n\tconst runtime = graph.node<EventFlowRuntimeFact<T>>(\n\t\tsources.map((source) => source.node),\n\t\t(ctx) => {\n\t\t\tconst state =\n\t\t\t\tctx.state.get<EventFlowRuntimeState>() ??\n\t\t\t\t({\n\t\t\t\t\trecordSeq: 0,\n\t\t\t\t\tauditSeq: 0,\n\t\t\t\t\thighWater: new Map(),\n\t\t\t\t} satisfies EventFlowRuntimeState);\n\t\t\tctx.state.persist(true);\n\t\t\tfor (let i = 0; i < sources.length; i++) {\n\t\t\t\tconst source = sources[i];\n\t\t\t\tfor (const raw of depBatch(ctx, i) ?? []) {\n\t\t\t\t\treduceEventSource(raw, source.source, flowId, now(), state, (fact) =>\n\t\t\t\t\t\tctx.down([[\"DATA\", fact as EventFlowRuntimeFact<T>]]),\n\t\t\t\t\t);\n\t\t\t\t}\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: \"eventFlowRuntime\",\n\t\t\tmeta: { flowId, sources: sources.map((source) => source.source) },\n\t\t\tpartial: true,\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n\treturn {\n\t\trecords: runtimeProjection(graph, runtime, \"record\", `${name}/records`, \"eventFlowRecords\"),\n\t\tstatus: runtimeProjection(graph, runtime, \"status\", `${name}/status`, \"eventFlowStatus\"),\n\t\tissues: runtimeProjection(graph, runtime, \"issue\", `${name}/issues`, \"eventFlowIssues\"),\n\t\taudit: runtimeProjection(graph, runtime, \"audit\", `${name}/audit`, \"eventFlowAudit\"),\n\t\thighWater: runtimeProjection(\n\t\t\tgraph,\n\t\t\truntime,\n\t\t\t\"high-water\",\n\t\t\t`${name}/highWater`,\n\t\t\t\"eventFlowHighWater\",\n\t\t),\n\t};\n}\n\nexport function eventFlowProjection<TState, TPayload = unknown>(\n\tgraph: Graph,\n\tflowOrRecords: EventFlowBundle<TPayload> | Node<EventFlowRecord<TPayload>>,\n\topts: EventFlowProjectionOptions<TState, TPayload>,\n): EventFlowProjectionBundle<TState> {\n\tconst records = isEventFlowBundle(flowOrRecords) ? flowOrRecords.records : flowOrRecords;\n\tconst name = opts.name ?? opts.projectionId ?? \"eventFlowProjection\";\n\tconst projectionId = opts.projectionId ?? name;\n\tconst now = opts.now ?? Date.now;\n\tconst runtime = graph.node<\n\t\t| { readonly kind: \"frame\"; readonly frame: EventFlowProjectionFrame<TState> }\n\t\t| { readonly kind: \"status\"; readonly status: EventFlowProjectionStatus }\n\t\t| { readonly kind: \"issue\"; readonly issue: DataIssue }\n\t\t| { readonly kind: \"high-water\"; readonly highWater: EventFlowHighWater }\n\t>(\n\t\t[records],\n\t\t(ctx) => {\n\t\t\tconst state = ctx.state.get<{\n\t\t\t\tvalue: TState;\n\t\t\t\thighWater: EventFlowHighWater;\n\t\t\t\tsourceHighWater: Map<string, EventFlowSourceHighWater>;\n\t\t\t}>() ?? {\n\t\t\t\tvalue: opts.initial,\n\t\t\t\thighWater: emptyHighWater(projectionId),\n\t\t\t\tsourceHighWater: new Map(),\n\t\t\t};\n\t\t\tctx.state.persist(true);\n\t\t\tfor (const raw of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst record = raw as EventFlowRecord<TPayload>;\n\t\t\t\ttry {\n\t\t\t\t\tstate.value = opts.reduce(state.value, record);\n\t\t\t\t\tstate.highWater = projectionHighWater(projectionId, record, state.sourceHighWater);\n\t\t\t\t\tctx.down([\n\t\t\t\t\t\t[\"DATA\", { kind: \"frame\", frame: { state: state.value, highWater: state.highWater } }],\n\t\t\t\t\t\t[\n\t\t\t\t\t\t\t\"DATA\",\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tkind: \"status\",\n\t\t\t\t\t\t\t\tstatus: {\n\t\t\t\t\t\t\t\t\tkind: \"projected\",\n\t\t\t\t\t\t\t\t\tprojectionId,\n\t\t\t\t\t\t\t\t\trecordSeq: record.recordSeq,\n\t\t\t\t\t\t\t\t\ttimestampMs: now(),\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t],\n\t\t\t\t\t\t[\"DATA\", { kind: \"high-water\", highWater: state.highWater }],\n\t\t\t\t\t]);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tconst issue = dataIssue(\n\t\t\t\t\t\t\"event-flow-projection-threw\",\n\t\t\t\t\t\terror instanceof Error ? error.message : \"eventFlowProjection reducer threw\",\n\t\t\t\t\t\t{ projectionId, record },\n\t\t\t\t\t);\n\t\t\t\t\tctx.down([\n\t\t\t\t\t\t[\"DATA\", { kind: \"issue\", issue }],\n\t\t\t\t\t\t[\n\t\t\t\t\t\t\t\"DATA\",\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tkind: \"status\",\n\t\t\t\t\t\t\t\tstatus: {\n\t\t\t\t\t\t\t\t\tkind: \"rejected\",\n\t\t\t\t\t\t\t\t\tprojectionId,\n\t\t\t\t\t\t\t\t\trecordSeq: record.recordSeq,\n\t\t\t\t\t\t\t\t\tissueCode: issue.code,\n\t\t\t\t\t\t\t\t\ttimestampMs: now(),\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t],\n\t\t\t\t\t]);\n\t\t\t\t}\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: \"eventFlowProjectionRuntime\",\n\t\t\tmeta: { projectionId },\n\t\t\tcompleteWhenDepsComplete: false,\n\t\t\terrorWhenDepsError: false,\n\t\t},\n\t);\n\treturn {\n\t\tframes: projectionRuntime(\n\t\t\tgraph,\n\t\t\truntime,\n\t\t\t\"frame\",\n\t\t\t`${name}/frames`,\n\t\t\t\"eventFlowProjectionFrames\",\n\t\t),\n\t\tsnapshot: projectionRuntime(\n\t\t\tgraph,\n\t\t\truntime,\n\t\t\t\"frame\",\n\t\t\t`${name}/snapshot`,\n\t\t\t\"eventFlowProjectionSnapshot\",\n\t\t\t(fact) => (fact as { readonly frame: EventFlowProjectionFrame<TState> }).frame.state,\n\t\t),\n\t\tstatus: projectionRuntime(\n\t\t\tgraph,\n\t\t\truntime,\n\t\t\t\"status\",\n\t\t\t`${name}/status`,\n\t\t\t\"eventFlowProjectionStatus\",\n\t\t),\n\t\tissues: projectionRuntime(\n\t\t\tgraph,\n\t\t\truntime,\n\t\t\t\"issue\",\n\t\t\t`${name}/issues`,\n\t\t\t\"eventFlowProjectionIssues\",\n\t\t),\n\t\thighWater: projectionRuntime(\n\t\t\tgraph,\n\t\t\truntime,\n\t\t\t\"high-water\",\n\t\t\t`${name}/highWater`,\n\t\t\t\"eventFlowProjectionHighWater\",\n\t\t),\n\t};\n}\n\nfunction reduceEventSource<T>(\n\traw: unknown,\n\tsource: string,\n\tflowId: string,\n\ttimestampMs: number,\n\tstate: EventFlowRuntimeState,\n\temit: (fact: EventFlowRuntimeFact<T>) => void,\n): void {\n\tconst normalized = normalizeInput(raw, source);\n\tif (normalized.issue !== undefined) {\n\t\tconst status: EventFlowStatus = {\n\t\t\tkind: \"rejected\",\n\t\t\tflowId,\n\t\t\tsource: normalized.source,\n\t\t\tissueCode: normalized.issue.code,\n\t\t\ttimestampMs,\n\t\t};\n\t\tconst audit = auditRecord(flowId, state, \"rejected\", timestampMs, {\n\t\t\tsource: normalized.source,\n\t\t\tissueCode: normalized.issue.code,\n\t\t});\n\t\temit({ kind: \"issue\", issue: normalized.issue });\n\t\temit({ kind: \"status\", status });\n\t\temit({ kind: \"audit\", audit });\n\t\temit({ kind: \"high-water\", highWater: highWaterSnapshot(flowId, state) });\n\t\treturn;\n\t}\n\n\tconst recordSeq = ++state.recordSeq;\n\tconst record: EventFlowRecord<T> = {\n\t\trecordSeq,\n\t\tflowId,\n\t\tevent: normalized.event as EventMessage<T>,\n\t\tsource: normalized.source,\n\t\tobservedAtMs: timestampMs,\n\t\t...(normalized.event.correlationId === undefined\n\t\t\t? {}\n\t\t\t: { correlationId: normalized.event.correlationId }),\n\t\t...(normalized.event.causationId === undefined\n\t\t\t? {}\n\t\t\t: { causationId: normalized.event.causationId }),\n\t};\n\tstate.highWater.set(sourceKey(normalized.source), {\n\t\tsource: normalized.source.source,\n\t\t...(normalized.source.topic === undefined ? {} : { topic: normalized.source.topic }),\n\t\t...(normalized.source.seq === undefined ? {} : { seq: normalized.source.seq }),\n\t\tmessageId: normalized.event.id,\n\t\trecordSeq,\n\t});\n\tconst audit = auditRecord(flowId, state, \"recorded\", timestampMs, {\n\t\tsource: normalized.source,\n\t\teventId: normalized.event.id,\n\t\teventType: normalized.event.type,\n\t});\n\tconst highWater = highWaterSnapshot(flowId, state);\n\tconst status: EventFlowStatus = {\n\t\tkind: \"recorded\",\n\t\tflowId,\n\t\trecordSeq,\n\t\teventId: normalized.event.id,\n\t\teventType: normalized.event.type,\n\t\tsource: normalized.source,\n\t\ttimestampMs,\n\t};\n\temit({ kind: \"record\", record });\n\temit({ kind: \"status\", status });\n\temit({ kind: \"audit\", audit });\n\temit({ kind: \"high-water\", highWater });\n}\n\nfunction normalizeInput(\n\traw: unknown,\n\tsource: string,\n):\n\t| {\n\t\t\treadonly event: EventMessage;\n\t\t\treadonly source: EventFlowSourceRef;\n\t\t\treadonly issue?: undefined;\n\t  }\n\t| { readonly source: EventFlowSourceRef; readonly issue: DataIssue } {\n\tconst envelope = messageEnvelopeOf(raw);\n\tconst value = envelope?.payload ?? raw;\n\tconst sourceRef: EventFlowSourceRef =\n\t\tenvelope === undefined\n\t\t\t? { source, ...(eventIdOf(value) === undefined ? {} : { messageId: eventIdOf(value) }) }\n\t\t\t: {\n\t\t\t\t\tsource,\n\t\t\t\t\ttopic: envelope.topic,\n\t\t\t\t\tseq: envelope.seq,\n\t\t\t\t\tmessageId: envelope.payload.id,\n\t\t\t\t\t...(envelope.idempotencyKey === undefined\n\t\t\t\t\t\t? {}\n\t\t\t\t\t\t: { idempotencyKey: envelope.idempotencyKey }),\n\t\t\t\t};\n\tconst issue = eventMessageIssue(value);\n\tif (issue !== undefined) {\n\t\treturn {\n\t\t\tsource: sourceRef,\n\t\t\tissue: dataIssue(issue.code, issue.message, { source: sourceRef, value }),\n\t\t};\n\t}\n\treturn { event: value as EventMessage, source: sourceRef };\n}\n\nfunction messageEnvelopeOf(value: unknown): MessageEnvelope<EventMessage> | undefined {\n\tif (!isRecord(value)) return undefined;\n\tif (\n\t\ttypeof value.topic !== \"string\" ||\n\t\t!Number.isInteger(value.seq) ||\n\t\ttypeof value.timestampMs !== \"number\" ||\n\t\t!(\"payload\" in value)\n\t) {\n\t\treturn undefined;\n\t}\n\tconst payloadIssue = eventMessageIssue(value.payload);\n\treturn payloadIssue === undefined\n\t\t? (value as unknown as MessageEnvelope<EventMessage>)\n\t\t: undefined;\n}\n\nfunction normalizeSources<T>(\n\tsources: readonly EventFlowSourceInput<T>[],\n): readonly EventFlowSource[] {\n\tif (sources.length === 0) throw new Error(\"eventFlow: sources must be non-empty\");\n\treturn sources.map((source, index) => {\n\t\tif (isRecord(source) && \"node\" in source) {\n\t\t\tif (typeof source.source !== \"string\" || source.source.length === 0) {\n\t\t\t\tthrow new Error(\"eventFlow: source name must be non-empty\");\n\t\t\t}\n\t\t\treturn source as EventFlowSource;\n\t\t}\n\t\treturn { source: `source-${index}`, node: source as EventFlowSource[\"node\"] };\n\t});\n}\n\nfunction runtimeProjection<TOut, T>(\n\tgraph: Graph,\n\truntime: Node<EventFlowRuntimeFact<T>>,\n\tkind: EventFlowRuntimeFact<T>[\"kind\"],\n\tname: string,\n\tfactory: string,\n): Node<TOut> {\n\treturn graph.node<TOut>(\n\t\t[runtime],\n\t\t(ctx) => {\n\t\t\tfor (const fact of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst typed = fact as EventFlowRuntimeFact<T>;\n\t\t\t\tif (typed.kind === kind) ctx.down([[\"DATA\", valueOfRuntimeFact(typed) as TOut]]);\n\t\t\t}\n\t\t},\n\t\t{ name, factory, completeWhenDepsComplete: false, errorWhenDepsError: false },\n\t);\n}\n\nfunction projectionRuntime<TOut, TFact extends { readonly kind: string }>(\n\tgraph: Graph,\n\truntime: Node<TFact>,\n\tkind: TFact[\"kind\"],\n\tname: string,\n\tfactory: string,\n\tmap: (fact: Extract<TFact, { readonly kind: typeof kind }>) => TOut = valueOfRuntimeFact as never,\n): Node<TOut> {\n\treturn graph.node<TOut>(\n\t\t[runtime],\n\t\t(ctx) => {\n\t\t\tfor (const fact of depBatch(ctx, 0) ?? []) {\n\t\t\t\tconst typed = fact as TFact;\n\t\t\t\tif (typed.kind === kind) ctx.down([[\"DATA\", map(typed as never)]]);\n\t\t\t}\n\t\t},\n\t\t{ name, factory, completeWhenDepsComplete: false, errorWhenDepsError: false },\n\t);\n}\n\nfunction valueOfRuntimeFact(fact: { readonly kind: string }): unknown {\n\tif (\"record\" in fact) return fact.record;\n\tif (\"status\" in fact) return fact.status;\n\tif (\"issue\" in fact) return fact.issue;\n\tif (\"audit\" in fact) return fact.audit;\n\tif (\"highWater\" in fact) return fact.highWater;\n\tif (\"frame\" in fact) return fact.frame;\n\treturn undefined;\n}\n\nfunction auditRecord(\n\tflowId: string,\n\tstate: EventFlowRuntimeState,\n\toutcome: \"recorded\" | \"rejected\",\n\ttimestampMs: number,\n\topts: {\n\t\treadonly source?: EventFlowSourceRef;\n\t\treadonly eventId?: string;\n\t\treadonly eventType?: string;\n\t\treadonly issueCode?: string;\n\t},\n): EventFlowAuditRecord {\n\treturn {\n\t\tseq: ++state.auditSeq,\n\t\tflowId,\n\t\toutcome,\n\t\t...(opts.eventId === undefined ? {} : { eventId: opts.eventId }),\n\t\t...(opts.eventType === undefined ? {} : { eventType: opts.eventType }),\n\t\t...(opts.issueCode === undefined ? {} : { issueCode: opts.issueCode }),\n\t\t...(opts.source === undefined ? {} : { source: opts.source }),\n\t\thighWater: highWaterSnapshot(flowId, state),\n\t\ttimestampMs,\n\t};\n}\n\nfunction highWaterSnapshot(flowId: string, state: EventFlowRuntimeState): EventFlowHighWater {\n\treturn {\n\t\tflowId,\n\t\trecordSeq: state.recordSeq,\n\t\tauditSeq: state.auditSeq,\n\t\tsources: [...state.highWater.values()].sort(\n\t\t\t(a, b) => a.source.localeCompare(b.source) || (a.topic ?? \"\").localeCompare(b.topic ?? \"\"),\n\t\t),\n\t};\n}\n\nfunction emptyHighWater(flowId: string): EventFlowHighWater {\n\treturn { flowId, recordSeq: 0, auditSeq: 0, sources: [] };\n}\n\nfunction projectionHighWater(\n\tflowId: string,\n\trecord: EventFlowRecord,\n\tsourceHighWater: Map<string, EventFlowSourceHighWater>,\n): EventFlowHighWater {\n\tsourceHighWater.set(sourceKey(record.source), {\n\t\tsource: record.source.source,\n\t\t...(record.source.topic === undefined ? {} : { topic: record.source.topic }),\n\t\t...(record.source.seq === undefined ? {} : { seq: record.source.seq }),\n\t\tmessageId: record.event.id,\n\t\trecordSeq: record.recordSeq,\n\t});\n\treturn {\n\t\tflowId,\n\t\trecordSeq: record.recordSeq,\n\t\tauditSeq: 0,\n\t\tsources: [...sourceHighWater.values()].sort(\n\t\t\t(a, b) => a.source.localeCompare(b.source) || (a.topic ?? \"\").localeCompare(b.topic ?? \"\"),\n\t\t),\n\t};\n}\n\nfunction sourceKey(source: EventFlowSourceRef): string {\n\treturn `${source.source}\\u0000${source.topic ?? \"\"}`;\n}\n\nfunction eventIdOf(value: unknown): string | undefined {\n\treturn isRecord(value) && typeof value.id === \"string\" ? value.id : undefined;\n}\n\nfunction dataIssue(code: string, message: string, details?: unknown): DataIssue {\n\treturn {\n\t\tkind: \"issue\",\n\t\tcode,\n\t\tmessage,\n\t\tseverity: \"error\",\n\t\tsource: \"eventFlow\",\n\t\t...(details === undefined ? {} : { details }),\n\t};\n}\n\nfunction isEventFlowBundle<T>(value: unknown): value is EventFlowBundle<T> {\n\treturn isRecord(value) && \"records\" in value && \"highWater\" in value;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"],"mappings":"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","names":["status","audit"]}

package/dist/{chunk-SWTLEQL6.js → chunk-WQIA3GFB.js}

@@ -1,6 +1,6 @@
 import {
   SENTINEL
-} from "./chunk-DK554R7P.js";
+} from "./chunk-S6HXABGL.js";
 
 // src/ctx/types.ts
 var CTX_DEP_CACHE = /* @__PURE__ */ Symbol("graphrefly.ctx.depCache");
@@ -50,4 +50,4 @@ export {
   depLatest,
   depTerminal
 };
-//# sourceMappingURL=chunk-SWTLEQL6.js.map
+//# sourceMappingURL=chunk-WQIA3GFB.js.map

package/dist/chunk-WQIA3GFB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ctx/types.ts"],"sourcesContent":["/**\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":";;;;;AAyBO,IAAM,gBAA+B,uBAAO,yBAAyB;AAOrE,IAAM,mBAAkC,uBAAO,4BAA4B;AAa3E,SAAS,eAAe,GAAqB;AACnD,SAAO,MAAM,SAAS,MAAM;AAC7B;AAEO,SAAS,mBAAmB,GAAuB;AACzD,SAAO,MAAM;AACd;AAEO,SAAS,gBAAgB,GAAqB;AACpD,SAAO,CAAC,eAAe,CAAC,KAAK,CAAC,mBAAmB,CAAC;AACnD;AAEO,SAAS,mBAAmB,GAAqB;AACvD,SAAO,gBAAgB,CAAC,IAAI,IAAI;AACjC;AA+FO,SAAS,SAAS,KAAkB;AAC1C,SAAO,IAAI,SAAS;AACrB;AAGO,SAAS,SAAS,KAAU,UAAmD;AACrF,SAAO,IAAI,SAAS,QAAQ,KAAK,CAAC;AACnC;AAGO,SAAS,SAAS,KAAU,UAA6C;AAC/E,QAAM,QAAQ,SAAS,KAAK,QAAQ;AACpC,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,QAAM,YAAY,MAAM,KAAK,EAAE,OAAO,CAAC,MAAM,MAAM,QAAQ;AAC3D,SAAO,UAAU,WAAW,IAAI,CAAC,IAAI;AACtC;AAGO,SAAS,UAAU,KAAU,UAA2B;AAC9D,SAAO,IAAI,aAAa,GAAG,OAAO,QAAQ;AAC3C;AAGO,SAAS,YAAY,KAAU,UAA2B;AAChE,QAAM,IAAI,IAAI,SAAS,QAAQ;AAC/B,SAAO,MAAM,SAAY,QAAQ;AAClC;","names":[]}