@automerge/subduction 0.10.1 → 0.11.0

package/dist/wasm_bindgen/web/subduction_wasm.d.ts

@@ -36,23 +36,23 @@ export interface SedimentreeStorage {
     loadAllSedimentreeIds(): Promise<SedimentreeId[]>;
 
     // Compound storage for commits (signed data + blob stored together)
-    saveCommit(sedimentreeId: SedimentreeId, digest: Digest, signedCommit: SignedLooseCommit, blob: Uint8Array): Promise<void>;
-    loadCommit(sedimentreeId: SedimentreeId, digest: Digest): Promise<CommitWithBlob | null>;
-    listCommitDigests(sedimentreeId: SedimentreeId): Promise<Digest[]>;
+    saveCommit(sedimentreeId: SedimentreeId, commitId: CommitId, signedCommit: SignedLooseCommit, blob: Uint8Array): Promise<void>;
+    loadCommit(sedimentreeId: SedimentreeId, commitId: CommitId): Promise<CommitWithBlob | null>;
+    listCommitIds(sedimentreeId: SedimentreeId): Promise<CommitId[]>;
     loadAllCommits(sedimentreeId: SedimentreeId): Promise<CommitWithBlob[]>;
-    deleteCommit(sedimentreeId: SedimentreeId, digest: Digest): Promise<void>;
+    deleteCommit(sedimentreeId: SedimentreeId, commitId: CommitId): Promise<void>;
     deleteAllCommits(sedimentreeId: SedimentreeId): Promise<void>;
 
     // Compound storage for fragments (signed data + blob stored together)
-    saveFragment(sedimentreeId: SedimentreeId, digest: Digest, signedFragment: SignedFragment, blob: Uint8Array): Promise<void>;
-    loadFragment(sedimentreeId: SedimentreeId, digest: Digest): Promise<FragmentWithBlob | null>;
-    listFragmentDigests(sedimentreeId: SedimentreeId): Promise<Digest[]>;
+    saveFragment(sedimentreeId: SedimentreeId, fragmentHead: CommitId, signedFragment: SignedFragment, blob: Uint8Array): Promise<void>;
+    loadFragment(sedimentreeId: SedimentreeId, fragmentHead: CommitId): Promise<FragmentWithBlob | null>;
+    listFragmentIds(sedimentreeId: SedimentreeId): Promise<CommitId[]>;
     loadAllFragments(sedimentreeId: SedimentreeId): Promise<FragmentWithBlob[]>;
-    deleteFragment(sedimentreeId: SedimentreeId, digest: Digest): Promise<void>;
+    deleteFragment(sedimentreeId: SedimentreeId, fragmentHead: CommitId): Promise<void>;
     deleteAllFragments(sedimentreeId: SedimentreeId): Promise<void>;
 
     // Batch save: write all commits + fragments in a single storage transaction.
-    saveBatchAll(sedimentreeId: SedimentreeId, commits: Array<{digest: Digest, signedCommit: SignedLooseCommit, blob: Uint8Array}>, fragments: Array<{digest: Digest, signedFragment: SignedFragment, blob: Uint8Array}>): Promise<number>;
+    saveBatchAll(sedimentreeId: SedimentreeId, commits: Array<{commitId: CommitId, signedCommit: SignedLooseCommit, blob: Uint8Array}>, fragments: Array<{fragmentHead: CommitId, signedFragment: SignedFragment, blob: Uint8Array}>): Promise<number>;
 }
 
 
@@ -298,6 +298,63 @@ export class CallError {
     [Symbol.dispose](): void;
 }
 
