@adonis-agora/flags 0.0.0-stage → 0.1.0

package/dist/src/schema.js

@@ -0,0 +1,311 @@
+import { dialectOf, query } from './sql.js';
+/**
+ * Every table this package owns. Timestamps are BIGINT epoch milliseconds throughout (see
+ * `toDate` in sql.ts), JSON is JSONB / JSON / TEXT depending on the dialect.
+ */
+export const FLAGS_TABLES = [
+    'flags_environments',
+    'flags_entities',
+    'flags_audit',
+    'flags_change_requests',
+    'flags_schedules',
+    'flags_usage',
+    'flags_declarations',
+    'flags_events',
+    'flags_sink_cursors',
+    'flags_exposures',
+    'flags_tracks',
+    'flags_results',
+];
+function typesFor(dialect) {
+    if (dialect === 'postgres') {
+        return {
+            json: 'JSONB',
+            bigintPk: 'BIGINT GENERATED BY DEFAULT AS IDENTITY',
+            double: 'DOUBLE PRECISION',
+            text: 'TEXT',
+        };
+    }
+    if (dialect === 'mysql') {
+        return { json: 'JSON', bigintPk: 'BIGINT AUTO_INCREMENT', double: 'DOUBLE', text: 'TEXT' };
+    }
+    return { json: 'TEXT', bigintPk: 'INTEGER', double: 'REAL', text: 'TEXT' };
+}
+/** Variable-length keys stay ≤ 191 chars so MySQL utf8mb4 indexes fit. */
+const K = 'VARCHAR(191)';
+function statements(dialect, options) {
+    const t = typesFor(dialect);
+    const sqlite = dialect === 'sqlite';
+    const eventsPk = sqlite
+        ? 'id INTEGER PRIMARY KEY AUTOINCREMENT'
+        : options.partitionEvents && dialect === 'postgres'
+            ? `id ${t.bigintPk}`
+            : `id ${t.bigintPk} PRIMARY KEY`;
+    const eventsTail = options.partitionEvents && dialect === 'postgres'
+        ? ', PRIMARY KEY (id, ts)) PARTITION BY RANGE (ts)'
+        : ')';
+    return [
+        `CREATE TABLE IF NOT EXISTS flags_environments (
+      name ${K} PRIMARY KEY,
+      version BIGINT NOT NULL DEFAULT 0,
+      updated_at BIGINT NOT NULL
+    )`,
+        `CREATE TABLE IF NOT EXISTS flags_entities (
+      environment ${K} NOT NULL,
+      entity VARCHAR(16) NOT NULL,
+      entity_key ${K} NOT NULL,
+      definition ${t.json} NOT NULL,
+      updated_at BIGINT NOT NULL,
+      updated_by ${K} NOT NULL,
+      PRIMARY KEY (environment, entity, entity_key)
+    )`,
+        `CREATE TABLE IF NOT EXISTS flags_audit (
+      id VARCHAR(36) PRIMARY KEY,
+      environment ${K} NOT NULL,
+      entity VARCHAR(16) NOT NULL,
+      entity_key ${K} NULL,
+      action VARCHAR(16) NOT NULL,
+      before_value ${t.json} NULL,
+      after_value ${t.json} NULL,
+      actor_id ${K} NOT NULL,
+      actor_name ${K} NULL,
+      change_request_id VARCHAR(36) NULL,
+      version BIGINT NOT NULL,
+      at BIGINT NOT NULL
+    )`,
+        `CREATE TABLE IF NOT EXISTS flags_change_requests (
+      id VARCHAR(36) PRIMARY KEY,
+      environment ${K} NOT NULL,
+      change_value ${t.json} NOT NULL,
+      note ${t.text} NULL,
+      requested_by ${t.json} NOT NULL,
+      requested_at BIGINT NOT NULL,
+      status VARCHAR(16) NOT NULL,
+      reviewed_by ${t.json} NULL,
+      reviewed_at BIGINT NULL,
+      review_note ${t.text} NULL,
+      base_version VARCHAR(32) NOT NULL
+    )`,
+        `CREATE TABLE IF NOT EXISTS flags_schedules (
+      id VARCHAR(36) PRIMARY KEY,
+      environment ${K} NOT NULL,
+      flag ${K} NOT NULL,
+      kind VARCHAR(16) NOT NULL,
+      payload ${t.json} NOT NULL,
+      run_at BIGINT NOT NULL,
+      status VARCHAR(16) NOT NULL,
+      created_by ${t.json} NOT NULL,
+      error ${t.text} NULL,
+      executed_at BIGINT NULL
+    )`,
+        `CREATE TABLE IF NOT EXISTS flags_usage (
+      environment ${K} NOT NULL,
+      flag ${K} NOT NULL,
+      day CHAR(10) NOT NULL,
+      evaluations BIGINT NOT NULL,
+      PRIMARY KEY (environment, flag, day)
+    )`,
+        `CREATE TABLE IF NOT EXISTS flags_declarations (
+      app ${K} NOT NULL,
+      flag ${K} NOT NULL,
+      declaration ${t.json} NOT NULL,
+      last_seen_at BIGINT NOT NULL,
+      PRIMARY KEY (app, flag)
+    )`,
+        `CREATE TABLE IF NOT EXISTS flags_events (
+      ${eventsPk},
+      event_id VARCHAR(36) NOT NULL,
+      schema_version SMALLINT NOT NULL,
+      app ${K} NOT NULL,
+      environment VARCHAR(64) NOT NULL,
+      type VARCHAR(16) NOT NULL,
+      flag ${K} NULL,
+      experiment ${K} NULL,
+      variant ${K} NULL,
+      name ${K} NULL,
+      subject ${K} NOT NULL,
+      subject_type VARCHAR(64) NOT NULL,
+      value ${t.double} NULL,
+      props ${t.json} NULL,
+      ts BIGINT NOT NULL${dialect === 'postgres'
+            ? `,
+      tx xid8 NOT NULL DEFAULT pg_current_xact_id()`
+            : ''}
+    ${eventsTail}`,
+        `CREATE TABLE IF NOT EXISTS flags_sink_cursors (
+      sink ${K} PRIMARY KEY,
+      last_id BIGINT NOT NULL DEFAULT 0,
+      last_tx BIGINT NOT NULL DEFAULT 0,
+      leased_by ${K} NULL,
+      lease_until BIGINT NULL,
+      delivered BIGINT NOT NULL DEFAULT 0,
+      last_error ${t.text} NULL,
+      updated_at BIGINT NOT NULL
+    )`,
+        `CREATE TABLE IF NOT EXISTS flags_exposures (
+      environment VARCHAR(64) NOT NULL,
+      experiment ${K} NOT NULL,
+      subject ${K} NOT NULL,
+      variant ${K} NOT NULL,
+      flag ${K} NOT NULL,
+      app ${K} NOT NULL,
+      subject_type VARCHAR(64) NOT NULL,
+      first_seen_ts BIGINT NOT NULL,
+      PRIMARY KEY (environment, experiment, subject)
+    )`,
+        `CREATE TABLE IF NOT EXISTS flags_tracks (
+      event_id VARCHAR(36) PRIMARY KEY,
+      environment VARCHAR(64) NOT NULL,
+      name ${K} NOT NULL,
+      subject ${K} NOT NULL,
+      subject_type VARCHAR(64) NOT NULL,
+      app ${K} NOT NULL,
+      value ${t.double} NULL,
+      props ${t.json} NULL,
+      ts BIGINT NOT NULL
+    )`,
+        `CREATE TABLE IF NOT EXISTS flags_results (
+      environment VARCHAR(64) NOT NULL,
+      experiment ${K} NOT NULL,
+      payload ${t.json} NOT NULL,
+      computed_at BIGINT NOT NULL,
+      PRIMARY KEY (environment, experiment)
+    )`,
+    ];
+}
+const INDEXES = [
+    ['flags_audit_env_version_idx', 'flags_audit', 'environment, version'],
+    ['flags_change_requests_status_idx', 'flags_change_requests', 'status, requested_at'],
+    ['flags_schedules_due_idx', 'flags_schedules', 'status, run_at'],
+    ['flags_events_ts_idx', 'flags_events', 'ts'],
+    ['flags_exposures_subject_idx', 'flags_exposures', 'subject'],
+    ['flags_tracks_env_name_subject_ts_idx', 'flags_tracks', 'environment, name, subject, ts'],
+    ['flags_tracks_subject_idx', 'flags_tracks', 'subject'],
+];
+async function createIndex(client, dialect, name, table, columns) {
+    if (dialect !== 'mysql') {
+        await client.rawQuery(`CREATE INDEX IF NOT EXISTS ${name} ON ${table} (${columns})`);
+        return;
+    }
+    try {
+        await client.rawQuery(`CREATE INDEX ${name} ON ${table} (${columns})`);
+    }
+    catch (error) {
+        if (!/duplicate key name|already exists/i.test(String(error.message)))
+            throw error;
+    }
+}
+/**
+ * Serializes concurrent DDL across replicas booting together: a Postgres advisory lock or a MySQL
+ * named lock. SQLite has a single writer already.
+ */
+async function withDdlLock(db, dialect, fn) {
+    if (dialect === 'postgres') {
+        return db.transaction(async (trx) => {
+            await trx.rawQuery("SELECT pg_advisory_xact_lock(hashtext('adonis-agora-flags-ddl'))");
+            return fn(trx);
+        });
+    }
+    if (dialect === 'mysql') {
+        // GET_LOCK belongs to the session, so the lock, the DDL and the release must share one
+        // connection: a transaction pins it. DDL commits implicitly, but the session (and the named
+        // lock) survives that.
+        return db.transaction(async (trx) => {
+            await trx.rawQuery("SELECT GET_LOCK('adonis-agora-flags-ddl', 60)");
+            try {
+                return await fn(trx);
+            }
+            finally {
+                await trx.rawQuery("SELECT RELEASE_LOCK('adonis-agora-flags-ddl')");
+            }
+        });
+    }
+    return fn(db);
+}
+/**
+ * Creates every table and index. Idempotent and safe to run from several replicas at once. Called
+ * by the provider at boot when `autoCreateSchema` is on (the default) and by the published
+ * migration — the same function on both paths, so the schema cannot drift.
+ */
+export async function createFlagsTables(db, options = {}) {
+    const dialect = dialectOf(db);
+    await withDdlLock(db, dialect, async (client) => {
+        for (const sql of statements(dialect, options))
+            await client.rawQuery(sql);
+        for (const [name, table, columns] of INDEXES) {
+            // A BRIN index fits an append-only log ordered by time far better than a B-tree.
+            if (name === 'flags_events_ts_idx' && dialect === 'postgres') {
+                await client.rawQuery(`CREATE INDEX IF NOT EXISTS ${name} ON ${table} USING BRIN (${columns})`);
+                // The relay reads in (tx, id) order; see DbTransport.
+                await client.rawQuery('CREATE INDEX IF NOT EXISTS flags_events_tx_id_idx ON flags_events (tx, id)');
+                continue;
+            }
+            await createIndex(client, dialect, name, table, columns);
+        }
+    });
+    if (options.partitionEvents && dialect === 'postgres')
+        await ensureEventPartitions(db, Date.now());
+}
+/** Drops every table this package owns. */
+export async function dropFlagsTables(db) {
+    for (const table of [...FLAGS_TABLES].reverse())
+        await db.rawQuery(`DROP TABLE IF EXISTS ${table}`);
+}
+/** Whether `flags_events` is a partitioned table (Postgres). */
+export async function eventsArePartitioned(db) {
+    if (dialectOf(db) !== 'postgres')
+        return false;
+    const rows = await query(db, "SELECT c.relkind FROM pg_class c WHERE c.relname = 'flags_events' AND c.relnamespace = to_regnamespace(current_schema())");
+    return rows[0]?.relkind === 'p';
+}
+function monthStart(ms, offset = 0) {
+    const d = new Date(ms);
+    return new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth() + offset, 1));
+}
+function partitionName(start) {
+    return `flags_events_${start.getUTCFullYear()}${String(start.getUTCMonth() + 1).padStart(2, '0')}`;
+}
+/**
+ * Creates the monthly partitions for the current and the next two months. Called at boot and by the
+ * worker, so inserts never hit a missing partition.
+ */
+export async function ensureEventPartitions(db, now) {
+    if (!(await eventsArePartitioned(db)))
+        return;
+    for (let offset = 0; offset < 3; offset++) {
+        const start = monthStart(now, offset);
+        const end = monthStart(now, offset + 1);
+        await db.rawQuery(`CREATE TABLE IF NOT EXISTS ${partitionName(start)} PARTITION OF flags_events FOR VALUES FROM (${start.getTime()}) TO (${end.getTime()})`);
+    }
+}
+/**
+ * Removes events older than `before` (epoch ms) that every sink cursor has already passed. On a
+ * partitioned table whole monthly partitions are dropped; otherwise rows are deleted in batches.
+ * Returns how many partitions or rows went away.
+ */
+export async function pruneEvents(db, before, safeId) {
+    if (await eventsArePartitioned(db)) {
+        const parts = await query(db, `SELECT c.relname AS name, pg_get_expr(c.relpartbound, c.oid) AS bound
+         FROM pg_inherits i JOIN pg_class c ON c.oid = i.inhrelid
+         JOIN pg_class p ON p.oid = i.inhparent
+        WHERE p.relname = 'flags_events' AND p.relnamespace = to_regnamespace(current_schema())`);
+        let partitions = 0;
+        for (const part of parts) {
+            const match = /TO \('?(\d+)'?\)/.exec(part.bound);
+            if (!match || Number(match[1]) > before)
+                continue;
+            const maxRows = await query(db, `SELECT MAX(id) AS max FROM ${part.name}`);
+            const max = maxRows[0]?.max;
+            if (max !== null && max !== undefined && Number(max) > safeId)
+                continue;
+            await db.rawQuery(`DROP TABLE ${part.name}`);
+            partitions++;
+        }
+        return { partitions, rows: 0 };
+    }
+    const result = await query(db, dialectOf(db) === 'postgres'
+        ? 'WITH gone AS (DELETE FROM flags_events WHERE ts < ? AND id <= ? RETURNING 1) SELECT COUNT(*) AS count FROM gone'
+        : 'DELETE FROM flags_events WHERE ts < ? AND id <= ?', [before, safeId]);
+    return { partitions: 0, rows: Number(result[0]?.count ?? 0) };
+}
+//# sourceMappingURL=schema.js.map

