@forinda/kickjs-db 5.2.0 → 5.2.2

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/pg.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-db v5.2.0
2
+ * @forinda/kickjs-db v5.2.2
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,48 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import { t as ColumnBuilder } from "./types-DBmUL5LM.mjs";
12
- //#region src/dsl/columns/pg.ts
13
- var PgEnumColumnBuilder = class extends ColumnBuilder {
14
- /** The enum's SQL identifier — preserved for emit + drift detection. */
15
- enumName;
16
- /** Allowed values — readonly to prevent mutation across columns. */
17
- values;
18
- constructor(enumName, values) {
19
- super(enumName);
20
- this.enumName = enumName;
21
- this.values = values;
22
- }
23
- };
24
- function pgEnum(name, ...values) {
25
- const factory = () => new PgEnumColumnBuilder(name, values);
26
- return Object.assign(factory, {
27
- enumName: name,
28
- values
29
- });
30
- }
31
- function tsvector() {
32
- return new ColumnBuilder("tsvector");
33
- }
34
- function vector(dim) {
35
- return new ColumnBuilder(dim === void 0 ? "vector" : `vector(${dim})`);
36
- }
37
- function citext() {
38
- return new ColumnBuilder("citext");
39
- }
40
- function money() {
41
- return new ColumnBuilder("money");
42
- }
43
- function inet() {
44
- return new ColumnBuilder("inet");
45
- }
46
- function cidr() {
47
- return new ColumnBuilder("cidr");
48
- }
49
- function xml() {
50
- return new ColumnBuilder("xml");
51
- }
52
- //#endregion
53
- export { PgEnumColumnBuilder, cidr, citext, inet, money, pgEnum, tsvector, vector, xml };
54
-
11
+ import{t as ColumnBuilder}from"./types-Cxh6cDtw.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{PgEnumColumnBuilder,cidr,citext,inet,money,pgEnum,tsvector,vector,xml};
55
12
  //# sourceMappingURL=pg.mjs.map
