@adonis-agora/flags 0.0.0-stage → 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory_store.js","sourceRoot":"","sources":["../../../src/stores/memory_store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAgB,MAAM,0BAA0B,CAAC;AAE9F,OAAO,EAGL,WAAW,EACX,WAAW,EAEX,YAAY,GAMb,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,OAAO,WAAW;IACtB,SAAS,GAAG,IAAI,GAAG,EAAmB,CAAC;IACvC,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,MAAM,GAAiB,EAAE,CAAC;IAC1B,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC7C,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAC;IAChD,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IACrC,aAAa,GAAG,IAAI,GAAG,EAA0B,CAAC;IAElD,2EAA2E;IAC3E,YAAY,IAAI,GAAsD,EAAE;QACtE,KAAK,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE;gBAC9B,GAAG,YAAY,EAAE;gBACjB,GAAG,OAAO;gBACV,aAAa,EAAE,sBAAsB;gBACrC,OAAO,EAAE,GAAG;aACb,CAAC,CAAC;YACH,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,WAAmB;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC;QACrE,OAAO,eAAe,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,WAAmB;QAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,KAAK,CACT,WAAmB,EACnB,MAAqB,EACrB,KAAY,EACZ,OAAO,GAAiC,EAAE;QAE1C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,GAAG,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/F,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,EAAE,EAAE,UAAU,EAAE;YAChB,WAAW;YACX,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI;YACvB,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;YACnC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC;YAC/B,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC;YACpC,KAAK;YACL,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;YACxB,EAAE,EAAE,IAAI,IAAI,EAAE;SACf,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAyC;QACnD,OAAO,IAAI,CAAC,MAAM;aACf,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CACR,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,CAAC;YAC5E,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC;YAC7D,CAAC,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,CAAC;YACpD,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAC1D;aACA,OAAO,EAAE;aACT,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,OAA6D;QAE7D,MAAM,OAAO,GAAkB;YAC7B,GAAG,eAAe,CAAC,OAAO,CAAC;YAC3B,EAAE,EAAE,UAAU,EAAE;YAChB,MAAM,EAAE,SAAS;YACjB,WAAW,EAAE,IAAI,IAAI,EAAE;SACxB,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,EAAU;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,OAAO,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,KAAsD;QAEtD,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;aAChC,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,CAAC;YACxE,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,CAC5D;aACA,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;aACjE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC;aAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,EAAU,EACV,KAAuD;QAEvD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAAgD;QACnE,MAAM,OAAO,GAAoB;YAC/B,GAAG,eAAe,CAAC,QAAQ,CAAC;YAC5B,EAAE,EAAE,UAAU,EAAE;YAChB,MAAM,EAAE,SAAS;SAClB,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACzC,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,EAAU;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,OAAO,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,KAAiD;QAEjD,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;aACjC,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,CAAC;YACxE,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC;YACnD,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC;YACzD,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,IAAI,KAAK,CAAC,SAAS,CAAC,CAChE;aACA,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;aACrD,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC;aAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,EAAU,EACV,KAAkD;QAElD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,EAAU;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,KAAK,EAAE,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC9C,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAgB;QAChC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,WAAW,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC,GAAG,EAAE,CAAC;YAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,QAAQ;gBAAE,QAAQ,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC;;gBACjD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAA6C;QACvD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;aAC7B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW,IAAI,GAAG,CAAC,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC;aAChF,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,GAAW,EACX,YAA6C;QAE7C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,GAAG,SAAS,GAAG,EAAE,EAAE;gBAC3C,GAAG;gBACH,GAAG;gBACH,WAAW,EAAE,eAAe,CAAC,WAAW,CAAC;gBACzC,UAAU,EAAE,GAAG;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAY;QAC7B,OAAO,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;aACpC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC;aACrD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IACxC,CAAC;CACF"}

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

