@datocms/cma-client 5.1.4 → 5.1.6

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

@@ -7,7 +7,7 @@ import type * as RawApiTypes from '../generated/RawApiTypes';
  * for various locales structured as an object, such as
  * `{ "en": "Hello", "it": "Ciao" }`
  */
-export type LocalizedFieldValue<T = unknown> = Record<string, T>;
+export type LocalizedFieldValue<T = unknown, L extends string = string> = Record<L, T>;
 /**
  * Determines whether a DatoCMS field is localized or not.
  *
@@ -26,11 +26,10 @@ export declare function isLocalized(field: RawApiTypes.Field | ApiTypes.Field):
  *
  * This uniform structure allows the same processing logic to work with both field types.
  */
-export type FieldValueEntry = {
-    locale: string | undefined;
-    value: unknown;
+export type FieldValueEntry<T = unknown, L extends string = string> = {
+    locale: L | undefined;
+    value: T;
 };
-export type PossiblyLocalizedEntry = FieldValueEntry;
 /**
  * Converts a field value (localized or non-localized) into a uniform array of entries.
  *
@@ -41,19 +40,19 @@ export type PossiblyLocalizedEntry = FieldValueEntry;
  * @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 fieldValueToEntries(field: RawApiTypes.Field | ApiTypes.Field, value: unknown): FieldValueEntry[];
+export declare function fieldValueToEntries<T = unknown, L extends string = string>(field: RawApiTypes.Field | ApiTypes.Field, value: T | LocalizedFieldValue<T, L>): FieldValueEntry<T, L>[];
 /**
  * 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
+ * This function is the inverse of `fieldValueToEntries`. 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
+ * @param entries - 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 entriesToFieldValue(field: RawApiTypes.Field | ApiTypes.Field, possiblyLocalizedEntries: FieldValueEntry[]): any;
+export declare function entriesToFieldValue<T = unknown, L extends string = string>(field: RawApiTypes.Field | ApiTypes.Field, entries: FieldValueEntry<T, L>[]): T | LocalizedFieldValue<T, L>;
 /**
  * Maps field values using a provided mapping function.
  * For localized fields, applies the mapping function to each locale value.
@@ -65,7 +64,7 @@ export declare function entriesToFieldValue(field: RawApiTypes.Field | ApiTypes.
  * @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 mapFieldValue<T>(field: RawApiTypes.Field | ApiTypes.Field, value: unknown, mapFn: (locale: string | undefined, localeValue: unknown) => T): any;
+export declare function mapFieldValue<TInput = unknown, TOutput = unknown, L extends string = string>(field: RawApiTypes.Field | ApiTypes.Field, value: TInput | LocalizedFieldValue<TInput, L>, mapFn: (locale: L | undefined, localeValue: TInput) => TOutput): TOutput | LocalizedFieldValue<TOutput, L>;
 /**
  * Maps field values using a provided mapping function (async version).
  * For localized fields, applies the mapping function to each locale value.
@@ -77,7 +76,7 @@ export declare function mapFieldValue<T>(field: RawApiTypes.Field | ApiTypes.Fie
  * @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 mapFieldValueAsync<T>(field: RawApiTypes.Field | ApiTypes.Field, value: unknown, mapFn: (locale: string | undefined, localeValue: unknown) => Promise<T>): Promise<any>;
+export declare function mapFieldValueAsync<TInput = unknown, TOutput = unknown, L extends string = string>(field: RawApiTypes.Field | ApiTypes.Field, value: TInput | LocalizedFieldValue<TInput, L>, mapFn: (locale: L | undefined, localeValue: TInput) => Promise<TOutput>): Promise<TOutput | LocalizedFieldValue<TOutput, L>>;
 /**
  * Filters field values using a provided filter function.
  * For localized fields, filters each locale value.
@@ -88,7 +87,7 @@ export declare function mapFieldValueAsync<T>(field: RawApiTypes.Field | ApiType
  * @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 filterFieldValue(field: RawApiTypes.Field | ApiTypes.Field, value: unknown, filterFn: (locale: string | undefined, localeValue: unknown) => boolean): any;
+export declare function filterFieldValue<T = unknown, L extends string = string>(field: RawApiTypes.Field | ApiTypes.Field, value: T | LocalizedFieldValue<T, L>, filterFn: (locale: L | undefined, localeValue: T) => boolean): T | LocalizedFieldValue<T, L> | undefined;
 /**
  * Filters field values using a provided filter function (async version).
  * For localized fields, filters each locale value.
@@ -99,7 +98,7 @@ export declare function filterFieldValue(field: RawApiTypes.Field | ApiTypes.Fie
  * @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 filterFieldValueAsync(field: RawApiTypes.Field | ApiTypes.Field, value: unknown, filterFn: (locale: string | undefined, localeValue: unknown) => Promise<boolean>): Promise<any>;
+export declare function filterFieldValueAsync<T = unknown, L extends string = string>(field: RawApiTypes.Field | ApiTypes.Field, value: T | LocalizedFieldValue<T, L>, filterFn: (locale: L | undefined, localeValue: T) => Promise<boolean>): Promise<T | LocalizedFieldValue<T, L> | undefined>;
 /**
  * Tests whether at least one field value passes the test implemented by the provided function.
  * For localized fields, tests each locale value.
@@ -110,7 +109,7 @@ export declare function filterFieldValueAsync(field: RawApiTypes.Field | ApiType
  * @param testFn - The function to test each locale value or the direct value
  * @returns true if at least one value passes the test, false otherwise
  */
-export declare function someFieldValue(field: RawApiTypes.Field | ApiTypes.Field, value: unknown, testFn: (locale: string | undefined, localeValue: unknown) => boolean): boolean;
+export declare function someFieldValue<T = unknown, L extends string = string>(field: RawApiTypes.Field | ApiTypes.Field, value: T | LocalizedFieldValue<T, L>, testFn: (locale: L | undefined, localeValue: T) => boolean): boolean;
 /**
  * Tests whether at least one field value passes the test implemented by the provided function (async version).
  * For localized fields, tests each locale value.
@@ -121,7 +120,7 @@ export declare function someFieldValue(field: RawApiTypes.Field | ApiTypes.Field
  * @param testFn - The function to test each locale value or the direct value
  * @returns true if at least one value passes the test, false otherwise
  */
-export declare function someFieldValueAsync(field: RawApiTypes.Field | ApiTypes.Field, value: unknown, testFn: (locale: string | undefined, localeValue: unknown) => Promise<boolean>): Promise<boolean>;
+export declare function someFieldValueAsync<T = unknown, L extends string = string>(field: RawApiTypes.Field | ApiTypes.Field, value: T | LocalizedFieldValue<T, L>, testFn: (locale: L | undefined, localeValue: T) => Promise<boolean>): Promise<boolean>;
 /**
  * Tests whether all field values pass the test implemented by the provided function.
  * For localized fields, tests each locale value.
@@ -132,7 +131,7 @@ export declare function someFieldValueAsync(field: RawApiTypes.Field | ApiTypes.
  * @param testFn - The function to test each locale value or the direct value
  * @returns true if all values pass the test, false otherwise
  */
-export declare function everyFieldValue(field: RawApiTypes.Field | ApiTypes.Field, value: unknown, testFn: (locale: string | undefined, localeValue: unknown) => boolean): boolean;
+export declare function everyFieldValue<T = unknown, L extends string = string>(field: RawApiTypes.Field | ApiTypes.Field, value: T | LocalizedFieldValue<T, L>, testFn: (locale: L | undefined, localeValue: T) => boolean): boolean;
 /**
  * Tests whether all field values pass the test implemented by the provided function (async version).
  * For localized fields, tests each locale value.
@@ -143,7 +142,7 @@ export declare function everyFieldValue(field: RawApiTypes.Field | ApiTypes.Fiel
  * @param testFn - The function to test each locale value or the direct value
  * @returns true if all values pass the test, false otherwise
  */
-export declare function everyFieldValueAsync(field: RawApiTypes.Field | ApiTypes.Field, value: unknown, testFn: (locale: string | undefined, localeValue: unknown) => Promise<boolean>): Promise<boolean>;
+export declare function everyFieldValueAsync<T = unknown, L extends string = string>(field: RawApiTypes.Field | ApiTypes.Field, value: T | LocalizedFieldValue<T, L>, testFn: (locale: L | undefined, localeValue: T) => Promise<boolean>): Promise<boolean>;
 /**
  * Visits each field value with the provided function.
  * For localized fields, visits each locale value.
@@ -153,7 +152,7 @@ export declare function everyFieldValueAsync(field: RawApiTypes.Field | ApiTypes
  * @param value - The field value (either localized object or direct value)
  * @param visitFn - The function to call for each locale value or the direct value
  */
-export declare function visitFieldValue(field: RawApiTypes.Field | ApiTypes.Field, value: unknown, visitFn: (locale: string | undefined, localeValue: unknown) => void): void;
+export declare function visitFieldValue<T = unknown, L extends string = string>(field: RawApiTypes.Field | ApiTypes.Field, value: T | LocalizedFieldValue<T, L>, visitFn: (locale: L | undefined, localeValue: T) => void): void;
 /**
  * Visits each field value with the provided function (async version).
  * For localized fields, visits each locale value.
@@ -163,4 +162,4 @@ export declare function visitFieldValue(field: RawApiTypes.Field | ApiTypes.Fiel
  * @param value - The field value (either localized object or direct value)
  * @param visitFn - The function to call for each locale value or the direct value
  */
-export declare function visitFieldValueAsync(field: RawApiTypes.Field | ApiTypes.Field, value: unknown, visitFn: (locale: string | undefined, localeValue: unknown) => Promise<void>): Promise<void>;
+export declare function visitFieldValueAsync<T = unknown, L extends string = string>(field: RawApiTypes.Field | ApiTypes.Field, value: T | LocalizedFieldValue<T, L>, visitFn: (locale: L | undefined, localeValue: T) => Promise<void>): Promise<void>;

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

@@ -12,13 +12,18 @@ type SingleBlockFieldDefinition<AllowedBlocks extends ItemTypeDefinition = ItemT
     blocks: AllowedBlocks;
 };
 type StructuredTextFieldDefinition<AllowedBlocks extends ItemTypeDefinition = ItemTypeDefinition, AllowedInlineBlocks extends ItemTypeDefinition = ItemTypeDefinition> = BaseFieldDefinition<'structured_text'> & {
-    blocks: AllowedBlocks;
-    inline_blocks: AllowedInlineBlocks;
+    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> = {}> = {
+export type ItemTypeDefinition<Settings extends {
+    locales: string;
+} = {
+    locales: string;
+}, ItemTypeId extends string = string, FieldDefinitions extends Record<string, FieldDefinition> = {}> = {
+    settings: Settings;
     itemTypeId: ItemTypeId;
     fields: FieldDefinitions;
 };
@@ -52,23 +57,31 @@ type FieldTypeToValue = {
     unknown: unknown;
 };
 /** Localized wrapper */
-type LocalizeIfNeeded<T extends FieldDefinition, Value> = T extends {
+type LocalizeIfNeeded<T extends FieldDefinition, Value, Locales extends string> = T extends {
     localized: true;
-} ? LocalizedFieldValue<Value> : Value;
+} ? LocalizedFieldValue<Value, Locales> : Value;
 /** Standard mapping */
-type FieldDefinitionToFieldValue<T extends FieldDefinition> = LocalizeIfNeeded<T, FieldTypeToValue[T['type']]>;
+type FieldDefinitionToFieldValue<T extends FieldDefinition, Locales extends string> = LocalizeIfNeeded<T, FieldTypeToValue[T['type']], Locales>;
 /** 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']]>;
+type FieldDefinitionToFieldValueAsRequest<T extends FieldDefinition, Locales extends string> = T extends RichTextFieldDefinition<infer B> ? LocalizeIfNeeded<T, RichTextFieldValueAsRequest<ItemTypeDefinitionToItemDefinitionAsRequest<B>>, Locales> : T extends SingleBlockFieldDefinition<infer B> ? LocalizeIfNeeded<T, SingleBlockFieldValueAsRequest<ItemTypeDefinitionToItemDefinitionAsRequest<B>>, Locales> : T extends StructuredTextFieldDefinition<infer B, infer I> ? LocalizeIfNeeded<T, StructuredTextFieldValueAsRequest<T extends {
+    blocks: any;
+} ? ItemTypeDefinitionToItemDefinitionAsRequest<B> : never, T extends {
+    inline_blocks: any;
+} ? ItemTypeDefinitionToItemDefinitionAsRequest<I> : never>, Locales> : LocalizeIfNeeded<T, FieldTypeToValue[T['type']], Locales>;
+type FieldDefinitionToFieldValueWithNestedBlocks<T extends FieldDefinition, Locales extends string> = T extends RichTextFieldDefinition<infer B> ? LocalizeIfNeeded<T, RichTextFieldValueWithNestedBlocks<ItemTypeDefinitionToItemDefinitionWithNestedBlocks<B>>, Locales> : T extends SingleBlockFieldDefinition<infer B> ? LocalizeIfNeeded<T, SingleBlockFieldValueWithNestedBlocks<ItemTypeDefinitionToItemDefinitionWithNestedBlocks<B>>, Locales> : T extends StructuredTextFieldDefinition<infer B, infer I> ? LocalizeIfNeeded<T, StructuredTextFieldValueWithNestedBlocks<T extends {
+    blocks: any;
+} ? ItemTypeDefinitionToItemDefinitionWithNestedBlocks<B> : never, T extends {
+    inline_blocks: any;
+} ? ItemTypeDefinitionToItemDefinitionWithNestedBlocks<I> : never>, Locales> : LocalizeIfNeeded<T, FieldTypeToValue[T['type']], Locales>;
 /** 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;
+export type ItemTypeDefinitionToItemDefinition<T extends ItemTypeDefinition<any, any, any>> = T extends ItemTypeDefinition<infer Settings, infer ItemTypeId, infer Fields> ? keyof Fields extends never ? ItemDefinition<ItemTypeId> : ItemDefinition<ItemTypeId, {
+    [K in keyof Fields]: Fields[K] extends FieldDefinition ? FieldDefinitionToFieldValue<Fields[K], Settings['locales']> : 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;
+export type ItemTypeDefinitionToItemDefinitionAsRequest<T extends ItemTypeDefinition<any, any, any>> = T extends ItemTypeDefinition<infer Settings, infer ItemTypeId, infer Fields> ? keyof Fields extends never ? ItemDefinition<ItemTypeId> : ItemDefinition<ItemTypeId, Partial<{
+    [K in keyof Fields]: Fields[K] extends FieldDefinition ? FieldDefinitionToFieldValueAsRequest<Fields[K], Settings['locales']> : 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;
+export type ItemTypeDefinitionToItemDefinitionWithNestedBlocks<T extends ItemTypeDefinition<any, any, any>> = T extends ItemTypeDefinition<infer Settings, infer ItemTypeId, infer Fields> ? keyof Fields extends never ? ItemDefinition<ItemTypeId> : ItemDefinition<ItemTypeId, {
+    [K in keyof Fields]: Fields[K] extends FieldDefinition ? FieldDefinitionToFieldValueWithNestedBlocks<Fields[K], Settings['locales']> : never;
 }> : never;
 export type UnknownField = Record<string, unknown>;
 export {};

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

@@ -28,6 +28,70 @@ interface GenericClient {
 /**
  * Repository for DatoCMS schema entities including item types, fields, and plugins.
  * Provides caching and efficient lookup functionality for schema-related operations.
+ *
+ * ## Purpose
+ *
+ * SchemaRepository is designed to solve the performance problem of repeatedly fetching
+ * the same schema information during complex operations that traverse nested blocks,
+ * structured text, or modular content. It acts as an in-memory cache/memoization layer
+ * for schema entities to avoid redundant API calls.
+ *
+ * ## What it's for:
+ *
+ * - **Caching schema entities**: Automatically caches item types, fields, fieldsets,
+ *   and plugins after the first API request, returning cached results on subsequent calls
+ * - **Complex traversal operations**: Essential when using utilities like
+ *   `mapBlocksInFieldValues()` that need to repeatedly lookup block models and fields
+ *   while traversing nested content structures
+ * - **Bulk operations**: Ideal for scripts that process multiple records of different
+ *   types and need efficient access to schema information
+ * - **Read-heavy workflows**: Perfect for scenarios where you need to repeatedly access
+ *   the same schema information without making redundant API calls
+ *
+ * ## What it's NOT for:
+ *
+ * - **Schema modification**: Do NOT use SchemaRepository if your script modifies models,
+ *   fields, fieldsets, or plugins, as the cache will become stale
+ * - **Record/content operations**: This is only for schema entities, not for records,
+ *   uploads, or other content
+ * - **Long-running applications**: The cache has no expiration or invalidation mechanism,
+ *   so it's not suitable for applications that need fresh schema data over time
+ * - **Concurrent schema changes**: No protection against cache inconsistency if other
+ *   processes modify the schema while your script runs
+ *
+ * ## Usage Pattern
+ *
+ * ```typescript
+ * const schemaRepository = new SchemaRepository(client);
+ *
+ * // These calls will hit the API and cache the results
+ * const models = await schemaRepository.getAllModels();
+ * const blogPost = await schemaRepository.getItemTypeByApiKey('blog_post');
+ *
+ * // These subsequent calls will return cached results (no API calls)
+ * const sameModels = await schemaRepository.getAllModels();
+ * const sameBlogPost = await schemaRepository.getItemTypeByApiKey('blog_post');
+ *
+ * // Pass the repository to utilities that need schema information
+ * await mapBlocksInFieldValues(schemaRepository, record, (block) => {
+ *   // The utility will use the cached schema data internally
+ * });
+ * ```
+ *
+ * ## Performance Benefits
+ *
+ * Without SchemaRepository, a script processing structured text with nested blocks
+ * might make the same `client.itemTypes.list()` or `client.fields.list()` calls
+ * dozens of times. SchemaRepository ensures each unique schema request is made only once.
+ *
+ * ## Best Practices
+ *
+ * - Use SchemaRepository consistently throughout your script — if you need it for one
+ *   utility call, use it for all schema operations to maximize cache efficiency
+ * - Create one instance per script execution, not per operation
+ * - Only use when you have read-only access to schema entities
+ * - Consider using optimistic locking for any record updates to handle potential
+ *   version conflicts when working with cached schema information
  */
 export declare class SchemaRepository {
     private client;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datocms/cma-client",
-  "version": "5.1.4",
+  "version": "5.1.6",
   "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.4",
+    "@datocms/rest-client-utils": "^5.1.6",
     "datocms-structured-text-utils": "^5.1.1",
     "uuid": "^9.0.1"
   },
   "devDependencies": {
-    "@datocms/dashboard-client": "^5.1.4",
+    "@datocms/dashboard-client": "^5.1.6",
     "@types/uuid": "^9.0.7"
   },
-  "gitHead": "b9b3aee7d6c78acdfef811fa42a84bc42abc36f7"
+  "gitHead": "92b4b39626abe853ab1ce24ddd7c64d1af1b43f8"
 }

package/src/fieldTypes/gallery.ts

@@ -16,12 +16,11 @@ export type GalleryFieldValue = Array<{
     x: number;
     y: number;
   } | null;
-}> | null;
+}>;
 
 export function isGalleryFieldValue(
   value: unknown,
 ): value is GalleryFieldValue {
-  if (value === null) return true;
   return (
     Array.isArray(value) &&
     value.every(

package/src/fieldTypes/links.ts

@@ -4,10 +4,9 @@ import type { LinksSelectEditorConfiguration } from './appearance/links_select';
 import type { ItemsItemTypeValidator } from './validators/items_item_type';
 import type { SizeValidator } from './validators/size';
 
-export type LinksFieldValue = string[] | null;
+export type LinksFieldValue = string[];
 
 export function isLinksFieldValue(value: unknown): value is LinksFieldValue {
-  if (value === null) return true;
   return (
     Array.isArray(value) && value.every((item) => typeof item === 'string')
   );

package/src/fieldTypes/rich_text.ts

@@ -95,8 +95,6 @@ export type RichTextFieldValueWithNestedBlocks<
 export function isRichTextFieldValue(
   value: unknown,
 ): value is RichTextFieldValue {
-  if (value === null) return true;
-
   return (
     Array.isArray(value) && value.every((block) => typeof block === 'string')
   );
@@ -151,8 +149,6 @@ export function isLocalizedRichTextFieldValueAsRequest<
 export function isRichTextFieldValueWithNestedBlocks<
   D extends ItemDefinition = ItemDefinition,
 >(value: unknown): value is RichTextFieldValueWithNestedBlocks<D> {
-  if (value === null) return true;
-
   if (!Array.isArray(value)) return false;
 
   return value.every((block) => {