effect-dynamodb 1.27.0 → 1.28.0

package/dist/internal/EventProjection.d.ts

@@ -0,0 +1,597 @@
+/**
+ * EventStore projections (#151) — read models folded from a change feed that
+ * take their order from the event store, not from delivery.
+ *
+ * DynamoDB Streams orders records per item only, and a transaction's records
+ * carry no grouping or order, so a stream's events reach a consumer in any
+ * order. A projection groups a batch's events by row, sorts and
+ * deduplicates them, reads from the store only the versions the batch lacks
+ * (one strongly consistent `readFrom`), folds, and writes the read-model row
+ * once, conditioned on the checkpoint it read. See
+ * `docs/designs/eventstore-projections.md`.
+ *
+ * Re-exported from `EventStore`; this module only type-imports it.
+ *
+ * @internal
+ */
+import { ConcurrentModification, type ConditionalCheckFailed, type ItemNotFound, StreamRecordIdentifierMissing, ValidationError } from "@effect-dynamodb/schema/Errors.js";
+import { Effect, Option, Pipeable, Schedule, type Schema } from "effect";
+import type { DynamoClient, DynamoClientError } from "../DynamoClient.js";
+import type { EventStream, StreamEvent, StreamIdInput, StreamMetadata } from "../EventStore.js";
+import type { TableConfig } from "../Table.js";
+import type { EntityGet, EntityPut } from "./EntityOps.js";
+import { type StreamImage } from "./Packed.js";
+/**
+ * The read model a projection writes: an unbound `Entity`. Its row is read
+ * with a strongly consistent `get` and written whole with `put` (or `create`
+ * for a new row), so the projection owns the row.
+ */
+export interface ProjectionReadModel {
+    readonly entityType: string;
+    readonly model: Schema.Top;
+    readonly versioned: unknown;
+    readonly softDelete: unknown;
+    readonly timeSeries: unknown;
+    readonly get: (key: any) => EntityGet<any, any, any, any>;
+    readonly put: (input: any) => EntityPut<any, any, any, any>;
+    readonly create: (input: any) => EntityPut<any, any, any, any>;
+    readonly systemFields: {
+        readonly createdAt: string | null;
+    };
+    readonly _attachPrototype?: ((decoded: any) => any) | undefined;
+}
+/** The state a projection folds: the read model's model type. */
+export type ProjectionState<RM> = RM extends {
+    readonly get: (key: any) => EntityGet<infer A, any, any, any>;
+} ? A : never;
+/** The read model's primary key, as its `get` takes it. */
+export type ProjectionKey<RM> = RM extends {
+    readonly get: (key: infer K) => any;
+} ? K : never;
+/**
+ * What reading and writing the read-model row can fail with — its `get` (a
+ * missing row is not an error) and its `put`. The conditional write's
+ * `ConditionalCheckFailed` is the projection's own race signal, never surfaced.
+ */
+export type ProjectionReadModelError<RM> = (RM extends {
+    readonly put: (input: any) => EntityPut<any, any, infer E, any>;
+} ? Exclude<E, ConditionalCheckFailed> : never) | (RM extends {
+    readonly get: (key: any) => EntityGet<any, any, infer E, any>;
+} ? Exclude<E, ItemNotFound> : never);
+/** The read model's numeric fields — those a checkpoint may name. */
+export type CheckpointField<S> = {
+    [K in keyof S]-?: S[K] extends number ? K : never;
+}[keyof S] & string;
+/**
+ * The read model's field holding the last applied stream version. With
+ * `{ field, offset }` the field stores `version + offset`: a read model that
+ * numbered versions from 0 adopts a projection with `offset: -1`, its stored
+ * values and readers unchanged.
+ */
+export type ProjectionCheckpoint<S> = CheckpointField<S> | {
+    readonly field: CheckpointField<S>;
+    readonly offset?: number | undefined;
+};
+/** Configuration of {@link projection}. */
+export interface ProjectionConfig<TEvent, TStreamIdFields extends ReadonlyArray<string>, TMetadata, RM extends ProjectionReadModel, E, R, KR extends ProjectionKey<RM> | Option.Option<ProjectionKey<RM>> = ProjectionKey<RM>> {
+    /** The source stream. One projection reads one stream. */
+    readonly stream: EventStream<TEvent, TStreamIdFields, TMetadata, any, any, any, any>;
+    /** The read model (an unbound `Entity`). */
+    readonly readModel: RM;
+    /**
+     * The row an event folds into. A function of the stream id alone gives one
+     * row per stream instance. One that also reads the event lets a stream feed
+     * several rows — each row is still fed by that one stream instance (a row
+     * fed by several streams needs a checkpoint per source, which projections
+     * don't keep). When a later event addresses a different row, the earlier
+     * row keeps what it had, and the new row folds only its own events.
+     *
+     * Return an `Option` to let an event address no row: `Option.none()`
+     * acknowledges it — no row is read or written, no checkpoint moves, and it
+     * is in no outcome (`ignored` lists its position). `apply` then returns an
+     * `Option` too.
+     */
+    readonly key: (streamId: StreamIdInput<TStreamIdFields>, event: StreamEvent<TEvent, StreamMetadata<TMetadata>>) => KR;
+    /**
+     * The state a row starts from, before `event` — the first event folded into
+     * a row that does not exist yet.
+     */
+    readonly initial: (streamId: StreamIdInput<TStreamIdFields>, event: StreamEvent<TEvent, StreamMetadata<TMetadata>>) => ProjectionState<RM>;
+    /**
+     * Apply one event. Return the state unchanged to ignore an event (the
+     * checkpoint still advances). A failure fails this row only, unless
+     * `terminal` accepts it. The library sets the checkpoint field after the
+     * fold; `evolve` need not.
+     */
+    readonly evolve: (state: ProjectionState<RM>, event: StreamEvent<TEvent, StreamMetadata<TMetadata>>) => Effect.Effect<ProjectionState<RM>, E, R>;
+    /** See {@link ProjectionCheckpoint}. */
+    readonly checkpoint: ProjectionCheckpoint<ProjectionState<RM>>;
+    /**
+     * The row as written, from the folded state (checkpoint set) — to recompute
+     * attributes kept for other readers (`Hidden` index fields, say) on every
+     * write. Default: the state as folded.
+     */
+    readonly toItem?: ((state: ProjectionState<RM>, context: {
+        readonly streamId: StreamIdInput<TStreamIdFields>;
+        readonly key: ProjectionKey<RM>;
+    }) => ProjectionState<RM>) | undefined;
+    /**
+     * The `evolve` failures that reject their event rather than fail the row —
+     * an update to a row that was never created, say. A rejected event is
+     * skipped and reported in the outcome's `rejected`; the fold continues, and
+     * a row that does not exist is not created by rejected events alone. The
+     * decision must be deterministic: a rejected event can be read again (to
+     * fill a later gap) and is rejected again. Any other failure fails the row,
+     * and keeps failing it on every redelivery.
+     *
+     * A row that is never created (every one of its events rejected) has no
+     * checkpoint, so each later delivery of its events gap-reads from version 1
+     * and reports the earlier rejections again — dedupe `rejected` by version
+     * when counting or logging them; the read grows with the stream.
+     */
+    readonly terminal?: ((error: E) => boolean) | undefined;
+    /**
+     * Retries after a lost race — another invocation advanced the row between
+     * this one's read and its conditional write. Each retry re-reads the row, so
+     * it usually finds the events applied and has nothing left to write. A
+     * number `n` is `Schedule.recurs(n)`. Default: up to 12 retries after a
+     * jittered delay growing from 5 ms by 1.5× (about 1.3 s in all). Exhausted,
+     * the row fails with `ConcurrentModification`.
+     */
+    readonly retry?: number | Schedule.Schedule<unknown, ConcurrentModification> | undefined;
+}
+/** An event `evolve` rejected — see {@link ProjectionConfig.terminal}. */
+export interface ProjectionRejected<A, M, E> {
+    readonly event: StreamEvent<A, M>;
+    readonly error: E;
+}
+/** One row applied by {@link EventProjection.applyBatch} / `apply`. */
+export interface ProjectionApplied<S, A, M, K = unknown, E = unknown> {
+    /** The stream instance (`StreamEvent.streamId`). */
+    readonly streamId: string;
+    /** The row's key. */
+    readonly key: K;
+    /**
+     * The events this call applied to the row, in version order — including
+     * any it read from the store to fill a gap. Each event is in exactly one
+     * call's `applied`: the one whose conditional write won. Side effects driven
+     * from it are at most once (a crash after the write loses them).
+     */
+    readonly applied: ReadonlyArray<StreamEvent<A, M>>;
+    /**
+     * The events `evolve` rejected (see {@link ProjectionConfig.terminal}), in
+     * version order. Reported by every call that reads them — again, if a row
+     * that does not exist is not created before the next read.
+     */
+    readonly rejected: ReadonlyArray<ProjectionRejected<A, M, E>>;
+    /**
+     * The batch's events this row had already applied (version at or below the
+     * checkpoint it read), in version order — a redelivery, or a late
+     * out-of-order delivery. Republishing their side effects gives at-least-once
+     * delivery, for consumers that tolerate duplicates.
+     */
+    readonly alreadyApplied: ReadonlyArray<StreamEvent<A, M>>;
+    /**
+     * The row as written, or as read when nothing was left to apply.
+     * `Option.none()` when there is no row: every event was rejected.
+     */
+    readonly state: Option.Option<S>;
+    /**
+     * The row's checkpoint, in store numbering (offset removed): every stream
+     * version up to it has been considered for this row.
+     */
+    readonly version: number;
+}
+/** The outcome of one row in {@link ProjectionBatchResult}. */
+export type ProjectionOutcome<S, A, M, Err, K = unknown, E = unknown> = ({
+    readonly _tag: "Applied";
+    /** Positions of this row's events in the `applyBatch` input, ascending. */
+    readonly positions: ReadonlyArray<number>;
+} & ProjectionApplied<S, A, M, K, E>) | {
+    readonly _tag: "Failed";
+    readonly streamId: string;
+    /** The row's key — `undefined` when the stream id could not be parsed. */
+    readonly key: K | undefined;
+    /** Positions of this row's events in the `applyBatch` input, ascending. */
+    readonly positions: ReadonlyArray<number>;
+    readonly error: Err;
+};
+/** Result of {@link EventProjection.applyBatch}. */
+export interface ProjectionBatchResult<S, A, M, Err, K = unknown, E = unknown> {
+    /** One outcome per row, in order of first delivery. */
+    readonly outcomes: ReadonlyArray<ProjectionOutcome<S, A, M, Err, K, E>>;
+    /**
+     * The earliest input position of each failed row, ascending — the records
+     * to report in a partial batch response.
+     */
+    readonly failedPositions: ReadonlyArray<number>;
+    /** Input positions of the events whose `key` returned `Option.none()`, ascending. */
+    readonly ignored: ReadonlyArray<number>;
+}
+/** Result of {@link EventProjection.catchUp}. */
+export interface ProjectionCaughtUp<S, A, M, K = unknown, E = unknown> {
+    /** The row of the stream's latest event — `Option.none()` for a stream with no events. */
+    readonly key: Option.Option<K>;
+    /** The events folded, in version order. Empty when the row was current. */
+    readonly applied: ReadonlyArray<StreamEvent<A, M>>;
+    /** The events `evolve` rejected, in version order. */
+    readonly rejected: ReadonlyArray<ProjectionRejected<A, M, E>>;
+    /** The row — `Option.none()` when there is none. */
+    readonly state: Option.Option<S>;
+    readonly version: number;
+}
+/** One row re-derived by {@link EventProjection.rebuild}. */
+export interface ProjectionRebuiltRow<S, A, M, K = unknown, E = unknown> {
+    readonly key: K;
+    /** The row as written — as read, when every one of its events was rejected. */
+    readonly state: Option.Option<S>;
+    /** The version of the row's last event. */
+    readonly version: number;
+    readonly rejected: ReadonlyArray<ProjectionRejected<A, M, E>>;
+}
+/** Result of {@link EventProjection.rebuild}. */
+export interface ProjectionRebuilt<S, A = unknown, M = unknown, K = unknown, E = unknown> {
+    /** Every row the stream's events address, in order of their first event. Empty for a stream with no events. */
+    readonly rows: ReadonlyArray<ProjectionRebuiltRow<S, A, M, K, E>>;
+}
+/** What a projection's operations fail with: `evolve`'s `E`, the read model's errors, and the store's. */
+export type ProjectionError<RM, E> = E | ProjectionReadModelError<RM> | DynamoClientError | ValidationError | ConcurrentModification;
+/** Options of {@link EventProjection.applyBatch}. */
+export interface ApplyBatchOptions {
+    /** Rows applied concurrently. Default `10`. */
+    readonly concurrency?: number | "unbounded" | undefined;
+}
+/**
+ * A DynamoDB Streams record as a Lambda event source mapping or an
+ * EventBridge Pipe delivers it — only the members the projection reads.
+ * Structural, so no `aws-lambda` types are needed. A record of another shape
+ * (a Pipe input template's) is read through `image` / `identifier` accessors.
+ */
+export interface StreamRecord {
+    readonly eventID?: string | undefined;
+    readonly eventName?: string | undefined;
+    readonly dynamodb?: {
+        readonly SequenceNumber?: string | undefined;
+        readonly NewImage?: StreamImage | undefined;
+    } | undefined;
+}
+/**
+ * Who reads the partial batch response. A Lambda event source mapping on a
+ * DynamoDB stream identifies a record by `dynamodb.SequenceNumber`; an
+ * EventBridge Pipe by `eventID`.
+ */
+export type BatchResponseSource = "lambda" | "pipe";
+/** The `ReportBatchItemFailures` response. */
+export interface BatchItemFailuresResponse {
+    readonly batchItemFailures: Array<{
+        readonly itemIdentifier: string;
+    }>;
+}
+/** Identify records by their source's member — see {@link BatchResponseSource}. */
+export interface IdentifyBySource {
+    readonly source: BatchResponseSource;
+}
+/** Identify records with an accessor — for a record shape of your own. */
+export interface IdentifyWith<Rec> {
+    readonly identifier: (record: Rec) => string | undefined;
+}
+/** Options of {@link EventProjection.processBatch}, beside how records are identified. */
+export interface ProcessBatchOptions<Rec> extends ApplyBatchOptions {
+    /**
+     * A record's image, `undefined` to skip it. Default: the `NewImage` of an
+     * `INSERT` (a record without an `eventName` counts as one).
+     */
+    readonly image?: ((record: Rec) => StreamImage | undefined) | undefined;
+    /**
+     * What to do with a record whose image does not decode. A decode failure is
+     * deterministic, so `"report"` (the default) makes the source redeliver it
+     * — and everything after it on its shard — until its retries or age run out.
+     * `"skip"` acknowledges it, to log and dead-letter it yourself. Either way it
+     * is in `decodeFailures`.
+     *
+     * Skipping acknowledges the record, not the stored event: the next event of
+     * the same row gap-fills through it, fails to decode it, and fails the row
+     * (that record is reported). It helps when the bad event is its stream's
+     * last, or once the stored item is repaired or removed.
+     */
+    readonly onDecodeFailure?: "report" | "skip" | undefined;
+}
+/** Result of {@link EventProjection.processBatch}. */
+export interface ProcessBatchResult<S, A, M, Err, Rec, K = unknown, E = unknown> {
+    /**
+     * See {@link ProjectionBatchResult.outcomes} — with `positions` indexing the
+     * **records** passed in.
+     */
+    readonly outcomes: ReadonlyArray<ProjectionOutcome<S, A, M, Err, K, E>>;
+    /** Records whose image failed to decode. */
+    readonly decodeFailures: ReadonlyArray<{
+        readonly record: Rec;
+        readonly error: ValidationError;
+    }>;
+    /**
+     * The records the response reports, in delivery order: the earliest record
+     * of each failed row, and (with `onDecodeFailure: "report"`) every record
+     * that failed to decode.
+     */
+    readonly failedRecords: ReadonlyArray<Rec>;
+    /**
+     * The partial batch response for `failedRecords`. To fail more records (a
+     * side effect that failed, say), pass them with these to {@link batchResponse}.
+     */
+    readonly response: BatchItemFailuresResponse;
+}
+/**
+ * The partial batch response (`ReportBatchItemFailures`) for `failedRecords`:
+ * each identified by `dynamodb.SequenceNumber` for a Lambda event source
+ * mapping, by `eventID` for an EventBridge Pipe, or by your own `identifier`
+ * accessor.
+ *
+ * Lambda checkpoints at the lowest reported sequence number and redelivers
+ * every record from there, so reporting the earliest failed record of each
+ * row is enough. A record without an identifier fails with
+ * `StreamRecordIdentifierMissing` — an empty one would fail the whole batch
+ * silently — so fail the invocation, and the source redelivers the batch.
+ */
+export declare const batchResponse: {
+    (failedRecords: ReadonlyArray<StreamRecord>, options: IdentifyBySource): Effect.Effect<BatchItemFailuresResponse, StreamRecordIdentifierMissing>;
+    <Rec>(failedRecords: ReadonlyArray<Rec>, options: IdentifyWith<Rec>): Effect.Effect<BatchItemFailuresResponse, StreamRecordIdentifierMissing>;
+};
+/** A stream {@link decoder} can dispatch to — an `EventStream` or a `BoundEventStream`. */
+export interface DecodableStream {
+    readonly streamName: string;
+    readonly eventMarker: string;
+    decodeStreamImage(image: StreamImage): Effect.Effect<Option.Option<unknown>, ValidationError, any>;
+}
+/** The event a decodable stream decodes to. */
+type DecodedEventOf<S> = S extends {
+    decodeStreamImage(image: any, options?: any): Effect.Effect<Option.Option<infer Ev>, any, any>;
+} ? Ev : never;
+/** What {@link decoder} returns for one of its streams' event images. */
+export type DecodedStreamEvent<Streams extends {
+    readonly [name: string]: DecodableStream;
+}> = {
+    readonly [K in keyof Streams & string]: {
+        readonly stream: K;
+        readonly event: DecodedEventOf<Streams[K]>;
+    };
+}[keyof Streams & string];
+/**
+ * One decoder for several streams' change-feed images. Name the streams in a
+ * record; `decode(image)` dispatches on the image's `__edd_e__` and returns
+ * `{ stream: <name>, event }`, or `Option.none()` for anything that is not one
+ * of their events (snapshots, idempotency sentinels, entities, other streams).
+ * The image is decoded by that stream's `decodeStreamImage`, so it accepts the
+ * same shapes (DynamoDB JSON with `B` as base64 or bytes, or unmarshalled).
+ *
+ * Two streams storing events under the same marker throw `[EDD-9082]`.
+ *
+ * @example
+ * ```ts
+ * const decode = EventStore.decoder({ Order: OrderEvents, Payment: PaymentEvents })
+ * const decoded = yield* decode(record.dynamodb.NewImage)
+ * if (Option.isSome(decoded) && decoded.value.stream === "Order") { ... }
+ * ```
+ */
+export declare const decoder: <const Streams extends {
+    readonly [name: string]: DecodableStream;
+}>(streams: Streams) => ((image: StreamImage) => Effect.Effect<Option.Option<DecodedStreamEvent<Streams>>, ValidationError, never>);
+/** A Lambda event source mapping / EventBridge Pipe filter pattern. */
+export interface EventFilterPattern {
+    readonly eventName: ReadonlyArray<"INSERT">;
+    readonly dynamodb: {
+        readonly NewImage: {
+            readonly __edd_e__: {
+                readonly S: ReadonlyArray<string>;
+            };
+        };
+    };
+}
+/**
+ * The filter pattern that selects the `INSERT`s of these streams' event items
+ * — `JSON.stringify` it into `FilterCriteria.Filters[].Pattern` of a Lambda
+ * event source mapping or an EventBridge Pipe. Snapshots, idempotency
+ * sentinels and other items are filtered out before the function runs.
+ */
+export declare const eventFilterPattern: (streams: ReadonlyArray<DecodableStream> | {
+    readonly [name: string]: DecodableStream;
+}) => EventFilterPattern;
+declare const EventProjectionTypeId: unique symbol;
+export type EventProjectionTypeId = typeof EventProjectionTypeId;
+/** @internal See {@link EventProjection}'s decode member. */
+export declare const ProjectionDecode: unique symbol;
+/**
+ * A change-feed projection: one source stream folded into read-model rows —
+ * see {@link projection}. Its operations need `DynamoClient | TableConfig`
+ * (the stream's table and the read model's) and `evolve`'s requirements;
+ * {@link bindProjection} resolves them (`R = never`).
+ */
+export interface EventProjection<S, A, TStreamIdFields extends ReadonlyArray<string>, M, Err, R, K = unknown, E = unknown, I extends boolean = false> extends Pipeable.Pipeable {
+    readonly [EventProjectionTypeId]: EventProjectionTypeId;
+    /** The source stream. */
+    readonly stream: EventStream<A, TStreamIdFields, any, any, any, any, any>;
+    /**
+     * @internal The stream's image decode — under the bound context for a
+     * bound projection, so a multi-projection batch decodes as its projections
+     * would.
+     */
+    readonly [ProjectionDecode]: (image: StreamImage) => Effect.Effect<Option.Option<StreamEvent<A, M>>, ValidationError, never>;
+    /** The read model's entity type. */
+    readonly entityType: string;
+    /**
+     * Apply one stream's decoded change-feed events — a batch, in delivery
+     * order. Per row (`key(streamId, event)`, concurrently across rows):
+     *
+     * 1. sort and deduplicate the row's events by version;
+     * 2. read the row (strongly consistent) and its checkpoint `c`; the events
+     *    at or below `c` are `alreadyApplied`, and with none left the row is
+     *    done;
+     * 3. if the rest are not exactly `c + 1 …` their highest version, read
+     *    `c + 1 …` that version from the store with one strongly consistent
+     *    `readFrom` and keep the row's events — so nothing waits for a delivery;
+     * 4. fold through `evolve` (skipping `terminal` rejections), set the
+     *    checkpoint, and write the row once, conditioned on the checkpoint still
+     *    being `c` (`create` for a new row; nothing when a new row's events were
+     *    all rejected);
+     * 5. on a lost race, re-read and continue, under the `retry` policy.
+     *
+     * Never fails: each row's failure is its outcome, so one row's error can't
+     * hide the others' `applied`.
+     */
+    applyBatch(events: ReadonlyArray<StreamEvent<A, M>>, options?: ApplyBatchOptions | undefined): Effect.Effect<ProjectionBatchResult<S, A, M, Err, K, E>, never, R>;
+    /** {@link EventProjection.applyBatch} of one event, its failure in the error channel. */
+    apply(event: StreamEvent<A, M>): Effect.Effect<I extends true ? Option.Option<ProjectionApplied<S, A, M, K, E>> : ProjectionApplied<S, A, M, K, E>, Err, R>;
+    /**
+     * Bring the row of the stream's latest event up to the head: read that
+     * event (one strongly consistent `Query`), then the row's events after its
+     * checkpoint (one strongly consistent `readFrom`) — to repair a row whose
+     * last event never arrived (a dead-lettered record, say). An earlier missing
+     * event is filled in by the next delivery anyway. With one row per stream
+     * instance that is the only row; {@link EventProjection.rebuild} re-derives
+     * every row.
+     */
+    catchUp(streamId: StreamIdInput<TStreamIdFields>): Effect.Effect<ProjectionCaughtUp<S, A, M, K, E>, Err, R>;
+    /**
+     * Re-derive every row of a stream instance from version 1: fold the whole
+     * stream (strongly consistent) from `initial`, row by row, ignoring the rows'
+     * state, and write each conditioned on the checkpoint read. Returns no
+     * applied events, so a rebuild never replays side effects. A stream with no
+     * events writes nothing.
+     *
+     * Pause live delivery for the stream instance while it runs. The condition
+     * is the checkpoint, and a rebuild of a row already at the stream's head
+     * writes the same checkpoint back — so an `applyBatch` that read the row
+     * before the rebuild still holds a matching condition, and its later write
+     * (folded from the old state) replaces the rebuilt row.
+     */
+    rebuild(streamId: StreamIdInput<TStreamIdFields>): Effect.Effect<ProjectionRebuilt<S, A, M, K, E>, Err, R>;
+    /**
+     * Process a raw change-feed batch: decode each `INSERT`'s `NewImage` (other
+     * records, and images that are not this stream's events, are skipped), apply
+     * the events with {@link EventProjection.applyBatch}, and build the partial
+     * batch response — the earliest record of each failed row and every record
+     * that failed to decode (unless `onDecodeFailure: "skip"`), identified per
+     * `options.source` or by `options.identifier`. Outcome `positions` index
+     * `records`. A failed record without an identifier fails the call with
+     * `StreamRecordIdentifierMissing`: fail the invocation, and the source
+     * redelivers the batch.
+     */
+    processBatch<Rec extends StreamRecord>(records: ReadonlyArray<Rec>, options: ProcessBatchOptions<Rec> & (IdentifyBySource | IdentifyWith<Rec>)): Effect.Effect<ProcessBatchResult<S, A, M, Err, Rec, K, E>, StreamRecordIdentifierMissing, R>;
+    /** A record shape of your own, read through `image` and `identifier`. */
+    processBatch<Rec>(records: ReadonlyArray<Rec>, options: ProcessBatchOptions<Rec> & {
+        readonly image: (record: Rec) => StreamImage | undefined;
+    } & IdentifyWith<Rec>): Effect.Effect<ProcessBatchResult<S, A, M, Err, Rec, K, E>, StreamRecordIdentifierMissing, R>;
+}
+/**
+ * Define a change-feed projection of `stream` into `readModel` — rows keyed by
+ * `key(streamId, event)` (one per stream instance when the key ignores the
+ * event), each folded from `initial(streamId, event)` through `evolve`, its
+ * checkpoint kept in `checkpoint`. See {@link EventProjection} for the
+ * operations.
+ *
+ * The read model must be a plain entity: `versioned` (the checkpoint is the
+ * version), `softDelete` (rows are never deleted) and `timeSeries` read
+ * models throw `[EDD-9081]`, as do a checkpoint the model has no field for and
+ * a non-integer offset.
+ *
+ * @example
+ * ```ts
+ * const OrderSummaryProjection = EventStore.projection({
+ *   stream: OrderEvents,
+ *   readModel: OrderSummaries,
+ *   key: (id) => ({ orderId: id.orderId }),
+ *   initial: (id) => ({ orderId: id.orderId, status: "open", total: 0, version: 0 }),
+ *   evolve: (state, event) => Effect.succeed(next(state, event.data)),
+ *   checkpoint: "version",
+ * })
+ * ```
+ */
+export declare const projection: <TEvent, TStreamIdFields extends ReadonlyArray<string>, TMetadata, RM extends ProjectionReadModel, E = never, R = never, KR extends ProjectionKey<RM> | Option.Option<ProjectionKey<RM>> = ProjectionKey<RM>>(config: ProjectionConfig<TEvent, TStreamIdFields, TMetadata, RM, E, R, KR>) => EventProjection<ProjectionState<RM>, TEvent, TStreamIdFields, StreamMetadata<TMetadata>, ProjectionError<RM, E>, R | DynamoClient | TableConfig, ProjectionKey<RM>, E, [Extract<KR, Option.Option<unknown>>] extends [never] ? false : true>;
+/** Any projection, bound or unbound. */
+export type AnyEventProjection = EventProjection<any, any, any, any, any, any, any, any, any>;
+/** A projection's outcomes. */
+export type ProjectionOutcomesOf<P> = P extends EventProjection<infer S, infer A, any, infer M, infer Err, any, infer K, infer E, any> ? ReadonlyArray<ProjectionOutcome<S, A, M, Err, K, E>> : never;
+/** A projection's requirements. */
+export type ProjectionRequirementsOf<P> = P extends EventProjection<any, any, any, any, any, infer R, any, any, any> ? R : never;
+/** Result of {@link processBatch}. */
+export interface ProcessBatchesResult<Projections extends {
+    readonly [name: string]: AnyEventProjection;
+}, Rec, Streams extends {
+    readonly [name: string]: DecodableStream;
+} = {}> {
+    /**
+     * The events of the `streams` named without a projection, in delivery order,
+     * each with its record's position — so a caller acting on them needs no
+     * second decode.
+     */
+    readonly unrouted: ReadonlyArray<{
+        readonly position: number;
+    } & DecodedStreamEvent<Streams>>;
+    /**
+     * Each projection's outcomes — `positions` index the **records** passed in.
+     * A projection whose stream had no events in the batch has none.
+     */
+    readonly outcomes: {
+        readonly [K in keyof Projections]: ProjectionOutcomesOf<Projections[K]>;
+    };
+    /** Records whose image failed to decode. */
+    readonly decodeFailures: ReadonlyArray<{
+        readonly record: Rec;
+        readonly error: ValidationError;
+    }>;
+    /**
+     * The records the response reports, in delivery order: the earliest record
+     * of each failed row of every projection, and (with
+     * `onDecodeFailure: "report"`) every record that failed to decode.
+     */
+    readonly failedRecords: ReadonlyArray<Rec>;
+    /** The partial batch response for `failedRecords`. */
+    readonly response: BatchItemFailuresResponse;
+}
+/**
+ * Process one change-feed batch for several projections — the usual shape
+ * when one table's feed carries several streams. Each record is decoded once
+ * and routed to every projection of its stream; records of other streams and
+ * items are skipped, as acknowledged. Each projection applies its events
+ * (see {@link EventProjection.applyBatch}), and one partial batch response
+ * names the earliest record of every failed row across all of them, plus the
+ * records that failed to decode (unless `onDecodeFailure: "skip"`). Outcome
+ * `positions` index `records`.
+ *
+ * Records are read as `StreamRecord`s, identified per `source`, or through
+ * `image` / `identifier` accessors for a shape of your own (a Pipe input
+ * template's). A failed record without an identifier fails the call with
+ * `StreamRecordIdentifierMissing`. `streams` names streams to decode without a
+ * projection: their events come back as `unrouted`. Two streams storing
+ * events under one marker die with `[EDD-9082]`.
+ *
+ * @example
+ * ```ts
+ * const result = yield* EventStore.processBatch(event.Records, {
+ *   projections: { summaries: OrderSummaryProjection, balances: BalanceProjection },
+ *   source: "lambda",
+ * })
+ * return result.response
+ * ```
+ */
+export declare const processBatch: {
+    <const Projections extends {
+        readonly [name: string]: AnyEventProjection;
+    }, Rec extends StreamRecord, const Streams extends {
+        readonly [name: string]: DecodableStream;
+    } = {}>(records: ReadonlyArray<Rec>, options: ProcessBatchOptions<Rec> & (IdentifyBySource | IdentifyWith<Rec>) & {
+        readonly projections: Projections;
+        readonly streams?: Streams | undefined;
+    }): Effect.Effect<ProcessBatchesResult<Projections, Rec, Streams>, StreamRecordIdentifierMissing, ProjectionRequirementsOf<Projections[keyof Projections]>>;
+    <const Projections extends {
+        readonly [name: string]: AnyEventProjection;
+    }, Rec, const Streams extends {
+        readonly [name: string]: DecodableStream;
+    } = {}>(records: ReadonlyArray<Rec>, options: ProcessBatchOptions<Rec> & {
+        readonly image: (record: Rec) => StreamImage | undefined;
+    } & IdentifyWith<Rec> & {
+        readonly projections: Projections;
+        readonly streams?: Streams | undefined;
+    }): Effect.Effect<ProcessBatchesResult<Projections, Rec, Streams>, StreamRecordIdentifierMissing, ProjectionRequirementsOf<Projections[keyof Projections]>>;
+};
+export {};
+//# sourceMappingURL=EventProjection.d.ts.map

package/dist/internal/EventProjection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventProjection.d.ts","sourceRoot":"","sources":["../../src/internal/EventProjection.ts"],"names":[],"mappings":"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"}