@flowcore/pathways 0.19.0 → 0.20.0

package/esm/deps/jsr.io/@flowcore/data-pump/0.18.0/src/data-pump/data-pump.d.ts

@@ -0,0 +1,86 @@
+import type { FlowcoreEvent } from "../../../../sdk/1.78.0/src/mod.js";
+import { FlowcoreDataSource } from "./data-source.js";
+import { type PulseSnapshot } from "./pulse.js";
+import type { FlowcoreDataPumpAuth, FlowcoreDataPumpDataSource, FlowcoreDataPumpProcessor, FlowcoreDataPumpState, FlowcoreDataPumpStateManager, FlowcoreLogger } from "./types.js";
+interface FlowcoreDataPumpNotifierNatsOptions {
+    type: "nats";
+    servers: string[];
+}
+interface FlowcoreDataPumpNotifierWebsocketOptions {
+    type: "websocket";
+}
+interface FlowcoreDataPumpNotifierPollerOptions {
+    type: "poller";
+    /**
+     * The interval in milliseconds to poll the data pump state (min 1000 ms)
+     */
+    intervalMs: number;
+}
+type FlowcoreDataPumpNotifierOptions = FlowcoreDataPumpNotifierNatsOptions | FlowcoreDataPumpNotifierWebsocketOptions | FlowcoreDataPumpNotifierPollerOptions;
+export interface FlowcoreDataPumpOptions {
+    auth: FlowcoreDataPumpAuth;
+    dataSource: FlowcoreDataPumpDataSource;
+    stateManager: FlowcoreDataPumpStateManager;
+    bufferSize?: number;
+    maxRedeliveryCount?: number;
+    achknowledgeTimeoutMs?: number;
+    includeSensitiveData?: boolean;
+    processor?: FlowcoreDataPumpProcessor;
+    notifier?: FlowcoreDataPumpNotifierOptions;
+    logger?: FlowcoreLogger;
+    stopAt?: Date;
+    baseUrlOverride?: string;
+    noTranslation?: boolean;
+    directMode?: boolean;
+    pulse?: {
+        url: string;
+        intervalMs?: number;
+        pathwayId: string;
+    };
+}
+export declare class FlowcoreDataPump {
+    readonly dataSource: FlowcoreDataSource;
+    private readonly notifier;
+    private stateManager;
+    private readonly options;
+    private readonly logger?;
+    private nextCursor?;
+    private running;
+    private restartTo?;
+    private abortController?;
+    private buffer;
+    private bufferState;
+    private stopAtState?;
+    private isLive;
+    private finallyFailedHandler?;
+    private pulseEmitter?;
+    private startedAt;
+    private acknowledgedCount;
+    private failedCount;
+    private pulledCount;
+    private constructor();
+    get isRunning(): boolean;
+    getSnapshot(): PulseSnapshot | null;
+    static create(options: FlowcoreDataPumpOptions, dataSourceOverride?: FlowcoreDataSource): FlowcoreDataPump;
+    start(callback?: (error?: Error) => void): Promise<void>;
+    restart(state: FlowcoreDataPumpState, stopAt?: Date | null): void;
+    stop(isRestart?: boolean): void;
+    private updateState;
+    private loop;
+    reserve(amount: number): Promise<FlowcoreEvent[]>;
+    onFinalyFailed(handler: (events: FlowcoreEvent[]) => Promise<void> | void): void;
+    acknowledge(eventIds: string[]): Promise<void>;
+    fail(eventIds: string[]): Promise<void>;
+    private reOpen;
+    private processLoop;
+    private updateMetricsGauges;
+    private incMetricsCounter;
+    private waiterEvents?;
+    private waitForEvents;
+    private waiterBufferThreshold?;
+    private waitForBufferThreshold;
+    private waiterBufferEmpty?;
+    private waitForBufferEmpty;
+}
+export {};
+//# sourceMappingURL=data-pump.d.ts.map

package/esm/deps/jsr.io/@flowcore/data-pump/0.18.0/src/data-pump/data-pump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-pump.d.ts","sourceRoot":"","sources":["../../../../../../../../src/deps/jsr.io/@flowcore/data-pump/0.18.0/src/data-pump/data-pump.ts"],"names":[],"mappings":"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"}

package/esm/deps/jsr.io/@flowcore/data-pump/0.18.0/src/data-pump/data-pump.js

