@warlock.js/core 5.30.0 → 5.32.0

package/esm/validation/validateAll.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"validateAll.mjs","names":["candidate"],"sources":["../../../../../../../../packages/core/src/validation/validateAll.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { merge } from \"@mongez/reinforcements\";\nimport { log } from \"@warlock.js/logger\";\nimport { v, type ObjectValidator } from \"@warlock.js/seal\";\nimport type { Request } from \"../http\";\nimport { Response } from \"../http/response\";\nimport type { RequestHandlerValidation, Route } from \"../router\";\n\nfunction resolveDataToParse(\n  validating: RequestHandlerValidation[\"validating\"],\n  schema: RequestHandlerValidation[\"schema\"],\n  request: Request,\n) {\n  if (!validating || validating.length === 0) {\n    const data = request.allExceptParams();\n\n    // Duck-typed rather than `instanceof ObjectValidator`: the app's schema can\n    // come from a different copy of seal than core's, and `instanceof` would\n    // then silently fall back to ignoring params.\n    const shape = (schema as { schema?: unknown } | undefined)?.schema;\n\n    if (!shape || typeof shape !== \"object\") return data;\n\n    for (const [key, value] of Object.entries(request.params)) {\n      if (data[key] === undefined && Object.hasOwn(shape, key)) {\n        data[key] = value;\n      }\n    }\n\n    return data;\n  }\n\n  let data: any = {};\n\n  for (const validatingType of validating) {\n    if (validatingType === \"body\") {\n      data = merge(data, request.body);\n    }\n\n    if (validatingType === \"query\") {\n      data = merge(data, request.query);\n    }\n\n    if (validatingType === \"params\") {\n      data = merge(data, request.params);\n    }\n\n    if (validatingType === \"headers\") {\n      data = merge(data, request.headers);\n    }\n  }\n\n  return data;\n}\n\n/**\n * Route segments arrive from Fastify as strings. A params schema is an\n * explicit request to parse those segments, so enable Seal's built-in\n * coercion for validators that support it (numbers and booleans) without\n * mutating the application-owned schema.\n *\n * This is deliberately duck-typed: a route may carry a Seal schema from a\n * linked application copy rather than core's installed copy.\n */\nconst coercingParamsSchemas = new WeakMap<ObjectValidator, ObjectValidator>();\n\nfunction coercingParamsSchema(schema: ObjectValidator): ObjectValidator {\n  const cached = coercingParamsSchemas.get(schema);\n\n  if (cached) return cached;\n\n  const coercing = buildCoercingParamsSchema(schema);\n\n  coercingParamsSchemas.set(schema, coercing);\n\n  return coercing;\n}\n\nfunction buildCoercingParamsSchema(schema: ObjectValidator): ObjectValidator {\n  const candidate = schema as ObjectValidator & {\n    clone?: () => ObjectValidator;\n    schema?: Record<string, { coerce?: () => unknown }>;\n  };\n  const cloned = candidate.clone?.() ?? schema;\n  const shape = (cloned as typeof candidate).schema;\n\n  if (!shape) return cloned;\n\n  for (const [key, validator] of Object.entries(shape)) {\n    if (typeof validator.coerce === \"function\") {\n      shape[key] = validator.coerce() as typeof validator;\n    }\n  }\n\n  return cloned;\n}\n\n/**\n * Validate the request route\n */\nexport async function validateAll(\n  validation: Route[\"handler\"][\"validation\"],\n  request: Request,\n  response: Response,\n) {\n  if (!validation) return;\n\n  log.info(\"validation\", \"started\", \"Start validating the request\");\n\n  let validatedData: Record<string, unknown> | undefined;\n\n  if (validation.schema) {\n    log.info(\"validation\", \"schema\", \"Validating request schema\");\n    try {\n      const data = resolveDataToParse(validation.validating, validation.schema, request);\n      const result = await v.validate(validation.schema, data);\n\n      if (!result.isValid) {\n        log.warn(\"validation\", \"schema\", \"Schema Validation failed\");\n        return response.failedSchema(result);\n      }\n\n      if (result.data) {\n        validatedData = result.data;\n      }\n\n      log.success(\"validation\", \"schema\", \"Schema Validation passed\");\n    } catch (error) {\n      log.warn(\"app.validation\", \"error\", error);\n      throw error;\n    }\n  }\n\n  if (validation.params) {\n    log.info(\"validation\", \"params\", \"Validating route params schema\");\n    try {\n      const result = await v.validate(coercingParamsSchema(validation.params), request.params);\n\n      if (!result.isValid) {\n        log.warn(\"validation\", \"params\", \"Route params schema validation failed\");\n        return response.failedSchema(result);\n      }\n\n      if (result.data) {\n        for (const [key, value] of Object.entries(result.data)) {\n          request.setParam(key, value);\n        }\n\n        validatedData = { ...validatedData, ...result.data };\n      }\n\n      log.success(\"validation\", \"params\", \"Route params schema validation passed\");\n    } catch (error) {\n      log.warn(\"app.validation\", \"error\", error);\n      throw error;\n    }\n  }\n\n  if (validatedData) {\n    request.setValidatedData(validatedData);\n  }\n\n  if (validation.validate) {\n    const result = await validation.validate({ request, response });\n\n    // if there is a result, it means it failed\n    if (result) {\n      log.info(\"validation\", \"failed\", \"Validation failed\");\n\n      // a returned Response already carries its own status; anything else is\n      // sent with the configured failure status (400 by default)\n      if (result instanceof Response) return result;\n\n      return response.send(result, config.get(\"validation.responseStatus\", 400));\n    }\n\n    log.info(\"validation\", \"passed\", \"Validation passed\");\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"validateAll.mjs","names":["candidate","config"],"sources":["../../../../../../../../packages/core/src/validation/validateAll.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { merge } from \"@mongez/reinforcements\";\nimport { log } from \"@warlock.js/logger\";\nimport { v, type ObjectValidator, type ValidationResult } from \"@warlock.js/seal\";\nimport type { Request } from \"../http\";\nimport { Response } from \"../http/response\";\nimport type { RequestHandlerValidation, Route } from \"../router\";\nimport { validationFailureStatus } from \"./validation-failure-status\";\n\nfunction resolveDataToParse(\n  validating: RequestHandlerValidation[\"validating\"],\n  schema: RequestHandlerValidation[\"schema\"],\n  request: Request,\n) {\n  if (!validating || validating.length === 0) {\n    const data = request.allExceptParams();\n\n    // Duck-typed rather than `instanceof ObjectValidator`: the app's schema can\n    // come from a different copy of seal than core's, and `instanceof` would\n    // then silently fall back to ignoring params.\n    const shape = (schema as { schema?: unknown } | undefined)?.schema;\n\n    if (!shape || typeof shape !== \"object\") return data;\n\n    for (const [key, value] of Object.entries(request.params)) {\n      if (data[key] === undefined && Object.hasOwn(shape, key)) {\n        data[key] = value;\n      }\n    }\n\n    return data;\n  }\n\n  let data: any = {};\n\n  for (const validatingType of validating) {\n    if (validatingType === \"body\") {\n      data = merge(data, request.body);\n    }\n\n    if (validatingType === \"query\") {\n      data = merge(data, request.query);\n    }\n\n    if (validatingType === \"params\") {\n      data = merge(data, request.params);\n    }\n\n    if (validatingType === \"headers\") {\n      data = merge(data, request.headers);\n    }\n  }\n\n  return data;\n}\n\n/**\n * Route segments arrive from Fastify as strings. A params schema is an\n * explicit request to parse those segments, so enable Seal's built-in\n * coercion for validators that support it (numbers and booleans) without\n * mutating the application-owned schema.\n *\n * This is deliberately duck-typed: a route may carry a Seal schema from a\n * linked application copy rather than core's installed copy.\n */\nconst coercingParamsSchemas = new WeakMap<ObjectValidator, ObjectValidator>();\n\nfunction coercingParamsSchema(schema: ObjectValidator): ObjectValidator {\n  const cached = coercingParamsSchemas.get(schema);\n\n  if (cached) return cached;\n\n  const coercing = buildCoercingParamsSchema(schema);\n\n  coercingParamsSchemas.set(schema, coercing);\n\n  return coercing;\n}\n\nfunction buildCoercingParamsSchema(schema: ObjectValidator): ObjectValidator {\n  const candidate = schema as ObjectValidator & {\n    clone?: () => ObjectValidator;\n    schema?: Record<string, { coerce?: () => unknown }>;\n  };\n  const cloned = candidate.clone?.() ?? schema;\n  const shape = (cloned as typeof candidate).schema;\n\n  if (!shape) return cloned;\n\n  for (const [key, validator] of Object.entries(shape)) {\n    if (typeof validator.coerce === \"function\") {\n      shape[key] = validator.coerce() as typeof validator;\n    }\n  }\n\n  return cloned;\n}\n\n/**\n * Answer a failed `schema` or `params` validation: the route's own\n * `onFailure` hook first, then `response.failedSchema(result)`, which applies\n * the global `validation.response.body` hook or the framework body.\n */\nasync function sendValidationFailure(\n  validation: RequestHandlerValidation,\n  result: ValidationResult,\n  request: Request,\n  response: Response,\n) {\n  if (validation.onFailure) {\n    const custom = await validation.onFailure(result, { request, response, route: request.route });\n\n    if (custom) {\n      return response.send(custom.body, custom.status ?? validationFailureStatus());\n    }\n  }\n\n  return response.failedSchema(result);\n}\n\n/**\n * Validate the request route\n */\nexport async function validateAll(\n  validation: Route[\"handler\"][\"validation\"],\n  request: Request,\n  response: Response,\n) {\n  if (!validation) return;\n\n  log.info(\"validation\", \"started\", \"Start validating the request\");\n\n  let validatedData: Record<string, unknown> | undefined;\n\n  if (validation.schema) {\n    log.info(\"validation\", \"schema\", \"Validating request schema\");\n    try {\n      const data = resolveDataToParse(validation.validating, validation.schema, request);\n      const result = await v.validate(validation.schema, data);\n\n      if (!result.isValid) {\n        log.warn(\"validation\", \"schema\", \"Schema Validation failed\");\n        return sendValidationFailure(validation, result, request, response);\n      }\n\n      if (result.data) {\n        validatedData = result.data;\n      }\n\n      log.success(\"validation\", \"schema\", \"Schema Validation passed\");\n    } catch (error) {\n      log.warn(\"app.validation\", \"error\", error);\n      throw error;\n    }\n  }\n\n  if (validation.params) {\n    log.info(\"validation\", \"params\", \"Validating route params schema\");\n    try {\n      const result = await v.validate(coercingParamsSchema(validation.params), request.params);\n\n      if (!result.isValid) {\n        log.warn(\"validation\", \"params\", \"Route params schema validation failed\");\n        return sendValidationFailure(validation, result, request, response);\n      }\n\n      if (result.data) {\n        for (const [key, value] of Object.entries(result.data)) {\n          request.setParam(key, value);\n        }\n\n        validatedData = { ...validatedData, ...result.data };\n      }\n\n      log.success(\"validation\", \"params\", \"Route params schema validation passed\");\n    } catch (error) {\n      log.warn(\"app.validation\", \"error\", error);\n      throw error;\n    }\n  }\n\n  if (validatedData) {\n    request.setValidatedData(validatedData);\n  }\n\n  if (validation.validate) {\n    const result = await validation.validate({ request, response });\n\n    // if there is a result, it means it failed\n    if (result) {\n      log.info(\"validation\", \"failed\", \"Validation failed\");\n\n      // a returned Response already carries its own status; anything else is\n      // sent with the configured failure status (400 by default)\n      if (result instanceof Response) return result;\n\n      return response.send(result, config.get(\"validation.responseStatus\", 400));\n    }\n\n    log.info(\"validation\", \"passed\", \"Validation passed\");\n  }\n}\n"],"mappings":"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"}

