@adonis-agora/flags 0.0.0-beta-20261112141227

package/dist/src/sinks/parquet_sink.d.ts

@@ -0,0 +1,41 @@
+import { type DuckDbOptions } from '../analytics/duckdb.js';
+import type { FlagEvent } from '../events/event.js';
+import type { Sink } from './sink.js';
+export interface ParquetSinkOptions extends DuckDbOptions {
+    /**
+     * Where the files go: a local directory (`storage/flags`) or an object-store prefix DuckDB can
+     * write (`s3://bucket/flags`, with credentials in `duckdb.setup`). Files are laid out as
+     * `type=…/day=YYYY-MM-DD/<uuid>.parquet`.
+     */
+    path: string;
+    /**
+     * Events per file. Parquet wants big files: the default 50,000 keeps file counts sane. The relay
+     * hands this sink batches of this size.
+     */
+    batchSize?: number;
+    /** Delivery interval (ms). Default 60000 — let batches fill. */
+    intervalMs?: number;
+}
+/**
+ * Writes events as Parquet through DuckDB. Cheap, long retention with no server: the `duckdb`
+ * analytics backend reads the same files. `@duckdb/node-api` is an optional peer with a native
+ * binary; run the relay for this sink in a worker, not in web processes.
+ *
+ * Erasure rewrites the affected local files without the subject's rows (`forget`). For object
+ * stores, rewrite them with your own tooling.
+ */
+export declare class ParquetSink implements Sink {
+    #private;
+    private readonly options;
+    readonly kind = "parquet";
+    constructor(options: ParquetSinkOptions);
+    get batchSize(): number;
+    get intervalMs(): number;
+    setup(): Promise<void>;
+    write(events: FlagEvent[]): Promise<void>;
+    forget(subject: string): Promise<void>;
+    close(): Promise<void>;
+}
+/** A SQL literal for DuckDB. */
+export declare function literal(value: unknown): string;
+//# sourceMappingURL=parquet_sink.d.ts.map

package/dist/src/sinks/parquet_sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parquet_sink.d.ts","sourceRoot":"","sources":["../../../src/sinks/parquet_sink.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,qBAAa,WAAY,YAAW,IAAI;;IAI1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,aAAa;IAG1B,YAA6B,OAAO,EAAE,kBAAkB,EAEvD;IAED,IAAI,SAAS,WAEZ;IAED,IAAI,UAAU,WAEb;IAMK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAEK,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0D9C;IAEK,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB3C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACF;AAkBD,gCAAgC;AAChC,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM9C"}

package/dist/src/sinks/parquet_sink.js

