effect-dynamodb 1.28.0 → 1.29.0

package/dist/internal/MultiProjection.js

@@ -0,0 +1,377 @@
+/**
+ * Multi-source projections (#153): read-model rows that several streams
+ * contribute to, with a checkpoint per source instance, gap-filling per
+ * instance, and one write per row guarded by the row's revision.
+ *
+ * Re-exported from `EventStore`; built on `ProjectionEngine`.
+ *
+ * @internal
+ */
+import { Duration, Effect, Option, Pipeable, Result } from "effect";
+import { ProjectionRoutes, refuseReadModel, resolveOutbox, resolveRevision, runBatch, } from "./EventProjection.js";
+import { addressed, instanceKey, keyId, makeEngine, retrySchedule, } from "./ProjectionEngine.js";
+const MultiSourceTypeId = Symbol.for("effect-dynamodb/MultiProjection/Source");
+const MultiProjectionTypeId = Symbol.for("effect-dynamodb/MultiProjection");
+/** @internal */
+export const isMultiProjection = (u) => typeof u === "object" && u !== null && MultiProjectionTypeId in u;
+// ---------------------------------------------------------------------------
+// multiProjection
+// ---------------------------------------------------------------------------
+/**
+ * A projection of several source streams into one read model: each row keeps
+ * a checkpoint per contributing source instance (`checkpoints`), and every
+ * write is guarded by the row's `revision`, so writers serving different
+ * sources serialise. See {@link MultiProjection}.
+ *
+ * @example
+ * ```ts
+ * const Shipments = EventStore.multiProjection({
+ *   readModel: ShipmentSummaries,
+ *   initial: (key) => ShipmentSummary.empty(key),
+ *   sources: (source) => ({
+ *     order: source(OrderEvents, { key: (id, e) => …, evolve: … }),
+ *     scan: source(ScanEvents, { key: …, evolve: …, mode: "latest" }),
+ *   }),
+ *   checkpoints: { field: "checkpoints" },
+ *   revision: "revision",
+ * })
+ * ```
+ */
+export const multiProjection = (config) => {
+    const { readModel } = config;
+    const sources = config.sources((stream, source) => ({
+        [MultiSourceTypeId]: undefined,
+        stream,
+        key: source.key,
+        evolve: source.evolve,
+        mode: source.mode ?? "fold",
+        terminal: source.terminal ?? (() => false),
+    }));
+    const names = Object.keys(sources);
+    const label = `EventStore.multiProjection("${readModel.entityType}")`;
+    const mapped = (config.checkpoints.sources ?? {});
+    if (config.checkpoints.field === undefined && Object.keys(mapped).length === 0) {
+        throw new Error(`[EDD-9081] ${label}: \`checkpoints\` declares neither \`field\` nor \`sources\`.`);
+    }
+    for (const name of Object.keys(mapped)) {
+        if (!names.includes(name)) {
+            throw new Error(`[EDD-9081] ${label}: \`checkpoints.sources.${name}\` names no source.`);
+        }
+    }
+    if (config.checkpoints.field === undefined) {
+        for (const name of names) {
+            if (mapped[name] === undefined) {
+                throw new Error(`[EDD-9081] ${label}: source "${name}" has no checkpoint — declare \`checkpoints.field\` ` +
+                    "(a map for every source) or a field for it in `checkpoints.sources`.");
+            }
+        }
+    }
+    const revision = resolveRevision(config.revision);
+    refuseReadModel(label, readModel, {
+        fields: [
+            revision.field,
+            ...(config.checkpoints.field === undefined ? [] : [config.checkpoints.field]),
+            ...Object.values(mapped).flatMap((f) => [f.field, f.instanceField]),
+        ],
+        removal: config.removal !== undefined,
+        outbox: config.outbox !== undefined,
+        revision: revision.field,
+    });
+    const engineSources = {};
+    for (const name of names) {
+        const src = sources[name];
+        engineSources[name] = {
+            name,
+            stream: src.stream,
+            key: src.key,
+            evolve: src.evolve,
+            mode: src.mode,
+            terminal: src.terminal,
+        };
+    }
+    const engine = makeEngine({
+        label,
+        readModel: readModel,
+        sources: names.map((n) => engineSources[n]),
+        initial: (key) => config.initial(key),
+        checkpoints: {
+            kind: "sources",
+            map: config.checkpoints.field,
+            fields: Object.fromEntries(Object.entries(mapped).map(([n, f]) => [
+                n,
+                { field: f.field, offset: f.offset ?? 0, instanceField: f.instanceField },
+            ])),
+        },
+        revision,
+        toItem: config.toItem,
+        toItemContext: (key) => ({ key }),
+        retry: retrySchedule(config.retry),
+        removal: config.removal === undefined
+            ? undefined
+            : {
+                ttl: config.removal.ttl === undefined
+                    ? undefined
+                    : Duration.fromInputUnsafe(config.removal.ttl),
+            },
+        outbox: resolveOutbox(config.outbox),
+    });
+    const appliedOf = (result) => ({
+        key: result.key,
+        instances: result.instances,
+        state: result.state,
+        removed: result.removed,
+        revision: result.revision,
+        enqueued: result.enqueued,
+        undelivered: Option.none(),
+    });
+    const deliverAfter = (applied, deliver) => deliver === undefined || config.outbox === undefined || applied.enqueued === 0
+        ? Effect.succeed(applied)
+        : engine.drain(applied.key, deliver).pipe(Effect.map((drained) => ({
+            ...applied,
+            undelivered: drained.undelivered,
+        })));
+    const applyBatch = (events, options) => Effect.gen(function* () {
+        // By source instance, in order of first delivery.
+        const instances = new Map();
+        events.forEach((tagged, position) => {
+            const source = engineSources[tagged.stream];
+            if (source === undefined)
+                return;
+            const id = `${tagged.stream}\u0000${tagged.event.streamId}`;
+            const group = instances.get(id);
+            if (group === undefined) {
+                instances.set(id, {
+                    source,
+                    streamIdStr: tagged.event.streamId,
+                    positions: [position],
+                    events: [tagged.event],
+                });
+            }
+            else {
+                group.positions.push(position);
+                group.events.push(tagged.event);
+            }
+        });
+        const ignored = [];
+        const failed = [];
+        // Rows across sources: each row's work, one entry per instance.
+        const rows = new Map();
+        for (const group of instances.values()) {
+            const placed = yield* Effect.result(Effect.gen(function* () {
+                const streamId = yield* group.source.stream.parseStreamId(group.streamIdStr);
+                const byRow = new Map();
+                for (let i = 0; i < group.events.length; i++) {
+                    const event = group.events[i];
+                    const key = addressed(yield* engine.call("key", () => group.source.key(streamId, event)));
+                    if (Option.isNone(key)) {
+                        ignored.push(group.positions[i]);
+                        continue;
+                    }
+                    const id = keyId(key.value);
+                    const row = byRow.get(id);
+                    if (row === undefined)
+                        byRow.set(id, { key: key.value, positions: [group.positions[i]], events: [event] });
+                    else {
+                        row.positions.push(group.positions[i]);
+                        row.events.push(event);
+                    }
+                }
+                return { streamId, byRow };
+            }));
+            if (Result.isFailure(placed)) {
+                failed.push({
+                    _tag: "Failed",
+                    key: undefined,
+                    positions: group.positions,
+                    error: placed.failure,
+                });
+                continue;
+            }
+            const delivered = new Set(group.events.map((e) => e.version));
+            for (const [id, row] of placed.success.byRow) {
+                const ordered = [...row.events]
+                    .sort((a, b) => a.version - b.version)
+                    .filter((e, i, sorted) => i === 0 || sorted[i - 1].version !== e.version);
+                const entry = rows.get(id) ?? {
+                    key: row.key,
+                    positions: [],
+                    work: [],
+                    byInstance: new Map(),
+                };
+                entry.positions.push(...row.positions);
+                entry.byInstance.set(`${group.source.name}\u0000${group.streamIdStr}`, row.positions);
+                entry.work.push({
+                    source: group.source,
+                    streamIdStr: group.streamIdStr,
+                    streamId: placed.success.streamId,
+                    events: ordered,
+                    top: 0,
+                    delivered,
+                });
+                rows.set(id, entry);
+            }
+        }
+        const tasks = [...rows.values()].map((row) => {
+            const positions = row.positions.sort((a, b) => a - b);
+            return {
+                first: positions[0],
+                run: Effect.result(Effect.gen(function* () {
+                    const result = (yield* engine.applyRow(row.key, row.work));
+                    return { result, applied: yield* deliverAfter(appliedOf(result), options?.deliver) };
+                })).pipe(Effect.map((outcome) => {
+                    if (Result.isFailure(outcome)) {
+                        return [{ _tag: "Failed", key: row.key, positions, error: outcome.failure }];
+                    }
+                    // The instances that failed are their own outcomes; the rest applied.
+                    const failedAt = new Set();
+                    const instanceFailures = outcome.success.result.failed.map((f) => {
+                        const at = row.byInstance.get(`${f.source}\u0000${f.streamId}`) ?? [];
+                        for (const p of at)
+                            failedAt.add(p);
+                        return { _tag: "Failed", key: row.key, positions: at, error: f.error };
+                    });
+                    return [
+                        {
+                            _tag: "Applied",
+                            positions: positions.filter((p) => !failedAt.has(p)),
+                            ...outcome.success.applied,
+                        },
+                        ...instanceFailures,
+                    ];
+                })),
+            };
+        });
+        tasks.sort((a, b) => a.first - b.first);
+        const outcomes = [
+            ...failed,
+            ...(yield* Effect.forEach(tasks, (task) => task.run, {
+                concurrency: options?.concurrency ?? 10,
+            })).flat(),
+        ]
+            .filter((o) => o._tag === "Failed" || o.positions.length > 0 || o.instances.length > 0)
+            .sort((a, b) => (a.positions[0] ?? 0) - (b.positions[0] ?? 0));
+        return {
+            outcomes,
+            failedPositions: outcomes
+                .filter((o) => o._tag === "Failed")
+                .map((o) => o.positions[0])
+                .sort((a, b) => a - b),
+            ignored: ignored.sort((a, b) => a - b),
+        };
+    });
+    /** The instances a row's checkpoints know: map entries, and field owners. */
+    const knownInstances = (values) => {
+        const known = [];
+        const map = config.checkpoints.field === undefined
+            ? {}
+            : (values[config.checkpoints.field] ?? {});
+        for (const entry of Object.keys(map)) {
+            const at = entry.indexOf("#");
+            if (at > 0)
+                known.push([entry.slice(0, at), entry.slice(at + 1)]);
+        }
+        for (const [name, f] of Object.entries(mapped)) {
+            const owner = values[f.instanceField];
+            if (typeof owner === "string" && owner !== "")
+                known.push([name, owner]);
+        }
+        return known.filter(([name]) => engineSources[name] !== undefined);
+    };
+    const catchUp = (key) => Effect.gen(function* () {
+        const row = yield* engine.readRow(key);
+        if (Option.isNone(row)) {
+            return appliedOf({
+                key,
+                instances: [],
+                state: Option.none(),
+                removed: false,
+                revision: undefined,
+                enqueued: 0,
+                failed: [],
+            });
+        }
+        const work = [];
+        for (const [name, streamIdStr] of knownInstances(row.value.values)) {
+            const source = engineSources[name];
+            const streamId = yield* source.stream.parseStreamId(streamIdStr);
+            const head = yield* source.stream.currentVersion(streamId, {
+                consistentRead: true,
+            });
+            work.push({
+                source,
+                streamIdStr,
+                streamId,
+                events: undefined,
+                top: head,
+                delivered: new Set(),
+            });
+        }
+        return appliedOf((yield* engine.applyRow(key, work)));
+    });
+    const rebuild = (key, options) => Effect.gen(function* () {
+        const named = options?.instances ??
+            (config.sourcesOf === undefined
+                ? yield* Effect.die(new Error(`[EDD-9081] ${label}.rebuild: pass \`instances\`, or declare \`sourcesOf\`.`))
+                : (yield* config.sourcesOf(key)));
+        const rowId = keyId(key);
+        const work = [];
+        for (const name of names) {
+            const ids = (named[name] ??
+                []);
+            const source = engineSources[name];
+            for (const streamId of ids) {
+                const events = (yield* source.stream.read(streamId, { consistentRead: true }));
+                const mine = [];
+                for (const event of events) {
+                    const k = addressed(yield* engine.call("key", () => source.key(streamId, event)));
+                    if (Option.isSome(k) && keyId(k.value) === rowId)
+                        mine.push(event);
+                }
+                if (mine.length === 0)
+                    continue;
+                work.push({
+                    source,
+                    streamIdStr: source.stream.streamIdFields.map((f) => streamId[f]).join("#"),
+                    streamId,
+                    events: mine,
+                    top: mine[mine.length - 1].version,
+                    delivered: new Set(events.map((e) => e.version)),
+                });
+            }
+        }
+        return appliedOf((yield* engine.applyRow(key, work, { fromScratch: true })));
+    });
+    const routes = (name) => names.map((tag) => ({
+        name,
+        tag,
+        stream: engineSources[tag].stream,
+        decode: (image) => engineSources[tag].stream.decodeStreamImage(image),
+        applyBatch: (events, applyOptions) => applyBatch(events, applyOptions),
+    }));
+    const processBatch = (records, options) => runBatch(`${label}.processBatch`, records, options, routes("projection")).pipe(Effect.map(({ outcomes, unrouted: _, ...rest }) => ({
+        ...rest,
+        outcomes: outcomes.projection,
+    })));
+    return {
+        [MultiProjectionTypeId]: MultiProjectionTypeId,
+        pipe() {
+            // eslint-disable-next-line prefer-rest-params
+            return Pipeable.pipeArguments(this, arguments);
+        },
+        [ProjectionRoutes]: routes,
+        entityType: readModel.entityType,
+        sources,
+        applyBatch,
+        catchUp,
+        rebuild,
+        processBatch,
+        drain: (key, deliver) => config.outbox === undefined
+            ? Effect.die(new Error(`[EDD-9081] ${label}.drain: the projection declares no \`outbox\`.`))
+            : engine.drain(key, deliver),
+        drainPending: (deliver) => config.outbox === undefined
+            ? Effect.die(new Error(`[EDD-9081] ${label}.drainPending: the projection declares no \`outbox\`.`))
+            : engine.drainPending(deliver),
+    };
+};
+export { instanceKey };
+//# sourceMappingURL=MultiProjection.js.map

