@forinda/kickjs-db 7.4.0 → 8.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -45
- package/dist/cli.d.mts +16 -2
- package/dist/cli.d.mts.map +1 -1
- package/dist/cli.mjs +4 -3
- package/dist/cli.mjs.map +1 -1
- package/dist/create-CwuC1odW.mjs +29 -0
- package/dist/create-CwuC1odW.mjs.map +1 -0
- package/dist/custom-type-DeGuRFuz.mjs +12 -0
- package/dist/custom-type-DeGuRFuz.mjs.map +1 -0
- package/dist/devtools-events.d.mts +1 -1
- package/dist/devtools-events.mjs +1 -1
- package/dist/{index-DF69HndC.d.mts → index-2fEnHqpn.d.mts} +814 -156
- package/dist/index-2fEnHqpn.d.mts.map +1 -0
- package/dist/index.d.mts +6 -4
- package/dist/index.mjs +2 -2
- package/dist/mysql.d.mts +41 -37
- package/dist/mysql.d.mts.map +1 -1
- package/dist/mysql.mjs +8 -8
- package/dist/mysql.mjs.map +1 -1
- package/dist/pg-CsmRByEZ.mjs +12 -0
- package/dist/pg-CsmRByEZ.mjs.map +1 -0
- package/dist/pg.d.mts +74 -8
- package/dist/pg.d.mts.map +1 -1
- package/dist/pg.mjs +8 -7
- package/dist/pg.mjs.map +1 -1
- package/dist/schema-BjGAg-s1.d.mts +95 -0
- package/dist/schema-BjGAg-s1.d.mts.map +1 -0
- package/dist/schema-types-DH-d43Pf.d.mts +51 -0
- package/dist/schema-types-DH-d43Pf.d.mts.map +1 -0
- package/dist/schema.d.mts +2 -87
- package/dist/schema.mjs +2 -2
- package/dist/schema.mjs.map +1 -1
- package/dist/split-statements-BPCw9cII.mjs +14 -0
- package/dist/split-statements-BPCw9cII.mjs.map +1 -0
- package/dist/sqlite.d.mts +86 -6
- package/dist/sqlite.d.mts.map +1 -1
- package/dist/sqlite.mjs +13 -7
- package/dist/sqlite.mjs.map +1 -1
- package/dist/src-DUtVGG2c.mjs +199 -0
- package/dist/src-DUtVGG2c.mjs.map +1 -0
- package/dist/table-CGPsm5i7.d.mts +221 -0
- package/dist/table-CGPsm5i7.d.mts.map +1 -0
- package/dist/testing.d.mts +53 -0
- package/dist/testing.d.mts.map +1 -0
- package/dist/testing.mjs +12 -0
- package/dist/testing.mjs.map +1 -0
- package/dist/{types-DtvYnaXL.d.mts → types-BZoTujcR.d.mts} +346 -9
- package/dist/types-BZoTujcR.d.mts.map +1 -0
- package/dist/{table-Bl5SbKRg.d.mts → types-DNAKmwPO.d.mts} +186 -64
- package/dist/types-DNAKmwPO.d.mts.map +1 -0
- package/package.json +14 -4
- package/dist/custom-type-j8k__3sL.mjs +0 -12
- package/dist/custom-type-j8k__3sL.mjs.map +0 -1
- package/dist/index-DF69HndC.d.mts.map +0 -1
- package/dist/pg-BJmYKLhI.mjs +0 -12
- package/dist/pg-BJmYKLhI.mjs.map +0 -1
- package/dist/schema.d.mts.map +0 -1
- package/dist/src-BnHTLx5l.mjs +0 -166
- package/dist/src-BnHTLx5l.mjs.map +0 -1
- package/dist/table-Bl5SbKRg.d.mts.map +0 -1
- package/dist/types-DtvYnaXL.d.mts.map +0 -1
package/dist/sqlite.d.mts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
|
|
2
|
-
import {
|
|
3
|
-
import { Dialect } from "kysely";
|
|
2
|
+
import { Ti as MigrationAdapter } from "./index-2fEnHqpn.mjs";
|
|
3
|
+
import { Dialect, Kysely } from "kysely";
|
|
4
4
|
//#region src/adapters/sqlite/adapter.d.ts
|
|
5
5
|
/**
|
|
6
6
|
* better-sqlite3-shaped database handle that `sqliteAdapter` consumes.
|
|
@@ -32,6 +32,11 @@ export interface SqliteDatabaseLike {
|
|
|
32
32
|
close(): unknown;
|
|
33
33
|
}
|
|
34
34
|
export interface SqliteAdapterOptions {
|
|
35
|
+
/**
|
|
36
|
+
* The table migrations are recorded in. Default `kick_migrations`; its lock
|
|
37
|
+
* table is the same name plus `_lock`.
|
|
38
|
+
*/
|
|
39
|
+
migrationsTable?: string;
|
|
35
40
|
/**
|
|
36
41
|
* better-sqlite3 (or compatible) Database handle. Caller-owned —
|
|
37
42
|
* the adapter's `close()` does NOT close the database because
|
|
@@ -58,10 +63,8 @@ export declare function sqliteAdapter(opts: SqliteAdapterOptions): MigrationAdap
|
|
|
58
63
|
//#region src/adapters/sqlite/dialect.d.ts
|
|
59
64
|
export interface SqliteDialectOptions {
|
|
60
65
|
/**
|
|
61
|
-
* better-sqlite3
|
|
62
|
-
*
|
|
63
|
-
* structurally (Bun is best-effort — same `.prepare()` shape, no
|
|
64
|
-
* version assertion).
|
|
66
|
+
* A better-sqlite3 `Database`, or a `bun:sqlite` `Database` (tested in
|
|
67
|
+
* CI's Bun job).
|
|
65
68
|
*/
|
|
66
69
|
database: SqliteDatabaseLike;
|
|
67
70
|
}
|
|
@@ -86,4 +89,81 @@ export interface SqliteDialectOptions {
|
|
|
86
89
|
*/
|
|
87
90
|
export declare function sqliteDialect(opts: SqliteDialectOptions): Dialect;
|
|
88
91
|
//#endregion
|
|
92
|
+
//#region src/adapters/sqlite/async-adapter.d.ts
|
|
93
|
+
/** One statement and its parameters. */
|
|
94
|
+
export interface SqliteStatementInput {
|
|
95
|
+
sql: string;
|
|
96
|
+
params?: readonly unknown[];
|
|
97
|
+
}
|
|
98
|
+
/**
|
|
99
|
+
* The two things an async SQLite driver (libsql/Turso, Cloudflare D1) has to
|
|
100
|
+
* offer for migrations. Wrap your client with {@link libsqlDriver} or
|
|
101
|
+
* {@link d1Driver}, or implement it for another driver.
|
|
102
|
+
*/
|
|
103
|
+
export interface AsyncSqliteDriver {
|
|
104
|
+
/** Run one statement and resolve with its rows (empty for a write). */
|
|
105
|
+
query(sql: string, params?: readonly unknown[]): Promise<unknown[]>;
|
|
106
|
+
/** Run statements atomically, in order: all of them apply, or none. */
|
|
107
|
+
batch(statements: readonly SqliteStatementInput[]): Promise<void>;
|
|
108
|
+
}
|
|
109
|
+
export interface AsyncSqliteAdapterOptions {
|
|
110
|
+
driver: AsyncSqliteDriver;
|
|
111
|
+
/**
|
|
112
|
+
* A Kysely instance on the same database, for migrations written in
|
|
113
|
+
* TypeScript (`migration.ts`). Without it, only SQL migrations run.
|
|
114
|
+
*/
|
|
115
|
+
kysely?: Kysely<any>;
|
|
116
|
+
/**
|
|
117
|
+
* The table migrations are recorded in. Default `kick_migrations`; its lock
|
|
118
|
+
* table is the same name plus `_lock`.
|
|
119
|
+
*/
|
|
120
|
+
migrationsTable?: string;
|
|
121
|
+
/**
|
|
122
|
+
* Called by `close()`, so a client opened for `kick db` can end when the
|
|
123
|
+
* command finishes: `close: () => client.close()`. The client is otherwise
|
|
124
|
+
* the caller's.
|
|
125
|
+
*/
|
|
126
|
+
close?: () => unknown;
|
|
127
|
+
}
|
|
128
|
+
/**
|
|
129
|
+
* Migrations on an async SQLite driver: libsql/Turso, Cloudflare D1, or any
|
|
130
|
+
* driver that can run a statement and an atomic batch.
|
|
131
|
+
*
|
|
132
|
+
* Each migration is applied as one batch: its statements, then its
|
|
133
|
+
* `kick_migrations` row, then — when it rebuilt a table — a statement that
|
|
134
|
+
* fails if a foreign key now points at a missing row. A failure anywhere
|
|
135
|
+
* rolls the whole batch back. The batch replaces `BEGIN`/`COMMIT`, which D1
|
|
136
|
+
* doesn't allow, so `meta.transaction: false` migrations run statement by
|
|
137
|
+
* statement instead.
|
|
138
|
+
*/
|
|
139
|
+
export declare function asyncSqliteAdapter(opts: AsyncSqliteAdapterOptions): MigrationAdapter;
|
|
140
|
+
/** The part of `@libsql/client`'s `Client` that {@link libsqlDriver} uses. */
|
|
141
|
+
export interface LibsqlClientLike {
|
|
142
|
+
execute(stmt: {
|
|
143
|
+
sql: string;
|
|
144
|
+
args: any[];
|
|
145
|
+
}): Promise<{
|
|
146
|
+
rows: ArrayLike<unknown>;
|
|
147
|
+
}>;
|
|
148
|
+
batch(stmts: Array<{
|
|
149
|
+
sql: string;
|
|
150
|
+
args: any[];
|
|
151
|
+
}>, mode?: 'write' | 'read' | 'deferred'): Promise<unknown>;
|
|
152
|
+
}
|
|
153
|
+
/** {@link AsyncSqliteDriver} over a libsql/Turso client (`@libsql/client`). */
|
|
154
|
+
export declare function libsqlDriver(client: LibsqlClientLike): AsyncSqliteDriver;
|
|
155
|
+
/** The part of Cloudflare D1's `D1Database` that {@link d1Driver} uses. */
|
|
156
|
+
export interface D1DatabaseLike {
|
|
157
|
+
prepare(sql: string): D1StatementLike;
|
|
158
|
+
batch(statements: D1StatementLike[]): Promise<unknown>;
|
|
159
|
+
}
|
|
160
|
+
export interface D1StatementLike {
|
|
161
|
+
bind(...values: unknown[]): D1StatementLike;
|
|
162
|
+
all(): Promise<{
|
|
163
|
+
results?: unknown[];
|
|
164
|
+
}>;
|
|
165
|
+
}
|
|
166
|
+
/** {@link AsyncSqliteDriver} over a Cloudflare D1 binding. */
|
|
167
|
+
export declare function d1Driver(db: D1DatabaseLike): AsyncSqliteDriver;
|
|
168
|
+
//#endregion
|
|
89
169
|
//# sourceMappingURL=sqlite.d.mts.map
|
package/dist/sqlite.d.mts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sqlite.d.mts","names":[],"sources":["../src/adapters/sqlite/adapter.ts","../src/adapters/sqlite/dialect.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"sqlite.d.mts","names":[],"sources":["../src/adapters/sqlite/adapter.ts","../src/adapters/sqlite/dialect.ts","../src/adapters/sqlite/async-adapter.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;iBAgCiB;EACf,OAAO;IAA+B;IAAiB;;EACvD,OAAO;EACP,OAAO;;iBAGQ;EACf,QAAQ,cAAc;EACtB,KAAK;EACL;;iBAGe;;;;;EAKf;;;;;;;EAOA,UAAU;;;;;;;;;;;;;;;wBAgBI,cAAc,MAAM,uBAAuB;;;iBC9D1C;;;;;EAKf,UAAU;;;;;;;;;;;;;;;;;;;;;wBAsBI,cAAc,MAAM,uBAAuB;;;;iBCpB1C;EACf;EACA;;;;;;;iBAQe;;EAEf,MAAM,aAAa,8BAA8B;;EAEjD,MAAM,qBAAqB,yBAAyB;;iBAGrC;EACf,QAAQ;;;;;EAKR,SAAS;;;;;EAKT;;;;;;EAMA;;;;;;;;;;;;;wBAcc,mBAAmB,MAAM,4BAA4B;;iBAmJpD;EACf,QAAQ;IAAQ;IAAa;MAAgB;IAAU,MAAM;;EAC7D,MACE,OAAO;IAAQ;IAAa;MAC5B,uCACC;;;wBAIW,aAAa,QAAQ,mBAAmB;;iBAgBvC;EACf,QAAQ,cAAc;EACtB,MAAM,YAAY,oBAAoB;;iBAGvB;EACf,QAAQ,oBAAoB;EAC5B,OAAO;IAAU;;;;wBAIH,SAAS,IAAI,iBAAiB"}
|
package/dist/sqlite.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-db
|
|
2
|
+
* @forinda/kickjs-db v8.1.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,12 +8,18 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{
|
|
12
|
-
FROM
|
|
13
|
-
ORDER BY applied_at ASC, id ASC`).all().map(row=>({id:row.id,name:row.name,hash:row.hash,batch:Number(row.batch),appliedAt:row.applied_at,direction:row.direction}))},async recordApplied(row){database.prepare(`INSERT INTO
|
|
14
|
-
VALUES (?, ?, ?, ?, ?)`).run(row.id,row.name,row.hash,row.batch,row.direction)},async removeApplied(id){database.prepare(`DELETE FROM
|
|
11
|
+
import{a as markDialect}from"./create-CwuC1odW.mjs";import{Et as introspectSqliteAsync,Mt as lockTableName,Nt as migrationsTableDdl,Pt as quoteTable,Tt as introspectSqlite,jt as lockTableDdl}from"./src-DUtVGG2c.mjs";import{t as splitSqlStatements}from"./split-statements-BPCw9cII.mjs";import{Kysely,SqliteDialect}from"kysely";function sqliteDialect(opts){return markDialect(new SqliteDialect({database:readerDatabase(opts.database)}),`sqlite`)}function readerDatabase(database){return{close:()=>database.close(),prepare(sql){let stmt=database.prepare(sql);return typeof stmt.reader==`boolean`?stmt:{reader:(stmt.columnNames?.length??0)>0,all:params=>stmt.all(...params),run:params=>stmt.run(...params),iterate:params=>stmt.iterate?stmt.iterate(...params):stmt.all(...params)[Symbol.iterator]()}}}}function sqliteAdapter(opts){let dialect=`sqlite`,{database}=opts,runBatch=sql=>database.exec(sql),table=opts.migrationsTable??`kick_migrations`,T=quoteTable(dialect,table),L=quoteTable(dialect,lockTableName(table)),bookkeepingTables=[table,lockTableName(table)],migrationDb;return{dialect,async ensureMigrationTables(){runBatch(migrationsTableDdl(dialect,table)),runBatch(lockTableDdl(dialect,table))},async listApplied(){return database.prepare(`SELECT id, name, hash, batch, applied_at, direction
|
|
12
|
+
FROM ${T}
|
|
13
|
+
ORDER BY applied_at ASC, id ASC`).all().map(row=>({id:row.id,name:row.name,hash:row.hash,batch:Number(row.batch),appliedAt:row.applied_at,direction:row.direction}))},async recordApplied(row){database.prepare(`INSERT INTO ${T} (id, name, hash, batch, direction)
|
|
14
|
+
VALUES (?, ?, ?, ?, ?)`).run(row.id,row.name,row.hash,row.batch,row.direction)},async removeApplied(id){database.prepare(`DELETE FROM ${T} WHERE id = ?`).run(id)},async acquireLock(owner){return database.prepare(`UPDATE ${L}
|
|
15
15
|
SET locked_at = datetime('now'), locked_by = ?
|
|
16
|
-
WHERE id = 1 AND locked_at IS NULL`).run(owner).changes===1},async releaseLock(){database.prepare(`UPDATE
|
|
16
|
+
WHERE id = 1 AND locked_at IS NULL`).run(owner).changes===1},async releaseLock(){database.prepare(`UPDATE ${L}
|
|
17
17
|
SET locked_at = NULL, locked_by = NULL
|
|
18
|
-
WHERE id = 1`).run()},async applySqlInTx(sql){
|
|
18
|
+
WHERE id = 1`).run()},async applySqlInTx(sql){await this.applyMigrationInTx(sql,null)},async applyMigrationInTx(sql,bookkeeping){runBatch(`BEGIN`);try{if(runBatch(sql),bookkeeping&&`record`in bookkeeping){let r=bookkeeping.record;database.prepare(`INSERT INTO ${T} (id, name, hash, batch, direction)
|
|
19
|
+
VALUES (?, ?, ?, ?, ?)`).run(r.id,r.name,r.hash,r.batch,r.direction)}else bookkeeping&&database.prepare(`DELETE FROM ${T} WHERE id = ?`).run(bookkeeping.remove);let rebuilt=new Set([...sql.matchAll(/ALTER TABLE "_kick_new_((?:[^"]|"")+)" RENAME TO/g)].map(m=>m[1].replace(/""/g,`"`)));if(rebuilt.size>0){let broken=database.prepare(`PRAGMA foreign_key_check`).all().filter(r=>rebuilt.has(r.table)||rebuilt.has(r.parent));if(broken.length>0){let where=[...new Set(broken.map(r=>`${r.table} → ${r.parent}`))].join(`, `);throw Error(`kickjs-db: the migration left ${broken.length} row(s) whose foreign key points at a missing row (${where}); rolled back. Fix the data, then migrate again.`)}}runBatch(`COMMIT`)}catch(err){try{runBatch(`ROLLBACK`)}catch{}throw err}},async applySqlNoTx(sql){runBatch(sql)},async introspect(){return introspectSqlite(database,{excludeTables:bookkeepingTables})},migrationsTable:table,kysely(){return migrationDb??=new Kysely({dialect:sqliteDialect({database})})},async close(){}}}function asyncSqliteAdapter(opts){let dialect=`sqlite`,{driver}=opts,table=opts.migrationsTable??`kick_migrations`,T=quoteTable(dialect,table),L=quoteTable(dialect,lockTableName(table)),bookkeepingTables=[table,lockTableName(table)],statements=sql=>splitSqlStatements(sql,`sqlite`).map(s=>({sql:s})),insertRow=r=>({sql:`INSERT INTO ${T} (id, name, hash, batch, direction) VALUES (?, ?, ?, ?, ?)`,params:[r.id,r.name,r.hash,r.batch,r.direction]}),deleteRow=id=>({sql:`DELETE FROM ${T} WHERE id = ?`,params:[id]});return{dialect,async ensureMigrationTables(){await driver.batch([...statements(migrationsTableDdl(dialect,table)),...statements(lockTableDdl(dialect,table))])},async listApplied(){return(await driver.query(`SELECT id, name, hash, batch, applied_at, direction FROM ${T}
|
|
20
|
+
ORDER BY applied_at ASC, id ASC`)).map(row=>({id:row.id,name:row.name,hash:row.hash,batch:Number(row.batch),appliedAt:row.applied_at,direction:row.direction}))},async recordApplied(row){let s=insertRow(row);await driver.query(s.sql,s.params)},async removeApplied(id){let s=deleteRow(id);await driver.query(s.sql,s.params)},async acquireLock(owner){return(await driver.query(`UPDATE ${L} SET locked_at = datetime('now'), locked_by = ?
|
|
21
|
+
WHERE id = 1 AND locked_at IS NULL RETURNING id`,[owner])).length===1},async releaseLock(){await driver.query(`UPDATE ${L} SET locked_at = NULL, locked_by = NULL WHERE id = 1`)},async applySqlInTx(sql){await this.applyMigrationInTx(sql,null)},async applyMigrationInTx(sql,bookkeeping){let batch=statements(sql);bookkeeping&&`record`in bookkeeping?batch.push(insertRow(bookkeeping.record)):bookkeeping&&batch.push(deleteRow(bookkeeping.remove));let guard=foreignKeyGuard(sql);if(guard&&batch.push(guard),batch.length!==0)try{await driver.batch(batch)}catch(err){throw guard&&/malformed JSON/i.test(String(err?.message))?Error(`kickjs-db: the migration left rows whose foreign key points at a missing row; rolled back. Fix the data, then migrate again.`,{cause:err}):err}},async applySqlNoTx(sql){for(let s of statements(sql))await driver.query(s.sql)},async introspect(){return introspectSqliteAsync((sql,params)=>driver.query(sql,params),{excludeTables:bookkeepingTables})},migrationsTable:table,...opts.kysely?{kysely:()=>opts.kysely}:{},async close(){await opts.close?.()}}}function foreignKeyGuard(sql){let rebuilt=[...new Set([...sql.matchAll(/ALTER TABLE "_kick_new_((?:[^"]|"")+)" RENAME TO/g)].map(m=>m[1].replace(/""/g,`"`)))];if(rebuilt.length===0)return;let marks=rebuilt.map(()=>`?`).join(`, `);return{sql:`SELECT CASE WHEN EXISTS (
|
|
22
|
+
SELECT 1 FROM pragma_foreign_key_check
|
|
23
|
+
WHERE "table" IN (${marks}) OR "parent" IN (${marks})
|
|
24
|
+
) THEN json('not json') END`,params:[...rebuilt,...rebuilt]}}function libsqlDriver(client){return{async query(sql,params=[]){let result=await client.execute({sql,args:[...params]});return Array.from(result.rows)},async batch(statements){await client.batch(statements.map(s=>({sql:s.sql,args:[...s.params??[]]})),`write`)}}}function d1Driver(db){let prepare=(sql,params=[])=>params.length>0?db.prepare(sql).bind(...params):db.prepare(sql);return{async query(sql,params){return(await prepare(sql,params).all()).results??[]},async batch(statements){await db.batch(statements.map(s=>prepare(s.sql,s.params)))}}}export{asyncSqliteAdapter,d1Driver,libsqlDriver,sqliteAdapter,sqliteDialect};
|
|
19
25
|
//# sourceMappingURL=sqlite.mjs.map
|
package/dist/sqlite.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sqlite.mjs","names":[],"sources":["../src/adapters/sqlite/adapter.ts","../src/adapters/sqlite/dialect.ts"],"sourcesContent":["import {\n lockTableDdl,\n migrationsTableDdl,\n type Dialect,\n type MigrationAdapter,\n type MigrationRow,\n type SchemaSnapshot,\n} from '../../index'\nimport { introspectSqlite } from '../../migrate/introspect-sqlite'\n\n/**\n * better-sqlite3-shaped database handle that `sqliteAdapter` consumes.\n * Mirrors the methods we actually use; both `new Database(...)` from\n * `better-sqlite3` and bun's `bun:sqlite` Database match structurally.\n *\n * better-sqlite3's API is synchronous — we wrap everything in `async`\n * to match the `MigrationAdapter` contract. No I/O actually awaits;\n * the wrapping is for shape compatibility.\n */\n/**\n * `all` / `get` are deliberately NOT method-generic: better-sqlite3\n * v12's own `Statement` methods are non-generic, so generic signatures\n * here would make a real `Database` instance structurally incompatible\n * (callers had to cast — same fix as `SqliteIntrospectDb`). Row typing\n * happens at the call sites via assertions instead.\n */\nexport interface SqliteStatement {\n run(...params: readonly unknown[]): { changes: number; lastInsertRowid: number | bigint }\n all(...params: readonly unknown[]): unknown[]\n get(...params: readonly unknown[]): unknown\n}\n\nexport interface SqliteDatabaseLike {\n prepare(sql: string): SqliteStatement\n exec(sql: string): unknown\n close(): unknown\n}\n\nexport interface SqliteAdapterOptions {\n /**\n * better-sqlite3 (or compatible) Database handle. Caller-owned —\n * the adapter's `close()` does NOT close the database because\n * adopters typically share a single handle across the migration\n * adapter and the KickDbClient.\n */\n database: SqliteDatabaseLike\n}\n\n/**\n * MigrationAdapter implementation backed by better-sqlite3.\n *\n * Lock semantics: single-row UPDATE WHERE locked_at IS NULL on\n * `kick_migrations_lock`. Only the row created by `ensureMigrationTables()`\n * exists, so the UPDATE either flips `locked_at` and returns\n * `changes=1` (we won) or matches zero rows (someone else holds it).\n *\n * Introspection: `introspect()` walks `sqlite_master` + `PRAGMA` via\n * {@link introspectSqlite}. Types come back as SQLite affinities (lossy\n * vs the code-first DSL), so it powers `kick db introspect` rather than\n * byte-exact drift detection.\n */\nexport function sqliteAdapter(opts: SqliteAdapterOptions): MigrationAdapter {\n const dialect: Dialect = 'sqlite'\n const { database } = opts\n\n // Multi-statement DDL runs through better-sqlite3's exec() (it\n // handles `;`-separated batches natively).\n const runBatch = (sql: string) => database.exec(sql)\n\n return {\n dialect,\n\n async ensureMigrationTables() {\n runBatch(migrationsTableDdl(dialect))\n runBatch(lockTableDdl(dialect))\n },\n\n async listApplied(): Promise<MigrationRow[]> {\n const rows = database\n .prepare(\n `SELECT id, name, hash, batch, applied_at, direction\n FROM kick_migrations\n ORDER BY applied_at ASC, id ASC`,\n )\n .all() as {\n id: string\n name: string\n hash: string\n batch: number\n applied_at: string\n direction: 'up' | 'down'\n }[]\n return rows.map((row) => ({\n id: row.id,\n name: row.name,\n hash: row.hash,\n batch: Number(row.batch),\n appliedAt: row.applied_at,\n direction: row.direction,\n }))\n },\n\n async recordApplied(row) {\n database\n .prepare(\n `INSERT INTO kick_migrations (id, name, hash, batch, direction)\n VALUES (?, ?, ?, ?, ?)`,\n )\n .run(row.id, row.name, row.hash, row.batch, row.direction)\n },\n\n async removeApplied(id: string) {\n database.prepare(`DELETE FROM kick_migrations WHERE id = ?`).run(id)\n },\n\n async acquireLock(owner: string): Promise<boolean> {\n const r = database\n .prepare(\n `UPDATE kick_migrations_lock\n SET locked_at = datetime('now'), locked_by = ?\n WHERE id = 1 AND locked_at IS NULL`,\n )\n .run(owner)\n return r.changes === 1\n },\n\n async releaseLock() {\n database\n .prepare(\n `UPDATE kick_migrations_lock\n SET locked_at = NULL, locked_by = NULL\n WHERE id = 1`,\n )\n .run()\n },\n\n async applySqlInTx(sql: string) {\n // BEGIN / COMMIT around a multi-statement batch gives us\n // atomicity. SQLite rolls back to pre-BEGIN on any error\n // inside the block.\n runBatch('BEGIN')\n try {\n runBatch(sql)\n runBatch('COMMIT')\n } catch (err) {\n try {\n runBatch('ROLLBACK')\n } catch {\n // Swallow rollback errors; we're already throwing the original.\n }\n throw err\n }\n },\n\n async applySqlNoTx(sql: string) {\n runBatch(sql)\n },\n\n async introspect(): Promise<SchemaSnapshot> {\n // Reverse-engineer the live schema via sqlite_master + PRAGMA walks.\n // Types come back as SQLite affinities (a code-first `uuid()` reads as\n // `text`), so this powers `kick db introspect`; byte-exact drift\n // against a code-first snapshot needs a dialect-normalised compare.\n return introspectSqlite(database)\n },\n\n async close() {\n // Caller owns the database handle. The adapter doesn't close\n // it — adopters typically share the same handle with the\n // KickDbClient.\n },\n }\n}\n","// sqliteDialect — thin factory over Kysely's SqliteDialect so adopters\n// never have to reach for `import { SqliteDialect } from 'kysely'`.\n// Mirrors the `@forinda/kickjs-db/pg` template; the kysely subpackage\n// is a pinned internal dep of the framework.\n\nimport { SqliteDialect, type Dialect as KyselyDialect } from 'kysely'\n\nimport { markDialect } from '../../dialect-marker'\nimport type { SqliteDatabaseLike } from './adapter'\n\nexport interface SqliteDialectOptions {\n /**\n * better-sqlite3-compatible database handle. Both `new Database(...)`\n * from `better-sqlite3` and bun's `bun:sqlite` `Database` match\n * structurally (Bun is best-effort — same `.prepare()` shape, no\n * version assertion).\n */\n database: SqliteDatabaseLike\n}\n\n/**\n * Construct the dialect that `createDbClient({ dialect })` consumes.\n *\n * @example\n * ```ts\n * import { createDbClient } from '@forinda/kickjs-db'\n * import { sqliteDialect, sqliteAdapter } from '@forinda/kickjs-db/sqlite'\n * import Database from 'better-sqlite3'\n *\n * const database = new Database(':memory:')\n *\n * export const db = createDbClient({\n * schema,\n * dialect: sqliteDialect({ database }),\n * })\n *\n * export const migrationAdapter = sqliteAdapter({ database })\n * ```\n */\nexport function sqliteDialect(opts: SqliteDialectOptions): KyselyDialect {\n return markDialect(new SqliteDialect({ database: opts.database as never }), 'sqlite')\n}\n"],"mappings":";;;;;;;;;;sJA6DA,SAAgB,cAAc,KAA8C,CAC1E,IAAM,QAAmB,SACnB,CAAE,UAAa,KAIf,SAAY,KAAgB,SAAS,KAAK,GAAG,EAEnD,MAAO,CACL,QAEA,MAAM,uBAAwB,CAC5B,SAAS,mBAAmB,OAAO,CAAC,EACpC,SAAS,aAAa,OAAO,CAAC,CAChC,EAEA,MAAM,aAAuC,CAe3C,OAda,SACV,QACC;;2CAGF,CAAC,CACA,IAQO,CAAC,CAAC,IAAK,MAAS,CACxB,GAAI,IAAI,GACR,KAAM,IAAI,KACV,KAAM,IAAI,KACV,MAAO,OAAO,IAAI,KAAK,EACvB,UAAW,IAAI,WACf,UAAW,IAAI,SACjB,EAAE,CACJ,EAEA,MAAM,cAAc,IAAK,CACvB,SACG,QACC;kCAEF,CAAC,CACA,IAAI,IAAI,GAAI,IAAI,KAAM,IAAI,KAAM,IAAI,MAAO,IAAI,SAAS,CAC7D,EAEA,MAAM,cAAc,GAAY,CAC9B,SAAS,QAAQ,0CAA0C,CAAC,CAAC,IAAI,EAAE,CACrE,EAEA,MAAM,YAAY,MAAiC,CAQjD,OAPU,SACP,QACC;;8CAGF,CAAC,CACA,IAAI,KACA,CAAC,CAAC,UAAY,CACvB,EAEA,MAAM,aAAc,CAClB,SACG,QACC;;wBAGF,CAAC,CACA,IAAI,CACT,EAEA,MAAM,aAAa,IAAa,CAI9B,SAAS,OAAO,EAChB,GAAI,CACF,SAAS,GAAG,EACZ,SAAS,QAAQ,CACnB,OAAS,IAAK,CACZ,GAAI,CACF,SAAS,UAAU,CACrB,MAAQ,CAER,CACA,MAAM,GACR,CACF,EAEA,MAAM,aAAa,IAAa,CAC9B,SAAS,GAAG,CACd,EAEA,MAAM,YAAsC,CAK1C,OAAO,iBAAiB,QAAQ,CAClC,EAEA,MAAM,OAAQ,CAId,CACF,CACF,CCrIA,SAAgB,cAAc,KAA2C,CACvE,OAAO,YAAY,IAAI,cAAc,CAAE,SAAU,KAAK,QAAkB,CAAC,EAAG,QAAQ,CACtF"}
|
|
1
|
+
{"version":3,"file":"sqlite.mjs","names":[],"sources":["../src/adapters/sqlite/dialect.ts","../src/adapters/sqlite/adapter.ts","../src/adapters/sqlite/async-adapter.ts"],"sourcesContent":["// sqliteDialect — thin factory over Kysely's SqliteDialect so adopters\n// never have to reach for `import { SqliteDialect } from 'kysely'`.\n// Mirrors the `@forinda/kickjs-db/pg` template; the kysely subpackage\n// is a pinned internal dep of the framework.\n\nimport { SqliteDialect, type Dialect as KyselyDialect } from 'kysely'\n\nimport { markDialect } from '../../dialect-marker'\nimport type { SqliteDatabaseLike } from './adapter'\n\nexport interface SqliteDialectOptions {\n /**\n * A better-sqlite3 `Database`, or a `bun:sqlite` `Database` (tested in\n * CI's Bun job).\n */\n database: SqliteDatabaseLike\n}\n\n/**\n * Construct the dialect that `createDbClient({ dialect })` consumes.\n *\n * @example\n * ```ts\n * import { createDbClient } from '@forinda/kickjs-db'\n * import { sqliteDialect, sqliteAdapter } from '@forinda/kickjs-db/sqlite'\n * import Database from 'better-sqlite3'\n *\n * const database = new Database(':memory:')\n *\n * export const db = createDbClient({\n * schema,\n * dialect: sqliteDialect({ database }),\n * })\n *\n * export const migrationAdapter = sqliteAdapter({ database })\n * ```\n */\nexport function sqliteDialect(opts: SqliteDialectOptions): KyselyDialect {\n return markDialect(new SqliteDialect({ database: readerDatabase(opts.database) }), 'sqlite')\n}\n\n/** What Kysely's SQLite driver calls on a prepared statement. */\ntype KyselyStatement = {\n reader: boolean\n all(params: readonly unknown[]): unknown[]\n run(params: readonly unknown[]): { changes: number | bigint; lastInsertRowid: number | bigint }\n iterate(params: readonly unknown[]): IterableIterator<unknown>\n}\n\ntype LooseStatement = {\n reader?: unknown\n columnNames?: readonly string[]\n all(...params: unknown[]): unknown[]\n run(...params: unknown[]): { changes: number | bigint; lastInsertRowid: number | bigint }\n iterate?(...params: unknown[]): IterableIterator<unknown>\n}\n\n/**\n * Kysely's SQLite driver asks a statement whether it returns rows\n * (`stmt.reader`, a better-sqlite3 field) and passes the parameters as one\n * array. `bun:sqlite` has neither: without this, every SELECT ran as a write\n * and returned no rows. A better-sqlite3 statement passes through as is.\n */\nfunction readerDatabase(database: SqliteDatabaseLike): never {\n return {\n close: () => database.close(),\n prepare(sql: string): KyselyStatement {\n const stmt = database.prepare(sql) as unknown as LooseStatement\n if (typeof stmt.reader === 'boolean') return stmt as unknown as KyselyStatement\n return {\n reader: (stmt.columnNames?.length ?? 0) > 0,\n all: (params) => stmt.all(...params),\n run: (params) => stmt.run(...params),\n iterate: (params) =>\n stmt.iterate ? stmt.iterate(...params) : stmt.all(...params)[Symbol.iterator](),\n }\n },\n } as never\n}\n","import { Kysely } from 'kysely'\nimport { sqliteDialect } from './dialect'\nimport {\n lockTableDdl,\n lockTableName,\n quoteTable,\n KICK_MIGRATIONS_TABLE,\n migrationsTableDdl,\n type Dialect,\n type MigrationAdapter,\n type MigrationBookkeeping,\n type MigrationRow,\n type SchemaSnapshot,\n} from '../../index'\nimport { introspectSqlite } from '../../migrate/introspect-sqlite'\n\n/**\n * better-sqlite3-shaped database handle that `sqliteAdapter` consumes.\n * Mirrors the methods we actually use; both `new Database(...)` from\n * `better-sqlite3` and bun's `bun:sqlite` Database match structurally.\n *\n * better-sqlite3's API is synchronous — we wrap everything in `async`\n * to match the `MigrationAdapter` contract. No I/O actually awaits;\n * the wrapping is for shape compatibility.\n */\n/**\n * `all` / `get` are deliberately NOT method-generic: better-sqlite3\n * v12's own `Statement` methods are non-generic, so generic signatures\n * here would make a real `Database` instance structurally incompatible\n * (callers had to cast — same fix as `SqliteIntrospectDb`). Row typing\n * happens at the call sites via assertions instead.\n */\nexport interface SqliteStatement {\n run(...params: readonly unknown[]): { changes: number; lastInsertRowid: number | bigint }\n all(...params: readonly unknown[]): unknown[]\n get(...params: readonly unknown[]): unknown\n}\n\nexport interface SqliteDatabaseLike {\n prepare(sql: string): SqliteStatement\n exec(sql: string): unknown\n close(): unknown\n}\n\nexport interface SqliteAdapterOptions {\n /**\n * The table migrations are recorded in. Default `kick_migrations`; its lock\n * table is the same name plus `_lock`.\n */\n migrationsTable?: string\n /**\n * better-sqlite3 (or compatible) Database handle. Caller-owned —\n * the adapter's `close()` does NOT close the database because\n * adopters typically share a single handle across the migration\n * adapter and the KickDbClient.\n */\n database: SqliteDatabaseLike\n}\n\n/**\n * MigrationAdapter implementation backed by better-sqlite3.\n *\n * Lock semantics: single-row UPDATE WHERE locked_at IS NULL on\n * `kick_migrations_lock`. Only the row created by `ensureMigrationTables()`\n * exists, so the UPDATE either flips `locked_at` and returns\n * `changes=1` (we won) or matches zero rows (someone else holds it).\n *\n * Introspection: `introspect()` walks `sqlite_master` + `PRAGMA` via\n * {@link introspectSqlite}. Types come back as SQLite affinities (lossy\n * vs the code-first DSL), so it powers `kick db introspect` rather than\n * byte-exact drift detection.\n */\nexport function sqliteAdapter(opts: SqliteAdapterOptions): MigrationAdapter {\n const dialect: Dialect = 'sqlite'\n const { database } = opts\n\n // Multi-statement DDL runs through better-sqlite3's exec() (it\n // handles `;`-separated batches natively).\n const runBatch = (sql: string) => database.exec(sql)\n\n const table = opts.migrationsTable ?? KICK_MIGRATIONS_TABLE\n const T = quoteTable(dialect, table)\n const L = quoteTable(dialect, lockTableName(table))\n // Introspection must not report the bookkeeping tables as schema.\n // A dot is part of the name here, not a schema.\n const bookkeepingTables = [table, lockTableName(table)]\n let migrationDb: Kysely<any> | undefined\n return {\n dialect,\n\n async ensureMigrationTables() {\n runBatch(migrationsTableDdl(dialect, table))\n runBatch(lockTableDdl(dialect, table))\n },\n\n async listApplied(): Promise<MigrationRow[]> {\n const rows = database\n .prepare(\n `SELECT id, name, hash, batch, applied_at, direction\n FROM ${T}\n ORDER BY applied_at ASC, id ASC`,\n )\n .all() as {\n id: string\n name: string\n hash: string\n batch: number\n applied_at: string\n direction: 'up' | 'down'\n }[]\n return rows.map((row) => ({\n id: row.id,\n name: row.name,\n hash: row.hash,\n batch: Number(row.batch),\n appliedAt: row.applied_at,\n direction: row.direction,\n }))\n },\n\n async recordApplied(row) {\n database\n .prepare(\n `INSERT INTO ${T} (id, name, hash, batch, direction)\n VALUES (?, ?, ?, ?, ?)`,\n )\n .run(row.id, row.name, row.hash, row.batch, row.direction)\n },\n\n async removeApplied(id: string) {\n database.prepare(`DELETE FROM ${T} WHERE id = ?`).run(id)\n },\n\n async acquireLock(owner: string): Promise<boolean> {\n const r = database\n .prepare(\n `UPDATE ${L}\n SET locked_at = datetime('now'), locked_by = ?\n WHERE id = 1 AND locked_at IS NULL`,\n )\n .run(owner)\n return r.changes === 1\n },\n\n async releaseLock() {\n database\n .prepare(\n `UPDATE ${L}\n SET locked_at = NULL, locked_by = NULL\n WHERE id = 1`,\n )\n .run()\n },\n\n async applySqlInTx(sql: string) {\n await this.applyMigrationInTx!(sql, null)\n },\n\n async applyMigrationInTx(sql: string, bookkeeping: MigrationBookkeeping | null) {\n // BEGIN / COMMIT around a multi-statement batch gives us\n // atomicity. SQLite rolls back to pre-BEGIN on any error\n // inside the block.\n runBatch('BEGIN')\n try {\n runBatch(sql)\n if (bookkeeping && 'record' in bookkeeping) {\n const r = bookkeeping.record\n database\n .prepare(\n `INSERT INTO ${T} (id, name, hash, batch, direction)\n VALUES (?, ?, ?, ?, ?)`,\n )\n .run(r.id, r.name, r.hash, r.batch, r.direction)\n } else if (bookkeeping) {\n database.prepare(`DELETE FROM ${T} WHERE id = ?`).run(bookkeeping.remove)\n }\n // A table rebuild copies rows into a fresh table; check no row now\n // points at a parent that isn't there before committing it.\n // The tables this migration rebuilt, read from the rebuild's final rename.\n const rebuilt = new Set(\n [...sql.matchAll(/ALTER TABLE \"_kick_new_((?:[^\"]|\"\")+)\" RENAME TO/g)].map((m) =>\n m[1]!.replace(/\"\"/g, '\"'),\n ),\n )\n if (rebuilt.size > 0) {\n // A rebuilt table can be the child or the parent of a broken key;\n // orphans elsewhere predate this migration and aren't its to fail on.\n const broken = (\n database.prepare('PRAGMA foreign_key_check').all() as Array<{\n table: string\n parent: string\n }>\n ).filter((r) => rebuilt.has(r.table) || rebuilt.has(r.parent))\n if (broken.length > 0) {\n const where = [...new Set(broken.map((r) => `${r.table} → ${r.parent}`))].join(', ')\n throw new Error(\n `kickjs-db: the migration left ${broken.length} row(s) whose foreign key points ` +\n `at a missing row (${where}); rolled back. Fix the data, then migrate again.`,\n )\n }\n }\n runBatch('COMMIT')\n } catch (err) {\n try {\n runBatch('ROLLBACK')\n } catch {\n // Swallow rollback errors; we're already throwing the original.\n }\n throw err\n }\n },\n\n async applySqlNoTx(sql: string) {\n runBatch(sql)\n },\n\n async introspect(): Promise<SchemaSnapshot> {\n // Reverse-engineer the live schema via sqlite_master + PRAGMA walks.\n // Types come back as SQLite affinities (a code-first `uuid()` reads as\n // `text`), so this powers `kick db introspect`; byte-exact drift\n // against a code-first snapshot needs a dialect-normalised compare.\n return introspectSqlite(database, { excludeTables: bookkeepingTables })\n },\n\n migrationsTable: table,\n\n kysely() {\n // Built once, on the same connection. Never destroyed here: the pool or\n // handle belongs to the caller (or to close()).\n return (migrationDb ??= new Kysely<any>({\n dialect: sqliteDialect({ database: database as never }),\n }))\n },\n\n async close() {\n // Caller owns the database handle. The adapter doesn't close\n // it — adopters typically share the same handle with the\n // KickDbClient.\n },\n }\n}\n","import type { Kysely } from 'kysely'\nimport {\n lockTableDdl,\n lockTableName,\n quoteTable,\n KICK_MIGRATIONS_TABLE,\n migrationsTableDdl,\n type Dialect,\n type MigrationAdapter,\n type MigrationBookkeeping,\n type MigrationRow,\n type SchemaSnapshot,\n} from '../../index'\nimport { introspectSqliteAsync } from '../../migrate/introspect-sqlite'\nimport { splitSqlStatements } from '../../migrate/split-statements'\n\n/** One statement and its parameters. */\nexport interface SqliteStatementInput {\n sql: string\n params?: readonly unknown[]\n}\n\n/**\n * The two things an async SQLite driver (libsql/Turso, Cloudflare D1) has to\n * offer for migrations. Wrap your client with {@link libsqlDriver} or\n * {@link d1Driver}, or implement it for another driver.\n */\nexport interface AsyncSqliteDriver {\n /** Run one statement and resolve with its rows (empty for a write). */\n query(sql: string, params?: readonly unknown[]): Promise<unknown[]>\n /** Run statements atomically, in order: all of them apply, or none. */\n batch(statements: readonly SqliteStatementInput[]): Promise<void>\n}\n\nexport interface AsyncSqliteAdapterOptions {\n driver: AsyncSqliteDriver\n /**\n * A Kysely instance on the same database, for migrations written in\n * TypeScript (`migration.ts`). Without it, only SQL migrations run.\n */\n kysely?: Kysely<any>\n /**\n * The table migrations are recorded in. Default `kick_migrations`; its lock\n * table is the same name plus `_lock`.\n */\n migrationsTable?: string\n /**\n * Called by `close()`, so a client opened for `kick db` can end when the\n * command finishes: `close: () => client.close()`. The client is otherwise\n * the caller's.\n */\n close?: () => unknown\n}\n\n/**\n * Migrations on an async SQLite driver: libsql/Turso, Cloudflare D1, or any\n * driver that can run a statement and an atomic batch.\n *\n * Each migration is applied as one batch: its statements, then its\n * `kick_migrations` row, then — when it rebuilt a table — a statement that\n * fails if a foreign key now points at a missing row. A failure anywhere\n * rolls the whole batch back. The batch replaces `BEGIN`/`COMMIT`, which D1\n * doesn't allow, so `meta.transaction: false` migrations run statement by\n * statement instead.\n */\nexport function asyncSqliteAdapter(opts: AsyncSqliteAdapterOptions): MigrationAdapter {\n const dialect: Dialect = 'sqlite'\n const { driver } = opts\n const table = opts.migrationsTable ?? KICK_MIGRATIONS_TABLE\n const T = quoteTable(dialect, table)\n const L = quoteTable(dialect, lockTableName(table))\n const bookkeepingTables = [table, lockTableName(table)]\n const statements = (sql: string): SqliteStatementInput[] =>\n splitSqlStatements(sql, 'sqlite').map((s) => ({ sql: s }))\n const insertRow = (r: Omit<MigrationRow, 'appliedAt'>): SqliteStatementInput => ({\n sql: `INSERT INTO ${T} (id, name, hash, batch, direction) VALUES (?, ?, ?, ?, ?)`,\n params: [r.id, r.name, r.hash, r.batch, r.direction],\n })\n const deleteRow = (id: string): SqliteStatementInput => ({\n sql: `DELETE FROM ${T} WHERE id = ?`,\n params: [id],\n })\n\n return {\n dialect,\n\n async ensureMigrationTables() {\n await driver.batch([\n ...statements(migrationsTableDdl(dialect, table)),\n ...statements(lockTableDdl(dialect, table)),\n ])\n },\n\n async listApplied(): Promise<MigrationRow[]> {\n const rows = (await driver.query(\n `SELECT id, name, hash, batch, applied_at, direction FROM ${T}\n ORDER BY applied_at ASC, id ASC`,\n )) as Array<{\n id: string\n name: string\n hash: string\n batch: number\n applied_at: string\n direction: 'up' | 'down'\n }>\n return rows.map((row) => ({\n id: row.id,\n name: row.name,\n hash: row.hash,\n batch: Number(row.batch),\n appliedAt: row.applied_at,\n direction: row.direction,\n }))\n },\n\n async recordApplied(row) {\n const s = insertRow(row)\n await driver.query(s.sql, s.params)\n },\n\n async removeApplied(id) {\n const s = deleteRow(id)\n await driver.query(s.sql, s.params)\n },\n\n async acquireLock(owner) {\n // RETURNING tells us whether this UPDATE took the lock (SQLite 3.35+).\n const won = await driver.query(\n `UPDATE ${L} SET locked_at = datetime('now'), locked_by = ?\n WHERE id = 1 AND locked_at IS NULL RETURNING id`,\n [owner],\n )\n return won.length === 1\n },\n\n async releaseLock() {\n await driver.query(`UPDATE ${L} SET locked_at = NULL, locked_by = NULL WHERE id = 1`)\n },\n\n async applySqlInTx(sql) {\n await this.applyMigrationInTx!(sql, null)\n },\n\n async applyMigrationInTx(sql: string, bookkeeping: MigrationBookkeeping | null) {\n const batch = statements(sql)\n if (bookkeeping && 'record' in bookkeeping) batch.push(insertRow(bookkeeping.record))\n else if (bookkeeping) batch.push(deleteRow(bookkeeping.remove))\n const guard = foreignKeyGuard(sql)\n if (guard) batch.push(guard)\n if (batch.length === 0) return\n try {\n await driver.batch(batch)\n } catch (err) {\n // The guard fails with SQLite's own \"malformed JSON\"; say what it means.\n if (guard && /malformed JSON/i.test(String((err as Error)?.message))) {\n throw new Error(\n 'kickjs-db: the migration left rows whose foreign key points at a missing row; ' +\n 'rolled back. Fix the data, then migrate again.',\n { cause: err },\n )\n }\n throw err\n }\n },\n\n async applySqlNoTx(sql) {\n for (const s of statements(sql)) await driver.query(s.sql)\n },\n\n async introspect(): Promise<SchemaSnapshot> {\n return introspectSqliteAsync((sql, params) => driver.query(sql, params), {\n excludeTables: bookkeepingTables,\n })\n },\n\n migrationsTable: table,\n\n ...(opts.kysely ? { kysely: () => opts.kysely! } : {}),\n\n async close() {\n await opts.close?.()\n },\n }\n}\n\n/**\n * After a table rebuild (rows copied into a fresh table), a statement that\n * fails when a rebuilt table is the child or the parent of a broken foreign\n * key. It's the last statement of the batch, so failing it rolls the\n * migration back. `json()` on a non-JSON string is the error (SQLite has no\n * `raise()` outside triggers); the adapter rewords it.\n */\nfunction foreignKeyGuard(sql: string): SqliteStatementInput | undefined {\n const rebuilt = [\n ...new Set(\n [...sql.matchAll(/ALTER TABLE \"_kick_new_((?:[^\"]|\"\")+)\" RENAME TO/g)].map((m) =>\n m[1]!.replace(/\"\"/g, '\"'),\n ),\n ),\n ]\n if (rebuilt.length === 0) return undefined\n const marks = rebuilt.map(() => '?').join(', ')\n return {\n sql: `SELECT CASE WHEN EXISTS (\n SELECT 1 FROM pragma_foreign_key_check\n WHERE \"table\" IN (${marks}) OR \"parent\" IN (${marks})\n ) THEN json('not json') END`,\n params: [...rebuilt, ...rebuilt],\n }\n}\n\n/** The part of `@libsql/client`'s `Client` that {@link libsqlDriver} uses. */\nexport interface LibsqlClientLike {\n execute(stmt: { sql: string; args: any[] }): Promise<{ rows: ArrayLike<unknown> }>\n batch(\n stmts: Array<{ sql: string; args: any[] }>,\n mode?: 'write' | 'read' | 'deferred',\n ): Promise<unknown>\n}\n\n/** {@link AsyncSqliteDriver} over a libsql/Turso client (`@libsql/client`). */\nexport function libsqlDriver(client: LibsqlClientLike): AsyncSqliteDriver {\n return {\n async query(sql, params = []) {\n const result = await client.execute({ sql, args: [...params] })\n return Array.from(result.rows)\n },\n async batch(statements) {\n await client.batch(\n statements.map((s) => ({ sql: s.sql, args: [...(s.params ?? [])] })),\n 'write',\n )\n },\n }\n}\n\n/** The part of Cloudflare D1's `D1Database` that {@link d1Driver} uses. */\nexport interface D1DatabaseLike {\n prepare(sql: string): D1StatementLike\n batch(statements: D1StatementLike[]): Promise<unknown>\n}\n\nexport interface D1StatementLike {\n bind(...values: unknown[]): D1StatementLike\n all(): Promise<{ results?: unknown[] }>\n}\n\n/** {@link AsyncSqliteDriver} over a Cloudflare D1 binding. */\nexport function d1Driver(db: D1DatabaseLike): AsyncSqliteDriver {\n const prepare = (sql: string, params: readonly unknown[] = []) =>\n params.length > 0 ? db.prepare(sql).bind(...params) : db.prepare(sql)\n return {\n async query(sql, params) {\n return (await prepare(sql, params).all()).results ?? []\n },\n async batch(statements) {\n // D1 runs a batch as one transaction.\n await db.batch(statements.map((s) => prepare(s.sql, s.params)))\n },\n }\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @forinda/kickjs-db v8.1.0
|
|
3
|
+
*
|
|
4
|
+
* Copyright (c) Felix Orinda
|
|
5
|
+
*
|
|
6
|
+
* This source code is licensed under the MIT license found in the
|
|
7
|
+
* LICENSE file in the root directory of this source tree.
|
|
8
|
+
*
|
|
9
|
+
* @license MIT
|
|
10
|
+
*/
|
|
11
|
+
import{C as loadModule,Ct as snapshotTableName,E as emitPg,G as findRenameCandidates,K as withTableRenames,W as diff,_t as table,at as KickDbError,b as computeMigrationHash,bt as derivedFkName,d as migrateLatest,g as emitMysql,gt as qualifiedTableName,ht as buildTable,p as migrateStatus,q as extractSnapshot,v as emitSqlite,x as readJournal,xt as derivedUniqueName,y as appendJournalEntry}from"./create-CwuC1odW.mjs";import{r as ColumnBuilder}from"./custom-type-DeGuRFuz.mjs";import{BinaryOperationNode,OperationNodeTransformer,OperatorNode,ValueNode,sql}from"kysely";import{createToken,defineAdapter}from"@forinda/kickjs";import{mkdir,readFile,readdir,writeFile}from"node:fs/promises";import{existsSync,readFileSync}from"node:fs";import path from"node:path";import{fileURLToPath,pathToFileURL}from"node:url";function renderSchemaSource(snapshot){let usedColumnHelpers=new Set,tableSources=[],enums=snapshot.enums??{};for(let table of Object.values(snapshot.tables))tableSources.push(renderTable(table,usedColumnHelpers,enums));let views=Object.values(snapshot.views??{});for(let v of views)tableSources.push(renderView(v,usedColumnHelpers,enums));let helpers=[`table`,...Array.from(usedColumnHelpers).toSorted()];views.some(v=>!v.materialized)&&helpers.push(`view`);let viewIndexes=views.flatMap(v=>v.indexes??[]);viewIndexes.some(i=>!i.unique)&&!helpers.includes(`index`)&&helpers.push(`index`),viewIndexes.some(i=>i.unique)&&!helpers.includes(`unique`)&&helpers.push(`unique`),Object.values(snapshot.tables).some(t=>t.indexes.some(i=>!isAutoUniqueName(t.name,i)))&&helpers.push(`index`),Object.values(snapshot.tables).some(t=>t.indexes.some(i=>i.unique&&!isAutoUniqueName(t.name,i)))&&!helpers.includes(`unique`)&&helpers.push(`unique`);let lines=[`import { ${helpers.join(`, `)} } from '@forinda/kickjs-db'`],enumDecls=Object.values(enums),pgImports=[...enumDecls.length>0?[`pgEnum`]:[],...views.some(v=>v.materialized)?[`materializedView`]:[],...Object.values(snapshot.tables).some(t=>t.policies?.length)?[`policy`]:[]];pgImports.length>0&&lines.push(`import { ${pgImports.join(`, `)} } from '@forinda/kickjs-db/pg'`);let body=[];if(enumDecls.length>0){for(let e of enumDecls.toSorted((a,b)=>a.name.localeCompare(b.name))){let values=e.values.map(v=>`'${v.replace(/'/g,`\\'`)}'`).join(`, `);body.push(`export const ${enumIdent(e.name)} = pgEnum('${e.name}', ${values})`)}body.push(``)}return[...lines,``,...body,...tableSources].join(`
|
|
12
|
+
`).trimEnd()+`
|
|
13
|
+
`}function renderView(v,helpers,enums){let columns=Object.values(v.columns??{}).map(c=>` ${jsKey(c.name)}: ${renderColumn(c,helpers,void 0,!1,v.name,enums)},`),opts=[`as: ${"`"+v.definition.replace(/\\/g,`\\\\`).replace(/`/g,"\\`").replace(/\$\{/g,"\\${")+"`"}`];if(v.indexes?.length){let calls=v.indexes.map(i=>` ${jsKey(i.name)}: ${renderIndexCall(i)}`).join(`,
|
|
14
|
+
`);opts.push(`constraints: (t) => ({\n${calls},\n })`)}let factory=v.materialized?`materializedView`:`view`;return`export const ${jsIdent(v.name)} = ${factory}(${strLit(v.name)}, {\n${columns.join(`
|
|
15
|
+
`)}\n}, { ${opts.join(`, `)} })`}function renderPolicyCall(p){let s=`policy(${strLit(p.name)})`;return p.as!==`permissive`&&(s+=`.as('${p.as}')`),p.command!==`all`&&(s+=`.for('${p.command}')`),p.to.join()!==`public`&&(s+=`.to(${p.to.map(strLit).join(`, `)})`),p.using&&(s+=`.using(${strLit(p.using)})`),p.withCheck&&(s+=`.withCheck(${strLit(p.withCheck)})`),s}function enumIdent(enumName){return jsIdent(enumName)}function renderTable(table,helpers,enums){let ident=jsIdent(table.name),columns=[],singleColumnFks=new Map;for(let f of table.foreignKeys){if(f.columns.length!==1)continue;let list=singleColumnFks.get(f.columns[0])??[];list.push(f),singleColumnFks.set(f.columns[0],list)}let inlined=new Set;for(let col of Object.values(table.columns)){let candidates=singleColumnFks.get(col.name)??[],fk=candidates.length===1?candidates[0]:void 0;fk&&inlined.add(fk);let inlineUnique=table.indexes.find(i=>i.unique&&i.columns.length===1&&i.columns[0]===col.name&&isAutoUniqueName(table.name,i))!==void 0;columns.push(` ${jsKey(col.name)}: ${renderColumn(col,helpers,fk,inlineUnique,table.name,enums)},`)}let explicitIndexes=table.indexes.filter(i=>!isAutoUniqueName(table.name,i)),deferredFks=table.foreignKeys.filter(f=>!inlined.has(f)),tableArgs=[strLit(table.name),`{\n${columns.join(`
|
|
16
|
+
`)}\n}`],callbacks=[...explicitIndexes.map(i=>` ${jsKey(i.name)}: ${renderIndexCall(i)}`),...(table.policies??[]).map(p=>` ${jsKey(p.name)}: ${renderPolicyCall(p)}`)].join(`,
|
|
17
|
+
`),constraints=callbacks?`(t) => ({\n${callbacks},\n })`:void 0,rls=table.rls?.force?`{ force: true }`:table.rls&&!table.policies?.length?`true`:void 0;if(table.comment!==void 0||rls){let parts=[];table.comment!==void 0&&parts.push(`comment: ${strLit(table.comment)}`),rls&&parts.push(`rls: ${rls}`),constraints&&parts.push(`constraints: ${constraints}`),tableArgs.push(`{ ${parts.join(`, `)} }`)}else constraints&&tableArgs.push(constraints);let src=`export const ${ident} = table(${tableArgs.join(`, `)})`;if(deferredFks.length>0){src+=`
|
|
18
|
+
// TODO: kick db introspect — composite foreign keys, and columns with more than one, not auto-rendered:
|
|
19
|
+
`;for(let f of deferredFks)src+=`// ${f.name}: (${f.columns.join(`, `)}) → ${f.refTable}(${f.refColumns.join(`, `)})\n`}return src}function renderColumn(col,helpers,fk,inlineUnique,tableName,enums){if(enums[col.type])return chainSuffix(`${enumIdent(col.type)}()`,col,fk,inlineUnique,tableName);let{helperName,args,isArray}=pickColumnHelper(col);return helpers.add(helperName),chainSuffix(`${helperName}(${args})${isArray?`.array()`:``}`,col,fk,inlineUnique,tableName)}function chainSuffix(base,col,fk,inlineUnique,tableName){let chain=base;if(col.primaryKey&&(chain+=`.primaryKey()`),!col.primaryKey&&!col.nullable&&(chain+=`.notNull()`),col.default!==null&&(chain+=`.default(${JSON.stringify(col.default)})`),col.identity===`always`&&(chain+=`.generatedAlwaysAsIdentity()`),col.identity===`byDefault`&&(chain+=`.generatedByDefaultAsIdentity()`),col.generated){let virtual=col.generated.stored?``:`, { stored: false }`;chain+=`.generatedAlwaysAs(${strLit(col.generated.expression)}${virtual})`}if(inlineUnique&&(chain+=`.unique()`),col.comment!==void 0&&(chain+=`.comment(${strLit(col.comment)})`),fk){let ref=`${jsIdent(fk.refTable)}.${jsIdent(fk.refColumns[0])}`,opts=[];fk.onDelete!==`no_action`&&opts.push(`onDelete: '${fk.onDelete}'`),fk.onUpdate!==void 0&&fk.onUpdate!==`no_action`&&opts.push(`onUpdate: '${fk.onUpdate}'`),fk.name!==derivedFkName(tableName,col.name)&&opts.push(`name: ${strLit(fk.name)}`);let optArg=opts.length>0?`, { ${opts.join(`, `)} }`:``;chain+=`.references(() => ${ref}${optArg})`}return chain}function pickColumnHelper(col){let isArray=col.type.endsWith(`[]`),t=isArray?col.type.slice(0,-2):col.type;return t===`serial`?{helperName:`serial`,args:``,isArray}:t===`bigserial`?{helperName:`bigSerial`,args:``,isArray}:t===`smallserial`?{helperName:`serial`,args:``,isArray}:t===`integer`?{helperName:`integer`,args:``,isArray}:t===`bigint`?{helperName:`bigint`,args:``,isArray}:t===`smallint`?{helperName:`smallint`,args:``,isArray}:t===`real`?{helperName:`real`,args:``,isArray}:t===`double precision`?{helperName:`doublePrecision`,args:``,isArray}:/^numeric(\(.+\))?$/.test(t)?{helperName:`numeric`,args:extractParens(t),isArray}:/^varchar(\(\d+\))?$/.test(t)?{helperName:`varchar`,args:extractParens(t),isArray}:/^char(\(\d+\))?$/.test(t)?{helperName:`char`,args:extractParens(t),isArray}:t===`text`?{helperName:`text`,args:``,isArray}:t===`boolean`?{helperName:`boolean`,args:``,isArray}:t===`timestamp`?{helperName:`timestamp`,args:``,isArray}:t===`timestamptz`?{helperName:`timestamptz`,args:``,isArray}:t===`date`?{helperName:`date`,args:``,isArray}:t===`time`?{helperName:`time`,args:``,isArray}:t===`interval`?{helperName:`interval`,args:``,isArray}:t===`uuid`?{helperName:`uuid`,args:``,isArray}:t===`jsonb`?{helperName:`jsonb`,args:``,isArray}:t===`json`?{helperName:`json`,args:``,isArray}:t===`bytea`?{helperName:`bytea`,args:``,isArray}:{helperName:`text`,args:`/* TODO: ${t} */`,isArray}}function extractParens(t){let m=t.match(/\(([^)]+)\)/);return m?m[1]:``}function renderIndexCall(idx){let helper=idx.unique?`unique`:`index`,key=c=>c.startsWith(`(`)?strLit(c.slice(1,-1)):`t.${jsIdent(c)}`,call=`${helper}(${strLit(idx.name)}).on(${idx.columns.map(key).join(`, `)})`;idx.using&&(call+=`.using(${strLit(idx.using)})`);for(let[k,op]of Object.entries(idx.opclasses??{}))call+=`.op(${key(k)}, ${strLit(op)})`;return idx.include?.length&&(call+=`.include(${idx.include.map(c=>`t.${jsIdent(c)}`).join(`, `)})`),idx.where&&(call+=`.where(${strLit(idx.where)})`),idx.concurrently&&(call+=`.concurrently()`),call}function isAutoUniqueName(tableName,idx){return idx.unique&&idx.columns.length===1&&idx.name===derivedUniqueName(tableName,idx.columns[0])}function strLit(value){return/^[^'\\\r\n\u2028\u2029]*$/.test(value)?`'${value}'`:JSON.stringify(value)}function jsIdent(raw){return/^[A-Za-z_$][\w$]*$/.test(raw)?raw:`_${raw.replace(/[^\w$]/g,`_`)}`}function jsKey(raw){return/^[A-Za-z_$][\w$]*$/.test(raw)?raw:JSON.stringify(raw)}function invertChanges(forward){let reversed=[];for(let change of forward)change.kind!==`createSchema`&&change.kind!==`createRole`&&change.kind!==`alterRole`&&reversed.push(invert(change));let ordered=reversed.toReversed(),droppedTables=new Set(ordered.filter(c=>c.kind===`dropTable`).map(c=>snapshotTableName(c.table)));return ordered.filter(c=>c.kind===`dropForeignKey`||c.kind===`dropIndex`||c.kind===`dropCheck`||c.kind===`dropPolicy`||c.kind===`setRowLevelSecurity`?!droppedTables.has(c.table):!0)}function invert(change){switch(change.kind){case`createTable`:return{kind:`dropTable`,table:change.table};case`dropTable`:return{kind:`createTable`,table:change.table};case`renameTable`:return{kind:`renameTable`,from:change.to,to:change.from};case`addColumn`:return{kind:`dropColumn`,table:change.table,column:change.column};case`dropColumn`:return{kind:`addColumn`,table:change.table,column:change.column};case`renameColumn`:return{kind:`renameColumn`,table:change.table,from:change.to,to:change.from};case`alterColumn`:return{kind:`alterColumn`,table:change.table,column:change.column,before:change.after,after:change.before};case`addIndex`:return{kind:`dropIndex`,table:change.table,index:change.index};case`dropIndex`:return{kind:`addIndex`,table:change.table,index:change.index};case`addForeignKey`:return{kind:`dropForeignKey`,table:change.table,fk:change.fk};case`dropForeignKey`:return{kind:`addForeignKey`,table:change.table,fk:change.fk};case`createEnum`:return{kind:`dropEnum`,enum:change.enum};case`dropEnum`:return{kind:`createEnum`,enum:change.enum};case`addEnumValue`:return change;case`alterPrimaryKey`:return{kind:`alterPrimaryKey`,table:change.table,before:change.after,after:change.before};case`addCheck`:return{kind:`dropCheck`,table:change.table,check:change.check};case`dropCheck`:return{kind:`addCheck`,table:change.table,check:change.check};case`createPolicy`:return{kind:`dropPolicy`,table:change.table,policy:change.policy};case`dropPolicy`:return{kind:`createPolicy`,table:change.table,policy:change.policy};case`setRowLevelSecurity`:return{...change,from:change.to,to:change.from};case`createView`:return{kind:`dropView`,view:change.view};case`dropView`:return{kind:`createView`,view:change.view};case`setTableComment`:return{...change,from:change.to,to:change.from};case`setColumnComment`:return{...change,column:{...change.column,comment:change.from??void 0},from:change.to,to:change.from};case`removeEnumValue`:return change}}const AMBIGUOUS_REVERSE_KINDS=new Set([`dropTable`,`dropColumn`,`alterColumn`,`addEnumValue`,`removeEnumValue`]);function hasAmbiguousReverse(forward){return forward.some(c=>AMBIGUOUS_REVERSE_KINDS.has(c.kind))}async function detectCompositeReferences(runner,enumName){let{schema,name}=splitQualifiedName(enumName);return(await runner.query(`
|
|
20
|
+
SELECT
|
|
21
|
+
ns_comp.nspname AS composite_schema,
|
|
22
|
+
t_comp.typname AS composite_name,
|
|
23
|
+
a.attname AS attribute_name,
|
|
24
|
+
ns_enum.nspname AS enum_schema,
|
|
25
|
+
t_enum.typname AS enum_name
|
|
26
|
+
FROM pg_type t_comp
|
|
27
|
+
JOIN pg_namespace ns_comp ON ns_comp.oid = t_comp.typnamespace
|
|
28
|
+
JOIN pg_class c ON c.oid = t_comp.typrelid
|
|
29
|
+
JOIN pg_attribute a ON a.attrelid = c.oid AND a.attnum > 0 AND NOT a.attisdropped
|
|
30
|
+
JOIN pg_type t_enum_or_arr ON t_enum_or_arr.oid = a.atttypid
|
|
31
|
+
JOIN pg_type t_enum ON t_enum.oid = COALESCE(NULLIF(t_enum_or_arr.typelem, 0), t_enum_or_arr.oid)
|
|
32
|
+
JOIN pg_namespace ns_enum ON ns_enum.oid = t_enum.typnamespace
|
|
33
|
+
WHERE t_comp.typtype = 'c'
|
|
34
|
+
AND c.relkind = 'c'
|
|
35
|
+
AND t_enum.typtype = 'e'
|
|
36
|
+
AND t_enum.typname = $1
|
|
37
|
+
AND ($2::text IS NULL OR ns_enum.nspname = $2)
|
|
38
|
+
`,[name,schema])).rows.map(r=>({composite:`${r.composite_schema}.${r.composite_name}`,attribute:r.attribute_name,enum:`${r.enum_schema}.${r.enum_name}`}))}function splitQualifiedName(qualified){let dot=qualified.indexOf(`.`);return dot===-1?{schema:null,name:qualified}:{schema:qualified.slice(0,dot),name:qualified.slice(dot+1)}}var CompositeEnumReferenceError=class extends KickDbError{refs;constructor(refs){let summary=refs.map(r=>`${r.composite}.${r.attribute} → ${r.enum}`).join(`, `);super(`composite_enum_reference`,`Cannot generate migration: the enum value(s) being removed are reachable through composite type field(s) [${summary}]. PostgreSQL's USING-cast in the rename-recreate path can't reach into composite fields, so the migration would fail at apply time. Drop or restructure the composite type(s) first, then re-run \`kick db generate\`.`),this.refs=refs}};const KICK_MIGRATIONS_TABLE=`kick_migrations`,KICK_LOCK_TABLE=`kick_migrations_lock`;function lockTableName(table){return`${table}_lock`}function quoteTable(dialect,name){return dialect===`mysql`?`\`${name.replaceAll("`","``")}\``:(dialect===`postgres`?name.split(`.`):[name]).map(p=>`"${p.replaceAll(`"`,`""`)}"`).join(`.`)}function bareName(name){return name.slice(name.lastIndexOf(`.`)+1)}function migrationsTableDdl(dialect,table=KICK_MIGRATIONS_TABLE){let T=quoteTable(dialect,table),idx=quoteTable(dialect,`${bareName(table)}_batch_idx`);switch(dialect){case`postgres`:return`${table.includes(`.`)?`CREATE SCHEMA IF NOT EXISTS ${quoteTable(dialect,table.slice(0,table.lastIndexOf(`.`)))};\n `:``}CREATE TABLE IF NOT EXISTS ${T} (
|
|
39
|
+
"id" varchar(128) PRIMARY KEY,
|
|
40
|
+
"name" text NOT NULL,
|
|
41
|
+
"hash" text NOT NULL,
|
|
42
|
+
"batch" integer NOT NULL,
|
|
43
|
+
"applied_at" timestamptz NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
|
44
|
+
"direction" varchar(8) NOT NULL DEFAULT 'up'
|
|
45
|
+
);
|
|
46
|
+
CREATE INDEX IF NOT EXISTS ${idx} ON ${T} ("batch");`;case`sqlite`:return`CREATE TABLE IF NOT EXISTS ${T} (
|
|
47
|
+
"id" text PRIMARY KEY,
|
|
48
|
+
"name" text NOT NULL,
|
|
49
|
+
"hash" text NOT NULL,
|
|
50
|
+
"batch" integer NOT NULL,
|
|
51
|
+
"applied_at" text NOT NULL DEFAULT (datetime('now')),
|
|
52
|
+
"direction" text NOT NULL DEFAULT 'up'
|
|
53
|
+
);
|
|
54
|
+
CREATE INDEX IF NOT EXISTS ${idx} ON ${T} ("batch");`;case`mysql`:return`CREATE TABLE IF NOT EXISTS ${T} (
|
|
55
|
+
\`id\` varchar(128) PRIMARY KEY,
|
|
56
|
+
\`name\` text NOT NULL,
|
|
57
|
+
\`hash\` text NOT NULL,
|
|
58
|
+
\`batch\` int NOT NULL,
|
|
59
|
+
\`applied_at\` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
|
60
|
+
\`direction\` varchar(8) NOT NULL DEFAULT 'up',
|
|
61
|
+
INDEX ${idx} (\`batch\`)
|
|
62
|
+
);`}}function lockTableDdl(dialect,table=KICK_MIGRATIONS_TABLE){let L=quoteTable(dialect,lockTableName(table));switch(dialect){case`postgres`:return`CREATE TABLE IF NOT EXISTS ${L} (
|
|
63
|
+
"id" smallint PRIMARY KEY,
|
|
64
|
+
"locked_at" timestamptz,
|
|
65
|
+
"locked_by" text
|
|
66
|
+
);
|
|
67
|
+
INSERT INTO ${L} ("id") VALUES (1) ON CONFLICT DO NOTHING;`;case`sqlite`:return`CREATE TABLE IF NOT EXISTS ${L} (
|
|
68
|
+
"id" integer PRIMARY KEY,
|
|
69
|
+
"locked_at" text,
|
|
70
|
+
"locked_by" text
|
|
71
|
+
);
|
|
72
|
+
INSERT OR IGNORE INTO ${L} ("id") VALUES (1);`;case`mysql`:return`CREATE TABLE IF NOT EXISTS ${L} (
|
|
73
|
+
\`id\` smallint PRIMARY KEY,
|
|
74
|
+
\`locked_at\` timestamp NULL,
|
|
75
|
+
\`locked_by\` text
|
|
76
|
+
);
|
|
77
|
+
INSERT IGNORE INTO ${L} (\`id\`) VALUES (1);`}}var MemoryMigrationAdapter=class{dialect=`postgres`;rows=[];locked=null;appliedSql=[];currentSchema={version:1,dialect:`postgres`,tables:{}};async ensureMigrationTables(){}async listApplied(){return[...this.rows]}async recordApplied(row){this.rows.push({...row,appliedAt:new Date().toISOString()})}async removeApplied(id){this.rows=this.rows.filter(r=>r.id!==id)}async acquireLock(owner){return!this.locked&&(this.locked={by:owner,at:new Date().toISOString()},!0)}async releaseLock(){this.locked=null}async applySqlInTx(sql){this.appliedSql.push(sql)}async applyMigrationInTx(sql,bookkeeping){this.appliedSql.push(sql),bookkeeping&&`record`in bookkeeping?await this.recordApplied(bookkeeping.record):bookkeeping&&await this.removeApplied(bookkeeping.remove)}async applySqlNoTx(sql){this.appliedSql.push(sql)}async introspect(){return this.currentSchema}async close(){}__setIntrospectedSchema(snap){this.currentSchema=snap}__appliedSql(){return this.appliedSql}};const DEFAULT_EXCLUDED$2=[`kick_migrations`,`kick_migrations_lock`];async function introspectPg(client,opts={}){let schema=opts.schema??`public`,excluded=opts.excludeTables??DEFAULT_EXCLUDED$2,tableRows=await client.query(`SELECT table_name,
|
|
78
|
+
obj_description(format('%I.%I', table_schema, table_name)::regclass, 'pg_class')
|
|
79
|
+
AS comment
|
|
80
|
+
FROM information_schema.tables
|
|
81
|
+
WHERE table_schema = $1 AND table_type = 'BASE TABLE'
|
|
82
|
+
ORDER BY table_name`,[schema]),tables={};for(let t of tableRows.rows)excluded.includes(t.table_name)||(tables[t.table_name]={name:t.table_name,columns:await readColumns$2(client,schema,t.table_name),indexes:await readIndexes$2(client,schema,t.table_name),foreignKeys:await readForeignKeys$2(client,schema,t.table_name),checks:[],...t.comment===null?{}:{comment:t.comment},...await readRowLevelSecurity(client,schema,t.table_name)});let enums=await readEnums(client,schema),snapshot={version:1,dialect:`postgres`,tables},views=await readViews(client,schema);return Object.keys(views).length>0&&(snapshot.views=views),Object.keys(enums).length>0&&(snapshot.enums=enums),snapshot}async function readRowLevelSecurity(client,schema,table){let flags=await client.query(`SELECT relrowsecurity AS on, relforcerowsecurity AS force FROM pg_class
|
|
83
|
+
WHERE oid = format('%I.%I', $1::text, $2::text)::regclass`,[schema,table]),rows=await client.query(`SELECT policyname AS name, permissive, array_to_json(roles) AS roles, cmd, qual, with_check
|
|
84
|
+
FROM pg_policies WHERE schemaname = $1 AND tablename = $2 ORDER BY policyname`,[schema,table]),out={};return flags.rows[0]?.on&&(out.rls=flags.rows[0].force?{force:!0}:{}),rows.rows.length>0&&(out.policies=rows.rows.map(r=>({name:r.name,as:r.permissive===`RESTRICTIVE`?`restrictive`:`permissive`,command:r.cmd.toLowerCase(),to:r.roles,...r.qual===null?{}:{using:r.qual},...r.with_check===null?{}:{withCheck:r.with_check}}))),out}async function readViews(client,schema){let rows=await client.query(`SELECT viewname AS name, definition, false AS materialized
|
|
85
|
+
FROM pg_views WHERE schemaname = $1
|
|
86
|
+
UNION ALL
|
|
87
|
+
SELECT matviewname, definition, true FROM pg_matviews WHERE schemaname = $1
|
|
88
|
+
ORDER BY name`,[schema]),out={};for(let r of rows.rows){let cols=await client.query(`SELECT a.attname AS name, format_type(a.atttypid, a.atttypmod) AS type,
|
|
89
|
+
a.attnotnull AS notnull
|
|
90
|
+
FROM pg_attribute a
|
|
91
|
+
WHERE a.attrelid = format('%I.%I', $1::text, $2::text)::regclass
|
|
92
|
+
AND a.attnum > 0 AND NOT a.attisdropped
|
|
93
|
+
ORDER BY a.attnum`,[schema,r.name]),columns={};for(let c of cols.rows)columns[c.name]={name:c.name,type:viewColumnType(c.type),nullable:!c.notnull,default:null,primaryKey:!1};let v={name:r.name,definition:r.definition.trim().replace(/;$/,``),columns};if(r.materialized){v.materialized=!0;let indexes=await readIndexes$2(client,schema,r.name);indexes.length>0&&(v.indexes=indexes)}out[r.name]=v}return out}function viewColumnType(type){return type.replace(/^character varying/,`varchar`).replace(/^character\b/,`char`).replace(/^timestamp(\(\d+\))? without time zone$/,`timestamp`).replace(/^timestamp(\(\d+\))? with time zone$/,`timestamptz`).replace(/^time(\(\d+\))? without time zone$/,`time`).replace(/,(\S)/g,`, $1`)}async function readEnums(client,schema){let rows=await client.query(`SELECT t.typname AS enum_name, e.enumlabel AS enum_value
|
|
94
|
+
FROM pg_type t
|
|
95
|
+
JOIN pg_enum e ON e.enumtypid = t.oid
|
|
96
|
+
JOIN pg_namespace n ON n.oid = t.typnamespace
|
|
97
|
+
WHERE n.nspname = $1
|
|
98
|
+
ORDER BY t.typname, e.enumsortorder`,[schema]),out={};for(let r of rows.rows){let entry=out[r.enum_name];entry?entry.values.push(r.enum_value):out[r.enum_name]={name:r.enum_name,values:[r.enum_value]}}return out}async function readColumns$2(client,schema,table){let cols=await client.query(`SELECT column_name, data_type, udt_name, is_nullable, column_default,
|
|
99
|
+
character_maximum_length, numeric_precision, numeric_scale,
|
|
100
|
+
pg_get_serial_sequence(format('%I.%I', table_schema, table_name), column_name)
|
|
101
|
+
::regclass::text AS owned_sequence,
|
|
102
|
+
to_regclass(
|
|
103
|
+
(regexp_match(column_default, 'nextval\\(''([^'']+)''(::regclass)?\\)'))[1]
|
|
104
|
+
)::text AS default_sequence,
|
|
105
|
+
is_identity, identity_generation, generation_expression,
|
|
106
|
+
(SELECT a.attgenerated FROM pg_attribute a
|
|
107
|
+
WHERE a.attrelid = format('%I.%I', table_schema, table_name)::regclass
|
|
108
|
+
AND a.attname = column_name) AS attgenerated,
|
|
109
|
+
col_description(
|
|
110
|
+
format('%I.%I', table_schema, table_name)::regclass, ordinal_position::int
|
|
111
|
+
) AS comment
|
|
112
|
+
FROM information_schema.columns
|
|
113
|
+
WHERE table_schema = $1 AND table_name = $2
|
|
114
|
+
ORDER BY ordinal_position`,[schema,table]),pkCols=await client.query(`SELECT k.column_name
|
|
115
|
+
FROM information_schema.table_constraints c
|
|
116
|
+
JOIN information_schema.key_column_usage k
|
|
117
|
+
ON k.constraint_name = c.constraint_name
|
|
118
|
+
AND k.table_schema = c.table_schema
|
|
119
|
+
WHERE c.table_schema = $1 AND c.table_name = $2 AND c.constraint_type = 'PRIMARY KEY'
|
|
120
|
+
ORDER BY k.ordinal_position`,[schema,table]),pkSet=new Set(pkCols.rows.map(r=>r.column_name)),out={};for(let r of cols.rows){let isSerial=isSerialColumn(r);out[r.column_name]={name:r.column_name,type:isSerial?serialTypeFor(r):normalizeType$2(r),nullable:r.is_nullable===`YES`,default:isSerial?null:normalizeDefault(r.column_default),primaryKey:pkSet.has(r.column_name)},r.is_identity===`YES`&&(out[r.column_name].identity=r.identity_generation===`ALWAYS`?`always`:`byDefault`),r.comment!==null&&(out[r.column_name].comment=r.comment),r.attgenerated&&r.generation_expression&&(out[r.column_name].generated={expression:r.generation_expression,stored:r.attgenerated===`s`})}return out}function isSerialColumn(r){return!r.column_default||!r.column_default.startsWith(`nextval(`)||r.owned_sequence===null||r.owned_sequence!==r.default_sequence||r.is_nullable===`YES`?!1:r.udt_name===`int2`||r.udt_name===`int4`||r.udt_name===`int8`}function serialTypeFor(r){return r.udt_name===`int8`?`bigserial`:r.udt_name===`int2`?`smallserial`:`serial`}function normalizeType$2(r){return r.data_type===`character varying`?r.character_maximum_length?`varchar(${r.character_maximum_length})`:`varchar`:r.data_type===`character`?r.character_maximum_length?`char(${r.character_maximum_length})`:`char(1)`:r.data_type===`numeric`?r.numeric_precision!==null&&r.numeric_scale!==null?`numeric(${r.numeric_precision}, ${r.numeric_scale})`:r.numeric_precision===null?`numeric`:`numeric(${r.numeric_precision})`:r.data_type===`timestamp with time zone`?`timestamptz`:r.data_type===`timestamp without time zone`?`timestamp`:r.data_type===`time without time zone`?`time`:r.data_type===`double precision`?`double precision`:r.data_type===`USER-DEFINED`?r.udt_name:r.data_type===`ARRAY`?`${dslTypeForUdt(r.udt_name.replace(/^_/,``))}[]`:r.data_type}const UDT_TO_DSL={int2:`smallint`,int4:`integer`,int8:`bigint`,float4:`real`,float8:`double precision`,bool:`boolean`,bpchar:`char`,varchar:`varchar`,timestamp:`timestamp`,timestamptz:`timestamptz`,time:`time`,date:`date`};function dslTypeForUdt(udt){return UDT_TO_DSL[udt]??udt}function normalizeDefault(raw){if(!raw)return null;let stripped=raw.replace(/::[\w" ]+(\([^)]*\))?$/,``),upper=stripped.toUpperCase();return upper===`NOW()`||upper===`CURRENT_TIMESTAMP`?`CURRENT_TIMESTAMP`:upper===`GEN_RANDOM_UUID()`?`gen_random_uuid()`:stripped.replace(/^'(.*)'$/,`$1`)}async function readIndexes$2(client,schema,table){let rows=await client.query(`SELECT i.relname AS index_name,
|
|
121
|
+
COALESCE(a.attname, pg_get_indexdef(ix.indexrelid, k.ord::int, true)) AS key,
|
|
122
|
+
k.attnum = 0 AS is_expression,
|
|
123
|
+
k.ord > ix.indnkeyatts AS is_included,
|
|
124
|
+
ix.indisunique AS is_unique,
|
|
125
|
+
ix.indisprimary AS is_primary,
|
|
126
|
+
am.amname AS method,
|
|
127
|
+
pg_get_expr(ix.indpred, ix.indrelid, true) AS predicate
|
|
128
|
+
FROM pg_class t
|
|
129
|
+
JOIN pg_namespace n ON n.oid = t.relnamespace
|
|
130
|
+
JOIN pg_index ix ON ix.indrelid = t.oid
|
|
131
|
+
JOIN pg_class i ON i.oid = ix.indexrelid
|
|
132
|
+
JOIN pg_am am ON am.oid = i.relam
|
|
133
|
+
JOIN unnest(ix.indkey) WITH ORDINALITY AS k(attnum, ord) ON true
|
|
134
|
+
LEFT JOIN pg_attribute a ON a.attrelid = t.oid AND a.attnum = k.attnum AND k.attnum <> 0
|
|
135
|
+
WHERE n.nspname = $1 AND t.relname = $2 AND t.relkind IN ('r', 'm')
|
|
136
|
+
ORDER BY i.relname, k.ord`,[schema,table]),byIndex=new Map;for(let r of rows.rows){let entry=byIndex.get(r.index_name);entry||(entry={name:r.index_name,columns:[],unique:r.is_unique,_isPrimary:r.is_primary},r.method!==`btree`&&(entry.using=r.method),r.predicate&&(entry.where=r.predicate),byIndex.set(r.index_name,entry)),r.is_included?entry.include=[...entry.include??[],r.key]:entry.columns.push(r.is_expression?`(${r.key})`:r.key)}return[...byIndex.values()].filter(i=>!i._isPrimary).map(({_isPrimary,...rest})=>rest).toSorted((a,b)=>a.name.localeCompare(b.name))}async function readForeignKeys$2(client,schema,table){let rows=await client.query(`SELECT tc.constraint_name,
|
|
137
|
+
kcu.column_name,
|
|
138
|
+
ccu.table_name AS ref_table,
|
|
139
|
+
ccu.column_name AS ref_column,
|
|
140
|
+
rc.delete_rule,
|
|
141
|
+
rc.update_rule
|
|
142
|
+
FROM information_schema.table_constraints tc
|
|
143
|
+
JOIN information_schema.key_column_usage kcu
|
|
144
|
+
ON kcu.constraint_name = tc.constraint_name
|
|
145
|
+
AND kcu.table_schema = tc.table_schema
|
|
146
|
+
JOIN information_schema.referential_constraints rc
|
|
147
|
+
ON rc.constraint_name = tc.constraint_name
|
|
148
|
+
AND rc.constraint_schema = tc.table_schema
|
|
149
|
+
JOIN information_schema.constraint_column_usage ccu
|
|
150
|
+
ON ccu.constraint_name = rc.unique_constraint_name
|
|
151
|
+
AND ccu.constraint_schema = rc.unique_constraint_schema
|
|
152
|
+
WHERE tc.table_schema = $1
|
|
153
|
+
AND tc.table_name = $2
|
|
154
|
+
AND tc.constraint_type = 'FOREIGN KEY'
|
|
155
|
+
ORDER BY tc.constraint_name, kcu.ordinal_position`,[schema,table]),byName=new Map;for(let r of rows.rows){let fk=byName.get(r.constraint_name);fk||(fk={name:r.constraint_name,columns:[],refTable:r.ref_table,refColumns:[],onDelete:mapFkAction$2(r.delete_rule),onUpdate:mapFkAction$2(r.update_rule)},byName.set(r.constraint_name,fk)),fk.columns.push(r.column_name),fk.refColumns.push(r.ref_column)}return[...byName.values()].toSorted((a,b)=>a.name.localeCompare(b.name))}function mapFkAction$2(raw){switch(raw.toUpperCase()){case`CASCADE`:return`cascade`;case`RESTRICT`:return`restrict`;case`SET NULL`:return`set_null`;case`SET DEFAULT`:return`set_default`;default:return`no_action`}}const DEFAULT_EXCLUDED$1=[`kick_migrations`,`kick_migrations_lock`];function*rows$1(sql,...params){return yield{sql,params}}function*introspectSteps(opts){let excluded=opts.excludeTables??DEFAULT_EXCLUDED$1,tableRows=yield*rows$1(`SELECT name FROM sqlite_master
|
|
156
|
+
WHERE type = 'table' AND name NOT LIKE 'sqlite_%' AND name NOT LIKE '\\_cf\\_%' ESCAPE '\\'
|
|
157
|
+
ORDER BY name`),tables={};for(let{name}of tableRows)excluded.includes(name)||(tables[name]={name,columns:yield*readColumns$1(name),indexes:yield*readIndexes$1(name),foreignKeys:yield*readForeignKeys$1(name),checks:[]});let snapshot={version:1,dialect:`sqlite`,tables},viewRows=yield*rows$1(`SELECT name, sql FROM sqlite_master WHERE type = 'view' ORDER BY name`);if(viewRows.length>0){let views={};for(let v of viewRows)views[v.name]={name:v.name,definition:viewSelect(v.sql),columns:yield*readColumns$1(v.name)};snapshot.views=views}return snapshot}function introspectSqlite(db,opts={}){let walk=introspectSteps(opts),step=walk.next();for(;!step.done;)step=walk.next(db.prepare(step.value.sql).all(...step.value.params));return step.value}async function introspectSqliteAsync(query,opts={}){let walk=introspectSteps(opts),step=walk.next();for(;!step.done;)step=walk.next(await query(step.value.sql,step.value.params));return step.value}function viewSelect(statement){let i=0,s=statement,space=()=>{for(;i<s.length&&/\s/.test(s[i]);)i++},word=w=>(space(),s.slice(i,i+w.length).toUpperCase()===w&&!/\w/.test(s[i+w.length]??``)&&(i+=w.length,!0)),close={'"':`"`,"`":"`","[":`]`,"'":`'`},identifier=()=>{space();let end=close[s[i]];if(end){for(i++;i<s.length;i++)if(s[i]===end){if(s[i+1]===end&&end!==`]`)i++;else return void i++}return}for(;i<s.length&&/[\w$]/.test(s[i]);)i++};if(word(`CREATE`),word(`TEMPORARY`)||word(`TEMP`),word(`VIEW`),word(`IF`)&&(word(`NOT`),word(`EXISTS`)),identifier(),space(),s[i]===`.`&&(i++,identifier()),space(),s[i]===`(`)for(let depth=0;i<s.length;i++){let end=close[s[i]];if(end){for(i++;i<s.length;i++)if(s[i]===end){if(s[i+1]===end&&end!==`]`)i++;else break}continue}if(s[i]===`(`)depth++;else if(s[i]===`)`&&--depth===0){i++;break}}return word(`AS`),s.slice(i).trim().replace(/;$/,``)}function*readColumns$1(table){let list=yield*rows$1(`PRAGMA table_xinfo(${quote(table)})`),out={},createSql;for(let r of list){out[r.name]={name:r.name,type:normalizeType$1(r.type.replace(/\s+GENERATED\s+ALWAYS\b.*$/i,``)),nullable:Number(r.notnull)===0,default:r.dflt_value,primaryKey:Number(r.pk)>0};let hidden=Number(r.hidden??0);(hidden===2||hidden===3)&&(createSql??=(yield*rows$1(`SELECT sql FROM sqlite_master WHERE type = 'table' AND name = ?`,table))[0]?.sql,out[r.name].generated={expression:generatedExpression(createSql??``,r.name),stored:hidden===3})}return out}function*readIndexes$1(table){let list=yield*rows$1(`PRAGMA index_list(${quote(table)})`),out=[];for(let idx of list){if(idx.origin!==`c`)continue;let cols=(yield*rows$1(`PRAGMA index_info(${quote(idx.name)})`)).filter(c=>c.name!==null).map(c=>c.name),entry={name:idx.name,columns:cols,unique:Number(idx.unique)===1};if(Number(idx.partial)===1){let where=(yield*rows$1(`SELECT sql FROM sqlite_master WHERE type = 'index' AND name = ?`,idx.name))[0]?.sql?.match(/\bWHERE\b([\s\S]*)$/i)?.[1].trim();where&&(entry.where=where)}out.push(entry)}return out}function*readForeignKeys$1(table){let list=yield*rows$1(`PRAGMA foreign_key_list(${quote(table)})`),byId=new Map;for(let r of list){let g=byId.get(Number(r.id))??[];g.push(r),byId.set(Number(r.id),g)}let out=[];for(let[id,group]of byId){group.sort((a,b)=>Number(a.seq)-Number(b.seq));let first=group[0];out.push({name:`${table}_${group.map(g=>g.from).join(`_`)}_fk_${id}`,columns:group.map(g=>g.from),refTable:first.table,refColumns:group.map(g=>g.to),onDelete:mapFkAction$1(first.on_delete),onUpdate:mapFkAction$1(first.on_update)})}return out}function mapFkAction$1(action){switch(action.toUpperCase()){case`CASCADE`:return`cascade`;case`RESTRICT`:return`restrict`;case`SET NULL`:return`set_null`;case`SET DEFAULT`:return`set_default`;default:return`no_action`}}function normalizeType$1(declared){return declared.trim().toLowerCase()||`text`}function quote(name){return`"`+name.replace(/"/g,`""`)+`"`}function generatedExpression(createSql,column){let name=column.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`),start=RegExp(`["\`\\[]?${name}["\`\\]]?\\s[^,]*?GENERATED\\s+ALWAYS\\s+AS\\s*\\(`,`i`).exec(createSql);if(!start)return``;let depth=1,from=start.index+start[0].length;for(let i=from;i<createSql.length;i++)if(createSql[i]===`(`)depth++;else if(createSql[i]===`)`&&--depth===0)return createSql.slice(from,i).trim();return``}const DEFAULT_EXCLUDED=[`kick_migrations`,`kick_migrations_lock`];async function rows(db,sql,params){let[result]=await db.query(sql,params);return result}async function introspectMysql(db,opts={}){let excluded=opts.excludeTables??DEFAULT_EXCLUDED,tableRows=await rows(db,`SELECT TABLE_NAME, TABLE_COMMENT FROM information_schema.TABLES
|
|
158
|
+
WHERE TABLE_SCHEMA = DATABASE() AND TABLE_TYPE = 'BASE TABLE'
|
|
159
|
+
ORDER BY TABLE_NAME`,[]),tables={};for(let t of tableRows)excluded.includes(t.TABLE_NAME)||(tables[t.TABLE_NAME]={name:t.TABLE_NAME,columns:await readColumns(db,t.TABLE_NAME),indexes:await readIndexes(db,t.TABLE_NAME),foreignKeys:await readForeignKeys(db,t.TABLE_NAME),checks:[],...t.TABLE_COMMENT?{comment:t.TABLE_COMMENT}:{}});let snapshot={version:1,dialect:`mysql`,tables},viewRows=await rows(db,`SELECT TABLE_NAME, VIEW_DEFINITION FROM information_schema.VIEWS
|
|
160
|
+
WHERE TABLE_SCHEMA = DATABASE() ORDER BY TABLE_NAME`,[]);if(viewRows.length>0){let views={};for(let v of viewRows)views[v.TABLE_NAME]={name:v.TABLE_NAME,definition:v.VIEW_DEFINITION,columns:await readColumns(db,v.TABLE_NAME)};snapshot.views=views}return snapshot}async function readColumns(db,table){let cols=await rows(db,`SELECT COLUMN_NAME, DATA_TYPE, COLUMN_TYPE, IS_NULLABLE, COLUMN_DEFAULT, COLUMN_KEY, EXTRA,
|
|
161
|
+
COLUMN_COMMENT
|
|
162
|
+
FROM information_schema.COLUMNS
|
|
163
|
+
WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = ?
|
|
164
|
+
ORDER BY ORDINAL_POSITION`,[table]),out={};for(let c of cols)out[c.COLUMN_NAME]={name:c.COLUMN_NAME,type:normalizeType(c),nullable:c.IS_NULLABLE===`YES`,default:c.COLUMN_DEFAULT,primaryKey:c.COLUMN_KEY===`PRI`,...c.COLUMN_COMMENT?{comment:c.COLUMN_COMMENT}:{}};return out}async function readIndexes(db,table){let stats=await rows(db,`SELECT INDEX_NAME, COLUMN_NAME, EXPRESSION, NON_UNIQUE, SEQ_IN_INDEX, INDEX_TYPE
|
|
165
|
+
FROM information_schema.STATISTICS
|
|
166
|
+
WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = ? AND INDEX_NAME <> 'PRIMARY'
|
|
167
|
+
ORDER BY INDEX_NAME, SEQ_IN_INDEX`,[table]),byName=new Map;for(let r of stats){let e=byName.get(r.INDEX_NAME);e||(e={name:r.INDEX_NAME,columns:[],unique:r.NON_UNIQUE===0},r.INDEX_TYPE===`HASH`&&(e.using=`hash`),byName.set(r.INDEX_NAME,e)),e.columns.push(r.COLUMN_NAME??`(${r.EXPRESSION})`)}return[...byName.values()]}async function readForeignKeys(db,table){let fkRows=await rows(db,`SELECT k.CONSTRAINT_NAME, k.COLUMN_NAME,
|
|
168
|
+
k.REFERENCED_TABLE_NAME AS REF_TABLE, k.REFERENCED_COLUMN_NAME AS REF_COLUMN,
|
|
169
|
+
r.DELETE_RULE, r.UPDATE_RULE, k.ORDINAL_POSITION
|
|
170
|
+
FROM information_schema.KEY_COLUMN_USAGE k
|
|
171
|
+
JOIN information_schema.REFERENTIAL_CONSTRAINTS r
|
|
172
|
+
ON r.CONSTRAINT_SCHEMA = k.TABLE_SCHEMA AND r.CONSTRAINT_NAME = k.CONSTRAINT_NAME
|
|
173
|
+
WHERE k.TABLE_SCHEMA = DATABASE() AND k.TABLE_NAME = ?
|
|
174
|
+
AND k.REFERENCED_TABLE_NAME IS NOT NULL
|
|
175
|
+
ORDER BY k.CONSTRAINT_NAME, k.ORDINAL_POSITION`,[table]),byName=new Map;for(let r of fkRows){let g=byName.get(r.CONSTRAINT_NAME)??[];g.push(r),byName.set(r.CONSTRAINT_NAME,g)}let out=[];for(let[name,group]of byName){let first=group[0];out.push({name,columns:group.map(g=>g.COLUMN_NAME),refTable:first.REF_TABLE,refColumns:group.map(g=>g.REF_COLUMN),onDelete:mapFkAction(first.DELETE_RULE),onUpdate:mapFkAction(first.UPDATE_RULE)})}return out}function mapFkAction(action){switch(action.toUpperCase()){case`CASCADE`:return`cascade`;case`RESTRICT`:return`restrict`;case`SET NULL`:return`set_null`;case`SET DEFAULT`:return`set_default`;default:return`no_action`}}function normalizeType(c){let type=(c.COLUMN_TYPE||c.DATA_TYPE).trim(),values=/^(enum|set)\s*(\(.*\))$/is.exec(type);return values?`${values[1].toLowerCase()}${values[2]}`:type.toLowerCase()||`text`}const kickDbAdapter=defineAdapter({name:`kickjs-db`,build:config=>({async beforeStart({container}){let policy=config.migrationsOnBoot??`fail-if-pending`,pending=(await migrateStatus({adapter:config.migrationAdapter,migrationsDir:config.migrationsDir})).filter(s=>s.state===`pending`);if(pending.length>0){if(policy===`fail-if-pending`)throw Error(`kickjs-db: ${pending.length} pending migration(s); run \`kick db migrate latest\` before boot`);if(policy===`apply`){let result=await migrateLatest({adapter:config.migrationAdapter,migrationsDir:config.migrationsDir,requireReviewed:config.requireReviewed,driftCheck:config.driftCheck});config.bus&&config.bus.emit(`db:migration-applied`,{applied:result.applied,batch:result.batch})}}config.token&&container.registerFactory(config.token,()=>config.migrationAdapter)},async shutdown(){await config.migrationAdapter.close()}})}),DB_PRIMARY=createToken(`kick/db/primary`),DB_REPLICA=createToken(`kick/db/replica`),DB_CLIENT=DB_PRIMARY;var SafeNullComparisonTransformer=class extends OperationNodeTransformer{transformBinaryOperation(node){let transformed=super.transformBinaryOperation(node),{operator,leftOperand,rightOperand}=transformed;if(!OperatorNode.is(operator)||!ValueNode.is(rightOperand)||rightOperand.value!==null)return transformed;let op=operator.operator;return op!==`=`&&op!==`!=`&&op!==`<>`?transformed:BinaryOperationNode.create(leftOperand,OperatorNode.create(op===`=`?`is`:`is not`),ValueNode.createImmediate(null))}},SafeNullComparisonPlugin=class{#transformer=new SafeNullComparisonTransformer;transformQuery(args){return this.#transformer.transformNode(args.node)}async transformResult(args){return args.result}};function safeNullComparison(){return new SafeNullComparisonPlugin}async function migrateTenants(opts){let{tenants,adapterFor,concurrency=1,stopOnError=!1,onTenant,...runner}=opts,queue=[...typeof tenants==`function`?await tenants():tenants],results=[],stop=!1,migrateOne=async tenant=>{let result,adapter;try{adapter=await adapterFor(tenant),result={tenant,summary:await migrateLatest({...runner,adapter})}}catch(error){result={tenant,error},stopOnError&&(stop=!0)}finally{await adapter?.close().catch(()=>{})}results.push(result),onTenant?.(result)};return await Promise.all(Array.from({length:Math.max(1,concurrency)},async()=>{for(;;){let tenant=stop?void 0:queue.shift();if(tenant===void 0)return;await migrateOne(tenant)}})),{results,failed:results.filter(r=>r.error!==void 0).map(r=>r.tenant)}}async function reviewMigration(migrationsDir,id){let dir=path.join(migrationsDir,id),metaPath=path.join(dir,`meta.json`);if(!existsSync(metaPath))throw Error(`kickjs-db: migration '${id}' not found under ${migrationsDir}`);let meta=JSON.parse(await readFile(metaPath,`utf8`)),alreadyReviewed=meta.reviewed===!0;for(let file of[`up.sql`,`down.sql`]){let p=path.join(dir,file);if(!existsSync(p))continue;let sql=await readFile(p,`utf8`),next=sql.replace(/^-- REVIEWED: false$/m,`-- REVIEWED: true`);next!==sql&&await writeFile(p,next,`utf8`)}alreadyReviewed||(meta.reviewed=!0,await writeFile(metaPath,JSON.stringify(meta,null,2)+`
|
|
176
|
+
`,`utf8`));let journalPath=path.join(migrationsDir,`_journal.json`),journal=JSON.parse(await readFile(journalPath,`utf8`)),entry=journal.entries.find(e=>e.id===id);return entry&&(entry.hash=await computeMigrationHash(dir),await writeFile(journalPath,JSON.stringify(journal,null,2)+`
|
|
177
|
+
`,`utf8`)),{id,alreadyReviewed}}async function resolveDbConfig(opts){let abs=path.resolve(opts.configPath),mod=await import(pathToFileURL(abs).href),db=(mod.default??mod)?.db??{};return{schemaPath:db.schemaPath??`src/db/schema.ts`,migrationsDir:db.migrationsDir??`db/migrations`,seedsDir:db.seedsDir??`db/seeds`,dialect:db.dialect??`postgres`,connectionString:db.connectionString??process.env.DATABASE_URL,adapter:db.adapter,driftCheck:db.driftCheck}}function emitDdl(dialect,changes,from,to){switch(dialect){case`sqlite`:return emitSqlite(changes,{from,to});case`mysql`:return emitMysql(changes);case`postgres`:return emitPg(changes)}}async function generate(opts){let migrationsAbs=path.resolve(opts.cwd,opts.config.migrationsDir),{snapshot:prev,id:previousId}=await readLatestSnapshotEntry(migrationsAbs,opts.config.dialect);if(opts.empty||opts.typescript)return await writeMigration({opts,migrationsAbs,previousId,target:prev,upBody:``,downBody:``,changeCount:0,draft:!1,empty:!0,code:opts.typescript?CODE_MIGRATION_TEMPLATE:void 0});let schemaAbs=path.resolve(opts.cwd,opts.config.schemaPath),schemaModule=await loadModule(schemaAbs,{fresh:!0}),target=extractSnapshot(schemaModule,opts.config.dialect,{casing:opts.config.casing}),renames=await resolveRenames(prev,target,opts),changes=diff(prev,target,renames);if(!opts.askRenames&&opts.onPossibleRename&&warnPossibleRenames(prev,target,changes,renames,opts.onPossibleRename),changes.length===0)return{status:`no-changes`,changeCount:0};await assertNoCompositeReferences(changes,opts.detectCompositeRefs);let dialect=opts.config.dialect,concurrent=changes.filter(isConcurrentIndexChange),rest=changes.filter(c=>!concurrent.includes(c)),stages=[...rest.length>0?[{changes:rest,pending:concurrent}]:[],...concurrent.map((c,i)=>({changes:[c],pending:concurrent.slice(i+1)}))],from=prev,previous=previousId,result;for(let[n,{changes:stage,pending}]of stages.entries()){let to=snapshotAfter(target,pending);result=await writeMigration({opts:n===0?opts:withStageName(opts,n),migrationsAbs,previousId:previous,target:to,upBody:emitDdl(dialect,stage,from,to),downBody:emitDdl(dialect,invertChanges(stage),to,from),changeCount:stage.length,draft:hasAmbiguousReverse(stage),empty:!1,transaction:!isConcurrentIndexChange(stage[0])&&void 0}),from=to,previous=path.basename(result.migrationDir)}return{...result,changeCount:changes.length}}function warnPossibleRenames(prev,target,changes,{renames={}},warn){let options=to=>to.length===1?to[0]:`<${to.join(`|`)}>`,candidates=findRenameCandidates(withTableRenames(prev,target,renames.tables??{}),target);for(let c of candidates.tables)changes.some(x=>x.kind===`dropTable`&&snapshotTableName(x.table)===c.from)&&warn({what:`table ${c.from}`,flag:`--rename-table ${c.from}=${options(c.to)}`});for(let c of candidates.columns)changes.some(x=>x.kind===`dropColumn`&&x.table===c.table&&x.column.name===c.from)&&warn({what:`column ${c.table}.${c.from}`,flag:`--rename-column ${c.table}.${c.from}=${options(c.to)}`})}async function resolveRenames(prev,target,opts){let given=opts.renames??{};if(!opts.askRenames)return{renames:given};let tables={...given.tables},claimedTables=new Set(Object.values(tables)),tableCandidates=findRenameCandidates(prev,target).tables.filter(c=>!(c.from in tables)).map(c=>Object.assign(c,{to:c.to.filter(t=>!claimedTables.has(t))})).filter(c=>c.to.length>0);tableCandidates.length>0&&Object.assign(tables,(await opts.askRenames({tables:tableCandidates,columns:[]})).tables);let columns={...given.columns},claimedColumns=new Set(Object.entries(columns).map(([key,to])=>`${key.slice(0,key.lastIndexOf(`.`))}.${to}`)),renamed=withTableRenames(prev,target,tables),columnCandidates=findRenameCandidates(renamed,target).columns.filter(c=>!(`${c.table}.${c.from}`in columns)).map(c=>Object.assign(c,{to:c.to.filter(t=>!claimedColumns.has(`${c.table}.${t}`))})).filter(c=>c.to.length>0);return columnCandidates.length>0&&Object.assign(columns,(await opts.askRenames({tables:[],columns:columnCandidates})).columns),{renames:{tables,columns},explicitRenames:!0}}function isConcurrentIndexChange(c){return(c.kind===`addIndex`||c.kind===`dropIndex`)&&c.index.concurrently===!0}function snapshotAfter(target,pending){if(pending.length===0)return target;let tables=structuredClone(target.tables);for(let c of pending.toReversed()){if(c.kind!==`addIndex`&&c.kind!==`dropIndex`)continue;let t=tables[c.table],others=t.indexes.filter(i=>i.name!==c.index.name);t.indexes=c.kind===`addIndex`?others:[...others,c.index]}return{...target,tables}}function withStageName(opts,n){let at=(opts.now?.()??new Date).getTime()+n*1e3;return{...opts,name:`${opts.name}_concurrently_${n}`,now:()=>new Date(at)}}const CODE_MIGRATION_TEMPLATE=`import type { MigrationDb } from '@forinda/kickjs-db'
|
|
178
|
+
|
|
179
|
+
// Runs inside the migration's transaction. \`db\` is Kysely over the live
|
|
180
|
+
// schema — untyped on purpose, since the schema keeps changing after this
|
|
181
|
+
// migration is written.
|
|
182
|
+
export async function up(db: MigrationDb): Promise<void> {
|
|
183
|
+
// await db.updateTable('users').set({ status: 'active' }).where('status', 'is', null).execute()
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
export async function down(db: MigrationDb): Promise<void> {
|
|
187
|
+
// Reverse up(), or throw if it can't be.
|
|
188
|
+
}
|
|
189
|
+
`;function generatedBanner(){return`-- Generated by @forinda/kickjs-db v${ownPackageVersion()} — review state lives in meta.json\n`}let cachedVersion=null;function ownPackageVersion(){if(cachedVersion)return cachedVersion;let here=path.dirname(fileURLToPath(import.meta.url));for(let rel of[`../package.json`,`../../package.json`])try{let pkg=JSON.parse(readFileSync(path.resolve(here,rel),`utf8`));if(pkg.name===`@forinda/kickjs-db`&&pkg.version)return cachedVersion=pkg.version,cachedVersion}catch{}return cachedVersion=`unknown`,cachedVersion}async function writeMigration(p){let id=formatId(p.opts.now?.()??new Date,p.opts.name),dir=path.join(p.migrationsAbs,id);await mkdir(dir,{recursive:!0});let upSql=generatedBanner()+(p.code?`-- Written in TypeScript: migration.ts runs instead of this file.
|
|
190
|
+
`:p.empty?`-- Empty migration — author SQL below (data migration, seed, etc).
|
|
191
|
+
`:``)+p.upBody+(p.upBody?`
|
|
192
|
+
`:``);await writeFile(path.join(dir,`up.sql`),upSql,`utf8`);let downHeader=generatedBanner(),downDraft=p.draft?`-- DRAFT: ambiguous reverses present (drop column / drop table / type change). Audit before applying.
|
|
193
|
+
`:``,downHint=p.code?`-- Written in TypeScript: migration.ts runs instead of this file.
|
|
194
|
+
`:p.empty?`-- Empty migration — author the reverse SQL here.
|
|
195
|
+
`:``,downSql=downHeader+downDraft+downHint+p.downBody+(p.downBody?`
|
|
196
|
+
`:``);await writeFile(path.join(dir,`down.sql`),downSql,`utf8`),await writeFile(path.join(dir,`snapshot.json`),JSON.stringify(p.target,null,2)+`
|
|
197
|
+
`,`utf8`),p.code&&await writeFile(path.join(dir,`migration.ts`),p.code,`utf8`),await writeFile(path.join(dir,`meta.json`),JSON.stringify({id,name:p.opts.name,createdAt:(p.opts.now?.()??new Date).toISOString(),reviewed:!1,dialect:p.opts.config.dialect,previousId:p.previousId,downIsDraft:p.draft,empty:p.empty,...p.transaction===!1?{transaction:!1}:{}},null,2)+`
|
|
198
|
+
`,`utf8`);let hash=await computeMigrationHash(dir);return await appendJournalEntry(p.migrationsAbs,p.opts.config.dialect,{id,tag:p.opts.name,hash,createdAt:(p.opts.now?.()??new Date).toISOString()}),{status:`created`,migrationDir:dir,changeCount:p.changeCount,empty:p.empty}}async function readLatestSnapshotEntry(migrationsDir,dialect){let empty={version:1,dialect,tables:{}};if(!existsSync(migrationsDir))return{snapshot:empty,id:null};let dirs=(await readdir(migrationsDir)).filter(e=>/^\d{8}_\d{6}_/.test(e)).toSorted();if(dirs.length===0)return{snapshot:empty,id:null};let latest=dirs[dirs.length-1],file=path.join(migrationsDir,latest,`snapshot.json`);return{snapshot:JSON.parse(await readFile(file,`utf8`)),id:latest}}async function assertNoCompositeReferences(changes,detect){if(!detect)return;let removals=changes.filter(c=>c.kind===`removeEnumValue`);if(removals.length===0)return;let allRefs=[],seen=new Set;for(let r of removals){if(seen.has(r.enum))continue;seen.add(r.enum);let refs=await detect(r.enum);allRefs.push(...refs)}if(allRefs.length>0)throw new CompositeEnumReferenceError(allRefs)}function formatId(date,name){let pad=n=>n.toString().padStart(2,`0`);return`${date.getUTCFullYear().toString()+pad(date.getUTCMonth()+1)+pad(date.getUTCDate())+`_`+pad(date.getUTCHours())+pad(date.getUTCMinutes())+pad(date.getUTCSeconds())}_${name.replace(/[^a-z0-9]+/gi,`_`).toLowerCase()}`}async function checkMigrations(opts){let{snapshot:prev}=await readLatestSnapshotEntry(path.resolve(opts.cwd,opts.config.migrationsDir),opts.config.dialect),schemaModule=await loadModule(path.resolve(opts.cwd,opts.config.schemaPath),{fresh:!0}),unmigratedChanges=diff(prev,extractSnapshot(schemaModule,opts.config.dialect,{casing:opts.config.casing})).length,unreviewed=[],modified=[],folders=[opts.config.migrationsDir,...opts.config.migrationsDirs??[]].map(d=>path.resolve(opts.cwd,d));for(let folder of folders)if(existsSync(folder))for(let entry of(await readJournal(folder,opts.config.dialect)).entries){let dir=path.join(folder,entry.id);JSON.parse(await readFile(path.join(dir,`meta.json`),`utf8`)).reviewed===!0?await computeMigrationHash(dir)!==entry.hash&&modified.push(entry.id):unreviewed.push(entry.id)}return{unmigratedChanges,unreviewed,modified,ok:unmigratedChanges===0&&unreviewed.length===0&&modified.length===0}}const SEED_FILE=/\.(?:[cm]?[jt]s)$/;async function listSeeds(dir){return existsSync(dir)?(await readdir(dir)).filter(f=>SEED_FILE.test(f)&&!f.endsWith(`.d.ts`)&&!/\.test\.[cm]?[jt]s$/.test(f)).toSorted():[]}async function runSeeds(opts){let all=await listSeeds(opts.dir),strip=f=>f.replace(SEED_FILE,``),byBase=new Map;for(let f of all)byBase.set(strip(f),[...byBase.get(strip(f))??[],f]);let clashes=[...byBase.values()].filter(files=>files.length>1);if(clashes.length>0)throw new KickDbError(`KICK_DB_SEED_DUPLICATE`,`Seeds share a name: ${clashes.map(c=>c.join(` and `)).join(`; `)} in ${opts.dir} — keep one of each`);let wanted=opts.names?.length?new Set(opts.names.map(strip)):null,files=wanted?all.filter(f=>wanted.has(strip(f))):all;if(wanted){let missing=[...wanted].filter(n=>!files.some(f=>strip(f)===n));if(missing.length>0)throw new KickDbError(`KICK_DB_SEED_NOT_FOUND`,`No seed named ${missing.join(`, `)} in ${opts.dir}`)}let ran=[];for(let file of files){let mod;try{mod=await loadModule(path.join(opts.dir,file))}catch(cause){let err=new KickDbError(`KICK_DB_SEED_FAILED`,`Seed ${file} failed to load: ${cause instanceof Error?cause.message:String(cause)}`);throw err.cause=cause,err}if(typeof mod.default!=`function`)throw new KickDbError(`KICK_DB_SEED_INVALID`,`Seed ${file} must default-export a function: export default async function seed() { … }`);try{await mod.default()}catch(cause){let err=new KickDbError(`KICK_DB_SEED_FAILED`,`Seed ${file} failed: ${cause instanceof Error?cause.message:String(cause)}`);throw err.cause=cause,err}ran.push(file)}return{ran}}function brandGenerated(col){return col}function brandNotNull(col){return col}function formatNumeric(base,precision,scale){return precision===void 0?base:scale===void 0?`${base}(${precision})`:`${base}(${precision}, ${scale})`}function serial(){return brandNotNull(brandGenerated(new ColumnBuilder(`serial`,{nullable:!1})))}function bigSerial(){return brandNotNull(brandGenerated(new ColumnBuilder(`bigserial`,{nullable:!1})))}function smallSerial(){return brandNotNull(brandGenerated(new ColumnBuilder(`smallserial`,{nullable:!1})))}function integer(){return new ColumnBuilder(`integer`)}function bigint(options){return new ColumnBuilder(`bigint`,options?{mode:options.mode}:{})}function smallint(){return new ColumnBuilder(`smallint`)}function version(){let col=integer().notNull().default(0);return col.state.managed=`version`,col}function decimal(precision,scale,options){return new ColumnBuilder(formatNumeric(`decimal`,precision,scale),options?{mode:options.mode}:{})}function numeric(precision,scale,options){return new ColumnBuilder(formatNumeric(`numeric`,precision,scale),options?{mode:options.mode}:{})}function real(){return new ColumnBuilder(`real`)}function doublePrecision(){return new ColumnBuilder(`double precision`)}function varchar(length=255){return new ColumnBuilder(`varchar(${length})`)}function char(length=1){return new ColumnBuilder(`char(${length})`)}function text(){return new ColumnBuilder(`text`)}function boolean(){return new ColumnBuilder(`boolean`)}var TimestampBuilder=class extends ColumnBuilder{constructor(typeName=`timestamp`){super(typeName)}defaultNow(){return this.state.default=`CURRENT_TIMESTAMP`,brandGenerated(this)}};function timestamp(){return new TimestampBuilder(`timestamp`)}function timestamptz(){return new TimestampBuilder(`timestamptz`)}function date(){return new ColumnBuilder(`date`)}function time(){return new ColumnBuilder(`time`)}function interval(){return new ColumnBuilder(`interval`)}var UuidBuilder=class extends ColumnBuilder{constructor(){super(`uuid`)}defaultRandom(){return this.state.default=`gen_random_uuid()`,brandGenerated(this)}};function uuid(){return new UuidBuilder}function json(){return new ColumnBuilder(`json`)}function jsonb(){return new ColumnBuilder(`jsonb`)}function bytea(){return new ColumnBuilder(`bytea`)}const SCHEMA_NAME=/^[A-Za-z_][A-Za-z0-9_$]*$/;function pgSchema(name){if(typeof name!=`string`||!SCHEMA_NAME.test(name))throw Error(`pgSchema: invalid schema name ${JSON.stringify(name)}. Expected an unquoted PostgreSQL identifier matching ${SCHEMA_NAME.source}.`);let effective=name===`public`?void 0:name;return{__isPgSchema:!0,name,table(tableName,columns,options){return buildTable(tableName,columns,options,effective)}}}function isPgSchema(value){return typeof value==`object`&&!!value&&value.__isPgSchema===!0}function build(name,columns,schema,constraints,rules){let decl=schema?pgSchema(schema).table(name,columns,constraints):table(name,columns,constraints);return Object.keys(rules).length>0&&Object.defineProperty(decl,"__rules",{value:{...rules},enumerable:!1}),decl}const FIELD_RULES=Symbol.for(`@forinda/kickjs-db/field-rules`),CLASS_TABLE=Symbol.for(`@forinda/kickjs-db/class-table`);function Rule(rule){return(prototype,key)=>{let ctor=prototype.constructor;Object.hasOwn(ctor,FIELD_RULES)||(ctor[FIELD_RULES]={...ctor[FIELD_RULES]}),ctor[FIELD_RULES][key]=rule}}function tableFromClass(cls){let meta=cls;if(!Object.hasOwn(meta,CLASS_TABLE)){let instance=new cls,columns={};for(let[key,value]of Object.entries(instance))value instanceof ColumnBuilder&&(columns[key]=value);if(Object.keys(columns).length===0)throw Error(`${cls.name} has no column fields`);let rules=meta[FIELD_RULES]??{};meta[CLASS_TABLE]=build(cls.tableName,columns,cls.schema,cls.indexes,rules)}return meta[CLASS_TABLE]}function TableBase(name,columns,options={}){let decl=build(name,columns,options.schema,options.indexes,options.rules??{});class Base{static table=decl;static from(row){return Object.assign(new this,row)}}return Base}var TableDefinition=class TableDefinition{name;schema;columns;columnRules;constraints;built;constructor(name,schema,columns,columnRules,constraints,built){this.name=name,this.schema=schema,this.columns=columns,this.columnRules=columnRules,this.constraints=constraints,this.built=built}column(key,builder,rule){let resolved=typeof builder==`function`?builder(this.lazyRefs()):builder;return new TableDefinition(this.name,this.schema,{...this.columns,[key]:resolved},rule?{...this.columnRules,[key]:rule}:this.columnRules,this.constraints,this.built)}index(constraints){let previous=this.constraints,next=constraints,combined=previous?refs=>({...previous(refs),...next(refs)}):next;return new TableDefinition(this.name,this.schema,this.columns,this.columnRules,combined,this.built)}build(){let decl=build(this.name,this.columns,this.schema,this.constraints,this.columnRules);return this.built.decl=decl,decl}lazyRefs(){let built=this.built,owner=this.schema&&this.schema!==`public`?`${this.schema}.${this.name}`:this.name;return new Proxy({},{get:(_,key)=>({__tableName:owner,__name:key,get __builder(){return built.decl[key].__builder},__state:()=>built.decl[key].__state()})})}};function defineTable(name,options={}){return new TableDefinition(name,options.schema,{},{},void 0,{})}function fk(builder,target,options={}){return builder.references(target,options)}function link(column,target,options={}){column.__builder.references(target,options)}function keyName(key){return typeof key==`string`?`(${key})`:key.__name}var IndexDecl=class{__index;constructor(name,keys,unique){this.__index={name,columns:keys.map(keyName),unique}}where(predicate){return this.__index.where=predicate,this}using(method){return this.__index.using=method,this}include(...cols){return this.__index.include=cols.map(c=>c.__name),this}op(key,opclass){let name=keyName(key);if(!this.__index.columns.includes(name))throw Error(`kickjs-db: index '${this.__index.name}' has no key ${name} to give op()`);return this.__index.opclasses={...this.__index.opclasses,[name]:opclass},this}concurrently(){return this.__index.concurrently=!0,this}};function index(name){return{on(...keys){return new IndexDecl(name,keys,!1)}}}function unique(name){return{on(...keys){return new IndexDecl(name,keys,!0)}}}function primaryKey(name){return{on(...cols){return name===void 0?{kind:`primaryKey`,columns:cols.map(c=>c.__name)}:{kind:`primaryKey`,name,columns:cols.map(c=>c.__name)}}}}function check(name,expression){return{kind:`check`,name,expression}}function alias(table,name){let refs={};for(let[key,builder]of Object.entries(table.__columns))refs[key]={__tableName:name,__name:key,__builder:builder,__state:()=>builder.__state()};return refs.$from=`${qualifiedTableName(table)} as ${name}`,refs}function isExpression(value){return typeof value==`object`&&!!value&&typeof value.toOperationNode==`function`}function isColumnRef(value){return typeof value==`object`&&!!value&&typeof value.__tableName==`string`&&typeof value.__name==`string`}function toSql(operand){return isExpression(operand)?operand:isColumnRef(operand)?sql.ref(`${operand.__tableName}.${operand.__name}`):sql.val(operand)}function binary(op){return(left,right)=>sql`${toSql(left)} ${sql.raw(op)} ${toSql(right)}`}const eq=binary(`=`),ne=binary(`<>`),gt=binary(`>`),gte=binary(`>=`),lt=binary(`<`),lte=binary(`<=`),like=(left,pattern)=>sql`${toSql(left)} like ${toSql(pattern)}`,notLike=(left,pattern)=>sql`${toSql(left)} not like ${toSql(pattern)}`,ilike=(left,pattern)=>sql`${toSql(left)} ilike ${toSql(pattern)}`,isNull=operand=>sql`${toSql(operand)} is null`,isNotNull=operand=>sql`${toSql(operand)} is not null`;function inArray(left,values){return values.length===0?sql`1 = 0`:sql`${toSql(left)} in (${sql.join(values.map(toSql))})`}function notInArray(left,values){return values.length===0?sql`1 = 1`:sql`${toSql(left)} not in (${sql.join(values.map(toSql))})`}const between=(left,low,high)=>sql`${toSql(left)} between ${toSql(low)} and ${toSql(high)}`;function and(...conditions){return combine(conditions,`and`,sql`1 = 1`)}function or(...conditions){return combine(conditions,`or`,sql`1 = 0`)}function combine(conditions,op,empty){let present=conditions.filter(c=>c!==void 0);return present.length===0?empty:sql`(${sql.join(present,sql.raw(` ${op} `))})`}const not=condition=>sql`not (${condition})`,exists=subquery=>sql`exists ${subquery}`,notExists=subquery=>sql`not exists ${subquery}`;function relations(source,builder){return{__isRelations:!0,__sourceTable:source.__name,__relations:builder({one:(target,opts)=>({kind:`one`,target,fields:opts.fields,references:opts.references,...opts.relationName===void 0?{}:{relationName:opts.relationName}}),many:(target,opts)=>({kind:`many`,target,...opts?.relationName===void 0?{}:{relationName:opts.relationName},...opts?.through===void 0?{}:{through:opts.through}})})}}function escapeLike(input,escapeChar=`\\`){if(escapeChar.length!==1||escapeChar===`%`||escapeChar===`_`)throw Error(`escapeLike: escapeChar must be a single character other than '%' or '_'`);let e=escapeChar;return input.replaceAll(e,e+e).replaceAll(`%`,e+`%`).replaceAll(`_`,e+`_`)}function likePattern(input,mode=`contains`,escapeChar=`\\`){let safe=escapeLike(input,escapeChar);switch(mode){case`contains`:return`%${safe}%`;case`startsWith`:return`${safe}%`;case`endsWith`:return`%${safe}`;case`exact`:return safe;default:throw Error(`likePattern: unsupported match mode ${String(mode)}`)}}function desc(expression){return sql`${expression} desc`}function asc(expression){return sql`${expression} asc`}export{jsonb as $,unique as A,KICK_MIGRATIONS_TABLE as At,TimestampBuilder as B,notLike as C,kickDbAdapter as Ct,check as D,introspectPg as Dt,IndexDecl as E,introspectSqliteAsync as Et,fk as F,CompositeEnumReferenceError as Ft,bytea as G,bigSerial as H,link as I,detectCompositeReferences as It,decimal as J,char as K,tableFromClass as L,hasAmbiguousReverse as Lt,TableBase as M,lockTableName as Mt,TableDefinition as N,migrationsTableDdl as Nt,index as O,MemoryMigrationAdapter as Ot,defineTable as P,quoteTable as Pt,json as Q,isPgSchema as R,invertChanges as Rt,notInArray as S,DB_REPLICA as St,alias as T,introspectSqlite as Tt,bigint as U,UuidBuilder as V,boolean as W,integer as X,doublePrecision as Y,interval as Z,lt as _,reviewMigration as _t,relations as a,text as at,not as b,DB_CLIENT as bt,eq as c,timestamptz as ct,gte as d,version as dt,numeric as et,ilike as f,listSeeds as ft,like as g,resolveDbConfig as gt,isNull as h,generate as ht,likePattern as i,smallint as it,Rule as j,lockTableDdl as jt,primaryKey as k,KICK_LOCK_TABLE as kt,exists as l,uuid as lt,isNotNull as m,checkMigrations as mt,desc as n,serial as nt,and as o,time as ot,inArray as p,runSeeds as pt,date as q,escapeLike as r,smallSerial as rt,between as s,timestamp as st,asc as t,real as tt,gt as u,varchar as ut,lte as v,migrateTenants as vt,or as w,introspectMysql as wt,notExists as x,DB_PRIMARY as xt,ne as y,safeNullComparison as yt,pgSchema as z,renderSchemaSource as zt};
|
|
199
|
+
//# sourceMappingURL=src-DUtVGG2c.mjs.map
|