@crvouga/mockingbird-service-posthog 2.1.0 → 2.3.0

package/dist/{chunk-SCY2VOTE.js → chunk-NCOO3LKB.js}

@@ -5,7 +5,7 @@ import {
   parseDuration,
   resolveAdminPrefix,
   specsFromState
-} from "./chunk-VZ3ZHVNW.js";
+} from "./chunk-DBFEFLR4.js";
 
 // ../../adapters/node/dist/cli.js
 import { readFile as readFile2 } from "node:fs/promises";
@@ -844,4 +844,4 @@ export {
   createServer2 as createServer,
   serveTarget
 };
-//# sourceMappingURL=chunk-SCY2VOTE.js.map
+//# sourceMappingURL=chunk-NCOO3LKB.js.map

package/dist/cli.js

@@ -3,8 +3,8 @@ import {
   runCli,
   serveCommand,
   serveTarget
-} from "./chunk-SCY2VOTE.js";
-import "./chunk-VZ3ZHVNW.js";
+} from "./chunk-NCOO3LKB.js";
+import "./chunk-DBFEFLR4.js";
 
 // src/cli.ts
 var code = await runCli(

package/dist/index.d.ts

@@ -29,6 +29,8 @@ type FlagRecord = {
     /** JSON string sent as `metadata.payload` when the flag is enabled. */
     payload: string | null;
     overrides: FlagOverride[];
+    /** Original management filters; evaluation still uses the deterministic model. */
+    filters?: Record<string, unknown>;
     version: number;
     created_at: string;
     updated_at: string;
@@ -52,6 +54,7 @@ declare const evaluateFlag: (flag: FlagRecord, subject: FlagSubject) => Evaluati
 declare const payloadString: (payload: unknown) => string | null;
 /** Body of `PUT /__admin/flags/:key`, validated. */
 type FlagSpec = {
+    filters?: Record<string, unknown>;
     name?: string;
     active?: boolean;
     default: FlagValue | null;
@@ -71,36 +74,6 @@ interface FetchAPI$1 {
     fetch(request: Request): Promise<Response>;
 }
 
-/**
- * The single source of time for a service.
- *
- * Every timestamp a mock writes reads from here, so a suite moves time instead of
- * sleeping: appointment windows, result delays and expiries become reachable in
- * milliseconds. A frozen clock also makes timestamps reproducible from a seed.
- */
-type ClockState = {
-    /** Current epoch milliseconds. */
-    now: number;
-    /** True while time does not advance on its own. */
-    frozen: boolean;
-    /** Milliseconds this clock adds to its underlying source. */
-    offsetMs: number;
-};
-type Clock = {
-    now(): number;
-    /** Pin the clock to an exact instant, keeping it frozen if it already was. */
-    set(epochMs: number): void;
-    /** Move the clock forward, or back with a negative delta. */
-    advance(deltaMs: number): void;
-    /** Stop time at the current instant. */
-    freeze(): void;
-    /** Resume from the current instant. */
-    unfreeze(): void;
-    /** Drop back to the underlying source, live. */
-    reset(): void;
-    state(): ClockState;
-};
-
 /** Bind values accepted by Mockingbird's SQLite port (matches sqlite-mem / better-sqlite3). */
 type SqliteValue$1 = null | number | bigint | string | Uint8Array | boolean;
 /** Mutation counters returned by {@link SqliteStatement.run}. */
@@ -172,6 +145,151 @@ declare class Collection<T> {
     }>;
 }
 
+/**
+ * Sequential id source persisted in SQLite. Ids are deterministic for a given
+ * sequence history (`cus_` + 14 opaque chars), so reproductions stay stable.
+ */
+declare class IdSequence {
+    private readonly sqlite;
+    private readonly namespace;
+    private readonly salt;
+    constructor(sqlite: SqliteClient$1, namespace: string, salt?: string);
+    next(prefix: string, length?: number): string;
+}
+
+/** A stable identifier for a point in a {@link Timeline}. */
+type CheckpointId = string;
+/** An immutable node in a timeline's checkpoint DAG. */
+type Checkpoint<T> = Readonly<{
+    id: CheckpointId;
+    branch: string;
+    parent: CheckpointId | null;
+    /** Logical time supplied by the timeline's injected clock. */
+    at: number;
+    value: T;
+}>;
+type TimelineOptions = {
+    /** Logical clock used to stamp checkpoints. Defaults to a deterministic counter. */
+    now?: () => number;
+    /** Maximum retained checkpoints. Branch heads are never collected. Default 1,000. */
+    maxCheckpoints?: number;
+    /** Customize deterministic checkpoint IDs. */
+    id?: (sequence: number) => CheckpointId;
+};
+type CommitOptions = {
+    branch?: string;
+    /** Parent checkpoint. Defaults to the selected branch's current head. */
+    parent?: CheckpointId | null;
+};
+type ForkOptions = {
+    /** Checkpoint to fork from. Defaults to the main branch's head. */
+    from?: CheckpointId;
+};
+/**
+ * Small, storage-agnostic checkpoint DAG shared by service runtimes. Its values may be immutable
+ * records, namespace images, or copy-on-write SQL engine snapshots.
+ *
+ * Values are retained by reference. Engines can therefore use persistent/COW snapshots while
+ * simpler services can use immutable values. IDs and GC order are deterministic, and all IO
+ * (the logical clock) is injected.
+ */
+declare class Timeline<T> {
+    readonly maxCheckpoints: number;
+    private readonly now;
+    private readonly makeId;
+    private readonly nodes;
+    private readonly heads;
+    /** Unreferenced nodes in the exact order they became collectible. */
+    private readonly evictable;
+    /** Branch heads plus explicit retainers. Absent means zero. */
+    private readonly references;
+    private readonly explicitPins;
+    private sequence;
+    constructor(options?: TimelineOptions);
+    /** Capture a new immutable value and move `branch` to it. */
+    commit(value: T, options?: CommitOptions): Checkpoint<T>;
+    /** Create a branch pointer without copying its checkpoint value. */
+    fork(branch: string, options?: ForkOptions): Checkpoint<T> | undefined;
+    /** Move a branch pointer to an existing checkpoint. */
+    checkout(branch: string, id: CheckpointId): Checkpoint<T>;
+    get(id: CheckpointId): Checkpoint<T>;
+    head(branch?: string): Checkpoint<T> | undefined;
+    hasBranch(branch: string): boolean;
+    branches(): Readonly<Record<string, CheckpointId>>;
+    checkpoints(): readonly Checkpoint<T>[];
+    /** Number of retained checkpoints without allocating an array. */
+    get size(): number;
+    /** Pin a checkpoint independently of branch heads (used by compatibility snapshot handles). */
+    retain(id: CheckpointId): Checkpoint<T>;
+    /** Release one explicit pin. Branch heads remain pinned until moved or deleted. */
+    release(id: CheckpointId): boolean;
+    deleteBranch(branch: string): boolean;
+    /**
+     * Deterministically discard oldest unpinned checkpoints. Collection is O(number removed):
+     * commits never scan pinned nodes or the retained history. Parents are metadata rather than a
+     * storage dependency, so a retained node remains usable after pruning.
+     */
+    gc(max?: number): CheckpointId[];
+    private collect;
+    private moveHead;
+    private addReference;
+    private removeReference;
+    private assertBranch;
+}
+
+/**
+ * Anything that can answer a Fetch `Request` with a `Response`.
+ *
+ * Every Mockingbird service implements this, and every runtime adapter consumes it.
+ * It is the only contract shared across the whole graph.
+ */
+interface FetchAPI {
+    fetch(request: Request): Promise<Response>;
+}
+
+/** Options every provider constructor accepts. */
+type APIOptions = {
+    /** Sync SQLite client. Defaults to `@crvouga/mockingbird-service-sqlite`. */
+    sqlite?: SqliteClient$1;
+    /** Clock used for `created`-style fields. Default `Date.now`. */
+    now?: () => number;
+    /**
+     * Storage namespace for this instance's records. Instances sharing one SQLite
+     * client stay isolated when their namespaces differ. Defaults to the service name.
+     */
+    namespace?: string;
+};
+
+/**
+ * The single source of time for a service.
+ *
+ * Every timestamp a mock writes reads from here, so a suite moves time instead of
+ * sleeping: appointment windows, result delays and expiries become reachable in
+ * milliseconds. A frozen clock also makes timestamps reproducible from a seed.
+ */
+type ClockState = {
+    /** Current epoch milliseconds. */
+    now: number;
+    /** True while time does not advance on its own. */
+    frozen: boolean;
+    /** Milliseconds this clock adds to its underlying source. */
+    offsetMs: number;
+};
+type Clock = {
+    now(): number;
+    /** Pin the clock to an exact instant, keeping it frozen if it already was. */
+    set(epochMs: number): void;
+    /** Move the clock forward, or back with a negative delta. */
+    advance(deltaMs: number): void;
+    /** Stop time at the current instant. */
+    freeze(): void;
+    /** Resume from the current instant. */
+    unfreeze(): void;
+    /** Drop back to the underlying source, live. */
+    reset(): void;
+    state(): ClockState;
+};
+
 /**
  * Seeded pseudo-random numbers, so anything a mock invents — ids, jitter, which
  * request a percentage fault hits — is reproducible from a seed.
@@ -312,109 +430,6 @@ type FaultRegistry = {
     take(candidate: FaultCandidate): Promise<FaultHit[]>;
 };
 
-/** A stable identifier for a point in a {@link Timeline}. */
-type CheckpointId = string;
-/** An immutable node in a timeline's checkpoint DAG. */
-type Checkpoint<T> = Readonly<{
-    id: CheckpointId;
-    branch: string;
-    parent: CheckpointId | null;
-    /** Logical time supplied by the timeline's injected clock. */
-    at: number;
-    value: T;
-}>;
-type TimelineOptions = {
-    /** Logical clock used to stamp checkpoints. Defaults to a deterministic counter. */
-    now?: () => number;
-    /** Maximum retained checkpoints. Branch heads are never collected. Default 1,000. */
-    maxCheckpoints?: number;
-    /** Customize deterministic checkpoint IDs. */
-    id?: (sequence: number) => CheckpointId;
-};
-type CommitOptions = {
-    branch?: string;
-    /** Parent checkpoint. Defaults to the selected branch's current head. */
-    parent?: CheckpointId | null;
-};
-type ForkOptions = {
-    /** Checkpoint to fork from. Defaults to the main branch's head. */
-    from?: CheckpointId;
-};
-/**
- * Small, storage-agnostic checkpoint DAG shared by service runtimes. Its values may be immutable
- * records, namespace images, or copy-on-write SQL engine snapshots.
- *
- * Values are retained by reference. Engines can therefore use persistent/COW snapshots while
- * simpler services can use immutable values. IDs and GC order are deterministic, and all IO
- * (the logical clock) is injected.
- */
-declare class Timeline<T> {
-    readonly maxCheckpoints: number;
-    private readonly now;
-    private readonly makeId;
-    private readonly nodes;
-    private readonly heads;
-    /** Unreferenced nodes in the exact order they became collectible. */
-    private readonly evictable;
-    /** Branch heads plus explicit retainers. Absent means zero. */
-    private readonly references;
-    private readonly explicitPins;
-    private sequence;
-    constructor(options?: TimelineOptions);
-    /** Capture a new immutable value and move `branch` to it. */
-    commit(value: T, options?: CommitOptions): Checkpoint<T>;
-    /** Create a branch pointer without copying its checkpoint value. */
-    fork(branch: string, options?: ForkOptions): Checkpoint<T> | undefined;
-    /** Move a branch pointer to an existing checkpoint. */
-    checkout(branch: string, id: CheckpointId): Checkpoint<T>;
-    get(id: CheckpointId): Checkpoint<T>;
-    head(branch?: string): Checkpoint<T> | undefined;
-    hasBranch(branch: string): boolean;
-    branches(): Readonly<Record<string, CheckpointId>>;
-    checkpoints(): readonly Checkpoint<T>[];
-    /** Number of retained checkpoints without allocating an array. */
-    get size(): number;
-    /** Pin a checkpoint independently of branch heads (used by compatibility snapshot handles). */
-    retain(id: CheckpointId): Checkpoint<T>;
-    /** Release one explicit pin. Branch heads remain pinned until moved or deleted. */
-    release(id: CheckpointId): boolean;
-    deleteBranch(branch: string): boolean;
-    /**
-     * Deterministically discard oldest unpinned checkpoints. Collection is O(number removed):
-     * commits never scan pinned nodes or the retained history. Parents are metadata rather than a
-     * storage dependency, so a retained node remains usable after pruning.
-     */
-    gc(max?: number): CheckpointId[];
-    private collect;
-    private moveHead;
-    private addReference;
-    private removeReference;
-    private assertBranch;
-}
-
-/**
- * Anything that can answer a Fetch `Request` with a `Response`.
- *
- * Every Mockingbird service implements this, and every runtime adapter consumes it.
- * It is the only contract shared across the whole graph.
- */
-interface FetchAPI {
-    fetch(request: Request): Promise<Response>;
-}
-
-/** Options every provider constructor accepts. */
-type APIOptions = {
-    /** Sync SQLite client. Defaults to `@crvouga/mockingbird-service-sqlite`. */
-    sqlite?: SqliteClient$1;
-    /** Clock used for `created`-style fields. Default `Date.now`. */
-    now?: () => number;
-    /**
-     * Storage namespace for this instance's records. Instances sharing one SQLite
-     * client stay isolated when their namespaces differ. Defaults to the service name.
-     */
-    namespace?: string;
-};
-
 /**
  * One problem with a request body, at a dotted path (`patient.address.city`, `items.0.sku`).
  * `kind` is `media_type` when the body is present but its media type is not one the operation
@@ -456,6 +471,10 @@ type RequestLog = {
     ids?: Record<string, string>;
     /** Set when the service created a resource the request referred to but that did not exist. */
     adopted?: boolean;
+    /** Explicit durable acceptance, independent of response delivery. */
+    accepted?: boolean;
+    /** Checkpoint captured at explicit acceptance. */
+    checkpoint?: string;
     /** Set on a rejection (status ≥ 400) the mock produced itself, never on a scripted fault. */
     request?: RejectedRequest;
     /** The validation issues behind a rejection, when the service found any. */
@@ -519,18 +538,6 @@ type CredentialRegistry = {
     }[];
 };
 
-/**
- * Sequential id source persisted in SQLite. Ids are deterministic for a given
- * sequence history (`cus_` + 14 opaque chars), so reproductions stay stable.
- */
-declare class IdSequence {
-    private readonly sqlite;
-    private readonly namespace;
-    private readonly salt;
-    constructor(sqlite: SqliteClient$1, namespace: string, salt?: string);
-    next(prefix: string, length?: number): string;
-}
-
 /**
  * A point-in-time copy of everything a service namespace holds.
  *
@@ -788,10 +795,24 @@ type Settings = {
     /** Session-recording posts to `/s/`, counted and discarded. */
     recordings: number;
 };
