@datocms/cma-client 5.4.5 → 5.4.7

package/README.md

@@ -309,10 +309,17 @@ TypeScript doesn't auto-narrow on discriminators buried in nested properties, so
 
 **TypeScript Signature:**
 ```typescript
+// Curried — returns a predicate (use with .filter / .find)
 function isBlockOfType<Id extends string>(
   itemTypeId: Id,
 ): <T>(block: T) => block is NarrowBlockByItemType<T, Id>
 
+// Direct — checks a single block inline (use inside `if`)
+function isBlockOfType<T, Id extends string>(
+  itemTypeId: Id,
+  block: T,
+): block is NarrowBlockByItemType<T, Id>
+
 type NarrowBlockByItemType<T, Id extends string> = Extract<
   T,
   { relationships: { item_type: { data: { type: 'item_type'; id: Id } } } }
@@ -321,8 +328,13 @@ type NarrowBlockByItemType<T, Id extends string> = Extract<
 
 **Parameters:**
 - `itemTypeId`: The item-type ID literal. For narrowing to work, the argument must be typed as a literal — use `as const` on pre-set ID constants. No `ItemTypeDefinition` type parameter is needed: `Extract` walks the input union using just the ID.
+- `block` (direct form only): The block to check.
+
+**Returns:**
+- Curried form: a predicate `(block) => block is D-typed-block`.
+- Direct form: a `boolean` that also acts as a type guard on `block`.
 
-**Returns:** A predicate `(block) => block is D-typed-block` that:
+In both cases the guard:
 - Narrows blocks carrying `relationships.item_type.data.id` — that covers `BlockInNestedResponse<D>` and the object variants of `BlockInRequest<D>` (`UpdatedBlockInRequest`, `NewBlockInRequest`).
 - Returns `false` for plain string IDs (unchanged-reference form in request payloads) and for any non-block input.
 
@@ -343,12 +355,18 @@ const images = article.content.filter(
 );
 images[0].attributes.upload_id; // ❌ property does not exist on union
 
-// After: guard narrows the filter result
+// After (curried): guard narrows the filter result
 const images = article.content.filter(isBlockOfType(IMAGE_BLOCK_ID));
 images[0].attributes.upload_id; // ✅ narrowed
+
+// After (direct): inline narrowing on a single block
+const first = article.content[0];
+if (isBlockOfType(IMAGE_BLOCK_ID, first)) {
+  first.attributes.upload_id; // ✅ narrowed
+}
 ```
 
-Use the `__itemTypeId` discriminator for inline `if` / `switch` narrowing on a single value — that's simpler and doesn't need a helper. Reach for `isBlockOfType` when you need a predicate for `.filter` / `.find`.
+Use the curried form when you need a predicate for `.filter` / `.find`; use the direct form for one-off `if` checks. The `__itemTypeId` discriminator is also available for inline `switch` narrowing on a single value.
 </details>
 
 ### Recursive Block Operations

package/dist/cjs/fieldTypes/rich_text.js

@@ -36,8 +36,8 @@ function isRichTextFieldValueInRequest(value) {
         // String ID - referencing existing block
         if ((0, single_block_1.isItemId)(block))
             return true;
-        // Object (either with or without ID for updates/creation)
-        return (0, single_block_1.isItemWithOptionalIdAndMeta)(block);
+        // Object (new, updated, or id-only update — with or without `relationships`)
+        return (0, single_block_1.isBlockObjectInRequest)(block);
     });
 }
 exports.isRichTextFieldValueInRequest = isRichTextFieldValueInRequest;

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

@@ -1 +1 @@
-{"version":3,"file":"rich_text.js","sourceRoot":"","sources":["../../../src/fieldTypes/rich_text.ts"],"names":[],"mappings":";;;AAAA,wCAA4C;AAE5C,8EAG4C;AAE5C,iDAMwB;AA2ExB;;;;GAIG;AAEH;;;GAGG;AACH,SAAgB,oBAAoB,CAClC,KAAc;IAEd,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAA,cAAS,EAAC,KAAK,CAAC,CAAC,CACtE,CAAC;AACJ,CAAC;AAPD,oDAOC;AAED,SAAgB,6BAA6B,CAC3C,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CACjD,CAAC;AACJ,CAAC;AAPD,sEAOC;AAED;;;GAGG;AACH,SAAgB,6BAA6B,CAE3C,KAAc;IACd,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,yCAAyC;QACzC,IAAI,IAAA,uBAAQ,EAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEjC,0DAA0D;QAC1D,OAAO,IAAA,0CAA2B,EAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC;AAdD,sEAcC;AAED,SAAgB,sCAAsC,CAGpD,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAC1D,CAAC;AACJ,CAAC;AATD,wFASC;AAED;;;GAGG;AACH,SAAgB,oCAAoC,CAElD,KAAc;IACd,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,uFAAuF;QACvF,OAAO,IAAA,qCAAsB,EAAC,KAAK,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AATD,oFASC;AAED,SAAgB,6CAA6C,CAG3D,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,oCAAoC,CAAC,CACjE,CAAC;AACJ,CAAC;AATD,sGASC"}
+{"version":3,"file":"rich_text.js","sourceRoot":"","sources":["../../../src/fieldTypes/rich_text.ts"],"names":[],"mappings":";;;AAAA,wCAA4C;AAE5C,8EAG4C;AAE5C,iDAMwB;AA2ExB;;;;GAIG;AAEH;;;GAGG;AACH,SAAgB,oBAAoB,CAClC,KAAc;IAEd,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAA,cAAS,EAAC,KAAK,CAAC,CAAC,CACtE,CAAC;AACJ,CAAC;AAPD,oDAOC;AAED,SAAgB,6BAA6B,CAC3C,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CACjD,CAAC;AACJ,CAAC;AAPD,sEAOC;AAED;;;GAGG;AACH,SAAgB,6BAA6B,CAE3C,KAAc;IACd,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,yCAAyC;QACzC,IAAI,IAAA,uBAAQ,EAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEjC,6EAA6E;QAC7E,OAAO,IAAA,qCAAsB,EAAC,KAAK,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AAdD,sEAcC;AAED,SAAgB,sCAAsC,CAGpD,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAC1D,CAAC;AACJ,CAAC;AATD,wFASC;AAED;;;GAGG;AACH,SAAgB,oCAAoC,CAElD,KAAc;IACd,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,uFAAuF;QACvF,OAAO,IAAA,qCAAsB,EAAC,KAAK,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AATD,oFASC;AAED,SAAgB,6CAA6C,CAG3D,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,oCAAoC,CAAC,CACjE,CAAC;AACJ,CAAC;AATD,sGASC"}

