@crvouga/mockingbird-service-payload-cms 1.3.0 → 1.5.0

package/dist/cli.js

@@ -3,8 +3,8 @@ import {
   runCli,
   serveCommand,
   serveTarget
-} from "./chunk-VQD2J3NH.js";
-import "./chunk-BB273WDT.js";
+} from "./chunk-3OUYZQTC.js";
+import "./chunk-7HS4CTPK.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;
@@ -457,6 +463,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;
@@ -583,6 +619,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

@@ -11,7 +11,7 @@ import {
   payloadCredential,
   payloadError,
   supportedOperationIds
-} from "./chunk-BB273WDT.js";
+} from "./chunk-7HS4CTPK.js";
 export {
   DEFAULT_MARKETING_DOCS,
   MARKETING_FIELDS,

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;
@@ -985,6 +1023,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;
@@ -1111,6 +1179,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-VQD2J3NH.js";
-import "./chunk-BB273WDT.js";
+} from "./chunk-3OUYZQTC.js";
+import "./chunk-7HS4CTPK.js";
 export {
   DEFAULT_PORT,
   createServer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crvouga/mockingbird-service-payload-cms",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "Stateful mock of the Payload CMS collection REST API: paginated finds with a where-query subset, find by id, a seeded marketing collection and admin-editable documents.",
   "license": "MIT",
   "type": "module",
@@ -55,7 +55,7 @@
       "website": "https://payloadcms.com",
       "docs": "https://payloadcms.com/docs/rest-api/overview"
     },
-    "status": "wip",
+    "parity": "Collection REST",
     "parityTier": "cold"
   },
   "scripts": {
@@ -71,7 +71,7 @@
     "pack:check": "bun ../../../scripts/pack-check.ts"
   },
   "dependencies": {
-    "@crvouga/mockingbird-service-sqlite": "1.1.0",
+    "@crvouga/mockingbird-service-sqlite": "1.2.0",
     "hono": "4.11.9"
   },
   "devDependencies": {