@tursodatabase/serverless 0.2.1 → 0.2.2

package/dist/compat.d.ts

@@ -76,11 +76,15 @@ export interface ResultSet {
  * libSQL-compatible error class with error codes.
  */
 export declare class LibsqlError extends Error {
-    /** Machine-readable error code */
+    /** Machine-readable error code (e.g., "SQLITE_CONSTRAINT") */
     code: string;
+    /** Extended error code with more specific information (e.g., "SQLITE_CONSTRAINT_PRIMARYKEY") */
+    extendedCode?: string;
     /** Raw numeric error code (if available) */
     rawCode?: number;
-    constructor(message: string, code: string, rawCode?: number);
+    /** Original error that caused this error */
+    cause?: Error;
+    constructor(message: string, code: string, extendedCode?: string, rawCode?: number, cause?: Error);
 }
 /**
  * Interactive transaction interface (not implemented in serverless mode).

package/dist/compat.js

@@ -1,13 +1,16 @@
 import { Session } from './session.js';
+import { DatabaseError } from './error.js';
 /**
  * libSQL-compatible error class with error codes.
  */
 export class LibsqlError extends Error {
-    constructor(message, code, rawCode) {
+    constructor(message, code, extendedCode, rawCode, cause) {
         super(message);
         this.name = 'LibsqlError';
         this.code = code;
+        this.extendedCode = extendedCode;
         this.rawCode = rawCode;
+        this.cause = cause;
     }
 }
 class LibSQLClient {
@@ -114,7 +117,10 @@ class LibSQLClient {
             return this.convertResult(result);
         }
         catch (error) {
-            throw new LibsqlError(error.message, "EXECUTE_ERROR");
+            if (error instanceof LibsqlError) {
+                throw error;
+            }
+            throw mapDatabaseError(error, "EXECUTE_ERROR");
         }
     }
     async batch(stmts, mode) {
@@ -131,7 +137,10 @@ class LibSQLClient {
             return [this.convertResult(result)];
         }
         catch (error) {
-            throw new LibsqlError(error.message, "BATCH_ERROR");
+            if (error instanceof LibsqlError) {
+                throw error;
+            }
+            throw mapDatabaseError(error, "BATCH_ERROR");
         }
     }
     async migrate(stmts) {
@@ -149,7 +158,10 @@ class LibSQLClient {
             await this.session.sequence(sql);
         }
         catch (error) {
-            throw new LibsqlError(error.message, "EXECUTE_MULTIPLE_ERROR");
+            if (error instanceof LibsqlError) {
+                throw error;
+            }
+            throw mapDatabaseError(error, "EXECUTE_MULTIPLE_ERROR");
         }
     }
     async sync() {
@@ -190,3 +202,63 @@ class LibSQLClient {
 export function createClient(config) {
     return new LibSQLClient(config);
 }
+// Known SQLite base error code names, used to split extended codes like
+// "SQLITE_CONSTRAINT_PRIMARYKEY" into base ("SQLITE_CONSTRAINT") and extended.
+const sqliteBaseErrorCodes = new Set([
+    "SQLITE_ERROR",
+    "SQLITE_INTERNAL",
+    "SQLITE_PERM",
+    "SQLITE_ABORT",
+    "SQLITE_BUSY",
+    "SQLITE_LOCKED",
+    "SQLITE_NOMEM",
+    "SQLITE_READONLY",
+    "SQLITE_INTERRUPT",
+    "SQLITE_IOERR",
+    "SQLITE_CORRUPT",
+    "SQLITE_NOTFOUND",
+    "SQLITE_FULL",
+    "SQLITE_CANTOPEN",
+    "SQLITE_PROTOCOL",
+    "SQLITE_EMPTY",
+    "SQLITE_SCHEMA",
+    "SQLITE_TOOBIG",
+    "SQLITE_CONSTRAINT",
+    "SQLITE_MISMATCH",
+    "SQLITE_MISUSE",
+    "SQLITE_NOLFS",
+    "SQLITE_AUTH",
+    "SQLITE_FORMAT",
+    "SQLITE_RANGE",
+    "SQLITE_NOTADB",
+    "SQLITE_NOTICE",
+    "SQLITE_WARNING",
+]);
+/**
+ * Parse a protocol error code into base and extended codes.
+ *
+ * The server may send either a base code ("SQLITE_CONSTRAINT") or an extended
+ * code ("SQLITE_CONSTRAINT_PRIMARYKEY"). This function splits them so that
+ * `code` is always the base code and `extendedCode` carries the full detail.
+ */
+function parseErrorCode(serverCode) {
+    if (sqliteBaseErrorCodes.has(serverCode)) {
+        return { code: serverCode };
+    }
+    // Try to find a base code prefix (e.g. "SQLITE_CONSTRAINT" in "SQLITE_CONSTRAINT_PRIMARYKEY")
+    for (const base of sqliteBaseErrorCodes) {
+        if (serverCode.startsWith(base + "_")) {
+            return { code: base, extendedCode: serverCode };
+        }
+    }
+    // Unknown code — return as-is
+    return { code: serverCode };
+}
+function mapDatabaseError(error, fallbackCode) {
+    if (error instanceof DatabaseError && error.code) {
+        const { code, extendedCode } = parseErrorCode(error.code);
+        return new LibsqlError(error.message, code, extendedCode, error.rawCode, error);
+    }
+    const cause = error instanceof Error ? error : undefined;
+    return new LibsqlError(error.message ?? String(error), fallbackCode, undefined, undefined, cause);
+}

package/dist/error.d.ts

@@ -1,3 +1,9 @@
 export declare class DatabaseError extends Error {
-    constructor(message: string);
+    /** Machine-readable error code (e.g., "SQLITE_CONSTRAINT") */
+    code?: string;
+    /** Raw numeric error code */
+    rawCode?: number;
+    /** Original error that caused this error */
+    cause?: Error;
+    constructor(message: string, code?: string, rawCode?: number, cause?: Error);
 }

package/dist/error.js

@@ -1,7 +1,10 @@
 export class DatabaseError extends Error {
-    constructor(message) {
+    constructor(message, code, rawCode, cause) {
         super(message);
         this.name = 'DatabaseError';
+        this.code = code;
+        this.rawCode = rawCode;
+        this.cause = cause;
         Object.setPrototypeOf(this, DatabaseError.prototype);
     }
 }

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { Connection, connect, type Config } from './connection.js';
 export { Statement } from './statement.js';
+export { Session, type SessionConfig } from './session.js';
 export { DatabaseError } from './error.js';
 export { type Column, ENCRYPTION_KEY_HEADER } from './protocol.js';

package/dist/index.js

@@ -1,5 +1,6 @@
 // Turso serverless driver entry point
 export { Connection, connect } from './connection.js';
 export { Statement } from './statement.js';
+export { Session } from './session.js';
 export { DatabaseError } from './error.js';
 export { ENCRYPTION_KEY_HEADER } from './protocol.js';

package/dist/session.js

@@ -41,7 +41,7 @@ export class Session {
         if (response.results && response.results[0]) {
             const result = response.results[0];
             if (result.type === "error") {
-                throw new DatabaseError(result.error?.message || 'Describe execution failed');
+                throw new DatabaseError(result.error?.message || 'Describe execution failed', result.error?.code);
             }
             if (result.response?.type === "describe" && result.response.result) {
                 return result.response.result;
@@ -162,7 +162,7 @@ export class Session {
                     break;
                 case 'step_error':
                 case 'error':
-                    throw new DatabaseError(entry.error?.message || 'SQL execution failed');
+                    throw new DatabaseError(entry.error?.message || 'SQL execution failed', entry.error?.code);
             }
         }
         return {
@@ -235,7 +235,7 @@ export class Session {
                     break;
                 case 'step_error':
                 case 'error':
-                    throw new DatabaseError(entry.error?.message || 'Batch execution failed');
+                    throw new DatabaseError(entry.error?.message || 'Batch execution failed', entry.error?.code);
             }
         }
         return {
@@ -266,7 +266,7 @@ export class Session {
         if (response.results && response.results[0]) {
             const result = response.results[0];
             if (result.type === "error") {
-                throw new DatabaseError(result.error?.message || 'Sequence execution failed');
+                throw new DatabaseError(result.error?.message || 'Sequence execution failed', result.error?.code);
             }
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tursodatabase/serverless",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",