@crvouga/mockingbird-service-posthog 2.1.0 → 2.2.0

package/dist/cli.js

@@ -3,8 +3,8 @@ import {
   runCli,
   serveCommand,
   serveTarget
-} from "./chunk-SCY2VOTE.js";
-import "./chunk-VZ3ZHVNW.js";
+} from "./chunk-DSIEW2HP.js";
+import "./chunk-SOC56HS3.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;
@@ -788,10 +791,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 +1046,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 +1081,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 +1149,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-SOC56HS3.js";
 export {
   ACME_FLAG_STATE,
   POSTHOG_NAMESPACE,

package/dist/server.d.ts

@@ -1314,6 +1314,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;
@@ -1333,6 +1335,7 @@ type Evaluation = {
 };
 /** Body of `PUT /__admin/flags/:key`, validated. */
 type FlagSpec = {
+    filters?: Record<string, unknown>;
     name?: string;
     active?: boolean;
     default: FlagValue | null;
@@ -1384,10 +1387,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;
@@ -1410,6 +1427,7 @@ declare class PostHogState {
 }
 
 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). */

package/dist/server.js

@@ -2,8 +2,8 @@ import {
   DEFAULT_PORT,
   createServer,
   serveTarget
-} from "./chunk-SCY2VOTE.js";
-import "./chunk-VZ3ZHVNW.js";
+} from "./chunk-DSIEW2HP.js";
+import "./chunk-SOC56HS3.js";
 export {
   DEFAULT_PORT,
   createServer,

package/openapi.yaml

@@ -5,7 +5,7 @@ info:
     Stateful mock subset of PostHog: remote flag evaluation (`/flags` v2 and the legacy
     `/decide` shape), remote config, event capture (`/batch/`, `/e/`, `/i/v0/e/`), session
     recording intake, the posthog-js asset and survey endpoints, and the slice of the
-    management API our tooling and crons call (feature-flag list/create/patch, HogQL query).
+    management API our tooling and crons call (feature-flag list/create/read/patch, experiment management, HogQL query).
     Hand-authored from the wire shapes of posthog-node 5.52.2 / @posthog/core 1.54.0,
     posthog-js 1.433.2 and our own raw fetches.
 
@@ -498,6 +498,21 @@ paths:
           x-mockingbird-resource-ref:
             type: feature_flag
             missing: "999999"
+    get:
+      operationId: GetFeatureFlag
+      security:
+        - bearerAuth: []
+      x-mockingbird:
+        supported: true
+        parity: { enabled: true, safe: true }
+      responses:
+        "200":
+          description: Current flag by numeric id (or mock key alias)
+          content:
+            application/json:
+              schema: { $ref: "#/components/schemas/FeatureFlag" }
+        "401": { $ref: "#/components/responses/ManagementError" }
+        "404": { $ref: "#/components/responses/ManagementError" }
     patch:
       operationId: UpdateFeatureFlag
       security:
@@ -538,6 +553,115 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/ErrorBody"
+  /api/projects/{projectId}/experiments:
+    parameters:
+      - $ref: "#/components/parameters/ProjectId"
+    get:
+      operationId: ListExperiments
+      security:
+        - bearerAuth: []
+      x-mockingbird:
+        supported: true
+        parity: { enabled: true, safe: true }
+      parameters:
+        - name: limit
+          in: query
+          schema: { type: integer, minimum: 1, maximum: 100, default: 100 }
+        - name: offset
+          in: query
+          schema: { type: integer, minimum: 0, maximum: 1000, default: 0 }
+      responses:
+        "200":
+          description: Newest experiments first, with limit/offset links
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [count, next, previous, results]
+                properties:
+                  count: { type: integer }
+                  next:
+                    type: [string, "null"]
+                    x-mockingbird-volatile: { kind: url }
+                  previous:
+                    type: [string, "null"]
+                    x-mockingbird-volatile: { kind: url }
+                  results:
+                    type: array
+                    items: { $ref: "#/components/schemas/Experiment" }
+        "400": { $ref: "#/components/responses/ManagementError" }
+        "401": { $ref: "#/components/responses/ManagementError" }
+    post:
+      operationId: CreateExperiment
+      security:
+        - bearerAuth: []
+      x-mockingbird:
+        supported: true
+        parity: { enabled: true, safe: false }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              allOf:
+                - $ref: "#/components/schemas/ExperimentWrite"
+                - type: object
+                  required: [name, feature_flag_key]
+                  properties:
+                    feature_flag_key: { type: string, pattern: "^[A-Za-z0-9_-]{1,64}$" }
+      responses:
+        "201":
+          description: Experiment with a linked flag; new draft flags are inactive
+          content:
+            application/json:
+              schema: { $ref: "#/components/schemas/Experiment" }
+        "400": { $ref: "#/components/responses/ManagementError" }
+        "401": { $ref: "#/components/responses/ManagementError" }
+  /api/projects/{projectId}/experiments/{experimentId}:
+    parameters:
+      - $ref: "#/components/parameters/ProjectId"
+      - name: experimentId
+        in: path
+        required: true
+        schema:
+          type: string
+          pattern: "^[0-9]{1,6}$"
+    get:
+      operationId: GetExperiment
+      security:
+        - bearerAuth: []
+      x-mockingbird:
+        supported: true
+        parity: { enabled: true, safe: true }
+      responses:
+        "200":
+          description: Persisted experiment with the current linked flag
+          content:
+            application/json:
+              schema: { $ref: "#/components/schemas/Experiment" }
+        "401": { $ref: "#/components/responses/ManagementError" }
+        "404": { $ref: "#/components/responses/ManagementError" }
+    patch:
+      operationId: UpdateExperiment
+      security:
+        - bearerAuth: []
+      x-mockingbird:
+        supported: true
+        parity: { enabled: true, safe: false }
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema: { $ref: "#/components/schemas/ExperimentWrite" }
+      responses:
+        "200":
+          description: Only provided fields change; setting start_date activates a draft's flag
+          content:
+            application/json:
+              schema: { $ref: "#/components/schemas/Experiment" }
+        "400": { $ref: "#/components/responses/ManagementError" }
+        "401": { $ref: "#/components/responses/ManagementError" }
+        "404": { $ref: "#/components/responses/ManagementError" }
   /api/projects/{projectId}/query:
     parameters:
       - $ref: "#/components/parameters/ProjectId"
@@ -579,6 +703,12 @@ paths:
               schema:
                 $ref: "#/components/schemas/ErrorBody"
 components:
+  responses:
+    ManagementError:
+      description: Management API error
+      content:
+        application/json:
+          schema: { $ref: "#/components/schemas/ErrorBody" }
   securitySchemes:
     bearerAuth:
       type: http
@@ -620,6 +750,43 @@ components:
         minimum: 1
         maximum: 999999999
   schemas:
+    ExperimentWrite:
+      type: object
+      properties:
+        name: { type: string, minLength: 1, maxLength: 120 }
+        parameters: { type: object }
+        metrics:
+          type: array
+          maxItems: 5
+          items: { type: object }
+        start_date: { type: [string, "null"], format: date-time }
+        end_date: { type: [string, "null"], format: date-time }
+        archived: { type: boolean }
+    Experiment:
+      type: object
+      required: [id, name, feature_flag_key, feature_flag, parameters, metrics, start_date, end_date, archived, created_at, updated_at]
+      properties:
+        id:
+          type: integer
+        name: { type: string }
+        feature_flag_key: { type: string }
+        feature_flag:
+          oneOf:
+            - $ref: "#/components/schemas/FeatureFlag"
+            - type: "null"
+        parameters: { type: object }
+        metrics:
+          type: array
+          items: { type: object }
+        start_date: { type: [string, "null"] }
+        end_date: { type: [string, "null"] }
+        archived: { type: boolean }
+        created_at:
+          type: string
+          x-mockingbird-volatile: { kind: timestamp }
+        updated_at:
+          type: string
+          x-mockingbird-volatile: { kind: timestamp }
     ErrorBody:
       type: object
       required: [type, code, detail]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crvouga/mockingbird-service-posthog",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Stateful mock of PostHog: /flags v2 and legacy /decide evaluation with per-test flag, variant and payload control, remote config, gzip/base64 capture (/batch/, /e/, /i/v0/e/), recordings intake, and the feature-flag management and HogQL API slice.",
   "license": "MIT",
   "type": "module",