@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.
@@ -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]) => `${this.reference(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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"}
@@ -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.ms)`.
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.ms)`.
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
  */
@@ -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.ms)`.\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"}
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
- if (offset && !limit) return ["LIMIT -1", `OFFSET ${offset}`];
45
- return super.limit();
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 if (offset && !limit)\n return [\"LIMIT -1\", `OFFSET ${offset}`];\n\n return super.limit();\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;AAE/B,MAAI,UAAU,CAAC,MACb,QAAO,CAAC,YAAY,UAAU,SAAS;AAEzC,SAAO,MAAM,OAAO"}
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.9.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.18.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` and transactions are in `expressive-orm`. Apps import everything from `@expressive/sql`; driver seams come from `@expressive/orm/driver`.
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`), which re-exports this package.
14
+ SQLite is built into Bun (`bun:sqlite`) and Node 24 (`node:sqlite`). Elsewhere add one of `better-sqlite3`, `sqlite3` or `@libsql/client` (0.18 or later); the first found is used. For Postgres and live rows install `@expressive/postgres` (skill `expressive-postgres`).
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
- Connections enforce foreign keys. SQLite has no live rows.
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, such as on React Native - any object with these, each async:
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. A given binding or client is used as is; `close()` leaves it open.
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, and leaves them on.
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 created. A TypeScript entry needs Bun (`bunx --bun expressive ...`) or Node 22.18+.
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 portable - orm declares them, and each connection maps them to its storage. `sql.*` is shorthand for the declaration: `str(sql.varchar(40))` is `str({ type: "varchar", length: 40 })`. A schema module importing only `@expressive/orm` writes the object form and binds here unchanged.
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 | `sql.*` | SQLite |
117
- |---|---|---|
118
- | `str` | `text` (default), `varchar(n)`, `char(n)`, `uuid` | TEXT |
119
- | `num` | `integer` (default), `smallint`, `bigint`, `real`, `double`, `numeric(p, s)`, `decimal(p, s)` | INTEGER, REAL, NUMERIC |
120
- | `bool` | - (boolean) | INTEGER, 1 or 0 |
121
- | `date` | `timestamp` (default), `date`, `time` | TEXT - ISO 8601 UTC to the ms; `date` as the local day `YYYY-MM-DD`; `time` as UTC `HH:MM:SS` |
122
- | `json` | - | TEXT |
123
- | `one` | - (the related key's) | the key's |
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. `"NOW"` is a deprecated alias.
141
- - Writes are checked by the field on every connection - `varchar` and `char` length, integer ranges, decimal precision and scale. The SQL floor checks again before storing, so rows forwarded from a client meet the same rules.
142
- - `Connection.new` throws for a datatype the connection can't store - `SQLiteConnection can't store json type 'blob' (Doc.blob).`
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