bun-query-builder 0.2.38 → 0.2.40

package/dist/actions/schema-drift.d.ts

@@ -11,7 +11,7 @@ export declare function familyOfSqlType(sqlType: string): TypeFamily;
  * model asking for `varchar` is content in a `text` column, because nothing is
  * lost. The reverse is exactly the bug this exists to find.
  */
-export declare function satisfies(declared: TypeFamily, actual: TypeFamily): boolean;
+export declare function satisfies(declared: TypeFamily, actual: TypeFamily, dialect?: SupportedDialect): boolean;
 /**
  * Audit the live database against a migration plan.
  *

package/dist/bin/cli.js

@@ -12290,14 +12290,29 @@ function getOrCreateBunSql(forceNew = false) {
   const signature = connectionSignature();
   const configChanged = _bunSqlInstance !== null && _currentSignature !== signature;
   if (forceNew || configChanged || !_bunSqlInstance) {
+    if (_bunSqlInstance)
+      resetConnection();
     _bunSqlInstance = getBunSql();
     _currentSignature = signature;
   }
   return _bunSqlInstance;
 }
-function resetConnection() {
+function detachCachedConnection() {
+  const connection = _bunSqlInstance;
   _bunSqlInstance = null;
   _currentSignature = null;
+  return connection;
+}
+async function closeSqlConnection(connection) {
+  if (!connection || typeof connection.close !== "function")
+    return;
+  await connection.close();
+}
+function resetConnection() {
+  const closing = closeSqlConnection(detachCachedConnection());
+  closing.catch((error) => {
+    console.error(`[query-builder] Failed to close database connection: ${error.message}`);
+  });
 }
 async function withFreshConnection(fn) {
   try {
@@ -30154,9 +30169,15 @@ function familyOfSqlType(sqlType) {
     return "integer";
   return "other";
 }
-function satisfies(declared, actual) {
+function satisfies(declared, actual, dialect) {
   if (declared === actual)
     return true;
+  if (dialect === "sqlite") {
+    if (declared === "boolean" && actual === "integer")
+      return true;
+    if ((declared === "date" || declared === "json") && actual === "text")
+      return true;
+  }
   if (declared === "varchar" && actual === "text")
     return true;
   if (declared === "integer" && actual === "fractional")
@@ -30188,7 +30209,7 @@ async function auditSchemaDrift(plan, options = {}) {
         continue;
       }
       const actual = familyOfSqlType(liveColumn.sqlType);
-      if (!satisfies(declared, actual)) {
+      if (!satisfies(declared, actual, dialect)) {
         typeMismatches.push({
           table: table.table,
           column: column.name,
@@ -32333,7 +32354,7 @@ function getPrefix() {
 }
 var prefix = getPrefix();
 // package.json
-var version2 = "0.2.38";
+var version2 = "0.2.40";
 
 // bin/cli.ts
 init_actions();

package/dist/db.d.ts

@@ -72,6 +72,13 @@ export declare function resolvePoolOptions(pool?: PoolConfig): {
  */
 export declare function getBunSql(): SQL;
 export declare function getOrCreateBunSql(forceNew?: boolean): SQL;
+/**
+ * Close and discard the cached connection.
+ *
+ * Use this when the caller needs to know the pool has fully drained before
+ * opening another connection, such as test teardown or a graceful shutdown.
+ */
+export declare function closeConnection(): Promise<void>;
 /**
  * Resets the cached database connection.
  * Call this after changing config via setConfig() to ensure the new config is used.

package/dist/orm.d.ts

@@ -199,6 +199,11 @@ declare interface StaticWhereOverloads<TDef extends ModelDefinition> {
     column: K,
     value: K extends keyof ModelAttributes<TDef> ? ModelAttributes<TDef>[K] : unknown
   ): ModelQueryBuilder<TDef>
+  where<K extends ColumnName<TDef>>(
+    column: K,
+    operator: 'in' | 'not in',
+    value: ReadonlyArray<K extends keyof ModelAttributes<TDef> ? ModelAttributes<TDef>[K] : unknown>
+  ): ModelQueryBuilder<TDef>
   where<K extends ColumnName<TDef>>(
     column: K,
     operator: WhereOperator,
@@ -357,8 +362,21 @@ declare type FillableKeys<TDef extends ModelDefinition> = {
  * from `attributes`, so without this every such create was a type error
  * against the one column the relation exists to set.
  */
+/**
+ * What `create` / `update` accept.
+ *
+ * `null` is allowed alongside each column's own type because a write is how a
+ * nullable column gets CLEARED, and that is a different instruction from
+ * leaving the field out. Without it, a caller assembling an update payload -
+ * `{ subject: form.subject ?? null }` is the ordinary shape - had to choose
+ * between a type error and `undefined`, and `undefined` silently means "do not
+ * touch this column", so the field the user cleared stayed as it was.
+ *
+ * The database's own nullability is still the authority: writing null to a NOT
+ * NULL column fails there, as it should.
+ */
 declare type FillableAttributes<TDef extends ModelDefinition> = Partial<Pick<
