@adonis-agora/flags 0.0.0-beta-20261112141227

package/dist/src/runtime.js

@@ -0,0 +1,301 @@
+import { FlagsAdmin } from './admin.js';
+import { LucidBackend } from './analytics/lucid_backend.js';
+import { serializeDeclarations } from './declare.js';
+import { analytics as analyticsFactories, sinks as sinkFactories } from './define_config.js';
+import { enrichers as builtInEnrichers } from './enrichers.js';
+import { EventBuffer } from './events/buffer.js';
+import { FlagsManager } from './manager.js';
+import { Relay } from './relay/relay.js';
+import { LucidResultsCache, MemoryResultsCache } from './relay/results_cache.js';
+import { FlagsWorker } from './relay/worker.js';
+import { StoreSource } from './ruleset_source.js';
+import { LucidSink } from './sinks/lucid_sink.js';
+import { query } from './sql.js';
+import { LucidStore } from './stores/lucid_store.js';
+import { MemoryStore } from './stores/memory_store.js';
+import { RemoteSource } from './topology/remote_source.js';
+import { tokens } from './topology/token.js';
+import { DbTransport } from './transports/db_transport.js';
+import { HttpTransport } from './transports/http_transport.js';
+import { MemoryTransport } from './transports/memory_transport.js';
+import { UsageCounter } from './usage.js';
+/** Resolves defaults that depend on what is installed (`lucid` when available, else memory). */
+async function lucidAvailable(ctx) {
+    try {
+        await ctx.db();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Builds (and starts) the runtime. Shared by the provider, the commands and the tests. */
+export async function createRuntime(config, ctx, options = {}) {
+    const topology = config.topology ?? 'standalone';
+    const role = config.role ?? 'all';
+    const environment = config.environment ?? 'production';
+    const app = config.topology === 'tenant' ? config.tenant.partition : (config.app ?? ctx.appName ?? 'app');
+    const logger = options.logger;
+    const declarations = config.flags;
+    const enricherList = [builtInEnrichers.diagnostics(), ...(config.enrichers ?? [])];
+    for (const enricher of enricherList)
+        await enricher.setup?.();
+    const start = options.start !== false;
+    if (config.topology === 'tenant') {
+        const tenant = config.tenant;
+        const token = typeof tenant.token === 'string' ? tokens.static(tenant.token) : tenant.token;
+        const source = new RemoteSource({
+            url: tenant.url,
+            token,
+            partition: tenant.partition,
+            ...(tenant.snapshotPath ? { snapshotPath: tenant.snapshotPath } : {}),
+            ...(tenant.stream !== undefined ? { stream: tenant.stream } : {}),
+            ...(tenant.intervalMs !== undefined ? { intervalMs: tenant.intervalMs } : {}),
+            ...(tenant.capabilities ? { capabilities: tenant.capabilities } : {}),
+            onError: (error) => logger?.warn(`[flags] control-plane: ${error.message}`),
+        });
+        const transport = new HttpTransport({ url: tenant.url, token, partition: tenant.partition });
+        const buffer = new EventBuffer(transport, {
+            ...config.events?.buffer,
+            onError: (error) => logger?.warn(`[flags] sending events failed: ${error.message}`),
+        });
+        const base = tenant.url.replace(/\/$/, '');
+        const post = async (path, body) => {
+            const response = await fetch(`${base}${path}`, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json',
+                    authorization: `Bearer ${await token.get()}`,
+                    'x-flags-tenant': tenant.partition,
+                },
+                body: JSON.stringify(body),
+            });
+            if (!response.ok)
+                throw new Error(`control-plane answered ${response.status} on ${path}`);
+        };
+        const usage = config.usage === false
+            ? undefined
+            : new UsageCounter(environment, (rows) => post('/v1/usage', { rows }), (error) => logger?.warn(`[flags] usage flush failed: ${error.message}`));
+        const manager = new FlagsManager({
+            app,
+            environment,
+            declarations,
+            source,
+            buffer,
+            transport,
+            enrichers: enricherList,
+            ...(usage ? { usage } : {}),
+            ...(config.attributes ? { attributes: config.attributes } : {}),
+            ...(logger ? { logger } : {}),
+        });
+        if (start) {
+            await source.start();
+            buffer.start();
+            usage?.start();
+            // Tell the control-plane what this app declares, so its console knows the flags exist.
+            void post('/v1/declarations', { declarations: serializeDeclarations(declarations) }).catch((error) => logger?.warn(`[flags] publishing declarations failed: ${error.message}`));
+        }
+        return {
+            config,
+            topology,
+            role,
+            manager,
+            source,
+            transport,
+            sinks: new Map(),
+            buffer,
+            ...(usage ? { usage } : {}),
+            enrichers: enricherList,
+            token,
+            async close() {
+                await source.stop();
+                await buffer.close();
+                await usage?.close();
+            },
+        };
+    }
+    const owned = config;
+    const hasLucid = await lucidAvailable(ctx);
+    const store = owned.store
+        ? await owned.store(ctx)
+        : hasLucid
+            ? await (async () => new LucidStore(await ctx.db(), {
+                autoCreateSchema: ctx.autoCreateSchema,
+                partitionEvents: ctx.partitionEvents,
+            }))()
+            : new MemoryStore();
+    if (!owned.store && !hasLucid) {
+        logger?.warn('[flags] @adonisjs/lucid is not configured: flags live in memory and reset on restart');
+    }
+    await store.setup?.();
+    const usesLucidStore = store instanceof LucidStore;
+    const transport = owned.transport
+        ? await owned.transport(ctx)
+        : usesLucidStore
+            ? new DbTransport(store.db, {
+                autoCreateSchema: ctx.autoCreateSchema,
+                partitionEvents: ctx.partitionEvents,
+            })
+            : new MemoryTransport();
+    await transport.setup?.();
+    if (!transport.capabilities.durable) {
+        logger?.warn(`[flags] the "${transport.name}" transport is not durable: undelivered events are lost on restart`);
+    }
+    const sinkFactories_ = owned.sinks ?? (usesLucidStore ? { warehouse: sinkFactories.lucid() } : {});
+    const sinkMap = new Map();
+    for (const [name, factory] of Object.entries(sinkFactories_)) {
+        const sink = await factory(ctx);
+        await sink.setup?.();
+        sinkMap.set(name, sink);
+    }
+    const lucidSink = [...sinkMap.values()].find((sink) => sink instanceof LucidSink);
+    const analyticsBackend = owned.analytics
+        ? await owned.analytics(ctx)
+        : lucidSink
+            ? new LucidBackend(lucidSink.db)
+            : undefined;
+    void analyticsFactories;
+    const resultsCache = usesLucidStore
+        ? new LucidResultsCache(store.db)
+        : new MemoryResultsCache();
+    const source = new StoreSource(store, {
+        environment,
+        ...(owned.refresh?.intervalMs !== undefined ? { intervalMs: owned.refresh.intervalMs } : {}),
+        ...(options.listen === false
+            ? { notify: false }
+            : owned.refresh?.notify !== undefined
+                ? { notify: owned.refresh.notify }
+                : {}),
+        onError: (error) => logger?.warn(`[flags] reloading the ruleset failed: ${error.message}`),
+    });
+    const buffer = new EventBuffer(transport, {
+        ...config.events?.buffer,
+        onError: (error) => logger?.warn(`[flags] publishing events failed: ${error.message}`),
+    });
+    const usage = config.usage === false
+        ? undefined
+        : new UsageCounter(environment, (rows) => store.recordUsage(rows), (error) => logger?.warn(`[flags] usage flush failed: ${error.message}`));
+    const admin = new FlagsAdmin(store, {
+        environment,
+        declarations,
+        ...(owned.approvals ? { approvals: owned.approvals } : {}),
+        ...(owned.authorize
+            ? { authorize: owned.authorize }
+            : config.identity?.can
+                ? { authorize: config.identity.can.bind(config.identity) }
+                : {}),
+        onApplied: (env, version) => {
+            if (env === environment)
+                void source.refresh();
+            options.onApplied?.(env, version);
+        },
+    });
+    const sticky = owned.sticky && lucidSink
+        ? async (subject) => {
+            const rows = await query(lucidSink.db, "SELECT flag, variant FROM flags_exposures WHERE environment = ? AND subject = ? AND variant <> '__holdout__'", [environment, subject]);
+            return Object.fromEntries(rows.map((row) => [row.flag, row.variant]));
+        }
+        : undefined;
+    if (owned.sticky && !lucidSink)
+        logger?.warn('[flags] sticky assignments need the lucid sink; they are off');
+    const relay = transport.consume && sinkMap.size > 0
+        ? new Relay(transport, sinkMap, {
+            ...(owned.relay?.batchSize !== undefined ? { batchSize: owned.relay.batchSize } : {}),
+            ...(owned.relay?.leaseMs !== undefined ? { leaseMs: owned.relay.leaseMs } : {}),
+        })
+        : undefined;
+    const worker = new FlagsWorker({
+        ...(relay ? { relay } : {}),
+        ...(owned.relay?.intervalMs !== undefined ? { relayIntervalMs: owned.relay.intervalMs } : {}),
+        admin,
+        source,
+        environment,
+        ...(owned.resultsEnvironments ? { resultsEnvironments: owned.resultsEnvironments } : {}),
+        ...(analyticsBackend ? { analytics: analyticsBackend } : {}),
+        resultsCache,
+        ...(owned.metrics ? { metrics: owned.metrics } : {}),
+        ...(owned.experiments ? { experiments: owned.experiments } : {}),
+        ...(owned.resultsIntervalMs !== undefined
+            ? { resultsIntervalMs: owned.resultsIntervalMs }
+            : {}),
+        transport,
+        ...(transport instanceof DbTransport ? { eventsDb: transport.db } : {}),
+        ...(owned.retentionDays !== undefined ? { retentionDays: owned.retentionDays } : {}),
+        ...(logger ? { logger } : {}),
+    });
+    const manager = new FlagsManager({
+        app,
+        environment,
+        declarations,
+        source,
+        buffer,
+        transport,
+        enrichers: enricherList,
+        ...(usage ? { usage } : {}),
+        ...(sticky ? { sticky } : {}),
+        ...(config.attributes ? { attributes: config.attributes } : {}),
+        admin,
+        results: (experiment, env) => resultsCache.get(env ?? environment, experiment),
+        forget: async (subject) => {
+            for (const sink of sinkMap.values())
+                await sink.forget?.(subject);
+            if (transport instanceof DbTransport) {
+                await transport.db.rawQuery('DELETE FROM flags_events WHERE subject = ?', [subject]);
+            }
+        },
+        ...(logger ? { logger } : {}),
+    });
+    if (start) {
+        await source.start();
+        buffer.start();
+        usage?.start();
+        if (options.runWorker)
+            worker.start();
+    }
+    return {
+        config,
+        topology,
+        role,
+        manager,
+        source,
+        admin,
+        store,
+        transport,
+        sinks: sinkMap,
+        ...(relay ? { relay } : {}),
+        ...(analyticsBackend ? { analytics: analyticsBackend } : {}),
+        resultsCache,
+        worker,
+        buffer,
+        ...(usage ? { usage } : {}),
+        enrichers: enricherList,
+        async close() {
+            await worker.stop();
+            await source.stop();
+            await buffer.close();
+            await usage?.close();
+            for (const sink of sinkMap.values())
+                await sink.close?.();
+            await analyticsBackend?.close?.();
+            await transport.close?.();
+        },
+    };
+}
+/** A database for factories, from a Lucid `Database` (or anything with `connection()`). */
+export function lucidContext(db, options = {}) {
+    return {
+        async db(connection) {
+            if (!db)
+                throw new Error('@adonisjs/lucid is not available');
+            return db.connection(connection);
+        },
+        redis: options.redis ??
+            (async () => {
+                throw new Error('no redis connection available');
+            }),
+        autoCreateSchema: options.autoCreateSchema ?? true,
+        partitionEvents: options.partitionEvents ?? false,
+        ...(options.app ? { app: options.app } : {}),
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/src/runtime.js.map

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

package/dist/src/schema.d.ts

@@ -0,0 +1,39 @@
+import { type SqlClient, type SqlDatabase } 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 declare const FLAGS_TABLES: readonly ['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'];
+export interface SchemaOptions {
+    /**
+     * Postgres only: partition `flags_events` by month on `ts`, so retention drops whole
+     * partitions instead of deleting rows. Decide before the table exists — switching later needs a
+     * manual migration. Default `false`.
+     */
+    partitionEvents?: boolean;
+}
+/**
+ * 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 declare function createFlagsTables(db: SqlDatabase, options?: SchemaOptions): Promise<void>;
+/** Drops every table this package owns. */
+export declare function dropFlagsTables(db: SqlDatabase): Promise<void>;
+/** Whether `flags_events` is a partitioned table (Postgres). */
+export declare function eventsArePartitioned(db: SqlClient): Promise<boolean>;
+/**
+ * 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 declare function ensureEventPartitions(db: SqlClient, now: number): Promise<void>;
+/**
+ * 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 declare function pruneEvents(db: SqlClient, before: number, safeId: number): Promise<{
+    partitions: number;
+    rows: number;
+}>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5F;;;GAGG;AACH,eAAO,MAAM,YAAY,YACvB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,eAAe,CACP,CAAC;AAEX,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAuOD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,WAAW,EACf,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,2CAA2C;AAC3C,wBAAsB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpE;AAED,gEAAgE;AAChE,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAO1E;AAWD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASrF;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAgC/C"}