@warlock.js/core 4.4.0 → 4.5.0

package/esm/ai/src/workflow/step.mjs

@@ -0,0 +1,37 @@
+import { WorkflowError } from "../errors/workflow-error.mjs";
+import "../errors/index.mjs";
+
+//#region ../@warlock.js/ai/src/workflow/step.ts
+/**
+* `ai.step(def)` — pass-through factory used for authoring. Returns
+* the definition object verbatim so the workflow engine can read it
+* during execution; the factory exists for API symmetry with
+* `ai.workflow()` and to leave room for future validation or
+* metadata annotation.
+*
+* Generics flow from the enclosing `ai.workflow<...>()` call when the
+* step is declared inline inside `steps: [...]`. To author a step
+* outside that context with full typing, pass them explicitly:
+* `ai.step<MyInput, MyState, MyContext>({ ... })`.
+*/
+function step(definition) {
+	validate(definition);
+	return definition;
+}
+function validate(def) {
+	if (!def.name || typeof def.name !== "string") throw new WorkflowError("ai.step: `name` is required");
+	const hasRun = typeof def.run === "function";
+	const hasAgent = def.agent !== void 0;
+	const modes = [
+		hasRun,
+		hasAgent,
+		Array.isArray(def.parallel) && def.parallel.length > 0
+	].filter(Boolean).length;
+	if (modes === 0) throw new WorkflowError(`ai.step("${def.name}"): must define exactly one of run | agent | parallel`);
+	if (modes > 1) throw new WorkflowError(`ai.step("${def.name}"): define only one of run | agent | parallel`);
+	if (hasAgent && typeof def.input !== "function") throw new WorkflowError(`ai.step("${def.name}"): \`input(ctx)\` is required when \`agent\` is set`);
+}
+
+//#endregion
+export { step };
+//# sourceMappingURL=step.mjs.map

package/esm/ai/src/workflow/step.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/workflow/step.ts"],"sourcesContent":["import type { StepDefinition } from \"../contracts/workflow/step.contract\";\nimport { WorkflowError } from \"../errors\";\n\n/**\n * `ai.step(def)` — pass-through factory used for authoring. Returns\n * the definition object verbatim so the workflow engine can read it\n * during execution; the factory exists for API symmetry with\n * `ai.workflow()` and to leave room for future validation or\n * metadata annotation.\n *\n * Generics flow from the enclosing `ai.workflow<...>()` call when the\n * step is declared inline inside `steps: [...]`. To author a step\n * outside that context with full typing, pass them explicitly:\n * `ai.step<MyInput, MyState, MyContext>({ ... })`.\n */\nexport function step<\n  TInput = unknown,\n  TState = Record<string, unknown>,\n  TContext = unknown,\n>(\n  definition: StepDefinition<TInput, TState, TContext>,\n): StepDefinition<TInput, TState, TContext> {\n  validate(definition);\n  return definition;\n}\n\nfunction validate<TInput, TState, TContext>(\n  def: StepDefinition<TInput, TState, TContext>,\n): void {\n  if (!def.name || typeof def.name !== \"string\") {\n    throw new WorkflowError(\"ai.step: `name` is required\");\n  }\n\n  const hasRun = typeof def.run === \"function\";\n  const hasAgent = def.agent !== undefined;\n  const hasParallel = Array.isArray(def.parallel) && def.parallel.length > 0;\n\n  const modes = [hasRun, hasAgent, hasParallel].filter(Boolean).length;\n\n  if (modes === 0) {\n    throw new WorkflowError(\n      `ai.step(\"${def.name}\"): must define exactly one of run | agent | parallel`,\n    );\n  }\n\n  if (modes > 1) {\n    throw new WorkflowError(\n      `ai.step(\"${def.name}\"): define only one of run | agent | parallel`,\n    );\n  }\n\n  if (hasAgent && typeof def.input !== \"function\") {\n    throw new WorkflowError(\n      `ai.step(\"${def.name}\"): \\`input(ctx)\\` is required when \\`agent\\` is set`,\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,SAAgB,KAKd,YAC0C;CAC1C,SAAS,UAAU;CACnB,OAAO;AACT;AAEA,SAAS,SACP,KACM;CACN,IAAI,CAAC,IAAI,QAAQ,OAAO,IAAI,SAAS,UACnC,MAAM,IAAI,cAAc,6BAA6B;CAGvD,MAAM,SAAS,OAAO,IAAI,QAAQ;CAClC,MAAM,WAAW,IAAI,UAAU;CAG/B,MAAM,QAAQ;EAAC;EAAQ;EAFH,MAAM,QAAQ,IAAI,QAAQ,KAAK,IAAI,SAAS,SAAS;CAE7B,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC;CAE9D,IAAI,UAAU,GACZ,MAAM,IAAI,cACR,YAAY,IAAI,KAAK,sDACvB;CAGF,IAAI,QAAQ,GACV,MAAM,IAAI,cACR,YAAY,IAAI,KAAK,8CACvB;CAGF,IAAI,YAAY,OAAO,IAAI,UAAU,YACnC,MAAM,IAAI,cACR,YAAY,IAAI,KAAK,qDACvB;AAEJ"}

package/esm/ai/src/workflow/workflow.mjs

