@ddd-ts/event-sourcing-firestore 0.0.37 → 0.0.38

package/dist/projection/cases/bigshuffle.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bigshuffle.spec.d.ts","sourceRoot":"","sources":["../../../src/projection/cases/bigshuffle.spec.ts"],"names":[],"mappings":""}

package/dist/projection/cases/burst.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=burst.spec.d.ts.map

package/dist/projection/cases/burst.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"burst.spec.d.ts","sourceRoot":"","sources":["../../../src/projection/cases/burst.spec.ts"],"names":[],"mappings":""}

package/dist/projection/cases/claimtimeout.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=claimtimeout.spec.d.ts.map

package/dist/projection/cases/claimtimeout.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claimtimeout.spec.d.ts","sourceRoot":"","sources":["../../../src/projection/cases/claimtimeout.spec.ts"],"names":[],"mappings":""}

package/dist/projection/cases/concurrency.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=concurrency.spec.d.ts.map

package/dist/projection/cases/concurrency.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.spec.d.ts","sourceRoot":"","sources":["../../../src/projection/cases/concurrency.spec.ts"],"names":[],"mappings":""}

package/dist/projection/cases/deduplicate.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deduplicate.spec.d.ts.map

package/dist/projection/cases/deduplicate.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deduplicate.spec.d.ts","sourceRoot":"","sources":["../../../src/projection/cases/deduplicate.spec.ts"],"names":[],"mappings":""}

package/dist/projection/cases/defer.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=defer.spec.d.ts.map

package/dist/projection/cases/defer.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defer.spec.d.ts","sourceRoot":"","sources":["../../../src/projection/cases/defer.spec.ts"],"names":[],"mappings":""}

package/dist/projection/cases/lock.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lock.spec.d.ts.map

package/dist/projection/cases/lock.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.spec.d.ts","sourceRoot":"","sources":["../../../src/projection/cases/lock.spec.ts"],"names":[],"mappings":""}

package/dist/projection/cases/skip.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skip.spec.d.ts.map

package/dist/projection/cases/skip.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skip.spec.d.ts","sourceRoot":"","sources":["../../../src/projection/cases/skip.spec.ts"],"names":[],"mappings":""}

package/dist/projection/cases/stress.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stress.spec.d.ts.map

package/dist/projection/cases/stress.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stress.spec.d.ts","sourceRoot":"","sources":["../../../src/projection/cases/stress.spec.ts"],"names":[],"mappings":""}

package/dist/projection/firestore.projector.d.ts

