@adonis-agora/flags 0.0.0-beta-20261112141227

package/dist/src/transports/db_transport.js

@@ -0,0 +1,202 @@
+import { createFlagsTables, ensureEventPartitions } from '../schema.js';
+import { dialectOf, insertIgnore, jsonValue, parseJson, query, toNumber, } from '../sql.js';
+const COLUMNS = [
+    'event_id',
+    'schema_version',
+    'app',
+    'environment',
+    'type',
+    'flag',
+    'experiment',
+    'variant',
+    'name',
+    'subject',
+    'subject_type',
+    'value',
+    'props',
+    'ts',
+];
+/**
+ * The event log in your database (`flags_events`), with one cursor per sink in
+ * `flags_sink_cursors`. The only transactional transport: `publish` accepts the caller's Lucid
+ * transaction.
+ *
+ * Leases are `UPDATE … WHERE lease expired` (no transaction held open while a sink sends), and the
+ * cursor only moves while the lease is still ours, so a replica that stalled past its lease cannot
+ * move it back. Delivery is at-least-once; sinks dedupe by event id.
+ *
+ * Gap safety: ids are assigned before commit, so reading strictly by id could skip an event whose
+ * transaction committed late. On Postgres the cursor is `(xid, id)` and the relay reads only rows of
+ * transactions older than the oldest still running (`pg_snapshot_xmin`), which closes the gap
+ * exactly. MySQL uses a time window (`mysqlSafetyMs`); SQLite serializes writers.
+ */
+export class DbTransport {
+    db;
+    options;
+    name = 'db';
+    capabilities = { transactional: true, durable: true };
+    dialect;
+    constructor(db, options = {}) {
+        this.db = db;
+        this.options = options;
+        this.dialect = dialectOf(db);
+    }
+    async setup() {
+        if (this.options.autoCreateSchema !== false)
+            await createFlagsTables(this.db, this.options);
+        else
+            await ensureEventPartitions(this.db, Date.now());
+    }
+    async publish(events, options = {}) {
+        if (events.length === 0)
+            return;
+        const client = options.client ?? this.db;
+        // Chunked: one statement per 500 rows keeps every driver under its bind-parameter limit.
+        for (let i = 0; i < events.length; i += 500) {
+            const chunk = events.slice(i, i + 500);
+            const placeholders = chunk.map(() => `(${COLUMNS.map(() => '?').join(', ')})`).join(', ');
+            const bindings = chunk.flatMap((e) => [
+                e.id,
+                e.schemaVersion,
+                e.app,
+                e.environment,
+                e.type,
+                e.flag ?? null,
+                e.experiment ?? null,
+                e.variant ?? null,
+                e.name ?? null,
+                e.subject,
+                e.subjectType,
+                e.value ?? null,
+                jsonValue(e.props),
+                e.ts,
+            ]);
+            await client.rawQuery(`INSERT INTO flags_events (${COLUMNS.join(', ')}) VALUES ${placeholders}`, bindings);
+        }
+    }
+    async consume(sink, options) {
+        const now = Date.now();
+        await this.db.rawQuery(insertIgnore(this.dialect, 'flags_sink_cursors', ['sink', 'last_id', 'last_tx', 'delivered', 'updated_at'], 1), [sink, 0, 0, 0, now]);
+        await this.db.rawQuery(`UPDATE flags_sink_cursors SET leased_by = ?, lease_until = ?
+        WHERE sink = ? AND (lease_until IS NULL OR lease_until < ? OR leased_by = ?)`, [options.owner, now + options.leaseMs, sink, now, options.owner]);
+        const cursorRows = await query(this.db, 'SELECT leased_by, last_id, last_tx FROM flags_sink_cursors WHERE sink = ?', [
+            sink,
+        ]);
+        const cursor = cursorRows[0];
+        if (!cursor || cursor.leased_by !== options.owner)
+            return null;
+        const lastId = toNumber(cursor.last_id);
+        const lastTx = String(cursor.last_tx ?? 0);
+        const rows = await this.#read(lastTx, lastId, options.batchSize);
+        const events = rows.map(toEvent);
+        const tail = rows.at(-1);
+        const owner = options.owner;
+        let settled = false;
+        const once = async (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            await fn();
+        };
+        return {
+            events,
+            ack: () => once(async () => {
+                if (!tail)
+                    return this.#release(sink, owner);
+                await this.db.rawQuery(`UPDATE flags_sink_cursors
+                SET last_id = ?, last_tx = ?, delivered = delivered + ?, last_error = NULL, updated_at = ?, lease_until = NULL
+              WHERE sink = ? AND leased_by = ?`, [
+                    toNumber(tail.id),
+                    tail.tx_text === undefined ? 0 : String(tail.tx_text),
+                    events.length,
+                    Date.now(),
+                    sink,
+                    owner,
+                ]);
+            }),
+            release: () => once(() => this.#release(sink, owner)),
+            fail: (error) => once(async () => {
+                const message = error instanceof Error ? error.message : String(error);
+                await this.db.rawQuery('UPDATE flags_sink_cursors SET last_error = ?, lease_until = NULL, updated_at = ? WHERE sink = ? AND leased_by = ?', [message.slice(0, 2000), Date.now(), sink, owner]);
+            }),
+        };
+    }
+    async #release(sink, owner) {
+        await this.db.rawQuery('UPDATE flags_sink_cursors SET lease_until = NULL WHERE sink = ? AND leased_by = ?', [sink, owner]);
+    }
+    async #read(lastTx, lastId, limit) {
+        if (this.dialect === 'postgres') {
+            return query(this.db, `SELECT *, tx::text AS tx_text FROM flags_events
+          WHERE (tx, id) > (?::text::xid8, ?)
+            AND tx < pg_snapshot_xmin(pg_current_snapshot())
+          ORDER BY tx, id
+          LIMIT ?`, [lastTx, lastId, limit]);
+        }
+        if (this.dialect === 'mysql') {
+            const horizon = Date.now() - (this.options.mysqlSafetyMs ?? 10_000);
+            return query(this.db, 'SELECT * FROM flags_events WHERE id > ? AND ts < ? ORDER BY id LIMIT ?', [lastId, horizon, limit]);
+        }
+        return query(this.db, 'SELECT * FROM flags_events WHERE id > ? ORDER BY id LIMIT ?', [
+            lastId,
+            limit,
+        ]);
+    }
+    async rewind(sink) {
+        await this.db.rawQuery('UPDATE flags_sink_cursors SET last_id = 0, last_tx = 0, delivered = 0, last_error = NULL, updated_at = ? WHERE sink = ?', [Date.now(), sink]);
+    }
+    async status(sinks) {
+        const cursors = await query(this.db, 'SELECT * FROM flags_sink_cursors');
+        const byName = new Map(cursors.map((row) => [String(row.sink), row]));
+        const maxRows = await query(this.db, 'SELECT MAX(id) AS max FROM flags_events');
+        const maxId = toNumber(maxRows[0]?.max ?? 0);
+        const out = [];
+        for (const sink of sinks) {
+            const row = byName.get(sink);
+            const lastId = toNumber(row?.last_id ?? 0);
+            // Exact lag would be a COUNT over the log; ids are dense enough for an estimate.
+            out.push({
+                sink,
+                lag: Math.max(0, maxId - lastId),
+                delivered: toNumber(row?.delivered ?? 0),
+                leasedBy: row?.leased_by && toNumber(row.lease_until) > Date.now() ? String(row.leased_by) : null,
+                lastError: row?.last_error ? String(row.last_error) : null,
+            });
+        }
+        return out;
+    }
+    async safePruneId(sinks) {
+        if (sinks.length === 0) {
+            const maxRows = await query(this.db, 'SELECT MAX(id) AS max FROM flags_events');
+            return toNumber(maxRows[0]?.max ?? 0);
+        }
+        const placeholders = sinks.map(() => '?').join(', ');
+        const rows = await query(this.db, `SELECT MIN(last_id) AS min, COUNT(*) AS count FROM flags_sink_cursors WHERE sink IN (${placeholders})`, sinks);
+        // A sink that never consumed has no cursor row yet: nothing is safe to prune.
+        if (toNumber(rows[0]?.count ?? 0) < sinks.length)
+            return 0;
+        return toNumber(rows[0]?.min ?? 0);
+    }
+}
+export function toEvent(row) {
+    return {
+        id: String(row.event_id),
+        schemaVersion: toNumber(row.schema_version),
+        app: String(row.app),
+        environment: String(row.environment),
+        type: row.type,
+        ...(row.flag !== null && row.flag !== undefined ? { flag: String(row.flag) } : {}),
+        ...(row.experiment !== null && row.experiment !== undefined
+            ? { experiment: String(row.experiment) }
+            : {}),
+        ...(row.variant !== null && row.variant !== undefined ? { variant: String(row.variant) } : {}),
+        ...(row.name !== null && row.name !== undefined ? { name: String(row.name) } : {}),
+        subject: String(row.subject),
+        subjectType: String(row.subject_type),
+        ...(row.value !== null && row.value !== undefined ? { value: toNumber(row.value) } : {}),
+        ...(row.props !== null && row.props !== undefined
+            ? { props: parseJson(row.props) }
+            : {}),
+        ts: toNumber(row.ts),
+    };
+}
+//# sourceMappingURL=db_transport.js.map

