payload 4.0.0-internal.2fddfc0 → 4.0.0-internal.3aa3d85

package/dist/utilities/configToJSONSchema.d.ts

@@ -4,6 +4,8 @@ import type { SanitizedCollectionConfig } from '../collections/config/types.js';
 import type { SanitizedConfig } from '../config/types.js';
 import type { FlattenedField } from '../fields/config/types.js';
 import type { SanitizedGlobalConfig } from '../globals/config/types.js';
+/** Read (`output`) vs write (`input`) shape: `input` is what `create`/`update` accept. */
+export type SchemaVariant = 'input' | 'output';
 /**
  * Returns a JSON Schema Type with 'null' added if the field is not required.
  */
@@ -37,8 +39,9 @@ export type FieldsToJSONSchemaArgs = {
      * ends up emitted once.
      */
     typeStringDefinitions: Set<string>;
+    variant?: SchemaVariant;
 };
-export declare function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, forceInlineBlocks, i18n, interfaceNameDefinitions, typeStringDefinitions, }: FieldsToJSONSchemaArgs): {
+export declare function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, forceInlineBlocks, i18n, interfaceNameDefinitions, typeStringDefinitions, variant, }: FieldsToJSONSchemaArgs): {
     properties: {
         [k: string]: JSONSchema4;
     };
@@ -46,19 +49,21 @@ export declare function fieldsToJSONSchema({ collectionIDFieldTypes, config, fie
 };
 export declare function entityToJSONSchema(config: SanitizedConfig, entity: SanitizedCollectionConfig | SanitizedGlobalConfig, interfaceNameDefinitions: Map<string, JSONSchema4>, defaultIDType: 'number' | 'text', typeStringDefinitions: Set<string>, collectionIDFieldTypes?: {
     [key: string]: 'number' | 'string';
-}, i18n?: I18n, forceInlineBlocks?: boolean): JSONSchema4;
+}, i18n?: I18n, forceInlineBlocks?: boolean, variant?: SchemaVariant): JSONSchema4;
 /**
  * Like {@link entityToJSONSchema}, but returns a standalone schema for one collection or global:
  * the entity plus only the `$defs` it actually uses, so it resolves on its own rather than
  * as part of the whole config schema.
  *
  * Relationship/upload `$ref`s to other collections are left in place - the caller handles those.
+ * (The `input` variant reduces relationships to IDs, so only rich-text node `$defs` still ref them.)
  */
