@datocms/cma-client 5.0.0 → 5.1.0

package/dist/types/fieldTypes/validators/size.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Only accept a number of items within the specified range.
+ */
+export type SizeValidator = {
+    /** Minimum length */
+    min: number /** Expected length */;
+    eq?: number /** Maximum length */;
+    max?: number /** The number of items must be multiple of this value */;
+    multiple_of?: number;
+} | {
+    /** Minimum length */
+    min?: number /** Expected length */;
+    eq: number /** Maximum length */;
+    max?: number /** The number of items must be multiple of this value */;
+    multiple_of?: number;
+} | {
+    /** Minimum length */
+    min?: number /** Expected length */;
+    eq?: number /** Maximum length */;
+    max: number /** The number of items must be multiple of this value */;
+    multiple_of?: number;
+} | {
+    /** Minimum length */
+    min?: number /** Expected length */;
+    eq?: number /** Maximum length */;
+    max?: number /** The number of items must be multiple of this value */;
+    multiple_of: number;
+};

package/dist/types/fieldTypes/validators/slug_format.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Only accept slugs having a specific format.
+ */
+export type SlugFormatValidator = {
+    /** Regular expression to be validated */
+    custom_pattern: string;
+    predefined_pattern?: never;
+} | {
+    custom_pattern?: never;
+    /** Allowed format */
+    predefined_pattern: 'webpage_slug';
+};

package/dist/types/fieldTypes/validators/slug_title_field.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Specifies the ID of the Single-line string field that will be used to generate the slug.
+ */
+export type SlugTitleFieldValidator = {
+    /** The field that will be used to generate the slug */
+    title_field_id: string;
+};

package/dist/types/fieldTypes/validators/structured_text_blocks.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Only accept references to block records of the specified block models.
+ */
+export type StructuredTextBlocksValidator = {
+    /** Set of allowed Block Model IDs */
+    item_types: string[];
+};

package/dist/types/fieldTypes/validators/structured_text_inline_blocks.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Only accept references to block records of the specified block models.
+ */
+export type StructuredTextInlineBlocksValidator = {
+    /** Set of allowed Block Model IDs */
+    item_types: string[];
+};

package/dist/types/fieldTypes/validators/structured_text_links.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Only accept `itemLink` to `inlineItem` nodes for records of the specified models.
+ */
+export type StructuredTextLinksValidator = {
+    /** Set of allowed model IDs */
+    item_types: string[];
+    /**
+     * Strategy to apply when a publishing is requested and this field references some unpublished records.
+     * - "fail": Fail the operation and notify the user
+     * - "publish_references": Publish also the referenced records
+     * @default "fail"
+     */
+    on_publish_with_unpublished_references_strategy?: 'fail' | 'publish_references';
+    /**
+     * Strategy to apply when unpublishing is requested for a record referenced by this field.
+     * - "fail": Fail the operation and notify the user
+     * - "unpublish": Unpublish also this record
+     * - "delete_references": Try to remove the reference to the unpublished record (if the field has a required validation it will fail)
+     * @default "delete_references"
+     */
+    on_reference_unpublish_strategy?: 'fail' | 'unpublish' | 'delete_references';
+    /**
+     * Strategy to apply when deletion is requested for a record referenced by this field.
+     * - "fail": Fail the operation and notify the user
+     * - "delete_references": Try to remove the reference to the deleted record (if the field has a required validation it will fail)
+     * @default "delete_references"
+     */
+    on_reference_delete_strategy?: 'fail' | 'delete_references';
+};

package/dist/types/fieldTypes/validators/title_length.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Limits the length of the title for a SEO field.
+ * Search engines usually truncate title tags to 60 characters so it is a good practice to keep the title around this length.
+ */
+export type TitleLengthValidator = {
+    /** Minimum value */ min: number /** Maximum value */;
+    max?: number;
+} | {
+    /** Minimum value */ min?: number /** Maximum value */;
+    max: number;
+};

package/dist/types/fieldTypes/validators/unique.d.ts

