@warlock.js/core 5.30.0 → 5.32.0

package/esm/cli/framework-cli-commands.mjs

@@ -1,19 +1,30 @@
 import { addCommand } from "./commands/add.command.mjs";
+import { agentsMdCommand } from "./commands/agents-md.command.mjs";
+import { boardCommand } from "./commands/board.command.mjs";
 import { buildCommand } from "./commands/build.command.mjs";
+import { checkCommand } from "./commands/check.command.mjs";
 import { createDatabaseCommand } from "./commands/create-database.command.mjs";
 import { devServerCommand } from "./commands/dev-server.command.mjs";
 import { doctorCommand } from "./commands/doctor.command.mjs";
 import { dropTablesCommand } from "./commands/drop-tables.command.mjs";
-import { generateCommand, generateControllerCommand, generateMigrationCommand, generateModelCommand, generateModuleCommand, generateRepositoryCommand, generateResourceCommand, generateServiceCommand, generateUseCaseCommand } from "./commands/generate/generate.command.mjs";
+import { explainCommand } from "./commands/explain.command.mjs";
+import { generateCommand, generateControllerCommand, generateEndpointCommand, generateMigrationCommand, generateModelCommand, generateModuleCommand, generateRepositoryCommand, generateResourceCommand, generateServiceCommand, generateUseCaseCommand, makeCommand } from "./commands/generate/generate.command.mjs";
+import { inspectCommand } from "./commands/inspect.command.mjs";
+import { issueCommand } from "./commands/issue.command.mjs";
+import { mcpCommand } from "./commands/mcp.command.mjs";
 import { migrateCommand } from "./commands/migrate.command.mjs";
 import { openApiGeneratorCommand } from "./commands/openapi-generator.command.mjs";
 import { postmanGeneratorCommand } from "./commands/postman-generator.command.mjs";
 import { routesCommand, routesDiffCommand } from "./commands/routes.command.mjs";
 import { seedCommand } from "./commands/seed.command.mjs";
 import { startProductionCommand } from "./commands/start-production.command.mjs";
+import { traceCommand } from "./commands/trace.command.mjs";
 import { storagePutCommand } from "./commands/storage-put.command.mjs";
+import { typecheckCommand } from "./commands/typecheck.command.mjs";
+import { testCommand } from "./commands/test.command.mjs";
 import { typingsGeneratorCommand } from "./commands/typings-generator.command.mjs";
 import { updateCommand } from "./commands/update.command.mjs";