-export declare function entityToStandaloneJSONSchema({ config, defaultIDType, entity, i18n, }: {
+export declare function entityToStandaloneJSONSchema({ config, defaultIDType, entity, i18n, variant, }: {
     config: SanitizedConfig;
     defaultIDType: 'number' | 'text';
     entity: SanitizedCollectionConfig | SanitizedGlobalConfig;
     i18n?: I18n;
+    variant?: SchemaVariant;
 }): JSONSchema4;
 export declare function fieldsToSelectJSONSchema({ config, fields, interfaceNameDefinitions, }: {
     config: SanitizedConfig;
@@ -74,11 +79,15 @@ export declare function timezonesToJSONSchema(supportedTimezones: SanitizedConfi
  * already uses that name - whether it was auto-generated or an explicit `interfaceName` - this one
  * gets a content-hash suffix (`Hero_3F2A1B0C`) so the two don't overwrite each other. Registering
  * the same block shape again reuses its name.
+ *
+ * The `input` variant adds an `Input` suffix (`HeroInput`) - unless the read-shaped def is already
+ * registered with byte-identical content (a block with nothing that differs between input and
+ * output), in which case it's shared as-is rather than emitting a redundant twin.
  */
 export declare function registerBlockInterface(block: {
     interfaceName?: string;
     slug: string;
-}, blockSchema: JSONSchema4, interfaceNameDefinitions: Map<string, JSONSchema4>): string;
+}, blockSchema: JSONSchema4, interfaceNameDefinitions: Map<string, JSONSchema4>, variant?: SchemaVariant): string;
 /**
  * This is used for generating the TypeScript types (payload-types.ts) with the payload generate:types command.
  */

package/dist/utilities/configToJSONSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configToJSONSchema.d.ts","sourceRoot":"","sources":["../../src/utilities/configToJSONSchema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"configToJSONSchema.d.ts","sourceRoot":"","sources":["../../src/utilities/configToJSONSchema.ts"],"names":[],"mappings":"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"}

package/dist/utilities/configToJSONSchema.js

@@ -1,11 +1,13 @@
 import { createHash } from 'crypto';
 import { MissingEditorProp } from '../errors/MissingEditorProp.js';
-import { fieldAffectsData } from '../fields/config/types.js';
+import { fieldAffectsData, fieldIsVirtual } from '../fields/config/types.js';
 import { generateJobsJSONSchemas } from '../queues/config/generateJobsJSONSchemas.js';
 import { flattenAllFields } from './flattenAllFields.js';
 import { formatNames, toWords } from './formatLabels.js';
 import { getCollectionIDFieldTypes } from './getCollectionIDFieldTypes.js';
 import { optionsAreEqual } from './optionsAreEqual.js';
+// Virtual fields (computed) and join fields (derived from the inverse relationship) are read-only.
+const fieldIsInputExcluded = (field)=>field.type === 'join' || fieldIsVirtual(field);
 const fieldIsRequired = (field)=>{
     const isConditional = Boolean(field?.admin && field?.admin?.condition);
     if (isConditional) {
@@ -61,6 +63,22 @@ function generateEntitySelectSchemas(entities) {
         required: Object.keys(properties)
     };
 }
+function generateEntityInputSchemas(entities) {
+    const properties = [
+        ...entities
+    ].reduce((acc, { slug })=>{
+        acc[slug] = {
+            $ref: `#/$defs/${slug}_input`
+        };
+        return acc;
+    }, {});
+    return {
+        type: 'object',
+        additionalProperties: false,
+        properties,
+        required: Object.keys(properties)
+    };
+}
 function generateCollectionJoinsSchemas(collections) {
     const properties = [
         ...collections
@@ -308,11 +326,35 @@ function entityOrFieldToJsDocs({ entity, i18n }) {
     }
     return description;
 }
-export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, forceInlineBlocks, i18n, interfaceNameDefinitions, typeStringDefinitions }) {
+export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, forceInlineBlocks, i18n, interfaceNameDefinitions, typeStringDefinitions, variant = 'output' }) {
     const requiredFieldNames = new Set();
+    // Registers a named-interface (group/tab/array/select) def and returns its `$ref` name. For input,
+    // shares the read-shaped def when byte-identical; otherwise registers an `Input`-suffixed twin so
+    // the write shape doesn't collide with the read one.
+    const registerNamedInterface = (name, schema)=>{
+        if (variant === 'input') {
+            const outputDef = interfaceNameDefinitions.get(name);
+            if (outputDef && JSON.stringify(outputDef) === JSON.stringify(schema)) {
+                return name;
+            }
+            const inputName = `${name}Input`;
+            interfaceNameDefinitions.set(inputName, schema);
+            return inputName;
+        }
+        interfaceNameDefinitions.set(name, schema);
+        return name;
+    };
     return {
         properties: Object.fromEntries(fields.reduce((fieldSchemas, field, index)=>{
+            if (variant === 'input' && fieldIsInputExcluded(field)) {
+                return fieldSchemas;
+            }
+            const hasDefaultValue = 'defaultValue' in field && field.defaultValue !== undefined;
+            // `isRequired` only controls nullability (a non-required field gets `| null`). It does not
+            // change between variants, so e.g. a defaulted field stays non-null on input.
             const isRequired = fieldAffectsData(field) && fieldIsRequired(field);
+            // `isOptionalOnInput` controls the `?`: on input, defaulted fields can be omitted.
+            const isOptionalOnInput = variant === 'input' && hasDefaultValue;
             const fieldDescription = entityOrFieldToJsDocs({
                 entity: field,
                 i18n
@@ -338,14 +380,14 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
                                     forceInlineBlocks,
                                     i18n,
                                     interfaceNameDefinitions,
-                                    typeStringDefinitions
+                                    typeStringDefinitions,
+                                    variant
                                 })
                             }
                         };
                         if (field.interfaceName) {
-                            interfaceNameDefinitions.set(field.interfaceName, fieldSchema);
                             fieldSchema = {
-                                $ref: `#/$defs/${field.interfaceName}`
+                                $ref: `#/$defs/${registerNamedInterface(field.interfaceName, fieldSchema)}`
                             };
                         }
                         break;
@@ -372,7 +414,8 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
                                         forceInlineBlocks,
                                         i18n,
                                         interfaceNameDefinitions,
-                                        typeStringDefinitions
+                                        typeStringDefinitions,
+                                        variant
                                     });
                                     const blockSchema = {
                                         type: 'object',
@@ -389,7 +432,7 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
                                         ]
                                     };
                                     return forceInlineBlocks ? blockSchema : {
-                                        $ref: `#/$defs/${registerBlockInterface(block, blockSchema, interfaceNameDefinitions)}`
+                                        $ref: `#/$defs/${registerBlockInterface(block, blockSchema, interfaceNameDefinitions, variant)}`
                                     };
                                 })
                             } : {}
