@datocms/cma-client 5.1.3 → 5.1.5

package/dist/esm/index.d.ts

@@ -10,6 +10,7 @@ export * from './utilities/fieldValue';
 export * from './utilities/id';
 export * from './utilities/recursiveBlocks';
 export * from './utilities/schemaRepository';
+export * from './utilities/itemDefinition';
 export * from './fieldTypes';
 export type { ApiTypes, RawApiTypes };
 export type { ApiTypes as SchemaTypes, RawApiTypes as SimpleSchemaTypes };

package/dist/esm/index.js

@@ -9,5 +9,6 @@ export * from './utilities/fieldValue';
 export * from './utilities/id';
 export * from './utilities/recursiveBlocks';
 export * from './utilities/schemaRepository';
+export * from './utilities/itemDefinition';
 export * from './fieldTypes';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC9E,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAC;AACnD,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC9E,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAC;AACnD,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wCAAwC,CAAC;AACvD,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC"}

package/dist/esm/utilities/buildBlockRecord.d.ts

@@ -1,32 +1,6 @@
+import type { NewBlockInARequest } from '../fieldTypes';
 import type * as ApiTypes from '../generated/ApiTypes';
-import type * as RawApiTypes from '../generated/RawApiTypes';
-export declare function buildBlockRecord(body: ApiTypes.ItemUpdateSchema): {
-    type: "item";
-    id: string;
-    attributes?: {
-        [k: string]: unknown;
-    } | undefined;
-    meta?: {
-        created_at?: string | undefined;
-        updated_at?: string | undefined;
-        published_at?: string | null | undefined;
-        first_published_at?: string | null | undefined;
-        publication_scheduled_at?: string | null | undefined;
-        unpublishing_scheduled_at?: string | null | undefined;
-        status?: "published" | "draft" | "updated" | null | undefined;
-        is_valid?: boolean | undefined;
-        current_version?: string | undefined;
-        is_current_version_valid?: boolean | null | undefined;
-        is_published_version_valid?: boolean | null | undefined;
-        stage?: string | null | undefined;
-        has_children?: boolean | null | undefined;
-    } | undefined;
-    relationships?: {
-        item_type?: {
-            data: RawApiTypes.ItemTypeData;
-        } | undefined;
-        creator?: {
-            data: RawApiTypes.UserData | RawApiTypes.SsoUserData | RawApiTypes.AccessTokenData | RawApiTypes.AccountData | RawApiTypes.OrganizationData;
-        } | undefined;
-    } | undefined;
-};
+import type { ItemTypeDefinition, ItemTypeDefinitionToItemDefinitionAsRequest } from './itemDefinition';
+type NoInfer<T> = [T][T extends any ? 0 : never];
+export declare function buildBlockRecord<D extends ItemTypeDefinition = ItemTypeDefinition>(body: ApiTypes.ItemUpdateSchema<ItemTypeDefinitionToItemDefinitionAsRequest<NoInfer<D>>>): NewBlockInARequest<ItemTypeDefinitionToItemDefinitionAsRequest<NoInfer<D>>>;
+export {};