+/**
+ * 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.
+ */
+export class CommitId {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Upcasts; to the JS-import type for [`WasmCommitId`].
+     */
+    __wasm_refgen_toWasmCommitId(): CommitId;
+    /**
+     * 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.
+     */
+    static fromBase58(s: string): CommitId;
+    /**
+     * Creates a new commit identifier from its byte representation.
+     *
+     * # Errors
+     *
+     * Returns an error if the byte slice is not exactly 32 bytes.
+     */
+    static fromBytes(bytes: Uint8Array): CommitId;
+    /**
+     * 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.
+     */
+    static fromHexString(s: string): CommitId;
+    /**
+     * Creates a new commit identifier from its byte representation.
+     *
+     * # Errors
+     *
+     * Returns an error if the byte slice is not exactly 32 bytes.
+     */
+    constructor(bytes: Uint8Array);
+    /**
+     * Returns the byte representation of the commit identifier.
+     */
+    toBytes(): Uint8Array;
+    /**
+     * Returns the hexadecimal string representation.
+     */
+    toHexString(): string;
+}
+
 /**
  * A commit stored with its associated blob.
  */
@@ -418,19 +475,19 @@ export class Fragment {
     /**
      * Create a new fragment from the given sedimentree ID, head, boundary, checkpoints, and blob metadata.
      */
-    constructor(sedimentree_id: SedimentreeId, head: Digest, boundary: Digest[], checkpoints: Digest[], blob_meta: BlobMeta);
+    constructor(sedimentree_id: SedimentreeId, head: CommitId, boundary: CommitId[], checkpoints: CommitId[], blob_meta: BlobMeta);
     /**
      * Get the blob metadata of the fragment.
      */
     readonly blobMeta: BlobMeta;
     /**
-     * Get the boundary digests of the fragment.
+     * Get the boundary commit identifiers of the fragment.
      */
-    readonly boundary: Digest[];
+    readonly boundary: CommitId[];
     /**
-     * Get the head digest of the fragment.
+     * Get the head commit identifier of the fragment.
      */
-    readonly head: Digest;
+    readonly head: CommitId;
 }
 
 /**
@@ -440,17 +497,17 @@ export class FragmentRequested {
     free(): void;
     [Symbol.dispose](): void;
     /**
-     * Create a new fragment request from the given digest.
+     * Create a new fragment request from the given commit ID.
      */
-    constructor(digest: Digest, depth: Depth);
+    constructor(commit_id: CommitId, depth: Depth);
     /**
      * Get the depth of the requested fragment.
      */
     readonly depth: Depth;
     /**
-     * Get the digest of the requested fragment.
+     * Get the head commit identifier of the requested fragment.
      */
-    readonly head: Digest;
+    readonly head: CommitId;
 }
 
 /**
@@ -512,21 +569,25 @@ export class LooseCommit {
      */
     __wasm_refgen_toWasmLooseCommit(): LooseCommit;
     /**
-     * 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.
      */
-    constructor(sedimentree_id: SedimentreeId, parents: Digest[], blob_meta: BlobMeta);
+    constructor(sedimentree_id: SedimentreeId, head: CommitId, parents: CommitId[], blob_meta: BlobMeta);
     /**
      * Get the blob metadata of the commit.
      */
     readonly blobMeta: BlobMeta;
     /**
-     * Get the digest of the commit.
+     * Get the commit's head identifier.
+     */
+    readonly commitId: CommitId;
+    /**
+     * Get the digest of the commit (content hash).
      */
     readonly digest: Digest;
     /**
-     * Get the parent digests of the commit.
+     * Get the parent commit identifiers.
      */
-    readonly parents: Digest[];
+    readonly parents: CommitId[];
 }
 
 /**
@@ -610,25 +671,25 @@ export class MemoryStorage {
      */
     deleteAllFragments(sedimentree_id: SedimentreeId): Promise<any>;
     /**
-     * Delete a commit by digest.
+     * Delete a single commit by its ID.
      */
-    deleteCommit(sedimentree_id: SedimentreeId, digest: Digest): Promise<any>;
+    deleteCommit(sedimentree_id: SedimentreeId, commit_id: CommitId): Promise<any>;
     /**
-     * Delete a fragment by digest.
+     * Delete a fragment by its identifier.
      */
