@expressive/sql 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -6,7 +6,7 @@ Entities on [`@expressive/mvc`](https://github.com/gabeklein/expressive-mvc) Mod
6
6
  npm install @expressive/sql @expressive/mvc
7
7
  ```
8
8
 
9
- SQLite is built into Bun (`bun:sqlite`) and Node 24 (`node:sqlite`). Elsewhere add one of `better-sqlite3`, `sqlite3` or `@libsql/client`; the first found is used.
9
+ SQLite is built into Bun (`bun:sqlite`) and Node 24 (`node:sqlite`). Elsewhere add one of `better-sqlite3`, `sqlite3` or `@libsql/client` (0.18 or later); the first found is used.
10
10
 
11
11
  ```ts
12
12
  import { Query, SQLiteConnection, Type, greaterThan, num, one, str } from '@expressive/sql';
@@ -42,7 +42,7 @@ await gabe.set({ name: "Gabriel" });
42
42
  await db.close();
43
43
  ```
44
44
 
45
- `SQLiteConnection.new(types, filename?)` binds the classes; awaiting it creates missing tables, adds missing columns and checks existing ones. SQLite cannot add a `unique` column or one defaulting to `"NOW"`; `sync` reports those. Omit `filename` for an in-memory database.
45
+ `SQLiteConnection.new(types, filename?)` binds the classes; awaiting it creates missing tables, adds missing columns and checks existing ones. SQLite cannot add a `unique` column or one defaulting to `"NOW"`; `sync` reports those. Omit `filename` for an in-memory database. In its place, pass a Cloudflare D1 binding, a libSQL client or a `libsql://` address - see [SQLite hosts](https://github.com/gabeklein/expressive-orm#sqlite-hosts).
46
46
 
47
47
  ## Also here
48
48
 
@@ -1,5 +1,5 @@
1
1
  import { Connection as Connection$1 } from "../connection/Connection.js";
2
- import { Engine } from "./engine.js";
2
+ import { D1Database, Engine, LibSQLClient } from "./engine.js";
3
3
  import { Field, Query } from "@expressive/orm";
4
4
  import { Builder } from "@expressive/orm/driver";
5
5
 
@@ -11,7 +11,7 @@ type TableInfo = {
11
11
  dflt_value: any;
12
12
  };
13
13
  /**
14
- * A connection to SQLite - a file, in memory, or a given `Engine`.
14
+ * A connection to SQLite - a file, in memory, a libSQL address, a D1 binding, a libSQL client or a given `Engine`.
15
15
  *
16
16
  * The built-in loader takes the first of `bun:sqlite`, `node:sqlite`, `better-sqlite3`, `sqlite3`, `@libsql/client`, with foreign keys on.
17
17
  * Awaiting it runs `sync`. No live rows.
@@ -20,15 +20,19 @@ type TableInfo = {
20
20
  * const db = await SQLiteConnection.new([User, Post], "app.db");
21
21
  */
22
22
  declare class SQLiteConnection extends Connection$1 {
23
+ #private;
23
24
  protected filename: string;
24
25
  protected engine?: Promise<Engine>;
25
26
  protected owned: boolean;
26
27
  /**
27
28
  * Bind `using` to a SQLite database. Construct with `SQLiteConnection.new`.
28
29
  *
29
- * Without `source`, the database is in memory.
30
+ * Without `source`, the database is in memory. A filename opens through the built-in loader.
31
+ * A `libsql:`, `https:`, `http:`, `ws:` or `wss:` address opens a `@libsql/client` 0.18 or later - pass a token as `?authToken=`.
32
+ * A D1 binding, a libSQL client or an `Engine` is used as given - foreign keys are not switched on, and `close()` leaves it open.
33
+ * D1 refuses `transaction`. libSQL runs each `transaction` on a libSQL write transaction, one at a time.
30
34
  */
31
- constructor(using: Connection$1.Types, source?: string | Engine);
35
+ constructor(using: Connection$1.Types, source?: string | Engine | D1Database | LibSQLClient);
32
36
  protected db(): Promise<Engine>;
33
37
  /** `CREATE TABLE` and `CREATE INDEX` statements for the bound classes, formatted. */
34
38
  get schema(): string;
@@ -1,12 +1,12 @@
1
1
  import { Connection as Connection$1 } from "../connection/Connection.js";
2
- import { createEngine } from "./engine.js";
2
+ import { createEngine, host, migrations } from "./engine.js";
3
3
  import { SQLiteGenerator, now as now$1 } from "./SQLiteGenerator.js";
4
4
  import { now } from "@expressive/orm";
5
5
  import { format } from "sql-formatter";
6
6
 
7
7
  //#region src/sqlite/SQLiteConnection.ts
8
8
  /**
9
- * A connection to SQLite - a file, in memory, or a given `Engine`.
9
+ * A connection to SQLite - a file, in memory, a libSQL address, a D1 binding, a libSQL client or a given `Engine`.
10
10
  *
11
11
  * The built-in loader takes the first of `bun:sqlite`, `node:sqlite`, `better-sqlite3`, `sqlite3`, `@libsql/client`, with foreign keys on.
12
12
  * Awaiting it runs `sync`. No live rows.
@@ -18,13 +18,16 @@ var SQLiteConnection = class extends Connection$1 {
18
18
  /**
19
19
  * Bind `using` to a SQLite database. Construct with `SQLiteConnection.new`.
20
20
  *
21
- * Without `source`, the database is in memory.
21
+ * Without `source`, the database is in memory. A filename opens through the built-in loader.
22
+ * A `libsql:`, `https:`, `http:`, `ws:` or `wss:` address opens a `@libsql/client` 0.18 or later - pass a token as `?authToken=`.
23
+ * A D1 binding, a libSQL client or an `Engine` is used as given - foreign keys are not switched on, and `close()` leaves it open.
24
+ * D1 refuses `transaction`. libSQL runs each `transaction` on a libSQL write transaction, one at a time.
22
25
  */
23
26
  constructor(using, source) {
24
27
  super(using);
25
28
  this.owned = true;
26
29
  if (typeof source == "object") {
27
- this.engine = Promise.resolve(source);
30
+ (this.engine = Promise.resolve(source).then(host)).catch(() => {});
28
31
  this.owned = false;
29
32
  }
30
33
  this.filename = typeof source == "string" && source || ":memory:";
@@ -32,6 +35,10 @@ var SQLiteConnection = class extends Connection$1 {
32
35
  db() {
33
36
  return this.engine ??= createEngine(this.filename);
34
37
  }
38
+ async #statements() {
39
+ await this.idle();
40
+ return this._journal()?.session || this.db();
41
+ }
35
42
  /** `CREATE TABLE` and `CREATE INDEX` statements for the bound classes, formatted. */
36
43
  get schema() {
37
44
  return pretty(this.generateSchema(this.using));
@@ -45,9 +52,8 @@ var SQLiteConnection = class extends Connection$1 {
45
52
  const sql = String(new SQLiteGenerator(builder));
46
53
  const string = (x) => x ? x.map((x) => x !== null && typeof x === "object" ? JSON.stringify(x) : typeof x === "boolean" ? Number(x) : x) : [];
47
54
  const run = async (op) => {
48
- await this.idle();
49
55
  try {
50
- return await op(this._journal()?.session || await this.db());
56
+ return await op(await this.#statements());
51
57
  } catch (err) {
52
58
  if (err instanceof Error) throw new Error(`Error running SQL: ${err.message}\n${pretty(sql)}`);
53
59
  throw err;
@@ -74,7 +80,8 @@ var SQLiteConnection = class extends Connection$1 {
74
80
  }
75
81
  /** Close the database when this connection opened it, then release the connection. */
76
82
  async close() {
77
- if (this.engine && this.owned) await (await this.engine).close();
83
+ const engine = await this.engine?.catch(() => void 0);
84
+ if (engine && this.owned) await engine.close();
78
85
  await super.close();
79
86
  }
80
87
  /**
@@ -113,7 +120,7 @@ var SQLiteConnection = class extends Connection$1 {
113
120
  table,
114
121
  action: `create table ${table}`,
115
122
  reason: `Table ${table} does not exist.`,
116
- sql: [this.generateTableSchema(type)]
123
+ sql: [this.tableSchema(type), ...indexed(type).map(index)]
117
124
  });
118
125
  continue;
119
126
  }
@@ -158,16 +165,21 @@ var SQLiteConnection = class extends Connection$1 {
158
165
  }
159
166
  async apply(steps) {
160
167
  const db = await this.db();
161
- const { foreign_keys } = await db.get("PRAGMA foreign_keys");
162
- const guard = foreign_keys && steps.some((step) => step.action.startsWith("rebuild"));
168
+ const rebuilds = steps.some((step) => step.action.startsWith("rebuild"));
163
169
  const sql = steps.flatMap((step) => step.sql);
170
+ const migrate = migrations.get(db);
171
+ if (migrate && rebuilds) {
172
+ await intact(db);
173
+ await migrate(sql);
174
+ return;
175
+ }
176
+ const guard = rebuilds && (await db.get("PRAGMA foreign_keys"))?.foreign_keys;
164
177
  if (db.batch && !guard) return db.batch(sql);
165
178
  if (db.batch) {
166
179
  await db.exec("PRAGMA foreign_keys = OFF").catch(() => {});
167
180
  try {
168
181
  if ((await db.get("PRAGMA foreign_keys")).foreign_keys) throw new Error("Cannot rebuild: this engine keeps foreign keys on, so dropping the table would cascade.");
169
- const broken = await db.all("PRAGMA foreign_key_check");
170
- if (broken.length) throw new Error(dangling(broken));
182
+ await intact(db);
171
183
  return await db.batch(sql);
172
184
  } finally {
173
185
  await db.exec("PRAGMA foreign_keys = ON").catch(() => {});
@@ -177,8 +189,7 @@ var SQLiteConnection = class extends Connection$1 {
177
189
  await db.exec("BEGIN");
178
190
  try {
179
191
  await db.exec(sql.join("\n"));
180
- const broken = guard ? await db.all("PRAGMA foreign_key_check") : [];
181
- if (broken.length) throw new Error(dangling(broken));
192
+ if (guard) await intact(db);
182
193
  await db.exec("COMMIT");
183
194
  } catch (error) {
184
195
  await db.exec("ROLLBACK");
@@ -196,7 +207,7 @@ var SQLiteConnection = class extends Connection$1 {
196
207
  }
197
208
  async inspect(type, planning = false) {
198
209
  const { table } = type;
199
- const db = await this.db();
210
+ const db = await this.#statements();
200
211
  if (!await db.get(`SELECT name FROM sqlite_master WHERE type='table' AND name=?`, [table])) return false;
201
212
  const columns = await db.all(`PRAGMA table_info(${table})`);
202
213
  const absent = [];
@@ -224,7 +235,7 @@ var SQLiteConnection = class extends Connection$1 {
224
235
  };
225
236
  }
226
237
  async unindexed(type) {
227
- const db = await this.db();
238
+ const db = await this.#statements();
228
239
  const covered = /* @__PURE__ */ new Set();
229
240
  for (const { name } of await db.all(`PRAGMA index_list(${type.table})`)) {
230
241
  const columns = await db.all(`PRAGMA index_info(\`${name}\`)`);
@@ -233,7 +244,7 @@ var SQLiteConnection = class extends Connection$1 {
233
244
  return indexed(type).filter((field) => !covered.has(field.column));
234
245
  }
235
246
  async misfit(type, fields, columns) {
236
- const db = await this.db();
247
+ const db = await this.#statements();
237
248
  const { table } = type;
238
249
  const problems = [];
239
250
  for (const field of fields) {
@@ -252,7 +263,7 @@ var SQLiteConnection = class extends Connection$1 {
252
263
  return problems;
253
264
  }
254
265
  async rebuild(type, fields, columns) {
255
- const db = await this.db();
266
+ const db = await this.#statements();
256
267
  const { table } = type;
257
268
  const temp = `${table}__rebuild`;
258
269
  const own = Array.from(type.fields.values()).filter((field) => !field.parts);
@@ -275,7 +286,7 @@ var SQLiteConnection = class extends Connection$1 {
275
286
  const foreignKey = reference.column;
276
287
  const foreignTable = reference.parent.table;
277
288
  if (reference.parent.connection !== this) return [`Foreign key ${foreignTable}.${foreignKey} cannot be checked by another connection`];
278
- const db = await this.db();
289
+ const db = await this.#statements();
279
290
  if (!await db.get(`SELECT name FROM sqlite_master WHERE type='table' AND name=?`, [foreignTable])) return planning && this.using.has(reference.parent) ? [] : [`Referenced table ${foreignTable} does not exist`];
280
291
  if (!(await db.all(`PRAGMA table_info(${foreignTable})`)).find((col) => col.name === foreignKey)) return [`Referenced column ${foreignKey} does not exist in table ${foreignTable}`];
281
292
  return [];
@@ -296,8 +307,12 @@ var SQLiteConnection = class extends Connection$1 {
296
307
  function indexed(type) {
297
308
  return Array.from(type.fields.values()).filter((field) => field.index && !field.primary && !field.unique);
298
309
  }
299
- function dangling(rows) {
300
- return `Cannot rebuild: ${[...new Set(rows.map((row) => row.table))].join(", ")} has references to missing rows (${rows.length}).`;
310
+ async function intact(db) {
311
+ const broken = await db.all("PRAGMA foreign_key_check");
312
+ if (broken.length) {
313
+ const tables = [...new Set(broken.map((row) => row.table))].join(", ");
314
+ throw new Error(`Cannot rebuild: ${tables} has references to missing rows (${broken.length}).`);
315
+ }
301
316
  }
302
317
  function indexName(field) {
303
318
  return typeof field.index == "string" ? field.index : `${field.parent.table}_${field.column}`;
@@ -1 +1 @@
1
- {"version":3,"file":"SQLiteConnection.js","names":["Connection","current"],"sources":["../../src/sqlite/SQLiteConnection.ts"],"sourcesContent":["import { Field, now, Query } from '@expressive/orm';\nimport { Builder } from '@expressive/orm/driver';\nimport { Connection } from '../connection/Connection';\nimport { format } from 'sql-formatter';\n\nimport { createEngine, Engine } from './engine';\nimport { now as current, SQLiteGenerator } from './SQLiteGenerator';\n\ntype TableInfo = {\n name: string;\n type: string;\n notnull: number;\n dflt_value: any\n};\n\n/**\n * A connection to SQLite - a file, in memory, or a given `Engine`.\n *\n * The built-in loader takes the first of `bun:sqlite`, `node:sqlite`, `better-sqlite3`, `sqlite3`, `@libsql/client`, with foreign keys on.\n * Awaiting it runs `sync`. No live rows.\n *\n * @example\n * const db = await SQLiteConnection.new([User, Post], \"app.db\");\n */\nexport class SQLiteConnection extends Connection {\n protected filename: string;\n protected engine?: Promise<Engine>;\n protected owned = true;\n\n /**\n * Bind `using` to a SQLite database. Construct with `SQLiteConnection.new`.\n *\n * Without `source`, the database is in memory.\n */\n constructor(using: Connection.Types, source?: string | Engine) {\n super(using);\n\n if (typeof source == \"object\") {\n this.engine = Promise.resolve(source);\n this.owned = false;\n }\n\n this.filename = typeof source == \"string\" && source || ':memory:';\n }\n\n protected db(){\n return this.engine ??= createEngine(this.filename);\n }\n\n /** `CREATE TABLE` and `CREATE INDEX` statements for the bound classes, formatted. */\n get schema() {\n return pretty(this.generateSchema(this.using));\n }\n\n /**\n * Compile a builder to SQLite SQL.\n *\n * A failure when run rethrows as `Error running SQL: <message>` with the statement.\n */\n prepare(builder: Builder){\n const sql = String(new SQLiteGenerator(builder));\n const string = (x?: unknown[]) => x\n ? x.map(x => (\n x !== null && typeof x === 'object' ? JSON.stringify(x) :\n typeof x === 'boolean' ? Number(x) :\n x\n ))\n : [];\n\n const run = async <R>(op: (engine: Engine.Statements) => Promise<R>) => {\n await this.idle();\n\n try {\n return await op(this._journal()?.session as Engine.Session || await this.db());\n }\n catch (err) {\n if(err instanceof Error)\n throw new Error(`Error running SQL: ${err.message}\\n${pretty(sql)}`);\n\n throw err;\n }\n };\n\n const counts = !builder.returns && !builder.inserts.size && !builder.updates.size && !builder.deletes.size;\n\n return {\n all: (p?: any[]) => run(e => e.all(sql, string(p))),\n run: counts\n ? (p?: any[]) => run(e => e.get(sql, string(p)).then(row => Number(Object.values(row)[0])))\n : (p?: any[]) => run(e => e.run(sql, string(p)).then(r => r.changes)),\n toString: () => pretty(sql)\n };\n }\n\n protected async transact<T>(fn: () => Promise<T>): Promise<T> {\n const db = await this.db();\n const session = this._journal()!.session = await db.transaction?.();\n\n if (!session)\n await db.exec(\"BEGIN\");\n\n try {\n const result = await fn();\n\n await (session ? session.commit() : db.exec(\"COMMIT\"));\n\n return result;\n }\n catch (error) {\n await (session ? session.rollback() : db.exec(\"ROLLBACK\")).catch(() => {});\n throw error;\n }\n }\n\n /** Close the database when this connection opened it, then release the connection. */\n async close(){\n if (this.engine && this.owned)\n await (await this.engine).close();\n\n await super.close();\n }\n\n /**\n * Bring the database in line with the bound classes, then mark the connection ready.\n *\n * Creates missing tables and adds missing columns and indexes, in one transaction. Throws for any problem `plan` reports, changing nothing.\n * `fix` false only verifies - anything missing throws too. `force` rebuilds a table whose column type or nullability drifted.\n * Throws when the connection is already ready.\n */\n async sync(fix = true, force = false){\n if (this.ready)\n throw new Error(\"Connection is already active.\");\n\n const { steps, problems } = await this.plan(force);\n const issues = fix ? problems : [...problems, ...steps.map(step => step.reason)];\n\n if (issues.length)\n throw new Error(issues.join(\"\\n\"));\n\n if (steps.length)\n await this.apply(steps);\n\n (this as Connection).set({ ready: true });\n\n return this;\n }\n\n /**\n * List what `sync` would do, without doing it.\n *\n * `problems` are what it cannot fix - drift without `force`, a column SQLite cannot add, a missing referenced table, `static schema`.\n */\n async plan(force = false): Promise<Connection.Plan> {\n const steps: Connection.Step[] = [];\n const problems: string[] = [];\n\n for (const type of this.using) {\n const { table } = type;\n\n if (type.schema) {\n problems.push(`static schema is not supported by ${this.constructor.name}.`);\n continue;\n }\n\n const found = await this.inspect(type, true);\n\n if (!found) {\n steps.push({ table, action: `create table ${table}`, reason: `Table ${table} does not exist.`, sql: [this.generateTableSchema(type)] });\n continue;\n }\n\n const { columns, absent, drift, issues } = found;\n const rebuild = force && drift.length > 0;\n\n problems.push(...issues);\n\n if (!rebuild)\n problems.push(...drift.map(({ message }) => message));\n\n for (const field of absent) {\n const reason = moved(field, columns.map(col => col.name)) || unfit(field);\n\n if (reason)\n problems.push(`Column ${field.column} in table ${table} ${reason}`);\n else if (!rebuild)\n steps.push({\n table,\n column: field.column,\n action: `add column ${field.column} to ${table}`,\n reason: `Column ${field.column} does not exist in table ${table}`,\n sql: [`ALTER TABLE ${table} ADD COLUMN ${definition(field, true)};`]\n });\n }\n\n if (rebuild) {\n const fields = drift.map(({ field }) => field);\n const misfit = await this.misfit(type, fields, columns);\n\n if (misfit.length)\n problems.push(...misfit);\n else\n steps.push({\n table,\n action: `rebuild table ${table}`,\n reason: drift.map(({ message }) => message).join(\"; \"),\n sql: await this.rebuild(type, fields, columns)\n });\n }\n\n for (const field of await this.unindexed(type))\n steps.push({\n table,\n column: field.column,\n action: `create index ${indexName(field)} on ${table}`,\n reason: `Index ${indexName(field)} does not exist on ${table}`,\n sql: [index(field)]\n });\n }\n\n return { steps, problems };\n }\n\n protected async apply(steps: Connection.Step[]){\n const db = await this.db();\n const { foreign_keys } = await db.get(\"PRAGMA foreign_keys\");\n const guard = foreign_keys && steps.some(step => step.action.startsWith(\"rebuild\"));\n const sql = steps.flatMap(step => step.sql);\n\n if (db.batch && !guard)\n return db.batch(sql);\n\n if (db.batch) {\n await db.exec(\"PRAGMA foreign_keys = OFF\").catch(() => {});\n\n try {\n if ((await db.get(\"PRAGMA foreign_keys\")).foreign_keys)\n throw new Error(\"Cannot rebuild: this engine keeps foreign keys on, so dropping the table would cascade.\");\n\n const broken: { table: string }[] = await db.all(\"PRAGMA foreign_key_check\");\n\n if (broken.length)\n throw new Error(dangling(broken));\n\n return await db.batch(sql);\n }\n finally {\n await db.exec(\"PRAGMA foreign_keys = ON\").catch(() => {});\n }\n }\n\n if (guard)\n await db.exec(\"PRAGMA foreign_keys = OFF\");\n\n await db.exec(\"BEGIN\");\n\n try {\n await db.exec(sql.join(\"\\n\"));\n\n const broken: { table: string }[] = guard ? await db.all(\"PRAGMA foreign_key_check\") : [];\n\n if (broken.length)\n throw new Error(dangling(broken));\n\n await db.exec(\"COMMIT\");\n }\n catch (error) {\n await db.exec(\"ROLLBACK\");\n throw error;\n }\n finally {\n if (guard)\n await db.exec(\"PRAGMA foreign_keys = ON\");\n }\n }\n\n async valid(type: Query.Table){\n const found = await this.inspect(type);\n\n if (!found)\n return false;\n\n const [problem] = [...found.drift.map(({ message }) => message), ...found.issues];\n\n if (problem)\n throw new Error(problem);\n\n return found.absent;\n }\n\n protected async inspect(type: Query.Table, planning = false){\n const { table } = type;\n const db = await this.db();\n\n const tableExists = await db.get(\n `SELECT name FROM sqlite_master WHERE type='table' AND name=?`, [table]);\n\n if (!tableExists)\n return false;\n\n const columns = await db.all(`PRAGMA table_info(${table})`) as TableInfo[];\n const absent: Field[] = [];\n const drift: { field: Field, message: string }[] = [];\n const issues: string[] = [];\n\n for (const field of type.fields.values()) {\n if (field.parts)\n continue;\n\n const info = columns.find(col => col.name === field.column);\n\n if (!info) {\n absent.push(field);\n continue;\n }\n\n const message = drifted(field, info);\n\n if (message)\n drift.push({ field, message });\n\n issues.push(...await this.references(field, planning));\n }\n\n return { columns, absent, drift, issues };\n }\n\n protected async unindexed(type: Query.Table){\n const db = await this.db();\n const covered = new Set<string>();\n\n for (const { name } of await db.all(`PRAGMA index_list(${type.table})`)) {\n const columns = await db.all(`PRAGMA index_info(\\`${name}\\`)`);\n\n if (columns.length == 1)\n covered.add(columns[0].name);\n }\n\n return indexed(type).filter(field => !covered.has(field.column));\n }\n\n protected async misfit(type: Query.Table, fields: Field[], columns: TableInfo[]){\n const db = await this.db();\n const { table } = type;\n const problems: string[] = [];\n\n for (const field of fields) {\n const info = columns.find(col => col.name === field.column)!;\n const column = `\\`${field.column}\\``;\n const expected = affinity(field);\n const fits = FITS[expected];\n const checks: [string, string][] = [];\n\n if (!field.nullable)\n checks.push([`${column} IS NULL`, \"NULL\"]);\n\n if (info.type.toUpperCase() !== expected && fits)\n checks.push([`${column} IS NOT NULL AND NOT (${fits(column)})`, `not ${expected}`]);\n\n for (const [where, what] of checks) {\n const { count } = await db.get(`SELECT COUNT(*) AS count FROM ${table} WHERE ${where}`);\n\n if (count)\n problems.push(\n `Column ${field.column} in table ${table} cannot be rebuilt: ${count} ${count == 1 ? \"row is\" : \"rows are\"} ${what}.`\n );\n }\n }\n\n return problems;\n }\n\n protected async rebuild(type: Query.Table, fields: Field[], columns: TableInfo[]){\n const db = await this.db();\n const { table } = type;\n const temp = `${table}__rebuild`;\n const own = Array.from(type.fields.values()).filter(field => !field.parts);\n const known = new Set(own.map(field => field.column));\n const extra = columns.filter(col => !known.has(col.name));\n const cast = new Set(fields.filter(field => (\n columns.find(col => col.name === field.column)!.type.toUpperCase() !== affinity(field)\n )));\n\n const copied = [\n ...own\n .filter(field => columns.some(col => col.name === field.column))\n .map(field => [field.column, cast.has(field) ? `CAST(\\`${field.column}\\` AS ${affinity(field)})` : `\\`${field.column}\\``]),\n ...extra.map(col => [col.name, `\\`${col.name}\\``])\n ];\n\n const indexes = await db.all(\n `SELECT sql FROM sqlite_master WHERE type IN ('index', 'trigger') AND tbl_name = ? AND sql IS NOT NULL`, [table]);\n\n return [\n this.tableSchema(type, temp, extra.map(col => (\n `\\`${col.name}\\` ${col.type}` +\n (col.notnull ? \" NOT NULL\" : \"\") +\n (col.dflt_value != null ? ` DEFAULT ${col.dflt_value}` : \"\")\n ))),\n `INSERT INTO ${temp} (${copied.map(([column]) => `\\`${column}\\``).join(\", \")}) ` +\n `SELECT ${copied.map(([, value]) => value).join(\", \")} FROM ${table};`,\n `DROP TABLE ${table};`,\n `ALTER TABLE ${temp} RENAME TO ${table};`,\n ...indexes.map(({ sql }: { sql: string }) => `${sql};`)\n ];\n }\n\n protected async references(field: Field, planning: boolean): Promise<string[]> {\n const { reference } = field;\n\n if (!reference)\n return [];\n\n const foreignKey = reference.column;\n const foreignTable = reference.parent!.table;\n\n if (reference.parent!.connection !== this)\n return [`Foreign key ${foreignTable}.${foreignKey} cannot be checked by another connection`];\n\n const db = await this.db();\n\n const foreignTableExists = await db.get(\n `SELECT name FROM sqlite_master WHERE type='table' AND name=?`, [foreignTable]);\n\n if (!foreignTableExists)\n return planning && this.using.has(reference.parent!) ? [] : [`Referenced table ${foreignTable} does not exist`];\n\n const foreignColumn = (await db.all(`PRAGMA table_info(${foreignTable})`))\n .find(col => col.name === foreignKey);\n\n if (!foreignColumn)\n return [`Referenced column ${foreignKey} does not exist in table ${foreignTable}`];\n\n return [];\n }\n\n protected generateSchema(types: Iterable<Query.Table>): string {\n return Array.from(types)\n .map(type => this.generateTableSchema(type))\n .join('\\n');\n }\n\n protected generateTableSchema(type: Query.Table): string {\n return [this.tableSchema(type), ...indexed(type).map(index)].join('\\n');\n }\n\n protected tableSchema(type: Query.Table, name = type.table, extra: string[] = []){\n const { parts } = type.fields.get(\"id\")!;\n const fields = [\n ...Array.from(type.fields.values()).filter(field => !field.parts).map(field => definition(field)),\n ...extra\n ];\n\n if (parts)\n fields.push(`PRIMARY KEY (${parts.map(part => `\\`${part.column}\\``).join(', ')})`);\n\n return `CREATE TABLE ${name} (${fields.join(', ')});`;\n }\n}\n\nfunction indexed(type: Query.Table){\n return Array.from(type.fields.values()).filter(field => field.index && !field.primary && !field.unique);\n}\n\nfunction dangling(rows: { table: string }[]){\n const tables = [...new Set(rows.map(row => row.table))].join(\", \");\n\n return `Cannot rebuild: ${tables} has references to missing rows (${rows.length}).`;\n}\n\nfunction indexName(field: Field){\n return typeof field.index == \"string\" ? field.index : `${field.parent!.table}_${field.column}`;\n}\n\nfunction index(field: Field){\n return `CREATE INDEX IF NOT EXISTS \\`${indexName(field)}\\` ON ${field.parent!.table} (\\`${field.column}\\`);`;\n}\n\nfunction drifted(field: Field, info: TableInfo){\n const { column, nullable, primary } = field;\n const parent = field.parent!;\n const keyed = primary || parent.fields.get(\"id\")!.parts?.includes(field);\n const expected = affinity(field);\n\n if (info.type.toUpperCase() !== expected)\n return `Column ${column} in table ${parent.table} has type ${info.type}, expected ${expected}`;\n\n if (!keyed && info.notnull === (nullable ? 1 : 0))\n return `Column ${column} in table ${parent.table} has incorrect nullable value`;\n}\n\nconst NUMBER = (column: string) =>\n `typeof(${column}) = 'text' AND CASE WHEN json_valid(trim(${column})) THEN json_type(trim(${column})) ELSE '' END IN ('integer', 'real')`;\n\nconst FITS: Record<string, (column: string) => string> = {\n INTEGER: column =>\n `typeof(${column}) = 'integer' OR typeof(${column}) = 'real' AND ${column} = CAST(${column} AS INTEGER) ` +\n `OR ${NUMBER(column)} AND ${column} NOT GLOB '*[eE]*' AND CAST(${column} AS REAL) = CAST(${column} AS INTEGER)`,\n REAL: column =>\n `typeof(${column}) IN ('integer', 'real') OR ${NUMBER(column)}`\n};\n\nFITS.NUMERIC = FITS.REAL;\n\nfunction definition(field: Field, adding?: boolean){\n const {\n column,\n fallback,\n reference,\n increment,\n nullable,\n primary,\n unique,\n } = field;\n\n const { onDelete, onUpdate } = field as Field & { onDelete?: string, onUpdate?: string };\n let parts = `\\`${column}\\` ${affinity(field)}`;\n\n if (!nullable) parts += ' NOT NULL';\n if (primary) parts += ' PRIMARY KEY';\n if (increment) parts += ' AUTOINCREMENT';\n if (unique) parts += ' UNIQUE';\n\n if (fallback !== undefined && !(adding && clock(fallback)))\n parts += ' DEFAULT ' + literal(field, fallback);\n\n if (reference)\n parts += ` REFERENCES ${reference.parent!.table}(${reference.column})`;\n\n if (onDelete) parts += ` ON DELETE ${onDelete}`;\n if (onUpdate) parts += ` ON UPDATE ${onUpdate}`;\n\n return parts;\n}\n\nfunction moved(field: Field, existing: string[]){\n const { entity } = field as Field & { entity?: Query.Table };\n const old = entity && `${entity.table}_id`;\n const taken = Array.from(field.parent!.fields.values()).some(other => other.column === old);\n\n if (old && !taken && existing.includes(old))\n return `is missing but ${old} exists; add { column: \"${old}\" } to ${field.parent!.name}.${field.key} to keep it.`;\n}\n\nfunction clock(fallback: unknown){\n return fallback === \"NOW\" || fallback === now;\n}\n\nfunction unfit({ primary, unique, nullable, fallback }: Field){\n if (primary)\n return \"is a primary key and cannot be added to an existing table.\";\n\n if (unique)\n return \"is UNIQUE and cannot be added by SQLite.\";\n\n if (!nullable && fallback === undefined)\n return \"is NOT NULL without a default and cannot be added to existing rows.\";\n\n if (!nullable && clock(fallback))\n return \"defaults to the current time and cannot be added by SQLite.\";\n}\n\nconst AFFINITY: Record<string, string> = {\n integer: \"INTEGER\",\n smallint: \"INTEGER\",\n bigint: \"INTEGER\",\n ms: \"INTEGER\",\n seconds: \"INTEGER\",\n boolean: \"INTEGER\",\n real: \"REAL\",\n float: \"REAL\",\n double: \"REAL\",\n numeric: \"NUMERIC\",\n decimal: \"NUMERIC\",\n text: \"TEXT\",\n varchar: \"TEXT\",\n char: \"TEXT\",\n uuid: \"TEXT\",\n timestamp: \"TEXT\",\n date: \"TEXT\",\n time: \"TEXT\"\n};\n\nfunction affinity(field: Field){\n const type = AFFINITY[field.type] || field.datatype.toUpperCase();\n\n if (!type)\n throw new Error(`Column ${field.column} has no datatype. Is @expressive/orm installed twice?`);\n\n return type;\n}\n\nfunction literal(field: Field, value: unknown){\n if (value === \"NOW\" || value === now)\n return `(${current(field)})`;\n\n if (value === null)\n return \"NULL\";\n\n const encoded = field.set(value);\n\n return typeof encoded == \"string\"\n ? `'${encoded.replace(/'/g, \"''\")}'`\n : String(encoded);\n}\n\nfunction pretty(sql: string){\n try {\n return format(sql, { language: 'sqlite', keywordCase: \"upper\" })\n .replace(/ - > > /g, \" ->> \")\n .replace(/`([a-zA-Z][a-zA-Z0-9_]*)`/g, \"$1\");\n }\n catch {\n return sql;\n }\n}"],"mappings":"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"}
1
+ {"version":3,"file":"SQLiteConnection.js","names":["Connection","#statements","current"],"sources":["../../src/sqlite/SQLiteConnection.ts"],"sourcesContent":["import { Field, now, Query } from '@expressive/orm';\nimport { Builder } from '@expressive/orm/driver';\nimport { Connection } from '../connection/Connection';\nimport { format } from 'sql-formatter';\n\nimport { createEngine, type D1Database, Engine, host, type LibSQLClient, migrations } from './engine';\nimport { now as current, SQLiteGenerator } from './SQLiteGenerator';\n\ntype TableInfo = {\n name: string;\n type: string;\n notnull: number;\n dflt_value: any\n};\n\n/**\n * A connection to SQLite - a file, in memory, a libSQL address, a D1 binding, a libSQL client or a given `Engine`.\n *\n * The built-in loader takes the first of `bun:sqlite`, `node:sqlite`, `better-sqlite3`, `sqlite3`, `@libsql/client`, with foreign keys on.\n * Awaiting it runs `sync`. No live rows.\n *\n * @example\n * const db = await SQLiteConnection.new([User, Post], \"app.db\");\n */\nexport class SQLiteConnection extends Connection {\n protected filename: string;\n protected engine?: Promise<Engine>;\n protected owned = true;\n\n /**\n * Bind `using` to a SQLite database. Construct with `SQLiteConnection.new`.\n *\n * Without `source`, the database is in memory. A filename opens through the built-in loader.\n * A `libsql:`, `https:`, `http:`, `ws:` or `wss:` address opens a `@libsql/client` 0.18 or later - pass a token as `?authToken=`.\n * A D1 binding, a libSQL client or an `Engine` is used as given - foreign keys are not switched on, and `close()` leaves it open.\n * D1 refuses `transaction`. libSQL runs each `transaction` on a libSQL write transaction, one at a time.\n */\n constructor(using: Connection.Types, source?: string | Engine | D1Database | LibSQLClient) {\n super(using);\n\n if (typeof source == \"object\") {\n (this.engine = Promise.resolve(source).then(host)).catch(() => {});\n this.owned = false;\n }\n\n this.filename = typeof source == \"string\" && source || ':memory:';\n }\n\n protected db(){\n return this.engine ??= createEngine(this.filename);\n }\n\n async #statements(): Promise<Engine.Statements> {\n await this.idle();\n\n return this._journal()?.session as Engine.Session || this.db();\n }\n\n /** `CREATE TABLE` and `CREATE INDEX` statements for the bound classes, formatted. */\n get schema() {\n return pretty(this.generateSchema(this.using));\n }\n\n /**\n * Compile a builder to SQLite SQL.\n *\n * A failure when run rethrows as `Error running SQL: <message>` with the statement.\n */\n prepare(builder: Builder){\n const sql = String(new SQLiteGenerator(builder));\n const string = (x?: unknown[]) => x\n ? x.map(x => (\n x !== null && typeof x === 'object' ? JSON.stringify(x) :\n typeof x === 'boolean' ? Number(x) :\n x\n ))\n : [];\n\n const run = async <R>(op: (engine: Engine.Statements) => Promise<R>) => {\n try {\n return await op(await this.#statements());\n }\n catch (err) {\n if(err instanceof Error)\n throw new Error(`Error running SQL: ${err.message}\\n${pretty(sql)}`);\n\n throw err;\n }\n };\n\n const counts = !builder.returns && !builder.inserts.size && !builder.updates.size && !builder.deletes.size;\n\n return {\n all: (p?: any[]) => run(e => e.all(sql, string(p))),\n run: counts\n ? (p?: any[]) => run(e => e.get(sql, string(p)).then(row => Number(Object.values(row)[0])))\n : (p?: any[]) => run(e => e.run(sql, string(p)).then(r => r.changes)),\n toString: () => pretty(sql)\n };\n }\n\n protected async transact<T>(fn: () => Promise<T>): Promise<T> {\n const db = await this.db();\n const session = this._journal()!.session = await db.transaction?.();\n\n if (!session)\n await db.exec(\"BEGIN\");\n\n try {\n const result = await fn();\n\n await (session ? session.commit() : db.exec(\"COMMIT\"));\n\n return result;\n }\n catch (error) {\n await (session ? session.rollback() : db.exec(\"ROLLBACK\")).catch(() => {});\n throw error;\n }\n }\n\n /** Close the database when this connection opened it, then release the connection. */\n async close(){\n const engine = await this.engine?.catch(() => undefined);\n\n if (engine && this.owned)\n await engine.close();\n\n await super.close();\n }\n\n /**\n * Bring the database in line with the bound classes, then mark the connection ready.\n *\n * Creates missing tables and adds missing columns and indexes, in one transaction. Throws for any problem `plan` reports, changing nothing.\n * `fix` false only verifies - anything missing throws too. `force` rebuilds a table whose column type or nullability drifted.\n * Throws when the connection is already ready.\n */\n async sync(fix = true, force = false){\n if (this.ready)\n throw new Error(\"Connection is already active.\");\n\n const { steps, problems } = await this.plan(force);\n const issues = fix ? problems : [...problems, ...steps.map(step => step.reason)];\n\n if (issues.length)\n throw new Error(issues.join(\"\\n\"));\n\n if (steps.length)\n await this.apply(steps);\n\n (this as Connection).set({ ready: true });\n\n return this;\n }\n\n /**\n * List what `sync` would do, without doing it.\n *\n * `problems` are what it cannot fix - drift without `force`, a column SQLite cannot add, a missing referenced table, `static schema`.\n */\n async plan(force = false): Promise<Connection.Plan> {\n const steps: Connection.Step[] = [];\n const problems: string[] = [];\n\n for (const type of this.using) {\n const { table } = type;\n\n if (type.schema) {\n problems.push(`static schema is not supported by ${this.constructor.name}.`);\n continue;\n }\n\n const found = await this.inspect(type, true);\n\n if (!found) {\n steps.push({ table, action: `create table ${table}`, reason: `Table ${table} does not exist.`, sql: [this.tableSchema(type), ...indexed(type).map(index)] });\n continue;\n }\n\n const { columns, absent, drift, issues } = found;\n const rebuild = force && drift.length > 0;\n\n problems.push(...issues);\n\n if (!rebuild)\n problems.push(...drift.map(({ message }) => message));\n\n for (const field of absent) {\n const reason = moved(field, columns.map(col => col.name)) || unfit(field);\n\n if (reason)\n problems.push(`Column ${field.column} in table ${table} ${reason}`);\n else if (!rebuild)\n steps.push({\n table,\n column: field.column,\n action: `add column ${field.column} to ${table}`,\n reason: `Column ${field.column} does not exist in table ${table}`,\n sql: [`ALTER TABLE ${table} ADD COLUMN ${definition(field, true)};`]\n });\n }\n\n if (rebuild) {\n const fields = drift.map(({ field }) => field);\n const misfit = await this.misfit(type, fields, columns);\n\n if (misfit.length)\n problems.push(...misfit);\n else\n steps.push({\n table,\n action: `rebuild table ${table}`,\n reason: drift.map(({ message }) => message).join(\"; \"),\n sql: await this.rebuild(type, fields, columns)\n });\n }\n\n for (const field of await this.unindexed(type))\n steps.push({\n table,\n column: field.column,\n action: `create index ${indexName(field)} on ${table}`,\n reason: `Index ${indexName(field)} does not exist on ${table}`,\n sql: [index(field)]\n });\n }\n\n return { steps, problems };\n }\n\n protected async apply(steps: Connection.Step[]){\n const db = await this.db();\n const rebuilds = steps.some(step => step.action.startsWith(\"rebuild\"));\n const sql = steps.flatMap(step => step.sql);\n const migrate = migrations.get(db);\n\n if (migrate && rebuilds) {\n await intact(db);\n return void await migrate(sql);\n }\n\n const guard = rebuilds && (await db.get(\"PRAGMA foreign_keys\"))?.foreign_keys;\n\n if (db.batch && !guard)\n return db.batch(sql);\n\n if (db.batch) {\n await db.exec(\"PRAGMA foreign_keys = OFF\").catch(() => {});\n\n try {\n if ((await db.get(\"PRAGMA foreign_keys\")).foreign_keys)\n throw new Error(\"Cannot rebuild: this engine keeps foreign keys on, so dropping the table would cascade.\");\n\n await intact(db);\n\n return await db.batch(sql);\n }\n finally {\n await db.exec(\"PRAGMA foreign_keys = ON\").catch(() => {});\n }\n }\n\n if (guard)\n await db.exec(\"PRAGMA foreign_keys = OFF\");\n\n await db.exec(\"BEGIN\");\n\n try {\n await db.exec(sql.join(\"\\n\"));\n\n if (guard)\n await intact(db);\n\n await db.exec(\"COMMIT\");\n }\n catch (error) {\n await db.exec(\"ROLLBACK\");\n throw error;\n }\n finally {\n if (guard)\n await db.exec(\"PRAGMA foreign_keys = ON\");\n }\n }\n\n async valid(type: Query.Table){\n const found = await this.inspect(type);\n\n if (!found)\n return false;\n\n const [problem] = [...found.drift.map(({ message }) => message), ...found.issues];\n\n if (problem)\n throw new Error(problem);\n\n return found.absent;\n }\n\n protected async inspect(type: Query.Table, planning = false){\n const { table } = type;\n const db = await this.#statements();\n\n const tableExists = await db.get(\n `SELECT name FROM sqlite_master WHERE type='table' AND name=?`, [table]);\n\n if (!tableExists)\n return false;\n\n const columns = await db.all(`PRAGMA table_info(${table})`) as TableInfo[];\n const absent: Field[] = [];\n const drift: { field: Field, message: string }[] = [];\n const issues: string[] = [];\n\n for (const field of type.fields.values()) {\n if (field.parts)\n continue;\n\n const info = columns.find(col => col.name === field.column);\n\n if (!info) {\n absent.push(field);\n continue;\n }\n\n const message = drifted(field, info);\n\n if (message)\n drift.push({ field, message });\n\n issues.push(...await this.references(field, planning));\n }\n\n return { columns, absent, drift, issues };\n }\n\n protected async unindexed(type: Query.Table){\n const db = await this.#statements();\n const covered = new Set<string>();\n\n for (const { name } of await db.all(`PRAGMA index_list(${type.table})`)) {\n const columns = await db.all(`PRAGMA index_info(\\`${name}\\`)`);\n\n if (columns.length == 1)\n covered.add(columns[0].name);\n }\n\n return indexed(type).filter(field => !covered.has(field.column));\n }\n\n protected async misfit(type: Query.Table, fields: Field[], columns: TableInfo[]){\n const db = await this.#statements();\n const { table } = type;\n const problems: string[] = [];\n\n for (const field of fields) {\n const info = columns.find(col => col.name === field.column)!;\n const column = `\\`${field.column}\\``;\n const expected = affinity(field);\n const fits = FITS[expected];\n const checks: [string, string][] = [];\n\n if (!field.nullable)\n checks.push([`${column} IS NULL`, \"NULL\"]);\n\n if (info.type.toUpperCase() !== expected && fits)\n checks.push([`${column} IS NOT NULL AND NOT (${fits(column)})`, `not ${expected}`]);\n\n for (const [where, what] of checks) {\n const { count } = await db.get(`SELECT COUNT(*) AS count FROM ${table} WHERE ${where}`);\n\n if (count)\n problems.push(\n `Column ${field.column} in table ${table} cannot be rebuilt: ${count} ${count == 1 ? \"row is\" : \"rows are\"} ${what}.`\n );\n }\n }\n\n return problems;\n }\n\n protected async rebuild(type: Query.Table, fields: Field[], columns: TableInfo[]){\n const db = await this.#statements();\n const { table } = type;\n const temp = `${table}__rebuild`;\n const own = Array.from(type.fields.values()).filter(field => !field.parts);\n const known = new Set(own.map(field => field.column));\n const extra = columns.filter(col => !known.has(col.name));\n const cast = new Set(fields.filter(field => (\n columns.find(col => col.name === field.column)!.type.toUpperCase() !== affinity(field)\n )));\n\n const copied = [\n ...own\n .filter(field => columns.some(col => col.name === field.column))\n .map(field => [field.column, cast.has(field) ? `CAST(\\`${field.column}\\` AS ${affinity(field)})` : `\\`${field.column}\\``]),\n ...extra.map(col => [col.name, `\\`${col.name}\\``])\n ];\n\n const indexes = await db.all(\n `SELECT sql FROM sqlite_master WHERE type IN ('index', 'trigger') AND tbl_name = ? AND sql IS NOT NULL`, [table]);\n\n return [\n this.tableSchema(type, temp, extra.map(col => (\n `\\`${col.name}\\` ${col.type}` +\n (col.notnull ? \" NOT NULL\" : \"\") +\n (col.dflt_value != null ? ` DEFAULT ${col.dflt_value}` : \"\")\n ))),\n `INSERT INTO ${temp} (${copied.map(([column]) => `\\`${column}\\``).join(\", \")}) ` +\n `SELECT ${copied.map(([, value]) => value).join(\", \")} FROM ${table};`,\n `DROP TABLE ${table};`,\n `ALTER TABLE ${temp} RENAME TO ${table};`,\n ...indexes.map(({ sql }: { sql: string }) => `${sql};`)\n ];\n }\n\n protected async references(field: Field, planning: boolean): Promise<string[]> {\n const { reference } = field;\n\n if (!reference)\n return [];\n\n const foreignKey = reference.column;\n const foreignTable = reference.parent!.table;\n\n if (reference.parent!.connection !== this)\n return [`Foreign key ${foreignTable}.${foreignKey} cannot be checked by another connection`];\n\n const db = await this.#statements();\n\n const foreignTableExists = await db.get(\n `SELECT name FROM sqlite_master WHERE type='table' AND name=?`, [foreignTable]);\n\n if (!foreignTableExists)\n return planning && this.using.has(reference.parent!) ? [] : [`Referenced table ${foreignTable} does not exist`];\n\n const foreignColumn = (await db.all(`PRAGMA table_info(${foreignTable})`))\n .find(col => col.name === foreignKey);\n\n if (!foreignColumn)\n return [`Referenced column ${foreignKey} does not exist in table ${foreignTable}`];\n\n return [];\n }\n\n protected generateSchema(types: Iterable<Query.Table>): string {\n return Array.from(types)\n .map(type => this.generateTableSchema(type))\n .join('\\n');\n }\n\n protected generateTableSchema(type: Query.Table): string {\n return [this.tableSchema(type), ...indexed(type).map(index)].join('\\n');\n }\n\n protected tableSchema(type: Query.Table, name = type.table, extra: string[] = []){\n const { parts } = type.fields.get(\"id\")!;\n const fields = [\n ...Array.from(type.fields.values()).filter(field => !field.parts).map(field => definition(field)),\n ...extra\n ];\n\n if (parts)\n fields.push(`PRIMARY KEY (${parts.map(part => `\\`${part.column}\\``).join(', ')})`);\n\n return `CREATE TABLE ${name} (${fields.join(', ')});`;\n }\n}\n\nfunction indexed(type: Query.Table){\n return Array.from(type.fields.values()).filter(field => field.index && !field.primary && !field.unique);\n}\n\nasync function intact(db: Engine.Statements){\n const broken: { table: string }[] = await db.all(\"PRAGMA foreign_key_check\");\n\n if (broken.length) {\n const tables = [...new Set(broken.map(row => row.table))].join(\", \");\n\n throw new Error(`Cannot rebuild: ${tables} has references to missing rows (${broken.length}).`);\n }\n}\n\nfunction indexName(field: Field){\n return typeof field.index == \"string\" ? field.index : `${field.parent!.table}_${field.column}`;\n}\n\nfunction index(field: Field){\n return `CREATE INDEX IF NOT EXISTS \\`${indexName(field)}\\` ON ${field.parent!.table} (\\`${field.column}\\`);`;\n}\n\nfunction drifted(field: Field, info: TableInfo){\n const { column, nullable, primary } = field;\n const parent = field.parent!;\n const keyed = primary || parent.fields.get(\"id\")!.parts?.includes(field);\n const expected = affinity(field);\n\n if (info.type.toUpperCase() !== expected)\n return `Column ${column} in table ${parent.table} has type ${info.type}, expected ${expected}`;\n\n if (!keyed && info.notnull === (nullable ? 1 : 0))\n return `Column ${column} in table ${parent.table} has incorrect nullable value`;\n}\n\nconst NUMBER = (column: string) =>\n `typeof(${column}) = 'text' AND CASE WHEN json_valid(trim(${column})) THEN json_type(trim(${column})) ELSE '' END IN ('integer', 'real')`;\n\nconst FITS: Record<string, (column: string) => string> = {\n INTEGER: column =>\n `typeof(${column}) = 'integer' OR typeof(${column}) = 'real' AND ${column} = CAST(${column} AS INTEGER) ` +\n `OR ${NUMBER(column)} AND ${column} NOT GLOB '*[eE]*' AND CAST(${column} AS REAL) = CAST(${column} AS INTEGER)`,\n REAL: column =>\n `typeof(${column}) IN ('integer', 'real') OR ${NUMBER(column)}`\n};\n\nFITS.NUMERIC = FITS.REAL;\n\nfunction definition(field: Field, adding?: boolean){\n const {\n column,\n fallback,\n reference,\n increment,\n nullable,\n primary,\n unique,\n } = field;\n\n const { onDelete, onUpdate } = field as Field & { onDelete?: string, onUpdate?: string };\n let parts = `\\`${column}\\` ${affinity(field)}`;\n\n if (!nullable) parts += ' NOT NULL';\n if (primary) parts += ' PRIMARY KEY';\n if (increment) parts += ' AUTOINCREMENT';\n if (unique) parts += ' UNIQUE';\n\n if (fallback !== undefined && !(adding && clock(fallback)))\n parts += ' DEFAULT ' + literal(field, fallback);\n\n if (reference)\n parts += ` REFERENCES ${reference.parent!.table}(${reference.column})`;\n\n if (onDelete) parts += ` ON DELETE ${onDelete}`;\n if (onUpdate) parts += ` ON UPDATE ${onUpdate}`;\n\n return parts;\n}\n\nfunction moved(field: Field, existing: string[]){\n const { entity } = field as Field & { entity?: Query.Table };\n const old = entity && `${entity.table}_id`;\n const taken = Array.from(field.parent!.fields.values()).some(other => other.column === old);\n\n if (old && !taken && existing.includes(old))\n return `is missing but ${old} exists; add { column: \"${old}\" } to ${field.parent!.name}.${field.key} to keep it.`;\n}\n\nfunction clock(fallback: unknown){\n return fallback === \"NOW\" || fallback === now;\n}\n\nfunction unfit({ primary, unique, nullable, fallback }: Field){\n if (primary)\n return \"is a primary key and cannot be added to an existing table.\";\n\n if (unique)\n return \"is UNIQUE and cannot be added by SQLite.\";\n\n if (!nullable && fallback === undefined)\n return \"is NOT NULL without a default and cannot be added to existing rows.\";\n\n if (!nullable && clock(fallback))\n return \"defaults to the current time and cannot be added by SQLite.\";\n}\n\nconst AFFINITY: Record<string, string> = {\n integer: \"INTEGER\",\n smallint: \"INTEGER\",\n bigint: \"INTEGER\",\n ms: \"INTEGER\",\n seconds: \"INTEGER\",\n boolean: \"INTEGER\",\n real: \"REAL\",\n float: \"REAL\",\n double: \"REAL\",\n numeric: \"NUMERIC\",\n decimal: \"NUMERIC\",\n text: \"TEXT\",\n varchar: \"TEXT\",\n char: \"TEXT\",\n uuid: \"TEXT\",\n timestamp: \"TEXT\",\n date: \"TEXT\",\n time: \"TEXT\"\n};\n\nfunction affinity(field: Field){\n const type = AFFINITY[field.type] || field.datatype.toUpperCase();\n\n if (!type)\n throw new Error(`Column ${field.column} has no datatype. Is @expressive/orm installed twice?`);\n\n return type;\n}\n\nfunction literal(field: Field, value: unknown){\n if (value === \"NOW\" || value === now)\n return `(${current(field)})`;\n\n if (value === null)\n return \"NULL\";\n\n const encoded = field.set(value);\n\n return typeof encoded == \"string\"\n ? `'${encoded.replace(/'/g, \"''\")}'`\n : String(encoded);\n}\n\nfunction pretty(sql: string){\n try {\n return format(sql, { language: 'sqlite', keywordCase: \"upper\" })\n .replace(/ - > > /g, \" ->> \")\n .replace(/`([a-zA-Z][a-zA-Z0-9_]*)`/g, \"$1\");\n }\n catch {\n return sql;\n }\n}"],"mappings":"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"}
@@ -42,6 +42,45 @@ declare namespace Engine {
42
42
  }
43
43
  }
44
44
  declare function createEngine(filename: string): Promise<Engine>;
45
+ declare function host(source: Engine | D1Database | LibSQLClient): Engine;
46
+ declare const migrations: WeakMap<Engine, (sql: string[]) => Promise<unknown>>;
47
+ /** A libSQL client from `@libsql/client` 0.18 or later - local, Turso or any libSQL server. */
48
+ interface LibSQLClient extends LibSQLStatements {
49
+ batch(sql: string[], mode: "write"): Promise<unknown>;
50
+ migrate(sql: string[]): Promise<unknown>;
51
+ transaction(mode: "write"): Promise<LibSQLStatements & {
52
+ commit(): Promise<void>;
53
+ rollback(): Promise<void>;
54
+ }>;
55
+ close(): void;
56
+ }
57
+ interface LibSQLStatements {
58
+ execute(statement: {
59
+ sql: string;
60
+ args: any[];
61
+ }): Promise<{
62
+ rows: any[];
63
+ rowsAffected: number;
64
+ }>;
65
+ executeMultiple(sql: string): Promise<void>;
66
+ }
67
+ /** A Cloudflare D1 binding, such as a Worker's `env.DB`. */
68
+ interface D1Database {
69
+ prepare(sql: string): D1Statement;
70
+ batch(statements: D1Statement[]): Promise<unknown>;
71
+ }
72
+ interface D1Statement {
73
+ bind(...values: any[]): D1Statement;
74
+ all(): Promise<{
75
+ results: any[];
76
+ }>;
77
+ first(): Promise<any>;
78
+ run(): Promise<{
79
+ meta: {
80
+ changes: number;
81
+ };
82
+ }>;
83
+ }
45
84
  //#endregion
46
- export { Engine, createEngine };
85
+ export { D1Database, Engine, LibSQLClient, createEngine, host, migrations };
47
86
  //# sourceMappingURL=engine.d.ts.map
@@ -6,7 +6,9 @@ const DRIVERS = [
6
6
  sqlite3,
7
7
  libsql
8
8
  ];
9
+ const REMOTE = /^(libsql|https?|wss?):\/\//;
9
10
  async function createEngine(filename) {
11
+ if (REMOTE.test(filename)) return libsql(filename, filename);
10
12
  for (const load of DRIVERS) {
11
13
  const engine = await load(filename).catch(() => null);
12
14
  if (engine) {
@@ -36,9 +38,9 @@ async function sqlite3(file) {
36
38
  const { default: { Database } } = await optional("sqlite3");
37
39
  return asyncEngine(new Database(file));
38
40
  }
39
- async function libsql(file) {
41
+ async function libsql(file, url = file === ":memory:" ? file : `file:${file}`) {
40
42
  const { createClient } = await optional("@libsql/client");
41
- return libsqlEngine(createClient({ url: file === ":memory:" ? ":memory:" : `file:${file}` }));
43
+ return libsqlEngine(createClient({ url }));
42
44
  }
43
45
  function syncEngine(db) {
44
46
  return {
@@ -75,7 +77,36 @@ function asyncEngine(db) {
75
77
  close: () => new Promise((resolve, reject) => db.close(done(resolve, reject)))
76
78
  };
77
79
  }
80
+ function host(source) {
81
+ const has = (key) => source && typeof source == "object" && key in source;
82
+ if (has("all")) return source;
83
+ if (has("execute")) return libsqlEngine(source);
84
+ if (has("prepare") && has("batch")) return d1Engine(source);
85
+ throw new TypeError("Unknown SQLite source. Pass a filename, a libSQL address, a D1 binding, a libSQL client or an Engine.");
86
+ }
87
+ const migrations = /* @__PURE__ */ new WeakMap();
78
88
  function libsqlEngine(client) {
89
+ const engine = {
90
+ ...libsqlStatements(client),
91
+ async batch(sql) {
92
+ await client.batch(sql, "write");
93
+ },
94
+ async transaction() {
95
+ const tx = await client.transaction("write");
96
+ return {
97
+ ...libsqlStatements(tx),
98
+ commit: () => tx.commit(),
99
+ rollback: () => tx.rollback()
100
+ };
101
+ },
102
+ async close() {
103
+ client.close();
104
+ }
105
+ };
106
+ migrations.set(engine, (sql) => client.migrate(sql));
107
+ return engine;
108
+ }
109
+ function libsqlStatements(client) {
79
110
  const execute = (sql, args) => client.execute({
80
111
  sql,
81
112
  args
@@ -92,13 +123,34 @@ function libsqlEngine(client) {
92
123
  },
93
124
  async exec(sql) {
94
125
  await client.executeMultiple(sql);
95
- },
96
- async close() {
97
- client.close();
98
126
  }
99
127
  };
100
128
  }
129
+ function d1Engine(db) {
130
+ const statement = (sql, params = []) => db.prepare(sql).bind(...params);
131
+ return {
132
+ async all(sql, params) {
133
+ return (await statement(sql, params).all()).results;
134
+ },
135
+ async get(sql, params) {
136
+ return await statement(sql, params).first() ?? void 0;
137
+ },
138
+ async run(sql, params) {
139
+ return { changes: (await statement(sql, params).run()).meta.changes };
140
+ },
141
+ async exec(sql) {
142
+ await db.prepare(sql).run();
143
+ },
144
+ async batch(sql) {
145
+ await db.batch(sql.map((sql) => db.prepare(sql)));
146
+ },
147
+ async transaction() {
148
+ throw new Error("D1 has no interactive transactions.");
149
+ },
150
+ async close() {}
151
+ };
152
+ }
101
153
 
102
154
  //#endregion
103
- export { createEngine };
155
+ export { createEngine, host, migrations };
104
156
  //# sourceMappingURL=engine.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"engine.js","names":[],"sources":["../../src/sqlite/engine.ts"],"sourcesContent":["/**\n * A SQLite host - what `SQLiteConnection` runs statements on.\n *\n * Pass one in place of a filename for a SQLite the built-in loader cannot open.\n * It is used as given - foreign keys are not switched on, and the connection's `close()` leaves it open.\n */\nexport interface Engine extends Engine.Statements {\n /** Release the database. Called only on an engine the connection opened. */\n close(): Promise<void>;\n /**\n * Open a transaction on its own session.\n *\n * Without it the connection issues `BEGIN`, `COMMIT` and `ROLLBACK` through `exec`.\n */\n transaction?(): Promise<Engine.Session>;\n /**\n * Run statements atomically.\n *\n * `sync` applies through it when present; a table rebuild then needs foreign keys off.\n */\n batch?(sql: string[]): Promise<void>;\n}\n\nexport declare namespace Engine {\n /** Statement methods an engine and a session share. Parameters are positional. */\n interface Statements {\n /** Run a statement, resolving every row. */\n all(sql: string, params?: any[]): Promise<any[]>;\n /** Run a statement, resolving the first row. */\n get(sql: string, params?: any[]): Promise<any>;\n /** Run a statement, resolving how many rows changed. */\n run(sql: string, params?: any[]): Promise<{ changes: number }>;\n /** Run one or more statements without parameters. */\n exec(sql: string): Promise<void>;\n }\n\n /** A transaction's own handle - statements inside `db.transaction(fn)` run on it. */\n interface Session extends Statements {\n commit(): Promise<void>;\n rollback(): Promise<void>;\n }\n}\n\nconst DRIVERS = [bunSqlite, nodeSqlite, betterSqlite3, sqlite3, libsql];\n\nexport async function createEngine(filename: string): Promise<Engine> {\n for (const load of DRIVERS) {\n const engine = await load(filename).catch(() => null);\n\n if (engine) {\n await engine.exec(\"PRAGMA foreign_keys = ON\");\n return engine;\n }\n }\n\n throw new Error(\n \"No compatible SQLite driver found. Run under Bun or Node >=24, \" +\n \"or install one of: better-sqlite3, sqlite3, @libsql/client.\"\n );\n}\n\nfunction optional(name: string): Promise<any> {\n return import(name);\n}\n\nasync function bunSqlite(file: string): Promise<Engine | null> {\n if (typeof (globalThis as any).Bun === \"undefined\")\n return null;\n\n const { Database } = await optional(\"bun:sqlite\");\n\n return syncEngine(new Database(file));\n}\n\nasync function nodeSqlite(file: string): Promise<Engine | null> {\n const { DatabaseSync } = await optional(\"node:sqlite\");\n\n return syncEngine(new DatabaseSync(file));\n}\n\nasync function betterSqlite3(file: string): Promise<Engine | null> {\n const { default: Database } = await optional(\"better-sqlite3\");\n\n return syncEngine(new Database(file));\n}\n\nasync function sqlite3(file: string): Promise<Engine | null> {\n const { default: { Database } } = await optional(\"sqlite3\");\n\n return asyncEngine(new Database(file));\n}\n\nasync function libsql(file: string): Promise<Engine | null> {\n const { createClient } = await optional(\"@libsql/client\");\n const url = file === \":memory:\" ? \":memory:\" : `file:${file}`;\n\n return libsqlEngine(createClient({ url }));\n}\n\nfunction syncEngine(db: any): Engine {\n return {\n async all(sql, params = []) {\n return db.prepare(sql).all(...params);\n },\n async get(sql, params = []) {\n return db.prepare(sql).get(...params);\n },\n async run(sql, params = []) {\n return { changes: db.prepare(sql).run(...params).changes };\n },\n async exec(sql) {\n db.exec(sql);\n },\n async close() {\n db.close();\n }\n };\n}\n\nfunction asyncEngine(db: any): Engine {\n const call = (method: string, sql: string, params: any[]) =>\n new Promise<any>((resolve, reject) => {\n db[method](sql, params, function (this: any, err: any, rows: any) {\n if (err) reject(err);\n else resolve(method === \"run\" ? this : rows);\n });\n });\n\n const done = (resolve: () => void, reject: (err: any) => void) =>\n (err: any) => err ? reject(err) : resolve();\n\n return {\n all: (sql, params = []) => call(\"all\", sql, params),\n get: (sql, params = []) => call(\"get\", sql, params),\n run: (sql, params = []) => call(\"run\", sql, params).then(ctx => ({ changes: ctx.changes })),\n exec: sql => new Promise((resolve, reject) => db.exec(sql, done(resolve, reject))),\n close: () => new Promise((resolve, reject) => db.close(done(resolve, reject)))\n };\n}\n\nfunction libsqlEngine(client: any): Engine {\n const execute = (sql: string, args: any[]) => client.execute({ sql, args });\n\n return {\n async all(sql, params = []) {\n return (await execute(sql, params)).rows;\n },\n async get(sql, params = []) {\n return (await execute(sql, params)).rows[0];\n },\n async run(sql, params = []) {\n return { changes: Number((await execute(sql, params)).rowsAffected) };\n },\n async exec(sql) {\n await client.executeMultiple(sql);\n },\n async close() {\n client.close();\n }\n };\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"engine.js","names":[],"sources":["../../src/sqlite/engine.ts"],"sourcesContent":["/**\n * A SQLite host - what `SQLiteConnection` runs statements on.\n *\n * Pass one in place of a filename for a SQLite the built-in loader cannot open.\n * It is used as given - foreign keys are not switched on, and the connection's `close()` leaves it open.\n */\nexport interface Engine extends Engine.Statements {\n /** Release the database. Called only on an engine the connection opened. */\n close(): Promise<void>;\n /**\n * Open a transaction on its own session.\n *\n * Without it the connection issues `BEGIN`, `COMMIT` and `ROLLBACK` through `exec`.\n */\n transaction?(): Promise<Engine.Session>;\n /**\n * Run statements atomically.\n *\n * `sync` applies through it when present; a table rebuild then needs foreign keys off.\n */\n batch?(sql: string[]): Promise<void>;\n}\n\nexport declare namespace Engine {\n /** Statement methods an engine and a session share. Parameters are positional. */\n interface Statements {\n /** Run a statement, resolving every row. */\n all(sql: string, params?: any[]): Promise<any[]>;\n /** Run a statement, resolving the first row. */\n get(sql: string, params?: any[]): Promise<any>;\n /** Run a statement, resolving how many rows changed. */\n run(sql: string, params?: any[]): Promise<{ changes: number }>;\n /** Run one or more statements without parameters. */\n exec(sql: string): Promise<void>;\n }\n\n /** A transaction's own handle - statements inside `db.transaction(fn)` run on it. */\n interface Session extends Statements {\n commit(): Promise<void>;\n rollback(): Promise<void>;\n }\n}\n\nconst DRIVERS = [bunSqlite, nodeSqlite, betterSqlite3, sqlite3, libsql];\n\nconst REMOTE = /^(libsql|https?|wss?):\\/\\//;\n\nexport async function createEngine(filename: string): Promise<Engine> {\n if (REMOTE.test(filename))\n return libsql(filename, filename);\n\n for (const load of DRIVERS) {\n const engine = await load(filename).catch(() => null);\n\n if (engine) {\n await engine.exec(\"PRAGMA foreign_keys = ON\");\n return engine;\n }\n }\n\n throw new Error(\n \"No compatible SQLite driver found. Run under Bun or Node >=24, \" +\n \"or install one of: better-sqlite3, sqlite3, @libsql/client.\"\n );\n}\n\nfunction optional(name: string): Promise<any> {\n return import(name);\n}\n\nasync function bunSqlite(file: string): Promise<Engine | null> {\n if (typeof (globalThis as any).Bun === \"undefined\")\n return null;\n\n const { Database } = await optional(\"bun:sqlite\");\n\n return syncEngine(new Database(file));\n}\n\nasync function nodeSqlite(file: string): Promise<Engine | null> {\n const { DatabaseSync } = await optional(\"node:sqlite\");\n\n return syncEngine(new DatabaseSync(file));\n}\n\nasync function betterSqlite3(file: string): Promise<Engine | null> {\n const { default: Database } = await optional(\"better-sqlite3\");\n\n return syncEngine(new Database(file));\n}\n\nasync function sqlite3(file: string): Promise<Engine | null> {\n const { default: { Database } } = await optional(\"sqlite3\");\n\n return asyncEngine(new Database(file));\n}\n\nasync function libsql(file: string, url = file === \":memory:\" ? file : `file:${file}`): Promise<Engine> {\n const { createClient } = await optional(\"@libsql/client\");\n\n return libsqlEngine(createClient({ url }));\n}\n\nfunction syncEngine(db: any): Engine {\n return {\n async all(sql, params = []) {\n return db.prepare(sql).all(...params);\n },\n async get(sql, params = []) {\n return db.prepare(sql).get(...params);\n },\n async run(sql, params = []) {\n return { changes: db.prepare(sql).run(...params).changes };\n },\n async exec(sql) {\n db.exec(sql);\n },\n async close() {\n db.close();\n }\n };\n}\n\nfunction asyncEngine(db: any): Engine {\n const call = (method: string, sql: string, params: any[]) =>\n new Promise<any>((resolve, reject) => {\n db[method](sql, params, function (this: any, err: any, rows: any) {\n if (err) reject(err);\n else resolve(method === \"run\" ? this : rows);\n });\n });\n\n const done = (resolve: () => void, reject: (err: any) => void) =>\n (err: any) => err ? reject(err) : resolve();\n\n return {\n all: (sql, params = []) => call(\"all\", sql, params),\n get: (sql, params = []) => call(\"get\", sql, params),\n run: (sql, params = []) => call(\"run\", sql, params).then(ctx => ({ changes: ctx.changes })),\n exec: sql => new Promise((resolve, reject) => db.exec(sql, done(resolve, reject))),\n close: () => new Promise((resolve, reject) => db.close(done(resolve, reject)))\n };\n}\n\nexport function host(source: Engine | D1Database | LibSQLClient): Engine {\n const has = (key: string) => source && typeof source == \"object\" && key in source;\n\n if (has(\"all\"))\n return source as Engine;\n\n if (has(\"execute\"))\n return libsqlEngine(source as LibSQLClient);\n\n if (has(\"prepare\") && has(\"batch\"))\n return d1Engine(source as D1Database);\n\n throw new TypeError(\"Unknown SQLite source. Pass a filename, a libSQL address, a D1 binding, a libSQL client or an Engine.\");\n}\n\nexport const migrations = new WeakMap<Engine, (sql: string[]) => Promise<unknown>>();\n\n/** A libSQL client from `@libsql/client` 0.18 or later - local, Turso or any libSQL server. */\nexport interface LibSQLClient extends LibSQLStatements {\n batch(sql: string[], mode: \"write\"): Promise<unknown>;\n migrate(sql: string[]): Promise<unknown>;\n transaction(mode: \"write\"): Promise<LibSQLStatements & { commit(): Promise<void>; rollback(): Promise<void> }>;\n close(): void;\n}\n\ninterface LibSQLStatements {\n execute(statement: { sql: string, args: any[] }): Promise<{ rows: any[], rowsAffected: number }>;\n executeMultiple(sql: string): Promise<void>;\n}\n\nfunction libsqlEngine(client: LibSQLClient): Engine {\n const engine: Engine = {\n ...libsqlStatements(client),\n async batch(sql) {\n await client.batch(sql, \"write\");\n },\n async transaction() {\n const tx = await client.transaction(\"write\");\n\n return {\n ...libsqlStatements(tx),\n commit: () => tx.commit(),\n rollback: () => tx.rollback()\n };\n },\n async close() {\n client.close();\n }\n };\n\n migrations.set(engine, sql => client.migrate(sql));\n\n return engine;\n}\n\nfunction libsqlStatements(client: LibSQLStatements): Engine.Statements {\n const execute = (sql: string, args: any[]) => client.execute({ sql, args });\n\n return {\n async all(sql, params = []) {\n return (await execute(sql, params)).rows;\n },\n async get(sql, params = []) {\n return (await execute(sql, params)).rows[0];\n },\n async run(sql, params = []) {\n return { changes: Number((await execute(sql, params)).rowsAffected) };\n },\n async exec(sql) {\n await client.executeMultiple(sql);\n }\n };\n}\n\n/** A Cloudflare D1 binding, such as a Worker's `env.DB`. */\nexport interface D1Database {\n prepare(sql: string): D1Statement;\n batch(statements: D1Statement[]): Promise<unknown>;\n}\n\ninterface D1Statement {\n bind(...values: any[]): D1Statement;\n all(): Promise<{ results: any[] }>;\n first(): Promise<any>;\n run(): Promise<{ meta: { changes: number } }>;\n}\n\nfunction d1Engine(db: D1Database): Engine {\n const statement = (sql: string, params: any[] = []) => db.prepare(sql).bind(...params);\n\n return {\n async all(sql, params) {\n return (await statement(sql, params).all()).results;\n },\n async get(sql, params) {\n return await statement(sql, params).first() ?? undefined;\n },\n async run(sql, params) {\n return { changes: (await statement(sql, params).run()).meta.changes };\n },\n async exec(sql) {\n await db.prepare(sql).run();\n },\n async batch(sql) {\n await db.batch(sql.map(sql => db.prepare(sql)));\n },\n async transaction(): Promise<never> {\n throw new Error(\"D1 has no interactive transactions.\");\n },\n async close() {}\n };\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@expressive/sql",
3
- "version": "0.6.0",
3
+ "version": "0.7.0",
4
4
  "description": "Expressive ORM on SQL: entities, Query and an embedded SQLite store from one import.",
5
5
  "keywords": [
6
6
  "orm",
@@ -61,11 +61,13 @@
61
61
  },
62
62
  "devDependencies": {
63
63
  "@expressive/mvc": "^0.94.2",
64
+ "@libsql/client": "^0.18.0",
65
+ "miniflare": "^4.20260730.0",
64
66
  "tsdown": "^0.20.1"
65
67
  },
66
68
  "peerDependencies": {
67
69
  "@expressive/mvc": "^0.94.0",
68
- "@libsql/client": ">=0.5.0",
70
+ "@libsql/client": ">=0.18.0",
69
71
  "better-sqlite3": ">=11.0.0",
70
72
  "sqlite3": ">=5.0.0"
71
73
  },
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: expressive-sql
3
- description: Expressive ORM on SQL (@expressive/sql) - SQLiteConnection with a built-in or custom Engine, sync and plan, the expressive sql CLI, the sql.* datatype vocabulary and validation, and the SQL Connection and Generator base for dialects. Use when connecting entities to SQLite, choosing column datatypes, syncing or checking a schema, plugging in a SQLite host, or writing a SQL driver.
3
+ description: Expressive ORM on SQL (@expressive/sql) - SQLiteConnection with a built-in or custom Engine, sync and plan, the expressive sql CLI, the sql.* datatype vocabulary and validation, and the SQL Connection and Generator base for dialects. Use when connecting entities to SQLite, Cloudflare D1 or libSQL and Turso, choosing column datatypes, syncing or checking a schema, plugging in a SQLite host, or writing a SQL driver.
4
4
  ---
5
5
 
6
6
  # @expressive/sql
@@ -11,7 +11,7 @@ Expressive ORM on SQL, with embedded SQLite. Re-exports `@expressive/orm` - enti
11
11
  npm install @expressive/sql @expressive/mvc
12
12
  ```
13
13
 
14
- SQLite is built into Bun (`bun:sqlite`) and Node 24 (`node:sqlite`). Elsewhere add one of `better-sqlite3`, `sqlite3` or `@libsql/client`; the first found is used. For Postgres and live rows install `@expressive/postgres` (skill `expressive-postgres`), which re-exports this package.
14
+ SQLite is built into Bun (`bun:sqlite`) and Node 24 (`node:sqlite`). Elsewhere add one of `better-sqlite3`, `sqlite3` or `@libsql/client` (0.18 or later); the first found is used. For Postgres and live rows install `@expressive/postgres` (skill `expressive-postgres`), which re-exports this package.
15
15
 
16
16
  ## Connect
17
17
 
@@ -56,6 +56,38 @@ Two optional members, for hosts without `BEGIN` and `COMMIT` on one connection:
56
56
  - `transaction()` - resolves a session, the four statements plus `commit()` and `rollback()`. Every statement inside `db.transaction(fn)` runs on it.
57
57
  - `batch(sql: string[])` - runs statements atomically; `sync` applies through it. A table rebuild in a batch needs foreign keys off, or dropping the old table cascades; an engine that keeps them on refuses it.
58
58
 
59
+ ### Hosts
60
+
61
+ In place of the filename, `new` also takes a D1 binding, a libSQL `Client` or a libSQL address, told apart by shape. A given binding or client is used as is; `close()` leaves it open.
62
+
63
+ On Workers, open once from the first request's binding, and drop it when `sync` fails - a second `new` while entities hold a connection throws:
64
+
65
+ ```ts
66
+ let ready: Promise<unknown> | undefined;
67
+
68
+ function open(DB: D1Database){
69
+ const db = SQLiteConnection.new([User], DB);
70
+
71
+ return Promise.resolve(db).catch(async error => {
72
+ ready = undefined;
73
+ await db.close();
74
+ throw error;
75
+ });
76
+ }
77
+
78
+ export default {
79
+ async fetch(request: Request, env: { DB: D1Database }) {
80
+ await (ready ??= open(env.DB));
81
+ return Response.json(await User.find({}));
82
+ }
83
+ };
84
+ ```
85
+
86
+ - D1 - `sync` applies as one batch, a few round trips per table each cold start. `transaction` throws. Foreign keys stay on, so `sync(true, true)` refuses a rebuild.
87
+ - libSQL address - `libsql:`, `https:`, `http:`, `ws:` or `wss:` opens `@libsql/client` 0.18+; token as `?authToken=`. Loaded at runtime, so under a bundler (Workers) pass a `createClient` client instead. An `undefined` or empty source opens in memory - check an address from the environment first.
88
+ - Every libSQL client - each `transaction` is a libSQL write transaction (`BEGIN IMMEDIATE`) holding the connection's lock, so transactions run one at a time app-wide. `sync` is one batch; a rebuild runs through `client.migrate`, foreign keys off for it alone. Local libSQL enforces foreign keys by default; remote gets the server's setting.
89
+ - A `migrate` rebuild refuses dangling rows (`foreign_key_check`) even where foreign keys are off, and leaves them on.
90
+
59
91
  ## Sync
60
92
 
61
93
  Awaiting a connection runs `sync`: