147 lines · 5.4 KB · TypeScript
RawDownload
/** * Historical name for the shared application event store. * * Owns durable append/replay access for project events and V2 agent-thread * events under one global sequence. It does not reduce events into read models * or apply command validation rules. * * Uses Effect `Context.Service` for dependency injection and exposes typed * persistence/decode errors for event append and replay operations. * * @module OrchestrationEventStore */import type {  ApplicationStoredEvent,  CommandId,  OrchestrationV2DomainEvent,  OrchestrationV2StoredEvent,  ThreadId,} from "@t3tools/contracts";import type { OrchestrationEvent } from "@t3tools/contracts/legacy-orchestration";import * as Context from "effect/Context";import type * as Effect from "effect/Effect";import type * as Stream from "effect/Stream"; import type { OrchestrationEventStoreError } from "../Errors.ts"; /** * OrchestrationEventStoreShape - Service API for orchestration event persistence. */export interface OrchestrationEventStoreShape {  /**   * Persist a new orchestration event.   *   * @param event - Event payload without sequence (assigned by storage).   * @returns Effect containing the stored event with assigned sequence.   *   * Actor kind is inferred from command/metadata before persistence.   */  readonly append: (    event: Omit<OrchestrationEvent, "sequence">,  ) => Effect.Effect<OrchestrationEvent, OrchestrationEventStoreError>;   /**   * Replay events after the provided sequence.   *   * @param sequenceExclusive - Sequence cursor (exclusive).   * @param limit - Maximum number of events to emit.   * @returns Stream containing ordered events.   *   * Reads in fixed-size pages and normalizes non-integer/negative limits.   */  readonly readFromSequence: (    sequenceExclusive: number,    limit?: number,  ) => Stream.Stream<OrchestrationEvent, OrchestrationEventStoreError>;   /**   * Read all events from the beginning of the stream.   *   * @returns Stream containing all stored events.   */  readonly readAll: () => Stream.Stream<OrchestrationEvent, OrchestrationEventStoreError>;   /** Append V2 agent events to the same globally ordered application log. */  readonly appendAgentEvents: (input: {    readonly commandId?: CommandId;    readonly events: ReadonlyArray<OrchestrationV2DomainEvent>;  }) => Effect.Effect<ReadonlyArray<OrchestrationV2StoredEvent>, OrchestrationEventStoreError>;   /** Read only V2 thread events from the application log. */  readonly readAgentEvents: (input?: {    readonly afterSequence?: number;    readonly throughSequence?: number;    readonly threadId?: ThreadId;    readonly commandId?: CommandId;    readonly limit?: number;  }) => Stream.Stream<OrchestrationV2StoredEvent, OrchestrationEventStoreError>;   /** Measure one thread's bounded replay without loading or decoding its payloads. */  readonly getAgentReplayStats: (input: {    readonly threadId: ThreadId;    readonly afterSequence: number;    readonly throughSequence: number;    readonly maxEvents: number;  }) => Effect.Effect<    {      readonly eventCount: number;      readonly payloadBytes: number;      readonly hasCreateEvent: boolean;    },    OrchestrationEventStoreError  >;   readonly latestAgentSequence: (    threadId?: ThreadId,  ) => Effect.Effect<number, OrchestrationEventStoreError>;   readonly latestApplicationSequence: Effect.Effect<number, OrchestrationEventStoreError>;   /** Read the finite retained application-event range `(afterSequence, throughSequence]`. */  readonly readApplicationEvents: (input: {    readonly afterSequence: number;    readonly throughSequence: number;  }) => Stream.Stream<ApplicationStoredEvent, OrchestrationEventStoreError>;   /** Publish only after the surrounding event/projection transaction commits. */  readonly publishCommitted: (events: ReadonlyArray<ApplicationStoredEvent>) => Effect.Effect<void>;   /** Race-free replay-to-live stream for project and V2 thread events. */  readonly streamApplicationEvents: (input?: {    readonly afterSequence?: number;  }) => Stream.Stream<ApplicationStoredEvent, OrchestrationEventStoreError>;  /** Project transport events before bounding replay and the live tail. */  readonly streamProjectedApplicationEvents: <A extends { readonly sequence: number }>(input: {    readonly afterSequence?: number;    readonly project: (event: ApplicationStoredEvent) => A;  }) => Stream.Stream<A, OrchestrationEventStoreError>;  /**   * Check whether an aggregate has an event after a sequence, optionally   * restricted to one event type.   *   * Used during replay to tell whether a later event supersedes the one being   * applied, without streaming the rest of the log.   */  readonly hasEventAfter: (input: {    readonly aggregateKind: OrchestrationEvent["aggregateKind"];    readonly aggregateId: string;    readonly type?: OrchestrationEvent["type"];    readonly sequenceExclusive: number;  }) => Effect.Effect<boolean, OrchestrationEventStoreError>;} /** * OrchestrationEventStore - Service tag for orchestration event persistence. * * @example * ```ts * const program = Effect.gen(function* () { *   const events = yield* OrchestrationEventStore *   return yield* Stream.runCollect(events.readAll()) * }) * ``` */export class OrchestrationEventStore extends Context.Service<  OrchestrationEventStore,  OrchestrationEventStoreShape>()("t3/persistence/Services/OrchestrationEventStore") {}

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t