@crvouga/mockingbird-service-posthog 1.3.0 → 1.4.0

package/dist/cli.js

@@ -3,8 +3,8 @@ import {
   runCli,
   serveCommand,
   serveTarget
-} from "./chunk-2W4NW7AB.js";
-import "./chunk-2FGITTBR.js";
+} from "./chunk-BLA3BJC5.js";
+import "./chunk-UJEAOIXF.js";
 
 // src/cli.ts
 var code = await runCli(

package/dist/index.d.ts

@@ -147,9 +147,15 @@ type ListRecordsOptions<T> = {
  */
 declare class Collection<T> {
     private readonly sqlite;
-    private readonly namespace;
-    private readonly name;
-    constructor(sqlite: SqliteClient$1, namespace: string, name: string);
+    /** Storage namespace. Admin introspection uses this to ignore another namespace's tables. */
+    readonly namespace: string;
+    /** Table name inside the namespace. Stable across resets of the rows themselves. */
+    readonly collectionName: string;
+    constructor(sqlite: SqliteClient$1, 
+    /** Storage namespace. Admin introspection uses this to ignore another namespace's tables. */
+    namespace: string, 
+    /** Table name inside the namespace. Stable across resets of the rows themselves. */
+    collectionName: string);
     private bumpCollectionSeq;
     nextSequence(): number;
     get(id: string): T | undefined;
@@ -530,6 +536,36 @@ type NamespaceSnapshot = {
     }[];
 };
 
+declare const STATE_FIELD_KINDS: readonly ["string", "number", "boolean", "null", "object", "array", "unknown"];
+type StateFieldKind = (typeof STATE_FIELD_KINDS)[number];
+/** JSON-safe annotations a bespoke admin UI may read. The default UI shows them as text. */
+type StateMeta = Readonly<Record<string, string | number | boolean | null>>;
+type StateField = {
+    name: string;
+    kind: StateFieldKind;
+    optional: boolean;
+    description?: string;
+    /** One level of nested object fields. */
+    fields?: StateField[];
+    meta?: StateMeta;
+};
+type StateCollectionView = {
+    name: string;
+    label: string;
+    description?: string;
+    count: number;
+    /** `mixed` when a declaration and stored rows both contribute fields. */
+    source: "declared" | "inferred" | "mixed";
+    fields: StateField[];
+    meta?: StateMeta;
+};
+/** The shape of one namespace, for an admin UI that has never seen the service before. */
+type StateView = {
+    namespace: string;
+    storageNamespace: string;
+    collections: StateCollectionView[];
+};
+
 type WebhookEndpoint = {
     /** Stable id; generated when omitted. */
     id?: string;
@@ -656,6 +692,8 @@ type ServiceRuntime<T extends ServiceInstance> = FetchAPI & {
     }): void;
     /** Inspect the retained history for a namespace. */
     timeline(namespace?: string): Timeline<ServiceTimelineState>;
+    /** Collections in one namespace: declared shape plus what the rows actually hold. */
+    state(namespace?: string): StateView;
 };
 
 /** Bind values accepted by Mockingbird's SQLite port (matches sqlite-mem / better-sqlite3). */

package/dist/index.js

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

package/dist/server.d.ts

@@ -386,6 +386,36 @@ type NamespaceSnapshot$1 = {
     }[];
 };
 
+declare const STATE_FIELD_KINDS$1: readonly ["string", "number", "boolean", "null", "object", "array", "unknown"];
+type StateFieldKind$1 = (typeof STATE_FIELD_KINDS$1)[number];
+/** JSON-safe annotations a bespoke admin UI may read. The default UI shows them as text. */
+type StateMeta$1 = Readonly<Record<string, string | number | boolean | null>>;
+type StateField$1 = {
+    name: string;
+    kind: StateFieldKind$1;
+    optional: boolean;
+    description?: string;
+    /** One level of nested object fields. */
+    fields?: StateField$1[];
+    meta?: StateMeta$1;
+};
+type StateCollectionView$1 = {
+    name: string;
+    label: string;
+    description?: string;
+    count: number;
+    /** `mixed` when a declaration and stored rows both contribute fields. */
+    source: "declared" | "inferred" | "mixed";
+    fields: StateField$1[];
+    meta?: StateMeta$1;
+};
+/** The shape of one namespace, for an admin UI that has never seen the service before. */
+type StateView$1 = {
+    namespace: string;
+    storageNamespace: string;
+    collections: StateCollectionView$1[];
+};
+
 type WebhookEndpoint$1 = {
     /** Stable id; generated when omitted. */
     id?: string;
@@ -512,6 +542,8 @@ type ServiceRuntime$1<T extends ServiceInstance$1> = FetchAPI$2 & {
     }): void;
     /** Inspect the retained history for a namespace. */
     timeline(namespace?: string): Timeline$1<ServiceTimelineState$1>;
