@warlock.js/core 4.0.174 → 4.1.2

package/esm/validation/validateAll.mjs

@@ -0,0 +1,53 @@
+import { v } from "@warlock.js/seal";
+import config from "@mongez/config";
+import { log } from "@warlock.js/logger";
+import { merge } from "@mongez/reinforcements";
+
+//#region ../../@warlock.js/core/src/validation/validateAll.ts
+function resolveDataToParse(validating, request) {
+	if (!validating || validating.length === 0) return request.allExceptParams();
+	let data = {};
+	for (const validatingType of validating) {
+		if (validatingType === "body") data = merge(data, request.body);
+		if (validatingType === "query") data = merge(data, request.query);
+		if (validatingType === "params") data = merge(data, request.params);
+		if (validatingType === "headers") data = merge(data, request.headers);
+	}
+	return data;
+}
+/**
+* Validate the request route
+*/
+async function validateAll(validation, request, response) {
+	if (!validation) return;
+	log.info("validation", "started", "Start validating the request");
+	if (validation.schema) {
+		log.info("validation", "schema", "Validating request schema");
+		try {
+			const data = resolveDataToParse(validation.validating, request);
+			const result = await v.validate(validation.schema, data);
+			if (result.data && result.isValid) request.setValidatedData(result.data);
+			if (!result.isValid) {
+				log.warn("validation", "schema", "Schema Validation failed");
+				return response.failedSchema(result);
+			}
+			log.success("validation", "schema", "Schema Validation passed");
+		} catch (error) {
+			log.warn("app.validation", "error", error);
+			throw error;
+		}
+	}
+	if (validation.validate) {
+		const result = await validation.validate(request, response);
+		if (result) {
+			if (!response.statusCode) response.setStatusCode(config.get("validation.responseStatus", 400));
+			log.info("validation", "failed", "Validation failed");
+			return result;
+		}
+		log.info("validation", "passed", "Validation passed");
+	}
+}
+
+//#endregion
+export { validateAll };
+//# sourceMappingURL=validateAll.mjs.map

package/esm/validation/validateAll.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateAll.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/validation/validateAll.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { merge } from \"@mongez/reinforcements\";\nimport { log } from \"@warlock.js/logger\";\nimport { v } from \"@warlock.js/seal\";\nimport type { Request, Response } from \"../http\";\nimport type { RequestHandlerValidation, Route } from \"../router\";\n\nfunction resolveDataToParse(validating: RequestHandlerValidation[\"validating\"], request: Request) {\n  if (!validating || validating.length === 0) return request.allExceptParams();\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 * 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  if (validation.schema) {\n    log.info(\"validation\", \"schema\", \"Validating request schema\");\n    try {\n      const data = resolveDataToParse(validation.validating, request);\n      const result = await v.validate(validation.schema, data);\n\n      if (result.data && result.isValid) {\n        request.setValidatedData(result.data);\n      }\n\n      if (!result.isValid) {\n        log.warn(\"validation\", \"schema\", \"Schema Validation failed\");\n        return response.failedSchema(result);\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.validate) {\n    const result = await validation.validate(request, response);\n\n    // if there is a result, it means it failed\n    if (result) {\n      // check if there is no response status code, then set it to config value or 400 as default\n      if (!response.statusCode) {\n        response.setStatusCode(config.get(\"validation.responseStatus\", 400));\n      }\n\n      log.info(\"validation\", \"failed\", \"Validation failed\");\n\n      return result;\n    }\n\n    log.info(\"validation\", \"passed\", \"Validation passed\");\n  }\n}\n"],"mappings":";;;;;;AAOA,SAAS,mBAAmB,YAAoD,SAAkB;CAChG,IAAI,CAAC,cAAc,WAAW,WAAW,GAAG,OAAO,QAAQ,gBAAgB;CAE3E,IAAI,OAAY,CAAC;CAEjB,KAAK,MAAM,kBAAkB,YAAY;EACvC,IAAI,mBAAmB,QACrB,OAAO,MAAM,MAAM,QAAQ,IAAI;EAGjC,IAAI,mBAAmB,SACrB,OAAO,MAAM,MAAM,QAAQ,KAAK;EAGlC,IAAI,mBAAmB,UACrB,OAAO,MAAM,MAAM,QAAQ,MAAM;EAGnC,IAAI,mBAAmB,WACrB,OAAO,MAAM,MAAM,QAAQ,OAAO;CAEtC;CAEA,OAAO;AACT;;;;AAKA,eAAsB,YACpB,YACA,SACA,UACA;CACA,IAAI,CAAC,YAAY;CAEjB,IAAI,KAAK,cAAc,WAAW,8BAA8B;CAEhE,IAAI,WAAW,QAAQ;EACrB,IAAI,KAAK,cAAc,UAAU,2BAA2B;EAC5D,IAAI;GACF,MAAM,OAAO,mBAAmB,WAAW,YAAY,OAAO;GAC9D,MAAM,SAAS,MAAM,EAAE,SAAS,WAAW,QAAQ,IAAI;GAEvD,IAAI,OAAO,QAAQ,OAAO,SACxB,QAAQ,iBAAiB,OAAO,IAAI;GAGtC,IAAI,CAAC,OAAO,SAAS;IACnB,IAAI,KAAK,cAAc,UAAU,0BAA0B;IAC3D,OAAO,SAAS,aAAa,MAAM;GACrC;GAEA,IAAI,QAAQ,cAAc,UAAU,0BAA0B;EAChE,SAAS,OAAO;GACd,IAAI,KAAK,kBAAkB,SAAS,KAAK;GACzC,MAAM;EACR;CACF;CAEA,IAAI,WAAW,UAAU;EACvB,MAAM,SAAS,MAAM,WAAW,SAAS,SAAS,QAAQ;EAG1D,IAAI,QAAQ;GAEV,IAAI,CAAC,SAAS,YACZ,SAAS,cAAc,OAAO,IAAI,6BAA6B,GAAG,CAAC;GAGrE,IAAI,KAAK,cAAc,UAAU,mBAAmB;GAEpD,OAAO;EACT;EAEA,IAAI,KAAK,cAAc,UAAU,mBAAmB;CACtD;AACF"}

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

