@forinda/kickjs-db 6.0.0 → 6.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/bin/kickjs-db.mjs +87 -0
- package/dist/cli.d.mts +71 -0
- package/dist/cli.d.mts.map +1 -0
- package/dist/cli.mjs +13 -0
- package/dist/cli.mjs.map +1 -0
- package/dist/devtools-events.mjs +1 -1
- package/dist/index-B1r7mcA1.d.mts +1320 -0
- package/dist/index-B1r7mcA1.d.mts.map +1 -0
- package/dist/index.d.mts +2 -1002
- package/dist/index.mjs +2 -124
- package/dist/mysql.d.mts +165 -0
- package/dist/mysql.d.mts.map +1 -0
- package/dist/mysql.mjs +20 -0
- package/dist/mysql.mjs.map +1 -0
- package/dist/pg.d.mts +84 -2
- package/dist/pg.d.mts.map +1 -1
- package/dist/pg.mjs +9 -2
- package/dist/pg.mjs.map +1 -1
- package/dist/sqlite.d.mts +84 -0
- package/dist/sqlite.d.mts.map +1 -0
- package/dist/sqlite.mjs +19 -0
- package/dist/sqlite.mjs.map +1 -0
- package/dist/src-lL141oWK.mjs +158 -0
- package/dist/src-lL141oWK.mjs.map +1 -0
- package/package.json +41 -22
- package/dist/index.d.mts.map +0 -1
- package/dist/index.mjs.map +0 -1
- package/dist/types-C1VwEYWD.d.mts +0 -196
- package/dist/types-C1VwEYWD.d.mts.map +0 -1
- package/dist/types-CnOQetrD.mjs +0 -12
- package/dist/types-CnOQetrD.mjs.map +0 -1
package/dist/pg.d.mts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
|
|
2
|
-
import {
|
|
2
|
+
import { Qt as MigrationAdapter, xt as ColumnBuilder } from "./index-B1r7mcA1.mjs";
|
|
3
|
+
import { Dialect } from "kysely";
|
|
3
4
|
|
|
4
5
|
//#region src/dsl/columns/pg.d.ts
|
|
5
6
|
/**
|
|
@@ -49,5 +50,86 @@ declare function inet(): ColumnBuilder<string>;
|
|
|
49
50
|
declare function cidr(): ColumnBuilder<string>;
|
|
50
51
|
declare function xml(): ColumnBuilder<string>;
|
|
51
52
|
//#endregion
|
|
52
|
-
|
|
53
|
+
//#region src/adapters/pg/adapter.d.ts
|
|
54
|
+
/**
|
|
55
|
+
* Minimal client returned by PgPoolLike.connect(). Matches the shape of
|
|
56
|
+
* pg.PoolClient and @neondatabase/serverless's PoolClient.
|
|
57
|
+
*/
|
|
58
|
+
interface PgClientLike {
|
|
59
|
+
query<R = unknown>(sql: string, params?: readonly unknown[]): Promise<{
|
|
60
|
+
rows: R[];
|
|
61
|
+
rowCount: number | null;
|
|
62
|
+
}>;
|
|
63
|
+
release(): void;
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* Pool-shaped contract that pgAdapter consumes. Both `pg.Pool` and
|
|
67
|
+
* `@neondatabase/serverless`'s Pool match this structurally — no hard
|
|
68
|
+
* dependency on the `pg` package. Adopters pick whichever pg-protocol-
|
|
69
|
+
* compatible client fits their runtime (node-postgres / neon-serverless /
|
|
70
|
+
* pg-cloudflare / etc).
|
|
71
|
+
*
|
|
72
|
+
* Edge runtimes with a different surface (Neon HTTP single-shot,
|
|
73
|
+
* Cloudflare D1's batch-only model) have their own adapter packages that
|
|
74
|
+
* implement MigrationAdapter directly — they don't reuse this shape.
|
|
75
|
+
*/
|
|
76
|
+
interface PgPoolLike {
|
|
77
|
+
query<R = unknown>(sql: string, params?: readonly unknown[]): Promise<{
|
|
78
|
+
rows: R[];
|
|
79
|
+
rowCount: number | null;
|
|
80
|
+
}>;
|
|
81
|
+
connect(): Promise<PgClientLike>;
|
|
82
|
+
}
|
|
83
|
+
interface PgAdapterOptions {
|
|
84
|
+
/**
|
|
85
|
+
* A pg-protocol-compatible Pool. Concretely: pg.Pool, neon-serverless Pool,
|
|
86
|
+
* any other Pool that satisfies the {@link PgPoolLike} structural shape.
|
|
87
|
+
*/
|
|
88
|
+
pool: PgPoolLike;
|
|
89
|
+
/** PG schema name to scope the introspector and validate at construction. Default 'public'. */
|
|
90
|
+
schema?: string;
|
|
91
|
+
}
|
|
92
|
+
/**
|
|
93
|
+
* MigrationAdapter implementation backed by node-postgres. The pool is
|
|
94
|
+
* caller-owned — close() does NOT end() the pool because adopters typically
|
|
95
|
+
* share a single pool across the migrationAdapter and the KickDbClient.
|
|
96
|
+
*
|
|
97
|
+
* Lock semantics: single-row UPDATE WHERE locked_at IS NULL on
|
|
98
|
+
* kick_migrations_lock. Only the row created by ensureMigrationTables()
|
|
99
|
+
* exists, so the UPDATE either flips locked_at and returns rowCount=1
|
|
100
|
+
* (we won) or matches zero rows (someone else holds it).
|
|
101
|
+
*/
|
|
102
|
+
declare function pgAdapter(opts: PgAdapterOptions): MigrationAdapter;
|
|
103
|
+
//#endregion
|
|
104
|
+
//#region src/adapters/pg/dialect.d.ts
|
|
105
|
+
interface PgDialectOptions {
|
|
106
|
+
/**
|
|
107
|
+
* pg-protocol-compatible pool. Both `pg.Pool` and
|
|
108
|
+
* `@neondatabase/serverless`'s Pool match structurally; adopters
|
|
109
|
+
* pick whichever runtime fits.
|
|
110
|
+
*/
|
|
111
|
+
pool: PgPoolLike;
|
|
112
|
+
}
|
|
113
|
+
/**
|
|
114
|
+
* Construct the dialect that `createDbClient({ dialect })` consumes.
|
|
115
|
+
*
|
|
116
|
+
* @example
|
|
117
|
+
* ```ts
|
|
118
|
+
* import { createDbClient } from '@forinda/kickjs-db'
|
|
119
|
+
* import { pgDialect, pgAdapter } from '@forinda/kickjs-db/pg'
|
|
120
|
+
* import { Pool } from 'pg'
|
|
121
|
+
*
|
|
122
|
+
* const pool = new Pool({ connectionString: process.env.DATABASE_URL })
|
|
123
|
+
*
|
|
124
|
+
* export const db = createDbClient({
|
|
125
|
+
* schema,
|
|
126
|
+
* dialect: pgDialect({ pool }),
|
|
127
|
+
* })
|
|
128
|
+
*
|
|
129
|
+
* export const migrationAdapter = pgAdapter({ pool })
|
|
130
|
+
* ```
|
|
131
|
+
*/
|
|
132
|
+
declare function pgDialect(opts: PgDialectOptions): Dialect;
|
|
133
|
+
//#endregion
|
|
134
|
+
export { PgAdapterOptions, PgClientLike, PgDialectOptions, PgEnumBuilder, PgEnumColumnBuilder, PgPoolLike, cidr, citext, inet, money, pgAdapter, pgDialect, pgEnum, tsvector, vector, xml };
|
|
53
135
|
//# sourceMappingURL=pg.d.mts.map
|
package/dist/pg.d.mts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pg.d.mts","names":[],"sources":["../src/dsl/columns/pg.ts"],"mappings":"
|
|
1
|
+
{"version":3,"file":"pg.d.mts","names":[],"sources":["../src/dsl/columns/pg.ts","../src/adapters/pg/adapter.ts","../src/adapters/pg/dialect.ts"],"mappings":";;;;;;;;AA8BA;;;;;;;;;;;;;;;;;;;;AAK0B;UALT,aAAA;EAAA,IACX,mBAAA,CAAoB,KAAA,EAAO,OAAA;EAOD;EAAA,SALrB,QAAA,EAAU,KAAA;EAUA;EAAA,SARV,MAAA,EAAQ,OAAA;AAAA;AAAA,cAGN,mBAAA,kEAGH,aAAA,CAAc,OAAA;EAAd;EAAA,SAEC,QAAA,EAAU,KAAA;EAFE;EAAA,SAIZ,MAAA,EAAQ,OAAA;EAEjB,WAAA,CAAY,QAAA,EAAU,KAAA,EAAO,MAAA,EAAQ,OAAA;AAAA;AAAA,iBAgBvB,MAAA,6EACd,IAAA,EAAM,KAAA,KACH,MAAA,EAAQ,OAAA,GACV,aAAA,CAAc,KAAA,EAAO,OAAA;AAAA,iBASR,QAAA,IAAY,aAAa;AAAA,iBAIzB,MAAA,CAAO,GAAA,YAAe,aAAa;AAAA,iBAInC,MAAA,IAAU,aAAa;AAAA,iBAIvB,KAAA,IAAS,aAAa;AAAA,iBAItB,IAAA,IAAQ,aAAa;AAAA,iBAIrB,IAAA,IAAQ,aAAa;AAAA,iBAIrB,GAAA,IAAO,aAAa;;;;;;AArEpC;UChBiB,YAAA;EACf,KAAA,cACE,GAAA,UACA,MAAA,wBACC,OAAO;IAAG,IAAA,EAAM,CAAA;IAAK,QAAA;EAAA;EACxB,OAAA;AAAA;;;;;;;;;;;;UAce,UAAA;EACf,KAAA,cACE,GAAA,UACA,MAAA,wBACC,OAAA;IAAU,IAAA,EAAM,CAAA;IAAK,QAAA;EAAA;EACxB,OAAA,IAAW,OAAA,CAAQ,YAAA;AAAA;AAAA,UAGJ,gBAAA;EDMO;;;;ECDtB,IAAA,EAAM,UAAU;EDPhB;ECSA,MAAA;AAAA;;;;;;;;;;;iBAec,SAAA,CAAU,IAAA,EAAM,gBAAA,GAAmB,gBAAgB;;;UCrDlD,gBAAA;;AFoBjB;;;;EEdE,IAAA,EAAM,UAAU;AAAA;;;;;;;;;;;;;;;AFmBQ;AAG1B;;;;iBEAgB,SAAA,CAAU,IAAA,EAAM,gBAAA,GAAmB,OAAa"}
|
package/dist/pg.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-db v6.
|
|
2
|
+
* @forinda/kickjs-db v6.1.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,5 +8,12 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{
|
|
11
|
+
import{L as ColumnBuilder,at as lockTableDdl,ot as migrationsTableDdl,tt as introspectPg}from"./src-lL141oWK.mjs";import{PostgresDialect}from"kysely";var PgEnumColumnBuilder=class extends ColumnBuilder{enumName;values;constructor(enumName,values){super(enumName),this.enumName=enumName,this.values=values}};function pgEnum(name,...values){return Object.assign(()=>new PgEnumColumnBuilder(name,values),{enumName:name,values})}function tsvector(){return new ColumnBuilder(`tsvector`)}function vector(dim){return new ColumnBuilder(dim===void 0?`vector`:`vector(${dim})`)}function citext(){return new ColumnBuilder(`citext`)}function money(){return new ColumnBuilder(`money`)}function inet(){return new ColumnBuilder(`inet`)}function cidr(){return new ColumnBuilder(`cidr`)}function xml(){return new ColumnBuilder(`xml`)}const SAFE_SCHEMA_NAME=/^[a-z_][a-z0-9_]*$/i;function pgAdapter(opts){let dialect=`postgres`,{pool}=opts,schema=opts.schema??`public`;if(!SAFE_SCHEMA_NAME.test(schema))throw Error(`Invalid PG schema name: ${schema}`);return{dialect,async ensureMigrationTables(){await pool.query(migrationsTableDdl(dialect)),await pool.query(lockTableDdl(dialect))},async listApplied(){return(await pool.query(`SELECT id, name, hash, batch, applied_at, direction
|
|
12
|
+
FROM kick_migrations
|
|
13
|
+
ORDER BY applied_at ASC, id ASC`)).rows.map(row=>({id:row.id,name:row.name,hash:row.hash,batch:Number(row.batch),appliedAt:row.applied_at instanceof Date?row.applied_at.toISOString():String(row.applied_at),direction:row.direction}))},async recordApplied(row){await pool.query(`INSERT INTO kick_migrations (id, name, hash, batch, direction)
|
|
14
|
+
VALUES ($1, $2, $3, $4, $5)`,[row.id,row.name,row.hash,row.batch,row.direction])},async removeApplied(id){await pool.query(`DELETE FROM kick_migrations WHERE id = $1`,[id])},async acquireLock(owner){return(await pool.query(`UPDATE kick_migrations_lock
|
|
15
|
+
SET locked_at = CURRENT_TIMESTAMP, locked_by = $1
|
|
16
|
+
WHERE id = 1 AND locked_at IS NULL`,[owner])).rowCount===1},async releaseLock(){await pool.query(`UPDATE kick_migrations_lock
|
|
17
|
+
SET locked_at = NULL, locked_by = NULL
|
|
18
|
+
WHERE id = 1`)},async applySqlInTx(sql){let client=await pool.connect();try{await client.query(`BEGIN`),await client.query(sql),await client.query(`COMMIT`)}catch(err){throw await client.query(`ROLLBACK`).catch(()=>{}),err}finally{client.release()}},async applySqlNoTx(sql){await pool.query(sql)},async introspect(){return introspectPg(pool,{schema})},async close(){}}}function pgDialect(opts){return new PostgresDialect({pool:opts.pool})}export{PgEnumColumnBuilder,cidr,citext,inet,money,pgAdapter,pgDialect,pgEnum,tsvector,vector,xml};
|
|
12
19
|
//# sourceMappingURL=pg.mjs.map
|
package/dist/pg.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pg.mjs","names":[],"sources":["../src/dsl/columns/pg.ts"],"sourcesContent":["import { ColumnBuilder } from './types'\n\n// PG-only column types. Phantom T per builder so SchemaToTypes<S> can narrow\n// each column to a useful TS shape — strings for the text-y types, number[]\n// for vector embeddings, etc.\n\n/**\n * Declare a PostgreSQL ENUM type.\n *\n * @example\n * ```ts\n * export const taskStatus = pgEnum('task_status', 'todo', 'in_progress', 'done')\n *\n * export const tasks = table('tasks', {\n * id: uuid().primaryKey().defaultRandom(),\n * status: taskStatus().notNull().default('todo'),\n * })\n * ```\n *\n * The factory returns a column builder whose phantom type narrows to\n * the union of the declared values — `db.selectFrom('tasks').select('status')`\n * types `status: 'todo' | 'in_progress' | 'done'`.\n *\n * Schema-level state (the enum name + values) is attached to every\n * column the factory produces so introspection / drift / emit can pick\n * it up. The snapshot + emit pipeline learns about enum types in the\n * follow-up commit; for now adopters must run the\n * `CREATE TYPE <name> AS ENUM (...)` DDL manually before any column\n * referencing the type is created.\n */\nexport interface PgEnumBuilder<TName extends string, TValues extends readonly string[]> {\n (): PgEnumColumnBuilder<TName, TValues>\n /** The SQL identifier — used by emit + drift detection. */\n readonly enumName: TName\n /** Allowed literal values, in declaration order. */\n readonly values: TValues\n}\n\nexport class PgEnumColumnBuilder<\n TName extends string,\n TValues extends readonly string[],\n> extends ColumnBuilder<TValues[number]> {\n /** The enum's SQL identifier — preserved for emit + drift detection. */\n readonly enumName: TName\n /** Allowed values — readonly to prevent mutation across columns. */\n readonly values: TValues\n\n constructor(enumName: TName, values: TValues) {\n // The SQL data type IS the enum identifier — `status task_status`,\n // not `status text` — so PG enforces the membership constraint.\n super(enumName)\n this.enumName = enumName\n this.values = values\n }\n}\n\n// Variadic rest forces TS to infer EACH value as its literal type, so\n// `pgEnum('s', 'todo', 'done')` resolves to\n// `PgEnumBuilder<'s', ['todo', 'done']>`. Without rest, an array\n// literal stored in a variable would widen to `string[]` and the\n// column phantom would collapse to plain `string`, defeating the\n// entire point of the helper. Adopters with a pre-existing array\n// can still spread it: `pgEnum('s', ...VALUES as const)`.\nexport function pgEnum<TName extends string, const TValues extends readonly [string, ...string[]]>(\n name: TName,\n ...values: TValues\n): PgEnumBuilder<TName, TValues> {\n const factory = (): PgEnumColumnBuilder<TName, TValues> =>\n new PgEnumColumnBuilder<TName, TValues>(name, values)\n // Attach metadata to the factory itself so introspection that walks\n // `Object.values(schema)` can discover enum declarations even when\n // they're declared standalone (without a column reference).\n return Object.assign(factory, { enumName: name, values }) as PgEnumBuilder<TName, TValues>\n}\n\nexport function tsvector(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('tsvector')\n}\n\nexport function vector(dim?: number): ColumnBuilder<number[]> {\n return new ColumnBuilder<number[]>(dim === undefined ? 'vector' : `vector(${dim})`)\n}\n\nexport function citext(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('citext')\n}\n\nexport function money(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('money')\n}\n\nexport function inet(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('inet')\n}\n\nexport function cidr(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('cidr')\n}\n\nexport function xml(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('xml')\n}\n"],"mappings":";;;;;;;;;;qDAsCA,IAAa,oBAAb,cAGU,aAA+B,CAEvC,SAEA,OAEA,YAAY,SAAiB,OAAiB,CAG5C,MAAM,QAAQ,EACd,KAAK,SAAW,SAChB,KAAK,OAAS,MAChB,CACF,EASA,SAAgB,OACd,KACA,GAAG,OAC4B,CAM/B,OAAO,OAAO,WAJZ,IAAI,oBAAoC,KAAM,MAAM,EAIxB,CAAE,SAAU,KAAM,MAAO,CAAC,CAC1D,CAEA,SAAgB,UAAkC,CAChD,OAAO,IAAI,cAAsB,UAAU,CAC7C,CAEA,SAAgB,OAAO,IAAuC,CAC5D,OAAO,IAAI,cAAwB,MAAQ,IAAA,GAAY,SAAW,UAAU,IAAI,EAAE,CACpF,CAEA,SAAgB,QAAgC,CAC9C,OAAO,IAAI,cAAsB,QAAQ,CAC3C,CAEA,SAAgB,OAA+B,CAC7C,OAAO,IAAI,cAAsB,OAAO,CAC1C,CAEA,SAAgB,MAA8B,CAC5C,OAAO,IAAI,cAAsB,MAAM,CACzC,CAEA,SAAgB,MAA8B,CAC5C,OAAO,IAAI,cAAsB,MAAM,CACzC,CAEA,SAAgB,KAA6B,CAC3C,OAAO,IAAI,cAAsB,KAAK,CACxC"}
|
|
1
|
+
{"version":3,"file":"pg.mjs","names":[],"sources":["../src/dsl/columns/pg.ts","../src/adapters/pg/adapter.ts","../src/adapters/pg/dialect.ts"],"sourcesContent":["import { ColumnBuilder } from './types'\n\n// PG-only column types. Phantom T per builder so SchemaToTypes<S> can narrow\n// each column to a useful TS shape — strings for the text-y types, number[]\n// for vector embeddings, etc.\n\n/**\n * Declare a PostgreSQL ENUM type.\n *\n * @example\n * ```ts\n * export const taskStatus = pgEnum('task_status', 'todo', 'in_progress', 'done')\n *\n * export const tasks = table('tasks', {\n * id: uuid().primaryKey().defaultRandom(),\n * status: taskStatus().notNull().default('todo'),\n * })\n * ```\n *\n * The factory returns a column builder whose phantom type narrows to\n * the union of the declared values — `db.selectFrom('tasks').select('status')`\n * types `status: 'todo' | 'in_progress' | 'done'`.\n *\n * Schema-level state (the enum name + values) is attached to every\n * column the factory produces so introspection / drift / emit can pick\n * it up. The snapshot + emit pipeline learns about enum types in the\n * follow-up commit; for now adopters must run the\n * `CREATE TYPE <name> AS ENUM (...)` DDL manually before any column\n * referencing the type is created.\n */\nexport interface PgEnumBuilder<TName extends string, TValues extends readonly string[]> {\n (): PgEnumColumnBuilder<TName, TValues>\n /** The SQL identifier — used by emit + drift detection. */\n readonly enumName: TName\n /** Allowed literal values, in declaration order. */\n readonly values: TValues\n}\n\nexport class PgEnumColumnBuilder<\n TName extends string,\n TValues extends readonly string[],\n> extends ColumnBuilder<TValues[number]> {\n /** The enum's SQL identifier — preserved for emit + drift detection. */\n readonly enumName: TName\n /** Allowed values — readonly to prevent mutation across columns. */\n readonly values: TValues\n\n constructor(enumName: TName, values: TValues) {\n // The SQL data type IS the enum identifier — `status task_status`,\n // not `status text` — so PG enforces the membership constraint.\n super(enumName)\n this.enumName = enumName\n this.values = values\n }\n}\n\n// Variadic rest forces TS to infer EACH value as its literal type, so\n// `pgEnum('s', 'todo', 'done')` resolves to\n// `PgEnumBuilder<'s', ['todo', 'done']>`. Without rest, an array\n// literal stored in a variable would widen to `string[]` and the\n// column phantom would collapse to plain `string`, defeating the\n// entire point of the helper. Adopters with a pre-existing array\n// can still spread it: `pgEnum('s', ...VALUES as const)`.\nexport function pgEnum<TName extends string, const TValues extends readonly [string, ...string[]]>(\n name: TName,\n ...values: TValues\n): PgEnumBuilder<TName, TValues> {\n const factory = (): PgEnumColumnBuilder<TName, TValues> =>\n new PgEnumColumnBuilder<TName, TValues>(name, values)\n // Attach metadata to the factory itself so introspection that walks\n // `Object.values(schema)` can discover enum declarations even when\n // they're declared standalone (without a column reference).\n return Object.assign(factory, { enumName: name, values }) as PgEnumBuilder<TName, TValues>\n}\n\nexport function tsvector(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('tsvector')\n}\n\nexport function vector(dim?: number): ColumnBuilder<number[]> {\n return new ColumnBuilder<number[]>(dim === undefined ? 'vector' : `vector(${dim})`)\n}\n\nexport function citext(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('citext')\n}\n\nexport function money(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('money')\n}\n\nexport function inet(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('inet')\n}\n\nexport function cidr(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('cidr')\n}\n\nexport function xml(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('xml')\n}\n","import {\n introspectPg,\n lockTableDdl,\n migrationsTableDdl,\n type Dialect,\n type MigrationAdapter,\n type MigrationRow,\n type SchemaSnapshot,\n} from '../../index'\n\n/**\n * Minimal client returned by PgPoolLike.connect(). Matches the shape of\n * pg.PoolClient and @neondatabase/serverless's PoolClient.\n */\nexport interface PgClientLike {\n query<R = unknown>(\n sql: string,\n params?: readonly unknown[],\n ): Promise<{ rows: R[]; rowCount: number | null }>\n release(): void\n}\n\n/**\n * Pool-shaped contract that pgAdapter consumes. Both `pg.Pool` and\n * `@neondatabase/serverless`'s Pool match this structurally — no hard\n * dependency on the `pg` package. Adopters pick whichever pg-protocol-\n * compatible client fits their runtime (node-postgres / neon-serverless /\n * pg-cloudflare / etc).\n *\n * Edge runtimes with a different surface (Neon HTTP single-shot,\n * Cloudflare D1's batch-only model) have their own adapter packages that\n * implement MigrationAdapter directly — they don't reuse this shape.\n */\nexport interface PgPoolLike {\n query<R = unknown>(\n sql: string,\n params?: readonly unknown[],\n ): Promise<{ rows: R[]; rowCount: number | null }>\n connect(): Promise<PgClientLike>\n}\n\nexport interface PgAdapterOptions {\n /**\n * A pg-protocol-compatible Pool. Concretely: pg.Pool, neon-serverless Pool,\n * any other Pool that satisfies the {@link PgPoolLike} structural shape.\n */\n pool: PgPoolLike\n /** PG schema name to scope the introspector and validate at construction. Default 'public'. */\n schema?: string\n}\n\nconst SAFE_SCHEMA_NAME = /^[a-z_][a-z0-9_]*$/i\n\n/**\n * MigrationAdapter implementation backed by node-postgres. The pool is\n * caller-owned — close() does NOT end() the pool because adopters typically\n * share a single pool across the migrationAdapter and the KickDbClient.\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 rowCount=1\n * (we won) or matches zero rows (someone else holds it).\n */\nexport function pgAdapter(opts: PgAdapterOptions): MigrationAdapter {\n const dialect: Dialect = 'postgres'\n const { pool } = opts\n const schema = opts.schema ?? 'public'\n if (!SAFE_SCHEMA_NAME.test(schema)) {\n // Schema name lands inside introspection queries unparameterised so guard\n // here rather than down at the SQL boundary.\n throw new Error(`Invalid PG schema name: ${schema}`)\n }\n\n return {\n dialect,\n\n async ensureMigrationTables() {\n await pool.query(migrationsTableDdl(dialect))\n await pool.query(lockTableDdl(dialect))\n },\n\n async listApplied(): Promise<MigrationRow[]> {\n const r = await pool.query<{\n id: string\n name: string\n hash: string\n batch: number | string\n applied_at: string | Date\n direction: 'up' | 'down'\n }>(\n `SELECT id, name, hash, batch, applied_at, direction\n FROM kick_migrations\n ORDER BY applied_at ASC, id ASC`,\n )\n return r.rows.map((row) => ({\n id: row.id,\n name: row.name,\n hash: row.hash,\n batch: Number(row.batch),\n appliedAt:\n row.applied_at instanceof Date ? row.applied_at.toISOString() : String(row.applied_at),\n direction: row.direction,\n }))\n },\n\n async recordApplied(row) {\n await pool.query(\n `INSERT INTO kick_migrations (id, name, hash, batch, direction)\n VALUES ($1, $2, $3, $4, $5)`,\n [row.id, row.name, row.hash, row.batch, row.direction],\n )\n },\n\n async removeApplied(id: string) {\n await pool.query(`DELETE FROM kick_migrations WHERE id = $1`, [id])\n },\n\n async acquireLock(owner: string): Promise<boolean> {\n const r = await pool.query(\n `UPDATE kick_migrations_lock\n SET locked_at = CURRENT_TIMESTAMP, locked_by = $1\n WHERE id = 1 AND locked_at IS NULL`,\n [owner],\n )\n return r.rowCount === 1\n },\n\n async releaseLock() {\n await pool.query(\n `UPDATE kick_migrations_lock\n SET locked_at = NULL, locked_by = NULL\n WHERE id = 1`,\n )\n },\n\n async applySqlInTx(sql: string) {\n const client = await pool.connect()\n try {\n await client.query('BEGIN')\n await client.query(sql)\n await client.query('COMMIT')\n } catch (err) {\n await client.query('ROLLBACK').catch(() => {\n /* swallow rollback errors; we're already throwing the original */\n })\n throw err\n } finally {\n client.release()\n }\n },\n\n async applySqlNoTx(sql: string) {\n await pool.query(sql)\n },\n\n async introspect(): Promise<SchemaSnapshot> {\n return introspectPg(pool, { schema })\n },\n\n async close() {\n // Caller owns the pool. kickDbAdapter's shutdown lifecycle calls this so\n // future adapter-internal teardown (e.g. cancelling pending observers)\n // has a hook, but we deliberately don't end() the shared pool.\n },\n }\n}\n","// pgDialect — thin factory over Kysely's PostgresDialect so adopters\n// never have to write `import { PostgresDialect } from 'kysely'`.\n// Kysely is a pinned internal dep of the framework; surfacing it\n// through our own export keeps the adopter import surface stable\n// even when we change query backends (or fork Kysely's internals).\n\nimport { PostgresDialect, type Dialect as KyselyDialect } from 'kysely'\n\nimport type { PgPoolLike } from './adapter'\n\nexport interface PgDialectOptions {\n /**\n * pg-protocol-compatible pool. Both `pg.Pool` and\n * `@neondatabase/serverless`'s Pool match structurally; adopters\n * pick whichever runtime fits.\n */\n pool: PgPoolLike\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 { pgDialect, pgAdapter } from '@forinda/kickjs-db/pg'\n * import { Pool } from 'pg'\n *\n * const pool = new Pool({ connectionString: process.env.DATABASE_URL })\n *\n * export const db = createDbClient({\n * schema,\n * dialect: pgDialect({ pool }),\n * })\n *\n * export const migrationAdapter = pgAdapter({ pool })\n * ```\n */\nexport function pgDialect(opts: PgDialectOptions): KyselyDialect {\n // PostgresDialect's `pool` parameter is typed as `PG.Pool` in newer\n // Kysely versions; casting through `unknown` keeps adopters using\n // alternate clients (neon, pg-cloudflare) compatible without\n // pulling node-postgres' typings into our public surface.\n return new PostgresDialect({ pool: opts.pool as unknown as never })\n}\n"],"mappings":";;;;;;;;;;sJAsCA,IAAa,oBAAb,cAGU,aAA+B,CAEvC,SAEA,OAEA,YAAY,SAAiB,OAAiB,CAG5C,MAAM,QAAQ,EACd,KAAK,SAAW,SAChB,KAAK,OAAS,MAChB,CACF,EASA,SAAgB,OACd,KACA,GAAG,OAC4B,CAM/B,OAAO,OAAO,WAJZ,IAAI,oBAAoC,KAAM,MAAM,EAIxB,CAAE,SAAU,KAAM,MAAO,CAAC,CAC1D,CAEA,SAAgB,UAAkC,CAChD,OAAO,IAAI,cAAsB,UAAU,CAC7C,CAEA,SAAgB,OAAO,IAAuC,CAC5D,OAAO,IAAI,cAAwB,MAAQ,IAAA,GAAY,SAAW,UAAU,IAAI,EAAE,CACpF,CAEA,SAAgB,QAAgC,CAC9C,OAAO,IAAI,cAAsB,QAAQ,CAC3C,CAEA,SAAgB,OAA+B,CAC7C,OAAO,IAAI,cAAsB,OAAO,CAC1C,CAEA,SAAgB,MAA8B,CAC5C,OAAO,IAAI,cAAsB,MAAM,CACzC,CAEA,SAAgB,MAA8B,CAC5C,OAAO,IAAI,cAAsB,MAAM,CACzC,CAEA,SAAgB,KAA6B,CAC3C,OAAO,IAAI,cAAsB,KAAK,CACxC,CClDA,MAAM,iBAAmB,sBAYzB,SAAgB,UAAU,KAA0C,CAClE,IAAM,QAAmB,WACnB,CAAE,MAAS,KACX,OAAS,KAAK,QAAU,SAC9B,GAAI,CAAC,iBAAiB,KAAK,MAAM,EAG/B,MAAU,MAAM,2BAA2B,QAAQ,EAGrD,MAAO,CACL,QAEA,MAAM,uBAAwB,CAC5B,MAAM,KAAK,MAAM,mBAAmB,OAAO,CAAC,EAC5C,MAAM,KAAK,MAAM,aAAa,OAAO,CAAC,CACxC,EAEA,MAAM,aAAuC,CAa3C,OAAO,MAZS,KAAK,MAQnB;;yCAGF,EAAA,CACS,KAAK,IAAK,MAAS,CAC1B,GAAI,IAAI,GACR,KAAM,IAAI,KACV,KAAM,IAAI,KACV,MAAO,OAAO,IAAI,KAAK,EACvB,UACE,IAAI,sBAAsB,KAAO,IAAI,WAAW,YAAY,EAAI,OAAO,IAAI,UAAU,EACvF,UAAW,IAAI,SACjB,EAAE,CACJ,EAEA,MAAM,cAAc,IAAK,CACvB,MAAM,KAAK,MACT;sCAEA,CAAC,IAAI,GAAI,IAAI,KAAM,IAAI,KAAM,IAAI,MAAO,IAAI,SAAS,CACvD,CACF,EAEA,MAAM,cAAc,GAAY,CAC9B,MAAM,KAAK,MAAM,4CAA6C,CAAC,EAAE,CAAC,CACpE,EAEA,MAAM,YAAY,MAAiC,CAOjD,OAAO,MANS,KAAK,MACnB;;6CAGA,CAAC,KAAK,CACR,EAAA,CACS,WAAa,CACxB,EAEA,MAAM,aAAc,CAClB,MAAM,KAAK,MACT;;sBAGF,CACF,EAEA,MAAM,aAAa,IAAa,CAC9B,IAAM,OAAS,MAAM,KAAK,QAAQ,EAClC,GAAI,CACF,MAAM,OAAO,MAAM,OAAO,EAC1B,MAAM,OAAO,MAAM,GAAG,EACtB,MAAM,OAAO,MAAM,QAAQ,CAC7B,OAAS,IAAK,CAIZ,MAHA,MAAM,OAAO,MAAM,UAAU,CAAC,CAAC,UAAY,CAE3C,CAAC,EACK,GACR,QAAU,CACR,OAAO,QAAQ,CACjB,CACF,EAEA,MAAM,aAAa,IAAa,CAC9B,MAAM,KAAK,MAAM,GAAG,CACtB,EAEA,MAAM,YAAsC,CAC1C,OAAO,aAAa,KAAM,CAAE,MAAO,CAAC,CACtC,EAEA,MAAM,OAAQ,CAId,CACF,CACF,CC/HA,SAAgB,UAAU,KAAuC,CAK/D,OAAO,IAAI,gBAAgB,CAAE,KAAM,KAAK,IAAyB,CAAC,CACpE"}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
|
|
2
|
+
import { Qt as MigrationAdapter } from "./index-B1r7mcA1.mjs";
|
|
3
|
+
import { Dialect } from "kysely";
|
|
4
|
+
|
|
5
|
+
//#region src/adapters/sqlite/adapter.d.ts
|
|
6
|
+
/**
|
|
7
|
+
* better-sqlite3-shaped database handle that `sqliteAdapter` consumes.
|
|
8
|
+
* Mirrors the methods we actually use; both `new Database(...)` from
|
|
9
|
+
* `better-sqlite3` and bun's `bun:sqlite` Database match structurally.
|
|
10
|
+
*
|
|
11
|
+
* better-sqlite3's API is synchronous — we wrap everything in `async`
|
|
12
|
+
* to match the `MigrationAdapter` contract. No I/O actually awaits;
|
|
13
|
+
* the wrapping is for shape compatibility.
|
|
14
|
+
*/
|
|
15
|
+
interface SqliteStatement {
|
|
16
|
+
run(...params: readonly unknown[]): {
|
|
17
|
+
changes: number;
|
|
18
|
+
lastInsertRowid: number | bigint;
|
|
19
|
+
};
|
|
20
|
+
all<R = unknown>(...params: readonly unknown[]): R[];
|
|
21
|
+
get<R = unknown>(...params: readonly unknown[]): R | undefined;
|
|
22
|
+
}
|
|
23
|
+
interface SqliteDatabaseLike {
|
|
24
|
+
prepare(sql: string): SqliteStatement;
|
|
25
|
+
exec(sql: string): unknown;
|
|
26
|
+
close(): unknown;
|
|
27
|
+
}
|
|
28
|
+
interface SqliteAdapterOptions {
|
|
29
|
+
/**
|
|
30
|
+
* better-sqlite3 (or compatible) Database handle. Caller-owned —
|
|
31
|
+
* the adapter's `close()` does NOT close the database because
|
|
32
|
+
* adopters typically share a single handle across the migration
|
|
33
|
+
* adapter and the KickDbClient.
|
|
34
|
+
*/
|
|
35
|
+
database: SqliteDatabaseLike;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* MigrationAdapter implementation backed by better-sqlite3.
|
|
39
|
+
*
|
|
40
|
+
* Lock semantics: single-row UPDATE WHERE locked_at IS NULL on
|
|
41
|
+
* `kick_migrations_lock`. Only the row created by `ensureMigrationTables()`
|
|
42
|
+
* exists, so the UPDATE either flips `locked_at` and returns
|
|
43
|
+
* `changes=1` (we won) or matches zero rows (someone else holds it).
|
|
44
|
+
*
|
|
45
|
+
* Introspection: `introspect()` walks `sqlite_master` + `PRAGMA` via
|
|
46
|
+
* {@link introspectSqlite}. Types come back as SQLite affinities (lossy
|
|
47
|
+
* vs the code-first DSL), so it powers `kick db introspect` rather than
|
|
48
|
+
* byte-exact drift detection.
|
|
49
|
+
*/
|
|
50
|
+
declare function sqliteAdapter(opts: SqliteAdapterOptions): MigrationAdapter;
|
|
51
|
+
//#endregion
|
|
52
|
+
//#region src/adapters/sqlite/dialect.d.ts
|
|
53
|
+
interface SqliteDialectOptions {
|
|
54
|
+
/**
|
|
55
|
+
* better-sqlite3-compatible database handle. Both `new Database(...)`
|
|
56
|
+
* from `better-sqlite3` and bun's `bun:sqlite` `Database` match
|
|
57
|
+
* structurally (Bun is best-effort — same `.prepare()` shape, no
|
|
58
|
+
* version assertion).
|
|
59
|
+
*/
|
|
60
|
+
database: SqliteDatabaseLike;
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* Construct the dialect that `createDbClient({ dialect })` consumes.
|
|
64
|
+
*
|
|
65
|
+
* @example
|
|
66
|
+
* ```ts
|
|
67
|
+
* import { createDbClient } from '@forinda/kickjs-db'
|
|
68
|
+
* import { sqliteDialect, sqliteAdapter } from '@forinda/kickjs-db/sqlite'
|
|
69
|
+
* import Database from 'better-sqlite3'
|
|
70
|
+
*
|
|
71
|
+
* const database = new Database(':memory:')
|
|
72
|
+
*
|
|
73
|
+
* export const db = createDbClient({
|
|
74
|
+
* schema,
|
|
75
|
+
* dialect: sqliteDialect({ database }),
|
|
76
|
+
* })
|
|
77
|
+
*
|
|
78
|
+
* export const migrationAdapter = sqliteAdapter({ database })
|
|
79
|
+
* ```
|
|
80
|
+
*/
|
|
81
|
+
declare function sqliteDialect(opts: SqliteDialectOptions): Dialect;
|
|
82
|
+
//#endregion
|
|
83
|
+
export { SqliteAdapterOptions, SqliteDatabaseLike, SqliteDialectOptions, SqliteStatement, sqliteAdapter, sqliteDialect };
|
|
84
|
+
//# sourceMappingURL=sqlite.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sqlite.d.mts","names":[],"sources":["../src/adapters/sqlite/adapter.ts","../src/adapters/sqlite/dialect.ts"],"mappings":";;;;;;;;AAmBA;;;;;;UAAiB,eAAA;EACf,GAAA,IAAO,MAAA;IAA+B,OAAA;IAAiB,eAAA;EAAA;EACvD,GAAA,iBAAoB,MAAA,uBAA6B,CAAA;EACjD,GAAA,iBAAoB,MAAA,uBAA6B,CAAC;AAAA;AAAA,UAGnC,kBAAA;EACf,OAAA,CAAQ,GAAA,WAAc,eAAe;EACrC,IAAA,CAAK,GAAA;EACL,KAAA;AAAA;AAAA,UAGe,oBAAA;;;;;;;EAOf,QAAA,EAAU,kBAAkB;AAAA;;AAVvB;AAGP;;;;AAO8B;AAgB9B;;;;;;iBAAgB,aAAA,CAAc,IAAA,EAAM,oBAAA,GAAuB,gBAAgB;;;UC7C1D,oBAAA;;ADUjB;;;;;ECHE,QAAA,EAAU,kBAAkB;AAAA;;;;;;;;;;;ADMsB;AAGpD;;;;;;;;iBCagB,aAAA,CAAc,IAAA,EAAM,oBAAA,GAAuB,OAAa"}
|
package/dist/sqlite.mjs
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @forinda/kickjs-db v6.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{at as lockTableDdl,et as introspectSqlite,ot as migrationsTableDdl}from"./src-lL141oWK.mjs";import{SqliteDialect}from"kysely";function sqliteAdapter(opts){let dialect=`sqlite`,{database}=opts,runBatch=sql=>database.exec(sql);return{dialect,async ensureMigrationTables(){runBatch(migrationsTableDdl(dialect)),runBatch(lockTableDdl(dialect))},async listApplied(){return database.prepare(`SELECT id, name, hash, batch, applied_at, direction
|
|
12
|
+
FROM kick_migrations
|
|
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 kick_migrations (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 kick_migrations WHERE id = ?`).run(id)},async acquireLock(owner){return database.prepare(`UPDATE kick_migrations_lock
|
|
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 kick_migrations_lock
|
|
17
|
+
SET locked_at = NULL, locked_by = NULL
|
|
18
|
+
WHERE id = 1`).run()},async applySqlInTx(sql){runBatch(`BEGIN`);try{runBatch(sql),runBatch(`COMMIT`)}catch(err){try{runBatch(`ROLLBACK`)}catch{}throw err}},async applySqlNoTx(sql){runBatch(sql)},async introspect(){return introspectSqlite(database)},async close(){}}}function sqliteDialect(opts){return new SqliteDialect({database:opts.database})}export{sqliteAdapter,sqliteDialect};
|
|
19
|
+
//# sourceMappingURL=sqlite.mjs.map
|
|
@@ -0,0 +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 */\nexport interface SqliteStatement {\n run(...params: readonly unknown[]): { changes: number; lastInsertRowid: number | bigint }\n all<R = unknown>(...params: readonly unknown[]): R[]\n get<R = unknown>(...params: readonly unknown[]): R | undefined\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<{\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 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 new SqliteDialect({ database: opts.database as never })\n}\n"],"mappings":";;;;;;;;;;qIAsDA,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,CC/HA,SAAgB,cAAc,KAA2C,CACvE,OAAO,IAAI,cAAc,CAAE,SAAU,KAAK,QAAkB,CAAC,CAC/D"}
|