+import { upgradeCommand } from "./commands/upgrade.command.mjs";
 
 //#region ../../packages/core/src/cli/framework-cli-commands.ts
 const frameworkCommands = [
@@ -21,9 +32,19 @@ const frameworkCommands = [
 	typingsGeneratorCommand,
 	openApiGeneratorCommand,
 	postmanGeneratorCommand,
+	testCommand,
 	doctorCommand,
 	routesCommand,
 	routesDiffCommand,
+	inspectCommand,
+	explainCommand,
+	issueCommand,
+	checkCommand,
+	typecheckCommand,
+	mcpCommand,
+	traceCommand,
+	agentsMdCommand,
+	boardCommand,
 	buildCommand,
 	startProductionCommand,
 	migrateCommand,
@@ -32,7 +53,10 @@ const frameworkCommands = [
 	dropTablesCommand,
 	addCommand,
 	updateCommand,
+	upgradeCommand,
 	generateCommand,
+	makeCommand,
+	generateEndpointCommand,
 	generateModuleCommand,
 	generateControllerCommand,
 	generateServiceCommand,

package/esm/cli/framework-cli-commands.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"framework-cli-commands.mjs","names":[],"sources":["../../../../../../../../packages/core/src/cli/framework-cli-commands.ts"],"sourcesContent":["import { addCommand } from \"./commands/add.command\";\nimport { buildCommand } from \"./commands/build.command\";\nimport { createDatabaseCommand } from \"./commands/create-database.command\";\nimport { devServerCommand } from \"./commands/dev-server.command\";\nimport { doctorCommand } from \"./commands/doctor.command\";\nimport { dropTablesCommand } from \"./commands/drop-tables.command\";\nimport {\n  generateCommand,\n  generateControllerCommand,\n  generateMigrationCommand,\n  generateModelCommand,\n  generateModuleCommand,\n  generateRepositoryCommand,\n  generateResourceCommand,\n  generateServiceCommand,\n  generateUseCaseCommand,\n} from \"./commands/generate/generate.command\";\nimport { migrateCommand } from \"./commands/migrate.command\";\nimport { openApiGeneratorCommand } from \"./commands/openapi-generator.command\";\nimport { postmanGeneratorCommand } from \"./commands/postman-generator.command\";\nimport { routesCommand, routesDiffCommand } from \"./commands/routes.command\";\nimport { seedCommand } from \"./commands/seed.command\";\nimport { startProductionCommand } from \"./commands/start-production.command\";\nimport { storagePutCommand } from \"./commands/storage-put.command\";\nimport { typingsGeneratorCommand } from \"./commands/typings-generator.command\";\nimport { updateCommand } from \"./commands/update.command\";\n\nexport const frameworkCommands = [\n  // development commands\n  devServerCommand,\n  typingsGeneratorCommand,\n  openApiGeneratorCommand,\n  postmanGeneratorCommand,\n\n  // diagnostics commands\n  doctorCommand,\n  routesCommand,\n  routesDiffCommand,\n\n  // production commands\n  buildCommand,\n  startProductionCommand,\n\n  // database commands\n  migrateCommand,\n  seedCommand,\n  createDatabaseCommand,\n  dropTablesCommand,\n\n  // generation/installation commands\n  addCommand,\n  updateCommand,\n\n  // scaffolding commands\n  generateCommand,\n  generateModuleCommand,\n  generateControllerCommand,\n  generateServiceCommand,\n  generateUseCaseCommand,\n  generateModelCommand,\n  generateRepositoryCommand,\n  generateResourceCommand,\n  generateMigrationCommand,\n\n  // storage commands\n  storagePutCommand,\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;AA2BA,MAAa,oBAAoB;CAE/B;CACA;CACA;CACA;CAGA;CACA;CACA;CAGA;CACA;CAGA;CACA;CACA;CACA;CAGA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;AACF"}
+{"version":3,"file":"framework-cli-commands.mjs","names":[],"sources":["../../../../../../../../packages/core/src/cli/framework-cli-commands.ts"],"sourcesContent":["import { addCommand } from \"./commands/add.command\";\nimport { agentsMdCommand } from \"./commands/agents-md.command\";\nimport { boardCommand } from \"./commands/board.command\";\nimport { buildCommand } from \"./commands/build.command\";\nimport { checkCommand } from \"./commands/check.command\";\nimport { createDatabaseCommand } from \"./commands/create-database.command\";\nimport { devServerCommand } from \"./commands/dev-server.command\";\nimport { doctorCommand } from \"./commands/doctor.command\";\nimport { dropTablesCommand } from \"./commands/drop-tables.command\";\nimport { explainCommand } from \"./commands/explain.command\";\nimport {\n  generateCommand,\n  generateControllerCommand,\n  generateEndpointCommand,\n  generateMigrationCommand,\n  generateModelCommand,\n  generateModuleCommand,\n  generateRepositoryCommand,\n  generateResourceCommand,\n  generateServiceCommand,\n  generateUseCaseCommand,\n  makeCommand,\n} from \"./commands/generate/generate.command\";\nimport { inspectCommand } from \"./commands/inspect.command\";\nimport { issueCommand } from \"./commands/issue.command\";\nimport { mcpCommand } from \"./commands/mcp.command\";\nimport { migrateCommand } from \"./commands/migrate.command\";\nimport { openApiGeneratorCommand } from \"./commands/openapi-generator.command\";\nimport { postmanGeneratorCommand } from \"./commands/postman-generator.command\";\nimport { routesCommand, routesDiffCommand } from \"./commands/routes.command\";\nimport { seedCommand } from \"./commands/seed.command\";\nimport { startProductionCommand } from \"./commands/start-production.command\";\nimport { traceCommand } from \"./commands/trace.command\";\nimport { storagePutCommand } from \"./commands/storage-put.command\";\nimport { typecheckCommand } from \"./commands/typecheck.command\";\nimport { testCommand } from \"./commands/test.command\";\nimport { typingsGeneratorCommand } from \"./commands/typings-generator.command\";\nimport { updateCommand } from \"./commands/update.command\";\nimport { upgradeCommand } from \"./commands/upgrade.command\";\n\nexport const frameworkCommands = [\n  // development commands\n  devServerCommand,\n  typingsGeneratorCommand,\n  openApiGeneratorCommand,\n  postmanGeneratorCommand,\n\n  // testing commands\n  testCommand,\n\n  // diagnostics commands\n  doctorCommand,\n  routesCommand,\n  routesDiffCommand,\n  inspectCommand,\n  explainCommand,\n  issueCommand,\n  checkCommand,\n  typecheckCommand,\n\n  // agent tooling commands\n  mcpCommand,\n  traceCommand,\n  agentsMdCommand,\n  boardCommand,\n\n  // production commands\n  buildCommand,\n  startProductionCommand,\n\n  // database commands\n  migrateCommand,\n  seedCommand,\n  createDatabaseCommand,\n  dropTablesCommand,\n\n  // generation/installation commands\n  addCommand,\n  updateCommand,\n  upgradeCommand,\n\n  // scaffolding commands\n  generateCommand,\n  makeCommand,\n  generateEndpointCommand,\n  generateModuleCommand,\n  generateControllerCommand,\n  generateServiceCommand,\n  generateUseCaseCommand,\n  generateModelCommand,\n  generateRepositoryCommand,\n  generateResourceCommand,\n  generateMigrationCommand,\n\n  // storage commands\n  storagePutCommand,\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,MAAa,oBAAoB;CAE/B;CACA;CACA;CACA;CAGA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CACA;CAGA;CACA;CAGA;CACA;CACA;CACA;CAGA;CACA;CACA;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAGA;AACF"}

package/esm/cli/parse-cli-args.mjs

@@ -14,15 +14,16 @@ var CliOptionValueError = class extends Error {
 		super(`Invalid value ${JSON.stringify(value)} for boolean option ${optionToken}. Expected one of: true, false, 1, 0, yes, no — or pass ${optionToken} on its own for true.`);
 		this.optionToken = optionToken;
 		this.value = value;
+		this.code = "WL7001";
 		this.name = "CliOptionValueError";
 	}
 };
-const TRUE_VALUES = new Set([
+const TRUE_VALUES = /* @__PURE__ */ new Set([
 	"true",
 	"1",
 	"yes"
 ]);
-const FALSE_VALUES = new Set([
+const FALSE_VALUES = /* @__PURE__ */ new Set([
 	"false",
 	"0",
 	"no"

package/esm/cli/parse-cli-args.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"parse-cli-args.mjs","names":[],"sources":["../../../../../../../../packages/core/src/cli/parse-cli-args.ts"],"sourcesContent":["import { toCamelCase } from \"@mongez/reinforcements\";\n\nexport type ParsedCliArgs = {\n  name: string;\n  args: string[];\n  options: Record<string, string | boolean>;\n};\n\n/**\n * The slice of a declared command option this parser needs.\n *\n * `CLICommand.commandOptions` (`ResolvedCLICommandOption[]`) satisfies it, but\n * the parser stays independent of the command classes so it can be unit-tested\n * and reused with a hand-written schema.\n */\nexport type CliOptionSchema = {\n  name?: string;\n  alias?: string;\n  type?: \"string\" | \"boolean\" | \"number\";\n};\n\n/**\n * Thrown when a declared boolean option is given a value that is neither\n * true-ish nor false-ish.\n *\n * We refuse to guess. Guessing is exactly what produced #21: `--rollback=false`\n * was kept as the truthy string `\"false\"` and dropped every table. An option\n * that gates a destructive action must fail loudly on input it cannot read.\n */\nexport class CliOptionValueError extends Error {\n  public constructor(\n    public readonly optionToken: string,\n    public readonly value: string,\n  ) {\n    super(\n      `Invalid value ${JSON.stringify(value)} for boolean option ${optionToken}. ` +\n        `Expected one of: true, false, 1, 0, yes, no — or pass ${optionToken} on its own for true.`,\n    );\n\n    this.name = \"CliOptionValueError\";\n  }\n}\n\nconst TRUE_VALUES = new Set([\"true\", \"1\", \"yes\"]);\nconst FALSE_VALUES = new Set([\"false\", \"0\", \"no\"]);\n\n/**\n * Collect the camelCased keys (names AND aliases) of every option the command\n * declared as `type: \"boolean\"`.\n *\n * Both sides are camelCased because declared names keep their raw kebab form\n * (`\"pending-only\"`) while the parser emits camelCase keys (`pendingOnly`).\n */\nfunction collectBooleanKeys(schema: CliOptionSchema[]): Set<string> {\n  const keys = new Set<string>();\n\n  for (const option of schema) {\n    if (option.type !== \"boolean\") continue;\n\n    if (option.name) {\n      keys.add(toCamelCase(option.name));\n    }\n\n    if (option.alias) {\n      keys.add(toCamelCase(option.alias));\n    }\n  }\n\n  return keys;\n}\n\n/**\n * Collect the declared aliases longer than one character (`-st`, `-rs`, `-pm`).\n *\n * A cluster equal to one of these is that alias, not a bundle of single-letter\n * flags, so it has to be matched before the bundle split.\n */\nfunction collectMultiCharAliases(schema: CliOptionSchema[]): Set<string> {\n  const aliases = new Set<string>();\n\n  for (const option of schema) {\n    if (option.alias && option.alias.length > 1) {\n      aliases.add(option.alias);\n    }\n  }\n\n  return aliases;\n}\n\n/**\n * Turn the value written after `=` into a real boolean, or throw.\n */\nfunction toBoolean(optionToken: string, value: string): boolean {\n  const normalized = value.toLowerCase();\n\n  if (TRUE_VALUES.has(normalized)) return true;\n  if (FALSE_VALUES.has(normalized)) return false;\n\n  throw new CliOptionValueError(optionToken, value);\n}\n\n/**\n * Parse CLI arguments from process.argv\n *\n * Called with a `schema` (the resolved command's declared options), every\n * option declared `type: \"boolean\"` is resolved as a boolean:\n * `--flag` → true, `--flag=false|0|no` → false, `--flag=true|1|yes` → true,\n * and `--flag <token>` leaves `<token>` as a POSITIONAL instead of swallowing\n * it as the flag's value. Anything else throws {@link CliOptionValueError}.\n *\n * Called without a schema — which is how the command name is discovered,\n * before any command object exists — behaviour is unchanged: every value stays\n * a raw string and a bare `--flag` still consumes the following non-dash token.\n * Nothing is blanket-coerced here on purpose: `--name=false` on a string-typed\n * option must survive as the string `\"false\"`.\n *\n * Options the schema does not declare keep the schema-less behaviour.\n *\n * @example\n * parseCliArgs([\"node\", \"warlock\", \"migrate\", \"--rollback\", \"file.ts\"])\n * // Returns: { name: \"migrate\", args: [], options: { rollback: \"file.ts\" } }\n *\n * @example\n * // `rollback` declared as type: \"boolean\" — the file stays a positional\n * parseCliArgs([\"node\", \"warlock\", \"migrate\", \"--rollback\", \"file.ts\"], migrateOptions)\n * // Returns: { name: \"migrate\", args: [\"file.ts\"], options: { rollback: true } }\n *\n * @example\n * parseCliArgs([\"node\", \"warlock\", \"dev\", \"--port=3000\", \"--fresh\"])\n * // Returns: { name: \"dev\", args: [], options: { port: \"3000\", fresh: true } }\n */\nexport function parseCliArgs(argv: string[], schema: CliOptionSchema[] = []): ParsedCliArgs {\n  // Command is at index 2 (after \"node\" and script path)\n  // But if index 2 starts with \"-\", it's an option, not a command\n  const potentialCommand = argv[2] || \"\";\n  const isFirstArgOption = potentialCommand.startsWith(\"-\");\n  const command = isFirstArgOption ? \"\" : potentialCommand;\n  const args: string[] = [];\n  const options: Record<string, string | boolean> = {};\n  const booleanKeys = collectBooleanKeys(schema);\n  const multiCharAliases = collectMultiCharAliases(schema);\n\n  // Parse arguments starting from index 3 (or 2 if first arg was an option)\n  const startIndex = isFirstArgOption ? 2 : 3;\n  for (let i = startIndex; i < argv.length; i++) {\n    const arg = argv[i];\n\n    // `i < argv.length` bounds this, but the compiler does not narrow an index\n    // read from a loop condition. Skipping rather than coercing: this file\n    // already refuses to guess about an operator's input (see\n    // `CliOptionValueError` above), and an `?? \"\"` here would silently push an\n    // empty POSITIONAL onto `args` — which for a command that takes a file or\n    // a table name is a scope the operator never typed.\n    if (arg === undefined) continue;\n\n    if (arg.startsWith(\"--\")) {\n      // Long option: --key or --key=value\n      const withoutDashes = arg.slice(2);\n      const equalIndex = withoutDashes.indexOf(\"=\");\n\n      if (equalIndex !== -1) {\n        // --key=value format\n        const key = toCamelCase(withoutDashes.slice(0, equalIndex));\n        const value = withoutDashes.slice(equalIndex + 1);\n        options[key] = booleanKeys.has(key)\n          ? toBoolean(`--${withoutDashes.slice(0, equalIndex)}`, value)\n          : value;\n      } else {\n        // --key format (check if next arg is a value)\n        const key = toCamelCase(withoutDashes);\n        const nextArg = argv[i + 1];\n\n        // A declared boolean NEVER consumes the next token: `--rollback\n        // users.ts` means \"rollback, and here is a positional\", not \"rollback\n        // the file users.ts\". Swallowing it silently discarded the operator's\n        // only stated scope and rolled back everything.\n        if (booleanKeys.has(key)) {\n          options[key] = true;\n        } else if (nextArg && !nextArg.startsWith(\"-\")) {\n          // If next arg exists and doesn't start with -, treat it as value\n          options[key] = nextArg;\n          i++; // Skip next arg\n        } else {\n          options[key] = true;\n        }\n      }\n    } else if (arg.startsWith(\"-\") && arg.length > 1) {\n      // Short option: -f, -t=value, or -abc (multiple flags)\n      const flags = arg.slice(1);\n      const equalIndex = flags.indexOf(\"=\");\n\n      if (equalIndex !== -1) {\n        // -t=value format\n        const rawKey = flags.slice(0, equalIndex);\n        const key = toCamelCase(rawKey);\n        const value = flags.slice(equalIndex + 1);\n        options[key] = booleanKeys.has(key) ? toBoolean(`-${rawKey}`, value) : value;\n      } else if (flags.length === 1 || multiCharAliases.has(flags)) {\n        // Single flag: -f, or a declared multi-character alias: -st\n        const key = toCamelCase(flags);\n        const nextArg = argv[i + 1];\n\n        if (booleanKeys.has(key)) {\n          options[key] = true;\n        } else if (nextArg && !nextArg.startsWith(\"-\")) {\n          options[key] = nextArg;\n          i++; // Skip next arg\n        } else {\n          options[key] = true;\n        }\n      } else {\n        // Multiple flags: -abc becomes { a: true, b: true, c: true }\n        // A bundle carries no value and never consumes the next token, so a\n        // declared boolean already resolves to `true` here.\n        for (const flag of flags) {\n          options[toCamelCase(flag)] = true;\n        }\n      }\n    } else {\n      // Positional argument\n      args.push(arg);\n    }\n  }\n\n  return { name: command, args, options };\n}\n"],"mappings":"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"}
+{"version":3,"file":"parse-cli-args.mjs","names":[],"sources":["../../../../../../../../packages/core/src/cli/parse-cli-args.ts"],"sourcesContent":["import { toCamelCase } from \"@mongez/reinforcements\";\n\nexport type ParsedCliArgs = {\n  name: string;\n  args: string[];\n  options: Record<string, string | boolean>;\n};\n\n/**\n * The slice of a declared command option this parser needs.\n *\n * `CLICommand.commandOptions` (`ResolvedCLICommandOption[]`) satisfies it, but\n * the parser stays independent of the command classes so it can be unit-tested\n * and reused with a hand-written schema.\n */\nexport type CliOptionSchema = {\n  name?: string;\n  alias?: string;\n  type?: \"string\" | \"boolean\" | \"number\";\n};\n\n/**\n * Thrown when a declared boolean option is given a value that is neither\n * true-ish nor false-ish.\n *\n * We refuse to guess. Guessing is exactly what produced #21: `--rollback=false`\n * was kept as the truthy string `\"false\"` and dropped every table. An option\n * that gates a destructive action must fail loudly on input it cannot read.\n */\nexport class CliOptionValueError extends Error {\n  /** Stable Warlock error code; `warlock explain WL7001` prints the fix. */\n  public readonly code = \"WL7001\";\n\n  public constructor(\n    public readonly optionToken: string,\n    public readonly value: string,\n  ) {\n    super(\n      `Invalid value ${JSON.stringify(value)} for boolean option ${optionToken}. ` +\n        `Expected one of: true, false, 1, 0, yes, no — or pass ${optionToken} on its own for true.`,\n    );\n\n    this.name = \"CliOptionValueError\";\n  }\n}\n\nconst TRUE_VALUES = new Set([\"true\", \"1\", \"yes\"]);\nconst FALSE_VALUES = new Set([\"false\", \"0\", \"no\"]);\n\n/**\n * Collect the camelCased keys (names AND aliases) of every option the command\n * declared as `type: \"boolean\"`.\n *\n * Both sides are camelCased because declared names keep their raw kebab form\n * (`\"pending-only\"`) while the parser emits camelCase keys (`pendingOnly`).\n */\nfunction collectBooleanKeys(schema: CliOptionSchema[]): Set<string> {\n  const keys = new Set<string>();\n\n  for (const option of schema) {\n    if (option.type !== \"boolean\") continue;\n\n    if (option.name) {\n      keys.add(toCamelCase(option.name));\n    }\n\n    if (option.alias) {\n      keys.add(toCamelCase(option.alias));\n    }\n  }\n\n  return keys;\n}\n\n/**\n * Collect the declared aliases longer than one character (`-st`, `-rs`, `-pm`).\n *\n * A cluster equal to one of these is that alias, not a bundle of single-letter\n * flags, so it has to be matched before the bundle split.\n */\nfunction collectMultiCharAliases(schema: CliOptionSchema[]): Set<string> {\n  const aliases = new Set<string>();\n\n  for (const option of schema) {\n    if (option.alias && option.alias.length > 1) {\n      aliases.add(option.alias);\n    }\n  }\n\n  return aliases;\n}\n\n/**\n * Turn the value written after `=` into a real boolean, or throw.\n */\nfunction toBoolean(optionToken: string, value: string): boolean {\n  const normalized = value.toLowerCase();\n\n  if (TRUE_VALUES.has(normalized)) return true;\n  if (FALSE_VALUES.has(normalized)) return false;\n\n  throw new CliOptionValueError(optionToken, value);\n}\n\n/**\n * Parse CLI arguments from process.argv\n *\n * Called with a `schema` (the resolved command's declared options), every\n * option declared `type: \"boolean\"` is resolved as a boolean:\n * `--flag` → true, `--flag=false|0|no` → false, `--flag=true|1|yes` → true,\n * and `--flag <token>` leaves `<token>` as a POSITIONAL instead of swallowing\n * it as the flag's value. Anything else throws {@link CliOptionValueError}.\n *\n * Called without a schema — which is how the command name is discovered,\n * before any command object exists — behaviour is unchanged: every value stays\n * a raw string and a bare `--flag` still consumes the following non-dash token.\n * Nothing is blanket-coerced here on purpose: `--name=false` on a string-typed\n * option must survive as the string `\"false\"`.\n *\n * Options the schema does not declare keep the schema-less behaviour.\n *\n * @example\n * parseCliArgs([\"node\", \"warlock\", \"migrate\", \"--rollback\", \"file.ts\"])\n * // Returns: { name: \"migrate\", args: [], options: { rollback: \"file.ts\" } }\n *\n * @example\n * // `rollback` declared as type: \"boolean\" — the file stays a positional\n * parseCliArgs([\"node\", \"warlock\", \"migrate\", \"--rollback\", \"file.ts\"], migrateOptions)\n * // Returns: { name: \"migrate\", args: [\"file.ts\"], options: { rollback: true } }\n *\n * @example\n * parseCliArgs([\"node\", \"warlock\", \"dev\", \"--port=3000\", \"--fresh\"])\n * // Returns: { name: \"dev\", args: [], options: { port: \"3000\", fresh: true } }\n */\nexport function parseCliArgs(argv: string[], schema: CliOptionSchema[] = []): ParsedCliArgs {\n  // Command is at index 2 (after \"node\" and script path)\n  // But if index 2 starts with \"-\", it's an option, not a command\n  const potentialCommand = argv[2] || \"\";\n  const isFirstArgOption = potentialCommand.startsWith(\"-\");\n  const command = isFirstArgOption ? \"\" : potentialCommand;\n  const args: string[] = [];\n  const options: Record<string, string | boolean> = {};\n  const booleanKeys = collectBooleanKeys(schema);\n  const multiCharAliases = collectMultiCharAliases(schema);\n\n  // Parse arguments starting from index 3 (or 2 if first arg was an option)\n  const startIndex = isFirstArgOption ? 2 : 3;\n  for (let i = startIndex; i < argv.length; i++) {\n    const arg = argv[i];\n\n    // `i < argv.length` bounds this, but the compiler does not narrow an index\n    // read from a loop condition. Skipping rather than coercing: this file\n    // already refuses to guess about an operator's input (see\n    // `CliOptionValueError` above), and an `?? \"\"` here would silently push an\n    // empty POSITIONAL onto `args` — which for a command that takes a file or\n    // a table name is a scope the operator never typed.\n    if (arg === undefined) continue;\n\n    if (arg.startsWith(\"--\")) {\n      // Long option: --key or --key=value\n      const withoutDashes = arg.slice(2);\n      const equalIndex = withoutDashes.indexOf(\"=\");\n\n      if (equalIndex !== -1) {\n        // --key=value format\n        const key = toCamelCase(withoutDashes.slice(0, equalIndex));\n        const value = withoutDashes.slice(equalIndex + 1);\n        options[key] = booleanKeys.has(key)\n          ? toBoolean(`--${withoutDashes.slice(0, equalIndex)}`, value)\n          : value;\n      } else {\n        // --key format (check if next arg is a value)\n        const key = toCamelCase(withoutDashes);\n        const nextArg = argv[i + 1];\n\n        // A declared boolean NEVER consumes the next token: `--rollback\n        // users.ts` means \"rollback, and here is a positional\", not \"rollback\n        // the file users.ts\". Swallowing it silently discarded the operator's\n        // only stated scope and rolled back everything.\n        if (booleanKeys.has(key)) {\n          options[key] = true;\n        } else if (nextArg && !nextArg.startsWith(\"-\")) {\n          // If next arg exists and doesn't start with -, treat it as value\n          options[key] = nextArg;\n          i++; // Skip next arg\n        } else {\n          options[key] = true;\n        }\n      }\n    } else if (arg.startsWith(\"-\") && arg.length > 1) {\n      // Short option: -f, -t=value, or -abc (multiple flags)\n      const flags = arg.slice(1);\n      const equalIndex = flags.indexOf(\"=\");\n\n      if (equalIndex !== -1) {\n        // -t=value format\n        const rawKey = flags.slice(0, equalIndex);\n        const key = toCamelCase(rawKey);\n        const value = flags.slice(equalIndex + 1);\n        options[key] = booleanKeys.has(key) ? toBoolean(`-${rawKey}`, value) : value;\n      } else if (flags.length === 1 || multiCharAliases.has(flags)) {\n        // Single flag: -f, or a declared multi-character alias: -st\n        const key = toCamelCase(flags);\n        const nextArg = argv[i + 1];\n\n        if (booleanKeys.has(key)) {\n          options[key] = true;\n        } else if (nextArg && !nextArg.startsWith(\"-\")) {\n          options[key] = nextArg;\n          i++; // Skip next arg\n        } else {\n          options[key] = true;\n        }\n      } else {\n        // Multiple flags: -abc becomes { a: true, b: true, c: true }\n        // A bundle carries no value and never consumes the next token, so a\n        // declared boolean already resolves to `true` here.\n        for (const flag of flags) {\n          options[toCamelCase(flag)] = true;\n        }\n      }\n    } else {\n      // Positional argument\n      args.push(arg);\n    }\n  }\n\n  return { name: command, args, options };\n}\n"],"mappings":"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"}

package/esm/cli/start.d.mts

@@ -1 +1 @@
-export { };
+export {}

package/esm/cli/string-similarity.mjs

@@ -61,5 +61,5 @@ function findSimilar(input, candidates, maxDistance = 3, maxResults = 3) {
 }
 
 //#endregion
-export { findSimilar };
+export { findSimilar, levenshteinDistance };
 //# sourceMappingURL=string-similarity.mjs.map

package/esm/commands/cli-command.d.mts

@@ -1,7 +1,6 @@
 import { CLICommandAction, CLICommandOption, CLICommandOptions, CLICommandPreload, CLICommandSource, CommandActionData, ResolvedCLICommandOption } from "./types.mjs";
-
 //#region ../../packages/core/src/commands/cli-command.d.ts
-declare class CLICommand {
+export declare class CLICommand {
   name: string;
   /**
    * Command source
@@ -113,7 +112,6 @@ declare class CLICommand {
    */
   execute(data: CommandActionData): Promise<void>;
 }
-declare function command(options: CLICommandOptions): CLICommand;
+export declare function command(options: CLICommandOptions): CLICommand;
 //#endregion
-export { CLICommand, command };
 //# sourceMappingURL=cli-command.d.mts.map

package/esm/commands/cli-command.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-command.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/commands/cli-command.ts"],"mappings":";;;cAWa,UAAA;EAqDF,IAAA;EArDE;;;EAIJ,aAAA,GAAgB,gBAAA;EAKA;;;EAAhB,aAAA,GAAgB,gBAAA;EAyDD;;;;EAnDf,gBAAA,GAAmB,gBAAA;EA0HT;;;EArHV,cAAA,GAAiB,iBAAA;EAqOA;;;EAhOjB,kBAAA;EAwOqC;;;EAnOrC,cAAA,EAAgB,wBAAA;EArBhB;;;;;EA4BA,mBAAA;EAZA;;;EAiBA,YAAA;EAAA;;;EAKA,YAAA;EAOL;;;cADO,IAAA,UACP,WAAA;EAoBK;;;EARA,MAAA,CAAO,MAAA,EAAQ,gBAAA;EAyBf;;;EAjBA,WAAA,CAAY,WAAA;EAyBL;;;EAjBP,UAAA,CAAW,YAAA;EAkCX;;;;EAzBA,KAAA,CAAM,KAAA;EA0CN;;;EAlCA,MAAA,CAAO,MAAA,EAAQ,gBAAA;EAoCpB;;;;EA3BK,SAAA,CAAU,MAAA,EAAQ,gBAAA;EA8Df;;;EAtDH,OAAA,CAAQ,OAAA,EAAS,gBAAA;EA+GhB;;;EAtGD,aAAA,CAAc,YAAA;EAoIR;;;EA5HN,MAAA,CAAO,MAAA,EAAQ,gBAAA;EACf,MAAA,CACL,IAAA,UACA,WAAA,WACA,OAAA,GAAU,IAAA,CAAK,gBAAA;EAwH2B;AAS9C;;;;;;;;EAT8C,UAvFlC,WAAA,CAAY,MAAA,EAAQ,gBAAA,GAAmB,wBAAA;;;;;;;;;UAyDzC,iBAAA;;;;EAsBD,OAAA,CAAQ,OAAA,EAAS,iBAAA;;;;EAQX,OAAA,CAAQ,IAAA,EAAM,iBAAA,GAAiB,OAAA;AAAA;AAAA,iBAS9B,OAAA,CAAQ,OAAA,EAAS,iBAAA,GAAiB,UAAA"}
+{"version":3,"file":"cli-command.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/commands/cli-command.ts"],"mappings":";;qBAWa;EAqDF;;;;EAjDF,gBAAgB;;;;EAKhB,gBAAgB;;;;;EAMhB,mBAAmB;;;;EAKnB,iBAAiB;;;;EAKjB;;;;EAKA,gBAAgB;;;;;;EAOhB;;;;EAKA;;;;EAKA;;;;EAKP,YACS,cACP;;;;EAYK,OAAO,QAAQ;;;;EAQf,YAAY;;;;EAQZ,WAAW;;;;;EASX,MAAM;;;;EAQN,OAAO,QAAQ;;;;;EASf,UAAU,QAAQ;;;;EAQlB,QAAQ,SAAS;;;;EASjB,cAAc;;;;EAQd,OAAO,QAAQ;EACf,OACL,cACA,sBACA,UAAU,KAAK;;;;;;;;;;YAiCP,YAAY,QAAQ,mBAAmB;;;;;;;;;UAyDzC;;;;EAsBD,QAAQ,SAAS;;;;EAQX,QAAQ,MAAM,oBAAiB;;wBAS9B,QAAQ,SAAS,oBAAiB"}

package/esm/commands/index.d.mts

@@ -1,2 +1,3 @@
 import { CLICommandAction, CLICommandOption, CLICommandOptions, CLICommandPreload, CLICommandSource, CommandActionData, ResolvedCLICommandOption } from "./types.mjs";
-import { CLICommand, command } from "./cli-command.mjs";
+import { CLICommand, command } from "./cli-command.mjs";
+export { CLICommand, type CLICommandAction, type CLICommandOption, type CLICommandOptions, type CLICommandPreload, type CLICommandSource, type CommandActionData, type ResolvedCLICommandOption, command };

package/esm/commands/index.mjs

@@ -1,3 +1,3 @@
 import { CLICommand, command } from "./cli-command.mjs";
 
-export {  };
+export { CLICommand, command };

package/esm/commands/types.d.mts

@@ -1,5 +1,6 @@
 import { RuntimeStrategy } from "../utils/environment.mjs";
 import { ConnectorName } from "../connectors/types.mjs";
+import "../connectors/index.mjs";
 //#region ../../packages/core/src/commands/types.d.ts
 /**
  * Indicates the origin/source of a CLI command.
@@ -8,7 +9,7 @@ import { ConnectorName } from "../connectors/types.mjs";
  * - `"plugin"` - Commands from installed Warlock.js plugins
  * - `"project"` - Custom commands defined in the project's source code
  */
-type CLICommandSource = "framework" | "plugin" | "project";
+export type CLICommandSource = "framework" | "plugin" | "project";
 /**
  * Data passed to command action and preAction functions.
  *
@@ -19,7 +20,7 @@ type CLICommandSource = "framework" | "plugin" | "project";
  *   options: { fresh: true, limit: "10" }
  * }
  */
-type CommandActionData = {
+export type CommandActionData = {
   /**
    * Positional arguments passed after the command name.
    * @example `warlock migrate users posts` → args: ["users", "posts"]
@@ -51,7 +52,7 @@ type CommandActionData = {
  *   connectors: true
  * }
  */
-type CLICommandPreload = {
+export type CLICommandPreload = {
   /**
    * Configuration files to load.
    * - `true` - Load all config files
@@ -119,7 +120,7 @@ type CLICommandPreload = {
  *   required: false
  * }
  */
-type CLICommandOption = {
+export type CLICommandOption = {
   /**
    * The raw option text as it appears in help output.
    * Supports formats: `"--port"`, `"-p"`, `"--port, -p"`, `"-p, --port"`
@@ -154,7 +155,7 @@ type CLICommandOption = {
    */
   required?: boolean;
 };
-type ResolvedCLICommandOption = Omit<CLICommandOption, "alias" | "name"> & {
+export type ResolvedCLICommandOption = Omit<CLICommandOption, "alias" | "name"> & {
   name: string;
   alias: string;
 };
@@ -162,7 +163,7 @@ type ResolvedCLICommandOption = Omit<CLICommandOption, "alias" | "name"> & {
  * Command action function signature.
  * Receives parsed CLI data and can be sync or async.
  */
-type CLICommandAction = (data: CommandActionData) => void | Promise<void>;
+export type CLICommandAction = (data: CommandActionData) => void | Promise<void>;
 /**
  * Configuration object for creating a CLI command using the `command()` factory.
  *
@@ -183,7 +184,7 @@ type CLICommandAction = (data: CommandActionData) => void | Promise<void>;
  *   }
  * })
  */
-type CLICommandOptions = {
+export type CLICommandOptions = {
   /**
    * The command name. Use dot notation for namespaced commands.
    * @example "migrate", "db.seed", "jwt.generate"
@@ -226,5 +227,4 @@ type CLICommandOptions = {
   options?: CLICommandOption[];
 };
 //#endregion
-export { CLICommandAction, CLICommandOption, CLICommandOptions, CLICommandPreload, CLICommandSource, CommandActionData, ResolvedCLICommandOption };
 //# sourceMappingURL=types.d.mts.map

package/esm/commands/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/commands/types.ts"],"mappings":";;;;;AAgB4B;AAY5B;;;;KAZY,gBAAA;;;;AAwBK;AAsBjB;;;;;;KAlCY,iBAAA;EAuDV;;;;EAlDA,IAAA;EAyFA;;;AAA0B;AAgB5B;EAlGE,OAAA,EAAS,MAAM;AAAA;;;;;;;;;;AAyIP;AAGV;;;;;;;;;KAtHY,iBAAA;EA+HA;;;;;EAzHV,MAAA;EAyHiE;;AAAO;EApHxE,QAAA;EA0I2B;;;EArI3B,aAAA;EA8KQ;;;EAzKR,eAAA,GAAkB,eAAA;EAqIlB;;;;;;;;;;;EAxHA,WAAA;EAkK0B;AAAA;;;;;;;;EAvJ1B,GAAA;;;;;EAMA,SAAA;;;;;;;;EASA,UAAA,GAAa,aAAa;AAAA;;;;;;;;;;;;;;KAgBhB,gBAAA;;;;;EAKV,IAAA;;;;;EAMA,IAAA;;;;;EAMA,KAAA;;;;EAKA,WAAA;;;;;EAMA,IAAA;;;;EAKA,YAAA;;;;;EAMA,QAAA;AAAA;AAAA,KAGU,wBAAA,GAA2B,IAAI,CAAC,gBAAA;EAC1C,IAAA;EACA,KAAA;AAAA;;;;;KAOU,gBAAA,IAAoB,IAAA,EAAM,iBAAA,YAA6B,OAAO;;;;;;;;;;;;;;;;;;;;;KAsB9D,iBAAA;;;;;EAKV,IAAA;;;;;EAMA,KAAA;;;;EAKA,WAAA;;;;;EAMA,OAAA,GAAU,iBAAA;;;;;;EAOV,UAAA;;;;;EAMA,SAAA,GAAY,gBAAA;;;;;EAMZ,MAAA,EAAQ,gBAAA;;;;;EAMR,OAAA,GAAU,gBAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/commands/types.ts"],"mappings":";;;;;;;;;;;YAgBY;;;;;;;;;;;YAYA;;;;;EAKV;;;;;;EAOA,SAAS;;;;;;;;;;;;;;;;;;;;;YAsBC;;;;;;EAMV;;;;EAKA;;;;EAKA;;;;EAKA,kBAAkB;;;;;;;;;;;;EAalB;;;;;;;;;;EAWA;;;;;EAMA;;;;;;;;EASA,aAAa;;;;;;;;;;;;;;;YAgBH;;;;;EAKV;;;;;EAMA;;;;;EAMA;;;;EAKA;;;;;EAMA;;;;EAKA;;;;;EAMA;;YAGU,2BAA2B,KAAK;EAC1C;EACA;;;;;;YAOU,oBAAoB,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;YAsBvD;;;;;EAKV;;;;;EAMA;;;;EAKA;;;;;EAMA,UAAU;;;;;;EAOV;;;;;EAMA,YAAY;;;;;EAMZ,QAAQ;;;;;EAMR,UAAU"}

package/esm/config/config-getter.d.mts

@@ -1,5 +1,4 @@
 import { ConfigKey, ConfigRegistry } from "./types.mjs";
-
 //#region ../../packages/core/src/config/config-getter.d.ts
 /**
  * Config accessor interface with typed overloads
@@ -32,7 +31,7 @@ interface ConfigAccessor {
  * const port = config.key<number>("database.port", 27017);
  * ```
  */
-declare const config: ConfigAccessor;
+export declare const config: ConfigAccessor;
 //#endregion
-export { config };
+export {};
 //# sourceMappingURL=config-getter.d.mts.map

package/esm/config/config-getter.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config-getter.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/config/config-getter.ts"],"mappings":";;;;;AACyD;UAK/C,cAAA;EAAc;;;EAItB,GAAA,UAAa,GAAA,EAAK,SAAA,kBAA2B,YAAA,GAAe,CAAA,GAAI,CAAA;EAM5C;;;;EAApB,GAAA,iBAAoB,cAAA,EAAgB,IAAA,EAAM,CAAA,EAAG,YAAA,GAAe,cAAA,CAAe,CAAA,IAAK,cAAA,CAAe,CAAA;EAAA;;;EAK/F,GAAA,UAAa,IAAA,UAAc,YAAA,GAAe,CAAA,GAAI,CAAA;AAAA;;;;;;;;;;;;;;cAgBnC,MAAA,EAAQ,cAQpB"}
+{"version":3,"file":"config-getter.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/config/config-getter.ts"],"mappings":";;;;;UAMU;;;;EAIR,IAAI,SAAS,KAAK,2BAA2B,eAAe,IAAI;;;;;EAMhE,IAAI,gBAAgB,gBAAgB,MAAM,GAAG,eAAe,eAAe,KAAK,eAAe;;;;EAK/F,IAAI,SAAS,cAAc,eAAe,IAAI;;;;;;;;;;;;;;;qBAgBnC,QAAQ"}

package/esm/config/config-getter.mjs

@@ -1,4 +1,4 @@
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 
 //#region ../../packages/core/src/config/config-getter.ts
 /**
@@ -14,15 +14,15 @@ import config from "@mongez/config";
 * const port = config.key<number>("database.port", 27017);
 * ```
 */
-const config$1 = {
+const config = {
 	key(key, defaultValue) {
-		return config.get(key, defaultValue);
+		return baseConfig.get(key, defaultValue);
 	},
 	get(name, defaultValue) {
-		return config.get(name, defaultValue);
+		return baseConfig.get(name, defaultValue);
 	}
 };
 
 //#endregion
-export { config$1 as config };
+export { config };
 //# sourceMappingURL=config-getter.mjs.map

package/esm/config/config-getter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config-getter.mjs","names":["config","baseConfig"],"sources":["../../../../../../../../packages/core/src/config/config-getter.ts"],"sourcesContent":["import baseConfig from \"@mongez/config\";\nimport type { ConfigKey, ConfigRegistry } from \"./types\";\n\n/**\n * Config accessor interface with typed overloads\n */\ninterface ConfigAccessor {\n  /**\n   * Get a config value by dot-notation key path.\n   */\n  key<T = any>(key: ConfigKey | (string & {}), defaultValue?: T): T;\n\n  /**\n   * Get an entire config group by name with type inference.\n   * Returns the typed config object for known config names.\n   */\n  get<K extends keyof ConfigRegistry>(name: K, defaultValue?: ConfigRegistry[K]): ConfigRegistry[K];\n\n  /**\n   * Get an entire config group by name (dynamic string).\n   */\n  get<T = any>(name: string, defaultValue?: T): T;\n}\n\n/**\n * Config accessor with typed autocomplete and return type inference.\n *\n * @example\n * ```typescript\n * // Get entire config group - returns the actual config type\n * const db = config.get(\"database\"); // → DatabaseConfigurations\n *\n * // Get specific key with dot notation\n * const host = config.key(\"database.host\");\n * const port = config.key<number>(\"database.port\", 27017);\n * ```\n */\nexport const config: ConfigAccessor = {\n  key(key: ConfigKey | (string & {}), defaultValue?: any): any {\n    return baseConfig.get(key, defaultValue);\n  },\n\n  get(name: string, defaultValue?: any): any {\n    return baseConfig.get(name, defaultValue);\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAqCA,MAAaA,WAAyB;CACpC,IAAI,KAAgC,cAAyB;EAC3D,OAAOC,OAAW,IAAI,KAAK,YAAY;CACzC;CAEA,IAAI,MAAc,cAAyB;EACzC,OAAOA,OAAW,IAAI,MAAM,YAAY;CAC1C;AACF"}
+{"version":3,"file":"config-getter.mjs","names":[],"sources":["../../../../../../../../packages/core/src/config/config-getter.ts"],"sourcesContent":["import baseConfig from \"@mongez/config\";\nimport type { ConfigKey, ConfigRegistry } from \"./types\";\n\n/**\n * Config accessor interface with typed overloads\n */\ninterface ConfigAccessor {\n  /**\n   * Get a config value by dot-notation key path.\n   */\n  key<T = any>(key: ConfigKey | (string & {}), defaultValue?: T): T;\n\n  /**\n   * Get an entire config group by name with type inference.\n   * Returns the typed config object for known config names.\n   */\n  get<K extends keyof ConfigRegistry>(name: K, defaultValue?: ConfigRegistry[K]): ConfigRegistry[K];\n\n  /**\n   * Get an entire config group by name (dynamic string).\n   */\n  get<T = any>(name: string, defaultValue?: T): T;\n}\n\n/**\n * Config accessor with typed autocomplete and return type inference.\n *\n * @example\n * ```typescript\n * // Get entire config group - returns the actual config type\n * const db = config.get(\"database\"); // → DatabaseConfigurations\n *\n * // Get specific key with dot notation\n * const host = config.key(\"database.host\");\n * const port = config.key<number>(\"database.port\", 27017);\n * ```\n */\nexport const config: ConfigAccessor = {\n  key(key: ConfigKey | (string & {}), defaultValue?: any): any {\n    return baseConfig.get(key, defaultValue);\n  },\n\n  get(name: string, defaultValue?: any): any {\n    return baseConfig.get(name, defaultValue);\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;AAqCA,MAAa,SAAyB;CACpC,IAAI,KAAgC,cAAyB;EAC3D,OAAO,WAAW,IAAI,KAAK,YAAY;CACzC;CAEA,IAAI,MAAc,cAAyB;EACzC,OAAO,WAAW,IAAI,MAAM,YAAY;CAC1C;AACF"}

package/esm/config/config-handlers.d.mts

@@ -1,10 +1,8 @@
 import { AppConfigurations } from "../utils/types.mjs";
-
 //#region ../../packages/core/src/config/config-handlers.d.ts
 /**
  * Enforce request-locale configuration when app config loads.
  */
-declare const registerAppConfig: (config: AppConfigurations) => Promise<void>;
+export declare const registerAppConfig: (config: AppConfigurations) => Promise<void>;
 //#endregion
-export { registerAppConfig };
 //# sourceMappingURL=config-handlers.d.mts.map

package/esm/config/config-handlers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config-handlers.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/config/config-handlers.ts"],"mappings":";;;;;AAOA;cAAa,iBAAA,GAA2B,MAAA,EAAQ,iBAAA,KAAoB,OAAO"}
+{"version":3,"file":"config-handlers.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/config/config-handlers.ts"],"mappings":";;;;;qBAOa,oBAAiB,QAAkB,sBAAoB"}

package/esm/config/config-loader.d.mts

@@ -3,7 +3,6 @@
  * Special Config Handler
  * A function that handles special configuration loading
  */
-type SpecialConfigHandler = (configValue: any) => unknown | Promise<unknown>;
+export type SpecialConfigHandler = (configValue: any) => unknown | Promise<unknown>;
 //#endregion
-export { SpecialConfigHandler };
 //# sourceMappingURL=config-loader.d.mts.map

package/esm/config/config-loader.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config-loader.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/config/config-loader.ts"],"mappings":";AAgBA;;;;AAAA,KAAY,oBAAA,IAAwB,WAAA,oBAA+B,OAAO"}
+{"version":3,"file":"config-loader.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/config/config-loader.ts"],"mappings":";;;;;YAiBY,wBAAwB,+BAA+B"}

package/esm/config/config-loader.mjs

@@ -1,9 +1,10 @@
 import { configSpecialHandlers } from "./config-special-handlers.mjs";
+import { InvalidConfigError, validateConfigValue } from "./config-schema.mjs";
 import { importAppModule } from "../loader/app-module-importer.mjs";
 import { configKeyFromPath } from "./config-key-from-path.mjs";
-import config from "@mongez/config";
-import { colors } from "@mongez/copper";
+import baseConfig from "@mongez/config";
 import { pathToFileURL } from "node:url";
+import { colors } from "@mongez/copper";
 
 //#region ../../packages/core/src/config/config-loader.ts
 /**
@@ -12,8 +13,16 @@ import { pathToFileURL } from "node:url";
 * Supports special handlers for configs that require additional processing
 */
 var ConfigLoader = class {
+	/**
+	* Load every config file, then throw one {@link InvalidConfigError} listing
+	* every value that fails its file's `configSchema`. An invalid config is
+	* still registered (later files may read it while loading) but its special
+	* handler does not run, so nothing connects with a broken configuration.
+	*/
 	async loadAll(configFiles) {
-		for (const file of configFiles) await this.loadConfig(file);
+		const issues = [];
+		for (const file of configFiles) issues.push(...await this.loadConfigFile(file, "register-invalid"));
+		if (issues.length > 0) throw new InvalidConfigError(issues);
 	}
 	/**
 	* Load a single configuration file.
@@ -22,19 +31,31 @@ var ConfigLoader = class {
 	* cycle gets a fresh module — no manual cache-busting needed here.
 	*/
 	async loadConfig(file) {
+		const issues = await this.loadConfigFile(file, "keep-previous");
+		if (issues.length > 0) throw new InvalidConfigError(issues);
+	}
+	/**
+	* Import, validate and register one config file. Returns the schema issues.
+	* On a hot reload (`keep-previous`) an invalid value is not registered, so
+	* the running app keeps its last valid configuration.
+	*/
+	async loadConfigFile(file, whenInvalid) {
 		const configName = this.getConfigName(file.relativePath);
-		try {
-			const fileUrl = pathToFileURL(file.absolutePath).href;
-			const configValue = (await importAppModule(fileUrl)).default;
-			if (configValue === void 0) {
-				console.log(colors.red(`config error: `), `Config file ${colors.yellow(file.relativePath)} does not have a default export`);
-				return;
-			}
-			config.set(configName, configValue);
-			await configSpecialHandlers.execute(configName, configValue);
-		} catch (error) {
-			throw error;
+		const fileUrl = pathToFileURL(file.absolutePath).href;
+		const configModule = await importAppModule(fileUrl);
+		const configValue = configModule.default;
+		if (configValue === void 0) {
+			console.log(colors.red(`config error: `), `Config file ${colors.yellow(file.relativePath)} does not have a default export`);
+			return [];
+		}
+		const issues = await validateConfigValue(configName, configValue, configModule.configSchema);
+		if (issues.length > 0) {
+			if (whenInvalid === "register-invalid") baseConfig.set(configName, configValue);
+			return issues;
 		}
+		baseConfig.set(configName, configValue);
+		await configSpecialHandlers.execute(configName, configValue);
+		return [];
 	}
 	async reloadConfig(file) {
 		await this.loadConfig(file);

package/esm/config/config-loader.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config-loader.mjs","names":[],"sources":["../../../../../../../../packages/core/src/config/config-loader.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { colors } from \"@mongez/copper\";\nimport { pathToFileURL } from \"node:url\";\nimport type { FileManager } from \"../dev-server/file-manager\";\nimport { importAppModule } from \"../loader/app-module-importer\";\nimport { configKeyFromPath } from \"./config-key-from-path\";\nimport { configSpecialHandlers } from \"./config-special-handlers\";\n\n/**\n * Special Config Handler\n * A function that handles special configuration loading\n */\n// Returns unknown, not void: ConfigSpecialHandlers.execute() RETURNS handler(config)\n// rather than discarding it, and a test pins that (\"returns the handler's resolved\n// value\"). The implementation and the test agreed; only this type said handlers\n// produce nothing, which made any value-returning handler fail to typecheck.\nexport type SpecialConfigHandler = (configValue: any) => unknown | Promise<unknown>;\n\n/**\n * Config Loader\n * Dynamically loads all configuration files and registers them with @mongez/config\n * Supports special handlers for configs that require additional processing\n */\nexport class ConfigLoader {\n  public async loadAll(configFiles: FileManager[]): Promise<void> {\n    for (const file of configFiles) {\n      await this.loadConfig(file);\n    }\n  }\n\n  /**\n   * Load a single configuration file.\n   *\n   * The ESM loader hook stamps a version token onto the URL so that each HMR\n   * cycle gets a fresh module — no manual cache-busting needed here.\n   */\n  public async loadConfig(file: FileManager): Promise<void> {\n    const configName = this.getConfigName(file.relativePath);\n\n    try {\n      const fileUrl = pathToFileURL(file.absolutePath).href;\n      const configModule = await importAppModule(fileUrl);\n      const configValue = configModule.default;\n\n      if (configValue === undefined) {\n        console.log(\n          colors.red(`config error: `),\n          `Config file ${colors.yellow(file.relativePath)} does not have a default export`,\n        );\n        return;\n      }\n\n      config.set(configName, configValue);\n      await configSpecialHandlers.execute(configName, configValue);\n    } catch (error) {\n      throw error;\n    }\n  }\n\n  public async reloadConfig(file: FileManager): Promise<void> {\n    await this.loadConfig(file);\n  }\n\n  private getConfigName(relativePath: string): string {\n    const configName = configKeyFromPath(relativePath);\n\n    if (!configName) {\n      throw new Error(`Invalid config file path: ${relativePath}`);\n    }\n\n    return configName;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAuBA,IAAa,eAAb,MAA0B;CACxB,MAAa,QAAQ,aAA2C;EAC9D,KAAK,MAAM,QAAQ,aACjB,MAAM,KAAK,WAAW,IAAI;CAE9B;;;;;;;CAQA,MAAa,WAAW,MAAkC;EACxD,MAAM,aAAa,KAAK,cAAc,KAAK,YAAY;EAEvD,IAAI;GACF,MAAM,UAAU,cAAc,KAAK,YAAY,CAAC,CAAC;GAEjD,MAAM,eAAc,MADO,gBAAgB,OAAO,EAClB,CAAC;GAEjC,IAAI,gBAAgB,QAAW;IAC7B,QAAQ,IACN,OAAO,IAAI,gBAAgB,GAC3B,eAAe,OAAO,OAAO,KAAK,YAAY,EAAE,gCAClD;IACA;GACF;GAEA,OAAO,IAAI,YAAY,WAAW;GAClC,MAAM,sBAAsB,QAAQ,YAAY,WAAW;EAC7D,SAAS,OAAO;GACd,MAAM;EACR;CACF;CAEA,MAAa,aAAa,MAAkC;EAC1D,MAAM,KAAK,WAAW,IAAI;CAC5B;CAEA,AAAQ,cAAc,cAA8B;EAClD,MAAM,aAAa,kBAAkB,YAAY;EAEjD,IAAI,CAAC,YACH,MAAM,IAAI,MAAM,6BAA6B,cAAc;EAG7D,OAAO;CACT;AACF"}
+{"version":3,"file":"config-loader.mjs","names":[],"sources":["../../../../../../../../packages/core/src/config/config-loader.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { colors } from \"@mongez/copper\";\nimport { pathToFileURL } from \"node:url\";\nimport type { FileManager } from \"../dev-server/file-manager\";\nimport { importAppModule } from \"../loader/app-module-importer\";\nimport { configKeyFromPath } from \"./config-key-from-path\";\nimport { type ConfigIssue, InvalidConfigError, validateConfigValue } from \"./config-schema\";\nimport { configSpecialHandlers } from \"./config-special-handlers\";\n\n/**\n * Special Config Handler\n * A function that handles special configuration loading\n */\n// Returns unknown, not void: ConfigSpecialHandlers.execute() RETURNS handler(config)\n// rather than discarding it, and a test pins that (\"returns the handler's resolved\n// value\"). The implementation and the test agreed; only this type said handlers\n// produce nothing, which made any value-returning handler fail to typecheck.\nexport type SpecialConfigHandler = (configValue: any) => unknown | Promise<unknown>;\n\n/**\n * Config Loader\n * Dynamically loads all configuration files and registers them with @mongez/config\n * Supports special handlers for configs that require additional processing\n */\nexport class ConfigLoader {\n  /**\n   * Load every config file, then throw one {@link InvalidConfigError} listing\n   * every value that fails its file's `configSchema`. An invalid config is\n   * still registered (later files may read it while loading) but its special\n   * handler does not run, so nothing connects with a broken configuration.\n   */\n  public async loadAll(configFiles: FileManager[]): Promise<void> {\n    const issues: ConfigIssue[] = [];\n\n    for (const file of configFiles) {\n      issues.push(...(await this.loadConfigFile(file, \"register-invalid\")));\n    }\n\n    if (issues.length > 0) throw new InvalidConfigError(issues);\n  }\n\n  /**\n   * Load a single configuration file.\n   *\n   * The ESM loader hook stamps a version token onto the URL so that each HMR\n   * cycle gets a fresh module — no manual cache-busting needed here.\n   */\n  public async loadConfig(file: FileManager): Promise<void> {\n    const issues = await this.loadConfigFile(file, \"keep-previous\");\n\n    if (issues.length > 0) throw new InvalidConfigError(issues);\n  }\n\n  /**\n   * Import, validate and register one config file. Returns the schema issues.\n   * On a hot reload (`keep-previous`) an invalid value is not registered, so\n   * the running app keeps its last valid configuration.\n   */\n  private async loadConfigFile(\n    file: FileManager,\n    whenInvalid: \"register-invalid\" | \"keep-previous\",\n  ): Promise<ConfigIssue[]> {\n    const configName = this.getConfigName(file.relativePath);\n\n    const fileUrl = pathToFileURL(file.absolutePath).href;\n    const configModule = await importAppModule(fileUrl);\n    const configValue = configModule.default;\n\n    if (configValue === undefined) {\n      console.log(\n        colors.red(`config error: `),\n        `Config file ${colors.yellow(file.relativePath)} does not have a default export`,\n      );\n      return [];\n    }\n\n    const issues = await validateConfigValue(configName, configValue, configModule.configSchema);\n\n    if (issues.length > 0) {\n      if (whenInvalid === \"register-invalid\") config.set(configName, configValue);\n      return issues;\n    }\n\n    config.set(configName, configValue);\n    await configSpecialHandlers.execute(configName, configValue);\n\n    return [];\n  }\n\n  public async reloadConfig(file: FileManager): Promise<void> {\n    await this.loadConfig(file);\n  }\n\n  private getConfigName(relativePath: string): string {\n    const configName = configKeyFromPath(relativePath);\n\n    if (!configName) {\n      throw new Error(`Invalid config file path: ${relativePath}`);\n    }\n\n    return configName;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAwBA,IAAa,eAAb,MAA0B;;;;;;;CAOxB,MAAa,QAAQ,aAA2C;EAC9D,MAAM,SAAwB,CAAC;EAE/B,KAAK,MAAM,QAAQ,aACjB,OAAO,KAAK,GAAI,MAAM,KAAK,eAAe,MAAM,kBAAkB,CAAE;EAGtE,IAAI,OAAO,SAAS,GAAG,MAAM,IAAI,mBAAmB,MAAM;CAC5D;;;;;;;CAQA,MAAa,WAAW,MAAkC;EACxD,MAAM,SAAS,MAAM,KAAK,eAAe,MAAM,eAAe;EAE9D,IAAI,OAAO,SAAS,GAAG,MAAM,IAAI,mBAAmB,MAAM;CAC5D;;;;;;CAOA,MAAc,eACZ,MACA,aACwB;EACxB,MAAM,aAAa,KAAK,cAAc,KAAK,YAAY;EAEvD,MAAM,UAAU,cAAc,KAAK,YAAY,CAAC,CAAC;EACjD,MAAM,eAAe,MAAM,gBAAgB,OAAO;EAClD,MAAM,cAAc,aAAa;EAEjC,IAAI,gBAAgB,QAAW;GAC7B,QAAQ,IACN,OAAO,IAAI,gBAAgB,GAC3B,eAAe,OAAO,OAAO,KAAK,YAAY,EAAE,gCAClD;GACA,OAAO,CAAC;EACV;EAEA,MAAM,SAAS,MAAM,oBAAoB,YAAY,aAAa,aAAa,YAAY;EAE3F,IAAI,OAAO,SAAS,GAAG;GACrB,IAAI,gBAAgB,oBAAoB,WAAO,IAAI,YAAY,WAAW;GAC1E,OAAO;EACT;EAEA,WAAO,IAAI,YAAY,WAAW;EAClC,MAAM,sBAAsB,QAAQ,YAAY,WAAW;EAE3D,OAAO,CAAC;CACV;CAEA,MAAa,aAAa,MAAkC;EAC1D,MAAM,KAAK,WAAW,IAAI;CAC5B;CAEA,AAAQ,cAAc,cAA8B;EAClD,MAAM,aAAa,kBAAkB,YAAY;EAEjD,IAAI,CAAC,YACH,MAAM,IAAI,MAAM,6BAA6B,cAAc;EAG7D,OAAO;CACT;AACF"}

package/esm/config/config-manager.mjs

@@ -24,5 +24,5 @@ var ConfigManager = class {
 const configManager = new ConfigManager();
 
 //#endregion
-export { configManager };
+export { ConfigManager, configManager };
 //# sourceMappingURL=config-manager.mjs.map

package/esm/config/config-schema.d.mts

@@ -0,0 +1,70 @@
+import { BaseValidator, Infer } from "@warlock.js/seal";
+//#region ../../packages/core/src/config/config-schema.d.ts
+declare const CONFIG_SCHEMA_MARKER: unique symbol;
+export type ConfigSchemaOptions = {
+  /**
+   * The environment variable each key is read from, by key path
+   * (`{ host: "MAIL_HOST", "smtp.password": "SMTP_PASSWORD" }`). Named in the
+   * boot error so the fix is obvious.
+   */
+  env?: Readonly<Record<string, string>>;
+};
+/** A config file's schema, as returned by {@link defineConfigSchema}. */
+export type ConfigSchema<TValidator extends BaseValidator = BaseValidator> = {
+  readonly [CONFIG_SCHEMA_MARKER]: true;
+  readonly validator: TValidator;
+  readonly env: Readonly<Record<string, string>>;
+};
+/** The config value a schema describes, for typing the default export. */
+export type ConfigOf<TSchema extends ConfigSchema> = TSchema extends ConfigSchema<infer TValidator> ? Infer.Input<TValidator> : never;
+/** One problem found while validating configuration. */
+export type ConfigIssue = {
+  /** Config name (the file's key, e.g. `mail`). */
+  config: string;
+  /** Key path inside it (`smtp.host`); empty for the config value as a whole. */
+  key: string;
+  /** What is wrong, from the schema's rule. */
+  message: string;
+  /** The environment variable that feeds this key, when the schema names it. */
+  env?: string;
+};
+/**
+ * Declare the schema a config file's default export must satisfy. Export the
+ * result as `configSchema` from the same file.
+ */
+export declare function defineConfigSchema<TValidator extends BaseValidator>(validator: TValidator, options?: ConfigSchemaOptions): ConfigSchema<TValidator>;
+/** Whether a value is a {@link ConfigSchema}. */
+export declare function isConfigSchema(value: unknown): value is ConfigSchema;
+/**
+ * Thrown at boot when one or more config files do not satisfy their
+ * `configSchema`. `issues` lists every problem; the message is ready to print.
+ */
+export declare class InvalidConfigError extends Error {
+  readonly issues: readonly ConfigIssue[];
+  readonly name = "InvalidConfigError";
+  constructor(issues: readonly ConfigIssue[]);
+}
+/** Render issues as the boot error message. */
+export declare function formatConfigIssues(issues: readonly ConfigIssue[]): string;
+/**
+ * Validate one config value against its schema. Returns the issues found (an
+ * empty list when it is valid, or when `schema` is not a config schema).
+ */
+export declare function validateConfigValue(configName: string, value: unknown, schema: unknown): Promise<ConfigIssue[]>;
+/** A loaded config module: its default export and, optionally, its `configSchema`. */
+export type ConfigModuleEntry = {
+  name: string;
+  module: {
+    default?: unknown;
+    configSchema?: unknown;
+  };
+};
+/**
+ * Validate every config module that exports a `configSchema` and throw one
+ * {@link InvalidConfigError} listing all problems. Used by the production
+ * config loader `warlock build` generates.
+ */
+export declare function assertValidConfigModules(entries: readonly ConfigModuleEntry[]): Promise<void>;
+//#endregion
+export {};
+//# sourceMappingURL=config-schema.d.mts.map

package/esm/config/config-schema.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/config/config-schema.ts"],"mappings":";;cAmCM;YAEM;;;;;;EAMV,MAAM,SAAS;;;YAIL,aAAa,mBAAmB,gBAAgB;YAChD;WACD,WAAW;WACX,KAAK,SAAS;;;YAIb,SAAS,gBAAgB,gBACnC,gBAAgB,mBAAmB,cAAc,MAAM,MAAM;;YAGnD;;EAEV;;EAEA;;EAEA;;EAEA;;;;;;wBAOc,mBAAmB,mBAAmB,eACpD,WAAW,YACX,UAAS,sBACR,aAAa;;wBAKA,eAAe,iBAAiB,SAAS;;;;;qBAY5C,2BAA2B;WAGH,iBAAiB;WAF3B;EAEzB,YAAmC,iBAAiB;;;wBAMtC,mBAAmB,iBAAiB;;;;;wBAgB9B,oBACpB,oBACA,gBACA,kBACC,QAAQ;;YAuBC;EACV;EACA;IAAU;IAAmB;;;;;;;;wBAQT,yBACpB,kBAAkB,sBACjB"}