@datocms/cma-client 5.1.11 → 5.1.13

package/dist/esm/utilities/nonRecursiveBlocks.js

@@ -49,42 +49,7 @@ var __asyncValues = (this && this.__asyncValues) || function (o) {
     function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
     function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
 };
-import { collectNodes, collectNodesAsync, filterNodes, filterNodesAsync, mapNodes, mapNodesAsync, } from 'datocms-structured-text-utils';
-import { isLocalizedFieldValue } from './normalizedFieldValues';
-function* iterateBlocks(fieldType, nonLocalizedFieldValue) {
-    if (isLocalizedFieldValue(nonLocalizedFieldValue)) {
-        throw new Error('A non-localized field value is required!');
-    }
-    if (fieldType === 'rich_text') {
-        const richTextValue = nonLocalizedFieldValue;
-        if (richTextValue) {
-            for (let index = 0; index < richTextValue.length; index++) {
-                const item = richTextValue[index];
-                yield { item, path: [index] };
-            }
-        }
-        return;
-    }
-    if (fieldType === 'single_block') {
-        const singleBlockValue = nonLocalizedFieldValue;
-        if (singleBlockValue) {
-            yield { item: singleBlockValue, path: [] };
-        }
-        return;
-    }
-    if (fieldType === 'structured_text') {
-        const structuredTextValue = nonLocalizedFieldValue;
-        if (structuredTextValue) {
-            const foundNodes = collectNodes(structuredTextValue.document, (node) => node.type === 'block' || node.type === 'inlineBlock');
-            for (const { node, path } of foundNodes) {
-                if (node.type === 'block' || node.type === 'inlineBlock') {
-                    yield { item: node.item, path };
-                }
-            }
-        }
-        return;
-    }
-}
+import { collectNodesAsync, filterNodesAsync, mapNodes, mapNodesAsync, } from 'datocms-structured-text-utils';
 function iterateBlocksAsync(fieldType, nonLocalizedFieldValue) {
     return __asyncGenerator(this, arguments, function* iterateBlocksAsync_1() {
         if (fieldType === 'rich_text') {
@@ -118,19 +83,6 @@ function iterateBlocksAsync(fieldType, nonLocalizedFieldValue) {
         }
     });
 }
-/**
- * Visit every block in a field value, calling the visitor function for each block found.
- * Supports rich text, single block, and structured text field types.
- *
- * @param fieldType - The type of DatoCMS field definition that determines how the value is processed
- * @param nonLocalizedFieldValue - The non-localized field value containing blocks to visit
- * @param visitor - Synchronous function called for each block. Receives the block item and its path
- */
-export function nonRecursiveVisitBlocksInNonLocalizedFieldValue(fieldType, nonLocalizedFieldValue, visitor) {
-    for (const { item, path } of iterateBlocks(fieldType, nonLocalizedFieldValue)) {
-        visitor(item, path);
-    }
-}
 /**
  * Visit every block in a field value, calling the visitor function for each block found.
  * Supports rich text, single block, and structured text field types.
@@ -243,24 +195,6 @@ export function nonRecursiveMapBlocksInNonLocalizedFieldValueAsync(fieldType, no
         return nonLocalizedFieldValue;
     });
 }
-/**
- * Find all blocks that match the predicate function.
- * Searches through all blocks in the non-localized field value and returns all matches.
- *
- * @param fieldType - The type of DatoCMS field definition that determines how the value is processed
- * @param nonLocalizedFieldValue - The non-localized field value containing blocks to search
- * @param predicate - Synchronous function that tests each block. Should return true for matching blocks
- * @returns Array of objects, each containing a matching block and its path
- */
-export function nonRecursiveFindAllBlocksInNonLocalizedFieldValue(fieldType, nonLocalizedFieldValue, predicate) {
-    const results = [];
-    for (const { item, path } of iterateBlocks(fieldType, nonLocalizedFieldValue)) {
-        if (predicate(item, path)) {
-            results.push({ item, path });
-        }
-    }
-    return results;
-}
 /**
  * Find all blocks that match the predicate function.
  * Searches through all blocks in the non-localized field value and returns all matches.
@@ -299,54 +233,6 @@ export function nonRecursiveFindAllBlocksInNonLocalizedFieldValueAsync(fieldType
         return results;
     });
 }
-/**
- * Filter blocks in a field value, removing those that don't match the predicate.
- * Creates a new field value containing only blocks that pass the predicate test.
- * Preserves the original field value structure and hierarchy.
- *
- * @param fieldType - The type of DatoCMS field definition that determines how the value is processed
- * @param nonLocalizedFieldValue - The non-localized field value containing blocks to filter
- * @param predicate - Synchronous function that tests each block. Blocks returning false are removed
- * @returns The new field value with filtered blocks
- */
-export function nonRecursiveFilterBlocksInNonLocalizedFieldValue(fieldType, nonLocalizedFieldValue, predicate) {
-    if (fieldType === 'rich_text') {
-        const filteredItems = [];
-        for (const { item, path } of iterateBlocks(fieldType, nonLocalizedFieldValue)) {
-            if (predicate(item, path)) {
-                filteredItems.push(item);
-            }
-        }
-        return filteredItems;
-    }
-    if (fieldType === 'single_block') {
-        for (const { item, path } of iterateBlocks(fieldType, nonLocalizedFieldValue)) {
-            if (predicate(item, path)) {
-                return item;
-            }
-        }
-        return null;
-    }
-    if (fieldType === 'structured_text') {
-        const structuredTextValue = nonLocalizedFieldValue;
-        if (!structuredTextValue) {
-            return null;
-        }
-        const filteredDocument = filterNodes(structuredTextValue.document, (node, _parent, path) => {
-            if (node.type === 'block' || node.type === 'inlineBlock') {
-                return predicate(node.item, path);
-            }
-            return true;
-        });
-        return filteredDocument
-            ? {
-                schema: 'dast',
-                document: filteredDocument,
-            }
-            : null;
-    }
-    return nonLocalizedFieldValue;
-}
 /**
  * Filter blocks in a field value, removing those that don't match the predicate.
  * Creates a new field value containing only blocks that pass the predicate test.
@@ -432,24 +318,6 @@ export function nonRecursiveFilterBlocksInNonLocalizedFieldValueAsync(fieldType,
         return nonLocalizedFieldValue;
     });
 }
-/**
- * Reduce all blocks in a field value to a single value by applying a reducer function.
- * Processes each block in the non-localized field value and accumulates the results into a single value.
- *
- * @template R - The type of the accumulated result
- * @param fieldType - The type of DatoCMS field definition that determines how the value is processed
- * @param nonLocalizedFieldValue - The non-localized field value containing blocks to reduce
- * @param reducer - Synchronous function that processes each block and updates the accumulator
- * @param initialValue - The initial value for the accumulator
- * @returns The final accumulated value
- */
-export function nonRecursiveReduceBlocksInNonLocalizedFieldValue(fieldType, nonLocalizedFieldValue, reducer, initialValue) {
-    let accumulator = initialValue;
-    for (const { item, path } of iterateBlocks(fieldType, nonLocalizedFieldValue)) {
-        accumulator = reducer(accumulator, item, path);
-    }
-    return accumulator;
-}
 /**
  * Reduce all blocks in a field value to a single value by applying a reducer function.
  * Processes each block in the non-localized field value and accumulates the results into a single value.
@@ -488,23 +356,6 @@ export function nonRecursiveReduceBlocksInNonLocalizedFieldValueAsync(fieldType,
         return accumulator;
     });
 }
-/**
- * Check if any block in the non-localized field value matches the predicate function.
- * Returns true as soon as the first matching block is found (short-circuit evaluation).
- *
- * @param fieldType - The type of DatoCMS field definition that determines how the value is processed
- * @param nonLocalizedFieldValue - The non-localized field value containing blocks to test
- * @param predicate - Synchronous function that tests each block. Should return true for matching blocks
- * @returns True if any block matches, false otherwise
- */
-export function nonRecursiveSomeBlocksInNonLocalizedFieldValue(fieldType, nonLocalizedFieldValue, predicate) {
-    for (const { item, path } of iterateBlocks(fieldType, nonLocalizedFieldValue)) {
-        if (predicate(item, path)) {
-            return true;
-        }
-    }
-    return false;
-}
 /**
  * Check if any block in the non-localized field value matches the predicate function.
  * Returns true as soon as the first matching block is found (short-circuit evaluation).
@@ -542,20 +393,6 @@ export function nonRecursiveSomeBlocksInNonLocalizedFieldValueAsync(fieldType, n
         return false;
     });
 }
-/**
- * Check if every block in the non-localized field value matches the predicate function.
- * Returns false as soon as the first non-matching block is found (short-circuit evaluation).
- *
- * @param fieldType - The type of DatoCMS field definition that determines how the value is processed
- * @param nonLocalizedFieldValue - The non-localized field value containing blocks to test
- * @param predicate - Synchronous function that tests each block. Should return true for valid blocks
- * @returns True if all blocks match, false otherwise
- */
-export function nonRecursiveEveryBlockInNonLocalizedFieldValue(fieldType, nonLocalizedFieldValue, predicate) {
-    return !nonRecursiveSomeBlocksInNonLocalizedFieldValue(fieldType, nonLocalizedFieldValue, (item, path) => {
-        return !predicate(item, path);
-    });
-}
 /**
  * Check if every block in the non-localized field value matches the predicate function.
  * Returns false as soon as the first non-matching block is found (short-circuit evaluation).

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

@@ -1 +1 @@
-{"version":3,"file":"nonRecursiveBlocks.js","sourceRoot":"","sources":["../../../src/utilities/nonRecursiveBlocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,OAAO,EAEL,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,aAAa,GACd,MAAM,+BAA+B,CAAC;AAcvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAehE,QAAQ,CAAC,CAAC,aAAa,CACrB,SAAuC,EACvC,sBAA+B;IAE/B,IAAI,qBAAqB,CAAC,sBAAsB,CAAC,EAAE;QACjD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;KAC7D;IAED,IAAI,SAAS,KAAK,WAAW,EAAE;QAC7B,MAAM,aAAa,GAAG,sBAA+C,CAAC;QACtE,IAAI,aAAa,EAAE;YACjB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;gBACzD,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAE,CAAC;gBACnC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;aAC/B;SACF;QACD,OAAO;KACR;IAED,IAAI,SAAS,KAAK,cAAc,EAAE;QAChC,MAAM,gBAAgB,GAAG,sBAAkD,CAAC;QAC5E,IAAI,gBAAgB,EAAE;YACpB,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;SAC5C;QACD,OAAO;KACR;IAED,IAAI,SAAS,KAAK,iBAAiB,EAAE;QACnC,MAAM,mBAAmB,GACvB,sBAAqD,CAAC;QACxD,IAAI,mBAAmB,EAAE;YACvB,MAAM,UAAU,GAAG,YAAY,CAC7B,mBAAmB,CAAC,QAAQ,EAC5B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,CAC/D,CAAC;YAEF,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE;gBACvC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE;oBACxD,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;iBACjC;aACF;SACF;QACD,OAAO;KACR;AACH,CAAC;AAED,SAAgB,kBAAkB,CAChC,SAAuC,EACvC,sBAA+B;;QAE/B,IAAI,SAAS,KAAK,WAAW,EAAE;YAC7B,MAAM,aAAa,GAAG,sBAA+C,CAAC;YACtE,IAAI,aAAa,EAAE;gBACjB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;oBACzD,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAE,CAAC;oBACnC,oBAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAA,CAAC;iBAC/B;aACF;YACD,6BAAO;SACR;QAED,IAAI,SAAS,KAAK,cAAc,EAAE;YAChC,MAAM,gBAAgB,GAAG,sBAAkD,CAAC;YAC5E,IAAI,gBAAgB,EAAE;gBACpB,oBAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA,CAAC;aAC5C;YACD,6BAAO;SACR;QAED,IAAI,SAAS,KAAK,iBAAiB,EAAE;YACnC,MAAM,mBAAmB,GACvB,sBAAqD,CAAC;YACxD,IAAI,mBAAmB,EAAE;gBACvB,MAAM,UAAU,GAAG,cAAM,iBAAiB,CACxC,mBAAmB,CAAC,QAAQ,EAC5B,CAAO,IAAI,EAAE,EAAE,gDAAC,OAAA,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,CAAA,GAAA,CACrE,CAAA,CAAC;gBAEF,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE;oBACvC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE;wBACxD,oBAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAA,CAAC;qBACjC;iBACF;aACF;YACD,6BAAO;SACR;IACH,CAAC;CAAA;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,+CAA+C,CAC7D,SAAuC,EACvC,sBAA+B,EAC/B,OAA4D;IAE5D,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,aAAa,CACxC,SAAS,EACT,sBAAsB,CACvB,EAAE;QACD,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;KACrB;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAgB,oDAAoD,CACxE,SAAuC,EACvC,sBAA+B,EAC/B,OAAqE;;;;YAErE,KAAmC,eAAA,KAAA,cAAA,kBAAkB,CACnD,SAAS,EACT,sBAAsB,CACvB,CAAA,IAAA;gBAHkC,cAGlC;gBAHkC,WAGlC;;oBAHU,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAA,CAAA;oBAI7B,MAAM,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;;;;;aAC3B;;;;;;;;;;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,6CAA6C,CAC3D,SAAuC,EACvC,sBAA+B,EAC/B,MAA0E;IAE1E,IAAI,SAAS,KAAK,WAAW,EAAE;QAC7B,MAAM,aAAa,GAAG,sBAA+C,CAAC;QACtE,OAAO,aAAa;YAClB,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3D,CAAC,CAAC,aAAa,CAAC;KACnB;IAED,IAAI,SAAS,KAAK,cAAc,EAAE;QAChC,MAAM,gBAAgB,GAAG,sBAAkD,CAAC;QAC5E,OAAO,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;KAC/D;IAED,IAAI,SAAS,KAAK,iBAAiB,EAAE;QACnC,MAAM,mBAAmB,GACvB,sBAAqD,CAAC;QAExD,IAAI,CAAC,mBAAmB,EAAE;YACxB,OAAO,IAAI,CAAC;SACb;QAED,OAAO;YACL,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,QAAQ,CAChB,mBAAmB,CAAC,QAAQ,EAC5B,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;gBACtB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE;oBACxD,uCAAY,IAAI,KAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAG;iBACnD;gBAED,OAAO,IAAI,CAAC;YACd,CAAC,CACF;SACF,CAAC;KACH;IAED,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAgB,kDAAkD,CACtE,SAAuC,EACvC,sBAA+B,EAC/B,MAGiC;;QAEjC,IAAI,SAAS,KAAK,WAAW,EAAE;YAC7B,MAAM,aAAa,GAAG,sBAA+C,CAAC;YACtE,OAAO,aAAa;gBAClB,CAAC,CAAC,MAAM,OAAO,CAAC,GAAG,CACf,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAC1D;gBACH,CAAC,CAAC,aAAa,CAAC;SACnB;QAED,IAAI,SAAS,KAAK,cAAc,EAAE;YAChC,MAAM,gBAAgB,GAAG,sBAAkD,CAAC;YAC5E,OAAO,gBAAgB,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;SACrE;QAED,IAAI,SAAS,KAAK,iBAAiB,EAAE;YACnC,MAAM,mBAAmB,GACvB,sBAAqD,CAAC;YAExD,IAAI,CAAC,mBAAmB,EAAE;gBACxB,OAAO,IAAI,CAAC;aACb;YAED,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,MAAM,aAAa,CAC3B,mBAAmB,CAAC,QAAQ,EAC5B,CAAO,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;oBAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE;wBACxD,uCAAY,IAAI,KAAE,IAAI,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAG;qBACzD;oBAED,OAAO,IAAI,CAAC;gBACd,CAAC,CAAA,CACF;aACF,CAAC;SACH;QAED,OAAO,sBAAsB,CAAC;IAChC,CAAC;CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iDAAiD,CAC/D,SAAuC,EACvC,sBAA+B,EAC/B,SAAiE;IAEjE,MAAM,OAAO,GAAyD,EAAE,CAAC;IAEzE,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,aAAa,CACxC,SAAS,EACT,sBAAsB,CACvB,EAAE;QACD,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;YACzB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;SAC9B;KACF;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAgB,sDAAsD,CAC1E,SAAuC,EACvC,sBAA+B,EAC/B,SAA0E;;;QAE1E,MAAM,OAAO,GAAyD,EAAE,CAAC;;YAEzE,KAAmC,eAAA,KAAA,cAAA,kBAAkB,CACnD,SAAS,EACT,sBAAsB,CACvB,CAAA,IAAA;gBAHkC,cAGlC;gBAHkC,WAGlC;;oBAHU,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAA,CAAA;oBAI7B,IAAI,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;wBAC/B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC9B;;;;;aACF;;;;;;;;;QAED,OAAO,OAAO,CAAC;;CAChB;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gDAAgD,CAC9D,SAAuC,EACvC,sBAA+B,EAC/B,SAAiE;IAEjE,IAAI,SAAS,KAAK,WAAW,EAAE;QAC7B,MAAM,aAAa,GAA0B,EAAE,CAAC;QAEhD,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,aAAa,CACxC,SAAS,EACT,sBAAsB,CACvB,EAAE;YACD,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;gBACzB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aAC1B;SACF;QAED,OAAO,aAAa,CAAC;KACtB;IAED,IAAI,SAAS,KAAK,cAAc,EAAE;QAChC,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,aAAa,CACxC,SAAS,EACT,sBAAsB,CACvB,EAAE;YACD,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;gBACzB,OAAO,IAAI,CAAC;aACb;SACF;QACD,OAAO,IAAI,CAAC;KACb;IAED,IAAI,SAAS,KAAK,iBAAiB,EAAE;QACnC,MAAM,mBAAmB,GACvB,sBAAqD,CAAC;QAExD,IAAI,CAAC,mBAAmB,EAAE;YACxB,OAAO,IAAI,CAAC;SACb;QAED,MAAM,gBAAgB,GAAG,WAAW,CAClC,mBAAmB,CAAC,QAAQ,EAC5B,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;YACtB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE;gBACxD,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;aACnC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CACF,CAAC;QAEF,OAAO,gBAAgB;YACrB,CAAC,CAAC;gBACE,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,gBAAgB;aAC3B;YACH,CAAC,CAAC,IAAI,CAAC;KACV;IAED,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAgB,qDAAqD,CACzE,SAAuC,EACvC,sBAA+B,EAC/B,SAA0E;;;QAE1E,IAAI,SAAS,KAAK,WAAW,EAAE;YAC7B,MAAM,aAAa,GAA0B,EAAE,CAAC;;gBAEhD,KAAmC,eAAA,KAAA,cAAA,kBAAkB,CACnD,SAAS,EACT,sBAAsB,CACvB,CAAA,IAAA;oBAHkC,cAGlC;oBAHkC,WAGlC;;wBAHU,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAA,CAAA;wBAI7B,IAAI,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;4BAC/B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;yBAC1B;;;;;iBACF;;;;;;;;;YAED,OAAO,aAAa,CAAC;SACtB;QAED,IAAI,SAAS,KAAK,cAAc,EAAE;;gBAChC,KAAmC,eAAA,KAAA,cAAA,kBAAkB,CACnD,SAAS,EACT,sBAAsB,CACvB,CAAA,IAAA;oBAHkC,cAGlC;oBAHkC,WAGlC;;wBAHU,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAA,CAAA;wBAI7B,IAAI,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;4BAC/B,OAAO,IAAI,CAAC;yBACb;;;;;iBACF;;;;;;;;;YACD,OAAO,IAAI,CAAC;SACb;QAED,IAAI,SAAS,KAAK,iBAAiB,EAAE;YACnC,MAAM,mBAAmB,GACvB,sBAAqD,CAAC;YAExD,IAAI,CAAC,mBAAmB,EAAE;gBACxB,OAAO,IAAI,CAAC;aACb;YAED,MAAM,gBAAgB,GAAG,MAAM,gBAAgB,CAC7C,mBAAmB,CAAC,QAAQ,EAC5B,CAAO,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;gBAC5B,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE;oBACxD,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;iBACzC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC,CAAA,CACF,CAAC;YAEF,OAAO,gBAAgB;gBACrB,CAAC,CAAC;oBACE,MAAM,EAAE,MAAM;oBACd,QAAQ,EAAE,gBAAgB;iBAC3B;gBACH,CAAC,CAAC,IAAI,CAAC;SACV;QAED,OAAO,sBAAsB,CAAC;;CAC/B;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gDAAgD,CAC9D,SAAuC,EACvC,sBAA+B,EAC/B,OAAyE,EACzE,YAAe;IAEf,IAAI,WAAW,GAAG,YAAY,CAAC;IAE/B,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,aAAa,CACxC,SAAS,EACT,sBAAsB,CACvB,EAAE;QACD,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;KAChD;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAgB,qDAAqD,CACzE,SAAuC,EACvC,sBAA+B,EAC/B,OAIe,EACf,YAAe;;;QAEf,IAAI,WAAW,GAAG,YAAY,CAAC;;YAE/B,KAAmC,eAAA,KAAA,cAAA,kBAAkB,CACnD,SAAS,EACT,sBAAsB,CACvB,CAAA,IAAA;gBAHkC,cAGlC;gBAHkC,WAGlC;;oBAHU,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAA,CAAA;oBAI7B,WAAW,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;;;;;aACtD;;;;;;;;;QAED,OAAO,WAAW,CAAC;;CACpB;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,8CAA8C,CAC5D,SAAuC,EACvC,sBAA+B,EAC/B,SAAiE;IAEjE,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,aAAa,CACxC,SAAS,EACT,sBAAsB,CACvB,EAAE;QACD,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;YACzB,OAAO,IAAI,CAAC;SACb;KACF;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAgB,mDAAmD,CACvE,SAAuC,EACvC,sBAA+B,EAC/B,SAA0E;;;;YAE1E,KAAmC,eAAA,KAAA,cAAA,kBAAkB,CACnD,SAAS,EACT,sBAAsB,CACvB,CAAA,IAAA;gBAHkC,cAGlC;gBAHkC,WAGlC;;oBAHU,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAA,CAAA;oBAI7B,IAAI,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;wBAC/B,OAAO,IAAI,CAAC;qBACb;;;;;aACF;;;;;;;;;QAED,OAAO,KAAK,CAAC;;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,8CAA8C,CAC5D,SAAuC,EACvC,sBAA+B,EAC/B,SAAiE;IAEjE,OAAO,CAAC,8CAA8C,CACpD,SAAS,EACT,sBAAsB,EACtB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QACb,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAgB,mDAAmD,CACvE,SAAuC,EACvC,sBAA+B,EAC/B,SAA0E;;QAE1E,OAAO,CAAC,CAAC,MAAM,mDAAmD,CAChE,SAAS,EACT,sBAAsB,EACtB,CAAO,IAAI,EAAE,IAAI,EAAE,EAAE;YACnB,OAAO,CAAC,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACxC,CAAC,CAAA,CACF,CAAC,CAAC;IACL,CAAC;CAAA"}
+{"version":3,"file":"nonRecursiveBlocks.js","sourceRoot":"","sources":["../../../src/utilities/nonRecursiveBlocks.ts"],"names":[],"mappings":"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"}

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

@@ -1,36 +1,47 @@
-import { type BlockItemInARequest } from '../fieldTypes';
+import { type BlockInRequest, type RichTextFieldValue, type RichTextFieldValueInNestedResponse, type RichTextFieldValueInRequest, type SingleBlockFieldValue, type SingleBlockFieldValueInNestedResponse, type SingleBlockFieldValueInRequest, type StructuredTextFieldValue, type StructuredTextFieldValueInNestedResponse, type StructuredTextFieldValueInRequest } from '../fieldTypes';
 import type * as ApiTypes from '../generated/ApiTypes';
+import type { ExtractNestedBlocksFromFieldValue } from './itemDefinition';
 import type { SchemaRepository } from './schemaRepository';
+type RecognizableFieldValue = RichTextFieldValueInNestedResponse | SingleBlockFieldValueInNestedResponse | StructuredTextFieldValueInNestedResponse | RichTextFieldValueInRequest | SingleBlockFieldValueInRequest | StructuredTextFieldValueInRequest | RichTextFieldValue | SingleBlockFieldValue | StructuredTextFieldValue;
 /**
  * Path through a non-localized field value (ie. ['content', 0, 'attributes', 'title'])
  */
 export type TreePath = readonly (string | number)[];
+/**
+ * Traversal direction for recursive operations
+ */
+export type TraversalDirection = 'top-down' | 'bottom-up';
 /**
  * Recursively visit every block in a non-localized field value and all nested blocks within those blocks.
  * This function traverses not only the direct blocks in the non-localized field value but also recursively
  * visits blocks contained within the attributes of each block, creating a complete traversal
  * of the entire block hierarchy.
  *
- * @param schemaRepository - Repository for accessing DatoCMS schema information to resolve block structures
- * @param fieldType - The type of DatoCMS field definition that determines how the value is processed
  * @param nonLocalizedFieldValue - The non-localized field value containing blocks to visit
+ * @param fieldType - The type field (determines how the value is processed)
+ * @param schemaRepository - Repository for accessing DatoCMS schema information (to resolve block structures)
  * @param visitor - Asynchronous function called for each block found, including nested blocks
  * @returns Promise that resolves when all blocks and nested blocks have been visited
  */
-export declare function visitBlocksInNonLocalizedFieldValue(schemaRepository: SchemaRepository, fieldType: ApiTypes.Field['field_type'], nonLocalizedFieldValue: unknown, visitor: (item: BlockItemInARequest, path: TreePath) => void | Promise<void>, path?: TreePath): Promise<void>;
+export declare function visitBlocksInNonLocalizedFieldValue<T extends RecognizableFieldValue>(nonLocalizedFieldValue: T, fieldType: ApiTypes.Field['field_type'], schemaRepository: SchemaRepository, visitor: (item: ExtractNestedBlocksFromFieldValue<T>, path: TreePath) => void | Promise<void>, path?: TreePath): Promise<void>;
+export declare function visitBlocksInNonLocalizedFieldValue(nonLocalizedFieldValue: unknown, fieldType: ApiTypes.Field['field_type'], schemaRepository: SchemaRepository, visitor: (item: BlockInRequest, path: TreePath) => void | Promise<void>, path?: TreePath): Promise<void>;
 /**
  * Recursively find all blocks that match the predicate function in a non-localized field value.
  * Searches through all direct blocks and recursively through nested blocks within
  * the attributes of each block, returning all matches found throughout the hierarchy.
  *
- * @param schemaRepository - Repository for accessing DatoCMS schema information to resolve block structures
- * @param fieldType - The type of DatoCMS field definition that determines how the value is processed
  * @param nonLocalizedFieldValue - The non-localized field value containing blocks to search
+ * @param fieldType - The type field (determines how the value is processed)
+ * @param schemaRepository - Repository for accessing DatoCMS schema information (to resolve block structures)
  * @param predicate - Asynchronous function that tests each block, including nested ones
  * @returns Promise that resolves to an array of objects, each containing a matching block and its full path
  */
-export declare function findAllBlocksInNonLocalizedFieldValue(schemaRepository: SchemaRepository, fieldType: ApiTypes.Field['field_type'], nonLocalizedFieldValue: unknown, predicate: (item: BlockItemInARequest, path: TreePath) => boolean | Promise<boolean>, path?: TreePath): Promise<Array<{
-    item: BlockItemInARequest;
+export declare function findAllBlocksInNonLocalizedFieldValue<T extends RecognizableFieldValue>(nonLocalizedFieldValue: T, fieldType: ApiTypes.Field['field_type'], schemaRepository: SchemaRepository, predicate: (item: ExtractNestedBlocksFromFieldValue<T>, path: TreePath) => boolean | Promise<boolean>, path?: TreePath): Promise<Array<{
+    item: ExtractNestedBlocksFromFieldValue<T>;
+    path: TreePath;
+}>>;
+export declare function findAllBlocksInNonLocalizedFieldValue(nonLocalizedFieldValue: unknown, fieldType: ApiTypes.Field['field_type'], schemaRepository: SchemaRepository, predicate: (item: BlockInRequest, path: TreePath) => boolean | Promise<boolean>, path?: TreePath): Promise<Array<{
+    item: BlockInRequest;
     path: TreePath;
 }>>;
 /**
@@ -39,63 +50,82 @@ export declare function findAllBlocksInNonLocalizedFieldValue(schemaRepository:
  * including recursive filtering of nested blocks within block attributes. The filtering
  * preserves the original non-localized field value structure and hierarchy.
  *
- * @param schemaRepository - Repository for accessing DatoCMS schema information to resolve block structures
- * @param fieldType - The type of DatoCMS field definition that determines how the value is processed
  * @param nonLocalizedFieldValue - The non-localized field value containing blocks to filter
+ * @param fieldType - The type field (determines how the value is processed)
+ * @param schemaRepository - Repository for accessing DatoCMS schema information (to resolve block structures)
  * @param predicate - Asynchronous function that tests each block, including nested ones
+ * @param options - Optional configuration object
+ * @param options.traversalDirection - Direction of traversal: 'top-down' (default) applies predicate before processing children, 'bottom-up' processes children first
  * @returns Promise that resolves to the new non-localized field value with recursively filtered blocks
  */
-export declare function filterBlocksInNonLocalizedFieldValue(schemaRepository: SchemaRepository, fieldType: ApiTypes.Field['field_type'], nonLocalizedFieldValue: unknown, predicate: (item: BlockItemInARequest, path: TreePath) => boolean | Promise<boolean>, path?: TreePath): Promise<unknown>;
+export declare function filterBlocksInNonLocalizedFieldValue<T extends RecognizableFieldValue>(nonLocalizedFieldValue: T, fieldType: ApiTypes.Field['field_type'], schemaRepository: SchemaRepository, predicate: (item: ExtractNestedBlocksFromFieldValue<T>, path: TreePath) => boolean | Promise<boolean>, options?: {
+    traversalDirection?: TraversalDirection;
+}, path?: TreePath): Promise<T>;
+export declare function filterBlocksInNonLocalizedFieldValue(nonLocalizedFieldValue: unknown, fieldType: ApiTypes.Field['field_type'], schemaRepository: SchemaRepository, predicate: (item: BlockInRequest, path: TreePath) => boolean | Promise<boolean>, options?: {
+    traversalDirection?: TraversalDirection;
+}, path?: TreePath): Promise<unknown>;
 /**
  * Recursively reduce all blocks in a non-localized field value to a single value by applying a reducer function.
  * Processes each direct block and recursively processes nested blocks within block attributes,
  * accumulating results from the entire block hierarchy into a single value.
  *
  * @template R - The type of the accumulated result
- * @param schemaRepository - Repository for accessing DatoCMS schema information to resolve block structures
- * @param fieldType - The type of DatoCMS field definition that determines how the value is processed
  * @param nonLocalizedFieldValue - The non-localized field value containing blocks to reduce
+ * @param fieldType - The type field (determines how the value is processed)
+ * @param schemaRepository - Repository for accessing DatoCMS schema information (to resolve block structures)
  * @param reducer - Asynchronous function that processes each block and updates the accumulator
  * @param initialNonLocalizedFieldValue - The initial value for the accumulator
  * @returns Promise that resolves to the final accumulated value from all blocks in the hierarchy
  */
-export declare function reduceBlocksInNonLocalizedFieldValue<R>(schemaRepository: SchemaRepository, fieldType: ApiTypes.Field['field_type'], nonLocalizedFieldValue: unknown, reducer: (accumulator: R, item: BlockItemInARequest, path: TreePath) => R | Promise<R>, initialValue: R, path?: TreePath): Promise<R>;
+export declare function reduceBlocksInNonLocalizedFieldValue<T, R>(nonLocalizedFieldValue: T, fieldType: ApiTypes.Field['field_type'], schemaRepository: SchemaRepository, reducer: (accumulator: R, item: ExtractNestedBlocksFromFieldValue<T>, path: TreePath) => R | Promise<R>, initialValue: R, path?: TreePath): Promise<R>;
+export declare function reduceBlocksInNonLocalizedFieldValue<R>(nonLocalizedFieldValue: unknown, fieldType: ApiTypes.Field['field_type'], schemaRepository: SchemaRepository, reducer: (accumulator: R, item: BlockInRequest, path: TreePath) => R | Promise<R>, initialValue: R, path?: TreePath): Promise<R>;
 /**
  * Recursively check if any block in the non-localized field value matches the predicate function.
  * Tests both direct blocks and recursively tests nested blocks within block attributes.
  * Returns true as soon as the first matching block is found anywhere in the hierarchy
  * (short-circuit evaluation).
  *
- * @param schemaRepository - Repository for accessing DatoCMS schema information to resolve block structures
- * @param fieldType - The type of DatoCMS field definition that determines how the value is processed
  * @param nonLocalizedFieldValue - The non-localized field value containing blocks to test
+ * @param fieldType - The type field (determines how the value is processed)
+ * @param schemaRepository - Repository for accessing DatoCMS schema information (to resolve block structures)
  * @param predicate - Asynchronous function that tests each block, including nested ones
  * @returns Promise that resolves to true if any block in the hierarchy matches, false otherwise
  */
-export declare function someBlocksInNonLocalizedFieldValue(schemaRepository: SchemaRepository, fieldType: ApiTypes.Field['field_type'], nonLocalizedFieldValue: unknown, predicate: (item: BlockItemInARequest, path: TreePath) => boolean | Promise<boolean>, path?: TreePath): Promise<boolean>;
+export declare function someBlocksInNonLocalizedFieldValue<T extends RecognizableFieldValue>(nonLocalizedFieldValue: T, fieldType: ApiTypes.Field['field_type'], schemaRepository: SchemaRepository, predicate: (item: ExtractNestedBlocksFromFieldValue<T>, path: TreePath) => boolean | Promise<boolean>, path?: TreePath): Promise<boolean>;
+export declare function someBlocksInNonLocalizedFieldValue(nonLocalizedFieldValue: unknown, fieldType: ApiTypes.Field['field_type'], schemaRepository: SchemaRepository, predicate: (item: BlockInRequest, path: TreePath) => boolean | Promise<boolean>, path?: TreePath): Promise<boolean>;
 /**
  * Recursively check if every block in the non-localized field value matches the predicate function.
  * Tests both direct blocks and recursively tests nested blocks within block attributes.
  * Returns false as soon as the first non-matching block is found anywhere in the hierarchy
  * (short-circuit evaluation).
  *
- * @param schemaRepository - Repository for accessing DatoCMS schema information to resolve block structures
- * @param fieldType - The type of DatoCMS field definition that determines how the value is processed
  * @param nonLocalizedFieldValue - The non-localized field value containing blocks to test
+ * @param fieldType - The type field (determines how the value is processed)
+ * @param schemaRepository - Repository for accessing DatoCMS schema information (to resolve block structures)
  * @param predicate - Asynchronous function that tests each block, including nested ones
  * @returns Promise that resolves to true if all blocks in the hierarchy match, false otherwise
  */
-export declare function everyBlockInNonLocalizedFieldValue(schemaRepository: SchemaRepository, fieldType: ApiTypes.Field['field_type'], nonLocalizedFieldValue: unknown, predicate: (item: BlockItemInARequest, path: TreePath) => boolean | Promise<boolean>, path?: TreePath): Promise<boolean>;
+export declare function everyBlockInNonLocalizedFieldValue<T extends RecognizableFieldValue>(nonLocalizedFieldValue: T, fieldType: ApiTypes.Field['field_type'], schemaRepository: SchemaRepository, predicate: (item: ExtractNestedBlocksFromFieldValue<T>, path: TreePath) => boolean | Promise<boolean>, path?: TreePath): Promise<boolean>;
+export declare function everyBlockInNonLocalizedFieldValue(nonLocalizedFieldValue: unknown, fieldType: ApiTypes.Field['field_type'], schemaRepository: SchemaRepository, predicate: (item: BlockInRequest, path: TreePath) => boolean | Promise<boolean>, path?: TreePath): Promise<boolean>;
+type FieldValueInRequest<T> = T extends RichTextFieldValueInNestedResponse<infer D> ? RichTextFieldValueInRequest<D> : T extends SingleBlockFieldValueInNestedResponse<infer D> ? SingleBlockFieldValueInRequest<D> : T extends StructuredTextFieldValueInNestedResponse<infer DB, infer DI> ? StructuredTextFieldValueInRequest<DB, DI> : T extends StructuredTextFieldValueInNestedResponse<infer DB> ? StructuredTextFieldValueInRequest<DB> : T;
 /**
  * Recursively transform blocks in a non-localized field value by applying a mapping function to each block.
  * Creates a new non-localized field value structure with transformed blocks while preserving the original
  * structure. Applies the mapping function to both direct blocks and recursively to nested
  * blocks within block attributes throughout the entire hierarchy.
  *
- * @param schemaRepository - Repository for accessing DatoCMS schema information to resolve block structures
- * @param fieldType - The type of DatoCMS field definition that determines how the value is processed
  * @param nonLocalizedFieldValue - The non-localized field value containing blocks to transform
+ * @param fieldType - The type field (determines how the value is processed)
+ * @param schemaRepository - Repository for accessing DatoCMS schema information (to resolve block structures)
  * @param mapper - Asynchronous function that transforms each block, including nested ones
+ * @param options - Optional configuration object
+ * @param options.traversalDirection - Direction of traversal: 'top-down' (default) applies mapper before processing children, 'bottom-up' processes children first
  * @returns Promise that resolves to the new non-localized field value with recursively transformed blocks
  */
-export declare function mapBlocksInNonLocalizedFieldValue(schemaRepository: SchemaRepository, fieldType: ApiTypes.Field['field_type'], nonLocalizedFieldValue: unknown, mapper: (item: BlockItemInARequest, path: TreePath) => BlockItemInARequest | Promise<BlockItemInARequest>, path?: TreePath): Promise<unknown>;
+export declare function mapBlocksInNonLocalizedFieldValue<T extends RecognizableFieldValue>(nonLocalizedFieldValue: T, fieldType: ApiTypes.Field['field_type'], schemaRepository: SchemaRepository, mapper: (item: ExtractNestedBlocksFromFieldValue<T>, path: TreePath) => BlockInRequest | Promise<BlockInRequest>, options?: {
+    traversalDirection?: TraversalDirection;
+}, path?: TreePath): Promise<FieldValueInRequest<T>>;
+export declare function mapBlocksInNonLocalizedFieldValue(nonLocalizedFieldValue: unknown, fieldType: ApiTypes.Field['field_type'], schemaRepository: SchemaRepository, mapper: (item: BlockInRequest, path: TreePath) => BlockInRequest | Promise<BlockInRequest>, options?: {
+    traversalDirection?: TraversalDirection;
+}, path?: TreePath): Promise<unknown>;
+export {};