@warlock.js/cascade 5.30.0 → 5.32.0

package/esm/model/register-model.d.mts

@@ -1,7 +1,6 @@
 import { ChildModel, ModelSchema } from "./model.types.mjs";
 import { Model } from "./model.mjs";
 import { Lazy } from "@mongez/reinforcements";
-
 //#region ../../packages/cascade/src/model/register-model.d.ts
 /**
  * Any way a relation target can be expressed: a string name registered
@@ -15,11 +14,11 @@ import { Lazy } from "@mongez/reinforcements";
  * class to `ChildModel<Model>` internally; the user's `lazy(() => X)`
  * call already guarantees the shape at the source.
  */
-type ModelRef = ChildModel<Model> | string | Lazy<unknown>;
+export type ModelRef = ChildModel<Model> | string | Lazy<unknown>;
 /**
  * Options for the RegisterModel decorator
  */
-type RegisterModelOptions = {
+export type RegisterModelOptions = {
   /**
    * Custom name for the model in the global registry.
    * If not provided, uses the class name.
@@ -61,8 +60,8 @@ type RegisterModelOptions = {
  * const UserModel = getModelFromRegistry("User");
  * ```
  */
-declare function RegisterModel(options?: RegisterModelOptions): <T extends ChildModel<Model>>(value: T, context: ClassDecoratorContext<T>) => T;
-declare function registerModelInRegistry(name: string, model: ChildModel<Model>): void;
+export declare function RegisterModel(options?: RegisterModelOptions): <T extends ChildModel<Model>>(value: T, context: ClassDecoratorContext<T>) => T;
+export declare function registerModelInRegistry(name: string, model: ChildModel<Model>): void;
 /**
  * Get a model class by its name from the global registry.
  *
@@ -77,7 +76,7 @@ declare function registerModelInRegistry(name: string, model: ChildModel<Model>)
  * }
  * ```
  */
-declare function getModelFromRegistry(name: string): ChildModel<Model<ModelSchema>> | undefined;
+export declare function getModelFromRegistry(name: string): ChildModel<Model<ModelSchema>> | undefined;
 /**
  * Get all registered models from the global registry.
  *
@@ -91,25 +90,25 @@ declare function getModelFromRegistry(name: string): ChildModel<Model<ModelSchem
  * }
  * ```
  */
-declare function getAllModelsFromRegistry(): Map<string, ChildModel<Model<ModelSchema>>>;
+export declare function getAllModelsFromRegistry(): Map<string, ChildModel<Model<ModelSchema>>>;
 /**
  * Clean up all models from register
  */
-declare function cleanupModelsRegistery(): void;
-declare function removeModelFromRegistery(name: string): void;
-declare function resolveModelClass(model: ModelRef): ChildModel<Model>;
+export declare function cleanupModelsRegistery(): void;
+export declare function removeModelFromRegistery(name: string): void;
+export declare function resolveModelClass(model: ModelRef): ChildModel<Model>;
 /**
  * Like `resolveModelClass`, but throws a descriptive error when a string
  * ref isn't registered instead of returning `undefined`.
  */
-declare function requireModelClass(model: ModelRef): ChildModel<Model>;
+export declare function requireModelClass(model: ModelRef): ChildModel<Model>;
 /**
  * Like `resolveModelClass`, but returns `undefined` instead of asserting
  * a non-null result when a string ref isn't in the registry. Use this
  * at call sites that already handle the missing-model case explicitly
  * (e.g. join builders that throw their own contextual error).
  */
-declare function tryResolveModelClass(model: ModelRef | undefined): ChildModel<Model> | undefined;
+export declare function tryResolveModelClass(model: ModelRef | undefined): ChildModel<Model> | undefined;
 /**
  * Read the model's registered name from any `ModelRef`. Used by
  * convention helpers (`inferPivotTable`, `inferPivotKey`) that derive
@@ -119,7 +118,7 @@ declare function tryResolveModelClass(model: ModelRef | undefined): ChildModel<M
  * the class's `.name` is returned — same string the registry would
  * key the class under, so conventions stay consistent across ref shapes.
  */
-declare function resolveModelName(model: ModelRef): string;
+export declare function resolveModelName(model: ModelRef): string;
 /**
  * Walk every registered model and verify that every relation declared on it
  * points at another registered model. Throws fast at boot with a clear error
@@ -139,7 +138,6 @@ declare function resolveModelName(model: ModelRef): string;
  * verifyRegisteredRelations();
  * ```
  */
-declare function verifyRegisteredRelations(): number;
+export declare function verifyRegisteredRelations(): number;
 //#endregion
-export { ModelRef, RegisterModel, RegisterModelOptions, cleanupModelsRegistery, getAllModelsFromRegistry, getModelFromRegistry, registerModelInRegistry, removeModelFromRegistery, requireModelClass, resolveModelClass, resolveModelName, tryResolveModelClass, verifyRegisteredRelations };
 //# sourceMappingURL=register-model.d.mts.map

package/esm/model/register-model.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"register-model.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/model/register-model.ts"],"mappings":";;;;;;;;AAiBA;;;;;;;;;KAAY,QAAA,GAAW,UAAA,CAAW,KAAA,aAAkB,IAAA;;;AAAI;KAK5C,oBAAA;EAAoB;;;AAW1B;AAsCN;;;;;;EAtCE,IAAI;AAAA;;;;;;;;;;;;;;;;;AAuCyF;AAiD/F;;;;;;;;;AAA8E;AAkB9E;;iBApEgB,aAAA,CAAc,OAAA,GAAU,oBAAA,cACX,UAAA,CAAW,KAAA,GAAQ,KAAA,EAAO,CAAA,EAAG,OAAA,EAAS,qBAAA,CAAsB,CAAA,MAAK,CAAA;AAAA,iBAiD9E,uBAAA,CAAwB,IAAA,UAAc,KAAA,EAAO,UAAU,CAAC,KAAA;;;;;;;;;;AAkBvB;AAiBjD;;;;iBAjBgB,oBAAA,CAAqB,IAAA,WAAY,UAAA,CAAA,KAAA,CAAb,WAAA;;;;;;;;;;AAiBI;AAOxC;;;iBAPgB,wBAAA,IAAwB,GAAA,SAAA,UAAA,CAAA,KAAA,CAAA,WAAA;AAOF;AAItC;;AAJsC,iBAAtB,sBAAA;AAAA,iBAIA,wBAAA,CAAyB,IAAY;AAAA,iBAIrC,iBAAA,CAAkB,KAAA,EAAO,QAAA,GAAW,UAAA,CAAW,KAAA;AAA/D;;;;AAAA,iBAWgB,iBAAA,CAAkB,KAAA,EAAO,QAAA,GAAW,UAAA,CAAW,KAAA;;;;;;;iBAwB/C,oBAAA,CACd,KAAA,EAAO,QAAA,eACN,UAAA,CAAW,KAAA;;AArCsD;AAWpE;;;;;;;iBA2CgB,gBAAA,CAAiB,KAAe,EAAR,QAAQ;;;;;;AA3CoB;AAwBpE;;;;;;;;;;;;;iBA6CgB,yBAAA"}
+{"version":3,"file":"register-model.d.mts","names":["_$__model_types0.ModelSchema"],"sources":["../../../../../../../../packages/cascade/src/model/register-model.ts"],"mappings":";;;;;;;;;;;;;;;;YAiBY,WAAW,WAAW,kBAAkB;;;;YAKxC;;;;;;;;;;;EAWV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAsCc,cAAc,UAAU,wBACrB,UAAU,WAAW,QAAM,OAAS,GAAC,SAAW,sBAAsB,OAAK;wBAoD9E,wBAAwB,cAAc,OAAO,WAAW;;;;;;;;;;;;;;;wBAkBxD,qBAAqB,eAAY,WAAA,MAAjCA;;;;;;;;;;;;;;wBAiBA,4BAAwB,YAAA,WAAA,MAAxBA;;;;wBAOA;wBAIA,yBAAyB;wBAIzB,kBAAkB,OAAO,WAAW,WAAW;;;;;wBAW/C,kBAAkB,OAAO,WAAW,WAAW;;;;;;;wBAwB/C,qBAAqB,OAAO,uBAAuB,WAAW;;;;;;;;;;wBAiB9D,iBAAiB,OAAO;;;;;;;;;;;;;;;;;;;;wBA0BxB"}

