@graphrefly/ts 0.0.0 → 0.0.1

package/dist/patterns/event-flow.d.cts

@@ -0,0 +1,115 @@
+import { DataIssue } from '../data/index.cjs';
+import { d as Graph } from '../graph-DCEWh4T2.cjs';
+import { EventMessage, MessageEnvelope } from '../messaging/index.cjs';
+import { N as Node } from '../types-CcPIn7sy.cjs';
+import '../core/index.cjs';
+import '../messages-CAzUPPJM.cjs';
+import '../codec-BB7p8fJc.cjs';
+import '../describe-DYMw_l1C.cjs';
+
+/**
+ * Event-flow projector helpers (D326/D329/D331).
+ *
+ * eventFlow consumes declared graph sources that emit EventMessage or
+ * MessageEnvelope<EventMessage>. It records projection facts and high-water over
+ * source coordinates; it does not own topics, subscriptions, cursors, retention,
+ * ack/seek/close, queues, workers, or dead-letter policy.
+ */
+
+interface EventFlowSource<T = unknown> {
+    readonly source: string;
+    readonly node: Node<EventMessage<T> | MessageEnvelope<EventMessage<T>> | unknown>;
+}
+type EventFlowSourceInput<T = unknown> = Node<EventMessage<T> | MessageEnvelope<EventMessage<T>> | unknown> | EventFlowSource<T>;
+interface EventFlowSourceRef {
+    readonly source: string;
+    readonly topic?: string;
+    readonly seq?: number;
+    readonly messageId?: string;
+    readonly idempotencyKey?: string;
+}
+interface EventFlowRecord<T = unknown> {
+    readonly recordSeq: number;
+    readonly flowId: string;
+    readonly event: EventMessage<T>;
+    readonly source: EventFlowSourceRef;
+    readonly observedAtMs: number;
+    readonly correlationId?: string;
+    readonly causationId?: string;
+}
+interface EventFlowStatus {
+    readonly kind: "recorded" | "rejected" | "projection-ready" | "projection-stale";
+    readonly flowId: string;
+    readonly recordSeq?: number;
+    readonly eventId?: string;
+    readonly eventType?: string;
+    readonly source?: EventFlowSourceRef;
+    readonly issueCode?: string;
+    readonly timestampMs: number;
+}
+interface EventFlowAuditRecord {
+    readonly seq: number;
+    readonly flowId: string;
+    readonly outcome: "recorded" | "rejected";
+    readonly eventId?: string;
+    readonly eventType?: string;
+    readonly issueCode?: string;
+    readonly source?: EventFlowSourceRef;
+    readonly highWater: EventFlowHighWater;
+    readonly timestampMs: number;
+}
+interface EventFlowSourceHighWater {
+    readonly source: string;
+    readonly topic?: string;
+    readonly seq?: number;
+    readonly messageId?: string;
+    readonly recordSeq: number;
+}
+interface EventFlowHighWater {
+    readonly flowId: string;
+    readonly recordSeq: number;
+    readonly auditSeq: number;
+    readonly sources: readonly EventFlowSourceHighWater[];
+}
+interface EventFlowOptions<T = unknown> {
+    readonly flowId?: string;
+    readonly name?: string;
+    readonly sources: readonly EventFlowSourceInput<T>[];
+    readonly now?: () => number;
+}
+interface EventFlowBundle<T = unknown> {
+    readonly records: Node<EventFlowRecord<T>>;
+    readonly status: Node<EventFlowStatus>;
+    readonly issues: Node<DataIssue>;
+    readonly audit: Node<EventFlowAuditRecord>;
+    readonly highWater: Node<EventFlowHighWater>;
+}
+interface EventFlowProjectionFrame<TState> {
+    readonly state: TState;
+    readonly highWater: EventFlowHighWater;
+}
+interface EventFlowProjectionStatus {
+    readonly kind: "projected" | "rejected";
+    readonly projectionId: string;
+    readonly recordSeq?: number;
+    readonly issueCode?: string;
+    readonly timestampMs: number;
+}
+interface EventFlowProjectionOptions<TState, TPayload = unknown> {
+    readonly projectionId?: string;
+    readonly name?: string;
+    readonly initial: TState;
+    readonly reduce: (state: TState, record: EventFlowRecord<TPayload>) => TState;
+    readonly now?: () => number;
+}
+interface EventFlowProjectionBundle<TState> {
+    readonly snapshot: Node<TState>;
+    readonly frames: Node<EventFlowProjectionFrame<TState>>;
+    readonly status: Node<EventFlowProjectionStatus>;
+    readonly issues: Node<DataIssue>;
+    readonly highWater: Node<EventFlowHighWater>;
+}
+declare function eventFlow<T = unknown>(graph: Graph, opts: EventFlowOptions<T>): EventFlowBundle<T>;
+declare function eventFlowProjection<TState, TPayload = unknown>(graph: Graph, flowOrRecords: EventFlowBundle<TPayload> | Node<EventFlowRecord<TPayload>>, opts: EventFlowProjectionOptions<TState, TPayload>): EventFlowProjectionBundle<TState>;
+
+export { type EventFlowAuditRecord, type EventFlowBundle, type EventFlowHighWater, type EventFlowOptions, type EventFlowProjectionBundle, type EventFlowProjectionFrame, type EventFlowProjectionOptions, type EventFlowProjectionStatus, type EventFlowRecord, type EventFlowSource, type EventFlowSourceHighWater, type EventFlowSourceInput, type EventFlowSourceRef, type EventFlowStatus, eventFlow, eventFlowProjection };

