@warlock.js/core 5.29.0 → 5.30.0

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

@@ -3,7 +3,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { fork } from "node:child_process";
 
-//#region ../core/src/production/registration-child-runner.ts
+//#region ../../packages/core/src/production/registration-child-runner.ts
 const DEFAULT_TIMEOUT_MS = 3e4;
 const MAX_DIAGNOSTIC_BYTES = 16384;
 /** Message a registration child sends when it fails. Shared by every result kind. */

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

@@ -1 +1 @@
-{"version":3,"file":"registration-child-runner.mjs","names":[],"sources":["../../../../../../../core/src/production/registration-child-runner.ts"],"sourcesContent":["import { fork, type ChildProcess, type Serializable } from \"node:child_process\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst MAX_DIAGNOSTIC_BYTES = 16_384;\n\n/** Message a registration child sends when it fails. Shared by every result kind. */\nexport const REGISTRATION_ERROR_MESSAGE = \"route-registration:error\";\n\n/** Message a registration child sends before it imports each module. Shared by every result kind. */\nexport const REGISTRATION_PROGRESS_MESSAGE = \"route-registration:progress\";\n\nexport type RegistrationChildProcess = Pick<\n  ChildProcess,\n  \"send\" | \"kill\" | \"disconnect\" | \"on\" | \"stdout\" | \"stderr\" | \"connected\"\n>;\n\nexport type RegistrationChildForker = (\n  entry: string,\n  options: { cwd: string },\n) => RegistrationChildProcess;\n\nexport type RegistrationChildRunOptions<TResult> = Readonly<{\n  cwd: string;\n  timeoutMs?: number;\n  childEntry?: string;\n  /**\n   * Test seam. An injected fork is a protocol seam, not an installation check, so the\n   * compiled child is not resolved when it is set.\n   */\n  forkProcess?: RegistrationChildForker;\n  /** The single IPC request the child receives after it starts. */\n  request: Serializable;\n  /** `type` of the one message that carries the result (for example `route-registration:snapshot`). */\n  resultMessageType: string;\n  /** What the result is called in error messages (\"snapshot\", \"document\"). */\n  resultNoun: string;\n  /**\n   * Validate and freeze the result message. Throw to reject the run with that error.\n   */\n  readResult: (message: Record<string, unknown>) => TResult;\n}>;\n\n/**\n * Run the compiled registration child in a fresh process and wait for its result.\n *\n * This is the fork / IPC / timeout / diagnostics plumbing shared by the route snapshot and\n * the OpenAPI document: the child is forked, sent one request, and must answer with exactly\n * one result message (or an error message) and exit 0. The timeout names the module the\n * child was still importing; the last 16 KiB of child stdout/stderr are attached to failures.\n */\nexport function runRegistrationChild<TResult>(\n  options: RegistrationChildRunOptions<TResult>,\n): Promise<TResult> {\n  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const startedAt = Date.now();\n  const forkProcess = options.forkProcess ?? defaultForkProcess;\n  const entry =\n    options.childEntry ??\n    (options.forkProcess ? \"<injected-route-registration-child>\" : resolveCompiledChildEntry());\n\n  return new Promise<TResult>((resolve, reject) => {\n    const child = forkProcess(entry, { cwd: options.cwd });\n    let settled = false;\n    let received: { value: TResult } | undefined;\n    let stdout = \"\";\n    let stderr = \"\";\n    let pendingModule: string | undefined;\n\n    const append = (current: string, chunk: Buffer) => {\n      const remaining = MAX_DIAGNOSTIC_BYTES - Buffer.byteLength(current);\n\n      return remaining <= 0 ? current : current + chunk.toString(\"utf8\", 0, remaining);\n    };\n\n    const finish = (error?: Error, result?: TResult) => {\n      if (settled) {\n        return;\n      }\n\n      settled = true;\n      clearTimeout(timeout);\n\n      if (child.connected) {\n        child.disconnect?.();\n      }\n\n      if (error) {\n        child.kill?.();\n        reject(error);\n      } else {\n        resolve(result as TResult);\n      }\n    };\n\n    child.stdout?.on(\"data\", (chunk: Buffer) => {\n      stdout = append(stdout, chunk);\n    });\n    child.stderr?.on(\"data\", (chunk: Buffer) => {\n      stderr = append(stderr, chunk);\n    });\n\n    const timeout = setTimeout(() => {\n      const elapsedMs = Date.now() - startedAt;\n\n      finish(\n        new Error(\n          `Route registration child timed out after ${elapsedMs}ms${pendingModule ? ` while registering ${pendingModule}` : \"\"}.${formatDiagnostics(stdout, stderr)}`,\n        ),\n      );\n    }, timeoutMs);\n    timeout.unref?.();\n\n    child.on(\"error\", (error) => {\n      finish(\n        new Error(\n          `Could not start route registration child: ${error.message}${formatDiagnostics(stdout, stderr)}`,\n        ),\n      );\n    });\n\n    child.on(\"message\", (message: unknown) => {\n      if (!isChildMessage(message, options.resultMessageType)) {\n        return;\n      }\n\n      if (message.type === REGISTRATION_ERROR_MESSAGE) {\n        finish(\n          new Error(\n            `Route registration child failed: ${String(message.message)}${formatDiagnostics(stdout, stderr)}`,\n          ),\n        );\n\n        return;\n      }\n\n      if (message.type === REGISTRATION_PROGRESS_MESSAGE) {\n        pendingModule = String(message.module);\n\n        return;\n      }\n\n      try {\n        const result = options.readResult(message);\n\n        if (received) {\n          finish(new Error(`Route registration child sent more than one ${options.resultNoun}.`));\n\n          return;\n        }\n\n        received = { value: result };\n      } catch (error) {\n        finish(error as Error);\n      }\n    });\n\n    child.on(\"close\", (code) => {\n      if (settled) {\n        return;\n      }\n\n      if (code === 0 && received) {\n        finish(undefined, received.value);\n\n        return;\n      }\n\n      finish(\n        new Error(\n          `Route registration child exited ${code ?? \"by signal\"} without a valid ${options.resultNoun}.${formatDiagnostics(stdout, stderr)}`,\n        ),\n      );\n    });\n\n    if (!child.send) {\n      finish(new Error(\"Route registration child did not provide an IPC send channel.\"));\n\n      return;\n    }\n\n    child.send(options.request);\n  });\n}\n\nfunction defaultForkProcess(entry: string, options: { cwd: string }): RegistrationChildProcess {\n  const forkOptions: NonNullable<Parameters<typeof fork>[2]> & { windowsHide?: boolean } = {\n    cwd: options.cwd,\n    stdio: [\"ignore\", \"pipe\", \"pipe\", \"ipc\"],\n    windowsHide: true,\n  };\n\n  return fork(entry, [], forkOptions);\n}\n\n/** Resolve from Core's package root, not an assumed bundler-preserved dirname. */\nfunction resolveCompiledChildEntry(): string {\n  let directory = path.dirname(fileURLToPath(import.meta.url));\n\n  while (directory !== path.dirname(directory)) {\n    const packageJson = path.join(directory, \"package.json\");\n\n    if (existsSync(packageJson)) {\n      try {\n        if (JSON.parse(readFileSync(packageJson, \"utf8\")).name === \"@warlock.js/core\") {\n          const child = path.join(directory, \"esm\", \"production\", \"route-registration-child.mjs\");\n\n          if (existsSync(child)) {\n            return child;\n          }\n\n          throw new Error(\n            `@warlock.js/core is missing its compiled route-registration child at ${child}. Reinstall a complete package.`,\n          );\n        }\n      } catch (error) {\n        if (error instanceof Error && error.message.includes(\"route-registration child\")) {\n          throw error;\n        }\n      }\n    }\n\n    directory = path.dirname(directory);\n  }\n\n  throw new Error(\n    \"Could not locate @warlock.js/core package root for the route-registration child.\",\n  );\n}\n\nfunction isChildMessage(\n  value: unknown,\n  resultMessageType: string,\n): value is Record<string, unknown> & { type: string } {\n  if (typeof value !== \"object\" || value === null || !(\"type\" in value)) {\n    return false;\n  }\n\n  const type = (value as { type?: unknown }).type;\n\n  return (\n    type === resultMessageType ||\n    type === REGISTRATION_ERROR_MESSAGE ||\n    type === REGISTRATION_PROGRESS_MESSAGE\n  );\n}\n\nfunction formatDiagnostics(stdout: string, stderr: string): string {\n  if (!stdout && !stderr) {\n    return \"\";\n  }\n\n  return `\\nChild stdout:\\n${stdout}\\nChild stderr:\\n${stderr}`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"registration-child-runner.mjs","names":[],"sources":["../../../../../../../../packages/core/src/production/registration-child-runner.ts"],"sourcesContent":["import { fork, type ChildProcess, type Serializable } from \"node:child_process\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst MAX_DIAGNOSTIC_BYTES = 16_384;\n\n/** Message a registration child sends when it fails. Shared by every result kind. */\nexport const REGISTRATION_ERROR_MESSAGE = \"route-registration:error\";\n\n/** Message a registration child sends before it imports each module. Shared by every result kind. */\nexport const REGISTRATION_PROGRESS_MESSAGE = \"route-registration:progress\";\n\nexport type RegistrationChildProcess = Pick<\n  ChildProcess,\n  \"send\" | \"kill\" | \"disconnect\" | \"on\" | \"stdout\" | \"stderr\" | \"connected\"\n>;\n\nexport type RegistrationChildForker = (\n  entry: string,\n  options: { cwd: string },\n) => RegistrationChildProcess;\n\nexport type RegistrationChildRunOptions<TResult> = Readonly<{\n  cwd: string;\n  timeoutMs?: number;\n  childEntry?: string;\n  /**\n   * Test seam. An injected fork is a protocol seam, not an installation check, so the\n   * compiled child is not resolved when it is set.\n   */\n  forkProcess?: RegistrationChildForker;\n  /** The single IPC request the child receives after it starts. */\n  request: Serializable;\n  /** `type` of the one message that carries the result (for example `route-registration:snapshot`). */\n  resultMessageType: string;\n  /** What the result is called in error messages (\"snapshot\", \"document\"). */\n  resultNoun: string;\n  /**\n   * Validate and freeze the result message. Throw to reject the run with that error.\n   */\n  readResult: (message: Record<string, unknown>) => TResult;\n}>;\n\n/**\n * Run the compiled registration child in a fresh process and wait for its result.\n *\n * This is the fork / IPC / timeout / diagnostics plumbing shared by the route snapshot and\n * the OpenAPI document: the child is forked, sent one request, and must answer with exactly\n * one result message (or an error message) and exit 0. The timeout names the module the\n * child was still importing; the last 16 KiB of child stdout/stderr are attached to failures.\n */\nexport function runRegistrationChild<TResult>(\n  options: RegistrationChildRunOptions<TResult>,\n): Promise<TResult> {\n  const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const startedAt = Date.now();\n  const forkProcess = options.forkProcess ?? defaultForkProcess;\n  const entry =\n    options.childEntry ??\n    (options.forkProcess ? \"<injected-route-registration-child>\" : resolveCompiledChildEntry());\n\n  return new Promise<TResult>((resolve, reject) => {\n    const child = forkProcess(entry, { cwd: options.cwd });\n    let settled = false;\n    let received: { value: TResult } | undefined;\n    let stdout = \"\";\n    let stderr = \"\";\n    let pendingModule: string | undefined;\n\n    const append = (current: string, chunk: Buffer) => {\n      const remaining = MAX_DIAGNOSTIC_BYTES - Buffer.byteLength(current);\n\n      return remaining <= 0 ? current : current + chunk.toString(\"utf8\", 0, remaining);\n    };\n\n    const finish = (error?: Error, result?: TResult) => {\n      if (settled) {\n        return;\n      }\n\n      settled = true;\n      clearTimeout(timeout);\n\n      if (child.connected) {\n        child.disconnect?.();\n      }\n\n      if (error) {\n        child.kill?.();\n        reject(error);\n      } else {\n        resolve(result as TResult);\n      }\n    };\n\n    child.stdout?.on(\"data\", (chunk: Buffer) => {\n      stdout = append(stdout, chunk);\n    });\n    child.stderr?.on(\"data\", (chunk: Buffer) => {\n      stderr = append(stderr, chunk);\n    });\n\n    const timeout = setTimeout(() => {\n      const elapsedMs = Date.now() - startedAt;\n\n      finish(\n        new Error(\n          `Route registration child timed out after ${elapsedMs}ms${pendingModule ? ` while registering ${pendingModule}` : \"\"}.${formatDiagnostics(stdout, stderr)}`,\n        ),\n      );\n    }, timeoutMs);\n    timeout.unref?.();\n\n    child.on(\"error\", (error) => {\n      finish(\n        new Error(\n          `Could not start route registration child: ${error.message}${formatDiagnostics(stdout, stderr)}`,\n        ),\n      );\n    });\n\n    child.on(\"message\", (message: unknown) => {\n      if (!isChildMessage(message, options.resultMessageType)) {\n        return;\n      }\n\n      if (message.type === REGISTRATION_ERROR_MESSAGE) {\n        finish(\n          new Error(\n            `Route registration child failed: ${String(message.message)}${formatDiagnostics(stdout, stderr)}`,\n          ),\n        );\n\n        return;\n      }\n\n      if (message.type === REGISTRATION_PROGRESS_MESSAGE) {\n        pendingModule = String(message.module);\n\n        return;\n      }\n\n      try {\n        const result = options.readResult(message);\n\n        if (received) {\n          finish(new Error(`Route registration child sent more than one ${options.resultNoun}.`));\n\n          return;\n        }\n\n        received = { value: result };\n      } catch (error) {\n        finish(error as Error);\n      }\n    });\n\n    child.on(\"close\", (code) => {\n      if (settled) {\n        return;\n      }\n\n      if (code === 0 && received) {\n        finish(undefined, received.value);\n\n        return;\n      }\n\n      finish(\n        new Error(\n          `Route registration child exited ${code ?? \"by signal\"} without a valid ${options.resultNoun}.${formatDiagnostics(stdout, stderr)}`,\n        ),\n      );\n    });\n\n    if (!child.send) {\n      finish(new Error(\"Route registration child did not provide an IPC send channel.\"));\n\n      return;\n    }\n\n    child.send(options.request);\n  });\n}\n\nfunction defaultForkProcess(entry: string, options: { cwd: string }): RegistrationChildProcess {\n  const forkOptions: NonNullable<Parameters<typeof fork>[2]> & { windowsHide?: boolean } = {\n    cwd: options.cwd,\n    stdio: [\"ignore\", \"pipe\", \"pipe\", \"ipc\"],\n    windowsHide: true,\n  };\n\n  return fork(entry, [], forkOptions);\n}\n\n/** Resolve from Core's package root, not an assumed bundler-preserved dirname. */\nfunction resolveCompiledChildEntry(): string {\n  let directory = path.dirname(fileURLToPath(import.meta.url));\n\n  while (directory !== path.dirname(directory)) {\n    const packageJson = path.join(directory, \"package.json\");\n\n    if (existsSync(packageJson)) {\n      try {\n        if (JSON.parse(readFileSync(packageJson, \"utf8\")).name === \"@warlock.js/core\") {\n          const child = path.join(directory, \"esm\", \"production\", \"route-registration-child.mjs\");\n\n          if (existsSync(child)) {\n            return child;\n          }\n\n          throw new Error(\n            `@warlock.js/core is missing its compiled route-registration child at ${child}. Reinstall a complete package.`,\n          );\n        }\n      } catch (error) {\n        if (error instanceof Error && error.message.includes(\"route-registration child\")) {\n          throw error;\n        }\n      }\n    }\n\n    directory = path.dirname(directory);\n  }\n\n  throw new Error(\n    \"Could not locate @warlock.js/core package root for the route-registration child.\",\n  );\n}\n\nfunction isChildMessage(\n  value: unknown,\n  resultMessageType: string,\n): value is Record<string, unknown> & { type: string } {\n  if (typeof value !== \"object\" || value === null || !(\"type\" in value)) {\n    return false;\n  }\n\n  const type = (value as { type?: unknown }).type;\n\n  return (\n    type === resultMessageType ||\n    type === REGISTRATION_ERROR_MESSAGE ||\n    type === REGISTRATION_PROGRESS_MESSAGE\n  );\n}\n\nfunction formatDiagnostics(stdout: string, stderr: string): string {\n  if (!stdout && !stderr) {\n    return \"\";\n  }\n\n  return `\\nChild stdout:\\n${stdout}\\nChild stderr:\\n${stderr}`;\n}\n"],"mappings":"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"}

