@datocms/cma-client 5.1.10 → 5.1.11

package/README.md

@@ -10,6 +10,581 @@ API client for [DatoCMS](https://www.datocms.com). Take a look at the full [API
 </a>
 <br /><br />
 
+## Utility Functions
+
+This library provides a comprehensive set of utility functions to work with DatoCMS records, blocks, and field values. These utilities make it easier to manipulate, traverse, and inspect your content programmatically.
+
+### 1. Record Inspection Utilities
+
+The `inspectItem()` function provides a visual, tree-structured representation of DatoCMS records in the console, making it easier to debug and understand complex content structures.
+
+<details>
+<summary><strong>inspectItem()</strong> - Display records with visual appeal</summary>
+
+Formats a DatoCMS item (record or block) as a visual tree structure, showing all fields with proper formatting for each field type. Particularly useful for debugging nested structures like modular content and structured text.
+
+**TypeScript Signature:**
+```typescript
+function inspectItem(
+  item: Item,
+  options?: InspectItemOptions
+): string
+
+type InspectItemOptions = {
+  maxWidth?: number; // Maximum width for text fields before truncation (default: 80)
+}
+```
+
+**Parameters:**
+- `item`: Any DatoCMS item, including records, blocks, or items in create/update format
+- `options`: Optional configuration object
+  - `maxWidth`: Maximum characters to display for text fields before truncating with "..."
+
+**Returns:** A formatted string representation of the item as a tree structure
+
+**Usage Example:**
+```typescript
+import { inspectItem } from '@datocms/cma-client';
+
+const record = await client.items.find('MgCNaAI0RxSG8CA9sDXCHg');
+console.log(inspectItem(record));
+
+// Output:
+// Item "MgCNaAI0RxSG8CA9sDXCHg" (item_type: "bJse85JFR0GbA37ey6kA1w")
+// ├─ title: "My Blog Post"
+// ├─ slug: "my-blog-post"
+// └─ content:
+//    ├─ en: "This is the English content..."
+//    └─ it: "Questo è il contenuto italiano..."
+```
+</details>
+
+### 2. Block Processing Utilities
+
+These utilities provide a unified interface for working with blocks embedded within DatoCMS field values. DatoCMS supports three field types that can contain blocks: Modular Content (arrays of blocks), Single Block fields, and Structured Text (with embedded blocks). These functions abstract away the differences between field types, providing consistent APIs for common operations.
+
+#### Recursive Block Operations
+
+These functions traverse blocks recursively, processing nested blocks within blocks. They require a `SchemaRepository` instance to look up field definitions for nested blocks.
+
+<details>
+<summary><strong>visitBlocksInNonLocalizedFieldValue()</strong> - Recursively visit all blocks</summary>
+
+Visit every block in a non-localized field value recursively, including blocks nested within other blocks.
+
+**TypeScript Signature:**
+```typescript
+async function visitBlocksInNonLocalizedFieldValue(
+  schemaRepository: SchemaRepository,
+  fieldType: string,
+  nonLocalizedFieldValue: unknown,
+  visitor: (item: BlockItemInARequest, path: TreePath) => void | Promise<void>,
+  path?: TreePath
+): Promise<void>
+```
+
+**Parameters:**
+- `schemaRepository`: Repository for caching schema lookups
+- `fieldType`: The typeo of DatoCMS field (ie. `string`, `rich_text`, etc.)
+- `nonLocalizedFieldValue`: The non-localized field value
+- `visitor`: Function called for each block (including nested)
+- `path`: Optional base path for tracking location
+```
+</details>
+
+<details>
+<summary><strong>mapBlocksInNonLocalizedFieldValue()</strong> - Recursively transform all blocks</summary>
+
+Transform all blocks in a non-localized field value recursively, including nested blocks.
+
+**TypeScript Signature:**
+```typescript
+async function mapBlocksInNonLocalizedFieldValue(
+  schemaRepository: SchemaRepository,
+  fieldType: string,
+  nonLocalizedFieldValue: unknown,
+  mapper: (item: BlockItemInARequest, path: TreePath) => BlockItemInARequest | Promise<BlockItemInARequest>,
+  path?: TreePath
+): Promise<unknown>
+```
+
+**Parameters:**
+- `schemaRepository`: Repository for caching schema lookups
+- `fieldType`: The typeo of DatoCMS field (ie. `string`, `rich_text`, etc.)
+- `nonLocalizedFieldValue`: The non-localized field value
+- `mapper`: Function that transforms each block
+- `path`: Optional base path
+
+**Returns:** New field value
+</details>
+
+<details>
+<summary><strong>filterBlocksInNonLocalizedFieldValue()</strong> - Recursively filter blocks</summary>
+
+Filter blocks recursively, removing blocks at any nesting level that don't match the predicate.
+
+**TypeScript Signature:**
+```typescript
+async function filterBlocksInNonLocalizedFieldValue(
+  schemaRepository: SchemaRepository,
+  fieldType: string,
+  nonLocalizedFieldValue: unknown,
+  predicate: (item: BlockItemInARequest, path: TreePath) => boolean | Promise<boolean>,
+  path?: TreePath
+): Promise<unknown>
+```
+
+**Parameters:**
+- `schemaRepository`: Repository for caching schema lookups
+- `fieldType`: The typeo of DatoCMS field (ie. `string`, `rich_text`, etc.)
+- `nonLocalizedFieldValue`: The non-localized field value to filter
+- `predicate`: Function that tests each block
+- `path`: Optional base path
+
+**Returns:** New field value with filtered blocks
+
+**Usage Example:**
+```typescript
+// Remove all video blocks at any nesting level
+const noVideos = await filterBlocksInNonLocalizedFieldValue(
+  schemaRepository,
+  field,
+  fieldValue,
+  (block) => block.relationships.item_type.data.id !== 'video_block'
+);
+```
+</details>
+
+<details>
+<summary><strong>findAllBlocksInNonLocalizedFieldValue()</strong> - Recursively search for blocks</summary>
+
+Find all blocks that match the predicate, searching recursively through nested blocks.
+
+**TypeScript Signature:**
+```typescript
+async function findAllBlocksInNonLocalizedFieldValue(
+  schemaRepository: SchemaRepository,
+  fieldType: string,
+  nonLocalizedFieldValue: unknown,
+  predicate: (item: BlockItemInARequest, path: TreePath) => boolean | Promise<boolean>,
+  path?: TreePath
+): Promise<Array<{ item: BlockItemInARequest; path: TreePath }>>
+```
+
+**Parameters:**
+- `schemaRepository`: Repository for caching schema lookups
+- `fieldType`: The typeo of DatoCMS field (ie. `string`, `rich_text`, etc.)
+- `nonLocalizedFieldValue`: The non-localized field value to search
+- `predicate`: Function that tests each block
+- `path`: Optional base path
+
+**Returns:** Array of all matching blocks with their paths
+</details>
+
+<details>
+<summary><strong>reduceBlocksInNonLocalizedFieldValue()</strong> - Recursively reduce blocks</summary>
+
+Reduce all blocks recursively to a single value.
+
+**TypeScript Signature:**
+```typescript
+async function reduceBlocksInNonLocalizedFieldValue<R>(
+  schemaRepository: SchemaRepository,
+  fieldType: string,
+  nonLocalizedFieldValue: unknown,
+  reducer: (accumulator: R, item: BlockItemInARequest, path: TreePath) => R | Promise<R>,
+  initialValue: R,
+  path?: TreePath
+): Promise<R>
+```
+
+**Parameters:**
+- `schemaRepository`: Repository for caching schema lookups
+- `fieldType`: The typeo of DatoCMS field (ie. `string`, `rich_text`, etc.)
+- `nonLocalizedFieldValue`: The non-localized field value to reduce
+- `reducer`: Function that processes each block
+- `initialValue`: Initial accumulator value
+- `path`: Optional base path
+
+**Returns:** The final accumulated value
+```
+</details>
+
+<details>
+<summary><strong>someBlocksInNonLocalizedFieldValue()</strong> - Recursively test for any match</summary>
+
+Check if any block (including nested) matches the predicate.
+
+**TypeScript Signature:**
+```typescript
+async function someBlocksInNonLocalizedFieldValue(
+  schemaRepository: SchemaRepository,
+  fieldType: string,
+  nonLocalizedFieldValue: unknown,
+  predicate: (item: BlockItemInARequest, path: TreePath) => boolean | Promise<boolean>,
+  path?: TreePath
+): Promise<boolean>
+```
+
+**Parameters:**
+- `schemaRepository`: Repository for caching schema lookups
+- `fieldType`: The typeo of DatoCMS field (ie. `string`, `rich_text`, etc.)
+- `nonLocalizedFieldValue`: The non-localized field value to test
+- `predicate`: Function that tests each block
+- `path`: Optional base path
+
+**Returns:** True if any block matches
+```
+</details>
+
+<details>
+<summary><strong>everyBlockInNonLocalizedFieldValue()</strong> - Recursively test if all match</summary>
+
+Check if every block (including nested) matches the predicate.
+
+**TypeScript Signature:**
+```typescript
+async function everyBlockInNonLocalizedFieldValue(
+  schemaRepository: SchemaRepository,
+  fieldType: string,
+  nonLocalizedFieldValue: unknown,
+  predicate: (item: BlockItemInARequest, path: TreePath) => boolean | Promise<boolean>,
+  path?: TreePath
+): Promise<boolean>
+```
+
+**Parameters:**
+- `schemaRepository`: Repository for caching schema lookups
+- `fieldType`: The typeo of DatoCMS field (ie. `string`, `rich_text`, etc.)
+- `nonLocalizedFieldValue`: The non-localized field value to test
+- `predicate`: Function that tests each block
+- `path`: Optional base path
+
+**Returns:** True if all blocks match
+</details>
+
+#### Block Record Management
+
+<details>
+<summary><strong>buildBlockRecord()</strong> - Create block records from data</summary>
+
+Converts a block data object into the proper format for API requests.
+
+**TypeScript Signature:**
+```typescript
+function buildBlockRecord<D extends ItemTypeDefinition>(
+  body: ItemUpdateSchema<ToItemDefinitionAsRequest<D>>
+): NewBlockInARequest<ToItemDefinitionAsRequest<D>>
+```
+
+**Parameters:**
+- `body`: Block data in update schema format
+
+**Returns:** Formatted block record ready for API requests
+</details>
+
+<details>
+<summary><strong>duplicateBlockRecord()</strong> - Deep clone blocks with nested content</summary>
+
+Creates a deep copy of a block record, including all nested blocks, removing IDs to create new instances.
+
+**TypeScript Signature:**
+```typescript
+async function duplicateBlockRecord<D extends ItemTypeDefinition>(
+  existingBlock: ItemWithOptionalIdAndMeta<ToItemDefinitionWithNestedBlocks<D>>,
+  schemaRepository: SchemaRepository
+): Promise<NewBlockInARequest<ToItemDefinitionAsRequest<D>>>
+```
+
+**Parameters:**
+- `existingBlock`: The block to duplicate
+- `schemaRepository`: Repository for schema lookups
+
+**Returns:** New block record without IDs, ready to be created
+</details>
+
+### 3. Localization-Aware Field Utilities
+
+These utilities provide a unified interface for working with DatoCMS field values that may or may not be localized. They eliminate the need for conditional logic when processing fields that could be either localized or non-localized.
+
+<details>
+<summary><strong>isLocalized()</strong> - Check if a field is localized</summary>
+
+Determines whether a DatoCMS field is configured for localization.
+
+**TypeScript Signature:**
+```typescript
+function isLocalized(field: Field): boolean
+```
+
+**Parameters:**
+- `fieldType`: The typeo of DatoCMS field (ie. `string`, `rich_text`, etc.)
+
+**Returns:** True if the field is localized, false otherwise
+</details>
+
+<details>
+<summary><strong>mapNormalizedFieldValues() / mapNormalizedFieldValuesAsync()</strong> - Transform field values</summary>
+
+Apply a transformation function to field values, handling both localized and non-localized fields uniformly.
+
+**TypeScript Signatures:**
+```typescript
+function mapNormalizedFieldValues<TInput, TOutput>(
+  field: Field,
+  value: TInput | LocalizedFieldValue<TInput>,
+  mapFn: (locale: string | undefined, localeValue: TInput) => TOutput
+): TOutput | LocalizedFieldValue<TOutput>
+
+async function mapNormalizedFieldValuesAsync<TInput, TOutput>(
+  field: Field,
+  value: TInput | LocalizedFieldValue<TInput>,
+  mapFn: (locale: string | undefined, localeValue: TInput) => Promise<TOutput>
+): Promise<TOutput | LocalizedFieldValue<TOutput>>
+```
+
+**Parameters:**
+- `fieldType`: The typeo of DatoCMS field (ie. `string`, `rich_text`, etc.)
+- `nonLocalizedFieldValue`: The non-localized field value (localized or non-localized)
+- `mapFn`: Function to transform each value (receives locale for localized fields, undefined for non-localized)
+
+**Returns:** Transformed value maintaining the same structure
+</details>
+
+<details>
+<summary><strong>filterNormalizedFieldValues() / filterNormalizedFieldValuesAsync()</strong> - Filter field values</summary>
+
+Filter field values based on a predicate, handling both localized and non-localized fields.
+
+**TypeScript Signatures:**
+```typescript
+function filterNormalizedFieldValues<T>(
+  field: Field,
+  value: T | LocalizedFieldValue<T>,
+  filterFn: (locale: string | undefined, localeValue: T) => boolean
+): T | LocalizedFieldValue<T> | undefined
+
+async function filterNormalizedFieldValuesAsync<T>(
+  field: Field,
+  value: T | LocalizedFieldValue<T>,
+  filterFn: (locale: string | undefined, localeValue: T) => Promise<boolean>
+): Promise<T | LocalizedFieldValue<T> | undefined>
+```
+
+**Parameters:**
+- `fieldType`: The typeo of DatoCMS field (ie. `string`, `rich_text`, etc.)
+- `nonLocalizedFieldValue`: The non-localized field value to filter
+- `filterFn`: Predicate function for filtering
+
+**Returns:** Filtered value or undefined if all filtered out
+</details>
+
+<details>
+<summary><strong>visitNormalizedFieldValues() / visitNormalizedFieldValuesAsync()</strong> - Iterate over field values</summary>
+
+Visit each value in a field, handling both localized and non-localized fields.
+
+**TypeScript Signatures:**
+```typescript
+function visitNormalizedFieldValues<T>(
+  field: Field,
+  value: T | LocalizedFieldValue<T>,
+  visitFn: (locale: string | undefined, localeValue: T) => void
+): void
+
+async function visitNormalizedFieldValuesAsync<T>(
+  field: Field,
+  value: T | LocalizedFieldValue<T>,
+  visitFn: (locale: string | undefined, localeValue: T) => Promise<void>
+): Promise<void>
+```
+
+**Parameters:**
+- `fieldType`: The typeo of DatoCMS field (ie. `string`, `rich_text`, etc.)
+- `nonLocalizedFieldValue`: The non-localized field value to visit
+- `visitFn`: Function called for each value
+</details>
+
+<details>
+<summary><strong>someNormalizedFieldValues() / someNormalizedFieldValuesAsync()</strong> - Test if any value matches</summary>
+
+Check if at least one field value passes the test.
+
+**TypeScript Signatures:**
+```typescript
+function someNormalizedFieldValues<T>(
+  field: Field,
+  value: T | LocalizedFieldValue<T>,
+  testFn: (locale: string | undefined, localeValue: T) => boolean
+): boolean
+
+async function someNormalizedFieldValuesAsync<T>(
+  field: Field,
+  value: T | LocalizedFieldValue<T>,
+  testFn: (locale: string | undefined, localeValue: T) => Promise<boolean>
+): Promise<boolean>
+```
+
+**Parameters:**
+- `fieldType`: The typeo of DatoCMS field (ie. `string`, `rich_text`, etc.)
+- `nonLocalizedFieldValue`: The non-localized field value to test
+- `testFn`: Predicate function
+
+**Returns:** True if any value passes the test
+</details>
+
+<details>
+<summary><strong>everyNormalizedFieldValue() / everyNormalizedFieldValueAsync()</strong> - Test if all values match</summary>
+
+Check if all field values pass the test.
+
+**TypeScript Signatures:**
+```typescript
+function everyNormalizedFieldValue<T>(
+  field: Field,
+  value: T | LocalizedFieldValue<T>,
+  testFn: (locale: string | undefined, localeValue: T) => boolean
+): boolean
+
+async function everyNormalizedFieldValueAsync<T>(
+  field: Field,
+  value: T | LocalizedFieldValue<T>,
+  testFn: (locale: string | undefined, localeValue: T) => Promise<boolean>
+): Promise<boolean>
+```
+
+**Parameters:**
+- `fieldType`: The typeo of DatoCMS field (ie. `string`, `rich_text`, etc.)
+- `nonLocalizedFieldValue`: The non-localized field value to test
+- `testFn`: Predicate function
+
+**Returns:** True if all values pass the test
+</details>
+
+<details>
+<summary><strong>toNormalizedFieldValueEntries() / fromNormalizedFieldValueEntries()</strong> - Convert between formats</summary>
+
+Convert field values to/from a normalized entry format for uniform processing.
+
+**TypeScript Signatures:**
+```typescript
+function toNormalizedFieldValueEntries<T>(
+  field: Field,
+  value: T | LocalizedFieldValue<T>
+): NormalizedFieldValueEntry<T>[]
+
+function fromNormalizedFieldValueEntries<T>(
+  field: Field,
+  entries: NormalizedFieldValueEntry<T>[]
+): T | LocalizedFieldValue<T>
+
+type NormalizedFieldValueEntry<T> = {
+  locale: string | undefined;
+  value: T;
+}
+```
+
+**Parameters:**
+- `fieldType`: The typeo of DatoCMS field (ie. `string`, `rich_text`, etc.)
+- `nonLocalizedFieldValue`/`entries non-localized`: Value to convert from/to
+
+**Returns:** Normalized entries array or reconstructed field value
+
+**Usage Example:**
+```typescript
+// Convert to entries for processing
+const entries = toNormalizedFieldValueEntries(field, fieldValue);
+
+// Process entries uniformly
+const processed = entries.map(({ locale, value }) => ({
+  locale,
+  value: processValue(value)
+}));
+
+// Convert back to field value format
+const result = fromNormalizedFieldValueEntries(field, processed);
+```
+</details>
+
+### 4. Schema Repository
+
+The `SchemaRepository` class provides an in-memory caching system for DatoCMS schema entities, significantly improving performance when working with complex content structures.
+
+<details>
+<summary><strong>SchemaRepository</strong> - Cache schema entities for performance</summary>
+
+Repository for DatoCMS schema entities including item types, fields, fieldsets, and plugins. Provides caching and efficient lookup functionality for schema-related operations.
+
+**Key Features:**
+- Automatic caching of schema entities after first fetch
+- Efficient lookups by ID, API key, or package name
+- Essential for recursive block operations
+- Dramatically reduces API calls during complex traversals
+
+**TypeScript Class:**
+```typescript
+class SchemaRepository {
+  constructor(client: GenericClient)
+
+  // Item Type methods
+  async getAllItemTypes(): Promise<ItemType[]>
+  async getAllModels(): Promise<ItemType[]>
+  async getAllBlockModels(): Promise<ItemType[]>
+  async getItemTypeByApiKey(apiKey: string): Promise<ItemType>
+  async getItemTypeById(id: string): Promise<ItemType>
+
+  // Field methods
+  async getItemTypeFields(itemType: ItemType): Promise<Field[]>
+  async getItemTypeFieldsets(itemType: ItemType): Promise<Fieldset[]>
+
+  // Plugin methods
+  async getAllPlugins(): Promise<Plugin[]>
+  async getPluginById(id: string): Promise<Plugin>
+  async getPluginByPackageName(packageName: string): Promise<Plugin>
+
+  // Raw variants (return API response format)
+  async getAllRawItemTypes(): Promise<RawItemType[]>
+  async getRawItemTypeByApiKey(apiKey: string): Promise<RawItemType>
+  // ... and more raw variants
+}
+```
+
+**When to Use:**
+- Complex traversal operations that repeatedly lookup schema
+- Bulk operations processing multiple records
+- Scripts that need efficient access to schema information
+- Working with recursive block utilities
+
+**When NOT to Use:**
+- Scripts that modify schema (models, fields, etc.)
+- Long-running applications (no cache expiration)
+- When schema might change during execution
+
+**Usage Example:**
+```typescript
+const schemaRepository = new SchemaRepository(client);
+
+// First call fetches from API and caches
+const blogPost = await schemaRepository.getItemTypeByApiKey('blog_post');
+const fields = await schemaRepository.getItemTypeFields(blogPost);
+
+// Subsequent calls use cached data (no API calls)
+const sameBlogPost = await schemaRepository.getItemTypeByApiKey('blog_post');
+const sameFields = await schemaRepository.getItemTypeFields(blogPost);
+
+// Use with recursive utilities for optimal performance
+await mapBlocksInNonLocalizedFieldValue(
+  schemaRepository,  // Pass repository for efficient lookups
+  field,
+  fieldValue,
+  async (block) => { /* transform */ }
+);
+```
+
+**Performance Impact:**
+Without SchemaRepository, a script processing structured text with nested blocks might make the same API calls dozens of times. SchemaRepository ensures each unique schema request is made only once, dramatically improving performance for complex operations.
+</details>
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/datocms/js-rest-api-clients. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.

package/dist/cjs/fieldTypes/boolean.js

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isLocalizedBooleanFieldValue = exports.isBooleanFieldValue = void 0;
+const normalizedFieldValues_1 = require("../utilities/normalizedFieldValues");
 function isBooleanFieldValue(value) {
     return typeof value === 'boolean' || value === null;
 }
 exports.isBooleanFieldValue = isBooleanFieldValue;
 function isLocalizedBooleanFieldValue(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
+    return ((0, normalizedFieldValues_1.isLocalizedFieldValue)(value) &&
         Object.values(value).every(isBooleanFieldValue));
 }
 exports.isLocalizedBooleanFieldValue = isLocalizedBooleanFieldValue;

package/dist/cjs/fieldTypes/boolean.js.map

@@ -1 +1 @@
-{"version":3,"file":"boolean.js","sourceRoot":"","sources":["../../../src/fieldTypes/boolean.ts"],"names":[],"mappings":";;;AAMA,SAAgB,mBAAmB,CACjC,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC;AAJD,kDAIC;AAED,SAAgB,4BAA4B,CAC1C,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAChD,CAAC;AACJ,CAAC;AARD,oEAQC"}
+{"version":3,"file":"boolean.js","sourceRoot":"","sources":["../../../src/fieldTypes/boolean.ts"],"names":[],"mappings":";;;AAAA,8EAG4C;AAM5C,SAAgB,mBAAmB,CACjC,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC;AAJD,kDAIC;AAED,SAAgB,4BAA4B,CAC1C,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAChD,CAAC;AACJ,CAAC;AAPD,oEAOC"}

package/dist/cjs/fieldTypes/color.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isLocalizedColorFieldValue = exports.isColorFieldValue = void 0;
+const normalizedFieldValues_1 = require("../utilities/normalizedFieldValues");
 function isColorFieldValue(value) {
     if (value === null)
         return true;
@@ -13,8 +14,7 @@ function isColorFieldValue(value) {
 }
 exports.isColorFieldValue = isColorFieldValue;
 function isLocalizedColorFieldValue(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
+    return ((0, normalizedFieldValues_1.isLocalizedFieldValue)(value) &&
         Object.values(value).every(isColorFieldValue));
 }
 exports.isLocalizedColorFieldValue = isLocalizedColorFieldValue;

package/dist/cjs/fieldTypes/color.js.map

@@ -1 +1 @@
-{"version":3,"file":"color.js","sourceRoot":"","sources":["../../../src/fieldTypes/color.ts"],"names":[],"mappings":";;;AAWA,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,IAAI,KAAK;QACd,OAAO,IAAI,KAAK;QAChB,MAAM,IAAI,KAAK;QACf,OAAO,IAAI,KAAK,CACjB,CAAC;AACJ,CAAC;AAVD,8CAUC;AAED,SAAgB,0BAA0B,CACxC,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAC9C,CAAC;AACJ,CAAC;AARD,gEAQC"}
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../../src/fieldTypes/color.ts"],"names":[],"mappings":";;;AAAA,8EAG4C;AAW5C,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,IAAI,KAAK;QACd,OAAO,IAAI,KAAK;QAChB,MAAM,IAAI,KAAK;QACf,OAAO,IAAI,KAAK,CACjB,CAAC;AACJ,CAAC;AAVD,8CAUC;AAED,SAAgB,0BAA0B,CACxC,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAC9C,CAAC;AACJ,CAAC;AAPD,gEAOC"}

package/dist/cjs/fieldTypes/date.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isLocalizedDateFieldValue = exports.isDateFieldValue = void 0;
+const normalizedFieldValues_1 = require("../utilities/normalizedFieldValues");
 function isDateFieldValue(value) {
     if (value === null)
         return true;
@@ -8,9 +9,7 @@ function isDateFieldValue(value) {
 }
 exports.isDateFieldValue = isDateFieldValue;
 function isLocalizedDateFieldValue(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        Object.values(value).every(isDateFieldValue));
+    return ((0, normalizedFieldValues_1.isLocalizedFieldValue)(value) && Object.values(value).every(isDateFieldValue));
 }
 exports.isLocalizedDateFieldValue = isLocalizedDateFieldValue;
 //# sourceMappingURL=date.js.map

package/dist/cjs/fieldTypes/date.js.map

@@ -1 +1 @@
-{"version":3,"file":"date.js","sourceRoot":"","sources":["../../../src/fieldTypes/date.ts"],"names":[],"mappings":";;;AAOA,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC;AAHD,4CAGC;AAED,SAAgB,yBAAyB,CACvC,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAC7C,CAAC;AACJ,CAAC;AARD,8DAQC"}
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../../src/fieldTypes/date.ts"],"names":[],"mappings":";;;AAAA,8EAG4C;AAO5C,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC;AAHD,4CAGC;AAED,SAAgB,yBAAyB,CACvC,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAC7E,CAAC;AACJ,CAAC;AAND,8DAMC"}

package/dist/cjs/fieldTypes/date_time.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isLocalizedDateTimeFieldValue = exports.isDateTimeFieldValue = void 0;
+const normalizedFieldValues_1 = require("../utilities/normalizedFieldValues");
 function isDateTimeFieldValue(value) {
     if (value === null)
         return true;
@@ -9,8 +10,7 @@ function isDateTimeFieldValue(value) {
 }
 exports.isDateTimeFieldValue = isDateTimeFieldValue;
 function isLocalizedDateTimeFieldValue(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
+    return ((0, normalizedFieldValues_1.isLocalizedFieldValue)(value) &&
         Object.values(value).every(isDateTimeFieldValue));
 }
 exports.isLocalizedDateTimeFieldValue = isLocalizedDateTimeFieldValue;

package/dist/cjs/fieldTypes/date_time.js.map

@@ -1 +1 @@
-{"version":3,"file":"date_time.js","sourceRoot":"","sources":["../../../src/fieldTypes/date_time.ts"],"names":[],"mappings":";;;AAOA,SAAgB,oBAAoB,CAClC,KAAc;IAEd,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,sCAAsC,CAAC,IAAI,CAAC,KAAK,CAAC,CACnD,CAAC;AACJ,CAAC;AARD,oDAQC;AAED,SAAgB,6BAA6B,CAC3C,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CACjD,CAAC;AACJ,CAAC;AARD,sEAQC"}
+{"version":3,"file":"date_time.js","sourceRoot":"","sources":["../../../src/fieldTypes/date_time.ts"],"names":[],"mappings":";;;AAAA,8EAG4C;AAO5C,SAAgB,oBAAoB,CAClC,KAAc;IAEd,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,sCAAsC,CAAC,IAAI,CAAC,KAAK,CAAC,CACnD,CAAC;AACJ,CAAC;AARD,oDAQC;AAED,SAAgB,6BAA6B,CAC3C,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CACjD,CAAC;AACJ,CAAC;AAPD,sEAOC"}