@datocms/cma-client 5.1.11 → 5.1.12

package/dist/esm/generated/ApiTypes.d.ts

@@ -1,81 +1,29 @@
-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, LatLonFieldAppearance, LatLonFieldValidators, LatLonFieldValue, LinkFieldAppearance, LinkFieldValidators, LinksFieldAppearance, LinksFieldValidators, RichTextFieldAppearance, RichTextFieldValidators, SeoFieldAppearance, SeoFieldValidators, SingleBlockFieldAppearance, SingleBlockFieldValidators, SlugFieldAppearance, SlugFieldValidators, StringFieldAppearance, StringFieldValidators, StringFieldValue, StructuredTextFieldAppearance, StructuredTextFieldValidators, TextFieldAppearance, TextFieldValidators, TextFieldValue, VideoFieldAppearance, VideoFieldValidators } from '../fieldTypes';
-import type { ItemDefinition } from '../utilities/itemDefinition';
-/**
- * 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 RawApiTypes
- */
-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 RawApiTypes
- */
-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', LatLonFieldValue, LatLonFieldValidators, LatLonFieldAppearance> | 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>;
-type LocalizedFieldCreateConfigForFieldType<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?: Record<string, FieldValue>;
-    validators?: FieldValidators;
-    appearance?: FieldAppearanceConfig<FieldAppearance>;
-};
-type NonLocalizedFieldCreateConfigForFieldType<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>;
-};
-type FieldCreateConfigForFieldType<SourceType, FieldType extends RawFieldAttributes['field_type'], FieldValue, FieldValidators, FieldAppearance> = LocalizedFieldCreateConfigForFieldType<SourceType, FieldType, FieldValue, FieldValidators, FieldAppearance> | NonLocalizedFieldCreateConfigForFieldType<SourceType, FieldType, FieldValue, FieldValidators, 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', LatLonFieldValue, LatLonFieldValidators, LatLonFieldAppearance> | 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', LatLonFieldValue, LatLonFieldValidators, LatLonFieldAppearance> | 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>;
-type ForceItemTypeDataId<ItemTypeId> = Omit<ItemTypeData, 'id'> & {
-    id: ItemTypeId;
-};
-type ForceItemTypeData<T, ItemTypeId> = {
-    [K in keyof T]: T[K] extends ItemTypeData ? ForceItemTypeDataId<ItemTypeId> : T[K] extends object ? ForceItemTypeData<T[K], ItemTypeId> : T[K];
-};
-type ForceItemTypeId<T, ItemTypeId> = ForceItemTypeData<T, ItemTypeId> & {
-    /** Useful for type narrowing */
-    __itemTypeId?: ItemTypeId;
+import type { FieldCreateConfig, FieldUpdateConfig, GenericFieldAttributes } from '../fieldTypes/schema';
+import type { ItemTypeDefinition, ToItemAttributes, ToItemAttributesInNestedResponse, ToItemAttributesInRequest } from '../utilities/itemDefinition';
+export type Field = GenericFieldAttributes<FieldStableShell>;
+export type FieldAttributes = GenericFieldAttributes<FieldAttributesStableShell>;
+export type FieldCreateSchema = FieldCreateConfig<FieldCreateSchemaStableShell>;
+export type FieldUpdateSchema = FieldUpdateConfig<FieldUpdateSchemaStableShell>;
+export type ItemTypeData<D extends ItemTypeDefinition = ItemTypeDefinition> = {
+    type: ItemTypeType;
+    id: D extends ItemTypeDefinition ? D['itemTypeId'] : ItemTypeIdentity;
 };
-export type ApplyItemDefinitionToSchema<Schema, D extends ItemDefinition = ItemDefinition> = D extends any ? ForceItemTypeId<Schema, D['itemTypeId']> & D['fields'] : never;
-export type Item<D extends ItemDefinition = ItemDefinition> = ApplyItemDefinitionToSchema<RawItem, D>;
-export type ItemValidateExistingSchema<D extends ItemDefinition = ItemDefinition> = ApplyItemDefinitionToSchema<RawItemValidateExistingSchema, D>;
-export type ItemValidateNewSchema<D extends ItemDefinition = ItemDefinition> = ApplyItemDefinitionToSchema<RawItemValidateNewSchema, D>;
-export type ItemCreateSchema<D extends ItemDefinition = ItemDefinition> = ApplyItemDefinitionToSchema<RawItemCreateSchema, D>;
-export type ItemUpdateSchema<D extends ItemDefinition = ItemDefinition> = ApplyItemDefinitionToSchema<RawItemUpdateSchema, D>;
+export type Item<D extends ItemTypeDefinition = ItemTypeDefinition> = {
+    __itemTypeId?: D['itemTypeId'];
+    id: ItemIdentity;
+    type: ItemType1;
+    item_type: ItemTypeData<D>;
+    creator?: AccountData | AccessTokenData | UserData | SsoUserData | OrganizationData;
+    meta: ItemMeta;
+} & ToItemAttributes<D>;
+export type ItemInNestedResponse<D extends ItemTypeDefinition = ItemTypeDefinition> = {
+    __itemTypeId?: D['itemTypeId'];
+    id: ItemIdentity;
+    type: ItemType1;
+    item_type: ItemTypeData<D>;
+    creator?: AccountData | AccessTokenData | UserData | SsoUserData | OrganizationData;
+    meta: ItemMeta;
+} & ToItemAttributesInNestedResponse<D>;
 /**
  * This file was automatically generated by hyperschema-to-ts: DO NOT MODIFY IT BY HAND.
  */
@@ -546,17 +494,17 @@ export type UploadCollectionReorderSchema = {
  */
 export type UploadCollectionReorderJobSchema = UploadCollection[];
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `definition` "type".
  */
 export type ItemType1 = 'item';
 /**
  * RFC 4122 UUID of record expressed in URL-safe base64 format
  *
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `definition` "identity".
  *
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `definition` "id".
  */
 export type ItemIdentity = string;
@@ -844,12 +792,12 @@ export type BuildEventInstancesHrefSchema = {
     [k: string]: unknown;
 };
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `instances.targetSchema` link.
  */
-export type ItemInstancesTargetSchema<D extends ItemDefinition = ItemDefinition> = Item<D>[];
+export type ItemInstancesTargetSchema<D extends ItemTypeDefinition = ItemTypeDefinition, NestedMode extends boolean = false> = NestedMode extends false ? Item<D>[] : ItemInNestedResponse<D>[];
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `instances.hrefSchema` link.
  */
 export type ItemInstancesHrefSchema = {
@@ -913,12 +861,12 @@ export type ItemInstancesHrefSchema = {
     [k: string]: unknown;
 };
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `references.targetSchema` link.
  */
-export type ItemReferencesTargetSchema<D extends ItemDefinition = ItemDefinition> = Item<D>[];
+export type ItemReferencesTargetSchema<D extends ItemTypeDefinition = ItemTypeDefinition, NestedMode extends boolean = false> = NestedMode extends false ? Item<D>[] : ItemInNestedResponse<D>[];
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `references.hrefSchema` link.
  */
 export type ItemReferencesHrefSchema = {
@@ -933,7 +881,7 @@ export type ItemReferencesHrefSchema = {
     [k: string]: unknown;
 };
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `self.hrefSchema` link.
  */
 export type ItemSelfHrefSchema = {
@@ -1008,7 +956,7 @@ export type ItemVersionType = 'item_version';
  */
 export type ItemVersionIdentity = string;
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `publish.schema` link.
  */
 export type ItemPublishSchema = {
@@ -1026,7 +974,7 @@ export type ItemPublishSchema = {
     non_localized_content: boolean;
 } | null;
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `publish.hrefSchema` link.
  */
 export type ItemPublishHrefSchema = {
@@ -1037,7 +985,7 @@ export type ItemPublishHrefSchema = {
     [k: string]: unknown;
 };
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `unpublish.schema` link.
  */
 export type ItemUnpublishSchema = {
@@ -1048,7 +996,7 @@ export type ItemUnpublishSchema = {
     content_in_locales: string[];
 } | null;
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `unpublish.hrefSchema` link.
  */
 export type ItemUnpublishHrefSchema = {
@@ -1059,22 +1007,22 @@ export type ItemUnpublishHrefSchema = {
     [k: string]: unknown;
 };
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `bulk_publish.jobSchema` link.
  */
 export type ItemBulkPublishJobSchema = unknown[];
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `bulk_unpublish.jobSchema` link.
  */
 export type ItemBulkUnpublishJobSchema = unknown[];
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `bulk_destroy.jobSchema` link.
  */
 export type ItemBulkDestroyJobSchema = unknown[];
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `bulk_move_to_stage.jobSchema` link.
  */
 export type ItemBulkMoveToStageJobSchema = unknown[];
@@ -1082,7 +1030,7 @@ export type ItemBulkMoveToStageJobSchema = unknown[];
  * This interface was referenced by `ItemVersion`'s JSON-Schema
  * via the `restore.jobSchema` link.
  */
-export type ItemVersionRestoreJobSchema<D extends ItemDefinition = ItemDefinition> = [Item<D>, ItemVersion];
+export type ItemVersionRestoreJobSchema<D extends ItemTypeDefinition = ItemTypeDefinition, NestedMode extends boolean = false> = NestedMode extends false ? [Item<D>, ItemVersion] : [ItemInNestedResponse<D>, ItemVersion];
 /**
  * This interface was referenced by `ItemVersion`'s JSON-Schema
  * via the `instances.targetSchema` link.
@@ -1184,7 +1132,7 @@ export type UploadInstancesHrefSchema = {
  * This interface was referenced by `Upload`'s JSON-Schema
  * via the `references.targetSchema` link.
  */
-export type UploadReferencesTargetSchema<D extends ItemDefinition = ItemDefinition> = Item<D>[];
+export type UploadReferencesTargetSchema<D extends ItemTypeDefinition = ItemTypeDefinition, NestedMode extends boolean = false> = NestedMode extends false ? Item<D>[] : ItemInNestedResponse<D>[];
 /**
  * This interface was referenced by `Upload`'s JSON-Schema
  * via the `references.hrefSchema` link.
@@ -1855,60 +1803,6 @@ export type SiteSelfHrefSchema = {
  * via the `instances.targetSchema` link.
  */
 export type WorkflowInstancesTargetSchema = Workflow[];
-export type DatoApi = {
-    role?: Role;
-    user?: User;
-    sso_user?: SsoUser;
-    audit_log_event?: AuditLogEvent;
-    account?: Account;
-    organization?: Organization;
-    site_plan?: SitePlan;
-    menu_item?: MenuItem;
-    schema_menu_item?: SchemaMenuItem;
-    upload_collection?: UploadCollection;
-    item_type?: ItemType;
-    field?: Field;
-    fieldset?: Fieldset;
-    job?: Job;
-    session?: Session;
-    access_token?: AccessToken;
-    plugin?: Plugin;
-    job_result?: JobResult;
-    subscription_limit?: SubscriptionLimit;
-    subscription_feature?: SubscriptionFeature;
-    build_event?: BuildEvent;
-    item?: Item;
-    item_current_vs_published_state?: ItemCurrentVsPublishedState;
-    item_version?: ItemVersion;
-    upload?: Upload;
-    upload_request?: UploadRequest;
-    upload_track?: UploadTrack;
-    scheduled_publication?: ScheduledPublication;
-    scheduled_unpublishing?: ScheduledUnpublishing;
-    search_result?: SearchResult;
-    environment?: Environment;
-    maintenance_mode?: MaintenanceMode;
-    webhook?: Webhook;
-    webhook_call?: WebhookCall;
-    build_trigger?: BuildTrigger;
-    item_type_filter?: ItemTypeFilter;
-    upload_filter?: UploadFilter;
-    site_invitation?: SiteInvitation;
-    editing_session?: EditingSession;
-    form_data?: FormData;
-    sso_group?: SsoGroup;
-    sso_settings?: SsoSettings;
-    emoji_suggestions?: EmojiSuggestions;
-    white_label_settings?: WhiteLabelSettings;
-    public_info?: PublicInfo;
-    daily_usage?: DailyUsage;
-    usage_counter?: UsageCounter;
-    upload_tag?: UploadTag;
-    upload_smart_tag?: UploadSmartTag;
-    site?: Site;
-    workflow?: Workflow;
-    [k: string]: unknown;
-};
 /**
  * A Role represents a specific set of actions an editor (or an API token) can perform on your administrative area.
  *
@@ -4083,16 +3977,6 @@ export type MenuItemCreateTargetSchema = MenuItem;
 export type MenuItemUpdateTargetSchema = MenuItem;
 export type MenuItemSelfTargetSchema = MenuItem;
 export type MenuItemDestroyTargetSchema = MenuItem;
-/**
- * JSON API data
- *
- * This interface was referenced by `ItemType`'s JSON-Schema
- * via the `definition` "data".
- */
-export type ItemTypeData = {
-    type: ItemTypeType;
-    id: ItemTypeIdentity;
-};
 /**
  * JSON API data
  *
@@ -4234,22 +4118,22 @@ export type MenuItemUpdateSchema = {
  * This interface was referenced by `Field`'s JSON-Schema
  * via the `duplicate.targetSchema` link.
  *
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `duplicate.targetSchema` link.
  *
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `destroy.targetSchema` link.
  *
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `bulk_publish.targetSchema` link.
  *
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `bulk_unpublish.targetSchema` link.
  *
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `bulk_destroy.targetSchema` link.
  *
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `bulk_move_to_stage.targetSchema` link.
  *
  * This interface was referenced by `ItemVersion`'s JSON-Schema
@@ -4632,7 +4516,7 @@ export type ItemTypeDestroyJobSchema = ItemType;
 /**
  * JSON API data
  *
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `definition` "data".
  */
 export type ItemData = {
@@ -5885,7 +5769,7 @@ export type ItemTypeUpdateSchema = {
  * This interface was referenced by `DatoApi`'s JSON-Schema
  * via the `definition` "field".
  */
-export type RawField = {
+export type FieldStableShell = {
     id: FieldIdentity;
     type: FieldType;
     /**
@@ -5989,7 +5873,7 @@ export type FieldDuplicateJobSchema = Field;
  * This interface was referenced by `Field`'s JSON-Schema
  * via the `definition` "attributes".
  */
-export type RawFieldAttributes = {
+export type FieldAttributesStableShell = {
     /**
      * The label of the field
      */
@@ -6092,7 +5976,7 @@ export type FieldRelationships = {
  * This interface was referenced by `Field`'s JSON-Schema
  * via the `create.schema` link.
  */
-export type RawFieldCreateSchema = {
+export type FieldCreateSchemaStableShell = {
     id?: FieldIdentity;
     type?: FieldType;
     /**
@@ -6188,7 +6072,7 @@ export type RawFieldCreateSchema = {
  * This interface was referenced by `Field`'s JSON-Schema
  * via the `update.schema` link.
  */
-export type RawFieldUpdateSchema = {
+export type FieldUpdateSchemaStableShell = {
     id?: FieldIdentity;
     type?: FieldType;
     /**
@@ -6904,783 +6788,19 @@ export type BuildEventAttributes = {
 export type BuildEventRelationships = {
     build_trigger: BuildTriggerData;
 };
-/**
- * DatoCMS stores the individual pieces of content you create from a model as records (for backwards compatibility the API calls these `item`). The shape of a record’s attributes depends on the fields defined by that record’s model — see the [Object payload](#object-payload) section for the full object payload documentation.
- *
- * ```json
- * // A simple record
- * {
- *   "id": "A4gkL_8pTZmcyJ-IlIEd2w",
- *   "type": "item",
- *   "attributes": {
- *     "title": "My Blog Post",
- *     "publication_date": "2024-01-15"
- *   },
- *   "relationships": {
- *     "item_type": {
- *       "data": { "id": "BxZ9Y2aKQVeTnM4hP8wLpD", "type": "item_type" }
- *     }
- *   }
- * }
- * ```
- *
- * > [!PROTIP] 📘 New to content modeling?
- * > Check out the [Content Modeling Guide](/docs/content-modelling) to understand how to design models, fields, and relationships before diving into API usage.
- *
- * ---
- *
- * ## Field types overview
- *
- * ###### Scalar fields
- * These store basic data types (ie. strings, numbers, booleans):
- *
- * <details>
- * <summary>Single-line string</summary>
- *
- * The field accepts `String` values or `null`.
- *
- * </details>
- *
- * <details>
- * <summary>Slug</summary>
- *
- * The field accepts `String` values or `null`.
- * </details>
- *
- * <details>
- * <summary>Multi-line text</summary>
- *
- * The field accepts simple `String` values (can include newlines) or `null`
- * </details>
- *
- * <details>
- * <summary>Boolean</summary>
- *
- * The field accepts simple `Boolean` values or `null`.
- * </details>
- *
- * <details>
- * <summary>Integer</summary>
- *
- * The field accepts simple `Integer` values or `null`.
- * </details>
- *
- * <details>
- * <summary>Float</summary>
- *
- * The field accepts simple `Float` values or `null`.
- *
- * </details>
- *
- * <details>
- * <summary>Date</summary>
- *
- * The field accepts `String` values in ISO 8601 date format (ie. `"2015-12-29"`) or `null`.
- *
- * </details>
- *
- * <details>
- * <summary>Date time</summary>
- *
- * The field accepts `String` values in ISO 8601 date-time format (ie. `"2020-04-17T16:34:31.981+01:00"`) or `null`.
- *
- * If you're on [legacy timezone management](/product-updates/improved-timezone-management), remember that when sending an ISO8601 datetime you should keep in mind that the system will ignore any provided timezone, and will use the project's timezone instead.
- * </details>
- *
- * <details>
- * <summary>JSON</summary>
- *
- * The field accepts `String` values that are valid JSON or `null`.
- *
- * **Note**: Must be a JSON-serialized string, not a JavaScript object!
- *
- * </details>
- *
- * ###### Object Fields
- * These require structured objects:
- *
- * <details>
- * <summary>Color</summary>
- *
- * The field accepts an object with the following properties, or `null`:
- *
- * | Property | Required | Type                        |
- * | -------- | -------- | --------------------------- |
- * | `red`    | ✅        | `Integer` between 0 and 255 |
- * | `green`  | ✅        | `Integer` between 0 and 255 |
- * | `blue`   | ✅        | `Integer` between 0 and 255 |
- * | `alpha`  | ✅        | `Integer` between 0 and 255 |
- *
- * </details>
- *
- *
- * <details>
- * <summary>Location</summary>
- *
- * The field accepts an object with the following properties, or `null`:
- *
- * | Property    | Required | Type                          |
- * | ----------- | -------- | ----------------------------- |
- * | `latitude`  | ✅        | `Float` between -90.0 to 90   |
- * | `longitude` | ✅        | `Float` between -180.0 to 180 |
- *
- * </details>
- *
- * <details>
- * <summary>SEO</summary>
- *
- * The field accepts an object with the following properties, or `null`:
- *
- * | Property       | Required | Type                                 | Description                                     |
- * | -------------- | -------- | ------------------------------------ | ----------------------------------------------- |
- * | `title`        |          | `String`                             | Title meta tag (max. 320 characters)            |
- * | `description`  |          | `String`                             | Description meta tag (max. 320 characters)      |
- * | `image`        |          | `Upload ID`                          | Asset to be used for social shares              |
- * | `twitter_card` |          | `"summary"`, `"summary_large_image"` | Type of Twitter card to use                     |
- * | `no_index`     |          | `Boolean`                            | Whether the noindex meta tag should be returned |
- *
- * </details>
- *
- * <details>
- * <summary>External video</summary>
- *
- * The field accepts an object with the following properties, or `null`:
- *
- * | Property        | Required | Type                                 | Description                                        | Example                                              |
- * | --------------- | -------- | ------------------------------------ | -------------------------------------------------- | ---------------------------------------------------- |
- * | `provider`      | ✅        | `"youtube"`, `"vimeo"`, `"facebook"` | External video provider                            | `"youtube"`                                          |
- * | `provider_uid`  | ✅        | `String`                             | Unique identifier of the video within the provider | `"vUdGBEb1i9g"`                                      |
- * | `url`           | ✅        | `URL`                                | URL of the video                                   | `"https://www.youtube.com/watch?v=qJhobECFQYk"`      |
- * | `width`         | ✅        | `Integer`                            | Video width                                        | `459`                                                |
- * | `height`        | ✅        | `Integer`                            | Video height                                       | `344`                                                |
- * | `thumbnail_url` | ✅        | `URL`                                | URL for the video thumb                            | `"https://i.ytimg.com/vi/vUdGBEb1i9g/hqdefault.jpg"` |
- * | `title`         | ✅        | `String`                             | Title of the video                                 | `"Next.js Conf Booth Welcoming!"`                    |
- *
- * </details>
- *
- * ###### Reference Fields
- *
- * These point to other resources (either assets or other records):
- *
- * <details>
- * <summary>Single-asset</summary>
- *
- * The field accepts an object with the following properties, or `null`:
- *
- * | Property      | Required | Type                             | Description                                                                                                                                                                                                                  | Example                         |
- * | ------------- | -------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
- * | `upload_id`   | ✅        | `Upload ID`                      | ID of an asset                                                                                                                                                                                                               | `"dhVR2HqgRVCTGFi0bWqLqA"`      |
- * | `title`       |          | `String`                         | Title for the asset, if you want to override the asset's default value (see Upload `default_field_metadata`)                                                                                                                 | `"From my trip to Italy"`       |
- * | `alt`         |          | `String`                         | Alternate text for the asset, if you want to override the asset's default value (see Upload `default_field_metadata`)                                                                                                        | `"Florence skyline"`            |
- * | `focal_point` |          | `{ x: Float, y: Float }`, `null` | Focal point for the asset, if you want to override the asset's default value (see Upload `default_field_metadata`). Values must be expressed as `Float` between 0 and 1. Focal point can only be specified for image assets. | `{ "x": 0.34, "y": 0.45 }`      |
- * | `custom_data` |          | `Record<String, String>`         | An object containing custom keys that you can use on your frontend projects                                                                                                                                                  | `{ "watermark_image": "true" }` |
- *
- * **API responses**: Always returns asset ID only (use separate asset API for details)
- *
- * </details>
- *
- * <details>
- * <summary>Asset gallery</summary>
- *
- * This field accepts an `Array` of objects with the following properties, or `null`:
- *
- * | Property      | Required | Type                             | Description                                                                                                                                                                                                                  | Example                         |
- * | ------------- | -------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
- * | `upload_id`   | ✅        | `Upload ID`                      | ID of an asset                                                                                                                                                                                                               | `"dhVR2HqgRVCTGFi0bWqLqA"`      |
- * | `title`       |          | `String`                         | Title for the asset, if you want to override the asset's default value (see Upload `default_field_metadata`)                                                                                                                 | `"Gallery Image Title"`         |
- * | `alt`         |          | `String`                         | Alternate text for the asset, if you want to override the asset's default value (see Upload `default_field_metadata`)                                                                                                        | `"Gallery image description"`   |
- * | `focal_point` |          | `{ x: Float, y: Float }`, `null` | Focal point for the asset, if you want to override the asset's default value (see Upload `default_field_metadata`). Values must be expressed as `Float` between 0 and 1. Focal point can only be specified for image assets. | `{ "x": 0.34, "y": 0.45 }`      |
- * | `custom_data` |          | `Record<String, String>`         | An object containing custom keys that you can use on your frontend projects                                                                                                                                                  | `{ "watermark_image": "true" }` |
- *
- * **API responses**: Always returns array of asset IDs only
- *
- * </details>
- *
- * <details>
- * <summary>Single link</summary>
- *
- * This field accepts a `String` representing the ID of the linked record, or `null`. See [Link Fields Guide](/docs/content-modelling/links) for relationship modeling concepts.
- *
- * **API responses**: Always returns record ID only
- *
- * </details>
- *
- * <details>
- * <summary>Multiple links</summary>
- *
- * This field accepts an `Array<String>` representing the IDs of the linked records, or `null`. See [Link Fields Guide](/docs/content-modelling/links) for relationship modeling concepts.
- *
- * **API responses**: Always returns array of record IDs only
- *
- * </details>
- *
- * ###### Block Fields
- *
- * These are special fields that contain **blocks within records**:
- *
- * | Field Type          | What it contains                                                                                                          |
- * | ------------------- | ------------------------------------------------------------------------------------------------------------------------- |
- * | **Modular content** | An array of blocks, perfect for building dynamic page sections                                                            |
- * | **Single block**    | A single block instance or `null`                                                                                         |
- * | **Structured text** | A rich text document that can have blocks embedded within the flow of content ([DAST format](/docs/structured-text/dast)) |
- *
- * Blocks are **records within records** - they're separate items that live inside fields of other records.
- *
- * > [!PROTIP] 📚 Content Modeling Context
- * > To understand when and how to design blocks vs models, see [Blocks Guide](/docs/content-modelling/blocks). For field-specific concepts, see [Modular Content](/docs/content-modelling/modular-content) and [Structured Text](/docs/content-modelling/structured-text).
- *
- * Blocks inside those fields are unique because they can be represented in two different ways depending on the context: as a lightweight reference (an ID) or as a full content object. Understanding this duality is key to working with them effectively:
- *
- * * **Block ID (Lightweight Reference)**: A simple `String` that uniquely identifies the block (ie. `"dhVR2HqgRVCTGFi_0bWqLqA"`). This is useful when you only need to know *which* block is there, not what's inside it.
- *
- * * **Block Object (Full Content)**: The complete record object for the block, containing its own `id`, `type`, `attributes`, and `relationships`. This is used when you need to read or modify the block's actual content.
- *
- *   ```json
- *   {
- *     "id": "dhVR2HqgRVCTGFi_0bWqLqA",
- *     "type": "item",
- *     "attributes": {
- *       "title": "Block Title",
- *       "content": "Block content..."
- *     },
- *     "relationships": {
- *       "item_type": {
- *         "data": { "id": "BxZ9Y2aKQVeTnM4hP8wLpD", "type": "item_type" }
- *       }
- *     }
- *   }
- *   ```
- *
- * <details>
- * <summary>Modular Content</summary>
- *
- * A Modular Content field holds an array of blocks.
- *
- * **As an array of IDs:**
- * ```json
- * {
- *   "content_blocks": [
- *     "dhVR2HqgRVCTGFi_0bWqLqA",
- *     "kL9mN3pQrStUvWxYzAbCdE"
- *   ]
- * }
- * ```
- *
- * **As an array of full objects:**
- *
- * ```json
- * {
- *   "content_blocks": [
- *     {
- *       "id": "dhVR2HqgRVCTGFi_0bWqLqA",
- *       "type": "item",
- *       "attributes": { "title": "Hero Section", "content": "Welcome to our site" },
- *       "relationships": { "item_type": { "data": { "id": "...", "type": "item_type" } } }
- *     },
- *     {
- *       "id": "kL9mN3pQrStUvWxYzAbCdE",
- *       "type": "item",
- *       "attributes": { "title": "Image Gallery", "images": [...] },
- *       "relationships": { "item_type": { "data": { "id": "...", "type": "item_type" } } }
- *     }
- *   ]
- * }
- * ```
- * </details>
- *
- * <details>
- * <summary>Single Block</summary>
- *
- * A Single Block field holds exactly one block, or `null`.
- *
- * **As an ID:**
- * ```json
- * {
- *   "featured_block": "dhVR2HqgRVCTGFi_0bWqLqA"
- * }
- * ```
- *
- * **As an full object:**
- *
- * ```json
- * {
- *   "featured_block": {
- *     "id": "dhVR2HqgRVCTGFi_0bWqLqA",
- *     "type": "item",
- *     "attributes": { "title": "Featured Content", "summary": "A summary..." },
- *     "relationships": { "item_type": { "data": { "id": "...", "type": "item_type" } } }
- *   }
- * }
- * ```
- * </details>
- *
- * <details>
- * <summary>Structured Text</summary>
- *
- * A Structured Text field can contain blocks within its document structure ([DAST format](/docs/structured-text/dast)). The item property of a `block` or `inlineBlock` node will hold either the ID or the full object.
- *
- * **With block IDs:**
- *
- * ```json
- * {
- *   "rich_text_content": {
- *     "schema": "dast",
- *     "document": {
- *       "type": "root",
- *       "children": [
- *         {
- *           "type": "paragraph",
- *           "children": [{ "type": "span", "value": "Text before block." }]
- *         },
- *         {
- *           "type": "block",
- *           "item": "dhVR2HqgRVCTGFi_0bWqLqA"
- *         }
- *       ]
- *     }
- *   }
- * }
- * ```
- *
- * **With full objects:**
- *
- * ```json
- * {
- *   "rich_text_content": {
- *     "schema": "dast",
- *     "document": {
- *       "type": "root",
- *       "children": [
- *         {
- *         "type": "paragraph",
- *           "children": [{ "type": "span", "value": "Text before block." }]
- *         },
- *         {
- *           "type": "block",
- *           "item": {
- *             "id": "dhVR2HqgRVCTGFi_0bWqLqA",
- *             "type": "item",
- *             "attributes": { "title": "Embedded Block", "content": "..." },
- *             "relationships": { "item_type": { "data": { "id": "...", "type": "item_type" } } }
- *           }
- *         }
- *       ]
- *     }
- *   }
- * }
- * ```
- * </details>
- *
- * ---
- *
- * ## API response modes: Regular vs. Nested
- *
- * When fetching record data, the API gives you control over how block fields are represented in the response. These two modes, **Regular** and **Nested**, are available on the following endpoints:
- *
- * * [Retrieve a single record (`GET /items/:id`)](/docs/content-management-api/resources/item/self)
- * * [Retrieve multiple records (`GET /items`)](/docs/content-management-api/resources/item/instances)
- * * [Retrieve records referenced by a record (`GET /items/:id/references`)](/docs/content-management-api/resources/item/references)
- * * [Retrieve records linked to an asset (`GET /upload/:id/references`)](/docs/content-management-api/resources/upload/references)
- *
- * ###### Regular mode (default)
- *
- * By default, the API returns block fields as IDs only. This is efficient and fast, making it ideal for listings or when you don't need the blocks' content immediately.
- *
- * ```json
- * GET /items/A4gkL_8pTZmcyJ-IlIEd2w
- *
- * {
- *   "id": "A4gkL_8pTZmcyJ-IlIEd2w",
- *   "type": "item",
- *   "attributes": {
- *     "title": "My Blog Post",
- *     "content_blocks": ["dhVR2HqgRVCTGFi_0bWqLqA", "kL9mN3pQrStUvWxYzAbCdE"],
- *     "featured_block": "nZ8xY2vWqTuJkL3mNcBeFg"
- *   }
- * }
- * ```
- *
- * ###### Nested mode (`?nested=true`)
- *
- * The same endpoint, when passing the `?nested=true` option, returns **block fields as full objects**. This is essential when you need to display or edit the content within the blocks.
- *
- * ```json
- * GET /items/A4gkL_8pTZmcyJ-IlIEd2w?nested=true
- *
- * {
- *   "id": "A4gkL_8pTZmcyJ-IlIEd2w",
- *   "type": "item",
- *   "attributes": {
- *     "title": "My Blog Post",
- *     "content_blocks": [
- *       {
- *         "id": "dhVR2HqgRVCTGFi_0bWqLqA",
- *         "type": "item",
- *         "attributes": { "title": "Hero Section", "content": "Welcome to our site" },
- *         "relationships": { ... }
- *       },
- *       {
- *         "id": "kL9mN3pQrStUvWxYzAbCdE",
- *         "type": "item",
- *         "attributes": { "title": "Image Gallery", "images": [...] },
- *         "relationships": { ... }
- *       }
- *     ],
- *     "featured_block": {
- *       "id": "nZ8xY2vWqTuJkL3mNcBeFg",
- *       "type": "item",
- *       "attributes": { ... },
- *       "relationships": { ... }
- *     }
- *   }
- * }
- * ```
- *
- * > [!WARNING] Block Fields vs. Other Reference Fields
- * > Block fields are the **only** field type that change representation between modes! Asset and link fields always return IDs. To get full details for assets or linked records, you need to make separate API calls using their IDs.
- *
- * ###### When to use each mode?
- *
- * | Use "Regular Mode" when...                                                                                     | Use "Nested Mode" when...                                                                     |
- * | -------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
- * | Listing many records or building navigation.                                                                   | Displaying or editing block content, as it provides the actual content needed.                |
- * | You only need to know which blocks exist.                                                                      | You need to read the actual block content for display or updates.                             |
- * | Building navigation                                                                                            | Preparing to update blocks                                                                    |
- * | Performance is critical; it's faster because it returns smaller responses (block IDs instead of full content). | You are building content editing interfaces where usability is more important than raw speed. |
- *
- *
- * ---
- *
- * ## Creating and updating blocks
- *
- * Working with blocks follows one fundamental constraint:
- *
- * **You cannot create, edit, or delete blocks directly. You must always update the parent record that contains them.**
- *
- * This ensures data integrity. To create/modify blocks, you send a payload to the parent record's endpoint, using a mix of Block IDs and Block Objects to describe the desired changes.
- *
- * ###### Key rules for block operations
- *
- * 1.  **To create a new block**: Provide the **full object**, including `type`, `attributes`, and the `relationships.item_type` which specifies the Block Model being used.
- * 2.  **To update an existing block**: Provide the **full object**, including its `id` and the changed `attributes`. You only need to include the specific attributes that you want to change - unchanged attributes will be preserved. You don't need to specify `relationships.item_type`.
- * 3.  **To keep an existing block unchanged**: Simply provide its **Block ID** string. This is the most efficient way to handle unchanged blocks.
- * 4.  **To delete a block**: Omit it from the payload. For a Modular Content array, remove its ID. For a Single Block field, set the value to `null`.
- * 5.  **To reorder blocks** (in Modular Content): Send an array of Block IDs in the new desired order.
- *
- *
- * The following examples show how to apply these rules.
- *
- * <details>
- * <summary>Working with Modular Content Fields</summary>
- *
- * **Current state** (from a regular API response):
- * ```json
- * {
- *   "content_blocks": ["dhVR2HqgRVCTGFi_0bWqLqA", "kL9mN3pQrStUvWxYzAbCdE", "fG8hI1jKlMnOpQrStUvWxY"]
- * }
- * ```
- *
- * **To update the second block and reorder the others:**
- * ```json
- * {
- *   "content_blocks": [
- *     "fG8hI1jKlMnOpQrStUvWxY", // Reordered: kept as ID
- *     {
- *       "id": "kL9mN3pQrStUvWxYzAbCdE", // Updated: sent as object
- *       "type": "item",
- *       "attributes": { "title": "Updated Title" }
- *     },
- *     "dhVR2HqgRVCTGFi_0bWqLqA" // Reordered: kept as ID
- *   ]
- * }
- * ```
- *
- * **To add a new block at the end and remove the first block:**
- * ```json
- * {
- *   "content_blocks": [
- *     "kL9mN3pQrStUvWxYzAbCdE", // Kept as ID
- *     "fG8hI1jKlMnOpQrStUvWxY", // Kept as ID
- *     {
- *       "type": "item", // New block: sent as object with relationships
- *       "attributes": { "title": "A Brand New Block" },
- *       "relationships": {
- *         "item_type": {
- *           "data": { "id": "BxZ9Y2aKQVeTnM4hP8wLpD", "type": "item_type" }
- *         }
- *       }
- *     }
- *   ]
- * }
- * ```
- *
- * </details>
- *
- * <details>
- * <summary>Working with Single Block Fields</summary>
- *
- * **Current state** (from a regular API response):
- * ```json
- * {
- *   "hero_block": "dhVR2HqgRVCTGFi_0bWqLqA"
- * }
- * ```
- *
- * **To update the block's content:**
- * ```json
- * {
- *   "hero_block": {
- *     "id": "dhVR2HqgRVCTGFi_0bWqLqA",
- *     "type": "item",
- *     "attributes": { "title": "Updated Hero Title" }
- *   }
- * }
- * ```
- *
- * **To replace it with a new block:**
- * ```json
- * {
- *   "hero_block": {
- *     "type": "item",
- *     "attributes": { "title": "New Hero Block" },
- *     "relationships": {
- *       "item_type": {
- *         "data": { "id": "BxZ9Y2aKQVeTnM4hP8wLpD", "type": "item_type" }
- *       }
- *     }
- *   }
- * }
- * ```
- *
- * **To remove (delete) the block:**
- * ```json
- * {
- *   "hero_block": null
- * }
- * ```
- * </details>
- *
- * <details>
- * <summary>Working with Structured Text Fields</summary>
- *
- * Updating blocks within Structured Text follows the same pattern: you replace the `item`'s ID with a full object for the block you want to change.
- *
- * **Current state** (from a regular API response):
- * ```json
- * {
- *   "rich_content": {
- *     "schema": "dast",
- *     "document": {
- *       "type": "root",
- *       "children": [
- *         { "type": "block", "item": "dhVR2HqgRVCTGFi_0bWqLqA" },
- *         { "type": "paragraph", "children": [{ "type": "span", "value": "Some text." }] }
- *       ]
- *     }
- *   }
- * }
- * ```
- *
- * **To update the block's content:**
- * ```json
- * {
- *   "rich_content": {
- *     "schema": "dast",
- *     "document": {
- *       "type": "root",
- *       "children": [
- *         {
- *           "type": "block",
- *           "item": {
- *             "id": "dhVR2HqgRVCTGFi_0bWqLqA", // The block to update
- *             "type": "item",
- *             "attributes": { "title": "Updated DAST Block Title" }
- *           }
- *         },
- *         { "type": "paragraph", "children": [{ "type": "span", "value": "Some text." }] }
- *       ]
- *     }
- *   }
- * }
- * ```
- * </details>
- *
- * ###### Deeply-nested blocks
- *
- * Blocks can contain other blocks, creating hierarchies multiple levels deep. **The same principles apply recursively.** When you fetch a record with `?nested=true`, the API will expand nested blocks at all levels.
- *
- * When updating, you are always sending a payload to the top-level parent record, but you can specify changes to deeply nested blocks using the same ID vs. object rules.
- *
- * <details>
- * <summary>Example: Updating a nested block</summary>
- *
- * Imagine a "Wrapper" block that contains a Modular Content field with "Child" blocks inside it. To update "Child Block 1" while leaving "Child Block 2" untouched:
- *
- * ```json
- * // This payload is sent to the top-level record containing the "Parent Block"
- * {
- *   "wrapper_block": {
- *     "id": "dhVR2HqgRVCTGFi_0bWqLqA", // ID of the parent block being updated
- *     "type": "item",
- *     "attributes": {
- *       "nested_content": [
- *         {
- *           "id": "kL9mN3pQrStUvWxYzAbCdE", // ID of the nested block being updated
- *           "type": "item",
- *           "attributes": { "title": "Updated Child Block 1" }
- *         },
- *         "fG8hI1jKlMnOpQrStUvWxY" // Unchanged nested block, sent as ID
- *       ],
- *       // You can skip any attribute that does not need to change
- *     }
- *   }
- * }
- * ```
- * </details>
- *
- * ---
- *
- * ## Localization
- *
- * Localization allows you to store different versions of your content for different languages or regions. When you mark a field as "localizable" in your model, its structure in the API changes to accommodate multiple values.
- *
- * The fundamental change is that the field's value is no longer a single piece of data but an **object keyed by locale codes**.
- *
- * For example, a simple non-localized `title` field looks like this:
- * ```json
- * {
- *   "title": "Hello World"
- * }
- * ```
- *
- * When localized, it becomes an object containing a value for each configured locale:
- * ```json
- * {
- *   "title": {
- *     "en": "Hello World",
- *     "it": "Ciao Mondo",
- *     "fr": "Bonjour le Monde"
- *   }
- * }
- * ```
- * This principle applies to **every type of field**, from simple strings to **Modular Content**, **Single Block**, and **Structured Text** fields. For instance, a localized Modular Content field will contain a separate array of blocks for each language. This powerful feature allows you to have completely different block structures for each locale.
- *
- * <details>
- * <summary>Example: Localized Modular Content field</summary>
- *
- * In a `regular` API response, you would see different arrays of block IDs for each locale.
- *
- * ```json
- * {
- *   "content_blocks": {
- *     "en": ["dhVR2HqgRVCTGFi0bWqLqA", "kL9mN3pQrStUvWxYzAbCdE"],
- *     "it": ["fG8hI1jKlMnOpQrStUvWxY", "dhVR2HqgRVCTGFi0bWqLqA"]
- *   }
- * }
- * ```
- * </details>
- *
- * <details>
- * <summary>Example: Localized Single Block field</summary>
- * A different block can be assigned to each locale.
- *
- * ```json
- * {
- *   "hero_block": {
- *     "en": "dhVR2HqgRVCTGFi0bWqLqA",
- *     "it": "kL9mN3pQrStUvWxYzAbCdE"
- *   }
- * }
- * ```
- * </details>
- *
- * <details>
- * <summary>Example: Localized Structured Text field</summary>
- *
- * The entire DAST document is localized, allowing for different text and different embedded blocks per locale.
- *
- * ```json
- * {
- *   "rich_content": {
- *     "en": {
- *       "schema": "dast",
- *       "document": {
- *         "type": "root",
- *         "children": [{ "type": "block", "item": "dhVR2HqgRVCTGFi0bWqLqA" }]
- *       }
- *     },
- *     "it": {
- *       "schema": "dast",
- *       "document": {
- *         "type": "root",
- *         "children": [{ "type": "block", "item": "kL9mN3pQrStUvWxYzAbCdE" }]
- *       }
- *     }
- *   }
- * }
- * ```
- * </details>
- *
- * When reading or writing localized content, there are a few key rules to follow to ensure data integrity.
- *
- * ###### Locale consistency
- * Within a single record, all localized fields must have a consistent set of locales. You cannot have a `title` with English and Italian, and a `description` with English and French in the same record.
- *
- * ```json
- * // ❌ This will FAIL due to inconsistent locales ("it" vs "fr")
- * {
- *   "title": { "en": "Title", "it": "Titolo" },
- *   "description": { "en": "Description", "fr": "Description" }
- * }
- *
- * // ✅ This is VALID because locales are consistent across all fields
- * {
- *   "title": { "en": "Title", "it": "Titolo" },
- *   "description": { "en": "Description", "it": "Descrizione" }
- * }
- * ```
- *
- * ###### Required locales
- *
- * Your model can be configured to require that all project's locales are always present ([`attributes.all_locales_required`](/docs/content-management-api/resources/item-type#object-payload)). If that's the case, when creating or updating a record, you must provide a value for all required locales.
- *
- * ```json
- * // ❌ This will FAIL if all locales are required for the model
- * {
- *   "title": { "en": "Title" }
- * }
- * ```
- *
- *
- * This interface was referenced by `ScheduledPublication`'s JSON-Schema
- * via the `destroy.targetSchema` link.
- *
- * This interface was referenced by `ScheduledUnpublishing`'s JSON-Schema
- * via the `destroy.targetSchema` link.
- *
- * This interface was referenced by `DatoApi`'s JSON-Schema
- * via the `definition` "item".
- */
-export type RawItem = {
-    id: ItemIdentity;
-    type: ItemType1;
-    item_type: ItemTypeData;
-    creator?: AccountData | AccessTokenData | UserData | SsoUserData | OrganizationData;
-    meta: ItemMeta;
-};
-export type ItemCreateTargetSchema<D extends ItemDefinition = ItemDefinition> = Item<D>;
-export type ItemDuplicateJobSchema<D extends ItemDefinition = ItemDefinition> = Item<D>;
-export type ItemUpdateTargetSchema<D extends ItemDefinition = ItemDefinition> = Item<D>;
-export type ItemSelfTargetSchema<D extends ItemDefinition = ItemDefinition> = Item<D>;
-export type ItemDestroyJobSchema<D extends ItemDefinition = ItemDefinition> = Item<D>;
-export type ItemPublishTargetSchema<D extends ItemDefinition = ItemDefinition> = Item<D>;
-export type ItemUnpublishTargetSchema<D extends ItemDefinition = ItemDefinition> = Item<D>;
-export type ScheduledPublicationDestroyTargetSchema<D extends ItemDefinition = ItemDefinition> = Item<D>;
-export type ScheduledUnpublishingDestroyTargetSchema<D extends ItemDefinition = ItemDefinition> = Item<D>;
+export type ItemCreateTargetSchema<D extends ItemTypeDefinition = ItemTypeDefinition, NestedMode extends boolean = false> = NestedMode extends false ? Item<D> : ItemInNestedResponse<D>;
+export type ItemDuplicateJobSchema<D extends ItemTypeDefinition = ItemTypeDefinition, NestedMode extends boolean = false> = NestedMode extends false ? Item<D> : ItemInNestedResponse<D>;
+export type ItemUpdateTargetSchema<D extends ItemTypeDefinition = ItemTypeDefinition, NestedMode extends boolean = false> = NestedMode extends false ? Item<D> : ItemInNestedResponse<D>;
+export type ItemSelfTargetSchema<D extends ItemTypeDefinition = ItemTypeDefinition, NestedMode extends boolean = false> = NestedMode extends false ? Item<D> : ItemInNestedResponse<D>;
+export type ItemDestroyJobSchema<D extends ItemTypeDefinition = ItemTypeDefinition, NestedMode extends boolean = false> = NestedMode extends false ? Item<D> : ItemInNestedResponse<D>;
+export type ItemPublishTargetSchema<D extends ItemTypeDefinition = ItemTypeDefinition, NestedMode extends boolean = false> = NestedMode extends false ? Item<D> : ItemInNestedResponse<D>;
+export type ItemUnpublishTargetSchema<D extends ItemTypeDefinition = ItemTypeDefinition, NestedMode extends boolean = false> = NestedMode extends false ? Item<D> : ItemInNestedResponse<D>;
+export type ScheduledPublicationDestroyTargetSchema<D extends ItemTypeDefinition = ItemTypeDefinition, NestedMode extends boolean = false> = NestedMode extends false ? Item<D> : ItemInNestedResponse<D>;
+export type ScheduledUnpublishingDestroyTargetSchema<D extends ItemTypeDefinition = ItemTypeDefinition, NestedMode extends boolean = false> = NestedMode extends false ? Item<D> : ItemInNestedResponse<D>;
 /**
  * Meta information regarding the record
  *
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `definition` "meta".
  */
 export type ItemMeta = {
@@ -7737,52 +6857,43 @@ export type ItemMeta = {
      */
     has_children: null | boolean;
 };
-/**
- * The JSON data associated to the record
- *
- * This interface was referenced by `Item<D>`'s JSON-Schema
- * via the `definition` "attributes".
- */
-export type ItemAttributes = {
-    [k: string]: unknown;
-};
 /**
  * JSON API links
  *
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `definition` "relationships".
  */
-export type ItemRelationships = {
-    item_type: ItemTypeData;
+export type ItemRelationships<D extends ItemTypeDefinition = ItemTypeDefinition> = {
+    item_type: ItemTypeData<D>;
     creator?: AccountData | AccessTokenData | UserData | SsoUserData | OrganizationData;
 };
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `validate_existing.schema` link.
  */
-export type RawItemValidateExistingSchema = {
+export type ItemValidateExistingSchema<D extends ItemTypeDefinition = ItemTypeDefinition> = {
     id?: ItemIdentity;
     type?: ItemType1;
-    item_type: ItemTypeData;
+    item_type: ItemTypeData<D>;
     creator?: AccountData | AccessTokenData | UserData | SsoUserData | OrganizationData;
-};
+} & ToItemAttributesInRequest<D>;
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `validate_new.schema` link.
  */
-export type RawItemValidateNewSchema = {
+export type ItemValidateNewSchema<D extends ItemTypeDefinition = ItemTypeDefinition> = {
     type?: ItemType1;
-    item_type: ItemTypeData;
+    item_type: ItemTypeData<D>;
     creator?: AccountData | AccessTokenData | UserData | SsoUserData | OrganizationData;
-};
+} & ToItemAttributesInRequest<D>;
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `create.schema` link.
  */
-export type RawItemCreateSchema = {
+export type ItemCreateSchema<D extends ItemTypeDefinition = ItemTypeDefinition> = {
     id?: ItemIdentity;
     type?: ItemType1;
-    item_type: ItemTypeData;
+    item_type: ItemTypeData<D>;
     creator?: AccountData | AccessTokenData | UserData | SsoUserData | OrganizationData;
     /**
      * Meta information regarding the record
@@ -7829,15 +6940,15 @@ export type RawItemCreateSchema = {
          */
         current_version?: string;
     };
-};
+} & ToItemAttributesInRequest<D>;
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `update.schema` link.
  */
-export type RawItemUpdateSchema = {
+export type ItemUpdateSchema<D extends ItemTypeDefinition = ItemTypeDefinition> = {
     id?: ItemIdentity;
     type?: ItemType1;
-    item_type?: ItemTypeData;
+    item_type?: ItemTypeData<D>;
     creator?: AccountData | AccessTokenData | UserData | SsoUserData | OrganizationData;
     /**
      * Meta information regarding the record
@@ -7896,11 +7007,11 @@ export type RawItemUpdateSchema = {
          */
         has_children?: null | boolean;
     };
-};
+} & ToItemAttributesInRequest<D>;
 /**
  * Information about the record
  *
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `current_vs_published_state.targetSchema` link.
  *
  * This interface was referenced by `DatoApi`'s JSON-Schema
@@ -7990,7 +7101,7 @@ export type ItemCurrentVsPublishedStateRelationships = {
     published_version: ItemVersionData | null;
 };
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `bulk_publish.schema` link.
  */
 export type ItemBulkPublishSchema = {
@@ -7999,7 +7110,7 @@ export type ItemBulkPublishSchema = {
     minItems?: unknown;
 };
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `bulk_unpublish.schema` link.
  */
 export type ItemBulkUnpublishSchema = {
@@ -8008,7 +7119,7 @@ export type ItemBulkUnpublishSchema = {
     minItems?: unknown;
 };
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `bulk_destroy.schema` link.
  */
 export type ItemBulkDestroySchema = {
@@ -8017,7 +7128,7 @@ export type ItemBulkDestroySchema = {
     minItems?: unknown;
 };
 /**
- * This interface was referenced by `Item<D>`'s JSON-Schema
+ * This interface was referenced by `Item`'s JSON-Schema
  * via the `bulk_move_to_stage.schema` link.
  */
 export type ItemBulkMoveToStageSchema = {
@@ -11796,4 +10907,3 @@ export type WorkflowUpdateSchema = {
         }[]
     ];
 };
-export {};