@@ -0,0 +1,65 @@
+import { BaseValidator, FileSizeOption, JsonSchemaResult, JsonSchemaTarget } from "@warlock.js/seal";
+
+//#region ../../@warlock.js/core/src/validation/validators/file-validator.d.ts
+declare const uploadedFileMetadataSchema: any;
+/**
+ * File validator class
+ */
+declare class FileValidator extends BaseValidator {
+  constructor(errorMessage?: string);
+  /**
+   * Check if value is a File type
+   */
+  matchesType(value: any): boolean;
+  /** Value must be an image */
+  image(errorMessage?: string): FileValidator;
+  /** Accept specific file extensions */
+  accept(extensions: string | string[], errorMessage?: string): FileValidator;
+  /** Allow specific MIME types */
+  mimeType(mimeTypes: string | string[], errorMessage?: string): FileValidator;
+  /** Allow only pdf files */
+  pdf(errorMessage?: string): FileValidator;
+  /** Allow only excel files */
+  excel(errorMessage?: string): FileValidator;
+  /** Allow only word files */
+  word(errorMessage?: string): FileValidator;
+  /** Minimum file size */
+  minSize(size: number | FileSizeOption, errorMessage?: string): FileValidator;
+  /** @alias minSize */
+  min(size: number | FileSizeOption, errorMessage?: string): FileValidator;
+  /** Maximum file size */
+  maxSize(size: number | FileSizeOption, errorMessage?: string): FileValidator;
+  /** @alias maxSize */
+  max(size: number, errorMessage?: string): FileValidator;
+  /** Minimum image width */
+  minWidth(width: number, errorMessage?: string): FileValidator;
+  /** Maximum image width */
+  maxWidth(width: number, errorMessage?: string): FileValidator;
+  /** Minimum image height */
+  minHeight(height: number, errorMessage?: string): FileValidator;
+  /** Maximum image height */
+  maxHeight(height: number, errorMessage?: string): FileValidator;
+  /**
+   * Save the file and return it as a string
+   */
+  saveTo(relativeDirectory: string): FileValidator;
+  /**
+   * @inheritdoc
+   *
+   * File uploads are not natively representable in JSON Schema.
+   * The output varies by target:
+   * - `openapi-3.0`   → `{ type: "string", format: "binary" }` (standard for multipart/form-data uploads)
+   * - `draft-2020-12` → `{ type: "string", contentEncoding: "binary" }`
+   * - `draft-07`      → `{}` (no standard binary representation — permissive fallback)
+   *
+   * @example
+   * ```ts
+   * v.file().toJsonSchema("openapi-3.0")
+   * // → { type: "string", format: "binary" }
+   * ```
+   */
+  toJsonSchema(target?: JsonSchemaTarget): JsonSchemaResult;
+}
+//#endregion
+export { FileValidator, uploadedFileMetadataSchema };
+//# sourceMappingURL=file-validator.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-validator.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/validation/validators/file-validator.ts"],"mappings":";;;cAea,0BAAA;AAAb;;;AAAA,cAaa,aAAA,SAAsB,aAAA;cACd,YAAA;EADR;;;EASJ,WAAA,CAAY,KAAA;EAUkD;EAL9D,KAAA,CAAM,YAAA,YAAwB,aAAA;EAmBF;EAd5B,MAAA,CAAO,UAAA,qBAA+B,YAAA,YAAwB,aAAA;EA8BjC;EAvB7B,QAAA,CAAS,SAAA,qBAA8B,YAAA,YAAwB,aAAA;EAkCA;EA3B/D,GAAA,CAAI,YAAA,YAAwB,aAAA;EAkC+B;EA7B3D,KAAA,CAAM,YAAA,YAAwB,aAAA;EAkCiC;EAvB/D,IAAA,CAAK,YAAA,YAAwB,aAAA;EAmCmB;EAxBhD,OAAA,CAAQ,IAAA,WAAe,cAAA,EAAgB,YAAA,YAAwB,aAAA;EAsCb;EA/BlD,GAAA,CAAI,IAAA,WAAe,cAAA,EAAgB,YAAA,YAAwB,aAAA;EA+CxB;EA1CnC,OAAA,CAAQ,IAAA,WAAe,cAAA,EAAgB,YAAA,YAAwB,aAAA;EAiEI;EA1DnE,GAAA,CAAI,IAAA,UAAc,YAAA,YAAwB,aAAA;EA/EH;EAoFvC,QAAA,CAAS,KAAA,UAAe,YAAA,YAAwB,aAAA;EApFtB;EA2F1B,QAAA,CAAS,KAAA,UAAe,YAAA,YAAwB,aAAA;EA1FpC;EAiGZ,SAAA,CAAU,MAAA,UAAgB,YAAA,YAAwB,aAAA;EAzFtC;EAgGZ,SAAA,CAAU,MAAA,UAAgB,YAAA,YAAwB,aAAA;EA3F5C;;;EAoGN,MAAA,CAAO,iBAAA,WAA4B,aAAA;EA/FG;;;;;;;;;;;;;;;EAsH7B,YAAA,CAAa,MAAA,GAAQ,gBAAA,GAAqC,gBAAA;AAAA"}