package/esm/production/resolve-build-config.d.mts

@@ -1,6 +1,6 @@
 import { WarlockConfig } from "../warlock-config/types.mjs";
 
-//#region ../core/src/production/resolve-build-config.d.ts
+//#region ../../packages/core/src/production/resolve-build-config.d.ts
 /**
  * Keys the builder deletes before handing the options to esbuild — ours
  * (`singleBundle`, `esmShim`), which esbuild would reject as unknown, and

package/esm/production/resolve-build-config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-build-config.d.mts","names":[],"sources":["../../../../../../../core/src/production/resolve-build-config.ts"],"mappings":";;;;;AAG6D;;;;AAkBrC;AAExB;;;;;;;;KAFK,mBAAA;AAAA,KAEO,mBAAA,GAAsB,QAAA,CAChC,IAAA,CAAK,WAAA,CAAY,aAAA,6BAA0C,mBAAA,KAE3D,OAAA,CAAQ,IAAA,CAAK,WAAA,CAAY,aAAA,YAAyB,mBAAA;EAAA,qEAEhD,SAAA;AAAA"}
+{"version":3,"file":"resolve-build-config.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/production/resolve-build-config.ts"],"mappings":";;;;;AAG6D;;;;AAkBrC;AAExB;;;;;;;;KAFK,mBAAA;AAAA,KAEO,mBAAA,GAAsB,QAAA,CAChC,IAAA,CAAK,WAAA,CAAY,aAAA,6BAA0C,mBAAA,KAE3D,OAAA,CAAQ,IAAA,CAAK,WAAA,CAAY,aAAA,YAAyB,mBAAA;EAAA,qEAEhD,SAAA;AAAA"}

package/esm/production/resolve-build-config.mjs

@@ -3,7 +3,7 @@ import { defaultWarlockConfigurations } from "../warlock-config/default-configur
 import { normalizeBuildConfig } from "../warlock-config/normalize-build-config.mjs";
 import path from "path";
 
-//#region ../core/src/production/resolve-build-config.ts
+//#region ../../packages/core/src/production/resolve-build-config.ts
 /**
 * esbuild options the build config may not carry, and why.
 *

package/esm/production/resolve-build-config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-build-config.mjs","names":[],"sources":["../../../../../../../core/src/production/resolve-build-config.ts"],"sourcesContent":["import path from \"path\";\nimport { defaultWarlockConfigurations } from \"../warlock-config/default-configurations\";\nimport { normalizeBuildConfig } from \"../warlock-config/normalize-build-config\";\nimport type { WarlockConfig } from \"../warlock-config/types\";\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\n\n/**\n * Keys the builder deletes before handing the options to esbuild — ours\n * (`singleBundle`, `esmShim`), which esbuild would reject as unknown, and\n * `banner`, which is re-merged and re-applied after the user spread.\n *\n * They are optional here for a concrete reason: `Required<…>` makes `delete`\n * a type error (TS2790). Naming exactly these three says which keys are\n * removable, rather than casting at each `delete` — a cast there would also\n * hide a genuine mistake.\n *\n * `outFile` and `entryPath` stay REQUIRED even though the builder deletes\n * them too. They are always present after resolution and callers depend on\n * that; widening them to `string | undefined` pushed the lie downstream into\n * `start-production.command.ts`, which then could not trust its own config.\n */\ntype BuilderStrippedKeys = \"singleBundle\" | \"esmShim\" | \"banner\" | \"routeRegistrationTimeoutMs\";\n\nexport type ResolvedBuildConfig = Required<\n  Omit<NonNullable<WarlockConfig[\"build\"]>, \"outDirectory\" | BuilderStrippedKeys>\n> &\n  Partial<Pick<NonNullable<WarlockConfig[\"build\"]>, BuilderStrippedKeys>> & {\n    /** Absolute path to the bundled entry file (`{outdir}/{outFile}`) */\n    entryPath: string;\n  };\n\n/**\n * esbuild options the build config may not carry, and why.\n *\n * Both apply the named compiler options to EVERY file in the bundle, not just\n * the app's own sources — workspace packages compiled under their own tsconfig\n * are silently recompiled under the app's. An app-level\n * `verbatimModuleSyntax: true` reaching package sources that never opted into\n * it strips the imports their decorators rely on, and the build succeeds only\n * to die at import time with `Class extends value undefined`.\n */\nconst FORBIDDEN_BUILD_OPTIONS = {\n  tsconfig: \"points esbuild at a tsconfig file\",\n  tsconfigRaw: \"inlines compiler options\",\n} as const;\n\n/**\n * Raised when the build config carries an esbuild option the framework owns.\n *\n * The typed config already omits these keys; this catches the forms the type\n * cannot see — an `as any` cast, or a plain `warlock.config.js`. Rejected\n * rather than deleted: dropping the key quietly would leave the author\n * believing a setting applied when it never did.\n */\nexport class ForbiddenBuildOptionError extends Error {\n  public constructor(public readonly option: keyof typeof FORBIDDEN_BUILD_OPTIONS) {\n    super(\n      [\n        `build.${option} is not a supported warlock build option.`,\n        \"\",\n        `Setting it ${FORBIDDEN_BUILD_OPTIONS[option]} for every file in the bundle,`,\n        \"including workspace packages that were compiled under their own tsconfig.\",\n        \"Options such as `verbatimModuleSyntax` then apply to sources that never\",\n        \"opted into them, and the build succeeds but crashes at import time with\",\n        \"`Class extends value undefined`.\",\n        \"\",\n        `Remove \\`${option}\\` from the \\`build\\` block of your warlock config. The builder`,\n        \"already reads the app's tsconfig for the parts it needs (path aliases); to\",\n        \"change how your own sources compile, edit that tsconfig.json instead.\",\n      ].join(\"\\n\"),\n    );\n\n    this.name = \"ForbiddenBuildOptionError\";\n  }\n}\n\n/**\n * Resolve the build config with framework defaults applied.\n *\n * Both the production builder and `warlock start` call this so they\n * agree on where the bundle lives — previously each had its own local\n * fallbacks and they drifted (`.warlock/production` vs `dist`),\n * letting `build` and `start` look at different paths.\n */\nexport function resolveBuildConfig(): ResolvedBuildConfig {\n  // Normalised here rather than only in `defineConfig` because a project may\n  // export a plain config object that never went through it.\n  const userBuild = normalizeBuildConfig(warlockConfigManager.get(\"build\") ?? {});\n\n  // Before the merge, so the option cannot reach the esbuild spread in\n  // production-builder — which overrides framework defaults with user config.\n  for (const option of Object.keys(FORBIDDEN_BUILD_OPTIONS) as Array<\n    keyof typeof FORBIDDEN_BUILD_OPTIONS\n  >) {\n    if (option in userBuild) {\n      throw new ForbiddenBuildOptionError(option);\n    }\n  }\n\n  const defaults = defaultWarlockConfigurations.build!;\n  const merged = { ...defaults, ...userBuild } as ResolvedBuildConfig;\n\n  return {\n    ...merged,\n    routeRegistrationTimeoutMs: resolveRouteRegistrationTimeoutMs(merged.routeRegistrationTimeoutMs),\n    entryPath: path.resolve(merged.outdir, merged.outFile),\n  };\n}\n\nconst DEFAULT_ROUTE_REGISTRATION_TIMEOUT_MS = 30_000;\nconst ROUTE_REGISTRATION_TIMEOUT_ENV = \"WARLOCK_ROUTE_REGISTRATION_TIMEOUT_MS\";\n\nfunction resolveRouteRegistrationTimeoutMs(configured: unknown): number {\n  const environment = process.env[ROUTE_REGISTRATION_TIMEOUT_ENV];\n  const value = environment === undefined ? configured : environment;\n  const source = environment === undefined ? \"build.routeRegistrationTimeoutMs\" : ROUTE_REGISTRATION_TIMEOUT_ENV;\n\n  if (typeof value === \"number\" && Number.isFinite(value) && value > 0) return value;\n  if (typeof value === \"string\" && value.trim() !== \"\") {\n    const parsed = Number(value);\n    if (Number.isFinite(parsed) && parsed > 0) return parsed;\n  }\n\n  console.warn(\n    `Invalid ${source} value ${JSON.stringify(value)}; using ${DEFAULT_ROUTE_REGISTRATION_TIMEOUT_MS}ms.`,\n  );\n  return DEFAULT_ROUTE_REGISTRATION_TIMEOUT_MS;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAyCA,MAAM,0BAA0B;CAC9B,UAAU;CACV,aAAa;AACf;;;;;;;;;AAUA,IAAa,4BAAb,cAA+C,MAAM;CACnD,AAAO,YAAY,AAAgB,QAA8C;EAC/E,MACE;GACE,SAAS,OAAO;GAChB;GACA,cAAc,wBAAwB,QAAQ;GAC9C;GACA;GACA;GACA;GACA;GACA,YAAY,OAAO;GACnB;GACA;EACF,CAAC,CAAC,KAAK,IAAI,CACb;EAfiC;EAiBjC,KAAK,OAAO;CACd;AACF;;;;;;;;;AAUA,SAAgB,qBAA0C;CAGxD,MAAM,YAAY,qBAAqB,qBAAqB,IAAI,OAAO,KAAK,CAAC,CAAC;CAI9E,KAAK,MAAM,UAAU,OAAO,KAAK,uBAAuB,GAGtD,IAAI,UAAU,WACZ,MAAM,IAAI,0BAA0B,MAAM;CAK9C,MAAM,SAAS;EAAE,GADA,6BAA6B;EAChB,GAAG;CAAU;CAE3C,OAAO;EACL,GAAG;EACH,4BAA4B,kCAAkC,OAAO,0BAA0B;EAC/F,WAAW,KAAK,QAAQ,OAAO,QAAQ,OAAO,OAAO;CACvD;AACF;AAEA,MAAM,wCAAwC;AAC9C,MAAM,iCAAiC;AAEvC,SAAS,kCAAkC,YAA6B;CACtE,MAAM,cAAc,QAAQ,IAAI;CAChC,MAAM,QAAQ,gBAAgB,SAAY,aAAa;CACvD,MAAM,SAAS,gBAAgB,SAAY,qCAAqC;CAEhF,IAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,KAAK,QAAQ,GAAG,OAAO;CAC7E,IAAI,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,IAAI;EACpD,MAAM,SAAS,OAAO,KAAK;EAC3B,IAAI,OAAO,SAAS,MAAM,KAAK,SAAS,GAAG,OAAO;CACpD;CAEA,QAAQ,KACN,WAAW,OAAO,SAAS,KAAK,UAAU,KAAK,EAAE,UAAU,sCAAsC,IACnG;CACA,OAAO;AACT"}
+{"version":3,"file":"resolve-build-config.mjs","names":[],"sources":["../../../../../../../../packages/core/src/production/resolve-build-config.ts"],"sourcesContent":["import path from \"path\";\nimport { defaultWarlockConfigurations } from \"../warlock-config/default-configurations\";\nimport { normalizeBuildConfig } from \"../warlock-config/normalize-build-config\";\nimport type { WarlockConfig } from \"../warlock-config/types\";\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\n\n/**\n * Keys the builder deletes before handing the options to esbuild — ours\n * (`singleBundle`, `esmShim`), which esbuild would reject as unknown, and\n * `banner`, which is re-merged and re-applied after the user spread.\n *\n * They are optional here for a concrete reason: `Required<…>` makes `delete`\n * a type error (TS2790). Naming exactly these three says which keys are\n * removable, rather than casting at each `delete` — a cast there would also\n * hide a genuine mistake.\n *\n * `outFile` and `entryPath` stay REQUIRED even though the builder deletes\n * them too. They are always present after resolution and callers depend on\n * that; widening them to `string | undefined` pushed the lie downstream into\n * `start-production.command.ts`, which then could not trust its own config.\n */\ntype BuilderStrippedKeys = \"singleBundle\" | \"esmShim\" | \"banner\" | \"routeRegistrationTimeoutMs\";\n\nexport type ResolvedBuildConfig = Required<\n  Omit<NonNullable<WarlockConfig[\"build\"]>, \"outDirectory\" | BuilderStrippedKeys>\n> &\n  Partial<Pick<NonNullable<WarlockConfig[\"build\"]>, BuilderStrippedKeys>> & {\n    /** Absolute path to the bundled entry file (`{outdir}/{outFile}`) */\n    entryPath: string;\n  };\n\n/**\n * esbuild options the build config may not carry, and why.\n *\n * Both apply the named compiler options to EVERY file in the bundle, not just\n * the app's own sources — workspace packages compiled under their own tsconfig\n * are silently recompiled under the app's. An app-level\n * `verbatimModuleSyntax: true` reaching package sources that never opted into\n * it strips the imports their decorators rely on, and the build succeeds only\n * to die at import time with `Class extends value undefined`.\n */\nconst FORBIDDEN_BUILD_OPTIONS = {\n  tsconfig: \"points esbuild at a tsconfig file\",\n  tsconfigRaw: \"inlines compiler options\",\n} as const;\n\n/**\n * Raised when the build config carries an esbuild option the framework owns.\n *\n * The typed config already omits these keys; this catches the forms the type\n * cannot see — an `as any` cast, or a plain `warlock.config.js`. Rejected\n * rather than deleted: dropping the key quietly would leave the author\n * believing a setting applied when it never did.\n */\nexport class ForbiddenBuildOptionError extends Error {\n  public constructor(public readonly option: keyof typeof FORBIDDEN_BUILD_OPTIONS) {\n    super(\n      [\n        `build.${option} is not a supported warlock build option.`,\n        \"\",\n        `Setting it ${FORBIDDEN_BUILD_OPTIONS[option]} for every file in the bundle,`,\n        \"including workspace packages that were compiled under their own tsconfig.\",\n        \"Options such as `verbatimModuleSyntax` then apply to sources that never\",\n        \"opted into them, and the build succeeds but crashes at import time with\",\n        \"`Class extends value undefined`.\",\n        \"\",\n        `Remove \\`${option}\\` from the \\`build\\` block of your warlock config. The builder`,\n        \"already reads the app's tsconfig for the parts it needs (path aliases); to\",\n        \"change how your own sources compile, edit that tsconfig.json instead.\",\n      ].join(\"\\n\"),\n    );\n\n    this.name = \"ForbiddenBuildOptionError\";\n  }\n}\n\n/**\n * Resolve the build config with framework defaults applied.\n *\n * Both the production builder and `warlock start` call this so they\n * agree on where the bundle lives — previously each had its own local\n * fallbacks and they drifted (`.warlock/production` vs `dist`),\n * letting `build` and `start` look at different paths.\n */\nexport function resolveBuildConfig(): ResolvedBuildConfig {\n  // Normalised here rather than only in `defineConfig` because a project may\n  // export a plain config object that never went through it.\n  const userBuild = normalizeBuildConfig(warlockConfigManager.get(\"build\") ?? {});\n\n  // Before the merge, so the option cannot reach the esbuild spread in\n  // production-builder — which overrides framework defaults with user config.\n  for (const option of Object.keys(FORBIDDEN_BUILD_OPTIONS) as Array<\n    keyof typeof FORBIDDEN_BUILD_OPTIONS\n  >) {\n    if (option in userBuild) {\n      throw new ForbiddenBuildOptionError(option);\n    }\n  }\n\n  const defaults = defaultWarlockConfigurations.build!;\n  const merged = { ...defaults, ...userBuild } as ResolvedBuildConfig;\n\n  return {\n    ...merged,\n    routeRegistrationTimeoutMs: resolveRouteRegistrationTimeoutMs(merged.routeRegistrationTimeoutMs),\n    entryPath: path.resolve(merged.outdir, merged.outFile),\n  };\n}\n\nconst DEFAULT_ROUTE_REGISTRATION_TIMEOUT_MS = 30_000;\nconst ROUTE_REGISTRATION_TIMEOUT_ENV = \"WARLOCK_ROUTE_REGISTRATION_TIMEOUT_MS\";\n\nfunction resolveRouteRegistrationTimeoutMs(configured: unknown): number {\n  const environment = process.env[ROUTE_REGISTRATION_TIMEOUT_ENV];\n  const value = environment === undefined ? configured : environment;\n  const source = environment === undefined ? \"build.routeRegistrationTimeoutMs\" : ROUTE_REGISTRATION_TIMEOUT_ENV;\n\n  if (typeof value === \"number\" && Number.isFinite(value) && value > 0) return value;\n  if (typeof value === \"string\" && value.trim() !== \"\") {\n    const parsed = Number(value);\n    if (Number.isFinite(parsed) && parsed > 0) return parsed;\n  }\n\n  console.warn(\n    `Invalid ${source} value ${JSON.stringify(value)}; using ${DEFAULT_ROUTE_REGISTRATION_TIMEOUT_MS}ms.`,\n  );\n  return DEFAULT_ROUTE_REGISTRATION_TIMEOUT_MS;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAyCA,MAAM,0BAA0B;CAC9B,UAAU;CACV,aAAa;AACf;;;;;;;;;AAUA,IAAa,4BAAb,cAA+C,MAAM;CACnD,AAAO,YAAY,AAAgB,QAA8C;EAC/E,MACE;GACE,SAAS,OAAO;GAChB;GACA,cAAc,wBAAwB,QAAQ;GAC9C;GACA;GACA;GACA;GACA;GACA,YAAY,OAAO;GACnB;GACA;EACF,CAAC,CAAC,KAAK,IAAI,CACb;EAfiC;EAiBjC,KAAK,OAAO;CACd;AACF;;;;;;;;;AAUA,SAAgB,qBAA0C;CAGxD,MAAM,YAAY,qBAAqB,qBAAqB,IAAI,OAAO,KAAK,CAAC,CAAC;CAI9E,KAAK,MAAM,UAAU,OAAO,KAAK,uBAAuB,GAGtD,IAAI,UAAU,WACZ,MAAM,IAAI,0BAA0B,MAAM;CAK9C,MAAM,SAAS;EAAE,GADA,6BAA6B;EAChB,GAAG;CAAU;CAE3C,OAAO;EACL,GAAG;EACH,4BAA4B,kCAAkC,OAAO,0BAA0B;EAC/F,WAAW,KAAK,QAAQ,OAAO,QAAQ,OAAO,OAAO;CACvD;AACF;AAEA,MAAM,wCAAwC;AAC9C,MAAM,iCAAiC;AAEvC,SAAS,kCAAkC,YAA6B;CACtE,MAAM,cAAc,QAAQ,IAAI;CAChC,MAAM,QAAQ,gBAAgB,SAAY,aAAa;CACvD,MAAM,SAAS,gBAAgB,SAAY,qCAAqC;CAEhF,IAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,KAAK,QAAQ,GAAG,OAAO;CAC7E,IAAI,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,IAAI;EACpD,MAAM,SAAS,OAAO,KAAK;EAC3B,IAAI,OAAO,SAAS,MAAM,KAAK,SAAS,GAAG,OAAO;CACpD;CAEA,QAAQ,KACN,WAAW,OAAO,SAAS,KAAK,UAAU,KAAK,EAAE,UAAU,sCAAsC,IACnG;CACA,OAAO;AACT"}

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

@@ -11,7 +11,7 @@ import { OPENAPI_RESULT_MESSAGE, parseOpenApiChildOptions } from "../openapi/ope
 import { buildOpenApiForChild } from "../openapi/openapi-child-output.mjs";
 import { fileExistsAsync } from "@warlock.js/fs";
 
-//#region ../core/src/production/route-registration-child.ts
+//#region ../../packages/core/src/production/route-registration-child.ts
 const PROTOCOL_VERSION = 1;
 process.once("message", async (message) => {
 	try {

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

@@ -1 +1 @@
-{"version":3,"file":"route-registration-child.mjs","names":[],"sources":["../../../../../../../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({ onBeforeLoad: (file) => sendProgress(file.relativePath) });\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({ onBeforeLoad: (file) => sendProgress(file.relativePath) });\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/route-registration-snapshot.mjs

@@ -1,6 +1,6 @@
 import { runRegistrationChild } from "./registration-child-runner.mjs";
 
-//#region ../core/src/production/route-registration-snapshot.ts
+//#region ../../packages/core/src/production/route-registration-snapshot.ts
 const PROTOCOL_VERSION = 1;
 /**
 * Collect named application API routes in a fresh process.

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

@@ -1 +1 @@
-{"version":3,"file":"route-registration-snapshot.mjs","names":[],"sources":["../../../../../../../core/src/production/route-registration-snapshot.ts"],"sourcesContent":["import type { NamedApiRoute, RequestMethod } from \"../router/types\";\nimport type { Environment, RuntimeStrategy } from \"../utils/environment\";\nimport {\n  runRegistrationChild,\n  type RegistrationChildForker,\n  type RegistrationChildProcess,\n} from \"./registration-child-runner\";\n\nconst PROTOCOL_VERSION = 1;\n\nexport type RouteRegistrationSnapshot = Readonly<{\n  version: typeof PROTOCOL_VERSION;\n  routes: readonly NamedApiRoute[];\n}>;\n\nexport type RouteRegistrationChildRequest = Readonly<{\n  version: typeof PROTOCOL_VERSION;\n  cwd: string;\n  environment?: Environment;\n  runtimeStrategy?: RuntimeStrategy;\n}>;\n\nexport type RouteRegistrationChildProcess = RegistrationChildProcess;\n\nexport type RouteRegistrationSnapshotOptions = Readonly<{\n  cwd?: string;\n  environment?: Environment;\n  runtimeStrategy?: RuntimeStrategy;\n  timeoutMs?: number;\n  childEntry?: string;\n  forkProcess?: RegistrationChildForker;\n}>;\n\n/**\n * Collect named application API routes in a fresh process.\n *\n * The child imports application registration modules but deliberately does not\n * register, boot, or start connectors. Application module top-level code can\n * still have arbitrary user-owned side effects; this boundary is framework-only.\n */\nexport function collectRouteRegistrationSnapshot(\n  options: RouteRegistrationSnapshotOptions = {},\n): Promise<RouteRegistrationSnapshot> {\n  const cwd = options.cwd ?? process.cwd();\n\n  return runRegistrationChild<RouteRegistrationSnapshot>({\n    cwd,\n    timeoutMs: options.timeoutMs,\n    childEntry: options.childEntry,\n    forkProcess: options.forkProcess,\n    request: {\n      version: PROTOCOL_VERSION,\n      cwd,\n      environment: options.environment,\n      runtimeStrategy: options.runtimeStrategy,\n    } satisfies RouteRegistrationChildRequest,\n    resultMessageType: \"route-registration:snapshot\",\n    resultNoun: \"snapshot\",\n    readResult: (message) => validateSnapshot(message.snapshot),\n  });\n}\n\nfunction validateSnapshot(value: unknown): RouteRegistrationSnapshot {\n  if (!isRecord(value) || value.version !== PROTOCOL_VERSION || !Array.isArray(value.routes)) {\n    throw new Error(\"Route registration child sent an invalid snapshot protocol payload.\");\n  }\n\n  const routes = value.routes.map((route) => {\n    if (\n      !isRecord(route) ||\n      typeof route.name !== \"string\" ||\n      typeof route.path !== \"string\" ||\n      !isRequestMethod(route.method)\n    ) {\n      throw new Error(\"Route registration child sent an invalid route record.\");\n    }\n\n    const response = route.response;\n    const allowedKeys = response === undefined ? 3 : 4;\n\n    if (\n      Object.keys(route).length !== allowedKeys ||\n      (response !== undefined && !isResponseTypeRecord(response))\n    ) {\n      throw new Error(\"Route registration child sent a route record with non-browser-safe fields.\");\n    }\n\n    const base = {\n      name: route.name,\n      path: route.path,\n      method: normalizeRequestMethod(route.method),\n    };\n\n    return Object.freeze(\n      response === undefined ? base : { ...base, response: Object.freeze({ ...response }) },\n    );\n  });\n\n  return Object.freeze({ version: PROTOCOL_VERSION, routes: Object.freeze(routes) });\n}\n\nfunction isResponseTypeRecord(value: unknown): value is Record<string, string> {\n  return isRecord(value) && Object.values(value).every((entry) => typeof entry === \"string\");\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isRequestMethod(value: unknown): value is RequestMethod {\n  return (\n    typeof value === \"string\" &&\n    [\"get\", \"post\", \"put\", \"delete\", \"patch\", \"options\", \"head\", \"all\"].includes(\n      value.toLowerCase(),\n    )\n  );\n}\n\nfunction normalizeRequestMethod(value: RequestMethod | string): RequestMethod {\n  return value.toLowerCase() === \"all\" ? \"all\" : (value.toUpperCase() as RequestMethod);\n}\n\n"],"mappings":";;;AAQA,MAAM,mBAAmB;;;;;;;;AAgCzB,SAAgB,iCACd,UAA4C,CAAC,GACT;CACpC,MAAM,MAAM,QAAQ,OAAO,QAAQ,IAAI;CAEvC,OAAO,qBAAgD;EACrD;EACA,WAAW,QAAQ;EACnB,YAAY,QAAQ;EACpB,aAAa,QAAQ;EACrB,SAAS;GACP,SAAS;GACT;GACA,aAAa,QAAQ;GACrB,iBAAiB,QAAQ;EAC3B;EACA,mBAAmB;EACnB,YAAY;EACZ,aAAa,YAAY,iBAAiB,QAAQ,QAAQ;CAC5D,CAAC;AACH;AAEA,SAAS,iBAAiB,OAA2C;CACnE,IAAI,CAAC,SAAS,KAAK,KAAK,MAAM,YAAY,oBAAoB,CAAC,MAAM,QAAQ,MAAM,MAAM,GACvF,MAAM,IAAI,MAAM,qEAAqE;CAGvF,MAAM,SAAS,MAAM,OAAO,KAAK,UAAU;EACzC,IACE,CAAC,SAAS,KAAK,KACf,OAAO,MAAM,SAAS,YACtB,OAAO,MAAM,SAAS,YACtB,CAAC,gBAAgB,MAAM,MAAM,GAE7B,MAAM,IAAI,MAAM,wDAAwD;EAG1E,MAAM,WAAW,MAAM;EACvB,MAAM,cAAc,aAAa,SAAY,IAAI;EAEjD,IACE,OAAO,KAAK,KAAK,CAAC,CAAC,WAAW,eAC7B,aAAa,UAAa,CAAC,qBAAqB,QAAQ,GAEzD,MAAM,IAAI,MAAM,4EAA4E;EAG9F,MAAM,OAAO;GACX,MAAM,MAAM;GACZ,MAAM,MAAM;GACZ,QAAQ,uBAAuB,MAAM,MAAM;EAC7C;EAEA,OAAO,OAAO,OACZ,aAAa,SAAY,OAAO;GAAE,GAAG;GAAM,UAAU,OAAO,OAAO,EAAE,GAAG,SAAS,CAAC;EAAE,CACtF;CACF,CAAC;CAED,OAAO,OAAO,OAAO;EAAE,SAAS;EAAkB,QAAQ,OAAO,OAAO,MAAM;CAAE,CAAC;AACnF;AAEA,SAAS,qBAAqB,OAAiD;CAC7E,OAAO,SAAS,KAAK,KAAK,OAAO,OAAO,KAAK,CAAC,CAAC,OAAO,UAAU,OAAO,UAAU,QAAQ;AAC3F;AAEA,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,gBAAgB,OAAwC;CAC/D,OACE,OAAO,UAAU,YACjB;EAAC;EAAO;EAAQ;EAAO;EAAU;EAAS;EAAW;EAAQ;CAAK,CAAC,CAAC,SAClE,MAAM,YAAY,CACpB;AAEJ;AAEA,SAAS,uBAAuB,OAA8C;CAC5E,OAAO,MAAM,YAAY,MAAM,QAAQ,QAAS,MAAM,YAAY;AACpE"}
+{"version":3,"file":"route-registration-snapshot.mjs","names":[],"sources":["../../../../../../../../packages/core/src/production/route-registration-snapshot.ts"],"sourcesContent":["import type { NamedApiRoute, RequestMethod } from \"../router/types\";\nimport type { Environment, RuntimeStrategy } from \"../utils/environment\";\nimport {\n  runRegistrationChild,\n  type RegistrationChildForker,\n  type RegistrationChildProcess,\n} from \"./registration-child-runner\";\n\nconst PROTOCOL_VERSION = 1;\n\nexport type RouteRegistrationSnapshot = Readonly<{\n  version: typeof PROTOCOL_VERSION;\n  routes: readonly NamedApiRoute[];\n}>;\n\nexport type RouteRegistrationChildRequest = Readonly<{\n  version: typeof PROTOCOL_VERSION;\n  cwd: string;\n  environment?: Environment;\n  runtimeStrategy?: RuntimeStrategy;\n}>;\n\nexport type RouteRegistrationChildProcess = RegistrationChildProcess;\n\nexport type RouteRegistrationSnapshotOptions = Readonly<{\n  cwd?: string;\n  environment?: Environment;\n  runtimeStrategy?: RuntimeStrategy;\n  timeoutMs?: number;\n  childEntry?: string;\n  forkProcess?: RegistrationChildForker;\n}>;\n\n/**\n * Collect named application API routes in a fresh process.\n *\n * The child imports application registration modules but deliberately does not\n * register, boot, or start connectors. Application module top-level code can\n * still have arbitrary user-owned side effects; this boundary is framework-only.\n */\nexport function collectRouteRegistrationSnapshot(\n  options: RouteRegistrationSnapshotOptions = {},\n): Promise<RouteRegistrationSnapshot> {\n  const cwd = options.cwd ?? process.cwd();\n\n  return runRegistrationChild<RouteRegistrationSnapshot>({\n    cwd,\n    timeoutMs: options.timeoutMs,\n    childEntry: options.childEntry,\n    forkProcess: options.forkProcess,\n    request: {\n      version: PROTOCOL_VERSION,\n      cwd,\n      environment: options.environment,\n      runtimeStrategy: options.runtimeStrategy,\n    } satisfies RouteRegistrationChildRequest,\n    resultMessageType: \"route-registration:snapshot\",\n    resultNoun: \"snapshot\",\n    readResult: (message) => validateSnapshot(message.snapshot),\n  });\n}\n\nfunction validateSnapshot(value: unknown): RouteRegistrationSnapshot {\n  if (!isRecord(value) || value.version !== PROTOCOL_VERSION || !Array.isArray(value.routes)) {\n    throw new Error(\"Route registration child sent an invalid snapshot protocol payload.\");\n  }\n\n  const routes = value.routes.map((route) => {\n    if (\n      !isRecord(route) ||\n      typeof route.name !== \"string\" ||\n      typeof route.path !== \"string\" ||\n      !isRequestMethod(route.method)\n    ) {\n      throw new Error(\"Route registration child sent an invalid route record.\");\n    }\n\n    const response = route.response;\n    const allowedKeys = response === undefined ? 3 : 4;\n\n    if (\n      Object.keys(route).length !== allowedKeys ||\n      (response !== undefined && !isResponseTypeRecord(response))\n    ) {\n      throw new Error(\"Route registration child sent a route record with non-browser-safe fields.\");\n    }\n\n    const base = {\n      name: route.name,\n      path: route.path,\n      method: normalizeRequestMethod(route.method),\n    };\n\n    return Object.freeze(\n      response === undefined ? base : { ...base, response: Object.freeze({ ...response }) },\n    );\n  });\n\n  return Object.freeze({ version: PROTOCOL_VERSION, routes: Object.freeze(routes) });\n}\n\nfunction isResponseTypeRecord(value: unknown): value is Record<string, string> {\n  return isRecord(value) && Object.values(value).every((entry) => typeof entry === \"string\");\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isRequestMethod(value: unknown): value is RequestMethod {\n  return (\n    typeof value === \"string\" &&\n    [\"get\", \"post\", \"put\", \"delete\", \"patch\", \"options\", \"head\", \"all\"].includes(\n      value.toLowerCase(),\n    )\n  );\n}\n\nfunction normalizeRequestMethod(value: RequestMethod | string): RequestMethod {\n  return value.toLowerCase() === \"all\" ? \"all\" : (value.toUpperCase() as RequestMethod);\n}\n\n"],"mappings":";;;AAQA,MAAM,mBAAmB;;;;;;;;AAgCzB,SAAgB,iCACd,UAA4C,CAAC,GACT;CACpC,MAAM,MAAM,QAAQ,OAAO,QAAQ,IAAI;CAEvC,OAAO,qBAAgD;EACrD;EACA,WAAW,QAAQ;EACnB,YAAY,QAAQ;EACpB,aAAa,QAAQ;EACrB,SAAS;GACP,SAAS;GACT;GACA,aAAa,QAAQ;GACrB,iBAAiB,QAAQ;EAC3B;EACA,mBAAmB;EACnB,YAAY;EACZ,aAAa,YAAY,iBAAiB,QAAQ,QAAQ;CAC5D,CAAC;AACH;AAEA,SAAS,iBAAiB,OAA2C;CACnE,IAAI,CAAC,SAAS,KAAK,KAAK,MAAM,YAAY,oBAAoB,CAAC,MAAM,QAAQ,MAAM,MAAM,GACvF,MAAM,IAAI,MAAM,qEAAqE;CAGvF,MAAM,SAAS,MAAM,OAAO,KAAK,UAAU;EACzC,IACE,CAAC,SAAS,KAAK,KACf,OAAO,MAAM,SAAS,YACtB,OAAO,MAAM,SAAS,YACtB,CAAC,gBAAgB,MAAM,MAAM,GAE7B,MAAM,IAAI,MAAM,wDAAwD;EAG1E,MAAM,WAAW,MAAM;EACvB,MAAM,cAAc,aAAa,SAAY,IAAI;EAEjD,IACE,OAAO,KAAK,KAAK,CAAC,CAAC,WAAW,eAC7B,aAAa,UAAa,CAAC,qBAAqB,QAAQ,GAEzD,MAAM,IAAI,MAAM,4EAA4E;EAG9F,MAAM,OAAO;GACX,MAAM,MAAM;GACZ,MAAM,MAAM;GACZ,QAAQ,uBAAuB,MAAM,MAAM;EAC7C;EAEA,OAAO,OAAO,OACZ,aAAa,SAAY,OAAO;GAAE,GAAG;GAAM,UAAU,OAAO,OAAO,EAAE,GAAG,SAAS,CAAC;EAAE,CACtF;CACF,CAAC;CAED,OAAO,OAAO,OAAO;EAAE,SAAS;EAAkB,QAAQ,OAAO,OAAO,MAAM;CAAE,CAAC;AACnF;AAEA,SAAS,qBAAqB,OAAiD;CAC7E,OAAO,SAAS,KAAK,KAAK,OAAO,OAAO,KAAK,CAAC,CAAC,OAAO,UAAU,OAAO,UAAU,QAAQ;AAC3F;AAEA,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,gBAAgB,OAAwC;CAC/D,OACE,OAAO,UAAU,YACjB;EAAC;EAAO;EAAQ;EAAO;EAAU;EAAS;EAAW;EAAQ;CAAK,CAAC,CAAC,SAClE,MAAM,YAAY,CACpB;AAEJ;AAEA,SAAS,uBAAuB,OAA8C;CAC5E,OAAO,MAAM,YAAY,MAAM,QAAQ,QAAS,MAAM,YAAY;AACpE"}

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

@@ -1,6 +1,6 @@
 import path from "node:path";
 
-//#region ../core/src/production/tsconfig-path-aliases.ts
+//#region ../../packages/core/src/production/tsconfig-path-aliases.ts
 /**
 * Turn a tsconfig `paths` map into the WILDCARD entries only, resolved
 * against `baseUrl`. Exact entries are excluded: esbuild's own `alias`

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

@@ -1 +1 @@
-{"version":3,"file":"tsconfig-path-aliases.mjs","names":[],"sources":["../../../../../../../core/src/production/tsconfig-path-aliases.ts"],"sourcesContent":["import path from \"node:path\";\nimport type { Plugin } from \"esbuild\";\n\nexport type WildcardPathAlias = Readonly<{\n  /** The literal text before the `*` — `app/` for `\"app/*\"`. */\n  prefix: string;\n  /** The literal text after the `*`. Almost always empty. */\n  suffix: string;\n  /** The `paths` targets, each still carrying its own `*`, resolved against `baseUrl`. */\n  targets: readonly string[];\n}>;\n\n/**\n * Turn a tsconfig `paths` map into the WILDCARD entries only, resolved\n * against `baseUrl`. Exact entries are excluded: esbuild's own `alias`\n * option handles those, and it is the better mechanism where it applies.\n */\nexport function collectWildcardPathAliases(\n  paths: Record<string, string[] | undefined>,\n  baseUrl: string,\n): WildcardPathAlias[] {\n  const aliases: WildcardPathAlias[] = [];\n\n  for (const [from, targets] of Object.entries(paths)) {\n    if (!Array.isArray(targets) || targets.length === 0) continue;\n\n    const star = from.indexOf(\"*\");\n    if (star === -1) continue;\n\n    aliases.push({\n      prefix: from.slice(0, star),\n      suffix: from.slice(star + 1),\n      targets: targets.map((target) => path.resolve(baseUrl, target)),\n    });\n  }\n\n  // Longest prefix first, which is what TypeScript itself does: with both\n  // `app/*` and `app/users/*` declared, the more specific one has to be tried\n  // first or it can never match.\n  return aliases.sort((a, b) => b.prefix.length - a.prefix.length);\n}\n\n/**\n * The substitution TypeScript performs for one `paths` entry: whatever the\n * `*` matched, spliced into each target's own `*`.\n */\nexport function substituteWildcard(\n  alias: WildcardPathAlias,\n  specifier: string,\n): string[] | undefined {\n  if (!specifier.startsWith(alias.prefix)) return undefined;\n  if (alias.suffix && !specifier.endsWith(alias.suffix)) return undefined;\n\n  const matched = specifier.slice(\n    alias.prefix.length,\n    alias.suffix ? specifier.length - alias.suffix.length : undefined,\n  );\n\n  if (!matched) return undefined;\n\n  return alias.targets.map((target) => target.replace(\"*\", matched));\n}\n\n/**\n * Resolve the tsconfig `paths` entries that esbuild's `alias` option cannot\n * express — the WILDCARD ones.\n *\n * **The defect.** `buildAliasMapFromTsconfig` skips any key ending in `/*`,\n * because esbuild's `alias` takes exact package names and nothing else. That\n * is a correct statement about `alias` and it left the wildcards handled by\n * nobody: `app/*` and `web/*` are how this app's own source refers to itself\n * (`import { User } from \"app/users/models/user.model\"`), and under\n * `packages: \"external\"` every one of those survived into the bundle as a\n * bare specifier. Node then looked for a PACKAGE called `app`:\n *\n * ```\n * Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'app' imported from …/dist/app.js\n * ```\n *\n * The build reported success; the failure waited until `warlock start`.\n *\n * **The resolution is delegated, not reimplemented.** This plugin performs\n * only the substitution TypeScript defines — splice what `*` matched into the\n * target — and hands the resulting ABSOLUTE path straight back to esbuild\n * through `build.resolve`. Extension probing, `index` files, `exports` maps\n * and directory handling stay esbuild's, so a path alias resolves exactly as\n * the same file would have resolved through a relative import. A candidate\n * that does not resolve is reported as esbuild's own error rather than\n * quietly falling through to the next candidate and then to \"external\",\n * which is how this became a runtime failure in the first place.\n */\nexport function tsconfigPathAliases(options: {\n  baseUrl: string;\n  paths: Record<string, string[] | undefined>;\n}): Plugin {\n  const aliases = collectWildcardPathAliases(options.paths, options.baseUrl);\n\n  return {\n    name: \"warlock:tsconfig-path-aliases\",\n    setup(build) {\n      if (aliases.length === 0) return;\n\n      build.onResolve({ filter: /.*/ }, async (args) => {\n        if (args.pluginData?.warlockTsconfigPathAlias) return undefined;\n        if (args.namespace !== \"file\" && args.namespace !== \"\") return undefined;\n        if (args.path.startsWith(\".\") || path.isAbsolute(args.path)) return undefined;\n\n        for (const alias of aliases) {\n          const candidates = substituteWildcard(alias, args.path);\n          if (!candidates) continue;\n\n          let lastResult: Awaited<ReturnType<typeof build.resolve>> | undefined;\n\n          for (const candidate of candidates) {\n            const result = await build.resolve(candidate, {\n              kind: args.kind,\n              importer: args.importer,\n              resolveDir: args.resolveDir || path.dirname(args.importer),\n              pluginData: { warlockTsconfigPathAlias: true },\n            });\n\n            lastResult = result;\n\n            if (result.errors.length === 0) {\n              return { path: result.path, external: result.external, namespace: result.namespace };\n            }\n          }\n\n          // The prefix matched a declared alias and NO target resolved. That\n          // is a broken import, and saying so here is the whole point — the\n          // alternative is the silent external that produced the\n          // `Cannot find package 'app'` above.\n          return lastResult ? { errors: lastResult.errors } : undefined;\n        }\n\n        return undefined;\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;AAiBA,SAAgB,2BACd,OACA,SACqB;CACrB,MAAM,UAA+B,CAAC;CAEtC,KAAK,MAAM,CAAC,MAAM,YAAY,OAAO,QAAQ,KAAK,GAAG;EACnD,IAAI,CAAC,MAAM,QAAQ,OAAO,KAAK,QAAQ,WAAW,GAAG;EAErD,MAAM,OAAO,KAAK,QAAQ,GAAG;EAC7B,IAAI,SAAS,IAAI;EAEjB,QAAQ,KAAK;GACX,QAAQ,KAAK,MAAM,GAAG,IAAI;GAC1B,QAAQ,KAAK,MAAM,OAAO,CAAC;GAC3B,SAAS,QAAQ,KAAK,WAAW,KAAK,QAAQ,SAAS,MAAM,CAAC;EAChE,CAAC;CACH;CAKA,OAAO,QAAQ,MAAM,GAAG,MAAM,EAAE,OAAO,SAAS,EAAE,OAAO,MAAM;AACjE;;;;;AAMA,SAAgB,mBACd,OACA,WACsB;CACtB,IAAI,CAAC,UAAU,WAAW,MAAM,MAAM,GAAG,OAAO;CAChD,IAAI,MAAM,UAAU,CAAC,UAAU,SAAS,MAAM,MAAM,GAAG,OAAO;CAE9D,MAAM,UAAU,UAAU,MACxB,MAAM,OAAO,QACb,MAAM,SAAS,UAAU,SAAS,MAAM,OAAO,SAAS,MAC1D;CAEA,IAAI,CAAC,SAAS,OAAO;CAErB,OAAO,MAAM,QAAQ,KAAK,WAAW,OAAO,QAAQ,KAAK,OAAO,CAAC;AACnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,oBAAoB,SAGzB;CACT,MAAM,UAAU,2BAA2B,QAAQ,OAAO,QAAQ,OAAO;CAEzE,OAAO;EACL,MAAM;EACN,MAAM,OAAO;GACX,IAAI,QAAQ,WAAW,GAAG;GAE1B,MAAM,UAAU,EAAE,QAAQ,KAAK,GAAG,OAAO,SAAS;IAChD,IAAI,KAAK,YAAY,0BAA0B,OAAO;IACtD,IAAI,KAAK,cAAc,UAAU,KAAK,cAAc,IAAI,OAAO;IAC/D,IAAI,KAAK,KAAK,WAAW,GAAG,KAAK,KAAK,WAAW,KAAK,IAAI,GAAG,OAAO;IAEpE,KAAK,MAAM,SAAS,SAAS;KAC3B,MAAM,aAAa,mBAAmB,OAAO,KAAK,IAAI;KACtD,IAAI,CAAC,YAAY;KAEjB,IAAI;KAEJ,KAAK,MAAM,aAAa,YAAY;MAClC,MAAM,SAAS,MAAM,MAAM,QAAQ,WAAW;OAC5C,MAAM,KAAK;OACX,UAAU,KAAK;OACf,YAAY,KAAK,cAAc,KAAK,QAAQ,KAAK,QAAQ;OACzD,YAAY,EAAE,0BAA0B,KAAK;MAC/C,CAAC;MAED,aAAa;MAEb,IAAI,OAAO,OAAO,WAAW,GAC3B,OAAO;OAAE,MAAM,OAAO;OAAM,UAAU,OAAO;OAAU,WAAW,OAAO;MAAU;KAEvF;KAMA,OAAO,aAAa,EAAE,QAAQ,WAAW,OAAO,IAAI;IACtD;GAGF,CAAC;EACH;CACF;AACF"}
+{"version":3,"file":"tsconfig-path-aliases.mjs","names":[],"sources":["../../../../../../../../packages/core/src/production/tsconfig-path-aliases.ts"],"sourcesContent":["import path from \"node:path\";\nimport type { Plugin } from \"esbuild\";\n\nexport type WildcardPathAlias = Readonly<{\n  /** The literal text before the `*` — `app/` for `\"app/*\"`. */\n  prefix: string;\n  /** The literal text after the `*`. Almost always empty. */\n  suffix: string;\n  /** The `paths` targets, each still carrying its own `*`, resolved against `baseUrl`. */\n  targets: readonly string[];\n}>;\n\n/**\n * Turn a tsconfig `paths` map into the WILDCARD entries only, resolved\n * against `baseUrl`. Exact entries are excluded: esbuild's own `alias`\n * option handles those, and it is the better mechanism where it applies.\n */\nexport function collectWildcardPathAliases(\n  paths: Record<string, string[] | undefined>,\n  baseUrl: string,\n): WildcardPathAlias[] {\n  const aliases: WildcardPathAlias[] = [];\n\n  for (const [from, targets] of Object.entries(paths)) {\n    if (!Array.isArray(targets) || targets.length === 0) continue;\n\n    const star = from.indexOf(\"*\");\n    if (star === -1) continue;\n\n    aliases.push({\n      prefix: from.slice(0, star),\n      suffix: from.slice(star + 1),\n      targets: targets.map((target) => path.resolve(baseUrl, target)),\n    });\n  }\n\n  // Longest prefix first, which is what TypeScript itself does: with both\n  // `app/*` and `app/users/*` declared, the more specific one has to be tried\n  // first or it can never match.\n  return aliases.sort((a, b) => b.prefix.length - a.prefix.length);\n}\n\n/**\n * The substitution TypeScript performs for one `paths` entry: whatever the\n * `*` matched, spliced into each target's own `*`.\n */\nexport function substituteWildcard(\n  alias: WildcardPathAlias,\n  specifier: string,\n): string[] | undefined {\n  if (!specifier.startsWith(alias.prefix)) return undefined;\n  if (alias.suffix && !specifier.endsWith(alias.suffix)) return undefined;\n\n  const matched = specifier.slice(\n    alias.prefix.length,\n    alias.suffix ? specifier.length - alias.suffix.length : undefined,\n  );\n\n  if (!matched) return undefined;\n\n  return alias.targets.map((target) => target.replace(\"*\", matched));\n}\n\n/**\n * Resolve the tsconfig `paths` entries that esbuild's `alias` option cannot\n * express — the WILDCARD ones.\n *\n * **The defect.** `buildAliasMapFromTsconfig` skips any key ending in `/*`,\n * because esbuild's `alias` takes exact package names and nothing else. That\n * is a correct statement about `alias` and it left the wildcards handled by\n * nobody: `app/*` and `web/*` are how this app's own source refers to itself\n * (`import { User } from \"app/users/models/user.model\"`), and under\n * `packages: \"external\"` every one of those survived into the bundle as a\n * bare specifier. Node then looked for a PACKAGE called `app`:\n *\n * ```\n * Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'app' imported from …/dist/app.js\n * ```\n *\n * The build reported success; the failure waited until `warlock start`.\n *\n * **The resolution is delegated, not reimplemented.** This plugin performs\n * only the substitution TypeScript defines — splice what `*` matched into the\n * target — and hands the resulting ABSOLUTE path straight back to esbuild\n * through `build.resolve`. Extension probing, `index` files, `exports` maps\n * and directory handling stay esbuild's, so a path alias resolves exactly as\n * the same file would have resolved through a relative import. A candidate\n * that does not resolve is reported as esbuild's own error rather than\n * quietly falling through to the next candidate and then to \"external\",\n * which is how this became a runtime failure in the first place.\n */\nexport function tsconfigPathAliases(options: {\n  baseUrl: string;\n  paths: Record<string, string[] | undefined>;\n}): Plugin {\n  const aliases = collectWildcardPathAliases(options.paths, options.baseUrl);\n\n  return {\n    name: \"warlock:tsconfig-path-aliases\",\n    setup(build) {\n      if (aliases.length === 0) return;\n\n      build.onResolve({ filter: /.*/ }, async (args) => {\n        if (args.pluginData?.warlockTsconfigPathAlias) return undefined;\n        if (args.namespace !== \"file\" && args.namespace !== \"\") return undefined;\n        if (args.path.startsWith(\".\") || path.isAbsolute(args.path)) return undefined;\n\n        for (const alias of aliases) {\n          const candidates = substituteWildcard(alias, args.path);\n          if (!candidates) continue;\n\n          let lastResult: Awaited<ReturnType<typeof build.resolve>> | undefined;\n\n          for (const candidate of candidates) {\n            const result = await build.resolve(candidate, {\n              kind: args.kind,\n              importer: args.importer,\n              resolveDir: args.resolveDir || path.dirname(args.importer),\n              pluginData: { warlockTsconfigPathAlias: true },\n            });\n\n            lastResult = result;\n\n            if (result.errors.length === 0) {\n              return { path: result.path, external: result.external, namespace: result.namespace };\n            }\n          }\n\n          // The prefix matched a declared alias and NO target resolved. That\n          // is a broken import, and saying so here is the whole point — the\n          // alternative is the silent external that produced the\n          // `Cannot find package 'app'` above.\n          return lastResult ? { errors: lastResult.errors } : undefined;\n        }\n\n        return undefined;\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;AAiBA,SAAgB,2BACd,OACA,SACqB;CACrB,MAAM,UAA+B,CAAC;CAEtC,KAAK,MAAM,CAAC,MAAM,YAAY,OAAO,QAAQ,KAAK,GAAG;EACnD,IAAI,CAAC,MAAM,QAAQ,OAAO,KAAK,QAAQ,WAAW,GAAG;EAErD,MAAM,OAAO,KAAK,QAAQ,GAAG;EAC7B,IAAI,SAAS,IAAI;EAEjB,QAAQ,KAAK;GACX,QAAQ,KAAK,MAAM,GAAG,IAAI;GAC1B,QAAQ,KAAK,MAAM,OAAO,CAAC;GAC3B,SAAS,QAAQ,KAAK,WAAW,KAAK,QAAQ,SAAS,MAAM,CAAC;EAChE,CAAC;CACH;CAKA,OAAO,QAAQ,MAAM,GAAG,MAAM,EAAE,OAAO,SAAS,EAAE,OAAO,MAAM;AACjE;;;;;AAMA,SAAgB,mBACd,OACA,WACsB;CACtB,IAAI,CAAC,UAAU,WAAW,MAAM,MAAM,GAAG,OAAO;CAChD,IAAI,MAAM,UAAU,CAAC,UAAU,SAAS,MAAM,MAAM,GAAG,OAAO;CAE9D,MAAM,UAAU,UAAU,MACxB,MAAM,OAAO,QACb,MAAM,SAAS,UAAU,SAAS,MAAM,OAAO,SAAS,MAC1D;CAEA,IAAI,CAAC,SAAS,OAAO;CAErB,OAAO,MAAM,QAAQ,KAAK,WAAW,OAAO,QAAQ,KAAK,OAAO,CAAC;AACnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,oBAAoB,SAGzB;CACT,MAAM,UAAU,2BAA2B,QAAQ,OAAO,QAAQ,OAAO;CAEzE,OAAO;EACL,MAAM;EACN,MAAM,OAAO;GACX,IAAI,QAAQ,WAAW,GAAG;GAE1B,MAAM,UAAU,EAAE,QAAQ,KAAK,GAAG,OAAO,SAAS;IAChD,IAAI,KAAK,YAAY,0BAA0B,OAAO;IACtD,IAAI,KAAK,cAAc,UAAU,KAAK,cAAc,IAAI,OAAO;IAC/D,IAAI,KAAK,KAAK,WAAW,GAAG,KAAK,KAAK,WAAW,KAAK,IAAI,GAAG,OAAO;IAEpE,KAAK,MAAM,SAAS,SAAS;KAC3B,MAAM,aAAa,mBAAmB,OAAO,KAAK,IAAI;KACtD,IAAI,CAAC,YAAY;KAEjB,IAAI;KAEJ,KAAK,MAAM,aAAa,YAAY;MAClC,MAAM,SAAS,MAAM,MAAM,QAAQ,WAAW;OAC5C,MAAM,KAAK;OACX,UAAU,KAAK;OACf,YAAY,KAAK,cAAc,KAAK,QAAQ,KAAK,QAAQ;OACzD,YAAY,EAAE,0BAA0B,KAAK;MAC/C,CAAC;MAED,aAAa;MAEb,IAAI,OAAO,OAAO,WAAW,GAC3B,OAAO;OAAE,MAAM,OAAO;OAAM,UAAU,OAAO;OAAU,WAAW,OAAO;MAAU;KAEvF;KAMA,OAAO,aAAa,EAAE,QAAQ,WAAW,OAAO,IAAI;IACtD;GAGF,CAAC;EACH;CACF;AACF"}

package/esm/react/index.d.mts

@@ -1,6 +1,6 @@
 import { ComponentType, ReactElement, ReactNode } from "react";
 
-//#region ../core/src/react/index.d.ts
+//#region ../../packages/core/src/react/index.d.ts
 /**
  * Render a React element/component to HTML string
  *

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../../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":";;;;;AAwKA;;;;;;;;;;;;;iBAAgB,WAAA,CAAY,YAAA,EAAc,YAAA,GAAe,aAAA,GAAgB,SAAA"}

package/esm/react/index.mjs

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
 
-//#region ../core/src/react/index.ts
+//#region ../../packages/core/src/react/index.ts
 /**
 * Installation instructions for React
 */

package/esm/react/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../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,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"}

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

@@ -3,7 +3,7 @@ import { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, Paginat
 import { QueryBuilderContract as QueryBuilderContract$1 } from "../../contracts/query-builder.contract.mjs";
 import { ChildModel, Model } from "@warlock.js/cascade";
 
-//#region ../core/src/repositories/adapters/cascade/cascade-adapter.d.ts
+//#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;
 /**

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

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

package/esm/repositories/adapters/cascade/cascade-adapter.mjs

@@ -1,7 +1,7 @@
 import { CascadeQueryBuilder } from "./cascade-query-builder.mjs";
 import { Model, afterCommit } from "@warlock.js/cascade";
 
-//#region ../core/src/repositories/adapters/cascade/cascade-adapter.ts
+//#region ../../packages/core/src/repositories/adapters/cascade/cascade-adapter.ts
 /** Records loaded and written per `updateMany` batch. */
 const UPDATE_MANY_BATCH_SIZE = 500;
 /**

package/esm/repositories/adapters/cascade/cascade-adapter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cascade-adapter.mjs","names":[],"sources":["../../../../../../../../../core/src/repositories/adapters/cascade/cascade-adapter.ts"],"sourcesContent":["import { afterCommit, type ChildModel, Model } from \"@warlock.js/cascade\";\nimport type {\n  ChunkCallback,\n  CursorPaginationOptions,\n  CursorPaginationResult,\n  PaginationResult,\n  QueryBuilderContract,\n  RepositoryAdapterContract,\n} from \"../../contracts\";\nimport { CascadeQueryBuilder } from \"./cascade-query-builder\";\n\n/** Records loaded and written per `updateMany` batch. */\nexport const UPDATE_MANY_BATCH_SIZE = 500;\n\n/**\n * Cascade adapter for Cascade-Next ORM\n * Implements RepositoryAdapterContract for @warlock.js/cascade\n *\n * @template T - The model instance type\n */\nexport class CascadeAdapter<T extends Model<any>> implements RepositoryAdapterContract<T> {\n  /**\n   * Constructor\n   * @param model - Cascade-Next Model class\n   */\n  public constructor(private model: ChildModel<T>) {}\n\n  // ============================================================================\n  // QUERY BUILDING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.query}\n   */\n  public query(): QueryBuilderContract<T> {\n    return new CascadeQueryBuilder<T>(this.model.query());\n  }\n\n  /**\n   * Register all events\n   */\n  public registerEvents(eventsCallback: any): any[] {\n    const events: any[] = [];\n\n    const modelEvents = this.model.events();\n\n    // Model events fire INSIDE the transaction, before COMMIT. Clear now (existing\n    // behaviour) and again after COMMIT, so a concurrent read that re-cached the\n    // old committed row in between does not leave a stale entry behind.\n    const handle = (model: any) => {\n      eventsCallback(model);\n      afterCommit(() => eventsCallback(model));\n    };\n\n    events.push(\n      modelEvents.onCreated(handle),\n      modelEvents.onUpdated(handle),\n      modelEvents.onDeleted(handle),\n    );\n\n    return events;\n  }\n\n  // ============================================================================\n  // CRUD OPERATIONS\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.find}\n   */\n  public async find(id: any): Promise<T | null> {\n    return await this.model.find(id);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.findBy}\n   */\n  public async findBy(column: string, value: any): Promise<T | null> {\n    return (await this.query().where(column, value).first()) as T | null;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.serializeModel}\n   */\n  public serializeModel(model: T): any {\n    return model.toSnapshot();\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.deserializeModel}\n   */\n  public deserializeModel(data: any): T {\n    return this.model.fromSnapshot(data);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.resolveRepositoryName}\n   */\n  public resolveRepositoryName(): string {\n    return this.model.table;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.create}\n   */\n  public async create(data: any): Promise<T> {\n    return this.model.create(data);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.update}\n   */\n  public async update(id: any, data: any): Promise<T> {\n    const model = id instanceof Model ? id : await this.model.find(id);\n    if (!model) {\n      throw new Error(`Model not found with id ${id}`);\n    }\n\n    await model.save({ merge: data });\n    return model as T;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.delete}\n   */\n  public async delete(id: any): Promise<void> {\n    // Load + destroy so events, delete strategy and repository-cache clearing apply.\n    const record = id instanceof Model ? id : await this.model.find(id);\n\n    if (!record) return;\n\n    await record.destroy();\n  }\n\n  // ============================================================================\n  // BULK OPERATIONS\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.updateMany}\n   */\n  public async updateMany(filter: any, data: any): Promise<number> {\n    const query = this.query();\n\n    // Apply filter\n    if (typeof filter === \"object\") {\n      query.where(filter);\n    }\n\n    let updated = 0;\n\n    // Process in batches instead of loading the whole result set; each batch\n    // is written inside a transaction when the model's driver offers one.\n    await query.chunk(UPDATE_MANY_BATCH_SIZE, async (records) => {\n      const writeBatch = async () => {\n        for (const record of records) {\n          await record.save({ merge: data });\n        }\n      };\n\n      const runInTransaction = (this.model as any).transaction;\n\n      if (typeof runInTransaction === \"function\") {\n        await runInTransaction.call(this.model, writeBatch);\n      } else {\n        await writeBatch();\n      }\n\n      updated += records.length;\n    });\n\n    return updated;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.deleteMany}\n   */\n  public async deleteMany(filter: any): Promise<number> {\n    const query = this.query();\n\n    // Apply filter\n    if (typeof filter === \"object\") {\n      query.where(filter);\n    }\n\n    // Get matching records\n    const records = await query.get();\n\n    // Delete each record\n    for (const record of records) {\n      await record.destroy();\n    }\n\n    return records.length;\n  }\n\n  // ============================================================================\n  // COUNTING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.count}\n   */\n  public async count(filter?: any): Promise<number> {\n    const query = this.query();\n\n    if (filter && typeof filter === \"object\") {\n      query.where(filter);\n    }\n\n    return query.count();\n  }\n\n  // ============================================================================\n  // PAGINATION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.paginate}\n   */\n  public async paginate(page: number, limit: number): Promise<PaginationResult<T>> {\n    return this.query().paginate(page, limit);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.cursorPaginate}\n   */\n  public async cursorPaginate(\n    options: CursorPaginationOptions,\n  ): Promise<CursorPaginationResult<T>> {\n    return this.query().cursorPaginate(options);\n  }\n\n  // ============================================================================\n  // CHUNKING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.chunk}\n   */\n  public async chunk(size: number, callback: ChunkCallback<T>): Promise<void> {\n    return this.query().chunk(size, callback);\n  }\n\n  // ============================================================================\n  // MODEL CREATION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.createModel}\n   */\n  public createModel(data: any): T {\n    return new (this.model as any)(data) as T;\n  }\n}\n"],"mappings":";;;;;AAYA,MAAa,yBAAyB;;;;;;;AAQtC,IAAa,iBAAb,MAA0F;;;;;CAKxF,AAAO,YAAY,AAAQ,OAAsB;EAAtB;CAAuB;;;;CASlD,AAAO,QAAiC;EACtC,OAAO,IAAI,oBAAuB,KAAK,MAAM,MAAM,CAAC;CACtD;;;;CAKA,AAAO,eAAe,gBAA4B;EAChD,MAAM,SAAgB,CAAC;EAEvB,MAAM,cAAc,KAAK,MAAM,OAAO;EAKtC,MAAM,UAAU,UAAe;GAC7B,eAAe,KAAK;GACpB,kBAAkB,eAAe,KAAK,CAAC;EACzC;EAEA,OAAO,KACL,YAAY,UAAU,MAAM,GAC5B,YAAY,UAAU,MAAM,GAC5B,YAAY,UAAU,MAAM,CAC9B;EAEA,OAAO;CACT;;;;CASA,MAAa,KAAK,IAA4B;EAC5C,OAAO,MAAM,KAAK,MAAM,KAAK,EAAE;CACjC;;;;CAKA,MAAa,OAAO,QAAgB,OAA+B;EACjE,OAAQ,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,QAAQ,KAAK,CAAC,CAAC,MAAM;CACxD;;;;CAKA,AAAO,eAAe,OAAe;EACnC,OAAO,MAAM,WAAW;CAC1B;;;;CAKA,AAAO,iBAAiB,MAAc;EACpC,OAAO,KAAK,MAAM,aAAa,IAAI;CACrC;;;;CAKA,AAAO,wBAAgC;EACrC,OAAO,KAAK,MAAM;CACpB;;;;CAKA,MAAa,OAAO,MAAuB;EACzC,OAAO,KAAK,MAAM,OAAO,IAAI;CAC/B;;;;CAKA,MAAa,OAAO,IAAS,MAAuB;EAClD,MAAM,QAAQ,cAAc,QAAQ,KAAK,MAAM,KAAK,MAAM,KAAK,EAAE;EACjE,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,2BAA2B,IAAI;EAGjD,MAAM,MAAM,KAAK,EAAE,OAAO,KAAK,CAAC;EAChC,OAAO;CACT;;;;CAKA,MAAa,OAAO,IAAwB;EAE1C,MAAM,SAAS,cAAc,QAAQ,KAAK,MAAM,KAAK,MAAM,KAAK,EAAE;EAElE,IAAI,CAAC,QAAQ;EAEb,MAAM,OAAO,QAAQ;CACvB;;;;CASA,MAAa,WAAW,QAAa,MAA4B;EAC/D,MAAM,QAAQ,KAAK,MAAM;EAGzB,IAAI,OAAO,WAAW,UACpB,MAAM,MAAM,MAAM;EAGpB,IAAI,UAAU;EAId,MAAM,MAAM,WAA8B,OAAO,YAAY;GAC3D,MAAM,aAAa,YAAY;IAC7B,KAAK,MAAM,UAAU,SACnB,MAAM,OAAO,KAAK,EAAE,OAAO,KAAK,CAAC;GAErC;GAEA,MAAM,mBAAoB,KAAK,MAAc;GAE7C,IAAI,OAAO,qBAAqB,YAC9B,MAAM,iBAAiB,KAAK,KAAK,OAAO,UAAU;QAElD,MAAM,WAAW;GAGnB,WAAW,QAAQ;EACrB,CAAC;EAED,OAAO;CACT;;;;CAKA,MAAa,WAAW,QAA8B;EACpD,MAAM,QAAQ,KAAK,MAAM;EAGzB,IAAI,OAAO,WAAW,UACpB,MAAM,MAAM,MAAM;EAIpB,MAAM,UAAU,MAAM,MAAM,IAAI;EAGhC,KAAK,MAAM,UAAU,SACnB,MAAM,OAAO,QAAQ;EAGvB,OAAO,QAAQ;CACjB;;;;CASA,MAAa,MAAM,QAA+B;EAChD,MAAM,QAAQ,KAAK,MAAM;EAEzB,IAAI,UAAU,OAAO,WAAW,UAC9B,MAAM,MAAM,MAAM;EAGpB,OAAO,MAAM,MAAM;CACrB;;;;CASA,MAAa,SAAS,MAAc,OAA6C;EAC/E,OAAO,KAAK,MAAM,CAAC,CAAC,SAAS,MAAM,KAAK;CAC1C;;;;CAKA,MAAa,eACX,SACoC;EACpC,OAAO,KAAK,MAAM,CAAC,CAAC,eAAe,OAAO;CAC5C;;;;CASA,MAAa,MAAM,MAAc,UAA2C;EAC1E,OAAO,KAAK,MAAM,CAAC,CAAC,MAAM,MAAM,QAAQ;CAC1C;;;;CASA,AAAO,YAAY,MAAc;EAC/B,OAAO,IAAK,KAAK,MAAc,IAAI;CACrC;AACF"}
+{"version":3,"file":"cascade-adapter.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/repositories/adapters/cascade/cascade-adapter.ts"],"sourcesContent":["import { afterCommit, type ChildModel, Model } from \"@warlock.js/cascade\";\nimport type {\n  ChunkCallback,\n  CursorPaginationOptions,\n  CursorPaginationResult,\n  PaginationResult,\n  QueryBuilderContract,\n  RepositoryAdapterContract,\n} from \"../../contracts\";\nimport { CascadeQueryBuilder } from \"./cascade-query-builder\";\n\n/** Records loaded and written per `updateMany` batch. */\nexport const UPDATE_MANY_BATCH_SIZE = 500;\n\n/**\n * Cascade adapter for Cascade-Next ORM\n * Implements RepositoryAdapterContract for @warlock.js/cascade\n *\n * @template T - The model instance type\n */\nexport class CascadeAdapter<T extends Model<any>> implements RepositoryAdapterContract<T> {\n  /**\n   * Constructor\n   * @param model - Cascade-Next Model class\n   */\n  public constructor(private model: ChildModel<T>) {}\n\n  // ============================================================================\n  // QUERY BUILDING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.query}\n   */\n  public query(): QueryBuilderContract<T> {\n    return new CascadeQueryBuilder<T>(this.model.query());\n  }\n\n  /**\n   * Register all events\n   */\n  public registerEvents(eventsCallback: any): any[] {\n    const events: any[] = [];\n\n    const modelEvents = this.model.events();\n\n    // Model events fire INSIDE the transaction, before COMMIT. Clear now (existing\n    // behaviour) and again after COMMIT, so a concurrent read that re-cached the\n    // old committed row in between does not leave a stale entry behind.\n    const handle = (model: any) => {\n      eventsCallback(model);\n      afterCommit(() => eventsCallback(model));\n    };\n\n    events.push(\n      modelEvents.onCreated(handle),\n      modelEvents.onUpdated(handle),\n      modelEvents.onDeleted(handle),\n    );\n\n    return events;\n  }\n\n  // ============================================================================\n  // CRUD OPERATIONS\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.find}\n   */\n  public async find(id: any): Promise<T | null> {\n    return await this.model.find(id);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.findBy}\n   */\n  public async findBy(column: string, value: any): Promise<T | null> {\n    return (await this.query().where(column, value).first()) as T | null;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.serializeModel}\n   */\n  public serializeModel(model: T): any {\n    return model.toSnapshot();\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.deserializeModel}\n   */\n  public deserializeModel(data: any): T {\n    return this.model.fromSnapshot(data);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.resolveRepositoryName}\n   */\n  public resolveRepositoryName(): string {\n    return this.model.table;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.create}\n   */\n  public async create(data: any): Promise<T> {\n    return this.model.create(data);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.update}\n   */\n  public async update(id: any, data: any): Promise<T> {\n    const model = id instanceof Model ? id : await this.model.find(id);\n    if (!model) {\n      throw new Error(`Model not found with id ${id}`);\n    }\n\n    await model.save({ merge: data });\n    return model as T;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.delete}\n   */\n  public async delete(id: any): Promise<void> {\n    // Load + destroy so events, delete strategy and repository-cache clearing apply.\n    const record = id instanceof Model ? id : await this.model.find(id);\n\n    if (!record) return;\n\n    await record.destroy();\n  }\n\n  // ============================================================================\n  // BULK OPERATIONS\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.updateMany}\n   */\n  public async updateMany(filter: any, data: any): Promise<number> {\n    const query = this.query();\n\n    // Apply filter\n    if (typeof filter === \"object\") {\n      query.where(filter);\n    }\n\n    let updated = 0;\n\n    // Process in batches instead of loading the whole result set; each batch\n    // is written inside a transaction when the model's driver offers one.\n    await query.chunk(UPDATE_MANY_BATCH_SIZE, async (records) => {\n      const writeBatch = async () => {\n        for (const record of records) {\n          await record.save({ merge: data });\n        }\n      };\n\n      const runInTransaction = (this.model as any).transaction;\n\n      if (typeof runInTransaction === \"function\") {\n        await runInTransaction.call(this.model, writeBatch);\n      } else {\n        await writeBatch();\n      }\n\n      updated += records.length;\n    });\n\n    return updated;\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.deleteMany}\n   */\n  public async deleteMany(filter: any): Promise<number> {\n    const query = this.query();\n\n    // Apply filter\n    if (typeof filter === \"object\") {\n      query.where(filter);\n    }\n\n    // Get matching records\n    const records = await query.get();\n\n    // Delete each record\n    for (const record of records) {\n      await record.destroy();\n    }\n\n    return records.length;\n  }\n\n  // ============================================================================\n  // COUNTING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.count}\n   */\n  public async count(filter?: any): Promise<number> {\n    const query = this.query();\n\n    if (filter && typeof filter === \"object\") {\n      query.where(filter);\n    }\n\n    return query.count();\n  }\n\n  // ============================================================================\n  // PAGINATION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.paginate}\n   */\n  public async paginate(page: number, limit: number): Promise<PaginationResult<T>> {\n    return this.query().paginate(page, limit);\n  }\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.cursorPaginate}\n   */\n  public async cursorPaginate(\n    options: CursorPaginationOptions,\n  ): Promise<CursorPaginationResult<T>> {\n    return this.query().cursorPaginate(options);\n  }\n\n  // ============================================================================\n  // CHUNKING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.chunk}\n   */\n  public async chunk(size: number, callback: ChunkCallback<T>): Promise<void> {\n    return this.query().chunk(size, callback);\n  }\n\n  // ============================================================================\n  // MODEL CREATION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc RepositoryAdapterContract.createModel}\n   */\n  public createModel(data: any): T {\n    return new (this.model as any)(data) as T;\n  }\n}\n"],"mappings":"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"}

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

@@ -2,7 +2,7 @@ import { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, FilterO
 import { AggregateExpressions, GroupByFields, QueryBuilderContract as QueryBuilderContract$1 } from "../../contracts/query-builder.contract.mjs";
 import { Model, QueryBuilderContract } from "@warlock.js/cascade";
 
-//#region ../core/src/repositories/adapters/cascade/cascade-query-builder.d.ts
+//#region ../../packages/core/src/repositories/adapters/cascade/cascade-query-builder.d.ts
 /**
  * Cascade query builder wrapper
  * Wraps Cascade-Next's ModelAggregate to implement QueryBuilderContract

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

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

package/esm/repositories/adapters/cascade/cascade-query-builder.mjs

@@ -1,6 +1,6 @@
 import { FilterApplicator } from "./filter-applicator.mjs";
 
-//#region ../core/src/repositories/adapters/cascade/cascade-query-builder.ts
+//#region ../../packages/core/src/repositories/adapters/cascade/cascade-query-builder.ts
 /**
 * Cascade query builder wrapper
 * Wraps Cascade-Next's ModelAggregate to implement QueryBuilderContract

package/esm/repositories/adapters/cascade/cascade-query-builder.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cascade-query-builder.mjs","names":[],"sources":["../../../../../../../../../core/src/repositories/adapters/cascade/cascade-query-builder.ts"],"sourcesContent":["import type {\n  QueryBuilderContract as CascadeQueryBuilderContract,\n  Model,\n} from \"@warlock.js/cascade\";\nimport type {\n  AggregateExpressions,\n  ChunkCallback,\n  CursorPaginationOptions,\n  CursorPaginationResult,\n  FilterOptions,\n  FilterRules,\n  GroupByFields,\n  PaginationResult,\n  QueryBuilderContract,\n  WhereOperator,\n} from \"../../contracts\";\nimport { FilterApplicator } from \"./filter-applicator\";\n\n/**\n * Cascade query builder wrapper\n * Wraps Cascade-Next's ModelAggregate to implement QueryBuilderContract\n *\n * @template T - The model instance type\n */\nexport class CascadeQueryBuilder<T extends Model> implements QueryBuilderContract<T> {\n  /**\n   * Constructor\n   * @param query - Cascade-Next QueryBuilder instance\n   */\n  public constructor(private query: CascadeQueryBuilderContract<T>) {}\n\n  // ============================================================================\n  // WHERE CLAUSES\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.where}\n   */\n  public where(field: string, value: any): this;\n  public where(field: string, operator: WhereOperator, value: any): this;\n  public where(conditions: Record<string, any>): this;\n  public where(callback: (query: this) => void): this;\n  public where(\n    fieldOrConditionsOrCallback: string | Record<string, any> | ((query: this) => void),\n    operatorOrValue?: WhereOperator | any,\n    value?: any,\n  ): this {\n    if (typeof fieldOrConditionsOrCallback === \"function\") {\n      // Callback\n      fieldOrConditionsOrCallback(this);\n    } else if (typeof fieldOrConditionsOrCallback === \"object\") {\n      // Object conditions\n      this.query.where(fieldOrConditionsOrCallback);\n    } else if (value !== undefined) {\n      // Field, operator, value\n      this.query.where(fieldOrConditionsOrCallback, operatorOrValue, value);\n    } else {\n      // Field, value\n      this.query.where(fieldOrConditionsOrCallback, operatorOrValue);\n    }\n\n    return this;\n  }\n\n  /**\n   * Pretty display the query in terminal\n   */\n  public pretty() {\n    return this.query.pretty();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.orWhere}\n   */\n  public orWhere(field: string, value: any): this;\n  public orWhere(field: string, operator: WhereOperator, value: any): this;\n  public orWhere(conditions: Record<string, any>): this;\n  public orWhere(\n    fieldOrConditions: string | Record<string, any>,\n    operatorOrValue?: WhereOperator | any,\n    value?: any,\n  ): this {\n    if (typeof fieldOrConditions === \"object\") {\n      this.query.orWhere(fieldOrConditions);\n    } else if (value !== undefined) {\n      this.query.orWhere(fieldOrConditions, operatorOrValue, value);\n    } else {\n      this.query.orWhere(fieldOrConditions, operatorOrValue);\n    }\n\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereIn}\n   */\n  public whereIn(field: string, values: any[]): this {\n    this.query.whereIn(field, values);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereNotIn}\n   */\n  public whereNotIn(field: string, values: any[]): this {\n    this.query.whereNotIn(field, values);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereNull}\n   */\n  public whereNull(field: string): this {\n    this.query.whereNull(field);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereNotNull}\n   */\n  public whereNotNull(field: string): this {\n    this.query.whereNotNull(field);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereBetween}\n   */\n  public whereBetween(field: string, range: [any, any]): this {\n    this.query.whereBetween(field, range);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereLike}\n   */\n  public whereLike(field: string, pattern: string): this {\n    this.query.whereLike(field, pattern);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.similarTo}\n   */\n  public similarTo(column: string, embedding: number[], alias?: string): this {\n    this.query.similarTo(column, embedding, alias);\n    return this;\n  }\n\n  // ============================================================================\n  // SELECT / PROJECTION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.select}\n   */\n  public select(fields: string[]): this;\n  public select(...fields: string[]): this;\n  public select(...fields: any[]): this {\n    if (Array.isArray(fields[0])) {\n      this.query.select(fields[0]);\n    } else {\n      this.query.select(fields);\n    }\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.deselect}\n   */\n  public deselect(fields: string[]): this;\n  public deselect(...fields: string[]): this;\n  public deselect(...fields: any[]): this {\n    if (Array.isArray(fields[0])) {\n      this.query.deselect(fields[0]);\n    } else {\n      this.query.deselect(fields);\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // ORDERING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.orderBy}\n   */\n  public orderBy(field: string, direction: \"asc\" | \"desc\" = \"asc\"): this {\n    this.query.orderBy(field, direction);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.sortBy}\n   */\n  public sortBy(orderBy: Record<string, \"asc\" | \"desc\">): this {\n    // Apply each order clause individually\n    for (const [field, direction] of Object.entries(orderBy)) {\n      this.query.orderBy(field, direction);\n    }\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.random}\n   */\n  public random(limit: number): this {\n    this.query.orderByRandom(limit);\n    return this;\n  }\n\n  // ============================================================================\n  // LIMITING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.limit}\n   */\n  public limit(limit: number): this {\n    this.query.limit(limit);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.offset}\n   */\n  public offset(offset: number): this {\n    this.query.offset(offset);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.skip}\n   */\n  public skip(count: number): this {\n    return this.offset(count);\n  }\n\n  // ============================================================================\n  // FILTERING (Repository-specific)\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.applyFilters}\n   */\n  public applyFilters(filters: FilterRules<this>, data: any, options: FilterOptions): this {\n    const applicator = new FilterApplicator();\n    applicator.apply(this.query as any, filters, data, options);\n    return this;\n  }\n\n  // ============================================================================\n  // EXECUTION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.get}\n   */\n  public async get(): Promise<T[]> {\n    return this.query.get();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.first}\n   */\n  public async first(): Promise<T | null> {\n    return this.query.first();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.count}\n   */\n  public async count(): Promise<number> {\n    return this.query.count();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.sum}\n   */\n  public async sum(field: string): Promise<number> {\n    return this.query.sum(field);\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.avg}\n   */\n  public async avg(field: string): Promise<number | null> {\n    return this.query.avg(field);\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.min}\n   */\n  public async min(field: string): Promise<number | null> {\n    return this.query.min(field);\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.max}\n   */\n  public async max(field: string): Promise<number | null> {\n    return this.query.max(field);\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.groupBy}\n   */\n  public async groupBy<R = Record<string, unknown>>(\n    fields: GroupByFields,\n    aggregates: AggregateExpressions,\n  ): Promise<R[]> {\n    return this.query.groupBy(fields, aggregates).get<R>();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.aggregate}\n   *\n   * Whole-set aggregation: groups with no group key so every matching record\n   * falls into a single group, then returns that one summary row.\n   */\n  public async aggregate<R = Record<string, unknown>>(\n    aggregates: AggregateExpressions,\n  ): Promise<R | null> {\n    const rows = await this.query.groupBy([], aggregates).get<R>();\n    return rows[0] ?? null;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.paginate}\n   */\n  public async paginate(page: number, limit: number): Promise<PaginationResult<T>> {\n    const result = await this.query.paginate({ limit, page });\n\n    // Convert Cascade-Next pagination to repository format\n    return {\n      data: result.data,\n      pagination: {\n        ...result.pagination,\n        result: result.data.length,\n      },\n    };\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.cursorPaginate}\n   *\n   * NOTE: This method is a pure executor.\n   * The caller (e.g. RepositoryManager._listImpl) is responsible for applying\n   * the cursor WHERE condition and ORDER BY BEFORE calling this method,\n   * so that the cursor column is always the primary sort key.\n   *\n   * For a forward page (`direction: \"next\"`) the caller sorts ASC and filters\n   * `> cursor`, so the rows already arrive in ascending cursor order.\n   *\n   * For a backward page (`direction: \"prev\"`) the caller sorts DESC and filters\n   * `< cursor`, so rows arrive in DESCENDING order. We re-reverse the trimmed\n   * page back to ascending so callers always receive a page in the same\n   * (ascending) order regardless of direction, and we derive the next/prev\n   * cursors from the page boundaries accordingly.\n   */\n  public async cursorPaginate(\n    options: CursorPaginationOptions,\n  ): Promise<CursorPaginationResult<T>> {\n    const { limit, cursorColumn = \"id\", direction = \"next\" } = options;\n\n    // Fetch limit + 1 to detect whether more pages exist in the scan direction.\n    this.limit(limit + 1);\n\n    const results = await this.get();\n    const hasMore = results.length > limit;\n\n    // Drop the extra record used for the hasMore check. It always sits at the\n    // tail because the caller ordered the scan so the next-to-fetch row is last.\n    const trimmed = hasMore ? results.slice(0, limit) : results;\n\n    const cursorOf = (record: T | undefined): string | number | undefined =>\n      record === undefined ? undefined : ((record as any)[cursorColumn] as string | number);\n\n    if (direction === \"prev\") {\n      // Scan came back DESC; present it ascending.\n      const documents = [...trimmed].reverse();\n      const first = documents[0];\n      const last = documents[documents.length - 1];\n\n      return {\n        data: documents,\n        pagination: {\n          limit,\n          result: documents.length,\n          hasMore,\n          // Going further back is only possible when the backward scan saw more\n          // rows than this page; the boundary is this page's first (smallest) row.\n          prevCursor: hasMore ? cursorOf(first) : undefined,\n          // Going forward always resumes after this page's last (largest) row.\n          nextCursor: cursorOf(last),\n        },\n      };\n    }\n\n    // Forward page — rows already ascending.\n    const documents = trimmed;\n    const first = documents[0];\n    const last = documents[documents.length - 1];\n\n    return {\n      data: documents,\n      pagination: {\n        limit,\n        result: documents.length,\n        hasMore,\n        // Going forward is only possible when the forward scan saw more rows\n        // than this page; the boundary is this page's last (largest) row.\n        nextCursor: hasMore ? cursorOf(last) : undefined,\n        // Going back resumes before this page's first (smallest) row.\n        prevCursor: cursorOf(first),\n      },\n    };\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.chunk}\n   */\n  public async chunk(size: number, callback: ChunkCallback<T>): Promise<void> {\n    return this.query.chunk(size, callback);\n  }\n\n  // ============================================================================\n  // UTILITIES\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.with}\n   */\n  public with(relation: string): this {\n    this.query.with(relation);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.joinWith}\n   */\n  public joinWith(...relations: string[]): this {\n    if (this.query.joinWith) {\n      this.query.joinWith(...relations);\n    } else {\n      console.warn(\n        \"[Repository] joinWith is not supported by the underlying query builder. Falling back to with.\",\n      );\n      for (const relation of relations) {\n        this.query.with(relation);\n      }\n    }\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.clone}\n   */\n  public clone(): this {\n    return new CascadeQueryBuilder(this.query.clone()) as this;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"cascade-query-builder.mjs","names":[],"sources":["../../../../../../../../../../packages/core/src/repositories/adapters/cascade/cascade-query-builder.ts"],"sourcesContent":["import type {\n  QueryBuilderContract as CascadeQueryBuilderContract,\n  Model,\n} from \"@warlock.js/cascade\";\nimport type {\n  AggregateExpressions,\n  ChunkCallback,\n  CursorPaginationOptions,\n  CursorPaginationResult,\n  FilterOptions,\n  FilterRules,\n  GroupByFields,\n  PaginationResult,\n  QueryBuilderContract,\n  WhereOperator,\n} from \"../../contracts\";\nimport { FilterApplicator } from \"./filter-applicator\";\n\n/**\n * Cascade query builder wrapper\n * Wraps Cascade-Next's ModelAggregate to implement QueryBuilderContract\n *\n * @template T - The model instance type\n */\nexport class CascadeQueryBuilder<T extends Model> implements QueryBuilderContract<T> {\n  /**\n   * Constructor\n   * @param query - Cascade-Next QueryBuilder instance\n   */\n  public constructor(private query: CascadeQueryBuilderContract<T>) {}\n\n  // ============================================================================\n  // WHERE CLAUSES\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.where}\n   */\n  public where(field: string, value: any): this;\n  public where(field: string, operator: WhereOperator, value: any): this;\n  public where(conditions: Record<string, any>): this;\n  public where(callback: (query: this) => void): this;\n  public where(\n    fieldOrConditionsOrCallback: string | Record<string, any> | ((query: this) => void),\n    operatorOrValue?: WhereOperator | any,\n    value?: any,\n  ): this {\n    if (typeof fieldOrConditionsOrCallback === \"function\") {\n      // Callback\n      fieldOrConditionsOrCallback(this);\n    } else if (typeof fieldOrConditionsOrCallback === \"object\") {\n      // Object conditions\n      this.query.where(fieldOrConditionsOrCallback);\n    } else if (value !== undefined) {\n      // Field, operator, value\n      this.query.where(fieldOrConditionsOrCallback, operatorOrValue, value);\n    } else {\n      // Field, value\n      this.query.where(fieldOrConditionsOrCallback, operatorOrValue);\n    }\n\n    return this;\n  }\n\n  /**\n   * Pretty display the query in terminal\n   */\n  public pretty() {\n    return this.query.pretty();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.orWhere}\n   */\n  public orWhere(field: string, value: any): this;\n  public orWhere(field: string, operator: WhereOperator, value: any): this;\n  public orWhere(conditions: Record<string, any>): this;\n  public orWhere(\n    fieldOrConditions: string | Record<string, any>,\n    operatorOrValue?: WhereOperator | any,\n    value?: any,\n  ): this {\n    if (typeof fieldOrConditions === \"object\") {\n      this.query.orWhere(fieldOrConditions);\n    } else if (value !== undefined) {\n      this.query.orWhere(fieldOrConditions, operatorOrValue, value);\n    } else {\n      this.query.orWhere(fieldOrConditions, operatorOrValue);\n    }\n\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereIn}\n   */\n  public whereIn(field: string, values: any[]): this {\n    this.query.whereIn(field, values);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereNotIn}\n   */\n  public whereNotIn(field: string, values: any[]): this {\n    this.query.whereNotIn(field, values);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereNull}\n   */\n  public whereNull(field: string): this {\n    this.query.whereNull(field);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereNotNull}\n   */\n  public whereNotNull(field: string): this {\n    this.query.whereNotNull(field);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereBetween}\n   */\n  public whereBetween(field: string, range: [any, any]): this {\n    this.query.whereBetween(field, range);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.whereLike}\n   */\n  public whereLike(field: string, pattern: string): this {\n    this.query.whereLike(field, pattern);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.similarTo}\n   */\n  public similarTo(column: string, embedding: number[], alias?: string): this {\n    this.query.similarTo(column, embedding, alias);\n    return this;\n  }\n\n  // ============================================================================\n  // SELECT / PROJECTION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.select}\n   */\n  public select(fields: string[]): this;\n  public select(...fields: string[]): this;\n  public select(...fields: any[]): this {\n    if (Array.isArray(fields[0])) {\n      this.query.select(fields[0]);\n    } else {\n      this.query.select(fields);\n    }\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.deselect}\n   */\n  public deselect(fields: string[]): this;\n  public deselect(...fields: string[]): this;\n  public deselect(...fields: any[]): this {\n    if (Array.isArray(fields[0])) {\n      this.query.deselect(fields[0]);\n    } else {\n      this.query.deselect(fields);\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // ORDERING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.orderBy}\n   */\n  public orderBy(field: string, direction: \"asc\" | \"desc\" = \"asc\"): this {\n    this.query.orderBy(field, direction);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.sortBy}\n   */\n  public sortBy(orderBy: Record<string, \"asc\" | \"desc\">): this {\n    // Apply each order clause individually\n    for (const [field, direction] of Object.entries(orderBy)) {\n      this.query.orderBy(field, direction);\n    }\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.random}\n   */\n  public random(limit: number): this {\n    this.query.orderByRandom(limit);\n    return this;\n  }\n\n  // ============================================================================\n  // LIMITING\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.limit}\n   */\n  public limit(limit: number): this {\n    this.query.limit(limit);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.offset}\n   */\n  public offset(offset: number): this {\n    this.query.offset(offset);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.skip}\n   */\n  public skip(count: number): this {\n    return this.offset(count);\n  }\n\n  // ============================================================================\n  // FILTERING (Repository-specific)\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.applyFilters}\n   */\n  public applyFilters(filters: FilterRules<this>, data: any, options: FilterOptions): this {\n    const applicator = new FilterApplicator();\n    applicator.apply(this.query as any, filters, data, options);\n    return this;\n  }\n\n  // ============================================================================\n  // EXECUTION\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.get}\n   */\n  public async get(): Promise<T[]> {\n    return this.query.get();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.first}\n   */\n  public async first(): Promise<T | null> {\n    return this.query.first();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.count}\n   */\n  public async count(): Promise<number> {\n    return this.query.count();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.sum}\n   */\n  public async sum(field: string): Promise<number> {\n    return this.query.sum(field);\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.avg}\n   */\n  public async avg(field: string): Promise<number | null> {\n    return this.query.avg(field);\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.min}\n   */\n  public async min(field: string): Promise<number | null> {\n    return this.query.min(field);\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.max}\n   */\n  public async max(field: string): Promise<number | null> {\n    return this.query.max(field);\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.groupBy}\n   */\n  public async groupBy<R = Record<string, unknown>>(\n    fields: GroupByFields,\n    aggregates: AggregateExpressions,\n  ): Promise<R[]> {\n    return this.query.groupBy(fields, aggregates).get<R>();\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.aggregate}\n   *\n   * Whole-set aggregation: groups with no group key so every matching record\n   * falls into a single group, then returns that one summary row.\n   */\n  public async aggregate<R = Record<string, unknown>>(\n    aggregates: AggregateExpressions,\n  ): Promise<R | null> {\n    const rows = await this.query.groupBy([], aggregates).get<R>();\n    return rows[0] ?? null;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.paginate}\n   */\n  public async paginate(page: number, limit: number): Promise<PaginationResult<T>> {\n    const result = await this.query.paginate({ limit, page });\n\n    // Convert Cascade-Next pagination to repository format\n    return {\n      data: result.data,\n      pagination: {\n        ...result.pagination,\n        result: result.data.length,\n      },\n    };\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.cursorPaginate}\n   *\n   * NOTE: This method is a pure executor.\n   * The caller (e.g. RepositoryManager._listImpl) is responsible for applying\n   * the cursor WHERE condition and ORDER BY BEFORE calling this method,\n   * so that the cursor column is always the primary sort key.\n   *\n   * For a forward page (`direction: \"next\"`) the caller sorts ASC and filters\n   * `> cursor`, so the rows already arrive in ascending cursor order.\n   *\n   * For a backward page (`direction: \"prev\"`) the caller sorts DESC and filters\n   * `< cursor`, so rows arrive in DESCENDING order. We re-reverse the trimmed\n   * page back to ascending so callers always receive a page in the same\n   * (ascending) order regardless of direction, and we derive the next/prev\n   * cursors from the page boundaries accordingly.\n   */\n  public async cursorPaginate(\n    options: CursorPaginationOptions,\n  ): Promise<CursorPaginationResult<T>> {\n    const { limit, cursorColumn = \"id\", direction = \"next\" } = options;\n\n    // Fetch limit + 1 to detect whether more pages exist in the scan direction.\n    this.limit(limit + 1);\n\n    const results = await this.get();\n    const hasMore = results.length > limit;\n\n    // Drop the extra record used for the hasMore check. It always sits at the\n    // tail because the caller ordered the scan so the next-to-fetch row is last.\n    const trimmed = hasMore ? results.slice(0, limit) : results;\n\n    const cursorOf = (record: T | undefined): string | number | undefined =>\n      record === undefined ? undefined : ((record as any)[cursorColumn] as string | number);\n\n    if (direction === \"prev\") {\n      // Scan came back DESC; present it ascending.\n      const documents = [...trimmed].reverse();\n      const first = documents[0];\n      const last = documents[documents.length - 1];\n\n      return {\n        data: documents,\n        pagination: {\n          limit,\n          result: documents.length,\n          hasMore,\n          // Going further back is only possible when the backward scan saw more\n          // rows than this page; the boundary is this page's first (smallest) row.\n          prevCursor: hasMore ? cursorOf(first) : undefined,\n          // Going forward always resumes after this page's last (largest) row.\n          nextCursor: cursorOf(last),\n        },\n      };\n    }\n\n    // Forward page — rows already ascending.\n    const documents = trimmed;\n    const first = documents[0];\n    const last = documents[documents.length - 1];\n\n    return {\n      data: documents,\n      pagination: {\n        limit,\n        result: documents.length,\n        hasMore,\n        // Going forward is only possible when the forward scan saw more rows\n        // than this page; the boundary is this page's last (largest) row.\n        nextCursor: hasMore ? cursorOf(last) : undefined,\n        // Going back resumes before this page's first (smallest) row.\n        prevCursor: cursorOf(first),\n      },\n    };\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.chunk}\n   */\n  public async chunk(size: number, callback: ChunkCallback<T>): Promise<void> {\n    return this.query.chunk(size, callback);\n  }\n\n  // ============================================================================\n  // UTILITIES\n  // ============================================================================\n\n  /**\n   * {@inheritDoc QueryBuilderContract.with}\n   */\n  public with(relation: string): this {\n    this.query.with(relation);\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.joinWith}\n   */\n  public joinWith(...relations: string[]): this {\n    if (this.query.joinWith) {\n      this.query.joinWith(...relations);\n    } else {\n      console.warn(\n        \"[Repository] joinWith is not supported by the underlying query builder. Falling back to with.\",\n      );\n      for (const relation of relations) {\n        this.query.with(relation);\n      }\n    }\n    return this;\n  }\n\n  /**\n   * {@inheritDoc QueryBuilderContract.clone}\n   */\n  public clone(): this {\n    return new CascadeQueryBuilder(this.query.clone()) as this;\n  }\n}\n"],"mappings":"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"}

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

@@ -2,7 +2,7 @@ import { BadRequestError } from "../../../http/errors/errors.mjs";
 import dayjs from "dayjs";
 import customParseFormat from "dayjs/plugin/customParseFormat.js";
 
-//#region ../core/src/repositories/adapters/cascade/filter-applicator.ts
+//#region ../../packages/core/src/repositories/adapters/cascade/filter-applicator.ts
 dayjs.extend(customParseFormat);
 /**
 * Applies repository filters to a Cascade-Next query builder