package/dist/src/transports/db_transport.js.map

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

package/dist/src/transports/http_transport.d.ts

@@ -0,0 +1,30 @@
+import type { FlagEvent } from '../events/event.js';
+import type { TokenSource } from '../topology/token.js';
+import type { Transport } from './transport.js';
+export interface HttpTransportOptions {
+    /** The control-plane base URL (`https://flags.example.com/_flags`). */
+    url: string;
+    token: TokenSource;
+    /** The tenant's partition, sent as `x-flags-tenant` (the token decides what it really is). */
+    partition: string;
+    /** Retries per batch on network errors and 5xx. Default 3. */
+    retries?: number;
+    fetch?: typeof fetch;
+}
+/**
+ * A tenant's transport: batches go to the control-plane over HTTP, which writes them into its own
+ * transport and fans them out to the sinks. Nothing is stored locally, so there is no relay on a
+ * tenant — the buffer in front of it retries, and events still unsent when the process dies are lost.
+ */
+export declare class HttpTransport implements Transport {
+    #private;
+    private readonly options;
+    readonly name = "http";
+    readonly capabilities: {
+        transactional: boolean;
+        durable: boolean;
+    };
+    constructor(options: HttpTransportOptions);
+    publish(events: FlagEvent[]): Promise<void>;
+}
+//# sourceMappingURL=http_transport.d.ts.map

