@expressive/sql 0.5.0 → 0.6.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.
@@ -1 +1 @@
1
- {"version":3,"file":"SQLiteConnection.js","names":["Connection","current"],"sources":["../../src/sqlite/SQLiteConnection.ts"],"sourcesContent":["import { Builder, Field, now, Query } from '@expressive/orm';\nimport { Connection } from '../connection/Connection';\nimport { format } from 'sql-formatter';\n\nimport { createEngine, Engine } from './engine';\nimport { now as current, SQLiteGenerator } from './SQLiteGenerator';\n\ntype TableInfo = {\n name: string;\n type: string;\n notnull: number;\n dflt_value: any\n};\n\nexport class SQLiteConnection extends Connection {\n protected filename: string;\n protected engine?: Promise<Engine>;\n\n constructor(using: Connection.Types, filename?: string) {\n super(using);\n this.filename = filename || ':memory:';\n }\n\n protected db(){\n return this.engine ??= createEngine(this.filename);\n }\n\n get schema() {\n return pretty(this.generateSchema(this.using));\n }\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) => Promise<R>) => {\n await this.idle();\n\n try {\n return await op(await this.db());\n }\n catch (err) {\n if(err instanceof Error)\n throw new Error(`Error running SQL: ${err.message}\\n${pretty(sql)}`);\n\n throw err;\n }\n };\n\n const counts = !builder.returns && !builder.inserts.size && !builder.updates.size && !builder.deletes.size;\n\n return {\n all: (p?: any[]) => run(e => e.all(sql, string(p))),\n run: counts\n ? (p?: any[]) => run(e => e.get(sql, string(p)).then(row => Number(Object.values(row)[0])))\n : (p?: any[]) => run(e => e.run(sql, string(p)).then(r => r.changes)),\n toString: () => pretty(sql)\n };\n }\n\n protected async transact<T>(fn: () => Promise<T>): Promise<T> {\n const db = await this.db();\n\n await db.exec(\"BEGIN\");\n\n try {\n const result = await fn();\n\n await db.exec(\"COMMIT\");\n\n return result;\n }\n catch (error) {\n await db.exec(\"ROLLBACK\");\n throw error;\n }\n }\n\n async close(){\n if (this.engine)\n await (await this.engine).close();\n\n await super.close();\n }\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 async plan(force = false): Promise<Connection.Plan> {\n const steps: Connection.Step[] = [];\n const problems: string[] = [];\n\n for (const type of this.using) {\n const { table } = type;\n\n if (type.schema) {\n problems.push(`static schema is not supported by ${this.constructor.name}.`);\n continue;\n }\n\n const found = await this.inspect(type, true);\n\n if (!found) {\n steps.push({ table, action: `create table ${table}`, reason: `Table ${table} does not exist.`, sql: [this.generateTableSchema(type)] });\n continue;\n }\n\n const { columns, absent, drift, issues } = found;\n const rebuild = force && drift.length > 0;\n\n problems.push(...issues);\n\n if (!rebuild)\n problems.push(...drift.map(({ message }) => message));\n\n for (const field of absent) {\n const reason = moved(field, columns.map(col => col.name)) || unfit(field);\n\n if (reason)\n problems.push(`Column ${field.column} in table ${table} ${reason}`);\n else if (!rebuild)\n steps.push({\n table,\n column: field.column,\n action: `add column ${field.column} to ${table}`,\n reason: `Column ${field.column} does not exist in table ${table}`,\n sql: [`ALTER TABLE ${table} ADD COLUMN ${definition(field, true)};`]\n });\n }\n\n if (rebuild) {\n const fields = drift.map(({ field }) => field);\n const misfit = await this.misfit(type, fields, columns);\n\n if (misfit.length)\n problems.push(...misfit);\n else\n steps.push({\n table,\n action: `rebuild table ${table}`,\n reason: drift.map(({ message }) => message).join(\"; \"),\n sql: await this.rebuild(type, fields, columns)\n });\n }\n\n for (const field of await this.unindexed(type))\n steps.push({\n table,\n column: field.column,\n action: `create index ${indexName(field)} on ${table}`,\n reason: `Index ${indexName(field)} does not exist on ${table}`,\n sql: [index(field)]\n });\n }\n\n return { steps, problems };\n }\n\n protected async apply(steps: Connection.Step[]){\n const db = await this.db();\n const { foreign_keys } = await db.get(\"PRAGMA foreign_keys\");\n const guard = foreign_keys && steps.some(step => step.action.startsWith(\"rebuild\"));\n\n if (guard)\n await db.exec(\"PRAGMA foreign_keys = OFF\");\n\n await db.exec(\"BEGIN\");\n\n try {\n await db.exec(steps.flatMap(step => step.sql).join(\"\\n\"));\n\n const broken: { table: string }[] = guard ? await db.all(\"PRAGMA foreign_key_check\") : [];\n\n if (broken.length)\n throw new Error(dangling(broken));\n\n await db.exec(\"COMMIT\");\n }\n catch (error) {\n await db.exec(\"ROLLBACK\");\n throw error;\n }\n finally {\n if (guard)\n await db.exec(\"PRAGMA foreign_keys = ON\");\n }\n }\n\n async valid(type: Query.Table){\n const found = await this.inspect(type);\n\n if (!found)\n return false;\n\n const [problem] = [...found.drift.map(({ message }) => message), ...found.issues];\n\n if (problem)\n throw new Error(problem);\n\n return found.absent;\n }\n\n protected async inspect(type: Query.Table, planning = false){\n const { table } = type;\n const db = await this.db();\n\n const tableExists = await db.get(\n `SELECT name FROM sqlite_master WHERE type='table' AND name=?`, [table]);\n\n if (!tableExists)\n return false;\n\n const columns = await db.all(`PRAGMA table_info(${table})`) as TableInfo[];\n const absent: Field[] = [];\n const drift: { field: Field, message: string }[] = [];\n const issues: string[] = [];\n\n for (const field of type.fields.values()) {\n if (field.parts)\n continue;\n\n const info = columns.find(col => col.name === field.column);\n\n if (!info) {\n absent.push(field);\n continue;\n }\n\n const message = drifted(field, info);\n\n if (message)\n drift.push({ field, message });\n\n issues.push(...await this.references(field, planning));\n }\n\n return { columns, absent, drift, issues };\n }\n\n protected async unindexed(type: Query.Table){\n const db = await this.db();\n const covered = new Set<string>();\n\n for (const { name } of await db.all(`PRAGMA index_list(${type.table})`)) {\n const columns = await db.all(`PRAGMA index_info(\\`${name}\\`)`);\n\n if (columns.length == 1)\n covered.add(columns[0].name);\n }\n\n return indexed(type).filter(field => !covered.has(field.column));\n }\n\n protected async misfit(type: Query.Table, fields: Field[], columns: TableInfo[]){\n const db = await this.db();\n const { table } = type;\n const problems: string[] = [];\n\n for (const field of fields) {\n const info = columns.find(col => col.name === field.column)!;\n const column = `\\`${field.column}\\``;\n const expected = affinity(field);\n const fits = FITS[expected];\n const checks: [string, string][] = [];\n\n if (!field.nullable)\n checks.push([`${column} IS NULL`, \"NULL\"]);\n\n if (info.type.toUpperCase() !== expected && fits)\n checks.push([`${column} IS NOT NULL AND NOT (${fits(column)})`, `not ${expected}`]);\n\n for (const [where, what] of checks) {\n const { count } = await db.get(`SELECT COUNT(*) AS count FROM ${table} WHERE ${where}`);\n\n if (count)\n problems.push(\n `Column ${field.column} in table ${table} cannot be rebuilt: ${count} ${count == 1 ? \"row is\" : \"rows are\"} ${what}.`\n );\n }\n }\n\n return problems;\n }\n\n protected async rebuild(type: Query.Table, fields: Field[], columns: TableInfo[]){\n const db = await this.db();\n const { table } = type;\n const temp = `${table}__rebuild`;\n const own = Array.from(type.fields.values()).filter(field => !field.parts);\n const known = new Set(own.map(field => field.column));\n const extra = columns.filter(col => !known.has(col.name));\n const cast = new Set(fields.filter(field => (\n columns.find(col => col.name === field.column)!.type.toUpperCase() !== affinity(field)\n )));\n\n const copied = [\n ...own\n .filter(field => columns.some(col => col.name === field.column))\n .map(field => [field.column, cast.has(field) ? `CAST(\\`${field.column}\\` AS ${affinity(field)})` : `\\`${field.column}\\``]),\n ...extra.map(col => [col.name, `\\`${col.name}\\``])\n ];\n\n const indexes = await db.all(\n `SELECT sql FROM sqlite_master WHERE type IN ('index', 'trigger') AND tbl_name = ? AND sql IS NOT NULL`, [table]);\n\n return [\n this.tableSchema(type, temp, extra.map(col => (\n `\\`${col.name}\\` ${col.type}` +\n (col.notnull ? \" NOT NULL\" : \"\") +\n (col.dflt_value != null ? ` DEFAULT ${col.dflt_value}` : \"\")\n ))),\n `INSERT INTO ${temp} (${copied.map(([column]) => `\\`${column}\\``).join(\", \")}) ` +\n `SELECT ${copied.map(([, value]) => value).join(\", \")} FROM ${table};`,\n `DROP TABLE ${table};`,\n `ALTER TABLE ${temp} RENAME TO ${table};`,\n ...indexes.map(({ sql }: { sql: string }) => `${sql};`)\n ];\n }\n\n protected async references(field: Field, planning: boolean): Promise<string[]> {\n const { reference } = field;\n\n if (!reference)\n return [];\n\n const foreignKey = reference.column;\n const foreignTable = reference.parent!.table;\n\n if (reference.parent!.connection !== this)\n return [`Foreign key ${foreignTable}.${foreignKey} cannot be checked by another connection`];\n\n const db = await this.db();\n\n const foreignTableExists = await db.get(\n `SELECT name FROM sqlite_master WHERE type='table' AND name=?`, [foreignTable]);\n\n if (!foreignTableExists)\n return planning && this.using.has(reference.parent!) ? [] : [`Referenced table ${foreignTable} does not exist`];\n\n const foreignColumn = (await db.all(`PRAGMA table_info(${foreignTable})`))\n .find(col => col.name === foreignKey);\n\n if (!foreignColumn)\n return [`Referenced column ${foreignKey} does not exist in table ${foreignTable}`];\n\n return [];\n }\n\n protected generateSchema(types: Iterable<Query.Table>): string {\n return Array.from(types)\n .map(type => this.generateTableSchema(type))\n .join('\\n');\n }\n\n protected generateTableSchema(type: Query.Table): string {\n return [this.tableSchema(type), ...indexed(type).map(index)].join('\\n');\n }\n\n protected tableSchema(type: Query.Table, name = type.table, extra: string[] = []){\n const { parts } = type.fields.get(\"id\")!;\n const fields = [\n ...Array.from(type.fields.values()).filter(field => !field.parts).map(field => definition(field)),\n ...extra\n ];\n\n if (parts)\n fields.push(`PRIMARY KEY (${parts.map(part => `\\`${part.column}\\``).join(', ')})`);\n\n return `CREATE TABLE ${name} (${fields.join(', ')});`;\n }\n}\n\nfunction indexed(type: Query.Table){\n return Array.from(type.fields.values()).filter(field => field.index && !field.primary && !field.unique);\n}\n\nfunction dangling(rows: { table: string }[]){\n const tables = [...new Set(rows.map(row => row.table))].join(\", \");\n\n return `Cannot rebuild: ${tables} has references to missing rows (${rows.length}).`;\n}\n\nfunction indexName(field: Field){\n return typeof field.index == \"string\" ? field.index : `${field.parent!.table}_${field.column}`;\n}\n\nfunction index(field: Field){\n return `CREATE INDEX IF NOT EXISTS \\`${indexName(field)}\\` ON ${field.parent!.table} (\\`${field.column}\\`);`;\n}\n\nfunction drifted(field: Field, info: TableInfo){\n const { column, nullable, primary } = field;\n const parent = field.parent!;\n const keyed = primary || parent.fields.get(\"id\")!.parts?.includes(field);\n const expected = affinity(field);\n\n if (info.type.toUpperCase() !== expected)\n return `Column ${column} in table ${parent.table} has type ${info.type}, expected ${expected}`;\n\n if (!keyed && info.notnull === (nullable ? 1 : 0))\n return `Column ${column} in table ${parent.table} has incorrect nullable value`;\n}\n\nconst NUMBER = (column: string) =>\n `typeof(${column}) = 'text' AND CASE WHEN json_valid(trim(${column})) THEN json_type(trim(${column})) ELSE '' END IN ('integer', 'real')`;\n\nconst FITS: Record<string, (column: string) => string> = {\n INTEGER: column =>\n `typeof(${column}) = 'integer' OR typeof(${column}) = 'real' AND ${column} = CAST(${column} AS INTEGER) ` +\n `OR ${NUMBER(column)} AND ${column} NOT GLOB '*[eE]*' AND CAST(${column} AS REAL) = CAST(${column} AS INTEGER)`,\n REAL: column =>\n `typeof(${column}) IN ('integer', 'real') OR ${NUMBER(column)}`\n};\n\nFITS.NUMERIC = FITS.REAL;\n\nfunction definition(field: Field, adding?: boolean){\n const {\n column,\n fallback,\n reference,\n increment,\n nullable,\n primary,\n unique,\n } = field;\n\n const { onDelete, onUpdate } = field as Field & { onDelete?: string, onUpdate?: string };\n let parts = `\\`${column}\\` ${affinity(field)}`;\n\n if (!nullable) parts += ' NOT NULL';\n if (primary) parts += ' PRIMARY KEY';\n if (increment) parts += ' AUTOINCREMENT';\n if (unique) parts += ' UNIQUE';\n\n if (fallback !== undefined && !(adding && clock(fallback)))\n parts += ' DEFAULT ' + literal(field, fallback);\n\n if (reference)\n parts += ` REFERENCES ${reference.parent!.table}(${reference.column})`;\n\n if (onDelete) parts += ` ON DELETE ${onDelete}`;\n if (onUpdate) parts += ` ON UPDATE ${onUpdate}`;\n\n return parts;\n}\n\nfunction moved(field: Field, existing: string[]){\n const { entity } = field as Field & { entity?: Query.Table };\n const old = entity && `${entity.table}_id`;\n const taken = Array.from(field.parent!.fields.values()).some(other => other.column === old);\n\n if (old && !taken && existing.includes(old))\n return `is missing but ${old} exists; add { column: \"${old}\" } to ${field.parent!.name}.${field.key} to keep it.`;\n}\n\nfunction clock(fallback: unknown){\n return fallback === \"NOW\" || fallback === now;\n}\n\nfunction unfit({ primary, unique, nullable, fallback }: Field){\n if (primary)\n return \"is a primary key and cannot be added to an existing table.\";\n\n if (unique)\n return \"is UNIQUE and cannot be added by SQLite.\";\n\n if (!nullable && fallback === undefined)\n return \"is NOT NULL without a default and cannot be added to existing rows.\";\n\n if (!nullable && clock(fallback))\n return \"defaults to the current time and cannot be added by SQLite.\";\n}\n\nconst AFFINITY: Record<string, string> = {\n integer: \"INTEGER\",\n smallint: \"INTEGER\",\n bigint: \"INTEGER\",\n ms: \"INTEGER\",\n seconds: \"INTEGER\",\n boolean: \"INTEGER\",\n real: \"REAL\",\n float: \"REAL\",\n double: \"REAL\",\n numeric: \"NUMERIC\",\n decimal: \"NUMERIC\",\n text: \"TEXT\",\n varchar: \"TEXT\",\n char: \"TEXT\",\n uuid: \"TEXT\",\n timestamp: \"TEXT\",\n date: \"TEXT\",\n time: \"TEXT\"\n};\n\nfunction affinity(field: Field){\n const type = AFFINITY[field.type] || field.datatype.toUpperCase();\n\n if (!type)\n throw new Error(`Column ${field.column} has no datatype. Is @expressive/orm installed twice?`);\n\n return type;\n}\n\nfunction literal(field: Field, value: unknown){\n if (value === \"NOW\" || value === now)\n return `(${current(field)})`;\n\n if (value === null)\n return \"NULL\";\n\n const encoded = field.set(value);\n\n return typeof encoded == \"string\"\n ? `'${encoded.replace(/'/g, \"''\")}'`\n : String(encoded);\n}\n\nfunction pretty(sql: string){\n try {\n return format(sql, { language: 'sqlite', keywordCase: \"upper\" })\n .replace(/ - > > /g, \" ->> \")\n .replace(/`([a-zA-Z][a-zA-Z0-9_]*)`/g, \"$1\");\n }\n catch {\n return sql;\n }\n}"],"mappings":"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"}
1
+ {"version":3,"file":"SQLiteConnection.js","names":["Connection","current"],"sources":["../../src/sqlite/SQLiteConnection.ts"],"sourcesContent":["import { Field, now, Query } from '@expressive/orm';\nimport { Builder } from '@expressive/orm/driver';\nimport { Connection } from '../connection/Connection';\nimport { format } from 'sql-formatter';\n\nimport { createEngine, Engine } from './engine';\nimport { now as current, SQLiteGenerator } from './SQLiteGenerator';\n\ntype TableInfo = {\n name: string;\n type: string;\n notnull: number;\n dflt_value: any\n};\n\n/**\n * A connection to SQLite - a file, in memory, or a given `Engine`.\n *\n * The built-in loader takes the first of `bun:sqlite`, `node:sqlite`, `better-sqlite3`, `sqlite3`, `@libsql/client`, with foreign keys on.\n * Awaiting it runs `sync`. No live rows.\n *\n * @example\n * const db = await SQLiteConnection.new([User, Post], \"app.db\");\n */\nexport class SQLiteConnection extends Connection {\n protected filename: string;\n protected engine?: Promise<Engine>;\n protected owned = true;\n\n /**\n * Bind `using` to a SQLite database. Construct with `SQLiteConnection.new`.\n *\n * Without `source`, the database is in memory.\n */\n constructor(using: Connection.Types, source?: string | Engine) {\n super(using);\n\n if (typeof source == \"object\") {\n this.engine = Promise.resolve(source);\n this.owned = false;\n }\n\n this.filename = typeof source == \"string\" && source || ':memory:';\n }\n\n protected db(){\n return this.engine ??= createEngine(this.filename);\n }\n\n /** `CREATE TABLE` and `CREATE INDEX` statements for the bound classes, formatted. */\n get schema() {\n return pretty(this.generateSchema(this.using));\n }\n\n /**\n * Compile a builder to SQLite SQL.\n *\n * A failure when run rethrows as `Error running SQL: <message>` with the statement.\n */\n prepare(builder: Builder){\n const sql = String(new SQLiteGenerator(builder));\n const string = (x?: unknown[]) => x\n ? x.map(x => (\n x !== null && typeof x === 'object' ? JSON.stringify(x) :\n typeof x === 'boolean' ? Number(x) :\n x\n ))\n : [];\n\n const run = async <R>(op: (engine: Engine.Statements) => Promise<R>) => {\n await this.idle();\n\n try {\n return await op(this._journal()?.session as Engine.Session || await this.db());\n }\n catch (err) {\n if(err instanceof Error)\n throw new Error(`Error running SQL: ${err.message}\\n${pretty(sql)}`);\n\n throw err;\n }\n };\n\n const counts = !builder.returns && !builder.inserts.size && !builder.updates.size && !builder.deletes.size;\n\n return {\n all: (p?: any[]) => run(e => e.all(sql, string(p))),\n run: counts\n ? (p?: any[]) => run(e => e.get(sql, string(p)).then(row => Number(Object.values(row)[0])))\n : (p?: any[]) => run(e => e.run(sql, string(p)).then(r => r.changes)),\n toString: () => pretty(sql)\n };\n }\n\n protected async transact<T>(fn: () => Promise<T>): Promise<T> {\n const db = await this.db();\n const session = this._journal()!.session = await db.transaction?.();\n\n if (!session)\n await db.exec(\"BEGIN\");\n\n try {\n const result = await fn();\n\n await (session ? session.commit() : db.exec(\"COMMIT\"));\n\n return result;\n }\n catch (error) {\n await (session ? session.rollback() : db.exec(\"ROLLBACK\")).catch(() => {});\n throw error;\n }\n }\n\n /** Close the database when this connection opened it, then release the connection. */\n async close(){\n if (this.engine && this.owned)\n await (await this.engine).close();\n\n await super.close();\n }\n\n /**\n * Bring the database in line with the bound classes, then mark the connection ready.\n *\n * Creates missing tables and adds missing columns and indexes, in one transaction. Throws for any problem `plan` reports, changing nothing.\n * `fix` false only verifies - anything missing throws too. `force` rebuilds a table whose column type or nullability drifted.\n * Throws when the connection is already ready.\n */\n async sync(fix = true, force = false){\n if (this.ready)\n throw new Error(\"Connection is already active.\");\n\n const { steps, problems } = await this.plan(force);\n const issues = fix ? problems : [...problems, ...steps.map(step => step.reason)];\n\n if (issues.length)\n throw new Error(issues.join(\"\\n\"));\n\n if (steps.length)\n await this.apply(steps);\n\n (this as Connection).set({ ready: true });\n\n return this;\n }\n\n /**\n * List what `sync` would do, without doing it.\n *\n * `problems` are what it cannot fix - drift without `force`, a column SQLite cannot add, a missing referenced table, `static schema`.\n */\n async plan(force = false): Promise<Connection.Plan> {\n const steps: Connection.Step[] = [];\n const problems: string[] = [];\n\n for (const type of this.using) {\n const { table } = type;\n\n if (type.schema) {\n problems.push(`static schema is not supported by ${this.constructor.name}.`);\n continue;\n }\n\n const found = await this.inspect(type, true);\n\n if (!found) {\n steps.push({ table, action: `create table ${table}`, reason: `Table ${table} does not exist.`, sql: [this.generateTableSchema(type)] });\n continue;\n }\n\n const { columns, absent, drift, issues } = found;\n const rebuild = force && drift.length > 0;\n\n problems.push(...issues);\n\n if (!rebuild)\n problems.push(...drift.map(({ message }) => message));\n\n for (const field of absent) {\n const reason = moved(field, columns.map(col => col.name)) || unfit(field);\n\n if (reason)\n problems.push(`Column ${field.column} in table ${table} ${reason}`);\n else if (!rebuild)\n steps.push({\n table,\n column: field.column,\n action: `add column ${field.column} to ${table}`,\n reason: `Column ${field.column} does not exist in table ${table}`,\n sql: [`ALTER TABLE ${table} ADD COLUMN ${definition(field, true)};`]\n });\n }\n\n if (rebuild) {\n const fields = drift.map(({ field }) => field);\n const misfit = await this.misfit(type, fields, columns);\n\n if (misfit.length)\n problems.push(...misfit);\n else\n steps.push({\n table,\n action: `rebuild table ${table}`,\n reason: drift.map(({ message }) => message).join(\"; \"),\n sql: await this.rebuild(type, fields, columns)\n });\n }\n\n for (const field of await this.unindexed(type))\n steps.push({\n table,\n column: field.column,\n action: `create index ${indexName(field)} on ${table}`,\n reason: `Index ${indexName(field)} does not exist on ${table}`,\n sql: [index(field)]\n });\n }\n\n return { steps, problems };\n }\n\n protected async apply(steps: Connection.Step[]){\n const db = await this.db();\n const { foreign_keys } = await db.get(\"PRAGMA foreign_keys\");\n const guard = foreign_keys && steps.some(step => step.action.startsWith(\"rebuild\"));\n const sql = steps.flatMap(step => step.sql);\n\n if (db.batch && !guard)\n return db.batch(sql);\n\n if (db.batch) {\n await db.exec(\"PRAGMA foreign_keys = OFF\").catch(() => {});\n\n try {\n if ((await db.get(\"PRAGMA foreign_keys\")).foreign_keys)\n throw new Error(\"Cannot rebuild: this engine keeps foreign keys on, so dropping the table would cascade.\");\n\n const broken: { table: string }[] = await db.all(\"PRAGMA foreign_key_check\");\n\n if (broken.length)\n throw new Error(dangling(broken));\n\n return await db.batch(sql);\n }\n finally {\n await db.exec(\"PRAGMA foreign_keys = ON\").catch(() => {});\n }\n }\n\n if (guard)\n await db.exec(\"PRAGMA foreign_keys = OFF\");\n\n await db.exec(\"BEGIN\");\n\n try {\n await db.exec(sql.join(\"\\n\"));\n\n const broken: { table: string }[] = guard ? await db.all(\"PRAGMA foreign_key_check\") : [];\n\n if (broken.length)\n throw new Error(dangling(broken));\n\n await db.exec(\"COMMIT\");\n }\n catch (error) {\n await db.exec(\"ROLLBACK\");\n throw error;\n }\n finally {\n if (guard)\n await db.exec(\"PRAGMA foreign_keys = ON\");\n }\n }\n\n async valid(type: Query.Table){\n const found = await this.inspect(type);\n\n if (!found)\n return false;\n\n const [problem] = [...found.drift.map(({ message }) => message), ...found.issues];\n\n if (problem)\n throw new Error(problem);\n\n return found.absent;\n }\n\n protected async inspect(type: Query.Table, planning = false){\n const { table } = type;\n const db = await this.db();\n\n const tableExists = await db.get(\n `SELECT name FROM sqlite_master WHERE type='table' AND name=?`, [table]);\n\n if (!tableExists)\n return false;\n\n const columns = await db.all(`PRAGMA table_info(${table})`) as TableInfo[];\n const absent: Field[] = [];\n const drift: { field: Field, message: string }[] = [];\n const issues: string[] = [];\n\n for (const field of type.fields.values()) {\n if (field.parts)\n continue;\n\n const info = columns.find(col => col.name === field.column);\n\n if (!info) {\n absent.push(field);\n continue;\n }\n\n const message = drifted(field, info);\n\n if (message)\n drift.push({ field, message });\n\n issues.push(...await this.references(field, planning));\n }\n\n return { columns, absent, drift, issues };\n }\n\n protected async unindexed(type: Query.Table){\n const db = await this.db();\n const covered = new Set<string>();\n\n for (const { name } of await db.all(`PRAGMA index_list(${type.table})`)) {\n const columns = await db.all(`PRAGMA index_info(\\`${name}\\`)`);\n\n if (columns.length == 1)\n covered.add(columns[0].name);\n }\n\n return indexed(type).filter(field => !covered.has(field.column));\n }\n\n protected async misfit(type: Query.Table, fields: Field[], columns: TableInfo[]){\n const db = await this.db();\n const { table } = type;\n const problems: string[] = [];\n\n for (const field of fields) {\n const info = columns.find(col => col.name === field.column)!;\n const column = `\\`${field.column}\\``;\n const expected = affinity(field);\n const fits = FITS[expected];\n const checks: [string, string][] = [];\n\n if (!field.nullable)\n checks.push([`${column} IS NULL`, \"NULL\"]);\n\n if (info.type.toUpperCase() !== expected && fits)\n checks.push([`${column} IS NOT NULL AND NOT (${fits(column)})`, `not ${expected}`]);\n\n for (const [where, what] of checks) {\n const { count } = await db.get(`SELECT COUNT(*) AS count FROM ${table} WHERE ${where}`);\n\n if (count)\n problems.push(\n `Column ${field.column} in table ${table} cannot be rebuilt: ${count} ${count == 1 ? \"row is\" : \"rows are\"} ${what}.`\n );\n }\n }\n\n return problems;\n }\n\n protected async rebuild(type: Query.Table, fields: Field[], columns: TableInfo[]){\n const db = await this.db();\n const { table } = type;\n const temp = `${table}__rebuild`;\n const own = Array.from(type.fields.values()).filter(field => !field.parts);\n const known = new Set(own.map(field => field.column));\n const extra = columns.filter(col => !known.has(col.name));\n const cast = new Set(fields.filter(field => (\n columns.find(col => col.name === field.column)!.type.toUpperCase() !== affinity(field)\n )));\n\n const copied = [\n ...own\n .filter(field => columns.some(col => col.name === field.column))\n .map(field => [field.column, cast.has(field) ? `CAST(\\`${field.column}\\` AS ${affinity(field)})` : `\\`${field.column}\\``]),\n ...extra.map(col => [col.name, `\\`${col.name}\\``])\n ];\n\n const indexes = await db.all(\n `SELECT sql FROM sqlite_master WHERE type IN ('index', 'trigger') AND tbl_name = ? AND sql IS NOT NULL`, [table]);\n\n return [\n this.tableSchema(type, temp, extra.map(col => (\n `\\`${col.name}\\` ${col.type}` +\n (col.notnull ? \" NOT NULL\" : \"\") +\n (col.dflt_value != null ? ` DEFAULT ${col.dflt_value}` : \"\")\n ))),\n `INSERT INTO ${temp} (${copied.map(([column]) => `\\`${column}\\``).join(\", \")}) ` +\n `SELECT ${copied.map(([, value]) => value).join(\", \")} FROM ${table};`,\n `DROP TABLE ${table};`,\n `ALTER TABLE ${temp} RENAME TO ${table};`,\n ...indexes.map(({ sql }: { sql: string }) => `${sql};`)\n ];\n }\n\n protected async references(field: Field, planning: boolean): Promise<string[]> {\n const { reference } = field;\n\n if (!reference)\n return [];\n\n const foreignKey = reference.column;\n const foreignTable = reference.parent!.table;\n\n if (reference.parent!.connection !== this)\n return [`Foreign key ${foreignTable}.${foreignKey} cannot be checked by another connection`];\n\n const db = await this.db();\n\n const foreignTableExists = await db.get(\n `SELECT name FROM sqlite_master WHERE type='table' AND name=?`, [foreignTable]);\n\n if (!foreignTableExists)\n return planning && this.using.has(reference.parent!) ? [] : [`Referenced table ${foreignTable} does not exist`];\n\n const foreignColumn = (await db.all(`PRAGMA table_info(${foreignTable})`))\n .find(col => col.name === foreignKey);\n\n if (!foreignColumn)\n return [`Referenced column ${foreignKey} does not exist in table ${foreignTable}`];\n\n return [];\n }\n\n protected generateSchema(types: Iterable<Query.Table>): string {\n return Array.from(types)\n .map(type => this.generateTableSchema(type))\n .join('\\n');\n }\n\n protected generateTableSchema(type: Query.Table): string {\n return [this.tableSchema(type), ...indexed(type).map(index)].join('\\n');\n }\n\n protected tableSchema(type: Query.Table, name = type.table, extra: string[] = []){\n const { parts } = type.fields.get(\"id\")!;\n const fields = [\n ...Array.from(type.fields.values()).filter(field => !field.parts).map(field => definition(field)),\n ...extra\n ];\n\n if (parts)\n fields.push(`PRIMARY KEY (${parts.map(part => `\\`${part.column}\\``).join(', ')})`);\n\n return `CREATE TABLE ${name} (${fields.join(', ')});`;\n }\n}\n\nfunction indexed(type: Query.Table){\n return Array.from(type.fields.values()).filter(field => field.index && !field.primary && !field.unique);\n}\n\nfunction dangling(rows: { table: string }[]){\n const tables = [...new Set(rows.map(row => row.table))].join(\", \");\n\n return `Cannot rebuild: ${tables} has references to missing rows (${rows.length}).`;\n}\n\nfunction indexName(field: Field){\n return typeof field.index == \"string\" ? field.index : `${field.parent!.table}_${field.column}`;\n}\n\nfunction index(field: Field){\n return `CREATE INDEX IF NOT EXISTS \\`${indexName(field)}\\` ON ${field.parent!.table} (\\`${field.column}\\`);`;\n}\n\nfunction drifted(field: Field, info: TableInfo){\n const { column, nullable, primary } = field;\n const parent = field.parent!;\n const keyed = primary || parent.fields.get(\"id\")!.parts?.includes(field);\n const expected = affinity(field);\n\n if (info.type.toUpperCase() !== expected)\n return `Column ${column} in table ${parent.table} has type ${info.type}, expected ${expected}`;\n\n if (!keyed && info.notnull === (nullable ? 1 : 0))\n return `Column ${column} in table ${parent.table} has incorrect nullable value`;\n}\n\nconst NUMBER = (column: string) =>\n `typeof(${column}) = 'text' AND CASE WHEN json_valid(trim(${column})) THEN json_type(trim(${column})) ELSE '' END IN ('integer', 'real')`;\n\nconst FITS: Record<string, (column: string) => string> = {\n INTEGER: column =>\n `typeof(${column}) = 'integer' OR typeof(${column}) = 'real' AND ${column} = CAST(${column} AS INTEGER) ` +\n `OR ${NUMBER(column)} AND ${column} NOT GLOB '*[eE]*' AND CAST(${column} AS REAL) = CAST(${column} AS INTEGER)`,\n REAL: column =>\n `typeof(${column}) IN ('integer', 'real') OR ${NUMBER(column)}`\n};\n\nFITS.NUMERIC = FITS.REAL;\n\nfunction definition(field: Field, adding?: boolean){\n const {\n column,\n fallback,\n reference,\n increment,\n nullable,\n primary,\n unique,\n } = field;\n\n const { onDelete, onUpdate } = field as Field & { onDelete?: string, onUpdate?: string };\n let parts = `\\`${column}\\` ${affinity(field)}`;\n\n if (!nullable) parts += ' NOT NULL';\n if (primary) parts += ' PRIMARY KEY';\n if (increment) parts += ' AUTOINCREMENT';\n if (unique) parts += ' UNIQUE';\n\n if (fallback !== undefined && !(adding && clock(fallback)))\n parts += ' DEFAULT ' + literal(field, fallback);\n\n if (reference)\n parts += ` REFERENCES ${reference.parent!.table}(${reference.column})`;\n\n if (onDelete) parts += ` ON DELETE ${onDelete}`;\n if (onUpdate) parts += ` ON UPDATE ${onUpdate}`;\n\n return parts;\n}\n\nfunction moved(field: Field, existing: string[]){\n const { entity } = field as Field & { entity?: Query.Table };\n const old = entity && `${entity.table}_id`;\n const taken = Array.from(field.parent!.fields.values()).some(other => other.column === old);\n\n if (old && !taken && existing.includes(old))\n return `is missing but ${old} exists; add { column: \"${old}\" } to ${field.parent!.name}.${field.key} to keep it.`;\n}\n\nfunction clock(fallback: unknown){\n return fallback === \"NOW\" || fallback === now;\n}\n\nfunction unfit({ primary, unique, nullable, fallback }: Field){\n if (primary)\n return \"is a primary key and cannot be added to an existing table.\";\n\n if (unique)\n return \"is UNIQUE and cannot be added by SQLite.\";\n\n if (!nullable && fallback === undefined)\n return \"is NOT NULL without a default and cannot be added to existing rows.\";\n\n if (!nullable && clock(fallback))\n return \"defaults to the current time and cannot be added by SQLite.\";\n}\n\nconst AFFINITY: Record<string, string> = {\n integer: \"INTEGER\",\n smallint: \"INTEGER\",\n bigint: \"INTEGER\",\n ms: \"INTEGER\",\n seconds: \"INTEGER\",\n boolean: \"INTEGER\",\n real: \"REAL\",\n float: \"REAL\",\n double: \"REAL\",\n numeric: \"NUMERIC\",\n decimal: \"NUMERIC\",\n text: \"TEXT\",\n varchar: \"TEXT\",\n char: \"TEXT\",\n uuid: \"TEXT\",\n timestamp: \"TEXT\",\n date: \"TEXT\",\n time: \"TEXT\"\n};\n\nfunction affinity(field: Field){\n const type = AFFINITY[field.type] || field.datatype.toUpperCase();\n\n if (!type)\n throw new Error(`Column ${field.column} has no datatype. Is @expressive/orm installed twice?`);\n\n return type;\n}\n\nfunction literal(field: Field, value: unknown){\n if (value === \"NOW\" || value === now)\n return `(${current(field)})`;\n\n if (value === null)\n return \"NULL\";\n\n const encoded = field.set(value);\n\n return typeof encoded == \"string\"\n ? `'${encoded.replace(/'/g, \"''\")}'`\n : String(encoded);\n}\n\nfunction pretty(sql: string){\n try {\n return format(sql, { language: 'sqlite', keywordCase: \"upper\" })\n .replace(/ - > > /g, \" ->> \")\n .replace(/`([a-zA-Z][a-zA-Z0-9_]*)`/g, \"$1\");\n }\n catch {\n return sql;\n }\n}"],"mappings":"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"}
@@ -1,5 +1,6 @@
1
1
  import { Generator } from "../connection/Generator.js";