package/dist/cjs/fieldTypes/single_block.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isLocalizedSingleBlockFieldValueInNestedResponse = exports.isSingleBlockFieldValueInNestedResponse = exports.isLocalizedSingleBlockFieldValueInRequest = exports.isSingleBlockFieldValueInRequest = exports.isLocalizedSingleBlockFieldValue = exports.isSingleBlockFieldValue = exports.isItemWithOptionalMeta = exports.isItemWithOptionalIdAndMeta = exports.isItemId = void 0;
+exports.isLocalizedSingleBlockFieldValueInNestedResponse = exports.isSingleBlockFieldValueInNestedResponse = exports.isLocalizedSingleBlockFieldValueInRequest = exports.isSingleBlockFieldValueInRequest = exports.isBlockObjectInRequest = exports.isLocalizedSingleBlockFieldValue = exports.isSingleBlockFieldValue = exports.isItemWithOptionalMeta = exports.isItemWithOptionalIdAndMeta = exports.isItemId = void 0;
 const id_1 = require("../utilities/id");
 const normalizedFieldValues_1 = require("../utilities/normalizedFieldValues");
 /**
@@ -55,6 +55,29 @@ function isLocalizedSingleBlockFieldValue(value) {
         Object.values(value).every(isSingleBlockFieldValue));
 }
 exports.isLocalizedSingleBlockFieldValue = isLocalizedSingleBlockFieldValue;
+/**
+ * Shape check for a block object on the *request* side. Accepts every object
+ * form the CMA allows inside a request payload:
+ *
+ *   1. New block (no id, full body):
+ *        { type: 'item', attributes, relationships: { item_type } }
+ *   2. Updated block, full body:
+ *        { type: 'item', id, attributes, relationships: { item_type } }
+ *   3. Updated block, id-only (patch some attributes of an existing block):
+ *        { type: 'item', id, attributes }                       ← no relationships
+ *
+ * Case 3 is what `buildBlockRecord` produces when the caller omits
+ * `item_type` — the server derives the model from the existing block's id,
+ * so re-specifying it in `relationships` is redundant.
+ */
+function isBlockObjectInRequest(block) {
+    return (typeof block === 'object' &&
+        block !== null &&
+        'type' in block &&
+        block.type === 'item' &&
+        'attributes' in block);
+}
+exports.isBlockObjectInRequest = isBlockObjectInRequest;
 /**
  * Type guard for Single Block field values in API request format.
  * Allows block as string ID, full object with ID, or object without ID.
@@ -65,8 +88,9 @@ function isSingleBlockFieldValueInRequest(value) {
     // String ID - referencing existing block
     if (isItemId(value))
         return true;
-    // Object (either with or without ID for updates/creation)
-    return isItemWithOptionalIdAndMeta(value);
+    // Object (either with or without ID for updates/creation, including
+    // id-only updates without `relationships`)
+    return isBlockObjectInRequest(value);
 }
 exports.isSingleBlockFieldValueInRequest = isSingleBlockFieldValueInRequest;
 function isLocalizedSingleBlockFieldValueInRequest(value) {

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

@@ -1 +1 @@
-{"version":3,"file":"single_block.js","sourceRoot":"","sources":["../../../src/fieldTypes/single_block.ts"],"names":[],"mappings":";;;AACA,wCAA4C;AAK5C,8EAG4C;AAyH5C;;;;;GAKG;AAEH;;GAEG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAFD,4BAEC;AAMD;;GAEG;AACH,SAAgB,2BAA2B,CAEzC,KAAc;IACd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,KAAK,CAAC,IAAI,KAAK,MAAM;QACrB,YAAY,IAAI,KAAK;QACrB,eAAe,IAAI,KAAK,CACzB,CAAC;AACJ,CAAC;AAXD,kEAWC;AAMD;;GAEG;AACH,SAAgB,sBAAsB,CAEpC,KAAc;IACd,OAAO,CACL,2BAA2B,CAAC,KAAK,CAAC;QAClC,IAAI,IAAI,KAAK;QACb,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAC7B,CAAC;AACJ,CAAC;AARD,wDAQC;AAED;;;;GAIG;AAEH;;;GAGG;AACH,SAAgB,uBAAuB,CACrC,KAAc;IAEd,OAAO,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAA,cAAS,EAAC,KAAK,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC;AAC3E,CAAC;AAJD,0DAIC;AAED,SAAgB,gCAAgC,CAC9C,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CACpD,CAAC;AACJ,CAAC;AAPD,4EAOC;AAED;;;GAGG;AACH,SAAgB,gCAAgC,CAE9C,KAAc;IACd,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,yCAAyC;IACzC,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjC,0DAA0D;IAC1D,OAAO,2BAA2B,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAVD,4EAUC;AAED,SAAgB,yCAAyC,CAGvD,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAC7D,CAAC;AACJ,CAAC;AATD,8FASC;AAED;;;GAGG;AACH,SAAgB,uCAAuC,CAErD,KAAc;IACd,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,uFAAuF;IACvF,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAPD,0FAOC;AAED,SAAgB,gDAAgD,CAG9D,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,uCAAuC,CAAC,CACpE,CAAC;AACJ,CAAC;AATD,4GASC"}
+{"version":3,"file":"single_block.js","sourceRoot":"","sources":["../../../src/fieldTypes/single_block.ts"],"names":[],"mappings":";;;AACA,wCAA4C;AAK5C,8EAG4C;AAyH5C;;;;;GAKG;AAEH;;GAEG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAFD,4BAEC;AAMD;;GAEG;AACH,SAAgB,2BAA2B,CAEzC,KAAc;IACd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,KAAK,CAAC,IAAI,KAAK,MAAM;QACrB,YAAY,IAAI,KAAK;QACrB,eAAe,IAAI,KAAK,CACzB,CAAC;AACJ,CAAC;AAXD,kEAWC;AAMD;;GAEG;AACH,SAAgB,sBAAsB,CAEpC,KAAc;IACd,OAAO,CACL,2BAA2B,CAAC,KAAK,CAAC;QAClC,IAAI,IAAI,KAAK;QACb,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAC7B,CAAC;AACJ,CAAC;AARD,wDAQC;AAED;;;;GAIG;AAEH;;;GAGG;AACH,SAAgB,uBAAuB,CACrC,KAAc;IAEd,OAAO,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAA,cAAS,EAAC,KAAK,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC;AAC3E,CAAC;AAJD,0DAIC;AAED,SAAgB,gCAAgC,CAC9C,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CACpD,CAAC;AACJ,CAAC;AAPD,4EAOC;AAED;;;;;;;;;;;;;;GAcG;AACH,SAAgB,sBAAsB,CAAC,KAAc;IAInD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,KAAK,CAAC,IAAI,KAAK,MAAM;QACrB,YAAY,IAAI,KAAK,CACtB,CAAC;AACJ,CAAC;AAXD,wDAWC;AAED;;;GAGG;AACH,SAAgB,gCAAgC,CAE9C,KAAc;IACd,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,yCAAyC;IACzC,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjC,oEAAoE;IACpE,2CAA2C;IAC3C,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAXD,4EAWC;AAED,SAAgB,yCAAyC,CAGvD,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAC7D,CAAC;AACJ,CAAC;AATD,8FASC;AAED;;;GAGG;AACH,SAAgB,uCAAuC,CAErD,KAAc;IACd,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,uFAAuF;IACvF,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAPD,0FAOC;AAED,SAAgB,gDAAgD,CAG9D,KAAc;IAEd,OAAO,CACL,IAAA,6CAAqB,EAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,uCAAuC,CAAC,CACpE,CAAC;AACJ,CAAC;AATD,4GASC"}

package/dist/cjs/fieldTypes/structured_text.js

@@ -56,8 +56,8 @@ function isStructuredTextFieldValueInRequest(value) {
         // String ID
         if ((0, single_block_1.isItemId)(item))
             return true;
-        // Object (either with or without ID)
-        return (0, single_block_1.isItemWithOptionalIdAndMeta)(item);
+        // Object (new, updated, or id-only update — with or without `relationships`)
+        return (0, single_block_1.isBlockObjectInRequest)(item);
     });
 }
 exports.isStructuredTextFieldValueInRequest = isStructuredTextFieldValueInRequest;

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

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

package/dist/cjs/generated/Client.js

@@ -90,7 +90,7 @@ class Client {
         return this.config.baseUrl || Client.defaultBaseUrl;
     }
     request(options) {
-        return (0, rest_client_utils_1.request)(Object.assign(Object.assign(Object.assign({}, this.config), options), { logFn: this.config.logFn || console.log, userAgent: '@datocms/cma-client v5.4.5', baseUrl: this.baseUrl, preCallStack: new Error().stack, extraHeaders: Object.assign(Object.assign(Object.assign({}, (this.config.extraHeaders || {})), (this.config.environment
+        return (0, rest_client_utils_1.request)(Object.assign(Object.assign(Object.assign({}, this.config), options), { logFn: this.config.logFn || console.log, userAgent: '@datocms/cma-client v5.4.7', baseUrl: this.baseUrl, preCallStack: new Error().stack, extraHeaders: Object.assign(Object.assign(Object.assign({}, (this.config.extraHeaders || {})), (this.config.environment
                 ? { 'X-Environment': this.config.environment }
                 : {})), { 'X-API-Version': '3' }), fetchJobResult: (jobId) => {
                 return this.jobResultsFetcher

package/dist/cjs/utilities/isBlockOfType.js

@@ -1,39 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isBlockOfType = void 0;
-/**
- * Builds a type guard that narrows a block to a specific model.
- *
- * Call it with the block's `itemTypeId` literal — the ID generic is inferred
- * from the argument, so no explicit type parameter is needed. The returned
- * predicate is generic: given any input type `T`, it narrows to
- * `Extract<T, { relationships: { item_type: { data: { id: Id } } } }>`. It's
- * meant to plug into `Array#filter` / `Array#find` over block-bearing fields
- * in any of these contexts:
- *
- * - `ItemInNestedResponse<D>` (responses with `nested: true`)
- * - `ItemCreateSchema<D>` / `ItemUpdateSchema<D>` (request payloads, object
- *   variants; plain string IDs are filtered out — there's no way to narrow
- *   them without an external lookup)
- *
- * The default (non-nested) response shape, where block fields are arrays of
- * plain string IDs, is deliberately not supported — the type information is
- * not recoverable from an ID alone.
- *
- * For the literal `Id` to be preserved (and narrowing to work), the argument
- * must be typed as a literal — use `as const` on pre-set ID constants.
- *
- * @example
- * ```ts
- * const SESSION_BLOCK_ID = 'abc123' as const;
- *
- * const record = await client.items.find<Schema.ConferenceDay>(id, { nested: true });
- * const sessions = record.agenda.filter(isBlockOfType(SESSION_BLOCK_ID));
- * sessions[0].attributes.signup_url; // OK — narrowed
- * ```
- */
-function isBlockOfType(itemTypeId) {
-    return (block) => {
+function isBlockOfType(itemTypeId, ...rest) {
+    const check = (block) => {
         if (typeof block !== 'object' || block === null)
             return false;
         const relationships = block.relationships;
@@ -47,6 +16,9 @@ function isBlockOfType(itemTypeId) {
             return false;
         return data.id === itemTypeId;
     };
+    if (rest.length > 0)
+        return check(rest[0]);
+    return (block) => check(block);
 }
 exports.isBlockOfType = isBlockOfType;
 //# sourceMappingURL=isBlockOfType.js.map

package/dist/cjs/utilities/isBlockOfType.js.map

@@ -1 +1 @@
-{"version":3,"file":"isBlockOfType.js","sourceRoot":"","sources":["../../../src/utilities/isBlockOfType.ts"],"names":[],"mappings":";;;AAeA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,SAAgB,aAAa,CAC3B,UAAc;IAEd,OAAO,CAAI,KAAQ,EAAyC,EAAE;QAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,aAAa,GAAI,KAAqC,CAAC,aAAa,CAAC;QAC3E,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,IAAI;YAC7D,OAAO,KAAK,CAAC;QACf,MAAM,QAAQ,GAAI,aAAyC,CAAC,SAAS,CAAC;QACtE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACpE,MAAM,IAAI,GAAI,QAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC5D,OAAQ,IAAyB,CAAC,EAAE,KAAK,UAAU,CAAC;IACtD,CAAC,CAAC;AACJ,CAAC;AAdD,sCAcC"}
+{"version":3,"file":"isBlockOfType.js","sourceRoot":"","sources":["../../../src/utilities/isBlockOfType.ts"],"names":[],"mappings":";;;AAiEA,SAAgB,aAAa,CAC3B,UAAc,EACd,GAAG,IAA2B;IAE9B,MAAM,KAAK,GAAG,CAAC,KAAc,EAAW,EAAE;QACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,aAAa,GAAI,KAAqC,CAAC,aAAa,CAAC;QAC3E,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,IAAI;YAC7D,OAAO,KAAK,CAAC;QACf,MAAM,QAAQ,GAAI,aAAyC,CAAC,SAAS,CAAC;QACtE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACpE,MAAM,IAAI,GAAI,QAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC5D,OAAQ,IAAyB,CAAC,EAAE,KAAK,UAAU,CAAC;IACtD,CAAC,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAI,KAAQ,EAAyC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAjBD,sCAiBC"}

package/dist/esm/fieldTypes/rich_text.js

@@ -1,6 +1,6 @@
 import { isValidId } from '../utilities/id';
 import { isLocalizedFieldValue, } from '../utilities/normalizedFieldValues';
-import { isItemId, isItemWithOptionalIdAndMeta, isItemWithOptionalMeta, } from './single_block';
+import { isBlockObjectInRequest, isItemId, isItemWithOptionalMeta, } from './single_block';
 /**
  * =============================================================================
  * TYPE GUARDS - Runtime validation functions
@@ -31,8 +31,8 @@ export function isRichTextFieldValueInRequest(value) {
         // String ID - referencing existing block
         if (isItemId(block))
             return true;
-        // Object (either with or without ID for updates/creation)
-        return isItemWithOptionalIdAndMeta(block);
+        // Object (new, updated, or id-only update — with or without `relationships`)
+        return isBlockObjectInRequest(block);
     });
 }
 export function isLocalizedRichTextFieldValueInRequest(value) {

package/dist/esm/fieldTypes/rich_text.js.map

@@ -1 +1 @@
-{"version":3,"file":"rich_text.js","sourceRoot":"","sources":["../../../src/fieldTypes/rich_text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAEL,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAGL,QAAQ,EACR,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AA2ExB;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAc;IAEd,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CACtE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAc;IAEd,OAAO,CACL,qBAAqB,CAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CACjD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAE3C,KAAc;IACd,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,yCAAyC;QACzC,IAAI,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEjC,0DAA0D;QAC1D,OAAO,2BAA2B,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sCAAsC,CAGpD,KAAc;IAEd,OAAO,CACL,qBAAqB,CAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oCAAoC,CAElD,KAAc;IACd,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,uFAAuF;QACvF,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,6CAA6C,CAG3D,KAAc;IAEd,OAAO,CACL,qBAAqB,CAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,oCAAoC,CAAC,CACjE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"rich_text.js","sourceRoot":"","sources":["../../../src/fieldTypes/rich_text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAEL,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAGL,sBAAsB,EACtB,QAAQ,EACR,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AA2ExB;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAc;IAEd,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CACtE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAc;IAEd,OAAO,CACL,qBAAqB,CAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CACjD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAE3C,KAAc;IACd,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,yCAAyC;QACzC,IAAI,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEjC,6EAA6E;QAC7E,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sCAAsC,CAGpD,KAAc;IAEd,OAAO,CACL,qBAAqB,CAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oCAAoC,CAElD,KAAc;IACd,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,uFAAuF;QACvF,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,6CAA6C,CAG3D,KAAc;IAEd,OAAO,CACL,qBAAqB,CAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,oCAAoC,CAAC,CACjE,CAAC;AACJ,CAAC"}

package/dist/esm/fieldTypes/single_block.d.ts

@@ -52,7 +52,7 @@ export type UpdatedBlockInRequest<D extends ItemTypeDefinition = ItemTypeDefinit
     __itemTypeId?: D['itemTypeId'];
     type: RawApiTypes.ItemType1;
     id: RawApiTypes.ItemIdentity;
-    relationships: RawApiTypes.ItemRelationships<D>;
+    relationships?: RawApiTypes.ItemRelationships<D>;
     meta?: RawApiTypes.ItemMeta;
     attributes: ToItemAttributesInRequest<D>;
 };
@@ -125,6 +125,25 @@ export declare function isItemWithOptionalMeta<D extends ItemTypeDefinition = It
  */
 export declare function isSingleBlockFieldValue(value: unknown): value is SingleBlockFieldValue;
 export declare function isLocalizedSingleBlockFieldValue(value: unknown): value is LocalizedFieldValue<SingleBlockFieldValue>;
+/**
+ * Shape check for a block object on the *request* side. Accepts every object
+ * form the CMA allows inside a request payload:
+ *
+ *   1. New block (no id, full body):
+ *        { type: 'item', attributes, relationships: { item_type } }
+ *   2. Updated block, full body:
+ *        { type: 'item', id, attributes, relationships: { item_type } }
+ *   3. Updated block, id-only (patch some attributes of an existing block):
+ *        { type: 'item', id, attributes }                       ← no relationships
+ *
+ * Case 3 is what `buildBlockRecord` produces when the caller omits
+ * `item_type` — the server derives the model from the existing block's id,
+ * so re-specifying it in `relationships` is redundant.
+ */
+export declare function isBlockObjectInRequest(block: unknown): block is {
+    type: RawApiTypes.ItemType1;
+    attributes: Record<string, unknown>;
+};
 /**
  * Type guard for Single Block field values in API request format.
  * Allows block as string ID, full object with ID, or object without ID.

package/dist/esm/fieldTypes/single_block.js

@@ -47,6 +47,28 @@ export function isLocalizedSingleBlockFieldValue(value) {
     return (isLocalizedFieldValue(value) &&
         Object.values(value).every(isSingleBlockFieldValue));
 }
+/**
+ * Shape check for a block object on the *request* side. Accepts every object
+ * form the CMA allows inside a request payload:
+ *
+ *   1. New block (no id, full body):
+ *        { type: 'item', attributes, relationships: { item_type } }
+ *   2. Updated block, full body:
+ *        { type: 'item', id, attributes, relationships: { item_type } }
+ *   3. Updated block, id-only (patch some attributes of an existing block):
+ *        { type: 'item', id, attributes }                       ← no relationships
+ *
+ * Case 3 is what `buildBlockRecord` produces when the caller omits
+ * `item_type` — the server derives the model from the existing block's id,
+ * so re-specifying it in `relationships` is redundant.
+ */
+export function isBlockObjectInRequest(block) {
+    return (typeof block === 'object' &&
+        block !== null &&
+        'type' in block &&
+        block.type === 'item' &&
+        'attributes' in block);
+}
 /**
  * Type guard for Single Block field values in API request format.
  * Allows block as string ID, full object with ID, or object without ID.
@@ -57,8 +79,9 @@ export function isSingleBlockFieldValueInRequest(value) {
     // String ID - referencing existing block
     if (isItemId(value))
         return true;
-    // Object (either with or without ID for updates/creation)
-    return isItemWithOptionalIdAndMeta(value);
+    // Object (either with or without ID for updates/creation, including
+    // id-only updates without `relationships`)
+    return isBlockObjectInRequest(value);
 }
 export function isLocalizedSingleBlockFieldValueInRequest(value) {
     return (isLocalizedFieldValue(value) &&

package/dist/esm/fieldTypes/single_block.js.map

@@ -1 +1 @@
-{"version":3,"file":"single_block.js","sourceRoot":"","sources":["../../../src/fieldTypes/single_block.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAK5C,OAAO,EAEL,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAyH5C;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAMD;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAEzC,KAAc;IACd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,KAAK,CAAC,IAAI,KAAK,MAAM;QACrB,YAAY,IAAI,KAAK;QACrB,eAAe,IAAI,KAAK,CACzB,CAAC;AACJ,CAAC;AAMD;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAEpC,KAAc;IACd,OAAO,CACL,2BAA2B,CAAC,KAAK,CAAC;QAClC,IAAI,IAAI,KAAK;QACb,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAC7B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAc;IAEd,OAAO,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,KAAc;IAEd,OAAO,CACL,qBAAqB,CAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CACpD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAE9C,KAAc;IACd,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,yCAAyC;IACzC,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjC,0DAA0D;IAC1D,OAAO,2BAA2B,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,yCAAyC,CAGvD,KAAc;IAEd,OAAO,CACL,qBAAqB,CAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAC7D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uCAAuC,CAErD,KAAc;IACd,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,uFAAuF;IACvF,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,gDAAgD,CAG9D,KAAc;IAEd,OAAO,CACL,qBAAqB,CAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,uCAAuC,CAAC,CACpE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"single_block.js","sourceRoot":"","sources":["../../../src/fieldTypes/single_block.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAK5C,OAAO,EAEL,qBAAqB,GACtB,MAAM,oCAAoC,CAAC;AAyH5C;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAMD;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAEzC,KAAc;IACd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,KAAK,CAAC,IAAI,KAAK,MAAM;QACrB,YAAY,IAAI,KAAK;QACrB,eAAe,IAAI,KAAK,CACzB,CAAC;AACJ,CAAC;AAMD;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAEpC,KAAc;IACd,OAAO,CACL,2BAA2B,CAAC,KAAK,CAAC;QAClC,IAAI,IAAI,KAAK;QACb,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAC7B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAc;IAEd,OAAO,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,KAAc;IAEd,OAAO,CACL,qBAAqB,CAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CACpD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAc;IAInD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,KAAK,CAAC,IAAI,KAAK,MAAM;QACrB,YAAY,IAAI,KAAK,CACtB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAE9C,KAAc;IACd,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,yCAAyC;IACzC,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjC,oEAAoE;IACpE,2CAA2C;IAC3C,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,yCAAyC,CAGvD,KAAc;IAEd,OAAO,CACL,qBAAqB,CAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAC7D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uCAAuC,CAErD,KAAc;IACd,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,uFAAuF;IACvF,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,gDAAgD,CAG9D,KAAc;IAEd,OAAO,CACL,qBAAqB,CAAC,KAAK,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,uCAAuC,CAAC,CACpE,CAAC;AACJ,CAAC"}

package/dist/esm/fieldTypes/structured_text.js

@@ -1,7 +1,7 @@
 import { everyNode, isBlock, isDocument, isInlineBlock, } from 'datocms-structured-text-utils';
 import { isValidId } from '../utilities/id';
 import { isLocalizedFieldValue, } from '../utilities/normalizedFieldValues';
-import { isItemId, isItemWithOptionalIdAndMeta, isItemWithOptionalMeta, } from './single_block';
+import { isBlockObjectInRequest, isItemId, isItemWithOptionalMeta, } from './single_block';
 /**
  * Utility function to validate all block/inlineBlock nodes in a structured text document tree.
  * Calls the provided callback for each block/inlineBlock node found and returns true only if all pass.
@@ -51,8 +51,8 @@ export function isStructuredTextFieldValueInRequest(value) {
         // String ID
         if (isItemId(item))
             return true;
-        // Object (either with or without ID)
-        return isItemWithOptionalIdAndMeta(item);
+        // Object (new, updated, or id-only update — with or without `relationships`)
+        return isBlockObjectInRequest(item);
     });
 }
 export function isLocalizedStructuredTextFieldValueInRequest(value) {

package/dist/esm/fieldTypes/structured_text.js.map

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

package/dist/esm/generated/Client.js

@@ -64,7 +64,7 @@ export class Client {
         return this.config.baseUrl || Client.defaultBaseUrl;
     }
     request(options) {
-        return request(Object.assign(Object.assign(Object.assign({}, this.config), options), { logFn: this.config.logFn || console.log, userAgent: '@datocms/cma-client v5.4.5', baseUrl: this.baseUrl, preCallStack: new Error().stack, extraHeaders: Object.assign(Object.assign(Object.assign({}, (this.config.extraHeaders || {})), (this.config.environment
+        return request(Object.assign(Object.assign(Object.assign({}, this.config), options), { logFn: this.config.logFn || console.log, userAgent: '@datocms/cma-client v5.4.7', baseUrl: this.baseUrl, preCallStack: new Error().stack, extraHeaders: Object.assign(Object.assign(Object.assign({}, (this.config.extraHeaders || {})), (this.config.environment
                 ? { 'X-Environment': this.config.environment }
                 : {})), { 'X-API-Version': '3' }), fetchJobResult: (jobId) => {
                 return this.jobResultsFetcher

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

@@ -19,14 +19,19 @@ export type NarrowBlockByItemType<T, Id extends string> = Extract<T, {
     };
 }>;
 /**
- * Builds a type guard that narrows a block to a specific model.
+ * Type guard that narrows a block to a specific model.
  *
- * Call it with the block's `itemTypeId` literal — the ID generic is inferred
- * from the argument, so no explicit type parameter is needed. The returned
- * predicate is generic: given any input type `T`, it narrows to
- * `Extract<T, { relationships: { item_type: { data: { id: Id } } } }>`. It's
- * meant to plug into `Array#filter` / `Array#find` over block-bearing fields
- * in any of these contexts:
+ * Two call styles, same narrowing behavior:
+ *
+ * - Curried: `isBlockOfType(itemTypeId)` returns a predicate, ideal for
+ *   `Array#filter` / `Array#find`.
+ * - Direct: `isBlockOfType(itemTypeId, block)` checks a single value inline,
+ *   handy inside `if` statements when you already have the block in hand.
+ *
+ * The ID generic is inferred from the first argument, so no explicit type
+ * parameter is needed. Given any input type `T`, the result narrows to
+ * `Extract<T, { relationships: { item_type: { data: { id: Id } } } }>`,
+ * which covers:
  *
  * - `ItemInNestedResponse<D>` (responses with `nested: true`)
  * - `ItemCreateSchema<D>` / `ItemUpdateSchema<D>` (request payloads, object
@@ -45,8 +50,16 @@ export type NarrowBlockByItemType<T, Id extends string> = Extract<T, {
  * const SESSION_BLOCK_ID = 'abc123' as const;
  *
  * const record = await client.items.find<Schema.ConferenceDay>(id, { nested: true });
+ *
+ * // Curried — predicate for filter/find
  * const sessions = record.agenda.filter(isBlockOfType(SESSION_BLOCK_ID));
  * sessions[0].attributes.signup_url; // OK — narrowed
+ *
+ * // Direct — inline check on a single block
+ * if (isBlockOfType(SESSION_BLOCK_ID, record.agenda[0])) {
+ *   record.agenda[0].attributes.signup_url; // OK — narrowed
+ * }
  * ```
  */
 export declare function isBlockOfType<Id extends string>(itemTypeId: Id): <T>(block: T) => block is NarrowBlockByItemType<T, Id>;
+export declare function isBlockOfType<T, Id extends string>(itemTypeId: Id, block: T): block is NarrowBlockByItemType<T, Id>;

package/dist/esm/utilities/isBlockOfType.js

@@ -1,36 +1,5 @@
-/**
- * Builds a type guard that narrows a block to a specific model.
- *
- * Call it with the block's `itemTypeId` literal — the ID generic is inferred
- * from the argument, so no explicit type parameter is needed. The returned
- * predicate is generic: given any input type `T`, it narrows to
- * `Extract<T, { relationships: { item_type: { data: { id: Id } } } }>`. It's
- * meant to plug into `Array#filter` / `Array#find` over block-bearing fields
- * in any of these contexts:
- *
- * - `ItemInNestedResponse<D>` (responses with `nested: true`)
- * - `ItemCreateSchema<D>` / `ItemUpdateSchema<D>` (request payloads, object
- *   variants; plain string IDs are filtered out — there's no way to narrow
- *   them without an external lookup)
- *
- * The default (non-nested) response shape, where block fields are arrays of
- * plain string IDs, is deliberately not supported — the type information is
- * not recoverable from an ID alone.
- *
- * For the literal `Id` to be preserved (and narrowing to work), the argument
- * must be typed as a literal — use `as const` on pre-set ID constants.
- *
- * @example
- * ```ts
- * const SESSION_BLOCK_ID = 'abc123' as const;
- *
- * const record = await client.items.find<Schema.ConferenceDay>(id, { nested: true });
- * const sessions = record.agenda.filter(isBlockOfType(SESSION_BLOCK_ID));
- * sessions[0].attributes.signup_url; // OK — narrowed
- * ```
- */
-export function isBlockOfType(itemTypeId) {
-    return (block) => {
+export function isBlockOfType(itemTypeId, ...rest) {
+    const check = (block) => {
         if (typeof block !== 'object' || block === null)
             return false;
         const relationships = block.relationships;
@@ -44,5 +13,8 @@ export function isBlockOfType(itemTypeId) {
             return false;
         return data.id === itemTypeId;
     };
+    if (rest.length > 0)
+        return check(rest[0]);
+    return (block) => check(block);
 }
 //# sourceMappingURL=isBlockOfType.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"isBlockOfType.js","sourceRoot":"","sources":["../../../src/utilities/isBlockOfType.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,aAAa,CAC3B,UAAc;IAEd,OAAO,CAAI,KAAQ,EAAyC,EAAE;QAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,aAAa,GAAI,KAAqC,CAAC,aAAa,CAAC;QAC3E,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,IAAI;YAC7D,OAAO,KAAK,CAAC;QACf,MAAM,QAAQ,GAAI,aAAyC,CAAC,SAAS,CAAC;QACtE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACpE,MAAM,IAAI,GAAI,QAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC5D,OAAQ,IAAyB,CAAC,EAAE,KAAK,UAAU,CAAC;IACtD,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"isBlockOfType.js","sourceRoot":"","sources":["../../../src/utilities/isBlockOfType.ts"],"names":[],"mappings":"AAiEA,MAAM,UAAU,aAAa,CAC3B,UAAc,EACd,GAAG,IAA2B;IAE9B,MAAM,KAAK,GAAG,CAAC,KAAc,EAAW,EAAE;QACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,aAAa,GAAI,KAAqC,CAAC,aAAa,CAAC;QAC3E,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,IAAI;YAC7D,OAAO,KAAK,CAAC;QACf,MAAM,QAAQ,GAAI,aAAyC,CAAC,SAAS,CAAC;QACtE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACpE,MAAM,IAAI,GAAI,QAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC5D,OAAQ,IAAyB,CAAC,EAAE,KAAK,UAAU,CAAC;IACtD,CAAC,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAI,KAAQ,EAAyC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/types/fieldTypes/single_block.d.ts

@@ -52,7 +52,7 @@ export type UpdatedBlockInRequest<D extends ItemTypeDefinition = ItemTypeDefinit
     __itemTypeId?: D['itemTypeId'];
     type: RawApiTypes.ItemType1;
     id: RawApiTypes.ItemIdentity;
-    relationships: RawApiTypes.ItemRelationships<D>;
+    relationships?: RawApiTypes.ItemRelationships<D>;
     meta?: RawApiTypes.ItemMeta;
     attributes: ToItemAttributesInRequest<D>;
 };
@@ -125,6 +125,25 @@ export declare function isItemWithOptionalMeta<D extends ItemTypeDefinition = It
  */
 export declare function isSingleBlockFieldValue(value: unknown): value is SingleBlockFieldValue;
 export declare function isLocalizedSingleBlockFieldValue(value: unknown): value is LocalizedFieldValue<SingleBlockFieldValue>;
+/**
+ * Shape check for a block object on the *request* side. Accepts every object
+ * form the CMA allows inside a request payload:
+ *
+ *   1. New block (no id, full body):
+ *        { type: 'item', attributes, relationships: { item_type } }
+ *   2. Updated block, full body:
+ *        { type: 'item', id, attributes, relationships: { item_type } }
+ *   3. Updated block, id-only (patch some attributes of an existing block):
+ *        { type: 'item', id, attributes }                       ← no relationships
+ *
+ * Case 3 is what `buildBlockRecord` produces when the caller omits
+ * `item_type` — the server derives the model from the existing block's id,
+ * so re-specifying it in `relationships` is redundant.
+ */
+export declare function isBlockObjectInRequest(block: unknown): block is {
+    type: RawApiTypes.ItemType1;
+    attributes: Record<string, unknown>;
+};
 /**
  * Type guard for Single Block field values in API request format.
  * Allows block as string ID, full object with ID, or object without ID.

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

@@ -19,14 +19,19 @@ export type NarrowBlockByItemType<T, Id extends string> = Extract<T, {
     };
 }>;
 /**
- * Builds a type guard that narrows a block to a specific model.
+ * Type guard that narrows a block to a specific model.
  *
- * Call it with the block's `itemTypeId` literal — the ID generic is inferred
- * from the argument, so no explicit type parameter is needed. The returned
- * predicate is generic: given any input type `T`, it narrows to
- * `Extract<T, { relationships: { item_type: { data: { id: Id } } } }>`. It's
- * meant to plug into `Array#filter` / `Array#find` over block-bearing fields
- * in any of these contexts:
+ * Two call styles, same narrowing behavior:
+ *
+ * - Curried: `isBlockOfType(itemTypeId)` returns a predicate, ideal for
+ *   `Array#filter` / `Array#find`.
+ * - Direct: `isBlockOfType(itemTypeId, block)` checks a single value inline,
+ *   handy inside `if` statements when you already have the block in hand.
+ *
+ * The ID generic is inferred from the first argument, so no explicit type
+ * parameter is needed. Given any input type `T`, the result narrows to
+ * `Extract<T, { relationships: { item_type: { data: { id: Id } } } }>`,
+ * which covers:
  *
  * - `ItemInNestedResponse<D>` (responses with `nested: true`)
  * - `ItemCreateSchema<D>` / `ItemUpdateSchema<D>` (request payloads, object
@@ -45,8 +50,16 @@ export type NarrowBlockByItemType<T, Id extends string> = Extract<T, {
  * const SESSION_BLOCK_ID = 'abc123' as const;
  *
  * const record = await client.items.find<Schema.ConferenceDay>(id, { nested: true });
+ *
+ * // Curried — predicate for filter/find
  * const sessions = record.agenda.filter(isBlockOfType(SESSION_BLOCK_ID));
  * sessions[0].attributes.signup_url; // OK — narrowed
+ *
+ * // Direct — inline check on a single block
+ * if (isBlockOfType(SESSION_BLOCK_ID, record.agenda[0])) {
+ *   record.agenda[0].attributes.signup_url; // OK — narrowed
+ * }
  * ```
  */
 export declare function isBlockOfType<Id extends string>(itemTypeId: Id): <T>(block: T) => block is NarrowBlockByItemType<T, Id>;
+export declare function isBlockOfType<T, Id extends string>(itemTypeId: Id, block: T): block is NarrowBlockByItemType<T, Id>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datocms/cma-client",
-  "version": "5.4.5",
+  "version": "5.4.7",
   "description": "JS client for DatoCMS REST Content Management API",
   "keywords": [
     "datocms",
@@ -45,5 +45,5 @@
     "@datocms/dashboard-client": "^5.4.3",
     "@types/uuid": "^9.0.7"
   },
-  "gitHead": "dac77c6d49f38f49d2a759d2b8c2d4427c8a6c63"
+  "gitHead": "4a2443c6f351448a165eef4359a3451ffd5b6b08"
 }

package/src/fieldTypes/rich_text.ts

@@ -8,8 +8,8 @@ import type { RichTextEditorConfiguration } from './appearance/rich_text';
 import {
   type BlockInNestedResponse,
   type BlockInRequest,
+  isBlockObjectInRequest,
   isItemId,
-  isItemWithOptionalIdAndMeta,
   isItemWithOptionalMeta,
 } from './single_block';
 import type { RichTextBlocksValidator } from './validators/rich_text_blocks';
@@ -129,8 +129,8 @@ export function isRichTextFieldValueInRequest<
     // String ID - referencing existing block
     if (isItemId(block)) return true;
 
-    // Object (either with or without ID for updates/creation)
-    return isItemWithOptionalIdAndMeta(block);
+    // Object (new, updated, or id-only update — with or without `relationships`)
+    return isBlockObjectInRequest(block);
   });
 }
 

package/src/fieldTypes/single_block.ts

@@ -68,7 +68,7 @@ export type UpdatedBlockInRequest<
   __itemTypeId?: D['itemTypeId'];
   type: RawApiTypes.ItemType1;
   id: RawApiTypes.ItemIdentity;
-  relationships: RawApiTypes.ItemRelationships<D>;
+  relationships?: RawApiTypes.ItemRelationships<D>;
   meta?: RawApiTypes.ItemMeta;
   attributes: ToItemAttributesInRequest<D>;
 };
