@forinda/kickjs-db 8.7.0 → 8.8.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.
Files changed (49) hide show
  1. package/bin/kickjs-db.mjs +4 -1
  2. package/dist/cli.d.mts +2 -2
  3. package/dist/cli.d.mts.map +1 -1
  4. package/dist/cli.mjs +3 -3
  5. package/dist/cli.mjs.map +1 -1
  6. package/dist/create-K_h9SGPl.mjs +29 -0
  7. package/dist/create-K_h9SGPl.mjs.map +1 -0
  8. package/dist/{custom-type-CqYKyYJW.mjs → custom-type-BPJpUuWz.mjs} +2 -2
  9. package/dist/{custom-type-CqYKyYJW.mjs.map → custom-type-BPJpUuWz.mjs.map} +1 -1
  10. package/dist/devtools-events.d.mts +1 -1
  11. package/dist/devtools-events.mjs +1 -1
  12. package/dist/{index-DH4qiCqU.d.mts → index-sRSu3kiL.d.mts} +53 -9
  13. package/dist/{index-DH4qiCqU.d.mts.map → index-sRSu3kiL.d.mts.map} +1 -1
  14. package/dist/index.d.mts +6 -6
  15. package/dist/index.mjs +2 -2
  16. package/dist/mysql.d.mts +2 -2
  17. package/dist/mysql.mjs +2 -2
  18. package/dist/{pg-DGxRYyFW.mjs → pg-CJr6OX2u.mjs} +3 -3
  19. package/dist/{pg-DGxRYyFW.mjs.map → pg-CJr6OX2u.mjs.map} +1 -1
  20. package/dist/pg.d.mts +3 -3
  21. package/dist/pg.mjs +2 -2
  22. package/dist/{schema-BIPOM1xj.d.mts → schema-BP_TZ1Sv.d.mts} +3 -3
  23. package/dist/{schema-BIPOM1xj.d.mts.map → schema-BP_TZ1Sv.d.mts.map} +1 -1
  24. package/dist/{schema-types-DIccweFR.d.mts → schema-types-DqdkKV19.d.mts} +3 -3
  25. package/dist/{schema-types-DIccweFR.d.mts.map → schema-types-DqdkKV19.d.mts.map} +1 -1
  26. package/dist/schema.d.mts +1 -1
  27. package/dist/schema.mjs +2 -2
  28. package/dist/{split-statements-BTlvQSAj.mjs → split-statements-E5gaoZIS.mjs} +2 -2
  29. package/dist/{split-statements-BTlvQSAj.mjs.map → split-statements-E5gaoZIS.mjs.map} +1 -1
  30. package/dist/sqlite.d.mts +1 -1
  31. package/dist/sqlite.d.mts.map +1 -1
  32. package/dist/sqlite.mjs +5 -5
  33. package/dist/sqlite.mjs.map +1 -1
  34. package/dist/{src-CcX7Jjfq.mjs → src-TXge_81j.mjs} +5 -5
  35. package/dist/src-TXge_81j.mjs.map +1 -0
  36. package/dist/{table-B_TVt7EC.d.mts → table-xq-X29gB.d.mts} +2 -2
  37. package/dist/{table-B_TVt7EC.d.mts.map → table-xq-X29gB.d.mts.map} +1 -1
  38. package/dist/testing.d.mts +2 -2
  39. package/dist/testing.mjs +2 -2
  40. package/dist/{types-DtX5fIbn.d.mts → types-LCdRbLC1.d.mts} +22 -1
  41. package/dist/types-LCdRbLC1.d.mts.map +1 -0
  42. package/dist/{types-p2E6CrKO.d.mts → types-ydAqBLR1.d.mts} +43 -6
  43. package/dist/types-ydAqBLR1.d.mts.map +1 -0
  44. package/package.json +4 -4
  45. package/dist/create-BS-WBMOA.mjs +0 -29
  46. package/dist/create-BS-WBMOA.mjs.map +0 -1
  47. package/dist/src-CcX7Jjfq.mjs.map +0 -1
  48. package/dist/types-DtX5fIbn.d.mts.map +0 -1
  49. package/dist/types-p2E6CrKO.d.mts.map +0 -1
@@ -1,5 +1,5 @@
1
1
 