package/esm/model/register-model.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"register-model.mjs","names":[],"sources":["../../../../../../../../packages/cascade/src/model/register-model.ts"],"sourcesContent":["import { isLazy, type Lazy } from \"@mongez/reinforcements\";\nimport type { RelationDefinition } from \"../relations/types\";\nimport type { ChildModel, Model } from \"./model\";\nimport { RELATION_METADATA_KEY } from \"./relation-decorators\";\n\n/**\n * Any way a relation target can be expressed: a string name registered\n * via `@RegisterModel()`, a direct class reference, or a `lazy(() => X)`\n * deferred class reference (for cycle-prone pairs).\n *\n * The lazy variant is typed as `Lazy<unknown>` (not `Lazy<ChildModel<Model>>`)\n * because `RelationDefinition.model` storage uses the same broader shape —\n * keeping the parameter type aligned avoids forcing every call site to\n * narrow before invoking the resolver. The helpers cast the resolved\n * class to `ChildModel<Model>` internally; the user's `lazy(() => X)`\n * call already guarantees the shape at the source.\n */\nexport type ModelRef = ChildModel<Model> | string | Lazy<unknown>;\n\n/**\n * Options for the RegisterModel decorator\n */\nexport type RegisterModelOptions = {\n  /**\n   * Custom name for the model in the global registry.\n   * If not provided, uses the class name.\n   *\n   * @example\n   * ```typescript\n   * @RegisterModel({ name: \"CustomUser\" })\n   * export class User extends Model {}\n   * ```\n   */\n  name?: string;\n};\n\n/**\n * Global model registry that maps model class names to their constructors.\n * This allows for string-based model references to avoid circular dependencies.\n */\nconst modelsRegistry = new Map<string, ChildModel<Model>>();\n\n/**\n * Class decorator that registers a model in the global registry.\n *\n * This is an opt-in mechanism that allows models to be referenced by string name\n * instead of direct class imports, helping avoid circular dependencies.\n *\n * Uses the **TC39 Stage 3 decorator** signature (standard since TypeScript 5.0).\n * Requires `experimentalDecorators: false` (or unset) in `tsconfig.json`.\n *\n * @param options - Optional configuration for registration\n *\n * @example\n * ```typescript\n * // Auto-capture class name\n * @RegisterModel()\n * export class User extends Model {\n *   static table = \"users\";\n * }\n *\n * // Custom name\n * @RegisterModel({ name: \"UserModel\" })\n * export class User extends Model {\n *   static table = \"users\";\n * }\n *\n * // Later, retrieve by name:\n * const UserModel = getModelFromRegistry(\"User\");\n * ```\n */\nexport function RegisterModel(options?: RegisterModelOptions) {\n  return function <T extends ChildModel<Model>>(value: T, context: ClassDecoratorContext<T>): T {\n    if (context.kind !== \"class\") {\n      throw new Error(`@RegisterModel can only be applied to classes — got \"${context.kind}\".`);\n    }\n\n    const modelName = options?.name || (context.name ?? value.name);\n\n    if (!modelName) {\n      throw new Error(\n        \"@RegisterModel decorator: Unable to determine model name. \" +\n          \"Please provide a name in options or ensure your class has a name.\",\n      );\n    }\n\n    if (modelsRegistry.has(modelName)) {\n      console.warn(\n        `⚠️  Model \"${modelName}\" is already registered. ` +\n          `This will overwrite the previous registration.`,\n      );\n    }\n\n    // Hoist relation definitions stashed by `@BelongsTo` / `@HasMany` /\n    // etc. on this class's decorator-metadata bag onto the class's static\n    // `relations` map. Field-decorator initializers are instance-level in\n    // TC39 stage 3 — they never fire for class-level operations like\n    // `Model.withCount(\"rel\")`. Reading via shared `context.metadata` is\n    // the right hand-off point because all field decorators have already\n    // run by the time the class decorator executes.\n    const decoratorRelations = context.metadata?.[RELATION_METADATA_KEY] as\n      | Record<string, RelationDefinition>\n      | undefined;\n\n    if (decoratorRelations && Object.keys(decoratorRelations).length > 0) {\n      const ownRelations = Object.prototype.hasOwnProperty.call(value, \"relations\")\n        ? (value as unknown as { relations: Record<string, RelationDefinition> }).relations\n        : { ...((value as unknown as { relations?: Record<string, RelationDefinition> }).relations ?? {}) };\n\n      (value as unknown as { relations: Record<string, RelationDefinition> }).relations = {\n        ...ownRelations,\n        ...decoratorRelations,\n      };\n    }\n\n    modelsRegistry.set(modelName, value);\n\n    return value;\n  };\n}\n\nexport function registerModelInRegistry(name: string, model: ChildModel<Model>) {\n  modelsRegistry.set(name, model);\n}\n\n/**\n * Get a model class by its name from the global registry.\n *\n * @param name - The model class name\n * @returns The model class or undefined if not found\n *\n * @example\n * ```typescript\n * const UserModel = getModelFromRegistry(\"User\");\n * if (UserModel) {\n *   const user = await UserModel.find(1);\n * }\n * ```\n */\nexport function getModelFromRegistry(name: string) {\n  return modelsRegistry.get(name);\n}\n\n/**\n * Get all registered models from the global registry.\n *\n * @returns A Map of all registered model classes by name\n *\n * @example\n * ```typescript\n * const allModels = getAllModelsFromRegistry();\n * for (const [name, ModelClass] of allModels) {\n *   console.log(`Found model: ${name}`);\n * }\n * ```\n */\nexport function getAllModelsFromRegistry() {\n  return new Map(modelsRegistry);\n}\n\n/**\n * Clean up all models from register\n */\nexport function cleanupModelsRegistery() {\n  modelsRegistry.clear();\n}\n\nexport function removeModelFromRegistery(name: string) {\n  modelsRegistry.delete(name);\n}\n\nexport function resolveModelClass(model: ModelRef): ChildModel<Model> {\n  if (typeof model === \"string\") return getModelFromRegistry(model)!;\n  if (isLazy(model)) return model.resolve() as ChildModel<Model>;\n\n  return model;\n}\n\n/**\n * Like `resolveModelClass`, but throws a descriptive error when a string\n * ref isn't registered instead of returning `undefined`.\n */\nexport function requireModelClass(model: ModelRef): ChildModel<Model> {\n  if (typeof model === \"string\") {\n    const found = getModelFromRegistry(model);\n\n    if (!found) {\n      const registered = [...modelsRegistry.keys()].join(\", \") || \"none\";\n\n      throw new Error(\n        `Model \"${model}\" is not registered (did you forget @RegisterModel()?). Registered: ${registered}`,\n      );\n    }\n\n    return found;\n  }\n\n  return resolveModelClass(model);\n}\n\n/**\n * Like `resolveModelClass`, but returns `undefined` instead of asserting\n * a non-null result when a string ref isn't in the registry. Use this\n * at call sites that already handle the missing-model case explicitly\n * (e.g. join builders that throw their own contextual error).\n */\nexport function tryResolveModelClass(\n  model: ModelRef | undefined,\n): ChildModel<Model> | undefined {\n  if (model === undefined) return undefined;\n  if (typeof model === \"string\") return getModelFromRegistry(model);\n  if (isLazy(model)) return model.resolve() as ChildModel<Model>;\n\n  return model;\n}\n\n/**\n * Read the model's registered name from any `ModelRef`. Used by\n * convention helpers (`inferPivotTable`, `inferPivotKey`) that derive\n * table / column names from the related model's class name.\n *\n * For string refs the value passes through. For class and lazy refs\n * the class's `.name` is returned — same string the registry would\n * key the class under, so conventions stay consistent across ref shapes.\n */\nexport function resolveModelName(model: ModelRef): string {\n  if (typeof model === \"string\") return model;\n  if (isLazy(model)) return (model.resolve() as ChildModel<Model>).name;\n\n  return model.name;\n}\n\n/**\n * Walk every registered model and verify that every relation declared on it\n * points at another registered model. Throws fast at boot with a clear error\n * naming the unresolved target — much better signal than the runtime\n * \"Model not found\" thrown deep inside a query.\n *\n * Call this once during app bootstrap, after every `@RegisterModel`-decorated\n * model module has been imported.\n *\n * @returns The number of relations verified (success case)\n * @throws Error listing every unresolved relation target if any are missing\n *\n * @example\n * ```typescript\n * // Inside your app bootstrap, after model imports:\n * import { verifyRegisteredRelations } from \"@warlock.js/cascade\";\n * verifyRegisteredRelations();\n * ```\n */\nexport function verifyRegisteredRelations(): number {\n  type RelationDef = { type: string; model: string };\n  const failures: Array<{ caller: string; relation: string; target: string }> = [];\n\n  let verifiedCount = 0;\n\n  for (const [callerName, ModelClass] of modelsRegistry) {\n    const relations = (ModelClass as { relations?: Record<string, RelationDef> }).relations;\n\n    if (!relations) {\n      continue;\n    }\n\n    for (const [relationName, definition] of Object.entries(relations)) {\n      verifiedCount++;\n      const targetName = definition.model;\n\n      if (typeof targetName !== \"string\") {\n        // Direct class reference or `lazy(() => X)` — class binding is\n        // captured by the decorator at definition time; can't drift.\n        continue;\n      }\n\n      if (!modelsRegistry.has(targetName)) {\n        failures.push({ caller: callerName, relation: relationName, target: targetName });\n      }\n    }\n  }\n\n  if (failures.length > 0) {\n    const list = failures\n      .map((f) => `  - ${f.caller}.${f.relation} → \"${f.target}\" is not registered`)\n      .join(\"\\n\");\n    throw new Error(\n      `verifyRegisteredRelations: ${failures.length} unresolved relation target(s):\\n${list}\\n` +\n        `Each target must be decorated with @RegisterModel() and imported before bootstrap.`,\n    );\n  }\n\n  return verifiedCount;\n}\n"],"mappings":"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"}
+{"version":3,"file":"register-model.mjs","names":[],"sources":["../../../../../../../../packages/cascade/src/model/register-model.ts"],"sourcesContent":["import { isLazy, type Lazy } from \"@mongez/reinforcements\";\nimport type { RelationDefinition } from \"../relations/types\";\nimport type { ChildModel, Model } from \"./model\";\nimport { RELATION_METADATA_KEY } from \"./relation-decorators\";\n\n/**\n * Any way a relation target can be expressed: a string name registered\n * via `@RegisterModel()`, a direct class reference, or a `lazy(() => X)`\n * deferred class reference (for cycle-prone pairs).\n *\n * The lazy variant is typed as `Lazy<unknown>` (not `Lazy<ChildModel<Model>>`)\n * because `RelationDefinition.model` storage uses the same broader shape —\n * keeping the parameter type aligned avoids forcing every call site to\n * narrow before invoking the resolver. The helpers cast the resolved\n * class to `ChildModel<Model>` internally; the user's `lazy(() => X)`\n * call already guarantees the shape at the source.\n */\nexport type ModelRef = ChildModel<Model> | string | Lazy<unknown>;\n\n/**\n * Options for the RegisterModel decorator\n */\nexport type RegisterModelOptions = {\n  /**\n   * Custom name for the model in the global registry.\n   * If not provided, uses the class name.\n   *\n   * @example\n   * ```typescript\n   * @RegisterModel({ name: \"CustomUser\" })\n   * export class User extends Model {}\n   * ```\n   */\n  name?: string;\n};\n\n/**\n * Global model registry that maps model class names to their constructors.\n * This allows for string-based model references to avoid circular dependencies.\n */\nconst modelsRegistry = new Map<string, ChildModel<Model>>();\n\n/**\n * Class decorator that registers a model in the global registry.\n *\n * This is an opt-in mechanism that allows models to be referenced by string name\n * instead of direct class imports, helping avoid circular dependencies.\n *\n * Uses the **TC39 Stage 3 decorator** signature (standard since TypeScript 5.0).\n * Requires `experimentalDecorators: false` (or unset) in `tsconfig.json`.\n *\n * @param options - Optional configuration for registration\n *\n * @example\n * ```typescript\n * // Auto-capture class name\n * @RegisterModel()\n * export class User extends Model {\n *   static table = \"users\";\n * }\n *\n * // Custom name\n * @RegisterModel({ name: \"UserModel\" })\n * export class User extends Model {\n *   static table = \"users\";\n * }\n *\n * // Later, retrieve by name:\n * const UserModel = getModelFromRegistry(\"User\");\n * ```\n */\nexport function RegisterModel(options?: RegisterModelOptions) {\n  return function <T extends ChildModel<Model>>(value: T, context: ClassDecoratorContext<T>): T {\n    if (context.kind !== \"class\") {\n      throw new Error(`@RegisterModel can only be applied to classes — got \"${context.kind}\".`);\n    }\n\n    const modelName = options?.name || (context.name ?? value.name);\n\n    if (!modelName) {\n      throw new Error(\n        \"@RegisterModel decorator: Unable to determine model name. \" +\n          \"Please provide a name in options or ensure your class has a name.\",\n      );\n    }\n\n    if (modelsRegistry.has(modelName)) {\n      console.warn(\n        `⚠️  Model \"${modelName}\" is already registered. ` +\n          `This will overwrite the previous registration.`,\n      );\n    }\n\n    // Hoist relation definitions stashed by `@BelongsTo` / `@HasMany` /\n    // etc. on this class's decorator-metadata bag onto the class's static\n    // `relations` map. Field-decorator initializers are instance-level in\n    // TC39 stage 3 — they never fire for class-level operations like\n    // `Model.withCount(\"rel\")`. Reading via shared `context.metadata` is\n    // the right hand-off point because all field decorators have already\n    // run by the time the class decorator executes.\n    const decoratorRelations = context.metadata?.[RELATION_METADATA_KEY] as\n      | Record<string, RelationDefinition>\n      | undefined;\n\n    if (decoratorRelations && Object.keys(decoratorRelations).length > 0) {\n      const ownRelations = Object.prototype.hasOwnProperty.call(value, \"relations\")\n        ? (value as unknown as { relations: Record<string, RelationDefinition> }).relations\n        : {\n            ...((value as unknown as { relations?: Record<string, RelationDefinition> })\n              .relations ?? {}),\n          };\n\n      (value as unknown as { relations: Record<string, RelationDefinition> }).relations = {\n        ...ownRelations,\n        ...decoratorRelations,\n      };\n    }\n\n    modelsRegistry.set(modelName, value);\n\n    return value;\n  };\n}\n\nexport function registerModelInRegistry(name: string, model: ChildModel<Model>) {\n  modelsRegistry.set(name, model);\n}\n\n/**\n * Get a model class by its name from the global registry.\n *\n * @param name - The model class name\n * @returns The model class or undefined if not found\n *\n * @example\n * ```typescript\n * const UserModel = getModelFromRegistry(\"User\");\n * if (UserModel) {\n *   const user = await UserModel.find(1);\n * }\n * ```\n */\nexport function getModelFromRegistry(name: string) {\n  return modelsRegistry.get(name);\n}\n\n/**\n * Get all registered models from the global registry.\n *\n * @returns A Map of all registered model classes by name\n *\n * @example\n * ```typescript\n * const allModels = getAllModelsFromRegistry();\n * for (const [name, ModelClass] of allModels) {\n *   console.log(`Found model: ${name}`);\n * }\n * ```\n */\nexport function getAllModelsFromRegistry() {\n  return new Map(modelsRegistry);\n}\n\n/**\n * Clean up all models from register\n */\nexport function cleanupModelsRegistery() {\n  modelsRegistry.clear();\n}\n\nexport function removeModelFromRegistery(name: string) {\n  modelsRegistry.delete(name);\n}\n\nexport function resolveModelClass(model: ModelRef): ChildModel<Model> {\n  if (typeof model === \"string\") return getModelFromRegistry(model)!;\n  if (isLazy(model)) return model.resolve() as ChildModel<Model>;\n\n  return model;\n}\n\n/**\n * Like `resolveModelClass`, but throws a descriptive error when a string\n * ref isn't registered instead of returning `undefined`.\n */\nexport function requireModelClass(model: ModelRef): ChildModel<Model> {\n  if (typeof model === \"string\") {\n    const found = getModelFromRegistry(model);\n\n    if (!found) {\n      const registered = [...modelsRegistry.keys()].join(\", \") || \"none\";\n\n      throw new Error(\n        `Model \"${model}\" is not registered (did you forget @RegisterModel()?). Registered: ${registered}`,\n      );\n    }\n\n    return found;\n  }\n\n  return resolveModelClass(model);\n}\n\n/**\n * Like `resolveModelClass`, but returns `undefined` instead of asserting\n * a non-null result when a string ref isn't in the registry. Use this\n * at call sites that already handle the missing-model case explicitly\n * (e.g. join builders that throw their own contextual error).\n */\nexport function tryResolveModelClass(model: ModelRef | undefined): ChildModel<Model> | undefined {\n  if (model === undefined) return undefined;\n  if (typeof model === \"string\") return getModelFromRegistry(model);\n  if (isLazy(model)) return model.resolve() as ChildModel<Model>;\n\n  return model;\n}\n\n/**\n * Read the model's registered name from any `ModelRef`. Used by\n * convention helpers (`inferPivotTable`, `inferPivotKey`) that derive\n * table / column names from the related model's class name.\n *\n * For string refs the value passes through. For class and lazy refs\n * the class's `.name` is returned — same string the registry would\n * key the class under, so conventions stay consistent across ref shapes.\n */\nexport function resolveModelName(model: ModelRef): string {\n  if (typeof model === \"string\") return model;\n  if (isLazy(model)) return (model.resolve() as ChildModel<Model>).name;\n\n  return model.name;\n}\n\n/**\n * Walk every registered model and verify that every relation declared on it\n * points at another registered model. Throws fast at boot with a clear error\n * naming the unresolved target — much better signal than the runtime\n * \"Model not found\" thrown deep inside a query.\n *\n * Call this once during app bootstrap, after every `@RegisterModel`-decorated\n * model module has been imported.\n *\n * @returns The number of relations verified (success case)\n * @throws Error listing every unresolved relation target if any are missing\n *\n * @example\n * ```typescript\n * // Inside your app bootstrap, after model imports:\n * import { verifyRegisteredRelations } from \"@warlock.js/cascade\";\n * verifyRegisteredRelations();\n * ```\n */\nexport function verifyRegisteredRelations(): number {\n  type RelationDef = { type: string; model: string };\n  const failures: Array<{ caller: string; relation: string; target: string }> = [];\n\n  let verifiedCount = 0;\n\n  for (const [callerName, ModelClass] of modelsRegistry) {\n    const relations = (ModelClass as { relations?: Record<string, RelationDef> }).relations;\n\n    if (!relations) {\n      continue;\n    }\n\n    for (const [relationName, definition] of Object.entries(relations)) {\n      verifiedCount++;\n      const targetName = definition.model;\n\n      if (typeof targetName !== \"string\") {\n        // Direct class reference or `lazy(() => X)` — class binding is\n        // captured by the decorator at definition time; can't drift.\n        continue;\n      }\n\n      if (!modelsRegistry.has(targetName)) {\n        failures.push({ caller: callerName, relation: relationName, target: targetName });\n      }\n    }\n  }\n\n  if (failures.length > 0) {\n    const list = failures\n      .map((f) => `  - ${f.caller}.${f.relation} → \"${f.target}\" is not registered`)\n      .join(\"\\n\");\n    throw new Error(\n      `verifyRegisteredRelations: ${failures.length} unresolved relation target(s):\\n${list}\\n` +\n        `Each target must be decorated with @RegisterModel() and imported before bootstrap.`,\n    );\n  }\n\n  return verifiedCount;\n}\n"],"mappings":"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"}