package/dist/src/schema.js.map

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

package/dist/src/services/accessor.d.ts

@@ -0,0 +1,5 @@
+import type { FlagsRuntime } from '../runtime.js';
+export declare function setRuntime(runtime: FlagsRuntime | undefined): void;
+export declare function getRuntime(): FlagsRuntime;
+export declare function hasRuntime(): boolean;
+//# sourceMappingURL=accessor.d.ts.map

package/dist/src/services/accessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessor.d.ts","sourceRoot":"","sources":["../../../src/services/accessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAWlD,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,QAE3D;AAED,wBAAgB,UAAU,IAAI,YAAY,CAQzC;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC"}

package/dist/src/services/accessor.js

@@ -0,0 +1,20 @@
+/**
+ * The runtime the provider built, readable outside the container (middleware, the OpenFeature
+ * provider, commands). Kept on a `Symbol.for` slot so two copies of this package in one process
+ * still share it.
+ */
+const SLOT = Symbol.for('@adonis-agora/flags/runtime');
+export function setRuntime(runtime) {
+    globalThis[SLOT] = runtime;
+}
+export function getRuntime() {
+    const runtime = globalThis[SLOT];
+    if (!runtime) {
+        throw new Error('@adonis-agora/flags is not booted: register "@adonis-agora/flags/flags_provider" in adonisrc.ts (node ace configure @adonis-agora/flags)');
+    }
+    return runtime;
+}
+export function hasRuntime() {
+    return globalThis[SLOT] !== undefined;
+}
+//# sourceMappingURL=accessor.js.map

