@syncular/transport-http 0.0.6-185 → 0.0.6-201

package/dist/transport-client.js

@@ -0,0 +1,189 @@
+import { encodeSnapshotScopes, resolveRequestUrl, SNAPSHOT_SCOPES_HEADER, } from './shared.js';
+export const HTTP_TRANSPORT_SOURCE = Symbol.for('@syncular/transport-http/source');
+function isApiClientLike(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.GET === 'function' &&
+        typeof value.POST === 'function');
+}
+function isJsonContentType(contentType) {
+    return contentType?.includes('application/json') === true;
+}
+async function parseErrorBody(response) {
+    if (!isJsonContentType(response.headers.get('content-type'))) {
+        return undefined;
+    }
+    try {
+        return (await response.json());
+    }
+    catch {
+        return undefined;
+    }
+}
+async function parseJsonBody(response) {
+    if (!isJsonContentType(response.headers.get('content-type'))) {
+        return undefined;
+    }
+    try {
+        return (await response.json());
+    }
+    catch {
+        return undefined;
+    }
+}
+function createAuthRetryResolver(defaultAuthLifecycle) {
+    let refreshInFlight = null;
+    const runRefreshSingleFlight = async (lifecycle, context) => {
+        if (!lifecycle.refreshToken)
+            return false;
+        if (!refreshInFlight) {
+            refreshInFlight = Promise.resolve(lifecycle.refreshToken(context))
+                .then((result) => Boolean(result))
+                .finally(() => {
+                refreshInFlight = null;
+            });
+        }
+        return refreshInFlight;
+    };
+    return async (context, options) => {
+        if (options?.onAuthError) {
+            return Boolean(await options.onAuthError());
+        }
+        const lifecycle = options?.authLifecycle ?? defaultAuthLifecycle;
+        if (!lifecycle)
+            return false;
+        await lifecycle.onAuthExpired?.(context);
+        const refreshResult = await runRefreshSingleFlight(lifecycle, context);
+        if (lifecycle.retryWithFreshToken) {
+            return Boolean(await lifecycle.retryWithFreshToken({ ...context, refreshResult }));
+        }
+        return refreshResult;
+    };
+}
+function createRequestHeaders(baseOptions, extraHeaders) {
+    return Promise.resolve(baseOptions.getHeaders?.()).then((dynamicHeaders) => {
+        const headers = new Headers(extraHeaders);
+        if (dynamicHeaders) {
+            for (const [key, value] of Object.entries(dynamicHeaders)) {
+                headers.set(key, value);
+            }
+        }
+        if (!headers.has('x-syncular-transport-path')) {
+            headers.set('x-syncular-transport-path', baseOptions.transportPath ?? 'direct');
+        }
+        return headers;
+    });
+}
+function createFetchApiClient(baseOptions) {
+    const fetchImpl = baseOptions.fetch ?? globalThis.fetch;
+    const request = async (args) => {
+        const headers = await createRequestHeaders(baseOptions, args.headers);
+        let body;
+        if (args.body !== undefined) {
+            headers.set('content-type', 'application/json');
+            body = JSON.stringify(args.body);
+        }
+        const response = await fetchImpl(resolveRequestUrl(baseOptions.baseUrl, args.path), {
+            method: args.method,
+            headers,
+            body,
+            ...(args.signal ? { signal: args.signal } : {}),
+        });
+        if (!response.ok) {
+            return {
+                response,
+                error: await parseErrorBody(response),
+            };
+        }
+        if (args.parseAs === 'blob') {
+            return {
+                response,
+                data: (await response.blob()),
+            };
+        }
+        return {
+            response,
+            data: await parseJsonBody(response),
+        };
+    };
+    return {
+        sync: (requestBody, signal) => request({
+            method: 'POST',
+            path: '/sync',
+            body: requestBody,
+            signal,
+        }),
+        initiateUpload: (args, signal) => request({
+            method: 'POST',
+            path: '/sync/blobs/upload',
+            body: args,
+            signal,
+        }),
+        completeUpload: (hash, signal) => request({
+            method: 'POST',
+            path: `/sync/blobs/${encodeURIComponent(hash)}/complete`,
+            signal,
+        }),
+        getDownloadUrl: (hash, signal) => request({
+            method: 'GET',
+            path: `/sync/blobs/${encodeURIComponent(hash)}/url`,
+            signal,
+        }),
+        getSnapshotChunk: (chunkId, scopeValues, signal) => request({
+            method: 'GET',
+            path: `/sync/snapshot-chunks/${encodeURIComponent(chunkId)}`,
+            headers: (() => {
+                const encodedScopes = encodeSnapshotScopes(scopeValues);
+                return encodedScopes
+                    ? {
+                        [SNAPSHOT_SCOPES_HEADER]: encodedScopes,
+                    }
+                    : undefined;
+            })(),
+            signal,
+            parseAs: 'blob',
+        }),
+    };
+}
+function createTypedTransportClient(client) {
+    return {
+        sync: (request, signal) => client.POST('/sync', {
+            body: request,
+            ...(signal ? { signal } : {}),
+        }),
+        initiateUpload: (args, signal) => client.POST('/sync/blobs/upload', {
+            body: args,
+            ...(signal ? { signal } : {}),
+        }),
+        completeUpload: (hash, signal) => client.POST('/sync/blobs/{hash}/complete', {
+            params: { path: { hash } },
+            ...(signal ? { signal } : {}),
+        }),
+        getDownloadUrl: (hash, signal) => client.GET('/sync/blobs/{hash}/url', {
+            params: { path: { hash } },
+            ...(signal ? { signal } : {}),
+        }),
+        getSnapshotChunk: (chunkId, scopeValues, signal) => client.GET('/sync/snapshot-chunks/{chunkId}', {
+            params: { path: { chunkId } },
+            parseAs: 'blob',
+            headers: (() => {
+                const encodedScopes = encodeSnapshotScopes(scopeValues);
+                return encodedScopes
+                    ? {
+                        [SNAPSHOT_SCOPES_HEADER]: encodedScopes,
+                    }
+                    : undefined;
+            })(),
+            ...(signal ? { signal } : {}),
+        }),
+    };
+}
+export function createTransportApiClient(source) {
+    return isApiClientLike(source)
+        ? createTypedTransportClient(source)
+        : createFetchApiClient(source);
+}
+export function createTransportAuthRetryResolver(source) {
+    return createAuthRetryResolver(isApiClientLike(source) ? undefined : source.authLifecycle);
+}
+//# sourceMappingURL=transport-client.js.map

