bun-query-builder 0.2.4 → 0.2.6

package/dist/bin/cli.js

@@ -11643,7 +11643,7 @@ var init_dist = __esm(() => {
 // src/config.ts
 import process19 from "process";
 function isMysqlLike(dialect = config5.dialect) {
-  return dialect === "mysql" || dialect === "singlestore";
+  return dialect === "mysql" || dialect === "singlestore" || dialect === "vitess";
 }
 function resolveDialect(explicit) {
   if (explicit)
@@ -12094,7 +12094,7 @@ function resolveDatabaseName(dbConfig = config5.database) {
   return String(raw).replace(/^['"]|['"]$/g, "");
 }
 function createConnectionString(dialect, dbConfig) {
-  if ((dialect === "postgres" || dialect === "mysql" || dialect === "singlestore") && process21.env.DB_CONNECTION === dialect) {
+  if ((dialect === "postgres" || dialect === "mysql" || dialect === "singlestore" || dialect === "vitess") && process21.env.DB_CONNECTION === dialect) {
     const e = process21.env;
     const envDb = (e.DB_DATABASE || dbConfig.database || "").replace(/^['"]|['"]$/g, "");
     const envUser = e.DB_USERNAME || dbConfig.username;
@@ -12115,6 +12115,7 @@ function createConnectionString(dialect, dbConfig) {
       return `postgres://${username}:${password}@${host}${port ? `:${port}` : ""}/${database}${sslQ}`;
     case "mysql":
     case "singlestore":
+    case "vitess":
       return `mysql://${username}:${password}@${host}${port ? `:${port}` : ""}/${database}${sslQ}`;
     case "sqlite":
       if (database === ":memory:") {
@@ -18078,10 +18079,26 @@ export default model
 var init_make_model = () => {};
 
 // src/drivers/index-name.ts
+function fingerprint(value) {
+  let hash = 2166136261;
+  for (let i = 0;i < value.length; i++) {
+    hash ^= value.charCodeAt(i);
+    hash = Math.imul(hash, 16777619) >>> 0;
+  }
+  return hash.toString(36).padStart(7, "0").slice(-7);
+}
+function boundIdentifier(name, limit = MAX_IDENTIFIER_LENGTH) {
+  if (name.length <= limit)
+    return name;
+  const suffix = `_${fingerprint(name)}`;
+  return name.slice(0, limit - suffix.length) + suffix;
+}
 function qualifiedIndexName(tableName, indexName) {
   const prefix = `${tableName}_`;
-  return indexName.startsWith(prefix) ? indexName : `${prefix}${indexName}`;
+  const qualified = indexName.startsWith(prefix) ? indexName : `${prefix}${indexName}`;
+  return boundIdentifier(qualified);
 }
+var MAX_IDENTIFIER_LENGTH = 63;
 
 // src/drivers/mysql.ts
 class MySQLDriver {
@@ -18509,6 +18526,35 @@ var init_singlestore = __esm(() => {
   };
 });
 
+// src/drivers/vitess.ts
+var VitessDriver;
+var init_vitess = __esm(() => {
+  init_mysql();
+  VitessDriver = class VitessDriver extends MySQLDriver {
+    getAutoIncrementClause(_column) {
+      return "";
+    }
+    renderColumn(column) {
+      if (!column.references)
+        return super.renderColumn(column);
+      const { references: _references, ...withoutReference } = column;
+      return super.renderColumn(withoutReference);
+    }
+    createTable(table) {
+      return super.createTable(table);
+    }
+    addForeignKey() {
+      return "";
+    }
+    createMigrationsTable() {
+      return `CREATE TABLE IF NOT EXISTS migrations (
+      migration VARCHAR(255) NOT NULL PRIMARY KEY,
+      executed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+    )`;
+    }
+  };
+});
+
 // src/drivers/sqlite.ts
 function isNumericPlanType(type) {
   return type === "integer" || type === "bigint" || type === "float" || type === "double" || type === "decimal";
@@ -18720,6 +18766,8 @@ function getDialectDriver(dialect) {
       return new MySQLDriver;
     case "singlestore":
       return new SingleStoreDriver;
+    case "vitess":
+      return new VitessDriver;
     case "sqlite":
       return new SQLiteDriver;
     default:
@@ -18730,11 +18778,13 @@ var init_drivers = __esm(() => {
   init_mysql();
   init_postgres();
   init_singlestore();
+  init_vitess();
   init_sqlite();
   init_mysql();
   init_postgres();
   init_singlestore();
   init_sqlite();
+  init_vitess();
 });
 
 // src/workspace.ts
@@ -31464,7 +31514,7 @@ function getPrefix() {
 }
 var prefix = getPrefix();
 // package.json
-var version2 = "0.2.4";
+var version2 = "0.2.6";
 
 // bin/cli.ts
 init_actions();

package/dist/config.d.ts

@@ -1,11 +1,12 @@
 import type { QueryBuilderConfig, SupportedDialect } from './types';
 /**
- * Whether a dialect belongs to the MySQL wire-protocol family (MySQL itself or
- * SingleStore). These share `?` placeholders, backtick identifier quoting,
- * `ON DUPLICATE KEY UPDATE` upserts, `LAST_INSERT_ID()` id recovery, and the
- * `YYYY-MM-DD HH:MM:SS` datetime literal shape. Runtime DML branches should key
- * off this helper rather than `dialect === 'mysql'` so SingleStore inherits the
- * same behavior; only DDL (see `SingleStoreDriver`) diverges.
+ * Whether a dialect belongs to the MySQL wire-protocol family (MySQL itself,
+ * SingleStore, or Vitess). These share `?` placeholders, backtick identifier
+ * quoting, `ON DUPLICATE KEY UPDATE` upserts, `LAST_INSERT_ID()` id recovery,
+ * and the `YYYY-MM-DD HH:MM:SS` datetime literal shape. Runtime DML branches
+ * should key off this helper rather than `dialect === 'mysql'` so the
+ * distributed dialects inherit the same behavior; only DDL (see
+ * `SingleStoreDriver` / `VitessDriver`) diverges.
  */
 export declare function isMysqlLike(dialect?: SupportedDialect): boolean;
 /**

package/dist/drivers/index-name.d.ts

@@ -1 +1,28 @@
+/**
+ * Shorten a name to what the database will actually store.
+ *
+ * Truncating and appending the fingerprint of the full name keeps the result
+ * readable at the front - where the table and column names are - and unique at
+ * the back.
+ */
+export declare function boundIdentifier(name: string, limit?: unknown): string;
+/**
+ * The name an index has in the database.
+ *
+ * Qualified with its table when it is not already, then bounded. Both halves
+ * have to happen here rather than at the call sites, because the diff compares
+ * what the model declares against what the database reports, and those only
+ * agree if the same function produced both.
+ */
 export declare function qualifiedIndexName(tableName: string, indexName: string): string;
+/**
+ * Postgres truncates any identifier over 63 bytes, silently, with a notice
+ * nobody reads. MySQL refuses one over 64 outright.
+ *
+ * A truncated index name is worse than a rejected one. The database ends up
+ * holding a name the model never declared, so the next diff looks for the
+ * declared name, does not find it, and proposes creating it - forever. That is
+ * exactly what "drop and recreate this index, unchanged, on every single run"
+ * looks like from the outside.
+ */
+export declare const MAX_IDENTIFIER_LENGTH: 63;

package/dist/drivers/index.d.ts

@@ -2,6 +2,7 @@ import { MySQLDriver } from './mysql';
 import { PostgresDriver } from './postgres';
 import { SingleStoreDriver } from './singlestore';
 import { SQLiteDriver } from './sqlite';
+import { VitessDriver } from './vitess';
 import type { DialectDriver } from './postgres';
 import type { SupportedDialect } from '../types';
 export type { DialectDriver } from './postgres';
@@ -32,6 +33,7 @@ export { MySQLDriver } from './mysql';
 export { PostgresDriver } from './postgres';
 export { SingleStoreDriver } from './singlestore';
 export { SQLiteDriver } from './sqlite';
+export { VitessDriver } from './vitess';
 // DynamoDB driver (NoSQL)
 export {
   createDynamoDBDriver,

package/dist/drivers/vitess.d.ts

@@ -0,0 +1,38 @@
+import { MySQLDriver } from './mysql';
+import type { ColumnPlan, TablePlan } from '../migrations';
+/**
+ * Vitess DDL driver.
+ *
+ * Vitess shards MySQL behind vtgate, which speaks the MySQL wire protocol, so
+ * runtime DML (placeholders, backtick quoting, `ON DUPLICATE KEY UPDATE`,
+ * `LAST_INSERT_ID`) is identical — see `isMysqlLike` in `config.ts`. Only DDL
+ * diverges, and every divergence below follows from one fact: a keyspace is
+ * split across shards that share nothing.
+ *
+ *  - **No foreign keys.** Enforcing one would need a cross-shard read on every
+ *    write, so vtgate rejects them in a sharded keyspace. Both forms are
+ *    suppressed: the `ALTER TABLE … ADD CONSTRAINT` statement (`addForeignKey`)
+ *    and the inline `REFERENCES` clause the MySQL driver emits inside a column
+ *    definition. Missing the inline form would be the subtler bug — the table
+ *    plan carries the reference on the column, so a `CREATE TABLE` would fail
+ *    on its own without any FK statement being generated.
+ *  - **No AUTO_INCREMENT.** Each shard would independently hand out the same
+ *    values and collide. This is not a parse error, which makes it worse than
+ *    one: the DDL succeeds and the collisions appear later, under load, as
+ *    duplicate-key failures on inserts that were previously fine. Primary keys
+ *    must come from the application or from a sequence table in an unsharded
+ *    keyspace, declared in the VSchema.
+ *
+ * **Sharding is not expressed in DDL.** Unlike SingleStore, where the shard key
+ * is a `CREATE TABLE` clause, Vitess keeps the topology in a separate VSchema
+ * document that maps each table's sharding column to a vindex. So `createTable`
+ * here is plain MySQL minus the two constructs above, and nothing in this
+ * driver needs to know how a table is sharded.
+ */
+export declare class VitessDriver extends MySQLDriver {
+  protected getAutoIncrementClause(_column: ColumnPlan): string;
+  protected renderColumn(column: ColumnPlan): string;
+  createTable(table: TablePlan): string;
+  addForeignKey(): string;
+  createMigrationsTable(): string;
+}

package/dist/src/index.js

@@ -11642,7 +11642,7 @@ var init_dist = __esm(() => {
 // src/config.ts
 import process19 from "process";
 function isMysqlLike(dialect = config5.dialect) {
-  return dialect === "mysql" || dialect === "singlestore";
+  return dialect === "mysql" || dialect === "singlestore" || dialect === "vitess";
 }
 function resolveDialect(explicit) {
   if (explicit)
@@ -12093,7 +12093,7 @@ function resolveDatabaseName(dbConfig = config5.database) {
   return String(raw).replace(/^['"]|['"]$/g, "");
 }
 function createConnectionString(dialect, dbConfig) {
-  if ((dialect === "postgres" || dialect === "mysql" || dialect === "singlestore") && process21.env.DB_CONNECTION === dialect) {
+  if ((dialect === "postgres" || dialect === "mysql" || dialect === "singlestore" || dialect === "vitess") && process21.env.DB_CONNECTION === dialect) {
     const e = process21.env;
     const envDb = (e.DB_DATABASE || dbConfig.database || "").replace(/^['"]|['"]$/g, "");
     const envUser = e.DB_USERNAME || dbConfig.username;
@@ -12114,6 +12114,7 @@ function createConnectionString(dialect, dbConfig) {
       return `postgres://${username}:${password}@${host}${port ? `:${port}` : ""}/${database}${sslQ}`;
     case "mysql":
     case "singlestore":
+    case "vitess":
       return `mysql://${username}:${password}@${host}${port ? `:${port}` : ""}/${database}${sslQ}`;
     case "sqlite":
       if (database === ":memory:") {
@@ -18077,10 +18078,26 @@ export default model
 var init_make_model = () => {};
 
 // src/drivers/index-name.ts
+function fingerprint(value) {
+  let hash = 2166136261;
+  for (let i = 0;i < value.length; i++) {
+    hash ^= value.charCodeAt(i);
+    hash = Math.imul(hash, 16777619) >>> 0;
+  }
+  return hash.toString(36).padStart(7, "0").slice(-7);
+}
+function boundIdentifier(name, limit = MAX_IDENTIFIER_LENGTH) {
+  if (name.length <= limit)
+    return name;
+  const suffix = `_${fingerprint(name)}`;
+  return name.slice(0, limit - suffix.length) + suffix;
+}
 function qualifiedIndexName(tableName, indexName) {
   const prefix = `${tableName}_`;
-  return indexName.startsWith(prefix) ? indexName : `${prefix}${indexName}`;
+  const qualified = indexName.startsWith(prefix) ? indexName : `${prefix}${indexName}`;
+  return boundIdentifier(qualified);
 }
+var MAX_IDENTIFIER_LENGTH = 63;
 
 // src/drivers/mysql.ts
 class MySQLDriver {
@@ -18508,6 +18525,35 @@ var init_singlestore = __esm(() => {
   };
 });
 
+// src/drivers/vitess.ts
+var VitessDriver;
+var init_vitess = __esm(() => {
+  init_mysql();
+  VitessDriver = class VitessDriver extends MySQLDriver {
+    getAutoIncrementClause(_column) {
+      return "";
+    }
+    renderColumn(column) {
+      if (!column.references)
+        return super.renderColumn(column);
+      const { references: _references, ...withoutReference } = column;
+      return super.renderColumn(withoutReference);
+    }
+    createTable(table) {
+      return super.createTable(table);
+    }
+    addForeignKey() {
+      return "";
+    }
+    createMigrationsTable() {
+      return `CREATE TABLE IF NOT EXISTS migrations (
+      migration VARCHAR(255) NOT NULL PRIMARY KEY,
+      executed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+    )`;
+    }
+  };
+});
+
 // src/drivers/sqlite.ts
 function isNumericPlanType(type) {
   return type === "integer" || type === "bigint" || type === "float" || type === "double" || type === "decimal";
@@ -18719,6 +18765,8 @@ function getDialectDriver(dialect) {
       return new MySQLDriver;
     case "singlestore":
       return new SingleStoreDriver;
+    case "vitess":
+      return new VitessDriver;
     case "sqlite":
       return new SQLiteDriver;
     default:
@@ -18729,11 +18777,13 @@ var init_drivers = __esm(() => {
   init_mysql();
   init_postgres();
   init_singlestore();
+  init_vitess();
   init_sqlite();
   init_mysql();
   init_postgres();
   init_singlestore();
   init_sqlite();
+  init_vitess();
 });
 
 // src/workspace.ts
@@ -29564,6 +29614,7 @@ export {
   browserQuery,
   browserAuth,
   applySqliteBootstrapPragmas,
+  VitessDriver,
   SingleTableRepository,
   SingleTableQueryBuilder,
   SingleTablePatterns,

package/dist/types.d.ts

@@ -293,7 +293,11 @@ export declare interface UnsafeOptions {
  *   but its DDL adds distributed-table concepts (`SHARD KEY`, `SORT KEY`,
  *   `ROWSTORE`/columnstore) and drops foreign keys — handled by the dedicated
  *   `SingleStoreDriver`.
+ * - 'vitess': Sharded MySQL behind vtgate. Shares MySQL's wire protocol and
+ *   DML (see `isMysqlLike`), but a sharded keyspace rejects foreign keys and
+ *   AUTO_INCREMENT, and its sharding topology lives in a separate VSchema
+ *   document rather than in DDL — handled by the dedicated `VitessDriver`.
  * - 'sqlite': Lightweight engine; some features are limited or emulated
  * - 'browser': Browser-compatible mode that uses fetch() API calls instead of direct database connections
  */
-export type SupportedDialect = 'postgres' | 'mysql' | 'singlestore' | 'sqlite' | 'browser';
+export type SupportedDialect = 'postgres' | 'mysql' | 'singlestore' | 'vitess' | 'sqlite' | 'browser';

package/package.json

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