sqlite-zod-orm 3.20.0 → 3.22.0

package/dist/index.js

@@ -4493,6 +4493,12 @@ class QueryBuilder {
   first() {
     return this.get();
   }
+  firstOrFail() {
+    const row = this.get();
+    if (row === null)
+      throw new Error("No matching row found");
+    return row;
+  }
   exists() {
     const { sql: selectSql, params } = compileIQO(this.tableName, this.iqo);
     const existsSql = selectSql.replace(/^SELECT .+? FROM/, "SELECT 1 FROM").replace(/ LIMIT \d+/, "") + " LIMIT 1";
@@ -4572,6 +4578,20 @@ class QueryBuilder {
     const aggSql = selectSql.replace(/^SELECT .+? FROM/, `SELECT ${groupCols}, COUNT(*) as count FROM`);
     return this.executor(aggSql, params, true);
   }
+  toSQL() {
+    return compileIQO(this.tableName, this.iqo);
+  }
+  pluck(column) {
+    const { sql: selectSql, params } = compileIQO(this.tableName, this.iqo);
+    const pluckSql = selectSql.replace(/^SELECT .+? FROM/, `SELECT "${column}" FROM`);
+    const results = this.executor(pluckSql, params, true);
+    return results.map((r) => r[column]);
+  }
+  clone() {
+    const cloned = new QueryBuilder(this.tableName, this.executor, this.singleExecutor, this.joinResolver, this.conditionResolver, this.eagerLoader);
+    cloned.iqo = JSON.parse(JSON.stringify(this.iqo));
+    return cloned;
+  }
   updateAll(data) {
     const { sql: selectSql, params } = compileIQO(this.tableName, this.iqo);
     const whereMatch = selectSql.match(/WHERE (.+?)(?:\s+ORDER|\s+LIMIT|\s+GROUP|\s+HAVING|$)/s);
@@ -5235,7 +5255,8 @@ class _Database {
   _pollInterval;
   constructor(dbFile, schemas, options = {}) {
     this.db = new SqliteDatabase(dbFile);
-    this.db.run("PRAGMA journal_mode = WAL");
+    if (options.wal !== false)
+      this.db.run("PRAGMA journal_mode = WAL");
     this.db.run("PRAGMA foreign_keys = ON");
     this.schemas = schemas;
     this.options = options;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sqlite-zod-orm",
-  "version": "3.20.0",
+  "version": "3.22.0",
   "description": "Type-safe SQLite ORM for Bun — Zod schemas, fluent queries, auto relationships, zero SQL",
   "type": "module",
   "main": "./dist/index.js",

package/src/builder.ts

@@ -330,6 +330,19 @@ export class QueryBuilder<T extends Record<string, any>, TResult extends Record<
         return this.get();
     }
 
+    /**
+     * Return the first matching row or throw if none found.
+     * ```ts
+     * const user = db.users.select().where({ id: 1 }).firstOrFail();
+     * // throws Error('No matching row found') if id=1 doesn't exist
+     * ```
+     */
+    firstOrFail(): TResult {
+        const row = this.get();
+        if (row === null) throw new Error('No matching row found');
+        return row;
+    }
+
     /** Returns true if at least one row matches the query. */
     exists(): boolean {
         const { sql: selectSql, params } = compileIQO(this.tableName, this.iqo);
@@ -465,6 +478,49 @@ export class QueryBuilder<T extends Record<string, any>, TResult extends Record<
         return this.executor(aggSql, params, true) as any;
     }
 
+    // ---------- Query Inspection ----------
+
+    /**
+     * Compile and return the SQL string + params without executing.
+     * ```ts
+     * db.users.select().where({ role: 'admin' }).toSQL()
+     * // → { sql: 'SELECT * FROM "users" WHERE "role" = ?', params: ['admin'] }
+     * ```
+     */
+    toSQL(): { sql: string; params: any[] } {
+        return compileIQO(this.tableName, this.iqo);
+    }
+
+    // ---------- Convenience Methods ----------
+
+    /**
+     * Return a flat array of values for a single column.
+     * ```ts
+     * db.users.select().pluck('name') // → ['Alice', 'Bob', 'Charlie']
+     * ```
+     */
+    pluck(column: keyof T & string): any[] {
+        const { sql: selectSql, params } = compileIQO(this.tableName, this.iqo);
+        const pluckSql = selectSql.replace(/^SELECT .+? FROM/, `SELECT "${column}" FROM`);
+        const results = this.executor(pluckSql, params, true);
+        return results.map((r: any) => r[column]);
+    }
+
+    /** Clone this QueryBuilder so you can fork a query. */
+    clone(): QueryBuilder<T, TResult> {
+        const cloned = new QueryBuilder<T, TResult>(
+            this.tableName,
+            this.executor,
+            this.singleExecutor,
+            this.joinResolver,
+            this.conditionResolver,
+            this.eagerLoader,
+        );
+        // Deep-copy the IQO state
+        (cloned as any).iqo = JSON.parse(JSON.stringify(this.iqo));
+        return cloned;
+    }
+
     // ---------- Batch Mutations ----------
 
     /**

package/src/database.ts

@@ -65,7 +65,7 @@ class _Database<Schemas extends SchemaMap> {
 
     constructor(dbFile: string, schemas: Schemas, options: DatabaseOptions = {}) {
         this.db = new SqliteDatabase(dbFile);
-        this.db.run('PRAGMA journal_mode = WAL');
+        if (options.wal !== false) this.db.run('PRAGMA journal_mode = WAL');
         this.db.run('PRAGMA foreign_keys = ON');
         this.schemas = schemas;
         this.options = options;

package/src/types.ts

@@ -75,6 +75,12 @@ export type DatabaseOptions<R extends RelationsConfig = RelationsConfig> = {
      * Default: `false`.
      */
     debug?: boolean;
+    /**
+     * Enable WAL (Write-Ahead Logging) journal mode for better
+     * concurrent read/write performance. Recommended for production.
+     * Default: `false`.
+     */
+    wal?: boolean;
     /**
      * Lifecycle hooks per table. Each hook receives data and can transform it.
      *