@@ -0,0 +1,140 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readdir, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { DuckDb } from '../analytics/duckdb.js';
+/**
+ * Writes events as Parquet through DuckDB. Cheap, long retention with no server: the `duckdb`
+ * analytics backend reads the same files. `@duckdb/node-api` is an optional peer with a native
+ * binary; run the relay for this sink in a worker, not in web processes.
+ *
+ * Erasure rewrites the affected local files without the subject's rows (`forget`). For object
+ * stores, rewrite them with your own tooling.
+ */
+export class ParquetSink {
+    options;
+    kind = 'parquet';
+    #duck;
+    constructor(options) {
+        this.options = options;
+        this.#duck = new DuckDb(options);
+    }
+    get batchSize() {
+        return this.options.batchSize ?? 50_000;
+    }
+    get intervalMs() {
+        return this.options.intervalMs ?? 60_000;
+    }
+    get #local() {
+        return !/^[a-z0-9]+:\/\//i.test(this.options.path);
+    }
+    async setup() {
+        if (this.#local)
+            await mkdir(this.options.path, { recursive: true });
+    }
+    async write(events) {
+        if (events.length === 0)
+            return;
+        const rows = events.map((e) => ({
+            event_id: e.id,
+            schema_version: e.schemaVersion,
+            app: e.app,
+            environment: e.environment,
+            type: e.type,
+            flag: e.flag ?? null,
+            experiment: e.experiment ?? null,
+            variant: e.variant ?? null,
+            name: e.name ?? null,
+            subject: e.subject,
+            subject_type: e.subjectType,
+            value: e.value ?? null,
+            props: JSON.stringify(e.props ?? {}),
+            ts: e.ts,
+            day: new Date(e.ts).toISOString().slice(0, 10),
+        }));
+        const staging = `staging_${randomUUID().replaceAll('-', '')}`;
+        await this.#duck.withConnection(async (sql) => {
+            await sql(`CREATE TEMP TABLE ${staging} (
+        event_id VARCHAR, schema_version INTEGER, app VARCHAR, environment VARCHAR, type VARCHAR, flag VARCHAR,
+        experiment VARCHAR, variant VARCHAR, name VARCHAR, subject VARCHAR, subject_type VARCHAR,
+        value DOUBLE, props VARCHAR, ts BIGINT, day VARCHAR)`);
+            for (let i = 0; i < rows.length; i += 1000) {
+                const chunk = rows.slice(i, i + 1000);
+                const values = chunk
+                    .map((r) => `(${[
+                    r.event_id,
+                    r.schema_version,
+                    r.app,
+                    r.environment,
+                    r.type,
+                    r.flag,
+                    r.experiment,
+                    r.variant,
+                    r.name,
+                    r.subject,
+                    r.subject_type,
+                    r.value,
+                    r.props,
+                    r.ts,
+                    r.day,
+                ]
+                    .map(literal)
+                    .join(', ')})`)
+                    .join(', ');
+                await sql(`INSERT INTO ${staging} VALUES ${values}`);
+            }
+            await sql(`COPY ${staging} TO ${literal(this.options.path)} (FORMAT PARQUET, PARTITION_BY (type, day), FILENAME_PATTERN 'part_{uuid}', APPEND)`);
+            await sql(`DROP TABLE ${staging}`);
+        });
+    }
+    async forget(subject) {
+        if (!this.#local) {
+            throw new Error('ParquetSink.forget only rewrites local files; rewrite object-store files with your own tooling');
+        }
+        for (const file of await listParquet(this.options.path)) {
+            await this.#duck.withConnection(async (sql, select) => {
+                const matches = await select(`SELECT COUNT(*) AS n FROM read_parquet(${literal(file)}) WHERE subject = ${literal(subject)}`);
+                if (Number(matches[0]?.n ?? 0) === 0)
+                    return;
+                const rewritten = `${file}.rewrite`;
+                await sql(`COPY (SELECT * FROM read_parquet(${literal(file)}) WHERE subject <> ${literal(subject)}) TO ${literal(rewritten)} (FORMAT PARQUET)`);
+                await rm(file);
+                const { rename } = await import('node:fs/promises');
+                await rename(rewritten, file);
+            });
+        }
+    }
+    async close() {
+        await this.#duck.close();
+    }
+}
+async function listParquet(dir) {
+    const out = [];
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const entry of entries) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory())
+            out.push(...(await listParquet(full)));
+        else if (entry.name.endsWith('.parquet'))
+            out.push(full);
+    }
+    return out;
+}
+/** A SQL literal for DuckDB. */
+export function literal(value) {
+    if (value === null || value === undefined)
+        return 'NULL';
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? String(value) : 'NULL';
+    if (typeof value === 'bigint')
+        return value.toString();
+    if (typeof value === 'boolean')
+        return value ? 'TRUE' : 'FALSE';
+    return `'${String(value).replaceAll("'", "''")}'`;
+}
+//# sourceMappingURL=parquet_sink.js.map

package/dist/src/sinks/parquet_sink.js.map

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

package/dist/src/sinks/posthog_sink.d.ts