+    /** Collections in one namespace: declared shape plus what the rows actually hold. */
+    state(namespace?: string): StateView$1;
 };
 
 type CliOption = {
@@ -627,9 +659,15 @@ type ListRecordsOptions<T> = {
  */
 declare class Collection<T> {
     private readonly sqlite;
-    private readonly namespace;
-    private readonly name;
-    constructor(sqlite: SqliteClient$1, namespace: string, name: string);
+    /** Storage namespace. Admin introspection uses this to ignore another namespace's tables. */
+    readonly namespace: string;
+    /** Table name inside the namespace. Stable across resets of the rows themselves. */
+    readonly collectionName: string;
+    constructor(sqlite: SqliteClient$1, 
+    /** Storage namespace. Admin introspection uses this to ignore another namespace's tables. */
+    namespace: string, 
+    /** Table name inside the namespace. Stable across resets of the rows themselves. */
+    collectionName: string);
     private bumpCollectionSeq;
     nextSequence(): number;
     get(id: string): T | undefined;
@@ -997,6 +1035,36 @@ type NamespaceSnapshot = {
     }[];
 };
 
+declare const STATE_FIELD_KINDS: readonly ["string", "number", "boolean", "null", "object", "array", "unknown"];
+type StateFieldKind = (typeof STATE_FIELD_KINDS)[number];
+/** JSON-safe annotations a bespoke admin UI may read. The default UI shows them as text. */
+type StateMeta = Readonly<Record<string, string | number | boolean | null>>;
+type StateField = {
+    name: string;
+    kind: StateFieldKind;
+    optional: boolean;
+    description?: string;
+    /** One level of nested object fields. */
+    fields?: StateField[];
+    meta?: StateMeta;
+};
+type StateCollectionView = {
+    name: string;
+    label: string;
+    description?: string;
+    count: number;
+    /** `mixed` when a declaration and stored rows both contribute fields. */
+    source: "declared" | "inferred" | "mixed";
+    fields: StateField[];
+    meta?: StateMeta;
+};
+/** The shape of one namespace, for an admin UI that has never seen the service before. */
+type StateView = {
+    namespace: string;
+    storageNamespace: string;
+    collections: StateCollectionView[];
+};
+
 type WebhookEndpoint = {
     /** Stable id; generated when omitted. */
     id?: string;
@@ -1123,6 +1191,8 @@ type ServiceRuntime<T extends ServiceInstance> = FetchAPI$1 & {
     }): void;
     /** Inspect the retained history for a namespace. */
     timeline(namespace?: string): Timeline<ServiceTimelineState>;
+    /** Collections in one namespace: declared shape plus what the rows actually hold. */
+    state(namespace?: string): StateView;
 };
 
 /** Bind values accepted by Mockingbird's SQLite port (matches sqlite-mem / better-sqlite3). */

package/dist/server.js

@@ -2,8 +2,8 @@ import {
   DEFAULT_PORT,
   createServer,
   serveTarget
-} from "./chunk-2W4NW7AB.js";
-import "./chunk-2FGITTBR.js";
+} from "./chunk-BLA3BJC5.js";
+import "./chunk-UJEAOIXF.js";
 export {
   DEFAULT_PORT,
   createServer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crvouga/mockingbird-service-posthog",
-  "version": "1.3.0",
+  "version": "1.4.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",