@aphexcms/cms-core 9.2.2 → 9.4.0

package/dist/field-validation/utils.d.ts

@@ -15,6 +15,21 @@ export interface DocumentValidationResult {
  * Check if a field is required based on its validation rules
  */
 export declare function isFieldRequired(field: Field): boolean;
+/**
+ * Structural (shape) validation for a field's stored value — the depth=0 write
+ * shape. This catches a caller (notably an AI agent over MCP) sending the wrong
+ * JSON shape that presence/required checks would miss: a slug as `{ current }`
+ * (Sanity's convention — AphexCMS stores slugs as plain strings), or a
+ * reference/image missing its `_ref`. Runs before the user's Rule validation
+ * and only when a value is meaningfully present (absent/empty is a required-ness
+ * concern, handled separately), so optional and half-filled fields are left
+ * alone. Returns an error message, or null when the shape is acceptable.
+ *
+ * Intentionally conservative: only unambiguous mismatches error, and empty
+ * placeholders (`''`, an image with no `asset`) are treated as absent so the
+ * admin's in-progress edit states don't trip it.
+ */
+export declare function validateValueShape(field: Field, value: unknown): string | null;
 /**
  * Validate a field value against its validation rules
  */

package/dist/field-validation/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/field-validation/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAKxD,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACnD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAUrD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,GAAG,EACV,OAAO,GAAE,GAAQ,GACf,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B,CAAC,CAiID;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAO/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,GAAE,GAAQ,GACf,OAAO,CAAC,wBAAwB,CAAC,CAqDnC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/field-validation/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAKxD,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACnD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAUrD;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAmC9E;AAED;;GAEG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,GAAG,EACV,OAAO,GAAE,GAAQ,GACf,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B,CAAC,CA6ID;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAO/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,GAAE,GAAQ,GACf,OAAO,CAAC,wBAAwB,CAAC,CAqDnC"}

package/dist/field-validation/utils.js

@@ -18,6 +18,69 @@ export function isFieldRequired(field) {
         return false;
     }
 }
+function describeValue(value) {
+    if (Array.isArray(value))
+        return 'an array';
+    if (value === null)
+        return 'null';
+    if (typeof value === 'object')
+        return 'an object';
+    return `a ${typeof value}`;
+}
+const isPlainObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+/**
+ * Structural (shape) validation for a field's stored value — the depth=0 write
+ * shape. This catches a caller (notably an AI agent over MCP) sending the wrong
+ * JSON shape that presence/required checks would miss: a slug as `{ current }`
+ * (Sanity's convention — AphexCMS stores slugs as plain strings), or a
+ * reference/image missing its `_ref`. Runs before the user's Rule validation
+ * and only when a value is meaningfully present (absent/empty is a required-ness
+ * concern, handled separately), so optional and half-filled fields are left
+ * alone. Returns an error message, or null when the shape is acceptable.
+ *
+ * Intentionally conservative: only unambiguous mismatches error, and empty
+ * placeholders (`''`, an image with no `asset`) are treated as absent so the
+ * admin's in-progress edit states don't trip it.
+ */
+export function validateValueShape(field, value) {
+    // Absent (or an empty-string placeholder for a non-string field) → shape is
+    // irrelevant here; presence is enforced by Rule().required().
+    if (value === null || value === undefined)
+        return null;
+    switch (field.type) {
+        case 'string':
+        case 'text':
+        case 'slug':
+        case 'url':
+            return typeof value === 'string' ? null : `expected a string, got ${describeValue(value)}`;
+        case 'reference':
+            if (value === '')
+                return null;
+            return isPlainObject(value) && typeof value._ref === 'string'
+                ? null
+                : `expected a reference object { _type: 'reference', _ref: '<documentId>' }, got ${describeValue(value)}`;
+        case 'image':
+        case 'file': {
+            if (value === '')
+                return null;
+            if (!isPlainObject(value))
+                return `expected an ${field.type} object { _type: '${field.type}', asset: { _type: 'reference', _ref: '<assetId>' } }, got ${describeValue(value)}`;
+            // An object with no asset yet is a valid empty/in-progress state.
+            if (value.asset === undefined || value.asset === null)
+                return null;
+            return isPlainObject(value.asset) && typeof value.asset._ref === 'string'
+                ? null
+                : `${field.type} asset must be { _type: 'reference', _ref: '<assetId>' }`;
+        }
+        case 'array':
+            return Array.isArray(value) ? null : `expected an array, got ${describeValue(value)}`;
+        case 'object':
+            return isPlainObject(value) ? null : `expected an object, got ${describeValue(value)}`;
+        default:
+            // number/boolean/date/datetime — left to existing auto-rules / user rules.
+            return null;
+    }
+}
 /**
  * Validate a field value against its validation rules
  */