@@ -0,0 +1,29 @@
+import type { FlagEvent } from '../events/event.js';
+import type { Sink } from './sink.js';
+export interface PostHogSinkOptions {
+    /** Project API key (the public `phc_…` key). */
+    apiKey: string;
+    /** Default `https://us.i.posthog.com`. */
+    host?: string;
+    batchSize?: number;
+    intervalMs?: number;
+    fetch?: typeof fetch;
+}
+/**
+ * Sends exposures as PostHog's `$feature_flag_called` events (so PostHog's experiment tooling
+ * recognises them) and tracks as regular events, through the `/batch/` endpoint. Every event
+ * carries its id as `uuid`, which PostHog uses to dedupe re-sends.
+ *
+ * Erasure (`forget`) is not implemented here: deleting a person in PostHog goes through its
+ * private API with a personal key. Do it there.
+ */
+export declare class PostHogSink implements Sink {
+    #private;
+    private readonly options;
+    readonly kind = "posthog";
+    constructor(options: PostHogSinkOptions);
+    get batchSize(): number;
+    get intervalMs(): number | undefined;
+    write(events: FlagEvent[]): Promise<void>;
+}
+//# sourceMappingURL=posthog_sink.d.ts.map

package/dist/src/sinks/posthog_sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog_sink.d.ts","sourceRoot":"","sources":["../../../src/sinks/posthog_sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,qBAAa,WAAY,YAAW,IAAI;;IAI1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,aAAa;IAG1B,YAA6B,OAAO,EAAE,kBAAkB,EAEvD;IAED,IAAI,SAAS,WAEZ;IAED,IAAI,UAAU,uBAEb;IAEK,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyC9C;CACF"}

package/dist/src/sinks/posthog_sink.js

@@ -0,0 +1,65 @@
+/**
+ * Sends exposures as PostHog's `$feature_flag_called` events (so PostHog's experiment tooling
+ * recognises them) and tracks as regular events, through the `/batch/` endpoint. Every event
+ * carries its id as `uuid`, which PostHog uses to dedupe re-sends.
+ *
+ * Erasure (`forget`) is not implemented here: deleting a person in PostHog goes through its
+ * private API with a personal key. Do it there.
+ */
+export class PostHogSink {
+    options;
+    kind = 'posthog';
+    #fetch;
+    constructor(options) {
+        this.options = options;
+        this.#fetch = options.fetch ?? fetch;
+    }
+    get batchSize() {
+        return this.options.batchSize ?? 500;
+    }
+    get intervalMs() {
+        return this.options.intervalMs;
+    }
+    async write(events) {
+        if (events.length === 0)
+            return;
+        const batch = events.map((e) => e.type === 'exposure'
+            ? {
+                event: '$feature_flag_called',
+                distinct_id: e.subject,
+                uuid: e.id,
+                timestamp: new Date(e.ts).toISOString(),
+                properties: {
+                    $feature_flag: e.flag ?? e.experiment,
+                    $feature_flag_response: e.variant,
+                    experiment: e.experiment,
+                    app: e.app,
+                    environment: e.environment,
+                    subject_type: e.subjectType,
+                    ...e.props,
+                },
+            }
+            : {
+                event: e.name,
+                distinct_id: e.subject,
+                uuid: e.id,
+                timestamp: new Date(e.ts).toISOString(),
+                properties: {
+                    ...(e.value !== undefined ? { value: e.value } : {}),
+                    app: e.app,
+                    environment: e.environment,
+                    subject_type: e.subjectType,
+                    ...e.props,
+                },
+            });
+        const host = (this.options.host ?? 'https://us.i.posthog.com').replace(/\/$/, '');
+        const response = await this.#fetch(`${host}/batch/`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ api_key: this.options.apiKey, historical_migration: false, batch }),
+        });
+        if (!response.ok)
+            throw new Error(`PostHog answered ${response.status}: ${await response.text()}`);
+    }
+}
+//# sourceMappingURL=posthog_sink.js.map