2
- import { d as TypedColumnRefs, t as ColumnBuilder, v as IndexSnapshot, x as RoleSnapshot, y as PolicySnapshot } from "./types-DtX5fIbn.mjs";
2
+ import { d as TypedColumnRefs, t as ColumnBuilder, v as IndexSnapshot, x as RoleSnapshot, y as PolicySnapshot } from "./types-LCdRbLC1.mjs";
3
3
  //#region src/dsl/rls.d.ts
4
4
  /** A database role, for `policy().to(...)` — created by migrations unless `.existing()`. */
5
5
  declare class RoleDecl {
@@ -218,4 +218,4 @@ declare function buildTable<TName extends string, C extends Record<string, Colum
218
218
  declare function unwrapTable(value: unknown): TableDecl | undefined;
219
219
  //#endregion
220
220
  export { PolicyDecl as _, qualifiedTableName as a, pgRole as b, CheckDecl as c, PrimaryKeyDecl as d, TableConstraint as f, unique as g, primaryKey as h, buildTable as i, IndexDecl as l, index as m, TableDecl as n, table as o, check as p, TableOptions as r, unwrapTable as s, QualifiedName as t, IndexKey as u, RoleDecl as v, policy as x, isRole as y };
221
- //# sourceMappingURL=table-B_TVt7EC.d.mts.map
221
+ //# sourceMappingURL=table-xq-X29gB.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"table-B_TVt7EC.d.mts","names":[],"sources":["../src/dsl/rls.ts","../src/dsl/constraints.ts","../src/dsl/table.ts"],"mappings":";;;;cAGa;WACF;WACA,QAAQ;;EAEjB;EAEA,YAAY,cAAc,UAAS,KAAK;;EAKxC;;;;;;;;;;;iBAec,OAAO,cAAc,UAAS,KAAK,wBAA6B;iBAIhE,OAAO,iBAAiB,SAAS;KAI5C,UAAU;;cAGF;WACF;WACA,UAAU;EAEnB,YAAY;;EAKZ,IAAI,SAAS;;EAMb,MAAM,OAAO,eAAe;;;;;EAS5B,GAAG;;EAMH,MAAM;;EAMN,UAAU;;;;;;;;;;;;;;;;;iBAqBI,OAAO,eAAe;;;UC9F5B;EACR;;;KAIU,WAAW;;;;;;;;;;cAeV;;WAEF,SAAS;EAElB,YAAY,cAAc,MAAM,YAAY;;EAK5C,MAAM;;EAMN,MAAM;;EAMN,WAAW,MAAM;;EAMjB,GAAG,KAAK,UAAU;;;;;;EAclB;;iBAMc,MAAM;EAElB,MAAE,MAAU,aAAa;;iBAMb,OAAO;EAEnB,MAAE,MAAU,aAAa;;;UAOZ;EACf;;EAEA;EACA;;;UAIe;EACf;EACA;;EAEA;;;KAIU,kBAAkB,YAAY,iBAAiB,YAAY;;;;;;;;;;iBAWvD,WAAW;EAEvB,MAAE,MAAU,WAAW;;;;;;iBAYX,MAAM,cAAc,qBAAqB;;;UCxHxC,UACf,+BACA,UAAU,eAAe,iBAAiB,eAAe,gBACzD;EAEA;EACA,QAAQ;EACR,WAAW;EACX,WAAW;;EAEX,eAAe;EACf,WAAW;;EAEX;;EAEA;IAAU;;EACV,aAAa;;;;;;;;;EASb,WAAW;;;;;WAKF,UAAU,SAAS;;;;;;;;;;KAWlB,cACV,sBACA,sCACE,4BAA4B,WAAW,UAAU;;iBAGrC,mBAAmB;EACjC;EACA;;KAKG,UACH,sBACA,UAAU,eAAe,gBACzB,kDACE,UAAU,OAAO,GAAG,WAAW,gBAAgB;KAE9C,kBAAkB,UAAU,eAAe,mBAC9C,MAAM,gBAAgB,OACnB,eAAe;;;;;KAMR,aAAa,UAAU,eAAe,kBAC9C,kBAAkB;EAEhB,cAAc,kBAAkB;EAChC;;;;;;;EAOA;IAAkB;;;;;;;;;iBASR,MAAM,sBAAsB,UAAU,eAAe,gBACnE,MAAM,OACN,SAAS,GACT,UAAU,aAAa,KACtB,UAAU,OAAO;;;;;iBAQJ,WACd,sBACA,UAAU,eAAe,gBACzB,oCAEA,MAAM,OACN,UAAU,GACV,SAAS,aAAa,gBACtB,QAAQ,UACP,UAAU,OAAO,GAAG;;;;;;;iBA6EP,YAAY,iBAAiB"}
1
+ {"version":3,"file":"table-xq-X29gB.d.mts","names":[],"sources":["../src/dsl/rls.ts","../src/dsl/constraints.ts","../src/dsl/table.ts"],"mappings":";;;;cAGa;WACF;WACA,QAAQ;;EAEjB;EAEA,YAAY,cAAc,UAAS,KAAK;;EAKxC;;;;;;;;;;;iBAec,OAAO,cAAc,UAAS,KAAK,wBAA6B;iBAIhE,OAAO,iBAAiB,SAAS;KAI5C,UAAU;;cAGF;WACF;WACA,UAAU;EAEnB,YAAY;;EAKZ,IAAI,SAAS;;EAMb,MAAM,OAAO,eAAe;;;;;EAS5B,GAAG;;EAMH,MAAM;;EAMN,UAAU;;;;;;;;;;;;;;;;;iBAqBI,OAAO,eAAe;;;UC9F5B;EACR;;;KAIU,WAAW;;;;;;;;;;cAeV;;WAEF,SAAS;EAElB,YAAY,cAAc,MAAM,YAAY;;EAK5C,MAAM;;EAMN,MAAM;;EAMN,WAAW,MAAM;;EAMjB,GAAG,KAAK,UAAU;;;;;;EAclB;;iBAMc,MAAM;EAElB,MAAE,MAAU,aAAa;;iBAMb,OAAO;EAEnB,MAAE,MAAU,aAAa;;;UAOZ;EACf;;EAEA;EACA;;;UAIe;EACf;EACA;;EAEA;;;KAIU,kBAAkB,YAAY,iBAAiB,YAAY;;;;;;;;;;iBAWvD,WAAW;EAEvB,MAAE,MAAU,WAAW;;;;;;iBAYX,MAAM,cAAc,qBAAqB;;;UCxHxC,UACf,+BACA,UAAU,eAAe,iBAAiB,eAAe,gBACzD;EAEA;EACA,QAAQ;EACR,WAAW;EACX,WAAW;;EAEX,eAAe;EACf,WAAW;;EAEX;;EAEA;IAAU;;EACV,aAAa;;;;;;;;;EASb,WAAW;;;;;WAKF,UAAU,SAAS;;;;;;;;;;KAWlB,cACV,sBACA,sCACE,4BAA4B,WAAW,UAAU;;iBAGrC,mBAAmB;EACjC;EACA;;KAKG,UACH,sBACA,UAAU,eAAe,gBACzB,kDACE,UAAU,OAAO,GAAG,WAAW,gBAAgB;KAE9C,kBAAkB,UAAU,eAAe,mBAC9C,MAAM,gBAAgB,OACnB,eAAe;;;;;KAMR,aAAa,UAAU,eAAe,kBAC9C,kBAAkB;EAEhB,cAAc,kBAAkB;EAChC;;;;;;;EAOA;IAAkB;;;;;;;;;iBASR,MAAM,sBAAsB,UAAU,eAAe,gBACnE,MAAM,OACN,SAAS,GACT,UAAU,aAAa,KACtB,UAAU,OAAO;;;;;iBAQJ,WACd,sBACA,UAAU,eAAe,gBACzB,oCAEA,MAAM,OACN,UAAU,GACV,SAAS,aAAa,gBACtB,QAAQ,UACP,UAAU,OAAO,GAAG;;;;;;;iBA6EP,YAAY,iBAAiB"}
@@ -1,6 +1,6 @@
1
1
 
2
- import { o as QueryEvent, r as KickDbClient } from "./types-p2E6CrKO.mjs";
3
- import { t as SchemaToTypes } from "./schema-types-DIccweFR.mjs";
2
+ import { o as QueryEvent, r as KickDbClient } from "./types-ydAqBLR1.mjs";
3
+ import { t as SchemaToTypes } from "./schema-types-DqdkKV19.mjs";
4
4
  //#region src/testing.d.ts
5
5
  export interface TestDbOptions<S> {
6
6
  schema: S;
package/dist/testing.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-db v8.7.0
2
+ * @forinda/kickjs-db v8.8.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,6 +8,6 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import{D as emitPg,I as EVENTS_ENABLED,K as diff,Y as extractSnapshot,d as migrateLatest,t as createDbClient,y as emitSqlite}from"./create-BS-WBMOA.mjs";import{randomBytes}from"node:crypto";async function createTestDb(opts){let{default:Database}=await import(`better-sqlite3`),{sqliteAdapter,sqliteDialect}=await import(`./sqlite.mjs`),database=new Database(`:memory:`);if(database.pragma(`foreign_keys = ON`),opts.migrationsDir)await migrateLatest({adapter:sqliteAdapter({database}),migrationsDir:opts.migrationsDir,requireReviewed:!1,driftCheck:`ignore`});else{let empty={version:1,dialect:`sqlite`,tables:{}},target=extractSnapshot(opts.schema,`sqlite`,{casing:opts.casing});database.exec(emitSqlite(diff(empty,target),{from:empty,to:target}))}return createDbClient({schema:opts.schema,dialect:sqliteDialect({database}),casing:opts.casing,events:!0})}async function createPgTestDb(opts){let{default:pg}=await import(`pg`),{pgAdapter,pgDialect}=await import(`./pg.mjs`),name=`kick_test_${randomBytes(6).toString(`hex`)}`,admin=new pg.Client({connectionString:opts.connectionString});await admin.connect();try{await admin.query(`CREATE DATABASE "${name}"`)}finally{await admin.end()}let url=new URL(opts.connectionString);url.pathname=`/${name}`;let connectionString=url.toString(),pool=new pg.Pool({connectionString});pool.on(`error`,()=>{}),pool.on(`connect`,client=>client.on(`error`,()=>{})),opts.migrationsDir?await migrateLatest({adapter:pgAdapter({pool}),migrationsDir:opts.migrationsDir,requireReviewed:!1,driftCheck:`ignore`}):await pool.query(emitPg(diff({version:1,dialect:`postgres`,tables:{}},extractSnapshot(opts.schema,`postgres`,{casing:opts.casing}))));let db=createDbClient({schema:opts.schema,dialect:pgDialect({pool}),casing:opts.casing,events:!0});return{db,connectionString,async drop(){await db.destroy();let admin=new pg.Client({connectionString:opts.connectionString});await admin.connect();try{await admin.query(`DROP DATABASE IF EXISTS "${name}" WITH (FORCE)`)}finally{await admin.end()}}}}const ROLLBACK=Symbol(`kickjs-db rolled back`);async function rolledBack(db,fn){let result;return await db.transaction(async()=>{throw result=await fn(),ROLLBACK}).catch(err=>{if(err!==ROLLBACK)throw err}),result}async function captureQueries(db,fn){if(db[EVENTS_ENABLED]===!1)throw Error("captureQueries: this client was created without events, so no query is reported and every count would be 0. Create it with `events: true`.");let queries=[],listener=event=>void queries.push(event);db.on(`query`,listener);try{return{result:await fn(),queries}}finally{db.off(`query`,listener)}}async function expectQueries(db,count,fn){let{result,queries}=await captureQueries(db,fn);if(queries.length!==count){let list=queries.map((q,i)=>` ${i+1}. ${q.sql}`).join(`
11
+ import{D as emitPg,I as EVENTS_ENABLED,K as diff,Y as extractSnapshot,d as migrateLatest,t as createDbClient,y as emitSqlite}from"./create-K_h9SGPl.mjs";import{randomBytes}from"node:crypto";async function createTestDb(opts){let{default:Database}=await import(`better-sqlite3`),{sqliteAdapter,sqliteDialect}=await import(`./sqlite.mjs`),database=new Database(`:memory:`);if(database.pragma(`foreign_keys = ON`),opts.migrationsDir)await migrateLatest({adapter:sqliteAdapter({database}),migrationsDir:opts.migrationsDir,requireReviewed:!1,driftCheck:`ignore`});else{let empty={version:1,dialect:`sqlite`,tables:{}},target=extractSnapshot(opts.schema,`sqlite`,{casing:opts.casing});database.exec(emitSqlite(diff(empty,target),{from:empty,to:target}))}return createDbClient({schema:opts.schema,dialect:sqliteDialect({database}),casing:opts.casing,events:!0})}async function createPgTestDb(opts){let{default:pg}=await import(`pg`),{pgAdapter,pgDialect}=await import(`./pg.mjs`),name=`kick_test_${randomBytes(6).toString(`hex`)}`,admin=new pg.Client({connectionString:opts.connectionString});await admin.connect();try{await admin.query(`CREATE DATABASE "${name}"`)}finally{await admin.end()}let url=new URL(opts.connectionString);url.pathname=`/${name}`;let connectionString=url.toString(),pool=new pg.Pool({connectionString});pool.on(`error`,()=>{}),pool.on(`connect`,client=>client.on(`error`,()=>{})),opts.migrationsDir?await migrateLatest({adapter:pgAdapter({pool}),migrationsDir:opts.migrationsDir,requireReviewed:!1,driftCheck:`ignore`}):await pool.query(emitPg(diff({version:1,dialect:`postgres`,tables:{}},extractSnapshot(opts.schema,`postgres`,{casing:opts.casing}))));let db=createDbClient({schema:opts.schema,dialect:pgDialect({pool}),casing:opts.casing,events:!0});return{db,connectionString,async drop(){await db.destroy();let admin=new pg.Client({connectionString:opts.connectionString});await admin.connect();try{await admin.query(`DROP DATABASE IF EXISTS "${name}" WITH (FORCE)`)}finally{await admin.end()}}}}const ROLLBACK=Symbol(`kickjs-db rolled back`);async function rolledBack(db,fn){let result;return await db.transaction(async()=>{throw result=await fn(),ROLLBACK}).catch(err=>{if(err!==ROLLBACK)throw err}),result}async function captureQueries(db,fn){if(db[EVENTS_ENABLED]===!1)throw Error("captureQueries: this client was created without events, so no query is reported and every count would be 0. Create it with `events: true`.");let queries=[],listener=event=>void queries.push(event);db.on(`query`,listener);try{return{result:await fn(),queries}}finally{db.off(`query`,listener)}}async function expectQueries(db,count,fn){let{result,queries}=await captureQueries(db,fn);if(queries.length!==count){let list=queries.map((q,i)=>` ${i+1}. ${q.sql}`).join(`
12
12
  `);throw Error(`Expected ${count} quer${count===1?`y`:`ies`}, ran ${queries.length}:\n${list||` (none)`}`)}return result}export{captureQueries,createPgTestDb,createTestDb,expectQueries,rolledBack};
13
13
  //# sourceMappingURL=testing.mjs.map
@@ -131,6 +131,27 @@ interface RelationSnapshot {
131
131
  sourceColumns: readonly string[];
132
132
  targetColumns: readonly string[];
133
133
  };
134
+ /**
135
+ * For a `morphMany` / `morphOne`: the target's type column and the value it must hold
136
+ * (bound as a parameter). There's no foreign key behind the join.
137
+ */
138
+ morph?: {
139
+ column: string;
140
+ value: string;
141
+ };
142
+ /**
143
+ * For a `morphTo`: the source's type column, and per type value the table
144
+ * and key column the source's id column (`sourceColumns[0]`) points at.
145
+ * `target` holds the first of those tables.
146
+ */
147
+ morphTo?: {
148
+ column: string;
149
+ targets: ReadonlyArray<{
150
+ value: string;
151
+ table: string;
152
+ key: string;
153
+ }>;
154
+ };
134
155
  }
135
156
  /** A row-level security policy (Postgres). */
136
157
  interface PolicySnapshot {
@@ -441,4 +462,4 @@ declare class ColumnBuilder<T = unknown> {
441
462
  }
442
463
  //#endregion
443
464
  export { TableSnapshot as C, SchemaSnapshot as S, ForeignKeySnapshot as _, GeneratedAlwaysBrand as a, RelationSnapshot as b, KICK_NOT_NULL as c, TypedColumnRefs as d, CheckSnapshot as f, FkAction as g, EnumSnapshot as h, FkSpec as i, NotNullBrand as l, Dialect as m, ColumnRef as n, GeneratedBrand as o, ColumnSnapshot as p, ColumnState as r, KICK_GENERATED as s, ColumnBuilder as t, TypedColumnRef as u, IndexSnapshot as v, ViewSnapshot as w, RoleSnapshot as x, PolicySnapshot as y };
444
- //# sourceMappingURL=types-DtX5fIbn.d.mts.map
465
+ //# sourceMappingURL=types-LCdRbLC1.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types-LCdRbLC1.d.mts","names":[],"sources":["../src/snapshot/types.ts","../src/dsl/columns/types.ts"],"mappings":";;KAAY;KAEA;UAEK;EACf;EACA;EACA;EACA;EACA;;EAEA;IAAc;IAAoB;;;EAElC;;EAEA;;;;;EAKA;;UAGe;EACf;;EAEA;EACA;;EAEA;;EAEA;;EAEA;;EAEA,YAAY;;EAEZ;;UAGe;EACf;EACA;EACA;EACA;EACA,UAAU;EACV,UAAU;;UAGK;EACf;EACA;;UAGe;;;;;;EAMf;;;;;;EAMA;EACA,SAAS,eAAe;EACxB,SAAS;EACT,aAAa;EACb,QAAQ;;;;;;;EAOR;IAAe;IAAe;;;EAE9B;;EAEA;IAAQ;;;EAER,WAAW;;;;;;;UAQI;EACf;;EAEA;;;;;;;;;;;;;;UAee;EACf;;EAEA;;EAEA;;EAEA;;;;;EAKA;;;;;EAKA;IAAY;IAAe;IAAkC;;;;;;EAK7D;IAAU;IAAgB;;;;;;;EAM1B;IACE;IACA,SAAS;MAAgB;MAAe;MAAe;;;;;UAK1C;EACf;EACA;EACA;;EAEA;EACA;EACA;;;UAIe;EACf;EACA;EACA;EACA;;EAEA;EACA;;UAGe;EACf;;EAEA;;EAEA;;EAEA,UAAU;;;;;EAKV,UAAU,eAAe;;UAGV;EACf;EACA,SAAS;;;;;;;;EAQT,QAAQ,eAAe;;;;;;EAMvB;;EAEA,QAAQ,eAAe;;;;;EAKvB,QAAQ,eAAe;;EAEvB,QAAQ,eAAe;;;;;;;EAOvB,YAAY,eAAe,eAAe;;;;;;;;;;;;;;;;;;UCpM3B;EACf;EACA;EACA,WAAW;EACX,eAAe,WAAW;;;;;;;;;;;;;;;;;;;;KAqBhB,eAAe,KAAK;WAAuB,cAAc;;;KAGzD,gBAAgB,QACzB,WAAW,IAAI,eAAe,EAAE,WAAW,oBAAoB,KAAK;UAGtD;EACf,aAAa;EACb,UAAU;EACV,UAAU;;;;;;;;;;;EAWV;;UAGe;EACf;EACA;EACA;EACA;EACA;EACA,YAAY;;;;;;;EAOZ;EACA;IAAc;IAAoB;;EAClC;;;;;EAKA;;EAEA;;EAEA;;EAEA;IAAY;IAAkB;;;EAE9B;;EAEA;;;;;;;;;;;;cAaW;KACD;YAA6B;;;;;;;cAO5B;KACD;YAAmC;;;;;;;;;;;;;cAalC;KACD;YAA2B;;;;;;;;;;;KAW3B,eAAe,MAAM,OAAO,OACrC,aAAa,eAAe,2BAC5B,aAAa,iBAAiB,6BAC9B,aAAa,uBAAuB;;;;;;;;;;cAW1B,cAAc;WAGR,MAAM;YAEb,OAAO;EAEjB,YAAY,cAAc,WAAU,QAAQ;EAY5C,kBAAkB;EAKlB,qBAAqB;EAMrB;EAKA,SAAS,qBAAqB,cAAc;EAK5C,WACE,cAAc,WACd;IAAQ,WAAW;IAAU,WAAW;IAAU;;;;;;;;;;;;;;EA4BpD,QAAQ,0CAA0C;;;;;;;EAWlD,WAAW,UAAU,WAAW;;;;;;EAUhC,UAAU,UAAU;;;;;EASpB;;;;;;EAUA;;;;;;;;EAYA,kBACE,oBACA;IAAW;aACH;;;;;EASV,oCAAoC,eAAe;;EAOnD,uCAAuC,eAAe;;;;;EAUtD,QAAQ;;;;;;EAUR,QAAQ;;EAMR,aAAa;EAIb,OAAO,eAAe;EAetB,WAAW,SAAS"}
@@ -1,5 +1,5 @@
1
1
 
2
- import { l as NotNullBrand, o as GeneratedBrand, t as ColumnBuilder } from "./types-DtX5fIbn.mjs";
2
+ import { l as NotNullBrand, o as GeneratedBrand, t as ColumnBuilder } from "./types-LCdRbLC1.mjs";
3
3
  import { CommonTableExpression, Dialect, Expression, ExpressionBuilder, Insertable, Kysely, KyselyPlugin, SelectQueryBuilder, SelectType, Selectable, SqlBool, UpdateObject } from "kysely";
4
4
  //#region src/client/insert-many.d.ts
5
5
  interface InsertManyOptions {
@@ -321,6 +321,8 @@ interface RelationMapEntry {
321
321
  kind: 'one' | 'many';
322
322
  target: string;
323
323
  relationName?: string;
324
+ /** A `morphTo`: `target` is the union of its tables. */
325
+ morphTo?: true;
324
326
  }
325
327
  /**
326
328
  * The full registered relation graph. Falls back to an open-shaped
@@ -391,9 +393,10 @@ interface FindManyOptions<DB = RegisteredDB, Table extends keyof DB & string = k
391
393
  with?: WithClause<DB, TableRelations<Table>>;
392
394
  /**
393
395
  * Cancellation handle. When the signal aborts, the in-flight
394
- * query is cancelled at the dialect level (PG `pg_cancel_backend`,
395
- * SQLite synchronous abort, MySQL `KILL QUERY`) and the promise
396
- * rejects with `RelationalQueryCancelledError`.
396
+ * query is cancelled on the server (Postgres `pg_cancel_backend`,
397
+ * MySQL `KILL QUERY`; better-sqlite3 runs synchronously, so there is
398
+ * nothing in flight) and the promise rejects with
399
+ * `RelationalQueryCancelledError`.
397
400
  *
398
401
  * Bind to `RequestContext.signal` from kickjs-http to short-circuit
399
402
  * the query when the client disconnects or the request times out.
@@ -403,6 +406,12 @@ interface FindManyOptions<DB = RegisteredDB, Table extends keyof DB & string = k
403
406
  * nested LATERAL/correlated subqueries inherit the parent signal.
404
407
  */
405
408
  signal?: AbortSignal;
409
+ /**
410
+ * Cancel the read on the server once it has run this long, and reject with
411
+ * `RelationalQueryCancelledError` (whose `cause` is a `TimeoutError`).
412
+ * Combines with `signal`: whichever fires first.
413
+ */
414
+ timeoutMs?: number;
406
415
  }
407
416
  /**
408
417
  * Per-relation shape inside `with`. `true` for boolean shorthand;
@@ -410,7 +419,19 @@ interface FindManyOptions<DB = RegisteredDB, Table extends keyof DB & string = k
410
419
  * whose `target` is also a key of the local `DB` are accepted —
411
420
  * cross-DB relations are unrepresentable at the call site.
412
421
  */
413
- type WithClause<DB, Rels extends Record<string, RelationMapEntry>> = { [K in keyof Rels]?: Rels[K]['target'] extends keyof DB & string ? true | FindManyOptions<DB, Rels[K]['target']> : never; };
422
+ type WithClause<DB, Rels extends Record<string, RelationMapEntry>> = { [K in keyof Rels]?: Rels[K]['target'] extends keyof DB & string ? true | WithOptions<DB, Rels[K], Rels[K]['target']> : never; };
423
+ /**
424
+ * A `morphTo`'s rows come from several tables, so only `withDeleted`
425
+ * applies. `never` (an untyped client) would match the check, so it keeps
426
+ * the full options.
427
+ */
428
+ type WithOptions<DB, E, Target extends keyof DB & string> = [E] extends [never] ? NestedOptions<DB, Target> : E extends {
429
+ morphTo: true;
430
+ } ? {
431
+ withDeleted?: boolean;
432
+ } : NestedOptions<DB, Target>;
433
+ /** A nested level runs inside its parent's query: cancelling is the parent's. */
434
+ type NestedOptions<DB, Target extends keyof DB & string> = Omit<FindManyOptions<DB, Target>, 'signal' | 'timeoutMs'>;
414
435
  /**
415
436
  * Resolved row shape returned by `findMany`. Base table columns
416
437
  * intersected with the per-relation slot map produced by `with`.
@@ -632,6 +653,22 @@ interface KickDbClient<DB = RegisteredDB> {
632
653
  readonly query: QueryNamespace<DB>;
633
654
  on<E extends keyof KickDbClientEvents>(event: E, listener: (e: KickDbClientEvents[E]) => void | Promise<void>): this;
634
655
  off<E extends keyof KickDbClientEvents>(event: E, listener: (e: KickDbClientEvents[E]) => void | Promise<void>): this;
656
+ /**
657
+ * Execute options that cancel a query on the server once it has run `ms`
658
+ * (Postgres `pg_cancel_backend`, MySQL `KILL QUERY`), or when `signal`
659
+ * aborts first. The query rejects with the signal's reason — a
660
+ * `DOMException` named `TimeoutError` for the timeout. Inside a
661
+ * transaction the query is abandoned, not cancelled: a cancel would abort
662
+ * the transaction.
663
+ *
664
+ * await db.selectFrom('reports').selectAll().execute(db.timeout(5_000))
665
+ */
666
+ timeout(ms: number, opts?: {
667
+ signal?: AbortSignal;
668
+ }): {
669
+ signal: AbortSignal;
670
+ inflightQueryAbortStrategy: 'cancel query' | 'ignore query';
671
+ };
635
672
  /**
636
673
  * Insert, or update the rows whose `target` key already exists — one
637
674
  * statement (`ON CONFLICT … DO UPDATE` / `ON DUPLICATE KEY UPDATE`), or
@@ -847,4 +884,4 @@ interface CreateDbClientOptions<TSchema, _DB = unknown> {
847
884
  }
848
885
  //#endregion
849
886
  export { TenantRequiredError as A, KickDbRegister as C, Tenancy as D, BypassOptions as E, ModelExtensions as F, FindOrCreateOptions as I, UpsertOptions as L, tenantKey as M, ExtendedClient as N, TenancyOptions as O, ExtensionDefinition as P, InsertManyOptions as R, WithClause as S, BypassInfo as T, QueryNamespace as _, QueryErrorEvent as a, TableQueryNamespace as b, ReadRouter as c, TransactionOptions as d, TransactionRetryEvent as f, KickDbRelationsRegister as g, FindManyRow as h, KickDbClientEvents as i, defineTenancy as j, TenancyStrategy as k, SlowQueryEvent as l, FindManyOptions as m, CreateDbClientOptions as n, QueryEvent as o, TransactionRollbackEvent as p, KickDbClient as r, ReadRoute as s, BeforeQueryEvent as t, TransactionEvent as u, RegisteredRelations as v, RegisteredDB as w, TableRelations as x, RelationMapEntry as y };
850
- //# sourceMappingURL=types-p2E6CrKO.d.mts.map
887
+ //# sourceMappingURL=types-ydAqBLR1.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types-ydAqBLR1.d.mts","names":["_$__upsert0.UpsertOptions","_$__insert_many0.InsertManyOptions","_$__upsert0.FindOrCreateOptions","_$___extend_types0.ExtensionDefinition","_$___extend_types0.ExtendedClient","KyselyDialect","_$___tenancy0.Tenancy"],"sources":["../src/client/insert-many.ts","../src/client/upsert.ts","../src/extend/types.ts","../src/tenancy.ts","../src/client/register.ts","../src/query/types.ts","../src/client/types.ts"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@forinda/kickjs-db",
3
- "version": "8.7.0",
3
+ "version": "8.8.0",
4
4
  "description": "KickJS-native ORM — code-first schema, reversible migrations, multi-dialect SQL builder",
5
5
  "keywords": [
6
6
  "kickjs",
@@ -104,9 +104,9 @@
104
104
  "pg": "^8.23.1",
105
105
  "pg-cursor": "^2.22.1",
106
106
  "typescript": "^7.0.2",
107
- "@forinda/kickjs": "10.2.0",
108
- "@forinda/kickjs-devtools-kit": "7.3.0",
109
- "@forinda/kickjs-schema": "0.2.4"
107
+ "@forinda/kickjs": "10.5.0",
108
+ "@forinda/kickjs-schema": "0.2.4",
109
+ "@forinda/kickjs-devtools-kit": "7.3.0"
110
110
  },
111
111
  "publishConfig": {
112
112
  "access": "public"