@warlock.js/core 5.31.0 → 5.32.0

package/esm/production/route-registration-child.mjs

@@ -50,17 +50,18 @@ process.once("message", async (message) => {
 				}
 			});
 		}
+		const routes = await collectNamedApiRoutesWithResponses({
+			appRoot: request.cwd,
+			files: filesOrchestrator.files.values(),
+			onWarn: (warning) => {
+				process.stderr.write(`[warlock] ${warning}\n`);
+			}
+		});
 		await sendAndExit({
 			type: "route-registration:snapshot",
 			snapshot: {
 				version: PROTOCOL_VERSION,
-				routes: await collectNamedApiRoutesWithResponses({
-					appRoot: request.cwd,
-					files: filesOrchestrator.files.values(),
-					onWarn: (warning) => {
-						process.stderr.write(`[warlock] ${warning}\n`);
-					}
-				})
+				routes
 			}
 		});
 	} catch (error) {

package/esm/production/route-registration-child.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"route-registration-child.mjs","names":[],"sources":["../../../../../../../../packages/core/src/production/route-registration-child.ts"],"sourcesContent":["import { fileExistsAsync } from \"@warlock.js/fs\";\nimport { Application } from \"../application\";\nimport { bootstrap } from \"../bootstrap\";\nimport { loadConfigFiles } from \"../config/load-config-files\";\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\nimport { buildOpenApiForChild } from \"../openapi/openapi-child-output\";\nimport {\n  OPENAPI_PROTOCOL_VERSION,\n  OPENAPI_RESULT_MESSAGE,\n  parseOpenApiChildOptions,\n  type OpenApiChildRequestOptions,\n} from \"../openapi/openapi-protocol\";\nimport { collectNamedApiRoutesWithResponses } from \"../router/named-api-routes-with-responses\";\nimport { loadEnvironmentFiles } from \"../utils/load-environment\";\nimport { appPath } from \"../utils/paths\";\nimport type { Environment, RuntimeStrategy } from \"../utils/environment\";\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\n\nconst PROTOCOL_VERSION = 1;\n\ntype RequestMessage = Readonly<{\n  version: typeof PROTOCOL_VERSION;\n  cwd: string;\n  environment?: Environment;\n  runtimeStrategy?: RuntimeStrategy;\n  /**\n   * Present for `warlock generate.openapi`: build the OpenAPI document in this process and\n   * send it instead of the route snapshot. The loading above is identical for both.\n   */\n  openapi?: OpenApiChildRequestOptions;\n}>;\n\nprocess.once(\"message\", async (message: unknown) => {\n  try {\n    const request = validateRequest(message);\n    process.chdir(request.cwd);\n\n    if (request.environment) Application.setEnvironment(request.environment);\n    if (request.runtimeStrategy) Application.setRuntimeStrategy(request.runtimeStrategy);\n\n    await loadEnvironmentFiles();\n    await warlockConfigManager.load();\n    await filesOrchestrator.init();\n    await bootstrap();\n\n    if (await fileExistsAsync(appPath(\"bootstrap.ts\"))) {\n      await filesOrchestrator.load(\"src/app/bootstrap.ts\");\n    }\n\n    await filesOrchestrator.initializeAll();\n    filesOrchestrator.specialFilesCollector.collect(filesOrchestrator.getFiles());\n    await loadConfigFiles(true);\n\n    for (const file of filesOrchestrator.files.values()) {\n      if (file.type === \"model\") {\n        await sendProgress(file.relativePath);\n        await filesOrchestrator.moduleLoader.loadModule(file, \"model\");\n      }\n    }\n\n    await filesOrchestrator.moduleLoader.loadAll({\n      onBeforeLoad: (file) => sendProgress(file.relativePath),\n    });\n\n    if (request.openapi) {\n      const { document, warnings } = await buildOpenApiForChild({\n        cwd: request.cwd,\n        files: filesOrchestrator.files.values(),\n        request: request.openapi,\n        onWarn: (warning) => {\n          process.stderr.write(`[warlock] ${warning}\\n`);\n        },\n      });\n\n      await sendAndExit({\n        type: OPENAPI_RESULT_MESSAGE,\n        result: { version: OPENAPI_PROTOCOL_VERSION, document, warnings },\n      });\n    }\n\n    const routes = await collectNamedApiRoutesWithResponses({\n      appRoot: request.cwd,\n      files: filesOrchestrator.files.values(),\n      onWarn: (warning) => {\n        process.stderr.write(`[warlock] ${warning}\\n`);\n      },\n    });\n\n    await sendAndExit({\n      type: \"route-registration:snapshot\",\n      snapshot: { version: PROTOCOL_VERSION, routes },\n    });\n  } catch (error) {\n    const message = error instanceof Error ? error.stack || error.message : String(error);\n    await sendAndExit({ type: \"route-registration:error\", message }, 1);\n  }\n});\n\nfunction validateRequest(value: unknown): RequestMessage {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    (value as { version?: unknown }).version !== PROTOCOL_VERSION ||\n    typeof (value as { cwd?: unknown }).cwd !== \"string\" ||\n    !isOptionalEnvironment((value as { environment?: unknown }).environment) ||\n    !isOptionalRuntimeStrategy((value as { runtimeStrategy?: unknown }).runtimeStrategy)\n  ) {\n    throw new Error(\"Route registration child received an invalid protocol request.\");\n  }\n\n  const openapi = (value as { openapi?: unknown }).openapi;\n\n  if (openapi !== undefined) {\n    parseOpenApiChildOptions(openapi);\n  }\n\n  return value as RequestMessage;\n}\n\nfunction isOptionalEnvironment(value: unknown): value is Environment | undefined {\n  return (\n    value === undefined || value === \"development\" || value === \"production\" || value === \"test\"\n  );\n}\n\nfunction isOptionalRuntimeStrategy(value: unknown): value is RuntimeStrategy | undefined {\n  return value === undefined || value === \"development\" || value === \"production\";\n}\n\nasync function sendAndExit(message: unknown, exitCode = 0): Promise<never> {\n  if (typeof process.send !== \"function\") {\n    throw new Error(\"Route registration child requires an IPC channel.\");\n  }\n\n  await new Promise<void>((resolve, reject) => {\n    process.send!(message, (error) => (error ? reject(error) : resolve()));\n  });\n  process.disconnect?.();\n  process.exit(exitCode);\n}\n\nasync function sendProgress(module: string): Promise<void> {\n  if (typeof process.send !== \"function\") return;\n  await new Promise<void>((resolve, reject) => {\n    process.send!({ type: \"route-registration:progress\", module }, (error) =>\n      error ? reject(error) : resolve(),\n    );\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"route-registration-child.mjs","names":[],"sources":["../../../../../../../../packages/core/src/production/route-registration-child.ts"],"sourcesContent":["import { fileExistsAsync } from \"@warlock.js/fs\";\nimport { Application } from \"../application\";\nimport { bootstrap } from \"../bootstrap\";\nimport { loadConfigFiles } from \"../config/load-config-files\";\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\nimport { buildOpenApiForChild } from \"../openapi/openapi-child-output\";\nimport {\n  OPENAPI_PROTOCOL_VERSION,\n  OPENAPI_RESULT_MESSAGE,\n  parseOpenApiChildOptions,\n  type OpenApiChildRequestOptions,\n} from \"../openapi/openapi-protocol\";\nimport { collectNamedApiRoutesWithResponses } from \"../router/named-api-routes-with-responses\";\nimport { loadEnvironmentFiles } from \"../utils/load-environment\";\nimport { appPath } from \"../utils/paths\";\nimport type { Environment, RuntimeStrategy } from \"../utils/environment\";\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\n\nconst PROTOCOL_VERSION = 1;\n\ntype RequestMessage = Readonly<{\n  version: typeof PROTOCOL_VERSION;\n  cwd: string;\n  environment?: Environment;\n  runtimeStrategy?: RuntimeStrategy;\n  /**\n   * Present for `warlock generate.openapi`: build the OpenAPI document in this process and\n   * send it instead of the route snapshot. The loading above is identical for both.\n   */\n  openapi?: OpenApiChildRequestOptions;\n}>;\n\nprocess.once(\"message\", async (message: unknown) => {\n  try {\n    const request = validateRequest(message);\n    process.chdir(request.cwd);\n\n    if (request.environment) Application.setEnvironment(request.environment);\n    if (request.runtimeStrategy) Application.setRuntimeStrategy(request.runtimeStrategy);\n\n    await loadEnvironmentFiles();\n    await warlockConfigManager.load();\n    await filesOrchestrator.init();\n    await bootstrap();\n\n    if (await fileExistsAsync(appPath(\"bootstrap.ts\"))) {\n      await filesOrchestrator.load(\"src/app/bootstrap.ts\");\n    }\n\n    await filesOrchestrator.initializeAll();\n    filesOrchestrator.specialFilesCollector.collect(filesOrchestrator.getFiles());\n    await loadConfigFiles(true);\n\n    for (const file of filesOrchestrator.files.values()) {\n      if (file.type === \"model\") {\n        await sendProgress(file.relativePath);\n        await filesOrchestrator.moduleLoader.loadModule(file, \"model\");\n      }\n    }\n\n    await filesOrchestrator.moduleLoader.loadAll({\n      onBeforeLoad: (file) => sendProgress(file.relativePath),\n    });\n\n    if (request.openapi) {\n      const { document, warnings } = await buildOpenApiForChild({\n        cwd: request.cwd,\n        files: filesOrchestrator.files.values(),\n        request: request.openapi,\n        onWarn: (warning) => {\n          process.stderr.write(`[warlock] ${warning}\\n`);\n        },\n      });\n\n      await sendAndExit({\n        type: OPENAPI_RESULT_MESSAGE,\n        result: { version: OPENAPI_PROTOCOL_VERSION, document, warnings },\n      });\n    }\n\n    const routes = await collectNamedApiRoutesWithResponses({\n      appRoot: request.cwd,\n      files: filesOrchestrator.files.values(),\n      onWarn: (warning) => {\n        process.stderr.write(`[warlock] ${warning}\\n`);\n      },\n    });\n\n    await sendAndExit({\n      type: \"route-registration:snapshot\",\n      snapshot: { version: PROTOCOL_VERSION, routes },\n    });\n  } catch (error) {\n    const message = error instanceof Error ? error.stack || error.message : String(error);\n    await sendAndExit({ type: \"route-registration:error\", message }, 1);\n  }\n});\n\nfunction validateRequest(value: unknown): RequestMessage {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    (value as { version?: unknown }).version !== PROTOCOL_VERSION ||\n    typeof (value as { cwd?: unknown }).cwd !== \"string\" ||\n    !isOptionalEnvironment((value as { environment?: unknown }).environment) ||\n    !isOptionalRuntimeStrategy((value as { runtimeStrategy?: unknown }).runtimeStrategy)\n  ) {\n    throw new Error(\"Route registration child received an invalid protocol request.\");\n  }\n\n  const openapi = (value as { openapi?: unknown }).openapi;\n\n  if (openapi !== undefined) {\n    parseOpenApiChildOptions(openapi);\n  }\n\n  return value as RequestMessage;\n}\n\nfunction isOptionalEnvironment(value: unknown): value is Environment | undefined {\n  return (\n    value === undefined || value === \"development\" || value === \"production\" || value === \"test\"\n  );\n}\n\nfunction isOptionalRuntimeStrategy(value: unknown): value is RuntimeStrategy | undefined {\n  return value === undefined || value === \"development\" || value === \"production\";\n}\n\nasync function sendAndExit(message: unknown, exitCode = 0): Promise<never> {\n  if (typeof process.send !== \"function\") {\n    throw new Error(\"Route registration child requires an IPC channel.\");\n  }\n\n  await new Promise<void>((resolve, reject) => {\n    process.send!(message, (error) => (error ? reject(error) : resolve()));\n  });\n  process.disconnect?.();\n  process.exit(exitCode);\n}\n\nasync function sendProgress(module: string): Promise<void> {\n  if (typeof process.send !== \"function\") return;\n  await new Promise<void>((resolve, reject) => {\n    process.send!({ type: \"route-registration:progress\", module }, (error) =>\n      error ? reject(error) : resolve(),\n    );\n  });\n}\n"],"mappings":"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"}

package/esm/production/tsconfig-path-aliases.mjs

@@ -95,5 +95,5 @@ function tsconfigPathAliases(options) {
 }
 
 //#endregion
-export { tsconfigPathAliases };
+export { collectWildcardPathAliases, substituteWildcard, tsconfigPathAliases };
 //# sourceMappingURL=tsconfig-path-aliases.mjs.map

package/esm/react/index.d.mts

@@ -1,5 +1,4 @@
 import { ComponentType, ReactElement, ReactNode } from "react";
-
 //#region ../../packages/core/src/react/index.d.ts
 /**
  * Render a React element/component to HTML string
@@ -16,7 +15,6 @@ import { ComponentType, ReactElement, ReactNode } from "react";
  * const html = renderReact(<WelcomeEmail name="John" />);
  * ```
  */
-declare function renderReact(reactElement: ReactElement | ComponentType | ReactNode): string;
+export declare function renderReact(reactElement: ReactElement | ComponentType | ReactNode): string;
 //#endregion
-export { renderReact };
 //# sourceMappingURL=index.d.mts.map

