@syncular/client 0.30.6 → 0.30.7

package/dist/client.js

@@ -2327,7 +2327,8 @@ export class SyncClient {
             };
             this.#emitDiagnostics();
             return summary;
-        }, (error) => {
+        }, (caught) => {
+            const error = classifySqliteFailure(caught).error;
             const completedAtMs = this.#now();
             const code = error.code;
             this.#progress.update({

package/dist/database.d.ts

@@ -63,4 +63,7 @@ export declare function assertImageAlias(alias: string): void;
  */
 export declare function runTransaction<T>(depthHolder: {
     depth: number;
+    aborted?: {
+        error: unknown;
+    };
 }, run: (sql: string) => void, fn: () => T): T;

package/dist/database.js

@@ -1,3 +1,4 @@
+import { classifySqliteFailure } from './errors.js';
 /** Attach-schema aliases are code-chosen, never user input — enforce it. */
 export function assertImageAlias(alias) {
     if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(alias)) {
@@ -10,6 +11,10 @@ export function assertImageAlias(alias) {
  */
 export function runTransaction(depthHolder, run, fn) {
     const depth = depthHolder.depth;
+    if (depth === 0)
+        delete depthHolder.aborted;
+    else if (depthHolder.aborted)
+        throw depthHolder.aborted.error;
     const savepoint = `syncular_sp_${depth}`;
     if (depth === 0)
         run('BEGIN');
@@ -18,6 +23,9 @@ export function runTransaction(depthHolder, run, fn) {
     depthHolder.depth = depth + 1;
     try {
         const result = fn();
+        const aborted = depthHolder.aborted;
+        if (aborted)
+            throw aborted.error;
         depthHolder.depth = depth;
         if (depth === 0)
             run('COMMIT');
@@ -25,15 +33,26 @@ export function runTransaction(depthHolder, run, fn) {
             run(`RELEASE ${savepoint}`);
         return result;
     }
-    catch (error) {
+    catch (caught) {
+        const aborted = depthHolder.aborted;
+        const error = aborted?.error ?? caught;
         depthHolder.depth = depth;
-        if (depth === 0) {
-            run('ROLLBACK');
+        try {
+            if (depth === 0)
+                run('ROLLBACK');
+            else {
+                run(`ROLLBACK TO ${savepoint}`);
+                run(`RELEASE ${savepoint}`);
+            }
         }
-        else {
-            run(`ROLLBACK TO ${savepoint}`);
-            run(`RELEASE ${savepoint}`);
+        catch (rollbackError) {
+            // SQLite can end the whole transaction after SQLITE_FULL or SQLITE_IOERR.
+            // Poison remaining nested scopes until the outer owner unwinds.
+            depthHolder.aborted = { error };
+            if (error instanceof Error && !('rollbackError' in error)) {
+                Object.defineProperty(error, 'rollbackError', { value: rollbackError });
+            }
         }
-        throw error;
+        throw classifySqliteFailure(error).error;
     }
 }

package/dist/diagnostics.d.ts

@@ -113,7 +113,7 @@ export interface DiagnosticQueryFailure {
     readonly id: string;
     /** Distinct generated table names the query depends on, ascending. */
     readonly tables: readonly string[];
-    readonly code: 'client.storage_corrupt' | 'client.storage_io' | 'client.query_failed';
+    readonly code: 'client.storage_corrupt' | 'client.storage_full' | 'client.storage_io' | 'client.query_failed';
     /** SQLite extended result code, when the driver exposed one. */
     readonly sqliteCode?: number;
     /** First failure since this id's last successful read. */

package/dist/errors.d.ts

@@ -5,6 +5,8 @@ export declare const STORAGE_BUSY_CODE = "client.storage_busy";
 export declare const STORAGE_UNAVAILABLE_CODE = "client.storage_unavailable";
 /** A local read hit SQLITE_CORRUPT or SQLITE_NOTADB (SPEC §7.5). */
 export declare const STORAGE_CORRUPT_CODE = "client.storage_corrupt";
+/** Local SQLite storage has no space for the write. */
+export declare const STORAGE_FULL_CODE = "client.storage_full";
 /** A local read hit SQLITE_IOERR (SPEC §7.5). */
 export declare const STORAGE_IO_CODE = "client.storage_io";
 /** SPEC §8.8: a round under `realtimePolicy: 'required'` found no socket. */
@@ -61,6 +63,6 @@ export declare class RealtimeUnavailableError extends ClientSyncError {
  */
 export declare function classifySqliteFailure(error: unknown): {
     readonly sqliteCode: number | undefined;
-    readonly code: typeof STORAGE_CORRUPT_CODE | typeof STORAGE_IO_CODE | undefined;
+    readonly code: typeof STORAGE_CORRUPT_CODE | typeof STORAGE_FULL_CODE | typeof STORAGE_IO_CODE | undefined;
     readonly error: unknown;
 };

package/dist/errors.js

@@ -4,6 +4,8 @@ export const STORAGE_BUSY_CODE = 'client.storage_busy';
 export const STORAGE_UNAVAILABLE_CODE = 'client.storage_unavailable';
 /** A local read hit SQLITE_CORRUPT or SQLITE_NOTADB (SPEC §7.5). */
 export const STORAGE_CORRUPT_CODE = 'client.storage_corrupt';
+/** Local SQLite storage has no space for the write. */
+export const STORAGE_FULL_CODE = 'client.storage_full';
 /** A local read hit SQLITE_IOERR (SPEC §7.5). */
 export const STORAGE_IO_CODE = 'client.storage_io';
 /** SPEC §8.8: a round under `realtimePolicy: 'required'` found no socket. */
@@ -73,6 +75,31 @@ export class RealtimeUnavailableError extends ClientSyncError {
  * original value.
  */
 export function classifySqliteFailure(error) {
+    if (error instanceof ClientSyncError) {
+        const sqliteCode = error.details?.sqliteCode;
+        let retained = error;
+        if ('rollbackError' in error &&
+            error.details?.rollbackFailure === undefined) {
+            const rollback = error.rollbackError;
+            retained = new ClientSyncError(error.code, error.message, error.retryable, {
+                ...error.details,
+                rollbackFailure: {
+                    message: rollback instanceof Error ? rollback.message : String(rollback),
+                    sqliteCode: classifySqliteFailure(rollback).sqliteCode,
+                },
+            });
+            Object.defineProperty(retained, 'cause', { value: error });
+        }
+        return {
+            sqliteCode: typeof sqliteCode === 'number' ? sqliteCode : undefined,
+            code: error.code === STORAGE_FULL_CODE ||
+                error.code === STORAGE_IO_CODE ||
+                error.code === STORAGE_CORRUPT_CODE
+                ? error.code
+                : undefined,
+            error: retained,
+        };
+    }
     const sqliteCode = error instanceof Error
         ? error.name === 'SQLiteError' &&
             'errno' in error &&
@@ -87,19 +114,34 @@ export function classifySqliteFailure(error) {
                     : undefined
         : undefined;
     const primary = sqliteCode === undefined ? undefined : sqliteCode & 0xff;
-    if (primary === 11 || primary === 26) {
-        return {
-            sqliteCode,
-            code: STORAGE_CORRUPT_CODE,
-            error: new ClientSyncError(STORAGE_CORRUPT_CODE, 'local SQLite storage is corrupt'),
-        };
-    }
-    if (primary === 10) {
-        return {
-            sqliteCode,
-            code: STORAGE_IO_CODE,
-            error: new ClientSyncError(STORAGE_IO_CODE, 'local SQLite storage I/O failed'),
-        };
-    }
-    return { sqliteCode, code: undefined, error };
+    const code = primary === 13
+        ? STORAGE_FULL_CODE
+        : primary === 10
+            ? STORAGE_IO_CODE
+            : primary === 11 || primary === 26
+                ? STORAGE_CORRUPT_CODE
+                : undefined;
+    if (code === undefined)
+        return { sqliteCode, code, error };
+    const rollback = error instanceof Error && 'rollbackError' in error
+        ? error.rollbackError
+        : undefined;
+    const failure = new ClientSyncError(code, primary === 13
+        ? 'local SQLite storage is full'
+        : primary === 10
+            ? 'local SQLite storage I/O failed'
+            : 'local SQLite storage is corrupt', false, {
+        sqliteCode,
+        sqliteMessage: error instanceof Error ? error.message : String(error),
+        ...(rollback !== undefined
+            ? {
+                rollbackFailure: {
+                    message: rollback instanceof Error ? rollback.message : String(rollback),
+                    sqliteCode: classifySqliteFailure(rollback).sqliteCode,
+                },
+            }
+            : {}),
+    });
+    Object.defineProperty(failure, 'cause', { value: error });
+    return { sqliteCode, code, error: failure };
 }

package/dist/worker-entry.js

@@ -16,11 +16,12 @@
 import { SyncClient } from './client.js';
 import { withClientDiagnosticsHost, } from './diagnostics.js';
 import { encryptionConfigFromKeyring } from './encryption.js';
-import { ClientSyncError, STORAGE_BUSY_CODE } from './errors.js';
+import { classifySqliteFailure, ClientSyncError, STORAGE_BUSY_CODE, } from './errors.js';
 import { httpBlobTransport, httpSegmentDownloader, httpSyncTransport, webSocketRealtimeConnector, } from './http.js';
 import { openPersistentWasmDatabase } from './wasm-database.js';
 import { WORKER_FAILED_CODE, } from './worker-protocol.js';
-function toErrorShape(error) {
+function toErrorShape(caught) {
+    const error = classifySqliteFailure(caught).error;
     if (error instanceof ClientSyncError) {
         return {
             code: error.code,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/client",
-  "version": "0.30.6",
+  "version": "0.30.7",
   "description": "Syncular TypeScript client core — offline-first sync over SQLite (WASM/OPFS, Bun, Node)",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -89,10 +89,10 @@
   },
   "dependencies": {
     "@sqlite.org/sqlite-wasm": "^3.53.0-build1",
-    "@syncular/core": "0.30.6"
+    "@syncular/core": "0.30.7"
   },
   "devDependencies": {
-    "@syncular/server": "0.30.6",
+    "@syncular/server": "0.30.7",
     "playwright": "1.63.0"
   }
 }

package/src/client.ts

@@ -3391,7 +3391,8 @@ export class SyncClient {
           this.#emitDiagnostics();
           return summary;
         },
-        (error: unknown) => {
+        (caught: unknown) => {
+          const error = classifySqliteFailure(caught).error;
           const completedAtMs = this.#now();
           const code = (error as { code?: unknown }).code;
           this.#progress.update({

package/src/database.ts

@@ -1,3 +1,5 @@
+import { classifySqliteFailure } from './errors';
+
 /**
  * Storage abstraction: the client core runs on any SQLite that
  * implements this minimal synchronous surface. Tests use bun:sqlite
@@ -75,29 +77,43 @@ export function assertImageAlias(alias: string): void {
  * `run` executes a parameterless statement.
  */
 export function runTransaction<T>(
-  depthHolder: { depth: number },
+  depthHolder: { depth: number; aborted?: { error: unknown } },
   run: (sql: string) => void,
   fn: () => T,
 ): T {
   const depth = depthHolder.depth;
+  if (depth === 0) delete depthHolder.aborted;
+  else if (depthHolder.aborted) throw depthHolder.aborted.error;
   const savepoint = `syncular_sp_${depth}`;
   if (depth === 0) run('BEGIN');
   else run(`SAVEPOINT ${savepoint}`);
   depthHolder.depth = depth + 1;
   try {
     const result = fn();
+    const aborted = depthHolder.aborted as { error: unknown } | undefined;
+    if (aborted) throw aborted.error;
     depthHolder.depth = depth;
     if (depth === 0) run('COMMIT');
     else run(`RELEASE ${savepoint}`);
     return result;
-  } catch (error) {
+  } catch (caught) {
+    const aborted = depthHolder.aborted as { error: unknown } | undefined;
+    const error = aborted?.error ?? caught;
     depthHolder.depth = depth;
-    if (depth === 0) {
-      run('ROLLBACK');
-    } else {
-      run(`ROLLBACK TO ${savepoint}`);
-      run(`RELEASE ${savepoint}`);
+    try {
+      if (depth === 0) run('ROLLBACK');
+      else {
+        run(`ROLLBACK TO ${savepoint}`);
+        run(`RELEASE ${savepoint}`);
+      }
+    } catch (rollbackError) {
+      // SQLite can end the whole transaction after SQLITE_FULL or SQLITE_IOERR.
+      // Poison remaining nested scopes until the outer owner unwinds.
+      depthHolder.aborted = { error };
+      if (error instanceof Error && !('rollbackError' in error)) {
+        Object.defineProperty(error, 'rollbackError', { value: rollbackError });
+      }
     }
-    throw error;
+    throw classifySqliteFailure(error).error;
   }
 }

package/src/diagnostics.ts

@@ -151,6 +151,7 @@ export interface DiagnosticQueryFailure {
   readonly tables: readonly string[];
   readonly code:
     | 'client.storage_corrupt'
+    | 'client.storage_full'
     | 'client.storage_io'
     | 'client.query_failed';
   /** SQLite extended result code, when the driver exposed one. */

package/src/errors.ts

@@ -9,6 +9,9 @@ export const STORAGE_UNAVAILABLE_CODE = 'client.storage_unavailable';
 /** A local read hit SQLITE_CORRUPT or SQLITE_NOTADB (SPEC §7.5). */
 export const STORAGE_CORRUPT_CODE = 'client.storage_corrupt';
 
+/** Local SQLite storage has no space for the write. */
+export const STORAGE_FULL_CODE = 'client.storage_full';
+
 /** A local read hit SQLITE_IOERR (SPEC §7.5). */
 export const STORAGE_IO_CODE = 'client.storage_io';
 
@@ -107,10 +110,45 @@ export function classifySqliteFailure(error: unknown): {
   readonly sqliteCode: number | undefined;
   readonly code:
     | typeof STORAGE_CORRUPT_CODE
+    | typeof STORAGE_FULL_CODE
     | typeof STORAGE_IO_CODE
     | undefined;
   readonly error: unknown;
 } {
+  if (error instanceof ClientSyncError) {
+    const sqliteCode = error.details?.sqliteCode;
+    let retained = error;
+    if (
+      'rollbackError' in error &&
+      error.details?.rollbackFailure === undefined
+    ) {
+      const rollback = error.rollbackError;
+      retained = new ClientSyncError(
+        error.code,
+        error.message,
+        error.retryable,
+        {
+          ...error.details,
+          rollbackFailure: {
+            message:
+              rollback instanceof Error ? rollback.message : String(rollback),
+            sqliteCode: classifySqliteFailure(rollback).sqliteCode,
+          },
+        },
+      );
+      Object.defineProperty(retained, 'cause', { value: error });
+    }
+    return {
+      sqliteCode: typeof sqliteCode === 'number' ? sqliteCode : undefined,
+      code:
+        error.code === STORAGE_FULL_CODE ||
+        error.code === STORAGE_IO_CODE ||
+        error.code === STORAGE_CORRUPT_CODE
+          ? error.code
+          : undefined,
+      error: retained,
+    };
+  }
   const sqliteCode =
     error instanceof Error
       ? error.name === 'SQLiteError' &&
@@ -126,25 +164,41 @@ export function classifySqliteFailure(error: unknown): {
             : undefined
       : undefined;
   const primary = sqliteCode === undefined ? undefined : sqliteCode & 0xff;
-  if (primary === 11 || primary === 26) {
-    return {
-      sqliteCode,
-      code: STORAGE_CORRUPT_CODE,
-      error: new ClientSyncError(
-        STORAGE_CORRUPT_CODE,
-        'local SQLite storage is corrupt',
-      ),
-    };
-  }
-  if (primary === 10) {
-    return {
+  const code =
+    primary === 13
+      ? STORAGE_FULL_CODE
+      : primary === 10
+        ? STORAGE_IO_CODE
+        : primary === 11 || primary === 26
+          ? STORAGE_CORRUPT_CODE
+          : undefined;
+  if (code === undefined) return { sqliteCode, code, error };
+  const rollback =
+    error instanceof Error && 'rollbackError' in error
+      ? error.rollbackError
+      : undefined;
+  const failure = new ClientSyncError(
+    code,
+    primary === 13
+      ? 'local SQLite storage is full'
+      : primary === 10
+        ? 'local SQLite storage I/O failed'
+        : 'local SQLite storage is corrupt',
+    false,
+    {
       sqliteCode,
-      code: STORAGE_IO_CODE,
-      error: new ClientSyncError(
-        STORAGE_IO_CODE,
-        'local SQLite storage I/O failed',
-      ),
-    };
-  }
-  return { sqliteCode, code: undefined, error };
+      sqliteMessage: error instanceof Error ? error.message : String(error),
+      ...(rollback !== undefined
+        ? {
+            rollbackFailure: {
+              message:
+                rollback instanceof Error ? rollback.message : String(rollback),
+              sqliteCode: classifySqliteFailure(rollback).sqliteCode,
+            },
+          }
+        : {}),
+    },
+  );
+  Object.defineProperty(failure, 'cause', { value: error });
+  return { sqliteCode, code, error: failure };
 }

package/src/worker-entry.ts

@@ -20,7 +20,11 @@ import {
   withClientDiagnosticsHost,
 } from './diagnostics';
 import { encryptionConfigFromKeyring } from './encryption';
-import { ClientSyncError, STORAGE_BUSY_CODE } from './errors';
+import {
+  classifySqliteFailure,
+  ClientSyncError,
+  STORAGE_BUSY_CODE,
+} from './errors';
 import {
   httpBlobTransport,
   httpSegmentDownloader,
@@ -77,7 +81,8 @@ interface WorkerScope {
   ): void;
 }
 
-function toErrorShape(error: unknown): WorkerErrorShape {
+function toErrorShape(caught: unknown): WorkerErrorShape {
+  const error = classifySqliteFailure(caught).error;
   if (error instanceof ClientSyncError) {
     return {
       code: error.code,