package/dist/src/services/accessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessor.js","sourceRoot":"","sources":["../../../src/services/accessor.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAIvD,MAAM,UAAU,UAAU,CAAC,OAAiC;IACzD,UAAqB,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,OAAO,GAAI,UAAqB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,0IAA0I,CAC3I,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAQ,UAAqB,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;AACpD,CAAC"}

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

@@ -0,0 +1,41 @@
+import type { FlagEvent } from '../events/event.js';
+import type { Sink } from './sink.js';
+export interface ClickHouseOptions {
+    /** HTTP endpoint, e.g. `http://localhost:8123`. */
+    url: string;
+    database?: string;
+    username?: string;
+    password?: string;
+    /** Table for every event. Default `flags_events`. */
+    table?: string;
+    fetch?: typeof fetch;
+}
+/** A tiny ClickHouse HTTP client: no driver dependency, just the HTTP interface. */
+export declare class ClickHouseClient {
+    #private;
+    readonly options: ClickHouseOptions;
+    readonly table: string;
+    constructor(options: ClickHouseOptions);
+    exec(sql: string): Promise<string>;
+    insert(rows: Array<Record<string, unknown>>): Promise<void>;
+    /** Runs a SELECT with `{name:Type}` parameters and returns the rows. */
+    select<T = Record<string, unknown>>(sql: string, params?: Record<string, string | number>): Promise<T[]>;
+    createTable(): Promise<void>;
+}
+/** Every event into one ClickHouse table, read back by the `clickhouse` analytics backend. */
+export declare class ClickHouseSink implements Sink {
+    #private;
+    readonly kind = "clickhouse";
+    readonly client: ClickHouseClient;
+    constructor(options: ClickHouseOptions & {
+        batchSize?: number;
+        intervalMs?: number;
+        autoCreateSchema?: boolean;
+    });
+    readonly batchSize: number;
+    readonly intervalMs?: number;
+    setup(): Promise<void>;
+    write(events: FlagEvent[]): Promise<void>;
+    forget(subject: string): Promise<void>;
+}
+//# sourceMappingURL=clickhouse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse.d.ts","sourceRoot":"","sources":["../../../src/sinks/clickhouse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,oFAAoF;AACpF,qBAAa,gBAAgB;;IAIf,QAAQ,CAAC,OAAO,EAAE,iBAAiB;IAF/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,YAAqB,OAAO,EAAE,iBAAiB,EAG9C;IAuBD,IAAI,CAAC,GAAG,EAAE,MAAM,mBAEf;IAEK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,iBAQhD;IAED,wEAAwE;IAClE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAM,GAC3C,OAAO,CAAC,CAAC,EAAE,CAAC,CAQd;IAEK,WAAW,kBAqBhB;CACF;AAED,8FAA8F;AAC9F,qBAAa,cAAe,YAAW,IAAI;;IACzC,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAElC,YACE,OAAO,EAAE,iBAAiB,GAAG;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC5B,EAMF;IAED,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAGvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAEK,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB9C;IAEK,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3C;CACF"}