package/esm/validation/validators/file-validator.mjs

@@ -0,0 +1,125 @@
+import { UploadedFile } from "../../http/uploaded-file.mjs";
+import "../../http/index.mjs";
+import { fileExtensionRule, fileRule, fileTypeRule, imageRule } from "../file/file.mjs";
+import "../file/index.mjs";
+import { BaseValidator, maxFileSizeRule, maxHeightRule, maxWidthRule, minFileSizeRule, minHeightRule, minWidthRule, resolveFileSize, v } from "@warlock.js/seal";
+
+//#region ../../@warlock.js/core/src/validation/validators/file-validator.ts
+const uploadedFileMetadataSchema = v.object({
+	location: v.string().oneOf(["local", "cloud"]),
+	width: v.int().positive(),
+	height: v.int().positive(),
+	size: v.int().positive(),
+	mimeType: v.string(),
+	extension: v.string(),
+	name: v.string()
+});
+/**
+* File validator class
+*/
+var FileValidator = class extends BaseValidator {
+	constructor(errorMessage) {
+		super();
+		this.addMutableRule(fileRule, errorMessage);
+	}
+	/**
+	* Check if value is a File type
+	*/
+	matchesType(value) {
+		return value instanceof UploadedFile;
+	}
+	/** Value must be an image */
+	image(errorMessage) {
+		return this.addRule(imageRule, errorMessage);
+	}
+	/** Accept specific file extensions */
+	accept(extensions, errorMessage) {
+		return this.addRule(fileExtensionRule, errorMessage, { extensions });
+	}
+	/** Allow specific MIME types */
+	mimeType(mimeTypes, errorMessage) {
+		return this.addRule(fileTypeRule, errorMessage, { mimeTypes });
+	}
+	/** Allow only pdf files */
+	pdf(errorMessage) {
+		return this.mimeType("application/pdf", errorMessage);
+	}
+	/** Allow only excel files */
+	excel(errorMessage) {
+		return this.mimeType(["application/vnd.ms-excel", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"], errorMessage);
+	}
+	/** Allow only word files */
+	word(errorMessage) {
+		return this.mimeType(["application/msword", "application/vnd.openxmlformats-officedocument.wordprocessingml.document"], errorMessage);
+	}
+	/** Minimum file size */
+	minSize(size, errorMessage) {
+		return this.addRule(minFileSizeRule, errorMessage, { minSize: resolveFileSize(size) });
+	}
+	/** @alias minSize */
+	min(size, errorMessage) {
+		return this.minSize(size, errorMessage);
+	}
+	/** Maximum file size */
+	maxSize(size, errorMessage) {
+		return this.addRule(maxFileSizeRule, errorMessage, { maxSize: resolveFileSize(size) });
+	}
+	/** @alias maxSize */
+	max(size, errorMessage) {
+		return this.maxSize(size, errorMessage);
+	}
+	/** Minimum image width */
+	minWidth(width, errorMessage) {
+		return this.addRule(minWidthRule, errorMessage, { minWidth: width });
+	}
+	/** Maximum image width */
+	maxWidth(width, errorMessage) {
+		return this.addRule(maxWidthRule, errorMessage, { maxWidth: width });
+	}
+	/** Minimum image height */
+	minHeight(height, errorMessage) {
+		return this.addRule(minHeightRule, errorMessage, { minHeight: height });
+	}
+	/** Maximum image height */
+	maxHeight(height, errorMessage) {
+		return this.addRule(maxHeightRule, errorMessage, { maxHeight: height });
+	}
+	/**
+	* Save the file and return it as a string
+	*/
+	saveTo(relativeDirectory) {
+		return this.addTransformer(async (file) => {
+			return (await file.save(relativeDirectory)).path;
+		});
+	}
+	/**
+	* @inheritdoc
+	*
+	* File uploads are not natively representable in JSON Schema.
+	* The output varies by target:
+	* - `openapi-3.0`   → `{ type: "string", format: "binary" }` (standard for multipart/form-data uploads)
+	* - `draft-2020-12` → `{ type: "string", contentEncoding: "binary" }`
+	* - `draft-07`      → `{}` (no standard binary representation — permissive fallback)
+	*
+	* @example
+	* ```ts
+	* v.file().toJsonSchema("openapi-3.0")
+	* // → { type: "string", format: "binary" }
+	* ```
+	*/
+	toJsonSchema(target = "draft-2020-12") {
+		if (target === "openapi-3.0") return {
+			type: "string",
+			format: "binary"
+		};
+		if (target === "draft-2020-12") return {
+			type: "string",
+			contentEncoding: "binary"
+		};
+		return {};
+	}
+};
+
+//#endregion
+export { FileValidator, uploadedFileMetadataSchema };
+//# sourceMappingURL=file-validator.mjs.map

package/esm/validation/validators/file-validator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-validator.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/validation/validators/file-validator.ts"],"sourcesContent":["import type { FileSizeOption, JsonSchemaResult, JsonSchemaTarget } from \"@warlock.js/seal\";\nimport {\n  BaseValidator,\n  maxFileSizeRule,\n  maxHeightRule,\n  maxWidthRule,\n  minFileSizeRule,\n  minHeightRule,\n  minWidthRule,\n  resolveFileSize,\n  v,\n} from \"@warlock.js/seal\";\nimport { UploadedFile } from \"../../http\";\nimport { fileExtensionRule, fileRule, fileTypeRule, imageRule } from \"../file\";\n\nexport const uploadedFileMetadataSchema = v.object({\n  location: v.string().oneOf([\"local\", \"cloud\"]),\n  width: v.int().positive(),\n  height: v.int().positive(),\n  size: v.int().positive(),\n  mimeType: v.string(),\n  extension: v.string(),\n  name: v.string(),\n});\n\n/**\n * File validator class\n */\nexport class FileValidator extends BaseValidator {\n  public constructor(errorMessage?: string) {\n    super();\n    this.addMutableRule(fileRule, errorMessage);\n  }\n\n  /**\n   * Check if value is a File type\n   */\n  public matchesType(value: any): boolean {\n    return value instanceof UploadedFile;\n  }\n\n  /** Value must be an image */\n  public image(errorMessage?: string): FileValidator {\n    return this.addRule(imageRule, errorMessage);\n  }\n\n  /** Accept specific file extensions */\n  public accept(extensions: string | string[], errorMessage?: string): FileValidator {\n    return this.addRule(fileExtensionRule, errorMessage, {\n      extensions,\n    });\n  }\n\n  /** Allow specific MIME types */\n  public mimeType(mimeTypes: string | string[], errorMessage?: string): FileValidator {\n    return this.addRule(fileTypeRule, errorMessage, {\n      mimeTypes,\n    });\n  }\n\n  /** Allow only pdf files */\n  public pdf(errorMessage?: string): FileValidator {\n    return this.mimeType(\"application/pdf\", errorMessage);\n  }\n\n  /** Allow only excel files */\n  public excel(errorMessage?: string): FileValidator {\n    return this.mimeType(\n      [\n        \"application/vnd.ms-excel\",\n        \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n      ],\n      errorMessage,\n    );\n  }\n\n  /** Allow only word files */\n  public word(errorMessage?: string): FileValidator {\n    return this.mimeType(\n      [\n        \"application/msword\",\n        \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n      ],\n      errorMessage,\n    );\n  }\n\n  /** Minimum file size */\n  public minSize(size: number | FileSizeOption, errorMessage?: string): FileValidator {\n    return this.addRule(minFileSizeRule, errorMessage, {\n      minSize: resolveFileSize(size),\n    });\n  }\n\n  /** @alias minSize */\n  public min(size: number | FileSizeOption, errorMessage?: string): FileValidator {\n    return this.minSize(size, errorMessage);\n  }\n\n  /** Maximum file size */\n  public maxSize(size: number | FileSizeOption, errorMessage?: string): FileValidator {\n    return this.addRule(maxFileSizeRule, errorMessage, {\n      maxSize: resolveFileSize(size),\n    });\n  }\n\n  /** @alias maxSize */\n  public max(size: number, errorMessage?: string): FileValidator {\n    return this.maxSize(size, errorMessage);\n  }\n\n  /** Minimum image width */\n  public minWidth(width: number, errorMessage?: string): FileValidator {\n    return this.addRule(minWidthRule, errorMessage, {\n      minWidth: width,\n    });\n  }\n\n  /** Maximum image width */\n  public maxWidth(width: number, errorMessage?: string): FileValidator {\n    return this.addRule(maxWidthRule, errorMessage, {\n      maxWidth: width,\n    });\n  }\n\n  /** Minimum image height */\n  public minHeight(height: number, errorMessage?: string): FileValidator {\n    return this.addRule(minHeightRule, errorMessage, {\n      minHeight: height,\n    });\n  }\n\n  /** Maximum image height */\n  public maxHeight(height: number, errorMessage?: string): FileValidator {\n    return this.addRule(maxHeightRule, errorMessage, {\n      maxHeight: height,\n    });\n  }\n\n  /**\n   * Save the file and return it as a string\n   */\n  public saveTo(relativeDirectory: string): FileValidator {\n    return this.addTransformer(async (file: UploadedFile) => {\n      const output = await file.save(relativeDirectory);\n\n      return output.path;\n    });\n  }\n\n  /**\n   * @inheritdoc\n   *\n   * File uploads are not natively representable in JSON Schema.\n   * The output varies by target:\n   * - `openapi-3.0`   → `{ type: \"string\", format: \"binary\" }` (standard for multipart/form-data uploads)\n   * - `draft-2020-12` → `{ type: \"string\", contentEncoding: \"binary\" }`\n   * - `draft-07`      → `{}` (no standard binary representation — permissive fallback)\n   *\n   * @example\n   * ```ts\n   * v.file().toJsonSchema(\"openapi-3.0\")\n   * // → { type: \"string\", format: \"binary\" }\n   * ```\n   */\n  public override toJsonSchema(target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\n    if (target === \"openapi-3.0\") {\n      return { type: \"string\", format: \"binary\" };\n    }\n\n    if (target === \"draft-2020-12\") {\n      return { type: \"string\", contentEncoding: \"binary\" };\n    }\n\n    // draft-07: no standard binary representation\n    return {};\n  }\n}\n"],"mappings":";;;;;;;AAeA,MAAa,6BAA6B,EAAE,OAAO;CACjD,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,OAAO,CAAC;CAC7C,OAAO,EAAE,IAAI,EAAE,SAAS;CACxB,QAAQ,EAAE,IAAI,EAAE,SAAS;CACzB,MAAM,EAAE,IAAI,EAAE,SAAS;CACvB,UAAU,EAAE,OAAO;CACnB,WAAW,EAAE,OAAO;CACpB,MAAM,EAAE,OAAO;AACjB,CAAC;;;;AAKD,IAAa,gBAAb,cAAmC,cAAc;CAC/C,AAAO,YAAY,cAAuB;EACxC,MAAM;EACN,KAAK,eAAe,UAAU,YAAY;CAC5C;;;;CAKA,AAAO,YAAY,OAAqB;EACtC,OAAO,iBAAiB;CAC1B;;CAGA,AAAO,MAAM,cAAsC;EACjD,OAAO,KAAK,QAAQ,WAAW,YAAY;CAC7C;;CAGA,AAAO,OAAO,YAA+B,cAAsC;EACjF,OAAO,KAAK,QAAQ,mBAAmB,cAAc,EACnD,WACF,CAAC;CACH;;CAGA,AAAO,SAAS,WAA8B,cAAsC;EAClF,OAAO,KAAK,QAAQ,cAAc,cAAc,EAC9C,UACF,CAAC;CACH;;CAGA,AAAO,IAAI,cAAsC;EAC/C,OAAO,KAAK,SAAS,mBAAmB,YAAY;CACtD;;CAGA,AAAO,MAAM,cAAsC;EACjD,OAAO,KAAK,SACV,CACE,4BACA,mEACF,GACA,YACF;CACF;;CAGA,AAAO,KAAK,cAAsC;EAChD,OAAO,KAAK,SACV,CACE,sBACA,yEACF,GACA,YACF;CACF;;CAGA,AAAO,QAAQ,MAA+B,cAAsC;EAClF,OAAO,KAAK,QAAQ,iBAAiB,cAAc,EACjD,SAAS,gBAAgB,IAAI,EAC/B,CAAC;CACH;;CAGA,AAAO,IAAI,MAA+B,cAAsC;EAC9E,OAAO,KAAK,QAAQ,MAAM,YAAY;CACxC;;CAGA,AAAO,QAAQ,MAA+B,cAAsC;EAClF,OAAO,KAAK,QAAQ,iBAAiB,cAAc,EACjD,SAAS,gBAAgB,IAAI,EAC/B,CAAC;CACH;;CAGA,AAAO,IAAI,MAAc,cAAsC;EAC7D,OAAO,KAAK,QAAQ,MAAM,YAAY;CACxC;;CAGA,AAAO,SAAS,OAAe,cAAsC;EACnE,OAAO,KAAK,QAAQ,cAAc,cAAc,EAC9C,UAAU,MACZ,CAAC;CACH;;CAGA,AAAO,SAAS,OAAe,cAAsC;EACnE,OAAO,KAAK,QAAQ,cAAc,cAAc,EAC9C,UAAU,MACZ,CAAC;CACH;;CAGA,AAAO,UAAU,QAAgB,cAAsC;EACrE,OAAO,KAAK,QAAQ,eAAe,cAAc,EAC/C,WAAW,OACb,CAAC;CACH;;CAGA,AAAO,UAAU,QAAgB,cAAsC;EACrE,OAAO,KAAK,QAAQ,eAAe,cAAc,EAC/C,WAAW,OACb,CAAC;CACH;;;;CAKA,AAAO,OAAO,mBAA0C;EACtD,OAAO,KAAK,eAAe,OAAO,SAAuB;GAGvD,QAAO,MAFc,KAAK,KAAK,iBAAiB,GAElC;EAChB,CAAC;CACH;;;;;;;;;;;;;;;;CAiBA,AAAgB,aAAa,SAA2B,iBAAmC;EACzF,IAAI,WAAW,eACb,OAAO;GAAE,MAAM;GAAU,QAAQ;EAAS;EAG5C,IAAI,WAAW,iBACb,OAAO;GAAE,MAAM;GAAU,iBAAiB;EAAS;EAIrD,OAAO,CAAC;CACV;AACF"}

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

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