package/esm/react/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/react/index.ts"],"mappings":";;;;;AAwKA;;;;;;;;;;;;;iBAAgB,WAAA,CAAY,YAAA,EAAc,YAAA,GAAe,aAAA,GAAgB,SAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/react/index.ts"],"mappings":";;;;;;;;;;;;;;;;;wBAwKgB,YAAY,cAAc,eAAe,gBAAgB"}

package/esm/react/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../../packages/core/src/react/index.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport type { ComponentType, ReactElement, ReactNode } from \"react\";\n\n// ============================================================\n// Lazily Resolved React Modules\n// ============================================================\n\n/**\n * Installation instructions for React\n */\nconst REACT_INSTALL_INSTRUCTIONS = `\nReact SSR functionality requires React packages.\nInstall them with:\n\n  warlock add react\n\nOr manually:\n\n  npm install react react-dom\n  pnpm add react react-dom\n  yarn add react react-dom\n`.trim();\n\n/**\n * Cached React modules, populated by the first `resolveReactModules()` call\n */\nlet react: typeof import(\"react\") | null = null;\nlet reactDomServer: typeof import(\"react-dom/server\") | null = null;\n\n/**\n * Whether the resolution attempt already ran (success or failure)\n */\nlet reactResolved = false;\n\n/**\n * Why the resolution failed, when it failed.\n *\n * Cached and re-thrown on every later call: the resolution attempt runs exactly\n * once, so without this the second `renderReact()` would skip the attempt and\n * fall through to the \"not installed\" branch, reporting a different, wrong\n * cause one call after the accurate one.\n */\nlet reactLoadError: Error | null = null;\n\n/**\n * `new Error(message, { cause })` is ES2022, and this package still compiles\n * against the ES2020 lib (see #16), where `Error` is typed as taking a message\n * only. Node has supported the option since v16, so this is the type layer\n * catching up with the runtime, not a change in what the code does.\n */\ntype ErrorWithCauseConstructor = new (message: string, options: { cause: unknown }) => Error;\n\nconst ErrorWithCause = Error as ErrorWithCauseConstructor;\n\n/**\n * Whether `error` says `specifier` itself is absent, as opposed to present but\n * broken.\n *\n * Both halves are load-bearing. `MODULE_NOT_FOUND` alone is not enough: a\n * dependency missing *inside* react raises the very same code (`Cannot find\n * module 'scheduler'`), and treating that as absence would tell the operator to\n * install a package they already have. So the message has to name the specifier\n * exactly — quoted, which is also what stops `'react-dom'` from matching a\n * check for `'react'`.\n */\nfunction isModuleMissing(error: unknown, specifier: string): boolean {\n  if (!(error instanceof Error)) return false;\n\n  return (\n    (error as NodeJS.ErrnoException).code === \"MODULE_NOT_FOUND\" &&\n    error.message.includes(`Cannot find module '${specifier}'`)\n  );\n}\n\n/**\n * Require one module, translating its failure into a message that names the\n * specifier that actually failed.\n *\n * The two specifiers are resolved separately and reported separately: a broken\n * `react-dom/server` must never be announced as \"react is not installed\", since\n * that sends the operator to fix a package that is already fine.\n */\nfunction requireModule<T>(require: NodeRequire, specifier: string): T {\n  try {\n    const module = require(specifier);\n\n    return (module.default ?? module) as T;\n  } catch (error) {\n    if (isModuleMissing(error, specifier)) {\n      throw new Error(`${specifier} is not installed.\\n\\n${REACT_INSTALL_INSTRUCTIONS}`);\n    }\n\n    // The package is there, it just would not load. Its own error names the\n    // real cause, so it is inlined *and* chained: a terminal that never prints\n    // `cause` must still show the text that actually helps.\n    throw new ErrorWithCause(`Failed to load \"${specifier}\": ${(error as Error).message}`, {\n      cause: error,\n    });\n  }\n}\n\n/**\n * Resolve the React modules synchronously, on first use.\n *\n * Resolution is deliberately *lazy* and *synchronous*:\n *\n * - Lazy, because a top-level require would drag react and react-dom into every\n *   `import \"@warlock.js/core\"`, including apps that never render a component.\n * - Synchronous, because `renderReact()` is synchronous. An async import kicked\n *   off at module load leaves a window in which the modules are neither loaded\n *   nor known to be missing, and a render running inside that window has no\n *   correct answer to give — it used to read `createElement` off `undefined`.\n *\n * `createRequire` gives an ESM-safe `require`, and the outcome — modules,\n * absence or load failure — is cached, so resolution runs exactly once per\n * process. The failure *reason* is cached too, not just the fact of it: every\n * call after a failed load has to report the same cause as the first one.\n *\n * @throws when react or react-dom is not installed, or cannot be loaded\n */\nfunction resolveReactModules() {\n  if (!reactResolved) {\n    reactResolved = true;\n\n    try {\n      const require = createRequire(import.meta.url);\n      react = requireModule<typeof import(\"react\")>(require, \"react\");\n      reactDomServer = requireModule<typeof import(\"react-dom/server\")>(\n        require,\n        \"react-dom/server\",\n      );\n    } catch (error) {\n      react = null;\n      reactDomServer = null;\n      reactLoadError = error as Error;\n    }\n  }\n\n  if (reactLoadError) {\n    throw reactLoadError;\n  }\n\n  if (!react || !reactDomServer) {\n    throw new Error(`react is not installed.\\n\\n${REACT_INSTALL_INSTRUCTIONS}`);\n  }\n\n  return { react, reactDomServer };\n}\n\n// ============================================================\n// Render Function\n// ============================================================\n\n/**\n * Render a React element/component to HTML string\n *\n * **Important:** This function requires React packages to be installed.\n * Install them with: `warlock add react` or `yarn add react react-dom`\n *\n * React is resolved synchronously on the first call that needs it, so this\n * function stays synchronous and missing packages throw here rather than\n * surfacing later as a read off an undefined module.\n *\n * @example\n * ```typescript\n * const html = renderReact(<WelcomeEmail name=\"John\" />);\n * ```\n */\nexport function renderReact(reactElement: ReactElement | ComponentType | ReactNode): string {\n  const { react, reactDomServer } = resolveReactModules();\n\n  if (typeof reactElement === \"function\") {\n    reactElement = react.createElement(reactElement);\n  }\n\n  return reactDomServer.renderToString(reactElement);\n}\n"],"mappings":";;;;;;AAUA,MAAM,6BAA6B;;;;;;;;;;;EAWjC,KAAK;;;;AAKP,IAAI,QAAuC;AAC3C,IAAI,iBAA2D;;;;AAK/D,IAAI,gBAAgB;;;;;;;;;AAUpB,IAAI,iBAA+B;AAUnC,MAAM,iBAAiB;;;;;;;;;;;;AAavB,SAAS,gBAAgB,OAAgB,WAA4B;CACnE,IAAI,EAAE,iBAAiB,QAAQ,OAAO;CAEtC,OACG,MAAgC,SAAS,sBAC1C,MAAM,QAAQ,SAAS,uBAAuB,UAAU,EAAE;AAE9D;;;;;;;;;AAUA,SAAS,cAAiB,SAAsB,WAAsB;CACpE,IAAI;EACF,MAAM,SAAS,QAAQ,SAAS;EAEhC,OAAQ,OAAO,WAAW;CAC5B,SAAS,OAAO;EACd,IAAI,gBAAgB,OAAO,SAAS,GAClC,MAAM,IAAI,MAAM,GAAG,UAAU,wBAAwB,4BAA4B;EAMnF,MAAM,IAAI,eAAe,mBAAmB,UAAU,KAAM,MAAgB,WAAW,EACrF,OAAO,MACT,CAAC;CACH;AACF;;;;;;;;;;;;;;;;;;;;AAqBA,SAAS,sBAAsB;CAC7B,IAAI,CAAC,eAAe;EAClB,gBAAgB;EAEhB,IAAI;GACF,MAAM,UAAU,cAAc,OAAO,KAAK,GAAG;GAC7C,QAAQ,cAAsC,SAAS,OAAO;GAC9D,iBAAiB,cACf,SACA,kBACF;EACF,SAAS,OAAO;GACd,QAAQ;GACR,iBAAiB;GACjB,iBAAiB;EACnB;CACF;CAEA,IAAI,gBACF,MAAM;CAGR,IAAI,CAAC,SAAS,CAAC,gBACb,MAAM,IAAI,MAAM,8BAA8B,4BAA4B;CAG5E,OAAO;EAAE;EAAO;CAAe;AACjC;;;;;;;;;;;;;;;;AAqBA,SAAgB,YAAY,cAAgE;CAC1F,MAAM,EAAE,OAAO,mBAAmB,oBAAoB;CAEtD,IAAI,OAAO,iBAAiB,YAC1B,eAAe,MAAM,cAAc,YAAY;CAGjD,OAAO,eAAe,eAAe,YAAY;AACnD"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../../packages/core/src/react/index.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport type { ComponentType, ReactElement, ReactNode } from \"react\";\n\n// ============================================================\n// Lazily Resolved React Modules\n// ============================================================\n\n/**\n * Installation instructions for React\n */\nconst REACT_INSTALL_INSTRUCTIONS = `\nReact SSR functionality requires React packages.\nInstall them with:\n\n  warlock add react\n\nOr manually:\n\n  npm install react react-dom\n  pnpm add react react-dom\n  yarn add react react-dom\n`.trim();\n\n/**\n * Cached React modules, populated by the first `resolveReactModules()` call\n */\nlet react: typeof import(\"react\") | null = null;\nlet reactDomServer: typeof import(\"react-dom/server\") | null = null;\n\n/**\n * Whether the resolution attempt already ran (success or failure)\n */\nlet reactResolved = false;\n\n/**\n * Why the resolution failed, when it failed.\n *\n * Cached and re-thrown on every later call: the resolution attempt runs exactly\n * once, so without this the second `renderReact()` would skip the attempt and\n * fall through to the \"not installed\" branch, reporting a different, wrong\n * cause one call after the accurate one.\n */\nlet reactLoadError: Error | null = null;\n\n/**\n * `new Error(message, { cause })` is ES2022, and this package still compiles\n * against the ES2020 lib (see #16), where `Error` is typed as taking a message\n * only. Node has supported the option since v16, so this is the type layer\n * catching up with the runtime, not a change in what the code does.\n */\ntype ErrorWithCauseConstructor = new (message: string, options: { cause: unknown }) => Error;\n\nconst ErrorWithCause = Error as ErrorWithCauseConstructor;\n\n/**\n * Whether `error` says `specifier` itself is absent, as opposed to present but\n * broken.\n *\n * Both halves are load-bearing. `MODULE_NOT_FOUND` alone is not enough: a\n * dependency missing *inside* react raises the very same code (`Cannot find\n * module 'scheduler'`), and treating that as absence would tell the operator to\n * install a package they already have. So the message has to name the specifier\n * exactly — quoted, which is also what stops `'react-dom'` from matching a\n * check for `'react'`.\n */\nfunction isModuleMissing(error: unknown, specifier: string): boolean {\n  if (!(error instanceof Error)) return false;\n\n  return (\n    (error as NodeJS.ErrnoException).code === \"MODULE_NOT_FOUND\" &&\n    error.message.includes(`Cannot find module '${specifier}'`)\n  );\n}\n\n/**\n * Require one module, translating its failure into a message that names the\n * specifier that actually failed.\n *\n * The two specifiers are resolved separately and reported separately: a broken\n * `react-dom/server` must never be announced as \"react is not installed\", since\n * that sends the operator to fix a package that is already fine.\n */\nfunction requireModule<T>(require: NodeRequire, specifier: string): T {\n  try {\n    const module = require(specifier);\n\n    return (module.default ?? module) as T;\n  } catch (error) {\n    if (isModuleMissing(error, specifier)) {\n      throw new Error(`${specifier} is not installed.\\n\\n${REACT_INSTALL_INSTRUCTIONS}`);\n    }\n\n    // The package is there, it just would not load. Its own error names the\n    // real cause, so it is inlined *and* chained: a terminal that never prints\n    // `cause` must still show the text that actually helps.\n    throw new ErrorWithCause(`Failed to load \"${specifier}\": ${(error as Error).message}`, {\n      cause: error,\n    });\n  }\n}\n\n/**\n * Resolve the React modules synchronously, on first use.\n *\n * Resolution is deliberately *lazy* and *synchronous*:\n *\n * - Lazy, because a top-level require would drag react and react-dom into every\n *   `import \"@warlock.js/core\"`, including apps that never render a component.\n * - Synchronous, because `renderReact()` is synchronous. An async import kicked\n *   off at module load leaves a window in which the modules are neither loaded\n *   nor known to be missing, and a render running inside that window has no\n *   correct answer to give — it used to read `createElement` off `undefined`.\n *\n * `createRequire` gives an ESM-safe `require`, and the outcome — modules,\n * absence or load failure — is cached, so resolution runs exactly once per\n * process. The failure *reason* is cached too, not just the fact of it: every\n * call after a failed load has to report the same cause as the first one.\n *\n * @throws when react or react-dom is not installed, or cannot be loaded\n */\nfunction resolveReactModules() {\n  if (!reactResolved) {\n    reactResolved = true;\n\n    try {\n      const require = createRequire(import.meta.url);\n      react = requireModule<typeof import(\"react\")>(require, \"react\");\n      reactDomServer = requireModule<typeof import(\"react-dom/server\")>(\n        require,\n        \"react-dom/server\",\n      );\n    } catch (error) {\n      react = null;\n      reactDomServer = null;\n      reactLoadError = error as Error;\n    }\n  }\n\n  if (reactLoadError) {\n    throw reactLoadError;\n  }\n\n  if (!react || !reactDomServer) {\n    throw new Error(`react is not installed.\\n\\n${REACT_INSTALL_INSTRUCTIONS}`);\n  }\n\n  return { react, reactDomServer };\n}\n\n// ============================================================\n// Render Function\n// ============================================================\n\n/**\n * Render a React element/component to HTML string\n *\n * **Important:** This function requires React packages to be installed.\n * Install them with: `warlock add react` or `yarn add react react-dom`\n *\n * React is resolved synchronously on the first call that needs it, so this\n * function stays synchronous and missing packages throw here rather than\n * surfacing later as a read off an undefined module.\n *\n * @example\n * ```typescript\n * const html = renderReact(<WelcomeEmail name=\"John\" />);\n * ```\n */\nexport function renderReact(reactElement: ReactElement | ComponentType | ReactNode): string {\n  const { react, reactDomServer } = resolveReactModules();\n\n  if (typeof reactElement === \"function\") {\n    reactElement = react.createElement(reactElement);\n  }\n\n  return reactDomServer.renderToString(reactElement);\n}\n"],"mappings":";;;;;;AAUA,MAAM,6BAA6B;;;;;;;;;;;EAWjC,KAAK;;;;AAKP,IAAI,QAAuC;AAC3C,IAAI,iBAA2D;;;;AAK/D,IAAI,gBAAgB;;;;;;;;;AAUpB,IAAI,iBAA+B;AAUnC,MAAM,iBAAiB;;;;;;;;;;;;AAavB,SAAS,gBAAgB,OAAgB,WAA4B;CACnE,IAAI,EAAE,iBAAiB,QAAQ,OAAO;CAEtC,OACG,MAAgC,SAAS,sBAC1C,MAAM,QAAQ,SAAS,uBAAuB,UAAU,EAAE;AAE9D;;;;;;;;;AAUA,SAAS,cAAiB,SAAsB,WAAsB;CACpE,IAAI;EACF,MAAM,SAAS,QAAQ,SAAS;EAEhC,OAAQ,OAAO,WAAW;CAC5B,SAAS,OAAO;EACd,IAAI,gBAAgB,OAAO,SAAS,GAClC,MAAM,IAAI,MAAM,GAAG,UAAU,wBAAwB,4BAA4B;EAMnF,MAAM,IAAI,eAAe,mBAAmB,UAAU,KAAM,MAAgB,WAAW,EACrF,OAAO,MACT,CAAC;CACH;AACF;;;;;;;;;;;;;;;;;;;;AAqBA,SAAS,sBAAsB;CAC7B,IAAI,CAAC,eAAe;EAClB,gBAAgB;EAEhB,IAAI;GACF,MAAM,UAAU,cAAc,YAAY,GAAG;GAC7C,QAAQ,cAAsC,SAAS,OAAO;GAC9D,iBAAiB,cACf,SACA,kBACF;EACF,SAAS,OAAO;GACd,QAAQ;GACR,iBAAiB;GACjB,iBAAiB;EACnB;CACF;CAEA,IAAI,gBACF,MAAM;CAGR,IAAI,CAAC,SAAS,CAAC,gBACb,MAAM,IAAI,MAAM,8BAA8B,4BAA4B;CAG5E,OAAO;EAAE;EAAO;CAAe;AACjC;;;;;;;;;;;;;;;;AAqBA,SAAgB,YAAY,cAAgE;CAC1F,MAAM,EAAE,OAAO,mBAAmB,oBAAoB;CAEtD,IAAI,OAAO,iBAAiB,YAC1B,eAAe,MAAM,cAAc,YAAY;CAGjD,OAAO,eAAe,eAAe,YAAY;AACnD"}