package/dist/src/sinks/clickhouse.js

@@ -0,0 +1,117 @@
+/** A tiny ClickHouse HTTP client: no driver dependency, just the HTTP interface. */
+export class ClickHouseClient {
+    options;
+    #fetch;
+    table;
+    constructor(options) {
+        this.options = options;
+        this.#fetch = options.fetch ?? fetch;
+        this.table = options.table ?? 'flags_events';
+    }
+    /** POSTs `sql` (in the `query` parameter) with an optional data body. */
+    async #request(sql, body, settings = {}) {
+        const url = new URL(this.options.url);
+        url.searchParams.set('query', sql);
+        if (this.options.database)
+            url.searchParams.set('database', this.options.database);
+        for (const [key, value] of Object.entries(settings))
+            url.searchParams.set(key, String(value));
+        const headers = {};
+        if (this.options.username) {
+            headers.authorization = `Basic ${Buffer.from(`${this.options.username}:${this.options.password ?? ''}`).toString('base64')}`;
+        }
+        const response = await this.#fetch(url, {
+            method: 'POST',
+            headers,
+            ...(body !== undefined ? { body } : {}),
+        });
+        const text = await response.text();
+        if (!response.ok)
+            throw new Error(`ClickHouse answered ${response.status}: ${text.slice(0, 500)}`);
+        return text;
+    }
+    exec(sql) {
+        return this.#request(sql);
+    }
+    async insert(rows) {
+        if (rows.length === 0)
+            return;
+        await this.#request(`INSERT INTO ${this.table} FORMAT JSONEachRow`, rows.map((row) => JSON.stringify(row)).join('\n'), 
+        // Server-side batching: many small inserts become few parts.
+        { async_insert: 1, wait_for_async_insert: 1 });
+    }
+    /** Runs a SELECT with `{name:Type}` parameters and returns the rows. */
+    async select(sql, params = {}) {
+        const settings = {};
+        for (const [key, value] of Object.entries(params))
+            settings[`param_${key}`] = value;
+        const text = await this.#request(`${sql} FORMAT JSONEachRow`, undefined, settings);
+        return text
+            .split('\n')
+            .filter((line) => line.trim().length > 0)
+            .map((line) => JSON.parse(line));
+    }
+    async createTable() {
+        // ReplacingMergeTree on the event id: re-sent events collapse on merge, and the analytics
+        // queries count DISTINCT subjects, so pre-merge duplicates never change a result.
+        await this.exec(`CREATE TABLE IF NOT EXISTS ${this.table} (
+      event_id String,
+      schema_version UInt8,
+      app LowCardinality(String),
+      environment LowCardinality(String),
+      type LowCardinality(String),
+      flag Nullable(String),
+      experiment Nullable(String),
+      variant Nullable(String),
+      name Nullable(String),
+      subject String,
+      subject_type LowCardinality(String),
+      value Nullable(Float64),
+      props String,
+      ts Int64
+    ) ENGINE = ReplacingMergeTree
+    PARTITION BY toYYYYMM(fromUnixTimestamp64Milli(ts))
+    ORDER BY (environment, type, ifNull(experiment, ''), ifNull(name, ''), subject, event_id)`);
+    }
+}
+/** Every event into one ClickHouse table, read back by the `clickhouse` analytics backend. */
+export class ClickHouseSink {
+    kind = 'clickhouse';
+    client;
+    constructor(options) {
+        this.client = new ClickHouseClient(options);
+        this.batchSize = options.batchSize ?? 5000;
+        if (options.intervalMs !== undefined)
+            this.intervalMs = options.intervalMs;
+        this.#autoCreate = options.autoCreateSchema !== false;
+    }
+    batchSize;
+    intervalMs;
+    #autoCreate;
+    async setup() {
+        if (this.#autoCreate)
+            await this.client.createTable();
+    }
+    async write(events) {
+        await this.client.insert(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,
+        })));
+    }
+    async forget(subject) {
+        await this.client.exec(`ALTER TABLE ${this.client.table} DELETE WHERE subject = '${subject.replaceAll('\\', '\\\\').replaceAll("'", "\\'")}'`);
+    }
+}
+//# sourceMappingURL=clickhouse.js.map

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

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

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