@@ -407,6 +450,7 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
                 case 'code':
                 case 'date':
                 case 'email':
+                case 'slug':
                 case 'textarea':
                     {
                         fieldSchema = {
@@ -429,13 +473,13 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
                                     forceInlineBlocks,
                                     i18n,
                                     interfaceNameDefinitions,
-                                    typeStringDefinitions
+                                    typeStringDefinitions,
+                                    variant
                                 })
                             };
                             if (field.interfaceName) {
-                                interfaceNameDefinitions.set(field.interfaceName, fieldSchema);
                                 fieldSchema = {
-                                    $ref: `#/$defs/${field.interfaceName}`
+                                    $ref: `#/$defs/${registerNamedInterface(field.interfaceName, fieldSchema)}`
                                 };
                             }
                         }
@@ -560,9 +604,8 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
                             enum: buildOptionEnums(field.options)
                         };
                         if (field.interfaceName) {
-                            interfaceNameDefinitions.set(field.interfaceName, fieldSchema);
                             fieldSchema = {
-                                $ref: `#/$defs/${field.interfaceName}`
+                                $ref: `#/$defs/${registerNamedInterface(field.interfaceName, fieldSchema)}`
                             };
                         }
                         break;
@@ -570,6 +613,19 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
                 case 'relationship':
                 case 'upload':
                     {
+                        // Read: an ID or the populated doc. Input: only the ID, so drop the `$ref`.
+                        const relationValueSchema = (relation)=>variant === 'input' ? {
+                                type: collectionIDFieldTypes[relation]
+                            } : {
+                                oneOf: [
+                                    {
+                                        type: collectionIDFieldTypes[relation]
+                                    },
+                                    {
+                                        $ref: `#/$defs/${relation}`
+                                    }
+                                ]
+                            };
                         if (Array.isArray(field.relationTo)) {
                             if (field.hasMany) {
                                 fieldSchema = {
@@ -584,16 +640,7 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
                                                     relationTo: {
                                                         const: relation
                                                     },
-                                                    value: {
-                                                        oneOf: [
-                                                            {
-                                                                type: collectionIDFieldTypes[relation]
-                                                            },
-                                                            {
-                                                                $ref: `#/$defs/${relation}`
-                                                            }
-                                                        ]
-                                                    }
+                                                    value: relationValueSchema(relation)
                                                 },
                                                 required: [
                                                     'value',
@@ -614,16 +661,7 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
                                                 relationTo: {
                                                     const: relation
                                                 },
-                                                value: {
-                                                    oneOf: [
-                                                        {
-                                                            type: collectionIDFieldTypes[relation]
-                                                        },
-                                                        {
-                                                            $ref: `#/$defs/${relation}`
-                                                        }
-                                                    ]
-                                                }
+                                                value: relationValueSchema(relation)
                                             },
                                             required: [
                                                 'value',
@@ -637,7 +675,9 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
                             fieldSchema = {
                                 ...baseFieldSchema,
                                 type: withNullableJSONSchemaType('array', isRequired),
-                                items: {
+                                items: variant === 'input' ? {
+                                    type: collectionIDFieldTypes[field.relationTo]
+                                } : {
                                     oneOf: [
                                         {
                                             type: collectionIDFieldTypes[field.relationTo]
@@ -648,6 +688,11 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
                                     ]
                                 }
                             };
+                        } else if (variant === 'input') {
+                            fieldSchema = {
+                                ...baseFieldSchema,
+                                type: withNullableJSONSchemaType(collectionIDFieldTypes[field.relationTo], isRequired)
+                            };
                         } else {
                             fieldSchema = {
                                 ...baseFieldSchema,
@@ -682,7 +727,8 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
                                     i18n,
                                     interfaceNameDefinitions,
                                     isRequired,
-                                    typeStringDefinitions
+                                    typeStringDefinitions,
+                                    variant
                                 })
                             };
                         } else {
@@ -735,9 +781,8 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
                                 }
                             }
                             if (field.interfaceName) {
-                                interfaceNameDefinitions.set(field.interfaceName, fieldSchema);
                                 fieldSchema = {
-                                    $ref: `#/$defs/${field.interfaceName}`
+                                    $ref: `#/$defs/${registerNamedInterface(field.interfaceName, fieldSchema)}`
                                 };
                             }
                             break;
@@ -757,13 +802,13 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
                                 forceInlineBlocks,
                                 i18n,
                                 interfaceNameDefinitions,
-                                typeStringDefinitions
+                                typeStringDefinitions,
+                                variant
                             })
                         };
                         if (field.interfaceName) {
-                            interfaceNameDefinitions.set(field.interfaceName, fieldSchema);
                             fieldSchema = {
-                                $ref: `#/$defs/${field.interfaceName}`
+                                $ref: `#/$defs/${registerNamedInterface(field.interfaceName, fieldSchema)}`
                             };
                         }
                         break;