package/dist/src/sinks/posthog_sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog_sink.js","sourceRoot":"","sources":["../../../src/sinks/posthog_sink.ts"],"names":[],"mappings":"AAaA;;;;;;;GAOG;AACH,MAAM,OAAO,WAAW;IAIO,OAAO;IAH3B,IAAI,GAAG,SAAS,CAAC;IACjB,MAAM,CAAe;IAE9B,YAA6B,OAA2B;uBAA3B,OAAO;QAClC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IACvC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC;IACvC,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAmB;QAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC7B,CAAC,CAAC,IAAI,KAAK,UAAU;YACnB,CAAC,CAAC;gBACE,KAAK,EAAE,sBAAsB;gBAC7B,WAAW,EAAE,CAAC,CAAC,OAAO;gBACtB,IAAI,EAAE,CAAC,CAAC,EAAE;gBACV,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE;gBACvC,UAAU,EAAE;oBACV,aAAa,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,UAAU;oBACrC,sBAAsB,EAAE,CAAC,CAAC,OAAO;oBACjC,UAAU,EAAE,CAAC,CAAC,UAAU;oBACxB,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,YAAY,EAAE,CAAC,CAAC,WAAW;oBAC3B,GAAG,CAAC,CAAC,KAAK;iBACX;aACF;YACH,CAAC,CAAC;gBACE,KAAK,EAAE,CAAC,CAAC,IAAI;gBACb,WAAW,EAAE,CAAC,CAAC,OAAO;gBACtB,IAAI,EAAE,CAAC,CAAC,EAAE;gBACV,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE;gBACvC,UAAU,EAAE;oBACV,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpD,GAAG,EAAE,CAAC,CAAC,GAAG;oBACV,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,YAAY,EAAE,CAAC,CAAC,WAAW;oBAC3B,GAAG,CAAC,CAAC,KAAK;iBACX;aACF,CACN,CAAC;QACF,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,0BAA0B,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAClF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,SAAS,EAAE;YACnD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;SAC3F,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE;YACd,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,CAAC,MAAM,KAAK,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACrF,CAAC;CACF"}

package/dist/src/sinks/sink.d.ts

@@ -0,0 +1,36 @@
+import type { FlagEvent } from '../events/event.js';
+/**
+ * A destination for events. The relay hands each sink batches from its own cursor; a sink must be
+ * idempotent by `event.id`, because delivery is at-least-once.
+ */
+export interface Sink {
+    /** Kind, for logs (`lucid`, `posthog`, …). The sink's name is its key in the config. */
+    readonly kind: string;
+    /** Per-sink batch size. Default: the relay's. */
+    readonly batchSize?: number | undefined;
+    /** Per-sink delivery interval in ms. Default: the relay's. */
+    readonly intervalMs?: number | undefined;
+    setup?(): Promise<void>;
+    write(events: FlagEvent[]): Promise<void>;
+    /** Deletes everything stored about a subject (right to erasure). */
+    forget?(subject: string): Promise<void>;
+    close?(): Promise<void>;
+}
+/** Keeps events in memory. For tests. */
+export declare class MemorySink implements Sink {
+    #private;
+    readonly kind = "memory";
+    readonly events: FlagEvent[];
+    write(events: FlagEvent[]): Promise<void>;
+    forget(subject: string): Promise<void>;
+}
+/** Hands batches to your function (a queue, a webhook, another warehouse). */
+export declare class CallbackSink implements Sink {
+    private readonly callback;
+    readonly batchSize?: number | undefined;
+    readonly intervalMs?: number | undefined;
+    readonly kind = "callback";
+    constructor(callback: (events: FlagEvent[]) => Promise<void>, batchSize?: number | undefined, intervalMs?: number | undefined);
+    write(events: FlagEvent[]): Promise<void>;
+}
+//# sourceMappingURL=sink.d.ts.map

package/dist/src/sinks/sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../../../src/sinks/sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,oEAAoE;IACpE,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,yCAAyC;AACzC,qBAAa,UAAW,YAAW,IAAI;;IACrC,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAM;IAG5B,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9C;IAEK,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3C;CACF;AAED,8EAA8E;AAC9E,qBAAa,YAAa,YAAW,IAAI;IAGrC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM;IAJ9B,QAAQ,CAAC,IAAI,cAAc;IAC3B,YACmB,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,EACxD,SAAS,CAAC,EAAE,MAAM,YAAA,EAClB,UAAU,CAAC,EAAE,MAAM,YAAA,EAC1B;IAEJ,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAExC;CACF"}

