sqlite-zod-orm 3.16.0 → 3.18.0

package/dist/index.js

@@ -4429,6 +4429,26 @@ class QueryBuilder {
     this.iqo.rawWheres.push({ sql, params });
     return this;
   }
+  whereIn(column, values) {
+    if (Array.isArray(values)) {
+      const placeholders = values.map(() => "?").join(", ");
+      this.iqo.rawWheres.push({ sql: `"${column}" IN (${placeholders})`, params: values });
+    } else {
+      const inner = compileIQO(values.tableName, values.iqo);
+      this.iqo.rawWheres.push({ sql: `"${column}" IN (${inner.sql})`, params: inner.params });
+    }
+    return this;
+  }
+  whereNotIn(column, values) {
+    if (Array.isArray(values)) {
+      const placeholders = values.map(() => "?").join(", ");
+      this.iqo.rawWheres.push({ sql: `"${column}" NOT IN (${placeholders})`, params: values });
+    } else {
+      const inner = compileIQO(values.tableName, values.iqo);
+      this.iqo.rawWheres.push({ sql: `"${column}" NOT IN (${inner.sql})`, params: inner.params });
+    }
+    return this;
+  }
   with(...relations) {
     this.iqo.includes.push(...relations);
     return this;
@@ -5449,6 +5469,72 @@ class _Database {
   columns(tableName) {
     return this.db.query(`PRAGMA table_info("${tableName}")`).all();
   }
+  dump() {
+    const result = {};
+    for (const tableName of Object.keys(this.schemas)) {
+      result[tableName] = this.db.query(`SELECT * FROM "${tableName}"`).all();
+    }
+    return result;
+  }
+  load(data, options) {
+    const txn = this.db.transaction(() => {
+      for (const [tableName, rows] of Object.entries(data)) {
+        if (!this.schemas[tableName])
+          continue;
+        if (!options?.append) {
+          this.db.run(`DELETE FROM "${tableName}"`);
+        }
+        for (const row of rows) {
+          const cols = Object.keys(row).filter((k) => k !== "id");
+          const placeholders = cols.map(() => "?").join(", ");
+          const values = cols.map((c) => {
+            const v = row[c];
+            if (v !== null && v !== undefined && typeof v === "object" && !(v instanceof Buffer)) {
+              return JSON.stringify(v);
+            }
+            return v;
+          });
+          this.db.query(`INSERT INTO "${tableName}" (${cols.map((c) => `"${c}"`).join(", ")}) VALUES (${placeholders})`).run(...values);
+        }
+      }
+    });
+    txn();
+  }
+  seed(fixtures) {
+    this.load(fixtures, { append: true });
+  }
+  diff() {
+    const result = {};
+    const systemCols = new Set(["id", "createdAt", "updatedAt", "deletedAt"]);
+    for (const [tableName, schema] of Object.entries(this.schemas)) {
+      const schemaFields = getStorableFields(schema);
+      const schemaColMap = new Map(schemaFields.map((f) => [f.name, zodTypeToSqlType(f.type)]));
+      const liveColumns = this.columns(tableName);
+      const liveColMap = new Map(liveColumns.map((c) => [c.name, c.type]));
+      const added = [];
+      const removed = [];
+      const typeChanged = [];
+      for (const [col, expectedType] of schemaColMap) {
+        if (!liveColMap.has(col)) {
+          added.push(col);
+        } else {
+          const actualType = liveColMap.get(col);
+          if (actualType !== expectedType) {
+            typeChanged.push({ column: col, expected: expectedType, actual: actualType });
+          }
+        }
+      }
+      for (const col of liveColMap.keys()) {
+        if (!systemCols.has(col) && !schemaColMap.has(col)) {
+          removed.push(col);
+        }
+      }
+      if (added.length > 0 || removed.length > 0 || typeChanged.length > 0) {
+        result[tableName] = { added, removed, typeChanged };
+      }
+    }
+    return result;
+  }
 }
 var Database = _Database;
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sqlite-zod-orm",
-  "version": "3.16.0",
+  "version": "3.18.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

@@ -231,6 +231,39 @@ export class QueryBuilder<T extends Record<string, any>, TResult extends Record<
         return this;
     }
 
