@iscc/wasm 0.0.2 → 0.0.3

package/iscc_wasm.d.ts

@@ -28,6 +28,11 @@ export class DataHasher {
     update(data: Uint8Array): void;
 }
 
+/**
+ * Default read buffer size for streaming I/O (4 MB).
+ */
+export function IO_READ_SIZE(): number;
+
 /**
  * Streaming Instance-Code generator.
  *
@@ -55,6 +60,50 @@ export class InstanceHasher {
     update(data: Uint8Array): void;
 }
 
+/**
+ * Result of decoding an ISCC unit string.
+ */
+export class IsccDecodeResult {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Raw digest bytes truncated to the encoded bit-length.
+     */
+    digest: Uint8Array;
+    /**
+     * Length index from the header.
+     */
+    length: number;
+    /**
+     * MainType enum value (0–7).
+     */
+    maintype: number;
+    /**
+     * SubType enum value (0–7).
+     */
+    subtype: number;
+    /**
+     * Version enum value.
+     */
+    version: number;
+}
+
+/**
+ * Maximum byte length for the description field after trimming.
+ */
+export function META_TRIM_DESCRIPTION(): number;
+
+/**
+ * Maximum byte length for the name field after trimming.
+ */
+export function META_TRIM_NAME(): number;
+
+/**
+ * Sliding window width for text n-gram generation.
+ */
+export function TEXT_NGRAM_SIZE(): number;
+
 /**
  * Split data into content-defined chunks using gear rolling hash.
  *
@@ -88,6 +137,14 @@ export function alg_simhash(hash_digests: any): Uint8Array;
  */
 export function encode_base64(data: Uint8Array): string;
 
+/**
+ * Encode raw ISCC header components and digest into a base32 ISCC unit string.
+ *
+ * Takes integer type identifiers and a raw digest, returns a base32-encoded
+ * ISCC unit string (without "ISCC:" prefix).
+ */
+export function encode_component(mtype: number, stype: number, version: number, bit_length: number, digest: Uint8Array): string;
+
 /**
  * Generate an Audio-Code from a Chromaprint feature vector.
  *
@@ -160,6 +217,14 @@ export function gen_text_code_v0(text: string, bits?: number | null): string;
  */
 export function gen_video_code_v0(frame_sigs: any, bits?: number | null): string;
 
+/**
+ * Decode an ISCC unit string into header components and raw digest.
+ *
+ * Returns an object with `maintype`, `subtype`, `version`, `length`, and
+ * `digest` fields. Strips an optional "ISCC:" prefix before decoding.
+ */
+export function iscc_decode(iscc: string): IsccDecodeResult;
+
 /**
  * Decompose a composite ISCC-CODE into individual ISCC-UNITs.
  *
@@ -169,6 +234,14 @@ export function gen_video_code_v0(frame_sigs: any, bits?: number | null): string
  */
 export function iscc_decompose(iscc_code: string): string[];
 