@@ -204,6 +204,34 @@ export function isLocalizedSingleBlockFieldValue(
   );
 }
 
+/**
+ * Shape check for a block object on the *request* side. Accepts every object
+ * form the CMA allows inside a request payload:
+ *
+ *   1. New block (no id, full body):
+ *        { type: 'item', attributes, relationships: { item_type } }
+ *   2. Updated block, full body:
+ *        { type: 'item', id, attributes, relationships: { item_type } }
+ *   3. Updated block, id-only (patch some attributes of an existing block):
+ *        { type: 'item', id, attributes }                       ← no relationships
+ *
+ * Case 3 is what `buildBlockRecord` produces when the caller omits
+ * `item_type` — the server derives the model from the existing block's id,
+ * so re-specifying it in `relationships` is redundant.
+ */
+export function isBlockObjectInRequest(block: unknown): block is {
+  type: RawApiTypes.ItemType1;
+  attributes: Record<string, unknown>;
+} {
+  return (
+    typeof block === 'object' &&
+    block !== null &&
+    'type' in block &&
+    block.type === 'item' &&
+    'attributes' in block
+  );
+}
+
 /**
  * Type guard for Single Block field values in API request format.
  * Allows block as string ID, full object with ID, or object without ID.
@@ -216,8 +244,9 @@ export function isSingleBlockFieldValueInRequest<
   // String ID - referencing existing block
   if (isItemId(value)) return true;
 
-  // Object (either with or without ID for updates/creation)
-  return isItemWithOptionalIdAndMeta(value);
+  // Object (either with or without ID for updates/creation, including
+  // id-only updates without `relationships`)
+  return isBlockObjectInRequest(value);
 }
 
 export function isLocalizedSingleBlockFieldValueInRequest<

package/src/fieldTypes/structured_text.ts

@@ -18,8 +18,8 @@ import type { StructuredTextEditorConfiguration } from './appearance/structured_
 import {
   type BlockInNestedResponse,
   type BlockInRequest,
+  isBlockObjectInRequest,
   isItemId,
-  isItemWithOptionalIdAndMeta,
   isItemWithOptionalMeta,
 } from './single_block';
 import type { RequiredValidator } from './validators';
@@ -217,8 +217,8 @@ export function isStructuredTextFieldValueInRequest<
     // String ID
     if (isItemId(item)) return true;
 
-    // Object (either with or without ID)
-    return isItemWithOptionalIdAndMeta(item);
+    // Object (new, updated, or id-only update — with or without `relationships`)
+    return isBlockObjectInRequest(item);
   });
 }
 

package/src/generated/Client.ts

@@ -151,7 +151,7 @@ export class Client {
       ...this.config,
       ...options,
       logFn: this.config.logFn || console.log,
-      userAgent: '@datocms/cma-client v5.4.5',
+      userAgent: '@datocms/cma-client v5.4.7',
       baseUrl: this.baseUrl,
       preCallStack: new Error().stack,
       extraHeaders: {

package/src/utilities/isBlockOfType.ts

@@ -14,14 +14,19 @@ export type NarrowBlockByItemType<T, Id extends string> = Extract<
 >;
 
 /**
- * Builds a type guard that narrows a block to a specific model.
+ * Type guard that narrows a block to a specific model.
  *
- * Call it with the block's `itemTypeId` literal — the ID generic is inferred
- * from the argument, so no explicit type parameter is needed. The returned
- * predicate is generic: given any input type `T`, it narrows to
- * `Extract<T, { relationships: { item_type: { data: { id: Id } } } }>`. It's
- * meant to plug into `Array#filter` / `Array#find` over block-bearing fields
- * in any of these contexts:
+ * Two call styles, same narrowing behavior:
+ *
+ * - Curried: `isBlockOfType(itemTypeId)` returns a predicate, ideal for
+ *   `Array#filter` / `Array#find`.
+ * - Direct: `isBlockOfType(itemTypeId, block)` checks a single value inline,
+ *   handy inside `if` statements when you already have the block in hand.
+ *
+ * The ID generic is inferred from the first argument, so no explicit type
+ * parameter is needed. Given any input type `T`, the result narrows to
+ * `Extract<T, { relationships: { item_type: { data: { id: Id } } } }>`,
+ * which covers:
  *
  * - `ItemInNestedResponse<D>` (responses with `nested: true`)
  * - `ItemCreateSchema<D>` / `ItemUpdateSchema<D>` (request payloads, object
@@ -40,14 +45,29 @@ export type NarrowBlockByItemType<T, Id extends string> = Extract<
  * const SESSION_BLOCK_ID = 'abc123' as const;
  *
  * const record = await client.items.find<Schema.ConferenceDay>(id, { nested: true });
+ *
+ * // Curried — predicate for filter/find
  * const sessions = record.agenda.filter(isBlockOfType(SESSION_BLOCK_ID));
  * sessions[0].attributes.signup_url; // OK — narrowed
+ *
+ * // Direct — inline check on a single block
+ * if (isBlockOfType(SESSION_BLOCK_ID, record.agenda[0])) {
+ *   record.agenda[0].attributes.signup_url; // OK — narrowed
+ * }
  * ```
  */
 export function isBlockOfType<Id extends string>(
   itemTypeId: Id,
-): <T>(block: T) => block is NarrowBlockByItemType<T, Id> {
-  return <T>(block: T): block is NarrowBlockByItemType<T, Id> => {
+): <T>(block: T) => block is NarrowBlockByItemType<T, Id>;
+export function isBlockOfType<T, Id extends string>(
+  itemTypeId: Id,
+  block: T,
+): block is NarrowBlockByItemType<T, Id>;
+export function isBlockOfType<Id extends string>(
+  itemTypeId: Id,
+  ...rest: [block: unknown] | []
+): boolean | (<T>(block: T) => block is NarrowBlockByItemType<T, Id>) {
+  const check = (block: unknown): boolean => {
     if (typeof block !== 'object' || block === null) return false;
     const relationships = (block as { relationships?: unknown }).relationships;
     if (typeof relationships !== 'object' || relationships === null)
@@ -58,4 +78,6 @@ export function isBlockOfType<Id extends string>(
     if (typeof data !== 'object' || data === null) return false;
     return (data as { id?: unknown }).id === itemTypeId;
   };
+  if (rest.length > 0) return check(rest[0]);
+  return <T>(block: T): block is NarrowBlockByItemType<T, Id> => check(block);
 }