@automerge/sedimentree 0.8.3 → 0.9.0

package/dist/wasm_bindgen/nodejs/sedimentree_wasm.cjs

@@ -67,6 +67,143 @@ class BlobMeta {
 if (Symbol.dispose) BlobMeta.prototype[Symbol.dispose] = BlobMeta.prototype.free;
 exports.BlobMeta = BlobMeta;
 
+/**
+ * A user-supplied opaque identifier for a loose commit.
+ *
+ * Unlike [`Digest`](crate::digest::WasmDigest), which is a content hash
+ * computed by the system, `CommitId` is provided by the caller at construction
+ * time. This is the identity used for DAG traversal, fragment boundaries,
+ * and sync.
+ */
+class CommitId {
+    static __wrap(ptr) {
+        ptr = ptr >>> 0;
+        const obj = Object.create(CommitId.prototype);
+        obj.__wbg_ptr = ptr;
+        CommitIdFinalization.register(obj, obj.__wbg_ptr, obj);
+        return obj;
+    }
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        CommitIdFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_commitid_free(ptr, 0);
+    }
+    /**
+     * Upcasts; to the JS-import type for [`WasmCommitId`].
+     * @returns {CommitId}
+     */
+    __wasm_refgen_toWasmCommitId() {
+        const ret = wasm.commitid___wasm_refgen_toWasmCommitId(this.__wbg_ptr);
+        return CommitId.__wrap(ret);
+    }
+    /**
+     * Creates a new commit identifier from its Base58 string representation.
+     *
+     * # Errors
+     *
+     * Returns an error if the string cannot be decoded or is not 32 bytes.
+     * @param {string} s
+     * @returns {CommitId}
+     */
+    static fromBase58(s) {
+        const ptr0 = passStringToWasm0(s, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.commitid_fromBase58(ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return CommitId.__wrap(ret[0]);
+    }
+    /**
+     * Creates a new commit identifier from its byte representation.
+     *
+     * # Errors
+     *
+     * Returns an error if the byte slice is not exactly 32 bytes.
+     * @param {Uint8Array} bytes
+     * @returns {CommitId}
+     */
+    static fromBytes(bytes) {
+        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_export);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.commitid_fromBytes(ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return CommitId.__wrap(ret[0]);
+    }
+    /**
+     * Creates a new commit identifier from its hexadecimal string representation.
+     *
+     * # Errors
+     *
+     * Returns an error if the string is not valid hex or not 32 bytes.
+     * @param {string} s
+     * @returns {CommitId}
+     */
+    static fromHexString(s) {
+        const ptr0 = passStringToWasm0(s, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.commitid_fromHexString(ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return CommitId.__wrap(ret[0]);
+    }
+    /**
+     * Creates a new commit identifier from its byte representation.
+     *
+     * # Errors
+     *
+     * Returns an error if the byte slice is not exactly 32 bytes.
+     * @param {Uint8Array} bytes
+     */
+    constructor(bytes) {
+        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_export);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.commitid_new(ptr0, len0);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        this.__wbg_ptr = ret[0] >>> 0;
+        CommitIdFinalization.register(this, this.__wbg_ptr, this);
+        return this;
+    }
+    /**
+     * Returns the byte representation of the commit identifier.
+     * @returns {Uint8Array}
+     */
+    toBytes() {
+        const ret = wasm.commitid_toBytes(this.__wbg_ptr);
+        var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_export6(ret[0], ret[1] * 1, 1);
+        return v1;
+    }
+    /**
+     * Returns the hexadecimal string representation.
+     * @returns {string}
+     */
+    toHexString() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const ret = wasm.commitid_toHexString(this.__wbg_ptr);
+            deferred1_0 = ret[0];
+            deferred1_1 = ret[1];
+            return getStringFromWasm0(ret[0], ret[1]);
+        } finally {
+            wasm.__wbindgen_export6(deferred1_0, deferred1_1, 1);
+        }
+    }
+}
+if (Symbol.dispose) CommitId.prototype[Symbol.dispose] = CommitId.prototype.free;
+exports.CommitId = CommitId;
+
 /**
  * A commit stored with its associated blob.
  */
@@ -368,8 +505,8 @@ class Fragment {
         return BlobMeta.__wrap(ret);
     }
     /**
-     * Get the boundary digests of the fragment.
-     * @returns {Digest[]}
+     * Get the boundary commit identifiers of the fragment.
+     * @returns {CommitId[]}
      */
     get boundary() {
         const ret = wasm.fragment_boundary(this.__wbg_ptr);
@@ -378,25 +515,25 @@ class Fragment {
         return v1;
     }
     /**
-     * Get the head digest of the fragment.
-     * @returns {Digest}
+     * Get the head commit identifier of the fragment.
+     * @returns {CommitId}
      */
     get head() {
         const ret = wasm.fragment_head(this.__wbg_ptr);
-        return Digest.__wrap(ret);
+        return CommitId.__wrap(ret);
     }
     /**
      * Create a new fragment from the given sedimentree ID, head, boundary, checkpoints, and blob metadata.
      * @param {SedimentreeId} sedimentree_id
-     * @param {Digest} head
-     * @param {Digest[]} boundary
-     * @param {Digest[]} checkpoints
+     * @param {CommitId} head
+     * @param {CommitId[]} boundary
+     * @param {CommitId[]} checkpoints
      * @param {BlobMeta} blob_meta
      */
     constructor(sedimentree_id, head, boundary, checkpoints, blob_meta) {
         _assertClass(sedimentree_id, SedimentreeId);
         var ptr0 = sedimentree_id.__destroy_into_raw();
-        _assertClass(head, Digest);
+        _assertClass(head, CommitId);
         var ptr1 = head.__destroy_into_raw();
         const ptr2 = passArrayJsValueToWasm0(boundary, wasm.__wbindgen_export);
         const len2 = WASM_VECTOR_LEN;
@@ -543,7 +680,15 @@ class LooseCommit {
         return BlobMeta.__wrap(ret);
     }
     /**
-     * Get the digest of the commit.
+     * Get the commit's head identifier.
+     * @returns {CommitId}
+     */
+    get commitId() {
+        const ret = wasm.loosecommit_commitId(this.__wbg_ptr);
+        return CommitId.__wrap(ret);
+    }
+    /**
+     * Get the digest of the commit (content hash).
      * @returns {Digest}
      */
     get digest() {
@@ -551,25 +696,28 @@ class LooseCommit {
         return Digest.__wrap(ret);
     }
     /**
-     * Create a new `LooseCommit` from the given sedimentree ID, parents, and blob metadata.
+     * Create a new `LooseCommit` from the given sedimentree ID, head, parents, and blob metadata.
      * @param {SedimentreeId} sedimentree_id
-     * @param {Digest[]} parents
+     * @param {CommitId} head
+     * @param {CommitId[]} parents
      * @param {BlobMeta} blob_meta
      */
-    constructor(sedimentree_id, parents, blob_meta) {
+    constructor(sedimentree_id, head, parents, blob_meta) {
         _assertClass(sedimentree_id, SedimentreeId);
         var ptr0 = sedimentree_id.__destroy_into_raw();
-        const ptr1 = passArrayJsValueToWasm0(parents, wasm.__wbindgen_export);
-        const len1 = WASM_VECTOR_LEN;
+        _assertClass(head, CommitId);
+        var ptr1 = head.__destroy_into_raw();
+        const ptr2 = passArrayJsValueToWasm0(parents, wasm.__wbindgen_export);
+        const len2 = WASM_VECTOR_LEN;
         _assertClass(blob_meta, BlobMeta);
-        const ret = wasm.loosecommit_new(ptr0, ptr1, len1, blob_meta.__wbg_ptr);
+        const ret = wasm.loosecommit_new(ptr0, ptr1, ptr2, len2, blob_meta.__wbg_ptr);
         this.__wbg_ptr = ret >>> 0;
         LooseCommitFinalization.register(this, this.__wbg_ptr, this);
         return this;
     }
     /**
-     * Get the parent digests of the commit.
-     * @returns {Digest[]}
+     * Get the parent commit identifiers.
+     * @returns {CommitId[]}
      */
     get parents() {
         const ret = wasm.loosecommit_parents(this.__wbg_ptr);
@@ -618,27 +766,27 @@ class MemoryStorage {
         return ret;
     }
     /**
-     * Delete a commit by digest.
+     * Delete a single commit by its ID.
      * @param {SedimentreeId} sedimentree_id
-     * @param {Digest} digest
+     * @param {CommitId} commit_id
      * @returns {Promise<any>}
      */
-    deleteCommit(sedimentree_id, digest) {
+    deleteCommit(sedimentree_id, commit_id) {
         _assertClass(sedimentree_id, SedimentreeId);
-        _assertClass(digest, Digest);
-        const ret = wasm.memorystorage_deleteCommit(this.__wbg_ptr, sedimentree_id.__wbg_ptr, digest.__wbg_ptr);
+        _assertClass(commit_id, CommitId);
+        const ret = wasm.memorystorage_deleteCommit(this.__wbg_ptr, sedimentree_id.__wbg_ptr, commit_id.__wbg_ptr);
         return ret;
     }
     /**
-     * Delete a fragment by digest.
+     * Delete a fragment by its identifier.
      * @param {SedimentreeId} sedimentree_id
-     * @param {Digest} digest
+     * @param {CommitId} fragment_head
      * @returns {Promise<any>}
      */
-    deleteFragment(sedimentree_id, digest) {
+    deleteFragment(sedimentree_id, fragment_head) {
         _assertClass(sedimentree_id, SedimentreeId);
-        _assertClass(digest, Digest);
-        const ret = wasm.memorystorage_deleteFragment(this.__wbg_ptr, sedimentree_id.__wbg_ptr, digest.__wbg_ptr);
+        _assertClass(fragment_head, CommitId);
+        const ret = wasm.memorystorage_deleteFragment(this.__wbg_ptr, sedimentree_id.__wbg_ptr, fragment_head.__wbg_ptr);
         return ret;
     }
     /**
@@ -652,23 +800,23 @@ class MemoryStorage {
         return ret;
     }
     /**
-     * List all commit digests for a sedimentree.
+     * List all commit IDs for a sedimentree.
      * @param {SedimentreeId} sedimentree_id
      * @returns {Promise<any>}
      */
-    listCommitDigests(sedimentree_id) {
+    listCommitIds(sedimentree_id) {
         _assertClass(sedimentree_id, SedimentreeId);
-        const ret = wasm.memorystorage_listCommitDigests(this.__wbg_ptr, sedimentree_id.__wbg_ptr);
+        const ret = wasm.memorystorage_listCommitIds(this.__wbg_ptr, sedimentree_id.__wbg_ptr);
         return ret;
     }
     /**
-     * List all fragment digests for a sedimentree.
+     * List all fragment IDs for a sedimentree.
      * @param {SedimentreeId} sedimentree_id
      * @returns {Promise<any>}
      */
-    listFragmentDigests(sedimentree_id) {
+    listFragmentIds(sedimentree_id) {
         _assertClass(sedimentree_id, SedimentreeId);
-        const ret = wasm.memorystorage_listFragmentDigests(this.__wbg_ptr, sedimentree_id.__wbg_ptr);
+        const ret = wasm.memorystorage_listFragmentIds(this.__wbg_ptr, sedimentree_id.__wbg_ptr);
         return ret;
     }
     /**
@@ -700,27 +848,27 @@ class MemoryStorage {
         return ret;
     }
     /**
-     * Load a commit by digest, returning `CommitWithBlob` or null.
+     * Load a single commit by its ID, returning `CommitWithBlob` or null.
      * @param {SedimentreeId} sedimentree_id
-     * @param {Digest} digest
+     * @param {CommitId} commit_id
      * @returns {Promise<any>}
      */
-    loadCommit(sedimentree_id, digest) {
+    loadCommit(sedimentree_id, commit_id) {
         _assertClass(sedimentree_id, SedimentreeId);
-        _assertClass(digest, Digest);
-        const ret = wasm.memorystorage_loadCommit(this.__wbg_ptr, sedimentree_id.__wbg_ptr, digest.__wbg_ptr);
+        _assertClass(commit_id, CommitId);
+        const ret = wasm.memorystorage_loadCommit(this.__wbg_ptr, sedimentree_id.__wbg_ptr, commit_id.__wbg_ptr);
         return ret;
     }
     /**
-     * Load a fragment by digest, returning `FragmentWithBlob` or null.
+     * Load a fragment by its identifier, returning `FragmentWithBlob` or null.
      * @param {SedimentreeId} sedimentree_id
-     * @param {Digest} digest
+     * @param {CommitId} fragment_head
      * @returns {Promise<any>}
      */
-    loadFragment(sedimentree_id, digest) {
+    loadFragment(sedimentree_id, fragment_head) {
         _assertClass(sedimentree_id, SedimentreeId);
-        _assertClass(digest, Digest);
-        const ret = wasm.memorystorage_loadFragment(this.__wbg_ptr, sedimentree_id.__wbg_ptr, digest.__wbg_ptr);
+        _assertClass(fragment_head, CommitId);
+        const ret = wasm.memorystorage_loadFragment(this.__wbg_ptr, sedimentree_id.__wbg_ptr, fragment_head.__wbg_ptr);
         return ret;
     }
     /**
@@ -746,32 +894,41 @@ class MemoryStorage {
     }
     /**
      * Save a commit with its blob.
+     *
+     * The `commit_id` parameter must match the `head()` embedded in
+     * the signed commit payload. Returns an error if they differ.
+     *
+     * # Errors
+     *
+     * Returns a JS error if:
+     * - The signed payload cannot be decoded
+     * - The `commit_id` does not match the embedded `head()`
      * @param {SedimentreeId} sedimentree_id
-     * @param {Digest} _digest
+     * @param {CommitId} commit_id
      * @param {SignedLooseCommit} signed_commit
      * @param {Uint8Array} blob
      * @returns {Promise<any>}
      */
-    saveCommit(sedimentree_id, _digest, signed_commit, blob) {
+    saveCommit(sedimentree_id, commit_id, signed_commit, blob) {
         _assertClass(sedimentree_id, SedimentreeId);
-        _assertClass(_digest, Digest);
+        _assertClass(commit_id, CommitId);
         _assertClass(signed_commit, SignedLooseCommit);
-        const ret = wasm.memorystorage_saveCommit(this.__wbg_ptr, sedimentree_id.__wbg_ptr, _digest.__wbg_ptr, signed_commit.__wbg_ptr, blob);
+        const ret = wasm.memorystorage_saveCommit(this.__wbg_ptr, sedimentree_id.__wbg_ptr, commit_id.__wbg_ptr, signed_commit.__wbg_ptr, blob);
         return ret;
     }
     /**
      * Save a fragment with its blob.
      * @param {SedimentreeId} sedimentree_id
-     * @param {Digest} _digest
+     * @param {CommitId} _fragment_head
      * @param {SignedFragment} signed_fragment
      * @param {Uint8Array} blob
      * @returns {Promise<any>}
      */
-    saveFragment(sedimentree_id, _digest, signed_fragment, blob) {
+    saveFragment(sedimentree_id, _fragment_head, signed_fragment, blob) {
         _assertClass(sedimentree_id, SedimentreeId);
-        _assertClass(_digest, Digest);
+        _assertClass(_fragment_head, CommitId);
         _assertClass(signed_fragment, SignedFragment);
-        const ret = wasm.memorystorage_saveFragment(this.__wbg_ptr, sedimentree_id.__wbg_ptr, _digest.__wbg_ptr, signed_fragment.__wbg_ptr, blob);
+        const ret = wasm.memorystorage_saveFragment(this.__wbg_ptr, sedimentree_id.__wbg_ptr, _fragment_head.__wbg_ptr, signed_fragment.__wbg_ptr, blob);
         return ret;
     }
     /**
@@ -1102,19 +1259,19 @@ exports.SignedLooseCommit = SignedLooseCommit;
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg___wasm_refgen_toWasmDigest_476b24805f220005: function(arg0) {
-            const ret = arg0.__wasm_refgen_toWasmDigest();
-            _assertClass(ret, Digest);
+        __wbg___wasm_refgen_toWasmCommitId_65b818e358f27de6: function(arg0) {
+            const ret = arg0.__wasm_refgen_toWasmCommitId();
+            _assertClass(ret, CommitId);
             var ptr1 = ret.__destroy_into_raw();
             return ptr1;
         },
-        __wbg___wasm_refgen_toWasmFragment_10dd1ff9b3934840: function(arg0) {
+        __wbg___wasm_refgen_toWasmFragment_38ddb9958dbdc455: function(arg0) {
             const ret = arg0.__wasm_refgen_toWasmFragment();
             _assertClass(ret, Fragment);
             var ptr1 = ret.__destroy_into_raw();
             return ptr1;
         },
-        __wbg___wasm_refgen_toWasmLooseCommit_f36ad6a9389cee03: function(arg0) {
+        __wbg___wasm_refgen_toWasmLooseCommit_876edb05490f6350: function(arg0) {
             const ret = arg0.__wasm_refgen_toWasmLooseCommit();
             _assertClass(ret, LooseCommit);
             var ptr1 = ret.__destroy_into_raw();
@@ -1151,12 +1308,12 @@ function __wbg_get_imports() {
             const ret = arg0.call(arg1, arg2);
             return ret;
         }, arguments); },
-        __wbg_commitwithblob_new: function(arg0) {
-            const ret = CommitWithBlob.__wrap(arg0);
+        __wbg_commitid_new: function(arg0) {
+            const ret = CommitId.__wrap(arg0);
             return ret;
         },
-        __wbg_digest_new: function(arg0) {
-            const ret = Digest.__wrap(arg0);
+        __wbg_commitwithblob_new: function(arg0) {
+            const ret = CommitWithBlob.__wrap(arg0);
             return ret;
         },
         __wbg_fragmentwithblob_new: function(arg0) {
@@ -1206,7 +1363,7 @@ function __wbg_get_imports() {
                     const a = state0.a;
                     state0.a = 0;
                     try {
-                        return __wasm_bindgen_func_elem_552_67(a, state0.b, arg0, arg1);
+                        return __wasm_bindgen_func_elem_563_75(a, state0.b, arg0, arg1);
                     } finally {
                         state0.a = a;
                     }
@@ -1271,8 +1428,8 @@ function __wbg_get_imports() {
             return ret;
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { dtor_idx: 70, function: Function { arguments: [Externref], shim_idx: 132, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_385, __wasm_bindgen_func_elem_552);
+            // Cast intrinsic for `Closure(Closure { dtor_idx: 73, function: Function { arguments: [Externref], shim_idx: 136, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm.__wasm_bindgen_func_elem_400, __wasm_bindgen_func_elem_563);
             return ret;
         },
         __wbindgen_cast_0000000000000002: function(arg0) {
@@ -1301,15 +1458,15 @@ function __wbg_get_imports() {
     };
 }
 
-function __wasm_bindgen_func_elem_552(arg0, arg1, arg2) {
-    const ret = wasm.__wasm_bindgen_func_elem_552(arg0, arg1, arg2);
+function __wasm_bindgen_func_elem_563(arg0, arg1, arg2) {
+    const ret = wasm.__wasm_bindgen_func_elem_563(arg0, arg1, arg2);
     if (ret[1]) {
         throw takeFromExternrefTable0(ret[0]);
     }
 }
 
-function __wasm_bindgen_func_elem_552_67(arg0, arg1, arg2, arg3) {
-    wasm.__wasm_bindgen_func_elem_552_67(arg0, arg1, arg2, arg3);
+function __wasm_bindgen_func_elem_563_75(arg0, arg1, arg2, arg3) {
+    wasm.__wasm_bindgen_func_elem_563_75(arg0, arg1, arg2, arg3);
 }
 
 const MemoryStorageFinalization = (typeof FinalizationRegistry === 'undefined')
@@ -1318,6 +1475,9 @@ const MemoryStorageFinalization = (typeof FinalizationRegistry === 'undefined')
 const BlobMetaFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_blobmeta_free(ptr >>> 0, 1));
+const CommitIdFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_commitid_free(ptr >>> 0, 1));
 const CommitWithBlobFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_commitwithblob_free(ptr >>> 0, 1));