package/esm/validation/validators/index.mjs

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

package/esm/warlock-config/default-configurations.mjs

@@ -0,0 +1,11 @@
+//#region ../../@warlock.js/core/src/warlock-config/default-configurations.ts
+const defaultWarlockConfigurations = { build: {
+	outDirectory: process.cwd() + "/dist",
+	outFile: "app.js",
+	sourcemap: true,
+	minify: true
+} };
+
+//#endregion
+export { defaultWarlockConfigurations };
+//# sourceMappingURL=default-configurations.mjs.map

package/esm/warlock-config/default-configurations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-configurations.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/warlock-config/default-configurations.ts"],"sourcesContent":["import { WarlockConfig } from \"./types\";\n\nexport const defaultWarlockConfigurations: WarlockConfig = {\n  build: {\n    outDirectory: process.cwd() + \"/dist\",\n    outFile: \"app.js\",\n    sourcemap: true,\n    minify: true,\n  },\n};\n"],"mappings":";AAEA,MAAa,+BAA8C,EACzD,OAAO;CACL,cAAc,QAAQ,IAAI,IAAI;CAC9B,SAAS;CACT,WAAW;CACX,QAAQ;AACV,EACF"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/warlock-config/define-config.ts"],"mappings":";;;iBAIgB,YAAA,CAAa,OAAA,EAAS,aAAA,GAAa,aAAA"}

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

