@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 +2 -2
- package/dist/sqlite/SQLiteConnection.d.ts +8 -4
- package/dist/sqlite/SQLiteConnection.js +36 -21
- package/dist/sqlite/SQLiteConnection.js.map +1 -1
- package/dist/sqlite/engine.d.ts +40 -1
- package/dist/sqlite/engine.js +58 -6
- package/dist/sqlite/engine.js.map +1 -1
- package/package.json +4 -2
- package/skills/expressive-sql/SKILL.md +34 -2
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
|
|
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(
|
|
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
|
-
|
|
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.
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
300
|
-
|
|
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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"}
|
package/dist/sqlite/engine.d.ts
CHANGED
|
@@ -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
|
package/dist/sqlite/engine.js
CHANGED
|
@@ -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
|
|
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.
|
|
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.
|
|
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
|
|
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`:
|