package/esm/model/relation-decorators.d.mts

@@ -1,14 +1,13 @@
-import { ChildModel } from "./model.types.mjs";
 import { BelongsToManyOptions, BelongsToOptions, HasManyOptions, HasOneOptions } from "../relations/types.mjs";
+import { ChildModel } from "./model.types.mjs";
 import { Model } from "./model.mjs";
 import { Lazy } from "@mongez/reinforcements";
-
 //#region ../../packages/cascade/src/model/relation-decorators.d.ts
 /**
  * Key used to stash relation definitions on the decorator metadata object.
  * Exported so `@RegisterModel` (in `register-model.ts`) can read it back.
  */
-declare const RELATION_METADATA_KEY: unique symbol;
+export declare const RELATION_METADATA_KEY: unique symbol;
 /**
  * Declares a `belongsTo` relation on a model field.
  *
@@ -34,7 +33,7 @@ declare const RELATION_METADATA_KEY: unique symbol;
  * }
  * ```
  */
-declare const BelongsTo: (modelRelation: string | ChildModel<Model> | Lazy<unknown>, options?: string | BelongsToOptions | undefined) => <This>(_value: undefined, context: ClassFieldDecoratorContext<This>) => void;
+export declare const BelongsTo: (modelRelation: string | ChildModel<Model> | Lazy<unknown>, options?: string | BelongsToOptions | undefined) => <This>(_value: undefined, context: ClassFieldDecoratorContext<This, unknown>) => void;
 /**
  * Declares a `hasOne` relation on a model field.
  *
@@ -50,7 +49,7 @@ declare const BelongsTo: (modelRelation: string | ChildModel<Model> | Lazy<unkno
  * }
  * ```
  */
