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

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/event-coordinator.d.ts

@@ -0,0 +1,16 @@
+import type { IEsEvent, ISavedChange } from "@ddd-ts/core";
+export declare class EventCoordinator {
+    private eventProcessing;
+    private currentEventId;
+    private lastEvent;
+    private isRunning;
+    private _onEmpty;
+    addEvent(event: ISavedChange<IEsEvent>): void;
+    start(event: ISavedChange<IEsEvent>): () => void;
+    waitCurrentEvent(): Promise<void>;
+    cleanEvent(event: ISavedChange<IEsEvent>): void;
+    canProceed(event: ISavedChange<IEsEvent>): boolean;
+    onEmpty(callback: () => void): void;
+    checkEmpty(): void;
+}
+//# sourceMappingURL=event-coordinator.d.ts.map

package/dist/projection/event-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-coordinator.d.ts","sourceRoot":"","sources":["../../src/projection/event-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG3D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,eAAe,CAAkD;IACzE,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,SAAS,CAAuC;IACxD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAY;IAE5B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC;IAYtC,KAAK,CAAC,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC;IAU7B,gBAAgB;IAMtB,UAAU,CAAC,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC;IAYxC,UAAU,CAAC,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC;IAMxC,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI;IAI5B,UAAU;CAKX"}

package/dist/projection/event-coordinator.js

@@ -0,0 +1,47 @@
+const require_promise_with_resolvers = require('../utils/promise-with-resolvers.js');
+
+//#region src/projection/event-coordinator.ts
+var EventCoordinator = class {
+	eventProcessing = /* @__PURE__ */ new Map();
+	currentEventId = null;
+	lastEvent = null;
+	isRunning = false;
+	_onEmpty = () => {};
+	addEvent(event) {
+		const eventId = event.id.serialize();
+		this.eventProcessing.set(eventId, require_promise_with_resolvers.promiseWithResolvers());
+		if (this.lastEvent === null || this.lastEvent.revision < event.revision) this.lastEvent = event;
+	}
+	start(event) {
+		if (this.isRunning) throw new Error("Event processing already in progress");
+		this.currentEventId = event.id.serialize();
+		this.isRunning = true;
+		return () => this.cleanEvent(event);
+	}
+	async waitCurrentEvent() {
+		if (!this.currentEventId) return;
+		await this.eventProcessing.get(this.currentEventId)?.promise;
+	}
+	cleanEvent(event) {
+		const eventId = event.id.serialize();
+		this.eventProcessing.get(eventId)?.resolve();
+		this.eventProcessing.delete(eventId);
+		this.isRunning = false;
+		this.currentEventId = null;
+		this.checkEmpty();
+	}
+	canProceed(event) {
+		if (this.isRunning) return false;
+		const eventId = event.id.serialize();
+		return this.lastEvent?.id.serialize() === eventId;
+	}
+	onEmpty(callback) {
+		this._onEmpty = callback;
+	}
+	checkEmpty() {
+		if (this.eventProcessing.size === 0) this._onEmpty();
+	}
+};
+
+//#endregion
+exports.EventCoordinator = EventCoordinator;

package/dist/projection/event-coordinator.mjs

@@ -0,0 +1,47 @@
+import { promiseWithResolvers } from "../utils/promise-with-resolvers.mjs";
+
+//#region src/projection/event-coordinator.ts
+var EventCoordinator = class {
+	eventProcessing = /* @__PURE__ */ new Map();
+	currentEventId = null;
+	lastEvent = null;
+	isRunning = false;
+	_onEmpty = () => {};
+	addEvent(event) {
+		const eventId = event.id.serialize();
+		this.eventProcessing.set(eventId, promiseWithResolvers());
+		if (this.lastEvent === null || this.lastEvent.revision < event.revision) this.lastEvent = event;
+	}
+	start(event) {
+		if (this.isRunning) throw new Error("Event processing already in progress");
+		this.currentEventId = event.id.serialize();
+		this.isRunning = true;
+		return () => this.cleanEvent(event);
+	}
+	async waitCurrentEvent() {
+		if (!this.currentEventId) return;
+		await this.eventProcessing.get(this.currentEventId)?.promise;
+	}
+	cleanEvent(event) {
+		const eventId = event.id.serialize();
+		this.eventProcessing.get(eventId)?.resolve();
+		this.eventProcessing.delete(eventId);
+		this.isRunning = false;
+		this.currentEventId = null;
+		this.checkEmpty();
+	}
+	canProceed(event) {
+		if (this.isRunning) return false;
+		const eventId = event.id.serialize();
+		return this.lastEvent?.id.serialize() === eventId;
+	}
+	onEmpty(callback) {
+		this._onEmpty = callback;
+	}
+	checkEmpty() {
+		if (this.eventProcessing.size === 0) this._onEmpty();
+	}
+};
+
+//#endregion
+export { EventCoordinator };

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

@@ -0,0 +1,128 @@
+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 { Mapping, MicrosecondTimestamp } from "@ddd-ts/shape";
+import { DefaultConverter, FirestoreTransaction } from "@ddd-ts/store-firestore";
+interface FirestoreProjectorConfig {
+    retry: {
+        attempts: number;
+        minDelay: number;
+        maxDelay: number;
+        backoff: number;
+    };
+    enqueue: {
+        batchSize: number;
+    };
+    onProcessError: (error: Error) => void;
+    onEnqueueError: (error: Error) => void;
+}
+export declare class FirestoreProjector {
+    readonly projection: ESProjection<IEsEvent>;
+    readonly reader: ProjectedStreamReader<IEsEvent>;
+    readonly queue: FirestoreQueueStore;
+    config: FirestoreProjectorConfig;
+    _unclaim: boolean;
+    constructor(projection: ESProjection<IEsEvent>, reader: ProjectedStreamReader<IEsEvent>, queue: FirestoreQueueStore, config?: FirestoreProjectorConfig);
+    breathe(): AsyncGenerator<readonly [number, () => void], void, unknown>;
+    private eventCoordinators;
+    private getEventCoordinator;
+    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;
+    private assertBeforeInsert;
+}
+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(claimerId: ClaimerId, 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;
+    /** @deprecated */ readonly claimer: import("@ddd-ts/shape").IOptional<StringConstructor, typeof import("@ddd-ts/shape").Empty>;
+    /** @deprecated */ readonly claimedAt: import("@ddd-ts/shape").IOptional<typeof MicrosecondTimestamp, typeof import("@ddd-ts/shape").Empty>;
+    readonly claimsMetadata: Mapping<[{
+        claimedAt: typeof MicrosecondTimestamp;
+        processedAt: import("@ddd-ts/shape").IOptional<typeof MicrosecondTimestamp, typeof import("@ddd-ts/shape").Empty>;
+    }], typeof import("@ddd-ts/shape").Empty>;
+    readonly claimIds: [StringConstructor];
+    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 currentClaimId(): string | undefined;
+    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":"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"}