@iscc/wasm 0.0.4 → 0.2.0

package/README.md

@@ -4,9 +4,6 @@
 [![npm](https://img.shields.io/npm/v/@iscc/wasm.svg)](https://www.npmjs.com/package/@iscc/wasm)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-> **Experimental:** This library is in early development (v0.0.x). APIs may change without notice.
-> Not recommended for production use yet.
-
 Browser-compatible WebAssembly bindings for
 [ISO 24138:2024](https://www.iso.org/standard/77899.html) -- International Standard Content Code
 (ISCC). Built with Rust and [wasm-bindgen](https://rustwasm.github.io/wasm-bindgen/) for use in

package/iscc_wasm.d.ts

@@ -128,6 +128,14 @@ export class WasmSumCodeResult {
      * Composite ISCC-CODE string (e.g., `"ISCC:KAC..."`).
      */
     iscc: string;
+    /**
+     * Data-Code and Instance-Code ISCC strings (when `add_units` is true).
+     */
+    get units(): string[] | undefined;
+    /**
+     * Data-Code and Instance-Code ISCC strings (when `add_units` is true).
+     */
+    set units(value: string[] | null | undefined);
 }
 
 /**
@@ -156,6 +164,13 @@ export function alg_minhash_256(features: Uint32Array): Uint8Array;
  */
 export function alg_simhash(hash_digests: any): Uint8Array;
 
+/**
+ * Run all conformance tests against vendored test vectors.
+ *
+ * Returns `true` if all tests pass, `false` if any fail.
+ */
+export function conformance_selftest(): boolean;
+
 /**
  * Encode bytes as base64url (RFC 4648 §5, no padding).
  *
@@ -233,8 +248,11 @@ export function gen_mixed_code_v0(codes: any, bits?: number | null): string;
  * Feeds both `DataHasher` (CDC/MinHash) and `InstanceHasher` (BLAKE3) from
  * the same byte slice, then composes the final ISCC-CODE via
  * `gen_iscc_code_v0`. WASM-compatible alternative to the file-based core API.
+ *
+ * When `add_units` is `true`, the result includes the individual Data-Code
+ * and Instance-Code ISCC strings.
  */
-export function gen_sum_code_v0(data: Uint8Array, bits?: number | null, wide?: boolean | null): WasmSumCodeResult;
+export function gen_sum_code_v0(data: Uint8Array, bits?: number | null, wide?: boolean | null, add_units?: boolean | null): WasmSumCodeResult;
 
 /**
  * Generate a Text-Code from plain text content.
@@ -344,6 +362,7 @@ export interface InitOutput {
     readonly __wbg_get_wasmsumcoderesult_datahash: (a: number, b: number) => void;
     readonly __wbg_get_wasmsumcoderesult_filesize: (a: number) => number;
     readonly __wbg_get_wasmsumcoderesult_iscc: (a: number, b: number) => void;
+    readonly __wbg_get_wasmsumcoderesult_units: (a: number, b: number) => void;
     readonly __wbg_instancehasher_free: (a: number, b: number) => void;
     readonly __wbg_isccdecoderesult_free: (a: number, b: number) => void;
     readonly __wbg_set_isccdecoderesult_digest: (a: number, b: number, c: number) => void;
@@ -354,10 +373,12 @@ export interface InitOutput {
     readonly __wbg_set_wasmsumcoderesult_datahash: (a: number, b: number, c: number) => void;
     readonly __wbg_set_wasmsumcoderesult_filesize: (a: number, b: number) => void;
     readonly __wbg_set_wasmsumcoderesult_iscc: (a: number, b: number, c: number) => void;
+    readonly __wbg_set_wasmsumcoderesult_units: (a: number, b: number, c: number) => void;
     readonly __wbg_wasmsumcoderesult_free: (a: number, b: number) => void;
     readonly alg_cdc_chunks: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly alg_minhash_256: (a: number, b: number, c: number) => void;
     readonly alg_simhash: (a: number, b: number) => void;
+    readonly conformance_selftest: () => number;
     readonly datahasher_finalize: (a: number, b: number, c: number) => void;
     readonly datahasher_new: () => number;
     readonly datahasher_update: (a: number, b: number, c: number, d: number) => void;
@@ -370,7 +391,7 @@ export interface InitOutput {
     readonly gen_iscc_code_v0: (a: number, b: number, c: number) => void;
     readonly gen_meta_code_v0: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
     readonly gen_mixed_code_v0: (a: number, b: number, c: number) => void;
-    readonly gen_sum_code_v0: (a: number, b: number, c: number, d: number, e: number) => void;
+    readonly gen_sum_code_v0: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
     readonly gen_text_code_v0: (a: number, b: number, c: number, d: number) => void;
     readonly gen_video_code_v0: (a: number, b: number, c: number) => void;
     readonly instancehasher_finalize: (a: number, b: number, c: number) => void;

package/iscc_wasm.js

@@ -386,6 +386,26 @@ export class WasmSumCodeResult {
             wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
         }
     }
+    /**
+     * Data-Code and Instance-Code ISCC strings (when `add_units` is true).
+     * @returns {string[] | undefined}
+     */
+    get units() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.__wbg_get_wasmsumcoderesult_units(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            let v1;
+            if (r0 !== 0) {
+                v1 = getArrayJsValueFromWasm0(r0, r1).slice();
+                wasm.__wbindgen_export4(r0, r1 * 4, 4);
+            }
+            return v1;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Hex-encoded BLAKE3 multihash (`"1e20..."`) of the data.
      * @param {string} arg0
@@ -411,6 +431,15 @@ export class WasmSumCodeResult {
         const len0 = WASM_VECTOR_LEN;
         wasm.__wbg_set_wasmsumcoderesult_iscc(this.__wbg_ptr, ptr0, len0);
     }
+    /**
+     * Data-Code and Instance-Code ISCC strings (when `add_units` is true).
+     * @param {string[] | null} [arg0]
+     */
+    set units(arg0) {
+        var ptr0 = isLikeNone(arg0) ? 0 : passArrayJsValueToWasm0(arg0, wasm.__wbindgen_export);
+        var len0 = WASM_VECTOR_LEN;
+        wasm.__wbg_set_wasmsumcoderesult_units(this.__wbg_ptr, ptr0, len0);
+    }
 }
 if (Symbol.dispose) WasmSumCodeResult.prototype[Symbol.dispose] = WasmSumCodeResult.prototype.free;
 
@@ -495,6 +524,17 @@ export function alg_simhash(hash_digests) {
     }
 }
 
+/**
+ * Run all conformance tests against vendored test vectors.
+ *
+ * Returns `true` if all tests pass, `false` if any fail.
+ * @returns {boolean}
+ */
+export function conformance_selftest() {
+    const ret = wasm.conformance_selftest();
+    return ret !== 0;
+}
+
 /**
  * Encode bytes as base64url (RFC 4648 §5, no padding).
  *
@@ -820,17 +860,21 @@ export function gen_mixed_code_v0(codes, bits) {
  * Feeds both `DataHasher` (CDC/MinHash) and `InstanceHasher` (BLAKE3) from
  * the same byte slice, then composes the final ISCC-CODE via
  * `gen_iscc_code_v0`. WASM-compatible alternative to the file-based core API.
+ *
+ * When `add_units` is `true`, the result includes the individual Data-Code
+ * and Instance-Code ISCC strings.
  * @param {Uint8Array} data
  * @param {number | null} [bits]
  * @param {boolean | null} [wide]
+ * @param {boolean | null} [add_units]
  * @returns {WasmSumCodeResult}
  */
-export function gen_sum_code_v0(data, bits, wide) {
+export function gen_sum_code_v0(data, bits, wide, add_units) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
         const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_export);
         const len0 = WASM_VECTOR_LEN;
-        wasm.gen_sum_code_v0(retptr, ptr0, len0, isLikeNone(bits) ? 0x100000001 : (bits) >>> 0, isLikeNone(wide) ? 0xFFFFFF : wide ? 1 : 0);
+        wasm.gen_sum_code_v0(retptr, ptr0, len0, isLikeNone(bits) ? 0x100000001 : (bits) >>> 0, isLikeNone(wide) ? 0xFFFFFF : wide ? 1 : 0, isLikeNone(add_units) ? 0xFFFFFF : add_units ? 1 : 0);
         var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
         var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
         var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -1504,6 +1548,16 @@ function passArray8ToWasm0(arg, malloc) {
     return ptr;
 }
 
+function passArrayJsValueToWasm0(array, malloc) {
+    const ptr = malloc(array.length * 4, 4) >>> 0;
+    const mem = getDataViewMemory0();
+    for (let i = 0; i < array.length; i++) {
+        mem.setUint32(ptr + 4 * i, addHeapObject(array[i]), true);
+    }
+    WASM_VECTOR_LEN = array.length;
+    return ptr;
+}
+
 function passStringToWasm0(arg, malloc, realloc) {
     if (realloc === undefined) {
         const buf = cachedTextEncoder.encode(arg);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iscc/wasm",
   "type": "module",
-  "version": "0.0.4",
+  "version": "0.2.0",
   "files": [
     "iscc_wasm_bg.wasm",
     "iscc_wasm.js",