@@ -0,0 +1,11 @@
+import { defaultWarlockConfigurations } from "./default-configurations.mjs";
+import { merge } from "@mongez/reinforcements";
+
+//#region ../../@warlock.js/core/src/warlock-config/define-config.ts
+function defineConfig(options) {
+	return merge(defaultWarlockConfigurations, options);
+}
+
+//#endregion
+export { defineConfig };
+//# sourceMappingURL=define-config.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/warlock-config/define-config.ts"],"sourcesContent":["import { merge } from \"@mongez/reinforcements\";\nimport { defaultWarlockConfigurations } from \"./default-configurations\";\nimport type { WarlockConfig } from \"./types\";\n\nexport function defineConfig(options: WarlockConfig) {\n  return merge(defaultWarlockConfigurations, options);\n}\n"],"mappings":";;;;AAIA,SAAgB,aAAa,SAAwB;CACnD,OAAO,MAAM,8BAA8B,OAAO;AACpD"}

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

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

package/esm/warlock-config/index.mjs

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

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

@@ -0,0 +1,143 @@
+import { CLICommand } from "../cli/cli-command.mjs";
+import { FileHealthCheckerContract } from "../dev-server/health-checker/file-health-checker.contract.mjs";
+import { MigrationConstructor } from "@warlock.js/cascade";
+
+//#region ../../@warlock.js/core/src/warlock-config/types.d.ts
+/**
+ * Resolved Warlock Configuration
+ *
+ * This is the final configuration after merging user config with defaults
+ */
+type WarlockConfig = {
+  /**
+   * Server configuration
+   */
+  server?: {
+    port?: number;
+    host?: string;
+    retryOtherPort?: boolean;
+  };
+  /**
+   * Build configuration
+   */
+  build?: {
+    /**
+     * Output directory
+     *
+     * @default dist
+     */
+    outDirectory?: string;
+    /**
+     * Output file
+     *
+     * @default app.js
+     */
+    outFile?: string;
+    /**
+     * Minify output
+     *
+     * @default true
+     */
+    minify?: boolean;
+    /**
+     * Generate sourcemap
+     *
+     * @default true
+     */
+    sourcemap?: boolean | "inline" | "linked";
+  };
+  /**
+   * CLI configuration
+   */
+  cli?: {
+    commands?: CLICommand[];
+  };
+  /**
+   * Development server configuration
+   */
+  devServer?: {
+    /**
+     * Watch configuration
+     */
+    watch?: {
+      /**
+       * Glob patterns to include in file watching
+       *
+       * @default ["**\/*.{ts,tsx}"]
+       */
+      include?: string[];
+      /**
+       * Glob patterns to exclude from file watching
+       *
+       * @default ["**\/node_modules\/**", "**\/dist\/**", "**\/.warlock\/**", "**\/.git\/**"]
+       */
+      exclude?: string[];
+    };
+    /**
+     * Custom health checkers
+     */
+    healthCheckers?: FileHealthCheckerContract[] | false;
+    /**
+     * Whether to generate typings on dev server start
+     * @default true
+     */
+    generateTypings?: boolean;
+    /**
+     * Debug aid for the (always-on) persisted transpile cache. Names cache
+     * files `<slug>.<hash>.js` (last 3 source path segments) and appends a
+     * trailing `// @source <path>` marker, so you can eyeball which entry
+     * in `.warlock/transpile/` is which. Purely cosmetic — does not affect
+     * cache keys, lookup, or correctness. Turn on only while diagnosing a
+     * cache issue; leave off for opaque hash-only names.
+     * @default false
+     */
+    transpileCacheDebug?: boolean;
+  };
+  /**
+   * Database configuration
+   */
+  database?: {
+    /**
+     * Package-level migrations to include in migration runs.
+     *
+     * Use this to register migrations from external packages
+     * (e.g., @warlock.js/auth) that are not auto-discovered.
+     *
+     * @example
+     * ```typescript
+     * import { authMigrations } from "@warlock.js/auth";
+     *
+     * export default defineConfig({
+     *   database: {
+     *     migrations: [...authMigrations],
+     *   },
+     * });
+     * ```
+     */
+    migrations?: Array<MigrationConstructor>;
+  };
+  /**
+   * Testing configuration
+   *
+   * High-level test settings. For detailed test behavior,
+   * use config/tests.ts instead.
+   */
+  testing?: {
+    /**
+     * Additional glob patterns to include as test files.
+     * Added to the default patterns.
+     *
+     * @example ["src/shared/[ALL]/*.test.ts"]
+     */
+    include?: string[];
+    /**
+     * Glob patterns to exclude from test discovery.
+     *
+     * @example [[ALL]/*.integration.test.ts"]
+     */
+    exclude?: string[];
+  };
+};
+//#endregion
+export { WarlockConfig };
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/warlock-config/types.ts"],"mappings":";;;;;;;AASA;;;KAAY,aAAA;EAuES;;;EAnEnB,MAAA;IACE,IAAA;IACA,IAAA;IACA,cAAA;EAAA;EAAA;;;EAMF,KAAA;IAkBE;;;;;IAZA,YAAA;IAmCA;;;;;IA7BA,OAAA;IA6DA;;;;;IAvDA,MAAA;IA+FA;;;AAOO;;IAhGP,SAAA;EAAA;;;;EAMF,GAAA;IACE,QAAA,GAAW,UAAA;EAAA;;;;EAMb,SAAA;;;;IAIE,KAAA;;;;;;MAME,OAAA;;;;;;MAMA,OAAA;IAAA;;;;IAKF,cAAA,GAAiB,yBAAA;;;;;IAKjB,eAAA;;;;;;;;;;IAUA,mBAAA;EAAA;;;;EAMF,QAAA;;;;;;;;;;;;;;;;;;IAkBE,UAAA,GAAa,KAAA,CAAM,oBAAA;EAAA;;;;;;;EASrB,OAAA;;;;;;;IAOE,OAAA;;;;;;IAOA,OAAA;EAAA;AAAA"}

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