2
- import { DataTable, Field } from "@expressive/orm";
2
+ import { Field } from "@expressive/orm";
3
+ import { DataTable } from "@expressive/orm/driver";
3
4
 
4
5
  //#region src/sqlite/SQLiteGenerator.d.ts
5
6
  declare function now(field?: Field): "CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)" | "CAST(strftime('%s', 'now') AS INTEGER)" | "date('now')" | "time('now')" | "strftime('%Y-%m-%dT%H:%M:%fZ', 'now')";
@@ -1 +1 @@
1
- {"version":3,"file":"SQLiteGenerator.js","names":[],"sources":["../../src/sqlite/SQLiteGenerator.ts"],"sourcesContent":["import { DataTable, Field } from '@expressive/orm';\nimport { Generator } from '../connection/Generator';\n\nexport function now(field?: Field){\n switch (field?.type) {\n case \"ms\":\n return \"CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)\";\n case \"seconds\":\n case \"integer\":\n return \"CAST(strftime('%s', 'now') AS INTEGER)\";\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":";;;AAGA,SAAgB,IAAI,OAAc;AAChC,SAAQ,OAAO,MAAf;EACE,KAAK,KACH,QAAO;EACT,KAAK;EACL,KAAK,UACH,QAAO;EACT,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 \"ms\":\n return \"CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)\";\n case \"seconds\":\n case \"integer\":\n return \"CAST(strftime('%s', 'now') AS INTEGER)\";\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,KACH,QAAO;EACT,KAAK;EACL,KAAK,UACH,QAAO;EACT,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,12 +1,45 @@
1
1
  //#region src/sqlite/engine.d.ts
2
- interface Engine {
3
- all(sql: string, params?: any[]): Promise<any[]>;
4
- get(sql: string, params?: any[]): Promise<any>;
5
- run(sql: string, params?: any[]): Promise<{
6
- changes: number;
7
- }>;
8
- exec(sql: string): Promise<void>;
2
+ /**
3
+ * A SQLite host - what `SQLiteConnection` runs statements on.
4
+ *
5
+ * Pass one in place of a filename for a SQLite the built-in loader cannot open.
6
+ * It is used as given - foreign keys are not switched on, and the connection's `close()` leaves it open.
7
+ */
8
+ interface Engine extends Engine.Statements {
9
+ /** Release the database. Called only on an engine the connection opened. */
9
10
  close(): Promise<void>;
11
+ /**
12
+ * Open a transaction on its own session.
13
+ *
14
+ * Without it the connection issues `BEGIN`, `COMMIT` and `ROLLBACK` through `exec`.
15
+ */
16
+ transaction?(): Promise<Engine.Session>;
17
+ /**
18
+ * Run statements atomically.
19
+ *
20
+ * `sync` applies through it when present; a table rebuild then needs foreign keys off.
21
+ */
22
+ batch?(sql: string[]): Promise<void>;
23
+ }
24
+ declare namespace Engine {
25
+ /** Statement methods an engine and a session share. Parameters are positional. */
26
+ interface Statements {
27
+ /** Run a statement, resolving every row. */
28
+ all(sql: string, params?: any[]): Promise<any[]>;
29
+ /** Run a statement, resolving the first row. */
30
+ get(sql: string, params?: any[]): Promise<any>;
31
+ /** Run a statement, resolving how many rows changed. */
32
+ run(sql: string, params?: any[]): Promise<{
33
+ changes: number;
34
+ }>;
35
+ /** Run one or more statements without parameters. */
36
+ exec(sql: string): Promise<void>;
37
+ }
38
+ /** A transaction's own handle - statements inside `db.transaction(fn)` run on it. */
39
+ interface Session extends Statements {
40
+ commit(): Promise<void>;
41
+ rollback(): Promise<void>;
42
+ }
10
43
  }
11
44
  declare function createEngine(filename: string): Promise<Engine>;
12
45
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"engine.js","names":[],"sources":["../../src/sqlite/engine.ts"],"sourcesContent":["export interface Engine {\n all(sql: string, params?: any[]): Promise<any[]>;\n get(sql: string, params?: any[]): Promise<any>;\n run(sql: string, params?: any[]): Promise<{ changes: number }>;\n exec(sql: string): Promise<void>;\n close(): Promise<void>;\n}\n\nconst DRIVERS = [bunSqlite, nodeSqlite, betterSqlite3, sqlite3, libsql];\n\nexport async function createEngine(filename: string): Promise<Engine> {\n for (const load of DRIVERS) {\n const engine = await load(filename).catch(() => null);\n\n if (engine) {\n await engine.exec(\"PRAGMA foreign_keys = ON\");\n return engine;\n }\n }\n\n throw new Error(\n \"No compatible SQLite driver found. Run under Bun or Node >=24, \" +\n \"or install one of: better-sqlite3, sqlite3, @libsql/client.\"\n );\n}\n\nfunction optional(name: string): Promise<any> {\n return import(name);\n}\n\nasync function bunSqlite(file: string): Promise<Engine | null> {\n if (typeof (globalThis as any).Bun === \"undefined\")\n return null;\n\n const { Database } = await optional(\"bun:sqlite\");\n\n return syncEngine(new Database(file));\n}\n\nasync function nodeSqlite(file: string): Promise<Engine | null> {\n const { DatabaseSync } = await optional(\"node:sqlite\");\n\n return syncEngine(new DatabaseSync(file));\n}\n\nasync function betterSqlite3(file: string): Promise<Engine | null> {\n const { default: Database } = await optional(\"better-sqlite3\");\n\n return syncEngine(new Database(file));\n}\n\nasync function sqlite3(file: string): Promise<Engine | null> {\n const { default: { Database } } = await optional(\"sqlite3\");\n\n return asyncEngine(new Database(file));\n}\n\nasync function libsql(file: string): Promise<Engine | null> {\n const { createClient } = await optional(\"@libsql/client\");\n const url = file === \":memory:\" ? \":memory:\" : `file:${file}`;\n\n return libsqlEngine(createClient({ url }));\n}\n\nfunction syncEngine(db: any): Engine {\n return {\n async all(sql, params = []) {\n return db.prepare(sql).all(...params);\n },\n async get(sql, params = []) {\n return db.prepare(sql).get(...params);\n },\n async run(sql, params = []) {\n return { changes: db.prepare(sql).run(...params).changes };\n },\n async exec(sql) {\n db.exec(sql);\n },\n async close() {\n db.close();\n }\n };\n}\n\nfunction asyncEngine(db: any): Engine {\n const call = (method: string, sql: string, params: any[]) =>\n new Promise<any>((resolve, reject) => {\n db[method](sql, params, function (this: any, err: any, rows: any) {\n if (err) reject(err);\n else resolve(method === \"run\" ? this : rows);\n });\n });\n\n const done = (resolve: () => void, reject: (err: any) => void) =>\n (err: any) => err ? reject(err) : resolve();\n\n return {\n all: (sql, params = []) => call(\"all\", sql, params),\n get: (sql, params = []) => call(\"get\", sql, params),\n run: (sql, params = []) => call(\"run\", sql, params).then(ctx => ({ changes: ctx.changes })),\n exec: sql => new Promise((resolve, reject) => db.exec(sql, done(resolve, reject))),\n close: () => new Promise((resolve, reject) => db.close(done(resolve, reject)))\n };\n}\n\nfunction libsqlEngine(client: any): Engine {\n const execute = (sql: string, args: any[]) => client.execute({ sql, args });\n\n return {\n async all(sql, params = []) {\n return (await execute(sql, params)).rows;\n },\n async get(sql, params = []) {\n return (await execute(sql, params)).rows[0];\n },\n async run(sql, params = []) {\n return { changes: Number((await execute(sql, params)).rowsAffected) };\n },\n async exec(sql) {\n await client.executeMultiple(sql);\n },\n async close() {\n client.close();\n }\n };\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"engine.js","names":[],"sources":["../../src/sqlite/engine.ts"],"sourcesContent":["/**\n * A SQLite host - what `SQLiteConnection` runs statements on.\n *\n * Pass one in place of a filename for a SQLite the built-in loader cannot open.\n * It is used as given - foreign keys are not switched on, and the connection's `close()` leaves it open.\n */\nexport interface Engine extends Engine.Statements {\n /** Release the database. Called only on an engine the connection opened. */\n close(): Promise<void>;\n /**\n * Open a transaction on its own session.\n *\n * Without it the connection issues `BEGIN`, `COMMIT` and `ROLLBACK` through `exec`.\n */\n transaction?(): Promise<Engine.Session>;\n /**\n * Run statements atomically.\n *\n * `sync` applies through it when present; a table rebuild then needs foreign keys off.\n */\n batch?(sql: string[]): Promise<void>;\n}\n\nexport declare namespace Engine {\n /** Statement methods an engine and a session share. Parameters are positional. */\n interface Statements {\n /** Run a statement, resolving every row. */\n all(sql: string, params?: any[]): Promise<any[]>;\n /** Run a statement, resolving the first row. */\n get(sql: string, params?: any[]): Promise<any>;\n /** Run a statement, resolving how many rows changed. */\n run(sql: string, params?: any[]): Promise<{ changes: number }>;\n /** Run one or more statements without parameters. */\n exec(sql: string): Promise<void>;\n }\n\n /** A transaction's own handle - statements inside `db.transaction(fn)` run on it. */\n interface Session extends Statements {\n commit(): Promise<void>;\n rollback(): Promise<void>;\n }\n}\n\nconst DRIVERS = [bunSqlite, nodeSqlite, betterSqlite3, sqlite3, libsql];\n\nexport async function createEngine(filename: string): Promise<Engine> {\n for (const load of DRIVERS) {\n const engine = await load(filename).catch(() => null);\n\n if (engine) {\n await engine.exec(\"PRAGMA foreign_keys = ON\");\n return engine;\n }\n }\n\n throw new Error(\n \"No compatible SQLite driver found. Run under Bun or Node >=24, \" +\n \"or install one of: better-sqlite3, sqlite3, @libsql/client.\"\n );\n}\n\nfunction optional(name: string): Promise<any> {\n return import(name);\n}\n\nasync function bunSqlite(file: string): Promise<Engine | null> {\n if (typeof (globalThis as any).Bun === \"undefined\")\n return null;\n\n const { Database } = await optional(\"bun:sqlite\");\n\n return syncEngine(new Database(file));\n}\n\nasync function nodeSqlite(file: string): Promise<Engine | null> {\n const { DatabaseSync } = await optional(\"node:sqlite\");\n\n return syncEngine(new DatabaseSync(file));\n}\n\nasync function betterSqlite3(file: string): Promise<Engine | null> {\n const { default: Database } = await optional(\"better-sqlite3\");\n\n return syncEngine(new Database(file));\n}\n\nasync function sqlite3(file: string): Promise<Engine | null> {\n const { default: { Database } } = await optional(\"sqlite3\");\n\n return asyncEngine(new Database(file));\n}\n\nasync function libsql(file: string): Promise<Engine | null> {\n const { createClient } = await optional(\"@libsql/client\");\n const url = file === \":memory:\" ? \":memory:\" : `file:${file}`;\n\n return libsqlEngine(createClient({ url }));\n}\n\nfunction syncEngine(db: any): Engine {\n return {\n async all(sql, params = []) {\n return db.prepare(sql).all(...params);\n },\n async get(sql, params = []) {\n return db.prepare(sql).get(...params);\n },\n async run(sql, params = []) {\n return { changes: db.prepare(sql).run(...params).changes };\n },\n async exec(sql) {\n db.exec(sql);\n },\n async close() {\n db.close();\n }\n };\n}\n\nfunction asyncEngine(db: any): Engine {\n const call = (method: string, sql: string, params: any[]) =>\n new Promise<any>((resolve, reject) => {\n db[method](sql, params, function (this: any, err: any, rows: any) {\n if (err) reject(err);\n else resolve(method === \"run\" ? this : rows);\n });\n });\n\n const done = (resolve: () => void, reject: (err: any) => void) =>\n (err: any) => err ? reject(err) : resolve();\n\n return {\n all: (sql, params = []) => call(\"all\", sql, params),\n get: (sql, params = []) => call(\"get\", sql, params),\n run: (sql, params = []) => call(\"run\", sql, params).then(ctx => ({ changes: ctx.changes })),\n exec: sql => new Promise((resolve, reject) => db.exec(sql, done(resolve, reject))),\n close: () => new Promise((resolve, reject) => db.close(done(resolve, reject)))\n };\n}\n\nfunction libsqlEngine(client: any): Engine {\n const execute = (sql: string, args: any[]) => client.execute({ sql, args });\n\n return {\n async all(sql, params = []) {\n return (await execute(sql, params)).rows;\n },\n async get(sql, params = []) {\n return (await execute(sql, params)).rows[0];\n },\n async run(sql, params = []) {\n return { changes: Number((await execute(sql, params)).rowsAffected) };\n },\n async exec(sql) {\n await client.executeMultiple(sql);\n },\n async close() {\n client.close();\n }\n };\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@expressive/sql",
3
- "version": "0.5.0",
3
+ "version": "0.6.0",
4
4
  "description": "Expressive ORM on SQL: entities, Query and an embedded SQLite store from one import.",
5
5
  "keywords": [
6
6
  "orm",
@@ -46,7 +46,8 @@
46
46
  "bin": "./dist/cli.js"
47
47
  },
48
48
  "files": [
49
- "dist"
49
+ "dist",
50
+ "skills"
50
51
  ],
51
52
  "scripts": {
52
53
  "build": "tsdown",
@@ -55,11 +56,11 @@
55
56
  "test": "bun run typecheck && bun run coverage"
56
57
  },
57
58
  "dependencies": {
58
- "@expressive/orm": "^0.13.0",
59
+ "@expressive/orm": "^0.14.0",
59
60
  "sql-formatter": "^10.7.2"
60
61
  },
61
62
  "devDependencies": {
62
- "@expressive/mvc": "^0.94.0",
63
+ "@expressive/mvc": "^0.94.2",
63
64
  "tsdown": "^0.20.1"
64
65
  },
65
66
  "peerDependencies": {
@@ -0,0 +1,136 @@
1
+ ---
2
+ name: expressive-sql
3
+ description: Expressive ORM on SQL (@expressive/sql) - SQLiteConnection with a built-in or custom Engine, sync and plan, the expressive sql CLI, the sql.* datatype vocabulary and validation, and the SQL Connection and Generator base for dialects. Use when connecting entities to SQLite, choosing column datatypes, syncing or checking a schema, plugging in a SQLite host, or writing a SQL driver.
4
+ ---
5
+
6
+ # @expressive/sql
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`.
9
+
10
+ ```bash
11
+ npm install @expressive/sql @expressive/mvc
12
+ ```
13
+
14
+ SQLite is built into Bun (`bun:sqlite`) and Node 24 (`node:sqlite`). Elsewhere add one of `better-sqlite3`, `sqlite3` or `@libsql/client`; the first found is used. For Postgres and live rows install `@expressive/postgres` (skill `expressive-postgres`), which re-exports this package.
15
+
16
+ ## Connect
17
+
18
+ ```ts
19
+ import { SQLiteConnection, Type, str } from '@expressive/sql';
20
+
21
+ class User extends Type {
22
+ name = str();
23
+ }
24
+
25
+ const db = await SQLiteConnection.new([User], "app.db"); // omit the filename for in-memory
26
+
27
+ await db.close();
28
+ ```
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.
33
+
34
+ ### Engine
35
+
36
+ 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
+
38
+ ```ts
39
+ import type { Engine } from '@expressive/sql';
40
+
41
+ const engine: Engine = {
42
+ all: (sql, params) => ..., // rows
43
+ get: (sql, params) => ..., // first row
44
+ run: (sql, params) => ..., // { changes }
45
+ exec: (sql) => ...,
46
+ close: () => ...,
47
+ };
48
+
49
+ const db = await SQLiteConnection.new([User], engine);
50
+ ```
51
+
52
+ A given engine is used as is - turn on foreign keys yourself where the host doesn't - and `close()` leaves it open.
53
+
54
+ Two optional members, for hosts without `BEGIN` and `COMMIT` on one connection:
55
+
56
+ - `transaction()` - resolves a session, the four statements plus `commit()` and `rollback()`. Every statement inside `db.transaction(fn)` runs on it.
57
+ - `batch(sql: string[])` - runs statements atomically; `sync` applies through it. A table rebuild in a batch needs foreign keys off, or dropping the old table cascades; an engine that keeps them on refuses it.
58
+
59
+ ## Sync
60
+
61
+ Awaiting a connection runs `sync`:
62
+
63
+ - Missing tables are created, missing columns and indexes added, existing ones checked against the classes.
64
+ - A new column reads `undefined` or its `fallback` on old rows. One that cannot fill existing rows - primary, `UNIQUE`, `NOT NULL` without a `fallback` or defaulting to now - is reported and nothing changes. A nullable column defaulting to now is added without the default; inserts fill it.
65
+ - Type and nullability drift is reported. `sync(true, true)` rebuilds the table, refusing while a row would not fit or a value would not convert. A rebuild keeps columns not on the class, indexes and triggers, but not UNIQUE or REFERENCES on columns the class doesn't declare, and refuses while any row references a missing one.
66
+ - `static schema` is reported - SQLite has none.
67
+ - A relation column missing while `<table>_id` exists is reported, not added - set `{ column: "<table>_id" }` to keep the old one.
68
+ - `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.
69
+
70
+ ### Command line
71
+
72
+ ```sh
73
+ expressive sql check src/db.ts # list what sync would change; exit 1 if anything would
74
+ expressive sql sync src/db.ts # create missing tables, columns and indexes
75
+ expressive sql sync --force src/db.ts # also rebuild drifted columns
76
+ ```
77
+
78
+ 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+.
79
+
80
+ ## Datatypes
81
+
82
+ `sql.*` picks a column's type; a factory takes its size. A config is portable - the same class syncs on SQLite and Postgres.
83
+
84
+ | Helper | `sql.*` | SQLite |
85
+ |---|---|---|
86
+ | `str` | `text` (default), `varchar(n)`, `char(n)`, `uuid` | TEXT |
87
+ | `num` | `integer` (default), `smallint`, `bigint`, `real`, `float`, `double`, `numeric(p, s)`, `decimal(p, s)` | INTEGER, REAL, NUMERIC |
88
+ | `bool` | `boolean` (default), `integer` (1/0), `text` / `varchar(n)` with `either` | INTEGER, TEXT |
89
+ | `date` | `timestamp` (default), `date`, `time`, `ms` (epoch ms), `seconds` or `integer` (epoch s), `text` | TEXT, INTEGER |
90
+ | `one` | `integer` (default), `bigint` | INTEGER |
91
+
92
+ ```ts
93
+ import { Type, bool, date, key, num, sql, str } from '@expressive/sql';
94
+
95
+ class Product extends Type {
96
+ id = key(sql.uuid); // UUIDv7 on insert
97
+ code = str(sql.char(3));
98
+ price = num(sql.numeric(10, 2));
99
+ listed = bool(sql.text, { either: ["yes", "no"] });
100
+ seen = date(sql.ms, null);
101
+ edited = date.updated(sql.ms);
102
+ }
103
+ ```
104
+
105
+ - `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.
106
+ - A datatype of another helper, like `num(sql.text)`, is a type error.
107
+ - Options a factory doesn't take go in an object - `date({ type: "timestamp", precision: 3 })`.
108
+ - `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.
109
+ - Writes are validated - `varchar` and `char` length, integer ranges, `numeric` precision and scale. Importing `@expressive/sql` turns this on for every connection, `memory()` included.
110
+
111
+ Add a datatype by augmenting the helper's `Types`:
112
+
113
+ ```ts
114
+ import { StringColumn, Type, str } from '@expressive/sql';
115
+
116
+ declare module '@expressive/orm' {
117
+ namespace str {
118
+ interface Inet extends StringColumn { type: "inet" }
119
+ interface Types { inet: Inet }
120
+ }
121
+ }
122
+
123
+ class Device extends Type {
124
+ address = str({ type: "inet" });
125
+ }
126
+ ```
127
+
128
+ `StringColumn`, `NumericColumn`, `BooleanColumn`, `TimeColumn`, `ForeignColumn` are the column classes behind `str`, `num`, `bool`, `date` and `one`.
129
+
130
+ ## SQL drivers
131
+
132
+ `Connection` from `@expressive/sql` implements orm's floor over `Query`. A dialect extends it and supplies `schema`, `prepare(builder)` (rendering with a `Generator` subclass), `sync(fix?, force?)` and `plan(force?)`; a protected `transact(fn)` enables `transaction(fn)`.
133
+
134
+ `Generator` renders a `Query` builder as SQL; `String(generator)` is the statement. A dialect overrides its protected hooks - `literal`, `insertWith`, `table`, `now` and `param` among them, each documented on `Generator`.
135
+
136
+ The builder and its values - `Builder`, `DataTable`, `DataField`, `Parameter`, `Computed`, `QueryTemplate`, `Where` - import from `@expressive/orm/driver`, not `@expressive/sql`. A dialect package therefore lists `@expressive/orm` as a direct dependency, at the range `@expressive/sql` depends on.