flint-orm 0.4.5 → 0.5.0

package/dist/drivers/better-sqlite3.d.ts

@@ -17,9 +17,9 @@ export declare class BetterSqlite3Executor implements Executor {
  * import { flint } from 'flint-orm/better-sqlite3'
  * const db = flint({ url: './app.db' })
  */
-export declare function flint(details: {
+export declare function flint(options: {
     url: string;
-}): {
+} & Database.Options): {
     select: () => import("..").SelectStage1;
     insert: <T extends import("..").AnyTable>(table: T) => import("..").InsertStage1<T>;
     update: <T extends import("..").AnyTable>(table: T) => import("..").UpdateStage1<T>;

package/dist/drivers/bun-sqlite.d.ts

@@ -1,4 +1,5 @@
 import { Database } from 'bun:sqlite';
+import type { DatabaseOptions } from 'bun:sqlite';
 import type { Executor } from '../executor';
 /** Synchronous executor backed by bun:sqlite, wrapped in Promises for uniform API. */
 export declare class BunSqliteExecutor implements Executor {
@@ -17,9 +18,9 @@ export declare class BunSqliteExecutor implements Executor {
  * import { flint } from 'flint-orm/bun-sqlite'
  * const db = flint({ url: './app.db' })
  */
-export declare function flint(details: {
+export declare function flint(options: {
     url: string;
-}): {
+} & DatabaseOptions): {
     select: () => import("..").SelectStage1;
     insert: <T extends import("..").AnyTable>(table: T) => import("..").InsertStage1<T>;
     update: <T extends import("..").AnyTable>(table: T) => import("..").UpdateStage1<T>;

package/dist/drivers/lazy-executor.d.ts

@@ -0,0 +1,14 @@
+import type { Executor } from '../executor';
+/**
+ * Wraps an async executor factory, deferring connection until first use.
+ * This lets flint() be synchronous even for async drivers.
+ */
+export declare class LazyExecutor implements Executor {
+    #private;
+    constructor(factory: () => Promise<Executor>);
+    all(sql: string, params: unknown[]): Promise<unknown[]>;
+    get(sql: string, params: unknown[]): Promise<unknown>;
+    run(sql: string, params: unknown[]): Promise<void>;
+    transaction(fn: () => void | Promise<void>): Promise<void>;
+    close(): void;
+}

package/dist/drivers/libsql-web.d.ts

@@ -1,4 +1,4 @@
-import type { Client } from '@libsql/client';
+import type { Client, Config } from '@libsql/client';
 import type { Executor } from '../executor';
 /** Async executor backed by @libsql/client/web. */
 export declare class LibsqlWebExecutor implements Executor {
@@ -10,11 +10,6 @@ export declare class LibsqlWebExecutor implements Executor {
     transaction(fn: () => void | Promise<void>): Promise<void>;
     close(): void;
 }
-export interface LibSQLWebConnectionDetails {
-    /** Database URL — must use ws:, wss:, http:, or https: scheme. */
-    url: string;
-    authToken?: string;
-}
 /**
  * Create a flint database client using @libsql/client/web.
  *
@@ -25,7 +20,7 @@ export interface LibSQLWebConnectionDetails {
  * import { flint } from 'flint-orm/libsql-web'
  * const db = flint({ url: 'libsql://your-db.turso.io', authToken: '...' })
  */
-export declare function flint(details: LibSQLWebConnectionDetails): {
+export declare function flint(options: Config): {
     select: () => import("..").SelectStage1;
     insert: <T extends import("..").AnyTable>(table: T) => import("..").InsertStage1<T>;
     update: <T extends import("..").AnyTable>(table: T) => import("..").UpdateStage1<T>;

package/dist/drivers/libsql.d.ts

@@ -1,4 +1,4 @@
-import type { Client } from '@libsql/client';
+import type { Client, Config } from '@libsql/client';
 import type { Executor } from '../executor';
 /** Async executor backed by `@libsql/client`. */
 export declare class LibsqlExecutor implements Executor {
@@ -10,10 +10,6 @@ export declare class LibsqlExecutor implements Executor {
     transaction(fn: () => void | Promise<void>): Promise<void>;
     close(): void;
 }
-export interface LibSQLConnectionDetails {
-    url: string;
-    authToken?: string;
-}
 /**
  * Create a flint database client using @libsql/client.
  *
@@ -21,7 +17,7 @@ export interface LibSQLConnectionDetails {
  * import { flint } from 'flint-orm/libsql'
  * const db = flint({ url: 'libsql://your-db.turso.io', authToken: '...' })
  */
-export declare function flint(details: LibSQLConnectionDetails): {
+export declare function flint(options: Config): {
     select: () => import("..").SelectStage1;
     insert: <T extends import("..").AnyTable>(table: T) => import("..").InsertStage1<T>;
     update: <T extends import("..").AnyTable>(table: T) => import("..").UpdateStage1<T>;

package/dist/drivers/turso-sync.d.ts

@@ -1,4 +1,4 @@
-import type { Database } from '@tursodatabase/sync';
+import type { Database, DatabaseOpts } from '@tursodatabase/sync';
 import type { Executor } from '../executor';
 /** Async executor backed by @tursodatabase/sync. */
 export declare class TursoSyncExecutor implements Executor {
@@ -10,22 +10,24 @@ export declare class TursoSyncExecutor implements Executor {
     transaction(fn: () => void | Promise<void>): Promise<void>;
     close(): void;
 }
-export interface TursoSyncConnectionDetails {
+export interface TursoSyncOptions extends Omit<DatabaseOpts, 'path' | 'url' | 'authToken'> {
     /** Local path for the synced database files. */
     url: string;
     /** Remote Turso database URL (libsql://...). */
     syncUrl?: string;
     /** Auth token for the remote database. */
-    authToken?: string;
+    authToken?: DatabaseOpts['authToken'];
 }
 /**
  * Create a flint database client using @tursodatabase/sync.
  *
+ * Connection is established lazily on first query.
+ *
  * @example
  * import { flint } from 'flint-orm/turso-sync'
  * const db = flint({ url: './local.db', syncUrl: 'libsql://db.turso.io', authToken: '...' })
  */
-export declare function flint(details: TursoSyncConnectionDetails): Promise<{
+export declare function flint(options: TursoSyncOptions): {
     select: () => import("..").SelectStage1;
     insert: <T extends import("..").AnyTable>(table: T) => import("..").InsertStage1<T>;
     update: <T extends import("..").AnyTable>(table: T) => import("..").UpdateStage1<T>;
@@ -41,4 +43,4 @@ export declare function flint(details: TursoSyncConnectionDetails): Promise<{
     max: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
     $run(query: string, ...params: unknown[]): Promise<void>;
     $executor: Executor;
-}>;
+};

package/dist/drivers/turso.d.ts

@@ -1,3 +1,4 @@
+import { connect } from '@tursodatabase/database';
 import type { Database } from '@tursodatabase/database';
 import type { Executor } from '../executor';
 /** Async executor backed by @tursodatabase/database. */
@@ -13,13 +14,15 @@ export declare class TursoExecutor implements Executor {
 /**
  * Create a flint database client using @tursodatabase/database.
  *
+ * Connection is established lazily on first query.
+ *
  * @example
  * import { flint } from 'flint-orm/turso'
- * const db = await flint({ url: './app.db' })
+ * const db = flint({ url: './app.db' })
  */
-export declare function flint(details: {
+export declare function flint(options: {
     url: string;
-}): Promise<{
+} & Parameters<typeof connect>[1]): {
     select: () => import("..").SelectStage1;
     insert: <T extends import("..").AnyTable>(table: T) => import("..").InsertStage1<T>;
     update: <T extends import("..").AnyTable>(table: T) => import("..").UpdateStage1<T>;
@@ -35,4 +38,4 @@ export declare function flint(details: {
     max: <T extends import("..").AnyTable, C extends import("..").ColumnDef<any, any>>(table: T, column: C, condition?: import("..").Condition) => Promise<number | null>;
     $run(query: string, ...params: unknown[]): Promise<void>;
     $executor: Executor;
-}>;
+};

package/dist/entries/libsql-web.d.ts

@@ -1,2 +1,2 @@
 export { flint } from '../drivers/libsql-web';
-export type { LibSQLWebConnectionDetails } from '../drivers/libsql-web';
+export type { Config as LibSQLWebConfig } from '@libsql/client/web';

package/dist/entries/libsql.d.ts

@@ -1,2 +1,2 @@
 export { flint } from '../drivers/libsql';
-export type { LibSQLConnectionDetails } from '../drivers/libsql';
+export type { Config as LibSQLConfig } from '@libsql/client';

package/dist/entries/turso-sync.d.ts

@@ -1,2 +1,2 @@
 export { flint } from '../drivers/turso-sync';
-export type { TursoSyncConnectionDetails } from '../drivers/turso-sync';
+export type { TursoSyncOptions } from '../drivers/turso-sync';

package/dist/src/cli.js

@@ -275,7 +275,7 @@ function diffColumns(tableName, prevCols, currCols) {
     if (prevCol.isPrimaryKey !== currCol.isPrimaryKey) {
       unsafe = true;
     }
-    if ((prevCol.isAutoIncrement ?? false) !== (currCol.isAutoIncrement ?? false)) {
+    if (prevCol.isAutoIncrement !== undefined && (prevCol.isAutoIncrement ?? false) !== (currCol.isAutoIncrement ?? false)) {
       unsafe = true;
     }
     if (prevCol.isNotNull !== currCol.isNotNull) {
@@ -538,6 +538,9 @@ function serializeColumn(col) {
     hasDefault: internal.hasDefault,
     defaultValue: internal.defaultValue
   };
+  if (result.isAutoIncrement && !result.isPrimaryKey) {
+    throw new Error(`Column "${col.name}": autoIncrement() requires primaryKey()`);
+  }
   if (internal.referencesTable && internal.referencesColumn) {
     result.referencesTable = internal.referencesTable;
     result.referencesColumn = internal.referencesColumn;
@@ -2370,8 +2373,9 @@ class BunSqliteExecutor {
     this.#client.close();
   }
 }
-function flint(details) {
-  const client = new Database(details.url);
+function flint(options) {
+  const { url, ...opts } = options;
+  const client = new Database(url, Object.keys(opts).length ? opts : undefined);
   return createClient(new BunSqliteExecutor(client));
 }
 var init_bun_sqlite = __esm(() => {
@@ -3188,8 +3192,9 @@ class BetterSqlite3Executor {
     this.#client.close();
   }
 }
-function flint2(details) {
-  const client = new import_better_sqlite3.default(details.url);
+function flint2(options) {
+  const { url, ...opts } = options;
+  const client = new import_better_sqlite3.default(url, Object.keys(opts).length ? opts : undefined);
   return createClient(new BetterSqlite3Executor(client));
 }
 var import_better_sqlite3;
@@ -9164,11 +9169,8 @@ class LibsqlExecutor {
     this.#client.close();
   }
 }
-function flint3(details) {
-  const client = createClient2({
-    url: normalizeUrl(details.url),
-    authToken: details.authToken
-  });
+function flint3(options) {
+  const client = createClient2({ ...options, url: normalizeUrl(options.url) });
   return createClient(new LibsqlExecutor(client));
 }
 var init_libsql = __esm(() => {
@@ -9245,8 +9247,8 @@ class LibsqlWebExecutor {
     this.#client.close();
   }
 }
-function flint4(details) {
-  const client = createClient3({ url: details.url, authToken: details.authToken });
+function flint4(options) {
+  const client = createClient3(options);
   return createClient(new LibsqlWebExecutor(client));
 }
 var init_libsql_web = __esm(() => {
@@ -11475,6 +11477,46 @@ var init_promise2 = __esm(() => {
   };
 });
 
+// src/drivers/lazy-executor.ts
+class LazyExecutor {
+  #factory;
+  #executor;
+  #promise;
+  constructor(factory) {
+    this.#factory = factory;
+  }
+  async#resolve() {
+    if (this.#executor)
+      return this.#executor;
+    if (!this.#promise) {
+      this.#promise = this.#factory().then((exec2) => {
+        this.#executor = exec2;
+        return exec2;
+      });
+    }
+    return this.#promise;
+  }
+  async all(sql2, params) {
+    const exec2 = await this.#resolve();
+    return exec2.all(sql2, params);
+  }
+  async get(sql2, params) {
+    const exec2 = await this.#resolve();
+    return exec2.get(sql2, params);
+  }
+  async run(sql2, params) {
+    const exec2 = await this.#resolve();
+    return exec2.run(sql2, params);
+  }
+  async transaction(fn) {
+    const exec2 = await this.#resolve();
+    return exec2.transaction(fn);
+  }
+  close() {
+    this.#executor?.close();
+  }
+}
+
 // src/drivers/turso-sync.ts
 var exports_turso_sync = {};
 __export(exports_turso_sync, {
@@ -11514,14 +11556,19 @@ class TursoSyncExecutor {
     this.#db.close();
   }
 }
-async function flint5(details) {
-  const localPath = details.url.includes("://") ? details.url : resolve2(details.url);
-  const db = await connect2({
-    path: localPath,
-    url: details.syncUrl,
-    authToken: details.authToken
+function flint5(options) {
+  const { url, syncUrl, authToken, ...rest } = options;
+  const localPath = url.includes("://") ? url : resolve2(url);
+  const executor = new LazyExecutor(async () => {
+    const db = await connect2({
+      path: localPath,
+      url: syncUrl,
+      authToken,
+      ...rest
+    });
+    return new TursoSyncExecutor(db);
   });
-  return createClient(new TursoSyncExecutor(db));
+  return createClient(executor);
 }
 var init_turso_sync = __esm(() => {
   init_promise2();
@@ -12099,9 +12146,13 @@ class TursoExecutor {
     this.#db.close();
   }
 }
-async function flint6(details) {
-  const db = await connect3(details.url);
-  return createClient(new TursoExecutor(db));
+function flint6(options) {
+  const { url, ...opts } = options;
+  const executor = new LazyExecutor(async () => {
+    const db = await connect3(url, Object.keys(opts).length ? opts : undefined);
+    return new TursoExecutor(db);
+  });
+  return createClient(executor);
 }
 var init_turso = __esm(() => {
   init_promise3();

package/dist/src/entries/better-sqlite3.js

@@ -2033,8 +2033,9 @@ class BetterSqlite3Executor {
     this.#client.close();
   }
 }
-function flint(details) {
-  const client = new import_better_sqlite3.default(details.url);
+function flint(options) {
+  const { url, ...opts } = options;
+  const client = new import_better_sqlite3.default(url, Object.keys(opts).length ? opts : undefined);
   return createClient(new BetterSqlite3Executor(client));
 }
 var import_better_sqlite3;

package/dist/src/entries/bun-sqlite.js

@@ -1269,8 +1269,9 @@ class BunSqliteExecutor {
     this.#client.close();
   }
 }
-function flint(details) {
-  const client = new Database(details.url);
+function flint(options) {
+  const { url, ...opts } = options;
+  const client = new Database(url, Object.keys(opts).length ? opts : undefined);
   return createClient(new BunSqliteExecutor(client));
 }
 var init_bun_sqlite = __esm(() => {

package/dist/src/entries/libsql-web.js

@@ -6049,8 +6049,8 @@ class LibsqlWebExecutor {
     this.#client.close();
   }
 }
-function flint(details) {
-  const client = createClient({ url: details.url, authToken: details.authToken });
+function flint(options) {
+  const client = createClient(options);
   return createClient2(new LibsqlWebExecutor(client));
 }
 var init_libsql_web = __esm(() => {

package/dist/src/entries/libsql.js

@@ -7189,11 +7189,8 @@ class LibsqlExecutor {
     this.#client.close();
   }
 }
-function flint(details) {
-  const client = createClient({
-    url: normalizeUrl(details.url),
-    authToken: details.authToken
-  });
+function flint(options) {
+  const client = createClient({ ...options, url: normalizeUrl(options.url) });
   return createClient2(new LibsqlExecutor(client));
 }
 var init_libsql = __esm(() => {

package/dist/src/entries/turso-sync.js

@@ -3444,6 +3444,46 @@ var init_flint = __esm(() => {
   init_aggregates();
 });
 
+// src/drivers/lazy-executor.ts
+class LazyExecutor {
+  #factory;
+  #executor;
+  #promise;
+  constructor(factory) {
+    this.#factory = factory;
+  }
+  async#resolve() {
+    if (this.#executor)
+      return this.#executor;
+    if (!this.#promise) {
+      this.#promise = this.#factory().then((exec) => {
+        this.#executor = exec;
+        return exec;
+      });
+    }
+    return this.#promise;
+  }
+  async all(sql2, params) {
+    const exec = await this.#resolve();
+    return exec.all(sql2, params);
+  }
+  async get(sql2, params) {
+    const exec = await this.#resolve();
+    return exec.get(sql2, params);
+  }
+  async run(sql2, params) {
+    const exec = await this.#resolve();
+    return exec.run(sql2, params);
+  }
+  async transaction(fn) {
+    const exec = await this.#resolve();
+    return exec.transaction(fn);
+  }
+  close() {
+    this.#executor?.close();
+  }
+}
+
 // src/drivers/turso-sync.ts
 var exports_turso_sync = {};
 __export(exports_turso_sync, {
@@ -3483,14 +3523,19 @@ class TursoSyncExecutor {
     this.#db.close();
   }
 }
-async function flint(details) {
-  const localPath = details.url.includes("://") ? details.url : resolve(details.url);
-  const db = await connect2({
-    path: localPath,
-    url: details.syncUrl,
-    authToken: details.authToken
+function flint(options) {
+  const { url, syncUrl, authToken, ...rest } = options;
+  const localPath = url.includes("://") ? url : resolve(url);
+  const executor = new LazyExecutor(async () => {
+    const db = await connect2({
+      path: localPath,
+      url: syncUrl,
+      authToken,
+      ...rest
+    });
+    return new TursoSyncExecutor(db);
   });
-  return createClient(new TursoSyncExecutor(db));
+  return createClient(executor);
 }
 var init_turso_sync = __esm(() => {
   init_promise2();

package/dist/src/entries/turso.js

@@ -2325,6 +2325,46 @@ var init_flint = __esm(() => {
   init_aggregates();
 });
 
+// src/drivers/lazy-executor.ts
+class LazyExecutor {
+  #factory;
+  #executor;
+  #promise;
+  constructor(factory) {
+    this.#factory = factory;
+  }
+  async#resolve() {
+    if (this.#executor)
+      return this.#executor;
+    if (!this.#promise) {
+      this.#promise = this.#factory().then((exec) => {
+        this.#executor = exec;
+        return exec;
+      });
+    }
+    return this.#promise;
+  }
+  async all(sql2, params) {
+    const exec = await this.#resolve();
+    return exec.all(sql2, params);
+  }
+  async get(sql2, params) {
+    const exec = await this.#resolve();
+    return exec.get(sql2, params);
+  }
+  async run(sql2, params) {
+    const exec = await this.#resolve();
+    return exec.run(sql2, params);
+  }
+  async transaction(fn) {
+    const exec = await this.#resolve();
+    return exec.transaction(fn);
+  }
+  close() {
+    this.#executor?.close();
+  }
+}
+
 // src/drivers/turso.ts
 var exports_turso = {};
 __export(exports_turso, {
@@ -2363,9 +2403,13 @@ class TursoExecutor {
     this.#db.close();
   }
 }
-async function flint(details) {
-  const db = await connect(details.url);
-  return createClient(new TursoExecutor(db));
+function flint(options) {
+  const { url, ...opts } = options;
+  const executor = new LazyExecutor(async () => {
+    const db = await connect(url, Object.keys(opts).length ? opts : undefined);
+    return new TursoExecutor(db);
+  });
+  return createClient(executor);
 }
 var init_turso = __esm(() => {
   init_promise2();

package/dist/src/migration/index.js

@@ -63,6 +63,9 @@ function serializeColumn(col) {
     hasDefault: internal.hasDefault,
     defaultValue: internal.defaultValue
   };
+  if (result.isAutoIncrement && !result.isPrimaryKey) {
+    throw new Error(`Column "${col.name}": autoIncrement() requires primaryKey()`);
+  }
   if (internal.referencesTable && internal.referencesColumn) {
     result.referencesTable = internal.referencesTable;
     result.referencesColumn = internal.referencesColumn;
@@ -208,7 +211,7 @@ function diffColumns(tableName, prevCols, currCols) {
     if (prevCol.isPrimaryKey !== currCol.isPrimaryKey) {
       unsafe = true;
     }
-    if ((prevCol.isAutoIncrement ?? false) !== (currCol.isAutoIncrement ?? false)) {
+    if (prevCol.isAutoIncrement !== undefined && (prevCol.isAutoIncrement ?? false) !== (currCol.isAutoIncrement ?? false)) {
       unsafe = true;
     }
     if (prevCol.isNotNull !== currCol.isNotNull) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flint-orm",
-  "version": "0.4.5",
+  "version": "0.5.0",
   "bin": {
     "flint": "./dist/src/cli.js"
   },