@@ -0,0 +1,25 @@
+import type { FlagEvent } from '../events/event.js';
+import { type Dialect, type SqlDatabase } from '../sql.js';
+import type { Sink } from './sink.js';
+/**
+ * The analysis tables in your database: `flags_exposures` (one row per experiment and subject — the
+ * first exposure wins, which is also what sticky assignment reads) and `flags_tracks` (one row per
+ * tracked event, deduped by event id). The `lucid` analytics backend reads them.
+ */
+export declare class LucidSink implements Sink {
+    readonly db: SqlDatabase;
+    private readonly options;
+    readonly kind = "lucid";
+    readonly dialect: Dialect;
+    constructor(db: SqlDatabase, options?: {
+        autoCreateSchema?: boolean;
+        batchSize?: number;
+        intervalMs?: number;
+    });
+    get batchSize(): number | undefined;
+    get intervalMs(): number | undefined;
+    setup(): Promise<void>;
+    write(events: FlagEvent[]): Promise<void>;
+    forget(subject: string): Promise<void>;
+}
+//# sourceMappingURL=lucid_sink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lucid_sink.d.ts","sourceRoot":"","sources":["../../../src/sinks/lucid_sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,KAAK,OAAO,EAAsC,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAC/F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC;;;;GAIG;AACH,qBAAa,SAAU,YAAW,IAAI;IAKlC,QAAQ,CAAC,EAAE,EAAE,WAAW;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,YACW,EAAE,EAAE,WAAW,EACP,OAAO,GAAE;QACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KAChB,EAGP;IAED,IAAI,SAAS,uBAEZ;IAED,IAAI,UAAU,uBAEb;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAEK,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmE9C;IAEK,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK3C;CACF"}