package/dist/src/transports/http_transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http_transport.d.ts","sourceRoot":"","sources":["../../../src/transports/http_transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,CAAC;IACnB,8FAA8F;IAC9F,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,aAAc,YAAW,SAAS;;IAKjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,YAAY;QAAK,aAAa;QAAS,OAAO;MAAU;IAGjE,YAA6B,OAAO,EAAE,oBAAoB,EAEzD;IAEK,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgChD;CACF"}

package/dist/src/transports/http_transport.js

@@ -0,0 +1,51 @@
+/**
+ * A tenant's transport: batches go to the control-plane over HTTP, which writes them into its own
+ * transport and fans them out to the sinks. Nothing is stored locally, so there is no relay on a
+ * tenant — the buffer in front of it retries, and events still unsent when the process dies are lost.
+ */
+export class HttpTransport {
+    options;
+    name = 'http';
+    capabilities = { transactional: false, durable: false };
+    #fetch;
+    constructor(options) {
+        this.options = options;
+        this.#fetch = options.fetch ?? fetch;
+    }
+    async publish(events) {
+        if (events.length === 0)
+            return;
+        const retries = this.options.retries ?? 3;
+        let lastError;
+        for (let attempt = 0; attempt <= retries; attempt++) {
+            try {
+                const response = await this.#fetch(`${this.options.url.replace(/\/$/, '')}/v1/events`, {
+                    method: 'POST',
+                    headers: {
+                        'content-type': 'application/json',
+                        authorization: `Bearer ${await this.options.token.get()}`,
+                        'x-flags-tenant': this.options.partition,
+                    },
+                    body: JSON.stringify({ events }),
+                });
+                if (response.ok)
+                    return;
+                if (response.status === 401)
+                    this.options.token.invalidate?.();
+                // 4xx other than 401/429 will not succeed on retry.
+                if (response.status < 500 && response.status !== 429 && response.status !== 401) {
+                    throw new Error(`control-plane rejected events: ${response.status} ${await response.text()}`);
+                }
+                lastError = new Error(`control-plane answered ${response.status}`);
+            }
+            catch (error) {
+                lastError = error;
+                if (error instanceof Error && error.message.startsWith('control-plane rejected'))
+                    throw error;
+            }
+            await new Promise((resolve) => setTimeout(resolve, 200 * 2 ** attempt));
+        }
+        throw lastError;
+    }
+}
+//# sourceMappingURL=http_transport.js.map