@@ -0,0 +1,166 @@
+import type { FlagDefinition, Holdout, Layer, Ruleset, Segment } from '@adonis-agora/flags-core';
+import type { FlagDeclaration } from '../declare.js';
+/** What a change targets. */
+export type EntityType = 'flag' | 'segment' | 'layer' | 'holdout' | 'ruleset';
+/** One change to the ruleset of an environment. `value: null` deletes. */
+export type RulesetChange = {
+    entity: 'flag';
+    key: string;
+    value: FlagDefinition | null;
+} | {
+    entity: 'segment';
+    key: string;
+    value: Segment | null;
+} | {
+    entity: 'layer';
+    key: string;
+    value: Layer | null;
+} | {
+    entity: 'holdout';
+    key?: undefined;
+    value: Holdout | null;
+}
+/** Replaces every flag, segment, layer and the holdout (import, promote). */
+ | {
+    entity: 'ruleset';
+    key?: undefined;
+    value: Omit<Ruleset, 'version' | 'schemaVersion'>;
+};
+/** Who did something: the authkit `sub`, a user id, `cli`, `schedule`… */
+export interface Actor {
+    id: string;
+    name?: string;
+    /**
+     * Nobody could be identified (e.g. the console with no signed-in user). Allowed to change
+     * environments without approvals; refused where approvals are on, because two anonymous people
+     * would be the same actor and the two-person rule would mean nothing.
+     */
+    anonymous?: boolean;
+}
+export interface AuditEntry {
+    id: string;
+    environment: string;
+    entity: EntityType;
+    key: string | null;
+    action: 'create' | 'update' | 'delete' | 'replace';
+    before: unknown;
+    after: unknown;
+    actor: Actor;
+    /** Change request that carried the change, when approvals are on. */
+    changeRequestId?: string;
+    /** The ruleset version this change produced. */
+    version: string;
+    at: Date;
+}
+export type ChangeRequestStatus = 'pending' | 'approved' | 'rejected' | 'applied' | 'cancelled';
+export interface ChangeRequest {
+    id: string;
+    environment: string;
+    change: RulesetChange;
+    /** Why the change is wanted. */
+    note?: string;
+    requestedBy: Actor;
+    requestedAt: Date;
+    status: ChangeRequestStatus;
+    reviewedBy?: Actor;
+    reviewedAt?: Date;
+    reviewNote?: string;
+    /** The ruleset version the request was made against; applying on a newer one warns. */
+    baseVersion: string;
+}
+export type ScheduleKind = 'enable' | 'disable' | 'rollout' | 'change';
+/** A change to apply at a given time (DESIGN §14: scheduling and gradual rollout). */
+export interface ScheduledChange {
+    id: string;
+    environment: string;
+    flag: string;
+    kind: ScheduleKind;
+    /** `rollout`: the share (0 … 100) the `on` arm should reach. `change`: a full RulesetChange. */
+    payload: {
+        percent?: number;
+        variant?: string;
+        change?: RulesetChange;
+    };
+    runAt: Date;
+    status: 'pending' | 'running' | 'done' | 'failed' | 'cancelled';
+    createdBy: Actor;
+    error?: string;
+    executedAt?: Date;
+}
+/** Evaluations of a flag on one day, for stale-flag detection. */
+export interface UsageRow {
+    environment: string;
+    flag: string;
+    day: string;
+    evaluations: number;
+}
+export interface DeclarationRow {
+    app: string;
+    key: string;
+    declaration: FlagDeclaration;
+    lastSeenAt: Date;
+}
+/**
+ * Where the ruleset lives. Every write bumps the environment's version in the same transaction,
+ * which is what readers poll (or are notified about) to know the ruleset changed.
+ */
+export interface FlagsStore {
+    /** Creates the tables if needed. Idempotent. */
+    setup?(): Promise<void>;
+    /** The assembled ruleset of an environment. */
+    readRuleset(environment: string): Promise<Ruleset>;
+    /** The current version string of an environment — cheap, polled. */
+    version(environment: string): Promise<string>;
+    /** Applies a change, bumps the version and writes the audit entry atomically. */
+    apply(environment: string, change: RulesetChange, actor: Actor, options?: {
+        changeRequestId?: string;
+    }): Promise<{
+        version: string;
+    }>;
+    environments(): Promise<string[]>;
+    audit(query: {
+        environment?: string;
+        entity?: EntityType;
+        key?: string;
+        limit?: number;
+        before?: Date;
+    }): Promise<AuditEntry[]>;
+    createChangeRequest(request: Omit<ChangeRequest, 'id' | 'status' | 'requestedAt'>): Promise<ChangeRequest>;
+    getChangeRequest(id: string): Promise<ChangeRequest | null>;
+    listChangeRequests(query: {
+        environment?: string;
+        status?: ChangeRequestStatus;
+        limit?: number;
+    }): Promise<ChangeRequest[]>;
+    updateChangeRequest(id: string, patch: Partial<Pick<ChangeRequest, 'status' | 'reviewedBy' | 'reviewedAt' | 'reviewNote'>>): Promise<ChangeRequest>;
+    getSchedule(id: string): Promise<ScheduledChange | null>;
+    createSchedule(schedule: Omit<ScheduledChange, 'id' | 'status'>): Promise<ScheduledChange>;
+    listSchedules(query: {
+        environment?: string;
+        flag?: string;
+        status?: ScheduledChange['status'];
+        dueBefore?: Date;
+        limit?: number;
+    }): Promise<ScheduledChange[]>;
+    updateSchedule(id: string, patch: Partial<Pick<ScheduledChange, 'status' | 'error' | 'executedAt'>>): Promise<ScheduledChange>;
+    /**
+     * Atomically claims a due schedule (pending → running) so one replica executes it. Returns
+     * `false` when another replica got it first.
+     */
+    claimSchedule(id: string): Promise<boolean>;
+    /** Adds evaluation counts (stale-flag detection). */
+    recordUsage(rows: UsageRow[]): Promise<void>;
+    usage(query: {
+        environment: string;
+        since: string;
+    }): Promise<UsageRow[]>;
+    /** Records the flags an app declares in code (schema push). */
+    saveDeclarations(app: string, declarations: Record<string, FlagDeclaration>): Promise<void>;
+    declarations(app?: string): Promise<DeclarationRow[]>;
+}
+/** Apply a change to an in-memory ruleset (shared by the stores and the console preview). */
+export declare function applyChange(ruleset: Ruleset, change: RulesetChange): Ruleset;
+/** The value a change replaces, for the audit `before` column. */
+export declare function currentValue(ruleset: Ruleset, change: RulesetChange): unknown;
+export declare function auditAction(before: unknown, change: RulesetChange): AuditEntry['action'];
+//# sourceMappingURL=store.d.ts.map

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

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