@@ -0,0 +1,573 @@
+import { utc } from "@date-fns/utc";
+import { TimeUuid } from "../../../../time-uuid/0.1.2/src/mod.js";
+import { format, startOfHour } from "date-fns";
+import { FlowcoreDataSource } from "./data-source.js";
+import { metrics } from "./metrics.js";
+import { FlowcoreNotifier } from "./notifier.js";
+import { PulseEmitter } from "./pulse.js";
+export class FlowcoreDataPump {
+    constructor(dataSource, notifier, stateManager, options, logger) {
+        Object.defineProperty(this, "dataSource", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: dataSource
+        });
+        Object.defineProperty(this, "notifier", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: notifier
+        });
+        Object.defineProperty(this, "stateManager", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: stateManager
+        });
+        Object.defineProperty(this, "options", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: options
+        });
+        Object.defineProperty(this, "logger", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: logger
+        });
+        Object.defineProperty(this, "nextCursor", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "running", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        Object.defineProperty(this, "restartTo", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "abortController", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "buffer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "bufferState", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "stopAtState", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "isLive", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        Object.defineProperty(this, "finallyFailedHandler", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "pulseEmitter", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "startedAt", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "acknowledgedCount", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "failedCount", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "pulledCount", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        // #endregion
+        // #region Waiters
+        Object.defineProperty(this, "waiterEvents", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "waiterBufferThreshold", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "waiterBufferEmpty", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.bufferState = {
+            timeBucket: format(startOfHour(utc(new Date())), "yyyyMMddHH0000"),
+            eventId: TimeUuid.now().toString(),
+        };
+    }
+    get isRunning() {
+        return this.running;
+    }
+    getSnapshot() {
+        if (!this.running)
+            return null;
+        const reserved = this.buffer.filter((b) => b.status === "reserved").length;
+        const sizeBytes = this.buffer.reduce((sum, b) => sum + JSON.stringify(b.event.payload).length, 0);
+        return {
+            pathwayId: this.pulseEmitter ? "" : "", // set by caller
+            flowType: this.dataSource.flowType,
+            timeBucket: this.bufferState.timeBucket,
+            eventId: this.bufferState.eventId,
+            isLive: this.isLive,
+            bufferDepth: this.buffer.length,
+            bufferReserved: reserved,
+            bufferSizeBytes: sizeBytes,
+            acknowledgedTotal: this.acknowledgedCount,
+            failedTotal: this.failedCount,
+            pulledTotal: this.pulledCount,
+            uptimeMs: this.startedAt ? Date.now() - this.startedAt : 0,
+        };
+    }
+    static create(options, dataSourceOverride) {
+        if ("apiKey" in options.auth && !options.auth.apiKeyId) {
+            const parts = options.auth.apiKey.split("_");
+            if (parts.length !== 3 || parts[0] !== "fc") {
+                throw new Error("Invalid API key");
+            }
+            options.auth.apiKeyId = parts[1];
+        }
+        const dataSource = dataSourceOverride ?? new FlowcoreDataSource({
+            auth: options.auth,
+            dataSource: options.dataSource,
+            baseUrlOverride: options.baseUrlOverride,
+            noTranslation: options.noTranslation,
+            directMode: options.directMode,
+        });
+        const notifier = new FlowcoreNotifier({
+            auth: options.auth,
+            dataSource: options.dataSource,
+            natsServers: options.notifier?.type === "nats" ? options.notifier.servers : undefined,
+            pollerIntervalMs: options.notifier?.type === "poller" ? options.notifier.intervalMs : undefined,
+            logger: options.logger,
+            directMode: options.directMode,
+            noTranslation: options.noTranslation,
+        });
+        const pump = new FlowcoreDataPump(dataSource, notifier, options.stateManager, {
+            bufferSize: options.bufferSize ?? 1000,
+            bufferThreshold: Math.ceil((options.bufferSize ?? 1000) * 0.1),
+            maxRedeliveryCount: options.maxRedeliveryCount ?? 3,
+            achknowledgeTimeoutMs: options.achknowledgeTimeoutMs ?? 5_000,
+            includeSensitiveData: options.includeSensitiveData ?? false,
+            processor: options.processor,
+            stopAt: options.stopAt,
+        }, options.logger);
+        if (options.pulse) {
+            const pathwayId = options.pulse.pathwayId;
+            pump.pulseEmitter = new PulseEmitter({
+                url: options.pulse.url,
+                intervalMs: options.pulse.intervalMs,
+                auth: options.auth,
+                logger: options.logger,
+            }, () => {
+                const snapshot = pump.getSnapshot();
+                if (snapshot)
+                    snapshot.pathwayId = pathwayId;
+                return snapshot;
+            });
+        }
+        return pump;
+    }
+    async start(callback) {
+        this.isLive = false;
+        if (this.running) {
+            throw new Error("Data pump already running");
+        }
+        this.running = true;
+        this.startedAt = Date.now();
+        this.nextCursor = undefined;
+        this.updateMetricsGauges();
+        this.pulseEmitter?.start();
+        const currentState = await this.stateManager.getState();
+        const timeBucket = currentState
+            ? await this.dataSource.getClosestTimeBucket(currentState.timeBucket)
+            : format(startOfHour(utc(new Date())), "yyyyMMddHH0000");
+        this.bufferState = {
+            timeBucket: timeBucket ?? format(startOfHour(utc(new Date())), "yyyyMMddHH0000"),
+            eventId: currentState ? currentState.eventId : TimeUuid.now().toString(),
+        };
+        if (this.options.stopAt) {
+            this.stopAtState = {
+                timeBucket: (await this.dataSource.getClosestTimeBucket(format(startOfHour(utc(this.options.stopAt)), "yyyyMMddHH0000"), true)) ?? format(startOfHour(utc(new Date())), "yyyyMMddHH0000"),
+                eventId: TimeUuid.fromDate(this.options.stopAt).toString(),
+            };
+        }
+        if (this.options.processor) {
+            this.processLoop().catch((error) => {
+                this.logger?.error("Error in processor", { error });
+                this.stop();
+            });
+        }
+        if (!callback) {
+            return this.loop();
+        }
+        void this.loop()
+            .then(() => callback())
+            .catch((error) => callback(error));
+    }
+    restart(state, stopAt) {
+        this.restartTo = state;
+        if (stopAt !== undefined) {
+            this.options.stopAt = stopAt ?? undefined;
+        }
+        this.stop(true);
+    }
+    stop(isRestart = false) {
+        this.running = false;
+        this.buffer = [];
+        this.updateMetricsGauges();
+        this.pulseEmitter?.stop();
+        this.abortController?.abort();
+        this.waiterBufferThreshold?.();
+        if (!isRestart) {
+            this.waiterEvents?.();
+        }
+    }
+    updateState(eventId) {
+        if (!this.stateManager.setState) {
+            return;
+        }
+        const stateEventId = eventId ?? this.buffer[0]?.event.eventId;
+        if (!stateEventId) {
+            return;
+        }
+        const date = TimeUuid.fromString(stateEventId).getDate();
+        const timeBucket = format(startOfHour(utc(date)), "yyyyMMddHH0000");
+        return this.stateManager.setState?.({ timeBucket, eventId: stateEventId });
+    }
+    async loop() {
+        do {
+            const amountToFetch = this.options.bufferSize - this.buffer.length;
+            if (amountToFetch <= 0) {
+                this.logger?.info("Buffer is full, waiting for space");
+                await this.waitForBufferThreshold();
+                continue;
+            }
+            this.logger?.debug(`fetching ${amountToFetch} events from ${this.bufferState.timeBucket}(${this.nextCursor})`);
+            const { events, nextCursor } = await this.dataSource.getEvents(this.bufferState, amountToFetch, this.stopAtState?.eventId, this.nextCursor, this.options.includeSensitiveData);
+            if (!this.running) {
+                break;
+            }
+            this.logger?.debug(`fetched ${events.length} events`);
+            this.pulledCount += events.length;
+            this.buffer.push(...events.map((event) => ({ event, status: "open", deliveryCount: 0 })));
+            this.nextCursor = nextCursor;
+            this.updateMetricsGauges();
+            events.length && this.waiterEvents?.();
+            this.bufferState.eventId = events[events.length - 1]?.eventId ?? this.bufferState.eventId;
+            if (this.stopAtState?.timeBucket && this.bufferState.timeBucket >= this.stopAtState.timeBucket && !events.length) {
+                this.logger?.info("Stopping at stopAt state");
+                await this.waitForBufferEmpty();
+                this.stop();
+                break;
+            }
+            if (!this.nextCursor) {
+                const timeBucket = await this.dataSource.getNextTimeBucket(this.bufferState.timeBucket);
+                if (!this.running) {
+                    break;
+                }
+                if (timeBucket) {
+                    this.bufferState.timeBucket = timeBucket;
+                }
+                else {
+                    const previousTimeBucket = this.bufferState.timeBucket;
+                    this.bufferState.timeBucket = format(startOfHour(utc(new Date())), "yyyyMMddHH0000");
+                    if (previousTimeBucket === this.bufferState.timeBucket && !events.length) {
+                        this.isLive = true;
+                        this.logger?.debug("Going live...");
+                        this.abortController = new AbortController();
+                        await this.notifier.wait(this.abortController.signal);
+                    }
+                    else if (this.isLive) {
+                        await new Promise((resolve) => setTimeout(resolve, 1000));
+                    }
+                }
+            }
+        } while (this.running);
+        if (this.restartTo) {
+            await this.dataSource.getTimeBuckets(true);
+            this.restartTo.timeBucket = (await this.dataSource.getClosestTimeBucket(this.restartTo.timeBucket)) ??
+                format(startOfHour(utc(new Date())), "yyyyMMddHH0000");
+            this.nextCursor = undefined;
+            this.bufferState = this.restartTo;
+            this.restartTo = undefined;
+            this.running = true;
+            return this.loop();
+        }
+        this.logger?.info("Data pump stopped");
+    }
+    // #region Puller
+    async reserve(amount) {
+        if (!this.running) {
+            return [];
+        }
+        const events = [];
+        const deliveryId = crypto.randomUUID();
+        for (const event of this.buffer) {
+            if (event.status === "open") {
+                event.status = "reserved";
+                event.deliveryId = deliveryId;
+                event.deliveryCount++;
+                events.push(event.event);
+                this.incMetricsCounter("pulled", event.event.eventType, JSON.stringify(event.event).length);
+                if (events.length === amount) {
+                    break;
+                }
+            }
+        }
+        if (!events.length) {
+            await this.waitForEvents();
+            return this.reserve(amount);
+        }
+        this.updateMetricsGauges();
+        setTimeout(() => {
+            this.reOpen(events.map((event) => event.eventId), deliveryId);
+        }, this.options.achknowledgeTimeoutMs);
+        return events;
+    }
+    onFinalyFailed(handler) {
+        this.finallyFailedHandler = handler;
+    }
+    async acknowledge(eventIds) {
+        if (!this.running) {
+            return;
+        }
+        const lastEventInBuffer = this.buffer[this.buffer.length - 1];
+        this.buffer = this.buffer.filter((event) => {
+            if (eventIds.includes(event.event.eventId)) {
+                this.incMetricsCounter("acknowledged", event.event.eventType, 1);
+                this.acknowledgedCount++;
+                return false;
+            }
+            return true;
+        });
+        if (this.buffer.length <= this.options.bufferSize - this.options.bufferThreshold) {
+            this.waiterBufferThreshold?.();
+        }
+        await this.updateState(this.buffer.length ? undefined : lastEventInBuffer?.event.eventId);
+        this.updateMetricsGauges();
+        if (!this.buffer.length) {
+            this.waiterBufferEmpty?.();
+        }
+    }
+    async fail(eventIds) {
+        if (!this.running || !eventIds.length) {
+            return;
+        }
+        const lastEventInBuffer = this.buffer[this.buffer.length - 1];
+        const failedEvents = [];
+        this.buffer = this.buffer.filter((event) => {
+            if (eventIds.includes(event.event.eventId)) {
+                this.incMetricsCounter("failed", event.event.eventType, 1);
+                this.failedCount++;
+                failedEvents.push(event.event);
+                return false;
+            }
+            return true;
+        });
+        this.logger?.info(`Failed ${failedEvents.length} events`);
+        void this.options.processor?.failedHandler?.(failedEvents);
+        if (this.buffer.length <= this.options.bufferSize - this.options.bufferThreshold) {
+            this.waiterBufferThreshold?.();
+        }
+        await this.updateState(this.buffer.length ? undefined : lastEventInBuffer?.event.eventId);
+        if (!this.buffer.length) {
+            this.waiterBufferEmpty?.();
+        }
+    }
+    async reOpen(eventIds, deliveryId) {
+        let lastEvent;
+        const failedEvents = [];
+        const reopenedEvents = [];
+        this.buffer = this.buffer.filter((event) => {
+            if (event.deliveryId !== deliveryId || !eventIds.includes(event.event.eventId)) {
+                return true;
+            }
+            if (this.options.maxRedeliveryCount > -1 && event.deliveryCount > this.options.maxRedeliveryCount) {
+                this.incMetricsCounter("failed", event.event.eventType, 1);
+                failedEvents.push(event.event);
+                lastEvent = event.event;
+                return false;
+            }
+            event.status = "open";
+            event.deliveryId = undefined;
+            reopenedEvents.push(event.event);
+            return true;
+        });
+        this.updateMetricsGauges();
+        if (reopenedEvents.length) {
+            this.logger?.info(`Reopened ${reopenedEvents.length} events`);
+            await this.waiterEvents?.();
+        }
+        if (!failedEvents.length) {
+            return;
+        }
+        this.logger?.info(`Failed ${failedEvents.length} events`);
+        void this.options.processor?.failedHandler?.(failedEvents);
+        void this.finallyFailedHandler?.(failedEvents);
+        if (this.buffer.length <= this.options.bufferSize - this.options.bufferThreshold) {
+            this.waiterBufferThreshold?.();
+        }
+        await this.updateState(this.buffer.length ? undefined : lastEvent?.eventId);
+        if (!this.buffer.length) {
+            this.waiterBufferEmpty?.();
+        }
+    }
+    // #endregion
+    // #region Pusher
+    async processLoop() {
+        while (this.running) {
+            try {
+                const events = await this.reserve(this.options.processor?.concurrency ?? 1);
+                await this.options.processor?.handler(events);
+                await this.acknowledge(events.map((event) => event.eventId));
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : "Unknown error";
+                this.logger?.error(`Failed to process events: ${errorMessage}`);
+            }
+        }
+    }
+    // #endregion
+    // #region Metrics
+    updateMetricsGauges() {
+        const stats = new Map();
+        for (const eventType of this.dataSource.eventTypes) {
+            stats.set(eventType, {
+                eventCount: 0,
+                eventReservedCount: 0,
+                eventSizeBytes: 0,
+            });
+        }
+        for (const item of this.buffer) {
+            const stat = stats.get(item.event.eventType);
+            if (!stat) {
+                continue;
+            }
+            stat.eventCount++;
+            if (item.status === "reserved") {
+                stat.eventReservedCount++;
+            }
+            stat.eventSizeBytes += JSON.stringify(item.event.payload).length;
+        }
+        for (const [eventType, stat] of stats) {
+            metrics.bufferEventCountGauge.set({
+                tenant: this.dataSource.tenant,
+                data_core: this.dataSource.dataCore,
+                flow_type: this.dataSource.flowType,
+                event_type: eventType,
+            }, stat.eventCount);
+            metrics.bufferReservedEventCountGauge.set({
+                tenant: this.dataSource.tenant,
+                data_core: this.dataSource.dataCore,
+                flow_type: this.dataSource.flowType,
+                event_type: eventType,
+            }, stat.eventReservedCount);
+            metrics.bufferSizeBytesGauge.set({
+                tenant: this.dataSource.tenant,
+                data_core: this.dataSource.dataCore,
+                flow_type: this.dataSource.flowType,
+                event_type: eventType,
+            }, stat.eventSizeBytes);
+        }
+    }
+    incMetricsCounter(name, eventType, value) {
+        switch (name) {
+            case "acknowledged":
+                metrics.eventsAcknowledgedCounter.inc({
+                    tenant: this.dataSource.tenant,
+                    data_core: this.dataSource.dataCore,
+                    flow_type: this.dataSource.flowType,
+                    event_type: eventType,
+                }, value);
+                break;
+            case "failed":
+                metrics.eventsFailedCounter.inc({
+                    tenant: this.dataSource.tenant,
+                    data_core: this.dataSource.dataCore,
+                    flow_type: this.dataSource.flowType,
+                    event_type: eventType,
+                }, value);
+                break;
+            case "pulled":
+                metrics.eventsPulledSizeBytesCounter.inc({
+                    tenant: this.dataSource.tenant,
+                    data_core: this.dataSource.dataCore,
+                    flow_type: this.dataSource.flowType,
+                    event_type: eventType,
+                }, value);
+                break;
+        }
+    }
+    async waitForEvents() {
+        const promise = new Promise((resolve) => {
+            this.waiterEvents = resolve;
+        });
+        await promise;
+    }
+    async waitForBufferThreshold() {
+        const promise = new Promise((resolve) => {
+            this.waiterBufferThreshold = resolve;
+        });
+        await promise;
+    }
+    async waitForBufferEmpty() {
+        if (!this.buffer.length) {
+            return;
+        }
+        const promise = new Promise((resolve) => {
+            this.waiterBufferEmpty = resolve;
+        });
+        await promise;
+    }
+}