-declare const HasOne: (modelRelation: string | ChildModel<Model> | Lazy<unknown>, options?: string | HasOneOptions | undefined) => <This>(_value: undefined, context: ClassFieldDecoratorContext<This>) => void;
+export declare const HasOne: (modelRelation: string | ChildModel<Model> | Lazy<unknown>, options?: string | HasOneOptions | undefined) => <This>(_value: undefined, context: ClassFieldDecoratorContext<This, unknown>) => void;
 /**
  * Declares a `hasMany` relation on a model field.
  *
@@ -66,7 +65,7 @@ declare const HasOne: (modelRelation: string | ChildModel<Model> | Lazy<unknown>
  * }
  * ```
  */
-declare const HasMany: (modelRelation: string | ChildModel<Model> | Lazy<unknown>, options?: string | HasManyOptions | undefined) => <This>(_value: undefined, context: ClassFieldDecoratorContext<This>) => void;
+export declare const HasMany: (modelRelation: string | ChildModel<Model> | Lazy<unknown>, options?: string | HasManyOptions | undefined) => <This>(_value: undefined, context: ClassFieldDecoratorContext<This, unknown>) => void;
 /**
  * Declares a `belongsToMany` relation on a model field.
  *
@@ -82,7 +81,6 @@ declare const HasMany: (modelRelation: string | ChildModel<Model> | Lazy<unknown
  * }
  * ```
  */