package/dist/src/transports/http_transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http_transport.js","sourceRoot":"","sources":["../../../src/transports/http_transport.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,MAAM,OAAO,aAAa;IAKK,OAAO;IAJ3B,IAAI,GAAG,MAAM,CAAC;IACd,YAAY,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACxD,MAAM,CAAe;IAE9B,YAA6B,OAA6B;uBAA7B,OAAO;QAClC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAmB;QAC/B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;QAC1C,IAAI,SAAkB,CAAC;QACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;YACpD,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,EAAE;oBACrF,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,cAAc,EAAE,kBAAkB;wBAClC,aAAa,EAAE,UAAU,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE;wBACzD,gBAAgB,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;qBACzC;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;iBACjC,CAAC,CAAC;gBACH,IAAI,QAAQ,CAAC,EAAE;oBAAE,OAAO;gBACxB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;oBAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC;gBAC/D,oDAAoD;gBACpD,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAChF,MAAM,IAAI,KAAK,CACb,kCAAkC,QAAQ,CAAC,MAAM,IAAI,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CAC7E,CAAC;gBACJ,CAAC;gBACD,SAAS,GAAG,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACrE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,CAAC;gBAClB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC;oBAC9E,MAAM,KAAK,CAAC;YAChB,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,SAAS,CAAC;IAClB,CAAC;CACF"}

package/dist/src/transports/memory_transport.d.ts

@@ -0,0 +1,29 @@
+import type { FlagEvent } from '../events/event.js';
+import type { Delivery, SinkStatus, Transport } from './transport.js';
+/**
+ * An in-process log. For tests and local development: nothing survives a restart, and replicas do
+ * not share it. Cursors and leases behave like the `db` transport's so code exercised against it
+ * behaves the same in production.
+ */
+export declare class MemoryTransport implements Transport {
+    #private;
+    readonly name = "memory";
+    readonly capabilities: {
+        transactional: boolean;
+        durable: boolean;
+    };
+    readonly log: Array<{
+        id: number;
+        event: FlagEvent;
+    }>;
+    publish(events: FlagEvent[]): Promise<void>;
+    consume(sink: string, options: {
+        batchSize: number;
+        leaseMs: number;
+        owner: string;
+    }): Promise<Delivery | null>;
+    rewind(sink: string): Promise<void>;
+    status(sinks: string[]): Promise<SinkStatus[]>;
+    safePruneId(sinks: string[]): Promise<number>;
+}
+//# sourceMappingURL=memory_transport.d.ts.map

package/dist/src/transports/memory_transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory_transport.d.ts","sourceRoot":"","sources":["../../../src/transports/memory_transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEtE;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,SAAS;;IAC/C,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,YAAY;QAAK,aAAa;QAAS,OAAO;MAAU;IACjE,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAAC,CAAM;IAarD,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhD;IAWK,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAC7D,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAqC1B;IAEK,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxC;IAEK,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAYnD;IAEK,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAGlD;CACF"}

package/dist/src/transports/memory_transport.js