@@ -0,0 +1,4 @@
+/**
+ * The value must be unique across the whole collection of records.
+ */
+export type UniqueValidator = Record<string, never>;

package/dist/types/fieldTypes/video.d.ts

@@ -0,0 +1,25 @@
+import type { VideoEditorConfiguration } from './appearance/video';
+import type { RequiredValidator } from './validators/required';
+export type VideoFieldValue = {
+    provider: 'youtube' | 'vimeo' | 'facebook';
+    provider_uid: string;
+    url: string;
+    width: number;
+    height: number;
+    thumbnail_url: string;
+    title: string;
+} | null;
+export declare function isVideoFieldValue(value: unknown): value is VideoFieldValue;
+export type VideoFieldValidators = {
+    /** Value must be specified or it won't be valid */
+    required?: RequiredValidator;
+};
+export type VideoFieldAppearance = {
+    editor: 'video';
+    parameters: VideoEditorConfiguration;
+} | {
+    /** Plugin ID */
+    editor: string;
+    /** Plugin configuration */
+    parameters: Record<string, unknown>;
+};

package/dist/types/generated/SchemaTypes.d.ts

@@ -1,3 +1,67 @@
+import type { BooleanFieldAppearance, BooleanFieldValidators, BooleanFieldValue, ColorFieldAppearance, ColorFieldValidators, ColorFieldValue, DateFieldAppearance, DateFieldValidators, DateFieldValue, DateTimeFieldAppearance, DateTimeFieldValidators, DateTimeFieldValue, FileFieldAppearance, FileFieldValidators, FloatFieldAppearance, FloatFieldValidators, FloatFieldValue, GalleryFieldAppearance, GalleryFieldValidators, IntegerFieldAppearance, IntegerFieldValidators, IntegerFieldValue, JsonFieldAppearance, JsonFieldValidators, JsonFieldValue, LinkFieldAppearance, LinkFieldValidators, LinksFieldAppearance, LinksFieldValidators, LocationFieldAppearance, LocationFieldValidators, LocationFieldValue, RichTextFieldAppearance, RichTextFieldValidators, SeoFieldAppearance, SeoFieldValidators, SingleBlockFieldAppearance, SingleBlockFieldValidators, SlugFieldAppearance, SlugFieldValidators, StringFieldAppearance, StringFieldValidators, StringFieldValue, StructuredTextFieldAppearance, StructuredTextFieldValidators, TextFieldAppearance, TextFieldValidators, TextFieldValue, VideoFieldAppearance, VideoFieldValidators } from '../fieldTypes';
+/**
+ * Enhanced appearance configuration with field-specific types and addon support
+ */
+type FieldAppearanceConfig<TAppearance> = TAppearance & Omit<RawFieldAttributes['appearance'], keyof TAppearance>;
+/**
+ * Base field configuration for attributes (non-localized), extending the original SchemaTypes
+ */
+type NonLocalizedFieldAttributesForFieldType<SourceType, FieldType extends RawFieldAttributes['field_type'], FieldValue, FieldValidators, FieldAppearance> = Omit<SourceType, 'field_type' | 'default_value' | 'validators' | 'appearance' | 'localized'> & {
+    field_type: FieldType;
+    localized: false;
+    default_value: FieldValue;
+    validators: FieldValidators;
+    appearance: FieldAppearanceConfig<FieldAppearance>;
+};
+/**
+ * Base field configuration for attributes (localized), extending the original SchemaTypes
+ */
+type LocalizedFieldAttributesForFieldType<SourceType, FieldType extends RawFieldAttributes['field_type'], FieldValue, FieldValidators, FieldAppearance> = Omit<SourceType, 'field_type' | 'default_value' | 'validators' | 'appearance' | 'localized'> & {
+    field_type: FieldType;
+    localized: true;
+    default_value: FieldValue | Record<string, FieldValue>;
+    validators: FieldValidators;
+    appearance: FieldAppearanceConfig<FieldAppearance>;
+};
+/**
+ * Union of localized and non-localized field configurations for attributes
+ */
+type FieldAttributesForFieldType<SourceType, FieldType extends RawFieldAttributes['field_type'], FieldValue, FieldValidators, FieldAppearance> = NonLocalizedFieldAttributesForFieldType<SourceType, FieldType, FieldValue, FieldValidators, FieldAppearance> | LocalizedFieldAttributesForFieldType<SourceType, FieldType, FieldValue, FieldValidators, FieldAppearance>;
+type GenericFieldAttributes<SourceType> = FieldAttributesForFieldType<SourceType, 'boolean', BooleanFieldValue, BooleanFieldValidators, BooleanFieldAppearance> | FieldAttributesForFieldType<SourceType, 'color', ColorFieldValue, ColorFieldValidators, ColorFieldAppearance> | FieldAttributesForFieldType<SourceType, 'date', DateFieldValue, DateFieldValidators, DateFieldAppearance> | FieldAttributesForFieldType<SourceType, 'date_time', DateTimeFieldValue, DateTimeFieldValidators, DateTimeFieldAppearance> | FieldAttributesForFieldType<SourceType, 'file', null, FileFieldValidators, FileFieldAppearance> | FieldAttributesForFieldType<SourceType, 'float', FloatFieldValue, FloatFieldValidators, FloatFieldAppearance> | FieldAttributesForFieldType<SourceType, 'gallery', null, GalleryFieldValidators, GalleryFieldAppearance> | FieldAttributesForFieldType<SourceType, 'integer', IntegerFieldValue, IntegerFieldValidators, IntegerFieldAppearance> | FieldAttributesForFieldType<SourceType, 'json', JsonFieldValue, JsonFieldValidators, JsonFieldAppearance> | FieldAttributesForFieldType<SourceType, 'lat_lon', LocationFieldValue, LocationFieldValidators, LocationFieldAppearance> | FieldAttributesForFieldType<SourceType, 'link', null, LinkFieldValidators, LinkFieldAppearance> | FieldAttributesForFieldType<SourceType, 'links', null, LinksFieldValidators, LinksFieldAppearance> | FieldAttributesForFieldType<SourceType, 'rich_text', null, RichTextFieldValidators, RichTextFieldAppearance> | FieldAttributesForFieldType<SourceType, 'seo', null, SeoFieldValidators, SeoFieldAppearance> | FieldAttributesForFieldType<SourceType, 'single_block', null, SingleBlockFieldValidators, SingleBlockFieldAppearance> | FieldAttributesForFieldType<SourceType, 'slug', null, SlugFieldValidators, SlugFieldAppearance> | FieldAttributesForFieldType<SourceType, 'string', StringFieldValue, StringFieldValidators, StringFieldAppearance> | FieldAttributesForFieldType<SourceType, 'structured_text', null, StructuredTextFieldValidators, StructuredTextFieldAppearance> | FieldAttributesForFieldType<SourceType, 'text', TextFieldValue, TextFieldValidators, TextFieldAppearance> | FieldAttributesForFieldType<SourceType, 'video', null, VideoFieldValidators, VideoFieldAppearance>;
+export type FieldAttributes = GenericFieldAttributes<RawFieldAttributes>;
+export type Field = RawField;
+/**
+ * Helper type to conditionally handle default values based on localization for field creation
+ */
+type FieldCreateDefaultValue<T> = T | Record<string, T> | undefined;
+type FieldCreateConfigForFieldType<SourceType, FieldType extends RawFieldAttributes['field_type'], FieldValue, FieldValidators, FieldAppearance> = Omit<SourceType, 'field_type' | 'default_value' | 'validators' | 'appearance'> & {
+    field_type: FieldType;
+    default_value?: FieldCreateDefaultValue<FieldValue>;
+    validators?: FieldValidators;
+    appearance?: FieldAppearanceConfig<FieldAppearance>;
+};
+type FieldCreateConfig<SourceType> = FieldCreateConfigForFieldType<SourceType, 'boolean', BooleanFieldValue, BooleanFieldValidators, BooleanFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'color', ColorFieldValue, ColorFieldValidators, ColorFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'date', DateFieldValue, DateFieldValidators, DateFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'date_time', DateTimeFieldValue, DateTimeFieldValidators, DateTimeFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'file', null, FileFieldValidators, FileFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'float', FloatFieldValue, FloatFieldValidators, FloatFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'gallery', null, GalleryFieldValidators, GalleryFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'integer', IntegerFieldValue, IntegerFieldValidators, IntegerFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'json', JsonFieldValue, JsonFieldValidators, JsonFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'lat_lon', LocationFieldValue, LocationFieldValidators, LocationFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'link', null, LinkFieldValidators, LinkFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'links', null, LinksFieldValidators, LinksFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'rich_text', null, RichTextFieldValidators, RichTextFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'seo', null, SeoFieldValidators, SeoFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'single_block', null, SingleBlockFieldValidators, SingleBlockFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'slug', null, SlugFieldValidators, SlugFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'string', StringFieldValue, StringFieldValidators, StringFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'structured_text', null, StructuredTextFieldValidators, StructuredTextFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'text', TextFieldValue, TextFieldValidators, TextFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'video', null, VideoFieldValidators, VideoFieldAppearance>;
+export type FieldCreateSchema = Omit<RawFieldCreateSchema, 'data'> & {
+    data: Omit<RawFieldCreateSchema['data'], 'attributes'> & {
+        attributes: FieldCreateConfig<RawFieldCreateSchema['data']['attributes']>;
+    };
+};
+/**
+ * Helper type to conditionally handle default values based on localization for field updates
+ */
+type FieldUpdateDefaultValue<T> = T | Record<string, T> | undefined;
+type FieldUpdateConfigForFieldType<SourceType, FieldType extends RawFieldAttributes['field_type'], FieldValue, FieldValidators, FieldAppearance> = Omit<SourceType, 'field_type' | 'default_value' | 'validators' | 'appearance'> & {
+    field_type?: FieldType;
+    default_value?: FieldUpdateDefaultValue<FieldValue>;
+    validators?: FieldValidators;
+    appearance?: FieldAppearanceConfig<FieldAppearance>;
+};
+type FieldUpdateConfig<SourceType> = FieldUpdateConfigForFieldType<SourceType, 'boolean', BooleanFieldValue, BooleanFieldValidators, BooleanFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'color', ColorFieldValue, ColorFieldValidators, ColorFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'date', DateFieldValue, DateFieldValidators, DateFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'date_time', DateTimeFieldValue, DateTimeFieldValidators, DateTimeFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'file', null, FileFieldValidators, FileFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'float', FloatFieldValue, FloatFieldValidators, FloatFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'gallery', null, GalleryFieldValidators, GalleryFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'integer', IntegerFieldValue, IntegerFieldValidators, IntegerFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'json', JsonFieldValue, JsonFieldValidators, JsonFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'lat_lon', LocationFieldValue, LocationFieldValidators, LocationFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'link', null, LinkFieldValidators, LinkFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'links', null, LinksFieldValidators, LinksFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'rich_text', null, RichTextFieldValidators, RichTextFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'seo', null, SeoFieldValidators, SeoFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'single_block', null, SingleBlockFieldValidators, SingleBlockFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'slug', null, SlugFieldValidators, SlugFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'string', StringFieldValue, StringFieldValidators, StringFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'structured_text', null, StructuredTextFieldValidators, StructuredTextFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'text', TextFieldValue, TextFieldValidators, TextFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'video', null, VideoFieldValidators, VideoFieldAppearance>;
+export type FieldUpdateSchema = Omit<RawFieldUpdateSchema, 'data'> & {
+    data: Omit<RawFieldUpdateSchema['data'], 'attributes'> & {
+        attributes: FieldUpdateConfig<RawFieldUpdateSchema['data']['attributes']>;
+    };
+};
 /**
  * This file was automatically generated by hyperschema-to-ts: DO NOT MODIFY IT BY HAND.
  */