-    deleteFragment(sedimentree_id: SedimentreeId, digest: Digest): Promise<any>;
+    deleteFragment(sedimentree_id: SedimentreeId, fragment_head: CommitId): Promise<any>;
     /**
      * Delete a sedimentree ID.
      */
     deleteSedimentreeId(sedimentree_id: SedimentreeId): Promise<any>;
     /**
-     * List all commit digests for a sedimentree.
+     * List all commit IDs for a sedimentree.
      */
-    listCommitDigests(sedimentree_id: SedimentreeId): Promise<any>;
+    listCommitIds(sedimentree_id: SedimentreeId): Promise<any>;
     /**
-     * List all fragment digests for a sedimentree.
+     * List all fragment IDs for a sedimentree.
      */
-    listFragmentDigests(sedimentree_id: SedimentreeId): Promise<any>;
+    listFragmentIds(sedimentree_id: SedimentreeId): Promise<any>;
     /**
      * Load all commits for a sedimentree, returning `CommitWithBlob[]`.
      */
@@ -642,25 +703,38 @@ export class MemoryStorage {
      */
     loadAllSedimentreeIds(): Promise<any>;
     /**
-     * Load a commit by digest, returning `CommitWithBlob` or null.
+     * Load a single commit by its ID, returning `CommitWithBlob` or null.
      */
-    loadCommit(sedimentree_id: SedimentreeId, digest: Digest): Promise<any>;
+    loadCommit(sedimentree_id: SedimentreeId, commit_id: CommitId): Promise<any>;
     /**
-     * Load a fragment by digest, returning `FragmentWithBlob` or null.
+     * Load a fragment by its identifier, returning `FragmentWithBlob` or null.
      */
-    loadFragment(sedimentree_id: SedimentreeId, digest: Digest): Promise<any>;
+    loadFragment(sedimentree_id: SedimentreeId, fragment_head: CommitId): Promise<any>;
     /**
      * Create a new in-memory storage instance.
      */
     constructor();
+    /**
+     * Save commits and fragments in a single batch.
+     */
+    saveBatchAll(sedimentree_id: SedimentreeId, commits: Array<any>, fragments: Array<any>): Promise<any>;
     /**
      * 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()`
      */
-    saveCommit(sedimentree_id: SedimentreeId, _digest: Digest, signed_commit: SignedLooseCommit, blob: Uint8Array): Promise<any>;
+    saveCommit(sedimentree_id: SedimentreeId, commit_id: CommitId, signed_commit: SignedLooseCommit, blob: Uint8Array): Promise<any>;
     /**
      * Save a fragment with its blob.
      */
-    saveFragment(sedimentree_id: SedimentreeId, _digest: Digest, signed_fragment: SignedFragment, blob: Uint8Array): Promise<any>;
+    saveFragment(sedimentree_id: SedimentreeId, _fragment_head: CommitId, signed_fragment: SignedFragment, blob: Uint8Array): Promise<any>;
     /**
      * Save a sedimentree ID.
      */
@@ -970,7 +1044,7 @@ export class Subduction {
      *
      * Returns a [`WasmWriteError`] if storage, networking, or policy fail.
      */
-    addCommit(id: SedimentreeId, parents: Digest[], blob: Uint8Array): Promise<FragmentRequested | undefined>;
+    addCommit(id: SedimentreeId, head: CommitId, parents: CommitId[], blob: Uint8Array): Promise<FragmentRequested | undefined>;
     /**
      * Onboard an authenticated transport: add it and sync all sedimentrees.
      *
@@ -1002,7 +1076,7 @@ export class Subduction {
      *
      * Returns a [`WasmWriteError`] if storage, networking, or policy fail.
      */
-    addFragment(id: SedimentreeId, head: Digest, boundary: Digest[], checkpoints: Digest[], blob: Uint8Array): Promise<void>;
+    addFragment(id: SedimentreeId, head: CommitId, boundary: CommitId[], checkpoints: CommitId[], blob: Uint8Array): Promise<void>;
     /**
      * Add a Sedimentree.
      *
@@ -1598,7 +1672,7 @@ export class SyncStats {
     /**
      * The remote peer's heads for this sedimentree.
      */
-    readonly remoteHeads: Digest[];
+    readonly remoteHeads: CommitId[];
     /**
      * Total items received (commits + fragments).
      */
@@ -1746,7 +1820,7 @@ export interface InitOutput {
     readonly subduction_getBlob: (a: number, b: number, c: number) => any;
     readonly subduction_getBlobs: (a: number, b: number) => any;
     readonly subduction_fetchBlobs: (a: number, b: number, c: number, d: bigint) => any;
-    readonly subduction_addCommit: (a: number, b: number, c: number, d: number, e: any) => any;
+    readonly subduction_addCommit: (a: number, b: number, c: number, d: number, e: number, f: any) => any;
     readonly subduction_addFragment: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: any) => any;
     readonly subduction_requestBlobs: (a: number, b: number, c: number, d: number) => any;
     readonly subduction_syncWithPeer: (a: number, b: number, c: number, d: number, e: number, f: bigint) => any;
@@ -1855,18 +1929,22 @@ export interface InitOutput {
     readonly __wbg_topic_free: (a: number, b: number) => void;
     readonly __wbg_webcryptosigner_free: (a: number, b: number) => void;
     readonly topic_toBytes: (a: number) => [number, number];
+    readonly __wbg_commitid_free: (a: number, b: number) => void;
+    readonly commitid_fromBytes: (a: number, b: number) => [number, number, number];
+    readonly commitid_fromBase58: (a: number, b: number) => [number, number, number];
+    readonly commitid_fromHexString: (a: number, b: number) => [number, number, number];
+    readonly commitid_toBytes: (a: number) => [number, number];
+    readonly commitid_toHexString: (a: number) => [number, number];
+    readonly commitid___wasm_refgen_toWasmCommitId: (a: number) => number;
     readonly __wbg_depth_free: (a: number, b: number) => void;
     readonly depth_new: (a: any) => [number, number, number];
     readonly depth_value: (a: number) => number;
     readonly depth___subduction_castToDepth: (a: number) => number;
-    readonly __wbg_digest_free: (a: number, b: number) => void;
     readonly digest_new: (a: number, b: number) => [number, number, number];
     readonly digest_fromBytes: (a: number, b: number) => [number, number, number];
     readonly digest_fromBase58: (a: number, b: number) => [number, number, number];
-    readonly digest_toBytes: (a: number) => [number, number];
     readonly digest_fromHexString: (a: number, b: number) => [number, number, number];
     readonly digest_toHexString: (a: number) => [number, number];
-    readonly digest___wasm_refgen_toWasmDigest: (a: number) => number;
     readonly __wbg_fragment_free: (a: number, b: number) => void;
     readonly fragment_new: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => number;
     readonly fragment_head: (a: number) => number;
@@ -1878,7 +1956,8 @@ export interface InitOutput {
     readonly fragmentwithblob_signed: (a: number) => number;
     readonly fragmentwithblob___wasm_refgen_toWasmFragmentWithBlob: (a: number) => number;
     readonly __wbg_loosecommit_free: (a: number, b: number) => void;
-    readonly loosecommit_new: (a: number, b: number, c: number, d: number) => number;
+    readonly loosecommit_new: (a: number, b: number, c: number, d: number, e: number) => number;
+    readonly loosecommit_commitId: (a: number) => number;
     readonly loosecommit_digest: (a: number) => number;
     readonly loosecommit_parents: (a: number) => [number, number];
     readonly loosecommit_blobMeta: (a: number) => number;
@@ -1916,33 +1995,38 @@ export interface InitOutput {
     readonly memorystorage_loadAllSedimentreeIds: (a: number) => any;
     readonly memorystorage_saveCommit: (a: number, b: number, c: number, d: number, e: any) => any;
     readonly memorystorage_loadCommit: (a: number, b: number, c: number) => any;
-    readonly memorystorage_listCommitDigests: (a: number, b: number) => any;
-    readonly memorystorage_loadAllCommits: (a: number, b: number) => any;
     readonly memorystorage_deleteCommit: (a: number, b: number, c: number) => any;
+    readonly memorystorage_listCommitIds: (a: number, b: number) => any;
+    readonly memorystorage_loadAllCommits: (a: number, b: number) => any;
     readonly memorystorage_deleteAllCommits: (a: number, b: number) => any;
     readonly memorystorage_saveFragment: (a: number, b: number, c: number, d: number, e: any) => any;
     readonly memorystorage_loadFragment: (a: number, b: number, c: number) => any;
-    readonly memorystorage_listFragmentDigests: (a: number, b: number) => any;
+    readonly memorystorage_listFragmentIds: (a: number, b: number) => any;
     readonly memorystorage_loadAllFragments: (a: number, b: number) => any;
     readonly memorystorage_deleteFragment: (a: number, b: number, c: number) => any;
     readonly memorystorage_deleteAllFragments: (a: number, b: number) => any;
+    readonly memorystorage_saveBatchAll: (a: number, b: number, c: any, d: any) => any;
+    readonly commitid_new: (a: number, b: number) => [number, number, number];
     readonly depth___wasm_refgen_toWasmDepth: (a: number) => number;
-    readonly fragmentwithblob_new: (a: number, b: any) => number;
     readonly __wbg_sedimentreeid_free: (a: number, b: number) => void;
-    readonly __wbg_signedloosecommit_free: (a: number, b: number) => void;
+    readonly fragmentwithblob_new: (a: number, b: any) => number;
+    readonly __wbg_digest_free: (a: number, b: number) => void;
     readonly __wbg_fragmentwithblob_free: (a: number, b: number) => void;
+    readonly __wbg_signedloosecommit_free: (a: number, b: number) => void;
     readonly sedimentreeid_toBytes: (a: number) => [number, number];
     readonly sedimentreeid___wasm_refgen_toWasmSedimentreeId: (a: number) => number;
+    readonly digest_toBytes: (a: number) => [number, number];
+    readonly digest___wasm_refgen_toWasmDigest: (a: number) => number;
     readonly fragmentwithblob_blob: (a: number) => any;
-    readonly __wasm_bindgen_func_elem_285: (a: number, b: number) => void;
-    readonly __wasm_bindgen_func_elem_1651: (a: number, b: number, c: any) => [number, number];
-    readonly __wasm_bindgen_func_elem_1651_194: (a: number, b: number, c: any, d: any) => void;
-    readonly __wasm_bindgen_func_elem_1651_195: (a: number, b: number, c: any, d: any) => void;
-    readonly __wasm_bindgen_func_elem_638: (a: number, b: number, c: any) => void;
-    readonly __wasm_bindgen_func_elem_638_1: (a: number, b: number, c: any) => void;
-    readonly __wasm_bindgen_func_elem_638_2: (a: number, b: number, c: any) => void;
-    readonly __wasm_bindgen_func_elem_638_3: (a: number, b: number, c: any) => void;
-    readonly __wasm_bindgen_func_elem_637: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_291: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_1666: (a: number, b: number, c: any) => [number, number];
+    readonly __wasm_bindgen_func_elem_1666_203: (a: number, b: number, c: any, d: any) => void;
+    readonly __wasm_bindgen_func_elem_1666_204: (a: number, b: number, c: any, d: any) => void;
+    readonly __wasm_bindgen_func_elem_658: (a: number, b: number, c: any) => void;
+    readonly __wasm_bindgen_func_elem_658_1: (a: number, b: number, c: any) => void;
+    readonly __wasm_bindgen_func_elem_658_2: (a: number, b: number, c: any) => void;
+    readonly __wasm_bindgen_func_elem_658_3: (a: number, b: number, c: any) => void;
+    readonly __wasm_bindgen_func_elem_657: (a: number, b: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_export3: (a: number) => void;