package/dist/esm/utilities/buildBlockRecord.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildBlockRecord.js","sourceRoot":"","sources":["../../../src/utilities/buildBlockRecord.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,4BAA4B,CAAC;AAGpD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C,MAAM,UAAU,gBAAgB,CAAC,IAA+B;IAC9D,OAAO,KAAK,CAAC,oBAAoB,CAA+B,IAAI,EAAE;QACpE,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,GAAG;QACf,aAAa,EAAE,CAAC,WAAW,CAAC;KAC7B,CAAC,CAAC,IAAI,CAAC;AACV,CAAC"}
+{"version":3,"file":"buildBlockRecord.js","sourceRoot":"","sources":["../../../src/utilities/buildBlockRecord.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,4BAA4B,CAAC;AAGpD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAQ9C,MAAM,UAAU,gBAAgB,CAG9B,IAEC;IAED,OAAO,KAAK,CAAC,oBAAoB,CAI9B,IAAI,EAAE;QACP,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,GAAG;QACf,aAAa,EAAE,CAAC,WAAW,CAAC;KAC7B,CAAC,CAAC,IAAI,CAAC;AACV,CAAC"}

package/dist/esm/utilities/itemDefinition.d.ts

@@ -0,0 +1,74 @@
+import type { BooleanFieldValue, ColorFieldValue, DateFieldValue, DateTimeFieldValue, FileFieldValue, FloatFieldValue, GalleryFieldValue, IntegerFieldValue, JsonFieldValue, LatLonFieldValue, LinkFieldValue, LinksFieldValue, RichTextFieldValue, RichTextFieldValueAsRequest, RichTextFieldValueWithNestedBlocks, SeoFieldValue, SingleBlockFieldValue, SingleBlockFieldValueAsRequest, SingleBlockFieldValueWithNestedBlocks, SlugFieldValue, StringFieldValue, StructuredTextFieldValue, StructuredTextFieldValueAsRequest, StructuredTextFieldValueWithNestedBlocks, TextFieldValue, VideoFieldValue } from '../fieldTypes';
+import type { LocalizedFieldValue } from './fieldValue';
+/** Base field definition */
+type BaseFieldDefinition<Type extends string> = {
+    type: Type;
+    localized?: boolean;
+};
+type RichTextFieldDefinition<AllowedBlocks extends ItemTypeDefinition = ItemTypeDefinition> = BaseFieldDefinition<'rich_text'> & {
+    blocks: AllowedBlocks;
+};
+type SingleBlockFieldDefinition<AllowedBlocks extends ItemTypeDefinition = ItemTypeDefinition> = BaseFieldDefinition<'single_block'> & {
+    blocks: AllowedBlocks;
+};
+type StructuredTextFieldDefinition<AllowedBlocks extends ItemTypeDefinition = ItemTypeDefinition, AllowedInlineBlocks extends ItemTypeDefinition = ItemTypeDefinition> = BaseFieldDefinition<'structured_text'> & {
+    blocks: AllowedBlocks;
+    inline_blocks: AllowedInlineBlocks;
+};
+/** Field definition union */
+export type FieldDefinition = BaseFieldDefinition<'boolean' | 'color' | 'date' | 'date_time' | 'file' | 'float' | 'gallery' | 'integer' | 'json' | 'lat_lon' | 'link' | 'links' | 'seo' | 'slug' | 'string' | 'text' | 'video' | 'unknown'> | RichTextFieldDefinition | SingleBlockFieldDefinition | StructuredTextFieldDefinition;
+/** Item type definition */
+export type ItemTypeDefinition<ItemTypeId extends string = string, FieldDefinitions extends Record<string, FieldDefinition> = {}> = {
+    itemTypeId: ItemTypeId;
+    fields: FieldDefinitions;
+};
+/** Item definition */
+export type ItemDefinition<ItemTypeId extends string = string, FieldValues extends Record<string, unknown> = Record<string, unknown>> = {
+    itemTypeId: ItemTypeId;
+    fields: FieldValues;
+};
+/** Standard field values */
+type FieldTypeToValue = {
+    boolean: BooleanFieldValue;
+    color: ColorFieldValue;
+    date: DateFieldValue;
+    date_time: DateTimeFieldValue;
+    file: FileFieldValue;
+    float: FloatFieldValue;
+    gallery: GalleryFieldValue;
+    integer: IntegerFieldValue;
+    json: JsonFieldValue;
+    lat_lon: LatLonFieldValue;
+    link: LinkFieldValue;
+    links: LinksFieldValue;
+    rich_text: RichTextFieldValue;
+    seo: SeoFieldValue;
+    single_block: SingleBlockFieldValue;
+    slug: SlugFieldValue;
+    string: StringFieldValue;
+    structured_text: StructuredTextFieldValue;
+    text: TextFieldValue;
+    video: VideoFieldValue;
+    unknown: unknown;
+};
+/** Localized wrapper */
+type LocalizeIfNeeded<T extends FieldDefinition, Value> = T extends {
+    localized: true;
+} ? LocalizedFieldValue<Value> : Value;
+/** Standard mapping */
+type FieldDefinitionToFieldValue<T extends FieldDefinition> = LocalizeIfNeeded<T, FieldTypeToValue[T['type']]>;
+/** AsRequest mapping (block fields become generic over allowed blocks) */
+type FieldDefinitionToFieldValueAsRequest<T extends FieldDefinition> = T extends RichTextFieldDefinition<infer B> ? LocalizeIfNeeded<T, RichTextFieldValueAsRequest<ItemTypeDefinitionToItemDefinitionAsRequest<B>>> : T extends SingleBlockFieldDefinition<infer B> ? LocalizeIfNeeded<T, SingleBlockFieldValueAsRequest<ItemTypeDefinitionToItemDefinitionAsRequest<B>>> : T extends StructuredTextFieldDefinition<infer B, infer I> ? LocalizeIfNeeded<T, StructuredTextFieldValueAsRequest<ItemTypeDefinitionToItemDefinitionAsRequest<B>, ItemTypeDefinitionToItemDefinitionAsRequest<I>>> : LocalizeIfNeeded<T, FieldTypeToValue[T['type']]>;
+type FieldDefinitionToFieldValueWithNestedBlocks<T extends FieldDefinition> = T extends RichTextFieldDefinition<infer B> ? LocalizeIfNeeded<T, RichTextFieldValueWithNestedBlocks<ItemTypeDefinitionToItemDefinitionWithNestedBlocks<B>>> : T extends SingleBlockFieldDefinition<infer B> ? LocalizeIfNeeded<T, SingleBlockFieldValueWithNestedBlocks<ItemTypeDefinitionToItemDefinitionWithNestedBlocks<B>>> : T extends StructuredTextFieldDefinition<infer B, infer I> ? LocalizeIfNeeded<T, StructuredTextFieldValueWithNestedBlocks<ItemTypeDefinitionToItemDefinitionWithNestedBlocks<B>, ItemTypeDefinitionToItemDefinitionWithNestedBlocks<I>>> : LocalizeIfNeeded<T, FieldTypeToValue[T['type']]>;
+/** Transformers */
+export type ItemTypeDefinitionToItemDefinition<T extends ItemTypeDefinition> = T extends ItemTypeDefinition ? keyof T['fields'] extends never ? ItemDefinition<T['itemTypeId']> : ItemDefinition<T['itemTypeId'], {
+    [K in keyof T['fields']]: T['fields'][K] extends FieldDefinition ? FieldDefinitionToFieldValue<T['fields'][K]> : never;
+}> : never;
+export type ItemTypeDefinitionToItemDefinitionAsRequest<T extends ItemTypeDefinition> = T extends ItemTypeDefinition ? keyof T['fields'] extends never ? ItemDefinition<T['itemTypeId']> : ItemDefinition<T['itemTypeId'], Partial<{
+    [K in keyof T['fields']]: T['fields'][K] extends FieldDefinition ? FieldDefinitionToFieldValueAsRequest<T['fields'][K]> : never;
+}>> : never;
+export type ItemTypeDefinitionToItemDefinitionWithNestedBlocks<T extends ItemTypeDefinition> = T extends ItemTypeDefinition ? keyof T['fields'] extends never ? ItemDefinition<T['itemTypeId']> : ItemDefinition<T['itemTypeId'], {
+    [K in keyof T['fields']]: T['fields'][K] extends FieldDefinition ? FieldDefinitionToFieldValueWithNestedBlocks<T['fields'][K]> : never;
+}> : never;
+export type UnknownField = Record<string, unknown>;
+export {};

package/dist/esm/utilities/itemDefinition.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=itemDefinition.js.map

package/dist/esm/utilities/itemDefinition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"itemDefinition.js","sourceRoot":"","sources":["../../../src/utilities/itemDefinition.ts"],"names":[],"mappings":""}

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

