@warlock.js/core 5.19.1 → 5.21.0

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

@@ -1 +1 @@
-{"version":3,"file":"parse-cli-args.mjs","names":[],"sources":["../../../../../../../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 * 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\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) {\n        // Single flag: -f\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":["../../../../../../../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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"}

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

@@ -1 +1 @@
-{"version":3,"file":"cli-command.d.mts","names":[],"sources":["../../../../../../../core/src/commands/cli-command.ts"],"mappings":";;;cAUa,UAAA;EAqDF,IAAA;EArDE;;;EAIJ,aAAA,GAAgB,gBAAA;EAKA;;;EAAhB,aAAA,GAAgB,gBAAA;EAyDD;;;;EAnDf,gBAAA,GAAmB,gBAAA;EA0HT;;;EArHV,cAAA,GAAiB,iBAAA;EAmOA;;;EA9NjB,kBAAA;EAsOqC;;;EAjOrC,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;EA6GhB;;;EApGD,aAAA,CAAc,YAAA;EAkIR;;;EA1HN,MAAA,CAAO,MAAA,EAAQ,gBAAA;EACf,MAAA,CACL,IAAA,UACA,WAAA,WACA,OAAA,GAAU,IAAA,CAAK,gBAAA;EAsH2B;AAS9C;;;;;;;;EAT8C,UArFlC,WAAA,CAAY,MAAA,EAAQ,gBAAA,GAAmB,wBAAA;;;;;;;;;UAuDzC,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":["../../../../../../../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"}

package/esm/commands/cli-command.mjs

@@ -1,3 +1,5 @@
+import { toCamelCase } from "@mongez/reinforcements";
+
 //#region ../core/src/commands/cli-command.ts
 var CLICommand = class {
 	/**
@@ -111,8 +113,8 @@ var CLICommand = class {
 		if (alias === "h" || name === "help") throw new Error("Help option is not allowed, it's reserved for displaying command help");
 		return {
 			...option,
-			name,
-			alias
+			name: toCamelCase(name),
+			alias: alias.includes("-") ? toCamelCase(alias) : alias
 		};
 	}
 	/**

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

@@ -1 +1 @@
-{"version":3,"file":"cli-command.mjs","names":[],"sources":["../../../../../../../core/src/commands/cli-command.ts"],"sourcesContent":["import type {\n  CLICommandAction,\n  CLICommandOption,\n  CLICommandOptions,\n  CLICommandPreload,\n  CLICommandSource,\n  CommandActionData,\n  ResolvedCLICommandOption,\n} from \"./types\";\n\nexport class CLICommand {\n  /**\n   * Command source\n   */\n  public commandSource?: CLICommandSource;\n\n  /**\n   * Command action\n   */\n  public commandAction?: CLICommandAction;\n\n  /**\n   * Command pre action\n   * This will be executed before loading preloaders\n   */\n  public commandPreAction?: CLICommandAction;\n\n  /**\n   *    Command preload\n   */\n  public commandPreload?: CLICommandPreload;\n\n  /**\n   * Command description\n   */\n  public commandDescription?: string;\n\n  /**\n   * Command options\n   */\n  public commandOptions: ResolvedCLICommandOption[] = [];\n\n  /**\n   * Command relative path\n   * Available only for project commands\n   * Auto injected by the framework itself\n   */\n  public commandRelativePath?: string;\n\n  /**\n   * Determine if the command is persistent\n   */\n  public isPersistent: boolean = false;\n\n  /**\n   * Command alias (short name)\n   */\n  public commandAlias?: string;\n\n  /**\n   * Constructor\n   */\n  public constructor(\n    public name: string,\n    description?: string,\n  ) {\n    if (description) {\n      this.commandDescription = description;\n    }\n\n    return this;\n  }\n\n  /**\n   * Add command source\n   */\n  public source(source: CLICommandSource): this {\n    this.commandSource = source;\n    return this;\n  }\n\n  /**\n   * Set command description\n   */\n  public description(description: string): this {\n    this.commandDescription = description;\n    return this;\n  }\n\n  /**\n   * Determine if the command is persistent\n   */\n  public persistent(isPersistent = true): this {\n    this.isPersistent = isPersistent;\n    return this;\n  }\n\n  /**\n   * Set command alias (short name)\n   * @example .alias(\"m\") for \"migrate\"\n   */\n  public alias(alias: string): this {\n    this.commandAlias = alias;\n    return this;\n  }\n\n  /**\n   * Command action\n   */\n  public action(action: CLICommandAction): this {\n    this.commandAction = action;\n    return this;\n  }\n\n  /**\n   * Command pre action\n   * This will be executed before loading preloaders\n   */\n  public preAction(action: CLICommandAction): this {\n    this.commandPreAction = action;\n    return this;\n  }\n\n  /**\n   * Add command options\n   */\n  public options(options: CLICommandOption[]): this {\n    options.map((option) => this.option(option));\n\n    return this;\n  }\n\n  /**\n   * Add command relative path\n   */\n  public $relativePath(relativePath: string) {\n    this.commandRelativePath = relativePath;\n    return this;\n  }\n\n  /**\n   * Add command option\n   */\n  public option(option: CLICommandOption): this;\n  public option(\n    name: string,\n    description?: string,\n    options?: Omit<CLICommandOption, \"name\" | \"text\" | \"description\">,\n  ): this;\n  public option(\n    ...args:\n      | [CLICommandOption]\n      | [string, string?, Omit<CLICommandOption, \"name\" | \"text\" | \"description\">?]\n  ): this {\n    let option: CLICommandOption;\n    if (args.length === 1) {\n      option = args[0] as CLICommandOption;\n    } else {\n      option = {\n        text: args[0],\n        description: args[1],\n        ...args[2],\n        name: \"\",\n      };\n    }\n\n    this.commandOptions.push(this.parseOption(option));\n\n    return this;\n  }\n\n  /**\n   * Parse option name and alias if exists\n   *\n   * Supports formats:\n   * - \"--port, -p\" → name: \"port\", alias: \"p\"\n   * - \"-p, --port\" → name: \"port\", alias: \"p\"\n   * - \"--port\" → name: \"port\", alias: undefined\n   * - \"-p\" → name: \"p\", alias: undefined\n   */\n  protected parseOption(option: CLICommandOption): ResolvedCLICommandOption {\n    const text = option.text.trim();\n\n    // Split by comma to check for alias\n    const parts = text.split(\",\").map((part) => part.trim());\n\n    let name = \"\";\n    let alias = \"\";\n    const firstPart = parts[0];\n\n    if (!firstPart) {\n      throw new Error(\"Command option text cannot be empty\");\n    }\n\n    if (parts.length === 1) {\n      // Single option: \"--port\" or \"-p\"\n      name = this.extractOptionName(firstPart);\n    } else if (parts.length === 2) {\n      // Two options: \"--port, -p\" or \"-p, --port\"\n      const first = firstPart;\n      const second = parts[1];\n\n      if (!second) {\n        throw new Error(\"Command option alias cannot be empty\");\n      }\n\n      // Determine which is the long form (name) and which is short (alias)\n      if (first.startsWith(\"--\")) {\n        name = this.extractOptionName(first);\n        alias = this.extractOptionName(second);\n      } else {\n        name = this.extractOptionName(second);\n        alias = this.extractOptionName(first);\n      }\n    }\n\n    if (alias === \"h\" || name === \"help\") {\n      throw new Error(\"Help option is not allowed, it's reserved for displaying command help\");\n    }\n\n    return {\n      ...option,\n      name,\n      alias,\n    };\n  }\n\n  /**\n   * Extract option name from text (removes -- or -)\n   *\n   * @example\n   * extractOptionName(\"--port\") → \"port\"\n   * extractOptionName(\"-p\") → \"p\"\n   * extractOptionName(\"--port=3000\") → \"port\"\n   */\n  private extractOptionName(text: string): string {\n    // Remove leading dashes\n    let name = text.replace(/^-+/, \"\");\n\n    // Remove value assignment if exists (e.g., \"--port=3000\" → \"port\")\n    const equalIndex = name.indexOf(\"=\");\n    if (equalIndex !== -1) {\n      name = name.slice(0, equalIndex);\n    }\n\n    // Remove angle brackets if exists (e.g., \"--port <number>\" → \"port\")\n    const spaceIndex = name.indexOf(\" \");\n    if (spaceIndex !== -1) {\n      name = name.slice(0, spaceIndex);\n    }\n\n    return name.trim();\n  }\n\n  /**\n   * Command preload\n   */\n  public preload(options: CLICommandPreload) {\n    this.commandPreload = options;\n    return this;\n  }\n\n  /**\n   * Execute the command\n   */\n  public async execute(data: CommandActionData) {\n    if (!this.commandAction) {\n      throw new Error(`Command \"${this.name}\" has no action defined`);\n    }\n\n    await this.commandAction(data);\n  }\n}\n\nexport function command(options: CLICommandOptions) {\n  const commandInstnace = new CLICommand(options.name, options.description);\n\n  if (options.preload) {\n    commandInstnace.preload(options.preload);\n  }\n\n  if (options.persistent) {\n    commandInstnace.persistent(options.persistent);\n  }\n\n  if (options.alias) {\n    commandInstnace.alias(options.alias);\n  }\n\n  commandInstnace.action(options.action);\n\n  if (options.options) {\n    commandInstnace.options(options.options);\n  }\n\n  if (options.preAction) {\n    commandInstnace.preAction(options.preAction);\n  }\n\n  return commandInstnace;\n}\n"],"mappings":"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"}
+{"version":3,"file":"cli-command.mjs","names":[],"sources":["../../../../../../../core/src/commands/cli-command.ts"],"sourcesContent":["import { toCamelCase } from \"@mongez/reinforcements\";\nimport type {\n  CLICommandAction,\n  CLICommandOption,\n  CLICommandOptions,\n  CLICommandPreload,\n  CLICommandSource,\n  CommandActionData,\n  ResolvedCLICommandOption,\n} from \"./types\";\n\nexport class CLICommand {\n  /**\n   * Command source\n   */\n  public commandSource?: CLICommandSource;\n\n  /**\n   * Command action\n   */\n  public commandAction?: CLICommandAction;\n\n  /**\n   * Command pre action\n   * This will be executed before loading preloaders\n   */\n  public commandPreAction?: CLICommandAction;\n\n  /**\n   *    Command preload\n   */\n  public commandPreload?: CLICommandPreload;\n\n  /**\n   * Command description\n   */\n  public commandDescription?: string;\n\n  /**\n   * Command options\n   */\n  public commandOptions: ResolvedCLICommandOption[] = [];\n\n  /**\n   * Command relative path\n   * Available only for project commands\n   * Auto injected by the framework itself\n   */\n  public commandRelativePath?: string;\n\n  /**\n   * Determine if the command is persistent\n   */\n  public isPersistent: boolean = false;\n\n  /**\n   * Command alias (short name)\n   */\n  public commandAlias?: string;\n\n  /**\n   * Constructor\n   */\n  public constructor(\n    public name: string,\n    description?: string,\n  ) {\n    if (description) {\n      this.commandDescription = description;\n    }\n\n    return this;\n  }\n\n  /**\n   * Add command source\n   */\n  public source(source: CLICommandSource): this {\n    this.commandSource = source;\n    return this;\n  }\n\n  /**\n   * Set command description\n   */\n  public description(description: string): this {\n    this.commandDescription = description;\n    return this;\n  }\n\n  /**\n   * Determine if the command is persistent\n   */\n  public persistent(isPersistent = true): this {\n    this.isPersistent = isPersistent;\n    return this;\n  }\n\n  /**\n   * Set command alias (short name)\n   * @example .alias(\"m\") for \"migrate\"\n   */\n  public alias(alias: string): this {\n    this.commandAlias = alias;\n    return this;\n  }\n\n  /**\n   * Command action\n   */\n  public action(action: CLICommandAction): this {\n    this.commandAction = action;\n    return this;\n  }\n\n  /**\n   * Command pre action\n   * This will be executed before loading preloaders\n   */\n  public preAction(action: CLICommandAction): this {\n    this.commandPreAction = action;\n    return this;\n  }\n\n  /**\n   * Add command options\n   */\n  public options(options: CLICommandOption[]): this {\n    options.map((option) => this.option(option));\n\n    return this;\n  }\n\n  /**\n   * Add command relative path\n   */\n  public $relativePath(relativePath: string) {\n    this.commandRelativePath = relativePath;\n    return this;\n  }\n\n  /**\n   * Add command option\n   */\n  public option(option: CLICommandOption): this;\n  public option(\n    name: string,\n    description?: string,\n    options?: Omit<CLICommandOption, \"name\" | \"text\" | \"description\">,\n  ): this;\n  public option(\n    ...args:\n      | [CLICommandOption]\n      | [string, string?, Omit<CLICommandOption, \"name\" | \"text\" | \"description\">?]\n  ): this {\n    let option: CLICommandOption;\n    if (args.length === 1) {\n      option = args[0] as CLICommandOption;\n    } else {\n      option = {\n        text: args[0],\n        description: args[1],\n        ...args[2],\n        name: \"\",\n      };\n    }\n\n    this.commandOptions.push(this.parseOption(option));\n\n    return this;\n  }\n\n  /**\n   * Parse option name and alias if exists\n   *\n   * Supports formats:\n   * - \"--port, -p\" → name: \"port\", alias: \"p\"\n   * - \"-p, --port\" → name: \"port\", alias: \"p\"\n   * - \"--port\" → name: \"port\", alias: undefined\n   * - \"-p\" → name: \"p\", alias: undefined\n   */\n  protected parseOption(option: CLICommandOption): ResolvedCLICommandOption {\n    const text = option.text.trim();\n\n    // Split by comma to check for alias\n    const parts = text.split(\",\").map((part) => part.trim());\n\n    let name = \"\";\n    let alias = \"\";\n    const firstPart = parts[0];\n\n    if (!firstPart) {\n      throw new Error(\"Command option text cannot be empty\");\n    }\n\n    if (parts.length === 1) {\n      // Single option: \"--port\" or \"-p\"\n      name = this.extractOptionName(firstPart);\n    } else if (parts.length === 2) {\n      // Two options: \"--port, -p\" or \"-p, --port\"\n      const first = firstPart;\n      const second = parts[1];\n\n      if (!second) {\n        throw new Error(\"Command option alias cannot be empty\");\n      }\n\n      // Determine which is the long form (name) and which is short (alias)\n      if (first.startsWith(\"--\")) {\n        name = this.extractOptionName(first);\n        alias = this.extractOptionName(second);\n      } else {\n        name = this.extractOptionName(second);\n        alias = this.extractOptionName(first);\n      }\n    }\n\n    if (alias === \"h\" || name === \"help\") {\n      throw new Error(\"Help option is not allowed, it's reserved for displaying command help\");\n    }\n\n    // The parser emits camelCase keys, so the resolved name must match them.\n    return {\n      ...option,\n      name: toCamelCase(name),\n      // Short flags are case-sensitive (`-L` vs `-l`); only kebab aliases fold.\n      alias: alias.includes(\"-\") ? toCamelCase(alias) : alias,\n    };\n  }\n\n  /**\n   * Extract option name from text (removes -- or -)\n   *\n   * @example\n   * extractOptionName(\"--port\") → \"port\"\n   * extractOptionName(\"-p\") → \"p\"\n   * extractOptionName(\"--port=3000\") → \"port\"\n   */\n  private extractOptionName(text: string): string {\n    // Remove leading dashes\n    let name = text.replace(/^-+/, \"\");\n\n    // Remove value assignment if exists (e.g., \"--port=3000\" → \"port\")\n    const equalIndex = name.indexOf(\"=\");\n    if (equalIndex !== -1) {\n      name = name.slice(0, equalIndex);\n    }\n\n    // Remove angle brackets if exists (e.g., \"--port <number>\" → \"port\")\n    const spaceIndex = name.indexOf(\" \");\n    if (spaceIndex !== -1) {\n      name = name.slice(0, spaceIndex);\n    }\n\n    return name.trim();\n  }\n\n  /**\n   * Command preload\n   */\n  public preload(options: CLICommandPreload) {\n    this.commandPreload = options;\n    return this;\n  }\n\n  /**\n   * Execute the command\n   */\n  public async execute(data: CommandActionData) {\n    if (!this.commandAction) {\n      throw new Error(`Command \"${this.name}\" has no action defined`);\n    }\n\n    await this.commandAction(data);\n  }\n}\n\nexport function command(options: CLICommandOptions) {\n  const commandInstnace = new CLICommand(options.name, options.description);\n\n  if (options.preload) {\n    commandInstnace.preload(options.preload);\n  }\n\n  if (options.persistent) {\n    commandInstnace.persistent(options.persistent);\n  }\n\n  if (options.alias) {\n    commandInstnace.alias(options.alias);\n  }\n\n  commandInstnace.action(options.action);\n\n  if (options.options) {\n    commandInstnace.options(options.options);\n  }\n\n  if (options.preAction) {\n    commandInstnace.preAction(options.preAction);\n  }\n\n  return commandInstnace;\n}\n"],"mappings":"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"}

package/esm/commands/index.mjs

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

package/esm/config/config-key-from-path.mjs

@@ -0,0 +1,20 @@
+//#region ../core/src/config/config-key-from-path.ts
+const CONFIG_FILE_PATTERN = /^src\/config\/(.+)\.(ts|tsx)$/;
+/**
+* The key a config file is registered under, from its project-relative path.
+* The single naming rule shared by dev, the production builder and typings:
+* the raw path under `src/config`, extension dropped, nothing case-converted.
+*
+* @example
+* configKeyFromPath("src/config/rate-limit.ts"); // "rate-limit"
+* configKeyFromPath("src/config/mail/smtp.ts"); // "mail/smtp"
+*
+* @returns the key, or `undefined` when the path is not a config file
+*/
+function configKeyFromPath(relativePath) {
+	return CONFIG_FILE_PATTERN.exec(relativePath.replace(/\\/g, "/"))?.[1];
+}
+
+//#endregion
+export { configKeyFromPath };
+//# sourceMappingURL=config-key-from-path.mjs.map

package/esm/config/config-key-from-path.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-key-from-path.mjs","names":[],"sources":["../../../../../../../core/src/config/config-key-from-path.ts"],"sourcesContent":["const CONFIG_FILE_PATTERN = /^src\\/config\\/(.+)\\.(ts|tsx)$/;\n\n/**\n * The key a config file is registered under, from its project-relative path.\n * The single naming rule shared by dev, the production builder and typings:\n * the raw path under `src/config`, extension dropped, nothing case-converted.\n *\n * @example\n * configKeyFromPath(\"src/config/rate-limit.ts\"); // \"rate-limit\"\n * configKeyFromPath(\"src/config/mail/smtp.ts\"); // \"mail/smtp\"\n *\n * @returns the key, or `undefined` when the path is not a config file\n */\nexport function configKeyFromPath(relativePath: string): string | undefined {\n  return CONFIG_FILE_PATTERN.exec(relativePath.replace(/\\\\/g, \"/\"))?.[1];\n}\n"],"mappings":";AAAA,MAAM,sBAAsB;;;;;;;;;;;;AAa5B,SAAgB,kBAAkB,cAA0C;CAC1E,OAAO,oBAAoB,KAAK,aAAa,QAAQ,OAAO,GAAG,CAAC,CAAC,GAAG;AACtE"}

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

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

package/esm/config/config-loader.mjs

@@ -1,4 +1,5 @@
 import { configSpecialHandlers } from "./config-special-handlers.mjs";
+import { configKeyFromPath } from "./config-key-from-path.mjs";
 import config from "@mongez/config";
 import { colors } from "@mongez/copper";
 import { pathToFileURL } from "node:url";
@@ -37,9 +38,7 @@ var ConfigLoader = class {
 		await this.loadConfig(file);
 	}
 	getConfigName(relativePath) {
-		const match = relativePath.match(/^src\/config\/(.+)\.(ts|tsx)$/);
-		if (!match) throw new Error(`Invalid config file path: ${relativePath}`);
-		const configName = match[1];
+		const configName = configKeyFromPath(relativePath);
 		if (!configName) throw new Error(`Invalid config file path: ${relativePath}`);
 		return configName;
 	}

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

@@ -1 +1 @@
-{"version":3,"file":"config-loader.mjs","names":[],"sources":["../../../../../../../core/src/config/config-loader.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { colors } from \"@mongez/copper\";\r\nimport { pathToFileURL } from \"node:url\";\r\nimport type { FileManager } from \"../dev-server/file-manager\";\r\nimport { configSpecialHandlers } from \"./config-special-handlers\";\r\n\r\n/**\r\n * Special Config Handler\r\n * A function that handles special configuration loading\r\n */\r\n// Returns unknown, not void: ConfigSpecialHandlers.execute() RETURNS handler(config)\r\n// rather than discarding it, and a test pins that (\"returns the handler's resolved\r\n// value\"). The implementation and the test agreed; only this type said handlers\r\n// produce nothing, which made any value-returning handler fail to typecheck.\r\nexport type SpecialConfigHandler = (configValue: any) => unknown | Promise<unknown>;\r\n\r\n/**\r\n * Config Loader\r\n * Dynamically loads all configuration files and registers them with @mongez/config\r\n * Supports special handlers for configs that require additional processing\r\n */\r\nexport class ConfigLoader {\r\n  public async loadAll(configFiles: FileManager[]): Promise<void> {\r\n    for (const file of configFiles) {\r\n      await this.loadConfig(file);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Load a single configuration file.\r\n   *\r\n   * The ESM loader hook stamps a version token onto the URL so that each HMR\r\n   * cycle gets a fresh module — no manual cache-busting needed here.\r\n   */\r\n  public async loadConfig(file: FileManager): Promise<void> {\r\n    const configName = this.getConfigName(file.relativePath);\r\n\r\n    try {\r\n      const fileUrl = pathToFileURL(file.absolutePath).href;\r\n      const configModule = await import(fileUrl);\r\n      const configValue = configModule.default;\r\n\r\n      if (configValue === undefined) {\r\n        console.log(\r\n          colors.red(`config error: `),\r\n          `Config file ${colors.yellow(file.relativePath)} does not have a default export`,\r\n        );\r\n        return;\r\n      }\r\n\r\n      config.set(configName, configValue);\r\n      await configSpecialHandlers.execute(configName, configValue);\r\n    } catch (error) {\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  public async reloadConfig(file: FileManager): Promise<void> {\r\n    await this.loadConfig(file);\r\n  }\r\n\r\n  private getConfigName(relativePath: string): string {\r\n    const match = relativePath.match(/^src\\/config\\/(.+)\\.(ts|tsx)$/);\r\n\r\n    if (!match) {\r\n      throw new Error(`Invalid config file path: ${relativePath}`);\r\n    }\r\n\r\n    const configName = match[1];\n\n    if (!configName) {\n      throw new Error(`Invalid config file path: ${relativePath}`);\n    }\n\n    return configName;\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;AAqBA,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;GAGF,MAAM,eAAc,MADO,OADX,cAAc,KAAK,YAAY,CAAC,CAAC,MAEjB,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,QAAQ,aAAa,MAAM,+BAA+B;EAEhE,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,6BAA6B,cAAc;EAG7D,MAAM,aAAa,MAAM;EAEzB,IAAI,CAAC,YACH,MAAM,IAAI,MAAM,6BAA6B,cAAc;EAG7D,OAAO;CACT;AACF"}
+{"version":3,"file":"config-loader.mjs","names":[],"sources":["../../../../../../../core/src/config/config-loader.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { colors } from \"@mongez/copper\";\r\nimport { pathToFileURL } from \"node:url\";\r\nimport type { FileManager } from \"../dev-server/file-manager\";\r\nimport { configKeyFromPath } from \"./config-key-from-path\";\r\nimport { configSpecialHandlers } from \"./config-special-handlers\";\r\n\r\n/**\r\n * Special Config Handler\r\n * A function that handles special configuration loading\r\n */\r\n// Returns unknown, not void: ConfigSpecialHandlers.execute() RETURNS handler(config)\r\n// rather than discarding it, and a test pins that (\"returns the handler's resolved\r\n// value\"). The implementation and the test agreed; only this type said handlers\r\n// produce nothing, which made any value-returning handler fail to typecheck.\r\nexport type SpecialConfigHandler = (configValue: any) => unknown | Promise<unknown>;\r\n\r\n/**\r\n * Config Loader\r\n * Dynamically loads all configuration files and registers them with @mongez/config\r\n * Supports special handlers for configs that require additional processing\r\n */\r\nexport class ConfigLoader {\r\n  public async loadAll(configFiles: FileManager[]): Promise<void> {\r\n    for (const file of configFiles) {\r\n      await this.loadConfig(file);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Load a single configuration file.\r\n   *\r\n   * The ESM loader hook stamps a version token onto the URL so that each HMR\r\n   * cycle gets a fresh module — no manual cache-busting needed here.\r\n   */\r\n  public async loadConfig(file: FileManager): Promise<void> {\r\n    const configName = this.getConfigName(file.relativePath);\r\n\r\n    try {\r\n      const fileUrl = pathToFileURL(file.absolutePath).href;\r\n      const configModule = await import(fileUrl);\r\n      const configValue = configModule.default;\r\n\r\n      if (configValue === undefined) {\r\n        console.log(\r\n          colors.red(`config error: `),\r\n          `Config file ${colors.yellow(file.relativePath)} does not have a default export`,\r\n        );\r\n        return;\r\n      }\r\n\r\n      config.set(configName, configValue);\r\n      await configSpecialHandlers.execute(configName, configValue);\r\n    } catch (error) {\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  public async reloadConfig(file: FileManager): Promise<void> {\r\n    await this.loadConfig(file);\r\n  }\r\n\r\n  private getConfigName(relativePath: string): string {\r\n    const configName = configKeyFromPath(relativePath);\r\n\r\n    if (!configName) {\r\n      throw new Error(`Invalid config file path: ${relativePath}`);\r\n    }\r\n\r\n    return configName;\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;;;AAsBA,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;GAGF,MAAM,eAAc,MADO,OADX,cAAc,KAAK,YAAY,CAAC,CAAC,MAEjB,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"}

package/esm/connectors/cache-connector.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-connector.d.mts","names":[],"sources":["../../../../../../../core/src/connectors/cache-connector.ts"],"mappings":";;;;;;AAUA;;cAAa,cAAA,SAAuB,aAAA;EAAA,SAClB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,KAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EA8BL;;;EAAA,mBAzBN,YAAA;EARe;;;EAarB,KAAA,IAAS,OAAA;EAXE;;;;;;;;EA+BX,QAAA,IAAY,OAAA;AAAA"}
+{"version":3,"file":"cache-connector.d.mts","names":[],"sources":["../../../../../../../core/src/connectors/cache-connector.ts"],"mappings":";;;;;;AAaA;;cAAa,cAAA,SAAuB,aAAA;EAAA,SAClB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,KAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EAuCL;;;EAAA,mBAlCN,YAAA;EARe;;;EAarB,KAAA,IAAS,OAAA;EAXE;;;;;;;;EAwCX,QAAA,IAAY,OAAA;AAAA"}

package/esm/connectors/cache-connector.mjs

@@ -1,6 +1,9 @@
+import { environment } from "../utils/environment.mjs";
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
+import { memoryCacheWarning } from "./single-server-warnings.mjs";
 import config from "@mongez/config";
+import { log } from "@warlock.js/logger";
 import { cache } from "@warlock.js/cache";
 
 //#region ../core/src/connectors/cache-connector.ts
@@ -24,6 +27,8 @@ var CacheConnector = class extends BaseConnector {
 		if (!cacheConfig) return;
 		cache.setCacheConfigurations(cacheConfig);
 		await cache.init();
+		const warning = memoryCacheWarning(cache.currentDriver?.name ?? cacheConfig.default, cache.currentDriver?.constructor?.name, environment(), config.get("cache.silenceSingleServerWarning") === true);
+		if (warning) log.warn("cache", "single-server", warning);
 		this.active = true;
 	}
 	/**

package/esm/connectors/cache-connector.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cache-connector.mjs","names":[],"sources":["../../../../../../../core/src/connectors/cache-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { cache } from \"@warlock.js/cache\";\nimport type { CacheDriver } from \"@warlock.js/cache\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Cache Connector\n * Manages cache engine connection lifecycle\n */\nexport class CacheConnector extends BaseConnector {\n  public readonly name = \"cache\";\n  public readonly priority = ConnectorPriority.CACHE;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger cache restart\n   */\n  protected readonly watchedFiles = [\"src/config/cache.ts\", \"src/config/cache.tsx\"];\n\n  /**\n   * Initialize cache connection\n   */\n  public async start(): Promise<void> {\n    const cacheConfig = config.get(\"cache\");\n\n    if (!cacheConfig) return;\n\n    cache.setCacheConfigurations(cacheConfig);\n\n    await cache.init();\n\n    this.active = true;\n  }\n\n  /**\n   * Shutdown cache connection\n   *\n   * Disconnects every loaded cache driver so external clients (e.g. a Redis\n   * connection) are released instead of left dangling — mirroring the\n   * database and herald connectors, which disconnect all registered\n   * connections on shutdown.\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    // Disconnect every driver the manager loaded (not just the current one),\n    // so secondary drivers selected via `cache.use(\"...\")` also release their\n    // connections.\n    const drivers: CacheDriver<unknown, unknown>[] = Object.values(cache.loadedDrivers);\n\n    for (const driver of drivers) {\n      await driver.disconnect();\n    }\n\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;AAUA,IAAa,iBAAb,cAAoC,cAAc;;;cACzB;;;sBAOW,CAAC,uBAAuB,sBAAsB;;;;;CAKhF,MAAa,QAAuB;EAClC,MAAM,cAAc,OAAO,IAAI,OAAO;EAEtC,IAAI,CAAC,aAAa;EAElB,MAAM,uBAAuB,WAAW;EAExC,MAAM,MAAM,KAAK;EAEjB,KAAK,SAAS;CAChB;;;;;;;;;CAUA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAMF,MAAM,UAA2C,OAAO,OAAO,MAAM,aAAa;EAElF,KAAK,MAAM,UAAU,SACnB,MAAM,OAAO,WAAW;EAG1B,KAAK,SAAS;CAChB;AACF"}
+{"version":3,"file":"cache-connector.mjs","names":[],"sources":["../../../../../../../core/src/connectors/cache-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { cache } from \"@warlock.js/cache\";\nimport type { CacheDriver } from \"@warlock.js/cache\";\nimport { log } from \"@warlock.js/logger\";\nimport { environment } from \"../utils/environment\";\nimport { BaseConnector } from \"./base-connector\";\nimport { memoryCacheWarning } from \"./single-server-warnings\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Cache Connector\n * Manages cache engine connection lifecycle\n */\nexport class CacheConnector extends BaseConnector {\n  public readonly name = \"cache\";\n  public readonly priority = ConnectorPriority.CACHE;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger cache restart\n   */\n  protected readonly watchedFiles = [\"src/config/cache.ts\", \"src/config/cache.tsx\"];\n\n  /**\n   * Initialize cache connection\n   */\n  public async start(): Promise<void> {\n    const cacheConfig = config.get(\"cache\");\n\n    if (!cacheConfig) return;\n\n    cache.setCacheConfigurations(cacheConfig);\n\n    await cache.init();\n\n    const warning = memoryCacheWarning(\n      cache.currentDriver?.name ?? cacheConfig.default,\n      cache.currentDriver?.constructor?.name,\n      environment(),\n      config.get(\"cache.silenceSingleServerWarning\") === true,\n    );\n\n    if (warning) log.warn(\"cache\", \"single-server\", warning);\n\n    this.active = true;\n  }\n\n  /**\n   * Shutdown cache connection\n   *\n   * Disconnects every loaded cache driver so external clients (e.g. a Redis\n   * connection) are released instead of left dangling — mirroring the\n   * database and herald connectors, which disconnect all registered\n   * connections on shutdown.\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    // Disconnect every driver the manager loaded (not just the current one),\n    // so secondary drivers selected via `cache.use(\"...\")` also release their\n    // connections.\n    const drivers: CacheDriver<unknown, unknown>[] = Object.values(cache.loadedDrivers);\n\n    for (const driver of drivers) {\n      await driver.disconnect();\n    }\n\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,IAAa,iBAAb,cAAoC,cAAc;;;cACzB;;;sBAOW,CAAC,uBAAuB,sBAAsB;;;;;CAKhF,MAAa,QAAuB;EAClC,MAAM,cAAc,OAAO,IAAI,OAAO;EAEtC,IAAI,CAAC,aAAa;EAElB,MAAM,uBAAuB,WAAW;EAExC,MAAM,MAAM,KAAK;EAEjB,MAAM,UAAU,mBACd,MAAM,eAAe,QAAQ,YAAY,SACzC,MAAM,eAAe,aAAa,MAClC,YAAY,GACZ,OAAO,IAAI,kCAAkC,MAAM,IACrD;EAEA,IAAI,SAAS,IAAI,KAAK,SAAS,iBAAiB,OAAO;EAEvD,KAAK,SAAS;CAChB;;;;;;;;;CAUA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAMF,MAAM,UAA2C,OAAO,OAAO,MAAM,aAAa;EAElF,KAAK,MAAM,UAAU,SACnB,MAAM,OAAO,WAAW;EAG1B,KAAK,SAAS;CAChB;AACF"}

package/esm/connectors/connectors-manager.d.mts

@@ -78,6 +78,10 @@ declare class ConnectorsManager {
    * Shutdown all connectors
    */
   shutdown(): Promise<void>;
+  /**
+   * Shut one connector down, isolating and reporting its failure.
+   */
+  private shutdownOne;
   /**
    * Shutdown connectors on process kill
    *

package/esm/connectors/connectors-manager.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"connectors-manager.d.mts","names":[],"sources":["../../../../../../../core/src/connectors/connectors-manager.ts"],"mappings":";;;cAgBa,iBAAA;EAAA;;;EAAA,iBAIM,UAAA;EAwEF;;;;;;;;;;;;EAAA,iBA1DE,YAAA;;;;;EAiDV;;;;;;;EAAA,QAvBC,eAAA;EAkDK;;;;;;;;EAlCN,aAAA,CAAc,IAAA;EA0EyB;;;EAnEvC,QAAA,IAAY,UAAA,EAAY,SAAA;EA8EN;;;EArElB,IAAA,IAAQ,SAAA;EAmJJ;;;;AAA2C;;;EAxI/C,GAAA,CAAI,IAAA,EAAM,aAAA;;;;EAOJ,KAAA,CAAM,eAAA,GAAkB,aAAA,KAAkB,OAAA;;;;;;;;;;EAuB1C,UAAA,CAAW,KAAA,EAAO,uBAAA,GAA0B,OAAA;;;;EAiB5C,YAAA,CAAa,kBAAA,EAAoB,aAAA,KAAkB,OAAA;;;;EAWnD,QAAA,IAAY,OAAA;;;;;;;;;;;;;EAqDlB,qBAAA;AAAA;AAAA,cAyBI,iBAAA,EAAiB,iBAA0B"}
+{"version":3,"file":"connectors-manager.d.mts","names":[],"sources":["../../../../../../../core/src/connectors/connectors-manager.ts"],"mappings":";;;cAsBa,iBAAA;EAAA;;;EAAA,iBAIM,UAAA;EAwEF;;;;;;;;;;;;EAAA,iBA1DE,YAAA;;;;;EAiDV;;;;;;;EAAA,QAvBC,eAAA;EAkDK;;;;;;;;EAlCN,aAAA,CAAc,IAAA;EA0EyB;;;EAnEvC,QAAA,IAAY,UAAA,EAAY,SAAA;EA8EN;;;EArElB,IAAA,IAAQ,SAAA;EAkJa;AAyB9B;;;;AAAwD;;EAhK/C,GAAA,CAAI,IAAA,EAAM,aAAA;;;;EAOJ,KAAA,CAAM,eAAA,GAAkB,aAAA,KAAkB,OAAA;;;;;;;;;;EAuB1C,UAAA,CAAW,KAAA,EAAO,uBAAA,GAA0B,OAAA;;;;EAiB5C,YAAA,CAAa,kBAAA,EAAoB,aAAA,KAAkB,OAAA;;;;EAWnD,QAAA,IAAY,OAAA;;;;UA8CX,WAAA;;;;;;;;;;;;;EA+BP,qBAAA;AAAA;AAAA,cAyBI,iBAAA,EAAiB,iBAA0B"}

package/esm/connectors/connectors-manager.mjs

@@ -11,9 +11,14 @@ import { MailerConnector } from "./mail-connector.mjs";
 import { NotificationsConnector } from "./notifications-connector.mjs";
 import { SocketConnector } from "./socket-connector.mjs";
 import { StorageConnector } from "./storage.connector.mjs";
+import config from "@mongez/config";
 import { log } from "@warlock.js/logger";
 
 //#region ../core/src/connectors/connectors-manager.ts
+/**
+* Overall shutdown budget in ms. Override via `app.shutdownTimeout`.
+*/
+const DEFAULT_SHUTDOWN_TIMEOUT = 1e4;
 var ConnectorsManager = class {
 	/**
 	* Constructor
@@ -111,14 +116,37 @@ var ConnectorsManager = class {
 	*/
 	async shutdown() {
 		await Application.runShutdownHooks();
-		for (const connector of [...this.connectors].reverse()) try {
+		const reversed = [...this.connectors].reverse();
+		const ordered = [...reversed.filter((connector) => connector.name === "http"), ...reversed.filter((connector) => connector.name !== "http")];
+		const timeout = config.get("app.shutdownTimeout", DEFAULT_SHUTDOWN_TIMEOUT);
+		let current;
+		const timer = setTimeout(() => {
+			console.error(`Shutdown timed out after ${timeout}ms; connector still shutting down: ${current ?? "none"}`);
+			process.exit(1);
+		}, timeout);
+		timer.unref?.();
+		try {
+			for (const connector of ordered) {
+				current = connector.name;
+				await this.shutdownOne(connector);
+			}
+			current = void 0;
+		} finally {
+			clearTimeout(timer);
+		}
+		await log.flush();
+	}
+	/**
+	* Shut one connector down, isolating and reporting its failure.
+	*/
+	async shutdownOne(connector) {
+		try {
 			await connector.shutdown();
 		} catch (error) {
 			try {
 				await log.error("connectors", "shutdown", error, { connector: connector.name });
 			} catch {}
 		}
-		await log.flush();
 	}
 	/**
 	* Shutdown connectors on process kill

package/esm/connectors/connectors-manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"connectors-manager.mjs","names":[],"sources":["../../../../../../../core/src/connectors/connectors-manager.ts"],"sourcesContent":["import { Application } from \"../application\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { AccessConnector } from \"./access-connector\";\r\nimport { AiConnector } from \"./ai-connector\";\r\nimport { CacheConnector } from \"./cache-connector\";\r\nimport { DatabaseConnector } from \"./database-connector\";\r\nimport { HeraldConnector } from \"./herald-connector\";\r\nimport { HttpConnector } from \"./http-connector\";\r\nimport { LoggerConnector } from \"./logger-connector\";\r\nimport { MailerConnector } from \"./mail-connector\";\r\nimport { NotificationsConnector } from \"./notifications-connector\";\r\nimport { SocketConnector } from \"./socket-connector\";\r\nimport { StorageConnector } from \"./storage.connector\";\r\nimport { ConnectorLifecyclePhase } from \"./types\";\r\nimport type { Connector, ConnectorName } from \"./types\";\r\n\r\nexport class ConnectorsManager {\r\n  /**\r\n   * Connectors list\r\n   */\r\n  private readonly connectors: Connector[] = [];\r\n\r\n  /**\r\n   * The names the framework's own connectors hold.\r\n   *\r\n   * Filled by the constructor's own registration calls rather than declared\r\n   * beside them, so there is exactly ONE place a built-in name exists: the\r\n   * connector that owns it. A second list — in the builder, in a config\r\n   * validator, in a test double — is a list that drifts the moment a built-in\r\n   * is added or renamed, and it drifts silently, because nothing compares the\r\n   * two. Both halves of a connector's life read this one through\r\n   * {@link isBuiltInName}: the build refuses a `connectors` array that claims\r\n   * a built-in name, and so does registration.\r\n   */\r\n  private readonly builtInNames = new Set<string>();\r\n\r\n  /**\r\n   * Constructor\r\n   */\r\n  public constructor() {\r\n    this.registerBuiltIn(new LoggerConnector());\r\n    this.registerBuiltIn(new MailerConnector());\r\n    this.registerBuiltIn(new HttpConnector());\r\n    this.registerBuiltIn(new DatabaseConnector());\r\n    this.registerBuiltIn(new HeraldConnector());\r\n    this.registerBuiltIn(new CacheConnector());\r\n    this.registerBuiltIn(new StorageConnector());\r\n    this.registerBuiltIn(new SocketConnector());\r\n    this.registerBuiltIn(new NotificationsConnector());\r\n    this.registerBuiltIn(new AccessConnector());\r\n    this.registerBuiltIn(new AiConnector());\r\n  }\r\n\r\n  /**\r\n   * Register a framework-owned connector and reserve its name.\r\n   *\r\n   * Private on purpose: an app connector must not be able to reserve a name,\r\n   * and the set is only correct if every entry in it came from a connector\r\n   * this class constructed itself.\r\n   */\r\n  private registerBuiltIn(...connectors: Connector[]): void {\r\n    for (const connector of connectors) {\r\n      this.builtInNames.add(connector.name);\r\n    }\r\n\r\n    this.register(...connectors);\r\n  }\r\n\r\n  /**\r\n   * Whether the given name belongs to a framework built-in connector.\r\n   *\r\n   * Reserved, not merely taken: a configured connector carrying one of these\r\n   * names would be skipped by {@link has} at boot while the build had already\r\n   * drained its contribution, so the artifact would carry a connector the\r\n   * server never runs. Callers refuse the name instead of skipping it.\r\n   */\r\n  public isBuiltInName(name: string): boolean {\r\n    return this.builtInNames.has(name);\r\n  }\r\n\r\n  /**\r\n   * Register a connector\r\n   */\r\n  public register(...connectors: Connector[]): void {\r\n    this.connectors.push(...connectors);\r\n    // sort connectors by priority\r\n    this.connectors.sort((a, b) => a.priority - b.priority);\r\n  }\r\n\r\n  /**\r\n   * Get all connectors\r\n   */\r\n  public list(): Connector[] {\r\n    return this.connectors;\r\n  }\r\n\r\n  /**\r\n   * Whether a connector with the given name is already registered.\r\n   *\r\n   * Names are the identity of a connector here, which is what lets a caller\r\n   * that may run more than once per process register idempotently instead of\r\n   * stacking duplicates that would each boot and shut down.\r\n   */\r\n  public has(name: ConnectorName): boolean {\r\n    return this.connectors.some((connector) => connector.name === name);\r\n  }\r\n\r\n  /**\r\n   * start all connectors\r\n   */\r\n  public async start(connectorsNames?: ConnectorName[]): Promise<void> {\r\n    const connectorsList = connectorsNames\r\n      ? this.connectors.filter((connector) => connectorsNames.includes(connector.name))\r\n      : this.connectors;\r\n\r\n    for (const connector of connectorsList) {\r\n      await connector.boot();\r\n    }\r\n\r\n    for (const connector of connectorsList) {\r\n      await connector.start();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Start all connectors in the given lifecycle phase.\r\n   *\r\n   * The production builder and dev preload split startup around app\r\n   * code: early phase before app imports, late phase after. Within a\r\n   * phase, all connectors `boot()` first, then all `start()`, so\r\n   * cross-connector wiring inside the phase still works (e.g. socket\r\n   * reads http's instance during its own boot).\r\n   */\r\n  public async startPhase(phase: ConnectorLifecyclePhase): Promise<void> {\r\n    const phaseConnectors = this.connectors.filter(\r\n      (connector) => connector.lifecyclePhase === phase,\r\n    );\r\n\r\n    for (const connector of phaseConnectors) {\r\n      await connector.boot();\r\n    }\r\n\r\n    for (const connector of phaseConnectors) {\r\n      await connector.start();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Start all connectors except the given ones\r\n   */\r\n  public async startWithout(excludedConnectors: ConnectorName[]): Promise<void> {\r\n    await this.start(\r\n      this.connectors\r\n        .filter((connector) => !excludedConnectors.includes(connector.name))\r\n        .map((connector) => connector.name),\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Shutdown all connectors\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    // App-owned teardown runs first, while every connector (db, cache, http) is\r\n    // still up, so cleanup hooks can use them. Idempotent + error-isolated.\r\n    await Application.runShutdownHooks();\r\n\r\n    // Shut down connectors in reverse priority order. Copy the list first —\r\n    // `reverse()` mutates in place, so reversing the live array would corrupt\r\n    // the order on a second shutdown pass.\r\n    for (const connector of [...this.connectors].reverse()) {\r\n      try {\r\n        await connector.shutdown();\r\n      } catch (error) {\r\n        try {\r\n          // Awaited deliberately: the caller (`shutdownOnProcessKill`) calls\r\n          // `process.exit(0)` as soon as this resolves, so an un-awaited log is\r\n          // a log that never happens.\r\n          await log.error(\"connectors\", \"shutdown\", error as Error, { connector: connector.name });\r\n        } catch {\r\n          // Reporting a failure must never become a worse failure than the one\r\n          // being reported. `Logger.log()` fans out to channels without\r\n          // isolating them, so a channel that throws synchronously rejects this\r\n          // call — and this call sits INSIDE the catch, so that rejection\r\n          // escapes `shutdown()` entirely: the remaining connectors are never\r\n          // torn down and `process.exit(0)` never runs, leaving the process\r\n          // alive on the handles they still hold.\r\n          //\r\n          // Swallowed rather than re-reported: the only channel we could report\r\n          // it through is the one that just threw.\r\n        }\r\n      }\r\n    }\r\n\r\n    // `Logger.log()` hands each entry to `channel.log()` without awaiting it, so\r\n    // awaiting the calls above is not enough on its own — a buffered or async\r\n    // channel (file, Sentry) still loses the entry when the process exits.\r\n    // Drained once here rather than per failure: shutdown is exactly when\r\n    // buffered logs must reach their destination, and re-draining every channel\r\n    // once per failed connector buys nothing.\r\n    await log.flush();\r\n  }\r\n\r\n  /**\r\n   * Shutdown connectors on process kill\r\n   *\r\n   * Registers signal handlers that run an idempotent graceful shutdown:\r\n   * - SIGINT: Ctrl+C on Unix, also caught on Windows but unreliable in child processes\r\n   * - SIGTERM: Termination signal (Unix primarily)\r\n   * - SIGHUP: registered on Windows (`win32`) only, to catch Ctrl+C / console close\r\n   *\r\n   * Note: no `beforeExit` handler is registered — `beforeExit` cannot reliably\r\n   * await async teardown (the process exits once the callback returns), so\r\n   * shutdown is driven entirely by the signal handlers above.\r\n   */\r\n  public shutdownOnProcessKill(): void {\r\n    let isShuttingDown = false;\r\n\r\n    const gracefulShutdown = async (signal: string) => {\r\n      if (isShuttingDown) return;\r\n      isShuttingDown = true;\r\n\r\n      console.log(`\\nExiting...`);\r\n      await this.shutdown();\r\n      process.exit(0);\r\n    };\r\n\r\n    // Unix signals\r\n    process.on(\"SIGINT\", () => gracefulShutdown(\"SIGINT\"));\r\n    process.on(\"SIGTERM\", () => gracefulShutdown(\"SIGTERM\"));\r\n\r\n    // Windows-specific: handle when process is about to exit\r\n    // This is more reliable on Windows for spawned child processes\r\n    if (process.platform === \"win32\") {\r\n      // Handle Ctrl+C on Windows specifically\r\n      process.on(\"SIGHUP\", () => gracefulShutdown(\"SIGHUP\"));\r\n    }\r\n  }\r\n}\r\n\r\nexport const connectorsManager = new ConnectorsManager();\r\n"],"mappings":"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"}
+{"version":3,"file":"connectors-manager.mjs","names":[],"sources":["../../../../../../../core/src/connectors/connectors-manager.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { Application } from \"../application\";\r\nimport { log } from \"@warlock.js/logger\";\r\nimport { AccessConnector } from \"./access-connector\";\r\nimport { AiConnector } from \"./ai-connector\";\r\nimport { CacheConnector } from \"./cache-connector\";\r\nimport { DatabaseConnector } from \"./database-connector\";\r\nimport { HeraldConnector } from \"./herald-connector\";\r\nimport { HttpConnector } from \"./http-connector\";\r\nimport { LoggerConnector } from \"./logger-connector\";\r\nimport { MailerConnector } from \"./mail-connector\";\r\nimport { NotificationsConnector } from \"./notifications-connector\";\r\nimport { SocketConnector } from \"./socket-connector\";\r\nimport { StorageConnector } from \"./storage.connector\";\r\nimport { ConnectorLifecyclePhase } from \"./types\";\r\nimport type { Connector, ConnectorName } from \"./types\";\r\n\r\n/**\r\n * Overall shutdown budget in ms. Override via `app.shutdownTimeout`.\r\n */\r\nconst DEFAULT_SHUTDOWN_TIMEOUT = 10_000;\r\n\r\nexport class ConnectorsManager {\r\n  /**\r\n   * Connectors list\r\n   */\r\n  private readonly connectors: Connector[] = [];\r\n\r\n  /**\r\n   * The names the framework's own connectors hold.\r\n   *\r\n   * Filled by the constructor's own registration calls rather than declared\r\n   * beside them, so there is exactly ONE place a built-in name exists: the\r\n   * connector that owns it. A second list — in the builder, in a config\r\n   * validator, in a test double — is a list that drifts the moment a built-in\r\n   * is added or renamed, and it drifts silently, because nothing compares the\r\n   * two. Both halves of a connector's life read this one through\r\n   * {@link isBuiltInName}: the build refuses a `connectors` array that claims\r\n   * a built-in name, and so does registration.\r\n   */\r\n  private readonly builtInNames = new Set<string>();\r\n\r\n  /**\r\n   * Constructor\r\n   */\r\n  public constructor() {\r\n    this.registerBuiltIn(new LoggerConnector());\r\n    this.registerBuiltIn(new MailerConnector());\r\n    this.registerBuiltIn(new HttpConnector());\r\n    this.registerBuiltIn(new DatabaseConnector());\r\n    this.registerBuiltIn(new HeraldConnector());\r\n    this.registerBuiltIn(new CacheConnector());\r\n    this.registerBuiltIn(new StorageConnector());\r\n    this.registerBuiltIn(new SocketConnector());\r\n    this.registerBuiltIn(new NotificationsConnector());\r\n    this.registerBuiltIn(new AccessConnector());\r\n    this.registerBuiltIn(new AiConnector());\r\n  }\r\n\r\n  /**\r\n   * Register a framework-owned connector and reserve its name.\r\n   *\r\n   * Private on purpose: an app connector must not be able to reserve a name,\r\n   * and the set is only correct if every entry in it came from a connector\r\n   * this class constructed itself.\r\n   */\r\n  private registerBuiltIn(...connectors: Connector[]): void {\r\n    for (const connector of connectors) {\r\n      this.builtInNames.add(connector.name);\r\n    }\r\n\r\n    this.register(...connectors);\r\n  }\r\n\r\n  /**\r\n   * Whether the given name belongs to a framework built-in connector.\r\n   *\r\n   * Reserved, not merely taken: a configured connector carrying one of these\r\n   * names would be skipped by {@link has} at boot while the build had already\r\n   * drained its contribution, so the artifact would carry a connector the\r\n   * server never runs. Callers refuse the name instead of skipping it.\r\n   */\r\n  public isBuiltInName(name: string): boolean {\r\n    return this.builtInNames.has(name);\r\n  }\r\n\r\n  /**\r\n   * Register a connector\r\n   */\r\n  public register(...connectors: Connector[]): void {\r\n    this.connectors.push(...connectors);\r\n    // sort connectors by priority\r\n    this.connectors.sort((a, b) => a.priority - b.priority);\r\n  }\r\n\r\n  /**\r\n   * Get all connectors\r\n   */\r\n  public list(): Connector[] {\r\n    return this.connectors;\r\n  }\r\n\r\n  /**\r\n   * Whether a connector with the given name is already registered.\r\n   *\r\n   * Names are the identity of a connector here, which is what lets a caller\r\n   * that may run more than once per process register idempotently instead of\r\n   * stacking duplicates that would each boot and shut down.\r\n   */\r\n  public has(name: ConnectorName): boolean {\r\n    return this.connectors.some((connector) => connector.name === name);\r\n  }\r\n\r\n  /**\r\n   * start all connectors\r\n   */\r\n  public async start(connectorsNames?: ConnectorName[]): Promise<void> {\r\n    const connectorsList = connectorsNames\r\n      ? this.connectors.filter((connector) => connectorsNames.includes(connector.name))\r\n      : this.connectors;\r\n\r\n    for (const connector of connectorsList) {\r\n      await connector.boot();\r\n    }\r\n\r\n    for (const connector of connectorsList) {\r\n      await connector.start();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Start all connectors in the given lifecycle phase.\r\n   *\r\n   * The production builder and dev preload split startup around app\r\n   * code: early phase before app imports, late phase after. Within a\r\n   * phase, all connectors `boot()` first, then all `start()`, so\r\n   * cross-connector wiring inside the phase still works (e.g. socket\r\n   * reads http's instance during its own boot).\r\n   */\r\n  public async startPhase(phase: ConnectorLifecyclePhase): Promise<void> {\r\n    const phaseConnectors = this.connectors.filter(\r\n      (connector) => connector.lifecyclePhase === phase,\r\n    );\r\n\r\n    for (const connector of phaseConnectors) {\r\n      await connector.boot();\r\n    }\r\n\r\n    for (const connector of phaseConnectors) {\r\n      await connector.start();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Start all connectors except the given ones\r\n   */\r\n  public async startWithout(excludedConnectors: ConnectorName[]): Promise<void> {\r\n    await this.start(\r\n      this.connectors\r\n        .filter((connector) => !excludedConnectors.includes(connector.name))\r\n        .map((connector) => connector.name),\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Shutdown all connectors\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    // App-owned teardown runs first, while every connector (db, cache, http) is\r\n    // still up, so cleanup hooks can use them. Idempotent + error-isolated.\r\n    await Application.runShutdownHooks();\r\n\r\n    // HTTP stops accepting and drains in-flight requests FIRST, while storage,\r\n    // socket, etc. are still up; then the rest go in reverse priority. Copy the\r\n    // list first — `reverse()` mutates in place, so reversing the live array\r\n    // would corrupt the order on a second shutdown pass.\r\n    const reversed = [...this.connectors].reverse();\r\n    const ordered = [\r\n      ...reversed.filter((connector) => connector.name === \"http\"),\r\n      ...reversed.filter((connector) => connector.name !== \"http\"),\r\n    ];\r\n\r\n    const timeout = config.get(\"app.shutdownTimeout\", DEFAULT_SHUTDOWN_TIMEOUT);\r\n    let current: string | undefined;\r\n\r\n    const timer = setTimeout(() => {\r\n      // Sync write: the process exits right after, so an async log would be lost.\r\n      console.error(\r\n        `Shutdown timed out after ${timeout}ms; connector still shutting down: ${current ?? \"none\"}`,\r\n      );\r\n      process.exit(1);\r\n    }, timeout);\r\n    timer.unref?.();\r\n\r\n    try {\r\n      for (const connector of ordered) {\r\n        current = connector.name;\r\n        await this.shutdownOne(connector);\r\n      }\r\n      current = undefined;\r\n    } finally {\r\n      clearTimeout(timer);\r\n    }\r\n\r\n    // `Logger.log()` hands each entry to `channel.log()` without awaiting it, so\r\n    // awaiting the calls above is not enough on its own — a buffered or async\r\n    // channel (file, Sentry) still loses the entry when the process exits.\r\n    await log.flush();\r\n  }\r\n\r\n  /**\r\n   * Shut one connector down, isolating and reporting its failure.\r\n   */\r\n  private async shutdownOne(connector: Connector): Promise<void> {\r\n    try {\r\n      await connector.shutdown();\r\n    } catch (error) {\r\n      try {\r\n        // Awaited deliberately: the caller (`shutdownOnProcessKill`) calls\r\n        // `process.exit(0)` as soon as this resolves, so an un-awaited log is\r\n        // a log that never happens.\r\n        await log.error(\"connectors\", \"shutdown\", error as Error, { connector: connector.name });\r\n      } catch {\r\n        // Reporting a failure must never become a worse failure than the one\r\n        // being reported: a channel that throws synchronously rejects this call\r\n        // INSIDE the catch, which would abort the remaining teardown. Swallowed\r\n        // rather than re-reported: the only channel we could report it through\r\n        // is the one that just threw.\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Shutdown connectors on process kill\r\n   *\r\n   * Registers signal handlers that run an idempotent graceful shutdown:\r\n   * - SIGINT: Ctrl+C on Unix, also caught on Windows but unreliable in child processes\r\n   * - SIGTERM: Termination signal (Unix primarily)\r\n   * - SIGHUP: registered on Windows (`win32`) only, to catch Ctrl+C / console close\r\n   *\r\n   * Note: no `beforeExit` handler is registered — `beforeExit` cannot reliably\r\n   * await async teardown (the process exits once the callback returns), so\r\n   * shutdown is driven entirely by the signal handlers above.\r\n   */\r\n  public shutdownOnProcessKill(): void {\r\n    let isShuttingDown = false;\r\n\r\n    const gracefulShutdown = async (signal: string) => {\r\n      if (isShuttingDown) return;\r\n      isShuttingDown = true;\r\n\r\n      console.log(`\\nExiting...`);\r\n      await this.shutdown();\r\n      process.exit(0);\r\n    };\r\n\r\n    // Unix signals\r\n    process.on(\"SIGINT\", () => gracefulShutdown(\"SIGINT\"));\r\n    process.on(\"SIGTERM\", () => gracefulShutdown(\"SIGTERM\"));\r\n\r\n    // Windows-specific: handle when process is about to exit\r\n    // This is more reliable on Windows for spawned child processes\r\n    if (process.platform === \"win32\") {\r\n      // Handle Ctrl+C on Windows specifically\r\n      process.on(\"SIGHUP\", () => gracefulShutdown(\"SIGHUP\"));\r\n    }\r\n  }\r\n}\r\n\r\nexport const connectorsManager = new ConnectorsManager();\r\n"],"mappings":"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"}

package/esm/connectors/single-server-warnings.mjs

@@ -0,0 +1,33 @@
+//#region ../core/src/connectors/single-server-warnings.ts
+const IN_PROCESS_CACHE_NAMES = [
+	"memory",
+	"memoryextended",
+	"lru"
+];
+const IN_PROCESS_CACHE_CLASSES = [
+	"memorycachedriver",
+	"memoryextendedcachedriver",
+	"lrumemorycachedriver"
+];
+/**
+* Warning for a production app whose default cache driver keeps data in this
+* process only. Returns `undefined` when there is nothing to warn about.
+*/
+function memoryCacheWarning(defaultDriverName, driverClassName, env, silenced = false) {
+	if (env !== "production" || silenced || !defaultDriverName) return void 0;
+	const byName = IN_PROCESS_CACHE_NAMES.includes(defaultDriverName.toLowerCase());
+	const byClass = !!driverClassName && IN_PROCESS_CACHE_CLASSES.includes(driverClassName.toLowerCase());
+	if (!byName && !byClass) return void 0;
+	return `cache: the default driver '${defaultDriverName}' keeps data in this process only. With more than one server, repository cache clears, locks and counters don't reach the other servers. Use the redis or pg cache driver in production, or set cache.silenceSingleServerWarning = true.`;
+}
+/**
+* Warning for a production app whose default storage driver is the local disk.
+*/
+function localStorageWarning(defaultDriverName, env, silenced = false) {
+	if (env !== "production" || silenced || defaultDriverName !== "local") return void 0;
+	return "storage: the default driver 'local' keeps files on this server's disk only. With more than one server, uploads written on one server are missing on the others. Use an S3 or R2 storage driver in production, or set storage.silenceSingleServerWarning = true.";
+}
+
+//#endregion
+export { localStorageWarning, memoryCacheWarning };
+//# sourceMappingURL=single-server-warnings.mjs.map

package/esm/connectors/single-server-warnings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-server-warnings.mjs","names":[],"sources":["../../../../../../../core/src/connectors/single-server-warnings.ts"],"sourcesContent":["import type { Environment } from \"../utils/environment\";\n\nconst IN_PROCESS_CACHE_NAMES = [\"memory\", \"memoryextended\", \"lru\"];\nconst IN_PROCESS_CACHE_CLASSES = [\"memorycachedriver\", \"memoryextendedcachedriver\", \"lrumemorycachedriver\"];\n\n/**\n * Warning for a production app whose default cache driver keeps data in this\n * process only. Returns `undefined` when there is nothing to warn about.\n */\nexport function memoryCacheWarning(\n  defaultDriverName: string | undefined,\n  driverClassName: string | undefined,\n  env: Environment,\n  silenced = false,\n): string | undefined {\n  if (env !== \"production\" || silenced || !defaultDriverName) return undefined;\n\n  const byName = IN_PROCESS_CACHE_NAMES.includes(defaultDriverName.toLowerCase());\n  const byClass =\n    !!driverClassName && IN_PROCESS_CACHE_CLASSES.includes(driverClassName.toLowerCase());\n\n  if (!byName && !byClass) return undefined;\n\n  return (\n    `cache: the default driver '${defaultDriverName}' keeps data in this process only. ` +\n    \"With more than one server, repository cache clears, locks and counters don't reach the other servers. \" +\n    \"Use the redis or pg cache driver in production, or set cache.silenceSingleServerWarning = true.\"\n  );\n}\n\n/**\n * Warning for a production app whose default storage driver is the local disk.\n */\nexport function localStorageWarning(\n  defaultDriverName: string | undefined,\n  env: Environment,\n  silenced = false,\n): string | undefined {\n  if (env !== \"production\" || silenced || defaultDriverName !== \"local\") return undefined;\n\n  return (\n    \"storage: the default driver 'local' keeps files on this server's disk only. \" +\n    \"With more than one server, uploads written on one server are missing on the others. \" +\n    \"Use an S3 or R2 storage driver in production, or set storage.silenceSingleServerWarning = true.\"\n  );\n}\n"],"mappings":";AAEA,MAAM,yBAAyB;CAAC;CAAU;CAAkB;AAAK;AACjE,MAAM,2BAA2B;CAAC;CAAqB;CAA6B;AAAsB;;;;;AAM1G,SAAgB,mBACd,mBACA,iBACA,KACA,WAAW,OACS;CACpB,IAAI,QAAQ,gBAAgB,YAAY,CAAC,mBAAmB,OAAO;CAEnE,MAAM,SAAS,uBAAuB,SAAS,kBAAkB,YAAY,CAAC;CAC9E,MAAM,UACJ,CAAC,CAAC,mBAAmB,yBAAyB,SAAS,gBAAgB,YAAY,CAAC;CAEtF,IAAI,CAAC,UAAU,CAAC,SAAS,OAAO;CAEhC,OACE,8BAA8B,kBAAkB;AAIpD;;;;AAKA,SAAgB,oBACd,mBACA,KACA,WAAW,OACS;CACpB,IAAI,QAAQ,gBAAgB,YAAY,sBAAsB,SAAS,OAAO;CAE9E,OACE;AAIJ"}

package/esm/connectors/socket-connector.d.mts

@@ -27,6 +27,20 @@ declare class SocketConnector extends BaseConnector {
    * created one itself (http absent). See {@link shutdown}.
    */
   protected ownsRawServer: boolean;
+  /**
+   * The shared server socket.io attached to, kept for the detach.
+   */
+  protected sharedServer?: any;
+  /**
+   * Listener changes socket.io/engine.io made on the shared server at attach:
+   * the listeners they added, and the ones they removed (engine.io lifts the
+   * existing `request` listeners into its own wrapper). Undone on detach so
+   * repeated dev restarts don't stack engines on Fastify's server.
+   */
+  protected attachedListeners: {
+    added: Array<[string, (...args: any[]) => void]>;
+    removed: Array<[string, (...args: any[]) => void]>;
+  };
   /**
    * Boot the connector
    */
@@ -35,6 +49,11 @@ declare class SocketConnector extends BaseConnector {
    * Initialize Socket server
    */
   start(): Promise<void>;
+  /**
+   * Restart re-boots too: the closed `io` must be replaced and the new
+   * `socket` config read, otherwise a config edit in dev restarts nothing.
+   */
+  restart(): Promise<void>;
   /**
    * Shutdown Socket server
    *
@@ -45,6 +64,16 @@ declare class SocketConnector extends BaseConnector {
    * race to `close()` the same socket.
    */
   shutdown(): Promise<void>;
+  /**
+   * Current listeners of the events socket.io touches on a node server.
+   */
+  private snapshotListeners;
+  private diffListeners;
+  /**
+   * Undo what attaching did to the shared server, leaving listeners other
+   * consumers added since (e.g. Vite's HMR upgrade handler) untouched.
+   */
+  private restoreListeners;
 }
 //#endregion
 export { SocketConnector };

package/esm/connectors/socket-connector.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"socket-connector.d.mts","names":[],"sources":["../../../../../../../core/src/connectors/socket-connector.ts"],"mappings":";;;;;;;AA8BA;;cAAa,eAAA,SAAwB,aAAA;EAAA,SACnB,IAAA,EAAM,aAAA;EAAA,SACN,QAAA,GAAQ,iBAAA,CAAA,MAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,IAAA;EASX;;;;;EAAA,mBAFA,YAAA;EAAA,UAET,MAAA,GAAS,MAAA;EAZgB;;;;;;;;EAAA,UAsBzB,aAAA;EAZS;;;EAiBN,IAAA,IAAI,OAAA;EAAJ;;;EAuDA,KAAA,IAAS,OAAA;EAqBT;;;AAAmB;;;;;;EAAnB,QAAA,IAAY,OAAA;AAAA"}
+{"version":3,"file":"socket-connector.d.mts","names":[],"sources":["../../../../../../../core/src/connectors/socket-connector.ts"],"mappings":";;;;;;;AAkCA;;cAAa,eAAA,SAAwB,aAAA;EAAA,SACnB,IAAA,EAAM,aAAA;EAAA,SACN,QAAA,GAAQ,iBAAA,CAAA,MAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,IAAA;EASX;;;;;EAAA,mBAFA,YAAA;EAAA,UAET,MAAA,GAAS,MAAA;EAZgB;;;;;;;;EAAA,UAsBzB,aAAA;EAnBM;;;EAAA,UAwBN,YAAA;EAfA;;;;;;EAAA,UAuBA,iBAAA;IACR,KAAA,EAAO,KAAA,cAAmB,IAAA;IAC1B,OAAA,EAAS,KAAA,cAAmB,IAAA;EAAA;EAAA;;;EAMjB,IAAA,IAAI,OAAA;EA2EK;;;EAAT,KAAA,IAAS,OAAA;EA+BG;;;;EAfZ,OAAA,IAAW,OAAA;EA4EA;;;;;;;;;EA7DX,QAAA,IAAY,OAAA;;;;UA8BjB,iBAAA;EAAA,QAUA,aAAA;;;;;UAqBA,gBAAA;AAAA"}

package/esm/connectors/socket-connector.mjs

@@ -1,3 +1,4 @@
+import { environment } from "../utils/environment.mjs";
 import { container } from "../container/index.mjs";
 import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
 import { BaseConnector } from "./base-connector.mjs";
@@ -23,6 +24,7 @@ Or manually:
   pnpm add socket.io
   yarn add socket.io
 `.trim();
+const SINGLE_SERVER_WARNING = "socket: no adapter configured — broadcasts only reach clients connected to this server. Use @socket.io/redis-adapter (socket.adapter) behind a load balancer, with sticky sessions for the polling transport.";
 /**
 * Socket Connector
 * Manages Socket server (Socket.IO) lifecycle
@@ -35,6 +37,10 @@ var SocketConnector = class extends BaseConnector {
 		this.lifecyclePhase = "late";
 		this.watchedFiles = ["src/config/socket.ts"];
 		this.ownsRawServer = false;
+		this.attachedListeners = {
+			added: [],
+			removed: []
+		};
 	}
 	/**
 	* Boot the connector
@@ -55,15 +61,28 @@ var SocketConnector = class extends BaseConnector {
 			server = fastify.server;
 			this.ownsRawServer = false;
 		} else {
-			server = socketConfig.ssl ? createServer$1() : createServer();
+			server = socketConfig.ssl ? createServer$1({
+				key: socketConfig.ssl.key,
+				cert: socketConfig.ssl.cert
+			}) : createServer();
+			server.on("error", (error) => {
+				log.error("socket", "connection", error, { port: socketConfig.port });
+			});
 			server.listen(socketConfig.port);
 			this.ownsRawServer = true;
 		}
 		container.set("socket.rawServer", server);
+		const before = this.snapshotListeners(server);
 		this.socket = new SocketServer(server, {
 			destroyUpgrade: false,
 			...socketConfig.options
 		});
+		if (!this.ownsRawServer) {
+			this.sharedServer = server;
+			this.attachedListeners = this.diffListeners(before, this.snapshotListeners(server));
+		}
+		if (socketConfig.adapter) this.socket.adapter(await socketConfig.adapter(this.socket));
+		else if (environment() === "production" && !socketConfig.silenceSingleServerWarning) log.warn("socket", "adapter", SINGLE_SERVER_WARNING);
 		container.set("socket", this.socket);
 	}
 	/**
@@ -75,6 +94,15 @@ var SocketConnector = class extends BaseConnector {
 		this.active = true;
 	}
 	/**
+	* Restart re-boots too: the closed `io` must be replaced and the new
+	* `socket` config read, otherwise a config edit in dev restarts nothing.
+	*/
+	async restart() {
+		await this.shutdown();
+		await this.boot();
+		await this.start();
+	}
+	/**
 	* Shutdown Socket server
 	*
 	* Always closes the Socket.IO layer (and awaits the drain). The underlying
@@ -86,18 +114,58 @@ var SocketConnector = class extends BaseConnector {
 	async shutdown() {
 		if (!this.active) return;
 		const socket = container.tryGet("socket");
-		if (socket) await new Promise((resolve) => {
+		if (socket) if (this.ownsRawServer) await new Promise((resolve) => {
 			socket.close(() => resolve());
 		});
-		const rawServer = this.ownsRawServer ? container.tryGet("socket.rawServer") : void 0;
-		if (rawServer) await new Promise((resolve, reject) => {
-			rawServer.close((error) => {
-				if (error) reject(error);
-				else resolve();
-			});
-		});
+		else {
+			socket.of("/").disconnectSockets(true);
+			socket.engine.close();
+			this.restoreListeners();
+		}
 		this.active = false;
 	}
+	/**
+	* Current listeners of the events socket.io touches on a node server.
+	*/
+	snapshotListeners(server) {
+		const snapshot = /* @__PURE__ */ new Map();
+		for (const event of [
+			"request",
+			"upgrade",
+			"close",
+			"listening"
+		]) snapshot.set(event, server?.listeners?.(event)?.slice() ?? []);
+		return snapshot;
+	}
+	diffListeners(before, after) {
+		const added = [];
+		const removed = [];
+		for (const [event, listeners] of before) {
+			const now = after.get(event) ?? [];
+			for (const listener of now) if (!listeners.includes(listener)) added.push([event, listener]);
+			for (const listener of listeners) if (!now.includes(listener)) removed.push([event, listener]);
+		}
+		return {
+			added,
+			removed
+		};
+	}
+	/**
+	* Undo what attaching did to the shared server, leaving listeners other
+	* consumers added since (e.g. Vite's HMR upgrade handler) untouched.
+	*/
+	restoreListeners() {
+		const server = this.sharedServer;
+		if (!server) return;
+		const { added, removed } = this.attachedListeners;
+		for (const [event, listener] of added) server.removeListener(event, listener);
+		for (const [event, listener] of removed) server.on(event, listener);
+		this.attachedListeners = {
+			added: [],
+			removed: []
+		};
+		this.sharedServer = void 0;
+	}
 };
 
 //#endregion