@datocms/cma-client 5.0.1 → 5.1.1

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

@@ -0,0 +1,165 @@
+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" }`
+ */
+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.
+ * For non-localized fields, applies the mapping function directly to the only non-localizeed value.
+ *
+ * @template T - The type that the mapping function returns
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @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): any;
+/**
+ * Maps localized field values using a provided mapping function (async version).
+ * For localized fields, applies the mapping function to each locale value.
+ * For non-localized fields, applies the mapping function directly to the only non-localizeed value.
+ *
+ * @template T - The type that the mapping function returns
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @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<any>;
+/**
+ * Filters localized field values using a provided filter function.
+ * For localized fields, filters each locale value.
+ * For non-localized fields, returns the value if the filter passes, otherwise undefined.
+ *
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @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): any;
+/**
+ * Filters localized field values using a provided filter function (async version).
+ * For localized fields, filters each locale value.
+ * For non-localized fields, returns the value if the filter passes, otherwise undefined.
+ *
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @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<any>;
+/**
+ * Tests whether at least one localized field value passes the test implemented by the provided function.
+ * For localized fields, tests each locale value.
+ * For non-localized fields, tests the direct value.
+ *
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @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 someLocalizedFieldValues(field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, testFn: (locale: string | undefined, localeValue: unknown) => boolean): boolean;
+/**
+ * Tests whether at least one localized field value passes the test implemented by the provided function (async version).
+ * For localized fields, tests each locale value.
+ * For non-localized fields, tests the direct value.
+ *
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @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 someLocalizedFieldValuesAsync(field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, testFn: (locale: string | undefined, localeValue: unknown) => Promise<boolean>): Promise<boolean>;
+/**
+ * Tests whether all localized field values pass the test implemented by the provided function.
+ * For localized fields, tests each locale value.
+ * For non-localized fields, tests the direct value.
+ *
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @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 everyLocalizedFieldValues(field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, testFn: (locale: string | undefined, localeValue: unknown) => boolean): boolean;
+/**
+ * Tests whether all localized field values pass the test implemented by the provided function (async version).
+ * For localized fields, tests each locale value.
+ * For non-localized fields, tests the direct value.
+ *
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @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 everyLocalizedFieldValuesAsync(field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, testFn: (locale: string | undefined, localeValue: unknown) => Promise<boolean>): Promise<boolean>;
+/**
+ * Visits each localized field value with the provided function.
+ * For localized fields, visits each locale value.
+ * For non-localized fields, visits the direct value.
+ *
+ * @param field - The DatoCMS field definition
+ * @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 visitLocalizedFieldValues(field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, visitFn: (locale: string | undefined, localeValue: unknown) => void): void;
+/**
+ * Visits each localized field value with the provided function (async version).
+ * For localized fields, visits each locale value.
+ * For non-localized fields, visits the direct value.
+ *
+ * @param field - The DatoCMS field definition
+ * @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 visitLocalizedFieldValuesAsync(field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, visitFn: (locale: string | undefined, localeValue: unknown) => Promise<void>): Promise<void>;

package/dist/esm/utilities/fieldValueLocalization.js

@@ -0,0 +1,237 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * 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 function isLocalized(field) {
+    return 'attributes' in field ? field.attributes.localized : field.localized;
+}
+/**
+ * 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 function fieldValueToPossiblyLocalizedEntries(field, value) {
+    if (isLocalized(field)) {
+        const localizedValue = value;
+        return Object.entries(localizedValue).map(([locale, value]) => ({ locale, value }));
+    }
+    return [{ locale: undefined, value }];
+}
+/**
+ * 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 function possiblyLocalizedEntriesToFieldValue(field, possiblyLocalizedEntries) {
+    var _a;
+    if (isLocalized(field)) {
+        return Object.fromEntries(possiblyLocalizedEntries.map(({ locale, value }) => [locale, value]));
+    }
+    return (_a = possiblyLocalizedEntries[0]) === null || _a === void 0 ? void 0 : _a.value;
+}
+/**
+ * Maps localized field values using a provided mapping function.
+ * For localized fields, applies the mapping function to each locale value.
+ * For non-localized fields, applies the mapping function directly to the only non-localizeed value.
+ *
+ * @template T - The type that the mapping function returns
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @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 function mapLocalizedFieldValues(field, value, mapFn) {
+    const entries = fieldValueToPossiblyLocalizedEntries(field, value);
+    const mappedEntries = entries.map(({ locale, value }) => ({
+        locale,
+        value: mapFn(locale, value),
+    }));
+    return possiblyLocalizedEntriesToFieldValue(field, mappedEntries);
+}
+/**
+ * Maps localized field values using a provided mapping function (async version).
+ * For localized fields, applies the mapping function to each locale value.
+ * For non-localized fields, applies the mapping function directly to the only non-localizeed value.
+ *
+ * @template T - The type that the mapping function returns
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @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 function mapLocalizedFieldValuesAsync(field, value, mapFn) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const entries = fieldValueToPossiblyLocalizedEntries(field, value);
+        const mappedEntries = yield Promise.all(entries.map(({ locale, value }) => __awaiter(this, void 0, void 0, function* () {
+            return ({
+                locale,
+                value: yield mapFn(locale, value),
+            });
+        })));
+        return possiblyLocalizedEntriesToFieldValue(field, mappedEntries);
+    });
+}
+/**
+ * Filters localized field values using a provided filter function.
+ * For localized fields, filters each locale value.
+ * For non-localized fields, returns the value if the filter passes, otherwise undefined.
+ *
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @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 function filterLocalizedFieldValues(field, value, filterFn) {
+    var _a;
+    const entries = fieldValueToPossiblyLocalizedEntries(field, value);
+    const filteredEntries = entries.filter(({ locale, value }) => filterFn(locale, value));
+    if (isLocalized(field)) {
+        return possiblyLocalizedEntriesToFieldValue(field, filteredEntries);
+    }
+    return filteredEntries.length > 0 ? (_a = filteredEntries[0]) === null || _a === void 0 ? void 0 : _a.value : undefined;
+}
+/**
+ * Filters localized field values using a provided filter function (async version).
+ * For localized fields, filters each locale value.
+ * For non-localized fields, returns the value if the filter passes, otherwise undefined.
+ *
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @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 function filterLocalizedFieldValuesAsync(field, value, filterFn) {
+    var _a;
+    return __awaiter(this, void 0, void 0, function* () {
+        const entries = fieldValueToPossiblyLocalizedEntries(field, value);
+        const results = yield Promise.all(entries.map(({ locale, value }) => __awaiter(this, void 0, void 0, function* () {
+            return ({
+                locale,
+                value,
+                passed: yield filterFn(locale, value),
+            });
+        })));
+        const filteredEntries = results
+            .filter(({ passed }) => passed)
+            .map(({ locale, value }) => ({ locale, value }));
+        if (isLocalized(field)) {
+            return possiblyLocalizedEntriesToFieldValue(field, filteredEntries);
+        }
+        return filteredEntries.length > 0 ? (_a = filteredEntries[0]) === null || _a === void 0 ? void 0 : _a.value : undefined;
+    });
+}
+/**
+ * Tests whether at least one localized field value passes the test implemented by the provided function.
+ * For localized fields, tests each locale value.
+ * For non-localized fields, tests the direct value.
+ *
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @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 function someLocalizedFieldValues(field, value, testFn) {
+    const entries = fieldValueToPossiblyLocalizedEntries(field, value);
+    return entries.some(({ locale, value }) => testFn(locale, value));
+}
+/**
+ * Tests whether at least one localized field value passes the test implemented by the provided function (async version).
+ * For localized fields, tests each locale value.
+ * For non-localized fields, tests the direct value.
+ *
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @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 function someLocalizedFieldValuesAsync(field, value, testFn) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const entries = fieldValueToPossiblyLocalizedEntries(field, value);
+        const results = yield Promise.all(entries.map(({ locale, value }) => testFn(locale, value)));
+        return results.some((result) => result);
+    });
+}
+/**
+ * Tests whether all localized field values pass the test implemented by the provided function.
+ * For localized fields, tests each locale value.
+ * For non-localized fields, tests the direct value.
+ *
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @param testFn - The function to test each locale value or the direct value
+ * @returns true if all values pass the test, false otherwise
+ */
+export function everyLocalizedFieldValues(field, value, testFn) {
+    return !someLocalizedFieldValues(field, value, (locale, localeValue) => !testFn(locale, localeValue));
+}
+/**
+ * Tests whether all localized field values pass the test implemented by the provided function (async version).
+ * For localized fields, tests each locale value.
+ * For non-localized fields, tests the direct value.
+ *
+ * @param field - The DatoCMS field definition
+ * @param value - The field value (either localized object or direct value)
+ * @param testFn - The function to test each locale value or the direct value
+ * @returns true if all values pass the test, false otherwise
+ */
+export function everyLocalizedFieldValuesAsync(field, value, testFn) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return !(yield someLocalizedFieldValuesAsync(field, value, (locale, localeValue) => __awaiter(this, void 0, void 0, function* () { return !(yield testFn(locale, localeValue)); })));
+    });
+}
+/**
+ * Visits each localized field value with the provided function.
+ * For localized fields, visits each locale value.
+ * For non-localized fields, visits the direct value.
+ *
+ * @param field - The DatoCMS field definition
+ * @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 function visitLocalizedFieldValues(field, value, visitFn) {
+    const entries = fieldValueToPossiblyLocalizedEntries(field, value);
+    for (const { locale, value } of entries) {
+        visitFn(locale, value);
+    }
+}
+/**
+ * Visits each localized field value with the provided function (async version).
+ * For localized fields, visits each locale value.
+ * For non-localized fields, visits the direct value.
+ *
+ * @param field - The DatoCMS field definition
+ * @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 function visitLocalizedFieldValuesAsync(field, value, visitFn) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const entries = fieldValueToPossiblyLocalizedEntries(field, value);
+        yield Promise.all(entries.map(({ locale, value }) => visitFn(locale, value)));
+    });
+}
+//# sourceMappingURL=fieldValueLocalization.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fieldValueLocalization.js","sourceRoot":"","sources":["../../../src/utilities/fieldValueLocalization.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,4 @@
+import type * as SchemaTypes from '../generated/SchemaTypes';
+import type * as SimpleSchemaTypes from '../generated/SimpleSchemaTypes';
+export declare function modelIdsReferencedInField(field: SchemaTypes.Field | SimpleSchemaTypes.Field): string[];
+export declare function blockModelIdsReferencedInField(field: SchemaTypes.Field | SimpleSchemaTypes.Field): string[];

package/dist/esm/utilities/fieldsContainingReferences.js

@@ -0,0 +1,40 @@
+export function modelIdsReferencedInField(field) {
+    const attributes = 'attributes' in field ? field.attributes : field;
+    switch (attributes.field_type) {
+        case 'link': {
+            return attributes.validators.item_item_type.item_types;
+        }
+        case 'links': {
+            return attributes.validators.items_item_type.item_types;
+        }
+        case 'structured_text': {
+            return attributes.validators.structured_text_links.item_types;
+        }
+        default: {
+            return [];
+        }
+    }
+}
+export function blockModelIdsReferencedInField(field) {
+    const attributes = 'attributes' in field ? field.attributes : field;
+    switch (attributes.field_type) {
+        case 'single_block': {
+            return attributes.validators.single_block_blocks.item_types;
+        }
+        case 'rich_text': {
+            return attributes.validators.rich_text_blocks.item_types;
+        }
+        case 'structured_text': {
+            return [
+                ...attributes.validators.structured_text_blocks.item_types,
+                ...(attributes.validators.structured_text_inline_blocks
+                    ? attributes.validators.structured_text_inline_blocks.item_types
+                    : []),
+            ];
+        }
+        default: {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=fieldsContainingReferences.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fieldsContainingReferences.js","sourceRoot":"","sources":["../../../src/utilities/fieldsContainingReferences.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,yBAAyB,CACvC,KAAkD;IAElD,MAAM,UAAU,GAAG,YAAY,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;IAEpE,QAAQ,UAAU,CAAC,UAAU,EAAE;QAC7B,KAAK,MAAM,CAAC,CAAC;YACX,OAAO,UAAU,CAAC,UAAU,CAAC,cAAc,CAAC,UAAU,CAAC;SACxD;QACD,KAAK,OAAO,CAAC,CAAC;YACZ,OAAO,UAAU,CAAC,UAAU,CAAC,eAAe,CAAC,UAAU,CAAC;SACzD;QACD,KAAK,iBAAiB,CAAC,CAAC;YACtB,OAAO,UAAU,CAAC,UAAU,CAAC,qBAAqB,CAAC,UAAU,CAAC;SAC/D;QACD,OAAO,CAAC,CAAC;YACP,OAAO,EAAE,CAAC;SACX;KACF;AACH,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,KAAkD;IAElD,MAAM,UAAU,GAAG,YAAY,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;IAEpE,QAAQ,UAAU,CAAC,UAAU,EAAE;QAC7B,KAAK,cAAc,CAAC,CAAC;YACnB,OAAO,UAAU,CAAC,UAAU,CAAC,mBAAmB,CAAC,UAAU,CAAC;SAC7D;QACD,KAAK,WAAW,CAAC,CAAC;YAChB,OAAO,UAAU,CAAC,UAAU,CAAC,gBAAgB,CAAC,UAAU,CAAC;SAC1D;QACD,KAAK,iBAAiB,CAAC,CAAC;YACtB,OAAO;gBACL,GAAG,UAAU,CAAC,UAAU,CAAC,sBAAsB,CAAC,UAAU;gBAC1D,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,6BAA6B;oBACrD,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,6BAA6B,CAAC,UAAU;oBAChE,CAAC,CAAC,EAAE,CAAC;aACR,CAAC;SACH;QACD,OAAO,CAAC,CAAC;YACP,OAAO,EAAE,CAAC;SACX;KACF;AACH,CAAC"}

package/dist/esm/{idUtils.js → utilities/id.js}

@@ -1,7 +1,7 @@
 import { v4 } from 'uuid';
 function fromUint8ArrayToUrlSafeBase64(bytes) {
-    var base64 = typeof Buffer === 'undefined'
-        ? btoa(Array.from(bytes, function (byte) { return String.fromCharCode(byte); }).join(''))
+    const base64 = typeof Buffer === 'undefined'
+        ? btoa(Array.from(bytes, (byte) => String.fromCharCode(byte)).join(''))
         : Buffer.from(bytes).toString('base64');
     // Convert to URL-safe format (see RFC 4648, sec. 5)
     return (base64
@@ -14,37 +14,37 @@ function fromUint8ArrayToUrlSafeBase64(bytes) {
 }
 function fromUrlSafeBase64toUint8Array(urlSafeBase64) {
     // Convert from URL-safe format (see RFC 4648, sec. 5)
-    var base64 = urlSafeBase64
+    const base64 = urlSafeBase64
         // Replace - with +
         .replace(/-/g, '+')
         // Replace _ with /
         .replace(/_/g, '/');
     return typeof Buffer === 'undefined'
-        ? Uint8Array.from(atob(base64), function (c) { return c.charCodeAt(0); })
+        ? Uint8Array.from(atob(base64), (c) => c.charCodeAt(0))
         : new Uint8Array(Buffer.from(base64, 'base64'));
 }
 export function isValidId(id) {
     // For backward compatibility, first check to see if this is an older-style integer ID formerly used by Dato
     if (/^\d+$/.test(id)) {
-        var intId = BigInt(id);
-        var maxDatoIntegerId = 281474976710655; // Max 6-byte/48-bit unsigned int
+        const intId = BigInt(id);
+        const maxDatoIntegerId = 281474976710655; // Max 6-byte/48-bit unsigned int
         return intId <= maxDatoIntegerId;
     }
-    var bytes = fromUrlSafeBase64toUint8Array(id);
+    const bytes = fromUrlSafeBase64toUint8Array(id);
     // UUIDs are 16 bytes
     if (bytes.length !== 16) {
         return false;
     }
     // The variant field determines the layout of the UUID
     // (see RFC 4122, sec. 4.1.1)
-    var variant = bytes.at(8);
+    const variant = bytes.at(8);
     // Variant must be the one described in RFC 4122
-    if ((variant & 192) !== 128) {
+    if ((variant & 0b11000000) !== 0b10000000) {
         return false;
     }
     // The version number is in the most significant 4 bits
     // of the time stamp (see RFC 4122, sec. 4.1.3)
-    var version = bytes.at(6) >> 4;
+    const version = bytes.at(6) >> 4;
     // Version number must be 4 (randomly generated)
     if (version !== 0x4) {
         return false;
@@ -52,7 +52,7 @@ export function isValidId(id) {
     return true;
 }
 export function generateId() {
-    var bytes = v4(null, new Uint8Array(16));
+    const bytes = v4(null, new Uint8Array(16));
     // Here we unset the first bit to ensure [A-Za-f] as the first char.
     //
     // If we didn't do this, we would generate IDs that, once encoded
@@ -60,7 +60,7 @@ export function generateId() {
     // easy to copy/paste, with bad DX.
     // This choice is purely aesthetic: definitely non-mandatory!
     bytes[0] = bytes[0] & 0x7f;
-    var base64 = fromUint8ArrayToUrlSafeBase64(bytes);
+    const base64 = fromUint8ArrayToUrlSafeBase64(bytes);
     return base64;
 }
-//# sourceMappingURL=idUtils.js.map
+//# sourceMappingURL=id.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../../src/utilities/id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAE1B,SAAS,6BAA6B,CAAC,KAAiB;IACtD,MAAM,MAAM,GACV,OAAO,MAAM,KAAK,WAAW;QAC3B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAE5C,oDAAoD;IACpD,OAAO,CACL,MAAM;QACJ,mBAAmB;SAClB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;QACpB,mBAAmB;SAClB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;QACpB,oBAAoB;SACnB,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CACpB,CAAC;AACJ,CAAC;AAED,SAAS,6BAA6B,CAAC,aAAqB;IAC1D,sDAAsD;IACtD,MAAM,MAAM,GAAG,aAAa;QAC1B,mBAAmB;SAClB,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;QACnB,mBAAmB;SAClB,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAEtB,OAAO,OAAO,MAAM,KAAK,WAAW;QAClC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,4GAA4G;IAC5G,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QACpB,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,gBAAgB,GAAG,eAAe,CAAC,CAAC,iCAAiC;QAC3E,OAAO,KAAK,IAAI,gBAAgB,CAAC;KAClC;IAED,MAAM,KAAK,GAAG,6BAA6B,CAAC,EAAE,CAAC,CAAC;IAEhD,qBAAqB;IACrB,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE;QACvB,OAAO,KAAK,CAAC;KACd;IAED,sDAAsD;IACtD,6BAA6B;IAE7B,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAE,CAAC;IAE7B,gDAAgD;IAChD,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,KAAK,UAAU,EAAE;QACzC,OAAO,KAAK,CAAC;KACd;IAED,uDAAuD;IACvD,+CAA+C;IAE/C,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC;IAElC,gDAAgD;IAChD,IAAI,OAAO,KAAK,GAAG,EAAE;QACnB,OAAO,KAAK,CAAC;KACd;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IAE3C,oEAAoE;IACpE,EAAE;IACF,iEAAiE;IACjE,mEAAmE;IACnE,mCAAmC;IAEnC,6DAA6D;IAE7D,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC;IAE5B,MAAM,MAAM,GAAG,6BAA6B,CAAC,KAAK,CAAC,CAAC;IAEpD,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,15 @@
+import { type BlockItemInARequest } from '../fieldTypes';
+import type * as SchemaTypes from '../generated/SchemaTypes';
+import type * as SimpleSchemaTypes from '../generated/SimpleSchemaTypes';
+import type { SchemaRepository } from './schemaRepository';
+import type { TreePath } from './structuredText';
+export declare function visitBlocksInFieldValues(schemaRepository: SchemaRepository, field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, visitor: (item: BlockItemInARequest, path: TreePath) => void | Promise<void>, path?: TreePath): Promise<void>;
+export declare function findAllBlocksInFieldValues(schemaRepository: SchemaRepository, field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, predicate: (item: BlockItemInARequest, path: TreePath) => boolean | Promise<boolean>, path?: TreePath): Promise<Array<{
+    item: BlockItemInARequest;
+    path: TreePath;
+}>>;
+export declare function filterBlocksInFieldValues(schemaRepository: SchemaRepository, field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, predicate: (item: BlockItemInARequest, path: TreePath) => boolean | Promise<boolean>, path?: TreePath): Promise<unknown>;
+export declare function reduceBlocksInFieldValues<R>(schemaRepository: SchemaRepository, field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, reducer: (accumulator: R, item: BlockItemInARequest, path: TreePath) => R | Promise<R>, initialValue: R, path?: TreePath): Promise<R>;
+export declare function someBlocksInFieldValues(schemaRepository: SchemaRepository, field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, predicate: (item: BlockItemInARequest, path: TreePath) => boolean | Promise<boolean>, path?: TreePath): Promise<boolean>;
+export declare function everyBlockInFieldValues(schemaRepository: SchemaRepository, field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, predicate: (item: BlockItemInARequest, path: TreePath) => boolean | Promise<boolean>, path?: TreePath): Promise<boolean>;
+export declare function mapBlocksInFieldValues(schemaRepository: SchemaRepository, field: SchemaTypes.Field | SimpleSchemaTypes.Field, value: unknown, mapper: (item: BlockItemInARequest, path: TreePath) => BlockItemInARequest | Promise<BlockItemInARequest>, path?: TreePath): Promise<unknown>;