package/dist/pg.mjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"pg.mjs","names":[],"sources":["../src/dsl/columns/pg.ts"],"sourcesContent":["import { ColumnBuilder } from './types'\n\n// PG-only column types. Phantom T per builder so SchemaToTypes<S> can narrow\n// each column to a useful TS shape — strings for the text-y types, number[]\n// for vector embeddings, etc.\n\n/**\n * Declare a PostgreSQL ENUM type.\n *\n * @example\n * ```ts\n * export const taskStatus = pgEnum('task_status', 'todo', 'in_progress', 'done')\n *\n * export const tasks = table('tasks', {\n * id: uuid().primaryKey().defaultRandom(),\n * status: taskStatus().notNull().default('todo'),\n * })\n * ```\n *\n * The factory returns a column builder whose phantom type narrows to\n * the union of the declared values — `db.selectFrom('tasks').select('status')`\n * types `status: 'todo' | 'in_progress' | 'done'`.\n *\n * Schema-level state (the enum name + values) is attached to every\n * column the factory produces so introspection / drift / emit can pick\n * it up. The snapshot + emit pipeline learns about enum types in the\n * follow-up commit; for now adopters must run the\n * `CREATE TYPE <name> AS ENUM (...)` DDL manually before any column\n * referencing the type is created.\n */\nexport interface PgEnumBuilder<TName extends string, TValues extends readonly string[]> {\n (): PgEnumColumnBuilder<TName, TValues>\n /** The SQL identifier — used by emit + drift detection. */\n readonly enumName: TName\n /** Allowed literal values, in declaration order. */\n readonly values: TValues\n}\n\nexport class PgEnumColumnBuilder<\n TName extends string,\n TValues extends readonly string[],\n> extends ColumnBuilder<TValues[number]> {\n /** The enum's SQL identifier — preserved for emit + drift detection. */\n readonly enumName: TName\n /** Allowed values — readonly to prevent mutation across columns. */\n readonly values: TValues\n\n constructor(enumName: TName, values: TValues) {\n // The SQL data type IS the enum identifier — `status task_status`,\n // not `status text` — so PG enforces the membership constraint.\n super(enumName)\n this.enumName = enumName\n this.values = values\n }\n}\n\n// Variadic rest forces TS to infer EACH value as its literal type, so\n// `pgEnum('s', 'todo', 'done')` resolves to\n// `PgEnumBuilder<'s', ['todo', 'done']>`. Without rest, an array\n// literal stored in a variable would widen to `string[]` and the\n// column phantom would collapse to plain `string`, defeating the\n// entire point of the helper. Adopters with a pre-existing array\n// can still spread it: `pgEnum('s', ...VALUES as const)`.\nexport function pgEnum<TName extends string, const TValues extends readonly [string, ...string[]]>(\n name: TName,\n ...values: TValues\n): PgEnumBuilder<TName, TValues> {\n const factory = (): PgEnumColumnBuilder<TName, TValues> =>\n new PgEnumColumnBuilder<TName, TValues>(name, values)\n // Attach metadata to the factory itself so introspection that walks\n // `Object.values(schema)` can discover enum declarations even when\n // they're declared standalone (without a column reference).\n return Object.assign(factory, { enumName: name, values }) as PgEnumBuilder<TName, TValues>\n}\n\nexport function tsvector(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('tsvector')\n}\n\nexport function vector(dim?: number): ColumnBuilder<number[]> {\n return new ColumnBuilder<number[]>(dim === undefined ? 'vector' : `vector(${dim})`)\n}\n\nexport function citext(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('citext')\n}\n\nexport function money(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('money')\n}\n\nexport function inet(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('inet')\n}\n\nexport function cidr(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('cidr')\n}\n\nexport function xml(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('xml')\n}\n"],"mappings":";;;;;;;;;;;;AAsCA,IAAa,sBAAb,cAGU,cAA+B;;CAEvC;;CAEA;CAEA,YAAY,UAAiB,QAAiB;AAG5C,QAAM,SAAS;AACf,OAAK,WAAW;AAChB,OAAK,SAAS;;;AAWlB,SAAgB,OACd,MACA,GAAG,QAC4B;CAC/B,MAAM,gBACJ,IAAI,oBAAoC,MAAM,OAAO;AAIvD,QAAO,OAAO,OAAO,SAAS;EAAE,UAAU;EAAM;EAAQ,CAAC;;AAG3D,SAAgB,WAAkC;AAChD,QAAO,IAAI,cAAsB,WAAW;;AAG9C,SAAgB,OAAO,KAAuC;AAC5D,QAAO,IAAI,cAAwB,QAAQ,KAAA,IAAY,WAAW,UAAU,IAAI,GAAG;;AAGrF,SAAgB,SAAgC;AAC9C,QAAO,IAAI,cAAsB,SAAS;;AAG5C,SAAgB,QAA+B;AAC7C,QAAO,IAAI,cAAsB,QAAQ;;AAG3C,SAAgB,OAA8B;AAC5C,QAAO,IAAI,cAAsB,OAAO;;AAG1C,SAAgB,OAA8B;AAC5C,QAAO,IAAI,cAAsB,OAAO;;AAG1C,SAAgB,MAA6B;AAC3C,QAAO,IAAI,cAAsB,MAAM"}
1
+ {"version":3,"file":"pg.mjs","names":[],"sources":["../src/dsl/columns/pg.ts"],"sourcesContent":["import { ColumnBuilder } from './types'\n\n// PG-only column types. Phantom T per builder so SchemaToTypes<S> can narrow\n// each column to a useful TS shape — strings for the text-y types, number[]\n// for vector embeddings, etc.\n\n/**\n * Declare a PostgreSQL ENUM type.\n *\n * @example\n * ```ts\n * export const taskStatus = pgEnum('task_status', 'todo', 'in_progress', 'done')\n *\n * export const tasks = table('tasks', {\n * id: uuid().primaryKey().defaultRandom(),\n * status: taskStatus().notNull().default('todo'),\n * })\n * ```\n *\n * The factory returns a column builder whose phantom type narrows to\n * the union of the declared values — `db.selectFrom('tasks').select('status')`\n * types `status: 'todo' | 'in_progress' | 'done'`.\n *\n * Schema-level state (the enum name + values) is attached to every\n * column the factory produces so introspection / drift / emit can pick\n * it up. The snapshot + emit pipeline learns about enum types in the\n * follow-up commit; for now adopters must run the\n * `CREATE TYPE <name> AS ENUM (...)` DDL manually before any column\n * referencing the type is created.\n */\nexport interface PgEnumBuilder<TName extends string, TValues extends readonly string[]> {\n (): PgEnumColumnBuilder<TName, TValues>\n /** The SQL identifier — used by emit + drift detection. */\n readonly enumName: TName\n /** Allowed literal values, in declaration order. */\n readonly values: TValues\n}\n\nexport class PgEnumColumnBuilder<\n TName extends string,\n TValues extends readonly string[],\n> extends ColumnBuilder<TValues[number]> {\n /** The enum's SQL identifier — preserved for emit + drift detection. */\n readonly enumName: TName\n /** Allowed values — readonly to prevent mutation across columns. */\n readonly values: TValues\n\n constructor(enumName: TName, values: TValues) {\n // The SQL data type IS the enum identifier — `status task_status`,\n // not `status text` — so PG enforces the membership constraint.\n super(enumName)\n this.enumName = enumName\n this.values = values\n }\n}\n\n// Variadic rest forces TS to infer EACH value as its literal type, so\n// `pgEnum('s', 'todo', 'done')` resolves to\n// `PgEnumBuilder<'s', ['todo', 'done']>`. Without rest, an array\n// literal stored in a variable would widen to `string[]` and the\n// column phantom would collapse to plain `string`, defeating the\n// entire point of the helper. Adopters with a pre-existing array\n// can still spread it: `pgEnum('s', ...VALUES as const)`.\nexport function pgEnum<TName extends string, const TValues extends readonly [string, ...string[]]>(\n name: TName,\n ...values: TValues\n): PgEnumBuilder<TName, TValues> {\n const factory = (): PgEnumColumnBuilder<TName, TValues> =>\n new PgEnumColumnBuilder<TName, TValues>(name, values)\n // Attach metadata to the factory itself so introspection that walks\n // `Object.values(schema)` can discover enum declarations even when\n // they're declared standalone (without a column reference).\n return Object.assign(factory, { enumName: name, values }) as PgEnumBuilder<TName, TValues>\n}\n\nexport function tsvector(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('tsvector')\n}\n\nexport function vector(dim?: number): ColumnBuilder<number[]> {\n return new ColumnBuilder<number[]>(dim === undefined ? 'vector' : `vector(${dim})`)\n}\n\nexport function citext(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('citext')\n}\n\nexport function money(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('money')\n}\n\nexport function inet(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('inet')\n}\n\nexport function cidr(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('cidr')\n}\n\nexport function xml(): ColumnBuilder<string> {\n return new ColumnBuilder<string>('xml')\n}\n"],"mappings":";;;;;;;;;;qDAsCA,IAAa,oBAAb,cAGU,aAA+B,CAEvC,SAEA,OAEA,YAAY,SAAiB,OAAiB,CAG5C,MAAM,SAAS,CACf,KAAK,SAAW,SAChB,KAAK,OAAS,SAWlB,SAAgB,OACd,KACA,GAAG,OAC4B,CAM/B,OAAO,OAAO,WAJZ,IAAI,oBAAoC,KAAM,OAAO,CAIzB,CAAE,SAAU,KAAM,OAAQ,CAAC,CAG3D,SAAgB,UAAkC,CAChD,OAAO,IAAI,cAAsB,WAAW,CAG9C,SAAgB,OAAO,IAAuC,CAC5D,OAAO,IAAI,cAAwB,MAAQ,IAAA,GAAY,SAAW,UAAU,IAAI,GAAG,CAGrF,SAAgB,QAAgC,CAC9C,OAAO,IAAI,cAAsB,SAAS,CAG5C,SAAgB,OAA+B,CAC7C,OAAO,IAAI,cAAsB,QAAQ,CAG3C,SAAgB,MAA8B,CAC5C,OAAO,IAAI,cAAsB,OAAO,CAG1C,SAAgB,MAA8B,CAC5C,OAAO,IAAI,cAAsB,OAAO,CAG1C,SAAgB,KAA6B,CAC3C,OAAO,IAAI,cAAsB,MAAM"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * @forinda/kickjs-db v5.2.2
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
+ const KICK_GENERATED=Symbol.for(`@forinda/kickjs-db/Generated`),KICK_NOT_NULL=Symbol.for(`@forinda/kickjs-db/NotNull`);var ColumnBuilder=class{state;constructor(type,defaults={}){this.state={type,nullable:defaults.nullable??!0,default:defaults.default??null,primaryKey:defaults.primaryKey??!1,unique:defaults.unique??!1,references:defaults.references??null}}notNull(){return this.state.nullable=!1,this}primaryKey(){return this.state.primaryKey=!0,this.state.nullable=!1,this}unique(){return this.state.unique=!0,this}array(){return this.state.type=`${this.state.type}[]`,this}references(target,opts={}){return this.state.references={thunk:target,onDelete:opts.onDelete??`no_action`,onUpdate:opts.onUpdate??`no_action`},this}default(value){return this.state.default=value,this}toJSON(name){return{name,type:this.state.type,nullable:this.state.nullable,default:this.state.default,primaryKey:this.state.primaryKey}}__state(){return this.state}};export{KICK_GENERATED as n,KICK_NOT_NULL as r,ColumnBuilder as t};
12
+ //# sourceMappingURL=types-Cxh6cDtw.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"types-DBmUL5LM.mjs","names":[],"sources":["../src/dsl/columns/types.ts"],"sourcesContent":["import type { ColumnSnapshot, FkAction } from '../../snapshot/types'\n\n/**\n * Runtime + type representation of a column reference (e.g. `users.id`).\n * Carries the parent table name, the column's own name, plus runtime\n * accessors used by FK thunks and constraint builders.\n *\n * Exported so adopters can annotate self-referencing thunks without\n * spelling the shape inline:\n *\n * parentId: uuid().references((): ColumnRef => categories.id)\n *\n * Without the annotation the initializer of a self-referencing const\n * trips TS7022 — TS needs to infer the const while the initializer\n * already references it.\n */\nexport interface ColumnRef {\n __tableName: string\n __name: string\n __builder: ColumnBuilder\n __state: () => ReturnType<ColumnBuilder['__state']>\n}\n\n/**\n * Resolved FK spec — `table` / `column` are pulled by invoking `thunk()`\n * lazily. The thunk pattern lets self-referencing tables work:\n *\n * const categories = table('categories', {\n * id: uuid().primaryKey().defaultRandom(),\n * parentId: uuid().references((): ColumnRef => categories.id),\n * })\n *\n * If we resolved at `.references()` call time, `categories` would TDZ-fail\n * inside its own initializer. Storing the thunk and resolving on read\n * (extract / render / emit) defers until after the const binding lands.\n */\nexport interface FkSpec {\n thunk: () => ColumnRef\n onDelete: FkAction\n onUpdate: FkAction\n}\n\nexport interface ColumnState {\n type: string\n nullable: boolean\n default: string | null\n primaryKey: boolean\n unique: boolean\n references: FkSpec | null\n}\n\n/**\n * Type-only brand attached to a column when it's auto-assigned by the\n * database (serial / bigserial / smallserial), has a runtime default\n * (`.default(...)`), or carries an expression default\n * (`uuid().defaultRandom()`, `timestamp().defaultNow()`). `SchemaToTypes<S>`\n * reads this marker and wraps the column type in Kysely's `Generated<T>` so\n * adopters can omit the column on insert.\n *\n * Runtime is a no-op — the symbol never reaches a value.\n */\nexport const KICK_GENERATED = Symbol.for('@forinda/kickjs-db/Generated')\nexport type GeneratedBrand = { readonly [KICK_GENERATED]?: true }\n\n/**\n * Type-only brand attached to a column when `.notNull()` or `.primaryKey()`\n * is called. `SchemaToTypes<S>` reads this brand to decide whether the\n * column type is `T` (NOT NULL) or `T | null` (default nullable).\n *\n * Why a brand instead of a class generic: chained methods (notNull,\n * primaryKey) can return `this & NotNullBrand` to narrow nullability while\n * preserving the subclass identity — so `uuid().primaryKey().defaultRandom()`\n * still resolves `defaultRandom()` on `UuidBuilder`. A class generic\n * `<TNullable>` would collapse the subclass back to the parent.\n */\nexport const KICK_NOT_NULL = Symbol.for('@forinda/kickjs-db/NotNull')\nexport type NotNullBrand = { readonly [KICK_NOT_NULL]?: true }\n\n/**\n * Phantom-typed column builder. The `T` generic carries the column's TS\n * value type (number / string / Date / etc.); nullability is tracked via\n * the `NotNullBrand` intersection rather than a class generic so chain\n * methods preserve subclass identity.\n *\n * Both `T` and the brand are erased at runtime; they exist purely so\n * `SchemaToTypes<S>` can pull them out per column.\n */\nexport class ColumnBuilder<T = unknown> {\n // Phantom param shows up in the public surface so the type system sees\n // it. Reading it at runtime is intentionally not supported.\n declare readonly __t?: T\n\n protected state: ColumnState\n\n constructor(type: string, defaults: Partial<ColumnState> = {}) {\n this.state = {\n type,\n nullable: defaults.nullable ?? true,\n default: defaults.default ?? null,\n primaryKey: defaults.primaryKey ?? false,\n unique: defaults.unique ?? false,\n references: defaults.references ?? null,\n }\n }\n\n notNull(): this & NotNullBrand {\n this.state.nullable = false\n return this as this & NotNullBrand\n }\n\n primaryKey(): this & NotNullBrand {\n this.state.primaryKey = true\n this.state.nullable = false\n return this as this & NotNullBrand\n }\n\n unique(): this {\n this.state.unique = true\n return this\n }\n\n array(): ColumnBuilder<T[]> {\n this.state.type = `${this.state.type}[]`\n return this as unknown as ColumnBuilder<T[]>\n }\n\n references(\n target: () => ColumnRef,\n opts: { onDelete?: FkAction; onUpdate?: FkAction } = {},\n ): this {\n // Store the thunk — do NOT invoke it here. Self-referencing tables\n // pass `() => self.id` whose binding does not exist yet.\n this.state.references = {\n thunk: target,\n onDelete: opts.onDelete ?? 'no_action',\n onUpdate: opts.onUpdate ?? 'no_action',\n }\n return this\n }\n\n /**\n * Mark the column as having a runtime / DB-assigned default. The\n * `GeneratedBrand` flows into `SchemaToTypes<S>` so the column wraps\n * in `Generated<T>` — adopters can `INSERT` without specifying it.\n */\n default(value: string): this & GeneratedBrand {\n this.state.default = value\n return this as this & GeneratedBrand\n }\n\n toJSON(name: string): ColumnSnapshot {\n return {\n name,\n type: this.state.type,\n nullable: this.state.nullable,\n default: this.state.default,\n primaryKey: this.state.primaryKey,\n }\n }\n\n // Internal accessor for table()/diff to read full state including unique/references.\n __state(): Readonly<ColumnState> {\n return this.state\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA6DA,MAAa,iBAAiB,OAAO,IAAI,+BAA+B;;;;;;;;;;;;AAcxE,MAAa,gBAAgB,OAAO,IAAI,6BAA6B;;;;;;;;;;AAYrE,IAAa,gBAAb,MAAwC;CAKtC;CAEA,YAAY,MAAc,WAAiC,EAAE,EAAE;AAC7D,OAAK,QAAQ;GACX;GACA,UAAU,SAAS,YAAY;GAC/B,SAAS,SAAS,WAAW;GAC7B,YAAY,SAAS,cAAc;GACnC,QAAQ,SAAS,UAAU;GAC3B,YAAY,SAAS,cAAc;GACpC;;CAGH,UAA+B;AAC7B,OAAK,MAAM,WAAW;AACtB,SAAO;;CAGT,aAAkC;AAChC,OAAK,MAAM,aAAa;AACxB,OAAK,MAAM,WAAW;AACtB,SAAO;;CAGT,SAAe;AACb,OAAK,MAAM,SAAS;AACpB,SAAO;;CAGT,QAA4B;AAC1B,OAAK,MAAM,OAAO,GAAG,KAAK,MAAM,KAAK;AACrC,SAAO;;CAGT,WACE,QACA,OAAqD,EAAE,EACjD;AAGN,OAAK,MAAM,aAAa;GACtB,OAAO;GACP,UAAU,KAAK,YAAY;GAC3B,UAAU,KAAK,YAAY;GAC5B;AACD,SAAO;;;;;;;CAQT,QAAQ,OAAsC;AAC5C,OAAK,MAAM,UAAU;AACrB,SAAO;;CAGT,OAAO,MAA8B;AACnC,SAAO;GACL;GACA,MAAM,KAAK,MAAM;GACjB,UAAU,KAAK,MAAM;GACrB,SAAS,KAAK,MAAM;GACpB,YAAY,KAAK,MAAM;GACxB;;CAIH,UAAiC;AAC/B,SAAO,KAAK"}
1
+ {"version":3,"file":"types-Cxh6cDtw.mjs","names":[],"sources":["../src/dsl/columns/types.ts"],"sourcesContent":["import type { ColumnSnapshot, FkAction } from '../../snapshot/types'\n\n/**\n * Runtime + type representation of a column reference (e.g. `users.id`).\n * Carries the parent table name, the column's own name, plus runtime\n * accessors used by FK thunks and constraint builders.\n *\n * Exported so adopters can annotate self-referencing thunks without\n * spelling the shape inline:\n *\n * parentId: uuid().references((): ColumnRef => categories.id)\n *\n * Without the annotation the initializer of a self-referencing const\n * trips TS7022 — TS needs to infer the const while the initializer\n * already references it.\n */\nexport interface ColumnRef {\n __tableName: string\n __name: string\n __builder: ColumnBuilder\n __state: () => ReturnType<ColumnBuilder['__state']>\n}\n\n/**\n * Resolved FK spec — `table` / `column` are pulled by invoking `thunk()`\n * lazily. The thunk pattern lets self-referencing tables work:\n *\n * const categories = table('categories', {\n * id: uuid().primaryKey().defaultRandom(),\n * parentId: uuid().references((): ColumnRef => categories.id),\n * })\n *\n * If we resolved at `.references()` call time, `categories` would TDZ-fail\n * inside its own initializer. Storing the thunk and resolving on read\n * (extract / render / emit) defers until after the const binding lands.\n */\nexport interface FkSpec {\n thunk: () => ColumnRef\n onDelete: FkAction\n onUpdate: FkAction\n}\n\nexport interface ColumnState {\n type: string\n nullable: boolean\n default: string | null\n primaryKey: boolean\n unique: boolean\n references: FkSpec | null\n}\n\n/**\n * Type-only brand attached to a column when it's auto-assigned by the\n * database (serial / bigserial / smallserial), has a runtime default\n * (`.default(...)`), or carries an expression default\n * (`uuid().defaultRandom()`, `timestamp().defaultNow()`). `SchemaToTypes<S>`\n * reads this marker and wraps the column type in Kysely's `Generated<T>` so\n * adopters can omit the column on insert.\n *\n * Runtime is a no-op — the symbol never reaches a value.\n */\nexport const KICK_GENERATED = Symbol.for('@forinda/kickjs-db/Generated')\nexport type GeneratedBrand = { readonly [KICK_GENERATED]?: true }\n\n/**\n * Type-only brand attached to a column when `.notNull()` or `.primaryKey()`\n * is called. `SchemaToTypes<S>` reads this brand to decide whether the\n * column type is `T` (NOT NULL) or `T | null` (default nullable).\n *\n * Why a brand instead of a class generic: chained methods (notNull,\n * primaryKey) can return `this & NotNullBrand` to narrow nullability while\n * preserving the subclass identity — so `uuid().primaryKey().defaultRandom()`\n * still resolves `defaultRandom()` on `UuidBuilder`. A class generic\n * `<TNullable>` would collapse the subclass back to the parent.\n */\nexport const KICK_NOT_NULL = Symbol.for('@forinda/kickjs-db/NotNull')\nexport type NotNullBrand = { readonly [KICK_NOT_NULL]?: true }\n\n/**\n * Phantom-typed column builder. The `T` generic carries the column's TS\n * value type (number / string / Date / etc.); nullability is tracked via\n * the `NotNullBrand` intersection rather than a class generic so chain\n * methods preserve subclass identity.\n *\n * Both `T` and the brand are erased at runtime; they exist purely so\n * `SchemaToTypes<S>` can pull them out per column.\n */\nexport class ColumnBuilder<T = unknown> {\n // Phantom param shows up in the public surface so the type system sees\n // it. Reading it at runtime is intentionally not supported.\n declare readonly __t?: T\n\n protected state: ColumnState\n\n constructor(type: string, defaults: Partial<ColumnState> = {}) {\n this.state = {\n type,\n nullable: defaults.nullable ?? true,\n default: defaults.default ?? null,\n primaryKey: defaults.primaryKey ?? false,\n unique: defaults.unique ?? false,\n references: defaults.references ?? null,\n }\n }\n\n notNull(): this & NotNullBrand {\n this.state.nullable = false\n return this as this & NotNullBrand\n }\n\n primaryKey(): this & NotNullBrand {\n this.state.primaryKey = true\n this.state.nullable = false\n return this as this & NotNullBrand\n }\n\n unique(): this {\n this.state.unique = true\n return this\n }\n\n array(): ColumnBuilder<T[]> {\n this.state.type = `${this.state.type}[]`\n return this as unknown as ColumnBuilder<T[]>\n }\n\n references(\n target: () => ColumnRef,\n opts: { onDelete?: FkAction; onUpdate?: FkAction } = {},\n ): this {\n // Store the thunk — do NOT invoke it here. Self-referencing tables\n // pass `() => self.id` whose binding does not exist yet.\n this.state.references = {\n thunk: target,\n onDelete: opts.onDelete ?? 'no_action',\n onUpdate: opts.onUpdate ?? 'no_action',\n }\n return this\n }\n\n /**\n * Mark the column as having a runtime / DB-assigned default. The\n * `GeneratedBrand` flows into `SchemaToTypes<S>` so the column wraps\n * in `Generated<T>` — adopters can `INSERT` without specifying it.\n */\n default(value: string): this & GeneratedBrand {\n this.state.default = value\n return this as this & GeneratedBrand\n }\n\n toJSON(name: string): ColumnSnapshot {\n return {\n name,\n type: this.state.type,\n nullable: this.state.nullable,\n default: this.state.default,\n primaryKey: this.state.primaryKey,\n }\n }\n\n // Internal accessor for table()/diff to read full state including unique/references.\n __state(): Readonly<ColumnState> {\n return this.state\n }\n}\n"],"mappings":";;;;;;;;;;AA6DA,MAAa,eAAiB,OAAO,IAAI,+BAA+B,CAc3D,cAAgB,OAAO,IAAI,6BAA6B,CAYrE,IAAa,cAAb,KAAwC,CAKtC,MAEA,YAAY,KAAc,SAAiC,EAAE,CAAE,CAC7D,KAAK,MAAQ,CACX,KACA,SAAU,SAAS,UAAY,GAC/B,QAAS,SAAS,SAAW,KAC7B,WAAY,SAAS,YAAc,GACnC,OAAQ,SAAS,QAAU,GAC3B,WAAY,SAAS,YAAc,KACpC,CAGH,SAA+B,CAE7B,MADA,MAAK,MAAM,SAAW,GACf,KAGT,YAAkC,CAGhC,MAFA,MAAK,MAAM,WAAa,GACxB,KAAK,MAAM,SAAW,GACf,KAGT,QAAe,CAEb,MADA,MAAK,MAAM,OAAS,GACb,KAGT,OAA4B,CAE1B,MADA,MAAK,MAAM,KAAO,GAAG,KAAK,MAAM,KAAK,IAC9B,KAGT,WACE,OACA,KAAqD,EAAE,CACjD,CAQN,MALA,MAAK,MAAM,WAAa,CACtB,MAAO,OACP,SAAU,KAAK,UAAY,YAC3B,SAAU,KAAK,UAAY,YAC5B,CACM,KAQT,QAAQ,MAAsC,CAE5C,MADA,MAAK,MAAM,QAAU,MACd,KAGT,OAAO,KAA8B,CACnC,MAAO,CACL,KACA,KAAM,KAAK,MAAM,KACjB,SAAU,KAAK,MAAM,SACrB,QAAS,KAAK,MAAM,QACpB,WAAY,KAAK,MAAM,WACxB,CAIH,SAAiC,CAC/B,OAAO,KAAK"}
@@ -234,7 +234,7 @@ interface CreateDbClientOptions<TSchema, _DB = unknown> {
234
234
  * existing emitter). Wire it from `DEVTOOLS_BUS` if you want the
235
235
  * DevTools panel to pick the events up:
236
236
  *
237
- * import { DEVTOOLS_BUS } from '@forinda/kickjs-devtools-kit/bus'
237
+ * import { DEVTOOLS_BUS } from '@forinda/kickjs-devtools-kit/bus/token'
238
238
  * // Resolve only when devtools is actually wired — adopters who
239
239
  * // skip @forinda/kickjs-devtools never register the token, and
240
240
  * // resolve() throws on missing tokens.
@@ -252,4 +252,4 @@ interface CreateDbClientOptions<TSchema, _DB = unknown> {
252
252
  }
253
253
  //#endregion
254
254
  export { QueryErrorEvent as a, TransactionEvent as c, RegisteredDB as d, ExtendedClient as f, KickDbClientEvents as i, TransactionRollbackEvent as l, ModelExtensions as m, CreateDbClientOptions as n, QueryEvent as o, ExtensionDefinition as p, KickDbClient as r, SlowQueryEvent as s, BeforeQueryEvent as t, KickDbRegister as u };
255
- //# sourceMappingURL=types-snBo_IiR.d.mts.map
255
+ //# sourceMappingURL=types-DlFKeljT.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types-snBo_IiR.d.mts","names":[],"sources":["../src/extend/types.ts","../src/client/register.ts","../src/client/types.ts"],"mappings":"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"}
1
+ {"version":3,"file":"types-DlFKeljT.d.mts","names":[],"sources":["../src/extend/types.ts","../src/client/register.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": "5.2.0",
3
+ "version": "5.2.2",
4
4
  "description": "KickJS-native ORM — code-first schema, reversible migrations, multi-dialect SQL builder",
5
5
  "keywords": [
6
6
  "kickjs",
@@ -67,8 +67,8 @@
67
67
  "kysely": "^0.28.16",
68
68
  "pg": "^8.13.1",
69
69
  "typescript": "^5.9.2",
70
- "@forinda/kickjs-devtools-kit": "5.2.0",
71
- "@forinda/kickjs": "5.2.0"
70
+ "@forinda/kickjs": "5.4.0",
71
+ "@forinda/kickjs-devtools-kit": "5.3.1"
72
72
  },
73
73
  "publishConfig": {
74
74
  "access": "public"
@@ -1,106 +0,0 @@
1
- /**
2
- * @forinda/kickjs-db v5.2.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
- //#region src/dsl/columns/types.ts
12
- /**
13
- * Type-only brand attached to a column when it's auto-assigned by the
14
- * database (serial / bigserial / smallserial), has a runtime default
15
- * (`.default(...)`), or carries an expression default
16
- * (`uuid().defaultRandom()`, `timestamp().defaultNow()`). `SchemaToTypes<S>`
17
- * reads this marker and wraps the column type in Kysely's `Generated<T>` so
18
- * adopters can omit the column on insert.
19
- *
20
- * Runtime is a no-op — the symbol never reaches a value.
21
- */
22
- const KICK_GENERATED = Symbol.for("@forinda/kickjs-db/Generated");
23
- /**
24
- * Type-only brand attached to a column when `.notNull()` or `.primaryKey()`
25
- * is called. `SchemaToTypes<S>` reads this brand to decide whether the
26
- * column type is `T` (NOT NULL) or `T | null` (default nullable).
27
- *
28
- * Why a brand instead of a class generic: chained methods (notNull,
29
- * primaryKey) can return `this & NotNullBrand` to narrow nullability while
30
- * preserving the subclass identity — so `uuid().primaryKey().defaultRandom()`
31
- * still resolves `defaultRandom()` on `UuidBuilder`. A class generic
32
- * `<TNullable>` would collapse the subclass back to the parent.
33
- */
34
- const KICK_NOT_NULL = Symbol.for("@forinda/kickjs-db/NotNull");
35
- /**
36
- * Phantom-typed column builder. The `T` generic carries the column's TS
37
- * value type (number / string / Date / etc.); nullability is tracked via
38
- * the `NotNullBrand` intersection rather than a class generic so chain
39
- * methods preserve subclass identity.
40
- *
41
- * Both `T` and the brand are erased at runtime; they exist purely so
42
- * `SchemaToTypes<S>` can pull them out per column.
43
- */
44
- var ColumnBuilder = class {
45
- state;
46
- constructor(type, defaults = {}) {
47
- this.state = {
48
- type,
49
- nullable: defaults.nullable ?? true,
50
- default: defaults.default ?? null,
51
- primaryKey: defaults.primaryKey ?? false,
52
- unique: defaults.unique ?? false,
53
- references: defaults.references ?? null
54
- };
55
- }
56
- notNull() {
57
- this.state.nullable = false;
58
- return this;
59
- }
60
- primaryKey() {
61
- this.state.primaryKey = true;
62
- this.state.nullable = false;
63
- return this;
64
- }
65
- unique() {
66
- this.state.unique = true;
67
- return this;
68
- }
69
- array() {
70
- this.state.type = `${this.state.type}[]`;
71
- return this;
72
- }
73
- references(target, opts = {}) {
74
- this.state.references = {
75
- thunk: target,
76
- onDelete: opts.onDelete ?? "no_action",
77
- onUpdate: opts.onUpdate ?? "no_action"
78
- };
79
- return this;
80
- }
81
- /**
82
- * Mark the column as having a runtime / DB-assigned default. The
83
- * `GeneratedBrand` flows into `SchemaToTypes<S>` so the column wraps
84
- * in `Generated<T>` — adopters can `INSERT` without specifying it.
85
- */
86
- default(value) {
87
- this.state.default = value;
88
- return this;
89
- }
90
- toJSON(name) {
91
- return {
92
- name,
93
- type: this.state.type,
94
- nullable: this.state.nullable,
95
- default: this.state.default,
96
- primaryKey: this.state.primaryKey
97
- };
98
- }
99
- __state() {
100
- return this.state;
101
- }
102
- };
103
- //#endregion
104
- export { KICK_GENERATED as n, KICK_NOT_NULL as r, ColumnBuilder as t };
105
-
106
- //# sourceMappingURL=types-DBmUL5LM.mjs.map