@expressive/sql 0.9.0 → 0.10.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/dist/connection/Generator.js +18 -1
- package/dist/connection/Generator.js.map +1 -1
- package/dist/datatypes.d.ts +1 -1
- package/dist/datatypes.js +1 -1
- package/dist/datatypes.js.map +1 -1
- package/dist/sqlite/SQLiteConnection.js +1 -1
- package/dist/sqlite/SQLiteConnection.js.map +1 -1
- package/dist/sqlite/SQLiteGenerator.js +2 -2
- package/dist/sqlite/SQLiteGenerator.js.map +1 -1
- package/package.json +2 -2
- package/skills/expressive-sql/SKILL.md +23 -25
|
@@ -3,6 +3,18 @@ import { Field, now } from "@expressive/orm";
|
|
|
3
3
|
import { Computed, DataField, DataTable, Parameter, QueryTemplate } from "@expressive/orm/driver";
|
|
4
4
|
|
|
5
5
|
//#region src/connection/Generator.ts
|
|
6
|
+
const OPERATORS = new Set([
|
|
7
|
+
"=",
|
|
8
|
+
"<>",
|
|
9
|
+
"!=",
|
|
10
|
+
"<",
|
|
11
|
+
"<=",
|
|
12
|
+
">",
|
|
13
|
+
">=",
|
|
14
|
+
"LIKE",
|
|
15
|
+
"IN",
|
|
16
|
+
"NOT IN"
|
|
17
|
+
]);
|
|
6
18
|
function isValue(input) {
|
|
7
19
|
return input instanceof Field || input instanceof Parameter || input instanceof DataField || input instanceof QueryTemplate || input instanceof Computed;
|
|
8
20
|
}
|
|
@@ -197,6 +209,7 @@ var Generator = class {
|
|
|
197
209
|
}
|
|
198
210
|
/** One condition. `null` renders `IS` / `IS NOT`; an empty list a constant. */
|
|
199
211
|
filter(left, op, right) {
|
|
212
|
+
if (!OPERATORS.has(op)) throw new Error(`Unsupported operator: ${op}`);
|
|
200
213
|
const raw = (value) => value === now ? this.now(left) : isValue(value) ? this.reference(value) : this.literal(op.includes("LIKE") ? value : this.query.encode(left, value));
|
|
201
214
|
if (right === null) {
|
|
202
215
|
if (op == "=") op = "IS";
|
|
@@ -228,11 +241,15 @@ var Generator = class {
|
|
|
228
241
|
/** `ORDER BY` clause. */
|
|
229
242
|
order() {
|
|
230
243
|
const { order } = this.query;
|
|
231
|
-
if (order.size) return "ORDER BY " + Array.from(order, ([x, y]) =>
|
|
244
|
+
if (order.size) return "ORDER BY " + Array.from(order, ([x, y]) => {
|
|
245
|
+
if (y !== "asc" && y !== "desc") throw new Error(`Unsupported order: ${y}`);
|
|
246
|
+
return `${this.reference(x)} ${y}`;
|
|
247
|
+
});
|
|
232
248
|
}
|
|
233
249
|
/** `LIMIT` and `OFFSET` clauses. */
|
|
234
250
|
limit() {
|
|
235
251
|
const { limit, offset } = this.query;
|
|
252
|
+
for (const value of [limit, offset]) if (value != null && !(Number.isSafeInteger(value) && value >= 0)) throw new Error(`Limit and offset must be whole numbers, not ${value}.`);
|
|
236
253
|
return [limit && `LIMIT ${limit}`, offset && `OFFSET ${offset}`];
|
|
237
254
|
}
|
|
238
255
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Generator.js","names":[],"sources":["../../src/connection/Generator.ts"],"sourcesContent":["import { Field, now } from '@expressive/orm';\nimport { Builder, Computed, DataField, DataTable, Parameter, QueryTemplate } from '@expressive/orm/driver';\n\nimport { escape } from '../utils';\n\ntype Expression = Builder[\"filters\"];\n\nfunction isValue(input: unknown){\n return (\n input instanceof Field ||\n input instanceof Parameter ||\n input instanceof DataField ||\n input instanceof QueryTemplate ||\n input instanceof Computed\n );\n}\n\n/**\n * Renders a `Query` builder as one SQL statement - `String(generator)`.\n *\n * A dialect subclasses it and overrides the protected hooks. Literals render inline, escaped; parameters bind.\n */\nexport class Generator {\n constructor(public query: Builder){}\n\n toString() {\n const parts = [\n this.insert() || [\n this.with(),\n this.update() ||\n this.delete() ||\n this.select()\n ],\n this.where(),\n this.order(),\n this.limit(),\n this.upsert(),\n this.returning()\n ];\n\n return parts.flat(Infinity).filter(Boolean).join(' ');\n }\n\n /** Quote an identifier, each dotted part on its own. */\n escape(name: unknown){\n return String(name).split('.').map(x => `\\`${x}\\``).join('.');\n }\n\n /** `INSERT INTO`, or `false` when the query inserts nothing. */\n protected insert() {\n const { inserts, tables } = this.query;\n\n if (!inserts.size)\n return false;\n\n const [[table, data]] = inserts;\n\n const keys: string[] = [];\n const values: string[] = [];\n\n for (const [field, value] of data) {\n keys.push(this.escape(field.column));\n values.push(this.value(value, field));\n }\n\n if (!keys.length && tables.size > 1)\n throw new Error(`Insert into ${table.name} for each joined row needs at least one value.`);\n\n const into = ['INSERT INTO', this.escape(table.name)];\n\n if (!keys.length)\n return [this.with(), into, 'DEFAULT VALUES'];\n\n return this.insertWith(this.with(), [into, `(${keys})`], [\n `SELECT ${values}`,\n tables.size > 1 && this.from()\n ]);\n }\n\n /** Order an insert's data CTE, target and select - for a dialect placing `WITH` elsewhere. */\n protected insertWith(cte: string | undefined, into: unknown[], select: unknown[]): unknown[] {\n return [cte, into, select];\n }\n\n /** `ON CONFLICT` clause of an upsert. */\n protected upsert(){\n const { conflict } = this.query;\n\n if (!conflict)\n return;\n\n const on = `ON CONFLICT (${conflict.on.map(field => this.escape(field.column))})`;\n\n if (!conflict.update)\n return [on, 'DO NOTHING'];\n\n const set = conflict.update.map(({ column }) => `${this.escape(column)} = excluded.${this.escape(column)}`);\n\n for (const [field, value] of conflict.set)\n set.push(`${this.escape(field.column)} = ${this.value(value)}`);\n\n if (!set.length)\n set.push(...conflict.on.map(({ column }) => `${this.escape(column)} = excluded.${this.escape(column)}`));\n\n return [on, 'DO UPDATE SET', set.join(', ')];\n }\n\n /** `RETURNING` clause of an insert that selects. */\n protected returning(){\n const { inserts, returns } = this.query;\n\n if (!inserts.size || !returns)\n return;\n\n return 'RETURNING ' + (\n returns instanceof Map\n ? Array.from(returns, ([alias, field]) => `${this.value(field)} AS \"${alias}\"`).join(', ')\n : this.reference(returns)\n );\n }\n\n /** `WITH` clause over the query's data tables. */\n protected with(){\n const cte = [] as string[];\n\n this.query.tables.forEach((table) => {\n if (table instanceof DataTable)\n cte.push(`${this.escape(table.name)} AS (${this.jsonTable(table)})`);\n });\n\n if(cte.length)\n return 'WITH ' + cte.join();\n }\n\n /** A value - `now`, a reference, or a literal. */\n protected value(input: unknown, field?: Field){\n if(input === now)\n return this.now(field);\n\n if(isValue(input))\n return this.reference(input);\n\n return this.literal(input);\n }\n\n /** A literal - every literal in values, `SET` and `WHERE` passes through it. */\n protected literal(value: unknown){\n return String(escape(value));\n }\n\n /** A table with its alias - for `FROM`, joins, `UPDATE` and `DELETE`. */\n protected table({ name, alias }: Builder.ITable){\n return this.escape(name) + (alias ? ` ${this.escape(alias)}` : \"\");\n }\n\n /** The current time - `CURRENT_TIMESTAMP`; a dialect renders it per `field`'s storage. */\n protected now(_field?: Field){\n return \"CURRENT_TIMESTAMP\";\n }\n\n /** Select a data table's rows out of its bound parameter. The base throws - a dialect implements it. */\n protected jsonTable(_table: DataTable): string {\n throw new Error(\"Not implemented.\");\n }\n\n /** An arithmetic expression, parenthesized by operator rank. */\n protected computed(from: Computed<unknown>): string {\n const { left, operator, right, rank } = from;\n const side = (input: unknown, tight: boolean) => {\n if(!(input instanceof Computed))\n return this.value(input);\n\n const value = this.computed(input);\n\n return (tight ? input.rank <= rank : input.rank < rank) ? `(${value})` : value;\n }\n\n if(left === undefined)\n return operator + side(right, true);\n\n return `${side(left, false)} ${operator} ${side(right, true)}`;\n }\n\n /** `JOIN` clauses for every table but `main`. Throws for a table without a join condition. */\n protected joins(main: Builder.ITable){\n const output: string[] = [];\n\n for(const table of this.query.tables.values()){\n if(table === main)\n continue;\n\n const { name, optional } = table;\n\n if(table.joins.length === 0)\n throw new Error(`Table ${name} has no joins.`);\n\n const mode = optional ? \"LEFT\" : \"INNER\";\n const conds = table.joins.map(x => this.filter(x.left, x.op, x.right));\n\n output.push(`${mode} JOIN ${this.table(table)} ON ${conds.join(' AND ')}`);\n }\n\n if(output.length)\n return output.join(' ');\n }\n\n /** `SET` clause of an update. Throws without values. */\n protected set(updates: Map<Builder.ITable, Builder.Insert>){\n const sets: string[] = [];\n\n for(const [_table, data] of updates)\n for(const [field, value] of data)\n sets.push(`${this.escape(field.column)} = ${\n value === now ? this.now(field) :\n isValue(value) ? this.reference(value) :\n value === null ? 'NULL' :\n this.literal(value)\n }`);\n\n if(!sets.length)\n throw new Error('Update contains no values.');\n\n return `SET ${sets}`;\n }\n\n /** `UPDATE` head. Throws when the query updates more than one table. */\n protected update(){\n const { updates } = this.query;\n\n if(!updates.size)\n return;\n\n if(updates.size > 1)\n throw new Error('Engine does not support multi-table updates.');\n\n const [ main ] = updates.keys();\n\n return [\n 'UPDATE',\n this.table(main),\n this.joins(main),\n this.set(updates)\n ]\n }\n\n /** `DELETE FROM` head. */\n protected delete(){\n const { query } = this;\n const [ main ] = query.deletes;\n\n if(!main)\n return;\n\n const { alias, name } = main;\n const target = query.tables.size > 1 && (alias || name);\n\n return ['DELETE', target, 'FROM', this.table(main), this.joins(main)]\n }\n\n /** A column, parameter, data column, raw template or expression. */\n protected reference(from: unknown): string {\n if(from instanceof DataField)\n return this.escape(from.table.name + '.' + from.column);\n\n if(from instanceof QueryTemplate)\n return from.from;\n\n if(from instanceof Computed)\n return this.computed(from);\n\n if(from instanceof Parameter)\n return this.param(from);\n\n const { table, column } = from as Field;\n\n return this.escape(table!.alias || table!.name) + \".\" + this.escape(column);\n }\n\n /** `SELECT` head with joins - `COUNT(*)` when the query selects nothing. */\n protected select(){\n const { returns, tables } = this.query;\n const [ main ] = tables.values();\n\n const selection =\n returns instanceof Map ?\n Array.from(returns, ([alias, field]) => this.value(field) + ` AS \"${alias}\"`).join(', ') :\n returns ?\n this.reference(returns) :\n 'COUNT(*)';\n\n return [\n \"SELECT\",\n selection,\n this.from(),\n main && this.joins(main)\n ]\n }\n\n /** `FROM` clause of the main table. */\n protected from(){\n const [ main ] = this.query.tables.values();\n\n if(main)\n return [\"FROM\", this.table(main)]\n }\n\n /** A parameter placeholder. */\n protected param(_from: Parameter){\n return \"?\";\n }\n\n /** One condition. `null` renders `IS` / `IS NOT`; an empty list a constant. */\n protected filter(left: Field, op: string, right: unknown){\n const raw = (value: unknown) => (\n value === now ? this.now(left) :\n isValue(value) ? this.reference(value) :\n this.literal(op.includes(\"LIKE\") ? value : this.query.encode(left, value))\n );\n\n if (right === null){\n if(op == '=')\n op = 'IS';\n else if(op == '<>' || op == '!=')\n op = 'IS NOT';\n else\n throw new Error('Cannot compare NULL with ' + op);\n\n right = 'NULL';\n }\n else if(right instanceof Array){\n if(!right.length)\n return op == 'NOT IN' ? '1 = 1' : '1 = 0';\n\n right = `(${right.map(raw)})`;\n }\n else\n right = raw(right);\n\n return `${this.reference(left)} ${op} ${right}`;\n }\n\n /** `WHERE` clause - top level joined with AND, alternating with OR by depth. */\n protected where() {\n const { filters } = this.query;\n\n if (!filters.size) return;\n\n const combine = (group: Expression, or?: boolean): string => {\n return Array\n .from(group.children, (cond, i) => {\n if (\"children\" in cond) {\n const inner = combine(cond, !or);\n const first = or !== false && i === 0;\n return cond.size === 1 || first ? inner : `(${inner})`;\n }\n\n return this.filter(cond.left, cond.op, cond.right);\n })\n .join(or ? ' OR ' : ' AND ');\n };\n\n return ['WHERE', combine(filters)];\n }\n\n /** `ORDER BY` clause. */\n protected order(){\n const { order } = this.query;\n\n if(order.size)\n return 'ORDER BY ' +\n Array.from(order, ([x, y]) => `${this.reference(x)} ${y}`);\n }\n\n /** `LIMIT` and `OFFSET` clauses. */\n protected limit(){\n const { limit, offset } = this.query;\n\n return [\n limit && `LIMIT ${limit}`,\n offset && `OFFSET ${offset}`\n ];\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"Generator.js","names":[],"sources":["../../src/connection/Generator.ts"],"sourcesContent":["import { Field, now } from '@expressive/orm';\nimport { Builder, Computed, DataField, DataTable, Parameter, QueryTemplate } from '@expressive/orm/driver';\n\nimport { escape } from '../utils';\n\ntype Expression = Builder[\"filters\"];\n\nconst OPERATORS = new Set(['=', '<>', '!=', '<', '<=', '>', '>=', 'LIKE', 'IN', 'NOT IN']);\n\nfunction isValue(input: unknown){\n return (\n input instanceof Field ||\n input instanceof Parameter ||\n input instanceof DataField ||\n input instanceof QueryTemplate ||\n input instanceof Computed\n );\n}\n\n/**\n * Renders a `Query` builder as one SQL statement - `String(generator)`.\n *\n * A dialect subclasses it and overrides the protected hooks. Literals render inline, escaped; parameters bind.\n */\nexport class Generator {\n constructor(public query: Builder){}\n\n toString() {\n const parts = [\n this.insert() || [\n this.with(),\n this.update() ||\n this.delete() ||\n this.select()\n ],\n this.where(),\n this.order(),\n this.limit(),\n this.upsert(),\n this.returning()\n ];\n\n return parts.flat(Infinity).filter(Boolean).join(' ');\n }\n\n /** Quote an identifier, each dotted part on its own. */\n escape(name: unknown){\n return String(name).split('.').map(x => `\\`${x}\\``).join('.');\n }\n\n /** `INSERT INTO`, or `false` when the query inserts nothing. */\n protected insert() {\n const { inserts, tables } = this.query;\n\n if (!inserts.size)\n return false;\n\n const [[table, data]] = inserts;\n\n const keys: string[] = [];\n const values: string[] = [];\n\n for (const [field, value] of data) {\n keys.push(this.escape(field.column));\n values.push(this.value(value, field));\n }\n\n if (!keys.length && tables.size > 1)\n throw new Error(`Insert into ${table.name} for each joined row needs at least one value.`);\n\n const into = ['INSERT INTO', this.escape(table.name)];\n\n if (!keys.length)\n return [this.with(), into, 'DEFAULT VALUES'];\n\n return this.insertWith(this.with(), [into, `(${keys})`], [\n `SELECT ${values}`,\n tables.size > 1 && this.from()\n ]);\n }\n\n /** Order an insert's data CTE, target and select - for a dialect placing `WITH` elsewhere. */\n protected insertWith(cte: string | undefined, into: unknown[], select: unknown[]): unknown[] {\n return [cte, into, select];\n }\n\n /** `ON CONFLICT` clause of an upsert. */\n protected upsert(){\n const { conflict } = this.query;\n\n if (!conflict)\n return;\n\n const on = `ON CONFLICT (${conflict.on.map(field => this.escape(field.column))})`;\n\n if (!conflict.update)\n return [on, 'DO NOTHING'];\n\n const set = conflict.update.map(({ column }) => `${this.escape(column)} = excluded.${this.escape(column)}`);\n\n for (const [field, value] of conflict.set)\n set.push(`${this.escape(field.column)} = ${this.value(value)}`);\n\n if (!set.length)\n set.push(...conflict.on.map(({ column }) => `${this.escape(column)} = excluded.${this.escape(column)}`));\n\n return [on, 'DO UPDATE SET', set.join(', ')];\n }\n\n /** `RETURNING` clause of an insert that selects. */\n protected returning(){\n const { inserts, returns } = this.query;\n\n if (!inserts.size || !returns)\n return;\n\n return 'RETURNING ' + (\n returns instanceof Map\n ? Array.from(returns, ([alias, field]) => `${this.value(field)} AS \"${alias}\"`).join(', ')\n : this.reference(returns)\n );\n }\n\n /** `WITH` clause over the query's data tables. */\n protected with(){\n const cte = [] as string[];\n\n this.query.tables.forEach((table) => {\n if (table instanceof DataTable)\n cte.push(`${this.escape(table.name)} AS (${this.jsonTable(table)})`);\n });\n\n if(cte.length)\n return 'WITH ' + cte.join();\n }\n\n /** A value - `now`, a reference, or a literal. */\n protected value(input: unknown, field?: Field){\n if(input === now)\n return this.now(field);\n\n if(isValue(input))\n return this.reference(input);\n\n return this.literal(input);\n }\n\n /** A literal - every literal in values, `SET` and `WHERE` passes through it. */\n protected literal(value: unknown){\n return String(escape(value));\n }\n\n /** A table with its alias - for `FROM`, joins, `UPDATE` and `DELETE`. */\n protected table({ name, alias }: Builder.ITable){\n return this.escape(name) + (alias ? ` ${this.escape(alias)}` : \"\");\n }\n\n /** The current time - `CURRENT_TIMESTAMP`; a dialect renders it per `field`'s storage. */\n protected now(_field?: Field){\n return \"CURRENT_TIMESTAMP\";\n }\n\n /** Select a data table's rows out of its bound parameter. The base throws - a dialect implements it. */\n protected jsonTable(_table: DataTable): string {\n throw new Error(\"Not implemented.\");\n }\n\n /** An arithmetic expression, parenthesized by operator rank. */\n protected computed(from: Computed<unknown>): string {\n const { left, operator, right, rank } = from;\n const side = (input: unknown, tight: boolean) => {\n if(!(input instanceof Computed))\n return this.value(input);\n\n const value = this.computed(input);\n\n return (tight ? input.rank <= rank : input.rank < rank) ? `(${value})` : value;\n }\n\n if(left === undefined)\n return operator + side(right, true);\n\n return `${side(left, false)} ${operator} ${side(right, true)}`;\n }\n\n /** `JOIN` clauses for every table but `main`. Throws for a table without a join condition. */\n protected joins(main: Builder.ITable){\n const output: string[] = [];\n\n for(const table of this.query.tables.values()){\n if(table === main)\n continue;\n\n const { name, optional } = table;\n\n if(table.joins.length === 0)\n throw new Error(`Table ${name} has no joins.`);\n\n const mode = optional ? \"LEFT\" : \"INNER\";\n const conds = table.joins.map(x => this.filter(x.left, x.op, x.right));\n\n output.push(`${mode} JOIN ${this.table(table)} ON ${conds.join(' AND ')}`);\n }\n\n if(output.length)\n return output.join(' ');\n }\n\n /** `SET` clause of an update. Throws without values. */\n protected set(updates: Map<Builder.ITable, Builder.Insert>){\n const sets: string[] = [];\n\n for(const [_table, data] of updates)\n for(const [field, value] of data)\n sets.push(`${this.escape(field.column)} = ${\n value === now ? this.now(field) :\n isValue(value) ? this.reference(value) :\n value === null ? 'NULL' :\n this.literal(value)\n }`);\n\n if(!sets.length)\n throw new Error('Update contains no values.');\n\n return `SET ${sets}`;\n }\n\n /** `UPDATE` head. Throws when the query updates more than one table. */\n protected update(){\n const { updates } = this.query;\n\n if(!updates.size)\n return;\n\n if(updates.size > 1)\n throw new Error('Engine does not support multi-table updates.');\n\n const [ main ] = updates.keys();\n\n return [\n 'UPDATE',\n this.table(main),\n this.joins(main),\n this.set(updates)\n ]\n }\n\n /** `DELETE FROM` head. */\n protected delete(){\n const { query } = this;\n const [ main ] = query.deletes;\n\n if(!main)\n return;\n\n const { alias, name } = main;\n const target = query.tables.size > 1 && (alias || name);\n\n return ['DELETE', target, 'FROM', this.table(main), this.joins(main)]\n }\n\n /** A column, parameter, data column, raw template or expression. */\n protected reference(from: unknown): string {\n if(from instanceof DataField)\n return this.escape(from.table.name + '.' + from.column);\n\n if(from instanceof QueryTemplate)\n return from.from;\n\n if(from instanceof Computed)\n return this.computed(from);\n\n if(from instanceof Parameter)\n return this.param(from);\n\n const { table, column } = from as Field;\n\n return this.escape(table!.alias || table!.name) + \".\" + this.escape(column);\n }\n\n /** `SELECT` head with joins - `COUNT(*)` when the query selects nothing. */\n protected select(){\n const { returns, tables } = this.query;\n const [ main ] = tables.values();\n\n const selection =\n returns instanceof Map ?\n Array.from(returns, ([alias, field]) => this.value(field) + ` AS \"${alias}\"`).join(', ') :\n returns ?\n this.reference(returns) :\n 'COUNT(*)';\n\n return [\n \"SELECT\",\n selection,\n this.from(),\n main && this.joins(main)\n ]\n }\n\n /** `FROM` clause of the main table. */\n protected from(){\n const [ main ] = this.query.tables.values();\n\n if(main)\n return [\"FROM\", this.table(main)]\n }\n\n /** A parameter placeholder. */\n protected param(_from: Parameter){\n return \"?\";\n }\n\n /** One condition. `null` renders `IS` / `IS NOT`; an empty list a constant. */\n protected filter(left: Field, op: string, right: unknown){\n if (!OPERATORS.has(op))\n throw new Error(`Unsupported operator: ${op}`);\n\n const raw = (value: unknown) => (\n value === now ? this.now(left) :\n isValue(value) ? this.reference(value) :\n this.literal(op.includes(\"LIKE\") ? value : this.query.encode(left, value))\n );\n\n if (right === null){\n if(op == '=')\n op = 'IS';\n else if(op == '<>' || op == '!=')\n op = 'IS NOT';\n else\n throw new Error('Cannot compare NULL with ' + op);\n\n right = 'NULL';\n }\n else if(right instanceof Array){\n if(!right.length)\n return op == 'NOT IN' ? '1 = 1' : '1 = 0';\n\n right = `(${right.map(raw)})`;\n }\n else\n right = raw(right);\n\n return `${this.reference(left)} ${op} ${right}`;\n }\n\n /** `WHERE` clause - top level joined with AND, alternating with OR by depth. */\n protected where() {\n const { filters } = this.query;\n\n if (!filters.size) return;\n\n const combine = (group: Expression, or?: boolean): string => {\n return Array\n .from(group.children, (cond, i) => {\n if (\"children\" in cond) {\n const inner = combine(cond, !or);\n const first = or !== false && i === 0;\n return cond.size === 1 || first ? inner : `(${inner})`;\n }\n\n return this.filter(cond.left, cond.op, cond.right);\n })\n .join(or ? ' OR ' : ' AND ');\n };\n\n return ['WHERE', combine(filters)];\n }\n\n /** `ORDER BY` clause. */\n protected order(){\n const { order } = this.query;\n\n if(order.size)\n return 'ORDER BY ' +\n Array.from(order, ([x, y]) => {\n if (y !== \"asc\" && y !== \"desc\")\n throw new Error(`Unsupported order: ${y}`);\n\n return `${this.reference(x)} ${y}`;\n });\n }\n\n /** `LIMIT` and `OFFSET` clauses. */\n protected limit(){\n const { limit, offset } = this.query;\n\n for (const value of [limit, offset])\n if (value != null && !(Number.isSafeInteger(value) && value >= 0))\n throw new Error(`Limit and offset must be whole numbers, not ${value}.`);\n\n return [\n limit && `LIMIT ${limit}`,\n offset && `OFFSET ${offset}`\n ];\n }\n}\n"],"mappings":"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"}
|
package/dist/datatypes.d.ts
CHANGED
|
@@ -72,7 +72,7 @@ interface Datatypes {
|
|
|
72
72
|
};
|
|
73
73
|
}
|
|
74
74
|
/**
|
|
75
|
-
* Column datatypes, passed to a field helper - `str(sql.varchar(255))`, `date(sql.
|
|
75
|
+
* Column datatypes, passed to a field helper - `str(sql.varchar(255))`, `date(sql.date)`.
|
|
76
76
|
*
|
|
77
77
|
* Each fits only the helpers named on it; elsewhere it is a type error.
|
|
78
78
|
*/
|
package/dist/datatypes.js
CHANGED
|
@@ -2,7 +2,7 @@ import { now } from "@expressive/orm";
|
|
|
2
2
|
|
|
3
3
|
//#region src/datatypes.ts
|
|
4
4
|
/**
|
|
5
|
-
* Column datatypes, passed to a field helper - `str(sql.varchar(255))`, `date(sql.
|
|
5
|
+
* Column datatypes, passed to a field helper - `str(sql.varchar(255))`, `date(sql.date)`.
|
|
6
6
|
*
|
|
7
7
|
* Each fits only the helpers named on it; elsewhere it is a type error.
|
|
8
8
|
*/
|
package/dist/datatypes.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"datatypes.js","names":[],"sources":["../src/datatypes.ts"],"sourcesContent":["import { now } from '@expressive/orm';\n\ninterface Datatypes {\n /** The current time - rendered by the database in the column's storage; statics take the app's clock. */\n readonly now: typeof now;\n /** `str` (default) - unbounded text. */\n readonly text: { readonly type: \"text\" };\n /** `str` - a UUID. As `key(sql.uuid)`, a UUIDv7 is generated on insert when absent. */\n readonly uuid: { readonly type: \"uuid\" };\n /** `num` (default) - 32-bit integer; a fraction or a value out of range throws on write. */\n readonly integer: { readonly type: \"integer\" };\n /** `num` - 16-bit integer; a fraction or a value out of range throws on write. */\n readonly smallint: { readonly type: \"smallint\" };\n /** `num` - 64-bit integer; a fraction throws on write. */\n readonly bigint: { readonly type: \"bigint\" };\n /** `num` - floating point. */\n readonly real: { readonly type: \"real\" };\n /** `num` - floating point, `double precision` in schema. */\n readonly double: { readonly type: \"double\" };\n /** `date` (default) - date and time. */\n readonly timestamp: { readonly type: \"timestamp\" };\n /** `date` - a calendar day, stored `YYYY-MM-DD` from the local day and read as local midnight. */\n readonly date: { readonly type: \"date\" };\n /** `date` - time of day, `HH:MM:SS` UTC, read on 1970-01-01. */\n readonly time: { readonly type: \"time\" };\n /** `str` - text up to `length` characters; longer throws on write. */\n readonly varchar: <N extends number>(length: N) => { readonly type: \"varchar\"; readonly length: N };\n /** `str` - fixed-length text; longer than `length` throws on write. */\n readonly char: <N extends number>(length: N) => { readonly type: \"char\"; readonly length: N };\n /**\n * `num` - exact decimal of `precision` digits, `scale` (default 0) after the point.\n *\n * A value past either throws on write.\n */\n readonly numeric: (precision: number, scale?: number) => { readonly type: \"numeric\"; readonly precision: number; readonly scale: number };\n /** `num` - exact decimal, as `numeric`. */\n readonly decimal: (precision: number, scale?: number) => { readonly type: \"decimal\"; readonly precision: number; readonly scale: number };\n}\n\n/**\n * Column datatypes, passed to a field helper - `str(sql.varchar(255))`, `date(sql.
|
|
1
|
+
{"version":3,"file":"datatypes.js","names":[],"sources":["../src/datatypes.ts"],"sourcesContent":["import { now } from '@expressive/orm';\n\ninterface Datatypes {\n /** The current time - rendered by the database in the column's storage; statics take the app's clock. */\n readonly now: typeof now;\n /** `str` (default) - unbounded text. */\n readonly text: { readonly type: \"text\" };\n /** `str` - a UUID. As `key(sql.uuid)`, a UUIDv7 is generated on insert when absent. */\n readonly uuid: { readonly type: \"uuid\" };\n /** `num` (default) - 32-bit integer; a fraction or a value out of range throws on write. */\n readonly integer: { readonly type: \"integer\" };\n /** `num` - 16-bit integer; a fraction or a value out of range throws on write. */\n readonly smallint: { readonly type: \"smallint\" };\n /** `num` - 64-bit integer; a fraction throws on write. */\n readonly bigint: { readonly type: \"bigint\" };\n /** `num` - floating point. */\n readonly real: { readonly type: \"real\" };\n /** `num` - floating point, `double precision` in schema. */\n readonly double: { readonly type: \"double\" };\n /** `date` (default) - date and time. */\n readonly timestamp: { readonly type: \"timestamp\" };\n /** `date` - a calendar day, stored `YYYY-MM-DD` from the local day and read as local midnight. */\n readonly date: { readonly type: \"date\" };\n /** `date` - time of day, `HH:MM:SS` UTC, read on 1970-01-01. */\n readonly time: { readonly type: \"time\" };\n /** `str` - text up to `length` characters; longer throws on write. */\n readonly varchar: <N extends number>(length: N) => { readonly type: \"varchar\"; readonly length: N };\n /** `str` - fixed-length text; longer than `length` throws on write. */\n readonly char: <N extends number>(length: N) => { readonly type: \"char\"; readonly length: N };\n /**\n * `num` - exact decimal of `precision` digits, `scale` (default 0) after the point.\n *\n * A value past either throws on write.\n */\n readonly numeric: (precision: number, scale?: number) => { readonly type: \"numeric\"; readonly precision: number; readonly scale: number };\n /** `num` - exact decimal, as `numeric`. */\n readonly decimal: (precision: number, scale?: number) => { readonly type: \"decimal\"; readonly precision: number; readonly scale: number };\n}\n\n/**\n * Column datatypes, passed to a field helper - `str(sql.varchar(255))`, `date(sql.date)`.\n *\n * Each fits only the helpers named on it; elsewhere it is a type error.\n */\nconst sql: Datatypes = {\n now,\n text: { type: \"text\" },\n uuid: { type: \"uuid\" },\n integer: { type: \"integer\" },\n smallint: { type: \"smallint\" },\n bigint: { type: \"bigint\" },\n real: { type: \"real\" },\n double: { type: \"double\" },\n timestamp: { type: \"timestamp\" },\n date: { type: \"date\" },\n time: { type: \"time\" },\n varchar: <N extends number>(length: N) => ({ type: \"varchar\", length }) as const,\n char: <N extends number>(length: N) => ({ type: \"char\", length }) as const,\n numeric: (precision: number, scale = 0) => ({ type: \"numeric\", precision, scale }) as const,\n decimal: (precision: number, scale = 0) => ({ type: \"decimal\", precision, scale }) as const\n};\n\nexport { sql };\n"],"mappings":";;;;;;;;AA4CA,MAAM,MAAiB;CACrB;CACA,MAAM,EAAE,MAAM,QAAQ;CACtB,MAAM,EAAE,MAAM,QAAQ;CACtB,SAAS,EAAE,MAAM,WAAW;CAC5B,UAAU,EAAE,MAAM,YAAY;CAC9B,QAAQ,EAAE,MAAM,UAAU;CAC1B,MAAM,EAAE,MAAM,QAAQ;CACtB,QAAQ,EAAE,MAAM,UAAU;CAC1B,WAAW,EAAE,MAAM,aAAa;CAChC,MAAM,EAAE,MAAM,QAAQ;CACtB,MAAM,EAAE,MAAM,QAAQ;CACtB,UAA4B,YAAe;EAAE,MAAM;EAAW;EAAQ;CACtE,OAAyB,YAAe;EAAE,MAAM;EAAQ;EAAQ;CAChE,UAAU,WAAmB,QAAQ,OAAO;EAAE,MAAM;EAAW;EAAW;EAAO;CACjF,UAAU,WAAmB,QAAQ,OAAO;EAAE,MAAM;EAAW;EAAW;EAAO;CAClF"}
|
|
@@ -59,7 +59,7 @@ var SQLiteConnection = class extends Connection$1 {
|
|
|
59
59
|
try {
|
|
60
60
|
return await op(await this.#statements());
|
|
61
61
|
} catch (err) {
|
|
62
|
-
if (err instanceof Error) throw new Error(`Error running SQL: ${err.message}\n${pretty(sql)}`);
|
|
62
|
+
if (err instanceof Error) throw new Error(`Error running SQL: ${err.message}\n${sql.length > 4096 ? sql.slice(0, 4096) + "..." : pretty(sql)}`);
|
|
63
63
|
throw err;
|
|
64
64
|
}
|
|
65
65
|
};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SQLiteConnection.js","names":["Connection","#statements","current"],"sources":["../../src/sqlite/SQLiteConnection.ts"],"sourcesContent":["import { Field, now, Query, Type } from '@expressive/orm';\nimport { Builder } from '@expressive/orm/driver';\nimport { codecs } from '../codecs';\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 get codecs(){\n return affinities;\n }\n\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 boolean: \"INTEGER\",\n real: \"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 json: \"TEXT\"\n};\n\nconst affinities: ReadonlyMap<Function, Connection.Codec> = new Map(Array.from(codecs, ([helper, codec]) => [\n helper,\n { ...codec, datatype: (field: Field) => AFFINITY[field.type] }\n]));\n\nfunction connection(field: Field){\n return (field.parent as Type.Class).connection;\n}\n\nfunction affinity(field: Field){\n return connection(field)._datatype(field);\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 = connection(field)._encode(field, 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, Type } from '@expressive/orm';\nimport { Builder } from '@expressive/orm/driver';\nimport { codecs } from '../codecs';\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 get codecs(){\n return affinities;\n }\n\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${sql.length > 4096 ? sql.slice(0, 4096) + \"...\" : 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 boolean: \"INTEGER\",\n real: \"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 json: \"TEXT\"\n};\n\nconst affinities: ReadonlyMap<Function, Connection.Codec> = new Map(Array.from(codecs, ([helper, codec]) => [\n helper,\n { ...codec, datatype: (field: Field) => AFFINITY[field.type] }\n]));\n\nfunction connection(field: Field){\n return (field.parent as Type.Class).connection;\n}\n\nfunction affinity(field: Field){\n return connection(field)._datatype(field);\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 = connection(field)._encode(field, 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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"}
|
|
@@ -41,8 +41,8 @@ var SQLiteGenerator = class extends Generator {
|
|
|
41
41
|
}
|
|
42
42
|
limit() {
|
|
43
43
|
const { limit, offset } = this.query;
|
|
44
|
-
|
|
45
|
-
return
|
|
44
|
+
const clauses = super.limit();
|
|
45
|
+
return offset && !limit ? ["LIMIT -1", ...clauses] : clauses;
|
|
46
46
|
}
|
|
47
47
|
};
|
|
48
48
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SQLiteGenerator.js","names":[],"sources":["../../src/sqlite/SQLiteGenerator.ts"],"sourcesContent":["import { Field } from '@expressive/orm';\nimport { DataTable } from '@expressive/orm/driver';\nimport { Generator } from '../connection/Generator';\n\nexport function now(field?: Field){\n switch (field?.type) {\n case \"date\":\n return \"date('now')\";\n case \"time\":\n return \"time('now')\";\n default:\n return \"strftime('%Y-%m-%dT%H:%M:%fZ', 'now')\";\n }\n}\n\nexport class SQLiteGenerator extends Generator {\n protected now(field?: Field){\n return now(field);\n }\n\n protected jsonTable(table: DataTable): string {\n const param = this.param(table);\n const fields = Array.from(table.used, (field, i) => {\n return `value ->> ${i} ${this.escape(field.column)}`;\n });\n \n return `SELECT ${fields.join(', ')} FROM json_each(${param})`;\n }\n\n protected update(){\n const { updates, tables } = this.query;\n\n const [main] = updates.keys();\n\n if (!updates.size)\n return\n\n const output = [\n 'UPDATE',\n this.escape(main),\n this.set(updates)\n ]\n\n if (tables.size > 1) {\n const using = Array.from(tables.values())\n .filter(table => table !== main)\n .map(table => {\n if (table.joins.length === 0)\n throw new Error(`Table ${table.name} has no joins.`);\n\n const conditions = table.joins\n .map(x => this.filter(x.left, x.op, x.right))\n .join(' AND ')\n\n return { conditions, table };\n });\n\n output.push(\n 'FROM', using.map(x => x.table.name).join(', '),\n 'WHERE', using.map(x => x.conditions).join(' AND ')\n )\n }\n\n return output;\n }\n\n protected limit(){\n const { limit, offset } = this.query;\n\n
|
|
1
|
+
{"version":3,"file":"SQLiteGenerator.js","names":[],"sources":["../../src/sqlite/SQLiteGenerator.ts"],"sourcesContent":["import { Field } from '@expressive/orm';\nimport { DataTable } from '@expressive/orm/driver';\nimport { Generator } from '../connection/Generator';\n\nexport function now(field?: Field){\n switch (field?.type) {\n case \"date\":\n return \"date('now')\";\n case \"time\":\n return \"time('now')\";\n default:\n return \"strftime('%Y-%m-%dT%H:%M:%fZ', 'now')\";\n }\n}\n\nexport class SQLiteGenerator extends Generator {\n protected now(field?: Field){\n return now(field);\n }\n\n protected jsonTable(table: DataTable): string {\n const param = this.param(table);\n const fields = Array.from(table.used, (field, i) => {\n return `value ->> ${i} ${this.escape(field.column)}`;\n });\n \n return `SELECT ${fields.join(', ')} FROM json_each(${param})`;\n }\n\n protected update(){\n const { updates, tables } = this.query;\n\n const [main] = updates.keys();\n\n if (!updates.size)\n return\n\n const output = [\n 'UPDATE',\n this.escape(main),\n this.set(updates)\n ]\n\n if (tables.size > 1) {\n const using = Array.from(tables.values())\n .filter(table => table !== main)\n .map(table => {\n if (table.joins.length === 0)\n throw new Error(`Table ${table.name} has no joins.`);\n\n const conditions = table.joins\n .map(x => this.filter(x.left, x.op, x.right))\n .join(' AND ')\n\n return { conditions, table };\n });\n\n output.push(\n 'FROM', using.map(x => x.table.name).join(', '),\n 'WHERE', using.map(x => x.conditions).join(' AND ')\n )\n }\n\n return output;\n }\n\n protected limit(){\n const { limit, offset } = this.query;\n const clauses = super.limit();\n\n return offset && !limit ? [\"LIMIT -1\", ...clauses] : clauses;\n }\n}\n"],"mappings":";;;AAIA,SAAgB,IAAI,OAAc;AAChC,SAAQ,OAAO,MAAf;EACE,KAAK,OACH,QAAO;EACT,KAAK,OACH,QAAO;EACT,QACE,QAAO;;;AAIb,IAAa,kBAAb,cAAqC,UAAU;CAC7C,AAAU,IAAI,OAAc;AAC1B,SAAO,IAAI,MAAM;;CAGnB,AAAU,UAAU,OAA0B;EAC5C,MAAM,QAAQ,KAAK,MAAM,MAAM;AAK/B,SAAO,UAJQ,MAAM,KAAK,MAAM,OAAO,OAAO,MAAM;AAClD,UAAO,aAAa,EAAE,GAAG,KAAK,OAAO,MAAM,OAAO;IAClD,CAEsB,KAAK,KAAK,CAAC,kBAAkB,MAAM;;CAG7D,AAAU,SAAQ;EAChB,MAAM,EAAE,SAAS,WAAW,KAAK;EAEjC,MAAM,CAAC,QAAQ,QAAQ,MAAM;AAE7B,MAAI,CAAC,QAAQ,KACX;EAEF,MAAM,SAAS;GACb;GACA,KAAK,OAAO,KAAK;GACjB,KAAK,IAAI,QAAQ;GAClB;AAED,MAAI,OAAO,OAAO,GAAG;GACnB,MAAM,QAAQ,MAAM,KAAK,OAAO,QAAQ,CAAC,CACtC,QAAO,UAAS,UAAU,KAAK,CAC/B,KAAI,UAAS;AACZ,QAAI,MAAM,MAAM,WAAW,EACzB,OAAM,IAAI,MAAM,SAAS,MAAM,KAAK,gBAAgB;AAMtD,WAAO;KAAE,YAJU,MAAM,MACtB,KAAI,MAAK,KAAK,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAC5C,KAAK,QAAQ;KAEK;KAAO;KAC5B;AAEJ,UAAO,KACL,QAAQ,MAAM,KAAI,MAAK,EAAE,MAAM,KAAK,CAAC,KAAK,KAAK,EAC/C,SAAS,MAAM,KAAI,MAAK,EAAE,WAAW,CAAC,KAAK,QAAQ,CACpD;;AAGH,SAAO;;CAGT,AAAU,QAAO;EACf,MAAM,EAAE,OAAO,WAAW,KAAK;EAC/B,MAAM,UAAU,MAAM,OAAO;AAE7B,SAAO,UAAU,CAAC,QAAQ,CAAC,YAAY,GAAG,QAAQ,GAAG"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@expressive/sql",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.10.0",
|
|
4
4
|
"description": "Expressive ORM on SQL: entities, Query and an embedded SQLite store from one import.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"orm",
|
|
@@ -59,7 +59,7 @@
|
|
|
59
59
|
"test": "bun run typecheck && bun run coverage"
|
|
60
60
|
},
|
|
61
61
|
"dependencies": {
|
|
62
|
-
"@expressive/orm": "^0.
|
|
62
|
+
"@expressive/orm": "^0.20.0",
|
|
63
63
|
"sql-formatter": "^10.7.2"
|
|
64
64
|
},
|
|
65
65
|
"devDependencies": {
|
|
@@ -5,13 +5,13 @@ description: Expressive ORM on SQL (@expressive/sql) - SQLiteConnection with a b
|
|
|
5
5
|
|
|
6
6
|
# @expressive/sql
|
|
7
7
|
|
|
8
|
-
Expressive ORM on SQL, with embedded SQLite. Re-exports `@expressive/orm` - entities, fields, relations, `Query
|
|
8
|
+
Expressive ORM on SQL, with embedded SQLite. Re-exports `@expressive/orm` - entities, fields, relations, `Query`, transactions and `Memory` are in `expressive-orm`. Apps import everything from `@expressive/sql`.
|
|
9
9
|
|
|
10
10
|
```bash
|
|
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` (0.18 or later); the first found is used. For Postgres and live rows install `@expressive/postgres` (skill `expressive-postgres`)
|
|
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`).
|
|
15
15
|
|
|
16
16
|
## Connect
|
|
17
17
|
|
|
@@ -27,13 +27,11 @@ const db = await SQLiteConnection.new([User], "app.db"); // omit the filename
|
|
|
27
27
|
await db.close();
|
|
28
28
|
```
|
|
29
29
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
`sync` covers the classes passed to `new`. `static connection = db` binds another class without syncing it. `db.schema` is the DDL.
|
|
30
|
+
A filename or in-memory connection enforces foreign keys. `sync` covers the classes passed to `new` - list every class; an unlisted one has no connection. `db.schema` is the DDL. A failed statement throws `Error running SQL: <message>` followed by the SQL.
|
|
33
31
|
|
|
34
32
|
### Engine
|
|
35
33
|
|
|
36
|
-
In place of the filename, pass an `Engine` for a SQLite the built-in loader can't open
|
|
34
|
+
In place of the filename, pass an `Engine` for a SQLite the built-in loader can't open - any object with these, each async:
|
|
37
35
|
|
|
38
36
|
```ts
|
|
39
37
|
import type { Engine } from '@expressive/sql';
|
|
@@ -49,7 +47,9 @@ const engine: Engine = {
|
|
|
49
47
|
const db = await SQLiteConnection.new([User], engine);
|
|
50
48
|
```
|
|
51
49
|
|
|
52
|
-
A given engine is used as is - turn on foreign keys yourself where the host doesn't - and `close()` leaves it open.
|
|
50
|
+
A given engine, binding or client is used as is - turn on foreign keys yourself where the host doesn't - and `close()` leaves it open.
|
|
51
|
+
|
|
52
|
+
On React Native (Metro, iOS and Android) the built-in loader is swapped out: a filename or libSQL address rejects with `... does not load under React Native. Pass an Engine instead.` Expo web does not bundle `@expressive/sql`. `transaction` throws there - no `AsyncLocalStorage`.
|
|
53
53
|
|
|
54
54
|
Two optional members, for hosts without `BEGIN` and `COMMIT` on one connection:
|
|
55
55
|
|
|
@@ -58,7 +58,7 @@ Two optional members, for hosts without `BEGIN` and `COMMIT` on one connection:
|
|
|
58
58
|
|
|
59
59
|
### Hosts
|
|
60
60
|
|
|
61
|
-
In place of the filename, `new` also takes a D1 binding, a libSQL `Client` or a libSQL address, told apart by shape.
|
|
61
|
+
In place of the filename, `new` also takes a D1 binding, a libSQL `Client` or a libSQL address, told apart by shape.
|
|
62
62
|
|
|
63
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
64
|
|
|
@@ -86,7 +86,7 @@ export default {
|
|
|
86
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
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
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
|
|
89
|
+
- A `migrate` rebuild refuses dangling rows (`foreign_key_check`) even where foreign keys are off.
|
|
90
90
|
|
|
91
91
|
## Sync
|
|
92
92
|
|
|
@@ -98,6 +98,7 @@ Awaiting a connection runs `sync`:
|
|
|
98
98
|
- `static schema` is reported - SQLite has none.
|
|
99
99
|
- A relation column missing while `<table>_id` exists is reported, not added - set `{ column: "<table>_id" }` to keep the old one.
|
|
100
100
|
- `sync(false)` only verifies. `plan(force?)` returns `{ steps, problems }` - each step with `action`, `reason` and `sql` - without doing it. A sync applies in one transaction.
|
|
101
|
+
- `sync` runs once - after the await it throws `Connection is already active.` To force a rebuild, call `sync(true, true)` on the connection instead of awaiting it, or run `expressive sql sync --force`.
|
|
101
102
|
|
|
102
103
|
### Command line
|
|
103
104
|
|
|
@@ -107,20 +108,20 @@ expressive sql sync src/db.ts # create missing tables, columns and index
|
|
|
107
108
|
expressive sql sync --force src/db.ts # also rebuild drifted columns
|
|
108
109
|
```
|
|
109
110
|
|
|
110
|
-
The entry is the module that creates the connections - imported with `sync` held back, so `await Connection.new()` resolves without touching the database; the command plans and syncs each connection
|
|
111
|
+
The entry is the module that creates the connections - imported with `sync` held back, so `await Connection.new()` resolves without touching the database; the command plans and syncs each connection awaited while it loads. The entry must not query at load - the tables may not exist yet. A TypeScript entry needs Bun (`bunx --bun expressive ...`) or Node 22.18+.
|
|
111
112
|
|
|
112
113
|
## Datatypes
|
|
113
114
|
|
|
114
|
-
Datatypes are
|
|
115
|
+
Datatypes are orm's (`expressive-orm/SKILL.md#entities`); `sql.*` is shorthand for the declaration: `str(sql.varchar(40))` is `str({ type: "varchar", length: 40 })`. SQLite stores:
|
|
115
116
|
|
|
116
|
-
| Helper |
|
|
117
|
-
|
|
118
|
-
| `str` |
|
|
119
|
-
| `num` |
|
|
120
|
-
| `bool` |
|
|
121
|
-
| `date` |
|
|
122
|
-
| `json` |
|
|
123
|
-
| `one` |
|
|
117
|
+
| Helper | SQLite |
|
|
118
|
+
|---|---|
|
|
119
|
+
| `str` | TEXT |
|
|
120
|
+
| `num` | INTEGER; `real`, `double` REAL; `numeric`, `decimal` NUMERIC |
|
|
121
|
+
| `bool` | INTEGER, 1 or 0 |
|
|
122
|
+
| `date` | TEXT - ISO 8601 UTC to the ms; `date` the local day `YYYY-MM-DD`; `time` UTC `HH:MM:SS` |
|
|
123
|
+
| `json` | TEXT |
|
|
124
|
+
| `one` | the related key's |
|
|
124
125
|
|
|
125
126
|
```ts
|
|
126
127
|
import { Type, date, key, num, sql, str } from '@expressive/sql';
|
|
@@ -135,13 +136,10 @@ class Product extends Type {
|
|
|
135
136
|
```
|
|
136
137
|
|
|
137
138
|
- `num()` is a 32-bit integer - a fraction or a value outside 32-bit range throws on write. `sql.bigint` for large integers, `sql.real` or `sql.numeric(p, s)` for fractions.
|
|
138
|
-
- A datatype of another helper, like `num(sql.text)`, is a type error.
|
|
139
139
|
- Options a factory doesn't take go in an object - `date({ type: "timestamp", precision: 3 })`.
|
|
140
|
-
- `sql.now` is the database's current time in the column's storage - as a `fallback`, in a statics write or comparison (`lessThan(sql.now)`), or in a `Query`. Statics read it from the app's clock.
|
|
141
|
-
-
|
|
142
|
-
- `
|
|
143
|
-
- A `date` type is a calendar day: a Date gives its local day, `"YYYY-MM-DD"` is that day, and it reads back as local midnight. It crosses the floor and is stored as `YYYY-MM-DD`, so zones never shift it. `sql.now` on it is the database's UTC day. A `time` is a UTC time of day, crossing as a Date on 1970-01-01 UTC.
|
|
144
|
-
- Storage-only types are gone: store epoch time as `num(sql.bigint)`, yes/no text as `str`.
|
|
140
|
+
- `sql.now` is the database's current time in the column's storage - as a `fallback`, in a statics write or comparison (`lessThan(sql.now)`), or in a `Query`. Statics read it from the app's clock.
|
|
141
|
+
- The SQL floor checks values again before storing, so rows forwarded from a client meet the same rules.
|
|
142
|
+
- A `date` type is a calendar day, read back as local midnight and stored `YYYY-MM-DD`, so zones never shift it; `sql.now` on it is the UTC day.
|
|
145
143
|
|
|
146
144
|
`codecs` maps each base helper to how SQL stores it (`Connection.Codec`). A dialect extends it - `new Map([...codecs, [date, myDateCodec]])` - and returns it from a protected `codecs` getter.
|
|
147
145
|
|