-declare const BelongsToMany: (modelRelation: string | ChildModel<Model> | Lazy<unknown>, options?: string | BelongsToManyOptions | undefined) => <This>(_value: undefined, context: ClassFieldDecoratorContext<This>) => void;
+export declare const BelongsToMany: (modelRelation: string | ChildModel<Model> | Lazy<unknown>, options?: string | BelongsToManyOptions | undefined) => <This>(_value: undefined, context: ClassFieldDecoratorContext<This, unknown>) => void;
 //#endregion
-export { BelongsTo, BelongsToMany, HasMany, HasOne, RELATION_METADATA_KEY };
 //# sourceMappingURL=relation-decorators.d.mts.map

package/esm/model/relation-decorators.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"relation-decorators.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/model/relation-decorators.ts"],"mappings":";;;;;;;;;;cA2Ha,qBAAA;;;AAgB0E;AAuFvF;;;;;;;;;;;;;;;;;;;;;;cAjBa,SAAA,GAAS,aAAA,WAzEM,UAAA,CAAW,KAAA,IAAS,IAAA,WAAa,OAAA,YAAA,gBAAA,wBAGlC,MAAA,aAAmB,OAAA,EAAS,0BAAA,CAA2B,IAAA;AAAK;AAwGvF;;;;;;;;;;;;;;AAxGuF,cAuF1E,MAAA,GAAM,aAAA,WA1FS,UAAA,CAAW,KAAA,IAAS,IAAA,WAAa,OAAA,YAAA,aAAA,wBAGlC,MAAA,aAAmB,OAAA,EAAS,0BAAA,CAA2B,IAAA;;;;;;;;;AAAK;AAyHvF;;;;;;cAjBa,OAAA,GAAO,aAAA,WA3GQ,UAAA,CAAW,KAAA,IAAS,IAAA,WAAa,OAAA,YAAA,cAAA,wBAGlC,MAAA,aAAmB,OAAA,EAAS,0BAAA,CAA2B,IAAA;;;;;;;;;;;;;;;;cAyHrE,aAAA,GAAa,aAAA,WA5HE,UAAA,CAAW,KAAA,IAAS,IAAA,WAAa,OAAA,YAAA,oBAAA,wBAGlC,MAAA,aAAmB,OAAA,EAAS,0BAAA,CAA2B,IAAA"}
+{"version":3,"file":"relation-decorators.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/model/relation-decorators.ts"],"mappings":";;;;;;;;;qBA2Ha;;;;;;;;;;;;;;;;;;;;;;;;;;qBAsFA,YAAS,wBAzEM,WAAW,SAAS,eAAa,mBAAA,kCAGxC,MAAI,mBAAmB,SAAA,2BAAA;;;;;;;;;;;;;;;;qBAuF/B,SAAM,wBA1FS,WAAW,SAAS,eAAa,mBAAA,+BAGxC,MAAI,mBAAmB,SAAA,2BAAA;;;;;;;;;;;;;;;;qBAwG/B,UAAO,wBA3GQ,WAAW,SAAS,eAAa,mBAAA,gCAGxC,MAAI,mBAAmB,SAAA,2BAAA;;;;;;;;;;;;;;;;qBAyH/B,gBAAa,wBA5HE,WAAW,SAAS,eAAa,mBAAA,sCAGxC,MAAI,mBAAmB,SAAA,2BAAA"}

package/esm/operations/database.d.mts

@@ -5,20 +5,25 @@
  * beyond "look up by registry name".
  */
 type DataSourceSelector = {
-  /** Data source name from the registry. Omit to use the default source. */readonly connection?: string;
+  /** Data source name from the registry. Omit to use the default source. */
+  readonly connection?: string;
 };
 /**
  * Result of {@link createDatabase}.
  */
-type CreateDatabaseResult = {
-  /** True if a new database was created; false if it already existed. */readonly created: boolean; /** The database name that was passed to the operation. */
+export type CreateDatabaseResult = {
+  /** True if a new database was created; false if it already existed. */
+  readonly created: boolean;
+  /** The database name that was passed to the operation. */
   readonly name: string;
 };
 /**
  * Result of {@link dropAllTables}.
  */
-type DropAllTablesResult = {
-  /** Names of tables that were dropped, in the order returned by the driver. */readonly tables: string[]; /** Count of dropped tables (equal to `tables.length`). */
+export type DropAllTablesResult = {
+  /** Names of tables that were dropped, in the order returned by the driver. */
+  readonly tables: string[];
+  /** Count of dropped tables (equal to `tables.length`). */
   readonly dropped: number;
 };
 /**
@@ -30,7 +35,7 @@ type DropAllTablesResult = {
  * await createDatabase("analytics");
  * await createDatabase("analytics", { connection: "warehouse" });
  */
-declare function createDatabase(name: string, options?: DataSourceSelector): Promise<CreateDatabaseResult>;
+export declare function createDatabase(name: string, options?: DataSourceSelector): Promise<CreateDatabaseResult>;
 /**
  * Drop every table on the configured data source. Lists tables first so the
  * caller receives the names that were affected — useful for printing,
@@ -40,7 +45,7 @@ declare function createDatabase(name: string, options?: DataSourceSelector): Pro
  * const { tables, dropped } = await dropAllTables();
  * console.log(`Dropped ${dropped} tables: ${tables.join(", ")}`);
  */
-declare function dropAllTables(options?: DataSourceSelector): Promise<DropAllTablesResult>;
+export declare function dropAllTables(options?: DataSourceSelector): Promise<DropAllTablesResult>;
 //#endregion
-export { CreateDatabaseResult, DropAllTablesResult, createDatabase, dropAllTables };
+export {};
 //# sourceMappingURL=database.d.mts.map

package/esm/operations/database.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"database.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/operations/database.ts"],"mappings":";;;;;;KAOK,kBAAA;EAQO,mFAND,UAAU;AAAA;;AAUN;AAMf;KAVY,oBAAA;kFAED,OAAA,WAYO;EAAA,SAVP,IAAI;AAAA;;;;KAMH,mBAAA;EAmBF,uFAjBC,MAAA,YAeT;EAAA,SAbS,OAAO;AAAA;;;;AAea;AAgB/B;;;;;iBAnBsB,cAAA,CACpB,IAAA,UACA,OAAA,GAAS,kBAAA,GACR,OAAA,CAAQ,oBAAA;;;;;;;;AAkBmB;;iBAFR,aAAA,CACpB,OAAA,GAAS,kBAAA,GACR,OAAA,CAAQ,mBAAA"}
+{"version":3,"file":"database.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/operations/database.ts"],"mappings":";;;;;;KAOK;;WAEM;;;;;YAMC;;WAED;;WAEA;;;;;YAMC;;WAED;;WAEA;;;;;;;;;;;wBAYW,eACpB,cACA,UAAS,qBACR,QAAQ;;;;;;;;;;wBAgBW,cACpB,UAAS,qBACR,QAAQ"}

