@cloudbitmaps/core 0.6.0 → 0.7.0

package/dist/index.cjs

@@ -1504,8 +1504,8 @@ var FOOTER = {
   // u32
   flags: 20,
   // u32
-  roaringSerializationId: 24,
-  // u16
+  payloadCodecId: 24,
+  // u16 — was `roaringSerializationId`; same offset, same width, wider meaning
   elementWidth: 26,
   // u8
   containerCodec: 27,
@@ -1533,7 +1533,10 @@ var FOOTER_CRC_COVERAGE = FOOTER.footerCrc32c;
 var FLAG_ENCRYPTED = 1 << 0;
 var FLAG_LITTLE_ENDIAN = 1 << 2;
 var ELEMENT_WIDTH_32 = 32;
-var ROARING_PORTABLE_ID = 1;
+var PAYLOAD_CODEC_ROARING_PORTABLE = 1;
+var KNOWN_PAYLOAD_CODEC_IDS = /* @__PURE__ */ new Set([
+  PAYLOAD_CODEC_ROARING_PORTABLE
+]);
 var CONTAINER_CODEC_NONE = 0;
 var DEFAULT_TAIL_BYTES = 256 * 1024;
 var DEFAULT_MAX_INDEX_BYTES = 8 * 1024 * 1024;
@@ -1630,10 +1633,10 @@ var CrbmReader = class _CrbmReader {
         `.crbm element_width ${elementWidth} not supported (v1 reads 32-bit ids; 64-bit is a future major version)`
       );
     }
-    const serializationId = fview.getUint16(FOOTER.roaringSerializationId, true);
-    if (serializationId !== ROARING_PORTABLE_ID) {
+    const payloadCodecId = fview.getUint16(FOOTER.payloadCodecId, true);
+    if (!KNOWN_PAYLOAD_CODEC_IDS.has(payloadCodecId)) {
       throw new UnsupportedError(
-        `.crbm roaring_serialization_id ${serializationId} not supported (v1 is portable=${ROARING_PORTABLE_ID})`
+        `.crbm payload_codec_id ${payloadCodecId} not supported by this build (known: ${[...KNOWN_PAYLOAD_CODEC_IDS].join(", ")}; ${PAYLOAD_CODEC_ROARING_PORTABLE}=roaring portable). A generation written by a different codec is rejected rather than decoded \u2014 a store uses one codec throughout.`
       );
     }
     const containerCodec = footer[FOOTER.containerCodec];
@@ -1928,8 +1931,8 @@ var CrbmWriter = class {
     view.setUint32(FOOTER.indexCrc32c, crc32c(indexRegion), true);
     view.setUint32(FOOTER.flags, FLAG_LITTLE_ENDIAN | (encrypted ? FLAG_ENCRYPTED : 0), true);
     view.setUint16(
-      FOOTER.roaringSerializationId,
-      this.options.roaringSerializationId ?? ROARING_PORTABLE_ID,
+      FOOTER.payloadCodecId,
+      this.options.payloadCodecId ?? PAYLOAD_CODEC_ROARING_PORTABLE,
       true
     );
     footer[FOOTER.elementWidth] = this.options.elementWidth ?? ELEMENT_WIDTH_32;