@solana/codecs-data-structures 8.3.0 → 8.4.0-canary-20260918134912

package/dist/index.node.cjs

@@ -33,13 +33,15 @@ function getMaxSize(codec) {
 // src/array.ts
 function getArrayEncoder(item, config = {}) {
   const size = config.size ?? codecsNumbers.getU32Encoder();
+  assertValidSize(size);
   const fixedSize = computeArrayLikeCodecSize(size, getFixedSize(item));
   const maxSize = computeArrayLikeCodecSize(size, getMaxSize(item)) ?? void 0;
   return codecsCore.createEncoder({
     ...fixedSize !== null ? { fixedSize } : {
       getSizeFromValue: (array) => {
-        const prefixSize = typeof size === "object" ? codecsCore.getEncodedSize(array.length, size) : 0;
-        return prefixSize + [...array].reduce((all, value) => all + codecsCore.getEncodedSize(value, item), 0);
+        const prefixSize = isPrefixSize(size) ? codecsCore.getEncodedSize(array.length, size) : 0;
+        const suffixSize = isSentinelSize(size) && size.strategy !== "omitted" ? size.sentinel.length : 0;
+        return prefixSize + suffixSize + [...array].reduce((all, value) => all + codecsCore.getEncodedSize(value, item), 0);
       },
       maxSize
     },
@@ -47,18 +49,23 @@ function getArrayEncoder(item, config = {}) {
       if (typeof size === "number") {
         assertValidNumberOfItemsForCodec(config.description ?? "array", size, array.length);
       }
-      if (typeof size === "object") {
+      if (isPrefixSize(size)) {
         offset = size.write(array.length, bytes, offset);
       }
       array.forEach((value) => {
         offset = item.write(value, bytes, offset);
       });
+      if (isSentinelSize(size) && size.strategy !== "omitted") {
+        bytes.set(size.sentinel, offset);
+        offset += size.sentinel.length;
+      }
       return offset;
     }
   });
 }
 function getArrayDecoder(item, config = {}) {
   const size = config.size ?? codecsNumbers.getU32Decoder();
+  assertValidSize(size);
   const itemSize = getFixedSize(item);
   const fixedSize = computeArrayLikeCodecSize(size, itemSize);
   const maxSize = computeArrayLikeCodecSize(size, getMaxSize(item)) ?? void 0;
@@ -66,7 +73,7 @@ function getArrayDecoder(item, config = {}) {
     ...fixedSize !== null ? { fixedSize } : { maxSize },
     read: (bytes, offset) => {
       const array = [];
-      if (typeof size === "object" && !config.requireSizePrefix && offset >= bytes.length) {
+      if (isPrefixSize(size) && !config.requireSizePrefix && offset >= bytes.length) {
         return [array, offset];
       }
       if (size === "remainder") {
@@ -77,6 +84,29 @@ function getArrayDecoder(item, config = {}) {
         }
         return [array, offset];
       }
+      if (isSentinelSize(size)) {
+        const { sentinel, strategy = "required" } = size;
+        while (true) {
+          if (offset + sentinel.length > bytes.length) {
+            if (strategy === "required") {
+              throw new errors.SolanaError(errors.SOLANA_ERROR__CODECS__SENTINEL_MISSING_AT_END_OF_BYTES, {
+                codecDescription: config.description ?? "array",
+                hexSentinel: hexBytes(sentinel),
+                sentinel
+              });
+            }
+            break;
+          }
+          if (codecsCore.containsBytes(bytes, sentinel, offset)) {
+            offset += sentinel.length;
+            break;
+          }
+          const [value, newOffset2] = item.read(bytes, offset);
+          offset = newOffset2;
+          array.push(value);
+        }
+        return [array, offset];
+      }
       const [resolvedSize, newOffset] = typeof size === "number" ? [size, offset] : size.read(bytes, offset);
       offset = newOffset;
       for (let i = 0; i < resolvedSize; i += 1) {
@@ -96,6 +126,20 @@ function computeArrayLikeCodecSize(size, itemSize) {
   if (size === 0) return 0;
   return itemSize === null ? null : itemSize * size;
 }
+function isPrefixSize(size) {
+  return typeof size === "object" && size !== null && !isSentinelSize(size);
+}
+function isSentinelSize(size) {
+  return typeof size === "object" && size !== null && "__kind" in size && size.__kind === "sentinel";
+}
+function assertValidSize(size) {
+  if (isSentinelSize(size) && size.sentinel.length === 0) {
+    throw new errors.SolanaError(errors.SOLANA_ERROR__CODECS__SENTINEL_MUST_NOT_BE_EMPTY);
+  }
+}
+function hexBytes(bytes) {
+  return bytes.reduce((str, byte) => str + byte.toString(16).padStart(2, "0"), "");
+}
 function getBitArrayEncoder(size, config = {}) {
   const parsedConfig = typeof config === "boolean" ? { backward: config } : config;
   const backward = parsedConfig.backward ?? false;