package/dist/src/stores/store.js

@@ -0,0 +1,67 @@
+/** Apply a change to an in-memory ruleset (shared by the stores and the console preview). */
+export function applyChange(ruleset, change) {
+    const next = structuredClone(ruleset);
+    const upsert = (map, key, value) => {
+        const out = { ...(map ?? {}) };
+        if (value === null)
+            delete out[key];
+        else
+            out[key] = value;
+        return out;
+    };
+    switch (change.entity) {
+        case 'flag':
+            next.flags = upsert(next.flags, change.key, change.value);
+            break;
+        case 'segment':
+            next.segments = upsert(next.segments, change.key, change.value);
+            break;
+        case 'layer':
+            next.layers = upsert(next.layers, change.key, change.value);
+            break;
+        case 'holdout':
+            if (change.value === null)
+                delete next.holdout;
+            else
+                next.holdout = change.value;
+            break;
+        case 'ruleset':
+            next.flags = structuredClone(change.value.flags);
+            next.segments = structuredClone(change.value.segments ?? {});
+            next.layers = structuredClone(change.value.layers ?? {});
+            if (change.value.holdout)
+                next.holdout = structuredClone(change.value.holdout);
+            else
+                delete next.holdout;
+            break;
+    }
+    return next;
+}
+/** The value a change replaces, for the audit `before` column. */
+export function currentValue(ruleset, change) {
+    switch (change.entity) {
+        case 'flag':
+            return ruleset.flags[change.key] ?? null;
+        case 'segment':
+            return ruleset.segments?.[change.key] ?? null;
+        case 'layer':
+            return ruleset.layers?.[change.key] ?? null;
+        case 'holdout':
+            return ruleset.holdout ?? null;
+        case 'ruleset':
+            return {
+                flags: ruleset.flags,
+                segments: ruleset.segments ?? {},
+                layers: ruleset.layers ?? {},
+                ...(ruleset.holdout ? { holdout: ruleset.holdout } : {}),
+            };
+    }
+}
+export function auditAction(before, change) {
+    if (change.entity === 'ruleset')
+        return 'replace';
+    if (change.value === null)
+        return 'delete';
+    return before === null || before === undefined ? 'create' : 'update';
+}
+//# sourceMappingURL=store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/stores/store.ts"],"names":[],"mappings":"AAkKA,6FAA6F;AAC7F,MAAM,UAAU,WAAW,CAAC,OAAgB,EAAE,MAAqB;IACjE,MAAM,IAAI,GAAY,eAAe,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,CAAI,GAAkC,EAAE,GAAW,EAAE,KAAe,EAAE,EAAE;QACrF,MAAM,GAAG,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;;YAC/B,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IACF,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,MAAM;YACT,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAC1D,MAAM;QACR,KAAK,SAAS;YACZ,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAChE,MAAM;QACR,KAAK,OAAO;YACV,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5D,MAAM;QACR,KAAK,SAAS;YACZ,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC,OAAO,CAAC;;gBAC1C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;YACjC,MAAM;QACR,KAAK,SAAS;YACZ,IAAI,CAAC,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACjD,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAC7D,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;YACzD,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO;gBAAE,IAAI,CAAC,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;;gBAC1E,OAAO,IAAI,CAAC,OAAO,CAAC;YACzB,MAAM;IACV,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,MAAqB;IAClE,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QAC3C,KAAK,SAAS;YACZ,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QAChD,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QAC9C,KAAK,SAAS;YACZ,OAAO,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;QACjC,KAAK,SAAS;YACZ,OAAO;gBACL,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;gBAChC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;gBAC5B,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACzD,CAAC;IACN,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAe,EAAE,MAAqB;IAChE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAClD,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC3C,OAAO,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvE,CAAC"}