+/**
+ * Convert a JSON string into a `data:` URL with JCS canonicalization.
+ *
+ * Uses `application/ld+json` media type when the JSON contains an `@context`
+ * key, otherwise `application/json`.
+ */
+export function json_to_data_url(json: string): string;
+
 /**
  * Generate sliding window n-grams from a string.
  *
@@ -222,8 +295,23 @@ export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembl
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
+    readonly IO_READ_SIZE: () => number;
+    readonly META_TRIM_DESCRIPTION: () => number;
+    readonly META_TRIM_NAME: () => number;
+    readonly TEXT_NGRAM_SIZE: () => number;
     readonly __wbg_datahasher_free: (a: number, b: number) => void;
+    readonly __wbg_get_isccdecoderesult_digest: (a: number, b: number) => void;
+    readonly __wbg_get_isccdecoderesult_length: (a: number) => number;
+    readonly __wbg_get_isccdecoderesult_maintype: (a: number) => number;
+    readonly __wbg_get_isccdecoderesult_subtype: (a: number) => number;
+    readonly __wbg_get_isccdecoderesult_version: (a: number) => number;
     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;
+    readonly __wbg_set_isccdecoderesult_length: (a: number, b: number) => void;
+    readonly __wbg_set_isccdecoderesult_maintype: (a: number, b: number) => void;
+    readonly __wbg_set_isccdecoderesult_subtype: (a: number, b: number) => void;
+    readonly __wbg_set_isccdecoderesult_version: (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;
@@ -231,6 +319,7 @@ export interface InitOutput {
     readonly datahasher_new: () => number;
     readonly datahasher_update: (a: number, b: number, c: number, d: number) => void;
     readonly encode_base64: (a: number, b: number, c: number) => void;
+    readonly encode_component: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
     readonly gen_audio_code_v0: (a: number, b: number, c: number, d: number) => void;
     readonly gen_data_code_v0: (a: number, b: number, c: number, d: number) => void;
     readonly gen_image_code_v0: (a: number, b: number, c: number, d: number) => void;
@@ -243,7 +332,9 @@ export interface InitOutput {
     readonly instancehasher_finalize: (a: number, b: number, c: number) => void;
     readonly instancehasher_new: () => number;
     readonly instancehasher_update: (a: number, b: number, c: number, d: number) => void;
+    readonly iscc_decode: (a: number, b: number, c: number) => void;
     readonly iscc_decompose: (a: number, b: number, c: number) => void;
+    readonly json_to_data_url: (a: number, b: number, c: number) => void;
     readonly sliding_window: (a: number, b: number, c: number, d: number) => void;
     readonly soft_hash_video_v0: (a: number, b: number, c: number) => void;
     readonly text_clean: (a: number, b: number, c: number) => void;

package/iscc_wasm.js

@@ -81,6 +81,15 @@ export class DataHasher {
 }
 if (Symbol.dispose) DataHasher.prototype[Symbol.dispose] = DataHasher.prototype.free;
 
+/**
+ * Default read buffer size for streaming I/O (4 MB).
+ * @returns {number}
+ */
+export function IO_READ_SIZE() {
+    const ret = wasm.IO_READ_SIZE();
+    return ret >>> 0;
+}
+
 /**
  * Streaming Instance-Code generator.
  *
@@ -162,6 +171,143 @@ export class InstanceHasher {
 }
 if (Symbol.dispose) InstanceHasher.prototype[Symbol.dispose] = InstanceHasher.prototype.free;
 
+/**
+ * Result of decoding an ISCC unit string.
+ */
+export class IsccDecodeResult {
+    static __wrap(ptr) {
+        ptr = ptr >>> 0;
+        const obj = Object.create(IsccDecodeResult.prototype);
+        obj.__wbg_ptr = ptr;
+        IsccDecodeResultFinalization.register(obj, obj.__wbg_ptr, obj);
+        return obj;
+    }
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        IsccDecodeResultFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_isccdecoderesult_free(ptr, 0);
+    }
+    /**
+     * Raw digest bytes truncated to the encoded bit-length.
+     * @returns {Uint8Array}
+     */
+    get digest() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.__wbg_get_isccdecoderesult_digest(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var v1 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v1;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
+    /**
+     * Length index from the header.
+     * @returns {number}
+     */
+    get length() {
+        const ret = wasm.__wbg_get_isccdecoderesult_length(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * MainType enum value (0–7).
+     * @returns {number}
+     */
+    get maintype() {
+        const ret = wasm.__wbg_get_isccdecoderesult_maintype(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * SubType enum value (0–7).
+     * @returns {number}
+     */
+    get subtype() {
+        const ret = wasm.__wbg_get_isccdecoderesult_subtype(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * Version enum value.
+     * @returns {number}
+     */
+    get version() {
+        const ret = wasm.__wbg_get_isccdecoderesult_version(this.__wbg_ptr);
+        return ret;
+    }
+    /**
+     * Raw digest bytes truncated to the encoded bit-length.
+     * @param {Uint8Array} arg0
+     */
+    set digest(arg0) {
+        const ptr0 = passArray8ToWasm0(arg0, wasm.__wbindgen_export);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.__wbg_set_isccdecoderesult_digest(this.__wbg_ptr, ptr0, len0);
+    }
+    /**
+     * Length index from the header.
+     * @param {number} arg0
+     */
+    set length(arg0) {
+        wasm.__wbg_set_isccdecoderesult_length(this.__wbg_ptr, arg0);
+    }
+    /**
+     * MainType enum value (0–7).
+     * @param {number} arg0
+     */
+    set maintype(arg0) {
+        wasm.__wbg_set_isccdecoderesult_maintype(this.__wbg_ptr, arg0);
+    }
+    /**
+     * SubType enum value (0–7).
+     * @param {number} arg0
+     */
+    set subtype(arg0) {
+        wasm.__wbg_set_isccdecoderesult_subtype(this.__wbg_ptr, arg0);
+    }
+    /**
+     * Version enum value.
+     * @param {number} arg0
+     */
+    set version(arg0) {
+        wasm.__wbg_set_isccdecoderesult_version(this.__wbg_ptr, arg0);
+    }
+}
+if (Symbol.dispose) IsccDecodeResult.prototype[Symbol.dispose] = IsccDecodeResult.prototype.free;
+
+/**
+ * Maximum byte length for the description field after trimming.
+ * @returns {number}
+ */
+export function META_TRIM_DESCRIPTION() {
+    const ret = wasm.META_TRIM_DESCRIPTION();
+    return ret >>> 0;
+}
+
+/**
+ * Maximum byte length for the name field after trimming.
+ * @returns {number}
+ */
+export function META_TRIM_NAME() {
+    const ret = wasm.META_TRIM_NAME();
+    return ret >>> 0;
+}
+
+/**
+ * Sliding window width for text n-gram generation.
+ * @returns {number}
+ */
+export function TEXT_NGRAM_SIZE() {
+    const ret = wasm.TEXT_NGRAM_SIZE();
+    return ret >>> 0;
+}
+
 /**
  * Split data into content-defined chunks using gear rolling hash.
  *
@@ -269,6 +415,45 @@ export function encode_base64(data) {
     }
 }
 
+/**
+ * Encode raw ISCC header components and digest into a base32 ISCC unit string.
+ *
+ * Takes integer type identifiers and a raw digest, returns a base32-encoded
+ * ISCC unit string (without "ISCC:" prefix).
+ * @param {number} mtype
+ * @param {number} stype
+ * @param {number} version
+ * @param {number} bit_length
+ * @param {Uint8Array} digest
+ * @returns {string}
+ */
+export function encode_component(mtype, stype, version, bit_length, digest) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passArray8ToWasm0(digest, wasm.__wbindgen_export);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.encode_component(retptr, mtype, stype, version, bit_length, ptr0, len0);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+        var ptr2 = r0;
+        var len2 = r1;
+        if (r3) {
+            ptr2 = 0; len2 = 0;
+            throw takeObject(r2);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export4(deferred3_0, deferred3_1, 1);
+    }
+}
+
 /**
  * Generate an Audio-Code from a Chromaprint feature vector.
  *
@@ -593,6 +778,32 @@ export function gen_video_code_v0(frame_sigs, bits) {
     }
 }
 
+/**
+ * Decode an ISCC unit string into header components and raw digest.
+ *
+ * Returns an object with `maintype`, `subtype`, `version`, `length`, and
+ * `digest` fields. Strips an optional "ISCC:" prefix before decoding.
+ * @param {string} iscc
+ * @returns {IsccDecodeResult}
+ */
+export function iscc_decode(iscc) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(iscc, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.iscc_decode(retptr, ptr0, len0);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        if (r2) {
+            throw takeObject(r1);
+        }
+        return IsccDecodeResult.__wrap(r0);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+}
+
 /**
  * Decompose a composite ISCC-CODE into individual ISCC-UNITs.
  *
@@ -623,6 +834,41 @@ export function iscc_decompose(iscc_code) {
     }
 }
 
+/**
+ * Convert a JSON string into a `data:` URL with JCS canonicalization.
+ *
+ * Uses `application/ld+json` media type when the JSON contains an `@context`
+ * key, otherwise `application/json`.
+ * @param {string} json
+ * @returns {string}
+ */
+export function json_to_data_url(json) {
+    let deferred3_0;
+    let deferred3_1;
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(json, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        wasm.json_to_data_url(retptr, ptr0, len0);
+        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+        var ptr2 = r0;
+        var len2 = r1;
+        if (r3) {
+            ptr2 = 0; len2 = 0;
+            throw takeObject(r2);
+        }
+        deferred3_0 = ptr2;
+        deferred3_1 = len2;
+        return getStringFromWasm0(ptr2, len2);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+        wasm.__wbindgen_export4(deferred3_0, deferred3_1, 1);
+    }
+}
+
 /**
  * Generate sliding window n-grams from a string.
  *
@@ -959,6 +1205,9 @@ const DataHasherFinalization = (typeof FinalizationRegistry === 'undefined')
 const InstanceHasherFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_instancehasher_free(ptr >>> 0, 1));
+const IsccDecodeResultFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_isccdecoderesult_free(ptr >>> 0, 1));
 
 function addHeapObject(obj) {
     if (heap_next === heap.length) heap.push(heap.length + 1);

package/package.json

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