package/dist/transport-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-client.js","sourceRoot":"","sources":["../src/transport-client.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,oBAAoB,EAEpB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,UAAU,CAAC;AAIlB,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,GAAG,CAC7C,iCAAiC,CAClC,CAAC;AAIF,SAAS,eAAe,CAAC,KAAc,EAAuB;IAC5D,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAAoB,CAAC,GAAG,KAAK,UAAU;QAC/C,OAAQ,KAAoB,CAAC,IAAI,KAAK,UAAU,CACjD,CAAC;AAAA,CACH;AAiCD,SAAS,iBAAiB,CAAC,WAA0B,EAAW;IAC9D,OAAO,WAAW,EAAE,QAAQ,CAAC,kBAAkB,CAAC,KAAK,IAAI,CAAC;AAAA,CAC3D;AAED,KAAK,UAAU,cAAc,CAAC,QAAkB,EAAoB;IAClE,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;QAC7D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAY,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AAAA,CACF;AAED,KAAK,UAAU,aAAa,CAAI,QAAkB,EAA0B;IAC1E,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;QAC7D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AAAA,CACF;AAED,SAAS,uBAAuB,CAC9B,oBAAmD,EACjC;IAClB,IAAI,eAAe,GAA4B,IAAI,CAAC;IAEpD,MAAM,sBAAsB,GAAG,KAAK,EAClC,SAA4B,EAC5B,OAA6B,EACX,EAAE,CAAC;QACrB,IAAI,CAAC,SAAS,CAAC,YAAY;YAAE,OAAO,KAAK,CAAC;QAE1C,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;iBAC/D,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;iBACjC,OAAO,CAAC,GAAG,EAAE,CAAC;gBACb,eAAe,GAAG,IAAI,CAAC;YAAA,CACxB,CAAC,CAAC;QACP,CAAC;QAED,OAAO,eAAe,CAAC;IAAA,CACxB,CAAC;IAEF,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;QACjC,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;YACzB,OAAO,OAAO,CAAC,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,EAAE,aAAa,IAAI,oBAAoB,CAAC;QACjE,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QAE7B,MAAM,SAAS,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,CAAC;QAEzC,MAAM,aAAa,GAAG,MAAM,sBAAsB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACvE,IAAI,SAAS,CAAC,mBAAmB,EAAE,CAAC;YAClC,OAAO,OAAO,CACZ,MAAM,SAAS,CAAC,mBAAmB,CAAC,EAAE,GAAG,OAAO,EAAE,aAAa,EAAE,CAAC,CACnE,CAAC;QACJ,CAAC;QACD,OAAO,aAAa,CAAC;IAAA,CACtB,CAAC;AAAA,CACH;AAED,SAAS,oBAAoB,CAC3B,WAA0B,EAC1B,YAAqC,EACnB;IAClB,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC;QAC1E,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,cAAc,EAAE,CAAC;YACnB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC1D,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,EAAE,CAAC;YAC9C,OAAO,CAAC,GAAG,CACT,2BAA2B,EAC3B,WAAW,CAAC,aAAa,IAAI,QAAQ,CACtC,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC;IAAA,CAChB,CAAC,CAAC;AAAA,CACJ;AAED,SAAS,oBAAoB,CAAC,WAA0B,EAAsB;IAC5E,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IAExD,MAAM,OAAO,GAAG,KAAK,EAAK,IAOzB,EAAyB,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACtE,IAAI,IAA0B,CAAC;QAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;YAChD,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,SAAS,CAC9B,iBAAiB,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EACjD;YACE,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO;YACP,IAAI;YACJ,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChD,CACF,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO;gBACL,QAAQ;gBACR,KAAK,EAAE,MAAM,cAAc,CAAC,QAAQ,CAAC;aACtC,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO;gBACL,QAAQ;gBACR,IAAI,EAAE,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM;aACnC,CAAC;QACJ,CAAC;QAED,OAAO;YACL,QAAQ;YACR,IAAI,EAAE,MAAM,aAAa,CAAI,QAAQ,CAAC;SACvC,CAAC;IAAA,CACH,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,CAC5B,OAAO,CAAC;YACN,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,WAAW;YACjB,MAAM;SACP,CAAC;QACJ,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAC/B,OAAO,CAAC;YACN,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,oBAAoB;YAC1B,IAAI,EAAE,IAAI;YACV,MAAM;SACP,CAAC;QACJ,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAC/B,OAAO,CAAC;YACN,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,eAAe,kBAAkB,CAAC,IAAI,CAAC,WAAW;YACxD,MAAM;SACP,CAAC;QACJ,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAC/B,OAAO,CAAC;YACN,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,eAAe,kBAAkB,CAAC,IAAI,CAAC,MAAM;YACnD,MAAM;SACP,CAAC;QACJ,gBAAgB,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,CACjD,OAAO,CAAC;YACN,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,yBAAyB,kBAAkB,CAAC,OAAO,CAAC,EAAE;YAC5D,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC;gBACd,MAAM,aAAa,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;gBACxD,OAAO,aAAa;oBAClB,CAAC,CAAC;wBACE,CAAC,sBAAsB,CAAC,EAAE,aAAa;qBACxC;oBACH,CAAC,CAAC,SAAS,CAAC;YAAA,CACf,CAAC,EAAE;YACJ,MAAM;YACN,OAAO,EAAE,MAAM;SAChB,CAAC;KACL,CAAC;AAAA,CACH;AAED,SAAS,0BAA0B,CAAC,MAAkB,EAAsB;IAC1E,OAAO;QACL,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CACxB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;YACnB,IAAI,EAAE,OAAO;YACb,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,CAA6C;QAChD,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAC/B,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;YAChC,IAAI,EAAE,IAAI;YACV,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,CAOA;QACH,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAC/B,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;YACzC,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE;YAC1B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,CAAwD;QAC3D,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAC/B,MAAM,CAAC,GAAG,CAAC,wBAAwB,EAAE;YACnC,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE;YAC1B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,CAA2D;QAC9D,gBAAgB,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,CACjD,MAAM,CAAC,GAAG,CAAC,iCAAiC,EAAE;YAC5C,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE;YAC7B,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC;gBACd,MAAM,aAAa,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;gBACxD,OAAO,aAAa;oBAClB,CAAC,CAAC;wBACE,CAAC,sBAAsB,CAAC,EAAE,aAAa;qBACxC;oBACH,CAAC,CAAC,SAAS,CAAC;YAAA,CACf,CAAC,EAAE;YACJ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,CAA6B;KACjC,CAAC;AAAA,CACH;AAED,MAAM,UAAU,wBAAwB,CACtC,MAA2B,EACP;IACpB,OAAO,eAAe,CAAC,MAAM,CAAC;QAC5B,CAAC,CAAC,0BAA0B,CAAC,MAAM,CAAC;QACpC,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAAA,CAClC;AAED,MAAM,UAAU,gCAAgC,CAC9C,MAA2B,EACT;IAClB,OAAO,uBAAuB,CAC5B,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAC3D,CAAC;AAAA,CACH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/transport-http",
-  "version": "0.0.6-185",
+  "version": "0.0.6-201",
   "description": "HTTP transport for Syncular client-server communication",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -23,6 +23,7 @@
     "fetch"
   ],
   "private": false,