package/esm/operations/index.d.mts

@@ -1,2 +1,3 @@
 import { CreateDatabaseResult, DropAllTablesResult, createDatabase, dropAllTables } from "./database.mjs";
-import { ExportMigrationsSQLOptions, PendingMigration, RollbackMigrationsOptions, exportMigrationsSQL, freshMigrate, listExecutedMigrations, listPendingMigrations, rollbackMigrations, runMigrations } from "./migrations.mjs";
+import { ExportMigrationsSQLOptions, PendingMigration, RollbackMigrationsOptions, exportMigrationsSQL, freshMigrate, listExecutedMigrations, listPendingMigrations, rollbackMigrations, runMigrations } from "./migrations.mjs";
+export { CreateDatabaseResult, DropAllTablesResult, ExportMigrationsSQLOptions, PendingMigration, RollbackMigrationsOptions, createDatabase, dropAllTables, exportMigrationsSQL, freshMigrate, listExecutedMigrations, listPendingMigrations, rollbackMigrations, runMigrations };

package/esm/operations/index.mjs

@@ -1,4 +1,4 @@
 import { createDatabase, dropAllTables } from "./database.mjs";
 import { exportMigrationsSQL, freshMigrate, listExecutedMigrations, listPendingMigrations, rollbackMigrations, runMigrations } from "./migrations.mjs";
 
-export {  };
+export { createDatabase, dropAllTables, exportMigrationsSQL, freshMigrate, listExecutedMigrations, listPendingMigrations, rollbackMigrations, runMigrations };

package/esm/operations/migrations.d.mts

@@ -1,18 +1,21 @@
 import { MigrationRecord, MigrationResult } from "../migration/types.mjs";
-
 //#region ../../packages/cascade/src/operations/migrations.d.ts
 /**
  * Options for exporting migrations as SQL files.
  */