@@ -0,0 +1,130 @@
+import { Firestore, WriteBatch } from "firebase-admin/firestore";
+import { type IEsEvent, type ISavedChange, EventId, ProjectedStreamReader, Cursor, CheckpointId, ESProjection, type IFact, type Serialized, Lock } from "@ddd-ts/core";
+import { MicrosecondTimestamp } from "@ddd-ts/shape";
+import { DefaultConverter, FirestoreTransaction } from "@ddd-ts/store-firestore";
+export declare class FirestoreProjector {
+    readonly projection: ESProjection<IEsEvent>;
+    readonly reader: ProjectedStreamReader<IEsEvent>;
+    readonly queue: FirestoreQueueStore;
+    config: {
+        retry: {
+            attempts: number;
+            minDelay: number;
+            maxDelay: number;
+            backoff: number;
+        };
+        enqueue: {
+            batchSize: number;
+        };
+        onProcessError: (error: Error) => void;
+        onEnqueueError: (error: Error) => void;
+    };
+    _unclaim: boolean;
+    constructor(projection: ESProjection<IEsEvent>, reader: ProjectedStreamReader<IEsEvent>, queue: FirestoreQueueStore, config?: {
+        retry: {
+            attempts: number;
+            minDelay: number;
+            maxDelay: number;
+            backoff: number;
+        };
+        enqueue: {
+            batchSize: number;
+        };
+        onProcessError: (error: Error) => void;
+        onEnqueueError: (error: Error) => void;
+    });
+    breathe(): AsyncGenerator<readonly [number, () => void], void, unknown>;
+    handle(savedChange: ISavedChange<IEsEvent>): Promise<void>;
+    private getCursor;
+    private attempt;
+    private getQueueHead;
+    private readSourceStream;
+    private enqueue;
+    private enqueueOne;
+    private checkIsProcessed;
+    private getUnprocessed;
+    private claimTasks;
+    private processEvents;
+}
+export declare class AlreadyEnqueuedError extends Error {
+    constructor();
+}
+export declare class FirestoreQueueStore {
+    db: Firestore;
+    converter: DefaultConverter<FirebaseFirestore.DocumentData>;
+    collection: FirebaseFirestore.CollectionReference;
+    constructor(db: Firestore);
+    private timestampToMicroseconds;
+    private microsecondsToTimestamp;
+    enqueue(checkpointId: CheckpointId, tasks: Task<false>[]): Promise<readonly ["OK", "Tasks enqueued successfully"] | readonly ["DEFERRED", any]>;
+    claim(checkpointId: CheckpointId, claimer: ClaimerId, tasks: Task<true>[]): Promise<void>;
+    head(checkpointId: CheckpointId): Promise<Cursor | undefined>;
+    unprocessed(checkpointId: CheckpointId): Promise<Task<true>[]>;
+    claimed(checkpointId: CheckpointId, claimer: ClaimerId): Promise<Task<true>[]>;
+    unclaim(checkpointId: CheckpointId, tasks: Task<true>[]): Promise<void>;
+    /**
+     * If the task exists, then looks for a processed flag.
+     * If not found, check if the cursor is older than the retention time for processed event.
+     * If so, consider it processed.
+     * Otherwise, consider it missing.
+     */
+    isProcessed(checkpointId: CheckpointId, cursor: Cursor): Promise<"ENQUEUED" | "PROCESSED" | "MISSING">;
+    checkpoint(id: CheckpointId): FirebaseFirestore.CollectionReference<FirebaseFirestore.DocumentData, FirebaseFirestore.DocumentData>;
+    queue(id: CheckpointId): FirebaseFirestore.CollectionReference<FirebaseFirestore.DocumentData, FirebaseFirestore.DocumentData>;
+    queued(id: CheckpointId, eventId: EventId): FirebaseFirestore.DocumentReference<FirebaseFirestore.DocumentData, FirebaseFirestore.DocumentData>;
+    processed(id: CheckpointId, eventIds: EventId[], context?: {
+        transaction?: FirestoreTransaction;
+        batchWriter?: WriteBatch;
+    }): Promise<void>;
+    getTailCursor(id: CheckpointId): Promise<Cursor | undefined>;
+    cleanup(id: CheckpointId): Promise<void>;
+    flush(id: CheckpointId): Promise<void>;
+    /**
+     * This method adds a fake processed event to the queue.
+     * It is useful for initializing the tail cursor of a new projection, at the
+     * same time as the projection's initial state is created, reset, or updated.
+     * By default, it will use the current time as the occurredAt timestamp.
+     * You can override this by providing a specific timestamp.
+     *
+     * This ensures that the projection can start processing new events from the
+     * correct point in time, avoiding reprocessing of old events.
+     */
+    seed(checkpointId: CheckpointId): Promise<void>;
+}
+export declare class ClaimerId extends EventId {
+}
+declare const Task_base: import("@ddd-ts/shape").IDict<{
+    readonly id: typeof EventId;
+    readonly ref: StringConstructor;
+    readonly occurredAt: typeof MicrosecondTimestamp;
+    readonly revision: NumberConstructor;
+    readonly attempts: NumberConstructor;
+    readonly processed: BooleanConstructor;
+    readonly claimer: import("@ddd-ts/shape").IOptional<StringConstructor, typeof import("@ddd-ts/shape").Empty>;
+    readonly claimedAt: import("@ddd-ts/shape").IOptional<typeof MicrosecondTimestamp, typeof import("@ddd-ts/shape").Empty>;
+    readonly lock: typeof Lock;
+    readonly skipAfter: NumberConstructor;
+    readonly remaining: NumberConstructor;
+    readonly isolateAfter: NumberConstructor;
+    readonly claimTimeout: NumberConstructor;
+    readonly lastUpdateTime: import("@ddd-ts/shape").IOptional<typeof MicrosecondTimestamp, typeof import("@ddd-ts/shape").Empty>;
+}, typeof import("@ddd-ts/shape").Empty>;
+export declare class Task<Stored extends boolean> extends Task_base {
+    lastUpdateTime: Stored extends true ? MicrosecondTimestamp : undefined;
+    get cursor(): Cursor;
+    static new(fact: IFact, config: {
+        lock: Lock;
+        claimTimeout: number;
+        skipAfter: number;
+        isolateAfter: number;
+    }): Task<false>;
+    get isProcessing(): boolean;
+    get isProcessed(): boolean;
+    get shouldSkip(): boolean;
+    get shouldIsolate(): boolean;
+    checkTimeout(): void;
+    static deserializeWithLastUpdateTime(data: Omit<Serialized<Task<true>>, "lastUpdateTime">, timestamp?: MicrosecondTimestamp): Task<true>;
+    static batch(tasks: Task<true>[]): Task<true>[];
+}
+export {};
+//# sourceMappingURL=firestore.projector.d.ts.map