@@ -792,12 +837,13 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
             if ('jsonSchema' in field && field?.jsonSchema?.length) {
                 for (const schema of field.jsonSchema){
                     fieldSchema = schema({
-                        jsonSchema: fieldSchema
+                        jsonSchema: fieldSchema,
+                        variant
                     });
                 }
             }
             if (fieldSchema && fieldAffectsData(field)) {
-                if (isRequired && fieldSchema.required !== false) {
+                if (isRequired && !isOptionalOnInput && fieldSchema.required !== false) {
                     requiredFieldNames.add(field.name);
                 }
                 fieldSchemas.set(field.name, fieldSchema);
@@ -808,17 +854,21 @@ export function fieldsToJSONSchema({ collectionIDFieldTypes, config, fields, for
     };
 }
 // This function is part of the public API and is exported through payload/utilities
-export function entityToJSONSchema(config, entity, interfaceNameDefinitions, defaultIDType, typeStringDefinitions, collectionIDFieldTypes, i18n, forceInlineBlocks) {
+export function entityToJSONSchema(config, entity, interfaceNameDefinitions, defaultIDType, typeStringDefinitions, collectionIDFieldTypes, i18n, forceInlineBlocks, variant = 'output') {
     if (!collectionIDFieldTypes) {
         collectionIDFieldTypes = getCollectionIDFieldTypes({
             config,
             defaultIDType
         });
     }
-    const title = entity.typescript?.interface ? entity.typescript.interface : formatNames(entity.slug).singular;
+    const isInput = variant === 'input';
+    const baseTitle = entity.typescript?.interface ? entity.typescript.interface : formatNames(entity.slug).singular;
+    const title = isInput ? `${baseTitle}Input` : baseTitle;
     let mutableFields = [
         ...entity.flattenedFields
     ];
+    // `required: true` keeps `id` non-null. On input it's made optional further below (it's dropped
+    // from `required`) so you can omit it or pass a custom ID, but it's still never `null`.
     const idField = {
         name: 'id',
         type: defaultIDType,
@@ -826,20 +876,18 @@ export function entityToJSONSchema(config, entity, interfaceNameDefinitions, def
     };
     const customIdField = mutableFields.find((field)=>field.name === 'id');
     if (customIdField && customIdField.type !== 'group' && customIdField.type !== 'tab') {
-        mutableFields = mutableFields.map((field)=>{
-            if (field === customIdField) {
-                return {
-                    ...field,
-                    required: true
-                };
-            }
-            return field;
-        });
+        mutableFields = mutableFields.map((field)=>field === customIdField ? {
+                ...field,
+                required: true
+            } : field);
     } else {
         mutableFields.unshift(idField);
     }
-    // mark timestamp fields required
-    if ('timestamps' in entity && entity.timestamps !== false) {
+    if (isInput) {
+        // Managed by Payload, not set by a client.
+        mutableFields = mutableFields.filter((field)=>field.name !== 'createdAt' && field.name !== 'updatedAt' && field.name !== '_status');
+    } else if ('timestamps' in entity && entity.timestamps !== false) {
+        // mark timestamp fields required
         mutableFields = mutableFields.map((field)=>{
             if (field.name === 'createdAt' || field.name === 'updatedAt') {
                 return {
@@ -864,10 +912,16 @@ export function entityToJSONSchema(config, entity, interfaceNameDefinitions, def
         forceInlineBlocks,
         i18n,
         interfaceNameDefinitions,
-        typeStringDefinitions
+        typeStringDefinitions,
+        variant
     });
-    // Add collection property to auth collections
-    if (isAuthCollection) {
+    // On input, `id` is optional (omit it, or pass a custom ID). Removing it from `required` makes
+    // it optional without making it nullable.
+    if (isInput && Array.isArray(fieldsSchema.required)) {
+        fieldsSchema.required = fieldsSchema.required.filter((name)=>name !== 'id');
+    }
+    // The `User`-union discriminator (read-side, e.g. `req.user`); not part of create/update data.
+    if (isAuthCollection && !isInput) {
         fieldsSchema.properties = {
             ...fieldsSchema.properties,
             collection: {
@@ -903,10 +957,11 @@ export function entityToJSONSchema(config, entity, interfaceNameDefinitions, def
  * as part of the whole config schema.
  *
  * Relationship/upload `$ref`s to other collections are left in place - the caller handles those.
- */ export function entityToStandaloneJSONSchema({ config, defaultIDType, entity, i18n }) {
+ * (The `input` variant reduces relationships to IDs, so only rich-text node `$defs` still ref them.)
+ */ export function entityToStandaloneJSONSchema({ config, defaultIDType, entity, i18n, variant = 'output' }) {
     const definitions = new Map();
     // entityToJSONSchema fills `definitions` with everything the fields reference (node unions, blocks).
-    const schema = entityToJSONSchema(config, entity, definitions, defaultIDType, new Set(), undefined, i18n, true);
+    const schema = entityToJSONSchema(config, entity, definitions, defaultIDType, new Set(), undefined, i18n, true, variant);
     // Timezone fields `$ref` supportedTimezones, which lives on the root config schema, so add it here.
     const supportedTimezones = config.admin?.timezones?.supportedTimezones;
     if (supportedTimezones?.length && schemaHasRef([
@@ -1213,8 +1268,19 @@ const hashBlockSchema = (schema)=>createHash('sha256').update(JSON.stringify(sch
  * already uses that name - whether it was auto-generated or an explicit `interfaceName` - this one
  * gets a content-hash suffix (`Hero_3F2A1B0C`) so the two don't overwrite each other. Registering
  * the same block shape again reuses its name.
- */ export function registerBlockInterface(block, blockSchema, interfaceNameDefinitions) {
-    const baseName = block.interfaceName ?? toWords(block.slug, true);
+ *
+ * The `input` variant adds an `Input` suffix (`HeroInput`) - unless the read-shaped def is already
+ * registered with byte-identical content (a block with nothing that differs between input and
+ * output), in which case it's shared as-is rather than emitting a redundant twin.
+ */ export function registerBlockInterface(block, blockSchema, interfaceNameDefinitions, variant = 'output') {
+    const rawName = block.interfaceName ?? toWords(block.slug, true);
+    if (variant === 'input') {
+        const outputDef = interfaceNameDefinitions.get(rawName);
+        if (outputDef && hashBlockSchema(outputDef) === hashBlockSchema(blockSchema)) {
+            return rawName;
+        }
+    }
+    const baseName = variant === 'input' ? `${rawName}Input` : rawName;
     const existing = interfaceNameDefinitions.get(baseName);
     // The name is free - claim it.
     if (!existing) {
@@ -1261,8 +1327,12 @@ const hashBlockSchema = (schema)=>createHash('sha256').update(JSON.stringify(sch
                 entity: collection
             }))
     ];
+    const generateInputTypes = config.typescript?.generateInputTypes === true;
     const entityDefinitions = entities.reduce((acc, { type, entity })=>{
         acc[entity.slug] = entityToJSONSchema(config, entity, interfaceNameDefinitions, defaultIDType, typeStringDefinitions, collectionIDFieldTypes, i18n, forceInlineBlocks);
+        if (generateInputTypes) {
+            acc[`${entity.slug}_input`] = entityToJSONSchema(config, entity, interfaceNameDefinitions, defaultIDType, typeStringDefinitions, collectionIDFieldTypes, i18n, forceInlineBlocks, 'input');
+        }
         const select = fieldsToSelectJSONSchema({
             config,
             fields: entity.flattenedFields,
@@ -1359,6 +1429,10 @@ const hashBlockSchema = (schema)=>createHash('sha256').update(JSON.stringify(sch
             globalsSelect: generateEntitySelectSchemas(config.globals || []),
             locale: generateLocaleEntitySchemas(config.localization),
             widgets: widgetSchemas.schema,
+            ...generateInputTypes ? {
+                collectionsInput: generateEntityInputSchemas(config.collections || []),
+                globalsInput: generateEntityInputSchemas(config.globals || [])
+            } : {},
             ...config.typescript?.strictDraftTypes ? {
                 strictDraftTypes: {
                     type: 'boolean',
@@ -1375,6 +1449,10 @@ const hashBlockSchema = (schema)=>createHash('sha256').update(JSON.stringify(sch
             'collectionsSelect',
             'collectionsJoins',
             'globalsSelect',
+            ...generateInputTypes ? [
+                'collectionsInput',
+                'globalsInput'
+            ] : [],
             ...config.typescript?.strictDraftTypes ? [
                 'strictDraftTypes'
             ] : [],