package/esm/repositories/adapters/cascade/cascade-adapter.d.mts

@@ -1,18 +1,18 @@
 import { RepositoryAdapterContract } from "../../contracts/repository-adapter.contract.mjs";
 import { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, PaginationResult } from "../../contracts/types.mjs";
 import { QueryBuilderContract as QueryBuilderContract$1 } from "../../contracts/query-builder.contract.mjs";
+import "../../contracts/index.mjs";
 import { ChildModel, Model } from "@warlock.js/cascade";
-
 //#region ../../packages/core/src/repositories/adapters/cascade/cascade-adapter.d.ts
 /** Records loaded and written per `updateMany` batch. */
-declare const UPDATE_MANY_BATCH_SIZE = 500;
+export declare const UPDATE_MANY_BATCH_SIZE = 500;
 /**
  * Cascade adapter for Cascade-Next ORM
  * Implements RepositoryAdapterContract for @warlock.js/cascade
  *
  * @template T - The model instance type
  */
-declare class CascadeAdapter<T extends Model<any>> implements RepositoryAdapterContract<T> {
+export declare class CascadeAdapter<T extends Model<any>> implements RepositoryAdapterContract<T> {
   private model;
   /**
    * Constructor
@@ -89,5 +89,4 @@ declare class CascadeAdapter<T extends Model<any>> implements RepositoryAdapterC
   createModel(data: any): T;
 }
 //#endregion
-export { CascadeAdapter, UPDATE_MANY_BATCH_SIZE };
 //# sourceMappingURL=cascade-adapter.d.mts.map

package/esm/repositories/adapters/cascade/cascade-adapter.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cascade-adapter.d.mts","names":[],"sources":["../../../../../../../../../../packages/core/src/repositories/adapters/cascade/cascade-adapter.ts"],"mappings":";;;;;;;cAYa,sBAAA;;;;AAAb;;;cAQa,cAAA,WAAyB,KAAA,kBAAuB,yBAAA,CAA0B,CAAA;EAAA,QAK1D,KAAA;EALhB;;;;cAKgB,KAAA,EAAO,UAAA,CAAW,CAAA;EAAA;;;EAStC,KAAA,IAAS,sBAAA,CAAqB,CAAA;EAoCD;;;EA7B7B,cAAA,CAAe,cAAA;EA2CO;;;EAdhB,IAAA,CAAK,EAAA,QAAU,OAAA,CAAQ,CAAA;EA0Ca;;;EAnCpC,MAAA,CAAO,MAAA,UAAgB,KAAA,QAAa,OAAA,CAAQ,CAAA;EAoGnB;;;EA7F/B,cAAA,CAAe,KAAA,EAAO,CAAA;EAwIuB;;;EAjI7C,gBAAA,CAAiB,IAAA,QAAY,CAAA;EA0IjC;;;EAnII,qBAAA;EAyJwB;;;EAlJlB,MAAA,CAAO,IAAA,QAAY,OAAA,CAAQ,CAAA;EArFd;;;EA4Fb,MAAA,CAAO,EAAA,OAAS,IAAA,QAAY,OAAA,CAAQ,CAAA;EAvFtB;;;EAoGd,MAAA,CAAO,EAAA,QAAU,OAAA;EApGH;;;EAoHd,UAAA,CAAW,MAAA,OAAa,IAAA,QAAY,OAAA;EApG1C;;;EAwIM,UAAA,CAAW,MAAA,QAAc,OAAA;EA3GV;;;EAqIf,KAAA,CAAM,MAAA,SAAe,OAAA;EA9HE;;;EA+IvB,QAAA,CAAS,IAAA,UAAc,KAAA,WAAgB,OAAA,CAAQ,gBAAA,CAAiB,CAAA;EAxIhD;;;EA+IhB,cAAA,CACX,OAAA,EAAS,uBAAA,GACR,OAAA,CAAQ,sBAAA,CAAuB,CAAA;EA1IE;;;EAqJvB,KAAA,CAAM,IAAA,UAAc,QAAA,EAAU,aAAA,CAAc,CAAA,IAAK,OAAA;EAvI9B;;;EAkJzB,WAAA,CAAY,IAAA,QAAY,CAAA;AAAA"}
+{"version":3,"file":"cascade-adapter.d.mts","names":["QueryBuilderContract"],"sources":["../../../../../../../../../../packages/core/src/repositories/adapters/cascade/cascade-adapter.ts"],"mappings":";;;;;;;qBAYa;;;;;;;qBAQA,eAAe,UAAU,uBAAuB,0BAA0B;UAK1D;;;;;EAA3B,YAA2B,OAAO,WAAW;;;;EAStC,SAASA,uBAAqB;;;;EAO9B,eAAe;;;;EA6BT,KAAK,UAAU,QAAQ;;;;EAOvB,OAAO,gBAAgB,aAAa,QAAQ;;;;EAOlD,eAAe,OAAO;;;;EAOtB,iBAAiB,YAAY;;;;EAO7B;;;;EAOM,OAAO,YAAY,QAAQ;;;;EAO3B,OAAO,SAAS,YAAY,QAAQ;;;;EAapC,OAAO,UAAU;;;;EAgBjB,WAAW,aAAa,YAAY;;;;EAoCpC,WAAW,cAAc;;;;EA0BzB,MAAM,eAAe;;;;EAiBrB,SAAS,cAAc,gBAAgB,QAAQ,iBAAiB;;;;EAOhE,eACX,SAAS,0BACR,QAAQ,uBAAuB;;;;EAWrB,MAAM,cAAc,UAAU,cAAc,KAAK;;;;EAWvD,YAAY,YAAY"}

package/esm/repositories/adapters/cascade/cascade-query-builder.d.mts

@@ -1,7 +1,7 @@
 import { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, FilterOptions, FilterRules, PaginationResult, WhereOperator } from "../../contracts/types.mjs";
 import { AggregateExpressions, GroupByFields, QueryBuilderContract as QueryBuilderContract$1 } from "../../contracts/query-builder.contract.mjs";
+import "../../contracts/index.mjs";
 import { Model, QueryBuilderContract } from "@warlock.js/cascade";
-
 //#region ../../packages/core/src/repositories/adapters/cascade/cascade-query-builder.d.ts
 /**
  * Cascade query builder wrapper
@@ -9,7 +9,7 @@ import { Model, QueryBuilderContract } from "@warlock.js/cascade";
  *
  * @template T - The model instance type
  */
-declare class CascadeQueryBuilder<T extends Model> implements QueryBuilderContract$1<T> {
+export declare class CascadeQueryBuilder<T extends Model> implements QueryBuilderContract$1<T> {
   private query;
   /**
    * Constructor
@@ -178,5 +178,4 @@ declare class CascadeQueryBuilder<T extends Model> implements QueryBuilderContra
   clone(): this;
 }
 //#endregion
-export { CascadeQueryBuilder };
 //# sourceMappingURL=cascade-query-builder.d.mts.map

package/esm/repositories/adapters/cascade/cascade-query-builder.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cascade-query-builder.d.mts","names":[],"sources":["../../../../../../../../../../packages/core/src/repositories/adapters/cascade/cascade-query-builder.ts"],"mappings":";;;;;;;;;AAwBA;;cAAa,mBAAA,WAA8B,KAAA,aAAkB,sBAAA,CAAqB,CAAA;EAAA,QAKrD,KAAA;EALqD;;;;cAKrD,KAAA,EAAO,oBAAA,CAA4B,CAAA;EA8CtB;;;EArCjC,KAAA,CAAM,KAAA,UAAe,KAAA;EACrB,KAAA,CAAM,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAC9C,KAAA,CAAM,UAAA,EAAY,MAAA;EAClB,KAAA,CAAM,QAAA,GAAW,KAAA;EAiOM;;;EAvMvB,MAAA;EA4N0B;;;EArN1B,OAAA,CAAQ,KAAA,UAAe,KAAA;EACvB,OAAA,CAAQ,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAChD,OAAA,CAAQ,UAAA,EAAY,MAAA;EA2OhB;;;EAvNJ,OAAA,CAAQ,KAAA,UAAe,MAAA;EAmOnB;;;EA3NJ,UAAA,CAAW,KAAA,UAAe,MAAA;EAmOmB;;;EA3N7C,SAAA,CAAU,KAAA;EA2Pd;;;EAnPI,YAAA,CAAa,KAAA;EAhGuC;;;EAwGpD,YAAA,CAAa,KAAA,UAAe,KAAA;EAxGM;;;EAgHlC,SAAA,CAAU,KAAA,UAAe,OAAA;;;;EAQzB,SAAA,CAAU,MAAA,UAAgB,SAAA,YAAqB,KAAA;EA1G/C;;;EAsHA,MAAA,CAAO,MAAA;EACP,MAAA,IAAU,MAAA;EAtHqB;;;EAmI/B,QAAA,CAAS,MAAA;EACT,QAAA,IAAY,MAAA;EAnIN;;;EAoJN,OAAA,CAAQ,KAAA,UAAe,SAAA;EAzHvB;;;EAiIA,MAAA,CAAO,OAAA,EAAS,MAAA;EAzHhB;;;EAoIA,MAAA,CAAO,KAAA;EApIyC;;;EAgJhD,KAAA,CAAM,KAAA;EA3HN;;;EAmIA,MAAA,CAAO,MAAA;EA3HI;;;EAmIX,IAAA,CAAK,KAAA;EAnHL;;;EA8HA,YAAA,CAAa,OAAA,EAAS,WAAA,QAAmB,IAAA,OAAW,OAAA,EAAS,aAAA;EAtHjC;;;EAmItB,GAAA,IAAO,OAAA,CAAQ,CAAA;EAnHrB;;;EA0HM,KAAA,IAAS,OAAA,CAAQ,CAAA;EA9GvB;;;EAqHM,KAAA,IAAS,OAAA;EAvGf;;;EA8GM,GAAA,CAAI,KAAA,WAAgB,OAAA;EA5F1B;;;EAmGM,GAAA,CAAI,KAAA,WAAgB,OAAA;EA3FV;;;EAkGV,GAAA,CAAI,KAAA,WAAgB,OAAA;EA3E1B;;;EAkFM,GAAA,CAAI,KAAA,WAAgB,OAAA;EAlE1B;;;EAyEM,OAAA,KAAY,MAAA,mBACvB,MAAA,EAAQ,aAAA,EACR,UAAA,EAAY,oBAAA,GACX,OAAA,CAAQ,CAAA;EAjES;;;;;;EA2EP,SAAA,KAAc,MAAA,mBACzB,UAAA,EAAY,oBAAA,GACX,OAAA,CAAQ,CAAA;EAzDE;;;EAiEA,QAAA,CAAS,IAAA,UAAc,KAAA,WAAgB,OAAA,CAAQ,gBAAA,CAAiB,CAAA;EA1DvD;;;;;;;;;;;;;;;;;EAwFT,cAAA,CACX,OAAA,EAAS,uBAAA,GACR,OAAA,CAAQ,sBAAA,CAAuB,CAAA;EArDpB;;;EAiHD,KAAA,CAAM,IAAA,UAAc,QAAA,EAAU,aAAA,CAAc,CAAA,IAAK,OAAA;EAtGjD;;;EAiHN,IAAA,CAAK,QAAA;EAhHV;;;EAwHK,QAAA,IAAY,SAAA;EA/GG;;;EAgIf,KAAA;AAAA"}
+{"version":3,"file":"cascade-query-builder.d.mts","names":["CascadeQueryBuilderContract","QueryBuilderContract"],"sources":["../../../../../../../../../../packages/core/src/repositories/adapters/cascade/cascade-query-builder.ts"],"mappings":";;;;;;;;;;;qBAwBa,oBAAoB,UAAU,kBAAkBC,uBAAqB;UAKrD;;;;;EAA3B,YAA2B,OAAOD,qBAA4B;;;;EASvD,MAAM,eAAe;EACrB,MAAM,eAAe,UAAU,eAAe;EAC9C,MAAM,YAAY;EAClB,MAAM,WAAW;;;;EA0BjB;;;;EAOA,QAAQ,eAAe;EACvB,QAAQ,eAAe,UAAU,eAAe;EAChD,QAAQ,YAAY;;;;EAoBpB,QAAQ,eAAe;;;;EAQvB,WAAW,eAAe;;;;EAQ1B,UAAU;;;;EAQV,aAAa;;;;EAQb,aAAa,eAAe;;;;EAQ5B,UAAU,eAAe;;;;EAQzB,UAAU,gBAAgB,qBAAqB;;;;EAY/C,OAAO;EACP,UAAU;;;;EAaV,SAAS;EACT,YAAY;;;;EAiBZ,QAAQ,eAAe;;;;EAQvB,OAAO,SAAS;;;;EAWhB,OAAO;;;;EAYP,MAAM;;;;EAQN,OAAO;;;;EAQP,KAAK;;;;EAWL,aAAa,SAAS,mBAAmB,WAAW,SAAS;;;;EAavD,OAAO,QAAQ;;;;EAOf,SAAS,QAAQ;;;;EAOjB,SAAS;;;;EAOT,IAAI,gBAAgB;;;;EAOpB,IAAI,gBAAgB;;;;EAOpB,IAAI,gBAAgB;;;;EAOpB,IAAI,gBAAgB;;;;EAOpB,QAAQ,IAAI,yBACvB,QAAQ,eACR,YAAY,uBACX,QAAQ;;;;;;;EAUE,UAAU,IAAI,yBACzB,YAAY,uBACX,QAAQ;;;;EAQE,SAAS,cAAc,gBAAgB,QAAQ,iBAAiB;;;;;;;;;;;;;;;;;;EA8BhE,eACX,SAAS,0BACR,QAAQ,uBAAuB;;;;EA4DrB,MAAM,cAAc,UAAU,cAAc,KAAK;;;;EAWvD,KAAK;;;;EAQL,YAAY;;;;EAiBZ"}

package/esm/repositories/adapters/cascade/filter-applicator.mjs

@@ -187,13 +187,13 @@ var FilterApplicator = class {
 			case "between":
 				query.whereBetween(column, value);
 				break;
-			case "not between":
-				query.whereNotBetween(column, value);
-				break;
+			case "not between": query.whereNotBetween(column, value);
+		}
+		else if (columns) {
+			if (operator === "=") this.anyOf(query, columns, (q, col) => q.where(col, value));
+			else if (operator === "like") this.anyOf(query, columns, (q, col) => q.where(col, "like", this.likePattern(value)));
+			else throw new Error(`Unsupported multi-column filter operator "${operator}" for rule "${ruleName ?? columns.join(",")}". Multi-column filters only support "=" and "like".`);
 		}
-		else if (columns) if (operator === "=") this.anyOf(query, columns, (q, col) => q.where(col, value));
-		else if (operator === "like") this.anyOf(query, columns, (q, col) => q.where(col, "like", this.likePattern(value)));
-		else throw new Error(`Unsupported multi-column filter operator "${operator}" for rule "${ruleName ?? columns.join(",")}". Multi-column filters only support "=" and "like".`);
 	}
 	/**
 	* Apply a condition across several columns as ONE grouped OR: `(a OR b OR ...)`.
@@ -370,9 +370,10 @@ var FilterApplicator = class {
 	}
 	handleDateComparison(query, column, columns, value, options, operator) {
 		const dateValue = this.parseDate(value, options?.dateFormat);
-		if (column) if (operator === ">" || operator === ">=") query.whereDateAfter(column, dateValue);
-		else query.whereDateBefore(column, dateValue);
-		else if (columns) {
+		if (column) {
+			if (operator === ">" || operator === ">=") query.whereDateAfter(column, dateValue);
+			else query.whereDateBefore(column, dateValue);
+		} else if (columns) {
 			const after = operator === ">" || operator === ">=";
 			this.anyOf(query, columns, (q, col) => after ? q.whereDateAfter(col, dateValue) : q.whereDateBefore(col, dateValue));
 		}

package/esm/repositories/adapters/cascade/filter-applicator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"filter-applicator.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/repositories/adapters/cascade/filter-applicator.ts"],"sourcesContent":["import type {\n  QueryBuilderContract as CascadeQueryBuilder,\n  QueryBuilderContract,\n} from \"@warlock.js/cascade\";\nimport dayjs from \"dayjs\";\nimport customParseFormat from \"dayjs/plugin/customParseFormat.js\";\nimport { BadRequestError } from \"../../../http/errors/errors\";\nimport type { FilterOptions, FilterRule, FilterRules } from \"../../contracts\";\n\ndayjs.extend(customParseFormat);\n\n/**\n * Applies repository filters to a Cascade-Next query builder\n * Translates repository filter rules into Cascade query builder method calls\n */\nexport class FilterApplicator {\n  /**\n   * Apply filters to a Cascade query builder\n   *\n   * @param query - Cascade query builder instance\n   * @param filters - Filter structure defining how to filter\n   * @param data - Data containing filter values\n   * @param options - Additional filter options (date formats, etc.)\n   */\n  public apply(\n    query: CascadeQueryBuilder<any>,\n    filters: FilterRules,\n    data: any,\n    options: FilterOptions,\n  ): void {\n    // `Object.entries` hands the rule over already narrowed; a `for...in` index\n    // read is `FilterRule | undefined` under the strictness contract.\n    for (const [key, filterRule] of Object.entries(filters)) {\n      const value = data[key];\n\n      if (value === undefined) continue;\n      if (filterRule === undefined) continue;\n\n      const rule = this.parseFilterRule(key, filterRule);\n      this.applyFilterRule(query, rule, value, data, options);\n    }\n  }\n\n  /**\n   * Parse a filter rule into a structured format\n   */\n  private parseFilterRule(key: string, rule: FilterRule) {\n    // Handle custom function\n    if (typeof rule === \"function\") {\n      return { type: \"function\", fn: rule, column: key, key };\n    }\n\n    // Handle array format: [\"operator\"] or [\"operator\", \"column\"] or [\"operator\", [\"col1\", \"col2\"]]\n    if (Array.isArray(rule)) {\n      const [operator, target] = rule;\n\n      if (target === undefined) {\n        return { type: operator, column: key, columns: undefined, key };\n      }\n\n      if (Array.isArray(target)) {\n        return { type: operator, column: undefined, columns: target, key };\n      }\n\n      return { type: operator, column: target, columns: undefined, key };\n    }\n\n    // Handle simple operator string\n    return { type: rule, column: key, columns: undefined, key };\n  }\n\n  /**\n   * Apply a single filter rule to the query\n   */\n  private applyFilterRule(\n    query: CascadeQueryBuilder<any>,\n    rule: any,\n    value: any,\n    data: any,\n    options: FilterOptions,\n  ): void {\n    // 1. Custom function filter\n    if (rule.type === \"function\") {\n      rule.fn(value, query, data);\n      return;\n    }\n\n    // 2. Predefined filter types\n    const handler = this.getFilterHandler(rule.type);\n    if (handler) {\n      handler.call(this, query, rule.column, rule.columns, value, options);\n      return;\n    }\n\n    // 3. Standard where operators\n    this.applyWhereOperator(query, rule.type, rule.column, rule.columns, value, rule.key);\n  }\n\n  /**\n   * Get filter handler for predefined types\n   */\n  private getFilterHandler(type: string): Function | undefined {\n    const handlers: Record<string, Function> = {\n      // Boolean filters\n      bool: this.handleBoolean,\n      boolean: this.handleBoolean,\n\n      // Numeric filters\n      int: this.handleInt,\n      integer: this.handleInt,\n      \"!int\": this.handleNotInt,\n      \"int>\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \">\"),\n      \"int>=\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \">=\"),\n      \"int<\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \"<\"),\n      \"int<=\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \"<=\"),\n      inInt: this.handleInInt,\n      number: this.handleNumber,\n      inNumber: this.handleInNumber,\n      float: this.handleFloat,\n      double: this.handleFloat,\n      inFloat: this.handleInNumber,\n\n      // Null filters\n      null: this.handleNull,\n      notNull: this.handleNotNull,\n      \"!null\": this.handleNotNull,\n\n      // Date filters\n      date: this.handleDate,\n      \"date>\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \">\"),\n      \"date>=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \">=\"),\n      \"date<\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \"<\"),\n      \"date<=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \"<=\"),\n      dateBetween: this.handleDateBetween,\n      inDate: this.handleInDate,\n\n      // DateTime filters\n      dateTime: this.handleDateTime,\n      \"dateTime>\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \">\"),\n      \"dateTime>=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \">=\"),\n      \"dateTime<\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \"<\"),\n      \"dateTime<=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \"<=\"),\n      dateTimeBetween: this.handleDateTimeBetween,\n      inDateTime: this.handleInDateTime,\n\n      // Scope filter - applies local scope when value is truthy\n      scope: this.handleScope,\n\n      // With filter - eager-loads a relation when value is truthy\n      with: this.handleWith,\n\n      // JoinWith filter - eager-loads a relation via SQL JOIN when value is truthy\n      joinWith: this.handleJoinWith,\n\n      // Vector similarity search — calls similarTo(column, embedding[])\n      similarTo: this.handleSimilarTo,\n    };\n\n    return handlers[type];\n  }\n\n  /**\n   * `like` is a contains match on every driver: a value without an explicit\n   * `%` is wrapped as `%value%` (Postgres would otherwise match exactly while\n   * Mongo matched a substring). Values carrying their own `%` are kept as-is.\n   */\n  private likePattern(value: any): any {\n    if (typeof value !== \"string\" || value.includes(\"%\")) return value;\n    return `%${value}%`;\n  }\n\n  /**\n   * Coerce a client value to an integer or reject with a 400.\n   */\n  private toInt(value: any): number {\n    const parsed = parseInt(value);\n    if (Number.isNaN(parsed)) {\n      throw new BadRequestError(`Invalid integer filter value \"${value}\"`);\n    }\n    return parsed;\n  }\n\n  /**\n   * Coerce a client value to a number or reject with a 400.\n   */\n  private toNumber(value: any): number {\n    const parsed = Number(value);\n    if (value === \"\" || value === null || Number.isNaN(parsed)) {\n      throw new BadRequestError(`Invalid number filter value \"${value}\"`);\n    }\n    return parsed;\n  }\n\n  /**\n   * Apply standard where operators\n   */\n  private applyWhereOperator(\n    query: QueryBuilderContract,\n    operator: string,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    ruleName?: string,\n  ): void {\n    // Handle \"in\" prefix for array values\n    if (operator.startsWith(\"in\") && operator !== \"int\" && !Array.isArray(value)) {\n      value = [value];\n    }\n\n    // Single column\n    if (column) {\n      switch (operator) {\n        case \"=\":\n          query.where(column, value);\n          break;\n        case \"!=\":\n        case \"<>\":\n          query.where(column, \"!=\", value);\n          break;\n        case \">\":\n        case \">=\":\n        case \"<\":\n        case \"<=\":\n          query.where(column, operator, value);\n          break;\n        case \"in\":\n          query.whereIn(column, Array.isArray(value) ? value : [value]);\n          break;\n        case \"not in\":\n          query.whereNotIn(column, Array.isArray(value) ? value : [value]);\n          break;\n        case \"like\":\n          query.whereLike(column, this.likePattern(value));\n          break;\n        case \"startsWith\":\n          query.whereLike(column, `${value}%`);\n          break;\n        case \"endsWith\":\n          query.whereLike(column, `%${value}`);\n          break;\n        case \"not like\":\n          query.whereNotLike(column, value);\n          break;\n        case \"between\":\n          query.whereBetween(column, value);\n          break;\n        case \"not between\":\n          query.whereNotBetween(column, value);\n          break;\n      }\n    }\n    // Multiple columns (OR condition)\n    else if (columns) {\n      if (operator === \"=\") {\n        this.anyOf(query, columns, (q, col) => q.where(col, value));\n      } else if (operator === \"like\") {\n        // (col0 LIKE value OR col1 LIKE value OR ...), OR'd with prior conditions —\n        // the object form of orWhere() only ever emits \"=\", so \"like\" needs the\n        // callback/group form to keep the operator instead of silently degrading\n        // to equality (D1).\n        this.anyOf(query, columns, (q, col) => q.where(col, \"like\", this.likePattern(value)));\n      } else {\n        // Every other operator silently degraded to equality via the object form\n        // of orWhere() — refuse instead of returning a correct-looking, wrong query.\n        throw new Error(\n          `Unsupported multi-column filter operator \"${operator}\" for rule \"${ruleName ?? columns.join(\",\")}\". ` +\n            `Multi-column filters only support \"=\" and \"like\".`,\n        );\n      }\n    }\n  }\n\n  /**\n   * Apply a condition across several columns as ONE grouped OR: `(a OR b OR ...)`.\n   * The group is ANDed with the rest of the query, so a tenant filter\n   * (`org_id = 5`) can never be widened by a multi-column search. Never emit a\n   * top-level `orWhere` for multi-column filters.\n   */\n  private anyOf(\n    query: QueryBuilderContract,\n    columns: string[],\n    apply: (q: QueryBuilderContract, col: string) => void,\n  ) {\n    query.where((group: QueryBuilderContract) => {\n      columns.forEach((col, index) => {\n        const build = (q: QueryBuilderContract) => apply(q, col);\n\n        if (index === 0) {\n          group.where(build);\n        } else {\n          group.orWhere(build);\n        }\n      });\n    });\n  }\n\n  // ============================================================================\n  // BOOLEAN FILTERS\n  // ============================================================================\n\n  /**\n   * Coerce a filter value to a boolean.\n   *\n   * Recognized truthy forms: `true`, `1`, `\"true\"`, `\"1\"`.\n   * Recognized falsy forms:  `false`, `0`, `\"false\"`, `\"0\"`.\n   * Anything else falls back to `Boolean(value)`.\n   *\n   * NOTE: this intentionally does NOT treat \"non-empty\" as true — the previous\n   * `|| !isEmpty(value)` fallback coerced `false`/`0` to `true`, inverting the\n   * filter for explicitly-false values.\n   */\n  private coerceBoolean(value: any): boolean {\n    if (value === true || value === 1 || value === \"true\" || value === \"1\") {\n      return true;\n    }\n\n    if (value === false || value === 0 || value === \"false\" || value === \"0\") {\n      return false;\n    }\n\n    return Boolean(value);\n  }\n\n  private handleBoolean(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const boolValue = this.coerceBoolean(value);\n    if (column) {\n      query.where(column, boolValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, boolValue));\n    }\n  }\n\n  // ============================================================================\n  // NUMERIC FILTERS\n  // ============================================================================\n  private handleInt(query: QueryBuilderContract, column?: string, columns?: string[], value?: any) {\n    const intValue = this.toInt(value);\n    if (column) {\n      query.where(column, intValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, intValue));\n    }\n  }\n\n  private handleNotInt(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const intValue = this.toInt(value);\n    if (column) {\n      query.where(column, \"!=\", intValue);\n    } else if (columns) {\n      // Grouped OR across columns\n      this.anyOf(query, columns, (q, col) => q.where(col, \"!=\", intValue));\n    }\n  }\n\n  private handleIntComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    operator: string,\n  ) {\n    const intValue = this.toInt(value);\n    if (column) {\n      query.where(column, operator, intValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, operator, intValue));\n    }\n  }\n\n  private handleInInt(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const values = (Array.isArray(value) ? value : [value]).map((v: any) => this.toInt(v));\n    if (column) {\n      query.whereIn(column, values);\n    } else if (columns) {\n      // Grouped OR of whereIn across columns\n      this.anyOf(query, columns, (q, col) => q.whereIn(col, values));\n    }\n  }\n\n  private handleNumber(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const numValue = this.toNumber(value);\n    if (column) {\n      query.where(column, numValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, numValue));\n    }\n  }\n\n  private handleInNumber(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const values = (Array.isArray(value) ? value : [value]).map((v: any) => this.toNumber(v));\n    if (column) {\n      query.whereIn(column, values);\n    } else if (columns) {\n      // Grouped OR of whereIn across columns\n      this.anyOf(query, columns, (q, col) => q.whereIn(col, values));\n    }\n  }\n\n  private handleFloat(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const floatValue = parseFloat(value);\n    if (column) {\n      query.where(column, floatValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, floatValue));\n    }\n  }\n\n  // ============================================================================\n  // NULL FILTERS\n  // ============================================================================\n\n  private handleNull(query: QueryBuilderContract, column?: string, columns?: string[]) {\n    if (column) {\n      query.whereNull(column);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.whereNull(col));\n    }\n  }\n\n  private handleNotNull(query: QueryBuilderContract, column?: string, columns?: string[]) {\n    if (column) {\n      query.whereNotNull(column);\n    } else if (columns) {\n      // Use whereNotNull for each column\n      this.anyOf(query, columns, (q, col) => q.whereNotNull(col));\n    }\n  }\n\n  // ============================================================================\n  // SCOPE FILTER\n  // ============================================================================\n\n  /**\n   * Handle scope filter - applies local scope and passes the filter value.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   active: \"scope\",           // Uses the filter key as scope name\n   *   isAdmin: [\"scope\", \"admin\"] // Uses custom scope name\n   * }\n   * ```\n   *\n   * When list({ active: true }) is called, it will call query.scope(\"active\", true)\n   * When list({ status: \"pending\" }) is called, it will call query.scope(\"status\", \"pending\")\n   */\n  private handleScope(\n    query: QueryBuilderContract,\n    column?: string,\n    _columns?: string[],\n    value?: any,\n  ) {\n    // column holds the scope name (either the filter key or custom name from array format)\n    if (column) {\n      query.scope(column, value);\n    }\n  }\n\n  // ============================================================================\n  // WITH (EAGER LOAD) FILTER\n  // ============================================================================\n\n  /**\n   * Handle with filter - eager-loads a relation when the filter value is truthy.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   with_ai_model: [\"with\", \"ai_model\"],         // load single relation\n   *   with_all:      [\"with\", [\"ai_model\", \"unit\"]] // load multiple relations\n   * }\n   * ```\n   *\n   * When list({ with_ai_model: true }) is called, it will call query.with(\"ai_model\")\n   */\n  private handleWith(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    if (!value) return;\n\n    // Load a single named relation\n    if (column) {\n      if (query.with) {\n        query.with(column);\n      }\n      return;\n    }\n\n    // Load multiple relations from the columns array\n    if (columns) {\n      for (const relation of columns) {\n        if (query.with) {\n          query.with(relation);\n        }\n      }\n    }\n  }\n\n  /**\n   * Handle joinWith filter - eager-loads a relation via SQL JOIN when the filter value is truthy.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   with_ai_model: [\"joinWith\", \"ai_model\"],         // load single relation via join\n   *   with_all:      [\"joinWith\", [\"ai_model\", \"unit\"]] // load multiple relations via join\n   * }\n   * ```\n   *\n   * When list({ with_ai_model: true }) is called, it will call query.joinWith(\"ai_model\")\n   */\n  private handleJoinWith(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    if (!value) return;\n\n    if (!query.joinWith) {\n      console.warn(\n        \"[Repository] joinWith is not supported by the query builder. using with instead.\",\n      );\n      return this.handleWith(query, column, columns, value);\n    }\n\n    // Load a single named relation\n    if (column) {\n      query.joinWith(column);\n      return;\n    }\n\n    // Load multiple relations from the columns array\n    if (columns) {\n      query.joinWith(...columns);\n    }\n  }\n\n  // ============================================================================\n  // VECTOR FILTER\n  // ============================================================================\n\n  /**\n   * Handle similarTo filter — performs vector similarity search.\n   *\n   * The filter value must be a `number[]` (pre-computed embedding).\n   * Delegates to `query.similarTo(column, embedding)` which is handled\n   * driver-specifically (pgvector or MongoDB Atlas $vectorSearch).\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   organization_id: \"=\",\n   *   embedding: \"similarTo\",\n   * }\n   * ```\n   *\n   * Then in the service:\n   * ```typescript\n   * await vectorsRepository.list({ embedding: queryEmbedding, organization_id: orgId });\n   * ```\n   */\n  private handleSimilarTo(\n    query: QueryBuilderContract,\n    column?: string,\n    _columns?: string[],\n    value?: any,\n  ) {\n    if (!column || !Array.isArray(value)) return;\n\n    // Cast to any: Cascade's internal QueryBuilderContract still uses nearestTo;\n    // our wrapper (CascadeQueryBuilder.similarTo) delegates to it correctly.\n    (query as any).similarTo(column, value);\n  }\n\n  // ============================================================================\n  // DATE FILTERS\n  // ============================================================================\n\n  private handleDate(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dateValue = this.parseDate(value, options?.dateFormat);\n    if (column) {\n      query.whereDate(column, dateValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.whereDate(col, dateValue));\n    }\n  }\n\n  private handleDateComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    options: any,\n    operator: string,\n  ) {\n    const dateValue = this.parseDate(value, options?.dateFormat);\n    if (column) {\n      if (operator === \">\" || operator === \">=\") {\n        query.whereDateAfter(column, dateValue);\n      } else {\n        query.whereDateBefore(column, dateValue);\n      }\n    } else if (columns) {\n      const after = operator === \">\" || operator === \">=\";\n      this.anyOf(query, columns, (q, col) =>\n        after ? q.whereDateAfter(col, dateValue) : q.whereDateBefore(col, dateValue),\n      );\n    }\n  }\n\n  private handleDateBetween(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    if (!Array.isArray(value) || value.length !== 2) return;\n    const [start, end] = value.map((v: any) => this.parseDate(v, options?.dateFormat));\n\n    // `value.length === 2` is checked above, so both exist — but the compiler\n    // does not narrow destructured elements from a length test. Returning\n    // rather than defaulting: this builds a date RANGE for a query, and a\n    // half-formed range would silently filter on a boundary the caller never\n    // asked for.\n    if (start === undefined || end === undefined) return;\n\n    if (column) {\n      query.whereDateBetween(column, [start, end]);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.whereDateBetween(col, [start, end]));\n    }\n  }\n\n  private handleInDate(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dates = (Array.isArray(value) ? value : [value]).map((v: any) =>\n      this.parseDate(v, options?.dateFormat),\n    );\n    if (column) {\n      query.whereIn(column, dates);\n    } else if (columns) {\n      // Grouped OR of whereIn across columns\n      this.anyOf(query, columns, (q, col) => q.whereIn(col, dates));\n    }\n  }\n\n  // ============================================================================\n  // DATETIME FILTERS\n  // ============================================================================\n\n  private handleDateTime(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dateValue = this.parseDateTime(value, options?.dateTimeFormat);\n    if (column) {\n      query.where(column, dateValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, dateValue));\n    }\n  }\n\n  private handleDateTimeComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    options: any,\n    operator: string,\n  ) {\n    const dateValue = this.parseDateTime(value, options?.dateTimeFormat);\n    if (column) {\n      query.where(column, operator, dateValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, operator, dateValue));\n    }\n  }\n\n  private handleDateTimeBetween(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    if (!Array.isArray(value) || value.length !== 2) return;\n    const [start, end] = value.map((v: any) => this.parseDateTime(v, options?.dateTimeFormat));\n    if (column) {\n      query.whereBetween(column, [start, end]);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.whereBetween(col, [start, end]));\n    }\n  }\n\n  private handleInDateTime(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dates = (Array.isArray(value) ? value : [value]).map((v: any) =>\n      this.parseDateTime(v, options?.dateTimeFormat),\n    );\n    if (column) {\n      query.whereIn(column, dates);\n    } else if (columns) {\n      // Grouped OR of whereIn across columns\n      this.anyOf(query, columns, (q, col) => q.whereIn(col, dates));\n    }\n  }\n\n  // ============================================================================\n  // DATE PARSING UTILITIES\n  // ============================================================================\n\n  /**\n   * Parse a date string with the declared format; invalid input is a 400.\n   */\n  private parseDate(value: any, format?: string): Date {\n    return this.parseWithFormat(value, format);\n  }\n\n  /**\n   * Parse a datetime string with the declared format; invalid input is a 400.\n   */\n  private parseDateTime(value: any, format?: string): Date {\n    return this.parseWithFormat(value, format);\n  }\n\n  private parseWithFormat(value: any, format?: string): Date {\n    if (value instanceof Date) return value;\n\n    const parsed = format ? dayjs(String(value), format, true) : dayjs(value);\n\n    if (!parsed.isValid()) {\n      throw new BadRequestError(\n        `Invalid date filter value \"${value}\"${format ? ` (expected ${format})` : \"\"}`,\n      );\n    }\n\n    return parsed.toDate();\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"filter-applicator.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/repositories/adapters/cascade/filter-applicator.ts"],"sourcesContent":["import type {\n  QueryBuilderContract as CascadeQueryBuilder,\n  QueryBuilderContract,\n} from \"@warlock.js/cascade\";\nimport dayjs from \"dayjs\";\nimport customParseFormat from \"dayjs/plugin/customParseFormat.js\";\nimport { BadRequestError } from \"../../../http/errors/errors\";\nimport type { FilterOptions, FilterRule, FilterRules } from \"../../contracts\";\n\ndayjs.extend(customParseFormat);\n\n/**\n * Applies repository filters to a Cascade-Next query builder\n * Translates repository filter rules into Cascade query builder method calls\n */\nexport class FilterApplicator {\n  /**\n   * Apply filters to a Cascade query builder\n   *\n   * @param query - Cascade query builder instance\n   * @param filters - Filter structure defining how to filter\n   * @param data - Data containing filter values\n   * @param options - Additional filter options (date formats, etc.)\n   */\n  public apply(\n    query: CascadeQueryBuilder<any>,\n    filters: FilterRules,\n    data: any,\n    options: FilterOptions,\n  ): void {\n    // `Object.entries` hands the rule over already narrowed; a `for...in` index\n    // read is `FilterRule | undefined` under the strictness contract.\n    for (const [key, filterRule] of Object.entries(filters)) {\n      const value = data[key];\n\n      if (value === undefined) continue;\n      if (filterRule === undefined) continue;\n\n      const rule = this.parseFilterRule(key, filterRule);\n      this.applyFilterRule(query, rule, value, data, options);\n    }\n  }\n\n  /**\n   * Parse a filter rule into a structured format\n   */\n  private parseFilterRule(key: string, rule: FilterRule) {\n    // Handle custom function\n    if (typeof rule === \"function\") {\n      return { type: \"function\", fn: rule, column: key, key };\n    }\n\n    // Handle array format: [\"operator\"] or [\"operator\", \"column\"] or [\"operator\", [\"col1\", \"col2\"]]\n    if (Array.isArray(rule)) {\n      const [operator, target] = rule;\n\n      if (target === undefined) {\n        return { type: operator, column: key, columns: undefined, key };\n      }\n\n      if (Array.isArray(target)) {\n        return { type: operator, column: undefined, columns: target, key };\n      }\n\n      return { type: operator, column: target, columns: undefined, key };\n    }\n\n    // Handle simple operator string\n    return { type: rule, column: key, columns: undefined, key };\n  }\n\n  /**\n   * Apply a single filter rule to the query\n   */\n  private applyFilterRule(\n    query: CascadeQueryBuilder<any>,\n    rule: any,\n    value: any,\n    data: any,\n    options: FilterOptions,\n  ): void {\n    // 1. Custom function filter\n    if (rule.type === \"function\") {\n      rule.fn(value, query, data);\n      return;\n    }\n\n    // 2. Predefined filter types\n    const handler = this.getFilterHandler(rule.type);\n    if (handler) {\n      handler.call(this, query, rule.column, rule.columns, value, options);\n      return;\n    }\n\n    // 3. Standard where operators\n    this.applyWhereOperator(query, rule.type, rule.column, rule.columns, value, rule.key);\n  }\n\n  /**\n   * Get filter handler for predefined types\n   */\n  private getFilterHandler(type: string): Function | undefined {\n    const handlers: Record<string, Function> = {\n      // Boolean filters\n      bool: this.handleBoolean,\n      boolean: this.handleBoolean,\n\n      // Numeric filters\n      int: this.handleInt,\n      integer: this.handleInt,\n      \"!int\": this.handleNotInt,\n      \"int>\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \">\"),\n      \"int>=\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \">=\"),\n      \"int<\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \"<\"),\n      \"int<=\": (q: any, col: any, cols: any, val: any) =>\n        this.handleIntComparison(q, col, cols, val, \"<=\"),\n      inInt: this.handleInInt,\n      number: this.handleNumber,\n      inNumber: this.handleInNumber,\n      float: this.handleFloat,\n      double: this.handleFloat,\n      inFloat: this.handleInNumber,\n\n      // Null filters\n      null: this.handleNull,\n      notNull: this.handleNotNull,\n      \"!null\": this.handleNotNull,\n\n      // Date filters\n      date: this.handleDate,\n      \"date>\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \">\"),\n      \"date>=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \">=\"),\n      \"date<\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \"<\"),\n      \"date<=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateComparison(q, col, cols, val, opts, \"<=\"),\n      dateBetween: this.handleDateBetween,\n      inDate: this.handleInDate,\n\n      // DateTime filters\n      dateTime: this.handleDateTime,\n      \"dateTime>\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \">\"),\n      \"dateTime>=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \">=\"),\n      \"dateTime<\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \"<\"),\n      \"dateTime<=\": (q: any, col: any, cols: any, val: any, opts: any) =>\n        this.handleDateTimeComparison(q, col, cols, val, opts, \"<=\"),\n      dateTimeBetween: this.handleDateTimeBetween,\n      inDateTime: this.handleInDateTime,\n\n      // Scope filter - applies local scope when value is truthy\n      scope: this.handleScope,\n\n      // With filter - eager-loads a relation when value is truthy\n      with: this.handleWith,\n\n      // JoinWith filter - eager-loads a relation via SQL JOIN when value is truthy\n      joinWith: this.handleJoinWith,\n\n      // Vector similarity search — calls similarTo(column, embedding[])\n      similarTo: this.handleSimilarTo,\n    };\n\n    return handlers[type];\n  }\n\n  /**\n   * `like` is a contains match on every driver: a value without an explicit\n   * `%` is wrapped as `%value%` (Postgres would otherwise match exactly while\n   * Mongo matched a substring). Values carrying their own `%` are kept as-is.\n   */\n  private likePattern(value: any): any {\n    if (typeof value !== \"string\" || value.includes(\"%\")) return value;\n    return `%${value}%`;\n  }\n\n  /**\n   * Coerce a client value to an integer or reject with a 400.\n   */\n  private toInt(value: any): number {\n    const parsed = parseInt(value);\n    if (Number.isNaN(parsed)) {\n      throw new BadRequestError(`Invalid integer filter value \"${value}\"`);\n    }\n    return parsed;\n  }\n\n  /**\n   * Coerce a client value to a number or reject with a 400.\n   */\n  private toNumber(value: any): number {\n    const parsed = Number(value);\n    if (value === \"\" || value === null || Number.isNaN(parsed)) {\n      throw new BadRequestError(`Invalid number filter value \"${value}\"`);\n    }\n    return parsed;\n  }\n\n  /**\n   * Apply standard where operators\n   */\n  private applyWhereOperator(\n    query: QueryBuilderContract,\n    operator: string,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    ruleName?: string,\n  ): void {\n    // Handle \"in\" prefix for array values\n    if (operator.startsWith(\"in\") && operator !== \"int\" && !Array.isArray(value)) {\n      value = [value];\n    }\n\n    // Single column\n    if (column) {\n      switch (operator) {\n        case \"=\":\n          query.where(column, value);\n          break;\n        case \"!=\":\n        case \"<>\":\n          query.where(column, \"!=\", value);\n          break;\n        case \">\":\n        case \">=\":\n        case \"<\":\n        case \"<=\":\n          query.where(column, operator, value);\n          break;\n        case \"in\":\n          query.whereIn(column, Array.isArray(value) ? value : [value]);\n          break;\n        case \"not in\":\n          query.whereNotIn(column, Array.isArray(value) ? value : [value]);\n          break;\n        case \"like\":\n          query.whereLike(column, this.likePattern(value));\n          break;\n        case \"startsWith\":\n          query.whereLike(column, `${value}%`);\n          break;\n        case \"endsWith\":\n          query.whereLike(column, `%${value}`);\n          break;\n        case \"not like\":\n          query.whereNotLike(column, value);\n          break;\n        case \"between\":\n          query.whereBetween(column, value);\n          break;\n        case \"not between\":\n          query.whereNotBetween(column, value);\n          break;\n      }\n    }\n    // Multiple columns (OR condition)\n    else if (columns) {\n      if (operator === \"=\") {\n        this.anyOf(query, columns, (q, col) => q.where(col, value));\n      } else if (operator === \"like\") {\n        // (col0 LIKE value OR col1 LIKE value OR ...), OR'd with prior conditions —\n        // the object form of orWhere() only ever emits \"=\", so \"like\" needs the\n        // callback/group form to keep the operator instead of silently degrading\n        // to equality (D1).\n        this.anyOf(query, columns, (q, col) => q.where(col, \"like\", this.likePattern(value)));\n      } else {\n        // Every other operator silently degraded to equality via the object form\n        // of orWhere() — refuse instead of returning a correct-looking, wrong query.\n        throw new Error(\n          `Unsupported multi-column filter operator \"${operator}\" for rule \"${ruleName ?? columns.join(\",\")}\". ` +\n            `Multi-column filters only support \"=\" and \"like\".`,\n        );\n      }\n    }\n  }\n\n  /**\n   * Apply a condition across several columns as ONE grouped OR: `(a OR b OR ...)`.\n   * The group is ANDed with the rest of the query, so a tenant filter\n   * (`org_id = 5`) can never be widened by a multi-column search. Never emit a\n   * top-level `orWhere` for multi-column filters.\n   */\n  private anyOf(\n    query: QueryBuilderContract,\n    columns: string[],\n    apply: (q: QueryBuilderContract, col: string) => void,\n  ) {\n    query.where((group: QueryBuilderContract) => {\n      columns.forEach((col, index) => {\n        const build = (q: QueryBuilderContract) => apply(q, col);\n\n        if (index === 0) {\n          group.where(build);\n        } else {\n          group.orWhere(build);\n        }\n      });\n    });\n  }\n\n  // ============================================================================\n  // BOOLEAN FILTERS\n  // ============================================================================\n\n  /**\n   * Coerce a filter value to a boolean.\n   *\n   * Recognized truthy forms: `true`, `1`, `\"true\"`, `\"1\"`.\n   * Recognized falsy forms:  `false`, `0`, `\"false\"`, `\"0\"`.\n   * Anything else falls back to `Boolean(value)`.\n   *\n   * NOTE: this intentionally does NOT treat \"non-empty\" as true — the previous\n   * `|| !isEmpty(value)` fallback coerced `false`/`0` to `true`, inverting the\n   * filter for explicitly-false values.\n   */\n  private coerceBoolean(value: any): boolean {\n    if (value === true || value === 1 || value === \"true\" || value === \"1\") {\n      return true;\n    }\n\n    if (value === false || value === 0 || value === \"false\" || value === \"0\") {\n      return false;\n    }\n\n    return Boolean(value);\n  }\n\n  private handleBoolean(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const boolValue = this.coerceBoolean(value);\n    if (column) {\n      query.where(column, boolValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, boolValue));\n    }\n  }\n\n  // ============================================================================\n  // NUMERIC FILTERS\n  // ============================================================================\n  private handleInt(query: QueryBuilderContract, column?: string, columns?: string[], value?: any) {\n    const intValue = this.toInt(value);\n    if (column) {\n      query.where(column, intValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, intValue));\n    }\n  }\n\n  private handleNotInt(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const intValue = this.toInt(value);\n    if (column) {\n      query.where(column, \"!=\", intValue);\n    } else if (columns) {\n      // Grouped OR across columns\n      this.anyOf(query, columns, (q, col) => q.where(col, \"!=\", intValue));\n    }\n  }\n\n  private handleIntComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    operator: string,\n  ) {\n    const intValue = this.toInt(value);\n    if (column) {\n      query.where(column, operator, intValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, operator, intValue));\n    }\n  }\n\n  private handleInInt(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const values = (Array.isArray(value) ? value : [value]).map((v: any) => this.toInt(v));\n    if (column) {\n      query.whereIn(column, values);\n    } else if (columns) {\n      // Grouped OR of whereIn across columns\n      this.anyOf(query, columns, (q, col) => q.whereIn(col, values));\n    }\n  }\n\n  private handleNumber(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const numValue = this.toNumber(value);\n    if (column) {\n      query.where(column, numValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, numValue));\n    }\n  }\n\n  private handleInNumber(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const values = (Array.isArray(value) ? value : [value]).map((v: any) => this.toNumber(v));\n    if (column) {\n      query.whereIn(column, values);\n    } else if (columns) {\n      // Grouped OR of whereIn across columns\n      this.anyOf(query, columns, (q, col) => q.whereIn(col, values));\n    }\n  }\n\n  private handleFloat(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    const floatValue = parseFloat(value);\n    if (column) {\n      query.where(column, floatValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, floatValue));\n    }\n  }\n\n  // ============================================================================\n  // NULL FILTERS\n  // ============================================================================\n\n  private handleNull(query: QueryBuilderContract, column?: string, columns?: string[]) {\n    if (column) {\n      query.whereNull(column);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.whereNull(col));\n    }\n  }\n\n  private handleNotNull(query: QueryBuilderContract, column?: string, columns?: string[]) {\n    if (column) {\n      query.whereNotNull(column);\n    } else if (columns) {\n      // Use whereNotNull for each column\n      this.anyOf(query, columns, (q, col) => q.whereNotNull(col));\n    }\n  }\n\n  // ============================================================================\n  // SCOPE FILTER\n  // ============================================================================\n\n  /**\n   * Handle scope filter - applies local scope and passes the filter value.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   active: \"scope\",           // Uses the filter key as scope name\n   *   isAdmin: [\"scope\", \"admin\"] // Uses custom scope name\n   * }\n   * ```\n   *\n   * When list({ active: true }) is called, it will call query.scope(\"active\", true)\n   * When list({ status: \"pending\" }) is called, it will call query.scope(\"status\", \"pending\")\n   */\n  private handleScope(\n    query: QueryBuilderContract,\n    column?: string,\n    _columns?: string[],\n    value?: any,\n  ) {\n    // column holds the scope name (either the filter key or custom name from array format)\n    if (column) {\n      query.scope(column, value);\n    }\n  }\n\n  // ============================================================================\n  // WITH (EAGER LOAD) FILTER\n  // ============================================================================\n\n  /**\n   * Handle with filter - eager-loads a relation when the filter value is truthy.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   with_ai_model: [\"with\", \"ai_model\"],         // load single relation\n   *   with_all:      [\"with\", [\"ai_model\", \"unit\"]] // load multiple relations\n   * }\n   * ```\n   *\n   * When list({ with_ai_model: true }) is called, it will call query.with(\"ai_model\")\n   */\n  private handleWith(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    if (!value) return;\n\n    // Load a single named relation\n    if (column) {\n      if (query.with) {\n        query.with(column);\n      }\n      return;\n    }\n\n    // Load multiple relations from the columns array\n    if (columns) {\n      for (const relation of columns) {\n        if (query.with) {\n          query.with(relation);\n        }\n      }\n    }\n  }\n\n  /**\n   * Handle joinWith filter - eager-loads a relation via SQL JOIN when the filter value is truthy.\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   with_ai_model: [\"joinWith\", \"ai_model\"],         // load single relation via join\n   *   with_all:      [\"joinWith\", [\"ai_model\", \"unit\"]] // load multiple relations via join\n   * }\n   * ```\n   *\n   * When list({ with_ai_model: true }) is called, it will call query.joinWith(\"ai_model\")\n   */\n  private handleJoinWith(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n  ) {\n    if (!value) return;\n\n    if (!query.joinWith) {\n      console.warn(\n        \"[Repository] joinWith is not supported by the query builder. using with instead.\",\n      );\n      return this.handleWith(query, column, columns, value);\n    }\n\n    // Load a single named relation\n    if (column) {\n      query.joinWith(column);\n      return;\n    }\n\n    // Load multiple relations from the columns array\n    if (columns) {\n      query.joinWith(...columns);\n    }\n  }\n\n  // ============================================================================\n  // VECTOR FILTER\n  // ============================================================================\n\n  /**\n   * Handle similarTo filter — performs vector similarity search.\n   *\n   * The filter value must be a `number[]` (pre-computed embedding).\n   * Delegates to `query.similarTo(column, embedding)` which is handled\n   * driver-specifically (pgvector or MongoDB Atlas $vectorSearch).\n   *\n   * Usage in filterBy:\n   * ```typescript\n   * filterBy: {\n   *   organization_id: \"=\",\n   *   embedding: \"similarTo\",\n   * }\n   * ```\n   *\n   * Then in the service:\n   * ```typescript\n   * await vectorsRepository.list({ embedding: queryEmbedding, organization_id: orgId });\n   * ```\n   */\n  private handleSimilarTo(\n    query: QueryBuilderContract,\n    column?: string,\n    _columns?: string[],\n    value?: any,\n  ) {\n    if (!column || !Array.isArray(value)) return;\n\n    // Cast to any: Cascade's internal QueryBuilderContract still uses nearestTo;\n    // our wrapper (CascadeQueryBuilder.similarTo) delegates to it correctly.\n    (query as any).similarTo(column, value);\n  }\n\n  // ============================================================================\n  // DATE FILTERS\n  // ============================================================================\n\n  private handleDate(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dateValue = this.parseDate(value, options?.dateFormat);\n    if (column) {\n      query.whereDate(column, dateValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.whereDate(col, dateValue));\n    }\n  }\n\n  private handleDateComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    options: any,\n    operator: string,\n  ) {\n    const dateValue = this.parseDate(value, options?.dateFormat);\n    if (column) {\n      if (operator === \">\" || operator === \">=\") {\n        query.whereDateAfter(column, dateValue);\n      } else {\n        query.whereDateBefore(column, dateValue);\n      }\n    } else if (columns) {\n      const after = operator === \">\" || operator === \">=\";\n      this.anyOf(query, columns, (q, col) =>\n        after ? q.whereDateAfter(col, dateValue) : q.whereDateBefore(col, dateValue),\n      );\n    }\n  }\n\n  private handleDateBetween(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    if (!Array.isArray(value) || value.length !== 2) return;\n    const [start, end] = value.map((v: any) => this.parseDate(v, options?.dateFormat));\n\n    // `value.length === 2` is checked above, so both exist — but the compiler\n    // does not narrow destructured elements from a length test. Returning\n    // rather than defaulting: this builds a date RANGE for a query, and a\n    // half-formed range would silently filter on a boundary the caller never\n    // asked for.\n    if (start === undefined || end === undefined) return;\n\n    if (column) {\n      query.whereDateBetween(column, [start, end]);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.whereDateBetween(col, [start, end]));\n    }\n  }\n\n  private handleInDate(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dates = (Array.isArray(value) ? value : [value]).map((v: any) =>\n      this.parseDate(v, options?.dateFormat),\n    );\n    if (column) {\n      query.whereIn(column, dates);\n    } else if (columns) {\n      // Grouped OR of whereIn across columns\n      this.anyOf(query, columns, (q, col) => q.whereIn(col, dates));\n    }\n  }\n\n  // ============================================================================\n  // DATETIME FILTERS\n  // ============================================================================\n\n  private handleDateTime(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dateValue = this.parseDateTime(value, options?.dateTimeFormat);\n    if (column) {\n      query.where(column, dateValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, dateValue));\n    }\n  }\n\n  private handleDateTimeComparison(\n    query: QueryBuilderContract,\n    column: any,\n    columns: any,\n    value: any,\n    options: any,\n    operator: string,\n  ) {\n    const dateValue = this.parseDateTime(value, options?.dateTimeFormat);\n    if (column) {\n      query.where(column, operator, dateValue);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.where(col, operator, dateValue));\n    }\n  }\n\n  private handleDateTimeBetween(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    if (!Array.isArray(value) || value.length !== 2) return;\n    const [start, end] = value.map((v: any) => this.parseDateTime(v, options?.dateTimeFormat));\n    if (column) {\n      query.whereBetween(column, [start, end]);\n    } else if (columns) {\n      this.anyOf(query, columns, (q, col) => q.whereBetween(col, [start, end]));\n    }\n  }\n\n  private handleInDateTime(\n    query: QueryBuilderContract,\n    column?: string,\n    columns?: string[],\n    value?: any,\n    options?: FilterOptions,\n  ) {\n    const dates = (Array.isArray(value) ? value : [value]).map((v: any) =>\n      this.parseDateTime(v, options?.dateTimeFormat),\n    );\n    if (column) {\n      query.whereIn(column, dates);\n    } else if (columns) {\n      // Grouped OR of whereIn across columns\n      this.anyOf(query, columns, (q, col) => q.whereIn(col, dates));\n    }\n  }\n\n  // ============================================================================\n  // DATE PARSING UTILITIES\n  // ============================================================================\n\n  /**\n   * Parse a date string with the declared format; invalid input is a 400.\n   */\n  private parseDate(value: any, format?: string): Date {\n    return this.parseWithFormat(value, format);\n  }\n\n  /**\n   * Parse a datetime string with the declared format; invalid input is a 400.\n   */\n  private parseDateTime(value: any, format?: string): Date {\n    return this.parseWithFormat(value, format);\n  }\n\n  private parseWithFormat(value: any, format?: string): Date {\n    if (value instanceof Date) return value;\n\n    const parsed = format ? dayjs(String(value), format, true) : dayjs(value);\n\n    if (!parsed.isValid()) {\n      throw new BadRequestError(\n        `Invalid date filter value \"${value}\"${format ? ` (expected ${format})` : \"\"}`,\n      );\n    }\n\n    return parsed.toDate();\n  }\n}\n"],"mappings":"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"}

package/esm/repositories/adapters/cascade/index.d.mts

@@ -1,2 +1,3 @@
 import { CascadeAdapter, UPDATE_MANY_BATCH_SIZE } from "./cascade-adapter.mjs";
-import { CascadeQueryBuilder } from "./cascade-query-builder.mjs";
+import { CascadeQueryBuilder } from "./cascade-query-builder.mjs";
+export { CascadeAdapter, CascadeQueryBuilder, UPDATE_MANY_BATCH_SIZE };

package/esm/repositories/adapters/cascade/index.mjs

@@ -1,4 +1,4 @@
 import { CascadeQueryBuilder } from "./cascade-query-builder.mjs";
 import { CascadeAdapter, UPDATE_MANY_BATCH_SIZE } from "./cascade-adapter.mjs";
 
-export {  };
+export { CascadeAdapter, CascadeQueryBuilder, UPDATE_MANY_BATCH_SIZE };

package/esm/repositories/contracts/index.d.mts

@@ -1,3 +1,4 @@
 import { RepositoryAdapterContract } from "./repository-adapter.contract.mjs";
 import { AllRepositoryOptions, CachedRepositoryOptions, ChunkCallback, CursorPaginationOptions, CursorPaginationResult, FilterFunction, FilterOperator, FilterOptions, FilterRule, FilterRules, PaginationMode, PaginationResult, RepositoryConfigurations, RepositoryEvent, RepositoryOptions, RepositoryOptionsWithCursor, RepositoryOptionsWithPages, SaveMode, TypedAllRepositoryOptions, TypedRepositoryOptions, TypedRepositoryOptionsWithCursor, TypedRepositoryOptionsWithPages, WhereOperator } from "./types.mjs";
-import { AggregateExpressionInput, AggregateExpressions, GroupByFields, QueryBuilderContract } from "./query-builder.contract.mjs";
+import { AggregateExpressionInput, AggregateExpressions, GroupByFields, QueryBuilderContract } from "./query-builder.contract.mjs";
+export { AggregateExpressionInput, AggregateExpressions, AllRepositoryOptions, CachedRepositoryOptions, ChunkCallback, CursorPaginationOptions, CursorPaginationResult, FilterFunction, FilterOperator, FilterOptions, FilterRule, FilterRules, GroupByFields, PaginationMode, PaginationResult, QueryBuilderContract, RepositoryAdapterContract, RepositoryConfigurations, RepositoryEvent, RepositoryOptions, RepositoryOptionsWithCursor, RepositoryOptionsWithPages, SaveMode, TypedAllRepositoryOptions, TypedRepositoryOptions, TypedRepositoryOptionsWithCursor, TypedRepositoryOptionsWithPages, WhereOperator };

package/esm/repositories/contracts/query-builder.contract.d.mts

@@ -1,5 +1,4 @@
 import { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, FilterOptions, FilterRules, PaginationResult, WhereOperator } from "./types.mjs";
-
 //#region ../../packages/core/src/repositories/contracts/query-builder.contract.d.ts
 /**
  * Field(s) to group aggregated results by.
@@ -7,7 +6,7 @@ import { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, FilterO
  * ORM-agnostic mirror of the underlying driver's group-by payload: a single
  * field name, a list of field names, or a driver-specific object form.
  */
-type GroupByFields = string | string[] | Record<string, unknown> | Array<Record<string, unknown>>;
+export type GroupByFields = string | string[] | Record<string, unknown> | Array<Record<string, unknown>>;
 /**
  * A single aggregate expression in a `groupBy` / `aggregate` projection.
  *
@@ -16,21 +15,21 @@ type GroupByFields = string | string[] | Record<string, unknown> | Array<Record<
  * (e.g. MongoDB `{ $sum: "$amount" }`, SQL `"SUM(amount)"`). The repository
  * layer is agnostic to which form is used and forwards it verbatim.
  */
-type AggregateExpressionInput = string | Record<string, unknown> | unknown;
+export type AggregateExpressionInput = string | Record<string, unknown> | unknown;
 /**
  * Map of result aliases to aggregate expressions.
  *
  * @example
  * { count: $agg.count(), total: $agg.sum("total") }
  */
-type AggregateExpressions = Record<string, AggregateExpressionInput>;
+export type AggregateExpressions = Record<string, AggregateExpressionInput>;
 /**
  * Query builder contract for building database queries
  * This interface is ORM-agnostic and can be implemented by any data source adapter
  *
  * @template T - The type of records being queried
  */
-interface QueryBuilderContract<T> {
+export interface QueryBuilderContract<T> {
   /**
    * Add a where clause to the query
    *
@@ -406,5 +405,4 @@ interface QueryBuilderContract<T> {
   similarTo(column: string, embedding: number[], alias?: string): this;
 }
 //#endregion
-export { AggregateExpressionInput, AggregateExpressions, GroupByFields, QueryBuilderContract };
 //# sourceMappingURL=query-builder.contract.d.mts.map

package/esm/repositories/contracts/query-builder.contract.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"query-builder.contract.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/repositories/contracts/query-builder.contract.ts"],"mappings":";;;;;AAgBA;;;;KAAY,aAAA,uBAGR,MAAA,oBACA,KAAA,CAAM,MAAA;;;;;;;;AAAM;KAUJ,wBAAA,YAAoC,MAAM;;;;AAAA;AAQtD;;KAAY,oBAAA,GAAuB,MAAM,SAAS,wBAAA;;AAAwB;AAQ1E;;;;UAAiB,oBAAA;EAqEkB;;;;;;;;;;EAtDjC,KAAA,CAAM,KAAA,UAAe,KAAA;EAsSD;;;;;;;;;;;EAzRpB,KAAA,CAAM,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAoVkB;;;;;;;;;EAzUhE,KAAA,CAAM,UAAA,EAAY,MAAA;EA8VsC;;;;;;;;;EAnVxD,KAAA,CAAM,QAAA,GAAW,KAAA;EAtB6B;;;;;;;EA+B9C,OAAA,CAAQ,KAAA,UAAe,KAAA;EAAf;;;;;;;;EAUR,OAAA,CAAQ,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAQxC;;;;;;EAAR,OAAA,CAAQ,UAAA,EAAY,MAAA;EA6BpB;;;;;;;;;;EAjBA,OAAA,CAAQ,KAAA,UAAe,MAAA;EAqEvB;;;;;;;EA5DA,UAAA,CAAW,KAAA,UAAe,MAAA;EAuG1B;;;;;;EA/FA,SAAA,CAAU,KAAA;EAkHH;;;;;;EA1GP,YAAA,CAAa,KAAA;EAoJb;;;;;;;;;;EAxIA,YAAA,CAAa,KAAA,UAAe,KAAA;EA0JX;;;;;;;;;;EA9IjB,SAAA,CAAU,KAAA,UAAe,OAAA;EAmLL;;;EA9KpB,MAAA;EAsMA;;;;;;;;;EAvLA,MAAA,CAAO,MAAA;EAyMG;;;;;;;;;EA9LV,MAAA,IAAU,MAAA;EAuMqC;;;;;;EA/L/C,QAAA,CAAS,MAAA;EA2MwE;;;;;;EAnMjF,QAAA,IAAY,MAAA;EA2NZ;;;;;;;;;;EA3MA,OAAA,CAAQ,KAAA,UAAe,SAAA;;;;;;;;;;EAWvB,MAAA,CAAO,OAAA,EAAS,MAAA;;;;;;;EAQhB,MAAA,CAAO,KAAA;;;;;;;EAYP,KAAA,CAAM,KAAA;;;;;;;EAQN,MAAA,CAAO,MAAA;;;;;;;EAQP,IAAA,CAAK,KAAA;;;;;;;;;EAcL,YAAA,CAAa,OAAA,EAAS,WAAA,QAAmB,IAAA,OAAW,OAAA,EAAS,aAAA;;;;;;EAW7D,GAAA,IAAO,OAAA,CAAQ,CAAA;;;;;;EAOf,KAAA,IAAS,OAAA,CAAQ,CAAA;;;;;;EAOjB,KAAA,IAAS,OAAA;;;;;;;;;;EAWT,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;;;;;EAWpB,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;;EAQpB,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;;EAQpB,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;;;;;;;;;;EAgBpB,OAAA,KAAY,MAAA,mBACV,MAAA,EAAQ,aAAA,EACR,UAAA,EAAY,oBAAA,GACX,OAAA,CAAQ,CAAA;;;;;;;;;;;;;;EAeX,SAAA,KAAc,MAAA,mBAAyB,UAAA,EAAY,oBAAA,GAAuB,OAAA,CAAQ,CAAA;;;;;;;;EASlF,QAAA,CAAS,IAAA,UAAc,KAAA,WAAgB,OAAA,CAAQ,gBAAA,CAAiB,CAAA;;;;;;;;;;;EAYhE,cAAA,CAAe,OAAA,EAAS,uBAAA,GAA0B,OAAA,CAAQ,sBAAA,CAAuB,CAAA;;;;;;;;EASjF,KAAA,CAAM,IAAA,UAAc,QAAA,EAAU,aAAA,CAAc,CAAA,IAAK,OAAA;;;;;;;;;;EAejD,IAAA,EAAM,QAAA;;;;;;;;;;EAWN,QAAA,KAAa,SAAA;;;;;;EAOb,KAAA;;;;;;;;;;;;;;;;;;;;;EAsBA,SAAA,CAAU,MAAA,UAAgB,SAAA,YAAqB,KAAA;AAAA"}
+{"version":3,"file":"query-builder.contract.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/repositories/contracts/query-builder.contract.ts"],"mappings":";;;;;;;;YAgBY,oCAGR,0BACA,MAAM;;;;;;;;;YAUE,oCAAoC;;;;;;;YAQpC,uBAAuB,eAAe;;;;;;;iBAQjC,qBAAqB;;;;;;;;;;;EAepC,MAAM,eAAe;;;;;;;;;;;;EAarB,MAAM,eAAe,UAAU,eAAe;;;;;;;;;;EAW9C,MAAM,YAAY;;;;;;;;;;EAWlB,MAAM,WAAW;;;;;;;;EASjB,QAAQ,eAAe;;;;;;;;;EAUvB,QAAQ,eAAe,UAAU,eAAe;;;;;;;EAQhD,QAAQ,YAAY;;;;;;;;;;;EAYpB,QAAQ,eAAe;;;;;;;;EASvB,WAAW,eAAe;;;;;;;EAQ1B,UAAU;;;;;;;EAQV,aAAa;;;;;;;;;;;EAYb,aAAa,eAAe;;;;;;;;;;;EAY5B,UAAU,eAAe;;;;EAKzB;;;;;;;;;;EAeA,OAAO;;;;;;;;;;EAWP,UAAU;;;;;;;EAQV,SAAS;;;;;;;EAQT,YAAY;;;;;;;;;;;EAgBZ,QAAQ,eAAe;;;;;;;;;;EAWvB,OAAO,SAAS;;;;;;;EAQhB,OAAO;;;;;;;EAYP,MAAM;;;;;;;EAQN,OAAO;;;;;;;EAQP,KAAK;;;;;;;;;EAcL,aAAa,SAAS,mBAAmB,WAAW,SAAS;;;;;;EAW7D,OAAO,QAAQ;;;;;;EAOf,SAAS,QAAQ;;;;;;EAOjB,SAAS;;;;;;;;;;EAWT,IAAI,gBAAgB;;;;;;;;;;EAWpB,IAAI,gBAAgB;;;;;;;EAQpB,IAAI,gBAAgB;;;;;;;EAQpB,IAAI,gBAAgB;;;;;;;;;;;;;;;EAgBpB,QAAQ,IAAI,yBACV,QAAQ,eACR,YAAY,uBACX,QAAQ;;;;;;;;;;;;;;EAeX,UAAU,IAAI,yBAAyB,YAAY,uBAAuB,QAAQ;;;;;;;;EASlF,SAAS,cAAc,gBAAgB,QAAQ,iBAAiB;;;;;;;;;;;EAYhE,eAAe,SAAS,0BAA0B,QAAQ,uBAAuB;;;;;;;;EASjF,MAAM,cAAc,UAAU,cAAc,KAAK;;;;;;;;;;EAejD,MAAM;;;;;;;;;;EAWN,aAAa;;;;;;EAOb;;;;;;;;;;;;;;;;;;;;;EAsBA,UAAU,gBAAgB,qBAAqB"}

package/esm/repositories/contracts/repository-adapter.contract.d.mts

@@ -1,6 +1,5 @@
 import { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, PaginationResult } from "./types.mjs";
 import { QueryBuilderContract } from "./query-builder.contract.mjs";
-
 //#region ../../packages/core/src/repositories/contracts/repository-adapter.contract.d.ts
 /**
  * Repository adapter contract for data source operations
@@ -9,7 +8,7 @@ import { QueryBuilderContract } from "./query-builder.contract.mjs";
  *
  * @template T - The type of records managed by this adapter
  */
-interface RepositoryAdapterContract<T> {
+export interface RepositoryAdapterContract<T> {
   /**
    * Create a new query builder instance
    *
@@ -183,5 +182,4 @@ interface RepositoryAdapterContract<T> {
   createModel(data: any): T;
 }
 //#endregion
-export { RepositoryAdapterContract };
 //# sourceMappingURL=repository-adapter.contract.d.mts.map

package/esm/repositories/contracts/repository-adapter.contract.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"repository-adapter.contract.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/repositories/contracts/repository-adapter.contract.ts"],"mappings":";;;;;;AAeA;;;;;UAAiB,yBAAA;EA4Cc;;;;;;;;;EA9B7B,KAAA,IAAS,oBAAA,CAAqB,CAAA;EA2GM;;;;;EApGpC,cAAA,CAAe,cAAA;EA+JS;;;;;EAxJxB,qBAAA;EA2KiD;;;;;;EAnKjD,cAAA,CAAe,KAAA,EAAO,CAAA;EAtBQ;;;;;;EA8B9B,gBAAA,CAAiB,IAAA,QAAY,CAAA;EAA7B;;;;;;;;;EAeA,IAAA,CAAK,EAAA,QAAU,OAAA,CAAQ,CAAA;EAYa;;;;;;;;;;EAApC,MAAA,CAAO,MAAA,UAAgB,KAAA,QAAa,OAAA,CAAQ,CAAA;EAkC5C;;;;;;;;;EAvBA,MAAA,CAAO,IAAA,QAAY,OAAA,CAAQ,CAAA;EAkE3B;;;;;;;;;;EAtDA,MAAA,CAAO,EAAA,OAAS,IAAA,QAAY,OAAA,CAAQ,CAAA;EAsFrB;;;;;;;;;EA3Ef,MAAA,CAAO,EAAA,QAAU,OAAA;EA8GjB;;;;AAAyB;;;;;;EA9FzB,UAAA,CAAW,MAAA,OAAa,IAAA,QAAY,OAAA;;;;;;;;;;EAWpC,UAAA,CAAW,MAAA,QAAc,OAAA;;;;;;;;;;;EAgBzB,KAAA,CAAM,MAAA,SAAe,OAAA;;;;;;;;;;;;;EAkBrB,QAAA,CAAS,IAAA,UAAc,KAAA,WAAgB,OAAA,CAAQ,gBAAA,CAAiB,CAAA;;;;;;;;;;;;;EAchE,cAAA,CAAe,OAAA,EAAS,uBAAA,GAA0B,OAAA,CAAQ,sBAAA,CAAuB,CAAA;;;;;;;;;;;;;;EAmBjF,KAAA,CAAM,IAAA,UAAc,QAAA,EAAU,aAAA,CAAc,CAAA,IAAK,OAAA;;;;;;;;;;;EAgBjD,WAAA,CAAY,IAAA,QAAY,CAAA;AAAA"}
+{"version":3,"file":"repository-adapter.contract.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/repositories/contracts/repository-adapter.contract.ts"],"mappings":";;;;;;;;;;iBAeiB,0BAA0B;;;;;;;;;;EAczC,SAAS,qBAAqB;;;;;;EAO9B,eAAe;;;;;;EAOf;;;;;;;EAQA,eAAe,OAAO;;;;;;;EAQtB,iBAAiB,YAAY;;;;;;;;;;EAe7B,KAAK,UAAU,QAAQ;;;;;;;;;;;EAYvB,OAAO,gBAAgB,aAAa,QAAQ;;;;;;;;;;EAW5C,OAAO,YAAY,QAAQ;;;;;;;;;;;EAY3B,OAAO,SAAS,YAAY,QAAQ;;;;;;;;;;EAWpC,OAAO,UAAU;;;;;;;;;;;EAgBjB,WAAW,aAAa,YAAY;;;;;;;;;;EAWpC,WAAW,cAAc;;;;;;;;;;;EAgBzB,MAAM,eAAe;;;;;;;;;;;;;EAkBrB,SAAS,cAAc,gBAAgB,QAAQ,iBAAiB;;;;;;;;;;;;;EAchE,eAAe,SAAS,0BAA0B,QAAQ,uBAAuB;;;;;;;;;;;;;;EAmBjF,MAAM,cAAc,UAAU,cAAc,KAAK;;;;;;;;;;;EAgBjD,YAAY,YAAY"}