@warlock.js/cascade 5.28.0 → 5.30.0

package/esm/expressions/column-expressions.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"column-expressions.mjs","names":[],"sources":["../../../../../../../cascade/src/expressions/column-expressions.ts"],"sourcesContent":["/**\n * Database-agnostic, **typed** column expressions for aggregate inputs.\n *\n * These let `$agg.sum(...)` (and any future expression-accepting aggregate)\n * operate on a composed arithmetic expression — e.g. `price * quantity` — not\n * just a bare column, while staying portable across drivers.\n *\n * The builders are grouped under a single `$expr` object (mirroring `$agg`),\n * so the package root exposes exactly two expression namespaces — `$agg` for\n * aggregates and `$expr` for the scalar arithmetic that feeds them — rather\n * than a handful of collision-prone bare verbs (`mul`, `add`, `col`, …).\n *\n * The expression tree is a small, closed union of safe nodes:\n *\n * - `$expr.col(\"price\")` — a column reference (driver quotes/escapes it)\n * - `$expr.lit(2)` — a numeric/boolean literal\n * - `$expr.mul(a, b, …)` / `$expr.add(…)` / `$expr.sub(a, b)` / `$expr.div(a, b)` — arithmetic\n * - `$expr.raw(\"price * 1.2\")` — an explicit escape hatch for a raw SQL fragment\n *\n * Only `$expr.raw` ever embeds an uninterpreted string, and it is opt-in by\n * name. Everything else is composed from typed nodes, so user-supplied column\n * names flow through the driver's identifier-quoting path rather than being\n * string-interpolated into SQL. This is the boundary the S2 task calls out: a\n * tiny typed DSL for the common safe ops, plus a clearly-named raw escape\n * hatch for everything beyond it.\n *\n * Bare strings are still accepted everywhere a `ColumnExpression` is — a plain\n * string is treated as a column reference (`\"price\"` === `$expr.col(\"price\")`),\n * so the existing `$agg.sum(\"amount\")` call site keeps working unchanged.\n *\n * @example\n * ```typescript\n * import { $agg, $expr } from \"@warlock.js/cascade\";\n *\n * query.groupByDate(\"created_at\", \"month\", {\n *   revenue: $agg.sum($expr.mul(\"price\", \"quantity\")),\n * });\n * ```\n */\n\n/** Discriminator tag identifying a node in the column-expression tree. */\nexport type ColumnExpressionType =\n  | \"column\"\n  | \"literal\"\n  | \"add\"\n  | \"subtract\"\n  | \"multiply\"\n  | \"divide\"\n  | \"raw\";\n\n/**\n * A reference to a column/field. The driver is responsible for quoting the\n * name (SQL) or prefixing it with `$` (Mongo) — it is never interpolated raw.\n */\nexport type ColumnRefExpression = {\n  readonly __expr: \"column\";\n  readonly column: string;\n};\n\n/** A scalar literal value embedded directly in the expression. */\nexport type LiteralExpression = {\n  readonly __expr: \"literal\";\n  readonly value: number | boolean;\n};\n\n/**\n * An arithmetic operation over one or more operands.\n *\n * `add` / `multiply` are variadic; `subtract` / `divide` take exactly two\n * operands (left, right) since they are not associative.\n */\nexport type ArithmeticExpression = {\n  readonly __expr: \"add\" | \"subtract\" | \"multiply\" | \"divide\";\n  readonly operands: ColumnExpression[];\n};\n\n/**\n * A raw expression escape hatch. The string is emitted verbatim into the\n * generated SQL — callers MUST NOT build it from untrusted input. This is the\n * documented boundary for anything the typed nodes above don't cover.\n */\nexport type RawColumnExpression = {\n  readonly __expr: \"raw\";\n  readonly expression: string;\n};\n\n/**\n * Any node in the typed column-expression tree. A bare `string` is also a\n * valid expression input wherever this type is accepted — it is interpreted as\n * a column reference.\n */\nexport type ColumnExpression =\n  | ColumnRefExpression\n  | LiteralExpression\n  | ArithmeticExpression\n  | RawColumnExpression;\n\n/** Input accepted by expression-aware helpers: a typed node or a column-name string. */\nexport type ColumnExpressionInput = ColumnExpression | string;\n\n/**\n * Type guard: is `value` one of the typed column-expression nodes?\n *\n * @param value - The value to test\n * @returns `true` when `value` is a `ColumnExpression` node\n */\nexport function isColumnExpression(value: unknown): value is ColumnExpression {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as ColumnExpression).__expr === \"string\"\n  );\n}\n\n/**\n * Reference a column/field by name.\n *\n * @param column - The column/field name\n * @returns A column-reference expression node\n */\nfunction col(column: string): ColumnRefExpression {\n  return { __expr: \"column\", column };\n}\n\n/**\n * A scalar literal (number or boolean) operand.\n *\n * @param value - The literal value\n * @returns A literal expression node\n */\nfunction lit(value: number | boolean): LiteralExpression {\n  return { __expr: \"literal\", value };\n}\n\n/**\n * Multiply two or more operands.\n *\n * @param operands - Column names, literals, or nested expression nodes\n * @returns A multiply expression node\n */\nfunction mul(...operands: ColumnExpressionInput[]): ArithmeticExpression {\n  return { __expr: \"multiply\", operands: operands.map(toColumnExpression) };\n}\n\n/**\n * Add two or more operands.\n *\n * @param operands - Column names, literals, or nested expression nodes\n * @returns An add expression node\n */\nfunction add(...operands: ColumnExpressionInput[]): ArithmeticExpression {\n  return { __expr: \"add\", operands: operands.map(toColumnExpression) };\n}\n\n/**\n * Subtract `right` from `left`.\n *\n * @param left - The minuend\n * @param right - The subtrahend\n * @returns A subtract expression node\n */\nfunction sub(\n  left: ColumnExpressionInput,\n  right: ColumnExpressionInput,\n): ArithmeticExpression {\n  return {\n    __expr: \"subtract\",\n    operands: [toColumnExpression(left), toColumnExpression(right)],\n  };\n}\n\n/**\n * Divide `left` by `right`.\n *\n * @param left - The dividend\n * @param right - The divisor\n * @returns A divide expression node\n */\nfunction div(\n  left: ColumnExpressionInput,\n  right: ColumnExpressionInput,\n): ArithmeticExpression {\n  return {\n    __expr: \"divide\",\n    operands: [toColumnExpression(left), toColumnExpression(right)],\n  };\n}\n\n/**\n * Wrap a raw expression string as an escape hatch.\n *\n * The string is emitted verbatim — never build it from untrusted input. Use\n * this only when the typed `$expr.mul` / `$expr.add` / `$expr.sub` /\n * `$expr.div` / `$expr.col` / `$expr.lit` combinators can't express what you\n * need.\n *\n * @param expression - A raw, driver-native expression fragment\n * @returns A raw expression node\n */\nfunction raw(expression: string): RawColumnExpression {\n  return { __expr: \"raw\", expression };\n}\n\n/**\n * Normalize an expression input to a `ColumnExpression` node. A bare string\n * becomes a `$expr.col(...)` reference; an existing node passes through\n * unchanged.\n *\n * @param input - A typed expression node or a bare column-name string\n * @returns The corresponding `ColumnExpression` node\n */\nexport function toColumnExpression(input: ColumnExpressionInput): ColumnExpression {\n  return typeof input === \"string\" ? col(input) : input;\n}\n\n/**\n * Typed, database-agnostic column-expression builders.\n *\n * Grouped under one object (like `$agg`) so the scalar arithmetic that feeds\n * an aggregate reads as a single, discoverable namespace: `$agg.sum($expr.mul(\n * \"price\", \"quantity\"))`. Each builder returns a plain, closed `ColumnExpression`\n * node — the driver translates it to native SQL / a Mongo pipeline.\n *\n * @example\n * ```typescript\n * import { $agg, $expr } from \"@warlock.js/cascade\";\n *\n * // SUM(price * quantity)\n * query.groupBy(\"product_id\", { revenue: $agg.sum($expr.mul(\"price\", \"quantity\")) });\n *\n * // SUM((1 - discount) * price)\n * query.groupBy(\"product_id\", {\n *   net: $agg.sum($expr.mul($expr.sub($expr.lit(1), \"discount\"), \"price\")),\n * });\n *\n * // price * 1.2 (e.g. tax)\n * $agg.sum($expr.mul(\"price\", $expr.lit(1.2)));\n *\n * // escape hatch (Postgres-only, emitted verbatim — never from user input)\n * $agg.sum($expr.raw(\"price * quantity * (1 - discount)\"));\n * ```\n */\nexport const $expr = {\n  col,\n  lit,\n  mul,\n  add,\n  sub,\n  div,\n  raw,\n};\n"],"mappings":";;;;;;;AA0GA,SAAgB,mBAAmB,OAA2C;CAC5E,OACE,OAAO,UAAU,YACjB,UAAU,QACV,OAAQ,MAA2B,WAAW;AAElD;;;;;;;AAQA,SAAS,IAAI,QAAqC;CAChD,OAAO;EAAE,QAAQ;EAAU;CAAO;AACpC;;;;;;;AAQA,SAAS,IAAI,OAA4C;CACvD,OAAO;EAAE,QAAQ;EAAW;CAAM;AACpC;;;;;;;AAQA,SAAS,IAAI,GAAG,UAAyD;CACvE,OAAO;EAAE,QAAQ;EAAY,UAAU,SAAS,IAAI,kBAAkB;CAAE;AAC1E;;;;;;;AAQA,SAAS,IAAI,GAAG,UAAyD;CACvE,OAAO;EAAE,QAAQ;EAAO,UAAU,SAAS,IAAI,kBAAkB;CAAE;AACrE;;;;;;;;AASA,SAAS,IACP,MACA,OACsB;CACtB,OAAO;EACL,QAAQ;EACR,UAAU,CAAC,mBAAmB,IAAI,GAAG,mBAAmB,KAAK,CAAC;CAChE;AACF;;;;;;;;AASA,SAAS,IACP,MACA,OACsB;CACtB,OAAO;EACL,QAAQ;EACR,UAAU,CAAC,mBAAmB,IAAI,GAAG,mBAAmB,KAAK,CAAC;CAChE;AACF;;;;;;;;;;;;AAaA,SAAS,IAAI,YAAyC;CACpD,OAAO;EAAE,QAAQ;EAAO;CAAW;AACrC;;;;;;;;;AAUA,SAAgB,mBAAmB,OAAgD;CACjF,OAAO,OAAO,UAAU,WAAW,IAAI,KAAK,IAAI;AAClD;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,QAAQ;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}
+{"version":3,"file":"column-expressions.mjs","names":[],"sources":["../../../../../../../../packages/cascade/src/expressions/column-expressions.ts"],"sourcesContent":["/**\n * Database-agnostic, **typed** column expressions for aggregate inputs.\n *\n * These let `$agg.sum(...)` (and any future expression-accepting aggregate)\n * operate on a composed arithmetic expression — e.g. `price * quantity` — not\n * just a bare column, while staying portable across drivers.\n *\n * The builders are grouped under a single `$expr` object (mirroring `$agg`),\n * so the package root exposes exactly two expression namespaces — `$agg` for\n * aggregates and `$expr` for the scalar arithmetic that feeds them — rather\n * than a handful of collision-prone bare verbs (`mul`, `add`, `col`, …).\n *\n * The expression tree is a small, closed union of safe nodes:\n *\n * - `$expr.col(\"price\")` — a column reference (driver quotes/escapes it)\n * - `$expr.lit(2)` — a numeric/boolean literal\n * - `$expr.mul(a, b, …)` / `$expr.add(…)` / `$expr.sub(a, b)` / `$expr.div(a, b)` — arithmetic\n * - `$expr.raw(\"price * 1.2\")` — an explicit escape hatch for a raw SQL fragment\n *\n * Only `$expr.raw` ever embeds an uninterpreted string, and it is opt-in by\n * name. Everything else is composed from typed nodes, so user-supplied column\n * names flow through the driver's identifier-quoting path rather than being\n * string-interpolated into SQL. This is the boundary the S2 task calls out: a\n * tiny typed DSL for the common safe ops, plus a clearly-named raw escape\n * hatch for everything beyond it.\n *\n * Bare strings are still accepted everywhere a `ColumnExpression` is — a plain\n * string is treated as a column reference (`\"price\"` === `$expr.col(\"price\")`),\n * so the existing `$agg.sum(\"amount\")` call site keeps working unchanged.\n *\n * @example\n * ```typescript\n * import { $agg, $expr } from \"@warlock.js/cascade\";\n *\n * query.groupByDate(\"created_at\", \"month\", {\n *   revenue: $agg.sum($expr.mul(\"price\", \"quantity\")),\n * });\n * ```\n */\n\n/** Discriminator tag identifying a node in the column-expression tree. */\nexport type ColumnExpressionType =\n  | \"column\"\n  | \"literal\"\n  | \"add\"\n  | \"subtract\"\n  | \"multiply\"\n  | \"divide\"\n  | \"raw\";\n\n/**\n * A reference to a column/field. The driver is responsible for quoting the\n * name (SQL) or prefixing it with `$` (Mongo) — it is never interpolated raw.\n */\nexport type ColumnRefExpression = {\n  readonly __expr: \"column\";\n  readonly column: string;\n};\n\n/** A scalar literal value embedded directly in the expression. */\nexport type LiteralExpression = {\n  readonly __expr: \"literal\";\n  readonly value: number | boolean;\n};\n\n/**\n * An arithmetic operation over one or more operands.\n *\n * `add` / `multiply` are variadic; `subtract` / `divide` take exactly two\n * operands (left, right) since they are not associative.\n */\nexport type ArithmeticExpression = {\n  readonly __expr: \"add\" | \"subtract\" | \"multiply\" | \"divide\";\n  readonly operands: ColumnExpression[];\n};\n\n/**\n * A raw expression escape hatch. The string is emitted verbatim into the\n * generated SQL — callers MUST NOT build it from untrusted input. This is the\n * documented boundary for anything the typed nodes above don't cover.\n */\nexport type RawColumnExpression = {\n  readonly __expr: \"raw\";\n  readonly expression: string;\n};\n\n/**\n * Any node in the typed column-expression tree. A bare `string` is also a\n * valid expression input wherever this type is accepted — it is interpreted as\n * a column reference.\n */\nexport type ColumnExpression =\n  | ColumnRefExpression\n  | LiteralExpression\n  | ArithmeticExpression\n  | RawColumnExpression;\n\n/** Input accepted by expression-aware helpers: a typed node or a column-name string. */\nexport type ColumnExpressionInput = ColumnExpression | string;\n\n/**\n * Type guard: is `value` one of the typed column-expression nodes?\n *\n * @param value - The value to test\n * @returns `true` when `value` is a `ColumnExpression` node\n */\nexport function isColumnExpression(value: unknown): value is ColumnExpression {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    typeof (value as ColumnExpression).__expr === \"string\"\n  );\n}\n\n/**\n * Reference a column/field by name.\n *\n * @param column - The column/field name\n * @returns A column-reference expression node\n */\nfunction col(column: string): ColumnRefExpression {\n  return { __expr: \"column\", column };\n}\n\n/**\n * A scalar literal (number or boolean) operand.\n *\n * @param value - The literal value\n * @returns A literal expression node\n */\nfunction lit(value: number | boolean): LiteralExpression {\n  return { __expr: \"literal\", value };\n}\n\n/**\n * Multiply two or more operands.\n *\n * @param operands - Column names, literals, or nested expression nodes\n * @returns A multiply expression node\n */\nfunction mul(...operands: ColumnExpressionInput[]): ArithmeticExpression {\n  return { __expr: \"multiply\", operands: operands.map(toColumnExpression) };\n}\n\n/**\n * Add two or more operands.\n *\n * @param operands - Column names, literals, or nested expression nodes\n * @returns An add expression node\n */\nfunction add(...operands: ColumnExpressionInput[]): ArithmeticExpression {\n  return { __expr: \"add\", operands: operands.map(toColumnExpression) };\n}\n\n/**\n * Subtract `right` from `left`.\n *\n * @param left - The minuend\n * @param right - The subtrahend\n * @returns A subtract expression node\n */\nfunction sub(\n  left: ColumnExpressionInput,\n  right: ColumnExpressionInput,\n): ArithmeticExpression {\n  return {\n    __expr: \"subtract\",\n    operands: [toColumnExpression(left), toColumnExpression(right)],\n  };\n}\n\n/**\n * Divide `left` by `right`.\n *\n * @param left - The dividend\n * @param right - The divisor\n * @returns A divide expression node\n */\nfunction div(\n  left: ColumnExpressionInput,\n  right: ColumnExpressionInput,\n): ArithmeticExpression {\n  return {\n    __expr: \"divide\",\n    operands: [toColumnExpression(left), toColumnExpression(right)],\n  };\n}\n\n/**\n * Wrap a raw expression string as an escape hatch.\n *\n * The string is emitted verbatim — never build it from untrusted input. Use\n * this only when the typed `$expr.mul` / `$expr.add` / `$expr.sub` /\n * `$expr.div` / `$expr.col` / `$expr.lit` combinators can't express what you\n * need.\n *\n * @param expression - A raw, driver-native expression fragment\n * @returns A raw expression node\n */\nfunction raw(expression: string): RawColumnExpression {\n  return { __expr: \"raw\", expression };\n}\n\n/**\n * Normalize an expression input to a `ColumnExpression` node. A bare string\n * becomes a `$expr.col(...)` reference; an existing node passes through\n * unchanged.\n *\n * @param input - A typed expression node or a bare column-name string\n * @returns The corresponding `ColumnExpression` node\n */\nexport function toColumnExpression(input: ColumnExpressionInput): ColumnExpression {\n  return typeof input === \"string\" ? col(input) : input;\n}\n\n/**\n * Typed, database-agnostic column-expression builders.\n *\n * Grouped under one object (like `$agg`) so the scalar arithmetic that feeds\n * an aggregate reads as a single, discoverable namespace: `$agg.sum($expr.mul(\n * \"price\", \"quantity\"))`. Each builder returns a plain, closed `ColumnExpression`\n * node — the driver translates it to native SQL / a Mongo pipeline.\n *\n * @example\n * ```typescript\n * import { $agg, $expr } from \"@warlock.js/cascade\";\n *\n * // SUM(price * quantity)\n * query.groupBy(\"product_id\", { revenue: $agg.sum($expr.mul(\"price\", \"quantity\")) });\n *\n * // SUM((1 - discount) * price)\n * query.groupBy(\"product_id\", {\n *   net: $agg.sum($expr.mul($expr.sub($expr.lit(1), \"discount\"), \"price\")),\n * });\n *\n * // price * 1.2 (e.g. tax)\n * $agg.sum($expr.mul(\"price\", $expr.lit(1.2)));\n *\n * // escape hatch (Postgres-only, emitted verbatim — never from user input)\n * $agg.sum($expr.raw(\"price * quantity * (1 - discount)\"));\n * ```\n */\nexport const $expr = {\n  col,\n  lit,\n  mul,\n  add,\n  sub,\n  div,\n  raw,\n};\n"],"mappings":";;;;;;;AA0GA,SAAgB,mBAAmB,OAA2C;CAC5E,OACE,OAAO,UAAU,YACjB,UAAU,QACV,OAAQ,MAA2B,WAAW;AAElD;;;;;;;AAQA,SAAS,IAAI,QAAqC;CAChD,OAAO;EAAE,QAAQ;EAAU;CAAO;AACpC;;;;;;;AAQA,SAAS,IAAI,OAA4C;CACvD,OAAO;EAAE,QAAQ;EAAW;CAAM;AACpC;;;;;;;AAQA,SAAS,IAAI,GAAG,UAAyD;CACvE,OAAO;EAAE,QAAQ;EAAY,UAAU,SAAS,IAAI,kBAAkB;CAAE;AAC1E;;;;;;;AAQA,SAAS,IAAI,GAAG,UAAyD;CACvE,OAAO;EAAE,QAAQ;EAAO,UAAU,SAAS,IAAI,kBAAkB;CAAE;AACrE;;;;;;;;AASA,SAAS,IACP,MACA,OACsB;CACtB,OAAO;EACL,QAAQ;EACR,UAAU,CAAC,mBAAmB,IAAI,GAAG,mBAAmB,KAAK,CAAC;CAChE;AACF;;;;;;;;AASA,SAAS,IACP,MACA,OACsB;CACtB,OAAO;EACL,QAAQ;EACR,UAAU,CAAC,mBAAmB,IAAI,GAAG,mBAAmB,KAAK,CAAC;CAChE;AACF;;;;;;;;;;;;AAaA,SAAS,IAAI,YAAyC;CACpD,OAAO;EAAE,QAAQ;EAAO;CAAW;AACrC;;;;;;;;;AAUA,SAAgB,mBAAmB,OAAgD;CACjF,OAAO,OAAO,UAAU,WAAW,IAAI,KAAK,IAAI;AAClD;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAa,QAAQ;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}

package/esm/migration/column-builder.d.mts

@@ -1,6 +1,6 @@
 import { ColumnDefinition, ColumnType, ForeignKeyDefinition, VectorIndexOptions } from "../contracts/migration-driver.contract.mjs";
 
-//#region ../cascade/src/migration/column-builder.d.ts
+//#region ../../packages/cascade/src/migration/column-builder.d.ts
 /**
  * Reference to the Migration type to avoid circular imports.
  * The actual type is injected at runtime.

package/esm/migration/column-builder.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"column-builder.d.mts","names":[],"sources":["../../../../../../../cascade/src/migration/column-builder.ts"],"mappings":";;;;;AAKgD;;KAM3C,aAAA;EACH,eAAA,CAAgB,KAAA;IAAS,OAAA;IAAmB,MAAA;EAAA;EAC5C,sBAAA,CAAuB,EAAA,EAAI,oBAAA;EAC3B,qBAAA,EAAuB,MAAA,UAAgB,OAAA,EAAS,IAAA,CAAK,kBAAA;AAAA;;;;;;;;;;;;AAA6B;AAqCpF;;;;;;;;;;cAAa,aAAA;EAAA,iBAmBQ,SAAA;EAslBK;EAAA,iBAvmBP,UAAA;EAumBuB;EAAA,QApmBhC,YAAA;EAHS;EAAA,QAMT,mBAAA;EAAA;;;;;;;;cAWW,SAAA,EAAW,aAAA,EAC5B,IAAA,UACA,IAAA,EAAM,UAAA,EACN,OAAA,GAAS,OAAA,CACP,IAAA,CAAK,gBAAA;EAAA;;;;;;;;;;EAyBF,QAAA;EAuIA;;;;;;;EA3HA,WAAA;EAoOA;;;;;;;;;;;;;;;;;EA1MA,OAAA,CAAQ,KAAA;EA0WC;;;;;;;;;;;AAyKwB;;;;EA9fjC,aAAA,CAAc,KAAA;;;;;;;;;;;;;EAkBd,UAAA;;;;;;;;;;;;;EAiBA,kBAAA;;;;;;;;;;;;;EAqBA,MAAA;;;;;;;;;;;;;EAoBA,KAAA;;;;;;;;;;;;;;EAoBA,WAAA,CAAY,OAAA,GAAS,IAAA,CAAK,kBAAA;;;;;;;;;;;EAwB1B,OAAA;;;;;;;;;;;;;;EAkBA,aAAA;;;;;;;;;;;;;EAqBA,QAAA;;;;;;;;;;;;;;EAsBA,OAAA,CAAQ,IAAA;;;;;;;;EAgBR,KAAA,CAAM,UAAA,UAAoB,IAAA;;;;;;;;;;;;;;EAyB1B,KAAA,CAAM,UAAA;;;;;;;;;;;;;EAiBN,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCA,UAAA,CAAW,YAAA;IAAyB,KAAA;EAAA;;;;;;;;;;;;;;EA2BpC,EAAA,CAAG,MAAA;;;;;;;;;;;;;;EAoBH,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;;;;EAoBjB,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;;;EAmBjB,UAAA;;;;;;;;;;;;;;;;;;;;;EAgCA,MAAA;;;;EAsCA,MAAA;;;;;;;;;;;;;;;;;;;;;;;EA8BA,WAAA,CAAY,UAAA;;;;;;;;EAYZ,MAAA;;;;;;;;EAiBA,OAAA;;;;;;;;EAqBA,aAAA,IAAiB,gBAAA;AAAA"}
+{"version":3,"file":"column-builder.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/migration/column-builder.ts"],"mappings":";;;;;AAKgD;;KAM3C,aAAA;EACH,eAAA,CAAgB,KAAA;IAAS,OAAA;IAAmB,MAAA;EAAA;EAC5C,sBAAA,CAAuB,EAAA,EAAI,oBAAA;EAC3B,qBAAA,EAAuB,MAAA,UAAgB,OAAA,EAAS,IAAA,CAAK,kBAAA;AAAA;;;;;;;;;;;;AAA6B;AAqCpF;;;;;;;;;;cAAa,aAAA;EAAA,iBAmBQ,SAAA;EAslBK;EAAA,iBAvmBP,UAAA;EAumBuB;EAAA,QApmBhC,YAAA;EAHS;EAAA,QAMT,mBAAA;EAAA;;;;;;;;cAWW,SAAA,EAAW,aAAA,EAC5B,IAAA,UACA,IAAA,EAAM,UAAA,EACN,OAAA,GAAS,OAAA,CACP,IAAA,CAAK,gBAAA;EAAA;;;;;;;;;;EAyBF,QAAA;EAuIA;;;;;;;EA3HA,WAAA;EAoOA;;;;;;;;;;;;;;;;;EA1MA,OAAA,CAAQ,KAAA;EA0WC;;;;;;;;;;;AAyKwB;;;;EA9fjC,aAAA,CAAc,KAAA;;;;;;;;;;;;;EAkBd,UAAA;;;;;;;;;;;;;EAiBA,kBAAA;;;;;;;;;;;;;EAqBA,MAAA;;;;;;;;;;;;;EAoBA,KAAA;;;;;;;;;;;;;;EAoBA,WAAA,CAAY,OAAA,GAAS,IAAA,CAAK,kBAAA;;;;;;;;;;;EAwB1B,OAAA;;;;;;;;;;;;;;EAkBA,aAAA;;;;;;;;;;;;;EAqBA,QAAA;;;;;;;;;;;;;;EAsBA,OAAA,CAAQ,IAAA;;;;;;;;EAgBR,KAAA,CAAM,UAAA,UAAoB,IAAA;;;;;;;;;;;;;;EAyB1B,KAAA,CAAM,UAAA;;;;;;;;;;;;;EAiBN,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCA,UAAA,CAAW,YAAA;IAAyB,KAAA;EAAA;;;;;;;;;;;;;;EA2BpC,EAAA,CAAG,MAAA;;;;;;;;;;;;;;EAoBH,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;;;;EAoBjB,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;;;EAmBjB,UAAA;;;;;;;;;;;;;;;;;;;;;EAgCA,MAAA;;;;EAsCA,MAAA;;;;;;;;;;;;;;;;;;;;;;;EA8BA,WAAA,CAAY,UAAA;;;;;;;;EAYZ,MAAA;;;;;;;;EAiBA,OAAA;;;;;;;;EAqBA,aAAA,IAAiB,gBAAA;AAAA"}

package/esm/migration/column-builder.mjs

@@ -1,4 +1,4 @@
-//#region ../cascade/src/migration/column-builder.ts
+//#region ../../packages/cascade/src/migration/column-builder.ts
 /**
 * Fluent builder for defining column properties.
 *

package/esm/migration/column-builder.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"column-builder.mjs","names":[],"sources":["../../../../../../../cascade/src/migration/column-builder.ts"],"sourcesContent":["import type {\n  ColumnDefinition,\n  ColumnType,\n  ForeignKeyDefinition,\n  VectorIndexOptions,\n} from \"../contracts/migration-driver.contract\";\n\n/**\n * Reference to the Migration type to avoid circular imports.\n * The actual type is injected at runtime.\n */\ntype MigrationLike = {\n  addPendingIndex(index: { columns: string[]; unique?: boolean }): void;\n  addForeignKeyOperation(fk: ForeignKeyDefinition): void;\n  addPendingVectorIndex?(column: string, options: Omit<VectorIndexOptions, \"column\">): void;\n};\n\n/**\n * Mutable foreign key definition being built via ColumnBuilder.\n */\ninterface MutableForeignKeyDefinition {\n  name?: string;\n  column: string;\n  referencesTable: string;\n  referencesColumn: string;\n  onDelete: ForeignKeyDefinition[\"onDelete\"];\n  onUpdate: ForeignKeyDefinition[\"onUpdate\"];\n}\n\n/**\n * Fluent builder for defining column properties.\n *\n * Allows chaining modifiers like `.nullable()`, `.unique()`, `.default()`.\n * Each column builder is bound to a parent migration and accumulates\n * the column definition through method chains.\n *\n * @example\n * ```typescript\n * this.string(\"email\")\n *   .nullable()\n *   .unique()\n *   .default(\"guest@example.com\");\n * ```\n *\n * @example\n * ```typescript\n * this.integer(\"age\")\n *   .unsigned()\n *   .comment(\"User's age in years\");\n * ```\n */\nexport class ColumnBuilder {\n  /** Mutable column definition being accumulated */\n  private readonly definition: ColumnDefinition;\n\n  /** Mutable foreign key definition, set when .references() is called */\n  private fkDefinition?: MutableForeignKeyDefinition;\n\n  /** Temporary storage for generated expression before .stored() or .virtual() is called */\n  private generatedExpression?: string;\n\n  /**\n   * Create a new column builder.\n   *\n   * @param migration - Parent migration instance for index registration\n   * @param name - Column name\n   * @param type - Column data type\n   * @param options - Optional initial configuration\n   */\n  public constructor(\n    private readonly migration: MigrationLike,\n    name: string,\n    type: ColumnType,\n    options: Partial<\n      Pick<ColumnDefinition, \"length\" | \"precision\" | \"scale\" | \"dimensions\" | \"values\">\n    > = {},\n  ) {\n    this.definition = {\n      name,\n      type,\n      nullable: false,\n      ...options,\n    };\n  }\n\n  // ============================================================================\n  // NULLABILITY\n  // ============================================================================\n\n  /**\n   * Mark column as nullable (allows NULL values).\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"middleName\").nullable();\n   * ```\n   */\n  public nullable(): this {\n    this.definition.nullable = true;\n    return this;\n  }\n\n  /**\n   * Mark column as not nullable (disallows NULL values).\n   *\n   * This is the default, but can be used for clarity.\n   *\n   * @returns This builder for chaining\n   */\n  public notNullable(): this {\n    this.definition.nullable = false;\n    return this;\n  }\n\n  // ============================================================================\n  // DEFAULT VALUES\n  // ============================================================================\n\n  /**\n   * Set default value for the column as a raw SQL expression.\n   *\n   * The value will be used as-is in the SQL statement without escaping.\n   * Use this for database functions and expressions.\n   *\n   * @param value - Default value (SQL expression, number, or boolean)\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.uuid(\"id\").default(\"gen_random_uuid()\");\n   * this.timestamp(\"created_at\").default(\"NOW()\");\n   * this.integer(\"version\").default(1);\n   * this.boolean(\"is_active\").default(true);\n   * ```\n   */\n  public default(value: string | number | boolean): this {\n    this.definition.defaultValue = value;\n    this.definition.isRawDefault = true;\n    return this;\n  }\n\n  /**\n   * Set default value for the column as a literal string.\n   *\n   * The value will be properly escaped and quoted in the SQL statement.\n   * Use this for literal string values, not SQL expressions.\n   *\n   * @param value - Default string value (will be escaped)\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.text(\"status\").defaultString(\"active\");\n   * this.text(\"greeting\").defaultString(\"Hello, World!\");\n   * ```\n   */\n  public defaultString(value: string): this {\n    this.definition.defaultValue = value;\n    this.definition.isRawDefault = false;\n    return this;\n  }\n\n  /**\n   * Set default value to the current timestamp.\n   *\n   * Database-agnostic. Generates NOW() / CURRENT_TIMESTAMP / GETDATE() based on driver.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.timestamp(\"created_at\").useCurrent();\n   * ```\n   */\n  public useCurrent(): this {\n    this.definition.defaultValue = { __type: \"CURRENT_TIMESTAMP\" };\n    return this;\n  }\n\n  /**\n   * Set column to update to current timestamp on row update.\n   *\n   * MySQL only. Other databases ignore this.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.timestamp(\"updated_at\").useCurrent().useCurrentOnUpdate();\n   * ```\n   */\n  public useCurrentOnUpdate(): this {\n    this.definition.onUpdateCurrent = true;\n    return this;\n  }\n\n  // ============================================================================\n  // INDEXES\n  // ============================================================================\n\n  /**\n   * Add unique constraint/index on this column.\n   *\n   * Registers a pending unique index with the parent migration.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"email\").unique();\n   * ```\n   */\n  public unique(): this {\n    this.migration.addPendingIndex({\n      columns: [this.definition.name],\n      unique: true,\n    });\n    return this;\n  }\n\n  /**\n   * Add regular index on this column.\n   *\n   * Registers a pending index with the parent migration.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"email\").index();\n   * ```\n   */\n  public index(): this {\n    this.migration.addPendingIndex({\n      columns: [this.definition.name],\n    });\n    return this;\n  }\n\n  /**\n   * Add a vector search index on this column.\n   *\n   * Registers a pending vector index with the parent migration.\n   *\n   * @param options - Vector index options\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.vector(1536).vectorIndex({ similarity: \"cosine\" });\n   * ```\n   */\n  public vectorIndex(options: Omit<VectorIndexOptions, \"dimensions\"> = {}): this {\n    if (this.migration.addPendingVectorIndex) {\n      this.migration.addPendingVectorIndex(this.definition.name, {\n        ...options,\n        dimensions: this.definition.dimensions || 0,\n      });\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // PRIMARY KEY & AUTO INCREMENT\n  // ============================================================================\n\n  /**\n   * Mark as primary key.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"id\").primary();\n   * ```\n   */\n  public primary(): this {\n    this.definition.primary = true;\n    return this;\n  }\n\n  /**\n   * Mark as auto-increment (numeric types only).\n   *\n   * SQL databases will use native AUTO_INCREMENT/SERIAL.\n   * NoSQL databases ignore this.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"id\").primary().autoIncrement();\n   * ```\n   */\n  public autoIncrement(): this {\n    this.definition.autoIncrement = true;\n    return this;\n  }\n\n  // ============================================================================\n  // NUMERIC MODIFIERS\n  // ============================================================================\n\n  /**\n   * Mark as unsigned (numeric types only).\n   *\n   * Disallows negative values and doubles the positive range.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"age\").unsigned();\n   * ```\n   */\n  public unsigned(): this {\n    this.definition.unsigned = true;\n    return this;\n  }\n\n  // ============================================================================\n  // METADATA\n  // ============================================================================\n\n  /**\n   * Add comment/description to column.\n   *\n   * Stored as column metadata in the database.\n   *\n   * @param text - Comment text\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"sku\").comment(\"Stock Keeping Unit code\");\n   * ```\n   */\n  public comment(text: string): this {\n    this.definition.comment = text;\n    return this;\n  }\n\n  // ============================================================================\n  // CONSTRAINTS\n  // ============================================================================\n\n  /**\n   * Add a CHECK constraint scoped to this column.\n   *\n   * @param expression - SQL CHECK expression (can reference the column by name)\n   * @param name - Constraint name (defaults to `check_<column>`)\n   * @returns This builder for chaining\n   */\n  public check(expression: string, name?: string): this {\n    this.definition.checkConstraint = {\n      expression,\n      name: name ?? `check_${this.definition.name}`,\n    };\n    return this;\n  }\n\n  // ============================================================================\n  // COLUMN POSITIONING (MySQL/MariaDB only)\n  // ============================================================================\n\n  /**\n   * Position this column after another column.\n   *\n   * MySQL/MariaDB only. Ignored by PostgreSQL and NoSQL drivers.\n   *\n   * @param columnName - Column to position after\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"middle_name\").after(\"first_name\");\n   * ```\n   */\n  public after(columnName: string): this {\n    this.definition.after = columnName;\n    return this;\n  }\n\n  /**\n   * Position this column as the first column in the table.\n   *\n   * MySQL/MariaDB only. Ignored by PostgreSQL and NoSQL drivers.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"id\").primary().first();\n   * ```\n   */\n  public first(): this {\n    this.definition.first = true;\n    return this;\n  }\n\n  // ============================================================================\n  // FOREIGN KEY\n  // ============================================================================\n\n  /**\n   * Declare a foreign key constraint on this column.\n   *\n   * Accepts either a raw table-name string or a Model class (anything with a\n   * static `table` property). Using a Model class is preferred — it is\n   * type-safe and automatically tracks table renames.\n   *\n   * Pushes an `addForeignKey` operation immediately using a mutable reference —\n   * subsequent `.on()`, `.onDelete()`, `.onUpdate()` calls mutate the same\n   * definition that is already queued, so no `.add()` terminator is needed.\n   *\n   * Referenced column defaults to `\"id\"` — use `.on()` to override.\n   *\n   * @param tableOrModel - Referenced table name OR a Model class with a static `table` property\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * // Preferred — model class reference (type-safe, rename-proof)\n   * this.uuid(\"organization_id\").references(Organization).onDelete(\"cascade\");\n   *\n   * // Also supported — raw table string\n   * this.uuid(\"organization_id\").references(\"organizations\").onDelete(\"cascade\");\n   * this.uuid(\"organization_id\").references(Organization.table).onDelete(\"cascade\");\n   * ```\n   */\n  public references(tableOrModel: string | { table: string }): this {\n    const tableName = typeof tableOrModel === \"string\" ? tableOrModel : tableOrModel.table;\n\n    this.fkDefinition = {\n      column: this.definition.name,\n      referencesTable: tableName,\n      referencesColumn: \"id\",\n      onDelete: \"restrict\",\n      onUpdate: \"restrict\",\n    };\n    this.migration.addForeignKeyOperation(this.fkDefinition as ForeignKeyDefinition);\n    return this;\n  }\n\n  /**\n   * Set the referenced column for the foreign key.\n   *\n   * Only meaningful after `.references()`. Defaults to `\"id\"` if omitted.\n   *\n   * @param column - Referenced column name\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").on(\"custom_id\");\n   * ```\n   */\n  public on(column: string): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.referencesColumn = column;\n    }\n    return this;\n  }\n\n  /**\n   * Set the ON DELETE action for the foreign key.\n   *\n   * Only meaningful after `.references()`.\n   *\n   * @param action - Action when the referenced row is deleted\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").onDelete(\"cascade\");\n   * ```\n   */\n  public onDelete(action: ForeignKeyDefinition[\"onDelete\"]): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.onDelete = action;\n    }\n    return this;\n  }\n\n  /**\n   * Set the ON UPDATE action for the foreign key.\n   *\n   * Only meaningful after `.references()`.\n   *\n   * @param action - Action when the referenced row's key is updated\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").onUpdate(\"cascade\");\n   * ```\n   */\n  public onUpdate(action: ForeignKeyDefinition[\"onUpdate\"]): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.onUpdate = action;\n    }\n    return this;\n  }\n\n  /**\n   * Shorthand for `.onDelete(\"cascade\").onUpdate(\"cascade\")`.\n   *\n   * Only meaningful after `.references()`.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").cascadeAll();\n   * ```\n   */\n  public cascadeAll(): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.onDelete = \"cascade\";\n      this.fkDefinition.onUpdate = \"cascade\";\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // COLUMN MODIFICATION\n  // ============================================================================\n\n  /**\n   * Mark this column definition as a modification of an existing column.\n   *\n   * Pushes a `modifyColumn` operation instead of `addColumn`.\n   * This method breaks the builder chain and returns the parent migration.\n   *\n   * @returns The parent migration instance (breaks builder chain)\n   *\n   * @example\n   * ```typescript\n   * // Make email nullable\n   * this.string(\"email\").nullable().change();\n   *\n   * // Increase length\n   * this.string(\"name\", 255).change();\n   *\n   * // Change type\n   * this.text(\"description\").change();\n   * ```\n   */\n  public change(): unknown {\n    const operations = (this.migration as any).pendingOperations;\n\n    // Remove the addColumn pushed by the column type method (e.g. uuid(), string())\n    // (by identity, anywhere in the queue: .unique()/.index() may have pushed ops after it)\n    const addIndex = operations.findIndex(\n      (op: { type: string; payload: unknown }) =>\n        op.type === \"addColumn\" && op.payload === this.definition,\n    );\n    if (addIndex !== -1) {\n      operations.splice(addIndex, 1);\n    }\n\n    // If .references() was called before .change(), the addForeignKey op is now\n    // last in the queue. We must pop it, push modifyColumn first, then re-push\n    // the FK — because SQL requires: ALTER COLUMN (type change) → ADD CONSTRAINT (FK).\n    let pendingFkOp: (typeof operations)[number] | undefined;\n    if (this.fkDefinition) {\n      const tail = operations[operations.length - 1];\n      if (tail?.type === \"addForeignKey\" && tail.payload === this.fkDefinition) {\n        pendingFkOp = operations.pop();\n      }\n    }\n\n    // Push modifyColumn — it must precede the FK constraint\n    operations.push({ type: \"modifyColumn\", payload: this.definition });\n\n    // Re-queue the FK after the column modification\n    if (pendingFkOp) {\n      operations.push(pendingFkOp);\n    }\n\n    return this.migration;\n  }\n\n  /**\n   * @alias change\n   */\n  public modify(): unknown {\n    return this.change();\n  }\n\n  // ============================================================================\n  // GENERATED COLUMNS\n  // ============================================================================\n\n  /**\n   * Mark this column as a generated column with the given SQL expression.\n   *\n   * Must be followed by `.stored()` or `.virtual()` to specify storage type.\n   *\n   * PostgreSQL: GENERATED ALWAYS AS (...) STORED\n   * MySQL: GENERATED ALWAYS AS (...) STORED | VIRTUAL\n   *\n   * @param expression - SQL expression to compute the value\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"full_name\")\n   *   .generatedAs(\"CONCAT(first_name, ' ', last_name)\")\n   *   .stored();\n   *\n   * this.decimal(\"price_with_tax\")\n   *   .generatedAs(\"price * 1.2\")\n   *   .virtual();\n   * ```\n   */\n  public generatedAs(expression: string): this {\n    this.generatedExpression = expression;\n    return this;\n  }\n\n  /**\n   * Mark the generated column as stored (computed and persisted to disk).\n   *\n   * Must be called after `.generatedAs()`.\n   *\n   * @returns This builder for chaining\n   */\n  public stored(): this {\n    if (this.generatedExpression) {\n      this.definition.generated = {\n        expression: this.generatedExpression,\n        stored: true,\n      };\n    }\n    return this;\n  }\n\n  /**\n   * Mark the generated column as virtual (computed on read, not stored).\n   *\n   * Must be called after `.generatedAs()`. Not supported by PostgreSQL.\n   *\n   * @returns This builder for chaining\n   */\n  public virtual(): this {\n    if (this.generatedExpression) {\n      this.definition.generated = {\n        expression: this.generatedExpression,\n        stored: false,\n      };\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // ACCESSOR\n  // ============================================================================\n\n  /**\n   * Get the built column definition.\n   *\n   * Called internally by the Migration class to extract the final definition.\n   *\n   * @returns The accumulated column definition\n   */\n  public getDefinition(): ColumnDefinition {\n    return this.definition;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"column-builder.mjs","names":[],"sources":["../../../../../../../../packages/cascade/src/migration/column-builder.ts"],"sourcesContent":["import type {\n  ColumnDefinition,\n  ColumnType,\n  ForeignKeyDefinition,\n  VectorIndexOptions,\n} from \"../contracts/migration-driver.contract\";\n\n/**\n * Reference to the Migration type to avoid circular imports.\n * The actual type is injected at runtime.\n */\ntype MigrationLike = {\n  addPendingIndex(index: { columns: string[]; unique?: boolean }): void;\n  addForeignKeyOperation(fk: ForeignKeyDefinition): void;\n  addPendingVectorIndex?(column: string, options: Omit<VectorIndexOptions, \"column\">): void;\n};\n\n/**\n * Mutable foreign key definition being built via ColumnBuilder.\n */\ninterface MutableForeignKeyDefinition {\n  name?: string;\n  column: string;\n  referencesTable: string;\n  referencesColumn: string;\n  onDelete: ForeignKeyDefinition[\"onDelete\"];\n  onUpdate: ForeignKeyDefinition[\"onUpdate\"];\n}\n\n/**\n * Fluent builder for defining column properties.\n *\n * Allows chaining modifiers like `.nullable()`, `.unique()`, `.default()`.\n * Each column builder is bound to a parent migration and accumulates\n * the column definition through method chains.\n *\n * @example\n * ```typescript\n * this.string(\"email\")\n *   .nullable()\n *   .unique()\n *   .default(\"guest@example.com\");\n * ```\n *\n * @example\n * ```typescript\n * this.integer(\"age\")\n *   .unsigned()\n *   .comment(\"User's age in years\");\n * ```\n */\nexport class ColumnBuilder {\n  /** Mutable column definition being accumulated */\n  private readonly definition: ColumnDefinition;\n\n  /** Mutable foreign key definition, set when .references() is called */\n  private fkDefinition?: MutableForeignKeyDefinition;\n\n  /** Temporary storage for generated expression before .stored() or .virtual() is called */\n  private generatedExpression?: string;\n\n  /**\n   * Create a new column builder.\n   *\n   * @param migration - Parent migration instance for index registration\n   * @param name - Column name\n   * @param type - Column data type\n   * @param options - Optional initial configuration\n   */\n  public constructor(\n    private readonly migration: MigrationLike,\n    name: string,\n    type: ColumnType,\n    options: Partial<\n      Pick<ColumnDefinition, \"length\" | \"precision\" | \"scale\" | \"dimensions\" | \"values\">\n    > = {},\n  ) {\n    this.definition = {\n      name,\n      type,\n      nullable: false,\n      ...options,\n    };\n  }\n\n  // ============================================================================\n  // NULLABILITY\n  // ============================================================================\n\n  /**\n   * Mark column as nullable (allows NULL values).\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"middleName\").nullable();\n   * ```\n   */\n  public nullable(): this {\n    this.definition.nullable = true;\n    return this;\n  }\n\n  /**\n   * Mark column as not nullable (disallows NULL values).\n   *\n   * This is the default, but can be used for clarity.\n   *\n   * @returns This builder for chaining\n   */\n  public notNullable(): this {\n    this.definition.nullable = false;\n    return this;\n  }\n\n  // ============================================================================\n  // DEFAULT VALUES\n  // ============================================================================\n\n  /**\n   * Set default value for the column as a raw SQL expression.\n   *\n   * The value will be used as-is in the SQL statement without escaping.\n   * Use this for database functions and expressions.\n   *\n   * @param value - Default value (SQL expression, number, or boolean)\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.uuid(\"id\").default(\"gen_random_uuid()\");\n   * this.timestamp(\"created_at\").default(\"NOW()\");\n   * this.integer(\"version\").default(1);\n   * this.boolean(\"is_active\").default(true);\n   * ```\n   */\n  public default(value: string | number | boolean): this {\n    this.definition.defaultValue = value;\n    this.definition.isRawDefault = true;\n    return this;\n  }\n\n  /**\n   * Set default value for the column as a literal string.\n   *\n   * The value will be properly escaped and quoted in the SQL statement.\n   * Use this for literal string values, not SQL expressions.\n   *\n   * @param value - Default string value (will be escaped)\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.text(\"status\").defaultString(\"active\");\n   * this.text(\"greeting\").defaultString(\"Hello, World!\");\n   * ```\n   */\n  public defaultString(value: string): this {\n    this.definition.defaultValue = value;\n    this.definition.isRawDefault = false;\n    return this;\n  }\n\n  /**\n   * Set default value to the current timestamp.\n   *\n   * Database-agnostic. Generates NOW() / CURRENT_TIMESTAMP / GETDATE() based on driver.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.timestamp(\"created_at\").useCurrent();\n   * ```\n   */\n  public useCurrent(): this {\n    this.definition.defaultValue = { __type: \"CURRENT_TIMESTAMP\" };\n    return this;\n  }\n\n  /**\n   * Set column to update to current timestamp on row update.\n   *\n   * MySQL only. Other databases ignore this.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.timestamp(\"updated_at\").useCurrent().useCurrentOnUpdate();\n   * ```\n   */\n  public useCurrentOnUpdate(): this {\n    this.definition.onUpdateCurrent = true;\n    return this;\n  }\n\n  // ============================================================================\n  // INDEXES\n  // ============================================================================\n\n  /**\n   * Add unique constraint/index on this column.\n   *\n   * Registers a pending unique index with the parent migration.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"email\").unique();\n   * ```\n   */\n  public unique(): this {\n    this.migration.addPendingIndex({\n      columns: [this.definition.name],\n      unique: true,\n    });\n    return this;\n  }\n\n  /**\n   * Add regular index on this column.\n   *\n   * Registers a pending index with the parent migration.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"email\").index();\n   * ```\n   */\n  public index(): this {\n    this.migration.addPendingIndex({\n      columns: [this.definition.name],\n    });\n    return this;\n  }\n\n  /**\n   * Add a vector search index on this column.\n   *\n   * Registers a pending vector index with the parent migration.\n   *\n   * @param options - Vector index options\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.vector(1536).vectorIndex({ similarity: \"cosine\" });\n   * ```\n   */\n  public vectorIndex(options: Omit<VectorIndexOptions, \"dimensions\"> = {}): this {\n    if (this.migration.addPendingVectorIndex) {\n      this.migration.addPendingVectorIndex(this.definition.name, {\n        ...options,\n        dimensions: this.definition.dimensions || 0,\n      });\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // PRIMARY KEY & AUTO INCREMENT\n  // ============================================================================\n\n  /**\n   * Mark as primary key.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"id\").primary();\n   * ```\n   */\n  public primary(): this {\n    this.definition.primary = true;\n    return this;\n  }\n\n  /**\n   * Mark as auto-increment (numeric types only).\n   *\n   * SQL databases will use native AUTO_INCREMENT/SERIAL.\n   * NoSQL databases ignore this.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"id\").primary().autoIncrement();\n   * ```\n   */\n  public autoIncrement(): this {\n    this.definition.autoIncrement = true;\n    return this;\n  }\n\n  // ============================================================================\n  // NUMERIC MODIFIERS\n  // ============================================================================\n\n  /**\n   * Mark as unsigned (numeric types only).\n   *\n   * Disallows negative values and doubles the positive range.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"age\").unsigned();\n   * ```\n   */\n  public unsigned(): this {\n    this.definition.unsigned = true;\n    return this;\n  }\n\n  // ============================================================================\n  // METADATA\n  // ============================================================================\n\n  /**\n   * Add comment/description to column.\n   *\n   * Stored as column metadata in the database.\n   *\n   * @param text - Comment text\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"sku\").comment(\"Stock Keeping Unit code\");\n   * ```\n   */\n  public comment(text: string): this {\n    this.definition.comment = text;\n    return this;\n  }\n\n  // ============================================================================\n  // CONSTRAINTS\n  // ============================================================================\n\n  /**\n   * Add a CHECK constraint scoped to this column.\n   *\n   * @param expression - SQL CHECK expression (can reference the column by name)\n   * @param name - Constraint name (defaults to `check_<column>`)\n   * @returns This builder for chaining\n   */\n  public check(expression: string, name?: string): this {\n    this.definition.checkConstraint = {\n      expression,\n      name: name ?? `check_${this.definition.name}`,\n    };\n    return this;\n  }\n\n  // ============================================================================\n  // COLUMN POSITIONING (MySQL/MariaDB only)\n  // ============================================================================\n\n  /**\n   * Position this column after another column.\n   *\n   * MySQL/MariaDB only. Ignored by PostgreSQL and NoSQL drivers.\n   *\n   * @param columnName - Column to position after\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"middle_name\").after(\"first_name\");\n   * ```\n   */\n  public after(columnName: string): this {\n    this.definition.after = columnName;\n    return this;\n  }\n\n  /**\n   * Position this column as the first column in the table.\n   *\n   * MySQL/MariaDB only. Ignored by PostgreSQL and NoSQL drivers.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"id\").primary().first();\n   * ```\n   */\n  public first(): this {\n    this.definition.first = true;\n    return this;\n  }\n\n  // ============================================================================\n  // FOREIGN KEY\n  // ============================================================================\n\n  /**\n   * Declare a foreign key constraint on this column.\n   *\n   * Accepts either a raw table-name string or a Model class (anything with a\n   * static `table` property). Using a Model class is preferred — it is\n   * type-safe and automatically tracks table renames.\n   *\n   * Pushes an `addForeignKey` operation immediately using a mutable reference —\n   * subsequent `.on()`, `.onDelete()`, `.onUpdate()` calls mutate the same\n   * definition that is already queued, so no `.add()` terminator is needed.\n   *\n   * Referenced column defaults to `\"id\"` — use `.on()` to override.\n   *\n   * @param tableOrModel - Referenced table name OR a Model class with a static `table` property\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * // Preferred — model class reference (type-safe, rename-proof)\n   * this.uuid(\"organization_id\").references(Organization).onDelete(\"cascade\");\n   *\n   * // Also supported — raw table string\n   * this.uuid(\"organization_id\").references(\"organizations\").onDelete(\"cascade\");\n   * this.uuid(\"organization_id\").references(Organization.table).onDelete(\"cascade\");\n   * ```\n   */\n  public references(tableOrModel: string | { table: string }): this {\n    const tableName = typeof tableOrModel === \"string\" ? tableOrModel : tableOrModel.table;\n\n    this.fkDefinition = {\n      column: this.definition.name,\n      referencesTable: tableName,\n      referencesColumn: \"id\",\n      onDelete: \"restrict\",\n      onUpdate: \"restrict\",\n    };\n    this.migration.addForeignKeyOperation(this.fkDefinition as ForeignKeyDefinition);\n    return this;\n  }\n\n  /**\n   * Set the referenced column for the foreign key.\n   *\n   * Only meaningful after `.references()`. Defaults to `\"id\"` if omitted.\n   *\n   * @param column - Referenced column name\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").on(\"custom_id\");\n   * ```\n   */\n  public on(column: string): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.referencesColumn = column;\n    }\n    return this;\n  }\n\n  /**\n   * Set the ON DELETE action for the foreign key.\n   *\n   * Only meaningful after `.references()`.\n   *\n   * @param action - Action when the referenced row is deleted\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").onDelete(\"cascade\");\n   * ```\n   */\n  public onDelete(action: ForeignKeyDefinition[\"onDelete\"]): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.onDelete = action;\n    }\n    return this;\n  }\n\n  /**\n   * Set the ON UPDATE action for the foreign key.\n   *\n   * Only meaningful after `.references()`.\n   *\n   * @param action - Action when the referenced row's key is updated\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").onUpdate(\"cascade\");\n   * ```\n   */\n  public onUpdate(action: ForeignKeyDefinition[\"onUpdate\"]): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.onUpdate = action;\n    }\n    return this;\n  }\n\n  /**\n   * Shorthand for `.onDelete(\"cascade\").onUpdate(\"cascade\")`.\n   *\n   * Only meaningful after `.references()`.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").cascadeAll();\n   * ```\n   */\n  public cascadeAll(): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.onDelete = \"cascade\";\n      this.fkDefinition.onUpdate = \"cascade\";\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // COLUMN MODIFICATION\n  // ============================================================================\n\n  /**\n   * Mark this column definition as a modification of an existing column.\n   *\n   * Pushes a `modifyColumn` operation instead of `addColumn`.\n   * This method breaks the builder chain and returns the parent migration.\n   *\n   * @returns The parent migration instance (breaks builder chain)\n   *\n   * @example\n   * ```typescript\n   * // Make email nullable\n   * this.string(\"email\").nullable().change();\n   *\n   * // Increase length\n   * this.string(\"name\", 255).change();\n   *\n   * // Change type\n   * this.text(\"description\").change();\n   * ```\n   */\n  public change(): unknown {\n    const operations = (this.migration as any).pendingOperations;\n\n    // Remove the addColumn pushed by the column type method (e.g. uuid(), string())\n    // (by identity, anywhere in the queue: .unique()/.index() may have pushed ops after it)\n    const addIndex = operations.findIndex(\n      (op: { type: string; payload: unknown }) =>\n        op.type === \"addColumn\" && op.payload === this.definition,\n    );\n    if (addIndex !== -1) {\n      operations.splice(addIndex, 1);\n    }\n\n    // If .references() was called before .change(), the addForeignKey op is now\n    // last in the queue. We must pop it, push modifyColumn first, then re-push\n    // the FK — because SQL requires: ALTER COLUMN (type change) → ADD CONSTRAINT (FK).\n    let pendingFkOp: (typeof operations)[number] | undefined;\n    if (this.fkDefinition) {\n      const tail = operations[operations.length - 1];\n      if (tail?.type === \"addForeignKey\" && tail.payload === this.fkDefinition) {\n        pendingFkOp = operations.pop();\n      }\n    }\n\n    // Push modifyColumn — it must precede the FK constraint\n    operations.push({ type: \"modifyColumn\", payload: this.definition });\n\n    // Re-queue the FK after the column modification\n    if (pendingFkOp) {\n      operations.push(pendingFkOp);\n    }\n\n    return this.migration;\n  }\n\n  /**\n   * @alias change\n   */\n  public modify(): unknown {\n    return this.change();\n  }\n\n  // ============================================================================\n  // GENERATED COLUMNS\n  // ============================================================================\n\n  /**\n   * Mark this column as a generated column with the given SQL expression.\n   *\n   * Must be followed by `.stored()` or `.virtual()` to specify storage type.\n   *\n   * PostgreSQL: GENERATED ALWAYS AS (...) STORED\n   * MySQL: GENERATED ALWAYS AS (...) STORED | VIRTUAL\n   *\n   * @param expression - SQL expression to compute the value\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"full_name\")\n   *   .generatedAs(\"CONCAT(first_name, ' ', last_name)\")\n   *   .stored();\n   *\n   * this.decimal(\"price_with_tax\")\n   *   .generatedAs(\"price * 1.2\")\n   *   .virtual();\n   * ```\n   */\n  public generatedAs(expression: string): this {\n    this.generatedExpression = expression;\n    return this;\n  }\n\n  /**\n   * Mark the generated column as stored (computed and persisted to disk).\n   *\n   * Must be called after `.generatedAs()`.\n   *\n   * @returns This builder for chaining\n   */\n  public stored(): this {\n    if (this.generatedExpression) {\n      this.definition.generated = {\n        expression: this.generatedExpression,\n        stored: true,\n      };\n    }\n    return this;\n  }\n\n  /**\n   * Mark the generated column as virtual (computed on read, not stored).\n   *\n   * Must be called after `.generatedAs()`. Not supported by PostgreSQL.\n   *\n   * @returns This builder for chaining\n   */\n  public virtual(): this {\n    if (this.generatedExpression) {\n      this.definition.generated = {\n        expression: this.generatedExpression,\n        stored: false,\n      };\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // ACCESSOR\n  // ============================================================================\n\n  /**\n   * Get the built column definition.\n   *\n   * Called internally by the Migration class to extract the final definition.\n   *\n   * @returns The accumulated column definition\n   */\n  public getDefinition(): ColumnDefinition {\n    return this.definition;\n  }\n}\n"],"mappings":"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"}

package/esm/migration/column-helpers.d.mts

@@ -1,7 +1,7 @@
 import { VectorIndexOptions } from "../contracts/migration-driver.contract.mjs";
 import { ColumnBuilder } from "./column-builder.mjs";
 
-//#region ../cascade/src/migration/column-helpers.d.ts
+//#region ../../packages/cascade/src/migration/column-helpers.d.ts
 /**
  * A no-op migration sink used by standalone column helpers.
  *

package/esm/migration/column-helpers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"column-helpers.d.mts","names":[],"sources":["../../../../../../../cascade/src/migration/column-helpers.ts"],"mappings":"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"}
+{"version":3,"file":"column-helpers.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/migration/column-helpers.ts"],"mappings":"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"}

package/esm/migration/column-helpers.mjs

@@ -1,6 +1,6 @@
 import { ColumnBuilder } from "./column-builder.mjs";
 
-//#region ../cascade/src/migration/column-helpers.ts
+//#region ../../packages/cascade/src/migration/column-helpers.ts
 /**
 * A no-op migration sink used by standalone column helpers.
 *

package/esm/migration/column-helpers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"column-helpers.mjs","names":[],"sources":["../../../../../../../cascade/src/migration/column-helpers.ts"],"sourcesContent":["import { ColumnBuilder } from \"./column-builder\";\n\n/**\n * A no-op migration sink used by standalone column helpers.\n *\n * When column helpers are used in `Migration.create()` / `Migration.alter()`,\n * the builder is constructed without a real migration context. The actual\n * operations are dequeued from the ColumnBuilder's definition and replayed\n * onto the real migration instance at execution time.\n *\n * Index and FK operations queued on this sink are collected and transferred\n * to the real migration by the factory methods.\n */\nclass DetachedMigrationSink {\n  /** Pending indexes registered via .unique() / .index() on a helper column. */\n  public readonly pendingIndexes: { columns: string[]; unique?: boolean }[] = [];\n\n  /** Pending FK definitions registered via .references() on a helper column. */\n  public readonly pendingForeignKeys: object[] = [];\n\n  /** Pending Vector index definitions registered via .vectorIndex() on a helper column. */\n  public readonly pendingVectorIndexes: {\n    column: string;\n    options: import(\"../contracts/migration-driver.contract\").VectorIndexOptions;\n  }[] = [];\n\n  public addPendingIndex(index: { columns: string[]; unique?: boolean }): void {\n    this.pendingIndexes.push(index);\n  }\n\n  public addForeignKeyOperation(fk: object): void {\n    this.pendingForeignKeys.push(fk);\n  }\n\n  public addPendingVectorIndex(\n    column: string,\n    options: Omit<import(\"../contracts/migration-driver.contract\").VectorIndexOptions, \"column\">,\n  ): void {\n    this.pendingVectorIndexes.push({ column, options: options as any });\n  }\n}\n\n/**\n * A `ColumnBuilder` that carries its own detached sink so it can be\n * constructed outside of a migration class and later merged in.\n */\nexport class DetachedColumnBuilder extends ColumnBuilder {\n  public readonly sink: DetachedMigrationSink;\n\n  public constructor(\n    type: ConstructorParameters<typeof ColumnBuilder>[2],\n    name: string,\n    options: ConstructorParameters<typeof ColumnBuilder>[3] = {},\n  ) {\n    const sink = new DetachedMigrationSink();\n    super(sink as any, name, type, options);\n    this.sink = sink;\n  }\n}\n\n// ============================================================================\n// STRING HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: string / varchar.\n *\n * @example\n * ```typescript\n * import { Migration, string } from \"@warlock.js/cascade\";\n *\n * export default Migration.create(User, {\n *   username: string(50).unique(),\n * });\n * ```\n */\nexport function string(length = 255): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"string\", \"__placeholder__\", { length });\n}\n\n/**\n * Standalone column helper: fixed-length CHAR.\n *\n * @example\n * ```typescript\n * code: char(3) // CHAR(3)\n * ```\n */\nexport function char(length: number): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"char\", \"__placeholder__\", { length });\n}\n\n/**\n * Standalone column helper: TEXT (unlimited length).\n *\n * @example\n * ```typescript\n * import { Migration, text } from \"@warlock.js/cascade\";\n *\n * export default Migration.create(User, {\n *   bio: text().nullable(),\n * });\n * ```\n */\nexport function text(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"text\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: MEDIUMTEXT.\n */\nexport function mediumText(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"mediumText\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: LONGTEXT.\n */\nexport function longText(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"longText\", \"__placeholder__\");\n}\n\n// ============================================================================\n// NUMERIC HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: INTEGER.\n *\n * @example\n * ```typescript\n * age: integer().unsigned()\n * ```\n */\nexport function integer(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"integer\", \"__placeholder__\");\n}\n\n/** Alias for `integer()`. */\nexport const int = integer;\n\n/**\n * Standalone column helper: SMALLINT.\n */\nexport function smallInteger(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"smallInteger\", \"__placeholder__\");\n}\n\n/** Alias for `smallInteger()`. */\nexport const smallInt = smallInteger;\n\n/**\n * Standalone column helper: TINYINT.\n */\nexport function tinyInteger(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"tinyInteger\", \"__placeholder__\");\n}\n\n/** Alias for `tinyInteger()`. */\nexport const tinyInt = tinyInteger;\n\n/**\n * Standalone column helper: BIGINT.\n */\nexport function bigInteger(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"bigInteger\", \"__placeholder__\");\n}\n\n/** Alias for `bigInteger()`. */\nexport const bigInt = bigInteger;\n\n/**\n * Standalone column helper: FLOAT.\n */\nexport function float(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"float\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: DOUBLE.\n */\nexport function double(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"double\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: DECIMAL.\n *\n * @example\n * ```typescript\n * price: decimal(10, 2) // DECIMAL(10,2)\n * ```\n */\nexport function decimal(precision = 8, scale = 2): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"decimal\", \"__placeholder__\", { precision, scale });\n}\n\n// ============================================================================\n// BOOLEAN HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: BOOLEAN.\n *\n * Named `boolCol` to avoid collision with the TypeScript / JS `boolean` primitive.\n *\n * @example\n * ```typescript\n * is_active: boolCol().default(true)\n * ```\n */\nexport function boolCol(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"boolean\", \"__placeholder__\");\n}\n\n/** Alias for `boolCol()`. */\nexport { boolCol as bool };\n\n// ============================================================================\n// DATE / TIME HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: DATE.\n */\nexport function date(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"date\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: DATETIME.\n */\nexport function dateTime(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"dateTime\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: TIMESTAMP.\n *\n * @example\n * ```typescript\n * started_at: timestamp().default(\"NOW()\")\n * ```\n */\nexport function timestamp(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"timestamp\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: TIME.\n */\nexport function time(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"time\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: YEAR.\n */\nexport function year(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"year\", \"__placeholder__\");\n}\n\n// ============================================================================\n// JSON & BINARY HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: JSON.\n *\n * Named `jsonCol` to avoid collision with the TS/JSON built-in names.\n * Use `json()` is fine for most cases though — this alias exists for clarity.\n *\n * @example\n * ```typescript\n * metadata: json().nullable()\n * ```\n */\nexport function json(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"json\", \"__placeholder__\");\n}\n\n/**\n * Alias for `json()`. Named `objectCol` to avoid collision with TS `object` type.\n */\nexport function objectCol(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"json\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: BINARY / BLOB.\n */\nexport function binary(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"binary\", \"__placeholder__\");\n}\n\n/**\n * Alias for `binary()`. Named `blobCol` to avoid collision with the Web `Blob` API.\n */\nexport function blobCol(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"binary\", \"__placeholder__\");\n}\n\n// ============================================================================\n// IDENTIFIER HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: UUID.\n *\n * @example\n * ```typescript\n * import { Migration, uuid } from \"@warlock.js/cascade\";\n *\n * export default Migration.create(Chat, {\n *   organization_id: uuid().references(Organization).onDelete(\"cascade\"),\n * });\n * ```\n */\nexport function uuid(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"uuid\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: ULID.\n */\nexport function ulid(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"ulid\", \"__placeholder__\");\n}\n\n// ============================================================================\n// NETWORK HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: IP address.\n */\nexport function ipAddress(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"ipAddress\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: MAC address.\n */\nexport function macAddress(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"macAddress\", \"__placeholder__\");\n}\n\n// ============================================================================\n// SPATIAL HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: geo point.\n */\nexport function point(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"point\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: polygon.\n */\nexport function polygon(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"polygon\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: line string.\n */\nexport function lineString(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"lineString\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: generic geometry.\n */\nexport function geometry(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"geometry\", \"__placeholder__\");\n}\n\n// ============================================================================\n// AI / ML HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: vector (for AI embeddings).\n *\n * @param dimensions - Embedding size (e.g. 1536 for text-embedding-3-small)\n *\n * @example\n * ```typescript\n * embedding: vector(1536)\n * ```\n */\nexport function vector(dimensions: number): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"vector\", \"__placeholder__\", { dimensions });\n}\n\n// ============================================================================\n// ENUM & SET HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: ENUM.\n *\n * @example\n * ```typescript\n * status: enumCol([\"active\", \"inactive\", \"pending\"])\n * ```\n */\nexport function enumCol(values: string[]): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"enum\", \"__placeholder__\", { values });\n}\n\n/**\n * Standalone column helper: SET (multiple values).\n */\nexport function setCol(values: string[]): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"set\", \"__placeholder__\", { values });\n}\n\n// ============================================================================\n// POSTGRESQL ARRAY HELPERS\n// ============================================================================\n\n/** Standalone helper: INTEGER[] */\nexport function arrayInt(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayInt\", \"__placeholder__\");\n}\n\n/** Standalone helper: BIGINT[] */\nexport function arrayBigInt(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayBigInt\", \"__placeholder__\");\n}\n\n/** Standalone helper: REAL[] */\nexport function arrayFloat(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayFloat\", \"__placeholder__\");\n}\n\n/** Standalone helper: DECIMAL[] */\nexport function arrayDecimal(precision?: number, scale?: number): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayDecimal\", \"__placeholder__\", { precision, scale });\n}\n\n/** Standalone helper: BOOLEAN[] */\nexport function arrayBoolean(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayBoolean\", \"__placeholder__\");\n}\n\n/** Standalone helper: TEXT[] */\nexport function arrayText(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayText\", \"__placeholder__\");\n}\n\n/** Standalone helper: DATE[] */\nexport function arrayDate(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayDate\", \"__placeholder__\");\n}\n\n/** Standalone helper: TIMESTAMPTZ[] */\nexport function arrayTimestamp(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayTimestamp\", \"__placeholder__\");\n}\n\n/** Standalone helper: UUID[] */\nexport function arrayUuid(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayUuid\", \"__placeholder__\");\n}\n\n/** Standalone helper: JSONB[] */\nexport function arrayJson(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayJson\", \"__placeholder__\");\n}\n"],"mappings":"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"}
+{"version":3,"file":"column-helpers.mjs","names":[],"sources":["../../../../../../../../packages/cascade/src/migration/column-helpers.ts"],"sourcesContent":["import { ColumnBuilder } from \"./column-builder\";\n\n/**\n * A no-op migration sink used by standalone column helpers.\n *\n * When column helpers are used in `Migration.create()` / `Migration.alter()`,\n * the builder is constructed without a real migration context. The actual\n * operations are dequeued from the ColumnBuilder's definition and replayed\n * onto the real migration instance at execution time.\n *\n * Index and FK operations queued on this sink are collected and transferred\n * to the real migration by the factory methods.\n */\nclass DetachedMigrationSink {\n  /** Pending indexes registered via .unique() / .index() on a helper column. */\n  public readonly pendingIndexes: { columns: string[]; unique?: boolean }[] = [];\n\n  /** Pending FK definitions registered via .references() on a helper column. */\n  public readonly pendingForeignKeys: object[] = [];\n\n  /** Pending Vector index definitions registered via .vectorIndex() on a helper column. */\n  public readonly pendingVectorIndexes: {\n    column: string;\n    options: import(\"../contracts/migration-driver.contract\").VectorIndexOptions;\n  }[] = [];\n\n  public addPendingIndex(index: { columns: string[]; unique?: boolean }): void {\n    this.pendingIndexes.push(index);\n  }\n\n  public addForeignKeyOperation(fk: object): void {\n    this.pendingForeignKeys.push(fk);\n  }\n\n  public addPendingVectorIndex(\n    column: string,\n    options: Omit<import(\"../contracts/migration-driver.contract\").VectorIndexOptions, \"column\">,\n  ): void {\n    this.pendingVectorIndexes.push({ column, options: options as any });\n  }\n}\n\n/**\n * A `ColumnBuilder` that carries its own detached sink so it can be\n * constructed outside of a migration class and later merged in.\n */\nexport class DetachedColumnBuilder extends ColumnBuilder {\n  public readonly sink: DetachedMigrationSink;\n\n  public constructor(\n    type: ConstructorParameters<typeof ColumnBuilder>[2],\n    name: string,\n    options: ConstructorParameters<typeof ColumnBuilder>[3] = {},\n  ) {\n    const sink = new DetachedMigrationSink();\n    super(sink as any, name, type, options);\n    this.sink = sink;\n  }\n}\n\n// ============================================================================\n// STRING HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: string / varchar.\n *\n * @example\n * ```typescript\n * import { Migration, string } from \"@warlock.js/cascade\";\n *\n * export default Migration.create(User, {\n *   username: string(50).unique(),\n * });\n * ```\n */\nexport function string(length = 255): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"string\", \"__placeholder__\", { length });\n}\n\n/**\n * Standalone column helper: fixed-length CHAR.\n *\n * @example\n * ```typescript\n * code: char(3) // CHAR(3)\n * ```\n */\nexport function char(length: number): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"char\", \"__placeholder__\", { length });\n}\n\n/**\n * Standalone column helper: TEXT (unlimited length).\n *\n * @example\n * ```typescript\n * import { Migration, text } from \"@warlock.js/cascade\";\n *\n * export default Migration.create(User, {\n *   bio: text().nullable(),\n * });\n * ```\n */\nexport function text(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"text\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: MEDIUMTEXT.\n */\nexport function mediumText(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"mediumText\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: LONGTEXT.\n */\nexport function longText(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"longText\", \"__placeholder__\");\n}\n\n// ============================================================================\n// NUMERIC HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: INTEGER.\n *\n * @example\n * ```typescript\n * age: integer().unsigned()\n * ```\n */\nexport function integer(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"integer\", \"__placeholder__\");\n}\n\n/** Alias for `integer()`. */\nexport const int = integer;\n\n/**\n * Standalone column helper: SMALLINT.\n */\nexport function smallInteger(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"smallInteger\", \"__placeholder__\");\n}\n\n/** Alias for `smallInteger()`. */\nexport const smallInt = smallInteger;\n\n/**\n * Standalone column helper: TINYINT.\n */\nexport function tinyInteger(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"tinyInteger\", \"__placeholder__\");\n}\n\n/** Alias for `tinyInteger()`. */\nexport const tinyInt = tinyInteger;\n\n/**\n * Standalone column helper: BIGINT.\n */\nexport function bigInteger(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"bigInteger\", \"__placeholder__\");\n}\n\n/** Alias for `bigInteger()`. */\nexport const bigInt = bigInteger;\n\n/**\n * Standalone column helper: FLOAT.\n */\nexport function float(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"float\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: DOUBLE.\n */\nexport function double(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"double\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: DECIMAL.\n *\n * @example\n * ```typescript\n * price: decimal(10, 2) // DECIMAL(10,2)\n * ```\n */\nexport function decimal(precision = 8, scale = 2): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"decimal\", \"__placeholder__\", { precision, scale });\n}\n\n// ============================================================================\n// BOOLEAN HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: BOOLEAN.\n *\n * Named `boolCol` to avoid collision with the TypeScript / JS `boolean` primitive.\n *\n * @example\n * ```typescript\n * is_active: boolCol().default(true)\n * ```\n */\nexport function boolCol(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"boolean\", \"__placeholder__\");\n}\n\n/** Alias for `boolCol()`. */\nexport { boolCol as bool };\n\n// ============================================================================\n// DATE / TIME HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: DATE.\n */\nexport function date(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"date\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: DATETIME.\n */\nexport function dateTime(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"dateTime\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: TIMESTAMP.\n *\n * @example\n * ```typescript\n * started_at: timestamp().default(\"NOW()\")\n * ```\n */\nexport function timestamp(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"timestamp\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: TIME.\n */\nexport function time(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"time\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: YEAR.\n */\nexport function year(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"year\", \"__placeholder__\");\n}\n\n// ============================================================================\n// JSON & BINARY HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: JSON.\n *\n * Named `jsonCol` to avoid collision with the TS/JSON built-in names.\n * Use `json()` is fine for most cases though — this alias exists for clarity.\n *\n * @example\n * ```typescript\n * metadata: json().nullable()\n * ```\n */\nexport function json(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"json\", \"__placeholder__\");\n}\n\n/**\n * Alias for `json()`. Named `objectCol` to avoid collision with TS `object` type.\n */\nexport function objectCol(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"json\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: BINARY / BLOB.\n */\nexport function binary(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"binary\", \"__placeholder__\");\n}\n\n/**\n * Alias for `binary()`. Named `blobCol` to avoid collision with the Web `Blob` API.\n */\nexport function blobCol(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"binary\", \"__placeholder__\");\n}\n\n// ============================================================================\n// IDENTIFIER HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: UUID.\n *\n * @example\n * ```typescript\n * import { Migration, uuid } from \"@warlock.js/cascade\";\n *\n * export default Migration.create(Chat, {\n *   organization_id: uuid().references(Organization).onDelete(\"cascade\"),\n * });\n * ```\n */\nexport function uuid(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"uuid\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: ULID.\n */\nexport function ulid(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"ulid\", \"__placeholder__\");\n}\n\n// ============================================================================\n// NETWORK HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: IP address.\n */\nexport function ipAddress(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"ipAddress\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: MAC address.\n */\nexport function macAddress(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"macAddress\", \"__placeholder__\");\n}\n\n// ============================================================================\n// SPATIAL HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: geo point.\n */\nexport function point(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"point\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: polygon.\n */\nexport function polygon(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"polygon\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: line string.\n */\nexport function lineString(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"lineString\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: generic geometry.\n */\nexport function geometry(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"geometry\", \"__placeholder__\");\n}\n\n// ============================================================================\n// AI / ML HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: vector (for AI embeddings).\n *\n * @param dimensions - Embedding size (e.g. 1536 for text-embedding-3-small)\n *\n * @example\n * ```typescript\n * embedding: vector(1536)\n * ```\n */\nexport function vector(dimensions: number): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"vector\", \"__placeholder__\", { dimensions });\n}\n\n// ============================================================================\n// ENUM & SET HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: ENUM.\n *\n * @example\n * ```typescript\n * status: enumCol([\"active\", \"inactive\", \"pending\"])\n * ```\n */\nexport function enumCol(values: string[]): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"enum\", \"__placeholder__\", { values });\n}\n\n/**\n * Standalone column helper: SET (multiple values).\n */\nexport function setCol(values: string[]): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"set\", \"__placeholder__\", { values });\n}\n\n// ============================================================================\n// POSTGRESQL ARRAY HELPERS\n// ============================================================================\n\n/** Standalone helper: INTEGER[] */\nexport function arrayInt(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayInt\", \"__placeholder__\");\n}\n\n/** Standalone helper: BIGINT[] */\nexport function arrayBigInt(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayBigInt\", \"__placeholder__\");\n}\n\n/** Standalone helper: REAL[] */\nexport function arrayFloat(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayFloat\", \"__placeholder__\");\n}\n\n/** Standalone helper: DECIMAL[] */\nexport function arrayDecimal(precision?: number, scale?: number): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayDecimal\", \"__placeholder__\", { precision, scale });\n}\n\n/** Standalone helper: BOOLEAN[] */\nexport function arrayBoolean(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayBoolean\", \"__placeholder__\");\n}\n\n/** Standalone helper: TEXT[] */\nexport function arrayText(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayText\", \"__placeholder__\");\n}\n\n/** Standalone helper: DATE[] */\nexport function arrayDate(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayDate\", \"__placeholder__\");\n}\n\n/** Standalone helper: TIMESTAMPTZ[] */\nexport function arrayTimestamp(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayTimestamp\", \"__placeholder__\");\n}\n\n/** Standalone helper: UUID[] */\nexport function arrayUuid(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayUuid\", \"__placeholder__\");\n}\n\n/** Standalone helper: JSONB[] */\nexport function arrayJson(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayJson\", \"__placeholder__\");\n}\n"],"mappings":"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"}

package/esm/migration/foreign-key-builder.d.mts

@@ -1,6 +1,6 @@
 import { ForeignKeyDefinition } from "../contracts/migration-driver.contract.mjs";
 
-//#region ../cascade/src/migration/foreign-key-builder.d.ts
+//#region ../../packages/cascade/src/migration/foreign-key-builder.d.ts
 /**
  * Reference to the Migration type to avoid circular imports.
  */

package/esm/migration/foreign-key-builder.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"foreign-key-builder.d.mts","names":[],"sources":["../../../../../../../cascade/src/migration/foreign-key-builder.ts"],"mappings":";;;;;AAAmF;KAK9E,aAAA;EACH,sBAAA,CAAuB,EAAA,EAAI,oBAAoB;AAAA;;;;;AAAA;AAiCjD;;;;;;;;;;;;;cAAa,iBAAA;EAAA,iBAWQ,SAAA;EAkBP;EAAA,iBA3BK,UAAA;EAiDC;;;;;;cAxCC,SAAA,EAAW,aAAA,EAC5B,MAAA;EA6Ec;;;AAeC;;;EA3EV,IAAA,CAAK,IAAA;;;;;;;;;;;;;;;;;;EAsBL,UAAA,CAAW,KAAA,UAAe,MAAA;;;;;;;;;;;;;;EAoB1B,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;;;;EAkBjB,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;EAejB,UAAA;AAAA"}
+{"version":3,"file":"foreign-key-builder.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/migration/foreign-key-builder.ts"],"mappings":";;;;;AAAmF;KAK9E,aAAA;EACH,sBAAA,CAAuB,EAAA,EAAI,oBAAoB;AAAA;;;;;AAAA;AAiCjD;;;;;;;;;;;;;cAAa,iBAAA;EAAA,iBAWQ,SAAA;EAkBP;EAAA,iBA3BK,UAAA;EAiDC;;;;;;cAxCC,SAAA,EAAW,aAAA,EAC5B,MAAA;EA6Ec;;;AAeC;;;EA3EV,IAAA,CAAK,IAAA;;;;;;;;;;;;;;;;;;EAsBL,UAAA,CAAW,KAAA,UAAe,MAAA;;;;;;;;;;;;;;EAoB1B,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;;;;EAkBjB,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;EAejB,UAAA;AAAA"}

package/esm/migration/foreign-key-builder.mjs

@@ -1,4 +1,4 @@
-//#region ../cascade/src/migration/foreign-key-builder.ts
+//#region ../../packages/cascade/src/migration/foreign-key-builder.ts
 /**
 * Fluent builder for foreign key constraints.
 *

package/esm/migration/foreign-key-builder.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"foreign-key-builder.mjs","names":[],"sources":["../../../../../../../cascade/src/migration/foreign-key-builder.ts"],"sourcesContent":["import type { ForeignKeyDefinition } from \"../contracts/migration-driver.contract\";\n\n/**\n * Reference to the Migration type to avoid circular imports.\n */\ntype MigrationLike = {\n  addForeignKeyOperation(fk: ForeignKeyDefinition): void;\n};\n\n/**\n * Mutable foreign key definition being built.\n */\ninterface MutableForeignKeyDefinition {\n  name?: string;\n  column: string;\n  referencesTable: string;\n  referencesColumn: string;\n  onDelete: ForeignKeyDefinition[\"onDelete\"];\n  onUpdate: ForeignKeyDefinition[\"onUpdate\"];\n}\n\n/**\n * Fluent builder for foreign key constraints.\n *\n * Allows building foreign key definitions with a chainable API.\n * SQL-only feature; NoSQL drivers ignore foreign keys.\n *\n * The operation is pushed when `.references()` is called using a mutable\n * reference — subsequent `.onDelete()` / `.onUpdate()` calls mutate the\n * same definition already queued in pendingOperations.\n *\n * @example\n * ```typescript\n * this.foreign(\"user_id\")\n *   .references(\"users\", \"id\")\n *   .onDelete(\"cascade\")\n *   .onUpdate(\"cascade\");\n * ```\n */\nexport class ForeignKeyBuilder {\n  /** Mutable foreign key definition being accumulated */\n  private readonly definition: MutableForeignKeyDefinition;\n\n  /**\n   * Create a new foreign key builder.\n   *\n   * @param migration - Parent migration instance\n   * @param column - Local column name that will reference another table\n   */\n  public constructor(\n    private readonly migration: MigrationLike,\n    column: string,\n  ) {\n    this.definition = {\n      column,\n      referencesTable: \"\",\n      referencesColumn: \"id\",\n      onDelete: \"restrict\",\n      onUpdate: \"restrict\",\n    };\n  }\n\n  /**\n   * Set the constraint name.\n   *\n   * @param name - Constraint name (auto-generated if not provided)\n   * @returns This builder for chaining\n   */\n  public name(name: string): this {\n    this.definition.name = name;\n    return this;\n  }\n\n  /**\n   * Set the referenced table and column, and register the foreign key operation.\n   *\n   * Pushes the operation immediately using a mutable reference — any\n   * `.onDelete()` / `.onUpdate()` calls after this will mutate the same\n   * definition already queued in pendingOperations.\n   *\n   * @param table - Referenced table name\n   * @param column - Referenced column name (default: \"id\")\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\").references(\"users\", \"id\");\n   * this.foreign(\"category_id\").references(\"categories\"); // defaults to \"id\"\n   * ```\n   */\n  public references(table: string, column = \"id\"): this {\n    this.definition.referencesTable = table;\n    this.definition.referencesColumn = column;\n    this.migration.addForeignKeyOperation(this.definition as ForeignKeyDefinition);\n    return this;\n  }\n\n  /**\n   * Set the ON DELETE action.\n   *\n   * @param action - Action to take when referenced row is deleted\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\")\n   *   .references(\"users\")\n   *   .onDelete(\"cascade\"); // Delete child when parent is deleted\n   * ```\n   */\n  public onDelete(action: ForeignKeyDefinition[\"onDelete\"]): this {\n    this.definition.onDelete = action;\n    return this;\n  }\n\n  /**\n   * Set the ON UPDATE action.\n   *\n   * @param action - Action to take when referenced row's key is updated\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\")\n   *   .references(\"users\")\n   *   .onUpdate(\"cascade\"); // Update child when parent key changes\n   * ```\n   */\n  public onUpdate(action: ForeignKeyDefinition[\"onUpdate\"]): this {\n    this.definition.onUpdate = action;\n    return this;\n  }\n\n  /**\n   * Shorthand for `.onDelete(\"cascade\").onUpdate(\"cascade\")`.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\").references(\"users\").cascadeAll();\n   * ```\n   */\n  public cascadeAll(): this {\n    this.definition.onDelete = \"cascade\";\n    this.definition.onUpdate = \"cascade\";\n    return this;\n  }\n\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAuCA,IAAa,oBAAb,MAA+B;CAWV;;CATnB,AAAiB;;;;;;;CAQjB,AAAO,YACL,AAAiB,WACjB,QACA;EAFiB;EAGjB,KAAK,aAAa;GAChB;GACA,iBAAiB;GACjB,kBAAkB;GAClB,UAAU;GACV,UAAU;EACZ;CACF;;;;;;;CAQA,AAAO,KAAK,MAAoB;EAC9B,KAAK,WAAW,OAAO;EACvB,OAAO;CACT;;;;;;;;;;;;;;;;;;CAmBA,AAAO,WAAW,OAAe,SAAS,MAAY;EACpD,KAAK,WAAW,kBAAkB;EAClC,KAAK,WAAW,mBAAmB;EACnC,KAAK,UAAU,uBAAuB,KAAK,UAAkC;EAC7E,OAAO;CACT;;;;;;;;;;;;;;CAeA,AAAO,SAAS,QAAgD;EAC9D,KAAK,WAAW,WAAW;EAC3B,OAAO;CACT;;;;;;;;;;;;;;CAeA,AAAO,SAAS,QAAgD;EAC9D,KAAK,WAAW,WAAW;EAC3B,OAAO;CACT;;;;;;;;;;;CAYA,AAAO,aAAmB;EACxB,KAAK,WAAW,WAAW;EAC3B,KAAK,WAAW,WAAW;EAC3B,OAAO;CACT;AAEF"}
+{"version":3,"file":"foreign-key-builder.mjs","names":[],"sources":["../../../../../../../../packages/cascade/src/migration/foreign-key-builder.ts"],"sourcesContent":["import type { ForeignKeyDefinition } from \"../contracts/migration-driver.contract\";\n\n/**\n * Reference to the Migration type to avoid circular imports.\n */\ntype MigrationLike = {\n  addForeignKeyOperation(fk: ForeignKeyDefinition): void;\n};\n\n/**\n * Mutable foreign key definition being built.\n */\ninterface MutableForeignKeyDefinition {\n  name?: string;\n  column: string;\n  referencesTable: string;\n  referencesColumn: string;\n  onDelete: ForeignKeyDefinition[\"onDelete\"];\n  onUpdate: ForeignKeyDefinition[\"onUpdate\"];\n}\n\n/**\n * Fluent builder for foreign key constraints.\n *\n * Allows building foreign key definitions with a chainable API.\n * SQL-only feature; NoSQL drivers ignore foreign keys.\n *\n * The operation is pushed when `.references()` is called using a mutable\n * reference — subsequent `.onDelete()` / `.onUpdate()` calls mutate the\n * same definition already queued in pendingOperations.\n *\n * @example\n * ```typescript\n * this.foreign(\"user_id\")\n *   .references(\"users\", \"id\")\n *   .onDelete(\"cascade\")\n *   .onUpdate(\"cascade\");\n * ```\n */\nexport class ForeignKeyBuilder {\n  /** Mutable foreign key definition being accumulated */\n  private readonly definition: MutableForeignKeyDefinition;\n\n  /**\n   * Create a new foreign key builder.\n   *\n   * @param migration - Parent migration instance\n   * @param column - Local column name that will reference another table\n   */\n  public constructor(\n    private readonly migration: MigrationLike,\n    column: string,\n  ) {\n    this.definition = {\n      column,\n      referencesTable: \"\",\n      referencesColumn: \"id\",\n      onDelete: \"restrict\",\n      onUpdate: \"restrict\",\n    };\n  }\n\n  /**\n   * Set the constraint name.\n   *\n   * @param name - Constraint name (auto-generated if not provided)\n   * @returns This builder for chaining\n   */\n  public name(name: string): this {\n    this.definition.name = name;\n    return this;\n  }\n\n  /**\n   * Set the referenced table and column, and register the foreign key operation.\n   *\n   * Pushes the operation immediately using a mutable reference — any\n   * `.onDelete()` / `.onUpdate()` calls after this will mutate the same\n   * definition already queued in pendingOperations.\n   *\n   * @param table - Referenced table name\n   * @param column - Referenced column name (default: \"id\")\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\").references(\"users\", \"id\");\n   * this.foreign(\"category_id\").references(\"categories\"); // defaults to \"id\"\n   * ```\n   */\n  public references(table: string, column = \"id\"): this {\n    this.definition.referencesTable = table;\n    this.definition.referencesColumn = column;\n    this.migration.addForeignKeyOperation(this.definition as ForeignKeyDefinition);\n    return this;\n  }\n\n  /**\n   * Set the ON DELETE action.\n   *\n   * @param action - Action to take when referenced row is deleted\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\")\n   *   .references(\"users\")\n   *   .onDelete(\"cascade\"); // Delete child when parent is deleted\n   * ```\n   */\n  public onDelete(action: ForeignKeyDefinition[\"onDelete\"]): this {\n    this.definition.onDelete = action;\n    return this;\n  }\n\n  /**\n   * Set the ON UPDATE action.\n   *\n   * @param action - Action to take when referenced row's key is updated\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\")\n   *   .references(\"users\")\n   *   .onUpdate(\"cascade\"); // Update child when parent key changes\n   * ```\n   */\n  public onUpdate(action: ForeignKeyDefinition[\"onUpdate\"]): this {\n    this.definition.onUpdate = action;\n    return this;\n  }\n\n  /**\n   * Shorthand for `.onDelete(\"cascade\").onUpdate(\"cascade\")`.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\").references(\"users\").cascadeAll();\n   * ```\n   */\n  public cascadeAll(): this {\n    this.definition.onDelete = \"cascade\";\n    this.definition.onUpdate = \"cascade\";\n    return this;\n  }\n\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAuCA,IAAa,oBAAb,MAA+B;CAWV;;CATnB,AAAiB;;;;;;;CAQjB,AAAO,YACL,AAAiB,WACjB,QACA;EAFiB;EAGjB,KAAK,aAAa;GAChB;GACA,iBAAiB;GACjB,kBAAkB;GAClB,UAAU;GACV,UAAU;EACZ;CACF;;;;;;;CAQA,AAAO,KAAK,MAAoB;EAC9B,KAAK,WAAW,OAAO;EACvB,OAAO;CACT;;;;;;;;;;;;;;;;;;CAmBA,AAAO,WAAW,OAAe,SAAS,MAAY;EACpD,KAAK,WAAW,kBAAkB;EAClC,KAAK,WAAW,mBAAmB;EACnC,KAAK,UAAU,uBAAuB,KAAK,UAAkC;EAC7E,OAAO;CACT;;;;;;;;;;;;;;CAeA,AAAO,SAAS,QAAgD;EAC9D,KAAK,WAAW,WAAW;EAC3B,OAAO;CACT;;;;;;;;;;;;;;CAeA,AAAO,SAAS,QAAgD;EAC9D,KAAK,WAAW,WAAW;EAC3B,OAAO;CACT;;;;;;;;;;;CAYA,AAAO,aAAmB;EACxB,KAAK,WAAW,WAAW;EAC3B,KAAK,WAAW,WAAW;EAC3B,OAAO;CACT;AAEF"}

package/esm/migration/migration-order.mjs

@@ -1,6 +1,6 @@
 import { compareCreatedAt } from "./parse-created-at.mjs";
 
-//#region ../cascade/src/migration/migration-order.ts
+//#region ../../packages/cascade/src/migration/migration-order.ts
 /**
 * Comparator for applying migrations — oldest first.
 *

package/esm/migration/migration-order.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"migration-order.mjs","names":[],"sources":["../../../../../../../cascade/src/migration/migration-order.ts"],"sourcesContent":["import { compareCreatedAt } from \"./parse-created-at\";\nimport type { MigrationOrigin } from \"./migration\";\n\n/** The minimum shape ordering needs — the runner passes full migration classes. */\ntype Orderable = {\n  createdAt?: string;\n  migrationName: string;\n  order?: number;\n  origin?: MigrationOrigin;\n};\n\n/**\n * Comparator for applying migrations — oldest first.\n *\n * Priority:\n *   1. package origin before app origin\n *   2. `order` override (lower = earlier, default 0)\n *   3. `createdAt` timestamp (older = earlier)\n *   4. Alphabetical by migration name (last resort)\n */\nexport function sortMigrations(a: Orderable, b: Orderable): number {\n  const byOrigin = Number(a.origin === \"app\") - Number(b.origin === \"app\");\n\n  if (byOrigin !== 0) {\n    return byOrigin;\n  }\n\n  const byOrder = (a.order ?? 0) - (b.order ?? 0);\n\n  if (byOrder !== 0) {\n    return byOrder;\n  }\n\n  const byCreatedAt = compareCreatedAt(a.createdAt, b.createdAt);\n\n  if (byCreatedAt !== undefined) {\n    return byCreatedAt;\n  }\n\n  // Last resort: alphabetical\n  return a.migrationName.localeCompare(b.migrationName);\n}\n\n/**\n * Comparator for rolling migrations back — newest first, the exact inverse of\n * {@link sortMigrations}.\n *\n * A rollback has to undo migrations in the reverse of the order they were\n * applied, or a `down()` will hit schema its predecessor already removed —\n * dropping a table before dropping the column that was added to it.\n *\n * This must be an explicit descending sort rather than a `.reverse()` of the\n * executed list: that list is read back ordered by `batch, name`, so it is\n * alphabetical rather than chronological, and reversing it merely produces\n * reverse-alphabetical order.\n */\nexport function sortMigrationsForRollback(a: Orderable, b: Orderable): number {\n  return sortMigrations(b, a);\n}\n"],"mappings":";;;;;;;;;;;;AAoBA,SAAgB,eAAe,GAAc,GAAsB;CACjE,MAAM,WAAW,OAAO,EAAE,WAAW,KAAK,IAAI,OAAO,EAAE,WAAW,KAAK;CAEvE,IAAI,aAAa,GACf,OAAO;CAGT,MAAM,WAAW,EAAE,SAAS,MAAM,EAAE,SAAS;CAE7C,IAAI,YAAY,GACd,OAAO;CAGT,MAAM,cAAc,iBAAiB,EAAE,WAAW,EAAE,SAAS;CAE7D,IAAI,gBAAgB,QAClB,OAAO;CAIT,OAAO,EAAE,cAAc,cAAc,EAAE,aAAa;AACtD;;;;;;;;;;;;;;AAeA,SAAgB,0BAA0B,GAAc,GAAsB;CAC5E,OAAO,eAAe,GAAG,CAAC;AAC5B"}
+{"version":3,"file":"migration-order.mjs","names":[],"sources":["../../../../../../../../packages/cascade/src/migration/migration-order.ts"],"sourcesContent":["import { compareCreatedAt } from \"./parse-created-at\";\nimport type { MigrationOrigin } from \"./migration\";\n\n/** The minimum shape ordering needs — the runner passes full migration classes. */\ntype Orderable = {\n  createdAt?: string;\n  migrationName: string;\n  order?: number;\n  origin?: MigrationOrigin;\n};\n\n/**\n * Comparator for applying migrations — oldest first.\n *\n * Priority:\n *   1. package origin before app origin\n *   2. `order` override (lower = earlier, default 0)\n *   3. `createdAt` timestamp (older = earlier)\n *   4. Alphabetical by migration name (last resort)\n */\nexport function sortMigrations(a: Orderable, b: Orderable): number {\n  const byOrigin = Number(a.origin === \"app\") - Number(b.origin === \"app\");\n\n  if (byOrigin !== 0) {\n    return byOrigin;\n  }\n\n  const byOrder = (a.order ?? 0) - (b.order ?? 0);\n\n  if (byOrder !== 0) {\n    return byOrder;\n  }\n\n  const byCreatedAt = compareCreatedAt(a.createdAt, b.createdAt);\n\n  if (byCreatedAt !== undefined) {\n    return byCreatedAt;\n  }\n\n  // Last resort: alphabetical\n  return a.migrationName.localeCompare(b.migrationName);\n}\n\n/**\n * Comparator for rolling migrations back — newest first, the exact inverse of\n * {@link sortMigrations}.\n *\n * A rollback has to undo migrations in the reverse of the order they were\n * applied, or a `down()` will hit schema its predecessor already removed —\n * dropping a table before dropping the column that was added to it.\n *\n * This must be an explicit descending sort rather than a `.reverse()` of the\n * executed list: that list is read back ordered by `batch, name`, so it is\n * alphabetical rather than chronological, and reversing it merely produces\n * reverse-alphabetical order.\n */\nexport function sortMigrationsForRollback(a: Orderable, b: Orderable): number {\n  return sortMigrations(b, a);\n}\n"],"mappings":";;;;;;;;;;;;AAoBA,SAAgB,eAAe,GAAc,GAAsB;CACjE,MAAM,WAAW,OAAO,EAAE,WAAW,KAAK,IAAI,OAAO,EAAE,WAAW,KAAK;CAEvE,IAAI,aAAa,GACf,OAAO;CAGT,MAAM,WAAW,EAAE,SAAS,MAAM,EAAE,SAAS;CAE7C,IAAI,YAAY,GACd,OAAO;CAGT,MAAM,cAAc,iBAAiB,EAAE,WAAW,EAAE,SAAS;CAE7D,IAAI,gBAAgB,QAClB,OAAO;CAIT,OAAO,EAAE,cAAc,cAAc,EAAE,aAAa;AACtD;;;;;;;;;;;;;;AAeA,SAAgB,0BAA0B,GAAc,GAAsB;CAC5E,OAAO,eAAe,GAAG,CAAC;AAC5B"}

package/esm/migration/migration-runner.d.mts

@@ -2,7 +2,7 @@ import { Migration, MigrationContract, MigrationOrigin } from "./migration.mjs";
 import { DataSource } from "../data-source/data-source.mjs";
 import { MigrationRecord, MigrationResult } from "./types.mjs";
 
-//#region ../cascade/src/migration/migration-runner.d.ts
+//#region ../../packages/cascade/src/migration/migration-runner.d.ts
 /**
  * Migration class type with static name property.
  */

package/esm/migration/migration-runner.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"migration-runner.d.mts","names":[],"sources":["../../../../../../../cascade/src/migration/migration-runner.ts"],"mappings":";;;;;;;AAgB2E;KAKtE,cAAA,cAA4B,SAAA;EAC/B,aAAA;EACA,SAAA;EACA,MAAA,GAAS,eAAe;AAAA;;;;;AAAA;AAAA;;;;;;;;;;AAsBA;KAHrB,qBAAA,cAAmC,iBAAA;EACtC,aAAA;EACA,SAAA;EACA,MAAA,GAAS,eAAe;AAAA;;;;KA0BrB,cAAA;EA8CW,uDA5CL,MAAA;WAEA,MAAA;EA0CoC;AAwC/C;;;EAxC+C,SArCpC,YAAA;AAAA;;;;;;iBAqCK,kBAAA,CAAmB,IAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwClC,eAAA;EAWM;EAAA,SATD,UAAA,EAAY,cAAA;;UAGpB,UAAA;EAkBS;EAAA,iBAfA,gBAAA;EAiBb;EAAA,iBAda,eAAA;EA6BV;EAAA,iBA1BU,OAAA;EA0BI;;;;;cAlBnB,OAAA;IACE,UAAA,GAAa,UAAA;IACb,eAAA;IACA,OAAA;EAAA;EA+IU;;;EAhIP,aAAA,CAAc,UAAA,EAAY,UAAA;EA2O8B;;;EAAA,QAlOvD,aAAA;EAuQY;;;EAAA,QA7PZ,kBAAA;EAqSU;;;;EAAA,QAtRV,iBAAA;EAwRG;EAAA,QAjRH,QAAA;EAqSU;EAAA,QAhSV,UAAA;EAiSG;;;;;;;EAAA,QAlRH,oBAAA;EA6SmD;EAAA,QArRnD,WAAA;EAohBK;EAAA,QAjhBC,YAAA;EAkhBsB;;;;EAAA,QAxgBtB,QAAA;EA4mBY;EAAA,QA9kBZ,WAAA;EA8kBmD;;;;;;;;;;;;;;;EAne1D,QAAA,CAAS,cAAA,EAAgB,qBAAA,EAAuB,MAAA,GAAQ,eAAA;EAojBb;;;;;;EA/gB3C,YAAA,CAAa,UAAA,EAAY,qBAAA;EAgiB5B;;;EAthBG,KAAA;EAqwBC;;;EA7vBD,kBAAA;EAs0BL;;;;;;;;;;;;;EAjzBW,GAAA,CACX,cAAA,EAAgB,cAAA,EAChB,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;EAq8BqB;AAAA;AAUlC;;;;AAAoD;;;;;;EA57BrC,QAAA,CACX,cAAA,EAAgB,cAAA,EAChB,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;;;;;;;;;;;;;;;;EA0BE,MAAA,CAAO,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;EAAA,QAS7C,cAAA;;;;;EAsPD,SAAA,CACX,OAAA;IAAW,WAAA;IAAuB,OAAA;EAAA,IACjC,OAAA;;;;;;;EAmGU,YAAA,CAAa,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;;;;;EAWpD,eAAA,CACX,OAAA,UACA,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;EAAA,QAMG,uBAAA;;;;;;;EAkDD,WAAA,CAAY,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;;;;EAWnD,KAAA,CAAM,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;EAa7C,MAAA,IAAU,OAAA,CACrB,KAAA;IACE,IAAA;IACA,KAAA;IACA,QAAA;IACA,KAAA;EAAA;;;;;;;;;;;;UAsCU,wBAAA;;;;UA2CA,YAAA;;;;;;;;;UA6JN,uBAAA;;;;;;;;;;;;;;;;;;;UA0BA,kBAAA;;;;;;;;;;;;;EA8CK,oBAAA,CACX,OAAA;IAAW,QAAA;EAAA,IACV,OAAA,CAAQ,cAAA;;;;;;;;;;;;;;;UA6BG,uBAAA;;;;EA6DD,qBAAA,CACX,UAAA,GAAY,UAAA,EACZ,OAAA;IAAW,QAAA;EAAA,IACV,OAAA,CAAQ,eAAA;;;;UAuBG,eAAA;;;;UAuBA,qBAAA;;;;UAWA,kBAAA;AAAA;AAAA,cAUH,eAAA,EAAe,eAAwB"}
+{"version":3,"file":"migration-runner.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/migration/migration-runner.ts"],"mappings":";;;;;;;AAgB2E;KAKtE,cAAA,cAA4B,SAAA;EAC/B,aAAA;EACA,SAAA;EACA,MAAA,GAAS,eAAe;AAAA;;;;;AAAA;AAAA;;;;;;;;;;AAsBA;KAHrB,qBAAA,cAAmC,iBAAA;EACtC,aAAA;EACA,SAAA;EACA,MAAA,GAAS,eAAe;AAAA;;;;KA0BrB,cAAA;EA8CW,uDA5CL,MAAA;WAEA,MAAA;EA0CoC;AAwC/C;;;EAxC+C,SArCpC,YAAA;AAAA;;;;;;iBAqCK,kBAAA,CAAmB,IAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwClC,eAAA;EAWM;EAAA,SATD,UAAA,EAAY,cAAA;;UAGpB,UAAA;EAkBS;EAAA,iBAfA,gBAAA;EAiBb;EAAA,iBAda,eAAA;EA6BV;EAAA,iBA1BU,OAAA;EA0BI;;;;;cAlBnB,OAAA;IACE,UAAA,GAAa,UAAA;IACb,eAAA;IACA,OAAA;EAAA;EA+IU;;;EAhIP,aAAA,CAAc,UAAA,EAAY,UAAA;EA2O8B;;;EAAA,QAlOvD,aAAA;EAuQY;;;EAAA,QA7PZ,kBAAA;EAqSU;;;;EAAA,QAtRV,iBAAA;EAwRG;EAAA,QAjRH,QAAA;EAqSU;EAAA,QAhSV,UAAA;EAiSG;;;;;;;EAAA,QAlRH,oBAAA;EA6SmD;EAAA,QArRnD,WAAA;EAohBK;EAAA,QAjhBC,YAAA;EAkhBsB;;;;EAAA,QAxgBtB,QAAA;EA4mBY;EAAA,QA9kBZ,WAAA;EA8kBmD;;;;;;;;;;;;;;;EAne1D,QAAA,CAAS,cAAA,EAAgB,qBAAA,EAAuB,MAAA,GAAQ,eAAA;EAojBb;;;;;;EA/gB3C,YAAA,CAAa,UAAA,EAAY,qBAAA;EAgiB5B;;;EAthBG,KAAA;EAqwBC;;;EA7vBD,kBAAA;EAs0BL;;;;;;;;;;;;;EAjzBW,GAAA,CACX,cAAA,EAAgB,cAAA,EAChB,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;EAq8BqB;AAAA;AAUlC;;;;AAAoD;;;;;;EA57BrC,QAAA,CACX,cAAA,EAAgB,cAAA,EAChB,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;;;;;;;;;;;;;;;;EA0BE,MAAA,CAAO,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;EAAA,QAS7C,cAAA;;;;;EAsPD,SAAA,CACX,OAAA;IAAW,WAAA;IAAuB,OAAA;EAAA,IACjC,OAAA;;;;;;;EAmGU,YAAA,CAAa,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;;;;;EAWpD,eAAA,CACX,OAAA,UACA,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;EAAA,QAMG,uBAAA;;;;;;;EAkDD,WAAA,CAAY,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;;;;EAWnD,KAAA,CAAM,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;EAa7C,MAAA,IAAU,OAAA,CACrB,KAAA;IACE,IAAA;IACA,KAAA;IACA,QAAA;IACA,KAAA;EAAA;;;;;;;;;;;;UAsCU,wBAAA;;;;UA2CA,YAAA;;;;;;;;;UA6JN,uBAAA;;;;;;;;;;;;;;;;;;;UA0BA,kBAAA;;;;;;;;;;;;;EA8CK,oBAAA,CACX,OAAA;IAAW,QAAA;EAAA,IACV,OAAA,CAAQ,cAAA;;;;;;;;;;;;;;;UA6BG,uBAAA;;;;EA6DD,qBAAA,CACX,UAAA,GAAY,UAAA,EACZ,OAAA;IAAW,QAAA;EAAA,IACV,OAAA,CAAQ,eAAA;;;;UAuBG,eAAA;;;;UAuBA,qBAAA;;;;UAWA,kBAAA;AAAA;AAAA,cAUH,eAAA,EAAe,eAAwB"}

package/esm/migration/migration-runner.mjs

@@ -7,7 +7,7 @@ import { colors } from "@mongez/copper";
 import fs from "fs";
 import path from "path";
 
-//#region ../cascade/src/migration/migration-runner.ts
+//#region ../../packages/cascade/src/migration/migration-runner.ts
 /** Name of the lock document Mongo migrations claim inside the migrations collection. */
 const MIGRATION_LOCK_NAME = "__warlock_migration_lock__";
 const MIGRATION_LOCK_KEY = "warlock:migrations";