-  ModelAttributes<TDef>,
+  { [K in keyof ModelAttributes<TDef>]: ModelAttributes<TDef>[K] | null },
   FillableKeys<TDef> | SnakeCase<FillableKeys<TDef>> | BelongsToKeys<TDef>
 >>;
 // Numeric attribute columns - constrains aggregate methods (sum, avg, etc.)
@@ -583,9 +601,11 @@ declare class ModelQueryBuilder<TDef extends ModelDefinition, TSelected extends
   withTrashed(): ModelQueryBuilder<TDef, TSelected>;
   onlyTrashed(): ModelQueryBuilder<TDef, TSelected>;
   where<K extends ColumnName<TDef>>(column: K, value: K extends keyof ModelAttributes<TDef> ? ModelAttributes<TDef>[K] : unknown): ModelQueryBuilder<TDef, TSelected>;
+  where<K extends ColumnName<TDef>>(column: K, operator: 'in' | 'not in', value: ReadonlyArray<K extends keyof ModelAttributes<TDef> ? ModelAttributes<TDef>[K] : unknown>): ModelQueryBuilder<TDef, TSelected>;
   where<K extends ColumnName<TDef>>(column: K, operator: WhereOperator, value: K extends keyof ModelAttributes<TDef> ? ModelAttributes<TDef>[K] : unknown): ModelQueryBuilder<TDef, TSelected>;
   where<K extends ColumnName<TDef>>(column: K, operatorOrValue: WhereOperator | unknown, value?: unknown): ModelQueryBuilder<TDef, TSelected>;
   orWhere<K extends ColumnName<TDef>>(column: K, value: K extends keyof ModelAttributes<TDef> ? ModelAttributes<TDef>[K] : unknown): ModelQueryBuilder<TDef, TSelected>;
+  orWhere<K extends ColumnName<TDef>>(column: K, operator: 'in' | 'not in', value: ReadonlyArray<K extends keyof ModelAttributes<TDef> ? ModelAttributes<TDef>[K] : unknown>): ModelQueryBuilder<TDef, TSelected>;
   orWhere<K extends ColumnName<TDef>>(column: K, operator: WhereOperator, value: K extends keyof ModelAttributes<TDef> ? ModelAttributes<TDef>[K] : unknown): ModelQueryBuilder<TDef, TSelected>;
   orWhere<K extends ColumnName<TDef>>(column: K, operatorOrValue: WhereOperator | unknown, value?: unknown): ModelQueryBuilder<TDef, TSelected>;
   whereIn<K extends ColumnName<TDef>>(column: K, values: (K extends keyof ModelAttributes<TDef> ? ModelAttributes<TDef>[K] : unknown)[]): ModelQueryBuilder<TDef, TSelected>;

package/dist/src/index.js

@@ -12289,14 +12289,29 @@ function getOrCreateBunSql(forceNew = false) {
   const signature = connectionSignature();
   const configChanged = _bunSqlInstance !== null && _currentSignature !== signature;
   if (forceNew || configChanged || !_bunSqlInstance) {
+    if (_bunSqlInstance)
+      resetConnection();
     _bunSqlInstance = getBunSql();
     _currentSignature = signature;
   }
   return _bunSqlInstance;
 }
-function resetConnection() {
+function detachCachedConnection() {
+  const connection = _bunSqlInstance;
   _bunSqlInstance = null;
   _currentSignature = null;
+  return connection;
+}
+async function closeSqlConnection(connection) {
+  if (!connection || typeof connection.close !== "function")
+    return;
+  await connection.close();
+}
+function resetConnection() {
+  const closing = closeSqlConnection(detachCachedConnection());
+  closing.catch((error) => {
+    console.error(`[query-builder] Failed to close database connection: ${error.message}`);
+  });
 }
 async function withFreshConnection(fn) {
   try {
@@ -30153,9 +30168,15 @@ function familyOfSqlType(sqlType) {
     return "integer";
   return "other";
 }
-function satisfies(declared, actual) {
+function satisfies(declared, actual, dialect) {
   if (declared === actual)
     return true;
+  if (dialect === "sqlite") {
+    if (declared === "boolean" && actual === "integer")
+      return true;
+    if ((declared === "date" || declared === "json") && actual === "text")
+      return true;
+  }
   if (declared === "varchar" && actual === "text")
     return true;
   if (declared === "integer" && actual === "fractional")
@@ -30187,7 +30208,7 @@ async function auditSchemaDrift(plan, options = {}) {
         continue;
       }
       const actual = familyOfSqlType(liveColumn.sqlType);
-      if (!satisfies(declared, actual)) {
+      if (!satisfies(declared, actual, dialect)) {
         typeMismatches.push({
           table: table.table,
           column: column.name,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bun-query-builder",
   "type": "module",
-  "version": "0.2.38",
+  "version": "0.2.40",
   "description": "A simple yet performant query builder for TypeScript. Built with Bun.",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",