package/dist/src/sinks/sink.js

@@ -0,0 +1,36 @@
+/** Keeps events in memory. For tests. */
+export class MemorySink {
+    kind = 'memory';
+    events = [];
+    #seen = new Set();
+    async write(events) {
+        for (const event of events) {
+            if (this.#seen.has(event.id))
+                continue;
+            this.#seen.add(event.id);
+            this.events.push(event);
+        }
+    }
+    async forget(subject) {
+        for (let i = this.events.length - 1; i >= 0; i--) {
+            if (this.events[i].subject === subject)
+                this.events.splice(i, 1);
+        }
+    }
+}
+/** Hands batches to your function (a queue, a webhook, another warehouse). */
+export class CallbackSink {
+    callback;
+    batchSize;
+    intervalMs;
+    kind = 'callback';
+    constructor(callback, batchSize, intervalMs) {
+        this.callback = callback;
+        this.batchSize = batchSize;
+        this.intervalMs = intervalMs;
+    }
+    write(events) {
+        return this.callback(events);
+    }
+}
+//# sourceMappingURL=sink.js.map

package/dist/src/sinks/sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.js","sourceRoot":"","sources":["../../../src/sinks/sink.ts"],"names":[],"mappings":"AAoBA,yCAAyC;AACzC,MAAM,OAAO,UAAU;IACZ,IAAI,GAAG,QAAQ,CAAC;IAChB,MAAM,GAAgB,EAAE,CAAC;IACzB,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEnC,KAAK,CAAC,KAAK,CAAC,MAAmB;QAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAAE,SAAS;YACvC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe;QAC1B,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,OAAO,KAAK,OAAO;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;CACF;AAED,8EAA8E;AAC9E,MAAM,OAAO,YAAY;IAGJ,QAAQ;IAChB,SAAS;IACT,UAAU;IAJZ,IAAI,GAAG,UAAU,CAAC;IAC3B,YACmB,QAAgD,EACxD,SAAkB,EAClB,UAAmB;wBAFX,QAAQ;yBAChB,SAAS;0BACT,UAAU;IAClB,CAAC;IAEJ,KAAK,CAAC,MAAmB;QACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/src/sql.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The slice of Lucid this package needs: raw SQL and transactions. Typed structurally so the
+ * package does not import `@adonisjs/lucid` at module load (it is an optional peer), and so a
+ * `Database`, a `QueryClient` or a `TransactionClient` all fit.
+ */
+export interface SqlClient {
+    rawQuery(sql: string, bindings?: readonly unknown[]): PromiseLike<unknown>;
+    dialect?: {
+        name?: string;
+    };
+}
+export interface SqlDatabase extends SqlClient {
+    transaction<T>(callback: (trx: SqlClient) => Promise<T>): Promise<T>;
+}
+export type Dialect = 'postgres' | 'mysql' | 'sqlite';
+export declare function dialectOf(client: SqlClient): Dialect;
+/** Normalizes `rawQuery` results across drivers into an array of row objects. */
+export declare function rowsOf<T = Record<string, unknown>>(result: unknown): T[];
+export declare function query<T = Record<string, unknown>>(client: SqlClient, sql: string, bindings?: readonly unknown[]): Promise<T[]>;
+/** JSON column values come back parsed on Postgres/MySQL and as text on SQLite. */
+export declare function parseJson<T>(value: unknown): T;
+/** Bindings for JSON columns: always a string, which every driver accepts. */
+export declare function jsonValue(value: unknown): string | null;
+/** Numbers come back as strings for BIGINT on pg/mysql. */
+export declare function toNumber(value: unknown): number;
+/**
+ * Every timestamp this package stores is a BIGINT of epoch milliseconds: no time zone handling,
+ * identical in every dialect and in the analytics backends.
+ */
+export declare function toDate(value: unknown): Date;
+/** `INSERT … ON CONFLICT DO NOTHING` in each dialect. */
+export declare function insertIgnore(dialect: Dialect, table: string, columns: string[], rows: number): string;
+//# sourceMappingURL=sql.d.ts.map

package/dist/src/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/sql.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3E,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B;AAED,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACtE;AAED,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtD,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAMpD;AAED,iFAAiF;AACjF,wBAAgB,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,EAAE,CAYxE;AAED,wBAAsB,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrD,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,SAAS,OAAO,EAAO,GAChC,OAAO,CAAC,CAAC,EAAE,CAAC,CAEd;AAED,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAG9C;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEvD;AAED,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAK/C;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAG3C;AAED,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,UAM5F"}

package/dist/src/sql.js

@@ -0,0 +1,66 @@
+export function dialectOf(client) {
+    const name = client.dialect?.name ?? '';
+    if (/postgres|pg|redshift/i.test(name))
+        return 'postgres';
+    if (/mysql|mariadb/i.test(name))
+        return 'mysql';
+    if (/sqlite/i.test(name))
+        return 'sqlite';
+    throw new Error(`@adonis-agora/flags: unsupported database dialect "${name}"`);
+}
+/** Normalizes `rawQuery` results across drivers into an array of row objects. */
+export function rowsOf(result) {
+    if (Array.isArray(result)) {
+        // mysql2: [rows, fields]; better-sqlite3 through knex: rows.
+        if (result.length === 2 && Array.isArray(result[0]) && Array.isArray(result[1])) {
+            return result[0];
+        }
+        return result;
+    }
+    if (result && typeof result === 'object' && 'rows' in result) {
+        return result.rows;
+    }
+    return [];
+}
+export async function query(client, sql, bindings = []) {
+    return rowsOf(await client.rawQuery(sql, bindings));
+}
+/** JSON column values come back parsed on Postgres/MySQL and as text on SQLite. */
+export function parseJson(value) {
+    if (typeof value === 'string')
+        return JSON.parse(value);
+    return value;
+}
+/** Bindings for JSON columns: always a string, which every driver accepts. */
+export function jsonValue(value) {
+    return value === undefined || value === null ? null : JSON.stringify(value);
+}
+/** Numbers come back as strings for BIGINT on pg/mysql. */
+export function toNumber(value) {
+    if (typeof value === 'number')
+        return value;
+    if (typeof value === 'bigint')
+        return Number(value);
+    if (typeof value === 'string')
+        return Number(value);
+    return 0;
+}
+/**
+ * Every timestamp this package stores is a BIGINT of epoch milliseconds: no time zone handling,
+ * identical in every dialect and in the analytics backends.
+ */
+export function toDate(value) {
+    if (value instanceof Date)
+        return value;
+    return new Date(toNumber(value));
+}
+/** `INSERT … ON CONFLICT DO NOTHING` in each dialect. */
+export function insertIgnore(dialect, table, columns, rows) {
+    const placeholders = `(${columns.map(() => '?').join(', ')})`;
+    const values = Array.from({ length: rows }, () => placeholders).join(', ');
+    const cols = columns.join(', ');
+    if (dialect === 'mysql')
+        return `INSERT IGNORE INTO ${table} (${cols}) VALUES ${values}`;
+    return `INSERT INTO ${table} (${cols}) VALUES ${values} ON CONFLICT DO NOTHING`;
+}
+//# sourceMappingURL=sql.js.map

package/dist/src/sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.js","sourceRoot":"","sources":["../../src/sql.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,SAAS,CAAC,MAAiB;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;IACxC,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,CAAC;IAC1D,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1C,MAAM,IAAI,KAAK,CAAC,sDAAsD,IAAI,GAAG,CAAC,CAAC;AACjF,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,MAAM,CAA8B,MAAe;IACjE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,6DAA6D;QAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,OAAO,MAAM,CAAC,CAAC,CAAQ,CAAC;QAC1B,CAAC;QACD,OAAO,MAAa,CAAC;IACvB,CAAC;IACD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QAC7D,OAAQ,MAAwB,CAAC,IAAI,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,MAAiB,EACjB,GAAW,EACX,QAAQ,GAAuB,EAAE;IAEjC,OAAO,MAAM,CAAI,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,SAAS,CAAI,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;IAC7D,OAAO,KAAU,CAAC;AACpB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,KAAa,EAAE,OAAiB,EAAE,IAAY;IAC3F,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,sBAAsB,KAAK,KAAK,IAAI,YAAY,MAAM,EAAE,CAAC;IACzF,OAAO,eAAe,KAAK,KAAK,IAAI,YAAY,MAAM,yBAAyB,CAAC;AAClF,CAAC"}

package/dist/src/stores/lucid_store.d.ts

@@ -0,0 +1,55 @@
+import { type Ruleset } from '@adonis-agora/flags-core';
+import type { FlagDeclaration } from '../declare.js';
+import { type SchemaOptions } from '../schema.js';
+import { type Dialect, type SqlDatabase } from '../sql.js';
+import { type Actor, type AuditEntry, type ChangeRequest, type DeclarationRow, type FlagsStore, type RulesetChange, type ScheduledChange, type UsageRow } from './store.js';
+/** Postgres channel notified on every ruleset change (payload: `environment:version`). */
+export declare const RULESET_CHANNEL = "adonis_agora_flags";
+/**
+ * The ruleset in your database, through Lucid. Works on Postgres, MySQL and SQLite. Every write
+ * runs in one transaction that also bumps the environment version and writes the audit row, and on
+ * Postgres sends `NOTIFY` so other replicas reload immediately instead of at the next poll.
+ */
+export declare class LucidStore implements FlagsStore {
+    #private;
+    readonly db: SqlDatabase;
+    private readonly options;
+    readonly dialect: Dialect;
+    constructor(db: SqlDatabase, options?: SchemaOptions & {
+        autoCreateSchema?: boolean;
+    });
+    setup(): Promise<void>;
+    /**
+     * Postgres `LISTEN` on {@link RULESET_CHANNEL}: holds one connection from the pool for the life of
+     * the process. Other dialects have no notifications; the source falls back to polling.
+     */
+    listen(onMessage: (payload: string) => void): Promise<() => Promise<void>>;
+    readRuleset(environment: string): Promise<Ruleset>;
+    version(environment: string): Promise<string>;
+    apply(environment: string, change: RulesetChange, actor: Actor, options?: {
+        changeRequestId?: string;
+    }): Promise<{
+        version: string;
+    }>;
+    environments(): Promise<string[]>;
+    audit(q: Parameters<FlagsStore['audit']>[0]): Promise<AuditEntry[]>;
+    createChangeRequest(request: Omit<ChangeRequest, 'id' | 'status' | 'requestedAt'>): Promise<ChangeRequest>;
+    getChangeRequest(id: string): Promise<ChangeRequest | null>;
+    listChangeRequests(q: Parameters<FlagsStore['listChangeRequests']>[0]): Promise<ChangeRequest[]>;
+    updateChangeRequest(id: string, patch: Parameters<FlagsStore['updateChangeRequest']>[1]): Promise<ChangeRequest>;
+    createSchedule(schedule: Omit<ScheduledChange, 'id' | 'status'>): Promise<ScheduledChange>;
+    getSchedule(id: string): Promise<ScheduledChange | null>;
+    /** Whether this store can push change notifications (Postgres `LISTEN/NOTIFY`). */
+    get canListen(): boolean;
+    listSchedules(q: Parameters<FlagsStore['listSchedules']>[0]): Promise<ScheduledChange[]>;
+    updateSchedule(id: string, patch: Parameters<FlagsStore['updateSchedule']>[1]): Promise<ScheduledChange>;
+    claimSchedule(id: string): Promise<boolean>;
+    recordUsage(rows: UsageRow[]): Promise<void>;
+    usage(q: {
+        environment: string;
+        since: string;
+    }): Promise<UsageRow[]>;
+    saveDeclarations(app: string, declarations: Record<string, FlagDeclaration>): Promise<void>;
+    declarations(app?: string): Promise<DeclarationRow[]>;
+}
+//# sourceMappingURL=lucid_store.d.ts.map

package/dist/src/stores/lucid_store.d.ts.map

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