@@ -0,0 +1,122 @@
+import { WorkflowError } from "../errors/workflow-error.mjs";
+import "../errors/index.mjs";
+import { notifyObservers } from "../observe/resolve-observers.mjs";
+import { asTool } from "./as-tool.mjs";
+import { WorkflowEmitter } from "./emitter.mjs";
+import { loadSnapshotForResume } from "./snapshot.mjs";
+import { runWorkflow } from "./engine.mjs";
+import { computeSignature } from "./signature.mjs";
+
+//#region ../@warlock.js/ai/src/workflow/workflow.ts
+/**
+* `ai.workflow(def)` — construct a `WorkflowInstance`. Validates the
+* definition, computes a stable structural signature, and wires up the
+* three-tier event subscription model.
+*/
+function workflow(definition) {
+	validate(definition);
+	const signature = computeSignature(definition);
+	const emitter = new WorkflowEmitter(definition.on);
+	async function execute(inputOrOptions, maybeOptions) {
+		const { input, options } = normalizeExecuteArgs(inputOrOptions, maybeOptions);
+		const runId = options?.runId ?? generateRunId();
+		const result = await runWorkflow({
+			definition,
+			signature,
+			emitter,
+			input,
+			context: options?.context,
+			runId,
+			signal: options?.signal,
+			executionHandlers: options?.on,
+			sessionId: options?.sessionId
+		});
+		await notifyObservers(definition.observe, result.report);
+		return result;
+	}
+	async function resume(runId, options) {
+		const snapshot = await loadSnapshotForResume({
+			definition,
+			signature,
+			runId,
+			options
+		});
+		const result = await runWorkflow({
+			definition,
+			signature,
+			emitter,
+			input: snapshot.input,
+			context: options?.context,
+			runId,
+			signal: options?.signal,
+			executionHandlers: options?.on,
+			sessionId: options?.sessionId,
+			resumeFrom: snapshot
+		});
+		await notifyObservers(definition.observe, result.report);
+		return result;
+	}
+	const instance = {
+		name: definition.name,
+		description: definition.description,
+		inputSchema: definition.inputSchema,
+		signature,
+		version: definition.version,
+		execute,
+		resume,
+		on(event, handler) {
+			return emitter.on(event, handler);
+		},
+		off(event, handler) {
+			emitter.off(event, handler);
+		},
+		asTool(options) {
+			return asTool(instance, options);
+		}
+	};
+	return instance;
+}
+/**
+* Resolve the overloaded `execute()` call shape. If the caller passed
+* a single plain object with an `input` field, treat it as the
+* combined `WorkflowExecuteOptions`. Otherwise the first arg is the
+* raw workflow input and the second is the run options.
+*
+* Ambiguity note: if your real workflow `input` is itself an object
+* with a top-level `input` key, prefer `execute(rawInput, options)`
+* explicitly — the single-arg detection heuristic would mis-classify
+* it.
+*/
+function normalizeExecuteArgs(inputOrOptions, maybeOptions) {
+	if (maybeOptions === void 0 && inputOrOptions !== null && typeof inputOrOptions === "object" && "input" in inputOrOptions) {
+		const { input, ...options } = inputOrOptions;
+		return {
+			input,
+			options
+		};
+	}
+	return {
+		input: inputOrOptions,
+		options: maybeOptions
+	};
+}
+function validate(definition) {
+	if (!definition.name || typeof definition.name !== "string") throw new WorkflowError("ai.workflow: `name` is required");
+	if (!Array.isArray(definition.steps) || definition.steps.length === 0) throw new WorkflowError(`ai.workflow("${definition.name}"): at least one step is required`);
+	const seen = /* @__PURE__ */ new Set();
+	const walk = (name) => {
+		if (seen.has(name)) throw new WorkflowError(`ai.workflow("${definition.name}"): duplicate step name "${name}"`);
+		seen.add(name);
+	};
+	for (const step of definition.steps) {
+		walk(step.name);
+		if (step.parallel) for (const child of step.parallel) walk(child.name);
+	}
+}
+function generateRunId() {
+	return `wf_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+}
+
+//#endregion
+export { workflow };
+//# sourceMappingURL=workflow.mjs.map

package/esm/ai/src/workflow/workflow.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.mjs","names":["combined"],"sources":["../../../../../../../../../@warlock.js/ai/src/workflow/workflow.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { WorkflowEventMap } from \"../contracts/events/event-map.type\";\nimport type { ExecutionReport } from \"../contracts/result/execution-report.type\";\nimport type { WorkflowResult } from \"../contracts/result/workflow-result.type\";\nimport type {\n  WorkflowDefinition,\n  WorkflowEventHandler,\n  WorkflowExecuteOptions,\n  WorkflowInstance,\n  WorkflowResumeOptions,\n  WorkflowRunOptions,\n} from \"../contracts/workflow/workflow.contract\";\nimport { WorkflowError } from \"../errors\";\nimport { notifyObservers } from \"../observe/resolve-observers\";\nimport type { ToolContract } from \"../tool/tool\";\nimport { asTool } from \"./as-tool\";\nimport { WorkflowEmitter } from \"./emitter\";\nimport { loadSnapshotForResume, runWorkflow } from \"./engine\";\nimport { computeSignature } from \"./signature\";\n\n/**\n * `ai.workflow(def)` — construct a `WorkflowInstance`. Validates the\n * definition, computes a stable structural signature, and wires up the\n * three-tier event subscription model.\n */\nexport function workflow<\n  TInput = unknown,\n  TOutput = unknown,\n  TState = Record<string, unknown>,\n  TContext = unknown,\n>(\n  definition: WorkflowDefinition<TInput, TOutput, TState, TContext>,\n): WorkflowInstance<TInput, TOutput, TState, TContext> {\n  validate(definition);\n  const signature = computeSignature(definition);\n  const emitter = new WorkflowEmitter(definition.on);\n\n  async function execute(\n    inputOrOptions: TInput | WorkflowExecuteOptions<TInput, TContext>,\n    maybeOptions?: WorkflowRunOptions<TContext>,\n  ): Promise<WorkflowResult<TOutput>> {\n    const { input, options } = normalizeExecuteArgs<TInput, TContext>(\n      inputOrOptions,\n      maybeOptions,\n    );\n    const runId = options?.runId ?? generateRunId();\n    const result = await runWorkflow<TOutput>({\n      definition,\n      signature,\n      emitter,\n      input,\n      context: options?.context,\n      runId,\n      signal: options?.signal,\n      executionHandlers: options?.on,\n      sessionId: options?.sessionId,\n    });\n\n    // Route the finished report to any resolved observers (F1/F3).\n    // Gated by `definition.observe` + the global observe-all flag;\n    // observer errors are swallowed inside `notifyObservers`. Bridge the\n    // pre-existing `WorkflowReport = Omit<BaseReport, \"type\">` drift (the\n    // report carries `type: \"workflow\"` at runtime — engine sets it) so\n    // this call site adds no new type error beyond the documented baseline.\n    await notifyObservers(definition.observe, result.report as unknown as ExecutionReport);\n\n    return result;\n  }\n\n  async function resume(\n    runId: string,\n    options?: WorkflowResumeOptions<TContext>,\n  ): Promise<WorkflowResult<TOutput>> {\n    const snapshot = await loadSnapshotForResume({\n      definition,\n      signature,\n      runId,\n      options,\n    });\n\n    const result = await runWorkflow<TOutput>({\n      definition,\n      signature,\n      emitter,\n      input: snapshot.input,\n      context: options?.context,\n      runId,\n      signal: options?.signal,\n      executionHandlers: options?.on,\n      sessionId: options?.sessionId,\n      resumeFrom: snapshot,\n    });\n\n    await notifyObservers(definition.observe, result.report as unknown as ExecutionReport);\n\n    return result;\n  }\n\n  const instance: WorkflowInstance<TInput, TOutput, TState, TContext> = {\n    name: definition.name,\n    description: definition.description,\n    inputSchema: definition.inputSchema,\n    signature,\n    version: definition.version,\n    execute,\n    resume,\n    on<K extends keyof WorkflowEventMap>(event: K, handler: WorkflowEventHandler<K>) {\n      return emitter.on(event, handler);\n    },\n    off<K extends keyof WorkflowEventMap>(event: K, handler: WorkflowEventHandler<K>) {\n      emitter.off(event, handler);\n    },\n    asTool<TToolInput = TInput>(options: {\n      description?: string;\n      inputSchema: StandardSchemaV1<TToolInput>;\n    }): ToolContract<TToolInput, TOutput> {\n      return asTool<TInput, TOutput, TToolInput>(instance, options);\n    },\n  };\n\n  return instance;\n}\n\n/**\n * Resolve the overloaded `execute()` call shape. If the caller passed\n * a single plain object with an `input` field, treat it as the\n * combined `WorkflowExecuteOptions`. Otherwise the first arg is the\n * raw workflow input and the second is the run options.\n *\n * Ambiguity note: if your real workflow `input` is itself an object\n * with a top-level `input` key, prefer `execute(rawInput, options)`\n * explicitly — the single-arg detection heuristic would mis-classify\n * it.\n */\nfunction normalizeExecuteArgs<TInput, TContext>(\n  inputOrOptions: TInput | WorkflowExecuteOptions<TInput, TContext>,\n  maybeOptions: WorkflowRunOptions<TContext> | undefined,\n): { input: TInput; options?: WorkflowRunOptions<TContext> } {\n  if (\n    maybeOptions === undefined &&\n    inputOrOptions !== null &&\n    typeof inputOrOptions === \"object\" &&\n    \"input\" in (inputOrOptions as object)\n  ) {\n    const combined = inputOrOptions as WorkflowExecuteOptions<TInput, TContext>;\n    const { input, ...options } = combined;\n    return { input, options };\n  }\n\n  return { input: inputOrOptions as TInput, options: maybeOptions };\n}\n\nfunction validate<TInput, TOutput, TState, TContext>(\n  definition: WorkflowDefinition<TInput, TOutput, TState, TContext>,\n): void {\n  if (!definition.name || typeof definition.name !== \"string\") {\n    throw new WorkflowError(\"ai.workflow: `name` is required\");\n  }\n\n  if (!Array.isArray(definition.steps) || definition.steps.length === 0) {\n    throw new WorkflowError(`ai.workflow(\"${definition.name}\"): at least one step is required`);\n  }\n\n  const seen = new Set<string>();\n  const walk = (name: string) => {\n    if (seen.has(name)) {\n      throw new WorkflowError(`ai.workflow(\"${definition.name}\"): duplicate step name \"${name}\"`);\n    }\n    seen.add(name);\n  };\n\n  for (const step of definition.steps) {\n    walk(step.name);\n\n    if (step.parallel) {\n      for (const child of step.parallel) {\n        walk(child.name);\n      }\n    }\n  }\n}\n\nfunction generateRunId(): string {\n  // Non-crypto random — adequate for ephemeral workflow runs.\n  return `wf_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAyBA,SAAgB,SAMd,YACqD;CACrD,SAAS,UAAU;CACnB,MAAM,YAAY,iBAAiB,UAAU;CAC7C,MAAM,UAAU,IAAI,gBAAgB,WAAW,EAAE;CAEjD,eAAe,QACb,gBACA,cACkC;EAClC,MAAM,EAAE,OAAO,YAAY,qBACzB,gBACA,YACF;EACA,MAAM,QAAQ,SAAS,SAAS,cAAc;EAC9C,MAAM,SAAS,MAAM,YAAqB;GACxC;GACA;GACA;GACA;GACA,SAAS,SAAS;GAClB;GACA,QAAQ,SAAS;GACjB,mBAAmB,SAAS;GAC5B,WAAW,SAAS;EACtB,CAAC;EAQD,MAAM,gBAAgB,WAAW,SAAS,OAAO,MAAoC;EAErF,OAAO;CACT;CAEA,eAAe,OACb,OACA,SACkC;EAClC,MAAM,WAAW,MAAM,sBAAsB;GAC3C;GACA;GACA;GACA;EACF,CAAC;EAED,MAAM,SAAS,MAAM,YAAqB;GACxC;GACA;GACA;GACA,OAAO,SAAS;GAChB,SAAS,SAAS;GAClB;GACA,QAAQ,SAAS;GACjB,mBAAmB,SAAS;GAC5B,WAAW,SAAS;GACpB,YAAY;EACd,CAAC;EAED,MAAM,gBAAgB,WAAW,SAAS,OAAO,MAAoC;EAErF,OAAO;CACT;CAEA,MAAM,WAAgE;EACpE,MAAM,WAAW;EACjB,aAAa,WAAW;EACxB,aAAa,WAAW;EACxB;EACA,SAAS,WAAW;EACpB;EACA;EACA,GAAqC,OAAU,SAAkC;GAC/E,OAAO,QAAQ,GAAG,OAAO,OAAO;EAClC;EACA,IAAsC,OAAU,SAAkC;GAChF,QAAQ,IAAI,OAAO,OAAO;EAC5B;EACA,OAA4B,SAGU;GACpC,OAAO,OAAoC,UAAU,OAAO;EAC9D;CACF;CAEA,OAAO;AACT;;;;;;;;;;;;AAaA,SAAS,qBACP,gBACA,cAC2D;CAC3D,IACE,iBAAiB,UACjB,mBAAmB,QACnB,OAAO,mBAAmB,YAC1B,WAAY,gBACZ;EAEA,MAAM,EAAE,OAAO,GAAG,YAAYA;EAC9B,OAAO;GAAE;GAAO;EAAQ;CAC1B;CAEA,OAAO;EAAE,OAAO;EAA0B,SAAS;CAAa;AAClE;AAEA,SAAS,SACP,YACM;CACN,IAAI,CAAC,WAAW,QAAQ,OAAO,WAAW,SAAS,UACjD,MAAM,IAAI,cAAc,iCAAiC;CAG3D,IAAI,CAAC,MAAM,QAAQ,WAAW,KAAK,KAAK,WAAW,MAAM,WAAW,GAClE,MAAM,IAAI,cAAc,gBAAgB,WAAW,KAAK,kCAAkC;CAG5F,MAAM,uBAAO,IAAI,IAAY;CAC7B,MAAM,QAAQ,SAAiB;EAC7B,IAAI,KAAK,IAAI,IAAI,GACf,MAAM,IAAI,cAAc,gBAAgB,WAAW,KAAK,2BAA2B,KAAK,EAAE;EAE5F,KAAK,IAAI,IAAI;CACf;CAEA,KAAK,MAAM,QAAQ,WAAW,OAAO;EACnC,KAAK,KAAK,IAAI;EAEd,IAAI,KAAK,UACP,KAAK,MAAM,SAAS,KAAK,UACvB,KAAK,MAAM,IAAI;CAGrB;AACF;AAEA,SAAS,gBAAwB;CAE/B,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,GAAG,EAAE;AAChF"}

package/esm/ai-openai/src/embedder.mjs

@@ -0,0 +1,4 @@
+import "./utils/index.mjs";
+import { log } from "@warlock.js/logger";
+
+export {  };

package/esm/ai-openai/src/index.mjs

@@ -0,0 +1,4 @@
+import "./embedder.mjs";
+import "./sdk.mjs";
+
+export {  };

package/esm/ai-openai/src/model.mjs

@@ -0,0 +1,5 @@
+import "../../ai/src/index.mjs";
+import "./utils/index.mjs";
+import { log } from "@warlock.js/logger";
+
+export {  };

package/esm/ai-openai/src/sdk.mjs

@@ -0,0 +1,6 @@
+import "../../node_modules/openai/index.mjs";
+import "../../ai/src/index.mjs";
+import "./embedder.mjs";
+import "./model.mjs";
+
+export {  };

package/esm/ai-openai/src/utils/index.mjs

@@ -0,0 +1,4 @@
+import "./to-openai-tools.mjs";
+import "./wrap-openai-error.mjs";
+
+export {  };

package/esm/ai-openai/src/utils/to-openai-tools.mjs

@@ -0,0 +1,3 @@
+import "../../../ai/src/index.mjs";
+
+export {  };

package/esm/ai-openai/src/utils/wrap-openai-error.mjs

@@ -0,0 +1,4 @@
+import "../../../node_modules/openai/index.mjs";
+import "../../../ai/src/index.mjs";
+
+export {  };

package/esm/cli/commands/dev-server.command.mjs

