feat: add better errors

Author: chrispader

package/src/NitroSQLiteError.ts

@@ -0,0 +1,52 @@
+const NITRO_SQLITE_ERROR_NAME = 'NitroSQLiteError'
+
+/**
+ * Custom error class for NitroSQLite operations
+ * Extends the native Error class with proper prototype chain and error handling
+ */
+export default class NitroSQLiteError extends Error {
+  constructor(message: string, options?: ErrorOptions) {
+    super(message, options)
+    this.name = NITRO_SQLITE_ERROR_NAME
+
+    // Maintains proper prototype chain for instanceof checks
+    Object.setPrototypeOf(this, NitroSQLiteError.prototype)
+  }
+
+  /**
+   * Converts an unknown error to a NitroSQLiteError
+   * Preserves stack traces and error causes when available
+   */
+  static fromError(error: unknown): NitroSQLiteError {
+    if (error instanceof NitroSQLiteError) {
+      return error
+    }
+
+    if (error instanceof Error) {
+      const nitroSQLiteError = new NitroSQLiteError(error.message, {
+        cause: error.cause,
+      })
+      // Preserve original stack trace if available
+      if (error.stack) {
+        nitroSQLiteError.stack = error.stack
+      }
+      return nitroSQLiteError
+    }
+
+    if (typeof error === 'string') {
+      return new NitroSQLiteError(error)
+    }
+
+    return new NitroSQLiteError('Unknown error occurred', {
+      cause: error,
+    })
+  }
+
+  /**
+   * Converts a native error (from C++ bridge) to a NitroSQLiteError
+   * Alias for fromError for semantic clarity
+   */
+  static fromNativeError(error: unknown): NitroSQLiteError {
+    return NitroSQLiteError.fromError(error)
+  }
+}

package/src/operations/execute.ts

@@ -8,6 +8,7 @@ import type {
   SQLiteQueryParams,
   QueryResultRow,
 } from '../types'
+import NitroSQLiteError from '../NitroSQLiteError'
 
 export function execute<Row extends QueryResultRow = never>(
   dbName: string,
@@ -18,13 +19,17 @@ export function execute<Row extends QueryResultRow = never>(
     ? toNativeQueryParams(params)
     : (params as NativeSQLiteQueryParams)
 
-  const nativeResult = HybridNitroSQLite.execute(
-    dbName,
-    query,
-    transformedParams
-  )
-  const result = buildJsQueryResult<Row>(nativeResult)
-  return result
+  try {
+    const nativeResult = HybridNitroSQLite.execute(
+      dbName,
+      query,
+      transformedParams
+    )
+
+    return buildJsQueryResult<Row>(nativeResult)
+  } catch (error) {
+    throw NitroSQLiteError.fromError(error)
+  }
 }
 
 export async function executeAsync<Row extends QueryResultRow = never>(
@@ -36,13 +41,16 @@ export async function executeAsync<Row extends QueryResultRow = never>(
     ? toNativeQueryParams(params)
     : (params as NativeSQLiteQueryParams)
 
-  const nativeResult = await HybridNitroSQLite.executeAsync(
-    dbName,
-    query,
-    transformedParams
-  )
-  const result = buildJsQueryResult<Row>(nativeResult)
-  return result
+  try {
+    const nativeResult = await HybridNitroSQLite.executeAsync(
+      dbName,
+      query,
+      transformedParams
+    )
+    return buildJsQueryResult<Row>(nativeResult)
+  } catch (error) {
+    throw NitroSQLiteError.fromError(error)
+  }
 }
 
 function toNativeQueryParams(