@datocms/cma-client 5.1.0 → 5.1.1

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

@@ -67,27 +67,27 @@ export type DocumentAsRequest = {
 /**
  * Variant of 'block' structured text node for ?nested=true API responses
  */
-export type BlockWithResolvedBlocks = Omit<Block, 'item'> & {
+export type BlockWithNestedBlocks = Omit<Block, 'item'> & {
     item: SchemaTypes.Item;
 };
 /**
  * Variant of 'inlineBlock' structured text node for ?nested=true API responses
  */
-export type InlineBlockWithResolvedBlocks = Omit<InlineBlock, 'item'> & {
+export type InlineBlockWithNestedBlocks = Omit<InlineBlock, 'item'> & {
     item: SchemaTypes.Item;
 };
 /**
  * Generic type to transform a node that might be containing a 'block' or 'inlineBlock' as a (deeply nested) children to it's variant for ?nested=true API responses
  */
-export type NodeWithResolvedBlocks<T> = WithMappedChildren<T, DeepMapVariants<T extends {
+export type NodeWithNestedBlocks<T> = WithMappedChildren<T, DeepMapVariants<T extends {
     children: infer C;
-} ? C : never, BlockWithResolvedBlocks, InlineBlockWithResolvedBlocks>>;
+} ? C : never, BlockWithNestedBlocks, InlineBlockWithNestedBlocks>>;
 /**
  * Variant of Structured Text document for ?nested=true API responses
  */
-export type DocumentWithResolvedBlocks = {
+export type DocumentWithNestedBlocks = {
     schema: 'dast';
-    document: NodeWithResolvedBlocks<Root>;
+    document: NodeWithNestedBlocks<Root>;
 };
 /**
  * =============================================================================
@@ -100,7 +100,7 @@ export type DocumentWithResolvedBlocks = {
  */
 export type StructuredTextFieldValue = Document | null;
 export type StructuredTextFieldValueAsRequest = DocumentAsRequest | null;
-export type StructuredTextFieldValueWithResolvedBlocks = DocumentWithResolvedBlocks | null;
+export type StructuredTextFieldValueWithNestedBlocks = DocumentWithNestedBlocks | null;
 /**
  * Type guard for basic structured text field values (blocks as string IDs only).
  * Checks for the expected structure and ensures all block/inlineBlock nodes have string IDs.
@@ -115,7 +115,7 @@ export declare function isStructuredTextFieldValueAsRequest(value: unknown): val
  * Type guard for structured text field values with nested blocks (?nested=true format).
  * Ensures all block/inlineBlock nodes have full SchemaTypes.Item objects.
  */
-export declare function isStructuredTextFieldValueWithResolvedBlocks(value: unknown): value is StructuredTextFieldValueWithResolvedBlocks;
+export declare function isStructuredTextFieldValueWithNestedBlocks(value: unknown): value is StructuredTextFieldValueWithNestedBlocks;
 /**
  * =============================================================================
  * SHARED TRANSFORMATION UTILITIES

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

@@ -30,16 +30,21 @@ type FieldAttributesForFieldType<SourceType, FieldType extends RawFieldAttribute
 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'> & {
+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;
-    default_value?: FieldCreateDefaultValue<FieldValue>;
+    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', 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'> & {

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

@@ -30,16 +30,21 @@ type FieldAttributesForFieldType<SourceType, FieldType extends RawFieldAttribute
 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'> & {
+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;
-    default_value?: FieldCreateDefaultValue<FieldValue>;
+    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', 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>;
 /**

package/dist/types/utilities/fieldValueLocalization.d.ts

@@ -1,12 +1,58 @@
 import type * as SchemaTypes from '../generated/SchemaTypes';
 import type * as SimpleSchemaTypes from '../generated/SimpleSchemaTypes';
 /**
+ * Represents a localized field value in DatoCMS.
+ *
  * In DatoCMS, fields can be localized. In this scenario, their value contains values
  * for various locales structured as an object, such as
- `{ "en": "Hello", "it": "Ciao" }`)
+ * `{ "en": "Hello", "it": "Ciao" }`
  */
 export type LocalizedFieldValue = Record<string, unknown>;
+/**
+ * Determines whether a DatoCMS field is localized or not.
+ *
+ * This function handles both full Schema field objects and simplified Schema field objects
+ * by checking the appropriate property based on the object structure.
+ *
+ * @param field - The DatoCMS field definition (either full or simple schema)
+ * @returns true if the field is localized, false otherwise
+ */
 export declare function isLocalized(field: SchemaTypes.Field | SimpleSchemaTypes.Field): boolean;
+/**
+ * A normalized entry that represents a single value from either a localized or non-localized field.
+ *
+ * For localized fields, each locale produces one entry with `locale` set to the locale code (e.g., "en", "it").
+ * For non-localized fields, there's one entry with `locale` set to `undefined`.
+ *
+ * This uniform structure allows the same processing logic to work with both field types.
+ */
+export type PossiblyLocalizedEntry = {
+    locale: string | undefined;
+    value: unknown;
+};
+/**
+ * Converts a field value (localized or non-localized) into a uniform array of entries.
+ *
+ * This function normalizes the handling of field values by converting them into a consistent
+ * array format, regardless of whether the field is localized or not.
+ *
+ * @param field - The DatoCMS field definition that determines localization behavior
+ * @param value - The field value to convert (either a localized object or direct value)
+ * @returns Array of entries where each entry contains a locale (string for localized, undefined for non-localized) and the corresponding value
+ */
+export declare function fieldValueToPossiblyLocalizedEntries(field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown): PossiblyLocalizedEntry[];
+/**
+ * Converts an array of possibly localized entries back into the appropriate field value format.
+ *
+ * This function is the inverse of `fieldValueToPossiblyLocalizedEntries`. It takes a uniform
+ * array of entries and converts them back to either a localized object or a direct value,
+ * depending on the field's localization setting.
+ *
+ * @param field - The DatoCMS field definition that determines the output format
+ * @param possiblyLocalizedEntries - Array of entries to convert back to field value format
+ * @returns Either a localized object (for localized fields) or the direct value (for non-localized fields)
+ */
+export declare function possiblyLocalizedEntriesToFieldValue(field: SchemaTypes.Field | SimpleSchemaTypes.Field, possiblyLocalizedEntries: PossiblyLocalizedEntry[]): any;
 /**
  * Maps localized field values using a provided mapping function.
  * For localized fields, applies the mapping function to each locale value.
@@ -18,9 +64,7 @@ export declare function isLocalized(field: SchemaTypes.Field | SimpleSchemaTypes
  * @param mapFn - The function to apply to each locale value or the direct value
  * @returns The mapped value with the same structure as the input
  */
-export declare function mapLocalizedFieldValues<T>(field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, mapFn: (locale: string | undefined, localeValue: unknown) => T): T | {
-    [k: string]: T;
-};
+export declare function mapLocalizedFieldValues<T>(field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, mapFn: (locale: string | undefined, localeValue: unknown) => T): any;
 /**
  * Maps localized field values using a provided mapping function (async version).
  * For localized fields, applies the mapping function to each locale value.
@@ -32,9 +76,7 @@ export declare function mapLocalizedFieldValues<T>(field: SchemaTypes.Field | Si
  * @param mapFn - The function to apply to each locale value or the direct value
  * @returns The mapped value with the same structure as the input
  */
-export declare function mapLocalizedFieldValuesAsync<T>(field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, mapFn: (locale: string | undefined, localeValue: unknown) => Promise<T>): Promise<T | {
-    [k: string]: unknown;
-}>;
+export declare function mapLocalizedFieldValuesAsync<T>(field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, mapFn: (locale: string | undefined, localeValue: unknown) => Promise<T>): Promise<any>;
 /**
  * Filters localized field values using a provided filter function.
  * For localized fields, filters each locale value.
@@ -45,7 +87,7 @@ export declare function mapLocalizedFieldValuesAsync<T>(field: SchemaTypes.Field
  * @param filterFn - The function to test each locale value or the direct value
  * @returns The filtered value with the same structure as the input
  */
-export declare function filterLocalizedFieldValues(field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, filterFn: (locale: string | undefined, localeValue: unknown) => boolean): unknown;
+export declare function filterLocalizedFieldValues(field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, filterFn: (locale: string | undefined, localeValue: unknown) => boolean): any;
 /**
  * Filters localized field values using a provided filter function (async version).
  * For localized fields, filters each locale value.
@@ -56,7 +98,7 @@ export declare function filterLocalizedFieldValues(field: SchemaTypes.Field | Si
  * @param filterFn - The function to test each locale value or the direct value
  * @returns The filtered value with the same structure as the input
  */
-export declare function filterLocalizedFieldValuesAsync(field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, filterFn: (locale: string | undefined, localeValue: unknown) => Promise<boolean>): Promise<unknown>;
+export declare function filterLocalizedFieldValuesAsync(field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, filterFn: (locale: string | undefined, localeValue: unknown) => Promise<boolean>): Promise<any>;
 /**
  * Tests whether at least one localized field value passes the test implemented by the provided function.
  * For localized fields, tests each locale value.

package/dist/types/utilities/structuredText.d.ts

@@ -27,7 +27,7 @@ export type NodePredicate<T, R> = (node: AllNodesInTree<T>, parent: AllNodesInTr
  * @param node - The root node to start visiting from
  * @param visitor - Synchronous function called for each node. Receives the node, its parent, and path through the Structured Text tree
  */
-export declare function visitNodes<T>(node: T, visitor: NodePredicate<T, void>, parent?: AllNodesInTree<T> | null, path?: TreePath): void;
+export declare function forEachNode<T>(node: T, visitor: NodePredicate<T, void>, parent?: AllNodesInTree<T> | null, path?: TreePath): void;
 /**
  * Visit every node in the Structured Text tree, calling the visitor function for each.
  * Uses pre-order traversal (parent is visited before its children).
@@ -37,7 +37,7 @@ export declare function visitNodes<T>(node: T, visitor: NodePredicate<T, void>,
  * @param visitor - Asynchronous function called for each node. Receives the node, its parent, and path through the Structured Text tree
  * @returns Promise that resolves when all nodes have been visited
  */
-export declare function visitNodesAsync<T>(node: T, visitor: NodePredicate<T, Promise<void>>, parent?: AllNodesInTree<T> | null, path?: TreePath): Promise<void>;
+export declare function forEachNodeAsync<T>(node: T, visitor: NodePredicate<T, Promise<void>>, parent?: AllNodesInTree<T> | null, path?: TreePath): Promise<void>;
 /**
  * Transform nodes in the Structured Text tree by applying a mapping function.
  * Creates a new tree structure with transformed nodes while preserving the Structured Text tree hierarchy.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datocms/cma-client",
-  "version": "5.1.0",
+  "version": "5.1.1",
   "description": "JS client for DatoCMS REST Content Management API",
   "keywords": [
     "datocms",
@@ -37,13 +37,13 @@
     "url": "https://github.com/datocms/js-rest-api-clients/issues"
   },
   "dependencies": {
-    "@datocms/rest-client-utils": "^5.1.0",
+    "@datocms/rest-client-utils": "^5.1.1",
     "datocms-structured-text-utils": "^5.0.0",
     "uuid": "^9.0.1"
   },
   "devDependencies": {
-    "@datocms/dashboard-client": "^5.1.0",
+    "@datocms/dashboard-client": "^5.1.1",
     "@types/uuid": "^9.0.7"
   },
-  "gitHead": "ccc646f22202e951675e695fd4e5be2cfde4e9a5"
+  "gitHead": "9683432160a36b785e866b447e2baaecf11f00ab"
 }

package/src/fieldTypes/rich_text.ts

@@ -71,7 +71,7 @@ export type RichTextFieldValueAsRequest = BlockItemInARequest[] | null;
 /**
  * Modular Content field value with nested blocks - array of fully populated block objects
  */
-export type RichTextFieldValueWithResolvedBlocks = SchemaTypes.Item[] | null;
+export type RichTextFieldValueWithNestedBlocks = SchemaTypes.Item[] | null;
 
 /**
  * =============================================================================
@@ -117,9 +117,9 @@ export function isRichTextFieldValueAsRequest(
  * Type guard for Modular Content field values with nested blocks (?nested=true format).
  * Ensures all blocks are full SchemaTypes.Item objects with complete data.
  */
-export function isRichTextFieldValueWithResolvedBlocks(
+export function isRichTextFieldValueWithNestedBlocks(
   value: unknown,
-): value is RichTextFieldValueWithResolvedBlocks {
+): value is RichTextFieldValueWithNestedBlocks {
   if (value === null) return true;
 
   if (!Array.isArray(value)) return false;

package/src/fieldTypes/single_block.ts

@@ -77,7 +77,7 @@ export type SingleBlockFieldValueAsRequest = BlockItemInARequest | null;
 /**
  * Single Block field value with nested block - fully populated block object
  */
-export type SingleBlockFieldValueWithResolvedBlocks = SchemaTypes.Item | null;
+export type SingleBlockFieldValueWithNestedBlocks = SchemaTypes.Item | null;
 
 /**
  * =============================================================================
@@ -159,9 +159,9 @@ export function isSingleBlockFieldValueAsRequest(
  * Type guard for Single Block field values with nested blocks (?nested=true format).
  * Ensures block is a full SchemaTypes.Item object with complete data.
  */
-export function isSingleBlockFieldValueWithResolvedBlocks(
+export function isSingleBlockFieldValueWithNestedBlocks(
   value: unknown,
-): value is SingleBlockFieldValueWithResolvedBlocks {
+): value is SingleBlockFieldValueWithNestedBlocks {
   if (value === null) return true;
 
   // Must be a full object with ID (nested format always includes complete block objects)

package/src/fieldTypes/structured_text.ts

@@ -94,35 +94,35 @@ export type DocumentAsRequest = {
 /**
  * Variant of 'block' structured text node for ?nested=true API responses
  */
-export type BlockWithResolvedBlocks = Omit<Block, 'item'> & {
+export type BlockWithNestedBlocks = Omit<Block, 'item'> & {
   item: SchemaTypes.Item;
 };
 
 /**
  * Variant of 'inlineBlock' structured text node for ?nested=true API responses
  */
-export type InlineBlockWithResolvedBlocks = Omit<InlineBlock, 'item'> & {
+export type InlineBlockWithNestedBlocks = Omit<InlineBlock, 'item'> & {
   item: SchemaTypes.Item;
 };
 
 /**
  * Generic type to transform a node that might be containing a 'block' or 'inlineBlock' as a (deeply nested) children to it's variant for ?nested=true API responses
  */
-export type NodeWithResolvedBlocks<T> = WithMappedChildren<
+export type NodeWithNestedBlocks<T> = WithMappedChildren<
   T,
   DeepMapVariants<
     T extends { children: infer C } ? C : never,
-    BlockWithResolvedBlocks,
-    InlineBlockWithResolvedBlocks
+    BlockWithNestedBlocks,
+    InlineBlockWithNestedBlocks
   >
 >;
 
 /**
  * Variant of Structured Text document for ?nested=true API responses
  */
-export type DocumentWithResolvedBlocks = {
+export type DocumentWithNestedBlocks = {
   schema: 'dast';
-  document: NodeWithResolvedBlocks<Root>;
+  document: NodeWithNestedBlocks<Root>;
 };
 
 /**
@@ -137,8 +137,8 @@ export type DocumentWithResolvedBlocks = {
  */
 export type StructuredTextFieldValue = Document | null;
 export type StructuredTextFieldValueAsRequest = DocumentAsRequest | null;
-export type StructuredTextFieldValueWithResolvedBlocks =
-  DocumentWithResolvedBlocks | null;
+export type StructuredTextFieldValueWithNestedBlocks =
+  DocumentWithNestedBlocks | null;
 
 /**
  * Helper function to validate if a value has the expected structured text document structure.
@@ -165,10 +165,10 @@ function validateAllBlockNodes(
     node:
       | Block
       | BlockAsRequest
-      | BlockWithResolvedBlocks
+      | BlockWithNestedBlocks
       | InlineBlock
       | InlineBlockAsRequest
-      | InlineBlockWithResolvedBlocks,
+      | InlineBlockWithNestedBlocks,
   ) => boolean,
 ): boolean {
   return everyNode(node, (currentNode) => {
@@ -232,9 +232,9 @@ export function isStructuredTextFieldValueAsRequest(
  * Type guard for structured text field values with nested blocks (?nested=true format).
  * Ensures all block/inlineBlock nodes have full SchemaTypes.Item objects.
  */
-export function isStructuredTextFieldValueWithResolvedBlocks(
+export function isStructuredTextFieldValueWithNestedBlocks(
   value: unknown,
-): value is StructuredTextFieldValueWithResolvedBlocks {
+): value is StructuredTextFieldValueWithNestedBlocks {
   if (value === null) return true;
 
   if (!isValidDocumentStructure(value)) {

package/src/generated/Client.ts

@@ -147,7 +147,7 @@ export class Client {
       ...this.config,
       ...options,
       logFn: this.config.logFn || console.log,
-      userAgent: '@datocms/cma-client v5.1.0',
+      userAgent: '@datocms/cma-client v5.1.1',
       baseUrl: this.baseUrl,
       preCallStack: new Error().stack,
       extraHeaders: {

package/src/generated/SchemaTypes.ts

@@ -278,12 +278,24 @@ 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 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 FieldCreateConfigForFieldType<
+type NonLocalizedFieldCreateConfigForFieldType<
   SourceType,
   FieldType extends RawFieldAttributes['field_type'],
   FieldValue,
@@ -291,14 +303,37 @@ type FieldCreateConfigForFieldType<
   FieldAppearance,
 > = Omit<
   SourceType,
-  'field_type' | 'default_value' | 'validators' | 'appearance'
+  'field_type' | 'default_value' | 'validators' | 'appearance' | 'localized'
 > & {
   field_type: FieldType;
-  default_value?: FieldCreateDefaultValue<FieldValue>;
+  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,

package/src/generated/SimpleSchemaTypes.ts

@@ -278,12 +278,24 @@ 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 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 FieldCreateConfigForFieldType<
+type NonLocalizedFieldCreateConfigForFieldType<
   SourceType,
   FieldType extends RawFieldAttributes['field_type'],
   FieldValue,
@@ -291,14 +303,37 @@ type FieldCreateConfigForFieldType<
   FieldAppearance,
 > = Omit<
   SourceType,
-  'field_type' | 'default_value' | 'validators' | 'appearance'
+  'field_type' | 'default_value' | 'validators' | 'appearance' | 'localized'
 > & {
   field_type: FieldType;
-  default_value?: FieldCreateDefaultValue<FieldValue>;
+  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,

package/src/utilities/blocks.ts

@@ -26,13 +26,13 @@ import type {
   BlockItemInARequest,
   RichTextFieldValue,
   RichTextFieldValueAsRequest,
-  RichTextFieldValueWithResolvedBlocks,
+  RichTextFieldValueWithNestedBlocks,
   SingleBlockFieldValue,
   SingleBlockFieldValueAsRequest,
-  SingleBlockFieldValueWithResolvedBlocks,
+  SingleBlockFieldValueWithNestedBlocks,
   StructuredTextFieldValue,
   StructuredTextFieldValueAsRequest,
-  StructuredTextFieldValueWithResolvedBlocks,
+  StructuredTextFieldValueWithNestedBlocks,
 } from '../fieldTypes';
 import type * as SchemaTypes from '../generated/SchemaTypes';
 import type * as SimpleSchemaTypes from '../generated/SimpleSchemaTypes';
@@ -49,15 +49,15 @@ import {
 type PossibleRichTextValue =
   | RichTextFieldValue
   | RichTextFieldValueAsRequest
-  | RichTextFieldValueWithResolvedBlocks;
+  | RichTextFieldValueWithNestedBlocks;
 type PossibleSingleBlockValue =
   | SingleBlockFieldValue
   | SingleBlockFieldValueAsRequest
-  | SingleBlockFieldValueWithResolvedBlocks;
+  | SingleBlockFieldValueWithNestedBlocks;
 type PossibleStructuredTextValue =
   | StructuredTextFieldValue
   | StructuredTextFieldValueAsRequest
-  | StructuredTextFieldValueWithResolvedBlocks;
+  | StructuredTextFieldValueWithNestedBlocks;
 
 function getFieldType(field: SchemaTypes.Field | SimpleSchemaTypes.Field) {
   return 'attributes' in field ? field.attributes.field_type : field.field_type;