-type ExportMigrationsSQLOptions = {
-  /** Export only pending migrations. Default: false (exports all registered). */readonly pendingOnly?: boolean; /** Strip generated block comments and blank lines from the output. */
+export type ExportMigrationsSQLOptions = {
+  /** Export only pending migrations. Default: false (exports all registered). */
+  readonly pendingOnly?: boolean;
+  /** Strip generated block comments and blank lines from the output. */
   readonly compact?: boolean;
 };
 /**
  * Options for rolling back migrations.
  */
-type RollbackMigrationsOptions = {
-  /** Roll back every executed migration. Overrides `batches` when true. */readonly all?: boolean; /** Number of batches to roll back when `all` is not set. Default: 1. */
+export type RollbackMigrationsOptions = {
+  /** Roll back every executed migration. Overrides `batches` when true. */
+  readonly all?: boolean;
+  /** Number of batches to roll back when `all` is not set. Default: 1. */
   readonly batches?: number;
 };
 /**
@@ -26,7 +29,7 @@ type RollbackMigrationsOptions = {
  * migrationRunner.registerMany([CreateUsersTable, AddEmailIndex]);
  * const results = await runMigrations();
  */
-declare function runMigrations(): Promise<MigrationResult[]>;
+export declare function runMigrations(): Promise<MigrationResult[]>;
 /**
  * Roll back executed migrations. By default rolls back the most recent batch;
  * pass `all: true` to undo every executed migration, or `batches: N` to undo
@@ -37,7 +40,7 @@ declare function runMigrations(): Promise<MigrationResult[]>;
  * await rollbackMigrations({ batches: 3 }); // last three batches
  * await rollbackMigrations({ all: true });  // everything
  */
-declare function rollbackMigrations(options?: RollbackMigrationsOptions): Promise<MigrationResult[]>;
+export declare function rollbackMigrations(options?: RollbackMigrationsOptions): Promise<MigrationResult[]>;
 /**
  * Roll back every executed migration, then run every registered migration.
  * Equivalent to `rollbackMigrations({ all: true })` followed by
@@ -46,7 +49,7 @@ declare function rollbackMigrations(options?: RollbackMigrationsOptions): Promis
  * @example
  * await freshMigrate();
  */
-declare function freshMigrate(): Promise<MigrationResult[]>;
+export declare function freshMigrate(): Promise<MigrationResult[]>;
 /**
  * Export registered migrations as phase-ordered `.up.sql` and `.down.sql`
  * files under `<cwd>/database/sql/`.
@@ -55,7 +58,7 @@ declare function freshMigrate(): Promise<MigrationResult[]>;
  * await exportMigrationsSQL();
  * await exportMigrationsSQL({ pendingOnly: true, compact: true });
  */
-declare function exportMigrationsSQL(options?: ExportMigrationsSQLOptions): Promise<void>;
+export declare function exportMigrationsSQL(options?: ExportMigrationsSQLOptions): Promise<void>;
 /**
  * Return the migration records persisted in the migrations table — one entry
  * per migration that has ever been executed against the configured data
@@ -65,13 +68,15 @@ declare function exportMigrationsSQL(options?: ExportMigrationsSQLOptions): Prom
  * const executed = await listExecutedMigrations();
  * console.log(executed.map((record) => record.name));
  */
-declare function listExecutedMigrations(): Promise<MigrationRecord[]>;
+export declare function listExecutedMigrations(): Promise<MigrationRecord[]>;
 /**
  * A registered migration that has not yet been executed against the configured
  * data source.
  */
-type PendingMigration = {
-  /** Migration name/identifier, as it will be recorded once executed. */readonly name: string; /** Creation timestamp, when the migration carries one. */
+export type PendingMigration = {
+  /** Migration name/identifier, as it will be recorded once executed. */
+  readonly name: string;
+  /** Creation timestamp, when the migration carries one. */
   readonly createdAt?: string;
 };
 /**
@@ -89,7 +94,6 @@ type PendingMigration = {
  * const pending = await listPendingMigrations();
  * console.log(pending.map((migration) => migration.name));
  */
-declare function listPendingMigrations(): Promise<PendingMigration[]>;
+export declare function listPendingMigrations(): Promise<PendingMigration[]>;
 //#endregion
-export { ExportMigrationsSQLOptions, PendingMigration, RollbackMigrationsOptions, exportMigrationsSQL, freshMigrate, listExecutedMigrations, listPendingMigrations, rollbackMigrations, runMigrations };
 //# sourceMappingURL=migrations.d.mts.map

package/esm/operations/migrations.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/operations/migrations.ts"],"mappings":";;;;;AAMA;KAAY,0BAAA;0FAED,WAAA,YAEO;EAAA,SAAP,OAAO;AAAA;;;AAUA;KAJN,yBAAA;EAkBuB,kFAhBxB,GAAA,YAgB4B;EAAA,SAd5B,OAAO;AAAA;;;;;;;;;;;;iBAcI,aAAA,IAAiB,OAAO,CAAC,eAAA;AAgBrB;AAkB1B;;;;AAA6D;AAY7D;;;;AA9B0B,iBAFJ,kBAAA,CACpB,OAAA,GAAS,yBAAA,GACR,OAAA,CAAQ,eAAA;;;;AAgCD;AAaV;;;;iBA3BsB,YAAA,IAAgB,OAAO,CAAC,eAAA;AAmC9C;;;;AAIoB;AAkBpB;;;AAtBA,iBAvBsB,mBAAA,CACpB,OAAA,GAAS,0BAAA,GACR,OAAO;AA2C6D;;;;;;;;;AAAA,iBA9BjD,sBAAA,IAA0B,OAAO,CAAC,eAAA;;;;;KAQ5C,gBAAA;kFAED,IAAA;WAEA,SAAS;AAAA;;;;;;;;;;;;;;;;iBAkBE,qBAAA,IAAyB,OAAO,CAAC,gBAAA"}
+{"version":3,"file":"migrations.d.mts","names":[],"sources":["../../../../../../../../packages/cascade/src/operations/migrations.ts"],"mappings":";;;;;YAMY;;WAED;;WAEA;;;;;YAMC;;WAED;;WAEA;;;;;;;;;;;;;wBAcW,iBAAiB,QAAQ;;;;;;;;;;;wBAczB,mBACpB,UAAS,4BACR,QAAQ;;;;;;;;;wBAkBW,gBAAgB,QAAQ;;;;;;;;;wBAYxB,oBAAoB,UAAS,6BAAkC;;;;;;;;;;wBAa/D,0BAA0B,QAAQ;;;;;YAQ5C;;WAED;;WAEA;;;;;;;;;;;;;;;;;wBAkBW,yBAAyB,QAAQ"}

package/esm/operations/migrations.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.mjs","names":[],"sources":["../../../../../../../../packages/cascade/src/operations/migrations.ts"],"sourcesContent":["import { migrationRunner } from \"../migration/migration-runner\";\nimport type { MigrationRecord, MigrationResult } from \"../migration/types\";\n\n/**\n * Options for exporting migrations as SQL files.\n */\nexport type ExportMigrationsSQLOptions = {\n  /** Export only pending migrations. Default: false (exports all registered). */\n  readonly pendingOnly?: boolean;\n  /** Strip generated block comments and blank lines from the output. */\n  readonly compact?: boolean;\n};\n\n/**\n * Options for rolling back migrations.\n */\nexport type RollbackMigrationsOptions = {\n  /** Roll back every executed migration. Overrides `batches` when true. */\n  readonly all?: boolean;\n  /** Number of batches to roll back when `all` is not set. Default: 1. */\n  readonly batches?: number;\n};\n\n/**\n * Run every pending migration registered on the migration runner.\n *\n * Caller is responsible for registering migration classes first via\n * `migrationRunner.register()` / `migrationRunner.registerMany()`. Returns one\n * result entry per executed migration.\n *\n * @example\n * migrationRunner.registerMany([CreateUsersTable, AddEmailIndex]);\n * const results = await runMigrations();\n */\nexport async function runMigrations(): Promise<MigrationResult[]> {\n  return migrationRunner.runAll();\n}\n\n/**\n * Roll back executed migrations. By default rolls back the most recent batch;\n * pass `all: true` to undo every executed migration, or `batches: N` to undo\n * the last N batches.\n *\n * @example\n * await rollbackMigrations();              // last batch\n * await rollbackMigrations({ batches: 3 }); // last three batches\n * await rollbackMigrations({ all: true });  // everything\n */\nexport async function rollbackMigrations(\n  options: RollbackMigrationsOptions = {},\n): Promise<MigrationResult[]> {\n  if (options.all) {\n    return migrationRunner.rollbackAll();\n  }\n\n  const batches = options.batches ?? 1;\n\n  return migrationRunner.rollbackBatches(batches);\n}\n\n/**\n * Roll back every executed migration, then run every registered migration.\n * Equivalent to `rollbackMigrations({ all: true })` followed by\n * `runMigrations()`.\n *\n * @example\n * await freshMigrate();\n */\nexport async function freshMigrate(): Promise<MigrationResult[]> {\n  return migrationRunner.fresh();\n}\n\n/**\n * Export registered migrations as phase-ordered `.up.sql` and `.down.sql`\n * files under `<cwd>/database/sql/`.\n *\n * @example\n * await exportMigrationsSQL();\n * await exportMigrationsSQL({ pendingOnly: true, compact: true });\n */\nexport async function exportMigrationsSQL(\n  options: ExportMigrationsSQLOptions = {},\n): Promise<void> {\n  return migrationRunner.exportSQL(options);\n}\n\n/**\n * Return the migration records persisted in the migrations table — one entry\n * per migration that has ever been executed against the configured data\n * source.\n *\n * @example\n * const executed = await listExecutedMigrations();\n * console.log(executed.map((record) => record.name));\n */\nexport async function listExecutedMigrations(): Promise<MigrationRecord[]> {\n  return migrationRunner.getExecutedMigrations();\n}\n\n/**\n * A registered migration that has not yet been executed against the configured\n * data source.\n */\nexport type PendingMigration = {\n  /** Migration name/identifier, as it will be recorded once executed. */\n  readonly name: string;\n  /** Creation timestamp, when the migration carries one. */\n  readonly createdAt?: string;\n};\n\n/**\n * Return the registered migrations that have NOT been executed, **in the order\n * they will execute**. The order is the point: it makes the result a dry run\n * rather than a set.\n *\n * ⚠️ Only registered migrations can be pending. Register them first — via\n * `migrationRunner.register()` / `registerMany()`, or whatever the host\n * framework's loader does — or this returns `[]`, which reads as \"nothing\n * pending\" and is not the same thing.\n *\n * @example\n * migrationRunner.registerMany([CreateUsersTable, AddEmailIndex]);\n * const pending = await listPendingMigrations();\n * console.log(pending.map((migration) => migration.name));\n */\nexport async function listPendingMigrations(): Promise<PendingMigration[]> {\n  const pending = await migrationRunner.getPendingMigrations();\n\n  return pending.map((MigrationClass) => ({\n    name: MigrationClass.migrationName,\n    createdAt: MigrationClass.createdAt,\n  }));\n}\n"],"mappings":";;;;;;;;;;;;;;AAkCA,eAAsB,gBAA4C;CAChE,OAAO,gBAAgB,OAAO;AAChC;;;;;;;;;;;AAYA,eAAsB,mBACpB,UAAqC,CAAC,GACV;CAC5B,IAAI,QAAQ,KACV,OAAO,gBAAgB,YAAY;CAGrC,MAAM,UAAU,QAAQ,WAAW;CAEnC,OAAO,gBAAgB,gBAAgB,OAAO;AAChD;;;;;;;;;AAUA,eAAsB,eAA2C;CAC/D,OAAO,gBAAgB,MAAM;AAC/B;;;;;;;;;AAUA,eAAsB,oBACpB,UAAsC,CAAC,GACxB;CACf,OAAO,gBAAgB,UAAU,OAAO;AAC1C;;;;;;;;;;AAWA,eAAsB,yBAAqD;CACzE,OAAO,gBAAgB,sBAAsB;AAC/C;;;;;;;;;;;;;;;;AA4BA,eAAsB,wBAAqD;CAGzE,QAAO,MAFe,gBAAgB,qBAAqB,EAE7C,CAAC,KAAK,oBAAoB;EACtC,MAAM,eAAe;EACrB,WAAW,eAAe;CAC5B,EAAE;AACJ"}
+{"version":3,"file":"migrations.mjs","names":[],"sources":["../../../../../../../../packages/cascade/src/operations/migrations.ts"],"sourcesContent":["import { migrationRunner } from \"../migration/migration-runner\";\nimport type { MigrationRecord, MigrationResult } from \"../migration/types\";\n\n/**\n * Options for exporting migrations as SQL files.\n */\nexport type ExportMigrationsSQLOptions = {\n  /** Export only pending migrations. Default: false (exports all registered). */\n  readonly pendingOnly?: boolean;\n  /** Strip generated block comments and blank lines from the output. */\n  readonly compact?: boolean;\n};\n\n/**\n * Options for rolling back migrations.\n */\nexport type RollbackMigrationsOptions = {\n  /** Roll back every executed migration. Overrides `batches` when true. */\n  readonly all?: boolean;\n  /** Number of batches to roll back when `all` is not set. Default: 1. */\n  readonly batches?: number;\n};\n\n/**\n * Run every pending migration registered on the migration runner.\n *\n * Caller is responsible for registering migration classes first via\n * `migrationRunner.register()` / `migrationRunner.registerMany()`. Returns one\n * result entry per executed migration.\n *\n * @example\n * migrationRunner.registerMany([CreateUsersTable, AddEmailIndex]);\n * const results = await runMigrations();\n */\nexport async function runMigrations(): Promise<MigrationResult[]> {\n  return migrationRunner.runAll();\n}\n\n/**\n * Roll back executed migrations. By default rolls back the most recent batch;\n * pass `all: true` to undo every executed migration, or `batches: N` to undo\n * the last N batches.\n *\n * @example\n * await rollbackMigrations();              // last batch\n * await rollbackMigrations({ batches: 3 }); // last three batches\n * await rollbackMigrations({ all: true });  // everything\n */\nexport async function rollbackMigrations(\n  options: RollbackMigrationsOptions = {},\n): Promise<MigrationResult[]> {\n  if (options.all) {\n    return migrationRunner.rollbackAll();\n  }\n\n  const batches = options.batches ?? 1;\n\n  return migrationRunner.rollbackBatches(batches);\n}\n\n/**\n * Roll back every executed migration, then run every registered migration.\n * Equivalent to `rollbackMigrations({ all: true })` followed by\n * `runMigrations()`.\n *\n * @example\n * await freshMigrate();\n */\nexport async function freshMigrate(): Promise<MigrationResult[]> {\n  return migrationRunner.fresh();\n}\n\n/**\n * Export registered migrations as phase-ordered `.up.sql` and `.down.sql`\n * files under `<cwd>/database/sql/`.\n *\n * @example\n * await exportMigrationsSQL();\n * await exportMigrationsSQL({ pendingOnly: true, compact: true });\n */\nexport async function exportMigrationsSQL(options: ExportMigrationsSQLOptions = {}): Promise<void> {\n  return migrationRunner.exportSQL(options);\n}\n\n/**\n * Return the migration records persisted in the migrations table — one entry\n * per migration that has ever been executed against the configured data\n * source.\n *\n * @example\n * const executed = await listExecutedMigrations();\n * console.log(executed.map((record) => record.name));\n */\nexport async function listExecutedMigrations(): Promise<MigrationRecord[]> {\n  return migrationRunner.getExecutedMigrations();\n}\n\n/**\n * A registered migration that has not yet been executed against the configured\n * data source.\n */\nexport type PendingMigration = {\n  /** Migration name/identifier, as it will be recorded once executed. */\n  readonly name: string;\n  /** Creation timestamp, when the migration carries one. */\n  readonly createdAt?: string;\n};\n\n/**\n * Return the registered migrations that have NOT been executed, **in the order\n * they will execute**. The order is the point: it makes the result a dry run\n * rather than a set.\n *\n * ⚠️ Only registered migrations can be pending. Register them first — via\n * `migrationRunner.register()` / `registerMany()`, or whatever the host\n * framework's loader does — or this returns `[]`, which reads as \"nothing\n * pending\" and is not the same thing.\n *\n * @example\n * migrationRunner.registerMany([CreateUsersTable, AddEmailIndex]);\n * const pending = await listPendingMigrations();\n * console.log(pending.map((migration) => migration.name));\n */\nexport async function listPendingMigrations(): Promise<PendingMigration[]> {\n  const pending = await migrationRunner.getPendingMigrations();\n\n  return pending.map((MigrationClass) => ({\n    name: MigrationClass.migrationName,\n    createdAt: MigrationClass.createdAt,\n  }));\n}\n"],"mappings":";;;;;;;;;;;;;;AAkCA,eAAsB,gBAA4C;CAChE,OAAO,gBAAgB,OAAO;AAChC;;;;;;;;;;;AAYA,eAAsB,mBACpB,UAAqC,CAAC,GACV;CAC5B,IAAI,QAAQ,KACV,OAAO,gBAAgB,YAAY;CAGrC,MAAM,UAAU,QAAQ,WAAW;CAEnC,OAAO,gBAAgB,gBAAgB,OAAO;AAChD;;;;;;;;;AAUA,eAAsB,eAA2C;CAC/D,OAAO,gBAAgB,MAAM;AAC/B;;;;;;;;;AAUA,eAAsB,oBAAoB,UAAsC,CAAC,GAAkB;CACjG,OAAO,gBAAgB,UAAU,OAAO;AAC1C;;;;;;;;;;AAWA,eAAsB,yBAAqD;CACzE,OAAO,gBAAgB,sBAAsB;AAC/C;;;;;;;;;;;;;;;;AA4BA,eAAsB,wBAAqD;CAGzE,QAAO,MAFe,gBAAgB,qBAAqB,EAE7C,CAAC,KAAK,oBAAoB;EACtC,MAAM,eAAe;EACrB,WAAW,eAAe;CAC5B,EAAE;AACJ"}

package/esm/query-builder/query-builder.d.mts

@@ -1,11 +1,10 @@
 import { GroupByInput, HavingInput, JoinOptions, LeanDocument, LockForUpdateOptions, OrderDirection, RawExpression, WhereCallback, WhereObject, WhereOperator } from "../contracts/query-builder.contract.mjs";
-
 //#region ../../packages/cascade/src/query-builder/query-builder.d.ts
 /**
  * A single recorded query operation.
  * `type` is the discriminator; `data` carries all parameters.
  */
-type Op = {
+export type Op = {
   readonly type: string;
   readonly data: Record<string, unknown>;
 };
@@ -32,7 +31,7 @@ type Op = {
  * // The sub-QB's operations[] are captured and stored in the joinWith op data.
  * ```
  */
-declare class QueryBuilder<T = unknown> {
+export declare class QueryBuilder<T = unknown> {
   /** Flat, ordered list of recorded operations. Public for parser access. */
   operations: Op[];
   /**
@@ -619,5 +618,4 @@ declare class QueryBuilder<T = unknown> {
   when<V>(condition: V | boolean, callback: (builder: this, value: V) => void, otherwise?: (builder: this) => void): this;
 }
 //#endregion
-export { Op, QueryBuilder };
 //# sourceMappingURL=query-builder.d.mts.map

package/esm/query-builder/query-builder.d.mts.map

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

package/esm/query-builder/query-builder.mjs

@@ -1209,17 +1209,18 @@ var QueryBuilder = class QueryBuilder {
 	having(...args) {
 		if (args.length === 1) {
 			const input = args[0];
-			if (Array.isArray(input)) if (input.length === 2) this.addOperation("having", {
-				field: input[0],
-				operator: "=",
-				value: input[1]
-			});
-			else this.addOperation("having", {
-				field: input[0],
-				operator: input[1],
-				value: input[2]
-			});
-			else for (const [key, value] of Object.entries(input)) this.addOperation("having", {
+			if (Array.isArray(input)) {
+				if (input.length === 2) this.addOperation("having", {
+					field: input[0],
+					operator: "=",
+					value: input[1]
+				});
+				else this.addOperation("having", {
+					field: input[0],
+					operator: input[1],
+					value: input[2]
+				});
+			} else for (const [key, value] of Object.entries(input)) this.addOperation("having", {
 				field: key,
 				operator: "=",
 				value