@structured-world/structured-zstd 0.2.5 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@structured-world/structured-zstd",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "description": "Pure-Rust Zstandard (zstd) codec compiled to WebAssembly — compress and decompress in the browser, Node.js and Deno, with automatic SIMD (simd128) acceleration and a scalar fallback. No native addons, no FFI.",
   "type": "module",
   "exports": {

package/scalar/structured_zstd_wasm.d.ts

@@ -51,7 +51,7 @@ export class ZstdCompressStream {
      * Feed more plaintext; returns whatever compressed bytes are now complete
      * (possibly empty while the current block is still filling).
      */
-    push(chunk: Uint8Array): Uint8Array;
+    push(chunk: Uint8Array | number[]): Uint8Array;
     /**
      * Open a streaming compressor at `level` seeded with a raw zstd dictionary
      * blob (e.g. from `zstd --train`), mirroring `ZSTD_CCtx_loadDictionary` on
@@ -61,7 +61,7 @@ export class ZstdCompressStream {
      * opened via its matching `withDictionary` constructor (or the one-shot
      * `decompressUsingDict`). Throws if the dictionary is invalid.
      */
-    static withDictionary(level: number, dict: Uint8Array, checksum?: boolean | null): ZstdCompressStream;
+    static withDictionary(level: number, dict: Uint8Array | number[], checksum?: boolean | null): ZstdCompressStream;
     /**
      * Open a streaming compressor at `level` seeded from a [`ZstdDictionary`]
      * prepared once: per-stream setup copies the prepared tables instead of
@@ -104,7 +104,7 @@ export class ZstdDecompressStream {
      * Feed more compressed bytes; returns whatever decompressed output is now
      * available (possibly empty while a block is still incomplete).
      */
-    push(chunk: Uint8Array): Uint8Array;
+    push(chunk: Uint8Array | number[]): Uint8Array;
     /**
      * The content checksum stored in the frame's 4-byte trailer, or
      * `undefined` if the frame carried none. Meaningful after [`Self::finish`].
@@ -117,7 +117,7 @@ export class ZstdDecompressStream {
      * `withDictionary`). `checksum` behaves as in [`Self::new`]. Throws if the
      * dictionary is malformed.
      */
-    static withDictionary(dict: Uint8Array, checksum?: ContentChecksum | null): ZstdDecompressStream;
+    static withDictionary(dict: Uint8Array | number[], checksum?: ContentChecksum | null): ZstdDecompressStream;
     /**
      * Open a streaming decompressor against a [`ZstdDictionary`] prepared
      * once: per-stream setup is a reference-count bump, no dictionary
@@ -158,19 +158,19 @@ export class ZstdDictionary {
      *
      * `checksum` is optional (default `false`).
      */
-    compress(data: Uint8Array, level: number, checksum?: boolean | null): Uint8Array;
+    compress(data: Uint8Array | number[], level: number, checksum?: boolean | null): Uint8Array;
     /**
      * Decompress a frame produced with this dictionary, reusing the
      * prepared tables and one decoder workspace across calls. `checksum`
      * behaves as in the module-level `decompress`.
      */
-    decompress(data: Uint8Array, checksum?: ContentChecksum | null): Uint8Array;
+    decompress(data: Uint8Array | number[], checksum?: ContentChecksum | null): Uint8Array;
     /**
      * Parse `dict` once for repeated use. Magic-prefixed blobs (e.g. from
      * `zstd --train`) parse as full dictionaries; anything else is raw
      * content. Throws if a magic-prefixed blob is corrupt.
      */
-    constructor(dict: Uint8Array);
+    constructor(dict: Uint8Array | number[]);
     /**
      * The dictionary ID (0 for raw content).
      */
@@ -188,7 +188,7 @@ export class ZstdDictionary {
  * `ZSTD_c_checksumFlag = 0`): pass `true` to append the trailing XXH64 content
  * checksum.
  */
-export function compress(data: Uint8Array, level: number, checksum?: boolean | null): Uint8Array;
+export function compress(data: Uint8Array | number[], level: number, checksum?: boolean | null): Uint8Array;
 
 /**
  * Compress `data` against a raw Zstandard dictionary at compression `level`.
@@ -200,7 +200,7 @@ export function compress(data: Uint8Array, level: number, checksum?: boolean | n
  * `checksum` is optional (default `false`, matching libzstd's
  * `ZSTD_c_checksumFlag = 0`); pass `true` to append the XXH64 trailer.
  */
-export function compressUsingDict(data: Uint8Array, dict: Uint8Array, level: number, checksum?: boolean | null): Uint8Array;
+export function compressUsingDict(data: Uint8Array | number[], dict: Uint8Array | number[], level: number, checksum?: boolean | null): Uint8Array;
 
 /**
  * Decompress a complete Zstandard frame back into its original bytes.
@@ -211,7 +211,7 @@ export function compressUsingDict(data: Uint8Array, dict: Uint8Array, level: num
  * pass `ContentChecksum.Verify` to validate, or `EmitOnly` to compute without
  * erroring on mismatch.
  */
-export function decompress(data: Uint8Array, checksum?: ContentChecksum | null): Uint8Array;
+export function decompress(data: Uint8Array | number[], checksum?: ContentChecksum | null): Uint8Array;
 
 /**
  * Decompress a dictionary-encoded Zstandard frame.
@@ -220,7 +220,7 @@ export function decompress(data: Uint8Array, checksum?: ContentChecksum | null):
  * dictionary the frame was compressed with. Throws on a malformed frame or a
  * dictionary mismatch.
  */
-export function decompressUsingDict(data: Uint8Array, dict: Uint8Array, checksum?: ContentChecksum | null): Uint8Array;
+export function decompressUsingDict(data: Uint8Array | number[], dict: Uint8Array | number[], checksum?: ContentChecksum | null): Uint8Array;
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
@@ -251,8 +251,8 @@ export interface InitOutput {
     readonly zstddictionary_new: (a: number, b: number) => [number, number, number];
     readonly __wbindgen_externrefs: WebAssembly.Table;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
-    readonly __externref_table_dealloc: (a: number) => void;
     readonly __wbindgen_free: (a: number, b: number, c: number) => void;
+    readonly __externref_table_dealloc: (a: number) => void;
     readonly __wbindgen_start: () => void;
 }
 

package/scalar/structured_zstd_wasm.js

@@ -80,7 +80,7 @@ export class ZstdCompressStream {
     /**
      * Feed more plaintext; returns whatever compressed bytes are now complete
      * (possibly empty while the current block is still filling).
-     * @param {Uint8Array} chunk
+     * @param {Uint8Array | number[]} chunk
      * @returns {Uint8Array}
      */
     push(chunk) {
@@ -103,14 +103,15 @@ export class ZstdCompressStream {
      * opened via its matching `withDictionary` constructor (or the one-shot
      * `decompressUsingDict`). Throws if the dictionary is invalid.
      * @param {number} level
-     * @param {Uint8Array} dict
+     * @param {Uint8Array | number[]} dict
      * @param {boolean | null} [checksum]
      * @returns {ZstdCompressStream}
      */
     static withDictionary(level, dict, checksum) {
+        const val2 = +level;
         const ptr0 = passArray8ToWasm0(dict, wasm.__wbindgen_malloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.zstdcompressstream_withDictionary(level, ptr0, len0, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
+        const ret = wasm.zstdcompressstream_withDictionary(val2, ptr0, len0, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }
@@ -202,7 +203,7 @@ export class ZstdDecompressStream {
     /**
      * Feed more compressed bytes; returns whatever decompressed output is now
      * available (possibly empty while a block is still incomplete).
-     * @param {Uint8Array} chunk
+     * @param {Uint8Array | number[]} chunk
      * @returns {Uint8Array}
      */
     push(chunk) {
@@ -231,14 +232,15 @@ export class ZstdDecompressStream {
      * frame was compressed with (e.g. via [`ZstdCompressStream`]'s
      * `withDictionary`). `checksum` behaves as in [`Self::new`]. Throws if the
      * dictionary is malformed.
-     * @param {Uint8Array} dict
+     * @param {Uint8Array | number[]} dict
      * @param {ContentChecksum | null} [checksum]
      * @returns {ZstdDecompressStream}
      */
     static withDictionary(dict, checksum) {
+        const val2 = +(isLikeNone(checksum) ? 3 : checksum);
         const ptr0 = passArray8ToWasm0(dict, wasm.__wbindgen_malloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.zstddecompressstream_withDictionary(ptr0, len0, isLikeNone(checksum) ? 3 : checksum);
+        const ret = wasm.zstddecompressstream_withDictionary(ptr0, len0, val2);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }
@@ -299,40 +301,42 @@ export class ZstdDictionary {
      * every following call reuses that primed snapshot.
      *
      * `checksum` is optional (default `false`).
-     * @param {Uint8Array} data
+     * @param {Uint8Array | number[]} data
      * @param {number} level
      * @param {boolean | null} [checksum]
      * @returns {Uint8Array}
      */
     compress(data, level, checksum) {
+        const val2 = +level;
         const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.zstddictionary_compress(this.__wbg_ptr, ptr0, len0, level, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
+        const ret = wasm.zstddictionary_compress(this.__wbg_ptr, ptr0, len0, val2, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
         if (ret[3]) {
             throw takeFromExternrefTable0(ret[2]);
         }
-        var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
         wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-        return v2;
+        return v3;
     }
     /**
      * Decompress a frame produced with this dictionary, reusing the
      * prepared tables and one decoder workspace across calls. `checksum`
      * behaves as in the module-level `decompress`.
-     * @param {Uint8Array} data
+     * @param {Uint8Array | number[]} data
      * @param {ContentChecksum | null} [checksum]
      * @returns {Uint8Array}
      */
     decompress(data, checksum) {
+        const val2 = +(isLikeNone(checksum) ? 3 : checksum);
         const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.zstddictionary_decompress(this.__wbg_ptr, ptr0, len0, isLikeNone(checksum) ? 3 : checksum);
+        const ret = wasm.zstddictionary_decompress(this.__wbg_ptr, ptr0, len0, val2);
         if (ret[3]) {
             throw takeFromExternrefTable0(ret[2]);
         }
-        var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
         wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-        return v2;
+        return v3;
     }
     /**
      * The dictionary ID (0 for raw content).
@@ -346,7 +350,7 @@ export class ZstdDictionary {
      * Parse `dict` once for repeated use. Magic-prefixed blobs (e.g. from
      * `zstd --train`) parse as full dictionaries; anything else is raw
      * content. Throws if a magic-prefixed blob is corrupt.
-     * @param {Uint8Array} dict
+     * @param {Uint8Array | number[]} dict
      */
     constructor(dict) {
         const ptr0 = passArray8ToWasm0(dict, wasm.__wbindgen_malloc);
@@ -372,18 +376,19 @@ if (Symbol.dispose) ZstdDictionary.prototype[Symbol.dispose] = ZstdDictionary.pr
  * `checksum` is optional (default `false`, matching libzstd's
  * `ZSTD_c_checksumFlag = 0`): pass `true` to append the trailing XXH64 content
  * checksum.
- * @param {Uint8Array} data
+ * @param {Uint8Array | number[]} data
  * @param {number} level
  * @param {boolean | null} [checksum]
  * @returns {Uint8Array}
  */
 export function compress(data, level, checksum) {
+    const val2 = +level;
     const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.compress(ptr0, len0, level, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
-    var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    const ret = wasm.compress(ptr0, len0, val2, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
+    var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
     wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-    return v2;
+    return v3;
 }
 
 /**
@@ -395,24 +400,32 @@ export function compress(data, level, checksum) {
  *
  * `checksum` is optional (default `false`, matching libzstd's
  * `ZSTD_c_checksumFlag = 0`); pass `true` to append the XXH64 trailer.
- * @param {Uint8Array} data
- * @param {Uint8Array} dict
+ * @param {Uint8Array | number[]} data
+ * @param {Uint8Array | number[]} dict
  * @param {number} level
  * @param {boolean | null} [checksum]
  * @returns {Uint8Array}
  */
 export function compressUsingDict(data, dict, level, checksum) {
-    const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
-    const len0 = WASM_VECTOR_LEN;
-    const ptr1 = passArray8ToWasm0(dict, wasm.__wbindgen_malloc);
-    const len1 = WASM_VECTOR_LEN;
-    const ret = wasm.compressUsingDict(ptr0, len0, ptr1, len1, level, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
+    const val3 = +level;
+    let ptr0, len0, ptr1, len1;
+    try {
+        ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
+        len0 = WASM_VECTOR_LEN;
+        ptr1 = passArray8ToWasm0(dict, wasm.__wbindgen_malloc);
+        len1 = WASM_VECTOR_LEN;
+    } catch (e) {
+        if (ptr1) { wasm.__wbindgen_free(ptr1, len1 * 1, 1); }
+        if (ptr0) { wasm.__wbindgen_free(ptr0, len0 * 1, 1); }
+        throw e;
+    }
+    const ret = wasm.compressUsingDict(ptr0, len0, ptr1, len1, val3, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
     if (ret[3]) {
         throw takeFromExternrefTable0(ret[2]);
     }
-    var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    var v4 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
     wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-    return v3;
+    return v4;
 }
 
 /**
@@ -423,20 +436,21 @@ export function compressUsingDict(data, dict, level, checksum) {
  * `checksum` is optional (default `None` — skip the XXH64 pass for speed);
  * pass `ContentChecksum.Verify` to validate, or `EmitOnly` to compute without
  * erroring on mismatch.
- * @param {Uint8Array} data
+ * @param {Uint8Array | number[]} data
  * @param {ContentChecksum | null} [checksum]
  * @returns {Uint8Array}
  */
 export function decompress(data, checksum) {
+    const val2 = +(isLikeNone(checksum) ? 3 : checksum);
     const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.decompress(ptr0, len0, isLikeNone(checksum) ? 3 : checksum);
+    const ret = wasm.decompress(ptr0, len0, val2);
     if (ret[3]) {
         throw takeFromExternrefTable0(ret[2]);
     }
-    var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
     wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-    return v2;
+    return v3;
 }
 
 /**
@@ -445,42 +459,49 @@ export function decompress(data, checksum) {
  * Mirrors C `ZSTD_decompress_usingDict`: `dict` must be the same raw
  * dictionary the frame was compressed with. Throws on a malformed frame or a
  * dictionary mismatch.
- * @param {Uint8Array} data
- * @param {Uint8Array} dict
+ * @param {Uint8Array | number[]} data
+ * @param {Uint8Array | number[]} dict
  * @param {ContentChecksum | null} [checksum]
  * @returns {Uint8Array}
  */
 export function decompressUsingDict(data, dict, checksum) {
-    const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
-    const len0 = WASM_VECTOR_LEN;
-    const ptr1 = passArray8ToWasm0(dict, wasm.__wbindgen_malloc);
-    const len1 = WASM_VECTOR_LEN;
-    const ret = wasm.decompressUsingDict(ptr0, len0, ptr1, len1, isLikeNone(checksum) ? 3 : checksum);
+    const val3 = +(isLikeNone(checksum) ? 3 : checksum);
+    let ptr0, len0, ptr1, len1;
+    try {
+        ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
+        len0 = WASM_VECTOR_LEN;
+        ptr1 = passArray8ToWasm0(dict, wasm.__wbindgen_malloc);
+        len1 = WASM_VECTOR_LEN;
+    } catch (e) {
+        if (ptr1) { wasm.__wbindgen_free(ptr1, len1 * 1, 1); }
+        if (ptr0) { wasm.__wbindgen_free(ptr0, len0 * 1, 1); }
+        throw e;
+    }
+    const ret = wasm.decompressUsingDict(ptr0, len0, ptr1, len1, val3);
     if (ret[3]) {
         throw takeFromExternrefTable0(ret[2]);
     }
-    var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    var v4 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
     wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-    return v3;
+    return v4;
 }
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg_Error_30c8987f7c2ed4e2: function(arg0, arg1) {
+        __wbg_Error_208446807d0d1e30: function(arg0, arg1) {
             const ret = Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
-        __wbg___wbindgen_throw_41e9ee4f547fc59a: function(arg0, arg1) {
+        __wbg___wbindgen_throw_4c88d8bf264fd984: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
         __wbindgen_init_externref_table: function() {
             const table = wasm.__wbindgen_externrefs;
-            const offset = table.grow(4);
             table.set(0, undefined);
-            table.set(offset + 0, undefined);
-            table.set(offset + 1, null);
-            table.set(offset + 2, true);
-            table.set(offset + 3, false);
+            table.set(1024, undefined);
+            table.set(1025, null);
+            table.set(1026, true);
+            table.set(1027, false);
         },
     };
     return {
@@ -511,7 +532,8 @@ function getArrayU8FromWasm0(ptr, len) {
 }
 
 function getStringFromWasm0(ptr, len) {
-    return decodeText(ptr >>> 0, len);
+    ptr = ptr >>> 0;
+    return decodeText(getUint8ArrayMemory0().subarray(ptr, ptr + len));
 }
 
 let cachedUint8ArrayMemory0 = null;
@@ -539,18 +561,18 @@ function takeFromExternrefTable0(idx) {
     return value;
 }
 
-let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true });
 cachedTextDecoder.decode();
 const MAX_SAFARI_DECODE_BYTES = 2146435072;
 let numBytesDecoded = 0;
-function decodeText(ptr, len) {
-    numBytesDecoded += len;
+function decodeText(bytes) {
+    numBytesDecoded += bytes.length;
     if (numBytesDecoded >= MAX_SAFARI_DECODE_BYTES) {
-        cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+        cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true });
         cachedTextDecoder.decode();
-        numBytesDecoded = len;
+        numBytesDecoded = bytes.length;
     }
-    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+    return cachedTextDecoder.decode(bytes);
 }
 
 let WASM_VECTOR_LEN = 0;
@@ -624,9 +646,17 @@ function initSync(module) {
     return __wbg_finalize_init(instance, module);
 }
 
+let __wbg_init_promise;
 async function __wbg_init(module_or_path) {
     if (wasm !== undefined) return wasm;
+    if (__wbg_init_promise === undefined) {
+        __wbg_init_promise = __wbg_init_once(module_or_path);
+        __wbg_init_promise.catch(() => { __wbg_init_promise = undefined; });
+    }
+    return __wbg_init_promise;
+}
 
+async function __wbg_init_once(module_or_path) {
 
     if (module_or_path !== undefined) {
         if (Object.getPrototypeOf(module_or_path) === Object.prototype) {

package/scalar/structured_zstd_wasm_bg.wasm.d.ts

@@ -26,6 +26,6 @@ export const zstddictionary_id: (a: number) => number;
 export const zstddictionary_new: (a: number, b: number) => [number, number, number];
 export const __wbindgen_externrefs: WebAssembly.Table;
 export const __wbindgen_malloc: (a: number, b: number) => number;
-export const __externref_table_dealloc: (a: number) => void;
 export const __wbindgen_free: (a: number, b: number, c: number) => void;
+export const __externref_table_dealloc: (a: number) => void;
 export const __wbindgen_start: () => void;

package/simd/structured_zstd_wasm.d.ts

@@ -51,7 +51,7 @@ export class ZstdCompressStream {
      * Feed more plaintext; returns whatever compressed bytes are now complete
      * (possibly empty while the current block is still filling).
      */
-    push(chunk: Uint8Array): Uint8Array;
+    push(chunk: Uint8Array | number[]): Uint8Array;
     /**
      * Open a streaming compressor at `level` seeded with a raw zstd dictionary
      * blob (e.g. from `zstd --train`), mirroring `ZSTD_CCtx_loadDictionary` on
@@ -61,7 +61,7 @@ export class ZstdCompressStream {
      * opened via its matching `withDictionary` constructor (or the one-shot
      * `decompressUsingDict`). Throws if the dictionary is invalid.
      */
-    static withDictionary(level: number, dict: Uint8Array, checksum?: boolean | null): ZstdCompressStream;
+    static withDictionary(level: number, dict: Uint8Array | number[], checksum?: boolean | null): ZstdCompressStream;
     /**
      * Open a streaming compressor at `level` seeded from a [`ZstdDictionary`]
      * prepared once: per-stream setup copies the prepared tables instead of
@@ -104,7 +104,7 @@ export class ZstdDecompressStream {
      * Feed more compressed bytes; returns whatever decompressed output is now
      * available (possibly empty while a block is still incomplete).
      */
-    push(chunk: Uint8Array): Uint8Array;
+    push(chunk: Uint8Array | number[]): Uint8Array;
     /**
      * The content checksum stored in the frame's 4-byte trailer, or
      * `undefined` if the frame carried none. Meaningful after [`Self::finish`].
@@ -117,7 +117,7 @@ export class ZstdDecompressStream {
      * `withDictionary`). `checksum` behaves as in [`Self::new`]. Throws if the
      * dictionary is malformed.
      */
-    static withDictionary(dict: Uint8Array, checksum?: ContentChecksum | null): ZstdDecompressStream;
+    static withDictionary(dict: Uint8Array | number[], checksum?: ContentChecksum | null): ZstdDecompressStream;
     /**
      * Open a streaming decompressor against a [`ZstdDictionary`] prepared
      * once: per-stream setup is a reference-count bump, no dictionary
@@ -158,19 +158,19 @@ export class ZstdDictionary {
      *
      * `checksum` is optional (default `false`).
      */
-    compress(data: Uint8Array, level: number, checksum?: boolean | null): Uint8Array;
+    compress(data: Uint8Array | number[], level: number, checksum?: boolean | null): Uint8Array;
     /**
      * Decompress a frame produced with this dictionary, reusing the
      * prepared tables and one decoder workspace across calls. `checksum`
      * behaves as in the module-level `decompress`.
      */
-    decompress(data: Uint8Array, checksum?: ContentChecksum | null): Uint8Array;
+    decompress(data: Uint8Array | number[], checksum?: ContentChecksum | null): Uint8Array;
     /**
      * Parse `dict` once for repeated use. Magic-prefixed blobs (e.g. from
      * `zstd --train`) parse as full dictionaries; anything else is raw
      * content. Throws if a magic-prefixed blob is corrupt.
      */
-    constructor(dict: Uint8Array);
+    constructor(dict: Uint8Array | number[]);
     /**
      * The dictionary ID (0 for raw content).
      */
@@ -188,7 +188,7 @@ export class ZstdDictionary {
  * `ZSTD_c_checksumFlag = 0`): pass `true` to append the trailing XXH64 content
  * checksum.
  */
-export function compress(data: Uint8Array, level: number, checksum?: boolean | null): Uint8Array;
+export function compress(data: Uint8Array | number[], level: number, checksum?: boolean | null): Uint8Array;
 
 /**
  * Compress `data` against a raw Zstandard dictionary at compression `level`.
@@ -200,7 +200,7 @@ export function compress(data: Uint8Array, level: number, checksum?: boolean | n
  * `checksum` is optional (default `false`, matching libzstd's
  * `ZSTD_c_checksumFlag = 0`); pass `true` to append the XXH64 trailer.
  */
-export function compressUsingDict(data: Uint8Array, dict: Uint8Array, level: number, checksum?: boolean | null): Uint8Array;
+export function compressUsingDict(data: Uint8Array | number[], dict: Uint8Array | number[], level: number, checksum?: boolean | null): Uint8Array;
 
 /**
  * Decompress a complete Zstandard frame back into its original bytes.
@@ -211,7 +211,7 @@ export function compressUsingDict(data: Uint8Array, dict: Uint8Array, level: num
  * pass `ContentChecksum.Verify` to validate, or `EmitOnly` to compute without
  * erroring on mismatch.
  */
-export function decompress(data: Uint8Array, checksum?: ContentChecksum | null): Uint8Array;
+export function decompress(data: Uint8Array | number[], checksum?: ContentChecksum | null): Uint8Array;
 
 /**
  * Decompress a dictionary-encoded Zstandard frame.
@@ -220,7 +220,7 @@ export function decompress(data: Uint8Array, checksum?: ContentChecksum | null):
  * dictionary the frame was compressed with. Throws on a malformed frame or a
  * dictionary mismatch.
  */
-export function decompressUsingDict(data: Uint8Array, dict: Uint8Array, checksum?: ContentChecksum | null): Uint8Array;
+export function decompressUsingDict(data: Uint8Array | number[], dict: Uint8Array | number[], checksum?: ContentChecksum | null): Uint8Array;
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
@@ -251,8 +251,8 @@ export interface InitOutput {
     readonly zstddictionary_new: (a: number, b: number) => [number, number, number];
     readonly __wbindgen_externrefs: WebAssembly.Table;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
-    readonly __externref_table_dealloc: (a: number) => void;
     readonly __wbindgen_free: (a: number, b: number, c: number) => void;
+    readonly __externref_table_dealloc: (a: number) => void;
     readonly __wbindgen_start: () => void;
 }
 

package/simd/structured_zstd_wasm.js

@@ -80,7 +80,7 @@ export class ZstdCompressStream {
     /**
      * Feed more plaintext; returns whatever compressed bytes are now complete
      * (possibly empty while the current block is still filling).
-     * @param {Uint8Array} chunk
+     * @param {Uint8Array | number[]} chunk
      * @returns {Uint8Array}
      */
     push(chunk) {
@@ -103,14 +103,15 @@ export class ZstdCompressStream {
      * opened via its matching `withDictionary` constructor (or the one-shot
      * `decompressUsingDict`). Throws if the dictionary is invalid.
      * @param {number} level
-     * @param {Uint8Array} dict
+     * @param {Uint8Array | number[]} dict
      * @param {boolean | null} [checksum]
      * @returns {ZstdCompressStream}
      */
     static withDictionary(level, dict, checksum) {
+        const val2 = +level;
         const ptr0 = passArray8ToWasm0(dict, wasm.__wbindgen_malloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.zstdcompressstream_withDictionary(level, ptr0, len0, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
+        const ret = wasm.zstdcompressstream_withDictionary(val2, ptr0, len0, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }
@@ -202,7 +203,7 @@ export class ZstdDecompressStream {
     /**
      * Feed more compressed bytes; returns whatever decompressed output is now
      * available (possibly empty while a block is still incomplete).
-     * @param {Uint8Array} chunk
+     * @param {Uint8Array | number[]} chunk
      * @returns {Uint8Array}
      */
     push(chunk) {
@@ -231,14 +232,15 @@ export class ZstdDecompressStream {
      * frame was compressed with (e.g. via [`ZstdCompressStream`]'s
      * `withDictionary`). `checksum` behaves as in [`Self::new`]. Throws if the
      * dictionary is malformed.
-     * @param {Uint8Array} dict
+     * @param {Uint8Array | number[]} dict
      * @param {ContentChecksum | null} [checksum]
      * @returns {ZstdDecompressStream}
      */
     static withDictionary(dict, checksum) {
+        const val2 = +(isLikeNone(checksum) ? 3 : checksum);
         const ptr0 = passArray8ToWasm0(dict, wasm.__wbindgen_malloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.zstddecompressstream_withDictionary(ptr0, len0, isLikeNone(checksum) ? 3 : checksum);
+        const ret = wasm.zstddecompressstream_withDictionary(ptr0, len0, val2);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }
@@ -299,40 +301,42 @@ export class ZstdDictionary {
      * every following call reuses that primed snapshot.
      *
      * `checksum` is optional (default `false`).
-     * @param {Uint8Array} data
+     * @param {Uint8Array | number[]} data
      * @param {number} level
      * @param {boolean | null} [checksum]
      * @returns {Uint8Array}
      */
     compress(data, level, checksum) {
+        const val2 = +level;
         const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.zstddictionary_compress(this.__wbg_ptr, ptr0, len0, level, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
+        const ret = wasm.zstddictionary_compress(this.__wbg_ptr, ptr0, len0, val2, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
         if (ret[3]) {
             throw takeFromExternrefTable0(ret[2]);
         }
-        var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
         wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-        return v2;
+        return v3;
     }
     /**
      * Decompress a frame produced with this dictionary, reusing the
      * prepared tables and one decoder workspace across calls. `checksum`
      * behaves as in the module-level `decompress`.
-     * @param {Uint8Array} data
+     * @param {Uint8Array | number[]} data
      * @param {ContentChecksum | null} [checksum]
      * @returns {Uint8Array}
      */
     decompress(data, checksum) {
+        const val2 = +(isLikeNone(checksum) ? 3 : checksum);
         const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
         const len0 = WASM_VECTOR_LEN;
-        const ret = wasm.zstddictionary_decompress(this.__wbg_ptr, ptr0, len0, isLikeNone(checksum) ? 3 : checksum);
+        const ret = wasm.zstddictionary_decompress(this.__wbg_ptr, ptr0, len0, val2);
         if (ret[3]) {
             throw takeFromExternrefTable0(ret[2]);
         }
-        var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
         wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-        return v2;
+        return v3;
     }
     /**
      * The dictionary ID (0 for raw content).
@@ -346,7 +350,7 @@ export class ZstdDictionary {
      * Parse `dict` once for repeated use. Magic-prefixed blobs (e.g. from
      * `zstd --train`) parse as full dictionaries; anything else is raw
      * content. Throws if a magic-prefixed blob is corrupt.
-     * @param {Uint8Array} dict
+     * @param {Uint8Array | number[]} dict
      */
     constructor(dict) {
         const ptr0 = passArray8ToWasm0(dict, wasm.__wbindgen_malloc);
@@ -372,18 +376,19 @@ if (Symbol.dispose) ZstdDictionary.prototype[Symbol.dispose] = ZstdDictionary.pr
  * `checksum` is optional (default `false`, matching libzstd's
  * `ZSTD_c_checksumFlag = 0`): pass `true` to append the trailing XXH64 content
  * checksum.
- * @param {Uint8Array} data
+ * @param {Uint8Array | number[]} data
  * @param {number} level
  * @param {boolean | null} [checksum]
  * @returns {Uint8Array}
  */
 export function compress(data, level, checksum) {
+    const val2 = +level;
     const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.compress(ptr0, len0, level, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
-    var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    const ret = wasm.compress(ptr0, len0, val2, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
+    var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
     wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-    return v2;
+    return v3;
 }
 
 /**
@@ -395,24 +400,32 @@ export function compress(data, level, checksum) {
  *
  * `checksum` is optional (default `false`, matching libzstd's
  * `ZSTD_c_checksumFlag = 0`); pass `true` to append the XXH64 trailer.
- * @param {Uint8Array} data
- * @param {Uint8Array} dict
+ * @param {Uint8Array | number[]} data
+ * @param {Uint8Array | number[]} dict
  * @param {number} level
  * @param {boolean | null} [checksum]
  * @returns {Uint8Array}
  */
 export function compressUsingDict(data, dict, level, checksum) {
-    const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
-    const len0 = WASM_VECTOR_LEN;
-    const ptr1 = passArray8ToWasm0(dict, wasm.__wbindgen_malloc);
-    const len1 = WASM_VECTOR_LEN;
-    const ret = wasm.compressUsingDict(ptr0, len0, ptr1, len1, level, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
+    const val3 = +level;
+    let ptr0, len0, ptr1, len1;
+    try {
+        ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
+        len0 = WASM_VECTOR_LEN;
+        ptr1 = passArray8ToWasm0(dict, wasm.__wbindgen_malloc);
+        len1 = WASM_VECTOR_LEN;
+    } catch (e) {
+        if (ptr1) { wasm.__wbindgen_free(ptr1, len1 * 1, 1); }
+        if (ptr0) { wasm.__wbindgen_free(ptr0, len0 * 1, 1); }
+        throw e;
+    }
+    const ret = wasm.compressUsingDict(ptr0, len0, ptr1, len1, val3, isLikeNone(checksum) ? 0xFFFFFF : checksum ? 1 : 0);
     if (ret[3]) {
         throw takeFromExternrefTable0(ret[2]);
     }
-    var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    var v4 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
     wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-    return v3;
+    return v4;
 }
 
 /**
@@ -423,20 +436,21 @@ export function compressUsingDict(data, dict, level, checksum) {
  * `checksum` is optional (default `None` — skip the XXH64 pass for speed);
  * pass `ContentChecksum.Verify` to validate, or `EmitOnly` to compute without
  * erroring on mismatch.
- * @param {Uint8Array} data
+ * @param {Uint8Array | number[]} data
  * @param {ContentChecksum | null} [checksum]
  * @returns {Uint8Array}
  */
 export function decompress(data, checksum) {
+    const val2 = +(isLikeNone(checksum) ? 3 : checksum);
     const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
     const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.decompress(ptr0, len0, isLikeNone(checksum) ? 3 : checksum);
+    const ret = wasm.decompress(ptr0, len0, val2);
     if (ret[3]) {
         throw takeFromExternrefTable0(ret[2]);
     }
-    var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
     wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-    return v2;
+    return v3;
 }
 
 /**
@@ -445,42 +459,49 @@ export function decompress(data, checksum) {
  * Mirrors C `ZSTD_decompress_usingDict`: `dict` must be the same raw
  * dictionary the frame was compressed with. Throws on a malformed frame or a
  * dictionary mismatch.
- * @param {Uint8Array} data
- * @param {Uint8Array} dict
+ * @param {Uint8Array | number[]} data
+ * @param {Uint8Array | number[]} dict
  * @param {ContentChecksum | null} [checksum]
  * @returns {Uint8Array}
  */
 export function decompressUsingDict(data, dict, checksum) {
-    const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
-    const len0 = WASM_VECTOR_LEN;
-    const ptr1 = passArray8ToWasm0(dict, wasm.__wbindgen_malloc);
-    const len1 = WASM_VECTOR_LEN;
-    const ret = wasm.decompressUsingDict(ptr0, len0, ptr1, len1, isLikeNone(checksum) ? 3 : checksum);
+    const val3 = +(isLikeNone(checksum) ? 3 : checksum);
+    let ptr0, len0, ptr1, len1;
+    try {
+        ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_malloc);
+        len0 = WASM_VECTOR_LEN;
+        ptr1 = passArray8ToWasm0(dict, wasm.__wbindgen_malloc);
+        len1 = WASM_VECTOR_LEN;
+    } catch (e) {
+        if (ptr1) { wasm.__wbindgen_free(ptr1, len1 * 1, 1); }
+        if (ptr0) { wasm.__wbindgen_free(ptr0, len0 * 1, 1); }
+        throw e;
+    }
+    const ret = wasm.decompressUsingDict(ptr0, len0, ptr1, len1, val3);
     if (ret[3]) {
         throw takeFromExternrefTable0(ret[2]);
     }
-    var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    var v4 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
     wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
-    return v3;
+    return v4;
 }
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg_Error_30c8987f7c2ed4e2: function(arg0, arg1) {
+        __wbg_Error_208446807d0d1e30: function(arg0, arg1) {
             const ret = Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
-        __wbg___wbindgen_throw_41e9ee4f547fc59a: function(arg0, arg1) {
+        __wbg___wbindgen_throw_4c88d8bf264fd984: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
         __wbindgen_init_externref_table: function() {
             const table = wasm.__wbindgen_externrefs;
-            const offset = table.grow(4);
             table.set(0, undefined);
-            table.set(offset + 0, undefined);
-            table.set(offset + 1, null);
-            table.set(offset + 2, true);
-            table.set(offset + 3, false);
+            table.set(1024, undefined);
+            table.set(1025, null);
+            table.set(1026, true);
+            table.set(1027, false);
         },
     };
     return {
@@ -511,7 +532,8 @@ function getArrayU8FromWasm0(ptr, len) {
 }
 
 function getStringFromWasm0(ptr, len) {
-    return decodeText(ptr >>> 0, len);
+    ptr = ptr >>> 0;
+    return decodeText(getUint8ArrayMemory0().subarray(ptr, ptr + len));
 }
 
 let cachedUint8ArrayMemory0 = null;
@@ -539,18 +561,18 @@ function takeFromExternrefTable0(idx) {
     return value;
 }
 
-let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true });
 cachedTextDecoder.decode();
 const MAX_SAFARI_DECODE_BYTES = 2146435072;
 let numBytesDecoded = 0;
-function decodeText(ptr, len) {
-    numBytesDecoded += len;
+function decodeText(bytes) {
+    numBytesDecoded += bytes.length;
     if (numBytesDecoded >= MAX_SAFARI_DECODE_BYTES) {
-        cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+        cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true });
         cachedTextDecoder.decode();
-        numBytesDecoded = len;
+        numBytesDecoded = bytes.length;
     }
-    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+    return cachedTextDecoder.decode(bytes);
 }
 
 let WASM_VECTOR_LEN = 0;
@@ -624,9 +646,17 @@ function initSync(module) {
     return __wbg_finalize_init(instance, module);
 }
 
+let __wbg_init_promise;
 async function __wbg_init(module_or_path) {
     if (wasm !== undefined) return wasm;
+    if (__wbg_init_promise === undefined) {
+        __wbg_init_promise = __wbg_init_once(module_or_path);
+        __wbg_init_promise.catch(() => { __wbg_init_promise = undefined; });
+    }
+    return __wbg_init_promise;
+}
 
+async function __wbg_init_once(module_or_path) {
 
     if (module_or_path !== undefined) {
         if (Object.getPrototypeOf(module_or_path) === Object.prototype) {

package/simd/structured_zstd_wasm_bg.wasm.d.ts

@@ -26,6 +26,6 @@ export const zstddictionary_id: (a: number) => number;
 export const zstddictionary_new: (a: number, b: number) => [number, number, number];
 export const __wbindgen_externrefs: WebAssembly.Table;
 export const __wbindgen_malloc: (a: number, b: number) => number;
-export const __externref_table_dealloc: (a: number) => void;
 export const __wbindgen_free: (a: number, b: number, c: number) => void;
+export const __externref_table_dealloc: (a: number) => void;
 export const __wbindgen_start: () => void;