package/dist/projection/firestore.projector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore.projector.d.ts","sourceRoot":"","sources":["../../src/projection/firestore.projector.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EAET,UAAU,EACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,OAAO,EACP,qBAAqB,EACrB,MAAM,EACN,YAAY,EACZ,YAAY,EAEZ,KAAK,KAAK,EACV,KAAK,UAAU,EACf,IAAI,EACL,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAmB,MAAM,eAAe,CAAC;AACtE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AAoBjC,qBAAa,kBAAkB;aAIX,UAAU,EAAE,YAAY,CAAC,QAAQ,CAAC;aAClC,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC;aACvC,KAAK,EAAE,mBAAmB;IACnC,MAAM;;;;;;;;;;gCAGa,KAAK;gCAGL,KAAK;;IAZjC,QAAQ,UAAQ;gBAGE,UAAU,EAAE,YAAY,CAAC,QAAQ,CAAC,EAClC,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,EACvC,KAAK,EAAE,mBAAmB,EACnC,MAAM;;;;;;;;;;gCAGa,KAAK;gCAGL,KAAK;KAG9B;IAGI,OAAO;IA4BR,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,QAAQ,CAAC;YAwClC,SAAS;YAKT,OAAO;YAkEP,YAAY;YAKZ,gBAAgB;YAahB,OAAO;YAqBP,UAAU;YAYV,gBAAgB;YAKhB,cAAc;YAKd,UAAU;YAcV,aAAa;CA8C5B;AAED,qBAAa,oBAAqB,SAAQ,KAAK;;CAK9C;AAED,qBAAa,mBAAmB;IAIX,EAAE,EAAE,SAAS;IAHhC,SAAS,mDAA0B;IACnC,UAAU,EAAE,iBAAiB,CAAC,mBAAmB,CAAC;gBAE/B,EAAE,EAAE,SAAS;IAMhC,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,uBAAuB;IAQzB,OAAO,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;IA0BxD,KAAK,CACT,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,SAAS,EAClB,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;IAqBf,IAAI,CAAC,YAAY,EAAE,YAAY;IAyB/B,WAAW,CAAC,YAAY,EAAE,YAAY;IA+CtC,OAAO,CACX,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,SAAS,GACjB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAgBlB,OAAO,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;IAc7D;;;;;OAKG;IACG,WAAW,CAAC,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM;IAgB5D,UAAU,CAAC,EAAE,EAAE,YAAY;IAI3B,KAAK,CAAC,EAAE,EAAE,YAAY;IAItB,MAAM,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO;IAInC,SAAS,CACb,EAAE,EAAE,YAAY,EAChB,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,GAAE;QACP,WAAW,CAAC,EAAE,oBAAoB,CAAC;QACnC,WAAW,CAAC,EAAE,UAAU,CAAC;KACrB;IAuBF,aAAa,CAAC,EAAE,EAAE,YAAY;IA0B9B,OAAO,CAAC,EAAE,EAAE,YAAY;IA6BxB,KAAK,CAAC,EAAE,EAAE,YAAY;IAO5B;;;;;;;;;OASG;IACG,IAAI,CAAC,YAAY,EAAE,YAAY;CAoCtC;AAED,qBAAa,SAAU,SAAQ,OAAO;CAAG;;;;;;;;;;;;;;;;;AACzC,qBAAa,IAAI,CAAC,MAAM,SAAS,OAAO,CAAE,SAAQ,SAehD;IACQ,cAAc,EAAE,MAAM,SAAS,IAAI,GACvC,oBAAoB,GACpB,SAAS,CAAC;IAEd,IAAI,MAAM,WAOT;IAED,MAAM,CAAC,GAAG,CACR,IAAI,EAAE,KAAK,EACX,MAAM,EAAE;QACN,IAAI,EAAE,IAAI,CAAC;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;KACtB,GACA,IAAI,CAAC,KAAK,CAAC;IAmBd,IAAI,YAAY,YAEf;IAED,IAAI,WAAW,YAEd;IAED,IAAI,UAAU,YAEb;IAED,IAAI,aAAa,YAEhB;IAED,YAAY;IAaZ,MAAM,CAAC,6BAA6B,CAClC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,gBAAgB,CAAC,EACpD,SAAS,CAAC,EAAE,oBAAoB,GAC/B,IAAI,CAAC,IAAI,CAAC;IASb,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;CA0DjC"}