@@ -0,0 +1,86 @@
+import { WarlockConfig } from "./types.mjs";
+
+//#region ../../@warlock.js/core/src/warlock-config/warlock-config.manager.d.ts
+/**
+ * Warlock Config Manager
+ *
+ * Manages lazy loading of the pre-compiled warlock.config.js file
+ * from the .warlock/cache directory.
+ */
+declare class WarlockConfigManager {
+  /**
+   * Cached config instance
+   */
+  private config?;
+  /**
+   * Loading promise to prevent duplicate loads
+   */
+  private loading?;
+  /**
+   * Load warlock.config.js (cached after first load)
+   *
+   * @returns The resolved Warlock configuration
+   */
+  load(): Promise<WarlockConfig | undefined>;
+  /**
+   * Internal load implementation
+   *
+   * The ESM loader hook transpiles `warlock.config.ts` on import — no
+   * separate compile-to-disk step is needed.
+   */
+  private doLoad;
+  /**
+   * Get config value by key (dot notation supported)
+   *
+   * @example
+   * config.get("server.port") // Returns 3000
+   * config.get("cli.commands") // Returns array of commands
+   *
+   * @param key - Config key (supports dot notation), autocompletes for first level only
+   * @returns The config value
+   * @throws Error if config is not loaded
+   */
+  get<Key extends keyof WarlockConfig>(key: Key, defaultValue?: WarlockConfig[Key]): WarlockConfig[Key];
+  /**
+   * Lazy get - loads config if not already loaded
+   *
+   * @example
+   * const port = await config.lazyGet("server");
+   *
+   * @param key - Config key (supports dot notation), autocompletes for first level only
+   * @param defaultValue - Default value if config key is undefined
+   * @returns The config value
+   */
+  lazyGet<Key extends keyof WarlockConfig>(key: Key, defaultValue?: WarlockConfig[Key]): Promise<WarlockConfig[Key]>;
+  /**
+   * Check if config is loaded
+   */
+  get isLoaded(): boolean;
+  /**
+   * Get the entire config object
+   *
+   * @throws Error if config is not loaded
+   */
+  getAll(): WarlockConfig;
+  /**
+   * Reload config (useful for HMR/development)
+   */
+  reload(): Promise<void>;
+}
+/**
+ * Exported singleton instance
+ *
+ * @example
+ * import { warlockConfig } from "@warlock.js/core";
+ *
+ * // Lazy load and get value
+ * const port = await warlockConfig.lazyGet("server.port");
+ *
+ * // Or load first, then get
+ * await warlockConfig.load();
+ * const commands = warlockConfig.get("cli.commands");
+ */
+declare const warlockConfigManager: WarlockConfigManager;
+//#endregion
+export { WarlockConfigManager, warlockConfigManager };
+//# sourceMappingURL=warlock-config.manager.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"warlock-config.manager.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/warlock-config/warlock-config.manager.ts"],"mappings":";;;;;AAaA;;;;cAAa,oBAAA;EAsEkB;;;EAAA,QAlErB,MAAA;EAqEL;;;EAAA,QAhEK,OAAA;EAoFS;;;;;EA7EJ,IAAA,CAAA,GAAQ,OAAA,CAAQ,aAAA;EA0GN;;;;;;EAAA,QAjFT,MAAA;EAzBe;;;;;;;;;;;EAsDtB,GAAA,mBAAsB,aAAA,CAAA,CAC3B,GAAA,EAAK,GAAA,EACL,YAAA,GAAe,aAAA,CAAc,GAAA,IAC5B,aAAA,CAAc,GAAA;EAkBX;;;;;;;;;;EAAA,OAAA,mBAA0B,aAAA,CAAA,CAC9B,GAAA,EAAK,GAAA,EACL,YAAA,GAAe,aAAA,CAAc,GAAA,IAC5B,OAAA,CAAQ,aAAA,CAAc,GAAA;EAQd;;;EAAA,IAAA,QAAA,CAAA;EAoBY;;AAAO;AAoBhC;;EA/BS,MAAA,CAAA,GAAU,aAAA;EA+B2C;AAAA;;EApB/C,MAAA,CAAA,GAAU,OAAA;AAAA;;;;;;;;;;;;;;cAoBZ,oBAAA,EAAoB,oBAA6B"}