@crvouga/mockingbird-service-flex 1.2.0 → 1.4.0

package/dist/cli.js

@@ -3,8 +3,8 @@ import {
   runCli,
   serveCommand,
   serveTarget
-} from "./chunk-KNQ2MP6O.js";
-import "./chunk-UQWTCFIV.js";
+} from "./chunk-BQA5UCJS.js";
+import "./chunk-UKBUYHZN.js";
 
 // src/cli.ts
 var code = await runCli(

package/dist/index.d.ts

@@ -86,9 +86,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;
@@ -469,6 +475,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;
@@ -595,6 +631,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

@@ -20,7 +20,7 @@ import {
   periodEnd,
   substituteSessionId,
   supportedOperationIds
-} from "./chunk-UQWTCFIV.js";
+} from "./chunk-UKBUYHZN.js";
 export {
   CARDS,
   CORPUS_ROWS,

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-KNQ2MP6O.js";
-import "./chunk-UQWTCFIV.js";
+} from "./chunk-BQA5UCJS.js";
+import "./chunk-UKBUYHZN.js";
 export {
   DEFAULT_PORT,
   createServer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crvouga/mockingbird-service-flex",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Stateful mock of the Flex HSA/FSA payments API: products (recorded catalog corpus), checkout sessions in payment, subscription, off-session and setup modes, subscriptions, customers, setup intents, refunds, the hosted checkout page, and Svix-signed webhooks.",
   "license": "MIT",
   "type": "module",
@@ -80,7 +80,7 @@
     "pack:check": "bun ../../../scripts/pack-check.ts"
   },
   "dependencies": {
-    "@crvouga/mockingbird-service-sqlite": "1.0.0",
+    "@crvouga/mockingbird-service-sqlite": "1.1.0",
     "hono": "4.11.9"
   },
   "devDependencies": {