@adonis-agora/flags 0.0.0-stage → 0.1.0

package/dist/src/stores/lucid_store.js

@@ -0,0 +1,412 @@
+import { randomUUID } from 'node:crypto';
+import { RULESET_SCHEMA_VERSION, } from '@adonis-agora/flags-core';
+import { createFlagsTables } from '../schema.js';
+import { dialectOf, insertIgnore, jsonValue, parseJson, query, toDate, toNumber, } from '../sql.js';
+import { applyChange, auditAction, currentValue, } from './store.js';
+/** Postgres channel notified on every ruleset change (payload: `environment:version`). */
+export const RULESET_CHANNEL = 'adonis_agora_flags';
+const HOLDOUT_KEY = '__holdout__';
+/**
+ * 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 class LucidStore {
+    db;
+    options;
+    dialect;
+    constructor(db, options = {}) {
+        this.db = db;
+        this.options = options;
+        this.dialect = dialectOf(db);
+    }
+    async setup() {
+        if (this.options.autoCreateSchema === false)
+            return;
+        await createFlagsTables(this.db, this.options);
+    }
+    /**
+     * 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.
+     */
+    async listen(onMessage) {
+        if (this.dialect !== 'postgres')
+            throw new Error('notifications need Postgres');
+        // A QueryClient exposes getWriteClient(); a Database exposes connection() returning one.
+        const holder = this.db;
+        const knex = typeof holder.getWriteClient === 'function'
+            ? holder.getWriteClient()
+            : typeof holder.connection === 'function'
+                ? holder.connection().getWriteClient()
+                : undefined;
+        if (!knex)
+            throw new Error('cannot reach the underlying knex client to LISTEN');
+        const connection = (await knex.client.acquireConnection());
+        const handler = (message) => {
+            if (message.channel === RULESET_CHANNEL)
+                onMessage(message.payload ?? '');
+        };
+        connection.on('notification', handler);
+        await connection.query(`LISTEN ${RULESET_CHANNEL}`);
+        return async () => {
+            connection.removeListener('notification', handler);
+            try {
+                await connection.query(`UNLISTEN ${RULESET_CHANNEL}`);
+            }
+            finally {
+                await knex.client.releaseConnection(connection);
+            }
+        };
+    }
+    async readRuleset(environment) {
+        // One snapshot: the version and the entities must come from the same moment.
+        return this.db.transaction(async (trx) => {
+            const version = await this.#version(trx, environment);
+            const rows = await query(trx, 'SELECT entity, entity_key, definition FROM flags_entities WHERE environment = ?', [environment]);
+            const ruleset = {
+                schemaVersion: RULESET_SCHEMA_VERSION,
+                version,
+                flags: {},
+                segments: {},
+                layers: {},
+            };
+            for (const row of rows) {
+                const definition = parseJson(row.definition);
+                if (row.entity === 'flag')
+                    ruleset.flags[row.entity_key] = definition;
+                else if (row.entity === 'segment')
+                    ruleset.segments[row.entity_key] = definition;
+                else if (row.entity === 'layer')
+                    ruleset.layers[row.entity_key] = definition;
+                else if (row.entity === 'holdout')
+                    ruleset.holdout = definition;
+            }
+            return ruleset;
+        });
+    }
+    async version(environment) {
+        return this.#version(this.db, environment);
+    }
+    async #version(client, environment) {
+        const rows = await query(client, 'SELECT version FROM flags_environments WHERE name = ?', [environment]);
+        return String(toNumber(rows[0]?.version ?? 0));
+    }
+    async apply(environment, change, actor, options = {}) {
+        const result = await this.db.transaction(async (trx) => {
+            const now = Date.now();
+            await this.#ensureEnvironment(trx, environment, now);
+            // Row lock on the environment serializes concurrent writers (SQLite is single-writer).
+            if (this.dialect !== 'sqlite') {
+                await trx.rawQuery('SELECT version FROM flags_environments WHERE name = ? FOR UPDATE', [
+                    environment,
+                ]);
+            }
+            const before = currentValue(await this.#readIn(trx, environment), change);
+            await this.#write(trx, environment, change, actor, now);
+            await trx.rawQuery('UPDATE flags_environments SET version = version + 1, updated_at = ? WHERE name = ?', [now, environment]);
+            const version = await this.#version(trx, environment);
+            await trx.rawQuery(`INSERT INTO flags_audit (id, environment, entity, entity_key, action, before_value, after_value, actor_id, actor_name, change_request_id, version, at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+                randomUUID(),
+                environment,
+                change.entity,
+                change.key ?? null,
+                auditAction(before, change),
+                jsonValue(before),
+                jsonValue(change.value),
+                actor.id,
+                actor.name ?? null,
+                options.changeRequestId ?? null,
+                Number(version),
+                now,
+            ]);
+            if (this.dialect === 'postgres') {
+                await trx.rawQuery('SELECT pg_notify(?, ?)', [
+                    RULESET_CHANNEL,
+                    `${environment}:${version}`,
+                ]);
+            }
+            return { version };
+        });
+        return result;
+    }
+    async #readIn(trx, environment) {
+        const rows = await query(trx, 'SELECT entity, entity_key, definition FROM flags_entities WHERE environment = ?', [environment]);
+        let ruleset = {
+            schemaVersion: RULESET_SCHEMA_VERSION,
+            version: '0',
+            flags: {},
+            segments: {},
+            layers: {},
+        };
+        for (const row of rows) {
+            const value = parseJson(row.definition);
+            ruleset =
+                row.entity === 'holdout'
+                    ? applyChange(ruleset, { entity: 'holdout', value })
+                    : applyChange(ruleset, { entity: row.entity, key: row.entity_key, value });
+        }
+        return ruleset;
+    }
+    async #ensureEnvironment(trx, environment, now) {
+        await trx.rawQuery(insertIgnore(this.dialect, 'flags_environments', ['name', 'version', 'updated_at'], 1), [environment, 0, now]);
+    }
+    async #write(trx, environment, change, actor, now) {
+        const upsert = async (entity, key, value) => {
+            await trx.rawQuery('DELETE FROM flags_entities WHERE environment = ? AND entity = ? AND entity_key = ?', [environment, entity, key]);
+            if (value === null)
+                return;
+            await trx.rawQuery('INSERT INTO flags_entities (environment, entity, entity_key, definition, updated_at, updated_by) VALUES (?, ?, ?, ?, ?, ?)', [environment, entity, key, jsonValue(value), now, actor.id]);
+        };
+        switch (change.entity) {
+            case 'flag':
+            case 'segment':
+            case 'layer':
+                await upsert(change.entity, change.key, change.value);
+                return;
+            case 'holdout':
+                await upsert('holdout', HOLDOUT_KEY, change.value);
+                return;
+            case 'ruleset': {
+                await trx.rawQuery('DELETE FROM flags_entities WHERE environment = ?', [environment]);
+                const value = change.value;
+                for (const [key, def] of Object.entries(value.flags))
+                    await upsert('flag', key, def);
+                for (const [key, def] of Object.entries(value.segments ?? {}))
+                    await upsert('segment', key, def);
+                for (const [key, def] of Object.entries(value.layers ?? {}))
+                    await upsert('layer', key, def);
+                if (value.holdout)
+                    await upsert('holdout', HOLDOUT_KEY, value.holdout);
+            }
+        }
+    }
+    async environments() {
+        const rows = await query(this.db, 'SELECT name FROM flags_environments ORDER BY name');
+        return rows.map((row) => row.name);
+    }
+    async audit(q) {
+        const where = [];
+        const bindings = [];
+        if (q.environment !== undefined)
+            where.push('environment = ?') && bindings.push(q.environment);
+        if (q.entity !== undefined)
+            where.push('entity = ?') && bindings.push(q.entity);
+        if (q.key !== undefined)
+            where.push('entity_key = ?') && bindings.push(q.key);
+        if (q.before !== undefined)
+            where.push('at < ?') && bindings.push(q.before.getTime());
+        bindings.push(q.limit ?? 100);
+        const rows = await query(this.db, `SELECT * FROM flags_audit ${where.length ? `WHERE ${where.join(' AND ')}` : ''} ORDER BY version DESC, at DESC LIMIT ?`, bindings);
+        return rows.map((row) => ({
+            id: String(row.id),
+            environment: String(row.environment),
+            entity: row.entity,
+            key: row.entity_key ?? null,
+            action: row.action,
+            before: row.before_value === null ? null : parseJson(row.before_value),
+            after: row.after_value === null ? null : parseJson(row.after_value),
+            actor: {
+                id: String(row.actor_id),
+                ...(row.actor_name ? { name: String(row.actor_name) } : {}),
+            },
+            ...(row.change_request_id ? { changeRequestId: String(row.change_request_id) } : {}),
+            version: String(toNumber(row.version)),
+            at: toDate(row.at),
+        }));
+    }
+    async createChangeRequest(request) {
+        const id = randomUUID();
+        const now = Date.now();
+        await this.db.rawQuery(`INSERT INTO flags_change_requests (id, environment, change_value, note, requested_by, requested_at, status, base_version)
+       VALUES (?, ?, ?, ?, ?, ?, 'pending', ?)`, [
+            id,
+            request.environment,
+            jsonValue(request.change),
+            request.note ?? null,
+            jsonValue(request.requestedBy),
+            now,
+            request.baseVersion,
+        ]);
+        return (await this.getChangeRequest(id));
+    }
+    async getChangeRequest(id) {
+        const rows = await query(this.db, 'SELECT * FROM flags_change_requests WHERE id = ?', [id]);
+        return rows[0] ? toChangeRequest(rows[0]) : null;
+    }
+    async listChangeRequests(q) {
+        const where = [];
+        const bindings = [];
+        if (q.environment !== undefined)
+            where.push('environment = ?') && bindings.push(q.environment);
+        if (q.status !== undefined)
+            where.push('status = ?') && bindings.push(q.status);
+        bindings.push(q.limit ?? 100);
+        const rows = await query(this.db, `SELECT * FROM flags_change_requests ${where.length ? `WHERE ${where.join(' AND ')}` : ''} ORDER BY requested_at DESC LIMIT ?`, bindings);
+        return rows.map(toChangeRequest);
+    }
+    async updateChangeRequest(id, patch) {
+        const sets = [];
+        const bindings = [];
+        if (patch.status !== undefined)
+            sets.push('status = ?') && bindings.push(patch.status);
+        if (patch.reviewedBy !== undefined)
+            sets.push('reviewed_by = ?') && bindings.push(jsonValue(patch.reviewedBy));
+        if (patch.reviewedAt !== undefined)
+            sets.push('reviewed_at = ?') && bindings.push(patch.reviewedAt.getTime());
+        if (patch.reviewNote !== undefined)
+            sets.push('review_note = ?') && bindings.push(patch.reviewNote);
+        if (sets.length > 0) {
+            await this.db.rawQuery(`UPDATE flags_change_requests SET ${sets.join(', ')} WHERE id = ?`, [
+                ...bindings,
+                id,
+            ]);
+        }
+        const updated = await this.getChangeRequest(id);
+        if (!updated)
+            throw new Error(`change request ${id} not found`);
+        return updated;
+    }
+    async createSchedule(schedule) {
+        const id = randomUUID();
+        await this.db.rawQuery(`INSERT INTO flags_schedules (id, environment, flag, kind, payload, run_at, status, created_by)
+       VALUES (?, ?, ?, ?, ?, ?, 'pending', ?)`, [
+            id,
+            schedule.environment,
+            schedule.flag,
+            schedule.kind,
+            jsonValue(schedule.payload),
+            schedule.runAt.getTime(),
+            jsonValue(schedule.createdBy),
+        ]);
+        return (await this.#schedule(id));
+    }
+    getSchedule(id) {
+        return this.#schedule(id);
+    }
+    /** Whether this store can push change notifications (Postgres `LISTEN/NOTIFY`). */
+    get canListen() {
+        return this.dialect === 'postgres';
+    }
+    async #schedule(id) {
+        const rows = await query(this.db, 'SELECT * FROM flags_schedules WHERE id = ?', [id]);
+        return rows[0] ? toSchedule(rows[0]) : null;
+    }
+    async listSchedules(q) {
+        const where = [];
+        const bindings = [];
+        if (q.environment !== undefined)
+            where.push('environment = ?') && bindings.push(q.environment);
+        if (q.flag !== undefined)
+            where.push('flag = ?') && bindings.push(q.flag);
+        if (q.status !== undefined)
+            where.push('status = ?') && bindings.push(q.status);
+        if (q.dueBefore !== undefined)
+            where.push('run_at <= ?') && bindings.push(q.dueBefore.getTime());
+        bindings.push(q.limit ?? 100);
+        const rows = await query(this.db, `SELECT * FROM flags_schedules ${where.length ? `WHERE ${where.join(' AND ')}` : ''} ORDER BY run_at ASC LIMIT ?`, bindings);
+        return rows.map(toSchedule);
+    }
+    async updateSchedule(id, patch) {
+        const sets = [];
+        const bindings = [];
+        if (patch.status !== undefined)
+            sets.push('status = ?') && bindings.push(patch.status);
+        if (patch.error !== undefined)
+            sets.push('error = ?') && bindings.push(patch.error);
+        if (patch.executedAt !== undefined)
+            sets.push('executed_at = ?') && bindings.push(patch.executedAt.getTime());
+        if (sets.length > 0) {
+            await this.db.rawQuery(`UPDATE flags_schedules SET ${sets.join(', ')} WHERE id = ?`, [
+                ...bindings,
+                id,
+            ]);
+        }
+        const updated = await this.#schedule(id);
+        if (!updated)
+            throw new Error(`schedule ${id} not found`);
+        return updated;
+    }
+    async claimSchedule(id) {
+        // Compare-and-set in one statement: only one replica's UPDATE matches the pending row, and the
+        // token it writes tells it apart from a replica that lost the race.
+        const token = `claim:${randomUUID()}`;
+        await this.db.rawQuery("UPDATE flags_schedules SET status = 'running', error = ? WHERE id = ? AND status = 'pending'", [token, id]);
+        const rows = await query(this.db, 'SELECT error FROM flags_schedules WHERE id = ?', [id]);
+        if (rows[0]?.error !== token)
+            return false;
+        await this.db.rawQuery('UPDATE flags_schedules SET error = NULL WHERE id = ?', [id]);
+        return true;
+    }
+    async recordUsage(rows) {
+        if (rows.length === 0)
+            return;
+        for (const row of rows) {
+            const sql = this.dialect === 'mysql'
+                ? 'INSERT INTO flags_usage (environment, flag, day, evaluations) VALUES (?, ?, ?, ?) ON DUPLICATE KEY UPDATE evaluations = evaluations + VALUES(evaluations)'
+                : 'INSERT INTO flags_usage (environment, flag, day, evaluations) VALUES (?, ?, ?, ?) ON CONFLICT (environment, flag, day) DO UPDATE SET evaluations = flags_usage.evaluations + excluded.evaluations';
+            await this.db.rawQuery(sql, [row.environment, row.flag, row.day, row.evaluations]);
+        }
+    }
+    async usage(q) {
+        const rows = await query(this.db, 'SELECT environment, flag, day, evaluations FROM flags_usage WHERE environment = ? AND day >= ?', [q.environment, q.since]);
+        return rows.map((row) => ({
+            environment: String(row.environment),
+            flag: String(row.flag),
+            day: String(row.day),
+            evaluations: toNumber(row.evaluations),
+        }));
+    }
+    async saveDeclarations(app, declarations) {
+        const now = Date.now();
+        await this.db.transaction(async (trx) => {
+            for (const [key, declaration] of Object.entries(declarations)) {
+                await trx.rawQuery('DELETE FROM flags_declarations WHERE app = ? AND flag = ?', [app, key]);
+                await trx.rawQuery('INSERT INTO flags_declarations (app, flag, declaration, last_seen_at) VALUES (?, ?, ?, ?)', [app, key, jsonValue(declaration), now]);
+            }
+        });
+    }
+    async declarations(app) {
+        const rows = await query(this.db, `SELECT * FROM flags_declarations ${app !== undefined ? 'WHERE app = ?' : ''} ORDER BY app, flag`, app !== undefined ? [app] : []);
+        return rows.map((row) => ({
+            app: String(row.app),
+            key: String(row.flag),
+            declaration: parseJson(row.declaration),
+            lastSeenAt: toDate(row.last_seen_at),
+        }));
+    }
+}
+function toChangeRequest(row) {
+    return {
+        id: String(row.id),
+        environment: String(row.environment),
+        change: parseJson(row.change_value),
+        ...(row.note ? { note: String(row.note) } : {}),
+        requestedBy: parseJson(row.requested_by),
+        requestedAt: toDate(row.requested_at),
+        status: row.status,
+        ...(row.reviewed_by ? { reviewedBy: parseJson(row.reviewed_by) } : {}),
+        ...(row.reviewed_at !== null && row.reviewed_at !== undefined
+            ? { reviewedAt: toDate(row.reviewed_at) }
+            : {}),
+        ...(row.review_note ? { reviewNote: String(row.review_note) } : {}),
+        baseVersion: String(row.base_version),
+    };
+}
+function toSchedule(row) {
+    return {
+        id: String(row.id),
+        environment: String(row.environment),
+        flag: String(row.flag),
+        kind: row.kind,
+        payload: parseJson(row.payload),
+        runAt: toDate(row.run_at),
+        status: row.status,
+        createdBy: parseJson(row.created_by),
+        ...(row.error && !String(row.error).startsWith('claim:') ? { error: String(row.error) } : {}),
+        ...(row.executed_at !== null && row.executed_at !== undefined
+            ? { executedAt: toDate(row.executed_at) }
+            : {}),
+    };
+}
+//# sourceMappingURL=lucid_store.js.map

package/dist/src/stores/lucid_store.js.map

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

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

@@ -0,0 +1,38 @@
+import { type Ruleset } from '@adonis-agora/flags-core';
+import type { FlagDeclaration } from '../declare.js';
+import { type Actor, type AuditEntry, type ChangeRequest, type DeclarationRow, type FlagsStore, type RulesetChange, type ScheduledChange, type UsageRow } from './store.js';
+/**
+ * A store that lives in process memory. For tests, local development and apps whose flags are
+ * only toggled from code. Nothing survives a restart, and replicas do not share it.
+ */
+export declare class MemoryStore implements FlagsStore {
+    #private;
+    /** Seed environments with a ruleset (`{ production: { flags: {…} } }`). */
+    constructor(seed?: Record<string, Partial<Omit<Ruleset, 'version'>>>);
+    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(query: Parameters<FlagsStore['audit']>[0]): Promise<AuditEntry[]>;
+    createChangeRequest(request: Omit<ChangeRequest, 'id' | 'status' | 'requestedAt'>): Promise<ChangeRequest>;
+    getChangeRequest(id: string): Promise<ChangeRequest | null>;
+    listChangeRequests(query: 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>;
+    listSchedules(query: 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(query: {
+        environment: string;
+        since: string;
+    }): Promise<UsageRow[]>;
+    saveDeclarations(app: string, declarations: Record<string, FlagDeclaration>): Promise<void>;
+    declarations(app?: string): Promise<DeclarationRow[]>;
+}
+//# sourceMappingURL=memory_store.d.ts.map

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

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

package/dist/src/stores/memory_store.js

@@ -0,0 +1,166 @@
+import { randomUUID } from 'node:crypto';
+import { emptyRuleset, RULESET_SCHEMA_VERSION } from '@adonis-agora/flags-core';
+import { applyChange, auditAction, currentValue, } from './store.js';
+/**
+ * A store that lives in process memory. For tests, local development and apps whose flags are
+ * only toggled from code. Nothing survives a restart, and replicas do not share it.
+ */
+export class MemoryStore {
+    #rulesets = new Map();
+    #versions = new Map();
+    #audit = [];
+    #requests = new Map();
+    #schedules = new Map();
+    #usage = new Map();
+    #declarations = new Map();
+    /** Seed environments with a ruleset (`{ production: { flags: {…} } }`). */
+    constructor(seed = {}) {
+        for (const [environment, ruleset] of Object.entries(seed)) {
+            this.#rulesets.set(environment, {
+                ...emptyRuleset(),
+                ...ruleset,
+                schemaVersion: RULESET_SCHEMA_VERSION,
+                version: '1',
+            });
+            this.#versions.set(environment, 1);
+        }
+    }
+    async readRuleset(environment) {
+        const ruleset = this.#rulesets.get(environment) ?? emptyRuleset('0');
+        return structuredClone({ ...ruleset, version: await this.version(environment) });
+    }
+    async version(environment) {
+        return String(this.#versions.get(environment) ?? 0);
+    }
+    async apply(environment, change, actor, options = {}) {
+        const current = this.#rulesets.get(environment) ?? emptyRuleset('0');
+        const before = currentValue(current, change);
+        const version = (this.#versions.get(environment) ?? 0) + 1;
+        this.#rulesets.set(environment, { ...applyChange(current, change), version: String(version) });
+        this.#versions.set(environment, version);
+        this.#audit.push({
+            id: randomUUID(),
+            environment,
+            entity: change.entity,
+            key: change.key ?? null,
+            action: auditAction(before, change),
+            before: structuredClone(before),
+            after: structuredClone(change.value),
+            actor,
+            ...(options.changeRequestId ? { changeRequestId: options.changeRequestId } : {}),
+            version: String(version),
+            at: new Date(),
+        });
+        return { version: String(version) };
+    }
+    async environments() {
+        return [...this.#rulesets.keys()].sort();
+    }
+    async audit(query) {
+        return this.#audit
+            .filter((entry) => (query.environment === undefined || entry.environment === query.environment) &&
+            (query.entity === undefined || entry.entity === query.entity) &&
+            (query.key === undefined || entry.key === query.key) &&
+            (query.before === undefined || entry.at < query.before))
+            .reverse()
+            .slice(0, query.limit ?? 100);
+    }
+    async createChangeRequest(request) {
+        const created = {
+            ...structuredClone(request),
+            id: randomUUID(),
+            status: 'pending',
+            requestedAt: new Date(),
+        };
+        this.#requests.set(created.id, created);
+        return structuredClone(created);
+    }
+    async getChangeRequest(id) {
+        const found = this.#requests.get(id);
+        return found ? structuredClone(found) : null;
+    }
+    async listChangeRequests(query) {
+        return [...this.#requests.values()]
+            .filter((r) => (query.environment === undefined || r.environment === query.environment) &&
+            (query.status === undefined || r.status === query.status))
+            .sort((a, b) => b.requestedAt.getTime() - a.requestedAt.getTime())
+            .slice(0, query.limit ?? 100)
+            .map((r) => structuredClone(r));
+    }
+    async updateChangeRequest(id, patch) {
+        const found = this.#requests.get(id);
+        if (!found)
+            throw new Error(`change request ${id} not found`);
+        Object.assign(found, structuredClone(patch));
+        return structuredClone(found);
+    }
+    async createSchedule(schedule) {
+        const created = {
+            ...structuredClone(schedule),
+            id: randomUUID(),
+            status: 'pending',
+        };
+        this.#schedules.set(created.id, created);
+        return structuredClone(created);
+    }
+    async getSchedule(id) {
+        const found = this.#schedules.get(id);
+        return found ? structuredClone(found) : null;
+    }
+    async listSchedules(query) {
+        return [...this.#schedules.values()]
+            .filter((s) => (query.environment === undefined || s.environment === query.environment) &&
+            (query.flag === undefined || s.flag === query.flag) &&
+            (query.status === undefined || s.status === query.status) &&
+            (query.dueBefore === undefined || s.runAt <= query.dueBefore))
+            .sort((a, b) => a.runAt.getTime() - b.runAt.getTime())
+            .slice(0, query.limit ?? 100)
+            .map((s) => structuredClone(s));
+    }
+    async updateSchedule(id, patch) {
+        const found = this.#schedules.get(id);
+        if (!found)
+            throw new Error(`schedule ${id} not found`);
+        Object.assign(found, structuredClone(patch));
+        return structuredClone(found);
+    }
+    async claimSchedule(id) {
+        const found = this.#schedules.get(id);
+        if (found?.status !== 'pending')
+            return false;
+        found.status = 'running';
+        return true;
+    }
+    async recordUsage(rows) {
+        for (const row of rows) {
+            const key = `${row.environment}\u0000${row.flag}\u0000${row.day}`;
+            const existing = this.#usage.get(key);
+            if (existing)
+                existing.evaluations += row.evaluations;
+            else
+                this.#usage.set(key, { ...row });
+        }
+    }
+    async usage(query) {
+        return [...this.#usage.values()]
+            .filter((row) => row.environment === query.environment && row.day >= query.since)
+            .map((row) => ({ ...row }));
+    }
+    async saveDeclarations(app, declarations) {
+        const now = new Date();
+        for (const [key, declaration] of Object.entries(declarations)) {
+            this.#declarations.set(`${app}\u0000${key}`, {
+                app,
+                key,
+                declaration: structuredClone(declaration),
+                lastSeenAt: now,
+            });
+        }
+    }
+    async declarations(app) {
+        return [...this.#declarations.values()]
+            .filter((row) => app === undefined || row.app === app)
+            .map((row) => structuredClone(row));
+    }
+}
+//# sourceMappingURL=memory_store.js.map