@actuate-media/cms-core 0.53.0 → 0.55.0

package/dist/api/collection-introspection.js

@@ -0,0 +1,82 @@
+/**
+ * Field-schema introspection for the `GET /api/cms/collections` discovery
+ * endpoint (roadmap WS-B4).
+ *
+ * Reduces a collection's field map to a compact, **recursive** summary an
+ * agent can plan a create/update against — including `array` element
+ * subfields and `blocks` variant subfields — WITHOUT shipping the full
+ * runtime validators, hooks, or access functions (those can carry closure
+ * state and must never reach the unauthenticated discovery surface).
+ *
+ * The shape is intentionally additive over the flat `{ name, type, required }`
+ * summary: relationship targets, select options, and nested subfield schemas
+ * appear only when present, so existing consumers keep working.
+ */
+/**
+ * Defensive recursion cap. Configs are static and authored by the developer,
+ * so cycles are not expected, but a malformed/self-referential config must
+ * never be able to blow the stack or balloon the response. Five levels is far
+ * deeper than any realistic page/array/blocks nesting.
+ */
+const MAX_DEPTH = 5;
+function isFieldMap(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+/**
+ * Summarize a collection's `fields` map into the recursive {@link FieldSummary}
+ * array used by the discovery endpoint. Safe on any input — a non-object map
+ * (or a missing one) yields `[]`.
+ */
+export function summarizeCollectionFields(fields, depth = 0) {
+    if (!isFieldMap(fields))
+        return [];
+    return Object.entries(fields).map(([name, fieldDef]) => summarizeField(name, fieldDef, depth));
+}
+function summarizeField(name, fieldDef, depth) {
+    const summary = {
+        name,
+        type: typeof fieldDef?.type === 'string' ? fieldDef.type : 'unknown',
+        required: fieldDef?.required === true,
+    };
+    // Relationship target collection(s) — the agent needs this to resolve a
+    // slug→id for a relationship field.
+    if (typeof fieldDef?.relationTo === 'string' || Array.isArray(fieldDef?.relationTo)) {
+        summary.relationTo = fieldDef.relationTo;
+    }
+    if (fieldDef?.hasMany === true || fieldDef?.multiple === true)
+        summary.hasMany = true;
+    // Select options (label/value pairs or bare strings) so the agent can fill enums.
+    if (Array.isArray(fieldDef?.options))
+        summary.options = fieldDef.options;
+    // Stop recursing past the cap, but still emit the field's own metadata.
+    if (depth >= MAX_DEPTH)
+        return summary;
+    // `array`: recurse into the element subfields so an agent knows the shape of
+    // each row it must author.
+    if (summary.type === 'array' && isFieldMap(fieldDef?.fields)) {
+        summary.fields = summarizeCollectionFields(fieldDef.fields, depth + 1);
+        if (typeof fieldDef.minRows === 'number')
+            summary.minRows = fieldDef.minRows;
+        if (typeof fieldDef.maxRows === 'number')
+            summary.maxRows = fieldDef.maxRows;
+    }
+    // `blocks`: recurse into each block variant's subfields, keyed by the block
+    // slug (the discriminator the agent writes as `blockType`).
+    if (summary.type === 'blocks' && Array.isArray(fieldDef?.blocks)) {
+        summary.blocks = fieldDef.blocks
+            .filter((b) => !!b && typeof b === 'object')
+            .map((b) => {
+            const slug = typeof b.slug === 'string' ? b.slug : 'unknown';
+            const labels = b.labels;
+            const block = {
+                slug,
+                fields: summarizeCollectionFields(b.fields, depth + 1),
+            };
+            if (typeof labels?.singular === 'string')
+                block.label = labels.singular;
+            return block;
+        });
+    }
+    return summary;
+}
+//# sourceMappingURL=collection-introspection.js.map

package/dist/api/collection-introspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-introspection.js","sourceRoot":"","sources":["../../src/api/collection-introspection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA6BH;;;;;GAKG;AACH,MAAM,SAAS,GAAG,CAAC,CAAA;AAenB,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AACtE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAe,EAAE,KAAK,GAAG,CAAC;IAClE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,CAAA;IAClC,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAA;AAChG,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,QAAkB,EAAE,KAAa;IACrE,MAAM,OAAO,GAAiB;QAC5B,IAAI;QACJ,IAAI,EAAE,OAAO,QAAQ,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACpE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,KAAK,IAAI;KACtC,CAAA;IAED,wEAAwE;IACxE,oCAAoC;IACpC,IAAI,OAAO,QAAQ,EAAE,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;QACpF,OAAO,CAAC,UAAU,GAAG,QAAQ,CAAC,UAA+B,CAAA;IAC/D,CAAC;IACD,IAAI,QAAQ,EAAE,OAAO,KAAK,IAAI,IAAI,QAAQ,EAAE,QAAQ,KAAK,IAAI;QAAE,OAAO,CAAC,OAAO,GAAG,IAAI,CAAA;IACrF,kFAAkF;IAClF,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC;QAAE,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAoB,CAAA;IAErF,wEAAwE;IACxE,IAAI,KAAK,IAAI,SAAS;QAAE,OAAO,OAAO,CAAA;IAEtC,6EAA6E;IAC7E,2BAA2B;IAC3B,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;QAC7D,OAAO,CAAC,MAAM,GAAG,yBAAyB,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;QACtE,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAA;QAC5E,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAA;IAC9E,CAAC;IAED,4EAA4E;IAC5E,4DAA4D;IAC5D,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;QACjE,OAAO,CAAC,MAAM,GAAI,QAAQ,CAAC,MAAoB;aAC5C,MAAM,CAAC,CAAC,CAAC,EAAgC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC;aACzE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;YAC5D,MAAM,MAAM,GAAG,CAAC,CAAC,MAA4C,CAAA;YAC7D,MAAM,KAAK,GAAiB;gBAC1B,IAAI;gBACJ,MAAM,EAAE,yBAAyB,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC;aACvD,CAAA;YACD,IAAI,OAAO,MAAM,EAAE,QAAQ,KAAK,QAAQ;gBAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAA;YACvE,OAAO,KAAK,CAAA;QACd,CAAC,CAAC,CAAA;IACN,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/api/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/api/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAomC5C,iFAAiF;AACjF,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AA4LD,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAS9E;AA0VD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA67YzD"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/api/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAqmC5C,iFAAiF;AACjF,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AA4LD,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAS9E;AA0VD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA25YzD"}

