@datocms/cma-client 5.0.1 → 5.1.0

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

@@ -0,0 +1,123 @@
+import type * as SchemaTypes from '../generated/SchemaTypes';
+import type * as SimpleSchemaTypes from '../generated/SimpleSchemaTypes';
+/**
+ * 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>;
+export declare function isLocalized(field: SchemaTypes.Field | SimpleSchemaTypes.Field): boolean;
+/**
+ * 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): T | {
+    [k: string]: T;
+};
+/**
+ * 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<T | {
+    [k: string]: unknown;
+}>;
+/**
+ * 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): unknown;
+/**
+ * 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<unknown>;
+/**
+ * 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,204 @@
+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());
+    });
+};
+export function isLocalized(field) {
+    return 'attributes' in field ? field.attributes.localized : field.localized;
+}
+/**
+ * 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) {
+    if (isLocalized(field)) {
+        const localizedValue = value;
+        return Object.fromEntries(Object.entries(localizedValue).map(([locale, value]) => [
+            locale,
+            mapFn(locale, value),
+        ]));
+    }
+    return mapFn(undefined, value);
+}
+/**
+ * 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* () {
+        if (isLocalized(field)) {
+            const localizedValue = value;
+            return Object.fromEntries(yield Promise.all(Object.entries(localizedValue).map(([locale, value]) => __awaiter(this, void 0, void 0, function* () { return [locale, yield mapFn(locale, value)]; }))));
+        }
+        return yield mapFn(undefined, value);
+    });
+}
+/**
+ * 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) {
+    if (isLocalized(field)) {
+        const localizedValue = value;
+        return Object.fromEntries(Object.entries(localizedValue).filter(([locale, value]) => filterFn(locale, value)));
+    }
+    return filterFn(undefined, value) ? 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) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (isLocalized(field)) {
+            const localizedValue = value;
+            const results = yield Promise.all(Object.entries(localizedValue).map(([locale, value]) => __awaiter(this, void 0, void 0, function* () {
+                return [
+                    locale,
+                    value,
+                    yield filterFn(locale, value),
+                ];
+            })));
+            return Object.fromEntries(results
+                .filter(([, , passed]) => passed)
+                .map(([locale, value]) => [locale, value]));
+        }
+        return (yield filterFn(undefined, value)) ? 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) {
+    if (isLocalized(field)) {
+        const localizedValue = value;
+        return Object.entries(localizedValue).some(([locale, value]) => testFn(locale, value));
+    }
+    return testFn(undefined, 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* () {
+        if (isLocalized(field)) {
+            const localizedValue = value;
+            const results = yield Promise.all(Object.entries(localizedValue).map(([locale, value]) => __awaiter(this, void 0, void 0, function* () { return yield testFn(locale, value); })));
+            return results.some((result) => result);
+        }
+        return yield testFn(undefined, value);
+    });
+}
+/**
+ * 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) {
+    if (isLocalized(field)) {
+        const localizedValue = value;
+        for (const [locale, value] of Object.entries(localizedValue)) {
+            visitFn(locale, value);
+        }
+    }
+    else {
+        visitFn(undefined, 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* () {
+        if (isLocalized(field)) {
+            const localizedValue = value;
+            yield Promise.all(Object.entries(localizedValue).map(([locale, value]) => __awaiter(this, void 0, void 0, function* () { return yield visitFn(locale, value); })));
+        }
+        else {
+            yield visitFn(undefined, 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>;