@@ -0,0 +1,91 @@
+/**
+ * An in-process log. For tests and local development: nothing survives a restart, and replicas do
+ * not share it. Cursors and leases behave like the `db` transport's so code exercised against it
+ * behaves the same in production.
+ */
+export class MemoryTransport {
+    name = 'memory';
+    capabilities = { transactional: false, durable: false };
+    log = [];
+    #nextId = 1;
+    #cursors = new Map();
+    async publish(events) {
+        for (const event of events)
+            this.log.push({ id: this.#nextId++, event: structuredClone(event) });
+    }
+    #cursor(sink) {
+        let cursor = this.#cursors.get(sink);
+        if (!cursor) {
+            cursor = { lastId: 0, delivered: 0, leasedBy: null, leaseUntil: 0, lastError: null };
+            this.#cursors.set(sink, cursor);
+        }
+        return cursor;
+    }
+    async consume(sink, options) {
+        const cursor = this.#cursor(sink);
+        const now = Date.now();
+        if (cursor.leasedBy && cursor.leasedBy !== options.owner && cursor.leaseUntil > now)
+            return null;
+        cursor.leasedBy = options.owner;
+        cursor.leaseUntil = now + options.leaseMs;
+        const batch = this.log.filter((entry) => entry.id > cursor.lastId).slice(0, options.batchSize);
+        let settled = false;
+        const release = () => {
+            if (cursor.leasedBy === options.owner)
+                cursor.leaseUntil = 0;
+        };
+        return {
+            events: batch.map((entry) => structuredClone(entry.event)),
+            ack: async () => {
+                if (settled)
+                    return;
+                settled = true;
+                if (cursor.leasedBy !== options.owner)
+                    return;
+                if (batch.length > 0) {
+                    cursor.lastId = batch.at(-1).id;
+                    cursor.delivered += batch.length;
+                }
+                cursor.lastError = null;
+                release();
+            },
+            release: async () => {
+                if (settled)
+                    return;
+                settled = true;
+                release();
+            },
+            fail: async (error) => {
+                if (settled)
+                    return;
+                settled = true;
+                cursor.lastError = error instanceof Error ? error.message : String(error);
+                release();
+            },
+        };
+    }
+    async rewind(sink) {
+        const cursor = this.#cursor(sink);
+        cursor.lastId = 0;
+        cursor.delivered = 0;
+    }
+    async status(sinks) {
+        const maxId = this.log.at(-1)?.id ?? 0;
+        return sinks.map((sink) => {
+            const cursor = this.#cursor(sink);
+            return {
+                sink,
+                lag: Math.max(0, maxId - cursor.lastId),
+                delivered: cursor.delivered,
+                leasedBy: cursor.leaseUntil > Date.now() ? cursor.leasedBy : null,
+                lastError: cursor.lastError,
+            };
+        });
+    }
+    async safePruneId(sinks) {
+        if (sinks.length === 0)
+            return this.log.at(-1)?.id ?? 0;
+        return Math.min(...sinks.map((sink) => this.#cursor(sink).lastId));
+    }
+}
+//# sourceMappingURL=memory_transport.js.map

package/dist/src/transports/memory_transport.js.map

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

package/dist/src/transports/redis_transport.d.ts

@@ -0,0 +1,50 @@
+import type { FlagEvent } from '../events/event.js';
+import type { Delivery, SinkStatus, Transport } from './transport.js';
+/** The ioredis commands this transport uses (what `@adonisjs/redis` connections expose). */
+export interface RedisStreamClient {
+    xadd(...args: Array<string | number>): Promise<unknown>;
+    xgroup(...args: Array<string | number>): Promise<unknown>;
+    xreadgroup(...args: Array<string | number>): Promise<unknown>;
+    xautoclaim(...args: Array<string | number>): Promise<unknown>;
+    xack(...args: Array<string | number>): Promise<unknown>;
+    xinfo(...args: Array<string | number>): Promise<unknown>;
+    xpending(...args: Array<string | number>): Promise<unknown>;
+    pipeline?(): {
+        xadd(...args: Array<string | number>): unknown;
+        exec(): Promise<unknown>;
+    };
+}
+export interface RedisTransportOptions {
+    /** Stream key. Default `agora:flags:events`. */
+    stream?: string;
+    /**
+     * Approximate cap on the stream length (`XADD MAXLEN ~`). Entries beyond it are trimmed even if a
+     * sink has not read them, so size it for the longest outage you want to absorb. Default 1,000,000.
+     */
+    maxLength?: number;
+}
+/**
+ * Redis Streams: one consumer group per sink, so each sink reads at its own pace and a message is
+ * delivered to one consumer of the group. A consumer that dies mid-batch leaves its messages
+ * pending; they are reclaimed (`XAUTOCLAIM`) once idle for longer than the lease. Durability is
+ * whatever the Redis server's persistence (AOF) gives; it is never transactional with the database.
+ */
+export declare class RedisTransport implements Transport {
+    #private;
+    private readonly redis;
+    readonly name = "redis";
+    readonly capabilities: {
+        transactional: boolean;
+        durable: boolean;
+    };
+    readonly stream: string;
+    constructor(redis: RedisStreamClient, options?: RedisTransportOptions);
+    publish(events: FlagEvent[]): Promise<void>;
+    consume(sink: string, options: {
+        batchSize: number;
+        leaseMs: number;
+        owner: string;
+    }): Promise<Delivery | null>;
+    status(sinks: string[]): Promise<SinkStatus[]>;
+}
+//# sourceMappingURL=redis_transport.d.ts.map

package/dist/src/transports/redis_transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis_transport.d.ts","sourceRoot":"","sources":["../../../src/transports/redis_transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEtE,4FAA4F;AAC5F,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1D,UAAU,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,UAAU,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,KAAK,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,QAAQ,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,QAAQ,CAAC,IAAI;QAAE,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC;QAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;CAC3F;AAED,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,SAAS;;IAQ5C,OAAO,CAAC,QAAQ,CAAC,KAAK;IAPxB,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,YAAY;QAAK,aAAa;QAAS,OAAO;MAAS;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAIxB,YACmB,KAAK,EAAE,iBAAiB,EACzC,OAAO,GAAE,qBAA0B,EAIpC;IAEK,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAahD;IAaK,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAC7D,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAgD1B;IAEK,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAwBnD;CACF"}

package/dist/src/transports/redis_transport.js

@@ -0,0 +1,107 @@
+/**
+ * Redis Streams: one consumer group per sink, so each sink reads at its own pace and a message is
+ * delivered to one consumer of the group. A consumer that dies mid-batch leaves its messages
+ * pending; they are reclaimed (`XAUTOCLAIM`) once idle for longer than the lease. Durability is
+ * whatever the Redis server's persistence (AOF) gives; it is never transactional with the database.
+ */
+export class RedisTransport {
+    redis;
+    name = 'redis';
+    capabilities = { transactional: false, durable: true };
+    stream;
+    #maxLength;
+    #groups = new Set();
+    constructor(redis, options = {}) {
+        this.redis = redis;
+        this.stream = options.stream ?? 'agora:flags:events';
+        this.#maxLength = options.maxLength ?? 1_000_000;
+    }
+    async publish(events) {
+        if (events.length === 0)
+            return;
+        const pipeline = this.redis.pipeline?.();
+        for (const event of events) {
+            const args = [this.stream, 'MAXLEN', '~', this.#maxLength, '*', 'e', JSON.stringify(event)];
+            if (pipeline)
+                pipeline.xadd(...args);
+            else
+                await this.redis.xadd(...args);
+        }
+        if (pipeline) {
+            const results = (await pipeline.exec());
+            const failed = results?.find(([error]) => error);
+            if (failed)
+                throw failed[0];
+        }
+    }
+    async #ensureGroup(sink) {
+        if (this.#groups.has(sink))
+            return;
+        try {
+            // `0`: a new sink starts from the oldest retained entry (backfill), like a db cursor at 0.
+            await this.redis.xgroup('CREATE', this.stream, sink, '0', 'MKSTREAM');
+        }
+        catch (error) {
+            if (!/BUSYGROUP/.test(String(error.message)))
+                throw error;
+        }
+        this.#groups.add(sink);
+    }
+    async consume(sink, options) {
+        await this.#ensureGroup(sink);
+        // Reclaim entries another consumer leased and abandoned, then read new ones.
+        const claimed = (await this.redis.xautoclaim(this.stream, sink, options.owner, options.leaseMs, '0-0', 'COUNT', options.batchSize));
+        let entries = (claimed?.[1] ?? []).filter((entry) => Array.isArray(entry));
+        if (entries.length < options.batchSize) {
+            const read = (await this.redis.xreadgroup('GROUP', sink, options.owner, 'COUNT', options.batchSize - entries.length, 'STREAMS', this.stream, '>'));
+            entries = entries.concat(read?.[0]?.[1] ?? []);
+        }
+        const ids = entries.map(([id]) => id);
+        const events = entries.map(([, fields]) => JSON.parse(fields[fields.indexOf('e') + 1]));
+        let settled = false;
+        const settle = async (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            await fn();
+        };
+        return {
+            events,
+            ack: () => settle(async () => {
+                if (ids.length > 0)
+                    await this.redis.xack(this.stream, sink, ...ids);
+            }),
+            // Unacked entries stay pending and are reclaimed after the lease; nothing to undo.
+            release: () => settle(async () => { }),
+            fail: () => settle(async () => { }),
+        };
+    }
+    async status(sinks) {
+        const out = [];
+        let groups = [];
+        try {
+            const raw = (await this.redis.xinfo('GROUPS', this.stream));
+            groups = raw.map((pairs) => {
+                const record = {};
+                for (let i = 0; i < pairs.length; i += 2)
+                    record[String(pairs[i])] = pairs[i + 1];
+                return record;
+            });
+        }
+        catch {
+            // No stream yet.
+        }
+        for (const sink of sinks) {
+            const group = groups.find((g) => g.name === sink);
+            out.push({
+                sink,
+                lag: Number(group?.lag ?? 0) + Number(group?.pending ?? 0),
+                delivered: Number(group?.['entries-read'] ?? 0),
+                leasedBy: null,
+                lastError: null,
+            });
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=redis_transport.js.map

package/dist/src/transports/redis_transport.js.map

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