package/dist/src/sinks/lucid_sink.js

@@ -0,0 +1,87 @@
+import { createFlagsTables } from '../schema.js';
+import { dialectOf, insertIgnore, jsonValue } from '../sql.js';
+/**
+ * The analysis tables in your database: `flags_exposures` (one row per experiment and subject — the
+ * first exposure wins, which is also what sticky assignment reads) and `flags_tracks` (one row per
+ * tracked event, deduped by event id). The `lucid` analytics backend reads them.
+ */
+export class LucidSink {
+    db;
+    options;
+    kind = 'lucid';
+    dialect;
+    constructor(db, options = {}) {
+        this.db = db;
+        this.options = options;
+        this.dialect = dialectOf(db);
+    }
+    get batchSize() {
+        return this.options.batchSize;
+    }
+    get intervalMs() {
+        return this.options.intervalMs;
+    }
+    async setup() {
+        if (this.options.autoCreateSchema !== false)
+            await createFlagsTables(this.db);
+    }
+    async write(events) {
+        const exposures = events.filter((e) => e.type === 'exposure' && e.experiment && e.variant);
+        const tracks = events.filter((e) => e.type === 'track' && e.name);
+        await this.db.transaction(async (trx) => {
+            for (let i = 0; i < exposures.length; i += 300) {
+                const chunk = exposures.slice(i, i + 300);
+                await trx.rawQuery(insertIgnore(this.dialect, 'flags_exposures', [
+                    'environment',
+                    'experiment',
+                    'subject',
+                    'variant',
+                    'flag',
+                    'app',
+                    'subject_type',
+                    'first_seen_ts',
+                ], chunk.length), chunk.flatMap((e) => [
+                    e.environment,
+                    e.experiment,
+                    e.subject,
+                    e.variant,
+                    e.flag ?? e.experiment,
+                    e.app,
+                    e.subjectType,
+                    e.ts,
+                ]));
+            }
+            for (let i = 0; i < tracks.length; i += 300) {
+                const chunk = tracks.slice(i, i + 300);
+                await trx.rawQuery(insertIgnore(this.dialect, 'flags_tracks', [
+                    'event_id',
+                    'environment',
+                    'name',
+                    'subject',
+                    'subject_type',
+                    'app',
+                    'value',
+                    'props',
+                    'ts',
+                ], chunk.length), chunk.flatMap((e) => [
+                    e.id,
+                    e.environment,
+                    e.name,
+                    e.subject,
+                    e.subjectType,
+                    e.app,
+                    e.value ?? null,
+                    jsonValue(e.props),
+                    e.ts,
+                ]));
+            }
+        });
+    }
+    async forget(subject) {
+        await this.db.transaction(async (trx) => {
+            await trx.rawQuery('DELETE FROM flags_exposures WHERE subject = ?', [subject]);
+            await trx.rawQuery('DELETE FROM flags_tracks WHERE subject = ?', [subject]);
+        });
+    }
+}
+//# sourceMappingURL=lucid_sink.js.map

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

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