@@ -19,7 +19,7 @@ const devServerCommand = command({
 		await displayStartupBanner({ environment: "development" });
 	},
 	action: async (data) => {
-		await startDevelopmentServer({
+		startDevelopmentServer({
 			fresh: Boolean(data.options.fresh),
 			generateTypings: data.options.skipTypings ? false : void 0,
 			healthCheckers: data.options.skipHealth ? false : void 0

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

@@ -1 +1 @@
-{"version":3,"file":"dev-server.command.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/cli/commands/dev-server.command.ts"],"sourcesContent":["import { checkForFrameworkUpdate } from \"../../dev-server/check-for-updates\";\r\nimport { startDevelopmentServer } from \"../../dev-server/start-development-server\";\r\nimport { command } from \"../cli-command\";\r\nimport { displayStartupBanner } from \"../cli-commands.utils\";\r\n\r\nexport const devServerCommand = command({\r\n  name: \"dev\",\r\n  description: \"Start development server (HMR, type-gen, health checks)\",\r\n  persistent: true,\r\n  preload: {\r\n    runtimeStrategy: \"development\",\r\n    config: true, // load all config\r\n    bootstrap: true,\r\n    prestart: true, // load prestart file (if exists)\r\n    // Only the Early lifecycle phase starts here; the Late phase\r\n    // (http, socket) starts after app modules load — see\r\n    // development-server.ts STEP 8.5.\r\n    connectors: true,\r\n  },\r\n  preAction: async () => {\r\n    await displayStartupBanner({ environment: \"development\" });\r\n  },\r\n  action: async (data) => {\r\n    await startDevelopmentServer({\r\n      fresh: Boolean(data.options.fresh),\r\n      // Pass `false` only when the CLI flag is explicitly set; `undefined`\r\n      // lets `warlock.config.ts > devServer.*` defaults apply.\r\n      generateTypings: data.options.skipTypings ? false : undefined,\r\n      healthCheckers: data.options.skipHealth ? false : undefined,\r\n    });\r\n\r\n    // Fire-and-forget: once the server is ready, surface a one-line notice if\r\n    // a newer @warlock.js/core has been published. Fully self-guarded — it\r\n    // never blocks startup nor breaks dev if the registry is unreachable.\r\n    void checkForFrameworkUpdate();\r\n  },\r\n  options: [\r\n    {\r\n      text: \"--fresh, -f\",\r\n      description: \"Delete .warlock/manifest.json before start (force full re-parse from disk)\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--skip-typings, -st\",\r\n      description: \"Skip background type generation for this run\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--skip-health, -sh\",\r\n      description: \"Skip file health checkers for this run\",\r\n      type: \"boolean\",\r\n    },\r\n  ],\r\n});\r\n"],"mappings":";;;;;;AAKA,MAAa,mBAAmB,QAAQ;CACtC,MAAM;CACN,aAAa;CACb,YAAY;CACZ,SAAS;EACP,iBAAiB;EACjB,QAAQ;EACR,WAAW;EACX,UAAU;EAIV,YAAY;CACd;CACA,WAAW,YAAY;EACrB,MAAM,qBAAqB,EAAE,aAAa,cAAc,CAAC;CAC3D;CACA,QAAQ,OAAO,SAAS;EACtB,MAAM,uBAAuB;GAC3B,OAAO,QAAQ,KAAK,QAAQ,KAAK;GAGjC,iBAAiB,KAAK,QAAQ,cAAc,QAAQ;GACpD,gBAAgB,KAAK,QAAQ,aAAa,QAAQ;EACpD,CAAC;EAKD,AAAK,wBAAwB;CAC/B;CACA,SAAS;EACP;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;CACF;AACF,CAAC"}
+{"version":3,"file":"dev-server.command.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/cli/commands/dev-server.command.ts"],"sourcesContent":["import { checkForFrameworkUpdate } from \"../../dev-server/check-for-updates\";\r\nimport { startDevelopmentServer } from \"../../dev-server/start-development-server\";\r\nimport { command } from \"../cli-command\";\r\nimport { displayStartupBanner } from \"../cli-commands.utils\";\r\n\r\nexport const devServerCommand = command({\r\n  name: \"dev\",\r\n  description: \"Start development server (HMR, type-gen, health checks)\",\r\n  persistent: true,\r\n  preload: {\r\n    runtimeStrategy: \"development\",\r\n    config: true, // load all config\r\n    bootstrap: true,\r\n    prestart: true, // load prestart file (if exists)\r\n    // Only the Early lifecycle phase starts here; the Late phase\r\n    // (http, socket) starts after app modules load — see\r\n    // development-server.ts STEP 8.5.\r\n    connectors: true,\r\n  },\r\n  preAction: async () => {\r\n    await displayStartupBanner({ environment: \"development\" });\r\n  },\r\n  action: async (data) => {\r\n    startDevelopmentServer({\r\n      fresh: Boolean(data.options.fresh),\r\n      // Pass `false` only when the CLI flag is explicitly set; `undefined`\r\n      // lets `warlock.config.ts > devServer.*` defaults apply.\r\n      generateTypings: data.options.skipTypings ? false : undefined,\r\n      healthCheckers: data.options.skipHealth ? false : undefined,\r\n    });\r\n\r\n    // Fire-and-forget: once the server is ready, surface a one-line notice if\r\n    // a newer @warlock.js/core has been published. Fully self-guarded — it\r\n    // never blocks startup nor breaks dev if the registry is unreachable.\r\n    void checkForFrameworkUpdate();\r\n  },\r\n  options: [\r\n    {\r\n      text: \"--fresh, -f\",\r\n      description: \"Delete .warlock/manifest.json before start (force full re-parse from disk)\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--skip-typings, -st\",\r\n      description: \"Skip background type generation for this run\",\r\n      type: \"boolean\",\r\n    },\r\n    {\r\n      text: \"--skip-health, -sh\",\r\n      description: \"Skip file health checkers for this run\",\r\n      type: \"boolean\",\r\n    },\r\n  ],\r\n});\r\n"],"mappings":";;;;;;AAKA,MAAa,mBAAmB,QAAQ;CACtC,MAAM;CACN,aAAa;CACb,YAAY;CACZ,SAAS;EACP,iBAAiB;EACjB,QAAQ;EACR,WAAW;EACX,UAAU;EAIV,YAAY;CACd;CACA,WAAW,YAAY;EACrB,MAAM,qBAAqB,EAAE,aAAa,cAAc,CAAC;CAC3D;CACA,QAAQ,OAAO,SAAS;EACtB,uBAAuB;GACrB,OAAO,QAAQ,KAAK,QAAQ,KAAK;GAGjC,iBAAiB,KAAK,QAAQ,cAAc,QAAQ;GACpD,gBAAgB,KAAK,QAAQ,aAAa,QAAQ;EACpD,CAAC;EAKD,AAAK,wBAAwB;CAC/B;CACA,SAAS;EACP;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;EACA;GACE,MAAM;GACN,aAAa;GACb,MAAM;EACR;CACF;AACF,CAAC"}

package/esm/cli/commands/generate/templates/stubs.mjs

@@ -174,7 +174,7 @@ function crudModelStub(moduleName) {
 	const singular = moduleName.singular;
 	const plural = moduleName.plural;
 	return `import { Model, RegisterModel } from "@warlock.js/cascade";
-import { type Infer, v } from "@warlock.js/core";
+import { type Infer, v } from "@warlock.js/seal";
 import { ${singular.pascal}Resource } from "app/${plural.kebab}/resources/${singular.kebab}.resource";
 
 export const ${singular.camel}Schema = v.object({
@@ -442,9 +442,8 @@ export type ${name.pascal}Schema = Infer<typeof ${name.camel}Schema>;
 */
 function modelStub(name, options = {}) {
 	const { tableName = `${name.plural.snake}`, withResource } = options;
-	return `import { Model } from "@warlock.js/core";
-import type { StrictMode } from "@warlock.js/cascade";
-import { v, type Infer } from "@warlock.js/core";
+	return `import { Model, type StrictMode } from "@warlock.js/cascade";
+import { v, type Infer } from "@warlock.js/seal";
 ${withResource ? `import { ${name.singular.pascal}Resource } from "../../resources/${name.singular.kebab}.resource";` : ""}
 
 const ${name.singular.camel}Schema = v.object({

package/esm/cli/commands/generate/templates/stubs.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"stubs.mjs","names":[],"sources":["../../../../../../../../../../@warlock.js/core/src/cli/commands/generate/templates/stubs.ts"],"sourcesContent":["import type { ParsedName } from \"../types\";\r\nimport { Name } from \"../utils/name-parser\";\r\n\r\n/**\r\n * Controller template stub\r\n *\r\n * Controllers default to the guarded handler type since application\r\n * routes run behind `guarded()`. When `withValidation` is set, the\r\n * schema's exported type + value are imported directly from the\r\n * `schema/` folder and bound to the handler — no `requests/` alias.\r\n */\r\nexport function controllerStub(\r\n  name: ParsedName,\r\n  options: { withValidation?: boolean } = {},\r\n): string {\r\n  const { withValidation } = options;\r\n\r\n  if (!withValidation) {\r\n    return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\r\n\r\nexport const ${name.camel}Controller: GuardedRequestHandler = async (request, response) => {\r\n  // TODO: Implement controller logic\r\n  return response.success({});\r\n};\r\n`;\r\n  }\r\n\r\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\r\nimport { type ${name.pascal}Schema, ${name.camel}Schema } from \"../schema/${name.kebab}.schema\";\r\n\r\nexport const ${name.camel}Controller: GuardedRequestHandler<${name.pascal}Schema> = async (\r\n  request,\r\n  response,\r\n) => {\r\n  // TODO: Implement controller logic\r\n  return response.success({});\r\n};\r\n\r\n${name.camel}Controller.validation = {\r\n  schema: ${name.camel}Schema,\r\n};\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Create Controller template\r\n * Note: moduleName is the module (plural), we need singular entity name\r\n */\r\nexport function crudCreateControllerStub(moduleName: Name): string {\r\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\r\nimport { type Create${moduleName.pascal}Schema, create${moduleName.pascal}Schema } from \"../schema/create-${moduleName.kebab}.schema\";\r\nimport { create${moduleName.pascal}Service } from \"../services/create-${moduleName.kebab}.service\";\r\n\r\nexport const create${moduleName.pascal}Controller: GuardedRequestHandler<Create${moduleName.pascal}Schema> = async (\r\n  request,\r\n  response,\r\n) => {\r\n  const ${moduleName.camel} = await create${moduleName.pascal}Service(request.validated());\r\n\r\n  return response.successCreate({\r\n    ${moduleName.camel},\r\n  });\r\n};\r\n\r\ncreate${moduleName.pascal}Controller.validation = {\r\n  schema: create${moduleName.pascal}Schema,\r\n};\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Update Controller template\r\n */\r\nexport function crudUpdateControllerStub(moduleName: Name): string {\r\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\r\nimport { type Update${moduleName.pascal}Schema, update${moduleName.pascal}Schema } from \"../schema/update-${moduleName.kebab}.schema\";\r\nimport { update${moduleName.pascal}Service } from \"../services/update-${moduleName.kebab}.service\";\r\n\r\nexport const update${moduleName.pascal}Controller: GuardedRequestHandler<Update${moduleName.pascal}Schema> = async (\r\n  request,\r\n  response,\r\n) => {\r\n  const ${moduleName.camel} = await update${moduleName.pascal}Service(request.input(\"id\"), request.validated());\r\n\r\n  return response.success({\r\n    ${moduleName.camel},\r\n  });\r\n};\r\n\r\nupdate${moduleName.pascal}Controller.validation = {\r\n  schema: update${moduleName.pascal}Schema,\r\n};\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD List Controller template\r\n */\r\nexport function crudListControllerStub(moduleName: Name): string {\r\n  const plural = moduleName.plural;\r\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\r\nimport { list${plural.pascal}Service } from \"../services/list-${plural.kebab}.service\";\r\n\r\nexport const list${plural.pascal}Controller: GuardedRequestHandler = async (\r\n  request,\r\n  response,\r\n) => {\r\n  const { data, pagination } = await list${plural.pascal}Service(request.all());\r\n\r\n  return response.success({\r\n    data,\r\n    pagination,\r\n  });\r\n};\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Show/Get Controller template\r\n */\r\nexport function crudShowControllerStub(moduleName: Name): string {\r\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\r\nimport { get${moduleName.pascal}Service } from \"../services/get-${moduleName.kebab}.service\";\r\n\r\nexport const get${moduleName.pascal}Controller: GuardedRequestHandler = async (\r\n  request,\r\n  response,\r\n) => {\r\n  const ${moduleName.camel} = await get${moduleName.pascal}Service(request.input(\"id\"));\r\n\r\n  if (!${moduleName.camel}) {\r\n    return response.notFound();\r\n  }\r\n\r\n  return response.success({\r\n    ${moduleName.camel},\r\n  });\r\n};\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Delete Controller template\r\n */\r\nexport function crudDeleteControllerStub(moduleName: Name): string {\r\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\r\nimport { delete${moduleName.pascal}Service } from \"../services/delete-${moduleName.kebab}.service\";\r\n\r\nexport const delete${moduleName.pascal}Controller: GuardedRequestHandler = async (\r\n  request,\r\n  response,\r\n) => {\r\n  await delete${moduleName.pascal}Service(request.input(\"id\"));\r\n\r\n  return response.noContent();\r\n};\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Routes template\r\n */\r\nexport function crudRoutesStub(moduleName: Name): string {\r\n  const singular = moduleName.singular;\r\n  const plural = moduleName.plural;\r\n\r\n  return `import { router } from \"@warlock.js/core\";\r\nimport { guarded } from \"app/shared/utils/router\";\r\nimport { create${singular.pascal}Controller } from \"./controllers/create-${singular.kebab}.controller\";\r\nimport { delete${singular.pascal}Controller } from \"./controllers/delete-${singular.kebab}.controller\";\r\nimport { get${singular.pascal}Controller } from \"./controllers/get-${singular.kebab}.controller\";\r\nimport { list${plural.pascal}Controller } from \"./controllers/list-${plural.kebab}.controller\";\r\nimport { update${singular.pascal}Controller } from \"./controllers/update-${singular.kebab}.controller\";\r\n\r\nguarded(() => {\r\n  router\r\n    .route(\"/${plural.kebab}\")\r\n    .list(list${plural.pascal}Controller)\r\n    .show(get${singular.pascal}Controller)\r\n    .create(create${singular.pascal}Controller)\r\n    .update(update${singular.pascal}Controller)\r\n    .destroy(delete${singular.pascal}Controller);\r\n});\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Model template\r\n */\r\nexport function crudModelStub(moduleName: Name): string {\r\n  const singular = moduleName.singular;\r\n  const plural = moduleName.plural;\r\n\r\n  return `import { Model, RegisterModel } from \"@warlock.js/cascade\";\r\nimport { type Infer, v } from \"@warlock.js/core\";\r\nimport { ${singular.pascal}Resource } from \"app/${plural.kebab}/resources/${singular.kebab}.resource\";\r\n\r\nexport const ${singular.camel}Schema = v.object({\r\n  // TODO: Add more fields\r\n});\r\n\r\nexport type ${singular.pascal}Schema = Infer.Output<typeof ${singular.camel}Schema>;\r\n\r\n@RegisterModel()\r\nexport class ${singular.pascal} extends Model<${singular.pascal}Schema> {\r\n  public static table = \"${plural.snake}\";\r\n\r\n  public static schema = ${singular.camel}Schema;\r\n\r\n  public static relations = {};\r\n\r\n  public static resource = ${singular.pascal}Resource;\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Resource template\r\n */\r\nexport function crudResourceStub(moduleName: Name): string {\r\n  // Get singular entity name\r\n  const entity = moduleName.singular;\r\n\r\n  return `import { defineResource } from \"@warlock.js/core\";\r\n\r\nexport const ${entity.pascal}Resource = defineResource({\r\n  schema: {\r\n    id: \"number\",\r\n    // TODO: Add more resource fields\r\n  },\r\n});\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Repository template\r\n */\r\nexport function crudRepositoryStub(entity: Name): string {\r\n  const moduleSingularName = entity.singular;\r\n  const modulePluralName = entity.plural;\r\n  return `import type { FilterRules, TypedRepositoryOptions } from \"@warlock.js/core\";\r\nimport { RepositoryManager } from \"@warlock.js/core\";\r\nimport { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\r\n\r\ntype ${moduleSingularName.pascal}ListFilter = {\r\n  // Repository list filters\r\n};\r\n\r\nexport type ${moduleSingularName.pascal}ListOptions = TypedRepositoryOptions<${moduleSingularName.pascal}ListFilter>;\r\n\r\nclass ${modulePluralName.pascal}Repository extends RepositoryManager<${moduleSingularName.pascal}, ${moduleSingularName.pascal}ListOptions> {\r\n  public source = ${moduleSingularName.pascal};\r\n\r\n  public simpleSelectColumns: string[] = [\"id\"];\r\n\r\n  public filterBy: FilterRules = {\r\n    id: \"=\",\r\n  };\r\n\r\n  public defaultOptions: RepositoryOptions = {\r\n    orderBy: {\r\n      id: \"desc\",\r\n    },\r\n  };\r\n}\r\n\r\nexport const ${modulePluralName.camel}Repository = new ${modulePluralName.pascal}Repository();\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Create Service template\r\n */\r\nexport function crudCreateServiceStub(entity: Name): string {\r\n  const moduleSingularName = entity.singular;\r\n  return `import { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\r\nimport type { Create${moduleSingularName.pascal}Schema } from \"../schema/create-${moduleSingularName.kebab}.schema\";\r\n\r\nexport async function create${moduleSingularName.pascal}Service(data: Create${moduleSingularName.pascal}Schema) {\r\n  const ${moduleSingularName.camel} = await ${moduleSingularName.pascal}.create(data);\r\n  return ${moduleSingularName.camel};\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Update Service template\r\n */\r\nexport function crudUpdateServiceStub(entity: Name): string {\r\n  const moduleSingularName = entity.singular;\r\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\r\nimport { get${moduleSingularName.pascal}Service } from \"./get-${moduleSingularName.kebab}.service\";\r\nimport type { Update${moduleSingularName.pascal}Schema } from \"../schema/update-${moduleSingularName.kebab}.schema\";\r\n\r\nexport async function update${moduleSingularName.pascal}Service(id: number | string, data: Update${moduleSingularName.pascal}Schema) {\r\n  const ${moduleSingularName.camel} = await get${moduleSingularName.pascal}Service(id);\r\n\r\n  await ${moduleSingularName.camel}.save({ merge: data });\r\n  return ${moduleSingularName.camel};\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD List Service template\r\n */\r\nexport function crudListServiceStub(entity: Name): string {\r\n  const modulePluralName = entity.plural;\r\n  return `import { ${modulePluralName.camel}Repository } from \"../repositories/${modulePluralName.kebab}.repository\";\r\n\r\nexport async function list${modulePluralName.pascal}Service(filters: any) {\r\n  return ${modulePluralName.camel}Repository.listCached(filters);\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Get Service template\r\n */\r\nexport function crudGetServiceStub(entity: Name): string {\r\n  return `import { ${entity.plural.camel}Repository } from \"../repositories/${entity.plural.kebab}.repository\";\r\nimport { ResourceNotFoundError } from \"@warlock.js/core\";\r\n\r\nexport async function get${entity.singular.pascal}Service(id: number | string) {\r\n  const ${entity.singular.camel} = await ${entity.plural.camel}Repository.getCached(id);\r\n\r\n  if (!${entity.singular.camel}) {\r\n    throw new ResourceNotFoundError(\"${entity.singular.pascal} resource not found!\");\r\n  }\r\n\r\n  return ${entity.singular.camel};\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Delete Service template\r\n */\r\nexport function crudDeleteServiceStub(entity: Name): string {\r\n  const singular = entity.singular;\r\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\r\nimport { get${singular.pascal}Service } from \"./get-${singular.kebab}.service\";\r\n\r\nexport async function delete${singular.pascal}Service(id: number | string) {\r\n  const ${singular.camel} = await get${singular.pascal}Service(id);\r\n  if (!${singular.camel}) {\r\n    throw new ResourceNotFoundError(\"${singular.pascal} not found\");\r\n  }\r\n  await ${singular.camel}.destroy();\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Seed template\r\n */\r\nexport function crudSeedStub(entity: Name): string {\r\n  return `import { seeder } from \"@warlock.js/core\";\r\nimport { ${entity.singular.pascal} } from \"../models/${entity.singular.kebab}\";\r\n\r\nexport default seeder({\r\n  name: \"Seed ${entity.plural.pascal}\",\r\n  once: true,\r\n  enabled: true,\r\n  run: async () => {\r\n    const total = 10;\r\n    for (let i = 0; i < total; i++) {\r\n      await ${entity.singular.pascal}.create({\r\n        // TODO: Add more fields\r\n      });\r\n    }\r\n\r\n    return {\r\n      recordsCreated: total,\r\n    };\r\n  },\r\n});\r\n`;\r\n}\r\n\r\n/**\r\n * Migration template\r\n */\r\n/**\r\n * Migration Create template\r\n */\r\nexport function migrationStub(\r\n  entityName: ParsedName,\r\n  options: {\r\n    columns?: string;\r\n    imports?: string[];\r\n    timestamps?: boolean;\r\n    tableName?: string;\r\n  } = {},\r\n): string {\r\n  const { columns = \"\", imports = [], timestamps = true } = options;\r\n\r\n  const allImports = [\"Migration\", ...imports].join(\", \");\r\n\r\n  let optionsString = \"\";\r\n  if (timestamps === false) {\r\n    optionsString = `, { timestamps: false }`;\r\n  }\r\n\r\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\r\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\r\n\r\nexport default Migration.create(${entityName.pascal}, {\r\n${columns ? columns : \"  // add your columns here, id is auto added to the list\"}\r\n}${optionsString});\r\n`;\r\n}\r\n\r\n/**\r\n * Migration Alter template\r\n */\r\nexport function migrationAlterStub(\r\n  entityName: ParsedName,\r\n  options: {\r\n    add?: string;\r\n    drop?: string; // stringified array like `\"[\\\"col1\\\", \\\"col2\\\"]\"`\r\n    rename?: string; // stringified object like `{ old: \"new\" }`\r\n    imports?: string[];\r\n  } = {},\r\n): string {\r\n  const { add = \"\", drop, rename, imports = [] } = options;\r\n  const allImports = [\"Migration\", ...imports].join(\", \");\r\n\r\n  // Build the schema object dynamically\r\n  const schemaParts: string[] = [];\r\n\r\n  if (add) {\r\n    schemaParts.push(`  add: {\\n${add}\\n  },`);\r\n  }\r\n\r\n  if (drop) {\r\n    schemaParts.push(`  drop: ${drop},`);\r\n  }\r\n\r\n  if (rename) {\r\n    schemaParts.push(`  rename: ${rename},`);\r\n  }\r\n\r\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\r\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\r\n\r\nexport default Migration.alter(${entityName.pascal}, {\r\n${schemaParts.join(\"\\n\")}\r\n});\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Create Schema template\r\n * Outputs to: schema/create-{entity}.schema.ts\r\n */\r\nexport function crudCreateSchemaStub(moduleName: Name): string {\r\n  return `import { type Infer, v } from \"@warlock.js/seal\";\r\n\r\nexport const create${moduleName.pascal}Schema = v.object({\r\n  // TODO: Add validation rules\r\n});\r\n\r\nexport type Create${moduleName.pascal}Schema = Infer<typeof create${moduleName.pascal}Schema>;\r\n`;\r\n}\r\n\r\n/**\r\n * CRUD Update Schema template\r\n * Outputs to: schema/update-{entity}.schema.ts\r\n */\r\nexport function crudUpdateSchemaStub(moduleName: Name): string {\r\n  return `import { type Infer, v } from \"@warlock.js/seal\";\r\n\r\nexport const update${moduleName.pascal}Schema = v.object({\r\n  // TODO: Add validation rules\r\n});\r\n\r\nexport type Update${moduleName.pascal}Schema = Infer<typeof update${moduleName.pascal}Schema>;\r\n`;\r\n}\r\n\r\n/**\r\n * Service template stub\r\n */\r\nexport function serviceStub(name: Name): string {\r\n  return `export async function ${name.camel}Service(data: any): Promise<any> {\r\n  // TODO: Implement service logic\r\n  throw new Error(\"${name.camel}Service not implemented\");\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * Schema template stub\r\n * Outputs to: schema/{name}.schema.ts\r\n */\r\nexport function schemaStub(name: Name): string {\r\n  return `import { type Infer, v } from \"@warlock.js/seal\";\r\n\r\nexport const ${name.camel}Schema = v.object({\r\n  // TODO: Define validation schema\r\n});\r\n\r\nexport type ${name.pascal}Schema = Infer<typeof ${name.camel}Schema>;\r\n`;\r\n}\r\n\r\n/**\r\n * Model template stub\r\n */\r\nexport function modelStub(\r\n  name: Name,\r\n  options: { tableName?: string; withResource?: boolean } = {},\r\n): string {\r\n  const { tableName = `${name.plural.snake}`, withResource } = options;\r\n\r\n  return `import { Model } from \"@warlock.js/core\";\r\nimport type { StrictMode } from \"@warlock.js/cascade\";\r\nimport { v, type Infer } from \"@warlock.js/core\";\r\n${withResource ? `import { ${name.singular.pascal}Resource } from \"../../resources/${name.singular.kebab}.resource\";` : \"\"}\r\n\r\nconst ${name.singular.camel}Schema = v.object({\r\n  // TODO: Define model schema\r\n});\r\n\r\nexport type ${name.singular.pascal}Type = Infer.Output<typeof ${name.singular.camel}Schema>;\r\n\r\nexport class ${name.singular.pascal} extends Model<${name.singular.pascal}Type> {\r\n  public static table = \"${tableName}\";\r\n  public static strictMode: StrictMode = \"fail\";\r\n${withResource ? `  public static resource = ${name.singular.pascal}Resource;` : \"\"}\r\n\r\n  public static schema = ${name.singular.camel}Schema;\r\n\r\n  public static relations = {\r\n    // TODO: Define relations\r\n  };\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * Repository template stub\r\n */\r\nexport function repositoryStub(name: Name): string {\r\n  return `import type { FilterByOptions, RepositoryOptions } from \"@warlock.js/core\";\r\nimport { RepositoryManager } from \"@warlock.js/core\";\r\nimport { ${name.singular.pascal} } from \"../models/${name.singular.kebab}\";\r\n\r\ntype ${name.singular.pascal}ListFilter = {\r\n  // Repository list filters\r\n};\r\n\r\nexport type ${name.singular.pascal}ListOptions = RepositoryOptions & ${name.singular.pascal}ListFilter;\r\n\r\nexport class ${name.plural.pascal}Repository extends RepositoryManager<${name.singular.pascal}, ${name.singular.pascal}ListFilter> {\r\n  public source = ${name.singular.pascal};\r\n\r\n  protected defaultOptions: RepositoryOptions = this.withDefaultOptions({});\r\n\r\n  protected filterBy: FilterByOptions = this.withDefaultFilters({\r\n    name: \"like\",\r\n  });\r\n}\r\n\r\nexport const ${name.plural.camel}Repository = new ${name.plural.pascal}Repository();\r\n`;\r\n}\r\n\r\n/**\r\n * Resource template stub\r\n */\r\nexport function resourceStub(name: Name): string {\r\n  return `import { Resource } from \"@warlock.js/core\";\r\n\r\nexport class ${name.singular.pascal}Resource extends Resource {\r\n  public schema = {\r\n    id: \"int\",\r\n    name: \"string\",\r\n    // TODO: Define resource schema\r\n  };\r\n}\r\n`;\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"stubs.mjs","names":[],"sources":["../../../../../../../../../../@warlock.js/core/src/cli/commands/generate/templates/stubs.ts"],"sourcesContent":["import type { ParsedName } from \"../types\";\nimport { Name } from \"../utils/name-parser\";\n\n/**\n * Controller template stub\n *\n * Controllers default to the guarded handler type since application\n * routes run behind `guarded()`. When `withValidation` is set, the\n * schema's exported type + value are imported directly from the\n * `schema/` folder and bound to the handler — no `requests/` alias.\n */\nexport function controllerStub(\n  name: ParsedName,\n  options: { withValidation?: boolean } = {},\n): string {\n  const { withValidation } = options;\n\n  if (!withValidation) {\n    return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\n\nexport const ${name.camel}Controller: GuardedRequestHandler = async (request, response) => {\n  // TODO: Implement controller logic\n  return response.success({});\n};\n`;\n  }\n\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type ${name.pascal}Schema, ${name.camel}Schema } from \"../schema/${name.kebab}.schema\";\n\nexport const ${name.camel}Controller: GuardedRequestHandler<${name.pascal}Schema> = async (\n  request,\n  response,\n) => {\n  // TODO: Implement controller logic\n  return response.success({});\n};\n\n${name.camel}Controller.validation = {\n  schema: ${name.camel}Schema,\n};\n`;\n}\n\n/**\n * CRUD Create Controller template\n * Note: moduleName is the module (plural), we need singular entity name\n */\nexport function crudCreateControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type Create${moduleName.pascal}Schema, create${moduleName.pascal}Schema } from \"../schema/create-${moduleName.kebab}.schema\";\nimport { create${moduleName.pascal}Service } from \"../services/create-${moduleName.kebab}.service\";\n\nexport const create${moduleName.pascal}Controller: GuardedRequestHandler<Create${moduleName.pascal}Schema> = async (\n  request,\n  response,\n) => {\n  const ${moduleName.camel} = await create${moduleName.pascal}Service(request.validated());\n\n  return response.successCreate({\n    ${moduleName.camel},\n  });\n};\n\ncreate${moduleName.pascal}Controller.validation = {\n  schema: create${moduleName.pascal}Schema,\n};\n`;\n}\n\n/**\n * CRUD Update Controller template\n */\nexport function crudUpdateControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { type Update${moduleName.pascal}Schema, update${moduleName.pascal}Schema } from \"../schema/update-${moduleName.kebab}.schema\";\nimport { update${moduleName.pascal}Service } from \"../services/update-${moduleName.kebab}.service\";\n\nexport const update${moduleName.pascal}Controller: GuardedRequestHandler<Update${moduleName.pascal}Schema> = async (\n  request,\n  response,\n) => {\n  const ${moduleName.camel} = await update${moduleName.pascal}Service(request.input(\"id\"), request.validated());\n\n  return response.success({\n    ${moduleName.camel},\n  });\n};\n\nupdate${moduleName.pascal}Controller.validation = {\n  schema: update${moduleName.pascal}Schema,\n};\n`;\n}\n\n/**\n * CRUD List Controller template\n */\nexport function crudListControllerStub(moduleName: Name): string {\n  const plural = moduleName.plural;\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { list${plural.pascal}Service } from \"../services/list-${plural.kebab}.service\";\n\nexport const list${plural.pascal}Controller: GuardedRequestHandler = async (\n  request,\n  response,\n) => {\n  const { data, pagination } = await list${plural.pascal}Service(request.all());\n\n  return response.success({\n    data,\n    pagination,\n  });\n};\n`;\n}\n\n/**\n * CRUD Show/Get Controller template\n */\nexport function crudShowControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { get${moduleName.pascal}Service } from \"../services/get-${moduleName.kebab}.service\";\n\nexport const get${moduleName.pascal}Controller: GuardedRequestHandler = async (\n  request,\n  response,\n) => {\n  const ${moduleName.camel} = await get${moduleName.pascal}Service(request.input(\"id\"));\n\n  if (!${moduleName.camel}) {\n    return response.notFound();\n  }\n\n  return response.success({\n    ${moduleName.camel},\n  });\n};\n`;\n}\n\n/**\n * CRUD Delete Controller template\n */\nexport function crudDeleteControllerStub(moduleName: Name): string {\n  return `import { type GuardedRequestHandler } from \"app/auth/requests/guarded.request\";\nimport { delete${moduleName.pascal}Service } from \"../services/delete-${moduleName.kebab}.service\";\n\nexport const delete${moduleName.pascal}Controller: GuardedRequestHandler = async (\n  request,\n  response,\n) => {\n  await delete${moduleName.pascal}Service(request.input(\"id\"));\n\n  return response.noContent();\n};\n`;\n}\n\n/**\n * CRUD Routes template\n */\nexport function crudRoutesStub(moduleName: Name): string {\n  const singular = moduleName.singular;\n  const plural = moduleName.plural;\n\n  return `import { router } from \"@warlock.js/core\";\nimport { guarded } from \"app/shared/utils/router\";\nimport { create${singular.pascal}Controller } from \"./controllers/create-${singular.kebab}.controller\";\nimport { delete${singular.pascal}Controller } from \"./controllers/delete-${singular.kebab}.controller\";\nimport { get${singular.pascal}Controller } from \"./controllers/get-${singular.kebab}.controller\";\nimport { list${plural.pascal}Controller } from \"./controllers/list-${plural.kebab}.controller\";\nimport { update${singular.pascal}Controller } from \"./controllers/update-${singular.kebab}.controller\";\n\nguarded(() => {\n  router\n    .route(\"/${plural.kebab}\")\n    .list(list${plural.pascal}Controller)\n    .show(get${singular.pascal}Controller)\n    .create(create${singular.pascal}Controller)\n    .update(update${singular.pascal}Controller)\n    .destroy(delete${singular.pascal}Controller);\n});\n`;\n}\n\n/**\n * CRUD Model template\n */\nexport function crudModelStub(moduleName: Name): string {\n  const singular = moduleName.singular;\n  const plural = moduleName.plural;\n\n  return `import { Model, RegisterModel } from \"@warlock.js/cascade\";\nimport { type Infer, v } from \"@warlock.js/seal\";\nimport { ${singular.pascal}Resource } from \"app/${plural.kebab}/resources/${singular.kebab}.resource\";\n\nexport const ${singular.camel}Schema = v.object({\n  // TODO: Add more fields\n});\n\nexport type ${singular.pascal}Schema = Infer.Output<typeof ${singular.camel}Schema>;\n\n@RegisterModel()\nexport class ${singular.pascal} extends Model<${singular.pascal}Schema> {\n  public static table = \"${plural.snake}\";\n\n  public static schema = ${singular.camel}Schema;\n\n  public static relations = {};\n\n  public static resource = ${singular.pascal}Resource;\n}\n`;\n}\n\n/**\n * CRUD Resource template\n */\nexport function crudResourceStub(moduleName: Name): string {\n  // Get singular entity name\n  const entity = moduleName.singular;\n\n  return `import { defineResource } from \"@warlock.js/core\";\n\nexport const ${entity.pascal}Resource = defineResource({\n  schema: {\n    id: \"number\",\n    // TODO: Add more resource fields\n  },\n});\n`;\n}\n\n/**\n * CRUD Repository template\n */\nexport function crudRepositoryStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  const modulePluralName = entity.plural;\n  return `import type { FilterRules, TypedRepositoryOptions } from \"@warlock.js/core\";\nimport { RepositoryManager } from \"@warlock.js/core\";\nimport { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\n\ntype ${moduleSingularName.pascal}ListFilter = {\n  // Repository list filters\n};\n\nexport type ${moduleSingularName.pascal}ListOptions = TypedRepositoryOptions<${moduleSingularName.pascal}ListFilter>;\n\nclass ${modulePluralName.pascal}Repository extends RepositoryManager<${moduleSingularName.pascal}, ${moduleSingularName.pascal}ListOptions> {\n  public source = ${moduleSingularName.pascal};\n\n  public simpleSelectColumns: string[] = [\"id\"];\n\n  public filterBy: FilterRules = {\n    id: \"=\",\n  };\n\n  public defaultOptions: RepositoryOptions = {\n    orderBy: {\n      id: \"desc\",\n    },\n  };\n}\n\nexport const ${modulePluralName.camel}Repository = new ${modulePluralName.pascal}Repository();\n`;\n}\n\n/**\n * CRUD Create Service template\n */\nexport function crudCreateServiceStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  return `import { ${moduleSingularName.pascal} } from \"../models/${moduleSingularName.kebab}\";\nimport type { Create${moduleSingularName.pascal}Schema } from \"../schema/create-${moduleSingularName.kebab}.schema\";\n\nexport async function create${moduleSingularName.pascal}Service(data: Create${moduleSingularName.pascal}Schema) {\n  const ${moduleSingularName.camel} = await ${moduleSingularName.pascal}.create(data);\n  return ${moduleSingularName.camel};\n}\n`;\n}\n\n/**\n * CRUD Update Service template\n */\nexport function crudUpdateServiceStub(entity: Name): string {\n  const moduleSingularName = entity.singular;\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\nimport { get${moduleSingularName.pascal}Service } from \"./get-${moduleSingularName.kebab}.service\";\nimport type { Update${moduleSingularName.pascal}Schema } from \"../schema/update-${moduleSingularName.kebab}.schema\";\n\nexport async function update${moduleSingularName.pascal}Service(id: number | string, data: Update${moduleSingularName.pascal}Schema) {\n  const ${moduleSingularName.camel} = await get${moduleSingularName.pascal}Service(id);\n\n  await ${moduleSingularName.camel}.save({ merge: data });\n  return ${moduleSingularName.camel};\n}\n`;\n}\n\n/**\n * CRUD List Service template\n */\nexport function crudListServiceStub(entity: Name): string {\n  const modulePluralName = entity.plural;\n  return `import { ${modulePluralName.camel}Repository } from \"../repositories/${modulePluralName.kebab}.repository\";\n\nexport async function list${modulePluralName.pascal}Service(filters: any) {\n  return ${modulePluralName.camel}Repository.listCached(filters);\n}\n`;\n}\n\n/**\n * CRUD Get Service template\n */\nexport function crudGetServiceStub(entity: Name): string {\n  return `import { ${entity.plural.camel}Repository } from \"../repositories/${entity.plural.kebab}.repository\";\nimport { ResourceNotFoundError } from \"@warlock.js/core\";\n\nexport async function get${entity.singular.pascal}Service(id: number | string) {\n  const ${entity.singular.camel} = await ${entity.plural.camel}Repository.getCached(id);\n\n  if (!${entity.singular.camel}) {\n    throw new ResourceNotFoundError(\"${entity.singular.pascal} resource not found!\");\n  }\n\n  return ${entity.singular.camel};\n}\n`;\n}\n\n/**\n * CRUD Delete Service template\n */\nexport function crudDeleteServiceStub(entity: Name): string {\n  const singular = entity.singular;\n  return `import { ResourceNotFoundError } from \"@warlock.js/core\";\nimport { get${singular.pascal}Service } from \"./get-${singular.kebab}.service\";\n\nexport async function delete${singular.pascal}Service(id: number | string) {\n  const ${singular.camel} = await get${singular.pascal}Service(id);\n  if (!${singular.camel}) {\n    throw new ResourceNotFoundError(\"${singular.pascal} not found\");\n  }\n  await ${singular.camel}.destroy();\n}\n`;\n}\n\n/**\n * CRUD Seed template\n */\nexport function crudSeedStub(entity: Name): string {\n  return `import { seeder } from \"@warlock.js/core\";\nimport { ${entity.singular.pascal} } from \"../models/${entity.singular.kebab}\";\n\nexport default seeder({\n  name: \"Seed ${entity.plural.pascal}\",\n  once: true,\n  enabled: true,\n  run: async () => {\n    const total = 10;\n    for (let i = 0; i < total; i++) {\n      await ${entity.singular.pascal}.create({\n        // TODO: Add more fields\n      });\n    }\n\n    return {\n      recordsCreated: total,\n    };\n  },\n});\n`;\n}\n\n/**\n * Migration template\n */\n/**\n * Migration Create template\n */\nexport function migrationStub(\n  entityName: ParsedName,\n  options: {\n    columns?: string;\n    imports?: string[];\n    timestamps?: boolean;\n    tableName?: string;\n  } = {},\n): string {\n  const { columns = \"\", imports = [], timestamps = true } = options;\n\n  const allImports = [\"Migration\", ...imports].join(\", \");\n\n  let optionsString = \"\";\n  if (timestamps === false) {\n    optionsString = `, { timestamps: false }`;\n  }\n\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\n\nexport default Migration.create(${entityName.pascal}, {\n${columns ? columns : \"  // add your columns here, id is auto added to the list\"}\n}${optionsString});\n`;\n}\n\n/**\n * Migration Alter template\n */\nexport function migrationAlterStub(\n  entityName: ParsedName,\n  options: {\n    add?: string;\n    drop?: string; // stringified array like `\"[\\\"col1\\\", \\\"col2\\\"]\"`\n    rename?: string; // stringified object like `{ old: \"new\" }`\n    imports?: string[];\n  } = {},\n): string {\n  const { add = \"\", drop, rename, imports = [] } = options;\n  const allImports = [\"Migration\", ...imports].join(\", \");\n\n  // Build the schema object dynamically\n  const schemaParts: string[] = [];\n\n  if (add) {\n    schemaParts.push(`  add: {\\n${add}\\n  },`);\n  }\n\n  if (drop) {\n    schemaParts.push(`  drop: ${drop},`);\n  }\n\n  if (rename) {\n    schemaParts.push(`  rename: ${rename},`);\n  }\n\n  return `import { ${allImports} } from \"@warlock.js/cascade\";\nimport { ${entityName.pascal} } from \"../${entityName.kebab}.model\";\n\nexport default Migration.alter(${entityName.pascal}, {\n${schemaParts.join(\"\\n\")}\n});\n`;\n}\n\n/**\n * CRUD Create Schema template\n * Outputs to: schema/create-{entity}.schema.ts\n */\nexport function crudCreateSchemaStub(moduleName: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const create${moduleName.pascal}Schema = v.object({\n  // TODO: Add validation rules\n});\n\nexport type Create${moduleName.pascal}Schema = Infer<typeof create${moduleName.pascal}Schema>;\n`;\n}\n\n/**\n * CRUD Update Schema template\n * Outputs to: schema/update-{entity}.schema.ts\n */\nexport function crudUpdateSchemaStub(moduleName: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const update${moduleName.pascal}Schema = v.object({\n  // TODO: Add validation rules\n});\n\nexport type Update${moduleName.pascal}Schema = Infer<typeof update${moduleName.pascal}Schema>;\n`;\n}\n\n/**\n * Service template stub\n */\nexport function serviceStub(name: Name): string {\n  return `export async function ${name.camel}Service(data: any): Promise<any> {\n  // TODO: Implement service logic\n  throw new Error(\"${name.camel}Service not implemented\");\n}\n`;\n}\n\n/**\n * Schema template stub\n * Outputs to: schema/{name}.schema.ts\n */\nexport function schemaStub(name: Name): string {\n  return `import { type Infer, v } from \"@warlock.js/seal\";\n\nexport const ${name.camel}Schema = v.object({\n  // TODO: Define validation schema\n});\n\nexport type ${name.pascal}Schema = Infer<typeof ${name.camel}Schema>;\n`;\n}\n\n/**\n * Model template stub\n */\nexport function modelStub(\n  name: Name,\n  options: { tableName?: string; withResource?: boolean } = {},\n): string {\n  const { tableName = `${name.plural.snake}`, withResource } = options;\n\n  return `import { Model, type StrictMode } from \"@warlock.js/cascade\";\nimport { v, type Infer } from \"@warlock.js/seal\";\n${withResource ? `import { ${name.singular.pascal}Resource } from \"../../resources/${name.singular.kebab}.resource\";` : \"\"}\n\nconst ${name.singular.camel}Schema = v.object({\n  // TODO: Define model schema\n});\n\nexport type ${name.singular.pascal}Type = Infer.Output<typeof ${name.singular.camel}Schema>;\n\nexport class ${name.singular.pascal} extends Model<${name.singular.pascal}Type> {\n  public static table = \"${tableName}\";\n  public static strictMode: StrictMode = \"fail\";\n${withResource ? `  public static resource = ${name.singular.pascal}Resource;` : \"\"}\n\n  public static schema = ${name.singular.camel}Schema;\n\n  public static relations = {\n    // TODO: Define relations\n  };\n}\n`;\n}\n\n/**\n * Repository template stub\n */\nexport function repositoryStub(name: Name): string {\n  return `import type { FilterByOptions, RepositoryOptions } from \"@warlock.js/core\";\nimport { RepositoryManager } from \"@warlock.js/core\";\nimport { ${name.singular.pascal} } from \"../models/${name.singular.kebab}\";\n\ntype ${name.singular.pascal}ListFilter = {\n  // Repository list filters\n};\n\nexport type ${name.singular.pascal}ListOptions = RepositoryOptions & ${name.singular.pascal}ListFilter;\n\nexport class ${name.plural.pascal}Repository extends RepositoryManager<${name.singular.pascal}, ${name.singular.pascal}ListFilter> {\n  public source = ${name.singular.pascal};\n\n  protected defaultOptions: RepositoryOptions = this.withDefaultOptions({});\n\n  protected filterBy: FilterByOptions = this.withDefaultFilters({\n    name: \"like\",\n  });\n}\n\nexport const ${name.plural.camel}Repository = new ${name.plural.pascal}Repository();\n`;\n}\n\n/**\n * Resource template stub\n */\nexport function resourceStub(name: Name): string {\n  return `import { Resource } from \"@warlock.js/core\";\n\nexport class ${name.singular.pascal}Resource extends Resource {\n  public schema = {\n    id: \"int\",\n    name: \"string\",\n    // TODO: Define resource schema\n  };\n}\n`;\n}\n"],"mappings":";;;;;;;;;AAWA,SAAgB,eACd,MACA,UAAwC,CAAC,GACjC;CACR,MAAM,EAAE,mBAAmB;CAE3B,IAAI,CAAC,gBACH,OAAO;;eAEI,KAAK,MAAM;;;;;CAOxB,OAAO;gBACO,KAAK,OAAO,UAAU,KAAK,MAAM,2BAA2B,KAAK,MAAM;;eAExE,KAAK,MAAM,oCAAoC,KAAK,OAAO;;;;;;;;EAQxE,KAAK,MAAM;YACD,KAAK,MAAM;;;AAGvB;;;;;AAMA,SAAgB,yBAAyB,YAA0B;CACjE,OAAO;sBACa,WAAW,OAAO,gBAAgB,WAAW,OAAO,kCAAkC,WAAW,MAAM;iBAC5G,WAAW,OAAO,qCAAqC,WAAW,MAAM;;qBAEpE,WAAW,OAAO,0CAA0C,WAAW,OAAO;;;;UAIzF,WAAW,MAAM,iBAAiB,WAAW,OAAO;;;MAGxD,WAAW,MAAM;;;;QAIf,WAAW,OAAO;kBACR,WAAW,OAAO;;;AAGpC;;;;AAKA,SAAgB,yBAAyB,YAA0B;CACjE,OAAO;sBACa,WAAW,OAAO,gBAAgB,WAAW,OAAO,kCAAkC,WAAW,MAAM;iBAC5G,WAAW,OAAO,qCAAqC,WAAW,MAAM;;qBAEpE,WAAW,OAAO,0CAA0C,WAAW,OAAO;;;;UAIzF,WAAW,MAAM,iBAAiB,WAAW,OAAO;;;MAGxD,WAAW,MAAM;;;;QAIf,WAAW,OAAO;kBACR,WAAW,OAAO;;;AAGpC;;;;AAKA,SAAgB,uBAAuB,YAA0B;CAC/D,MAAM,SAAS,WAAW;CAC1B,OAAO;eACM,OAAO,OAAO,mCAAmC,OAAO,MAAM;;mBAE1D,OAAO,OAAO;;;;2CAIU,OAAO,OAAO;;;;;;;;AAQzD;;;;AAKA,SAAgB,uBAAuB,YAA0B;CAC/D,OAAO;cACK,WAAW,OAAO,kCAAkC,WAAW,MAAM;;kBAEjE,WAAW,OAAO;;;;UAI1B,WAAW,MAAM,cAAc,WAAW,OAAO;;SAElD,WAAW,MAAM;;;;;MAKpB,WAAW,MAAM;;;;AAIvB;;;;AAKA,SAAgB,yBAAyB,YAA0B;CACjE,OAAO;iBACQ,WAAW,OAAO,qCAAqC,WAAW,MAAM;;qBAEpE,WAAW,OAAO;;;;gBAIvB,WAAW,OAAO;;;;;AAKlC;;;;AAKA,SAAgB,eAAe,YAA0B;CACvD,MAAM,WAAW,WAAW;CAC5B,MAAM,SAAS,WAAW;CAE1B,OAAO;;iBAEQ,SAAS,OAAO,0CAA0C,SAAS,MAAM;iBACzE,SAAS,OAAO,0CAA0C,SAAS,MAAM;cAC5E,SAAS,OAAO,uCAAuC,SAAS,MAAM;eACrE,OAAO,OAAO,wCAAwC,OAAO,MAAM;iBACjE,SAAS,OAAO,0CAA0C,SAAS,MAAM;;;;eAI3E,OAAO,MAAM;gBACZ,OAAO,OAAO;eACf,SAAS,OAAO;oBACX,SAAS,OAAO;oBAChB,SAAS,OAAO;qBACf,SAAS,OAAO;;;AAGrC;;;;AAKA,SAAgB,cAAc,YAA0B;CACtD,MAAM,WAAW,WAAW;CAC5B,MAAM,SAAS,WAAW;CAE1B,OAAO;;WAEE,SAAS,OAAO,uBAAuB,OAAO,MAAM,aAAa,SAAS,MAAM;;eAE5E,SAAS,MAAM;;;;cAIhB,SAAS,OAAO,+BAA+B,SAAS,MAAM;;;eAG7D,SAAS,OAAO,iBAAiB,SAAS,OAAO;2BACrC,OAAO,MAAM;;2BAEb,SAAS,MAAM;;;;6BAIb,SAAS,OAAO;;;AAG7C;;;;AAKA,SAAgB,iBAAiB,YAA0B;CAIzD,OAAO;;eAFQ,WAAW,SAIN,OAAO;;;;;;;AAO7B;;;;AAKA,SAAgB,mBAAmB,QAAsB;CACvD,MAAM,qBAAqB,OAAO;CAClC,MAAM,mBAAmB,OAAO;CAChC,OAAO;;WAEE,mBAAmB,OAAO,qBAAqB,mBAAmB,MAAM;;OAE5E,mBAAmB,OAAO;;;;cAInB,mBAAmB,OAAO,uCAAuC,mBAAmB,OAAO;;QAEjG,iBAAiB,OAAO,uCAAuC,mBAAmB,OAAO,IAAI,mBAAmB,OAAO;oBAC3G,mBAAmB,OAAO;;;;;;;;;;;;;;;eAe/B,iBAAiB,MAAM,mBAAmB,iBAAiB,OAAO;;AAEjF;;;;AAKA,SAAgB,sBAAsB,QAAsB;CAC1D,MAAM,qBAAqB,OAAO;CAClC,OAAO,YAAY,mBAAmB,OAAO,qBAAqB,mBAAmB,MAAM;sBACvE,mBAAmB,OAAO,kCAAkC,mBAAmB,MAAM;;8BAE7E,mBAAmB,OAAO,sBAAsB,mBAAmB,OAAO;UAC9F,mBAAmB,MAAM,WAAW,mBAAmB,OAAO;WAC7D,mBAAmB,MAAM;;;AAGpC;;;;AAKA,SAAgB,sBAAsB,QAAsB;CAC1D,MAAM,qBAAqB,OAAO;CAClC,OAAO;cACK,mBAAmB,OAAO,wBAAwB,mBAAmB,MAAM;sBACnE,mBAAmB,OAAO,kCAAkC,mBAAmB,MAAM;;8BAE7E,mBAAmB,OAAO,2CAA2C,mBAAmB,OAAO;UACnH,mBAAmB,MAAM,cAAc,mBAAmB,OAAO;;UAEjE,mBAAmB,MAAM;WACxB,mBAAmB,MAAM;;;AAGpC;;;;AAKA,SAAgB,oBAAoB,QAAsB;CACxD,MAAM,mBAAmB,OAAO;CAChC,OAAO,YAAY,iBAAiB,MAAM,qCAAqC,iBAAiB,MAAM;;4BAE5E,iBAAiB,OAAO;WACzC,iBAAiB,MAAM;;;AAGlC;;;;AAKA,SAAgB,mBAAmB,QAAsB;CACvD,OAAO,YAAY,OAAO,OAAO,MAAM,qCAAqC,OAAO,OAAO,MAAM;;;2BAGvE,OAAO,SAAS,OAAO;UACxC,OAAO,SAAS,MAAM,WAAW,OAAO,OAAO,MAAM;;SAEtD,OAAO,SAAS,MAAM;uCACQ,OAAO,SAAS,OAAO;;;WAGnD,OAAO,SAAS,MAAM;;;AAGjC;;;;AAKA,SAAgB,sBAAsB,QAAsB;CAC1D,MAAM,WAAW,OAAO;CACxB,OAAO;cACK,SAAS,OAAO,wBAAwB,SAAS,MAAM;;8BAEvC,SAAS,OAAO;UACpC,SAAS,MAAM,cAAc,SAAS,OAAO;SAC9C,SAAS,MAAM;uCACe,SAAS,OAAO;;UAE7C,SAAS,MAAM;;;AAGzB;;;;AAKA,SAAgB,aAAa,QAAsB;CACjD,OAAO;WACE,OAAO,SAAS,OAAO,qBAAqB,OAAO,SAAS,MAAM;;;gBAG7D,OAAO,OAAO,OAAO;;;;;;cAMvB,OAAO,SAAS,OAAO;;;;;;;;;;;AAWrC;;;;;;;AAQA,SAAgB,cACd,YACA,UAKI,CAAC,GACG;CACR,MAAM,EAAE,UAAU,IAAI,UAAU,CAAC,GAAG,aAAa,SAAS;CAE1D,MAAM,aAAa,CAAC,aAAa,GAAG,OAAO,CAAC,CAAC,KAAK,IAAI;CAEtD,IAAI,gBAAgB;CACpB,IAAI,eAAe,OACjB,gBAAgB;CAGlB,OAAO,YAAY,WAAW;WACrB,WAAW,OAAO,cAAc,WAAW,MAAM;;kCAE1B,WAAW,OAAO;EAClD,UAAU,UAAU,2DAA2D;GAC9E,cAAc;;AAEjB;;;;AAKA,SAAgB,mBACd,YACA,UAKI,CAAC,GACG;CACR,MAAM,EAAE,MAAM,IAAI,MAAM,QAAQ,UAAU,CAAC,MAAM;CACjD,MAAM,aAAa,CAAC,aAAa,GAAG,OAAO,CAAC,CAAC,KAAK,IAAI;CAGtD,MAAM,cAAwB,CAAC;CAE/B,IAAI,KACF,YAAY,KAAK,aAAa,IAAI,OAAO;CAG3C,IAAI,MACF,YAAY,KAAK,WAAW,KAAK,EAAE;CAGrC,IAAI,QACF,YAAY,KAAK,aAAa,OAAO,EAAE;CAGzC,OAAO,YAAY,WAAW;WACrB,WAAW,OAAO,cAAc,WAAW,MAAM;;iCAE3B,WAAW,OAAO;EACjD,YAAY,KAAK,IAAI,EAAE;;;AAGzB;;;;;AAMA,SAAgB,qBAAqB,YAA0B;CAC7D,OAAO;;qBAEY,WAAW,OAAO;;;;oBAInB,WAAW,OAAO,8BAA8B,WAAW,OAAO;;AAEtF;;;;;AAMA,SAAgB,qBAAqB,YAA0B;CAC7D,OAAO;;qBAEY,WAAW,OAAO;;;;oBAInB,WAAW,OAAO,8BAA8B,WAAW,OAAO;;AAEtF;;;;AAKA,SAAgB,YAAY,MAAoB;CAC9C,OAAO,yBAAyB,KAAK,MAAM;;qBAExB,KAAK,MAAM;;;AAGhC;;;;;AAMA,SAAgB,WAAW,MAAoB;CAC7C,OAAO;;eAEM,KAAK,MAAM;;;;cAIZ,KAAK,OAAO,wBAAwB,KAAK,MAAM;;AAE7D;;;;AAKA,SAAgB,UACd,MACA,UAA0D,CAAC,GACnD;CACR,MAAM,EAAE,YAAY,GAAG,KAAK,OAAO,SAAS,iBAAiB;CAE7D,OAAO;;EAEP,eAAe,YAAY,KAAK,SAAS,OAAO,mCAAmC,KAAK,SAAS,MAAM,eAAe,GAAG;;QAEnH,KAAK,SAAS,MAAM;;;;cAId,KAAK,SAAS,OAAO,6BAA6B,KAAK,SAAS,MAAM;;eAErE,KAAK,SAAS,OAAO,iBAAiB,KAAK,SAAS,OAAO;2BAC/C,UAAU;;EAEnC,eAAe,8BAA8B,KAAK,SAAS,OAAO,aAAa,GAAG;;2BAEzD,KAAK,SAAS,MAAM;;;;;;;AAO/C;;;;AAKA,SAAgB,eAAe,MAAoB;CACjD,OAAO;;WAEE,KAAK,SAAS,OAAO,qBAAqB,KAAK,SAAS,MAAM;;OAElE,KAAK,SAAS,OAAO;;;;cAId,KAAK,SAAS,OAAO,oCAAoC,KAAK,SAAS,OAAO;;eAE7E,KAAK,OAAO,OAAO,uCAAuC,KAAK,SAAS,OAAO,IAAI,KAAK,SAAS,OAAO;oBACnG,KAAK,SAAS,OAAO;;;;;;;;;eAS1B,KAAK,OAAO,MAAM,mBAAmB,KAAK,OAAO,OAAO;;AAEvE;;;;AAKA,SAAgB,aAAa,MAAoB;CAC/C,OAAO;;eAEM,KAAK,SAAS,OAAO;;;;;;;;AAQpC"}

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

@@ -0,0 +1,43 @@
+import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
+import { BaseConnector } from "./base-connector.mjs";
+
+//#region ../@warlock.js/core/src/connectors/ai-connector.d.ts
+/**
+ * AI Connector
+ *
+ * Wires `@warlock.js/ai` from `src/config/ai.ts` at boot: reads the exported
+ * config object and hands it to the package's `ai.config(...)`. Config files stay
+ * declarative; the connector performs the side-effect.
+ *
+ * The package is lazy-imported (only when an ai config is present), so core
+ * carries no hard dependency on it — the same pattern as the access,
+ * notifications and herald connectors.
+ *
+ * Because the satellite packages' side-effect imports sit at the TOP of
+ * config/ai.ts, they have already registered their surface on `ai` (ai.tools /
+ * ai.mcp, ai.workspace, panoptic) by the time config-loader runs the file and
+ * this connector applies the config — so this single `ai.config(...)` call also
+ * fires panoptic's onConfigApplied wiring.
+ */
+declare class AiConnector extends BaseConnector {
+  readonly name = "ai";
+  readonly priority = ConnectorPriority.AI;
+  readonly lifecyclePhase = ConnectorLifecyclePhase.Early;
+  /**
+   * Files that trigger an ai restart
+   */
+  protected readonly watchedFiles: string[];
+  /**
+   * Register the ai configuration with the package.
+   */
+  start(): Promise<void>;
+  /**
+   * Clear the active flag so a dev restart re-registers from the (possibly
+   * changed, or now-removed) config file. The package holds no external
+   * connection of its own.
+   */
+  shutdown(): Promise<void>;
+}
+//#endregion
+export { AiConnector };
+//# sourceMappingURL=ai-connector.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-connector.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/ai-connector.ts"],"mappings":";;;;;;AAsBA;;;;;;;;;;;;;;;cAAa,WAAA,SAAoB,aAAA;EAAA,SACf,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,EAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EAUjB;;;EAAA,mBALM,YAAA;EAuBa;AAAA;;EAlBnB,KAAA,IAAS,OAAA;;;;;;EAkBT,QAAA,IAAY,OAAA;AAAA"}

package/esm/connectors/ai-connector.mjs

@@ -0,0 +1,56 @@
+import { ConnectorLifecyclePhase, ConnectorPriority } from "./types.mjs";
+import { BaseConnector } from "./base-connector.mjs";
+import baseConfig from "@mongez/config";
+import { log } from "@warlock.js/logger";
+
+//#region ../@warlock.js/core/src/connectors/ai-connector.ts
+/**
+* AI Connector
+*
+* Wires `@warlock.js/ai` from `src/config/ai.ts` at boot: reads the exported
+* config object and hands it to the package's `ai.config(...)`. Config files stay
+* declarative; the connector performs the side-effect.
+*
+* The package is lazy-imported (only when an ai config is present), so core
+* carries no hard dependency on it — the same pattern as the access,
+* notifications and herald connectors.
+*
+* Because the satellite packages' side-effect imports sit at the TOP of
+* config/ai.ts, they have already registered their surface on `ai` (ai.tools /
+* ai.mcp, ai.workspace, panoptic) by the time config-loader runs the file and
+* this connector applies the config — so this single `ai.config(...)` call also
+* fires panoptic's onConfigApplied wiring.
+*/
+var AiConnector = class extends BaseConnector {
+	constructor(..._args) {
+		super(..._args);
+		this.name = "ai";
+		this.priority = 10;
+		this.lifecyclePhase = "early";
+		this.watchedFiles = ["src/config/ai.ts"];
+	}
+	/**
+	* Register the ai configuration with the package.
+	*/
+	async start() {
+		const aiConfiguration = baseConfig.get("ai");
+		if (!aiConfiguration) return;
+		const { ai } = await import("../ai/src/index.mjs");
+		ai.config(aiConfiguration);
+		this.active = true;
+		log.info("ai", "configured", "AI wired from config/ai.ts");
+	}
+	/**
+	* Clear the active flag so a dev restart re-registers from the (possibly
+	* changed, or now-removed) config file. The package holds no external
+	* connection of its own.
+	*/
+	async shutdown() {
+		if (!this.active) return;
+		this.active = false;
+	}
+};
+
+//#endregion
+export { AiConnector };
+//# sourceMappingURL=ai-connector.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-connector.mjs","names":["config"],"sources":["../../../../../../../@warlock.js/core/src/connectors/ai-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { log } from \"@warlock.js/logger\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * AI Connector\n *\n * Wires `@warlock.js/ai` from `src/config/ai.ts` at boot: reads the exported\n * config object and hands it to the package's `ai.config(...)`. Config files stay\n * declarative; the connector performs the side-effect.\n *\n * The package is lazy-imported (only when an ai config is present), so core\n * carries no hard dependency on it — the same pattern as the access,\n * notifications and herald connectors.\n *\n * Because the satellite packages' side-effect imports sit at the TOP of\n * config/ai.ts, they have already registered their surface on `ai` (ai.tools /\n * ai.mcp, ai.workspace, panoptic) by the time config-loader runs the file and\n * this connector applies the config — so this single `ai.config(...)` call also\n * fires panoptic's onConfigApplied wiring.\n */\nexport class AiConnector extends BaseConnector {\n  public readonly name = \"ai\";\n  public readonly priority = ConnectorPriority.AI;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger an ai restart\n   */\n  protected readonly watchedFiles = [\"src/config/ai.ts\"];\n\n  /**\n   * Register the ai configuration with the package.\n   */\n  public async start(): Promise<void> {\n    const aiConfiguration = config.get(\"ai\");\n\n    if (!aiConfiguration) return;\n\n    const { ai } = await import(\"@warlock.js/ai\");\n\n    ai.config(aiConfiguration);\n    this.active = true;\n\n    log.info(\"ai\", \"configured\", \"AI wired from config/ai.ts\");\n  }\n\n  /**\n   * Clear the active flag so a dev restart re-registers from the (possibly\n   * changed, or now-removed) config file. The package holds no external\n   * connection of its own.\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) return;\n\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,IAAa,cAAb,cAAiC,cAAc;;;cACtB;;;sBAOW,CAAC,kBAAkB;;;;;CAKrD,MAAa,QAAuB;EAClC,MAAM,kBAAkBA,WAAO,IAAI,IAAI;EAEvC,IAAI,CAAC,iBAAiB;EAEtB,MAAM,EAAE,OAAO,MAAM,OAAO;EAE5B,GAAG,OAAO,eAAe;EACzB,KAAK,SAAS;EAEd,IAAI,KAAK,MAAM,cAAc,4BAA4B;CAC3D;;;;;;CAOA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QAAQ;EAElB,KAAK,SAAS;CAChB;AACF"}

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

@@ -20,6 +20,11 @@ declare class CacheConnector extends BaseConnector {
   start(): Promise<void>;
   /**
    * Shutdown cache connection
+   *
+   * Disconnects every loaded cache driver so external clients (e.g. a Redis
+   * connection) are released instead of left dangling — mirroring the
+   * database and herald connectors, which disconnect all registered
+   * connections on shutdown.
    */
   shutdown(): Promise<void>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"cache-connector.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/cache-connector.ts"],"mappings":";;;;;;AASA;;cAAa,cAAA,SAAuB,aAAA;EAAA,SAClB,IAAA;EAAA,SACA,QAAA,GAAQ,iBAAA,CAAA,KAAA;EAAA,SACR,cAAA,GAAc,uBAAA,CAAA,KAAA;EAyBL;;;EAAA,mBApBN,YAAA;EARe;;;EAarB,KAAA,IAAS,OAAA;EAXE;;;EA0BX,QAAA,IAAY,OAAA;AAAA"}
+{"version":3,"file":"cache-connector.d.mts","names":[],"sources":["../../../../../../../@warlock.js/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"}

package/esm/connectors/cache-connector.mjs

@@ -28,9 +28,16 @@ var CacheConnector = class extends BaseConnector {
 	}
 	/**
 	* Shutdown cache connection
+	*
+	* Disconnects every loaded cache driver so external clients (e.g. a Redis
+	* connection) are released instead of left dangling — mirroring the
+	* database and herald connectors, which disconnect all registered
+	* connections on shutdown.
 	*/
 	async shutdown() {
 		if (!this.active) return;
+		const drivers = Object.values(cache.loadedDrivers);
+		for (const driver of drivers) await driver.disconnect();
 		this.active = false;
 	}
 };

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

@@ -1 +1 @@
-{"version":3,"file":"cache-connector.mjs","names":["config"],"sources":["../../../../../../../@warlock.js/core/src/connectors/cache-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\r\nimport { cache } from \"@warlock.js/cache\";\r\nimport { BaseConnector } from \"./base-connector\";\r\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\r\n\r\n/**\r\n * Cache Connector\r\n * Manages cache engine connection lifecycle\r\n */\r\nexport class CacheConnector extends BaseConnector {\r\n  public readonly name = \"cache\";\r\n  public readonly priority = ConnectorPriority.CACHE;\r\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\r\n\r\n  /**\r\n   * Files that trigger cache restart\r\n   */\r\n  protected readonly watchedFiles = [\"src/config/cache.ts\", \"src/config/cache.tsx\"];\r\n\r\n  /**\r\n   * Initialize cache connection\r\n   */\r\n  public async start(): Promise<void> {\r\n    const cacheConfig = config.get(\"cache\");\r\n\r\n    if (!cacheConfig) return;\r\n\r\n    cache.setCacheConfigurations(cacheConfig);\r\n\r\n    await cache.init();\r\n\r\n    this.active = true;\r\n  }\r\n\r\n  /**\r\n   * Shutdown cache connection\r\n   */\r\n  public async shutdown(): Promise<void> {\r\n    if (!this.active) {\r\n      return;\r\n    }\r\n\r\n    // TODO: Implement actual cache disconnection\r\n    // - Close all active connections\r\n    // - Clean up resources\r\n\r\n    this.active = false;\r\n  }\r\n}\r\n"],"mappings":";;;;;;;;;;AASA,IAAa,iBAAb,cAAoC,cAAc;;;cACzB;;;sBAOW,CAAC,uBAAuB,sBAAsB;;;;;CAKhF,MAAa,QAAuB;EAClC,MAAM,cAAcA,WAAO,IAAI,OAAO;EAEtC,IAAI,CAAC,aAAa;EAElB,MAAM,uBAAuB,WAAW;EAExC,MAAM,MAAM,KAAK;EAEjB,KAAK,SAAS;CAChB;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAOF,KAAK,SAAS;CAChB;AACF"}
+{"version":3,"file":"cache-connector.mjs","names":["config"],"sources":["../../../../../../../@warlock.js/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,cAAcA,WAAO,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"}

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

@@ -43,10 +43,14 @@ declare class ConnectorsManager {
   /**
    * Shutdown connectors on process kill
    *
-   * Handles graceful shutdown for both Unix and Windows:
+   * Registers signal handlers that run an idempotent graceful shutdown:
    * - SIGINT: Ctrl+C on Unix, also caught on Windows but unreliable in child processes
    * - SIGTERM: Termination signal (Unix primarily)
-   * - beforeExit: Fires when Node.js empties its event loop (more reliable on Windows)
+   * - SIGHUP: registered on Windows (`win32`) only, to catch Ctrl+C / console close
+   *
+   * Note: no `beforeExit` handler is registered — `beforeExit` cannot reliably
+   * await async teardown (the process exits once the callback returns), so
+   * shutdown is driven entirely by the signal handlers above.
    */
   shutdownOnProcessKill(): void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"connectors-manager.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/connectors-manager.ts"],"mappings":";;;cAgBa,iBAAA;EAAA;;;EAAA,iBAIM,UAAA;EA8BF;;;;EA8B0C;;;EAvClD,QAAA,IAAY,UAAA,EAAY,SAAA;EAmEC;;;EA1DzB,IAAA,IAAQ,SAAA;EATR;;;EAgBM,KAAA,CAAM,eAAA,GAAkB,aAAA,KAAkB,OAAA;EAPxC;;;;;;;;;EA8BF,UAAA,CAAW,KAAA,EAAO,uBAAA,GAA0B,OAAA;EAiBX;;;EAAjC,YAAA,CAAa,kBAAA,EAAoB,aAAA,KAAkB,OAAA;EAWvC;;;EAAZ,QAAA,IAAY,OAAA;EAkDd;;;;AAA2C;;;;EAzB/C,qBAAA;AAAA;AAAA,cAyBI,iBAAA,EAAiB,iBAA0B"}
+{"version":3,"file":"connectors-manager.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/connectors/connectors-manager.ts"],"mappings":";;;cAiBa,iBAAA;EAAA;;;EAAA,iBAIM,UAAA;EA+BF;;;;EA8B0C;;;EAvClD,QAAA,IAAY,UAAA,EAAY,SAAA;EAmEC;;;EA1DzB,IAAA,IAAQ,SAAA;EATR;;;EAgBM,KAAA,CAAM,eAAA,GAAkB,aAAA,KAAkB,OAAA;EAPxC;;;;;;;;;EA8BF,UAAA,CAAW,KAAA,EAAO,uBAAA,GAA0B,OAAA;EAiBX;;;EAAjC,YAAA,CAAa,kBAAA,EAAoB,aAAA,KAAkB,OAAA;EAWvC;;;EAAZ,QAAA,IAAY,OAAA;EAsDd;;;;AAA2C;;;;;;;;EAzB/C,qBAAA;AAAA;AAAA,cAyBI,iBAAA,EAAiB,iBAA0B"}