@solana/codecs-data-structures 8.4.0 → 8.5.0-canary-20261006083550

package/dist/index.browser.mjs

@@ -1,6 +1,6 @@
 import { createEncoder, getEncodedSize, createDecoder, containsBytes, combineCodec, assertByteArrayHasEnoughBytesForCodec, transformEncoder, transformDecoder, isFixedSize, assertIsFixedSize, fixEncoderSize, fixDecoderSize } from '@solana/codecs-core';
 import { getU32Encoder, getU32Decoder, getU8Encoder, getU8Decoder } from '@solana/codecs-numbers';
-import { SolanaError, SOLANA_ERROR__CODECS__INVALID_NUMBER_OF_ITEMS, SOLANA_ERROR__CODECS__SENTINEL_MISSING_AT_END_OF_BYTES, SOLANA_ERROR__CODECS__SENTINEL_MUST_NOT_BE_EMPTY, SOLANA_ERROR__CODECS__INVALID_CONSTANT, SOLANA_ERROR__CODECS__UNION_VARIANT_OUT_OF_RANGE, SOLANA_ERROR__CODECS__INVALID_DISCRIMINATED_UNION_VARIANT, SOLANA_ERROR__CODECS__CANNOT_USE_LEXICAL_VALUES_AS_ENUM_DISCRIMINATORS, SOLANA_ERROR__CODECS__INVALID_ENUM_VARIANT, SOLANA_ERROR__CODECS__ENUM_DISCRIMINATOR_OUT_OF_RANGE, SOLANA_ERROR__CODECS__INVALID_LITERAL_UNION_VARIANT, SOLANA_ERROR__CODECS__LITERAL_UNION_DISCRIMINATOR_OUT_OF_RANGE, SOLANA_ERROR__CODECS__INVALID_PATTERN_MATCH_VALUE, SOLANA_ERROR__CODECS__INVALID_PATTERN_MATCH_BYTES } from '@solana/errors';
+import { SolanaError, SOLANA_ERROR__CODECS__INVALID_NUMBER_OF_ITEMS, SOLANA_ERROR__CODECS__SENTINEL_MISSING_AT_END_OF_BYTES, SOLANA_ERROR__CODECS__SENTINEL_MUST_NOT_BE_EMPTY, SOLANA_ERROR__CODECS__UNEXPECTED_ZERO_FIXED_SIZE_ITEM_FOR_ARRAY_LIKE_SIZE_STRATEGY, SOLANA_ERROR__CODECS__INVALID_CONSTANT, SOLANA_ERROR__CODECS__UNION_VARIANT_OUT_OF_RANGE, SOLANA_ERROR__CODECS__INVALID_DISCRIMINATED_UNION_VARIANT, SOLANA_ERROR__CODECS__CANNOT_USE_LEXICAL_VALUES_AS_ENUM_DISCRIMINATORS, SOLANA_ERROR__CODECS__INVALID_ENUM_VARIANT, SOLANA_ERROR__CODECS__ENUM_DISCRIMINATOR_OUT_OF_RANGE, SOLANA_ERROR__CODECS__INVALID_LITERAL_UNION_VARIANT, SOLANA_ERROR__CODECS__LITERAL_UNION_DISCRIMINATOR_OUT_OF_RANGE, SOLANA_ERROR__CODECS__INVALID_PATTERN_MATCH_VALUE, SOLANA_ERROR__CODECS__INVALID_PATTERN_MATCH_BYTES } from '@solana/errors';
 
 // src/array.ts
 function assertValidNumberOfItemsForCodec(codecDescription, expected, actual) {
@@ -32,7 +32,9 @@ function getMaxSize(codec) {
 function getArrayEncoder(item, config = {}) {
   const size = config.size ?? getU32Encoder();
   assertValidSize(size);
-  const fixedSize = computeArrayLikeCodecSize(size, getFixedSize(item));
+  const itemSize = getFixedSize(item);
+  assertItemCodecSupportsSizeStrategy(config.description ?? "array", size, itemSize);
+  const fixedSize = computeArrayLikeCodecSize(size, itemSize);
   const maxSize = computeArrayLikeCodecSize(size, getMaxSize(item)) ?? void 0;
   return createEncoder({
     ...fixedSize !== null ? { fixedSize } : {
@@ -65,6 +67,7 @@ function getArrayDecoder(item, config = {}) {
   const size = config.size ?? getU32Decoder();
   assertValidSize(size);
   const itemSize = getFixedSize(item);
+  assertItemCodecSupportsSizeStrategy(config.description ?? "array", size, itemSize);
   const fixedSize = computeArrayLikeCodecSize(size, itemSize);
   const maxSize = computeArrayLikeCodecSize(size, getMaxSize(item)) ?? void 0;
   return createDecoder({
@@ -135,6 +138,15 @@ function assertValidSize(size) {
     throw new SolanaError(SOLANA_ERROR__CODECS__SENTINEL_MUST_NOT_BE_EMPTY);
   }
 }
+function assertItemCodecSupportsSizeStrategy(codecDescription, size, itemFixedSize) {
+  if (itemFixedSize !== 0) return;
+  if (size === "remainder" || isSentinelSize(size)) {
+    throw new SolanaError(SOLANA_ERROR__CODECS__UNEXPECTED_ZERO_FIXED_SIZE_ITEM_FOR_ARRAY_LIKE_SIZE_STRATEGY, {
+      codecDescription,
+      sizeStrategy: size === "remainder" ? "remainder" : "sentinel"
+    });
+  }
+}
 function hexBytes(bytes) {
   return bytes.reduce((str, byte) => str + byte.toString(16).padStart(2, "0"), "");
 }