package/dist/patterns/event-flow.d.ts

@@ -0,0 +1,115 @@
+import { DataIssue } from '../data/index.js';
+import { d as Graph } from '../graph-D-1-SQeC.js';
+import { EventMessage, MessageEnvelope } from '../messaging/index.js';
+import { N as Node } from '../types-BsJvElYZ.js';
+import '../core/index.js';
+import '../messages-CAzUPPJM.js';
+import '../codec-BB7p8fJc.js';
+import '../describe-BpyJuWkw.js';
+
+/**
+ * Event-flow projector helpers (D326/D329/D331).
+ *
+ * eventFlow consumes declared graph sources that emit EventMessage or
+ * MessageEnvelope<EventMessage>. It records projection facts and high-water over
+ * source coordinates; it does not own topics, subscriptions, cursors, retention,
+ * ack/seek/close, queues, workers, or dead-letter policy.
+ */
+
+interface EventFlowSource<T = unknown> {
+    readonly source: string;
+    readonly node: Node<EventMessage<T> | MessageEnvelope<EventMessage<T>> | unknown>;
+}
+type EventFlowSourceInput<T = unknown> = Node<EventMessage<T> | MessageEnvelope<EventMessage<T>> | unknown> | EventFlowSource<T>;
+interface EventFlowSourceRef {
+    readonly source: string;
+    readonly topic?: string;
+    readonly seq?: number;
+    readonly messageId?: string;
+    readonly idempotencyKey?: string;
+}
+interface EventFlowRecord<T = unknown> {
+    readonly recordSeq: number;
+    readonly flowId: string;
+    readonly event: EventMessage<T>;
+    readonly source: EventFlowSourceRef;
+    readonly observedAtMs: number;
+    readonly correlationId?: string;
+    readonly causationId?: string;
+}
+interface EventFlowStatus {
+    readonly kind: "recorded" | "rejected" | "projection-ready" | "projection-stale";
+    readonly flowId: string;
+    readonly recordSeq?: number;
+    readonly eventId?: string;
+    readonly eventType?: string;
+    readonly source?: EventFlowSourceRef;
+    readonly issueCode?: string;
+    readonly timestampMs: number;
+}
+interface EventFlowAuditRecord {
+    readonly seq: number;
+    readonly flowId: string;
+    readonly outcome: "recorded" | "rejected";
+    readonly eventId?: string;
+    readonly eventType?: string;
+    readonly issueCode?: string;
+    readonly source?: EventFlowSourceRef;
+    readonly highWater: EventFlowHighWater;
+    readonly timestampMs: number;
+}
+interface EventFlowSourceHighWater {
+    readonly source: string;
+    readonly topic?: string;
+    readonly seq?: number;
+    readonly messageId?: string;
+    readonly recordSeq: number;
+}
+interface EventFlowHighWater {
+    readonly flowId: string;
+    readonly recordSeq: number;
+    readonly auditSeq: number;
+    readonly sources: readonly EventFlowSourceHighWater[];
+}
+interface EventFlowOptions<T = unknown> {
+    readonly flowId?: string;
+    readonly name?: string;
+    readonly sources: readonly EventFlowSourceInput<T>[];
+    readonly now?: () => number;
+}
+interface EventFlowBundle<T = unknown> {
+    readonly records: Node<EventFlowRecord<T>>;
+    readonly status: Node<EventFlowStatus>;
+    readonly issues: Node<DataIssue>;
+    readonly audit: Node<EventFlowAuditRecord>;
+    readonly highWater: Node<EventFlowHighWater>;
+}
+interface EventFlowProjectionFrame<TState> {
+    readonly state: TState;
+    readonly highWater: EventFlowHighWater;
+}
+interface EventFlowProjectionStatus {
+    readonly kind: "projected" | "rejected";
+    readonly projectionId: string;
+    readonly recordSeq?: number;
+    readonly issueCode?: string;
+    readonly timestampMs: number;
+}
+interface EventFlowProjectionOptions<TState, TPayload = unknown> {
+    readonly projectionId?: string;
+    readonly name?: string;
+    readonly initial: TState;
+    readonly reduce: (state: TState, record: EventFlowRecord<TPayload>) => TState;
+    readonly now?: () => number;
+}
+interface EventFlowProjectionBundle<TState> {
+    readonly snapshot: Node<TState>;
+    readonly frames: Node<EventFlowProjectionFrame<TState>>;
+    readonly status: Node<EventFlowProjectionStatus>;
+    readonly issues: Node<DataIssue>;
+    readonly highWater: Node<EventFlowHighWater>;
+}
+declare function eventFlow<T = unknown>(graph: Graph, opts: EventFlowOptions<T>): EventFlowBundle<T>;
+declare function eventFlowProjection<TState, TPayload = unknown>(graph: Graph, flowOrRecords: EventFlowBundle<TPayload> | Node<EventFlowRecord<TPayload>>, opts: EventFlowProjectionOptions<TState, TPayload>): EventFlowProjectionBundle<TState>;
+
+export { type EventFlowAuditRecord, type EventFlowBundle, type EventFlowHighWater, type EventFlowOptions, type EventFlowProjectionBundle, type EventFlowProjectionFrame, type EventFlowProjectionOptions, type EventFlowProjectionStatus, type EventFlowRecord, type EventFlowSource, type EventFlowSourceHighWater, type EventFlowSourceInput, type EventFlowSourceRef, type EventFlowStatus, eventFlow, eventFlowProjection };

package/dist/patterns/event-flow.js

@@ -0,0 +1,14 @@
+import {
+  eventFlow,
+  eventFlowProjection
+} from "../chunk-VTHLCFN4.js";
+import "../chunk-QFY4AFY4.js";
+import "../chunk-UT3MHJCW.js";
+import "../chunk-WQIA3GFB.js";
+import "../chunk-S6HXABGL.js";
+import "../chunk-DGUM43GV.js";
+export {
+  eventFlow,
+  eventFlowProjection
+};
+//# sourceMappingURL=event-flow.js.map

package/dist/patterns/event-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}