package/dist/src/subject.d.ts

@@ -0,0 +1,25 @@
+import type { EvaluationContext } from '@adonis-agora/flags-core';
+/**
+ * Who a flag is evaluated for. Same vocabulary as `@adonis-agora/authz`: a subject has an id and a
+ * type (`user`, `organization`, …). With authkit as the IdP, use the `sub` claim as the id so the
+ * same person lands in the same bucket in every app.
+ */
+export interface Subject {
+    id: string | number;
+    /** Default `user`. Stored on events; does not change bucketing. */
+    type?: string;
+    /** Targeting attributes (`plan`, `country`, `orgId`, …). Must come from trusted server state. */
+    attributes?: Record<string, unknown>;
+}
+/** Anything `flags.for()` accepts: a subject, a bare id, or a model with an `id`. */
+export type SubjectLike = Subject | string | number | {
+    id: string | number;
+} | null | undefined;
+/** Normalizes {@link SubjectLike}. `null`/`undefined` is the anonymous subject (no targeting key). */
+export declare function toSubject(input: SubjectLike): Subject | undefined;
+/**
+ * The evaluation context for a subject. The targeting key is the subject id; the type travels as
+ * the `subjectType` attribute so rules can target it.
+ */
+export declare function toContext(subject: Subject | undefined, extra?: Record<string, unknown>): EvaluationContext;
+//# sourceMappingURL=subject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subject.d.ts","sourceRoot":"","sources":["../../src/subject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,qFAAqF;AACrF,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,CAAC;AAEjG,sGAAsG;AACtG,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,CAUjE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,iBAAiB,CAQnB"}

package/dist/src/subject.js

@@ -0,0 +1,30 @@
+/** Normalizes {@link SubjectLike}. `null`/`undefined` is the anonymous subject (no targeting key). */
+export function toSubject(input) {
+    if (input === null || input === undefined)
+        return undefined;
+    if (typeof input === 'string' || typeof input === 'number')
+        return { id: input };
+    const candidate = input;
+    if (candidate.id === undefined || candidate.id === null)
+        return undefined;
+    return {
+        id: candidate.id,
+        ...(candidate.type !== undefined ? { type: candidate.type } : {}),
+        ...(candidate.attributes !== undefined ? { attributes: candidate.attributes } : {}),
+    };
+}
+/**
+ * The evaluation context for a subject. The targeting key is the subject id; the type travels as
+ * the `subjectType` attribute so rules can target it.
+ */
+export function toContext(subject, extra = {}) {
+    if (!subject)
+        return { ...extra };
+    return {
+        ...extra,
+        ...subject.attributes,
+        subjectType: subject.type ?? 'user',
+        targetingKey: String(subject.id),
+    };
+}
+//# sourceMappingURL=subject.js.map