@@ -5544,7 +5608,7 @@ export type ItemTypeReorderFieldsAndFieldsetsJobSchema = {
  * This interface was referenced by `DatoApi`'s JSON-Schema
  * via the `definition` "field".
  */
-export type Field = {
+export type RawField = {
     type: FieldType;
     id: FieldIdentity;
     attributes: FieldAttributes;
@@ -5556,7 +5620,7 @@ export type Field = {
  * This interface was referenced by `Field`'s JSON-Schema
  * via the `definition` "attributes".
  */
-export type FieldAttributes = {
+export type RawFieldAttributes = {
     /**
      * The label of the field
      */
@@ -5669,7 +5733,7 @@ export type FieldRelationships = {
  * This interface was referenced by `Field`'s JSON-Schema
  * via the `create.schema` link.
  */
-export type FieldCreateSchema = {
+export type RawFieldCreateSchema = {
     data: {
         id?: FieldIdentity;
         type: FieldType;
@@ -5797,7 +5861,7 @@ export type FieldCreateJobSchema = {
  * This interface was referenced by `Field`'s JSON-Schema
  * via the `update.schema` link.
  */
-export type FieldUpdateSchema = {
+export type RawFieldUpdateSchema = {
     data: {
         type: FieldType;
         id: FieldIdentity;
@@ -7600,7 +7664,7 @@ export type ItemBulkMoveToStageJobSchema = {
     };
 };
 /**
- * Every file you upload to DatoCMS will be retrievable from this endpoint.
+ * Each media object you upload to the Media Area of your DatoCMS project is represented as an `upload` entity.
  *
  * This interface was referenced by `DatoApi`'s JSON-Schema
  * via the `definition` "upload".
@@ -8158,7 +8222,7 @@ export type UploadBulkDestroyJobSchema = {
     };
 };
 /**
- * To upload a file in DatoCMS, first you need to obtain an upload permission through this API endpoint. The response will contain the S3 URL where you will be able to upload the file with a direct PUT request.
+ * To upload a file with the Content Management API, first you need to obtain an upload permission. The `upload_request` entity contains the S3-like URL where you will be able to upload the file with a raw/binary PUT request.
  *
  * This interface was referenced by `DatoApi`'s JSON-Schema
  * via the `definition` "upload_request".
@@ -8176,7 +8240,7 @@ export type UploadRequest = {
  */
 export type UploadRequestAttributes = {
     /**
-     * The URL to use to upload the file with a direct PUT request
+     * The URL to use to upload the file with a raw/binary PUT request
      */
     url: string;
     /**
@@ -11345,3 +11409,4 @@ export type WorkflowInstancesTargetSchema = {
 export type WorkflowSelfTargetSchema = {
     data: Workflow;
 };
+export {};

package/dist/types/generated/SimpleSchemaTypes.d.ts

@@ -1,3 +1,59 @@
+import type { BooleanFieldAppearance, BooleanFieldValidators, BooleanFieldValue, ColorFieldAppearance, ColorFieldValidators, ColorFieldValue, DateFieldAppearance, DateFieldValidators, DateFieldValue, DateTimeFieldAppearance, DateTimeFieldValidators, DateTimeFieldValue, FileFieldAppearance, FileFieldValidators, FloatFieldAppearance, FloatFieldValidators, FloatFieldValue, GalleryFieldAppearance, GalleryFieldValidators, IntegerFieldAppearance, IntegerFieldValidators, IntegerFieldValue, JsonFieldAppearance, JsonFieldValidators, JsonFieldValue, LinkFieldAppearance, LinkFieldValidators, LinksFieldAppearance, LinksFieldValidators, LocationFieldAppearance, LocationFieldValidators, LocationFieldValue, RichTextFieldAppearance, RichTextFieldValidators, SeoFieldAppearance, SeoFieldValidators, SingleBlockFieldAppearance, SingleBlockFieldValidators, SlugFieldAppearance, SlugFieldValidators, StringFieldAppearance, StringFieldValidators, StringFieldValue, StructuredTextFieldAppearance, StructuredTextFieldValidators, TextFieldAppearance, TextFieldValidators, TextFieldValue, VideoFieldAppearance, VideoFieldValidators } from '../fieldTypes';
+/**
+ * Enhanced appearance configuration with field-specific types and addon support
+ */
+type FieldAppearanceConfig<TAppearance> = TAppearance & Omit<RawFieldAttributes['appearance'], keyof TAppearance>;
+/**
+ * Base field configuration for attributes (non-localized), extending the original SchemaTypes
+ */
+type NonLocalizedFieldAttributesForFieldType<SourceType, FieldType extends RawFieldAttributes['field_type'], FieldValue, FieldValidators, FieldAppearance> = Omit<SourceType, 'field_type' | 'default_value' | 'validators' | 'appearance' | 'localized'> & {
+    field_type: FieldType;
+    localized: false;
+    default_value: FieldValue;
+    validators: FieldValidators;
+    appearance: FieldAppearanceConfig<FieldAppearance>;
+};
+/**
+ * Base field configuration for attributes (localized), extending the original SchemaTypes
+ */
+type LocalizedFieldAttributesForFieldType<SourceType, FieldType extends RawFieldAttributes['field_type'], FieldValue, FieldValidators, FieldAppearance> = Omit<SourceType, 'field_type' | 'default_value' | 'validators' | 'appearance' | 'localized'> & {
+    field_type: FieldType;
+    localized: true;
+    default_value: FieldValue | Record<string, FieldValue>;
+    validators: FieldValidators;
+    appearance: FieldAppearanceConfig<FieldAppearance>;
+};
+/**
+ * Union of localized and non-localized field configurations for attributes
+ */
+type FieldAttributesForFieldType<SourceType, FieldType extends RawFieldAttributes['field_type'], FieldValue, FieldValidators, FieldAppearance> = NonLocalizedFieldAttributesForFieldType<SourceType, FieldType, FieldValue, FieldValidators, FieldAppearance> | LocalizedFieldAttributesForFieldType<SourceType, FieldType, FieldValue, FieldValidators, FieldAppearance>;
+type GenericFieldAttributes<SourceType> = FieldAttributesForFieldType<SourceType, 'boolean', BooleanFieldValue, BooleanFieldValidators, BooleanFieldAppearance> | FieldAttributesForFieldType<SourceType, 'color', ColorFieldValue, ColorFieldValidators, ColorFieldAppearance> | FieldAttributesForFieldType<SourceType, 'date', DateFieldValue, DateFieldValidators, DateFieldAppearance> | FieldAttributesForFieldType<SourceType, 'date_time', DateTimeFieldValue, DateTimeFieldValidators, DateTimeFieldAppearance> | FieldAttributesForFieldType<SourceType, 'file', null, FileFieldValidators, FileFieldAppearance> | FieldAttributesForFieldType<SourceType, 'float', FloatFieldValue, FloatFieldValidators, FloatFieldAppearance> | FieldAttributesForFieldType<SourceType, 'gallery', null, GalleryFieldValidators, GalleryFieldAppearance> | FieldAttributesForFieldType<SourceType, 'integer', IntegerFieldValue, IntegerFieldValidators, IntegerFieldAppearance> | FieldAttributesForFieldType<SourceType, 'json', JsonFieldValue, JsonFieldValidators, JsonFieldAppearance> | FieldAttributesForFieldType<SourceType, 'lat_lon', LocationFieldValue, LocationFieldValidators, LocationFieldAppearance> | FieldAttributesForFieldType<SourceType, 'link', null, LinkFieldValidators, LinkFieldAppearance> | FieldAttributesForFieldType<SourceType, 'links', null, LinksFieldValidators, LinksFieldAppearance> | FieldAttributesForFieldType<SourceType, 'rich_text', null, RichTextFieldValidators, RichTextFieldAppearance> | FieldAttributesForFieldType<SourceType, 'seo', null, SeoFieldValidators, SeoFieldAppearance> | FieldAttributesForFieldType<SourceType, 'single_block', null, SingleBlockFieldValidators, SingleBlockFieldAppearance> | FieldAttributesForFieldType<SourceType, 'slug', null, SlugFieldValidators, SlugFieldAppearance> | FieldAttributesForFieldType<SourceType, 'string', StringFieldValue, StringFieldValidators, StringFieldAppearance> | FieldAttributesForFieldType<SourceType, 'structured_text', null, StructuredTextFieldValidators, StructuredTextFieldAppearance> | FieldAttributesForFieldType<SourceType, 'text', TextFieldValue, TextFieldValidators, TextFieldAppearance> | FieldAttributesForFieldType<SourceType, 'video', null, VideoFieldValidators, VideoFieldAppearance>;
+export type FieldAttributes = GenericFieldAttributes<RawFieldAttributes>;
+export type Field = GenericFieldAttributes<RawField>;
+/**
+ * Helper type to conditionally handle default values based on localization for field creation
+ */
+type FieldCreateDefaultValue<T> = T | Record<string, T> | undefined;
+type FieldCreateConfigForFieldType<SourceType, FieldType extends RawFieldAttributes['field_type'], FieldValue, FieldValidators, FieldAppearance> = Omit<SourceType, 'field_type' | 'default_value' | 'validators' | 'appearance'> & {
+    field_type: FieldType;
+    default_value?: FieldCreateDefaultValue<FieldValue>;
+    validators?: FieldValidators;
+    appearance?: FieldAppearanceConfig<FieldAppearance>;
+};
+type FieldCreateConfig<SourceType> = FieldCreateConfigForFieldType<SourceType, 'boolean', BooleanFieldValue, BooleanFieldValidators, BooleanFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'color', ColorFieldValue, ColorFieldValidators, ColorFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'date', DateFieldValue, DateFieldValidators, DateFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'date_time', DateTimeFieldValue, DateTimeFieldValidators, DateTimeFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'file', null, FileFieldValidators, FileFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'float', FloatFieldValue, FloatFieldValidators, FloatFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'gallery', null, GalleryFieldValidators, GalleryFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'integer', IntegerFieldValue, IntegerFieldValidators, IntegerFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'json', JsonFieldValue, JsonFieldValidators, JsonFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'lat_lon', LocationFieldValue, LocationFieldValidators, LocationFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'link', null, LinkFieldValidators, LinkFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'links', null, LinksFieldValidators, LinksFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'rich_text', null, RichTextFieldValidators, RichTextFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'seo', null, SeoFieldValidators, SeoFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'single_block', null, SingleBlockFieldValidators, SingleBlockFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'slug', null, SlugFieldValidators, SlugFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'string', StringFieldValue, StringFieldValidators, StringFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'structured_text', null, StructuredTextFieldValidators, StructuredTextFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'text', TextFieldValue, TextFieldValidators, TextFieldAppearance> | FieldCreateConfigForFieldType<SourceType, 'video', null, VideoFieldValidators, VideoFieldAppearance>;
+export type FieldCreateSchema = FieldCreateConfig<RawFieldCreateSchema>;
+/**
+ * Helper type to conditionally handle default values based on localization for field updates
+ */
+type FieldUpdateDefaultValue<T> = T | Record<string, T> | undefined;
+type FieldUpdateConfigForFieldType<SourceType, FieldType extends RawFieldAttributes['field_type'], FieldValue, FieldValidators, FieldAppearance> = Omit<SourceType, 'field_type' | 'default_value' | 'validators' | 'appearance'> & {
+    field_type?: FieldType;
+    default_value?: FieldUpdateDefaultValue<FieldValue>;
+    validators?: FieldValidators;
+    appearance?: FieldAppearanceConfig<FieldAppearance>;
+};
+type FieldUpdateConfig<SourceType> = FieldUpdateConfigForFieldType<SourceType, 'boolean', BooleanFieldValue, BooleanFieldValidators, BooleanFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'color', ColorFieldValue, ColorFieldValidators, ColorFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'date', DateFieldValue, DateFieldValidators, DateFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'date_time', DateTimeFieldValue, DateTimeFieldValidators, DateTimeFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'file', null, FileFieldValidators, FileFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'float', FloatFieldValue, FloatFieldValidators, FloatFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'gallery', null, GalleryFieldValidators, GalleryFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'integer', IntegerFieldValue, IntegerFieldValidators, IntegerFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'json', JsonFieldValue, JsonFieldValidators, JsonFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'lat_lon', LocationFieldValue, LocationFieldValidators, LocationFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'link', null, LinkFieldValidators, LinkFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'links', null, LinksFieldValidators, LinksFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'rich_text', null, RichTextFieldValidators, RichTextFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'seo', null, SeoFieldValidators, SeoFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'single_block', null, SingleBlockFieldValidators, SingleBlockFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'slug', null, SlugFieldValidators, SlugFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'string', StringFieldValue, StringFieldValidators, StringFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'structured_text', null, StructuredTextFieldValidators, StructuredTextFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'text', TextFieldValue, TextFieldValidators, TextFieldAppearance> | FieldUpdateConfigForFieldType<SourceType, 'video', null, VideoFieldValidators, VideoFieldAppearance>;
+export type FieldUpdateSchema = FieldUpdateConfig<RawFieldUpdateSchema>;
 /**
  * This file was automatically generated by hyperschema-to-ts: DO NOT MODIFY IT BY HAND.
  */
@@ -5807,7 +5863,7 @@ export type ItemTypeUpdateSchema = {
  * This interface was referenced by `DatoApi`'s JSON-Schema
  * via the `definition` "field".
  */
-export type Field = {
+export type RawField = {
     id: FieldIdentity;
     type: FieldType;
     /**
@@ -5911,7 +5967,7 @@ export type FieldDuplicateJobSchema = Field;
  * This interface was referenced by `Field`'s JSON-Schema
  * via the `definition` "attributes".
  */
-export type FieldAttributes = {
+export type RawFieldAttributes = {
     /**
      * The label of the field
      */
@@ -6014,7 +6070,7 @@ export type FieldRelationships = {
  * This interface was referenced by `Field`'s JSON-Schema
  * via the `create.schema` link.
  */
-export type FieldCreateSchema = {
+export type RawFieldCreateSchema = {
     id?: FieldIdentity;
     type?: FieldType;
     /**
@@ -6110,7 +6166,7 @@ export type FieldCreateSchema = {
  * This interface was referenced by `Field`'s JSON-Schema
  * via the `update.schema` link.
  */
-export type FieldUpdateSchema = {
+export type RawFieldUpdateSchema = {
     id?: FieldIdentity;
     type?: FieldType;
     /**
@@ -7279,7 +7335,7 @@ export type ItemVersionRelationships = {
     editor: AccountData | AccessTokenData | UserData | SsoUserData | OrganizationData;
 };
 /**
- * Every file you upload to DatoCMS will be retrievable from this endpoint.
+ * Each media object you upload to the Media Area of your DatoCMS project is represented as an `upload` entity.
  *
  * This interface was referenced by `DatoApi`'s JSON-Schema
  * via the `definition` "upload".
@@ -7813,7 +7869,7 @@ export type UploadBulkDestroySchema = {
     uploads: UploadData[];
 };
 /**
- * To upload a file in DatoCMS, first you need to obtain an upload permission through this API endpoint. The response will contain the S3 URL where you will be able to upload the file with a direct PUT request.
+ * To upload a file with the Content Management API, first you need to obtain an upload permission. The `upload_request` entity contains the S3-like URL where you will be able to upload the file with a raw/binary PUT request.
  *
  * This interface was referenced by `DatoApi`'s JSON-Schema
  * via the `definition` "upload_request".
@@ -7822,7 +7878,7 @@ export type UploadRequest = {
     id: UploadRequestIdentity;
     type: UploadRequestType;
     /**
-     * The URL to use to upload the file with a direct PUT request
+     * The URL to use to upload the file with a raw/binary PUT request
      */
     url: string;
     /**
@@ -7841,7 +7897,7 @@ export type UploadRequestCreateTargetSchema = UploadRequest;
  */
 export type UploadRequestAttributes = {
     /**
-     * The URL to use to upload the file with a direct PUT request
+     * The URL to use to upload the file with a raw/binary PUT request
      */
     url: string;
     /**
@@ -10985,3 +11041,4 @@ export type WorkflowUpdateSchema = {
         }[]
     ];
 };
+export {};