package/esm/validation/validation-failure-status.mjs

@@ -0,0 +1,15 @@
+import baseConfig from "@mongez/config";
+
+//#region ../../packages/core/src/validation/validation-failure-status.ts
+/**
+* The status of a failed schema validation: `validation.response.status`, or
+* 422 when it is not configured.
+*/
+function validationFailureStatus() {
+	const status = baseConfig.get("validation.response.status");
+	return typeof status === "number" && Number.isInteger(status) ? status : 422;
+}
+
+//#endregion
+export { validationFailureStatus };
+//# sourceMappingURL=validation-failure-status.mjs.map

package/esm/validation/validation-failure-status.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-failure-status.mjs","names":["config"],"sources":["../../../../../../../../packages/core/src/validation/validation-failure-status.ts"],"sourcesContent":["import config from \"@mongez/config\";\n\n/**\n * The status of a failed schema validation: `validation.response.status`, or\n * 422 when it is not configured.\n */\nexport function validationFailureStatus(): number {\n  const status: unknown = config.get(\"validation.response.status\");\n\n  return typeof status === \"number\" && Number.isInteger(status) ? status : 422;\n}\n"],"mappings":";;;;;;;AAMA,SAAgB,0BAAkC;CAChD,MAAM,SAAkBA,WAAO,IAAI,4BAA4B;CAE/D,OAAO,OAAO,WAAW,YAAY,OAAO,UAAU,MAAM,IAAI,SAAS;AAC3E"}

package/esm/validation/validators/file-validator.d.mts

@@ -1,7 +1,6 @@
 import { BaseValidator, FileSizeOption, JsonSchemaResult, JsonSchemaTarget, StandardSchemaV1 } from "@warlock.js/seal";
-
 //#region ../../packages/core/src/validation/validators/file-validator.d.ts