package/dist/src/subject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subject.js","sourceRoot":"","sources":["../../src/subject.ts"],"names":[],"mappings":"AAkBA,sGAAsG;AACtG,MAAM,UAAU,SAAS,CAAC,KAAkB;IAC1C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IACjF,MAAM,SAAS,GAAG,KAAyB,CAAC;IAC5C,IAAI,SAAS,CAAC,EAAE,KAAK,SAAS,IAAI,SAAS,CAAC,EAAE,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC1E,OAAO;QACL,EAAE,EAAE,SAAS,CAAC,EAAE;QAChB,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,SAAS,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,OAA4B,EAC5B,KAAK,GAA4B,EAAE;IAEnC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;IAClC,OAAO;QACL,GAAG,KAAK;QACR,GAAG,OAAO,CAAC,UAAU;QACrB,WAAW,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;QACnC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;KACjC,CAAC;AACJ,CAAC"}

package/dist/src/testing/index.d.ts

@@ -0,0 +1,31 @@
+import type { JsonValue, Ruleset } from '@adonis-agora/flags-core';
+import type { FlagDeclaration } from '../declare.js';
+import { FlagsManager } from '../manager.js';
+import type { FlagKey } from '../types.js';
+/**
+ * Fakes flag values in a test of a booted app and restores them afterwards:
+ *
+ * ```ts
+ * test('one-page checkout', async ({ cleanup }) => {
+ *   cleanup(fakeFlags({ checkout: 'one_page' }))
+ *   // …request the page…
+ * })
+ * ```
+ */
+export declare function fakeFlags(values: Partial<Record<FlagKey, JsonValue>>): () => void;
+/**
+ * A manager with no database, for unit tests of code that takes a manager or scope: give it the
+ * declarations and an optional ruleset; tracked and exposure events land in `events`.
+ */
+export declare function createTestFlags<F extends Record<string, FlagDeclaration>>(options: {
+    flags: F;
+    ruleset?: Partial<Ruleset>;
+    app?: string;
+}): {
+    manager: FlagsManager;
+    /** Replaces the ruleset. */
+    setRuleset(ruleset: Partial<Ruleset>): void;
+    /** Every event recorded so far (exposures and tracks). */
+    events(): Promise<import("../index.js").FlagEvent[]>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAI7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,GAAG,MAAM,IAAI,CAEjF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,EAAE;IAClF,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;;IAoBG,4BAA4B;wBACR,OAAO,CAAC,OAAO,CAAC;IASpC,0DAA0D;;EAM7D"}

package/dist/src/testing/index.js

@@ -0,0 +1,60 @@
+import { EventBuffer } from '../events/buffer.js';
+import { FlagsManager } from '../manager.js';
+import { StaticSource } from '../ruleset_source.js';
+import { getRuntime } from '../services/accessor.js';
+import { MemoryTransport } from '../transports/memory_transport.js';
+/**
+ * Fakes flag values in a test of a booted app and restores them afterwards:
+ *
+ * ```ts
+ * test('one-page checkout', async ({ cleanup }) => {
+ *   cleanup(fakeFlags({ checkout: 'one_page' }))
+ *   // …request the page…
+ * })
+ * ```
+ */
+export function fakeFlags(values) {
+    return getRuntime().manager.fake(values);
+}
+/**
+ * A manager with no database, for unit tests of code that takes a manager or scope: give it the
+ * declarations and an optional ruleset; tracked and exposure events land in `events`.
+ */
+export function createTestFlags(options) {
+    const source = new StaticSource({
+        schemaVersion: 1,
+        version: '1',
+        flags: {},
+        segments: {},
+        ...options.ruleset,
+    });
+    const transport = new MemoryTransport();
+    const buffer = new EventBuffer(transport, { maxSize: 1 });
+    const manager = new FlagsManager({
+        app: options.app ?? 'test',
+        environment: 'test',
+        declarations: options.flags,
+        source,
+        buffer,
+        transport,
+    });
+    return {
+        manager,
+        /** Replaces the ruleset. */
+        setRuleset(ruleset) {
+            source.replace({
+                schemaVersion: 1,
+                version: String(Date.now()),
+                flags: {},
+                segments: {},
+                ...ruleset,
+            });
+        },
+        /** Every event recorded so far (exposures and tracks). */
+        async events() {
+            await buffer.flush();
+            return transport.log.map((entry) => entry.event);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGpE;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,MAA2C;IACnE,OAAO,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAA4C,OAI1E;IACC,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;QAC9B,aAAa,EAAE,CAAC;QAChB,OAAO,EAAE,GAAG;QACZ,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,GAAG,OAAO,CAAC,OAAO;KACnB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC;QAC/B,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,MAAM;QAC1B,WAAW,EAAE,MAAM;QACnB,YAAY,EAAE,OAAO,CAAC,KAAK;QAC3B,MAAM;QACN,MAAM;QACN,SAAS;KACV,CAAC,CAAC;IACH,OAAO;QACL,OAAO;QACP,4BAA4B;QAC5B,UAAU,CAAC,OAAyB;YAClC,MAAM,CAAC,OAAO,CAAC;gBACb,aAAa,EAAE,CAAC;gBAChB,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC3B,KAAK,EAAE,EAAE;gBACT,QAAQ,EAAE,EAAE;gBACZ,GAAG,OAAO;aACX,CAAC,CAAC;QACL,CAAC;QACD,0DAA0D;QAC1D,KAAK,CAAC,MAAM;YACV,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACnD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/topology/browser_token.d.ts

@@ -0,0 +1,48 @@
+import type { Subject } from '../subject.js';
+import type { TokenSource } from './token.js';
+import type { VerifiedUser } from './verify.js';
+export interface BrowserTokenPayload {
+    sub?: string;
+    typ?: string;
+    attrs?: Record<string, unknown>;
+    app: string;
+    env: string;
+    exp: number;
+}
+export interface IssuedBrowserToken {
+    token: string;
+    /** Epoch ms. */
+    expiresAt: number;
+}
+/** The signing key of one app in one environment. */
+export declare function browserKey(secret: string, app: string, environment: string): string;
+export declare function signBrowserToken(subject: Subject | undefined, options: {
+    key: string;
+    app: string;
+    environment: string;
+    ttlSeconds?: number;
+}): IssuedBrowserToken;
+/** Verifies a browser token against the flags server's secret. `null` when invalid or expired. */
+export declare function verifyBrowserToken(token: string | undefined, secret: string): VerifiedUser | null;
+/** Where an app gets the key it signs its browser tokens with. */
+export interface BrowserKeySource {
+    get(): Promise<{
+        key: string;
+        app: string;
+        environment: string;
+    }>;
+}
+/** Standalone and control-plane: the key is derived locally. */
+export declare function localKeySource(secret: string, app: string, environment: string): BrowserKeySource;
+/**
+ * Tenant: asks the control-plane for this app's key (`POST <url>/v1/browser-key`), authenticated
+ * like every other tenant call. Cached for an hour; concurrent callers share one request.
+ */
+export declare function remoteKeySource(options: {
+    url: string;
+    token: TokenSource;
+    partition: string;
+    fetch?: typeof fetch;
+    cacheMs?: number;
+}): BrowserKeySource;
+//# sourceMappingURL=browser_token.d.ts.map

package/dist/src/topology/browser_token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser_token.d.ts","sourceRoot":"","sources":["../../../src/topology/browser_token.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAehD,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAQD,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAInF;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9E,kBAAkB,CAiBpB;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAiCjG;AAED,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAGjG;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,gBAAgB,CAuCnB"}

package/dist/src/topology/browser_token.js

@@ -0,0 +1,128 @@
+import { createHmac, timingSafeEqual } from 'node:crypto';
+/**
+ * Browser tokens: short-lived, HMAC-signed evaluation contexts that an app's backend mints for
+ * its own frontend (`GET /_flags/token`) and the flags API verifies.
+ *
+ * Each app signs with its own key, derived from the flags server's secret and the app's name and
+ * environment. The flags server re-derives the key from the token's `app` and `env`, so a token
+ * cannot be moved to another app or environment, and an app can only ever mint tokens for itself.
+ * A tenant gets its key from the control-plane over its authenticated tenant connection, so there
+ * is no extra secret to distribute.
+ */
+const VERSION = 'v1';
+function sameString(a, b) {
+    const x = Buffer.from(a);
+    const y = Buffer.from(b);
+    return x.length === y.length && timingSafeEqual(x, y);
+}
+/** The signing key of one app in one environment. */
+export function browserKey(secret, app, environment) {
+    return createHmac('sha256', secret)
+        .update(`flags-browser-key:${VERSION}:${app}:${environment}`)
+        .digest('base64url');
+}
+export function signBrowserToken(subject, options) {
+    const exp = Math.floor(Date.now() / 1000) + (options.ttlSeconds ?? 300);
+    const payload = {
+        ...(subject ? { sub: String(subject.id) } : {}),
+        ...(subject?.type ? { typ: subject.type } : {}),
+        ...(subject?.attributes && Object.keys(subject.attributes).length > 0
+            ? { attrs: subject.attributes }
+            : {}),
+        app: options.app,
+        env: options.environment,
+        exp,
+    };
+    const body = Buffer.from(JSON.stringify(payload)).toString('base64url');
+    const signature = createHmac('sha256', options.key)
+        .update(`${VERSION}.${body}`)
+        .digest('base64url');
+    return { token: `${VERSION}.${body}.${signature}`, expiresAt: exp * 1000 };
+}
+/** Verifies a browser token against the flags server's secret. `null` when invalid or expired. */
+export function verifyBrowserToken(token, secret) {
+    if (!token)
+        return null;
+    const [version, body, signature] = token.split('.');
+    if (version !== VERSION || !body || !signature)
+        return null;
+    let payload;
+    try {
+        payload = JSON.parse(Buffer.from(body, 'base64url').toString('utf8'));
+    }
+    catch {
+        return null;
+    }
+    if (typeof payload.app !== 'string' || typeof payload.env !== 'string')
+        return null;
+    if (typeof payload.exp !== 'number' || payload.exp * 1000 < Date.now())
+        return null;
+    const key = browserKey(secret, payload.app, payload.env);
+    const expected = createHmac('sha256', key).update(`${VERSION}.${body}`).digest('base64url');
+    if (!sameString(signature, expected))
+        return null;
+    const attributes = payload.attrs && typeof payload.attrs === 'object' && !Array.isArray(payload.attrs)
+        ? payload.attrs
+        : undefined;
+    return {
+        ...(typeof payload.sub === 'string'
+            ? {
+                subject: {
+                    id: payload.sub,
+                    ...(typeof payload.typ === 'string' ? { type: payload.typ } : {}),
+                    ...(attributes ? { attributes } : {}),
+                },
+            }
+            : {}),
+        environment: payload.env,
+        app: payload.app,
+        expiresAt: payload.exp * 1000,
+    };
+}
+/** Standalone and control-plane: the key is derived locally. */
+export function localKeySource(secret, app, environment) {
+    const key = { key: browserKey(secret, app, environment), app, environment };
+    return { get: async () => key };
+}
+/**
+ * Tenant: asks the control-plane for this app's key (`POST <url>/v1/browser-key`), authenticated
+ * like every other tenant call. Cached for an hour; concurrent callers share one request.
+ */
+export function remoteKeySource(options) {
+    const doFetch = options.fetch ?? fetch;
+    let cached = null;
+    let inflight;
+    const load = async () => {
+        const request = async () => doFetch(`${options.url.replace(/\/$/, '')}/v1/browser-key`, {
+            method: 'POST',
+            headers: {
+                authorization: `Bearer ${await options.token.get()}`,
+                'x-flags-tenant': options.partition,
+            },
+        });
+        let response = await request();
+        if (response.status === 401 && options.token.invalidate) {
+            options.token.invalidate();
+            response = await request();
+        }
+        if (response.status === 404) {
+            throw new Error('the control-plane does not serve browsers: set `browser` in its config/flags.ts');
+        }
+        if (!response.ok)
+            throw new Error(`control-plane answered ${response.status} on /v1/browser-key`);
+        const value = (await response.json());
+        cached = { value, until: Date.now() + (options.cacheMs ?? 3_600_000) };
+        return value;
+    };
+    return {
+        async get() {
+            if (cached && cached.until > Date.now())
+                return cached.value;
+            inflight ??= load().finally(() => {
+                inflight = undefined;
+            });
+            return inflight;
+        },
+    };
+}
+//# sourceMappingURL=browser_token.js.map

package/dist/src/topology/browser_token.js.map

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