@forinda/kickjs-db 7.2.1 → 7.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.d.mts +10 -10
- package/dist/cli.d.mts.map +1 -1
- package/dist/cli.mjs +3 -3
- package/dist/cli.mjs.map +1 -1
- package/dist/custom-type-j8k__3sL.mjs +12 -0
- package/dist/custom-type-j8k__3sL.mjs.map +1 -0
- package/dist/devtools-events.d.mts +2 -1
- package/dist/devtools-events.mjs +1 -1
- package/dist/{index-Ci5DXgUh.d.mts → index-DF69HndC.d.mts} +39 -312
- package/dist/index-DF69HndC.d.mts.map +1 -0
- package/dist/index.d.mts +4 -3
- package/dist/index.mjs +2 -2
- package/dist/mysql.d.mts +11 -12
- package/dist/mysql.d.mts.map +1 -1
- package/dist/mysql.mjs +2 -2
- package/dist/mysql.mjs.map +1 -1
- package/dist/pg-BJmYKLhI.mjs +12 -0
- package/dist/pg-BJmYKLhI.mjs.map +1 -0
- package/dist/pg.d.mts +21 -21
- package/dist/pg.d.mts.map +1 -1
- package/dist/pg.mjs +2 -2
- package/dist/pg.mjs.map +1 -1
- package/dist/schema.d.mts +88 -0
- package/dist/schema.d.mts.map +1 -0
- package/dist/schema.mjs +12 -0
- package/dist/schema.mjs.map +1 -0
- package/dist/sqlite.d.mts +7 -8
- package/dist/sqlite.d.mts.map +1 -1
- package/dist/sqlite.mjs +2 -2
- package/dist/src-BnHTLx5l.mjs +166 -0
- package/dist/src-BnHTLx5l.mjs.map +1 -0
- package/dist/table-Bl5SbKRg.d.mts +309 -0
- package/dist/table-Bl5SbKRg.d.mts.map +1 -0
- package/dist/{types-NkfgZHEN.d.mts → types-DtvYnaXL.d.mts} +3 -4
- package/dist/types-DtvYnaXL.d.mts.map +1 -0
- package/package.json +14 -9
- package/dist/index-Ci5DXgUh.d.mts.map +0 -1
- package/dist/src-BLr8KOo1.mjs +0 -156
- package/dist/src-BLr8KOo1.mjs.map +0 -1
- package/dist/types-NkfgZHEN.d.mts.map +0 -1
package/dist/mysql.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-db v7.
|
|
2
|
+
* @forinda/kickjs-db v7.4.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{
|
|
11
|
+
import{$ as introspectMysql,Pt as KickDbError,R as markDialect,at as lockTableDdl,ot as migrationsTableDdl}from"./src-BnHTLx5l.mjs";import{MysqlDialect}from"kysely";function parseMysqlVersion(version){let trimmed=version.trim();if(/MariaDB/i.test(trimmed)){let m=/(\d+)\.(\d+)(?:\.\d+)?-MariaDB/i.exec(trimmed);if(m){let major=Number(m[1]),minor=Number(m[2]);if(Number.isFinite(major)&&Number.isFinite(minor))return{flavor:`mariadb`,major,minor}}let fallback=/^(\d+)\.(\d+)/.exec(trimmed);if(!fallback)return null;let major=Number(fallback[1]),minor=Number(fallback[2]);return!Number.isFinite(major)||!Number.isFinite(minor)?null:{flavor:`mariadb`,major,minor}}let m=/^(\d+)\.(\d+)/.exec(trimmed);if(!m)return null;let major=Number(m[1]),minor=Number(m[2]);return!Number.isFinite(major)||!Number.isFinite(minor)?null:{flavor:`mysql`,major,minor}}function parseMysqlMajorVersion(version){return parseMysqlVersion(version)?.major??null}function checkVersionSupport(parsed,raw){return parsed==null?`unparseable version string: ${raw||`<empty>`}`:parsed.flavor===`mariadb`?parsed.major>10?null:parsed.major<10||parsed.minor<5?`MariaDB 10.5+ required (detected: ${raw})`:null:parsed.major<8?`MySQL 8.0+ required (detected: ${raw})`:null}function splitMysqlStatements(sql){let out=[],buf=``,inSingle=!1,inDouble=!1,inBacktick=!1,inLineComment=!1,inBlockComment=!1,isCommentWhitespace=c=>c===` `||c===` `||c===`
|
|
12
12
|
`||c===`\r`||c===`\f`||c===`\v`;for(let i=0;i<sql.length;i++){let ch=sql[i],next=i+1<sql.length?sql[i+1]:``,after=i+2<sql.length?sql[i+2]:``;if(inLineComment){buf+=ch,ch===`
|
|
13
13
|
`&&(inLineComment=!1);continue}if(inBlockComment){buf+=ch,ch===`*`&&next===`/`&&(buf+=next,i++,inBlockComment=!1);continue}if(inSingle){if(ch===`'`&&next===`'`){buf+=ch,buf+=next,i++;continue}if(buf+=ch,ch===`\\`&&next!==``){buf+=next,i++;continue}ch===`'`&&(inSingle=!1);continue}if(inDouble){if(ch===`"`&&next===`"`){buf+=ch,buf+=next,i++;continue}if(buf+=ch,ch===`\\`&&next!==``){buf+=next,i++;continue}ch===`"`&&(inDouble=!1);continue}if(inBacktick){buf+=ch,ch==="`"&&(inBacktick=!1);continue}if(ch===`-`&&next===`-`&&(after===``||isCommentWhitespace(after))){buf+=ch,inLineComment=!0;continue}if(ch===`/`&&next===`*`){buf+=ch,inBlockComment=!0;continue}if(ch===`'`){buf+=ch,inSingle=!0;continue}if(ch===`"`){buf+=ch,inDouble=!0;continue}if(ch==="`"){buf+=ch,inBacktick=!0;continue}if(ch===`;`){let trimmed=buf.trim();trimmed.length>0&&out.push(trimmed),buf=``;continue}buf+=ch}let tail=buf.trim();return tail.length>0&&out.push(tail),out}function mysqlAdapter(opts){let dialect=`mysql`,{pool}=opts,versionVerified=!1;async function assertVersion(){if(versionVerified)return;let[rows]=await pool.query("SELECT VERSION() AS `version`"),versionString=rows[0]?.version??``,failure=checkVersionSupport(parseMysqlVersion(versionString),versionString);if(failure)throw new KickDbError(`KICK_DB_RELATIONAL_NOT_SUPPORTED`,`${failure}. JSON_ARRAYAGG (required by the relational query layer) shipped in MySQL 8.0 and MariaDB 10.5. Use layer-1/layer-2 queries (selectFrom / selectAll) on older versions.`);versionVerified=!0}async function runStatements(sql){for(let stmt of splitMysqlStatements(sql))await pool.query(stmt)}async function runStatementsOnConn(conn,sql){for(let stmt of splitMysqlStatements(sql))await conn.query(stmt)}return{dialect,async ensureMigrationTables(){await assertVersion(),await runStatements(migrationsTableDdl(dialect)),await runStatements(lockTableDdl(dialect))},async listApplied(){let[rows]=await pool.query(`SELECT id, name, hash, batch, applied_at, direction
|
|
14
14
|
FROM \`kick_migrations\`
|
package/dist/mysql.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mysql.mjs","names":[],"sources":["../src/adapters/mysql/adapter.ts","../src/adapters/mysql/dialect.ts"],"sourcesContent":["import {\n KickDbError,\n lockTableDdl,\n migrationsTableDdl,\n type Dialect,\n type MigrationAdapter,\n type MigrationRow,\n type SchemaSnapshot,\n} from '../../index'\nimport { introspectMysql } from '../../migrate/introspect-mysql'\n\n/**\n * mysql2-shaped pool that `mysqlAdapter` consumes. Mirrors the\n * structural surface of `mysql2/promise`'s Pool. The adapter only\n * uses `query(...)` and `getConnection(...)` so any mysql2-compatible\n * driver works.\n *\n * Return type is `Promise<[R, unknown]>` (not `[R[], unknown]`) so\n * mysql2's `Pool.query()` is structurally assignable: SELECT\n * statements return `RowDataPacket[]` (so callers pass `R =\n * MyRow[]`), INSERT / UPDATE / DELETE return `ResultSetHeader` (so\n * callers pass `R = ResultSetHeader`). Each adapter call site picks\n * the row shape it expects via the type parameter.\n */\nexport interface MysqlConnectionLike {\n query<R = unknown>(sql: string, params?: readonly unknown[]): Promise<[R, unknown]>\n release(): void\n}\n\nexport interface MysqlPoolLike {\n query<R = unknown>(sql: string, params?: readonly unknown[]): Promise<[R, unknown]>\n getConnection(): Promise<MysqlConnectionLike>\n}\n\nexport interface MysqlAdapterOptions {\n /**\n * mysql2-compatible Pool. Caller-owned — `close()` on the adapter\n * does NOT end the pool because adopters typically share a single\n * pool across the migration adapter and the KickDbClient.\n */\n pool: MysqlPoolLike\n}\n\n/**\n * Minimum supported MySQL major + MariaDB version. `JSON_ARRAYAGG`\n * shipped in MySQL 8.0 and MariaDB 10.5 — earlier versions can't\n * run kickjs-db's relational query layer.\n *\n * Spec: docs/db/spec-relational-query-other-dialects.md §7 R-1.\n */\nconst MIN_MYSQL_MAJOR = 8\nconst MIN_MARIADB_MAJOR = 10\nconst MIN_MARIADB_MINOR = 5\n\n/**\n * Parsed shape returned by `parseMysqlVersion`. `flavor` lets\n * adopters distinguish MySQL from MariaDB without re-grepping the\n * raw string.\n */\nexport interface ParsedMysqlVersion {\n flavor: 'mysql' | 'mariadb'\n major: number\n minor: number\n}\n\n/**\n * Parse a MySQL `SELECT VERSION()` string. Handles:\n *\n * - MySQL: `8.0.34`, `8.4.0`, `5.7.42-log`\n * - MariaDB plain: `10.6.11-MariaDB`, `10.5.21-MariaDB-log`,\n * `10.4.32-MariaDB`\n * - MariaDB w/ compat prefix: `5.5.5-10.6.11-MariaDB-1:10.6.11+maria~ubu2004`\n * (the leading `5.5.5-` is a wire-protocol thing for older MySQL\n * clients; the real server version sits immediately before\n * `-MariaDB`)\n *\n * Returns `null` on unparseable input.\n */\nexport function parseMysqlVersion(version: string): ParsedMysqlVersion | null {\n const trimmed = version.trim()\n const isMariaDb = /MariaDB/i.test(trimmed)\n\n if (isMariaDb) {\n // Pull the `major.minor` that sits immediately before\n // `-MariaDB`. This skips the `5.5.5-` compat prefix when\n // present and grabs the real server version regardless of\n // whether one's there.\n const m = /(\\d+)\\.(\\d+)(?:\\.\\d+)?-MariaDB/i.exec(trimmed)\n if (m) {\n const major = Number(m[1])\n const minor = Number(m[2])\n if (Number.isFinite(major) && Number.isFinite(minor)) {\n return { flavor: 'mariadb', major, minor }\n }\n }\n // Fallback for vendor strings we haven't seen — try the\n // leading x.y. Better to surface the wrong floor than to\n // refuse an otherwise valid MariaDB outright.\n const fallback = /^(\\d+)\\.(\\d+)/.exec(trimmed)\n if (!fallback) return null\n const major = Number(fallback[1])\n const minor = Number(fallback[2])\n if (!Number.isFinite(major) || !Number.isFinite(minor)) return null\n return { flavor: 'mariadb', major, minor }\n }\n\n // MySQL: leading x.y from the start of the string.\n const m = /^(\\d+)\\.(\\d+)/.exec(trimmed)\n if (!m) return null\n const major = Number(m[1])\n const minor = Number(m[2])\n if (!Number.isFinite(major) || !Number.isFinite(minor)) return null\n return { flavor: 'mysql', major, minor }\n}\n\n/**\n * Back-compat shim — pre-existing API surface that returned the\n * major version only. Kept exported so adopters depending on it\n * keep working; new code should use `parseMysqlVersion`.\n *\n * @deprecated Use `parseMysqlVersion` for full version + flavor info.\n */\nexport function parseMysqlMajorVersion(version: string): number | null {\n const parsed = parseMysqlVersion(version)\n return parsed?.major ?? null\n}\n\n/**\n * Returns the failure reason if the parsed version doesn't satisfy\n * kickjs-db's floor, or `null` if it does. Pure — no I/O.\n */\nfunction checkVersionSupport(parsed: ParsedMysqlVersion | null, raw: string): string | null {\n if (parsed == null) {\n return `unparseable version string: ${raw || '<empty>'}`\n }\n if (parsed.flavor === 'mariadb') {\n if (parsed.major > MIN_MARIADB_MAJOR) return null\n if (parsed.major < MIN_MARIADB_MAJOR) {\n return `MariaDB ${MIN_MARIADB_MAJOR}.${MIN_MARIADB_MINOR}+ required (detected: ${raw})`\n }\n if (parsed.minor < MIN_MARIADB_MINOR) {\n return `MariaDB ${MIN_MARIADB_MAJOR}.${MIN_MARIADB_MINOR}+ required (detected: ${raw})`\n }\n return null\n }\n // MySQL flavor.\n if (parsed.major < MIN_MYSQL_MAJOR) {\n return `MySQL ${MIN_MYSQL_MAJOR}.0+ required (detected: ${raw})`\n }\n return null\n}\n\n/**\n * Split a SQL blob into individual statements at the top-level `;`\n * boundary. Respects single-quote / double-quote / backtick string\n * literals AND `--` line comments + C-style block comments —\n * `;` inside any of those does not terminate a statement.\n *\n * mysql2's default `Pool.query()` rejects multi-statement SQL unless\n * the driver was created with `multipleStatements: true`. Splitting\n * lets the adapter run kickjs-emitted DDL (multi-statement, but\n * always semicolon-separated at the top level) without that flag.\n *\n * Two MySQL-specific quirks the splitter handles:\n *\n * - **`--` comments require trailing whitespace/end-of-input.**\n * Per MySQL docs, `--` is only a line-comment introducer when\n * followed by whitespace (space/tab/newline) or end-of-input —\n * otherwise it's two unary-minus operators (`5--3` evaluates\n * to `8`). Bare `--xyz` is a parse error in MySQL but kickjs\n * should pass it through unchanged so the driver surfaces the\n * real error, not silently swallow the rest of the line.\n * - **Doubled-quote string escapes.** MySQL accepts both\n * backslash-escapes (`'it\\'s'`) and SQL-standard doubled-quote\n * escapes (`'it''s'`). The state machine peeks for the doubled\n * form and stays in-string. Same rule applies to `\"\"` inside\n * double-quoted strings.\n *\n * Adopter-written migrations with pathological SQL — e.g. `;` in\n * an unterminated block comment — won't split correctly.\n * Documented in the README; turn on `multipleStatements: true` on\n * the pool if you hit it.\n */\nexport function splitMysqlStatements(sql: string): string[] {\n const out: string[] = []\n let buf = ''\n let inSingle = false\n let inDouble = false\n let inBacktick = false\n let inLineComment = false\n let inBlockComment = false\n\n const isCommentWhitespace = (c: string) =>\n c === ' ' || c === '\\t' || c === '\\n' || c === '\\r' || c === '\\f' || c === '\\v'\n\n for (let i = 0; i < sql.length; i++) {\n const ch = sql[i]\n const next = i + 1 < sql.length ? sql[i + 1] : ''\n const after = i + 2 < sql.length ? sql[i + 2] : ''\n\n if (inLineComment) {\n buf += ch\n if (ch === '\\n') inLineComment = false\n continue\n }\n if (inBlockComment) {\n buf += ch\n if (ch === '*' && next === '/') {\n buf += next\n i++\n inBlockComment = false\n }\n continue\n }\n if (inSingle) {\n // Doubled `''` is an SQL-standard escape — stay in-string.\n if (ch === \"'\" && next === \"'\") {\n buf += ch\n buf += next\n i++\n continue\n }\n buf += ch\n if (ch === '\\\\' && next !== '') {\n buf += next\n i++\n continue\n }\n if (ch === \"'\") inSingle = false\n continue\n }\n if (inDouble) {\n // Doubled `\"\"` is an SQL-standard escape — stay in-string.\n if (ch === '\"' && next === '\"') {\n buf += ch\n buf += next\n i++\n continue\n }\n buf += ch\n if (ch === '\\\\' && next !== '') {\n buf += next\n i++\n continue\n }\n if (ch === '\"') inDouble = false\n continue\n }\n if (inBacktick) {\n buf += ch\n if (ch === '`') inBacktick = false\n continue\n }\n\n // `--` is a comment introducer only when followed by whitespace\n // (or end-of-input). Anything else (`5--3`, `--xyz`) is left as\n // operator-soup and the driver decides what to do with it.\n if (ch === '-' && next === '-' && (after === '' || isCommentWhitespace(after))) {\n buf += ch\n inLineComment = true\n continue\n }\n if (ch === '/' && next === '*') {\n buf += ch\n inBlockComment = true\n continue\n }\n if (ch === \"'\") {\n buf += ch\n inSingle = true\n continue\n }\n if (ch === '\"') {\n buf += ch\n inDouble = true\n continue\n }\n if (ch === '`') {\n buf += ch\n inBacktick = true\n continue\n }\n if (ch === ';') {\n const trimmed = buf.trim()\n if (trimmed.length > 0) out.push(trimmed)\n buf = ''\n continue\n }\n buf += ch\n }\n\n const tail = buf.trim()\n if (tail.length > 0) out.push(tail)\n return out\n}\n\n/**\n * MigrationAdapter implementation backed by mysql2.\n *\n * Asserts MySQL 8.0+ (or MariaDB 10.5+) on first connection (via\n * the first `ensureMigrationTables` call, lazily — no I/O at\n * construction time). Earlier versions throw `KickDbError` with\n * code `KICK_DB_RELATIONAL_NOT_SUPPORTED` carrying the detected\n * version so adopters get a clear error before any query reaches\n * the relational compiler.\n *\n * Multi-statement support: every `query()` call splits the SQL\n * blob at top-level semicolons and runs each statement\n * sequentially. Works against mysql2's default settings; adopters\n * who set `multipleStatements: true` on the pool pay no extra\n * cost (the split is cheap on small DDL blobs).\n *\n * Lock semantics: single-row UPDATE WHERE locked_at IS NULL on\n * `kick_migrations_lock`. Only the row created by\n * `ensureMigrationTables()` exists, so the UPDATE either flips\n * `locked_at` and returns `affectedRows=1` (we won) or matches\n * zero rows (someone else holds it).\n *\n * Introspection: not implemented in v1 — throws `KickDbError` with\n * code `KICK_DB_INTROSPECT_NOT_SUPPORTED`. Drift detection lands\n * in a follow-up that walks `information_schema`.\n */\nexport function mysqlAdapter(opts: MysqlAdapterOptions): MigrationAdapter {\n const dialect: Dialect = 'mysql'\n const { pool } = opts\n let versionVerified = false\n\n async function assertVersion() {\n if (versionVerified) return\n const [rows] = await pool.query<{ version: string }[]>(`SELECT VERSION() AS \\`version\\``)\n const versionString = rows[0]?.version ?? ''\n const parsed = parseMysqlVersion(versionString)\n const failure = checkVersionSupport(parsed, versionString)\n if (failure) {\n throw new KickDbError(\n 'KICK_DB_RELATIONAL_NOT_SUPPORTED',\n `${failure}. JSON_ARRAYAGG (required by the relational query layer) shipped in ` +\n `MySQL 8.0 and MariaDB 10.5. Use layer-1/layer-2 queries (selectFrom / selectAll) ` +\n `on older versions.`,\n )\n }\n versionVerified = true\n }\n\n /**\n * Run a (possibly multi-statement) SQL blob via the pool,\n * splitting at top-level `;` so default mysql2 settings work.\n */\n async function runStatements(sql: string): Promise<void> {\n for (const stmt of splitMysqlStatements(sql)) {\n await pool.query(stmt)\n }\n }\n\n /**\n * Same as `runStatements` but on a held connection (used inside\n * `applySqlInTx` so all statements share the BEGIN / COMMIT\n * boundary).\n */\n async function runStatementsOnConn(conn: MysqlConnectionLike, sql: string): Promise<void> {\n for (const stmt of splitMysqlStatements(sql)) {\n await conn.query(stmt)\n }\n }\n\n return {\n dialect,\n\n async ensureMigrationTables() {\n await assertVersion()\n await runStatements(migrationsTableDdl(dialect))\n await runStatements(lockTableDdl(dialect))\n },\n\n async listApplied(): Promise<MigrationRow[]> {\n const [rows] = await pool.query<\n Array<{\n id: string\n name: string\n hash: string\n batch: number\n applied_at: string | Date\n direction: 'up' | 'down'\n }>\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 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 (?, ?, ?, ?, ?)`,\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 = ?`, [id])\n },\n\n async acquireLock(owner: string): Promise<boolean> {\n const [result] = await pool.query<{ affectedRows: number }>(\n `UPDATE \\`kick_migrations_lock\\`\n SET locked_at = CURRENT_TIMESTAMP, locked_by = ?\n WHERE id = 1 AND locked_at IS NULL`,\n [owner],\n )\n return result.affectedRows === 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 conn = await pool.getConnection()\n try {\n await conn.query('START TRANSACTION')\n await runStatementsOnConn(conn, sql)\n await conn.query('COMMIT')\n } catch (err) {\n await conn.query('ROLLBACK').catch(() => {\n // Swallow rollback errors; we're already throwing the original.\n })\n throw err\n } finally {\n conn.release()\n }\n },\n\n async applySqlNoTx(sql: string) {\n await runStatements(sql)\n },\n\n async introspect(): Promise<SchemaSnapshot> {\n // Reverse-engineer the live schema via information_schema. Types come\n // back as the declared COLUMN_TYPE (a code-first `uuid()` reads as\n // `char(36)`), so this powers `kick db introspect`; byte-exact drift\n // against a code-first snapshot needs a dialect-normalised compare.\n return introspectMysql(pool)\n },\n\n async close() {\n // Caller owns the pool. The adapter doesn't end() it —\n // adopters typically share the same pool with the\n // KickDbClient.\n },\n }\n}\n","// mysqlDialect — thin factory over Kysely's MysqlDialect so adopters\n// never have to reach for `import { MysqlDialect } from 'kysely'`.\n// Mirrors the `@forinda/kickjs-db/pg` template; the kysely subpackage\n// is a pinned internal dep of the framework.\n\nimport { MysqlDialect, type Dialect as KyselyDialect } from 'kysely'\nimport { markDialect } from '../../dialect-marker'\n\nimport type { MysqlPoolLike } from './adapter'\n\nexport interface MysqlDialectOptions {\n /**\n * mysql2-compatible pool. Both `mysql.createPool(...)` from\n * `mysql2/promise` and `mysql2.createPool(...)` (callback API\n * wrapped in a promise) match structurally.\n */\n pool: MysqlPoolLike\n}\n\n/**\n * Construct the dialect that `createDbClient({ dialect })` consumes.\n *\n * **MySQL 8.0+ required.** Kickjs-db's relational query layer\n * compiles to `JSON_ARRAYAGG`, which shipped in 8.0. Adapter-side\n * version assertion lands at first connection from `mysqlAdapter()`;\n * see that factory's docs.\n *\n * @example\n * ```ts\n * import { createDbClient } from '@forinda/kickjs-db'\n * import { mysqlAdapter, mysqlDialect } from '@forinda/kickjs-db/mysql'\n * import { createPool } from 'mysql2/promise'\n *\n * const pool = createPool({\n * host: '127.0.0.1', user: 'root', password: '...', database: 'app',\n * })\n *\n * export const db = createDbClient({\n * schema,\n * dialect: mysqlDialect({ pool }),\n * })\n *\n * export const migrationAdapter = mysqlAdapter({ pool })\n * ```\n */\nexport function mysqlDialect(opts: MysqlDialectOptions): KyselyDialect {\n // MysqlDialect's `pool` parameter is typed as `mysql2.Pool` in\n // newer Kysely versions; casting through `unknown` keeps adopters\n // using compatible drivers (e.g. mysql-mariadb forks) working\n // without pulling mysql2's typings into our public surface.\n return markDialect(new MysqlDialect({ pool: opts.pool as unknown as never }), 'mysql')\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"mysql.mjs","names":[],"sources":["../src/adapters/mysql/adapter.ts","../src/adapters/mysql/dialect.ts"],"sourcesContent":["import {\n KickDbError,\n lockTableDdl,\n migrationsTableDdl,\n type Dialect,\n type MigrationAdapter,\n type MigrationRow,\n type SchemaSnapshot,\n} from '../../index'\nimport { introspectMysql } from '../../migrate/introspect-mysql'\n\n/**\n * mysql2-shaped pool that `mysqlAdapter` consumes. Mirrors the\n * structural surface of `mysql2/promise`'s Pool. The adapter only\n * uses `query(...)` and `getConnection(...)` so any mysql2-compatible\n * driver works.\n *\n * Return type is `Promise<[R, unknown]>` (not `[R[], unknown]`) so\n * mysql2's `Pool.query()` is structurally assignable: SELECT\n * statements return `RowDataPacket[]` (so callers pass `R =\n * MyRow[]`), INSERT / UPDATE / DELETE return `ResultSetHeader` (so\n * callers pass `R = ResultSetHeader`). Each adapter call site picks\n * the row shape it expects via the type parameter.\n */\nexport interface MysqlConnectionLike {\n query<R = unknown>(sql: string, params?: readonly unknown[]): Promise<[R, unknown]>\n release(): void\n}\n\nexport interface MysqlPoolLike {\n query<R = unknown>(sql: string, params?: readonly unknown[]): Promise<[R, unknown]>\n getConnection(): Promise<MysqlConnectionLike>\n}\n\nexport interface MysqlAdapterOptions {\n /**\n * mysql2-compatible Pool. Caller-owned — `close()` on the adapter\n * does NOT end the pool because adopters typically share a single\n * pool across the migration adapter and the KickDbClient.\n */\n pool: MysqlPoolLike\n}\n\n/**\n * Minimum supported MySQL major + MariaDB version. `JSON_ARRAYAGG`\n * shipped in MySQL 8.0 and MariaDB 10.5 — earlier versions can't\n * run kickjs-db's relational query layer.\n */\nconst MIN_MYSQL_MAJOR = 8\nconst MIN_MARIADB_MAJOR = 10\nconst MIN_MARIADB_MINOR = 5\n\n/**\n * Parsed shape returned by `parseMysqlVersion`. `flavor` lets\n * adopters distinguish MySQL from MariaDB without re-grepping the\n * raw string.\n */\nexport interface ParsedMysqlVersion {\n flavor: 'mysql' | 'mariadb'\n major: number\n minor: number\n}\n\n/**\n * Parse a MySQL `SELECT VERSION()` string. Handles:\n *\n * - MySQL: `8.0.34`, `8.4.0`, `5.7.42-log`\n * - MariaDB plain: `10.6.11-MariaDB`, `10.5.21-MariaDB-log`,\n * `10.4.32-MariaDB`\n * - MariaDB w/ compat prefix: `5.5.5-10.6.11-MariaDB-1:10.6.11+maria~ubu2004`\n * (the leading `5.5.5-` is a wire-protocol thing for older MySQL\n * clients; the real server version sits immediately before\n * `-MariaDB`)\n *\n * Returns `null` on unparseable input.\n */\nexport function parseMysqlVersion(version: string): ParsedMysqlVersion | null {\n const trimmed = version.trim()\n const isMariaDb = /MariaDB/i.test(trimmed)\n\n if (isMariaDb) {\n // Pull the `major.minor` that sits immediately before\n // `-MariaDB`. This skips the `5.5.5-` compat prefix when\n // present and grabs the real server version regardless of\n // whether one's there.\n const m = /(\\d+)\\.(\\d+)(?:\\.\\d+)?-MariaDB/i.exec(trimmed)\n if (m) {\n const major = Number(m[1])\n const minor = Number(m[2])\n if (Number.isFinite(major) && Number.isFinite(minor)) {\n return { flavor: 'mariadb', major, minor }\n }\n }\n // Fallback for vendor strings we haven't seen — try the\n // leading x.y. Better to surface the wrong floor than to\n // refuse an otherwise valid MariaDB outright.\n const fallback = /^(\\d+)\\.(\\d+)/.exec(trimmed)\n if (!fallback) return null\n const major = Number(fallback[1])\n const minor = Number(fallback[2])\n if (!Number.isFinite(major) || !Number.isFinite(minor)) return null\n return { flavor: 'mariadb', major, minor }\n }\n\n // MySQL: leading x.y from the start of the string.\n const m = /^(\\d+)\\.(\\d+)/.exec(trimmed)\n if (!m) return null\n const major = Number(m[1])\n const minor = Number(m[2])\n if (!Number.isFinite(major) || !Number.isFinite(minor)) return null\n return { flavor: 'mysql', major, minor }\n}\n\n/**\n * Back-compat shim — pre-existing API surface that returned the\n * major version only. Kept exported so adopters depending on it\n * keep working; new code should use `parseMysqlVersion`.\n *\n * @deprecated Use `parseMysqlVersion` for full version + flavor info.\n */\nexport function parseMysqlMajorVersion(version: string): number | null {\n const parsed = parseMysqlVersion(version)\n return parsed?.major ?? null\n}\n\n/**\n * Returns the failure reason if the parsed version doesn't satisfy\n * kickjs-db's floor, or `null` if it does. Pure — no I/O.\n */\nfunction checkVersionSupport(parsed: ParsedMysqlVersion | null, raw: string): string | null {\n if (parsed == null) {\n return `unparseable version string: ${raw || '<empty>'}`\n }\n if (parsed.flavor === 'mariadb') {\n if (parsed.major > MIN_MARIADB_MAJOR) return null\n if (parsed.major < MIN_MARIADB_MAJOR) {\n return `MariaDB ${MIN_MARIADB_MAJOR}.${MIN_MARIADB_MINOR}+ required (detected: ${raw})`\n }\n if (parsed.minor < MIN_MARIADB_MINOR) {\n return `MariaDB ${MIN_MARIADB_MAJOR}.${MIN_MARIADB_MINOR}+ required (detected: ${raw})`\n }\n return null\n }\n // MySQL flavor.\n if (parsed.major < MIN_MYSQL_MAJOR) {\n return `MySQL ${MIN_MYSQL_MAJOR}.0+ required (detected: ${raw})`\n }\n return null\n}\n\n/**\n * Split a SQL blob into individual statements at the top-level `;`\n * boundary. Respects single-quote / double-quote / backtick string\n * literals AND `--` line comments + C-style block comments —\n * `;` inside any of those does not terminate a statement.\n *\n * mysql2's default `Pool.query()` rejects multi-statement SQL unless\n * the driver was created with `multipleStatements: true`. Splitting\n * lets the adapter run kickjs-emitted DDL (multi-statement, but\n * always semicolon-separated at the top level) without that flag.\n *\n * Two MySQL-specific quirks the splitter handles:\n *\n * - **`--` comments require trailing whitespace/end-of-input.**\n * Per MySQL docs, `--` is only a line-comment introducer when\n * followed by whitespace (space/tab/newline) or end-of-input —\n * otherwise it's two unary-minus operators (`5--3` evaluates\n * to `8`). Bare `--xyz` is a parse error in MySQL but kickjs\n * should pass it through unchanged so the driver surfaces the\n * real error, not silently swallow the rest of the line.\n * - **Doubled-quote string escapes.** MySQL accepts both\n * backslash-escapes (`'it\\'s'`) and SQL-standard doubled-quote\n * escapes (`'it''s'`). The state machine peeks for the doubled\n * form and stays in-string. Same rule applies to `\"\"` inside\n * double-quoted strings.\n *\n * Adopter-written migrations with pathological SQL — e.g. `;` in\n * an unterminated block comment — won't split correctly.\n * Documented in the README; turn on `multipleStatements: true` on\n * the pool if you hit it.\n */\nexport function splitMysqlStatements(sql: string): string[] {\n const out: string[] = []\n let buf = ''\n let inSingle = false\n let inDouble = false\n let inBacktick = false\n let inLineComment = false\n let inBlockComment = false\n\n const isCommentWhitespace = (c: string) =>\n c === ' ' || c === '\\t' || c === '\\n' || c === '\\r' || c === '\\f' || c === '\\v'\n\n for (let i = 0; i < sql.length; i++) {\n const ch = sql[i]\n const next = i + 1 < sql.length ? sql[i + 1] : ''\n const after = i + 2 < sql.length ? sql[i + 2] : ''\n\n if (inLineComment) {\n buf += ch\n if (ch === '\\n') inLineComment = false\n continue\n }\n if (inBlockComment) {\n buf += ch\n if (ch === '*' && next === '/') {\n buf += next\n i++\n inBlockComment = false\n }\n continue\n }\n if (inSingle) {\n // Doubled `''` is an SQL-standard escape — stay in-string.\n if (ch === \"'\" && next === \"'\") {\n buf += ch\n buf += next\n i++\n continue\n }\n buf += ch\n if (ch === '\\\\' && next !== '') {\n buf += next\n i++\n continue\n }\n if (ch === \"'\") inSingle = false\n continue\n }\n if (inDouble) {\n // Doubled `\"\"` is an SQL-standard escape — stay in-string.\n if (ch === '\"' && next === '\"') {\n buf += ch\n buf += next\n i++\n continue\n }\n buf += ch\n if (ch === '\\\\' && next !== '') {\n buf += next\n i++\n continue\n }\n if (ch === '\"') inDouble = false\n continue\n }\n if (inBacktick) {\n buf += ch\n if (ch === '`') inBacktick = false\n continue\n }\n\n // `--` is a comment introducer only when followed by whitespace\n // (or end-of-input). Anything else (`5--3`, `--xyz`) is left as\n // operator-soup and the driver decides what to do with it.\n if (ch === '-' && next === '-' && (after === '' || isCommentWhitespace(after))) {\n buf += ch\n inLineComment = true\n continue\n }\n if (ch === '/' && next === '*') {\n buf += ch\n inBlockComment = true\n continue\n }\n if (ch === \"'\") {\n buf += ch\n inSingle = true\n continue\n }\n if (ch === '\"') {\n buf += ch\n inDouble = true\n continue\n }\n if (ch === '`') {\n buf += ch\n inBacktick = true\n continue\n }\n if (ch === ';') {\n const trimmed = buf.trim()\n if (trimmed.length > 0) out.push(trimmed)\n buf = ''\n continue\n }\n buf += ch\n }\n\n const tail = buf.trim()\n if (tail.length > 0) out.push(tail)\n return out\n}\n\n/**\n * MigrationAdapter implementation backed by mysql2.\n *\n * Asserts MySQL 8.0+ (or MariaDB 10.5+) on first connection (via\n * the first `ensureMigrationTables` call, lazily — no I/O at\n * construction time). Earlier versions throw `KickDbError` with\n * code `KICK_DB_RELATIONAL_NOT_SUPPORTED` carrying the detected\n * version so adopters get a clear error before any query reaches\n * the relational compiler.\n *\n * Multi-statement support: every `query()` call splits the SQL\n * blob at top-level semicolons and runs each statement\n * sequentially. Works against mysql2's default settings; adopters\n * who set `multipleStatements: true` on the pool pay no extra\n * cost (the split is cheap on small DDL blobs).\n *\n * Lock semantics: single-row UPDATE WHERE locked_at IS NULL on\n * `kick_migrations_lock`. Only the row created by\n * `ensureMigrationTables()` exists, so the UPDATE either flips\n * `locked_at` and returns `affectedRows=1` (we won) or matches\n * zero rows (someone else holds it).\n *\n * Introspection: not implemented in v1 — throws `KickDbError` with\n * code `KICK_DB_INTROSPECT_NOT_SUPPORTED`. Drift detection lands\n * in a follow-up that walks `information_schema`.\n */\nexport function mysqlAdapter(opts: MysqlAdapterOptions): MigrationAdapter {\n const dialect: Dialect = 'mysql'\n const { pool } = opts\n let versionVerified = false\n\n async function assertVersion() {\n if (versionVerified) return\n const [rows] = await pool.query<{ version: string }[]>(`SELECT VERSION() AS \\`version\\``)\n const versionString = rows[0]?.version ?? ''\n const parsed = parseMysqlVersion(versionString)\n const failure = checkVersionSupport(parsed, versionString)\n if (failure) {\n throw new KickDbError(\n 'KICK_DB_RELATIONAL_NOT_SUPPORTED',\n `${failure}. JSON_ARRAYAGG (required by the relational query layer) shipped in ` +\n `MySQL 8.0 and MariaDB 10.5. Use layer-1/layer-2 queries (selectFrom / selectAll) ` +\n `on older versions.`,\n )\n }\n versionVerified = true\n }\n\n /**\n * Run a (possibly multi-statement) SQL blob via the pool,\n * splitting at top-level `;` so default mysql2 settings work.\n */\n async function runStatements(sql: string): Promise<void> {\n for (const stmt of splitMysqlStatements(sql)) {\n await pool.query(stmt)\n }\n }\n\n /**\n * Same as `runStatements` but on a held connection (used inside\n * `applySqlInTx` so all statements share the BEGIN / COMMIT\n * boundary).\n */\n async function runStatementsOnConn(conn: MysqlConnectionLike, sql: string): Promise<void> {\n for (const stmt of splitMysqlStatements(sql)) {\n await conn.query(stmt)\n }\n }\n\n return {\n dialect,\n\n async ensureMigrationTables() {\n await assertVersion()\n await runStatements(migrationsTableDdl(dialect))\n await runStatements(lockTableDdl(dialect))\n },\n\n async listApplied(): Promise<MigrationRow[]> {\n const [rows] = await pool.query<\n Array<{\n id: string\n name: string\n hash: string\n batch: number\n applied_at: string | Date\n direction: 'up' | 'down'\n }>\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 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 (?, ?, ?, ?, ?)`,\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 = ?`, [id])\n },\n\n async acquireLock(owner: string): Promise<boolean> {\n const [result] = await pool.query<{ affectedRows: number }>(\n `UPDATE \\`kick_migrations_lock\\`\n SET locked_at = CURRENT_TIMESTAMP, locked_by = ?\n WHERE id = 1 AND locked_at IS NULL`,\n [owner],\n )\n return result.affectedRows === 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 conn = await pool.getConnection()\n try {\n await conn.query('START TRANSACTION')\n await runStatementsOnConn(conn, sql)\n await conn.query('COMMIT')\n } catch (err) {\n await conn.query('ROLLBACK').catch(() => {\n // Swallow rollback errors; we're already throwing the original.\n })\n throw err\n } finally {\n conn.release()\n }\n },\n\n async applySqlNoTx(sql: string) {\n await runStatements(sql)\n },\n\n async introspect(): Promise<SchemaSnapshot> {\n // Reverse-engineer the live schema via information_schema. Types come\n // back as the declared COLUMN_TYPE (a code-first `uuid()` reads as\n // `char(36)`), so this powers `kick db introspect`; byte-exact drift\n // against a code-first snapshot needs a dialect-normalised compare.\n return introspectMysql(pool)\n },\n\n async close() {\n // Caller owns the pool. The adapter doesn't end() it —\n // adopters typically share the same pool with the\n // KickDbClient.\n },\n }\n}\n","// mysqlDialect — thin factory over Kysely's MysqlDialect so adopters\n// never have to reach for `import { MysqlDialect } from 'kysely'`.\n// Mirrors the `@forinda/kickjs-db/pg` template; the kysely subpackage\n// is a pinned internal dep of the framework.\n\nimport { MysqlDialect, type Dialect as KyselyDialect } from 'kysely'\nimport { markDialect } from '../../dialect-marker'\n\nimport type { MysqlPoolLike } from './adapter'\n\nexport interface MysqlDialectOptions {\n /**\n * mysql2-compatible pool. Both `mysql.createPool(...)` from\n * `mysql2/promise` and `mysql2.createPool(...)` (callback API\n * wrapped in a promise) match structurally.\n */\n pool: MysqlPoolLike\n}\n\n/**\n * Construct the dialect that `createDbClient({ dialect })` consumes.\n *\n * **MySQL 8.0+ required.** Kickjs-db's relational query layer\n * compiles to `JSON_ARRAYAGG`, which shipped in 8.0. Adapter-side\n * version assertion lands at first connection from `mysqlAdapter()`;\n * see that factory's docs.\n *\n * @example\n * ```ts\n * import { createDbClient } from '@forinda/kickjs-db'\n * import { mysqlAdapter, mysqlDialect } from '@forinda/kickjs-db/mysql'\n * import { createPool } from 'mysql2/promise'\n *\n * const pool = createPool({\n * host: '127.0.0.1', user: 'root', password: '...', database: 'app',\n * })\n *\n * export const db = createDbClient({\n * schema,\n * dialect: mysqlDialect({ pool }),\n * })\n *\n * export const migrationAdapter = mysqlAdapter({ pool })\n * ```\n */\nexport function mysqlDialect(opts: MysqlDialectOptions): KyselyDialect {\n // MysqlDialect's `pool` parameter is typed as `mysql2.Pool` in\n // newer Kysely versions; casting through `unknown` keeps adopters\n // using compatible drivers (e.g. mysql-mariadb forks) working\n // without pulling mysql2's typings into our public surface.\n return markDialect(new MysqlDialect({ pool: opts.pool as unknown as never }), 'mysql')\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @forinda/kickjs-db v7.4.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{r as ColumnBuilder}from"./custom-type-j8k__3sL.mjs";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`)}export{money as a,vector as c,inet as i,xml as l,cidr as n,pgEnum as o,citext as r,tsvector as s,PgEnumColumnBuilder as t};
|
|
12
|
+
//# sourceMappingURL=pg-BJmYKLhI.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pg-BJmYKLhI.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":";;;;;;;;;;2DAsCA,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"}
|
package/dist/pg.d.mts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
|
|
2
|
-
import {
|
|
2
|
+
import { l as ColumnBuilder, n as TableDecl, o as IndexDecl, u as ColumnRef } from "./table-Bl5SbKRg.mjs";
|
|
3
|
+
import { qt as MigrationAdapter } from "./index-DF69HndC.mjs";
|
|
3
4
|
import { Dialect } from "kysely";
|
|
4
5
|
//#region src/dsl/columns/pg.d.ts
|
|
5
6
|
/**
|
|
@@ -26,28 +27,28 @@ import { Dialect } from "kysely";
|
|
|
26
27
|
* `CREATE TYPE <name> AS ENUM (...)` DDL manually before any column
|
|
27
28
|
* referencing the type is created.
|
|
28
29
|
*/
|
|
29
|
-
interface PgEnumBuilder<TName extends string, TValues extends readonly string[]> {
|
|
30
|
+
export interface PgEnumBuilder<TName extends string, TValues extends readonly string[]> {
|
|
30
31
|
(): PgEnumColumnBuilder<TName, TValues>;
|
|
31
32
|
/** The SQL identifier — used by emit + drift detection. */
|
|
32
33
|
readonly enumName: TName;
|
|
33
34
|
/** Allowed literal values, in declaration order. */
|
|
34
35
|
readonly values: TValues;
|
|
35
36
|
}
|
|
36
|
-
declare class PgEnumColumnBuilder<TName extends string, TValues extends readonly string[]> extends ColumnBuilder<TValues[number]> {
|
|
37
|
+
export declare class PgEnumColumnBuilder<TName extends string, TValues extends readonly string[]> extends ColumnBuilder<TValues[number]> {
|
|
37
38
|
/** The enum's SQL identifier — preserved for emit + drift detection. */
|
|
38
39
|
readonly enumName: TName;
|
|
39
40
|
/** Allowed values — readonly to prevent mutation across columns. */
|
|
40
41
|
readonly values: TValues;
|
|
41
42
|
constructor(enumName: TName, values: TValues);
|
|
42
43
|
}
|
|
43
|
-
declare function pgEnum<TName extends string, const TValues extends readonly [string, ...string[]]>(name: TName, ...values: TValues): PgEnumBuilder<TName, TValues>;
|
|
44
|
-
declare function tsvector(): ColumnBuilder<string>;
|
|
45
|
-
declare function vector(dim?: number): ColumnBuilder<number[]>;
|
|
46
|
-
declare function citext(): ColumnBuilder<string>;
|
|
47
|
-
declare function money(): ColumnBuilder<string>;
|
|
48
|
-
declare function inet(): ColumnBuilder<string>;
|
|
49
|
-
declare function cidr(): ColumnBuilder<string>;
|
|
50
|
-
declare function xml(): ColumnBuilder<string>;
|
|
44
|
+
export declare function pgEnum<TName extends string, const TValues extends readonly [string, ...string[]]>(name: TName, ...values: TValues): PgEnumBuilder<TName, TValues>;
|
|
45
|
+
export declare function tsvector(): ColumnBuilder<string>;
|
|
46
|
+
export declare function vector(dim?: number): ColumnBuilder<number[]>;
|
|
47
|
+
export declare function citext(): ColumnBuilder<string>;
|
|
48
|
+
export declare function money(): ColumnBuilder<string>;
|
|
49
|
+
export declare function inet(): ColumnBuilder<string>;
|
|
50
|
+
export declare function cidr(): ColumnBuilder<string>;
|
|
51
|
+
export declare function xml(): ColumnBuilder<string>;
|
|
51
52
|
//#endregion
|
|
52
53
|
//#region src/dsl/pg-schema.d.ts
|
|
53
54
|
/**
|
|
@@ -76,7 +77,7 @@ declare function xml(): ColumnBuilder<string>;
|
|
|
76
77
|
* then diffing against MySQL/SQLite throws rather than emitting DDL that
|
|
77
78
|
* looks right and means something else.
|
|
78
79
|
*/
|
|
79
|
-
interface PgSchema<TSchema extends string | undefined = string | undefined> {
|
|
80
|
+
export interface PgSchema<TSchema extends string | undefined = string | undefined> {
|
|
80
81
|
readonly __isPgSchema: true;
|
|
81
82
|
/** The schema name as declared, e.g. `billing`. */
|
|
82
83
|
readonly name: string;
|
|
@@ -101,15 +102,15 @@ type EffectiveSchema<TName extends string> = TName extends 'public' ? undefined
|
|
|
101
102
|
* `pgSchema('public')` is accepted and collapses to "no schema" — see
|
|
102
103
|
* {@link EffectiveSchema} for why that matters.
|
|
103
104
|
*/
|
|
104
|
-
declare function pgSchema<TName extends string>(name: TName): PgSchema<EffectiveSchema<TName>>;
|
|
105
|
-
declare function isPgSchema(value: unknown): value is PgSchema<string>;
|
|
105
|
+
export declare function pgSchema<TName extends string>(name: TName): PgSchema<EffectiveSchema<TName>>;
|
|
106
|
+
export declare function isPgSchema(value: unknown): value is PgSchema<string>;
|
|
106
107
|
//#endregion
|
|
107
108
|
//#region src/adapters/pg/adapter.d.ts
|
|
108
109
|
/**
|
|
109
110
|
* Minimal client returned by PgPoolLike.connect(). Matches the shape of
|
|
110
111
|
* pg.PoolClient and @neondatabase/serverless's PoolClient.
|
|
111
112
|
*/
|
|
112
|
-
interface PgClientLike {
|
|
113
|
+
export interface PgClientLike {
|
|
113
114
|
query<R = unknown>(sql: string, params?: readonly unknown[]): Promise<{
|
|
114
115
|
rows: R[];
|
|
115
116
|
rowCount: number | null;
|
|
@@ -127,14 +128,14 @@ interface PgClientLike {
|
|
|
127
128
|
* Cloudflare D1's batch-only model) have their own adapter packages that
|
|
128
129
|
* implement MigrationAdapter directly — they don't reuse this shape.
|
|
129
130
|
*/
|
|
130
|
-
interface PgPoolLike {
|
|
131
|
+
export interface PgPoolLike {
|
|
131
132
|
query<R = unknown>(sql: string, params?: readonly unknown[]): Promise<{
|
|
132
133
|
rows: R[];
|
|
133
134
|
rowCount: number | null;
|
|
134
135
|
}>;
|
|
135
136
|
connect(): Promise<PgClientLike>;
|
|
136
137
|
}
|
|
137
|
-
interface PgAdapterOptions {
|
|
138
|
+
export interface PgAdapterOptions {
|
|
138
139
|
/**
|
|
139
140
|
* A pg-protocol-compatible Pool. Concretely: pg.Pool, neon-serverless Pool,
|
|
140
141
|
* any other Pool that satisfies the {@link PgPoolLike} structural shape.
|
|
@@ -153,10 +154,10 @@ interface PgAdapterOptions {
|
|
|
153
154
|
* exists, so the UPDATE either flips locked_at and returns rowCount=1
|
|
154
155
|
* (we won) or matches zero rows (someone else holds it).
|
|
155
156
|
*/
|
|
156
|
-
declare function pgAdapter(opts: PgAdapterOptions): MigrationAdapter;
|
|
157
|
+
export declare function pgAdapter(opts: PgAdapterOptions): MigrationAdapter;
|
|
157
158
|
//#endregion
|
|
158
159
|
//#region src/adapters/pg/dialect.d.ts
|
|
159
|
-
interface PgDialectOptions {
|
|
160
|
+
export interface PgDialectOptions {
|
|
160
161
|
/**
|
|
161
162
|
* pg-protocol-compatible pool. Both `pg.Pool` and
|
|
162
163
|
* `@neondatabase/serverless`'s Pool match structurally; adopters
|
|
@@ -183,7 +184,6 @@ interface PgDialectOptions {
|
|
|
183
184
|
* export const migrationAdapter = pgAdapter({ pool })
|
|
184
185
|
* ```
|
|
185
186
|
*/
|
|
186
|
-
declare function pgDialect(opts: PgDialectOptions): Dialect;
|
|
187
|
+
export declare function pgDialect(opts: PgDialectOptions): Dialect;
|
|
187
188
|
//#endregion
|
|
188
|
-
export { PgAdapterOptions, PgClientLike, PgDialectOptions, PgEnumBuilder, PgEnumColumnBuilder, PgPoolLike, PgSchema, cidr, citext, inet, isPgSchema, money, pgAdapter, pgDialect, pgEnum, pgSchema, tsvector, vector, xml };
|
|
189
189
|
//# 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","../src/dsl/pg-schema.ts","../src/adapters/pg/adapter.ts","../src/adapters/pg/dialect.ts"],"mappings":"
|
|
1
|
+
{"version":3,"file":"pg.d.mts","names":[],"sources":["../src/dsl/columns/pg.ts","../src/dsl/pg-schema.ts","../src/adapters/pg/adapter.ts","../src/adapters/pg/dialect.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BiB,cAAc,sBAAsB;MAC/C,oBAAoB,OAAO;;WAEtB,UAAU;;WAEV,QAAQ;;qBAGN,oBACX,sBACA,2CACQ,cAAc;;WAEb,UAAU;;WAEV,QAAQ;EAEjB,YAAY,UAAU,OAAO,QAAQ;;wBAgBvB,OAAO,4BAA4B,gDACjD,MAAM,UACH,QAAQ,UACV,cAAc,OAAO;wBASR,YAAY;wBAIZ,OAAO,eAAe;wBAItB,UAAU;wBAIV,SAAS;wBAIT,QAAQ;wBAIR,QAAQ;wBAIR,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBCrEN,SAAS;WACf;;WAEA;EAET,MAAM,sBAAsB,UAAU,eAAe,gBACnD,MAAM,OACN,SAAS,GACT,eAAe,SAAS,WAAW,IAAI,iBAAgB,eAAe,aACrE,UAAU,OAAO,GAAG,cAAc,WAAW,IAAI;;;;;;;;;;;;;;KAejD,gBAAgB,wBAAwB,qCAAqC;;;;;;;wBAWlE,SAAS,sBAAsB,MAAM,QAAQ,SAAS,gBAAgB;wBA6BtE,WAAW,iBAAiB,SAAS;;;;;;;iBChFpC;EACf,MAAM,aACJ,aACA,8BACC;IAAU,MAAM;IAAK;;EACxB;;;;;;;;;;;;;iBAce;EACf,MAAM,aACJ,aACA,8BACC;IAAU,MAAM;IAAK;;EACxB,WAAW,QAAQ;;iBAGJ;;;;;EAKf,MAAM;;EAEN;;;;;;;;;;;;wBAec,UAAU,MAAM,mBAAmB;;;iBCpDlC;;;;;;EAMf,MAAM;;;;;;;;;;;;;;;;;;;;;wBAsBQ,UAAU,MAAM,mBAAmB"}
|
package/dist/pg.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs-db v7.
|
|
2
|
+
* @forinda/kickjs-db v7.4.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{
|
|
11
|
+
import{It as buildTable,R as markDialect,at as lockTableDdl,ot as migrationsTableDdl,tt as introspectPg}from"./src-BnHTLx5l.mjs";import{a as money,c as vector,i as inet,l as xml,n as cidr,o as pgEnum,r as citext,s as tsvector,t as PgEnumColumnBuilder}from"./pg-BJmYKLhI.mjs";import{PostgresDialect}from"kysely";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,constraints){return buildTable(tableName,columns,constraints,effective)}}}function isPgSchema(value){return typeof value==`object`&&!!value&&value.__isPgSchema===!0}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
12
|
FROM kick_migrations
|
|
13
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
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
|
package/dist/pg.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pg.mjs","names":[],"sources":["../src/dsl/columns/pg.ts","../src/dsl/pg-schema.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 type { ColumnBuilder, ColumnRef } from './columns/types'\nimport type { IndexDecl } from './constraints'\nimport { buildTable, type TableDecl } from './table'\n\n/**\n * PostgreSQL named-schema namespace.\n *\n * ```ts\n * const billing = pgSchema('billing')\n *\n * const invoices = billing.table('invoices', {\n * id: uuid().primaryKey().defaultRandom(),\n * total: numeric().notNull(),\n * })\n * ```\n *\n * Emits `CREATE SCHEMA IF NOT EXISTS \"billing\"` ahead of the tables that need\n * it, qualifies every generated statement (`\"billing\".\"invoices\"`), and keys\n * the row type as `KickDbSchema['billing.invoices']` so Kysely resolves the\n * qualified table without a `withSchema()` call.\n *\n * Tables declared through the bare `table()` factory are untouched: no schema\n * field, bare identifiers, same snapshot bytes and migration hashes as before.\n *\n * PostgreSQL only. A schema is a true namespace only on PG — on MySQL the\n * word means \"database\" and on SQLite it means an `ATTACH` alias, both of\n * which have different lifecycles than `CREATE SCHEMA`. Declaring one and\n * then diffing against MySQL/SQLite throws rather than emitting DDL that\n * looks right and means something else.\n */\nexport interface PgSchema<TSchema extends string | undefined = string | undefined> {\n readonly __isPgSchema: true\n /** The schema name as declared, e.g. `billing`. */\n readonly name: string\n\n table<TName extends string, C extends Record<string, ColumnBuilder>>(\n name: TName,\n columns: C,\n constraints?: (refs: { [K in keyof C]: ColumnRef }) => Record<string, IndexDecl>,\n ): TableDecl<TName, C, TSchema> & { [K in keyof C]: ColumnRef }\n}\n\n/**\n * `public` resolves to \"no schema\" rather than to itself.\n *\n * PG creates `public` for every database and puts it on the default\n * search_path, so `pgSchema('public').table('users', …)` and\n * `table('users', …)` name the same physical table. If the former stamped\n * `schema: 'public'`, its snapshot key would be `public.users` while the\n * latter's is `users` — the diff engine would read that as \"drop `users`,\n * create `public.users`\" and emit a DROP TABLE. Collapsing to `undefined`\n * keeps the two spellings interchangeable, and the conditional return type\n * below keeps the static key in step with the runtime one.\n */\ntype EffectiveSchema<TName extends string> = TName extends 'public' ? undefined : TName\n\n/** Reject names that would need quoting gymnastics or inject into DDL. */\nconst SCHEMA_NAME = /^[A-Za-z_][A-Za-z0-9_$]*$/\n\n/**\n * Declare a PostgreSQL schema namespace. See {@link PgSchema}.\n *\n * `pgSchema('public')` is accepted and collapses to \"no schema\" — see\n * {@link EffectiveSchema} for why that matters.\n */\nexport function pgSchema<TName extends string>(name: TName): PgSchema<EffectiveSchema<TName>> {\n // The typeof check is load-bearing, not belt-and-braces: `RegExp.test(x)`\n // stringifies its argument, so the regex alone accepts `undefined`\n // ('undefined'), `null` ('null'), `true` ('true') and `['a']` ('a'). Each\n // fails differently downstream — `undefined` yields a silently unqualified\n // table, `null` serializes `\"schema\": null` into the snapshot, and the\n // others key a table `\"true.x\"` / `\"a.x\"` and emit DDL creating a schema by\n // that name. TS forbids all of them; JS callers and `any` do not.\n if (typeof name !== 'string' || !SCHEMA_NAME.test(name)) {\n throw new Error(\n `pgSchema: invalid schema name ${JSON.stringify(name)}. ` +\n `Expected an unquoted PostgreSQL identifier matching ${SCHEMA_NAME.source}.`,\n )\n }\n const effective = (name === 'public' ? undefined : name) as EffectiveSchema<TName>\n\n return {\n __isPgSchema: true,\n name,\n table<TName2 extends string, C extends Record<string, ColumnBuilder>>(\n tableName: TName2,\n columns: C,\n constraints?: (refs: { [K in keyof C]: ColumnRef }) => Record<string, IndexDecl>,\n ) {\n return buildTable(tableName, columns, constraints, effective)\n },\n }\n}\n\nexport function isPgSchema(value: unknown): value is PgSchema<string> {\n return (\n typeof value === 'object' &&\n value !== null &&\n (value as { __isPgSchema?: unknown }).__isPgSchema === true\n )\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'\nimport { markDialect } from '../../dialect-marker'\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 markDialect(new PostgresDialect({ pool: opts.pool as unknown as never }), 'postgres')\n}\n"],"mappings":";;;;;;;;;;wLAsCA,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,CC5CA,MAAM,YAAc,4BAQpB,SAAgB,SAA+B,KAA+C,CAQ5F,GAAI,OAAO,MAAS,UAAY,CAAC,YAAY,KAAK,IAAI,EACpD,MAAU,MACR,iCAAiC,KAAK,UAAU,IAAI,EAAE,wDACG,YAAY,OAAO,EAC9E,EAEF,IAAM,UAAa,OAAS,SAAW,IAAA,GAAY,KAEnD,MAAO,CACL,aAAc,GACd,KACA,MACE,UACA,QACA,YACA,CACA,OAAO,WAAW,UAAW,QAAS,YAAa,SAAS,CAC9D,CACF,CACF,CAEA,SAAgB,WAAW,MAA2C,CACpE,OACE,OAAO,OAAU,YACjB,OACC,MAAqC,eAAiB,EAE3D,CCjDA,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,CC9HA,SAAgB,UAAU,KAAuC,CAK/D,OAAO,YAAY,IAAI,gBAAgB,CAAE,KAAM,KAAK,IAAyB,CAAC,EAAG,UAAU,CAC7F"}
|
|
1
|
+
{"version":3,"file":"pg.mjs","names":[],"sources":["../src/dsl/pg-schema.ts","../src/adapters/pg/adapter.ts","../src/adapters/pg/dialect.ts"],"sourcesContent":["import type { ColumnBuilder, ColumnRef } from './columns/types'\nimport type { IndexDecl } from './constraints'\nimport { buildTable, type TableDecl } from './table'\n\n/**\n * PostgreSQL named-schema namespace.\n *\n * ```ts\n * const billing = pgSchema('billing')\n *\n * const invoices = billing.table('invoices', {\n * id: uuid().primaryKey().defaultRandom(),\n * total: numeric().notNull(),\n * })\n * ```\n *\n * Emits `CREATE SCHEMA IF NOT EXISTS \"billing\"` ahead of the tables that need\n * it, qualifies every generated statement (`\"billing\".\"invoices\"`), and keys\n * the row type as `KickDbSchema['billing.invoices']` so Kysely resolves the\n * qualified table without a `withSchema()` call.\n *\n * Tables declared through the bare `table()` factory are untouched: no schema\n * field, bare identifiers, same snapshot bytes and migration hashes as before.\n *\n * PostgreSQL only. A schema is a true namespace only on PG — on MySQL the\n * word means \"database\" and on SQLite it means an `ATTACH` alias, both of\n * which have different lifecycles than `CREATE SCHEMA`. Declaring one and\n * then diffing against MySQL/SQLite throws rather than emitting DDL that\n * looks right and means something else.\n */\nexport interface PgSchema<TSchema extends string | undefined = string | undefined> {\n readonly __isPgSchema: true\n /** The schema name as declared, e.g. `billing`. */\n readonly name: string\n\n table<TName extends string, C extends Record<string, ColumnBuilder>>(\n name: TName,\n columns: C,\n constraints?: (refs: { [K in keyof C]: ColumnRef }) => Record<string, IndexDecl>,\n ): TableDecl<TName, C, TSchema> & { [K in keyof C]: ColumnRef }\n}\n\n/**\n * `public` resolves to \"no schema\" rather than to itself.\n *\n * PG creates `public` for every database and puts it on the default\n * search_path, so `pgSchema('public').table('users', …)` and\n * `table('users', …)` name the same physical table. If the former stamped\n * `schema: 'public'`, its snapshot key would be `public.users` while the\n * latter's is `users` — the diff engine would read that as \"drop `users`,\n * create `public.users`\" and emit a DROP TABLE. Collapsing to `undefined`\n * keeps the two spellings interchangeable, and the conditional return type\n * below keeps the static key in step with the runtime one.\n */\ntype EffectiveSchema<TName extends string> = TName extends 'public' ? undefined : TName\n\n/** Reject names that would need quoting gymnastics or inject into DDL. */\nconst SCHEMA_NAME = /^[A-Za-z_][A-Za-z0-9_$]*$/\n\n/**\n * Declare a PostgreSQL schema namespace. See {@link PgSchema}.\n *\n * `pgSchema('public')` is accepted and collapses to \"no schema\" — see\n * {@link EffectiveSchema} for why that matters.\n */\nexport function pgSchema<TName extends string>(name: TName): PgSchema<EffectiveSchema<TName>> {\n // The typeof check is load-bearing, not belt-and-braces: `RegExp.test(x)`\n // stringifies its argument, so the regex alone accepts `undefined`\n // ('undefined'), `null` ('null'), `true` ('true') and `['a']` ('a'). Each\n // fails differently downstream — `undefined` yields a silently unqualified\n // table, `null` serializes `\"schema\": null` into the snapshot, and the\n // others key a table `\"true.x\"` / `\"a.x\"` and emit DDL creating a schema by\n // that name. TS forbids all of them; JS callers and `any` do not.\n if (typeof name !== 'string' || !SCHEMA_NAME.test(name)) {\n throw new Error(\n `pgSchema: invalid schema name ${JSON.stringify(name)}. ` +\n `Expected an unquoted PostgreSQL identifier matching ${SCHEMA_NAME.source}.`,\n )\n }\n const effective = (name === 'public' ? undefined : name) as EffectiveSchema<TName>\n\n return {\n __isPgSchema: true,\n name,\n table<TName2 extends string, C extends Record<string, ColumnBuilder>>(\n tableName: TName2,\n columns: C,\n constraints?: (refs: { [K in keyof C]: ColumnRef }) => Record<string, IndexDecl>,\n ) {\n return buildTable(tableName, columns, constraints, effective)\n },\n }\n}\n\nexport function isPgSchema(value: unknown): value is PgSchema<string> {\n return (\n typeof value === 'object' &&\n value !== null &&\n (value as { __isPgSchema?: unknown }).__isPgSchema === true\n )\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'\nimport { markDialect } from '../../dialect-marker'\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 markDialect(new PostgresDialect({ pool: opts.pool as unknown as never }), 'postgres')\n}\n"],"mappings":";;;;;;;;;;uTAyDA,MAAM,YAAc,4BAQpB,SAAgB,SAA+B,KAA+C,CAQ5F,GAAI,OAAO,MAAS,UAAY,CAAC,YAAY,KAAK,IAAI,EACpD,MAAU,MACR,iCAAiC,KAAK,UAAU,IAAI,EAAE,wDACG,YAAY,OAAO,EAC9E,EAEF,IAAM,UAAa,OAAS,SAAW,IAAA,GAAY,KAEnD,MAAO,CACL,aAAc,GACd,KACA,MACE,UACA,QACA,YACA,CACA,OAAO,WAAW,UAAW,QAAS,YAAa,SAAS,CAC9D,CACF,CACF,CAEA,SAAgB,WAAW,MAA2C,CACpE,OACE,OAAO,OAAU,YACjB,OACC,MAAqC,eAAiB,EAE3D,CCjDA,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,CC9HA,SAAgB,UAAU,KAAuC,CAK/D,OAAO,YAAY,IAAI,gBAAgB,CAAE,KAAM,KAAK,IAAyB,CAAC,EAAG,UAAU,CAC7F"}
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
|
|
2
|
+
import { g as NotNullBrand, l as ColumnBuilder, n as TableDecl, p as GeneratedBrand } from "./table-Bl5SbKRg.mjs";
|
|
3
|
+
//#region src/schema.d.ts
|
|
4
|
+
type ColumnsOf<T> = T extends TableDecl<string, infer C, string | undefined> ? C : never;
|
|
5
|
+
type ValueOf<C> = C extends ColumnBuilder<infer V> ? V : never;
|
|
6
|
+
type IsNotNull<C> = C extends NotNullBrand ? true : false;
|
|
7
|
+
/** A row as read from the table. */
|
|
8
|
+
export type InferSelect<T extends TableDecl> = { [K in keyof ColumnsOf<T>]: IsNotNull<ColumnsOf<T>[K]> extends true ? ValueOf<ColumnsOf<T>[K]> : ValueOf<ColumnsOf<T>[K]> | null; };
|
|
9
|
+
type OptionalOnInsert<T> = { [K in keyof ColumnsOf<T>]: ColumnsOf<T>[K] extends GeneratedBrand ? K : IsNotNull<ColumnsOf<T>[K]> extends true ? never : K; }[keyof ColumnsOf<T>];
|
|
10
|
+
/** A row to insert: generated, defaulted and nullable columns may be left out. */
|
|
11
|
+
export type InferInsert<T extends TableDecl> = Omit<InferSelect<T>, OptionalOnInsert<T>> & Partial<Pick<InferSelect<T>, OptionalOnInsert<T>>>;
|
|
12
|
+
/** Extra rules for one column — what a SQL type can't say. */
|
|
13
|
+
export interface ColumnRule {
|
|
14
|
+
/** JSON Schema `format`; `email`, `uri`, `uuid` and `date-time` are also checked. */
|
|
15
|
+
format?: string;
|
|
16
|
+
minLength?: number;
|
|
17
|
+
maxLength?: number;
|
|
18
|
+
/** Checked against the whole string. */
|
|
19
|
+
pattern?: string;
|
|
20
|
+
minimum?: number;
|
|
21
|
+
maximum?: number;
|
|
22
|
+
}
|
|
23
|
+
/** Anything with `safeParse` + `toJsonSchema` — a `KickSchema` (e.g. `fromZod(...)`). */
|
|
24
|
+
export interface SchemaLike {
|
|
25
|
+
safeParse(data: unknown): {
|
|
26
|
+
success: true;
|
|
27
|
+
data: unknown;
|
|
28
|
+
} | {
|
|
29
|
+
success: false;
|
|
30
|
+
issues: unknown[];
|
|
31
|
+
};
|
|
32
|
+
toJsonSchema(options?: JsonSchemaOptions): Record<string, unknown>;
|
|
33
|
+
}
|
|
34
|
+
export interface TableSchemaOptions<T extends TableDecl> {
|
|
35
|
+
columns?: { [K in keyof ColumnsOf<T>]?: ColumnRule | SchemaLike; };
|
|
36
|
+
/** Columns left out of the schema entirely (e.g. `password` on a read). */
|
|
37
|
+
omit?: readonly (keyof ColumnsOf<T>)[];
|
|
38
|
+
}
|
|
39
|
+
export interface JsonSchemaOptions {
|
|
40
|
+
readonly target?: 'draft-2020-12' | 'draft-07' | 'openapi-3.0';
|
|
41
|
+
}
|
|
42
|
+
export interface SchemaIssue {
|
|
43
|
+
path: string[];
|
|
44
|
+
message: string;
|
|
45
|
+
code: string;
|
|
46
|
+
}
|
|
47
|
+
/** The schema these functions return — structurally a `KickSchema<TOutput>` and a Standard Schema. */
|
|
48
|
+
export interface TableSchema<TOutput> {
|
|
49
|
+
safeParse(data: unknown): {
|
|
50
|
+
success: true;
|
|
51
|
+
data: TOutput;
|
|
52
|
+
} | {
|
|
53
|
+
success: false;
|
|
54
|
+
issues: SchemaIssue[];
|
|
55
|
+
};
|
|
56
|
+
toJsonSchema(options?: JsonSchemaOptions): Record<string, unknown>;
|
|
57
|
+
readonly '~standard': {
|
|
58
|
+
readonly version: 1;
|
|
59
|
+
readonly vendor: 'kickjs-db';
|
|
60
|
+
readonly validate: (value: unknown) => {
|
|
61
|
+
value: TOutput;
|
|
62
|
+
issues?: undefined;
|
|
63
|
+
} | {
|
|
64
|
+
issues: ReadonlyArray<{
|
|
65
|
+
message: string;
|
|
66
|
+
path: readonly string[];
|
|
67
|
+
}>;
|
|
68
|
+
};
|
|
69
|
+
readonly types?: {
|
|
70
|
+
readonly input: unknown;
|
|
71
|
+
readonly output: TOutput;
|
|
72
|
+
};
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
/** A row as read: every column present, nullable ones may be `null`. */
|
|
76
|
+
export declare function selectSchema<T extends TableDecl, const O extends keyof ColumnsOf<T> = never>(table: T, options?: TableSchemaOptions<T> & {
|
|
77
|
+
omit?: readonly O[];
|
|
78
|
+
}): TableSchema<Omit<InferSelect<T>, O>>;
|
|
79
|
+
/** A row to insert: serial, defaulted and nullable columns are optional. */
|
|
80
|
+
export declare function insertSchema<T extends TableDecl, const O extends keyof ColumnsOf<T> = never>(table: T, options?: TableSchemaOptions<T> & {
|
|
81
|
+
omit?: readonly O[];
|
|
82
|
+
}): TableSchema<Omit<InferInsert<T>, O>>;
|
|
83
|
+
/** A patch: every column optional. */
|
|
84
|
+
export declare function updateSchema<T extends TableDecl, const O extends keyof ColumnsOf<T> = never>(table: T, options?: TableSchemaOptions<T> & {
|
|
85
|
+
omit?: readonly O[];
|
|
86
|
+
}): TableSchema<Partial<Omit<InferInsert<T>, O>>>;
|
|
87
|
+
//#endregion
|
|
88
|
+
//# sourceMappingURL=schema.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"schema.d.mts","names":[],"sources":["../src/schema.ts"],"mappings":";;;KAoCK,UAAU,KAAK,UAAU,wBAAwB,yBAAyB;KAC1E,QAAQ,KAAK,UAAU,oBAAoB,KAAK;KAChD,UAAU,KAAK,UAAU;;YAGlB,YAAY,UAAU,gBAC/B,WAAW,UAAU,KAAK,UAAU,UAAU,GAAG,mBAC9C,QAAQ,UAAU,GAAG,MACrB,QAAQ,UAAU,GAAG;KAGtB,iBAAiB,QACnB,WAAW,UAAU,KAAK,UAAU,GAAG,WAAW,iBAC/C,IACA,UAAU,UAAU,GAAG,2BAErB,WACA,UAAU;;YAGN,YAAY,UAAU,aAAa,KAAK,YAAY,IAAI,iBAAiB,MACnF,QAAQ,KAAK,YAAY,IAAI,iBAAiB;;iBAG/B;;EAEf;EACA;EACA;;EAEA;EACA;EACA;;;iBAIe;EACf,UAAU;IAAkB;IAAe;;IAAoB;IAAgB;;EAC/E,aAAa,UAAU,oBAAoB;;iBAG5B,mBAAmB,UAAU;EAC5C,aAAa,WAAW,UAAU,MAAM,aAAa;;EAErD,uBAAuB,UAAU;;iBAGlB;WACN;;iBAGM;EACf;EACA;EACA;;;iBAIe,YAAY;EAC3B,UACE;IACG;IAAe,MAAM;;IAAc;IAAgB,QAAQ;;EAChE,aAAa,UAAU,oBAAoB;WAClC;aACE;aACA;aACA,WACP;MAEI,OAAO;MAAS;;MAChB,QAAQ;QAAgB;QAAiB;;;aACtC;eAAmB;eAAyB,QAAQ;;;;;wBAiXjD,aAAa,UAAU,iBAAiB,gBAAgB,UAAU,YAChF,OAAO,GACP,UAAU,mBAAmB;EAAO,gBAAgB;IACnD,YAAY,KAAK,YAAY,IAAI;;wBAKpB,aAAa,UAAU,iBAAiB,gBAAgB,UAAU,YAChF,OAAO,GACP,UAAU,mBAAmB;EAAO,gBAAgB;IACnD,YAAY,KAAK,YAAY,IAAI;;wBAKpB,aAAa,UAAU,iBAAiB,gBAAgB,UAAU,YAChF,OAAO,GACP,UAAU,mBAAmB;EAAO,gBAAgB;IACnD,YAAY,QAAQ,KAAK,YAAY,IAAI"}
|
package/dist/schema.mjs
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @forinda/kickjs-db v7.4.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{t as CustomColumnBuilder}from"./custom-type-j8k__3sL.mjs";import{t as PgEnumColumnBuilder}from"./pg-BJmYKLhI.mjs";const ok=value=>({ok:!0,value}),fail=(message,code=`invalid_type`)=>({ok:!1,message,code}),INTEGER=/^-?\d+$/,DECIMAL=/^-?\d+(\.\d+)?$/,UUID=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,EMAIL=/^[^\s@]+@[^\s@]+\.[^\s@]+$/;function integerSpec(minimum,maximum){return{json:{type:`integer`,minimum,maximum},parse:v=>typeof v!=`number`||!Number.isInteger(v)?fail(`Expected an integer`):v<minimum||v>maximum?fail(`Must be between ${minimum} and ${maximum}`,v<minimum?`too_small`:`too_big`):ok(v)}}const INT16=32767,INT32=2147483647,INT64=2n**63n;function stringSpec(json={},check){return{json:{type:`string`,...json},parse:v=>{if(typeof v!=`string`)return fail(`Expected a string`);let problem=check?.(v);return problem?fail(problem,`invalid_string`):ok(v)}}}function dateSpec(format){return{json:{type:`string`,format},parse:v=>{let date=v instanceof Date?v:typeof v==`string`?new Date(v):void 0;return date&&!Number.isNaN(date.getTime())?ok(date):fail(`Expected a ${format===`date`?`date`:`date-time`} string`)}}}function specFor(builder){if(builder instanceof PgEnumColumnBuilder){let values=builder.values;return{json:{type:`string`,enum:[...values]},parse:v=>typeof v==`string`&&values.includes(v)?ok(v):fail(`Expected one of ${values.join(`, `)}`,`invalid_enum_value`)}}if(builder instanceof CustomColumnBuilder)return anySpec();let type=builder.__state().type.toLowerCase();return type.endsWith(`[]`)?arraySpec(specForType(type.slice(0,-2))):specForType(type)}function anySpec(){return{json:{},parse:ok}}function arraySpec(item,length){return{json:{type:`array`,items:item.json,...length===void 0?{}:{minItems:length,maxItems:length}},parse:v=>{if(!Array.isArray(v))return fail(`Expected an array`);if(length!==void 0&&v.length!==length)return fail(`Expected ${length} items`,`invalid_length`);let out=[];for(let[i,element]of v.entries()){let parsed=item.parse(element);if(!parsed.ok)return fail(`[${i}]: ${parsed.message}`,parsed.code);out.push(parsed.value)}return ok(out)}}}function specForType(type){let base=type.replace(/\(.*$/,``).trim(),size=Number(/\((\d+)/.exec(type)?.[1]);switch(base){case`smallserial`:return integerSpec(1,INT16);case`serial`:return integerSpec(1,INT32);case`smallint`:return integerSpec(-32768,INT16);case`integer`:case`int`:return integerSpec(-2147483648,INT32);case`bigserial`:case`bigint`:return{json:{type:`string`,pattern:INTEGER.source},parse:v=>{if(!(typeof v==`number`&&Number.isInteger(v))&&!(typeof v==`string`&&INTEGER.test(v)))return fail(`Expected an integer or a string of digits`);let n=BigInt(v);return n<-INT64||n>=INT64?fail(`Out of range for a 64-bit integer`,`too_big`):ok(n)}};case`real`:case`double precision`:return{json:{type:`number`},parse:v=>typeof v==`number`&&Number.isFinite(v)?ok(v):fail(`Expected a number`)};case`decimal`:case`numeric`:case`money`:return{json:{type:`string`,pattern:DECIMAL.source},parse:v=>typeof v==`number`&&Number.isFinite(v)?ok(String(v)):typeof v==`string`&&DECIMAL.test(v)?ok(v):fail(`Expected a decimal number or string`)};case`varchar`:case`character varying`:case`char`:case`character`:return Number.isFinite(size)?stringSpec({maxLength:size},v=>v.length>size?`Must be at most ${size} characters`:null):stringSpec();case`boolean`:return{json:{type:`boolean`},parse:v=>typeof v==`boolean`?ok(v):fail(`Expected a boolean`)};case`timestamp`:case`timestamptz`:return dateSpec(`date-time`);case`date`:return dateSpec(`date`);case`uuid`:return stringSpec({format:`uuid`},v=>UUID.test(v)?null:`Expected a UUID`);case`vector`:return arraySpec({json:{type:`number`},parse:v=>typeof v==`number`?ok(v):fail(`Expected a number`)},Number.isFinite(size)?size:void 0);case`json`:case`jsonb`:return anySpec();default:return stringSpec()}}function isSchemaLike(value){return typeof value==`object`&&!!value&&typeof value.safeParse==`function`&&typeof value.toJsonSchema==`function`}function withRule(spec,rule){if(!rule)return spec;if(isSchemaLike(rule))return{json:rule.toJsonSchema(),jsonFor:options=>rule.toJsonSchema(options),parse:v=>{let result=rule.safeParse(v);if(result.success)return ok(result.data);let first=result.issues[0];return fail(first?.message??`Invalid value`,`custom`)}};let pattern=rule.pattern===void 0?void 0:RegExp(`^(?:${rule.pattern})$`);return{json:{...spec.json,...rule},parse:v=>{let parsed=spec.parse(v);if(!parsed.ok)return parsed;let value=parsed.value;if(typeof value==`string`){if(rule.minLength!==void 0&&value.length<rule.minLength)return fail(`Must be at least ${rule.minLength} characters`,`too_small`);if(rule.maxLength!==void 0&&value.length>rule.maxLength)return fail(`Must be at most ${rule.maxLength} characters`,`too_big`);if(pattern&&!pattern.test(value))return fail(`Invalid format`,`invalid_string`);let formatProblem=checkFormat(rule.format,value);if(formatProblem)return fail(formatProblem,`invalid_string`)}if(typeof value==`number`){if(rule.minimum!==void 0&&value<rule.minimum)return fail(`Must be at least ${rule.minimum}`,`too_small`);if(rule.maximum!==void 0&&value>rule.maximum)return fail(`Must be at most ${rule.maximum}`,`too_big`)}return parsed}}}function checkFormat(format,value){switch(format){case`email`:return EMAIL.test(value)?null:`Expected an email address`;case`uuid`:return UUID.test(value)?null:`Expected a UUID`;case`uri`:case`url`:return URL.canParse(value)?null:`Expected a URL`;case`date-time`:return Number.isNaN(Date.parse(value))?`Expected a date-time string`:null;default:return null}}function optionalOnInsert(builder){let state=builder.__state();return state.nullable||state.default!==null||/^(small|big)?serial$/.test(state.type)}function buildSchema(table,mode,options={}){let omitted=new Set(options.omit??[]),columns=Object.entries(table.__columns).filter(([name])=>!omitted.has(name)).map(([name,builder])=>({name,nullable:builder.__state().nullable,required:mode===`select`||mode===`insert`&&!optionalOnInsert(builder),spec:withRule(specFor(builder),options.columns?.[name])})),safeParse=data=>{if(typeof data!=`object`||!data||Array.isArray(data))return{success:!1,issues:[{path:[],message:`Expected an object`,code:`invalid_type`}]};let input=data,out={},issues=[];for(let column of columns){let value=input[column.name];if(value===void 0){column.required&&issues.push({path:[column.name],message:`Required`,code:`invalid_type`});continue}if(value===null){column.nullable?out[column.name]=null:issues.push({path:[column.name],message:`Cannot be null`,code:`invalid_type`});continue}let parsed=column.spec.parse(value);parsed.ok?out[column.name]=parsed.value:issues.push({path:[column.name],message:parsed.message,code:parsed.code})}return issues.length>0?{success:!1,issues}:{success:!0,data:out}};return{safeParse,toJsonSchema:(jsonOptions={})=>{let openapi=jsonOptions.target===`openapi-3.0`,properties={};for(let column of columns){let json=column.spec.jsonFor?.(jsonOptions)??column.spec.json;properties[column.name]=column.nullable?openapi?{...json,nullable:!0}:{anyOf:[json,{type:`null`}]}:json}let required=columns.filter(c=>c.required).map(c=>c.name);return{type:`object`,properties,...required.length>0?{required}:{},additionalProperties:!1}},"~standard":{version:1,vendor:`kickjs-db`,validate:value=>{let result=safeParse(value);return result.success?{value:result.data}:{issues:result.issues}}}}}function selectSchema(table,options){return buildSchema(table,`select`,options)}function insertSchema(table,options){return buildSchema(table,`insert`,options)}function updateSchema(table,options){return buildSchema(table,`update`,options)}export{insertSchema,selectSchema,updateSchema};
|
|
12
|
+
//# sourceMappingURL=schema.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"schema.mjs","names":[],"sources":["../src/schema.ts"],"sourcesContent":["/**\n * Request validators and JSON Schema from a kick/db table.\n *\n * import { insertSchema, selectSchema, updateSchema } from '@forinda/kickjs-db/schema'\n *\n * export const createUser = insertSchema(users, {\n * columns: { email: { format: 'email' }, name: { minLength: 1 } },\n * omit: ['id'],\n * })\n *\n * @Post('/', { body: createUser }) // validated + typed ctx.body + OpenAPI\n *\n * The result is a `KickSchema` (`safeParse` + `toJsonSchema`), so request\n * validation, the Swagger spec, `kick typegen` and the typed client take it\n * the way they take a wrapped Zod schema — and a Standard Schema\n * (`~standard`), for libraries that accept those. No schema library needed.\n *\n * Each column's rule comes from its SQL type and nullability. A table can't\n * say a column holds an email or a minimum length, and `json` / custom\n * columns have no runtime shape — `columns` adds those: a rule object, or a\n * whole schema (e.g. `fromZod(...)`) for the column.\n *\n * - `selectSchema` — a row as read: every column present, nullable ones may be null.\n * - `insertSchema` — a row to insert: columns the database fills (serial, a\n * default, nullable) are optional.\n * - `updateSchema` — a patch: every column optional.\n *\n * Unknown keys are dropped from the parsed value, like a Zod object.\n */\nimport { CustomColumnBuilder } from './custom-type'\nimport type { ColumnBuilder, GeneratedBrand, NotNullBrand } from './dsl/columns/types'\nimport { PgEnumColumnBuilder } from './dsl/columns/pg'\nimport type { TableDecl } from './dsl/table'\n\n// ── Types ───────────────────────────────────────────────────────────────\n\ntype ColumnsOf<T> = T extends TableDecl<string, infer C, string | undefined> ? C : never\ntype ValueOf<C> = C extends ColumnBuilder<infer V> ? V : never\ntype IsNotNull<C> = C extends NotNullBrand ? true : false\n\n/** A row as read from the table. */\nexport type InferSelect<T extends TableDecl> = {\n [K in keyof ColumnsOf<T>]: IsNotNull<ColumnsOf<T>[K]> extends true\n ? ValueOf<ColumnsOf<T>[K]>\n : ValueOf<ColumnsOf<T>[K]> | null\n}\n\ntype OptionalOnInsert<T> = {\n [K in keyof ColumnsOf<T>]: ColumnsOf<T>[K] extends GeneratedBrand\n ? K\n : IsNotNull<ColumnsOf<T>[K]> extends true\n ? never\n : K\n}[keyof ColumnsOf<T>]\n\n/** A row to insert: generated, defaulted and nullable columns may be left out. */\nexport type InferInsert<T extends TableDecl> = Omit<InferSelect<T>, OptionalOnInsert<T>> &\n Partial<Pick<InferSelect<T>, OptionalOnInsert<T>>>\n\n/** Extra rules for one column — what a SQL type can't say. */\nexport interface ColumnRule {\n /** JSON Schema `format`; `email`, `uri`, `uuid` and `date-time` are also checked. */\n format?: string\n minLength?: number\n maxLength?: number\n /** Checked against the whole string. */\n pattern?: string\n minimum?: number\n maximum?: number\n}\n\n/** Anything with `safeParse` + `toJsonSchema` — a `KickSchema` (e.g. `fromZod(...)`). */\nexport interface SchemaLike {\n safeParse(data: unknown): { success: true; data: unknown } | { success: false; issues: unknown[] }\n toJsonSchema(options?: JsonSchemaOptions): Record<string, unknown>\n}\n\nexport interface TableSchemaOptions<T extends TableDecl> {\n columns?: { [K in keyof ColumnsOf<T>]?: ColumnRule | SchemaLike }\n /** Columns left out of the schema entirely (e.g. `password` on a read). */\n omit?: readonly (keyof ColumnsOf<T>)[]\n}\n\nexport interface JsonSchemaOptions {\n readonly target?: 'draft-2020-12' | 'draft-07' | 'openapi-3.0'\n}\n\nexport interface SchemaIssue {\n path: string[]\n message: string\n code: string\n}\n\n/** The schema these functions return — structurally a `KickSchema<TOutput>` and a Standard Schema. */\nexport interface TableSchema<TOutput> {\n safeParse(\n data: unknown,\n ): { success: true; data: TOutput } | { success: false; issues: SchemaIssue[] }\n toJsonSchema(options?: JsonSchemaOptions): Record<string, unknown>\n readonly '~standard': {\n readonly version: 1\n readonly vendor: 'kickjs-db'\n readonly validate: (\n value: unknown,\n ) =>\n | { value: TOutput; issues?: undefined }\n | { issues: ReadonlyArray<{ message: string; path: readonly string[] }> }\n readonly types?: { readonly input: unknown; readonly output: TOutput }\n }\n}\n\n// ── Column rules ────────────────────────────────────────────────────────\n\ntype Parsed = { ok: true; value: unknown } | { ok: false; message: string; code: string }\n\ninterface ColumnSpec {\n json: Record<string, unknown>\n /** For a whole-schema override: its JSON Schema in the caller's target. */\n jsonFor?: (options: JsonSchemaOptions) => Record<string, unknown>\n parse(value: unknown): Parsed\n}\n\nconst ok = (value: unknown): Parsed => ({ ok: true, value })\nconst fail = (message: string, code = 'invalid_type'): Parsed => ({ ok: false, message, code })\n\nconst INTEGER = /^-?\\d+$/\nconst DECIMAL = /^-?\\d+(\\.\\d+)?$/\nconst UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i\nconst EMAIL = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/\n\n/**\n * An integer the column can store. Out of range, the database would reject\n * the insert with a server error; here it is a validation issue instead.\n */\nfunction integerSpec(minimum: number, maximum: number): ColumnSpec {\n return {\n json: { type: 'integer', minimum, maximum },\n parse: (v) =>\n typeof v !== 'number' || !Number.isInteger(v)\n ? fail('Expected an integer')\n : v < minimum || v > maximum\n ? fail(`Must be between ${minimum} and ${maximum}`, v < minimum ? 'too_small' : 'too_big')\n : ok(v),\n }\n}\n\nconst INT16 = 32_767\nconst INT32 = 2_147_483_647\nconst INT64 = 2n ** 63n\n\nfunction stringSpec(json: Record<string, unknown> = {}, check?: (v: string) => string | null) {\n return {\n json: { type: 'string', ...json },\n parse: (v: unknown): Parsed => {\n if (typeof v !== 'string') return fail('Expected a string')\n const problem = check?.(v)\n return problem ? fail(problem, 'invalid_string') : ok(v)\n },\n }\n}\n\nfunction dateSpec(format: 'date' | 'date-time'): ColumnSpec {\n return {\n json: { type: 'string', format },\n parse: (v) => {\n const date = v instanceof Date ? v : typeof v === 'string' ? new Date(v) : undefined\n return date && !Number.isNaN(date.getTime())\n ? ok(date)\n : fail(`Expected a ${format === 'date' ? 'date' : 'date-time'} string`)\n },\n }\n}\n\n/** The rule for one column, from its SQL type. */\nfunction specFor(builder: ColumnBuilder): ColumnSpec {\n if (builder instanceof PgEnumColumnBuilder) {\n const values = builder.values as readonly string[]\n return {\n json: { type: 'string', enum: [...values] },\n parse: (v) =>\n typeof v === 'string' && values.includes(v)\n ? ok(v)\n : fail(`Expected one of ${values.join(', ')}`, 'invalid_enum_value'),\n }\n }\n if (builder instanceof CustomColumnBuilder) return anySpec()\n\n const type = builder.__state().type.toLowerCase()\n if (type.endsWith('[]')) return arraySpec(specForType(type.slice(0, -2)))\n return specForType(type)\n}\n\nfunction anySpec(): ColumnSpec {\n return { json: {}, parse: ok }\n}\n\nfunction arraySpec(item: ColumnSpec, length?: number): ColumnSpec {\n return {\n json: {\n type: 'array',\n items: item.json,\n ...(length === undefined ? {} : { minItems: length, maxItems: length }),\n },\n parse: (v) => {\n if (!Array.isArray(v)) return fail('Expected an array')\n if (length !== undefined && v.length !== length) {\n return fail(`Expected ${length} items`, 'invalid_length')\n }\n const out: unknown[] = []\n for (const [i, element] of v.entries()) {\n const parsed = item.parse(element)\n if (!parsed.ok) return fail(`[${i}]: ${parsed.message}`, parsed.code)\n out.push(parsed.value)\n }\n return ok(out)\n },\n }\n}\n\nfunction specForType(type: string): ColumnSpec {\n const base = type.replace(/\\(.*$/, '').trim()\n const size = Number(/\\((\\d+)/.exec(type)?.[1])\n switch (base) {\n // serial values start at 1.\n case 'smallserial':\n return integerSpec(1, INT16)\n case 'serial':\n return integerSpec(1, INT32)\n case 'smallint':\n return integerSpec(-INT16 - 1, INT16)\n case 'integer':\n case 'int':\n return integerSpec(-INT32 - 1, INT32)\n case 'bigserial':\n case 'bigint':\n // JSON has no 64-bit integer: accept a number or a string of digits,\n // parse to the column's TS type, bigint.\n return {\n json: { type: 'string', pattern: INTEGER.source },\n parse: (v) => {\n if (\n !(typeof v === 'number' && Number.isInteger(v)) &&\n !(typeof v === 'string' && INTEGER.test(v))\n ) {\n return fail('Expected an integer or a string of digits')\n }\n const n = BigInt(v)\n return n < -INT64 || n >= INT64\n ? fail('Out of range for a 64-bit integer', 'too_big')\n : ok(n)\n },\n }\n case 'real':\n case 'double precision':\n return {\n json: { type: 'number' },\n parse: (v) =>\n typeof v === 'number' && Number.isFinite(v) ? ok(v) : fail('Expected a number'),\n }\n case 'decimal':\n case 'numeric':\n case 'money':\n // The column's TS type is string — exact decimals don't survive a float.\n return {\n json: { type: 'string', pattern: DECIMAL.source },\n parse: (v) =>\n typeof v === 'number' && Number.isFinite(v)\n ? ok(String(v))\n : typeof v === 'string' && DECIMAL.test(v)\n ? ok(v)\n : fail('Expected a decimal number or string'),\n }\n case 'varchar':\n case 'character varying':\n case 'char':\n case 'character':\n return Number.isFinite(size)\n ? stringSpec({ maxLength: size }, (v) =>\n v.length > size ? `Must be at most ${size} characters` : null,\n )\n : stringSpec()\n case 'boolean':\n return {\n json: { type: 'boolean' },\n parse: (v) => (typeof v === 'boolean' ? ok(v) : fail('Expected a boolean')),\n }\n case 'timestamp':\n case 'timestamptz':\n return dateSpec('date-time')\n case 'date':\n return dateSpec('date')\n case 'uuid':\n return stringSpec({ format: 'uuid' }, (v) => (UUID.test(v) ? null : 'Expected a UUID'))\n case 'vector':\n return arraySpec(\n {\n json: { type: 'number' },\n parse: (v) => (typeof v === 'number' ? ok(v) : fail('Expected a number')),\n },\n Number.isFinite(size) ? size : undefined,\n )\n case 'json':\n case 'jsonb':\n return anySpec()\n default:\n // text, citext, time, interval, inet, cidr, xml, tsvector, bytea (base64)\n return stringSpec()\n }\n}\n\nfunction isSchemaLike(value: unknown): value is SchemaLike {\n return (\n typeof value === 'object' &&\n value !== null &&\n typeof (value as SchemaLike).safeParse === 'function' &&\n typeof (value as SchemaLike).toJsonSchema === 'function'\n )\n}\n\n/** Layer a column's extra rules over its type rule. */\nfunction withRule(spec: ColumnSpec, rule: ColumnRule | SchemaLike | undefined): ColumnSpec {\n if (!rule) return spec\n if (isSchemaLike(rule)) {\n return {\n json: rule.toJsonSchema(),\n jsonFor: (options) => rule.toJsonSchema(options),\n parse: (v) => {\n const result = rule.safeParse(v)\n if (result.success) return ok(result.data)\n const first = result.issues[0] as { message?: string } | undefined\n return fail(first?.message ?? 'Invalid value', 'custom')\n },\n }\n }\n const pattern = rule.pattern === undefined ? undefined : new RegExp(`^(?:${rule.pattern})$`)\n return {\n json: { ...spec.json, ...rule },\n parse: (v) => {\n const parsed = spec.parse(v)\n if (!parsed.ok) return parsed\n const value = parsed.value\n if (typeof value === 'string') {\n if (rule.minLength !== undefined && value.length < rule.minLength) {\n return fail(`Must be at least ${rule.minLength} characters`, 'too_small')\n }\n if (rule.maxLength !== undefined && value.length > rule.maxLength) {\n return fail(`Must be at most ${rule.maxLength} characters`, 'too_big')\n }\n if (pattern && !pattern.test(value)) return fail('Invalid format', 'invalid_string')\n const formatProblem = checkFormat(rule.format, value)\n if (formatProblem) return fail(formatProblem, 'invalid_string')\n }\n if (typeof value === 'number') {\n if (rule.minimum !== undefined && value < rule.minimum) {\n return fail(`Must be at least ${rule.minimum}`, 'too_small')\n }\n if (rule.maximum !== undefined && value > rule.maximum) {\n return fail(`Must be at most ${rule.maximum}`, 'too_big')\n }\n }\n return parsed\n },\n }\n}\n\nfunction checkFormat(format: string | undefined, value: string): string | null {\n switch (format) {\n case 'email':\n return EMAIL.test(value) ? null : 'Expected an email address'\n case 'uuid':\n return UUID.test(value) ? null : 'Expected a UUID'\n case 'uri':\n case 'url':\n return URL.canParse(value) ? null : 'Expected a URL'\n case 'date-time':\n return Number.isNaN(Date.parse(value)) ? 'Expected a date-time string' : null\n default:\n return null\n }\n}\n\n// ── Schemas ─────────────────────────────────────────────────────────────\n\ntype Mode = 'select' | 'insert' | 'update'\n\n/** Whether a column may be left out of an insert: the database fills it. */\nfunction optionalOnInsert(builder: ColumnBuilder): boolean {\n const state = builder.__state()\n return state.nullable || state.default !== null || /^(small|big)?serial$/.test(state.type)\n}\n\nfunction buildSchema<TOutput>(\n table: TableDecl,\n mode: Mode,\n options: TableSchemaOptions<TableDecl> = {},\n): TableSchema<TOutput> {\n const omitted = new Set<string>((options.omit ?? []) as string[])\n const columns = Object.entries(table.__columns)\n .filter(([name]) => !omitted.has(name))\n .map(([name, builder]) => ({\n name,\n nullable: builder.__state().nullable,\n required: mode === 'select' || (mode === 'insert' && !optionalOnInsert(builder)),\n spec: withRule(\n specFor(builder),\n (options.columns as Record<string, ColumnRule | SchemaLike> | undefined)?.[name],\n ),\n }))\n\n const safeParse = (data: unknown) => {\n if (typeof data !== 'object' || data === null || Array.isArray(data)) {\n return {\n success: false as const,\n issues: [{ path: [], message: 'Expected an object', code: 'invalid_type' }],\n }\n }\n const input = data as Record<string, unknown>\n const out: Record<string, unknown> = {}\n const issues: SchemaIssue[] = []\n for (const column of columns) {\n const value = input[column.name]\n if (value === undefined) {\n if (column.required) {\n issues.push({ path: [column.name], message: 'Required', code: 'invalid_type' })\n }\n continue\n }\n if (value === null) {\n if (column.nullable) out[column.name] = null\n else issues.push({ path: [column.name], message: 'Cannot be null', code: 'invalid_type' })\n continue\n }\n const parsed = column.spec.parse(value)\n if (parsed.ok) out[column.name] = parsed.value\n else issues.push({ path: [column.name], message: parsed.message, code: parsed.code })\n }\n return issues.length > 0\n ? { success: false as const, issues }\n : { success: true as const, data: out as TOutput }\n }\n\n const toJsonSchema = (jsonOptions: JsonSchemaOptions = {}) => {\n const openapi = jsonOptions.target === 'openapi-3.0'\n const properties: Record<string, unknown> = {}\n for (const column of columns) {\n const json = column.spec.jsonFor?.(jsonOptions) ?? column.spec.json\n properties[column.name] = !column.nullable\n ? json\n : openapi\n ? { ...json, nullable: true }\n : { anyOf: [json, { type: 'null' }] }\n }\n const required = columns.filter((c) => c.required).map((c) => c.name)\n return {\n type: 'object',\n properties,\n ...(required.length > 0 ? { required } : {}),\n additionalProperties: false,\n }\n }\n\n return {\n safeParse,\n toJsonSchema,\n '~standard': {\n version: 1,\n vendor: 'kickjs-db',\n validate: (value: unknown) => {\n const result = safeParse(value)\n return result.success ? { value: result.data } : { issues: result.issues }\n },\n },\n }\n}\n\n/** A row as read: every column present, nullable ones may be `null`. */\nexport function selectSchema<T extends TableDecl, const O extends keyof ColumnsOf<T> = never>(\n table: T,\n options?: TableSchemaOptions<T> & { omit?: readonly O[] },\n): TableSchema<Omit<InferSelect<T>, O>> {\n return buildSchema(table, 'select', options as TableSchemaOptions<TableDecl>)\n}\n\n/** A row to insert: serial, defaulted and nullable columns are optional. */\nexport function insertSchema<T extends TableDecl, const O extends keyof ColumnsOf<T> = never>(\n table: T,\n options?: TableSchemaOptions<T> & { omit?: readonly O[] },\n): TableSchema<Omit<InferInsert<T>, O>> {\n return buildSchema(table, 'insert', options as TableSchemaOptions<TableDecl>)\n}\n\n/** A patch: every column optional. */\nexport function updateSchema<T extends TableDecl, const O extends keyof ColumnsOf<T> = never>(\n table: T,\n options?: TableSchemaOptions<T> & { omit?: readonly O[] },\n): TableSchema<Partial<Omit<InferInsert<T>, O>>> {\n return buildSchema(table, 'update', options as TableSchemaOptions<TableDecl>)\n}\n"],"mappings":"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"}
|