@syncular/tauri 0.32.0 → 0.33.0

package/dist/index.d.ts

@@ -186,6 +186,26 @@ export declare class TauriSyncClient implements PromiseMethods<ClientSnapshotMet
     crdtDeleteText(table: string, rowId: string, column: string, index: number, len: number, name?: string): Promise<string>;
     /** Escape hatch: apply an arbitrary Yjs update onto a `crdt` column. */
     crdtApplyUpdate(table: string, rowId: string, column: string, update: Uint8Array): Promise<string>;
+    /**
+     * Stage a blob for attachment (§5.9.7) and return the canonical `BlobRef`
+     * string to store in a `blob_ref` column. The native core owns the upload
+     * queue; write the referencing row after this resolves (§5.9.3).
+     */
+    uploadBlob(bytes: Uint8Array, options?: {
+        readonly mediaType?: string;
+        readonly name?: string;
+    }): Promise<string>;
+    /**
+     * Resolve blob bytes for a `blob_ref` column value or a bare `blobId`
+     * (§5.9.7): the native core serves a local cache hit and otherwise
+     * downloads and verifies the content address.
+     */
+    fetchBlob(ref: string): Promise<{
+        readonly blobId: string;
+        readonly byteLength: number;
+        readonly bytes: Uint8Array;
+        readonly mediaType?: string;
+    }>;
     subscribe(input: {
         readonly id: string;
         readonly table: string;

package/dist/index.js

@@ -616,6 +616,40 @@ export class TauriSyncClient {
         }));
         return result.clientCommitId;
     }
+    /**
+     * Stage a blob for attachment (§5.9.7) and return the canonical `BlobRef`
+     * string to store in a `blob_ref` column. The native core owns the upload
+     * queue; write the referencing row after this resolves (§5.9.3).
+     */
+    async uploadBlob(bytes, options) {
+        const result = (await this.#command('uploadBlob', {
+            bytes: { $bytes: bytesToHex(bytes) },
+            ...(options?.mediaType !== undefined
+                ? { mediaType: options.mediaType }
+                : {}),
+            ...(options?.name !== undefined ? { name: options.name } : {}),
+        }));
+        return result.ref;
+    }
+    /**
+     * Resolve blob bytes for a `blob_ref` column value or a bare `blobId`
+     * (§5.9.7): the native core serves a local cache hit and otherwise
+     * downloads and verifies the content address.
+     */
+    async fetchBlob(ref) {
+        const result = (await this.#command('fetchBlob', { blob: ref }));
+        const bytes = result.blob.bytes;
+        if (!isBytesEnvelope(bytes))
+            throw new TauriSyncError('sync.invalid_request', 'fetchBlob reply carried no $bytes envelope');
+        return {
+            blobId: result.blob.blobId,
+            byteLength: result.blob.byteLength,
+            bytes: hexToBytes(bytes.$bytes),
+            ...(result.blob.mediaType !== undefined
+                ? { mediaType: result.blob.mediaType }
+                : {}),
+        };
+    }
     async subscribe(input) {
         await this.#command('subscribe', {
             id: input.id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/tauri",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "description": "Tauri integration for the Syncular client",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -56,13 +56,13 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@syncular/client": "0.32.0"
+    "@syncular/client": "0.33.0"
   },
   "peerDependencies": {
     "@tauri-apps/api": ">=2.0.0"
   },
   "devDependencies": {
-    "@syncular/react": "0.32.0",
-    "@syncular/server": "0.32.0"
+    "@syncular/react": "0.33.0",
+    "@syncular/server": "0.33.0"
   }
 }

package/src/index.ts

@@ -992,6 +992,60 @@ export class TauriSyncClient implements PromiseMethods<ClientSnapshotMethods> {
     return result.clientCommitId;
   }
 
+  /**
+   * Stage a blob for attachment (§5.9.7) and return the canonical `BlobRef`
+   * string to store in a `blob_ref` column. The native core owns the upload
+   * queue; write the referencing row after this resolves (§5.9.3).
+   */
+  async uploadBlob(
+    bytes: Uint8Array,
+    options?: { readonly mediaType?: string; readonly name?: string },
+  ): Promise<string> {
+    const result = (await this.#command('uploadBlob', {
+      bytes: { $bytes: bytesToHex(bytes) },
+      ...(options?.mediaType !== undefined
+        ? { mediaType: options.mediaType }
+        : {}),
+      ...(options?.name !== undefined ? { name: options.name } : {}),
+    })) as { ref: string };
+    return result.ref;
+  }
+
+  /**
+   * Resolve blob bytes for a `blob_ref` column value or a bare `blobId`
+   * (§5.9.7): the native core serves a local cache hit and otherwise
+   * downloads and verifies the content address.
+   */
+  async fetchBlob(ref: string): Promise<{
+    readonly blobId: string;
+    readonly byteLength: number;
+    readonly bytes: Uint8Array;
+    readonly mediaType?: string;
+  }> {
+    const result = (await this.#command('fetchBlob', { blob: ref })) as {
+      blob: {
+        blobId: string;
+        byteLength: number;
+        bytes: unknown;
+        mediaType?: string;
+      };
+    };
+    const bytes = result.blob.bytes;
+    if (!isBytesEnvelope(bytes))
+      throw new TauriSyncError(
+        'sync.invalid_request',
+        'fetchBlob reply carried no $bytes envelope',
+      );
+    return {
+      blobId: result.blob.blobId,
+      byteLength: result.blob.byteLength,
+      bytes: hexToBytes(bytes.$bytes),
+      ...(result.blob.mediaType !== undefined
+        ? { mediaType: result.blob.mediaType }
+        : {}),
+    };
+  }
+
   async subscribe(input: {
     readonly id: string;
     readonly table: string;