@@ -15,7 +15,7 @@ export type GalleryFieldValue = Array<{
         x: number;
         y: number;
     } | null;
-}> | null;
+}>;
 export declare function isGalleryFieldValue(value: unknown): value is GalleryFieldValue;
 export declare function isLocalizedGalleryFieldValue(value: unknown): value is LocalizedFieldValue<GalleryFieldValue>;
 export type GalleryFieldValidators = {

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

@@ -1,17 +1,17 @@
 import type { LocalizedFieldValue } from '../utilities/fieldValue';
 import type { MapEditorConfiguration } from './appearance/map';
 import type { RequiredValidator } from './validators/required';
-export type LocationFieldValue = {
+export type LatLonFieldValue = {
     latitude: number;
     longitude: number;
 } | null;
-export declare function isLocationFieldValue(value: unknown): value is LocationFieldValue;
-export declare function isLocalizedLocationFieldValue(value: unknown): value is LocalizedFieldValue<LocationFieldValue>;
-export type LocationFieldValidators = {
+export declare function isLatLonFieldValue(value: unknown): value is LatLonFieldValue;
+export declare function isLocalizedLatLonFieldValue(value: unknown): value is LocalizedFieldValue<LatLonFieldValue>;
+export type LatLonFieldValidators = {
     /** Value must be specified or it won't be valid */
     required?: RequiredValidator;
 };
-export type LocationFieldAppearance = {
+export type LatLonFieldAppearance = {
     editor: 'map';
     parameters: MapEditorConfiguration;
 } | {

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

@@ -1,5 +1,6 @@
 import type * as RawApiTypes from '../generated/RawApiTypes';
 import type { LocalizedFieldValue } from '../utilities/fieldValue';
+import type { ItemDefinition } from '../utilities/itemDefinition';
 import type { RichTextEditorConfiguration } from './appearance/rich_text';
 import { type BlockItemInARequest } from './single_block';
 import type { RichTextBlocksValidator } from './validators/rich_text_blocks';
@@ -33,7 +34,7 @@ import type { SizeValidator } from './validators/size';
 /**
  * Basic Modular Content field value - array of string block IDs (lightweight references)
  */
-export type RichTextFieldValue = string[] | null;
+export type RichTextFieldValue = string[];
 /**
  * =============================================================================
  * REQUEST VARIANT - Type for sending data TO the DatoCMS API
@@ -50,7 +51,7 @@ export type RichTextFieldValue = string[] | null;
  * - RawApiTypes.Item: Full block object with ID (for updates)
  * - Omit<RawApiTypes.Item, 'id'>: Block object without ID (for creation)
  */
-export type RichTextFieldValueAsRequest = BlockItemInARequest[] | null;
+export type RichTextFieldValueAsRequest<D extends ItemDefinition = ItemDefinition> = BlockItemInARequest<D>[] | null;
 /**
  * =============================================================================
  * NESTED VARIANT - Type for API responses with ?nested=true parameter
@@ -63,7 +64,7 @@ export type RichTextFieldValueAsRequest = BlockItemInARequest[] | null;
 /**
  * Modular Content field value with nested blocks - array of fully populated block objects
  */
-export type RichTextFieldValueWithNestedBlocks = RawApiTypes.Item[] | null;
+export type RichTextFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition> = RawApiTypes.Item<D>[];
 /**
  * =============================================================================
  * TYPE GUARDS - Runtime validation functions
@@ -79,14 +80,14 @@ export declare function isLocalizedRichTextFieldValue(value: unknown): value is
  * Type guard for Modular Content field values in API request format.
  * Allows blocks as string IDs, full objects with IDs, or objects without IDs.
  */
-export declare function isRichTextFieldValueAsRequest(value: unknown): value is RichTextFieldValueAsRequest;
-export declare function isLocalizedRichTextFieldValueAsRequest(value: unknown): value is LocalizedFieldValue<RichTextFieldValueAsRequest>;
+export declare function isRichTextFieldValueAsRequest<D extends ItemDefinition = ItemDefinition>(value: unknown): value is RichTextFieldValueAsRequest<D>;
+export declare function isLocalizedRichTextFieldValueAsRequest<D extends ItemDefinition = ItemDefinition>(value: unknown): value is LocalizedFieldValue<RichTextFieldValueAsRequest<D>>;
 /**
  * Type guard for Modular Content field values with nested blocks (?nested=true format).
  * Ensures all blocks are full RawApiTypes.Item objects with complete data.
  */
-export declare function isRichTextFieldValueWithNestedBlocks(value: unknown): value is RichTextFieldValueWithNestedBlocks;
-export declare function isLocalizedRichTextFieldValueWithNestedBlocks(value: unknown): value is LocalizedFieldValue<RichTextFieldValueWithNestedBlocks>;
+export declare function isRichTextFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition>(value: unknown): value is RichTextFieldValueWithNestedBlocks<D>;
+export declare function isLocalizedRichTextFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition>(value: unknown): value is LocalizedFieldValue<RichTextFieldValueWithNestedBlocks<D>>;
 export type RichTextFieldValidators = {
     /** Only accept references to block records of the specified block models */
     rich_text_blocks: RichTextBlocksValidator;

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

@@ -1,5 +1,6 @@
 import type * as RawApiTypes from '../generated/RawApiTypes';
 import type { LocalizedFieldValue } from '../utilities/fieldValue';
+import type { ItemDefinition } from '../utilities/itemDefinition';
 import type { FramedSingleBlockEditorConfiguration } from './appearance/framed_single_block';
 import type { FramelessSingleBlockEditorConfiguration } from './appearance/frameless_single_block';
 import type { RequiredValidator } from './validators/required';
@@ -45,11 +46,11 @@ export type SingleBlockFieldValue = string | null;
  * - Omit ID for new blocks being created
  */
 /** Represents an existing block in a CMA request */
-export type UnchangedBlockInARequest = string;
+export type UnchangedBlockInARequest<D extends ItemDefinition = ItemDefinition> = RawApiTypes.Item<D>['id'];
 /** Represents a block we want to update in a CMA request */
-export type UpdatedBlockInARequest = OptionalFields<RawApiTypes.Item, 'meta'>;
+export type UpdatedBlockInARequest<D extends ItemDefinition = ItemDefinition> = OptionalFields<RawApiTypes.Item<D>, 'meta'>;
 /** Represents a new block to create in a CMA request */
-export type NewBlockInARequest = OptionalFields<RawApiTypes.Item, 'id' | 'meta'>;
+export type NewBlockInARequest<D extends ItemDefinition = ItemDefinition> = OptionalFields<RawApiTypes.Item<D>, 'id' | 'meta'>;
 /**
  * Union type representing the different ways a block can be specified in API requests:
  * - string: Just the block ID (to keep existing blocks unchanged)
@@ -58,14 +59,14 @@ export type NewBlockInARequest = OptionalFields<RawApiTypes.Item, 'id' | 'meta'>
  *
  * Also, 'meta' can always be omitted
  */
-export type BlockItemInARequest = UnchangedBlockInARequest | UpdatedBlockInARequest | NewBlockInARequest;
+export type BlockItemInARequest<D extends ItemDefinition = ItemDefinition> = UnchangedBlockInARequest | UpdatedBlockInARequest<D> | NewBlockInARequest<D>;
 /**
  * Single Block field value for API requests - allows flexible block representations:
  * - string: Just the block ID (to keep existing blocks unchanged)
  * - Full block object with ID (to update an existing block)
  * - Block object without ID (to create a new block)
  */
-export type SingleBlockFieldValueAsRequest = BlockItemInARequest | null;
+export type SingleBlockFieldValueAsRequest<D extends ItemDefinition = ItemDefinition> = BlockItemInARequest<D> | null;
 /**
  * =============================================================================
  * NESTED VARIANT - Type for API responses with ?nested=true parameter
@@ -78,7 +79,7 @@ export type SingleBlockFieldValueAsRequest = BlockItemInARequest | null;
 /**
  * Single Block field value with nested block - fully populated block object
  */
-export type SingleBlockFieldValueWithNestedBlocks = RawApiTypes.Item | null;
+export type SingleBlockFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition> = RawApiTypes.Item<D> | null;
 /**
  * =============================================================================
  * SHARED UTILITY FUNCTIONS
@@ -89,16 +90,16 @@ export type SingleBlockFieldValueWithNestedBlocks = RawApiTypes.Item | null;
  * Validates if the input is a valid item (either block or record) ID
  */
 export declare function isItemId(input: unknown): input is string;
-export type ItemWithOptionalIdAndMeta = OptionalFields<RawApiTypes.Item, 'id' | 'meta'>;
+export type ItemWithOptionalIdAndMeta<D extends ItemDefinition = ItemDefinition> = OptionalFields<RawApiTypes.Item<D>, 'id' | 'meta'>;
 /**
  * Validates if the input is a RawApiTypes.Item object (with optional `id` and `meta`)
  */
-export declare function isItemWithOptionalIdAndMeta(block: unknown): block is ItemWithOptionalIdAndMeta;
-export type ItemWithOptionalMeta = OptionalFields<RawApiTypes.Item, 'meta'>;
+export declare function isItemWithOptionalIdAndMeta<D extends ItemDefinition = ItemDefinition>(block: unknown): block is ItemWithOptionalIdAndMeta<D>;
+export type ItemWithOptionalMeta<D extends ItemDefinition = ItemDefinition> = OptionalFields<RawApiTypes.Item<D>, 'meta'>;
 /**
  * Validates if the input is a a complete RawApiTypes.Item object with optional `meta`
  */
-export declare function isItemWithOptionalMeta(block: unknown): block is ItemWithOptionalMeta;
+export declare function isItemWithOptionalMeta<D extends ItemDefinition = ItemDefinition>(block: unknown): block is ItemWithOptionalMeta<D>;
 /**
  * =============================================================================
  * TYPE GUARDS - Runtime validation functions
@@ -114,14 +115,14 @@ export declare function isLocalizedSingleBlockFieldValue(value: unknown): value
  * Type guard for Single Block field values in API request format.
  * Allows block as string ID, full object with ID, or object without ID.
  */
-export declare function isSingleBlockFieldValueAsRequest(value: unknown): value is SingleBlockFieldValueAsRequest;
-export declare function isLocalizedSingleBlockFieldValueAsRequest(value: unknown): value is LocalizedFieldValue<SingleBlockFieldValueAsRequest>;
+export declare function isSingleBlockFieldValueAsRequest<D extends ItemDefinition = ItemDefinition>(value: unknown): value is SingleBlockFieldValueAsRequest<D>;
+export declare function isLocalizedSingleBlockFieldValueAsRequest<D extends ItemDefinition = ItemDefinition>(value: unknown): value is LocalizedFieldValue<SingleBlockFieldValueAsRequest<D>>;
 /**
  * Type guard for Single Block field values with nested blocks (?nested=true format).
  * Ensures block is a full RawApiTypes.Item object with complete data.
  */
-export declare function isSingleBlockFieldValueWithNestedBlocks(value: unknown): value is SingleBlockFieldValueWithNestedBlocks;
-export declare function isLocalizedSingleBlockFieldValueWithNestedBlocks(value: unknown): value is LocalizedFieldValue<SingleBlockFieldValueWithNestedBlocks>;
+export declare function isSingleBlockFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition>(value: unknown): value is SingleBlockFieldValueWithNestedBlocks<D>;
+export declare function isLocalizedSingleBlockFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition>(value: unknown): value is LocalizedFieldValue<SingleBlockFieldValueWithNestedBlocks<D>>;
 export type SingleBlockFieldValidators = {
     /** Only accept references to block records of the specified block models */
     single_block_blocks: SingleBlockBlocksValidator;

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

@@ -1,6 +1,7 @@
 import { type Block, type Document, type InlineBlock } from 'datocms-structured-text-utils';
 import type * as RawApiTypes from '../generated/RawApiTypes';
 import type { LocalizedFieldValue } from '../utilities/fieldValue';
+import type { ItemDefinition } from '../utilities/itemDefinition';
 import type { StructuredTextEditorConfiguration } from './appearance/structured_text';
 import { type BlockItemInARequest } from './single_block';
 import type { LengthValidator } from './validators/length';
@@ -39,15 +40,15 @@ import type { StructuredTextLinksValidator } from './validators/structured_text_
 /**
  * Variant of 'block' structured text node for API requests
  */
-export type BlockAsRequest = Block<BlockItemInARequest>;
+export type BlockAsRequest<D extends ItemDefinition = ItemDefinition> = Block<BlockItemInARequest<D>>;
 /**
  * Variant of 'inlineBlock' structured text node for API requests
  */
-export type InlineBlockAsRequest = InlineBlock<BlockItemInARequest>;
+export type InlineBlockAsRequest<D extends ItemDefinition = ItemDefinition> = InlineBlock<BlockItemInARequest<D>>;
 /**
  * Variant of Structured Text document for API requests
  */
-export type DocumentAsRequest = Document<BlockItemInARequest>;
+export type DocumentAsRequest<BlockItemDefinition extends ItemDefinition = ItemDefinition, InlineBlockItemDefinition extends ItemDefinition = ItemDefinition> = Document<BlockItemInARequest<BlockItemDefinition>, BlockItemInARequest<InlineBlockItemDefinition>>;
 /**
  * =============================================================================
  * NESTED VARIANTS - Types for API responses with ?nested=true parameter
@@ -60,15 +61,15 @@ export type DocumentAsRequest = Document<BlockItemInARequest>;
 /**
  * Variant of 'block' structured text node for ?nested=true API responses
  */
-export type BlockWithNestedBlocks = Block<RawApiTypes.Item>;
+export type BlockWithNestedBlocks<D extends ItemDefinition = ItemDefinition> = Block<RawApiTypes.Item<D>>;
 /**
  * Variant of 'inlineBlock' structured text node for ?nested=true API responses
  */
-export type InlineBlockWithNestedBlocks = InlineBlock<RawApiTypes.Item>;
+export type InlineBlockWithNestedBlocks<D extends ItemDefinition = ItemDefinition> = InlineBlock<RawApiTypes.Item<D>>;
 /**
  * Variant of Structured Text document for ?nested=true API responses
  */
-export type DocumentWithNestedBlocks = Document<RawApiTypes.Item>;
+export type DocumentWithNestedBlocks<BlockItemDefinition extends ItemDefinition = ItemDefinition, InlineBlockItemDefinition extends ItemDefinition = ItemDefinition> = Document<RawApiTypes.Item<BlockItemDefinition>, RawApiTypes.Item<InlineBlockItemDefinition>>;
 /**
  * =============================================================================
  * MAIN APPLICATION TYPES
@@ -79,8 +80,8 @@ export type DocumentWithNestedBlocks = Document<RawApiTypes.Item>;
  * Can be null (empty field) or a document with blocks as string IDs
  */
 export type StructuredTextFieldValue = Document | null;
-export type StructuredTextFieldValueAsRequest = DocumentAsRequest | null;
-export type StructuredTextFieldValueWithNestedBlocks = DocumentWithNestedBlocks | null;
+export type StructuredTextFieldValueAsRequest<BlockItemDefinition extends ItemDefinition = ItemDefinition, InlineBlockItemDefinition extends ItemDefinition = ItemDefinition> = DocumentAsRequest<BlockItemDefinition, InlineBlockItemDefinition> | null;
+export type StructuredTextFieldValueWithNestedBlocks<BlockItemDefinition extends ItemDefinition = ItemDefinition, InlineBlockItemDefinition extends ItemDefinition = ItemDefinition> = DocumentWithNestedBlocks<BlockItemDefinition, InlineBlockItemDefinition> | 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.
@@ -91,14 +92,14 @@ export declare function isLocalizedStructuredTextFieldValue(value: unknown): val
  * Type guard for structured text field values in API request format.
  * Allows blocks as string IDs, full objects with IDs, or objects without IDs.
  */
-export declare function isStructuredTextFieldValueAsRequest(value: unknown): value is StructuredTextFieldValueAsRequest;
-export declare function isLocalizedStructuredTextFieldValueAsRequest(value: unknown): value is LocalizedFieldValue<StructuredTextFieldValueAsRequest>;
+export declare function isStructuredTextFieldValueAsRequest<BlockItemDefinition extends ItemDefinition = ItemDefinition, InlineBlockItemDefinition extends ItemDefinition = ItemDefinition>(value: unknown): value is StructuredTextFieldValueAsRequest<BlockItemDefinition, InlineBlockItemDefinition>;
+export declare function isLocalizedStructuredTextFieldValueAsRequest<D extends ItemDefinition = ItemDefinition>(value: unknown): value is LocalizedFieldValue<StructuredTextFieldValueAsRequest<D>>;
 /**
  * Type guard for structured text field values with nested blocks (?nested=true format).
  * Ensures all block/inlineBlock nodes have full RawApiTypes.Item objects.
  */
-export declare function isStructuredTextFieldValueWithNestedBlocks(value: unknown): value is StructuredTextFieldValueWithNestedBlocks;
-export declare function isLocalizedStructuredTextFieldValueWithNestedBlocks(value: unknown): value is LocalizedFieldValue<StructuredTextFieldValueWithNestedBlocks>;
+export declare function isStructuredTextFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition>(value: unknown): value is StructuredTextFieldValueWithNestedBlocks<D>;
+export declare function isLocalizedStructuredTextFieldValueWithNestedBlocks<D extends ItemDefinition = ItemDefinition>(value: unknown): value is LocalizedFieldValue<StructuredTextFieldValueWithNestedBlocks<D>>;
 export type StructuredTextFieldValidators = {
     /** Only accept references to block records of the specified block models */
     structured_text_blocks: StructuredTextBlocksValidator;