+type ExperimentRecord = {
+    id: number;
+    projectId: string;
+    name: string;
+    feature_flag_key: string;
+    parameters: Record<string, unknown>;
+    metrics: unknown[];
+    start_date: string | null;
+    end_date: string | null;
+    archived: boolean;
+    created_at: string;
+    updated_at: string;
+};
 declare class PostHogState {
     private readonly seed;
     private readonly now;
     readonly flags: Collection<FlagRecord>;
+    readonly experiments: Collection<ExperimentRecord>;
     readonly events: Collection<CapturedEvent>;
     readonly settings: Collection<Settings>;
     readonly ids: IdSequence;
@@ -1029,10 +1050,10 @@ type OpenAPIDocument = {
 };
 
 declare const document: OpenAPIDocument;
-type OperationId = "EvaluateFlags" | "Decide" | "GetRemoteConfig" | "GetRemoteConfigScript" | "CaptureBatch" | "CaptureEvent" | "CaptureEventV0" | "CaptureRecording" | "GetRecorderScript" | "GetVersionedRecorderScript" | "ListSurveys" | "ListWebExperiments" | "ListFeatureFlags" | "CreateFeatureFlag" | "UpdateFeatureFlag" | "RunQuery";
-type SupportedOperationId = "EvaluateFlags" | "Decide" | "GetRemoteConfig" | "GetRemoteConfigScript" | "CaptureBatch" | "CaptureEvent" | "CaptureEventV0" | "CaptureRecording" | "GetRecorderScript" | "GetVersionedRecorderScript" | "ListSurveys" | "ListWebExperiments" | "ListFeatureFlags" | "CreateFeatureFlag" | "UpdateFeatureFlag" | "RunQuery";
-declare const operationIds: readonly ["EvaluateFlags", "Decide", "GetRemoteConfig", "GetRemoteConfigScript", "CaptureBatch", "CaptureEvent", "CaptureEventV0", "CaptureRecording", "GetRecorderScript", "GetVersionedRecorderScript", "ListSurveys", "ListWebExperiments", "ListFeatureFlags", "CreateFeatureFlag", "UpdateFeatureFlag", "RunQuery"];
-declare const supportedOperationIds: readonly ["EvaluateFlags", "Decide", "GetRemoteConfig", "GetRemoteConfigScript", "CaptureBatch", "CaptureEvent", "CaptureEventV0", "CaptureRecording", "GetRecorderScript", "GetVersionedRecorderScript", "ListSurveys", "ListWebExperiments", "ListFeatureFlags", "CreateFeatureFlag", "UpdateFeatureFlag", "RunQuery"];
+type OperationId = "EvaluateFlags" | "Decide" | "GetRemoteConfig" | "GetRemoteConfigScript" | "CaptureBatch" | "CaptureEvent" | "CaptureEventV0" | "CaptureRecording" | "GetRecorderScript" | "GetVersionedRecorderScript" | "ListSurveys" | "ListWebExperiments" | "ListFeatureFlags" | "CreateFeatureFlag" | "GetFeatureFlag" | "UpdateFeatureFlag" | "ListExperiments" | "CreateExperiment" | "GetExperiment" | "UpdateExperiment" | "RunQuery";
+type SupportedOperationId = "EvaluateFlags" | "Decide" | "GetRemoteConfig" | "GetRemoteConfigScript" | "CaptureBatch" | "CaptureEvent" | "CaptureEventV0" | "CaptureRecording" | "GetRecorderScript" | "GetVersionedRecorderScript" | "ListSurveys" | "ListWebExperiments" | "ListFeatureFlags" | "CreateFeatureFlag" | "GetFeatureFlag" | "UpdateFeatureFlag" | "ListExperiments" | "CreateExperiment" | "GetExperiment" | "UpdateExperiment" | "RunQuery";
+declare const operationIds: readonly ["EvaluateFlags", "Decide", "GetRemoteConfig", "GetRemoteConfigScript", "CaptureBatch", "CaptureEvent", "CaptureEventV0", "CaptureRecording", "GetRecorderScript", "GetVersionedRecorderScript", "ListSurveys", "ListWebExperiments", "ListFeatureFlags", "CreateFeatureFlag", "GetFeatureFlag", "UpdateFeatureFlag", "ListExperiments", "CreateExperiment", "GetExperiment", "UpdateExperiment", "RunQuery"];
+declare const supportedOperationIds: readonly ["EvaluateFlags", "Decide", "GetRemoteConfig", "GetRemoteConfigScript", "CaptureBatch", "CaptureEvent", "CaptureEventV0", "CaptureRecording", "GetRecorderScript", "GetVersionedRecorderScript", "ListSurveys", "ListWebExperiments", "ListFeatureFlags", "CreateFeatureFlag", "GetFeatureFlag", "UpdateFeatureFlag", "ListExperiments", "CreateExperiment", "GetExperiment", "UpdateExperiment", "RunQuery"];
 
 /**
  * Every named PostHog misbehaviour our consumers branch on, switched on with
@@ -1064,6 +1085,7 @@ declare const createRuntime: (options?: PostHogRuntimeOptions) => PostHogRuntime
 
 declare const POSTHOG_NAMESPACE = "posthog";
 type PostHogAPIOptions = APIOptions & {
+    adminPrefix?: string;
     /** Flags every namespace starts with (and returns to on reset), keyed by flag key. */
     flags?: Record<string, FlagSpec>;
     /** Initial per-namespace settings (session recording, canned HogQL results). */
@@ -1131,4 +1153,4 @@ declare class PostHogAPI implements FetchAPI$1 {
 }
 
 export { ACME_FLAG_STATE, POSTHOG_NAMESPACE, POSTHOG_PRESETS, PostHogAPI, createRuntime, decodePostHogBody, document, evaluateFlag, operationIds, parseFlagSpec, payloadString, scrubProperties, specsFromState, supportedOperationIds, tokenFromBody, valueForState };
-export type { CapturedEvent, Evaluation, EventQuery, FetchAPI$1 as FetchAPI, FlagOverride, FlagRecord, FlagSpec, FlagStateFile, FlagSubject, FlagValue, ImportOptions, OperationId, PostHogAPIOptions, PostHogRuntime, PostHogRuntimeOptions, QueryResult, Settings, SqliteClient, SupportedOperationId };
+export type { CapturedEvent, Evaluation, EventQuery, ExperimentRecord, FetchAPI$1 as FetchAPI, FlagOverride, FlagRecord, FlagSpec, FlagStateFile, FlagSubject, FlagValue, ImportOptions, OperationId, PostHogAPIOptions, PostHogRuntime, PostHogRuntimeOptions, QueryResult, Settings, SqliteClient, SupportedOperationId };

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   supportedOperationIds,
   tokenFromBody,
   valueForState
-} from "./chunk-VZ3ZHVNW.js";
+} from "./chunk-DBFEFLR4.js";
 export {
   ACME_FLAG_STATE,
   POSTHOG_NAMESPACE,