package/dist/internal/MultiProjection.js.map

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

package/dist/internal/ProjectionEngine.d.ts

@@ -0,0 +1,253 @@
+/**
+ * The row engine behind EventStore projections (#151, #153, #154, #155).
+ *
+ * One engine serves single-source projections (`EventStore.projection`, one
+ * source and a scalar checkpoint) and multi-source projections
+ * (`EventStore.multiProjection`, a checkpoint per source instance): a row is
+ * read strongly consistent, each contributing instance's events are ordered,
+ * deduplicated and gap-filled from the store, folded, and written once —
+ * conditioned on the row's revision (or, without one, its checkpoint) — as
+ * the row, a tombstone (#154), or either together with outbox items in one
+ * transaction (#155).
+ *
+ * Internal: the public shapes live in `EventProjection.ts` / `MultiProjection.ts`.
+ *
+ * @internal
+ */
+import { ConcurrentModification, type ConditionalCheckFailed, ValidationError } from "@effect-dynamodb/schema/Errors.js";
+import { type Duration, Effect, Option, Schedule, type Schema } from "effect";
+import type { StreamEvent } from "../EventStore.js";
+import type * as Query from "../Query.js";
+declare const RemoveRowTypeId: unique symbol;
+/** What `evolve` returns to remove the row — see {@link removeRow}. */
+export interface RemoveRow {
+    readonly [RemoveRowTypeId]: typeof RemoveRowTypeId;
+}
+/**
+ * Returned from a projection's `evolve`, removes the row: the library writes a
+ * tombstone at the row's key that keeps its checkpoints (and revision), so a
+ * redelivery can't recreate it. A later event starts the row again from
+ * `initial`. Requires `removal` on the projection.
+ */
+export declare const removeRow: RemoveRow;
+/** @internal */
+export declare const isRemoveRow: (u: unknown) => u is RemoveRow;
+/** The `__edd_e__` of a read model's tombstones. */
+export declare const tombstoneMarker: (entityType: string) => string;
+/** The `__edd_e__` of a read model's outbox items. */
+export declare const outboxMarker: (entityType: string) => string;
+/** Attribute names the engine owns on tombstones and outbox items. */
+export declare const REMOVED_AT = "__edd_removed__";
+type AnyEvent = StreamEvent<unknown, unknown>;
+/** @internal The read-model entity, as far as the engine uses it. */
+export interface EngineEntity {
+    readonly entityType: string;
+    readonly model: Schema.Top;
+    readonly indexes: {
+        readonly primary?: {
+            readonly pk: {
+                readonly field: string;
+            };
+            readonly sk: {
+                readonly field: string;
+            };
+        };
+    };
+    readonly systemFields: {
+        readonly createdAt: string | null;
+        readonly createdAtEncoding: unknown;
+    };
+    readonly put: (input: any) => any;
+    readonly create: (input: any) => any;
+    readonly _tableTag: any;
+    readonly _renameToDynamo: (item: Record<string, unknown>) => void;
+    readonly _attachPrototype?: ((decoded: any) => any) | undefined;
+    readonly _multiItemWriteFeatures?: ReadonlyArray<string> | undefined;
+    readonly schemas: any;
+}
+/** @internal One source a row engine reads. */
+export interface EngineSource {
+    readonly name: string;
+    readonly stream: {
+        readonly streamName: string;
+        readonly eventMarker: string;
+        readonly streamIdFields: ReadonlyArray<string>;
+        parseStreamId(id: string): Effect.Effect<any, ValidationError>;
+        readFrom(id: any, after: number, options?: any): Effect.Effect<ReadonlyArray<any>, any, any>;
+        read(id: any, options?: any): Effect.Effect<ReadonlyArray<any>, any, any>;
+        readonly query: {
+            events(id: any): Query.Query<any>;
+        };
+        decodeStreamImage(image: any): Effect.Effect<Option.Option<any>, ValidationError, any>;
+    };
+    /** `K`, or `Option<K>` (none: the event addresses no row). */
+    readonly key: (streamId: any, event: any) => unknown;
+    readonly evolve: (state: any, event: any, context: EvolveContext) => Effect.Effect<any, any, any>;
+    readonly mode: "fold" | "latest";
+    readonly terminal: ((error: any) => boolean) | undefined;
+}
+/** What `evolve` is told about the event it folds. */
+export interface EvolveContext {
+    /** The source (a multi-source projection's name for it; `"projection"` otherwise). */
+    readonly source: string;
+    /** The stream instance (`StreamEvent.streamId`). */
+    readonly streamId: string;
+}
+/** @internal Where a row keeps its checkpoints. */
+export type CheckpointLayout = {
+    readonly kind: "scalar";
+    readonly field: string;
+    readonly offset: number;
+} | {
+    readonly kind: "sources";
+    /** A `Record<string, number>` model field, keyed `<source>#<streamId>`. */
+    readonly map: string | undefined;
+    readonly fields: Readonly<Record<string, {
+        readonly field: string;
+        readonly offset: number;
+        readonly instanceField: string;
+    }>>;
+};
+/** @internal */
+export interface EngineOutbox {
+    readonly schema: Schema.Codec<any, any>;
+    readonly effects: (event: any, next: any, context: EvolveContext) => ReadonlyArray<any>;
+    readonly table: {
+        readonly Tag: any;
+    } | undefined;
+    readonly pk: string;
+    readonly sk: string;
+    readonly index: {
+        readonly name: string;
+        readonly pk: string;
+        readonly sk: string;
+    } | undefined;
+    readonly claimFor: Duration.Duration;
+}
+/** @internal */
+export interface EngineConfig {
+    readonly label: string;
+    readonly readModel: EngineEntity;
+    readonly sources: ReadonlyArray<EngineSource>;
+    readonly initial: (key: any, context: {
+        readonly source: string;
+        readonly streamId: any;
+        readonly event: any;
+    }) => any;
+    readonly checkpoints: CheckpointLayout;
+    /**
+     * The library-owned revision field, incremented and conditioned on by every
+     * write; `initial` is the value a row without one is written with.
+     */
+    readonly revision: {
+        readonly field: string;
+        readonly initial: number;
+    } | undefined;
+    readonly toItem: ((state: any, context: any) => any) | undefined;
+    readonly retry: Schedule.Schedule<unknown, unknown>;
+    readonly removal: {
+        readonly ttl: Duration.Duration | undefined;
+    } | undefined;
+    readonly outbox: EngineOutbox | undefined;
+    /** Builds the context `toItem` receives for a row. */
+    readonly toItemContext: (key: any, instances: ReadonlyArray<InstanceWork>) => any;
+}
+/** @internal One source instance's share of a row's work. */
+export interface InstanceWork {
+    readonly source: EngineSource;
+    readonly streamIdStr: string;
+    readonly streamId: any;
+    /** The batch's events of this instance for this row, sorted and deduplicated; none: catch up to `top`. */
+    readonly events: ReadonlyArray<AnyEvent> | undefined;
+    /** The highest version wanted when catching up (or rebuilding). */
+    readonly top: number;
+    /** Versions of every batch event of this instance (any row, or none). */
+    readonly delivered: ReadonlySet<number>;
+}
+/** @internal One instance's result. */
+export interface InstanceResult {
+    readonly source: string;
+    readonly streamId: string;
+    readonly applied: ReadonlyArray<AnyEvent>;
+    readonly alreadyApplied: ReadonlyArray<AnyEvent>;
+    readonly rejected: ReadonlyArray<{
+        readonly event: AnyEvent;
+        readonly error: unknown;
+    }>;
+    readonly superseded: ReadonlyArray<AnyEvent>;
+    /** The instance's checkpoint after this call, in store numbering. */
+    readonly version: number;
+}
+/** @internal A row's result. */
+export interface RowResult {
+    readonly key: unknown;
+    readonly instances: ReadonlyArray<InstanceResult>;
+    readonly state: Option.Option<unknown>;
+    readonly removed: boolean;
+    readonly revision: number | undefined;
+    /** Outbox effects committed with this write. */
+    readonly enqueued: number;
+    /** Instances that failed and were left out of the write (the others applied). */
+    readonly failed: ReadonlyArray<{
+        readonly source: string;
+        readonly streamId: string;
+        readonly error: unknown;
+    }>;
+}
+/** A key's identity: its fields, sorted, as JSON. */
+export declare const keyId: (key: unknown) => string;
+/** `K | Option<K>` → `Option<K>`. */
+export declare const addressed: <K>(key: unknown) => Option.Option<K>;
+/** A map checkpoint's key. */
+export declare const instanceKey: (source: string, streamId: string) => string;
+/** @internal */
+export declare const modelFields: (model: Schema.Top) => ReadonlyArray<string> | undefined;
+/** A row as read. */
+interface Row {
+    /** The model fields (with `Hidden` ones), or — for a tombstone — the kept checkpoint fields. */
+    readonly values: Record<string, unknown>;
+    readonly tombstone: boolean;
+    readonly createdAt: unknown;
+}
+/** @internal */
+export declare const makeEngine: (config: EngineConfig) => {
+    readRow: (key: unknown) => Effect.Effect<Option.Option<Row>, any, any>;
+    applyRow: (key: unknown, work: ReadonlyArray<InstanceWork>, options?: {
+        readonly fromScratch?: boolean | undefined;
+    }) => Effect.Effect<RowResult, any, any>;
+    drain: <E, R>(key: unknown, deliver: (effect: any, meta: OutboxMeta) => Effect.Effect<void, E, R>) => Effect.Effect<DrainResult<E>, any, any>;
+    drainPending: <E, R>(deliver: (effect: any, meta: OutboxMeta) => Effect.Effect<void, E, R>) => Effect.Effect<{
+        delivered: number;
+        undelivered: {
+            readonly meta: OutboxMeta;
+            readonly error: E;
+        }[];
+    }, any, any>;
+    call: <X>(name: string, f: () => X) => Effect.Effect<X, ValidationError>;
+};
+/** What `deliver` is told about an effect. */
+export interface OutboxMeta {
+    readonly source: string;
+    readonly streamId: string;
+    readonly version: number;
+    readonly eventType: string;
+}
+/** Result of draining a row's outbox. */
+export interface DrainResult<E> {
+    /** Effects delivered (and removed). */
+    readonly delivered: number;
+    /** The effect `deliver` failed on — it stays pending, at the head. */
+    readonly undelivered: Option.Option<{
+        readonly meta: OutboxMeta;
+        readonly error: E;
+    }>;
+}
+/**
+ * The default lost-race policy: up to 12 retries after a jittered delay
+ * growing from 5 ms by 1.5× (about 1.3 s in all).
+ */
+export declare const defaultRetry: Schedule.Schedule<unknown, unknown>;
+/** The `retry` option as a schedule. */
+export declare const retrySchedule: (retry: number | Schedule.Schedule<unknown, ConcurrentModification> | undefined) => Schedule.Schedule<unknown, unknown>;
+export type { ConditionalCheckFailed };
+//# sourceMappingURL=ProjectionEngine.d.ts.map