package/dist/api/handlers.js

@@ -1,3 +1,4 @@
+import { summarizeCollectionFields } from './collection-introspection.js';
 import { listDocuments, getDocument, createDocument, updateDocument, updateDocumentSeoFields, assertCollectionAccess, deleteDocument, getGlobal, updateGlobal, buildRelationLookup, } from '../actions.js';
 import { populateRelations, parsePopulateParam } from '../fields/relations.js';
 import { verifyPassword, hashPassword, needsRehash, compareToDummyHash } from '../auth/password.js';
@@ -1457,30 +1458,12 @@ export function registerCMSRoutes(router) {
         if (!config)
             return errorResponse('CMS not configured', 500);
         const collections = Object.entries(config.collections ?? {}).map(([slug, def]) => {
-            const fields = (def?.fields ?? {});
             // Reduce each field to `{ name, type, required }` plus, where present,
-            // the relationship target and select options — enough for the agent to
-            // plan a create/update AND resolve relationship fields (WS-C C2 /
-            // WS-B4 overlap) without sending the full validator.
-            const fieldSummary = Object.entries(fields).map(([name, fieldDef]) => {
-                const summary = {
-                    name,
-                    type: typeof fieldDef?.type === 'string' ? fieldDef.type : 'unknown',
-                    required: fieldDef?.required === true,
-                };
-                // Relationship target collection(s) — the agent needs this to know
-                // where to resolve a slug→id for a relationship field.
-                if (typeof fieldDef?.relationTo === 'string' || Array.isArray(fieldDef?.relationTo)) {
-                    summary.relationTo = fieldDef.relationTo;
-                }
-                if (fieldDef?.hasMany === true || fieldDef?.multiple === true)
-                    summary.hasMany = true;
-                // Select options (label/value pairs) so the agent can fill enums.
-                if (Array.isArray(fieldDef?.options)) {
-                    summary.options = fieldDef.options;
-                }
-                return summary;
-            });
+            // the relationship target, select options, and (for `array`/`blocks`)
+            // the nested subfield schema — enough for the agent to plan a deep
+            // create/update AND resolve relationship fields (WS-B4 + WS-C C2)
+            // without sending the full validator. See collection-introspection.ts.
+            const fieldSummary = summarizeCollectionFields(def?.fields);
             return {
                 slug,
                 labels: def?.labels ?? { singular: slug, plural: slug },