+    /**
+     * Filter by column value being in a list or subquery.
+     * ```ts
+     * db.users.select().whereIn('id', [1, 2, 3]).all()
+     * db.users.select().whereIn('id', db.orders.select('userId')).all()
+     * ```
+     */
+    whereIn(column: keyof T & string, values: any[] | QueryBuilder<any, any>): this {
+        if (Array.isArray(values)) {
+            const placeholders = values.map(() => '?').join(', ');
+            this.iqo.rawWheres.push({ sql: `"${column}" IN (${placeholders})`, params: values });
+        } else {
+            // Subquery: compile the inner QueryBuilder's IQO
+            const inner = compileIQO((values as any).tableName, (values as any).iqo);
+            this.iqo.rawWheres.push({ sql: `"${column}" IN (${inner.sql})`, params: inner.params });
+        }
+        return this;
+    }
+
+    /**
+     * Filter by column value NOT being in a list or subquery.
+     */
+    whereNotIn(column: keyof T & string, values: any[] | QueryBuilder<any, any>): this {
+        if (Array.isArray(values)) {
+            const placeholders = values.map(() => '?').join(', ');
+            this.iqo.rawWheres.push({ sql: `"${column}" NOT IN (${placeholders})`, params: values });
+        } else {
+            const inner = compileIQO((values as any).tableName, (values as any).iqo);
+            this.iqo.rawWheres.push({ sql: `"${column}" NOT IN (${inner.sql})`, params: inner.params });
+        }
+        return this;
+    }
+
     /**
      * Eagerly load a related entity and attach as an array property.
      *

package/src/database.ts

@@ -420,6 +420,109 @@ class _Database<Schemas extends SchemaMap> {
     public columns(tableName: string): { name: string; type: string; notnull: number; pk: number }[] {
         return this.db.query(`PRAGMA table_info("${tableName}")`).all() as any[];
     }
+
+    // =========================================================================
+    // Data Import / Export
+    // =========================================================================
+
+    /**
+     * Export all data as a JSON-serializable object.
+     * Each key is a table name, value is an array of raw row objects.
+     */
+    public dump(): Record<string, any[]> {
+        const result: Record<string, any[]> = {};
+        for (const tableName of Object.keys(this.schemas)) {
+            result[tableName] = this.db.query(`SELECT * FROM "${tableName}"`).all();
+        }
+        return result;
+    }
+
+    /**
+     * Import data from a dump object. Truncates existing data first.
+     * Use `{ append: true }` to insert without truncating.
+     */
+    public load(data: Record<string, any[]>, options?: { append?: boolean }): void {
+        const txn = this.db.transaction(() => {
+            for (const [tableName, rows] of Object.entries(data)) {
+                if (!this.schemas[tableName]) continue;
+                if (!options?.append) {
+                    this.db.run(`DELETE FROM "${tableName}"`);
+                }
+                for (const row of rows) {
+                    const cols = Object.keys(row).filter(k => k !== 'id');
+                    const placeholders = cols.map(() => '?').join(', ');
+                    const values = cols.map(c => {
+                        const v = row[c];
+                        // Auto-serialize objects/arrays
+                        if (v !== null && v !== undefined && typeof v === 'object' && !(v instanceof Buffer)) {
+                            return JSON.stringify(v);
+                        }
+                        return v;
+                    });
+                    this.db.query(`INSERT INTO "${tableName}" (${cols.map(c => `"${c}"`).join(', ')}) VALUES (${placeholders})`).run(...values);
+                }
+            }
+        });
+        txn();
+    }
+
+    /**
+     * Seed tables with fixture data. Each key is a table name, value is an
+     * array of records to insert. Does NOT truncate — use for additive seeding.
+     */
+    public seed(fixtures: Record<string, Record<string, any>[]>): void {
+        this.load(fixtures, { append: true });
+    }
+
+    // =========================================================================
+    // Schema Diffing
+    // =========================================================================
+
+    /**
+     * Compare Zod schemas against the live SQLite table structure.
+     * Returns a diff object per table: { added, removed, typeChanged }.
+     */
+    public diff(): Record<string, { added: string[]; removed: string[]; typeChanged: { column: string; expected: string; actual: string }[] }> {
+        const result: Record<string, { added: string[]; removed: string[]; typeChanged: { column: string; expected: string; actual: string }[] }> = {};
+        const systemCols = new Set(['id', 'createdAt', 'updatedAt', 'deletedAt']);
+
+        for (const [tableName, schema] of Object.entries(this.schemas)) {
+            const schemaFields = getStorableFields(schema);
+            const schemaColMap = new Map(schemaFields.map(f => [f.name, zodTypeToSqlType(f.type)]));
+
+            const liveColumns = this.columns(tableName);
+            const liveColMap = new Map(liveColumns.map(c => [c.name, c.type]));
+
+            const added: string[] = [];
+            const removed: string[] = [];
+            const typeChanged: { column: string; expected: string; actual: string }[] = [];
+
+            // Columns in schema but not in live DB
+            for (const [col, expectedType] of schemaColMap) {
+                if (!liveColMap.has(col)) {
+                    added.push(col);
+                } else {
+                    const actualType = liveColMap.get(col)!;
+                    if (actualType !== expectedType) {
+                        typeChanged.push({ column: col, expected: expectedType, actual: actualType });
+                    }
+                }
+            }
+
+            // Columns in live DB but not in schema (excluding system columns)
+            for (const col of liveColMap.keys()) {
+                if (!systemCols.has(col) && !schemaColMap.has(col)) {
+                    removed.push(col);
+                }
+            }
+
+            if (added.length > 0 || removed.length > 0 || typeChanged.length > 0) {
+                result[tableName] = { added, removed, typeChanged };
+            }
+        }
+
+        return result;
+    }
 }
 
 // =============================================================================