+  "sideEffects": false,
   "publishConfig": {
     "access": "public"
   },
@@ -34,6 +35,13 @@
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
       }
+    },
+    "./blob": {
+      "bun": "./src/blob.ts",
+      "import": {
+        "types": "./dist/blob.d.ts",
+        "default": "./dist/blob.js"
+      }
     }
   },
   "scripts": {
@@ -43,7 +51,7 @@
     "release": "bunx syncular-publish"
   },
   "dependencies": {
-    "@syncular/core": "0.0.6-185",
+    "@syncular/core": "0.0.6-201",
     "openapi-fetch": "^0.17.0"
   },
   "devDependencies": {

package/src/api-client.ts

@@ -0,0 +1,39 @@
+import createClient from 'openapi-fetch';
+import type { paths } from './generated/api';
+import type { ClientOptions } from './shared';
+
+export type SyncClient = ReturnType<typeof createClient<paths>>;
+
+/**
+ * Create a typed API client for the full Syncular API.
+ *
+ * Returns an openapi-fetch client with full type safety for all endpoints.
+ */
+export function createApiClient(options: ClientOptions): SyncClient {
+  const client = createClient<paths>({
+    baseUrl: options.baseUrl,
+    ...(options.fetch && { fetch: options.fetch }),
+  });
+
+  const getHeaders = options.getHeaders;
+  const transportPath = options.transportPath ?? 'direct';
+
+  client.use({
+    async onRequest({ request }) {
+      if (getHeaders) {
+        const headers = await getHeaders();
+        for (const [key, value] of Object.entries(headers)) {
+          request.headers.set(key, value);
+        }
+      }
+
+      if (!request.headers.has('x-syncular-transport-path')) {
+        request.headers.set('x-syncular-transport-path', transportPath);
+      }
+
+      return request;
+    },
+  });
+
+  return client;
+}

package/src/blob.ts

@@ -0,0 +1,95 @@
+import type { SyncTransport, SyncTransportBlobs } from '@syncular/core';
+import { SyncTransportError } from '@syncular/core';
+import { executeWithAuthRetry, getErrorMessage } from './shared';
+import {
+  createTransportApiClient,
+  createTransportAuthRetryResolver,
+  HTTP_TRANSPORT_SOURCE,
+  type HttpTransportSource,
+} from './transport-client';
+
+type HttpTransportWithSource = SyncTransport & {
+  [HTTP_TRANSPORT_SOURCE]?: HttpTransportSource;
+};
+
+export function createHttpTransportBlobs(
+  source: HttpTransportSource
+): SyncTransportBlobs {
+  const client = createTransportApiClient(source);
+  const resolveAuthRetry = createTransportAuthRetryResolver(source);
+
+  return {
+    async initiateUpload(args) {
+      const { data, error, response } = await executeWithAuthRetry(
+        (signal) => client.initiateUpload(args, signal),
+        undefined,
+        'blobInitiateUpload',
+        resolveAuthRetry
+      );
+
+      if (error || !data) {
+        throw new SyncTransportError(
+          `Blob upload init failed: ${getErrorMessage(error) || response.statusText}`,
+          response.status
+        );
+      }
+
+      return data;
+    },
+
+    async completeUpload(hash) {
+      const { data, error } = await executeWithAuthRetry(
+        (signal) => client.completeUpload(hash, signal),
+        undefined,
+        'blobCompleteUpload',
+        resolveAuthRetry
+      );
+
+      if (error || !data) {
+        return {
+          ok: false,
+          error: getErrorMessage(error) || 'Complete upload failed',
+        };
+      }
+
+      return data;
+    },
+
+    async getDownloadUrl(hash) {
+      const { data, error, response } = await executeWithAuthRetry(
+        (signal) => client.getDownloadUrl(hash, signal),
+        undefined,
+        'blobGetDownloadUrl',
+        resolveAuthRetry
+      );
+
+      if (error || !data) {
+        throw new SyncTransportError(
+          `Get download URL failed: ${getErrorMessage(error) || response.statusText}`,
+          response.status
+        );
+      }
+
+      return data;
+    },
+  };
+}
+
+export function ensureHttpTransportBlobs(
+  transport: SyncTransport
+): SyncTransportBlobs | null {
+  if (transport.blobs) {
+    return transport.blobs;
+  }
+
+  const source = (transport as HttpTransportWithSource)[HTTP_TRANSPORT_SOURCE];
+  if (!source) {
+    return null;
+  }
+
+  const blobs = createHttpTransportBlobs(source);
+  transport.blobs = blobs;
+  return blobs;
+}
+
+export type { SyncClient } from './api-client';

package/src/generated/api.ts

@@ -739,18 +739,20 @@ export interface operations {
                 "application/json": {
                     clientId: string;
                     push?: {
-                        clientCommitId: string;
-                        operations: {
-                            table: string;
-                            row_id: string;
-                            /** @enum {string} */
-                            op: "upsert" | "delete";
-                            payload: {
-                                [key: string]: unknown;
-                            } | null;
-                            base_version?: number | null;
+                        commits: {
+                            clientCommitId: string;
+                            operations: {
+                                table: string;
+                                row_id: string;
+                                /** @enum {string} */
+                                op: "upsert" | "delete";
+                                payload: {
+                                    [key: string]: unknown;
+                                } | null;
+                                base_version?: number | null;
+                            }[];
+                            schemaVersion: number;
                         }[];
-                        schemaVersion: number;
                     };
                     pull?: {
                         limitCommits: number;
@@ -791,28 +793,33 @@ export interface operations {
                         push?: {
                             /** @constant */
                             ok: true;
-                            /** @enum {string} */
-                            status: "applied" | "cached" | "rejected";
-                            commitSeq?: number;
-                            results: ({
-                                opIndex: number;
-                                /** @constant */
-                                status: "applied";
-                            } | {
-                                opIndex: number;
+                            commits: {
                                 /** @constant */
-                                status: "conflict";
-                                message: string;
-                                server_version: number;
-                                server_row: unknown;
-                            } | {
-                                opIndex: number;
-                                /** @constant */
-                                status: "error";
-                                error: string;
-                                code?: string;
-                                retriable?: boolean;
-                            })[];
+                                ok: true;
+                                /** @enum {string} */
+                                status: "applied" | "cached" | "rejected";
+                                commitSeq?: number;
+                                results: ({
+                                    opIndex: number;
+                                    /** @constant */
+                                    status: "applied";
+                                } | {
+                                    opIndex: number;
+                                    /** @constant */
+                                    status: "conflict";
+                                    message: string;
+                                    server_version: number;
+                                    server_row: unknown;
+                                } | {
+                                    opIndex: number;
+                                    /** @constant */
+                                    status: "error";
+                                    error: string;
+                                    code?: string;
+                                    retriable?: boolean;
+                                })[];
+                                clientCommitId: string;
+                            }[];
                         };
                         pull?: {
                             /** @constant */
@@ -898,7 +905,9 @@ export interface operations {
     };
     getSyncSnapshotChunksByChunkId: {
         parameters: {
-            query?: never;
+            query?: {
+                scopes?: string;
+            };
             header?: never;
             path: {
                 chunkId: string;