@@ -28,6 +91,17 @@ export async function validateField(field, value, context = {}) {
         hasValidation: !!field.validation
     });
     const allErrors = [];
+    // Structural shape check first: if the value is the wrong JSON shape (e.g. a
+    // slug sent as `{ current }`, or a reference without `_ref`), report that and
+    // stop — the type-assuming auto-rules and user rules below expect the correct
+    // primitive/shape and would otherwise throw or emit confusing errors.
+    const shapeError = validateValueShape(field, value);
+    if (shapeError) {
+        return {
+            isValid: false,
+            errors: [{ level: 'error', message: `Field "${field.name}" ${shapeError}` }]
+        };
+    }
     // Add automatic validation for date/datetime/url fields based on type
     if (field.type === 'date') {
         const dateField = field;

package/dist/graphql/resolvers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolvers.d.ts","sourceRoot":"","sources":["../../src/lib/graphql/resolvers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAS,MAAM,kBAAkB,CAAC;AA4H1D,wBAAgB,eAAe,CAC9B,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,UAAU,EAAE,EACzB,kBAAkB,GAAE,OAAO,GAAG,WAAyB,uBA2tBvD"}
+{"version":3,"file":"resolvers.d.ts","sourceRoot":"","sources":["../../src/lib/graphql/resolvers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAS,MAAM,kBAAkB,CAAC;AAyH1D,wBAAgB,eAAe,CAC9B,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,UAAU,EAAE,EACzB,kBAAkB,GAAE,OAAO,GAAG,WAAyB,uBA4tBvD"}

package/dist/graphql/resolvers.js

@@ -2,9 +2,7 @@ import { GraphQLError } from 'graphql';
 import { authToContext } from '../local-api/auth-helpers.js';
 import { getDefaultValueForFieldType } from '../utils/field-defaults.js';
 import { cmsLogger } from '../utils/logger.js';
-function capitalizeFirst(str) {
-    return str.charAt(0).toUpperCase() + str.slice(1);
-}
+import { toPascalCase, toCamelCase } from '../utils/string-case.js';
 // Normalize null/undefined field values to type-appropriate defaults (recursive)
 function normalizeDocumentFields(data, schemaType, allSchemaTypes) {
     if (!data)
@@ -130,7 +128,7 @@ export function createResolvers(cms, schemaTypes, defaultPerspective = 'publishe
     // Generate reference field resolvers for all types
     function generateReferenceFieldResolvers() {
         schemaTypes.forEach((schemaType) => {
-            const typeName = capitalizeFirst(schemaType.name);
+            const typeName = toPascalCase(schemaType.name);
             function processFields(fields, currentTypeName) {
                 fields.forEach((field) => {
                     // Handle reference fields
@@ -244,7 +242,7 @@ export function createResolvers(cms, schemaTypes, defaultPerspective = 'publishe
                     }
                     // Handle nested objects
                     if (field.type === 'object' && field.fields) {
-                        const nestedTypeName = capitalizeFirst(`${schemaType.name}${field.name}Object`);
+                        const nestedTypeName = toPascalCase(`${schemaType.name}${field.name}Object`);
                         processFields(field.fields, nestedTypeName);
                     }
                 });
@@ -262,11 +260,11 @@ export function createResolvers(cms, schemaTypes, defaultPerspective = 'publishe
                     if (field.type === 'array' && field.of && field.of.length > 1) {
                         const validTypes = field.of.filter((item) => schemaTypes.find((s) => s.name === item.type));
                         if (validTypes.length > 1) {
-                            const unionName = `${capitalizeFirst(parentName)}${capitalizeFirst(field.name)}Item`;
+                            const unionName = `${toPascalCase(parentName)}${toPascalCase(field.name)}Item`;
                             resolvers[unionName] = {
                                 __resolveType(obj) {
                                     if (obj._type) {
-                                        return capitalizeFirst(obj._type);
+                                        return toPascalCase(obj._type);
                                     }
                                     return null;
                                 }
@@ -286,7 +284,8 @@ export function createResolvers(cms, schemaTypes, defaultPerspective = 'publishe
     // Generate resolvers for each document type
     const documentTypes = schemaTypes.filter((type) => type.type === 'document');
     documentTypes.forEach((schemaType) => {
-        const typeName = capitalizeFirst(schemaType.name);
+        const typeName = toPascalCase(schemaType.name);
+        const fieldName = toCamelCase(schemaType.name);
         // Singleton resolvers: no-arg query, no-id mutations.
         // Schema/codegen already differs for singletons (see schema.ts) — the
         // resolver just delegates to the singleton-aware CollectionAPI methods.
@@ -306,7 +305,7 @@ export function createResolvers(cms, schemaTypes, defaultPerspective = 'publishe
                     ...normalizedData
                 };
             };
-            resolvers.Query[schemaType.name] = async (_, args, context) => {
+            resolvers.Query[fieldName] = async (_, args, context) => {
                 try {
                     const { localAPI, auth } = context;
                     const apiContext = authToContext(auth);
@@ -404,7 +403,7 @@ export function createResolvers(cms, schemaTypes, defaultPerspective = 'publishe
             return; // skip the regular per-type resolvers below for singletons
         }
         // Single document resolver: page(id: "123", perspective: "draft")
-        resolvers.Query[schemaType.name] = async (_, args, context) => {
+        resolvers.Query[fieldName] = async (_, args, context) => {
             try {
                 const { localAPI, auth } = context;
                 const apiContext = authToContext(auth);

package/dist/graphql/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/lib/graphql/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAkD,MAAM,kBAAkB,CAAC;AA0YnG,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CA2FvE"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/lib/graphql/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAkD,MAAM,kBAAkB,CAAC;AAyYnG,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CA2FvE"}

package/dist/graphql/schema.js

@@ -1,6 +1,4 @@
-function capitalizeFirst(str) {
-    return str.charAt(0).toUpperCase() + str.slice(1);
-}
+import { toPascalCase, toCamelCase } from '../utils/string-case.js';
 function generateGraphQLField(field, schemaTypes, parentName = '') {
     const nullability = isFieldRequired(field) ? '!' : '';
     const fieldType = getGraphQLType(field, schemaTypes, parentName);
@@ -44,7 +42,7 @@ function handleArrayField(field, schemaTypes, parentName = '') {
         const refItem = refItems[0];
         const to = refItem.to;
         if (to && to.length === 1) {
-            return `[${capitalizeFirst(to[0].type)}]`;
+            return `[${toPascalCase(to[0].type)}]`;
         }
         return '[JSON]';
     }
@@ -56,22 +54,22 @@ function handleArrayField(field, schemaTypes, parentName = '') {
     // If array contains only one type
     if (validTypes.length === 1) {
         const itemType = validTypes[0];
-        return `[${capitalizeFirst(itemType.type)}]`;
+        return `[${toPascalCase(itemType.type)}]`;
     }
     // For multiple types in array, create union type with parent prefix
-    const unionName = `${capitalizeFirst(parentName)}${capitalizeFirst(field.name)}Item`;
+    const unionName = `${toPascalCase(parentName)}${toPascalCase(field.name)}Item`;
     return `[${unionName}]`;
 }
 function handleObjectField(field, _schemaTypes, parentName = '') {
     if (field.fields && field.fields.length > 0) {
         // Inline object - create a unique type name with parent prefix
-        return capitalizeFirst(`${parentName}${field.name}Object`);
+        return toPascalCase(`${parentName}${field.name}Object`);
     }
     return 'String'; // JSON string fallback
 }
 function handleReferenceField(field) {
     if (field.to && field.to.length === 1) {
-        return capitalizeFirst(field.to[0].type);
+        return toPascalCase(field.to[0].type);
     }
     return 'String'; // ID reference for MVP
 }
@@ -82,7 +80,7 @@ function isFieldRequired(field) {
     return field.validation.toString().includes('required');
 }
 function generateObjectType(schemaType, allSchemaTypes) {
-    const typeName = capitalizeFirst(schemaType.name);
+    const typeName = toPascalCase(schemaType.name);
     const fields = schemaType.fields
         .map((field) => generateGraphQLField(field, allSchemaTypes, schemaType.name))
         .join('\n');
@@ -91,7 +89,7 @@ ${fields}
 }`;
 }
 function generateDocumentType(schemaType, allSchemaTypes) {
-    const typeName = capitalizeFirst(schemaType.name);
+    const typeName = toPascalCase(schemaType.name);
     const customFields = schemaType.fields
         .map((field) => generateGraphQLField(field, allSchemaTypes, schemaType.name))
         .join('\n');
@@ -111,7 +109,7 @@ function generateInlineObjectTypes(schemaTypes) {
         fields.forEach((field) => {
             if (field.type === 'object' && field.fields) {
                 const objectField = field;
-                const typeName = capitalizeFirst(`${parentName}${field.name}Object`);
+                const typeName = toPascalCase(`${parentName}${field.name}Object`);
                 const fieldDefs = objectField.fields
                     .map((f) => generateGraphQLField(f, schemaTypes, `${parentName}${field.name}`))
                     .join('\n');
@@ -127,8 +125,8 @@ ${fieldDefs}
                     // Only create union for types that exist in schemaTypes
                     const validTypes = arrayField.of.filter((item) => schemaTypes.find((s) => s.name === item.type));
                     if (validTypes.length > 1) {
-                        const unionName = `${capitalizeFirst(parentName)}${capitalizeFirst(field.name)}Item`;
-                        const unionTypes = validTypes.map((item) => capitalizeFirst(item.type)).join(' | ');
+                        const unionName = `${toPascalCase(parentName)}${toPascalCase(field.name)}Item`;
+                        const unionTypes = validTypes.map((item) => toPascalCase(item.type)).join(' | ');
                         inlineTypes.push(`union ${unionName} = ${unionTypes}`);
                     }
                 }
@@ -186,7 +184,7 @@ input IDFilter {
 }
 // Generate where input type for a specific document type
 function generateWhereInputType(schemaType, _allSchemaTypes) {
-    const typeName = capitalizeFirst(schemaType.name);
+    const typeName = toPascalCase(schemaType.name);
     const whereTypeName = `${typeName}WhereInput`;
     // Generate field filters
     const fieldFilters = [];
@@ -223,7 +221,7 @@ function getFilterType(field) {
 }
 // Generate data input type for mutations
 function generateDataInputType(schemaType, allSchemaTypes) {
-    const typeName = capitalizeFirst(schemaType.name);
+    const typeName = toPascalCase(schemaType.name);
     const inputTypeName = `${typeName}DataInput`;
     const fields = [];
     schemaType.fields.forEach((field) => {
@@ -268,16 +266,17 @@ function generateQueryFields(schemaTypes) {
     const documentTypes = schemaTypes.filter((type) => type.type === 'document');
     return documentTypes
         .map((schemaType) => {
-        const typeName = capitalizeFirst(schemaType.name);
+        const typeName = toPascalCase(schemaType.name);
         // Singletons resolve to a single canonical row — no id arg, no
         // `all` query. Lazy-creates on first access via the resolver.
+        const fieldName = toCamelCase(schemaType.name);
         if (schemaType.singleton) {
             return `  # Get the ${schemaType.name} singleton (lazy-creates an empty draft on first access)
-  ${schemaType.name}(perspective: String, depth: Int): ${typeName}!`;
+  ${fieldName}(perspective: String, depth: Int): ${typeName}!`;
         }
         const whereInputType = `${typeName}WhereInput`;
         return `  # Get a single ${schemaType.name} by ID
-  ${schemaType.name}(id: ID!, perspective: String, depth: Int): ${typeName}
+  ${fieldName}(id: ID!, perspective: String, depth: Int): ${typeName}
 
   # Get all ${schemaType.name} documents with filtering
   all${typeName}(
@@ -295,7 +294,7 @@ function generateMutationFields(schemaTypes) {
     const documentTypes = schemaTypes.filter((type) => type.type === 'document');
     return documentTypes
         .map((schemaType) => {
-        const typeName = capitalizeFirst(schemaType.name);
+        const typeName = toPascalCase(schemaType.name);
         const dataInputType = `${typeName}DataInput`;
         // Singletons skip create/delete/all: there's only ever one row, with
         // a deterministic id, so update/publish/unpublish operate on it

package/dist/lib/components/admin/fields/richtext/block-defaults.d.ts

@@ -0,0 +1,4 @@
+export declare const DEFAULT_BLOCK_STYLES: string[];
+export declare const DEFAULT_BLOCK_DECORATORS: string[];
+export declare const DEFAULT_BLOCK_LISTS: string[];
+//# sourceMappingURL=block-defaults.d.ts.map

package/dist/lib/components/admin/fields/richtext/block-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-defaults.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/components/admin/fields/richtext/block-defaults.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,oBAAoB,UAA+D,CAAC;AAEjG,eAAO,MAAM,wBAAwB,UAA0D,CAAC;AAEhG,eAAO,MAAM,mBAAmB,UAAuB,CAAC"}

package/dist/lib/components/admin/fields/richtext/block-defaults.js

@@ -0,0 +1,9 @@
+// Default Portable Text block config, applied when a `{ type: 'block' }` in a
+// schema omits its own `styles` / `marks.decorators` / `lists`. Single source of
+// truth: the editor (RichtextField.svelte) and the MCP schema guide
+// (mcp/tools.ts → portableTextGuide) both import these, so what the agent is told
+// matches what the editor actually offers. Plain constants — no Svelte.
+export const DEFAULT_BLOCK_STYLES = ['normal', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'blockquote'];
+export const DEFAULT_BLOCK_DECORATORS = ['strong', 'em', 'underline', 'strike-through', 'code'];
+export const DEFAULT_BLOCK_LISTS = ['bullet', 'number'];
+//# sourceMappingURL=block-defaults.js.map

package/dist/lib/components/admin/fields/richtext/block-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-defaults.js","sourceRoot":"","sources":["../../../../../../src/lib/components/admin/fields/richtext/block-defaults.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,iFAAiF;AACjF,oEAAoE;AACpE,kFAAkF;AAClF,wEAAwE;AAExE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;AAEjG,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;AAEhG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC"}

package/dist/lib/field-validation/utils.d.ts

@@ -15,6 +15,21 @@ export interface DocumentValidationResult {
  * Check if a field is required based on its validation rules
  */
 export declare function isFieldRequired(field: Field): boolean;
+/**
+ * Structural (shape) validation for a field's stored value — the depth=0 write
+ * shape. This catches a caller (notably an AI agent over MCP) sending the wrong
+ * JSON shape that presence/required checks would miss: a slug as `{ current }`
+ * (Sanity's convention — AphexCMS stores slugs as plain strings), or a
+ * reference/image missing its `_ref`. Runs before the user's Rule validation
+ * and only when a value is meaningfully present (absent/empty is a required-ness
+ * concern, handled separately), so optional and half-filled fields are left
+ * alone. Returns an error message, or null when the shape is acceptable.
+ *
+ * Intentionally conservative: only unambiguous mismatches error, and empty
+ * placeholders (`''`, an image with no `asset`) are treated as absent so the
+ * admin's in-progress edit states don't trip it.
+ */
+export declare function validateValueShape(field: Field, value: unknown): string | null;
 /**
  * Validate a field value against its validation rules
  */

package/dist/lib/field-validation/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/field-validation/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAKxD,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACnD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAUrD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,GAAG,EACV,OAAO,GAAE,GAAQ,GACf,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B,CAAC,CAiID;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAO/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,GAAE,GAAQ,GACf,OAAO,CAAC,wBAAwB,CAAC,CAqDnC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/field-validation/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAKxD,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACnD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAUrD;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAmC9E;AAED;;GAEG;AACH,wBAAsB,aAAa,CAClC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,GAAG,EACV,OAAO,GAAE,GAAQ,GACf,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B,CAAC,CA6ID;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAO/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACzC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,GAAE,GAAQ,GACf,OAAO,CAAC,wBAAwB,CAAC,CAqDnC"}

package/dist/lib/field-validation/utils.js

@@ -18,6 +18,69 @@ export function isFieldRequired(field) {
         return false;
     }
 }
+function describeValue(value) {
+    if (Array.isArray(value))
+        return 'an array';
+    if (value === null)
+        return 'null';
+    if (typeof value === 'object')
+        return 'an object';
+    return `a ${typeof value}`;
+}
+const isPlainObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+/**
+ * Structural (shape) validation for a field's stored value — the depth=0 write
+ * shape. This catches a caller (notably an AI agent over MCP) sending the wrong
+ * JSON shape that presence/required checks would miss: a slug as `{ current }`
+ * (Sanity's convention — AphexCMS stores slugs as plain strings), or a
+ * reference/image missing its `_ref`. Runs before the user's Rule validation
+ * and only when a value is meaningfully present (absent/empty is a required-ness
+ * concern, handled separately), so optional and half-filled fields are left
+ * alone. Returns an error message, or null when the shape is acceptable.
+ *
+ * Intentionally conservative: only unambiguous mismatches error, and empty
+ * placeholders (`''`, an image with no `asset`) are treated as absent so the
+ * admin's in-progress edit states don't trip it.
+ */
+export function validateValueShape(field, value) {
+    // Absent (or an empty-string placeholder for a non-string field) → shape is
+    // irrelevant here; presence is enforced by Rule().required().
+    if (value === null || value === undefined)
+        return null;
+    switch (field.type) {
+        case 'string':
+        case 'text':
+        case 'slug':
+        case 'url':
+            return typeof value === 'string' ? null : `expected a string, got ${describeValue(value)}`;
+        case 'reference':
+            if (value === '')
+                return null;
+            return isPlainObject(value) && typeof value._ref === 'string'
+                ? null
+                : `expected a reference object { _type: 'reference', _ref: '<documentId>' }, got ${describeValue(value)}`;
+        case 'image':
+        case 'file': {
+            if (value === '')
+                return null;
+            if (!isPlainObject(value))
+                return `expected an ${field.type} object { _type: '${field.type}', asset: { _type: 'reference', _ref: '<assetId>' } }, got ${describeValue(value)}`;
+            // An object with no asset yet is a valid empty/in-progress state.
+            if (value.asset === undefined || value.asset === null)
+                return null;
+            return isPlainObject(value.asset) && typeof value.asset._ref === 'string'
+                ? null
+                : `${field.type} asset must be { _type: 'reference', _ref: '<assetId>' }`;
+        }
+        case 'array':
+            return Array.isArray(value) ? null : `expected an array, got ${describeValue(value)}`;
+        case 'object':
+            return isPlainObject(value) ? null : `expected an object, got ${describeValue(value)}`;
+        default:
+            // number/boolean/date/datetime — left to existing auto-rules / user rules.
+            return null;
+    }
+}
 /**
  * Validate a field value against its validation rules
  */
@@ -28,6 +91,17 @@ export async function validateField(field, value, context = {}) {
         hasValidation: !!field.validation
     });
     const allErrors = [];
+    // Structural shape check first: if the value is the wrong JSON shape (e.g. a
+    // slug sent as `{ current }`, or a reference without `_ref`), report that and
+    // stop — the type-assuming auto-rules and user rules below expect the correct
+    // primitive/shape and would otherwise throw or emit confusing errors.
+    const shapeError = validateValueShape(field, value);
+    if (shapeError) {
+        return {
+            isValid: false,
+            errors: [{ level: 'error', message: `Field "${field.name}" ${shapeError}` }]
+        };
+    }
     // Add automatic validation for date/datetime/url fields based on type
     if (field.type === 'date') {
         const dateField = field;

package/dist/lib/field-validation/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/lib/field-validation/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/lib/field-validation/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAa5C;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAY;IAC3C,IAAI,CAAC,KAAK,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,CAAC;QACJ,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;QAC9F,IAAI,CAAC,YAAY;YAAE,OAAO,KAAK,CAAC;QAChC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACpC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAC5C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC;IAClD,OAAO,KAAK,OAAO,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,aAAa,GAAG,CAAC,CAAU,EAAgC,EAAE,CAClE,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAY,EAAE,KAAc;IAC9D,4EAA4E;IAC5E,8DAA8D;IAC9D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAEvD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK;YACT,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,0BAA0B,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5F,KAAK,WAAW;YACf,IAAI,KAAK,KAAK,EAAE;gBAAE,OAAO,IAAI,CAAC;YAC9B,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAC5D,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,iFAAiF,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5G,KAAK,OAAO,CAAC;QACb,KAAK,MAAM,CAAC,CAAC,CAAC;YACb,IAAI,KAAK,KAAK,EAAE;gBAAE,OAAO,IAAI,CAAC;YAC9B,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;gBACxB,OAAO,eAAe,KAAK,CAAC,IAAI,qBAAqB,KAAK,CAAC,IAAI,8DAA8D,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACrJ,kEAAkE;YAClE,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;YACnE,OAAO,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;gBACxE,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,0DAA0D,CAAC;QAC5E,CAAC;QACD,KAAK,OAAO;YACX,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,0BAA0B,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACvF,KAAK,QAAQ;YACZ,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,2BAA2B,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACxF;YACC,2EAA2E;YAC3E,OAAO,IAAI,CAAC;IACd,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,KAAY,EACZ,KAAU,EACV,UAAe,EAAE;IAKjB,SAAS,CAAC,KAAK,CAAC,iBAAiB,EAAE,qBAAqB,KAAK,CAAC,IAAI,GAAG,EAAE;QACtE,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK;QACL,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU;KACjC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAsB,EAAE,CAAC;IAExC,6EAA6E;IAC7E,8EAA8E;IAC9E,8EAA8E;IAC9E,sEAAsE;IACtE,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACpD,IAAI,UAAU,EAAE,CAAC;QAChB,OAAO;YACN,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,EAAE,CAAC;SAC5E,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,KAAY,CAAC;QAC/B,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,EAAE,UAAU,IAAI,YAAY,CAAC;QACjE,SAAS,CAAC,KAAK,CAAC,iBAAiB,EAAE,yCAAyC,KAAK,CAAC,IAAI,GAAG,EAAE;YAC1F,UAAU;SACV,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE;YAC9C,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;YAClB,GAAG,OAAO;SACV,CAAC,CAAC;QAEH,SAAS,CAAC,IAAI,CACb,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;SACvB,CAAC,CAAC,CACH,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,aAAa,GAAG,KAAY,CAAC;QACnC,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,EAAE,UAAU,IAAI,YAAY,CAAC;QACrE,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,EAAE,UAAU,IAAI,OAAO,CAAC;QAChE,SAAS,CAAC,KAAK,CAAC,iBAAiB,EAAE,6CAA6C,KAAK,CAAC,IAAI,GAAG,EAAE;YAC9F,UAAU;YACV,UAAU;SACV,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE;YAC9C,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;YAClB,GAAG,OAAO;SACV,CAAC,CAAC;QAEH,SAAS,CAAC,IAAI,CACb,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;SACvB,CAAC,CAAC,CACH,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACjC,oEAAoE;QACpE,mGAAmG;QACnG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YACvB,SAAS,CAAC,KAAK,CAAC,iBAAiB,EAAE,wCAAwC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;YAE1F,8DAA8D;YAC9D,IAAI,KAAK,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;gBAC3B,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC;gBAClC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE;oBAC9C,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;oBAClB,GAAG,OAAO;iBACV,CAAC,CAAC;gBAEH,SAAS,CAAC,IAAI,CACb,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,OAAO,EAAE,MAAM,CAAC,OAAO;iBACvB,CAAC,CAAC,CACH,CAAC;YACH,CAAC;QACF,CAAC;aAAM,CAAC;YACP,SAAS,CAAC,KAAK,CACd,iBAAiB,EACjB,0CAA0C,KAAK,CAAC,IAAI,2BAA2B,CAC/E,CAAC;QACH,CAAC;IACF,CAAC;IAED,+CAA+C;IAC/C,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACvB,SAAS,CAAC,KAAK,CAAC,iBAAiB,EAAE,mCAAmC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IACtF,CAAC;SAAM,CAAC;QACP,IAAI,CAAC;YACJ,MAAM,mBAAmB,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC1D,CAAC,CAAC,KAAK,CAAC,UAAU;gBAClB,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAEtB,SAAS,CAAC,KAAK,CACd,iBAAiB,EACjB,UAAU,KAAK,CAAC,IAAI,SAAS,mBAAmB,CAAC,MAAM,gCAAgC,CACvF,CAAC;YAEF,KAAK,MAAM,YAAY,IAAI,mBAAmB,EAAE,CAAC;gBAChD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;gBAEtC,IAAI,CAAC,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;oBAC7B,SAAS,CAAC,KAAK,CACd,kCAAkC,KAAK,CAAC,IAAI,yGAAyG,CACrJ,CAAC;oBACF,SAAS;gBACV,CAAC;gBAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;oBAC1C,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;oBAClB,GAAG,OAAO;iBACV,CAAC,CAAC;gBAEH,SAAS,CAAC,IAAI,CACb,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,OAAO,EAAE,MAAM,CAAC,OAAO;iBACvB,CAAC,CAAC,CACH,CAAC;YACH,CAAC;QACF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,SAAS,CAAC,KAAK,CAAC,iBAAiB,EAAE,yBAAyB,KAAK,CAAC,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC;YACnF,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAClE,CAAC;IACF,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IAE1E,SAAS,CAAC,KAAK,CAAC,iBAAiB,EAAE,UAAU,KAAK,CAAC,IAAI,uBAAuB,EAAE;QAC/E,OAAO;QACP,MAAM,EAAE,SAAS;KACjB,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAkB;IACtD,IAAI,SAAS,EAAE,CAAC;QACf,OAAO,6BAA6B,CAAC;IACtC,CAAC;IAED,0DAA0D;IAC1D,OAAO,EAAE,CAAC;AACX,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,MAAkB,EAClB,IAAyB,EACzB,UAAe,EAAE;IAEjB,SAAS,CAAC,KAAK,CAAC,wBAAwB,EAAE,qBAAqB,EAAE;QAChE,UAAU,EAAE,MAAM,CAAC,IAAI;QACvB,IAAI;KACJ,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAA+C,EAAE,CAAC;IAExE,gFAAgF;IAChF,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,GAAG,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEhF,SAAS,CAAC,KAAK,CAAC,wBAAwB,EAAE,qBAAqB,EAAE;QAChE,cAAc;QACd,iBAAiB;KACjB,CAAC,CAAC;IAEH,oDAAoD;IACpD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,SAAS,CAAC,KAAK,CAAC,wBAAwB,EAAE,qBAAqB,KAAK,CAAC,IAAI,GAAG,EAAE;YAC7E,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK;SACL,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,iBAAiB,EAAE,CAAC,CAAC;QAEvF,SAAS,CAAC,KAAK,CAAC,wBAAwB,EAAE,UAAU,KAAK,CAAC,IAAI,qBAAqB,EAAE;YACpF,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;SACrB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAE7F,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,gBAAgB,CAAC,IAAI,CAAC;oBACrB,KAAK,EAAE,KAAK,CAAC,IAAI;oBACjB,MAAM,EAAE,aAAa;iBACrB,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;IACF,CAAC;IAED,SAAS,CAAC,KAAK,CAAC,wBAAwB,EAAE,cAAc,EAAE;QACzD,OAAO,EAAE,gBAAgB,CAAC,MAAM,KAAK,CAAC;QACtC,MAAM,EAAE,gBAAgB;KACxB,CAAC,CAAC;IAEH,OAAO;QACN,OAAO,EAAE,gBAAgB,CAAC,MAAM,KAAK,CAAC;QACtC,MAAM,EAAE,gBAAgB;QACxB,cAAc;KACd,CAAC;AACH,CAAC"}

package/dist/lib/graphql/resolvers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolvers.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql/resolvers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAS,MAAM,kBAAkB,CAAC;AA4H1D,wBAAgB,eAAe,CAC9B,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,UAAU,EAAE,EACzB,kBAAkB,GAAE,OAAO,GAAG,WAAyB,uBA2tBvD"}
+{"version":3,"file":"resolvers.d.ts","sourceRoot":"","sources":["../../../src/lib/graphql/resolvers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAS,MAAM,kBAAkB,CAAC;AAyH1D,wBAAgB,eAAe,CAC9B,GAAG,EAAE,YAAY,EACjB,WAAW,EAAE,UAAU,EAAE,EACzB,kBAAkB,GAAE,OAAO,GAAG,WAAyB,uBA4tBvD"}

package/dist/lib/graphql/resolvers.js

@@ -2,9 +2,7 @@ import { GraphQLError } from 'graphql';
 import { authToContext } from '../local-api/auth-helpers.js';
 import { getDefaultValueForFieldType } from '../utils/field-defaults.js';
 import { cmsLogger } from '../utils/logger.js';
-function capitalizeFirst(str) {
-    return str.charAt(0).toUpperCase() + str.slice(1);
-}
+import { toPascalCase, toCamelCase } from '../utils/string-case.js';
 // Normalize null/undefined field values to type-appropriate defaults (recursive)
 function normalizeDocumentFields(data, schemaType, allSchemaTypes) {
     if (!data)
@@ -130,7 +128,7 @@ export function createResolvers(cms, schemaTypes, defaultPerspective = 'publishe
     // Generate reference field resolvers for all types
     function generateReferenceFieldResolvers() {
         schemaTypes.forEach((schemaType) => {
-            const typeName = capitalizeFirst(schemaType.name);
+            const typeName = toPascalCase(schemaType.name);
             function processFields(fields, currentTypeName) {
                 fields.forEach((field) => {
                     // Handle reference fields
@@ -244,7 +242,7 @@ export function createResolvers(cms, schemaTypes, defaultPerspective = 'publishe
                     }
                     // Handle nested objects
                     if (field.type === 'object' && field.fields) {
-                        const nestedTypeName = capitalizeFirst(`${schemaType.name}${field.name}Object`);
+                        const nestedTypeName = toPascalCase(`${schemaType.name}${field.name}Object`);
                         processFields(field.fields, nestedTypeName);
                     }
                 });
@@ -262,11 +260,11 @@ export function createResolvers(cms, schemaTypes, defaultPerspective = 'publishe
                     if (field.type === 'array' && field.of && field.of.length > 1) {
                         const validTypes = field.of.filter((item) => schemaTypes.find((s) => s.name === item.type));
                         if (validTypes.length > 1) {
-                            const unionName = `${capitalizeFirst(parentName)}${capitalizeFirst(field.name)}Item`;
+                            const unionName = `${toPascalCase(parentName)}${toPascalCase(field.name)}Item`;
                             resolvers[unionName] = {
                                 __resolveType(obj) {
                                     if (obj._type) {
-                                        return capitalizeFirst(obj._type);
+                                        return toPascalCase(obj._type);
                                     }
                                     return null;
                                 }
@@ -286,7 +284,8 @@ export function createResolvers(cms, schemaTypes, defaultPerspective = 'publishe
     // Generate resolvers for each document type
     const documentTypes = schemaTypes.filter((type) => type.type === 'document');
     documentTypes.forEach((schemaType) => {
-        const typeName = capitalizeFirst(schemaType.name);
+        const typeName = toPascalCase(schemaType.name);
+        const fieldName = toCamelCase(schemaType.name);
         // Singleton resolvers: no-arg query, no-id mutations.
         // Schema/codegen already differs for singletons (see schema.ts) — the
         // resolver just delegates to the singleton-aware CollectionAPI methods.
@@ -306,7 +305,7 @@ export function createResolvers(cms, schemaTypes, defaultPerspective = 'publishe
                     ...normalizedData
                 };
             };
-            resolvers.Query[schemaType.name] = async (_, args, context) => {
+            resolvers.Query[fieldName] = async (_, args, context) => {
                 try {
                     const { localAPI, auth } = context;
                     const apiContext = authToContext(auth);
@@ -404,7 +403,7 @@ export function createResolvers(cms, schemaTypes, defaultPerspective = 'publishe
             return; // skip the regular per-type resolvers below for singletons
         }
         // Single document resolver: page(id: "123", perspective: "draft")
-        resolvers.Query[schemaType.name] = async (_, args, context) => {
+        resolvers.Query[fieldName] = async (_, args, context) => {
             try {
                 const { localAPI, auth } = context;
                 const apiContext = authToContext(auth);