-declare const uploadedFileMetadataSchema: import("@warlock.js/seal").ObjectValidator<{
+export declare const uploadedFileMetadataSchema: import("@warlock.js/seal").ObjectValidator<{
   location: import("@warlock.js/seal").StringValidator & StandardSchemaV1<string, string>;
   width: import("@warlock.js/seal").IntValidator & StandardSchemaV1<number, number>;
   height: import("@warlock.js/seal").IntValidator & StandardSchemaV1<number, number>;
@@ -9,27 +8,11 @@ declare const uploadedFileMetadataSchema: import("@warlock.js/seal").ObjectValid
   mimeType: import("@warlock.js/seal").StringValidator & StandardSchemaV1<string, string>;
   extension: import("@warlock.js/seal").StringValidator & StandardSchemaV1<string, string>;
   name: import("@warlock.js/seal").StringValidator & StandardSchemaV1<string, string>;
-}> & StandardSchemaV1<{
-  location: string;
-  width: number;
-  height: number;
-  size: number;
-  mimeType: string;
-  extension: string;
-  name: string;
-}, {
-  location: string;
-  width: number;
-  height: number;
-  size: number;
-  mimeType: string;
-  extension: string;
-  name: string;
 }>;
 /**
  * File validator class
  */
-declare class FileValidator extends BaseValidator {
+export declare class FileValidator extends BaseValidator {
   constructor(errorMessage?: string);
   /**
    * Check if value is a File type
@@ -88,5 +71,4 @@ declare class FileValidator extends BaseValidator {
   toJsonSchema(target?: JsonSchemaTarget): JsonSchemaResult;
 }
 //#endregion
-export { FileValidator, uploadedFileMetadataSchema };
 //# sourceMappingURL=file-validator.d.mts.map

package/esm/validation/validators/file-validator.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"file-validator.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/validators/file-validator.ts"],"mappings":";;;cAoBa,0BAAA,6BAA0B,eAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAa1B,aAAA,SAAsB,aAAA;cACd,YAAA;;;;EAQZ,WAAA,CAAY,KAAA;;EAKZ,KAAA,CAAM,YAAA;;EAKN,MAAA,CAAO,UAAA,qBAA+B,YAAA;;EAOtC,QAAA,CAAS,SAAA,qBAA8B,YAAA;;EAOvC,GAAA,CAAI,YAAA;;EAKJ,KAAA,CAAM,YAAA;;EAWN,IAAA,CAAK,YAAA;;EAWL,OAAA,CAAQ,IAAA,WAAe,cAAA,EAAgB,YAAA;;EAOvC,GAAA,CAAI,IAAA,WAAe,cAAA,EAAgB,YAAA;;EAKnC,OAAA,CAAQ,IAAA,WAAe,cAAA,EAAgB,YAAA;;EAOvC,GAAA,CAAI,IAAA,UAAc,YAAA;EA/EA;EAoFlB,QAAA,CAAS,KAAA,UAAe,YAAA;EAxBD;EA+BvB,QAAA,CAAS,KAAA,UAAe,YAAA;EAnBD;EA0BvB,SAAA,CAAU,MAAA,UAAgB,YAAA;EAmByB;EAZnD,SAAA,CAAU,MAAA,UAAgB,YAAA;EAmCyC;;;;;;EAvBnE,MAAA,CAAO,iBAAA,WAA4B,aAAA,GAAgB,gBAAA;EA5GnD;;;;;;;;;;;;;;;EAmIS,YAAA,CAAa,MAAA,GAAQ,gBAAA,GAAqC,gBAAA;AAAA"}
+{"version":3,"file":"file-validator.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/validation/validators/file-validator.ts"],"mappings":";;qBAoBa,uDAA0B;;;;;;;;;;;;qBAa1B,sBAAsB;EACjC,YAAmB;;;;EAQZ,YAAY;;EAKZ,MAAM;;EAKN,OAAO,+BAA+B;;EAOtC,SAAS,8BAA8B;;EAOvC,IAAI;;EAKJ,MAAM;;EAWN,KAAK;;EAWL,QAAQ,eAAe,gBAAgB;;EAOvC,IAAI,eAAe,gBAAgB;;EAKnC,QAAQ,eAAe,gBAAgB;;EAOvC,IAAI,cAAc;;EAKlB,SAAS,eAAe;;EAOxB,SAAS,eAAe;;EAOxB,UAAU,gBAAgB;;EAO1B,UAAU,gBAAgB;;;;;;;EAY1B,OAAO,4BAA4B,gBAAgB;;;;;;;;;;;;;;;;EAuB1C,aAAa,SAAQ,mBAAqC"}

package/esm/validation/validators/index.d.mts

@@ -1 +1,2 @@
-import { FileValidator, uploadedFileMetadataSchema } from "./file-validator.mjs";
+import { FileValidator, uploadedFileMetadataSchema } from "./file-validator.mjs";
+export { FileValidator, uploadedFileMetadataSchema };

package/esm/validation/validators/index.mjs

@@ -1,3 +1,3 @@
 import { FileValidator, uploadedFileMetadataSchema } from "./file-validator.mjs";
 
-export {  };
+export { FileValidator, uploadedFileMetadataSchema };

package/esm/vite/lower-stage3-decorators.d.mts

@@ -6,7 +6,7 @@
  * just for one type — the shape is assignable to Vite's `PluginOption` wherever
  * it's placed in a config's `plugins` array.
  */
-interface DecoratorLoweringPlugin {
+export interface DecoratorLoweringPlugin {
   name: string;
   enforce: "pre";
   transform(code: string, id: string): Promise<{
@@ -47,7 +47,6 @@ interface DecoratorLoweringPlugin {
  * });
  * ```
  */
-declare function lowerStage3Decorators(): DecoratorLoweringPlugin;
+export declare function lowerStage3Decorators(): DecoratorLoweringPlugin;
 //#endregion
-export { DecoratorLoweringPlugin, lowerStage3Decorators };
 //# sourceMappingURL=lower-stage3-decorators.d.mts.map

package/esm/vite/lower-stage3-decorators.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"lower-stage3-decorators.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/vite/lower-stage3-decorators.ts"],"mappings":";;AASA;;;;;;UAAiB,uBAAA;EACf,IAAA;EACA,OAAA;EACA,SAAA,CAAU,IAAA,UAAc,EAAA,WAAa,OAAO;IAAG,IAAA;IAAc,GAAA;EAAA;AAAA;AAoC/D;;;;AAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAhE,iBAAgB,qBAAA,IAAyB,uBAAuB"}
+{"version":3,"file":"lower-stage3-decorators.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/vite/lower-stage3-decorators.ts"],"mappings":";;;;;;;;iBASiB;EACf;EACA;EACA,UAAU,cAAc,aAAa;IAAU;IAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAoC/C,yBAAyB"}

package/esm/warlock-config/bundle-config.mjs

@@ -1,7 +1,7 @@
 import path from "node:path";
+import { pathToFileURL } from "node:url";
 import { readFile } from "node:fs/promises";
 import { getTsconfig } from "get-tsconfig";
-import { pathToFileURL } from "node:url";
 
 //#region ../../packages/core/src/warlock-config/bundle-config.ts
 /**

package/esm/warlock-config/define-config.d.mts

@@ -1,7 +1,5 @@
 import { WarlockConfig } from "./types.mjs";
-
 //#region ../../packages/core/src/warlock-config/define-config.d.ts
-declare function defineConfig(options: WarlockConfig): WarlockConfig;
+export declare function defineConfig(options: WarlockConfig): WarlockConfig;
 //#endregion
-export { defineConfig };
 //# sourceMappingURL=define-config.d.mts.map

package/esm/warlock-config/define-config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"define-config.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/define-config.ts"],"mappings":";;;iBAKgB,YAAA,CAAa,OAAA,EAAS,aAAA,GAQsB,aAAa"}
+{"version":3,"file":"define-config.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/define-config.ts"],"mappings":";;wBAKgB,aAAa,SAAS,gBAQsB"}

package/esm/warlock-config/define-config.mjs

@@ -4,10 +4,11 @@ import { merge } from "@mongez/reinforcements";
 
 //#region ../../packages/core/src/warlock-config/define-config.ts
 function defineConfig(options) {
-	return merge(defaultWarlockConfigurations, options.build ? {
+	const normalized = options.build ? {
 		...options,
 		build: normalizeBuildConfig(options.build)
-	} : options);
+	} : options;
+	return merge(defaultWarlockConfigurations, normalized);
 }
 
 //#endregion

package/esm/warlock-config/define-config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"define-config.mjs","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/define-config.ts"],"sourcesContent":["import { merge } from \"@mongez/reinforcements\";\nimport { defaultWarlockConfigurations } from \"./default-configurations\";\nimport { normalizeBuildConfig } from \"./normalize-build-config\";\nimport type { WarlockConfig } from \"./types\";\n\nexport function defineConfig(options: WarlockConfig) {\n  // Fold `build.outDirectory` into `build.outdir` BEFORE merging. Afterwards\n  // is too late: the defaults supply an `outdir`, so the alias could never\n  // tell \"the user set outdir\" from \"the default did\" and would be dropped.\n  const normalized: WarlockConfig = options.build\n    ? { ...options, build: normalizeBuildConfig(options.build) }\n    : options;\n\n  return merge(defaultWarlockConfigurations, normalized) as WarlockConfig;\n}\n"],"mappings":";;;;;AAKA,SAAgB,aAAa,SAAwB;CAQnD,OAAO,MAAM,8BAJqB,QAAQ,QACtC;EAAE,GAAG;EAAS,OAAO,qBAAqB,QAAQ,KAAK;CAAE,IACzD,OAEiD;AACvD"}
+{"version":3,"file":"define-config.mjs","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/define-config.ts"],"sourcesContent":["import { merge } from \"@mongez/reinforcements\";\nimport { defaultWarlockConfigurations } from \"./default-configurations\";\nimport { normalizeBuildConfig } from \"./normalize-build-config\";\nimport type { WarlockConfig } from \"./types\";\n\nexport function defineConfig(options: WarlockConfig) {\n  // Fold `build.outDirectory` into `build.outdir` BEFORE merging. Afterwards\n  // is too late: the defaults supply an `outdir`, so the alias could never\n  // tell \"the user set outdir\" from \"the default did\" and would be dropped.\n  const normalized: WarlockConfig = options.build\n    ? { ...options, build: normalizeBuildConfig(options.build) }\n    : options;\n\n  return merge(defaultWarlockConfigurations, normalized) as WarlockConfig;\n}\n"],"mappings":";;;;;AAKA,SAAgB,aAAa,SAAwB;CAInD,MAAM,aAA4B,QAAQ,QACtC;EAAE,GAAG;EAAS,OAAO,qBAAqB,QAAQ,KAAK;CAAE,IACzD;CAEJ,OAAO,MAAM,8BAA8B,UAAU;AACvD"}

package/esm/warlock-config/index.d.mts

@@ -1,3 +1,4 @@
 import { WarlockConfig } from "./types.mjs";
 import { defineConfig } from "./define-config.mjs";
-import { WarlockConfigManager, isUnknownTsExtensionError, isUnresolvedConfigImportError, isUnsupportedTypeStrippingError, warlockConfigManager } from "./warlock-config.manager.mjs";
+import { WarlockConfigManager, isUnknownTsExtensionError, isUnresolvedConfigImportError, isUnsupportedTypeStrippingError, warlockConfigManager } from "./warlock-config.manager.mjs";
+export { WarlockConfig, WarlockConfigManager, defineConfig, isUnknownTsExtensionError, isUnresolvedConfigImportError, isUnsupportedTypeStrippingError, warlockConfigManager };

package/esm/warlock-config/index.mjs

@@ -1,4 +1,4 @@
 import { WarlockConfigManager, isUnknownTsExtensionError, isUnresolvedConfigImportError, isUnsupportedTypeStrippingError, warlockConfigManager } from "./warlock-config.manager.mjs";
 import { defineConfig } from "./define-config.mjs";
 
-export {  };
+export { WarlockConfigManager, defineConfig, isUnknownTsExtensionError, isUnresolvedConfigImportError, isUnsupportedTypeStrippingError, warlockConfigManager };

package/esm/warlock-config/types.d.mts

@@ -1,16 +1,15 @@
-import { FileHealthCheckerContract } from "../dev-server/health-checker/file-health-checker.contract.mjs";
+import { BuiltInHealthCheckerOptions, FileHealthCheckerContract } from "../dev-server/health-checker/file-health-checker.contract.mjs";
 import { Connector } from "../connectors/types.mjs";
 import { CLICommand } from "../commands/cli-command.mjs";
 import { MigrationConstructor } from "@warlock.js/cascade";
 import { BuildOptions } from "esbuild";
-
 //#region ../../packages/core/src/warlock-config/types.d.ts
 /**
  * Resolved Warlock Configuration
  *
  * This is the final configuration after merging user config with defaults
  */
-type WarlockConfig = {
+export type WarlockConfig = {
   /**
    * Server configuration
    */
@@ -169,9 +168,10 @@ type WarlockConfig = {
       exclude?: string[];
     };
     /**
-     * Custom health checkers
+     * Built-in checker switches, custom checker array, or false to disable.
+     * Installed/configured ESLint and Oxlint both run by default.
      */
-    healthCheckers?: FileHealthCheckerContract[] | false;
+    healthCheckers?: FileHealthCheckerContract[] | BuiltInHealthCheckerOptions | false;
     /**
      * Whether to generate typings on dev server start
      * @default true
@@ -217,6 +217,32 @@ type WarlockConfig = {
      * @default false
      */
     timings?: boolean;
+    /**
+     * Keep the generated section of the project's `AGENTS.md` fresh: written
+     * on boot and again (debounced) after reloads, between the
+     * `<!-- warlock:generated:start -->` / `end` markers. Content outside the
+     * markers is never touched; the file is created when missing. Set to
+     * `false` to leave `AGENTS.md` alone (`warlock agents-md --write` still
+     * works).
+     * @default true
+     */
+    agentsMd?: boolean;
+    /**
+     * Serve `warlock mcp` from inside the dev server, over Streamable HTTP on
+     * loopback, so its `inspect_*` tools read the live registries. Same as
+     * `warlock dev --mcp`. `true` uses the defaults; an object sets them. The
+     * endpoint is printed and recorded in `.warlock/dev-server.json`. Needs
+     * `@warlock.js/ai-tools`.
+     * @default false
+     */
+    mcp?: boolean | {
+      /** `0` picks a free port. @default 0 */
+      port?: number;
+      /** Bearer token clients must send. @default none (loopback only) */
+      token?: string;
+      /** Let generate tools write into the project. @default false */
+      allowWrites?: boolean;
+    };
   };
   /**
    * Database configuration
@@ -268,5 +294,4 @@ type WarlockConfig = {
   };
 };
 //#endregion
-export { WarlockConfig };
 //# sourceMappingURL=types.d.mts.map

package/esm/warlock-config/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/types.ts"],"mappings":";;;;;;;;;AAWA;;;KAAY,aAAA;EA8BF;;;EA1BR,MAAA;IAsOqB;;;IAlOnB,IAAA;IAJF;;;IAQE,IAAA;IAkBF;;;IAdE,cAAA;EAAA;EAqCA;;;;;;;;;;;EAvBF,KAAA,GAAQ,IAAA,CAAK,YAAA;IAsHX;;;;;IAhHA,MAAA;IA+IA;;;;;;;;;;IApIA,YAAA;IAsNO;AAAA;;;;IAhNP,OAAA;;;;;;;IAOA,0BAAA;;;;;;;;;;;;;;;;;IAiBA,YAAA;;;;;;;;;;;;;;;;IAgBA,OAAA;;;;;;IAMA,MAAA;;;;;;IAMA,SAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;EA2BF,UAAA,GAAa,SAAA;;;;EAKb,GAAA;IACE,QAAA,GAAW,UAAA;EAAA;;;;EAMb,SAAA;;;;IAIE,KAAA;;;;;;MAME,OAAA;;;;;;MAMA,OAAA;IAAA;;;;IAKF,cAAA,GAAiB,yBAAA;;;;;IAKjB,eAAA;;;;;;;;;IASA,eAAA;;;;;;;;;IASA,qBAAA;;;;;;;;;;IAUA,mBAAA;;;;;;;;;;;;IAYA,OAAA;EAAA;;;;EAMF,QAAA;;;;;;;;;;;;;;;;;;IAkBE,UAAA,GAAa,KAAA,CAAM,oBAAA;EAAA;;;;;;;EASrB,OAAA;;;;;;;;;IASE,OAAA;;;;;;;;IASA,OAAA;EAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/types.ts"],"mappings":";;;;;;;;;;;YAcY;;;;EAIV;;;;IAIE;;;;IAIA;;;;IAIA;;;;;;;;;;;;;EAcF,QAAQ,KAAK;;;;;;IAMX;;;;;;;;;;;IAWA;;;;;;IAMA;;;;;;;IAOA;;;;;;;;;;;;;;;;;IAiBA;;;;;;;;;;;;;;;;IAgBA;;;;;;IAMA;;;;;;IAMA;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BF,aAAa;;;;EAKb;IACE,WAAW;;;;;EAMb;;;;IAIE;;;;;;MAME;;;;;;MAMA;;;;;;IAMF,iBAAiB,8BAA8B;;;;;IAK/C;;;;;;;;;IASA;;;;;;;;;IASA;;;;;;;;;;IAUA;;;;;;;;;;;;IAYA;;;;;;;;;;IAUA;;;;;;;;;IASA;;MAIM;;MAEA;;MAEA;;;;;;EAOR;;;;;;;;;;;;;;;;;;IAkBE,aAAa,MAAM;;;;;;;;EASrB;;;;;;;;;IASE;;;;;;;;IASA"}

package/esm/warlock-config/warlock-config.manager.d.mts

@@ -1,5 +1,4 @@
 import { WarlockConfig } from "./types.mjs";
-
 //#region ../../packages/core/src/warlock-config/warlock-config.manager.d.ts
 /**
  * True when `error` is Node's "this runtime can't import a `.ts` file" error.
@@ -9,7 +8,7 @@ import { WarlockConfig } from "./types.mjs";
  * `import("warlock.config.ts")` throws `ERR_UNKNOWN_FILE_EXTENSION` — which is
  * the signal to fall back to transpiling the config ourselves.
  */
-declare function isUnknownTsExtensionError(error: unknown): boolean;
+export declare function isUnknownTsExtensionError(error: unknown): boolean;
 /**
  * True when `error` is Node failing to RESOLVE an import of the config's OWN
  * graph: an extensionless relative import (`./src/connectors/local`), a
@@ -24,20 +23,20 @@ declare function isUnknownTsExtensionError(error: unknown): boolean;
  * `pathAliases` are the tsconfig `paths` patterns (`app/*`). When the message
  * cannot be parsed the error is treated as a graph error, as before.
  */
-declare function isUnresolvedConfigImportError(error: unknown, pathAliases?: readonly string[]): boolean;
+export declare function isUnresolvedConfigImportError(error: unknown, pathAliases?: readonly string[]): boolean;
 /**
  * True when `error` is native type stripping refusing TypeScript it cannot
  * strip (an `enum`, a `namespace`, a parameter property) or a `.ts` file under
  * `node_modules`. Both are raised while loading, before the graph runs.
  */
-declare function isUnsupportedTypeStrippingError(error: unknown): boolean;
+export declare function isUnsupportedTypeStrippingError(error: unknown): boolean;
 /**
  * Warlock Config Manager
  *
  * Manages lazy loading of the pre-compiled warlock.config.js file
  * from the .warlock/cache directory.
  */
-declare class WarlockConfigManager {
+export declare class WarlockConfigManager {
   /**
    * Cached config instance
    */
@@ -123,7 +122,6 @@ declare class WarlockConfigManager {
  * await warlockConfig.load();
  * const commands = warlockConfig.get("cli.commands");
  */
-declare const warlockConfigManager: WarlockConfigManager;
+export declare const warlockConfigManager: WarlockConfigManager;
 //#endregion
-export { WarlockConfigManager, isUnknownTsExtensionError, isUnresolvedConfigImportError, isUnsupportedTypeStrippingError, warlockConfigManager };
 //# sourceMappingURL=warlock-config.manager.d.mts.map

package/esm/warlock-config/warlock-config.manager.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"warlock-config.manager.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/warlock-config.manager.ts"],"mappings":";;;;;AAyBA;;;;AAAwD;AAqBxD;iBArBgB,yBAAA,CAA0B,KAAc;;;AAuBnB;AA4BrC;;;;AAA8D;AA+B9D;;;;;;iBA7DgB,6BAAA,CACd,KAAA,WACA,WAAmC;;;;;;iBA4BrB,+BAAA,CAAgC,KAAc;;;;;;;cA+BjD,oBAAA;EA0LmB;;;EAAA,QAtLtB,MAAA;EAYK;;;EAAA,QAPL,OAAA;EA6FM;;;;;EAtFD,IAAA,IAAQ,OAAA,CAAQ,aAAA;EAwHZ;;;;;;EAAA,QA1FH,MAAA;EA6GkB;;;;;;;;;;;;EAAA,QArDlB,cAAA;EAoFS;;AAAO;AAwDhC;;;;AAA8D;;;;EA5GrD,GAAA,mBAAsB,aAAA,EAC3B,GAAA,EAAK,GAAA,EACL,YAAA,GAAe,aAAA,CAAc,GAAA,IAC5B,aAAA,CAAc,GAAA;;;;;;;;;;;EAkBX,OAAA,mBAA0B,aAAA,EAC9B,GAAA,EAAK,GAAA,EACL,YAAA,GAAe,aAAA,CAAc,GAAA,IAC5B,OAAA,CAAQ,aAAA,CAAc,GAAA;;;;MAQd,QAAA;;;;;;EASJ,MAAA,IAAU,aAAA;;;;EAWJ,MAAA,IAAU,OAAA;AAAA;;;;;;;;;;;;;;cAwDZ,oBAAA,EAAoB,oBAA6B"}
+{"version":3,"file":"warlock-config.manager.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/warlock-config.manager.ts"],"mappings":";;;;;;;;;;wBAyBgB,0BAA0B;;;;;;;;;;;;;;;wBAqB1B,8BACd,gBACA;;;;;;wBA4Bc,gCAAgC;;;;;;;qBA+BnC;;;;UAIH;;;;UAKA;;;;;;EAOK,QAAQ,QAAQ;;;;;;;UA8Bf;;;;;;;;;;;;;UAwDA;;;;;;;;;;;;EAgCP,IAAI,kBAAkB,eAC3B,KAAK,KACL,eAAe,cAAc,OAC5B,cAAc;;;;;;;;;;;EAkBX,QAAQ,kBAAkB,eAC9B,KAAK,KACL,eAAe,cAAc,OAC5B,QAAQ,cAAc;;;;MAQd;;;;;;EASJ,UAAU;;;;EAWJ,UAAU;;;;;;;;;;;;;;;qBAwDZ,sBAAoB"}

package/esm/warlock-config/warlock-config.manager.mjs

@@ -207,7 +207,8 @@ function configPathAliases(configPath) {
 function nameOriginalConfig(error, compiledPath, configPath) {
 	const code = error?.code;
 	if (typeof code !== "string" || !code.startsWith("ERR_")) return error;
-	const wrapped = new ErrorWithCause(`Failed to load warlock.config.ts: ${String(error.message ?? error).split(pathToFileURL(compiledPath).href).join(pathToFileURL(configPath).href).split(compiledPath).join(configPath)}`, { cause: error });
+	const message = String(error.message ?? error).split(pathToFileURL(compiledPath).href).join(pathToFileURL(configPath).href).split(compiledPath).join(configPath);
+	const wrapped = new ErrorWithCause(`Failed to load warlock.config.ts: ${message}`, { cause: error });
 	wrapped.code = code;
 	return wrapped;
 }

package/esm/warlock-config/warlock-config.manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"warlock-config.manager.mjs","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/warlock-config.manager.ts"],"sourcesContent":["import { fileExistsAsync } from \"@warlock.js/fs\";\nimport { get } from \"@mongez/reinforcements\";\nimport { getTsconfig } from \"get-tsconfig\";\nimport { unlink, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"url\";\nimport { rootPath } from \"../utils\";\nimport { bundleWarlockConfig } from \"./bundle-config\";\nimport { type WarlockConfig } from \"./types\";\nimport { getDeprecatedConfigWarnings } from \"./warn-deprecated-config\";\n\n/**\n * `Error` with the ES2022 `cause` option, typed for packages still compiled\n * against an older lib (see `application.ts`).\n */\nconst ErrorWithCause = Error as new (message: string, options: { cause: unknown }) => Error;\n\n/**\n * True when `error` is Node's \"this runtime can't import a `.ts` file\" error.\n *\n * Node only executes TypeScript natively from v22.18 / v23.6 onward (earlier\n * 22.x needs `--experimental-strip-types`). On older runtimes a bare\n * `import(\"warlock.config.ts\")` throws `ERR_UNKNOWN_FILE_EXTENSION` — which is\n * the signal to fall back to transpiling the config ourselves.\n */\nexport function isUnknownTsExtensionError(error: unknown): boolean {\n  return (\n    (error as { code?: string })?.code === \"ERR_UNKNOWN_FILE_EXTENSION\" ||\n    /Unknown file extension \"\\.tsx?\"/.test(String((error as Error)?.message))\n  );\n}\n\n/**\n * True when `error` is Node failing to RESOLVE an import of the config's OWN\n * graph: an extensionless relative import (`./src/connectors/local`), a\n * directory import, or a tsconfig `paths` alias (`app/connectors`) — all of\n * which only a TypeScript toolchain resolves. Native type stripping\n * (Node ≥ 22.18) loads `warlock.config.ts` itself, then fails here.\n *\n * A package that is genuinely not installed is NOT a fallback case: the error\n * names a bare specifier that matches no `paths` pattern, and it is rethrown\n * as is. Neither is a missing module imported from inside `node_modules`.\n *\n * `pathAliases` are the tsconfig `paths` patterns (`app/*`). When the message\n * cannot be parsed the error is treated as a graph error, as before.\n */\nexport function isUnresolvedConfigImportError(\n  error: unknown,\n  pathAliases: readonly string[] = [],\n): boolean {\n  const code = (error as { code?: string })?.code;\n\n  if (code === \"ERR_UNSUPPORTED_DIR_IMPORT\") return true;\n  if (code !== \"ERR_MODULE_NOT_FOUND\") return false;\n\n  const message = String((error as Error)?.message ?? \"\");\n  const match = /Cannot find (module|package) '([^']+)' imported from (.+)$/m.exec(message);\n\n  if (!match) return true;\n\n  const [, kind, specifier = \"\", importer = \"\"] = match;\n\n  if (/[\\\\/]node_modules[\\\\/]/.test(importer)) return false;\n\n  // An unresolved relative or absolute path: an extensionless TS import.\n  if (kind === \"module\") return true;\n\n  // A bare name: only a tsconfig alias is the config graph's own code.\n  return pathAliases.some((pattern) => aliasCovers(pattern, specifier));\n}\n\n/**\n * True when `error` is native type stripping refusing TypeScript it cannot\n * strip (an `enum`, a `namespace`, a parameter property) or a `.ts` file under\n * `node_modules`. Both are raised while loading, before the graph runs.\n */\nexport function isUnsupportedTypeStrippingError(error: unknown): boolean {\n  const code = (error as { code?: string })?.code;\n\n  return (\n    code === \"ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX\" ||\n    code === \"ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING\"\n  );\n}\n\n/**\n * True when a tsconfig `paths` pattern can produce `packageName` as the first\n * segment(s) of a specifier: `app/*` covers `app`, `@shared/*` covers\n * `@shared`, a catch-all `*` covers anything.\n */\nfunction aliasCovers(pattern: string, packageName: string): boolean {\n  const star = pattern.indexOf(\"*\");\n  const prefix = star === -1 ? pattern : pattern.slice(0, star);\n\n  if (prefix === \"\") return true;\n\n  return (\n    prefix === packageName || prefix.startsWith(`${packageName}/`) || packageName.startsWith(prefix)\n  );\n}\n\n/**\n * Warlock Config Manager\n *\n * Manages lazy loading of the pre-compiled warlock.config.js file\n * from the .warlock/cache directory.\n */\nexport class WarlockConfigManager {\n  /**\n   * Cached config instance\n   */\n  private config?: WarlockConfig;\n\n  /**\n   * Loading promise to prevent duplicate loads\n   */\n  private loading?: Promise<WarlockConfig | undefined>;\n\n  /**\n   * Load warlock.config.js (cached after first load)\n   *\n   * @returns The resolved Warlock configuration\n   */\n  public async load(): Promise<WarlockConfig | undefined> {\n    // Already loaded\n    if (this.config) {\n      return this.config;\n    }\n\n    // Currently loading (prevent duplicate loads)\n    if (this.loading) {\n      return this.loading;\n    }\n\n    // Start loading\n    this.loading = this.doLoad();\n    this.config = await this.loading;\n    this.loading = undefined;\n\n    // Console, not the logger: this runs before any log channel exists.\n    for (const warning of getDeprecatedConfigWarnings(this.config)) {\n      console.warn(warning);\n    }\n\n    return this.config;\n  }\n\n  /**\n   * Internal load implementation\n   *\n   * The ESM loader hook transpiles `warlock.config.ts` on import — no\n   * separate compile-to-disk step is needed.\n   */\n  private async doLoad(): Promise<WarlockConfig | undefined> {\n    const configPath = rootPath(\"warlock.config.ts\");\n\n    if (!(await fileExistsAsync(configPath))) {\n      // Written straight to the console, NOT through `@warlock.js/logger`.\n      // This runs during CLI bootstrap, before `LoggerConnector.start()` has\n      // configured a single channel, so a logger call here reaches nobody in\n      // any application — the warning would be silently dropped exactly when\n      // the user most needs it.\n      console.warn(\n        \"warlock.config.ts is missing — create it at the project root (see https://warlock.js.org/docs for the config reference)\",\n      );\n      return;\n    }\n\n    try {\n      const configModule = await import(pathToFileURL(configPath).href);\n      return configModule.default;\n    } catch (error) {\n      // `dev` registers a TS loader hook, and Node ≥ 22.18 / 23.6 strips types\n      // natively — in both cases the direct import above works for a\n      // self-contained config. But `build` / `start` register no hook, so on an\n      // older Node the import throws ERR_UNKNOWN_FILE_EXTENSION; native\n      // stripping cannot resolve extensionless or tsconfig-aliased local\n      // imports, nor strip an `enum` or a parameter property. Bundle the\n      // config's local graph with esbuild ourselves so config loading is\n      // Node-version-independent.\n      //\n      // These errors are raised while resolving and loading the STATIC graph,\n      // before any of it runs. An unresolved import reached later — a dynamic\n      // `import()` while the config runs — is indistinguishable by code, so the\n      // fallback is limited to the config's own relative and aliased imports.\n      if (\n        isUnknownTsExtensionError(error) ||\n        isUnsupportedTypeStrippingError(error) ||\n        isUnresolvedConfigImportError(error, configPathAliases(configPath))\n      ) {\n        return await this.loadViaEsbuild(configPath);\n      }\n\n      throw new ErrorWithCause(`Failed to load warlock.config.ts: ${error}`, { cause: error });\n    }\n  }\n\n  /**\n   * Fallback config loader for runtimes that cannot import the config as written.\n   *\n   * Bundles `warlock.config.ts` with its LOCAL import graph (relative imports,\n   * extensionless TS imports, tsconfig `paths` aliases) through esbuild, keeping\n   * every package external so `BaseConnector`, the container and other\n   * registries keep the application's identity (see `bundleWarlockConfig`).\n   * The bundle is written as a sibling `.mjs` — so its external imports resolve\n   * from the project exactly as they would from the original config — imported\n   * once, then removed whether it loaded or threw. An error thrown by the\n   * user's config propagates unchanged.\n   */\n  private async loadViaEsbuild(configPath: string): Promise<WarlockConfig | undefined> {\n    const code = await bundleWarlockConfig(configPath);\n\n    // Unique sibling name so concurrent processes never clobber each other.\n    const compiledPath = configPath.replace(\n      /warlock\\.config\\.ts$/,\n      `.warlock.config.${process.pid}.${Date.now()}.mjs`,\n    );\n\n    await writeFile(compiledPath, code, \"utf8\");\n\n    try {\n      const configModule = await import(pathToFileURL(compiledPath).href);\n      return configModule.default;\n    } catch (error) {\n      throw nameOriginalConfig(error, compiledPath, configPath);\n    } finally {\n      await unlink(compiledPath).catch(() => {});\n    }\n  }\n\n  /**\n   * Get config value by key (dot notation supported)\n   *\n   * @example\n   * config.get(\"server.port\") // Returns 3000\n   * config.get(\"cli.commands\") // Returns array of commands\n   *\n   * @param key - Config key (supports dot notation), autocompletes for first level only\n   * @returns The config value\n   * @throws Error if config is not loaded\n   */\n  public get<Key extends keyof WarlockConfig>(\n    key: Key,\n    defaultValue?: WarlockConfig[Key],\n  ): WarlockConfig[Key] {\n    if (!this.config) {\n      throw new Error(\"WarlockConfig not loaded. Call load() first or use lazyGet().\");\n    }\n\n    return get(this.config, key as string, defaultValue);\n  }\n\n  /**\n   * Lazy get - loads config if not already loaded\n   *\n   * @example\n   * const port = await config.lazyGet(\"server\");\n   *\n   * @param key - Config key (supports dot notation), autocompletes for first level only\n   * @param defaultValue - Default value if config key is undefined\n   * @returns The config value\n   */\n  async lazyGet<Key extends keyof WarlockConfig>(\n    key: Key,\n    defaultValue?: WarlockConfig[Key],\n  ): Promise<WarlockConfig[Key]> {\n    await this.load();\n    return this.get(key, defaultValue);\n  }\n\n  /**\n   * Check if config is loaded\n   */\n  public get isLoaded(): boolean {\n    return this.config !== undefined;\n  }\n\n  /**\n   * Get the entire config object\n   *\n   * @throws Error if config is not loaded\n   */\n  public getAll(): WarlockConfig {\n    if (!this.config) {\n      throw new Error(\"WarlockConfig not loaded. Call load() first or use lazyGet().\");\n    }\n\n    return this.config;\n  }\n\n  /**\n   * Reload config (useful for HMR/development)\n   */\n  public async reload(): Promise<void> {\n    this.config = undefined;\n    this.loading = undefined;\n    await this.load();\n  }\n}\n\n/**\n * The tsconfig `paths` patterns of the project holding `configPath`.\n */\nfunction configPathAliases(configPath: string): string[] {\n  try {\n    return Object.keys(getTsconfig(path.dirname(configPath))?.config.compilerOptions?.paths ?? {});\n  } catch {\n    return [];\n  }\n}\n\n/**\n * A loader error raised by the bundled config names the temporary `.mjs`\n * module. Rewrite it to name `warlock.config.ts`, keeping the original as the\n * cause. An error thrown by the user's own config is returned unchanged.\n */\nfunction nameOriginalConfig(error: unknown, compiledPath: string, configPath: string): unknown {\n  const code = (error as { code?: string })?.code;\n\n  if (typeof code !== \"string\" || !code.startsWith(\"ERR_\")) return error;\n\n  const message = String((error as Error).message ?? error)\n    .split(pathToFileURL(compiledPath).href)\n    .join(pathToFileURL(configPath).href)\n    .split(compiledPath)\n    .join(configPath);\n\n  const wrapped = new ErrorWithCause(`Failed to load warlock.config.ts: ${message}`, {\n    cause: error,\n  });\n\n  (wrapped as Error & { code?: string }).code = code;\n\n  return wrapped;\n}\n\n/**\n * Exported singleton instance\n *\n * @example\n * import { warlockConfig } from \"@warlock.js/core\";\n *\n * // Lazy load and get value\n * const port = await warlockConfig.lazyGet(\"server.port\");\n *\n * // Or load first, then get\n * await warlockConfig.load();\n * const commands = warlockConfig.get(\"cli.commands\");\n */\nexport const warlockConfigManager = new WarlockConfigManager();\n"],"mappings":"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"}
+{"version":3,"file":"warlock-config.manager.mjs","names":[],"sources":["../../../../../../../../packages/core/src/warlock-config/warlock-config.manager.ts"],"sourcesContent":["import { fileExistsAsync } from \"@warlock.js/fs\";\nimport { get } from \"@mongez/reinforcements\";\nimport { getTsconfig } from \"get-tsconfig\";\nimport { unlink, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"url\";\nimport { rootPath } from \"../utils\";\nimport { bundleWarlockConfig } from \"./bundle-config\";\nimport { type WarlockConfig } from \"./types\";\nimport { getDeprecatedConfigWarnings } from \"./warn-deprecated-config\";\n\n/**\n * `Error` with the ES2022 `cause` option, typed for packages still compiled\n * against an older lib (see `application.ts`).\n */\nconst ErrorWithCause = Error as new (message: string, options: { cause: unknown }) => Error;\n\n/**\n * True when `error` is Node's \"this runtime can't import a `.ts` file\" error.\n *\n * Node only executes TypeScript natively from v22.18 / v23.6 onward (earlier\n * 22.x needs `--experimental-strip-types`). On older runtimes a bare\n * `import(\"warlock.config.ts\")` throws `ERR_UNKNOWN_FILE_EXTENSION` — which is\n * the signal to fall back to transpiling the config ourselves.\n */\nexport function isUnknownTsExtensionError(error: unknown): boolean {\n  return (\n    (error as { code?: string })?.code === \"ERR_UNKNOWN_FILE_EXTENSION\" ||\n    /Unknown file extension \"\\.tsx?\"/.test(String((error as Error)?.message))\n  );\n}\n\n/**\n * True when `error` is Node failing to RESOLVE an import of the config's OWN\n * graph: an extensionless relative import (`./src/connectors/local`), a\n * directory import, or a tsconfig `paths` alias (`app/connectors`) — all of\n * which only a TypeScript toolchain resolves. Native type stripping\n * (Node ≥ 22.18) loads `warlock.config.ts` itself, then fails here.\n *\n * A package that is genuinely not installed is NOT a fallback case: the error\n * names a bare specifier that matches no `paths` pattern, and it is rethrown\n * as is. Neither is a missing module imported from inside `node_modules`.\n *\n * `pathAliases` are the tsconfig `paths` patterns (`app/*`). When the message\n * cannot be parsed the error is treated as a graph error, as before.\n */\nexport function isUnresolvedConfigImportError(\n  error: unknown,\n  pathAliases: readonly string[] = [],\n): boolean {\n  const code = (error as { code?: string })?.code;\n\n  if (code === \"ERR_UNSUPPORTED_DIR_IMPORT\") return true;\n  if (code !== \"ERR_MODULE_NOT_FOUND\") return false;\n\n  const message = String((error as Error)?.message ?? \"\");\n  const match = /Cannot find (module|package) '([^']+)' imported from (.+)$/m.exec(message);\n\n  if (!match) return true;\n\n  const [, kind, specifier = \"\", importer = \"\"] = match;\n\n  if (/[\\\\/]node_modules[\\\\/]/.test(importer)) return false;\n\n  // An unresolved relative or absolute path: an extensionless TS import.\n  if (kind === \"module\") return true;\n\n  // A bare name: only a tsconfig alias is the config graph's own code.\n  return pathAliases.some((pattern) => aliasCovers(pattern, specifier));\n}\n\n/**\n * True when `error` is native type stripping refusing TypeScript it cannot\n * strip (an `enum`, a `namespace`, a parameter property) or a `.ts` file under\n * `node_modules`. Both are raised while loading, before the graph runs.\n */\nexport function isUnsupportedTypeStrippingError(error: unknown): boolean {\n  const code = (error as { code?: string })?.code;\n\n  return (\n    code === \"ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX\" ||\n    code === \"ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING\"\n  );\n}\n\n/**\n * True when a tsconfig `paths` pattern can produce `packageName` as the first\n * segment(s) of a specifier: `app/*` covers `app`, `@shared/*` covers\n * `@shared`, a catch-all `*` covers anything.\n */\nfunction aliasCovers(pattern: string, packageName: string): boolean {\n  const star = pattern.indexOf(\"*\");\n  const prefix = star === -1 ? pattern : pattern.slice(0, star);\n\n  if (prefix === \"\") return true;\n\n  return (\n    prefix === packageName || prefix.startsWith(`${packageName}/`) || packageName.startsWith(prefix)\n  );\n}\n\n/**\n * Warlock Config Manager\n *\n * Manages lazy loading of the pre-compiled warlock.config.js file\n * from the .warlock/cache directory.\n */\nexport class WarlockConfigManager {\n  /**\n   * Cached config instance\n   */\n  private config?: WarlockConfig;\n\n  /**\n   * Loading promise to prevent duplicate loads\n   */\n  private loading?: Promise<WarlockConfig | undefined>;\n\n  /**\n   * Load warlock.config.js (cached after first load)\n   *\n   * @returns The resolved Warlock configuration\n   */\n  public async load(): Promise<WarlockConfig | undefined> {\n    // Already loaded\n    if (this.config) {\n      return this.config;\n    }\n\n    // Currently loading (prevent duplicate loads)\n    if (this.loading) {\n      return this.loading;\n    }\n\n    // Start loading\n    this.loading = this.doLoad();\n    this.config = await this.loading;\n    this.loading = undefined;\n\n    // Console, not the logger: this runs before any log channel exists.\n    for (const warning of getDeprecatedConfigWarnings(this.config)) {\n      console.warn(warning);\n    }\n\n    return this.config;\n  }\n\n  /**\n   * Internal load implementation\n   *\n   * The ESM loader hook transpiles `warlock.config.ts` on import — no\n   * separate compile-to-disk step is needed.\n   */\n  private async doLoad(): Promise<WarlockConfig | undefined> {\n    const configPath = rootPath(\"warlock.config.ts\");\n\n    if (!(await fileExistsAsync(configPath))) {\n      // Written straight to the console, NOT through `@warlock.js/logger`.\n      // This runs during CLI bootstrap, before `LoggerConnector.start()` has\n      // configured a single channel, so a logger call here reaches nobody in\n      // any application — the warning would be silently dropped exactly when\n      // the user most needs it.\n      console.warn(\n        \"warlock.config.ts is missing — create it at the project root (see https://warlock.js.org/docs for the config reference)\",\n      );\n      return;\n    }\n\n    try {\n      const configModule = await import(pathToFileURL(configPath).href);\n      return configModule.default;\n    } catch (error) {\n      // `dev` registers a TS loader hook, and Node ≥ 22.18 / 23.6 strips types\n      // natively — in both cases the direct import above works for a\n      // self-contained config. But `build` / `start` register no hook, so on an\n      // older Node the import throws ERR_UNKNOWN_FILE_EXTENSION; native\n      // stripping cannot resolve extensionless or tsconfig-aliased local\n      // imports, nor strip an `enum` or a parameter property. Bundle the\n      // config's local graph with esbuild ourselves so config loading is\n      // Node-version-independent.\n      //\n      // These errors are raised while resolving and loading the STATIC graph,\n      // before any of it runs. An unresolved import reached later — a dynamic\n      // `import()` while the config runs — is indistinguishable by code, so the\n      // fallback is limited to the config's own relative and aliased imports.\n      if (\n        isUnknownTsExtensionError(error) ||\n        isUnsupportedTypeStrippingError(error) ||\n        isUnresolvedConfigImportError(error, configPathAliases(configPath))\n      ) {\n        return await this.loadViaEsbuild(configPath);\n      }\n\n      throw new ErrorWithCause(`Failed to load warlock.config.ts: ${error}`, { cause: error });\n    }\n  }\n\n  /**\n   * Fallback config loader for runtimes that cannot import the config as written.\n   *\n   * Bundles `warlock.config.ts` with its LOCAL import graph (relative imports,\n   * extensionless TS imports, tsconfig `paths` aliases) through esbuild, keeping\n   * every package external so `BaseConnector`, the container and other\n   * registries keep the application's identity (see `bundleWarlockConfig`).\n   * The bundle is written as a sibling `.mjs` — so its external imports resolve\n   * from the project exactly as they would from the original config — imported\n   * once, then removed whether it loaded or threw. An error thrown by the\n   * user's config propagates unchanged.\n   */\n  private async loadViaEsbuild(configPath: string): Promise<WarlockConfig | undefined> {\n    const code = await bundleWarlockConfig(configPath);\n\n    // Unique sibling name so concurrent processes never clobber each other.\n    const compiledPath = configPath.replace(\n      /warlock\\.config\\.ts$/,\n      `.warlock.config.${process.pid}.${Date.now()}.mjs`,\n    );\n\n    await writeFile(compiledPath, code, \"utf8\");\n\n    try {\n      const configModule = await import(pathToFileURL(compiledPath).href);\n      return configModule.default;\n    } catch (error) {\n      throw nameOriginalConfig(error, compiledPath, configPath);\n    } finally {\n      await unlink(compiledPath).catch(() => {});\n    }\n  }\n\n  /**\n   * Get config value by key (dot notation supported)\n   *\n   * @example\n   * config.get(\"server.port\") // Returns 3000\n   * config.get(\"cli.commands\") // Returns array of commands\n   *\n   * @param key - Config key (supports dot notation), autocompletes for first level only\n   * @returns The config value\n   * @throws Error if config is not loaded\n   */\n  public get<Key extends keyof WarlockConfig>(\n    key: Key,\n    defaultValue?: WarlockConfig[Key],\n  ): WarlockConfig[Key] {\n    if (!this.config) {\n      throw new Error(\"WarlockConfig not loaded. Call load() first or use lazyGet().\");\n    }\n\n    return get(this.config, key as string, defaultValue);\n  }\n\n  /**\n   * Lazy get - loads config if not already loaded\n   *\n   * @example\n   * const port = await config.lazyGet(\"server\");\n   *\n   * @param key - Config key (supports dot notation), autocompletes for first level only\n   * @param defaultValue - Default value if config key is undefined\n   * @returns The config value\n   */\n  async lazyGet<Key extends keyof WarlockConfig>(\n    key: Key,\n    defaultValue?: WarlockConfig[Key],\n  ): Promise<WarlockConfig[Key]> {\n    await this.load();\n    return this.get(key, defaultValue);\n  }\n\n  /**\n   * Check if config is loaded\n   */\n  public get isLoaded(): boolean {\n    return this.config !== undefined;\n  }\n\n  /**\n   * Get the entire config object\n   *\n   * @throws Error if config is not loaded\n   */\n  public getAll(): WarlockConfig {\n    if (!this.config) {\n      throw new Error(\"WarlockConfig not loaded. Call load() first or use lazyGet().\");\n    }\n\n    return this.config;\n  }\n\n  /**\n   * Reload config (useful for HMR/development)\n   */\n  public async reload(): Promise<void> {\n    this.config = undefined;\n    this.loading = undefined;\n    await this.load();\n  }\n}\n\n/**\n * The tsconfig `paths` patterns of the project holding `configPath`.\n */\nfunction configPathAliases(configPath: string): string[] {\n  try {\n    return Object.keys(getTsconfig(path.dirname(configPath))?.config.compilerOptions?.paths ?? {});\n  } catch {\n    return [];\n  }\n}\n\n/**\n * A loader error raised by the bundled config names the temporary `.mjs`\n * module. Rewrite it to name `warlock.config.ts`, keeping the original as the\n * cause. An error thrown by the user's own config is returned unchanged.\n */\nfunction nameOriginalConfig(error: unknown, compiledPath: string, configPath: string): unknown {\n  const code = (error as { code?: string })?.code;\n\n  if (typeof code !== \"string\" || !code.startsWith(\"ERR_\")) return error;\n\n  const message = String((error as Error).message ?? error)\n    .split(pathToFileURL(compiledPath).href)\n    .join(pathToFileURL(configPath).href)\n    .split(compiledPath)\n    .join(configPath);\n\n  const wrapped = new ErrorWithCause(`Failed to load warlock.config.ts: ${message}`, {\n    cause: error,\n  });\n\n  (wrapped as Error & { code?: string }).code = code;\n\n  return wrapped;\n}\n\n/**\n * Exported singleton instance\n *\n * @example\n * import { warlockConfig } from \"@warlock.js/core\";\n *\n * // Lazy load and get value\n * const port = await warlockConfig.lazyGet(\"server.port\");\n *\n * // Or load first, then get\n * await warlockConfig.load();\n * const commands = warlockConfig.get(\"cli.commands\");\n */\nexport const warlockConfigManager = new WarlockConfigManager();\n"],"mappings":"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"}

package/esm/warlock-config/warn-deprecated-config.mjs

@@ -21,5 +21,5 @@ function getDeprecatedConfigWarnings(config) {
 }
 
 //#endregion
-export { getDeprecatedConfigWarnings };
+export { deprecatedConfigKeys, getDeprecatedConfigWarnings };
 //# sourceMappingURL=warn-deprecated-config.mjs.map