@warlock.js/core 4.16.0 → 5.0.0

package/esm/connectors/types.d.mts

@@ -1,3 +1,6 @@
+import { ResolvedBuildConfig } from "../production/resolve-build-config.mjs";
+import { BuildOptions } from "esbuild";
+
 //#region ../core/src/connectors/types.d.ts
 /**
  * Connector Interface
@@ -48,7 +51,79 @@ interface Connector {
    * @returns true if connector should restart
    */
   shouldRestart(changedFiles: string[]): boolean;
+  /**
+   * What this connector contributes to `warlock build`.
+   *
+   * Read STATICALLY from `warlock.config.ts > connectors` — `warlock build`
+   * never calls `boot()`/`start()`, so nothing here may assume a running
+   * connector. The same `connectors` key drives both halves of a connector's
+   * life — build-time contribution and runtime boot; see
+   * {@link ConnectorBuildContribution}.
+   */
+  readonly build?: ConnectorBuildContribution;
 }
+/**
+ * What a build contribution is handed. Everything it needs to write files
+ * and shape the bundle, and nothing that would let it reach the runtime.
+ */
+type ConnectorBuildContext = {
+  /** Absolute path to `.warlock/production` — deleted after the build */productionDir: string; /** Absolute path to the application root (where `package.json` lives) */
+  appRoot: string; /** The build config after framework defaults and user overrides */
+  options: ResolvedBuildConfig;
+};
+/**
+ * The esbuild options a contributor may patch.
+ *
+ * Deliberately a narrow `Pick`, not `Partial<BuildOptions>`: `entryPoints`,
+ * `tsconfig` and `tsconfigRaw` stay forbidden here for the same reason they
+ * are forbidden in the user's `build` block — they re-compile every file in
+ * the bundle, workspace packages included (see `ForbiddenBuildOptionError`).
+ * A contributor reaching them would reintroduce the failure the user-level
+ * guard exists to prevent.
+ */
+type ConnectorEsbuildPatch = Pick<BuildOptions, "jsx" | "jsxImportSource" | "define" | "external" | "loader">;
+/**
+ * What `generate` may hand back to the builder.
+ */
+type ConnectorBuildGenerateResult = {
+  /**
+   * Lines appended verbatim to section 4 of the generated entry, AFTER the
+   * `./routes` import — page registration must see the routes app code
+   * collected, mirroring dev's ordering.
+   *
+   * @example ['await import("./pages");']
+   */
+  entryImports?: string[]; /** Merged into the esbuild call: defaults < this patch < user `build` */
+  esbuild?: ConnectorEsbuildPatch;
+};
+/**
+ * A connector's build-time half: two hooks, both awaited, drained in
+ * `connectors` array order. A hook that throws fails the build.
+ *
+ * **This type is closed on purpose**: exactly these two optional function properties and ZERO data-bearing
+ * fields. There is deliberately no property where a Vite/babel plugin
+ * instance, an alias map or a compiled pipeline could live, so
+ * `build: { plugins: [...] }` is a type error rather than something a
+ * reviewer has to catch. Anything heavy must be constructed INSIDE a hook,
+ * after that hook dynamically imports it — that is what keeps a connector's
+ * static import graph out of the runtime closure. The drain mirrors this at
+ * read time by rejecting unknown enumerable keys (`assertClosedContribution`):
+ * the type narrows, the runtime asserts.
+ */
+type ConnectorBuildContribution = {
+  /**
+   * Write files into `ctx.productionDir` and/or patch the bundle.
+   *
+   * Runs after the generated-imports check and before esbuild bundles.
+   */
+  generate?(context: ConnectorBuildContext): Promise<ConnectorBuildGenerateResult | void> | ConnectorBuildGenerateResult | void;
+  /**
+   * Produce artifacts esbuild does not — e.g. a client bundle.
+   *
+   * Runs after esbuild and before `.warlock/production` is removed.
+   */
+  emit?(context: ConnectorBuildContext): Promise<void> | void;
+};
 type ConnectorName = "logger" | "mailer" | "http" | "database" | "cache" | "storage" | "herald" | "socket" | "notifications" | "access" | "ai" | (string & {});
 /**
  * When a connector boots relative to user code (main, routes, events).
@@ -80,5 +155,5 @@ declare enum ConnectorPriority {
   AI = 10
 }
 //#endregion
-export { Connector, ConnectorLifecyclePhase, ConnectorName, ConnectorPriority };
+export { Connector, ConnectorBuildContext, ConnectorBuildContribution, ConnectorBuildGenerateResult, ConnectorEsbuildPatch, ConnectorLifecyclePhase, ConnectorName, ConnectorPriority };
 //# sourceMappingURL=types.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../core/src/connectors/types.ts"],"mappings":";;AAIA;;;UAAiB,SAAA;EAgBU;;;EAAA,SAZhB,IAAA,EAAM,aAAA;EAyCH;;;;EAAA,SAnCH,QAAA;EAAA;;;;EAAA,SAMA,cAAA,EAAgB,uBAAA;EAWV;;;EANf,QAAA;EAkBW;;;;EAZX,IAAA,WAAe,OAAA;EAyBqB;AAAA;AAGtC;;EAtBE,KAAA,IAAS,OAAA;EAsBc;AAAA;AAuBzB;;EAvCE,OAAA,IAAW,OAAA;EAwCX;AACI;AAMN;;EAzCE,QAAA,IAAY,OAAA;EAyCe;;;;;EAlC3B,aAAA,CAAc,YAAA;AAAA;AAAA,KAGJ,aAAA;;;;;;AA0CR;;;;aAnBQ,uBAAA;EACV,KAAA;EACA,IAAI;AAAA;;;;aAMM,iBAAA;EACV,MAAA;EACA,MAAA;EACA,QAAA;EACA,YAAA;EACA,KAAA;EACA,IAAA;EACA,OAAA;EACA,MAAA;EACA,aAAA;EACA,MAAA;EACA,EAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../core/src/connectors/types.ts"],"mappings":";;;;;;AAOA;;UAAiB,SAAA;EAIA;;;EAAA,SAAN,IAAA,EAAM,aAAA;EAmCJ;;;;EAAA,SA7BF,QAAA;EANA;;;;EAAA,SAYA,cAAA,EAAgB,uBAAA;EAKzB;;;EAAA,QAAA;EAYS;;;;EANT,IAAA,WAAe,OAAA;EAyBf;;;;EAnBA,KAAA,IAAS,OAAA;EA8BkC;AAO7C;;;EA/BE,OAAA,IAAW,OAAA;EAiCX;;;;EA3BA,QAAA,IAAY,OAAA;EA+BgB;AAa9B;;;;EArCE,aAAA,CAAc,YAAA;EA6CJ;;;;;;;;AAUqB;EAVrB,SAlCD,KAAA,GAAQ,0BAAA;AAAA;;;;;KAOP,qBAAA;EAqEK,uEAnEf,aAAA,UAmE8C;EAjE9C,OAAA,UAwDA;EAtDA,OAAA,EAAS,mBAAmB;AAAA;;;;;;;;;AA+DkB;AAGhD;KArDY,qBAAA,GAAwB,IAAI,CACtC,YAAA;;;AAoDuB;KA7Cb,4BAAA;EAoEuB;;;AAE7B;AAMN;;;EApEE,YAAA,aAqEA;EAnEA,OAAA,GAAU,qBAAqB;AAAA;;;;;;;;;;AA6E7B;;;;;KA5DQ,0BAAA;;;;;;EAMV,QAAA,EACE,OAAA,EAAS,qBAAA,GACR,OAAA,CAAQ,4BAAA,WAAuC,4BAAA;;;;;;EAOlD,IAAA,EAAM,OAAA,EAAS,qBAAA,GAAwB,OAAA;AAAA;AAAA,KAG7B,aAAA;;;;;;;;;;aAuBA,uBAAA;EACV,KAAA;EACA,IAAI;AAAA;;;;aAMM,iBAAA;EACV,MAAA;EACA,MAAA;EACA,QAAA;EACA,YAAA;EACA,KAAA;EACA,IAAA;EACA,OAAA;EACA,MAAA;EACA,aAAA;EACA,MAAA;EACA,EAAA;AAAA"}

package/esm/connectors/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../../../../../../../core/src/connectors/types.ts"],"sourcesContent":["/**\n * Connector Interface\n * All service connectors (Database, HTTP, Cache, etc.) must implement this interface\n */\nexport interface Connector {\n  /**\n   * Unique name of the connector\n   */\n  readonly name: ConnectorName;\n\n  /**\n   * Priority for initialization order\n   * Lower numbers initialize first (e.g., Database: 1, HTTP: 3)\n   */\n  readonly priority: number;\n\n  /**\n   * Phase the connector boots in, relative to user code.\n   * See `ConnectorLifecyclePhase` for semantics.\n   */\n  readonly lifecyclePhase: ConnectorLifecyclePhase;\n\n  /**\n   * Whether the connector is currently active/connected\n   */\n  isActive(): boolean;\n\n  /**\n   * Boot the connector\n   * Called during server startup before starting the connector\n   */\n  boot(): void | Promise<void>;\n\n  /**\n   * Initialize the connector\n   * Called during server startup\n   */\n  start(): Promise<void>;\n\n  /**\n   * Restart the connector\n   * Called when watched files change\n   */\n  restart(): Promise<void>;\n\n  /**\n   * Gracefully shutdown the connector\n   * Called during server shutdown\n   */\n  shutdown(): Promise<void>;\n\n  /**\n   * Determine if this connector needs restart based on changed files\n   * @param changedFiles Array of relative file paths that changed\n   * @returns true if connector should restart\n   */\n  shouldRestart(changedFiles: string[]): boolean;\n}\n\nexport type ConnectorName =\n  | \"logger\"\n  | \"mailer\"\n  | \"http\"\n  | \"database\"\n  | \"cache\"\n  | \"storage\"\n  | \"herald\"\n  | \"socket\"\n  | \"notifications\"\n  | \"access\"\n  | \"ai\"\n  | (string & {});\n\n/**\n * When a connector boots relative to user code (main, routes, events).\n *\n * - `Early`: before user code is imported. For services user code\n *   needs at import time (database, cache, logger, storage, mailer).\n * - `Late`: after user code is imported. For services that bind to\n *   things user code registered (http scans the router; socket\n *   depends on http's instance).\n */\nexport enum ConnectorLifecyclePhase {\n  Early = \"early\",\n  Late = \"late\",\n}\n\n/**\n * Connector priority constants\n */\nexport enum ConnectorPriority {\n  LOGGER = 0,\n  MAILER = 1,\n  DATABASE = 2,\n  COMMUNICATOR = 3,\n  CACHE = 4,\n  HTTP = 5,\n  STORAGE = 6,\n  SOCKET = 7,\n  NOTIFICATIONS = 8,\n  ACCESS = 9,\n  AI = 10,\n}\n"],"mappings":";;;;;;;;;;AAkFA,IAAY,0BAAL;CACL;CACA;;AACF;;;;AAKA,IAAY,oBAAL;CACL;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;;AACF"}
+{"version":3,"file":"types.mjs","names":[],"sources":["../../../../../../../core/src/connectors/types.ts"],"sourcesContent":["import type { BuildOptions } from \"esbuild\";\nimport type { ResolvedBuildConfig } from \"../production/resolve-build-config\";\n\n/**\n * Connector Interface\n * All service connectors (Database, HTTP, Cache, etc.) must implement this interface\n */\nexport interface Connector {\n  /**\n   * Unique name of the connector\n   */\n  readonly name: ConnectorName;\n\n  /**\n   * Priority for initialization order\n   * Lower numbers initialize first (e.g., Database: 1, HTTP: 3)\n   */\n  readonly priority: number;\n\n  /**\n   * Phase the connector boots in, relative to user code.\n   * See `ConnectorLifecyclePhase` for semantics.\n   */\n  readonly lifecyclePhase: ConnectorLifecyclePhase;\n\n  /**\n   * Whether the connector is currently active/connected\n   */\n  isActive(): boolean;\n\n  /**\n   * Boot the connector\n   * Called during server startup before starting the connector\n   */\n  boot(): void | Promise<void>;\n\n  /**\n   * Initialize the connector\n   * Called during server startup\n   */\n  start(): Promise<void>;\n\n  /**\n   * Restart the connector\n   * Called when watched files change\n   */\n  restart(): Promise<void>;\n\n  /**\n   * Gracefully shutdown the connector\n   * Called during server shutdown\n   */\n  shutdown(): Promise<void>;\n\n  /**\n   * Determine if this connector needs restart based on changed files\n   * @param changedFiles Array of relative file paths that changed\n   * @returns true if connector should restart\n   */\n  shouldRestart(changedFiles: string[]): boolean;\n\n  /**\n   * What this connector contributes to `warlock build`.\n   *\n   * Read STATICALLY from `warlock.config.ts > connectors` — `warlock build`\n   * never calls `boot()`/`start()`, so nothing here may assume a running\n   * connector. The same `connectors` key drives both halves of a connector's\n   * life — build-time contribution and runtime boot; see\n   * {@link ConnectorBuildContribution}.\n   */\n  readonly build?: ConnectorBuildContribution;\n}\n\n/**\n * What a build contribution is handed. Everything it needs to write files\n * and shape the bundle, and nothing that would let it reach the runtime.\n */\nexport type ConnectorBuildContext = {\n  /** Absolute path to `.warlock/production` — deleted after the build */\n  productionDir: string;\n  /** Absolute path to the application root (where `package.json` lives) */\n  appRoot: string;\n  /** The build config after framework defaults and user overrides */\n  options: ResolvedBuildConfig;\n};\n\n/**\n * The esbuild options a contributor may patch.\n *\n * Deliberately a narrow `Pick`, not `Partial<BuildOptions>`: `entryPoints`,\n * `tsconfig` and `tsconfigRaw` stay forbidden here for the same reason they\n * are forbidden in the user's `build` block — they re-compile every file in\n * the bundle, workspace packages included (see `ForbiddenBuildOptionError`).\n * A contributor reaching them would reintroduce the failure the user-level\n * guard exists to prevent.\n */\nexport type ConnectorEsbuildPatch = Pick<\n  BuildOptions,\n  \"jsx\" | \"jsxImportSource\" | \"define\" | \"external\" | \"loader\"\n>;\n\n/**\n * What `generate` may hand back to the builder.\n */\nexport type ConnectorBuildGenerateResult = {\n  /**\n   * Lines appended verbatim to section 4 of the generated entry, AFTER the\n   * `./routes` import — page registration must see the routes app code\n   * collected, mirroring dev's ordering.\n   *\n   * @example ['await import(\"./pages\");']\n   */\n  entryImports?: string[];\n  /** Merged into the esbuild call: defaults < this patch < user `build` */\n  esbuild?: ConnectorEsbuildPatch;\n};\n\n/**\n * A connector's build-time half: two hooks, both awaited, drained in\n * `connectors` array order. A hook that throws fails the build.\n *\n * **This type is closed on purpose**: exactly these two optional function properties and ZERO data-bearing\n * fields. There is deliberately no property where a Vite/babel plugin\n * instance, an alias map or a compiled pipeline could live, so\n * `build: { plugins: [...] }` is a type error rather than something a\n * reviewer has to catch. Anything heavy must be constructed INSIDE a hook,\n * after that hook dynamically imports it — that is what keeps a connector's\n * static import graph out of the runtime closure. The drain mirrors this at\n * read time by rejecting unknown enumerable keys (`assertClosedContribution`):\n * the type narrows, the runtime asserts.\n */\nexport type ConnectorBuildContribution = {\n  /**\n   * Write files into `ctx.productionDir` and/or patch the bundle.\n   *\n   * Runs after the generated-imports check and before esbuild bundles.\n   */\n  generate?(\n    context: ConnectorBuildContext,\n  ): Promise<ConnectorBuildGenerateResult | void> | ConnectorBuildGenerateResult | void;\n\n  /**\n   * Produce artifacts esbuild does not — e.g. a client bundle.\n   *\n   * Runs after esbuild and before `.warlock/production` is removed.\n   */\n  emit?(context: ConnectorBuildContext): Promise<void> | void;\n};\n\nexport type ConnectorName =\n  | \"logger\"\n  | \"mailer\"\n  | \"http\"\n  | \"database\"\n  | \"cache\"\n  | \"storage\"\n  | \"herald\"\n  | \"socket\"\n  | \"notifications\"\n  | \"access\"\n  | \"ai\"\n  | (string & {});\n\n/**\n * When a connector boots relative to user code (main, routes, events).\n *\n * - `Early`: before user code is imported. For services user code\n *   needs at import time (database, cache, logger, storage, mailer).\n * - `Late`: after user code is imported. For services that bind to\n *   things user code registered (http scans the router; socket\n *   depends on http's instance).\n */\nexport enum ConnectorLifecyclePhase {\n  Early = \"early\",\n  Late = \"late\",\n}\n\n/**\n * Connector priority constants\n */\nexport enum ConnectorPriority {\n  LOGGER = 0,\n  MAILER = 1,\n  DATABASE = 2,\n  COMMUNICATOR = 3,\n  CACHE = 4,\n  HTTP = 5,\n  STORAGE = 6,\n  SOCKET = 7,\n  NOTIFICATIONS = 8,\n  ACCESS = 9,\n  AI = 10,\n}\n"],"mappings":";;;;;;;;;;AA4KA,IAAY,0BAAL;CACL;CACA;;AACF;;;;AAKA,IAAY,oBAAL;CACL;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;;AACF"}

package/esm/database/models/database-log/database-log.d.mts

@@ -2,7 +2,31 @@ import { Infer } from "@warlock.js/seal";
 import { Model } from "@warlock.js/cascade";
 
 //#region ../core/src/database/models/database-log/database-log.d.ts
-declare const schema: any;
+declare const schema: import("@warlock.js/seal").ObjectValidator<{
+  module: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+  action: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+  message: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+  trace: import("@warlock.js/seal").RecordValidator & {
+    valueValidator: import("@warlock.js/seal").AnyValidator & import("@warlock.js/seal").StandardSchemaV1<any, any>;
+  } & import("@warlock.js/seal").StandardSchemaV1<Record<string, any>, Record<string, any>>;
+  level: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+}> & import("@warlock.js/seal").StandardSchemaV1<import("@warlock.js/seal").InferInputObjectShape<{
+  module: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+  action: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+  message: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+  trace: import("@warlock.js/seal").RecordValidator & {
+    valueValidator: import("@warlock.js/seal").AnyValidator & import("@warlock.js/seal").StandardSchemaV1<any, any>;
+  } & import("@warlock.js/seal").StandardSchemaV1<Record<string, any>, Record<string, any>>;
+  level: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+}>, import("@warlock.js/seal").InferInputObjectShape<{
+  module: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+  action: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+  message: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+  trace: import("@warlock.js/seal").RecordValidator & {
+    valueValidator: import("@warlock.js/seal").AnyValidator & import("@warlock.js/seal").StandardSchemaV1<any, any>;
+  } & import("@warlock.js/seal").StandardSchemaV1<Record<string, any>, Record<string, any>>;
+  level: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+}>>;
 type LogSchema = Infer.Output<typeof schema>;
 declare class DatabaseLogModel extends Model<LogSchema> {
   /**
@@ -12,7 +36,31 @@ declare class DatabaseLogModel extends Model<LogSchema> {
   /**
    * {@inheritdoc}
    */
-  static schema: any;
+  static schema: import("@warlock.js/seal").ObjectValidator<{
+    module: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+    action: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+    message: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+    trace: import("@warlock.js/seal").RecordValidator & {
+      valueValidator: import("@warlock.js/seal").AnyValidator & import("@warlock.js/seal").StandardSchemaV1<any, any>;
+    } & import("@warlock.js/seal").StandardSchemaV1<Record<string, any>, Record<string, any>>;
+    level: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+  }> & import("@warlock.js/seal").StandardSchemaV1<import("@warlock.js/seal").InferInputObjectShape<{
+    module: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+    action: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+    message: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+    trace: import("@warlock.js/seal").RecordValidator & {
+      valueValidator: import("@warlock.js/seal").AnyValidator & import("@warlock.js/seal").StandardSchemaV1<any, any>;
+    } & import("@warlock.js/seal").StandardSchemaV1<Record<string, any>, Record<string, any>>;
+    level: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+  }>, import("@warlock.js/seal").InferInputObjectShape<{
+    module: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+    action: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+    message: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+    trace: import("@warlock.js/seal").RecordValidator & {
+      valueValidator: import("@warlock.js/seal").AnyValidator & import("@warlock.js/seal").StandardSchemaV1<any, any>;
+    } & import("@warlock.js/seal").StandardSchemaV1<Record<string, any>, Record<string, any>>;
+    level: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
+  }>>;
 }
 //#endregion
 export { DatabaseLogModel };

package/esm/database/models/database-log/database-log.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"database-log.d.mts","names":[],"sources":["../../../../../../../../../core/src/database/models/database-log/database-log.ts"],"mappings":";;;;cAGM,MAAA;AAAA,KAQD,SAAA,GAAY,KAAA,CAAM,MAAM,QAAQ,MAAA;AAAA,cAExB,gBAAA,SAAyB,KAAK,CAAC,SAAA;EAJ1C;;;EAAA,OAQc,KAAA;EANX;;;EAAA,OAWW,MAAA;AAAA"}
+{"version":3,"file":"database-log.d.mts","names":[],"sources":["../../../../../../../../../core/src/database/models/database-log/database-log.ts"],"mappings":";;;;cAGM,MAAA,6BAAM,eAAA;;;;;;;;;;;;;;;;;;;;;;;;;KAQP,SAAA,GAAY,KAAA,CAAM,MAAM,QAAQ,MAAA;AAAA,cAExB,gBAAA,SAAyB,KAAA,CAAM,SAAA;;;;SAI5B,KAAA;;;;SAKA,MAAA,6BAAM,eAAA"}

package/esm/database/utils.d.mts

@@ -1,11 +1,11 @@
-import { SchemaContext } from "@warlock.js/seal";
+import { ComputedCallback, SchemaContext } from "@warlock.js/seal";
 import { Model } from "@warlock.js/cascade";
 
 //#region ../core/src/database/utils.d.ts
 /**
  * Hash password on saving if password changes
  */
-declare const useHashedPassword: () => any;
+declare const useHashedPassword: () => import("@warlock.js/seal").TransformerCallback;
 type ComputedCallbackModel = (data: any, model: Model, context: SchemaContext) => any | Promise<any>;
 /**
  * Generate computed value based on other fields

package/esm/database/utils.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.mts","names":[],"sources":["../../../../../../../core/src/database/utils.ts"],"mappings":";;;;;;AASA;cAAa,iBAAA;AAAA,KASR,qBAAA,IACH,IAAA,OACA,KAAA,EAAO,KAAA,EACP,OAAA,EAAS,aAAA,WACA,OAAA;;AANP;AAAC;iBAWW,gBAAA,CAAiB,QAAA,EAAU,qBAAA,GAAqB,gBAAA;;;;iBAWhD,eAAA,CAAgB,KAAA,WAAiB,KAAA,0BAAuC,gBAAA"}
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../../../../../../../core/src/database/utils.ts"],"mappings":";;;;;;AASA;cAAa,iBAAA,mCAAiB,mBAO1B;AAAA,KAEC,qBAAA,IACH,IAAA,OACA,KAAA,EAAO,KAAA,EACP,OAAA,EAAS,aAAA,WACA,OAAA;;AANP;AAAC;iBAWW,gBAAA,CAAiB,QAAA,EAAU,qBAAA,GAAqB,gBAAA;;;;iBAWhD,eAAA,CAAgB,KAAA,WAAiB,KAAA,0BAAuC,gBAAA"}

package/esm/dev-server/development-server.mjs

@@ -41,6 +41,7 @@ var DevelopmentServer = class {
 			this.setupEventListeners();
 			await this.autoDiscoverFiles();
 			await filesOrchestrator.moduleLoader.loadAll();
+			await Application.runStartupValidators();
 			await connectorsManager.startPhase("late");
 			this.layerExecutor = new LayerExecutor(filesOrchestrator.getDependencyGraph(), filesOrchestrator.specialFilesCollector, filesOrchestrator.moduleLoader, (absolutePath) => filesOrchestrator.bumpVersion(absolutePath), () => filesOrchestrator.flushVersionBumps());
 			this.running = true;

package/esm/dev-server/development-server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"development-server.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/development-server.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport events from \"@mongez/events\";\r\nimport { fileExistsAsync, unlinkAsync } from \"@warlock.js/fs\";\r\nimport { Application } from \"../application\";\r\nimport { connectorsManager } from \"../connectors/connectors-manager\";\r\nimport { ConnectorLifecyclePhase } from \"../connectors/types\";\r\nimport { warlockConfigManager } from \"../warlock-config\";\r\nimport { devLogInfo, devLogReady, devLogSection, devLogWarn, devServeLog } from \"./dev-logger\";\r\nimport { filesOrchestrator } from \"./files-orchestrator\";\r\nimport { MANIFEST_PATH } from \"./flags\";\r\nimport { LayerExecutor } from \"./layer-executor\";\r\nimport { restartDevServer } from \"./restart-dev-server\";\r\nimport { devServerShortcuts } from \"./shortcuts\";\r\nimport type { StartDevServerOptions } from \"./start-development-server\";\r\nimport { typeGenerator } from \"./type-generator\";\r\n\r\ntype Batch = { added: string[]; changed: string[]; deleted: string[] };\r\n\r\n/**\r\n * Top-level coordinator for `warlock dev`. Wires the file orchestrator, the\r\n * connectors, and the layer executor together, and listens for the watcher's\r\n * batched events to drive HMR.\r\n */\r\nexport class DevelopmentServer {\r\n  private layerExecutor?: LayerExecutor;\r\n  private running = false;\r\n  private readonly options: StartDevServerOptions;\r\n\r\n  public constructor(options: StartDevServerOptions = {}) {\r\n    this.options = options;\r\n    devLogSection(\"Starting Development Server...\");\r\n  }\r\n\r\n  public async start(): Promise<void> {\r\n    try {\r\n      const startedAt = performance.now();\r\n\r\n      // --fresh deletes the manifest so reconciliation re-parses every file\r\n      // from disk. Transpile caching is owned by the loader hook (in-memory).\r\n      if (this.options.fresh && (await fileExistsAsync(MANIFEST_PATH))) {\r\n        await unlinkAsync(MANIFEST_PATH);\r\n        devServeLog(colors.cyanBright(\"Cleared manifest (--fresh)\"));\r\n      }\r\n\r\n      await filesOrchestrator.init();\r\n      await filesOrchestrator.initializeAll();\r\n      await filesOrchestrator.watchFiles();\r\n\r\n      filesOrchestrator.specialFilesCollector.collect(filesOrchestrator.getFiles());\r\n\r\n      this.setupEventListeners();\r\n\r\n      // Decorator-driven registries (models, etc.) must be populated before\r\n      // routes/services can resolve symbols by name.\r\n      await this.autoDiscoverFiles();\r\n\r\n      await filesOrchestrator.moduleLoader.loadAll();\r\n\r\n      // Late-phase connectors (http, socket) bind after app code has\r\n      // registered routes/listeners.\r\n      await connectorsManager.startPhase(ConnectorLifecyclePhase.Late);\r\n\r\n      this.layerExecutor = new LayerExecutor(\r\n        filesOrchestrator.getDependencyGraph(),\r\n        filesOrchestrator.specialFilesCollector,\r\n        filesOrchestrator.moduleLoader,\r\n        (absolutePath) => filesOrchestrator.bumpVersion(absolutePath),\r\n        () => filesOrchestrator.flushVersionBumps(),\r\n      );\r\n\r\n      this.running = true;\r\n\r\n      const duration = performance.now() - startedAt;\r\n      devLogReady(`Development Server is ready in ${colors.greenBright(parseDuration(duration))}`);\r\n\r\n      // App modules are loaded and both connector phases are active — signal a\r\n      // complete boot so `Application.onceBooted(...)` listeners fire.\r\n      Application.markBooted({\r\n        environment: Application.environment,\r\n        runtimeStrategy: Application.runtimeStrategy,\r\n        bootDurationMs: duration,\r\n      });\r\n\r\n      // Precedence: explicit CLI option > devServer.* config > default.\r\n      const devServerConfig = await warlockConfigManager.get(\"devServer\");\r\n      const generateTypings =\r\n        this.options.generateTypings ?? devServerConfig?.generateTypings ?? true;\r\n      const healthCheckers = this.options.healthCheckers ?? devServerConfig?.healthCheckers ?? true;\r\n\r\n      if (generateTypings) typeGenerator.executeGenerateAllCommand();\r\n\r\n      if (healthCheckers) {\r\n        filesOrchestrator.startCheckingHealth(healthCheckers === true ? undefined : healthCheckers);\r\n      }\r\n    } catch (error) {\r\n      devServeLog(colors.redBright(`Failed to start Development Server: ${error}`));\r\n      await this.shutdown();\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Eagerly import files whose decorators populate global registries so any\r\n   * symbol-by-name resolution later in boot finds them.\r\n   */\r\n  private async autoDiscoverFiles(): Promise<void> {\r\n    const discoveryTypes = [\"model\"] as const;\r\n    for (const file of filesOrchestrator.files.values()) {\r\n      if (file.type && (discoveryTypes as readonly string[]).includes(file.type)) {\r\n        await filesOrchestrator.moduleLoader.loadModule(file, file.type);\r\n      }\r\n    }\r\n  }\r\n\r\n  private setupEventListeners(): void {\r\n    events.on(\"dev-server:batch-complete\", (batch: Batch) => this.handleBatchComplete(batch));\r\n  }\r\n\r\n  private async handleBatchComplete(batch: Batch): Promise<void> {\r\n    if (!this.running || !this.layerExecutor) return;\r\n\r\n    // warlock.config.ts holds settings read at boot (CLI commands, build\r\n    // options, watch patterns, scheduled jobs) and .env feeds every config\r\n    // that reads it. Neither can be hot-reloaded without leaving running\r\n    // services configured with stale values, so the only honest response is\r\n    // a full restart.\r\n    const restartTrigger = this.findRestartTrigger(batch);\r\n\r\n    if (restartTrigger) {\r\n      // On success this never comes back — the process exits and the\r\n      // supervisor replaces it. Reaching the next line means the restart was\r\n      // declined by config or wasn't possible, so we fall through and still\r\n      // hot-reload whatever ordinary code shared the batch.\r\n      await this.restartForConfigChange(restartTrigger);\r\n    }\r\n\r\n    // No-op saves (an editor that fsyncs without a content write) are already\r\n    // filtered upstream by the file hash in FileEventHandler, so batch.changed\r\n    // only contains genuinely-changed paths by the time it reaches here.\r\n\r\n    const total = batch.added.length + batch.changed.length + batch.deleted.length;\r\n    if (total === 0) return;\r\n\r\n    // Boot-time files still ride along in `changed` when a restart was\r\n    // declined (`restartOnConfigChange: false`) or wasn't possible — they are\r\n    // never hot-reloaded, so keep them out of the reload set either way.\r\n    const codeFiles = [...batch.added, ...batch.changed].filter(\r\n      (p) => !isEnvPath(p) && p !== \"warlock.config.ts\",\r\n    );\r\n\r\n    try {\r\n      await this.layerExecutor.executeBatchReload(\r\n        codeFiles,\r\n        filesOrchestrator.getFiles(),\r\n        batch.deleted,\r\n        batch.changed,\r\n      );\r\n\r\n      typeGenerator.executeTypingsGenerator([...batch.added, ...batch.changed]);\r\n\r\n      filesOrchestrator.checkHealth(batch);\r\n    } catch (error) {\r\n      devServeLog(colors.redBright(`Failed to execute batch reload: ${error}`));\r\n    }\r\n  }\r\n\r\n  /**\r\n   * The boot-time file in this batch that can only be applied by restarting,\r\n   * or `undefined` when the batch is ordinary application code.\r\n   */\r\n  private findRestartTrigger(batch: Batch): string | undefined {\r\n    if (batch.changed.includes(\"warlock.config.ts\")) {\r\n      return \"warlock.config.ts\";\r\n    }\r\n\r\n    return [...batch.added, ...batch.changed].find(isEnvPath);\r\n  }\r\n\r\n  /**\r\n   * Restart so a changed boot-time file actually takes effect.\r\n   *\r\n   * Opt out with `devServer.restartOnConfigChange: false` and the old\r\n   * behaviour returns: a warning telling you to restart yourself. If the\r\n   * restart can't be performed at all (no supervisor, a shutdown that threw),\r\n   * `restartDevServer` reports it and we fall back to the same warning rather\r\n   * than leaving the server running against config it isn't using.\r\n   */\r\n  private async restartForConfigChange(file: string): Promise<void> {\r\n    const devServerConfig = await warlockConfigManager.get(\"devServer\");\r\n\r\n    if (devServerConfig?.restartOnConfigChange === false) {\r\n      devLogWarn(`${file} changed — restart the dev server to apply.`);\r\n      return;\r\n    }\r\n\r\n    devLogInfo(`${file} changed — restarting to apply.`);\r\n\r\n    const restarted = await restartDevServer(this);\r\n\r\n    if (!restarted) {\r\n      devLogWarn(`${file} changed — restart the dev server to apply.`);\r\n    }\r\n  }\r\n\r\n  public async shutdown(): Promise<void> {\r\n    // Always hand the terminal back, even on a repeat/no-op shutdown — a\r\n    // process that exits while stdin is still in raw mode leaves the user's\r\n    // shell without line editing or Ctrl+C.\r\n    devServerShortcuts.release();\r\n\r\n    if (!this.running) return;\r\n    devServeLog(colors.redBright(\"Shutting down Development Server...\"));\r\n    this.running = false;\r\n    await connectorsManager.shutdown();\r\n    devServeLog(colors.greenBright(\"Development Server stopped\"));\r\n  }\r\n\r\n  public isRunning(): boolean {\r\n    return this.running;\r\n  }\r\n}\r\n\r\n\r\nfunction isEnvPath(path: string): boolean {\r\n  const basename = path.split(\"/\").pop() ?? path;\r\n  return basename === \".env\" || basename.startsWith(\".env.\");\r\n}\r\n\r\nfunction parseDuration(ms: number): string {\r\n  if (ms < 1000) return `${ms.toFixed(2)}ms`;\r\n  if (ms > 60_000) return `${(ms / 60_000).toFixed(2)}m`;\r\n  return `${(ms / 1000).toFixed(2)}s`;\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"development-server.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/development-server.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport events from \"@mongez/events\";\r\nimport { fileExistsAsync, unlinkAsync } from \"@warlock.js/fs\";\r\nimport { Application } from \"../application\";\r\nimport { connectorsManager } from \"../connectors/connectors-manager\";\r\nimport { ConnectorLifecyclePhase } from \"../connectors/types\";\r\nimport { warlockConfigManager } from \"../warlock-config\";\r\nimport { devLogInfo, devLogReady, devLogSection, devLogWarn, devServeLog } from \"./dev-logger\";\r\nimport { filesOrchestrator } from \"./files-orchestrator\";\r\nimport { MANIFEST_PATH } from \"./flags\";\r\nimport { LayerExecutor } from \"./layer-executor\";\r\nimport { restartDevServer } from \"./restart-dev-server\";\r\nimport { devServerShortcuts } from \"./shortcuts\";\r\nimport type { StartDevServerOptions } from \"./start-development-server\";\r\nimport { typeGenerator } from \"./type-generator\";\r\n\r\ntype Batch = { added: string[]; changed: string[]; deleted: string[] };\r\n\r\n/**\r\n * Top-level coordinator for `warlock dev`. Wires the file orchestrator, the\r\n * connectors, and the layer executor together, and listens for the watcher's\r\n * batched events to drive HMR.\r\n */\r\nexport class DevelopmentServer {\r\n  private layerExecutor?: LayerExecutor;\r\n  private running = false;\r\n  private readonly options: StartDevServerOptions;\r\n\r\n  public constructor(options: StartDevServerOptions = {}) {\r\n    this.options = options;\r\n    devLogSection(\"Starting Development Server...\");\r\n  }\r\n\r\n  public async start(): Promise<void> {\r\n    try {\r\n      const startedAt = performance.now();\r\n\r\n      // --fresh deletes the manifest so reconciliation re-parses every file\r\n      // from disk. Transpile caching is owned by the loader hook (in-memory).\r\n      if (this.options.fresh && (await fileExistsAsync(MANIFEST_PATH))) {\r\n        await unlinkAsync(MANIFEST_PATH);\r\n        devServeLog(colors.cyanBright(\"Cleared manifest (--fresh)\"));\r\n      }\r\n\r\n      await filesOrchestrator.init();\r\n      await filesOrchestrator.initializeAll();\r\n      await filesOrchestrator.watchFiles();\r\n\r\n      filesOrchestrator.specialFilesCollector.collect(filesOrchestrator.getFiles());\r\n\r\n      this.setupEventListeners();\r\n\r\n      // Decorator-driven registries (models, etc.) must be populated before\r\n      // routes/services can resolve symbols by name.\r\n      await this.autoDiscoverFiles();\r\n\r\n      await filesOrchestrator.moduleLoader.loadAll();\r\n\r\n      // A rejecting validator (Application.onValidateBoot) must abort boot\r\n      // before late-phase connectors bind a port — this is what makes the\r\n      // hook actually prevent serving instead of merely being defined.\r\n      await Application.runStartupValidators();\r\n\r\n      // Late-phase connectors (http, socket) bind after app code has\r\n      // registered routes/listeners.\r\n      await connectorsManager.startPhase(ConnectorLifecyclePhase.Late);\r\n\r\n      this.layerExecutor = new LayerExecutor(\r\n        filesOrchestrator.getDependencyGraph(),\r\n        filesOrchestrator.specialFilesCollector,\r\n        filesOrchestrator.moduleLoader,\r\n        (absolutePath) => filesOrchestrator.bumpVersion(absolutePath),\r\n        () => filesOrchestrator.flushVersionBumps(),\r\n      );\r\n\r\n      this.running = true;\r\n\r\n      const duration = performance.now() - startedAt;\r\n      devLogReady(`Development Server is ready in ${colors.greenBright(parseDuration(duration))}`);\r\n\r\n      // App modules are loaded and both connector phases are active — signal a\r\n      // complete boot so `Application.onceBooted(...)` listeners fire.\r\n      Application.markBooted({\r\n        environment: Application.environment,\r\n        runtimeStrategy: Application.runtimeStrategy,\r\n        bootDurationMs: duration,\r\n      });\r\n\r\n      // Precedence: explicit CLI option > devServer.* config > default.\r\n      const devServerConfig = await warlockConfigManager.get(\"devServer\");\r\n      const generateTypings =\r\n        this.options.generateTypings ?? devServerConfig?.generateTypings ?? true;\r\n      const healthCheckers = this.options.healthCheckers ?? devServerConfig?.healthCheckers ?? true;\r\n\r\n      if (generateTypings) typeGenerator.executeGenerateAllCommand();\r\n\r\n      if (healthCheckers) {\r\n        filesOrchestrator.startCheckingHealth(healthCheckers === true ? undefined : healthCheckers);\r\n      }\r\n    } catch (error) {\r\n      devServeLog(colors.redBright(`Failed to start Development Server: ${error}`));\r\n      await this.shutdown();\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Eagerly import files whose decorators populate global registries so any\r\n   * symbol-by-name resolution later in boot finds them.\r\n   */\r\n  private async autoDiscoverFiles(): Promise<void> {\r\n    const discoveryTypes = [\"model\"] as const;\r\n    for (const file of filesOrchestrator.files.values()) {\r\n      if (file.type && (discoveryTypes as readonly string[]).includes(file.type)) {\r\n        await filesOrchestrator.moduleLoader.loadModule(file, file.type);\r\n      }\r\n    }\r\n  }\r\n\r\n  private setupEventListeners(): void {\r\n    events.on(\"dev-server:batch-complete\", (batch: Batch) => this.handleBatchComplete(batch));\r\n  }\r\n\r\n  private async handleBatchComplete(batch: Batch): Promise<void> {\r\n    if (!this.running || !this.layerExecutor) return;\r\n\r\n    // warlock.config.ts holds settings read at boot (CLI commands, build\r\n    // options, watch patterns, scheduled jobs) and .env feeds every config\r\n    // that reads it. Neither can be hot-reloaded without leaving running\r\n    // services configured with stale values, so the only honest response is\r\n    // a full restart.\r\n    const restartTrigger = this.findRestartTrigger(batch);\r\n\r\n    if (restartTrigger) {\r\n      // On success this never comes back — the process exits and the\r\n      // supervisor replaces it. Reaching the next line means the restart was\r\n      // declined by config or wasn't possible, so we fall through and still\r\n      // hot-reload whatever ordinary code shared the batch.\r\n      await this.restartForConfigChange(restartTrigger);\r\n    }\r\n\r\n    // No-op saves (an editor that fsyncs without a content write) are already\r\n    // filtered upstream by the file hash in FileEventHandler, so batch.changed\r\n    // only contains genuinely-changed paths by the time it reaches here.\r\n\r\n    const total = batch.added.length + batch.changed.length + batch.deleted.length;\r\n    if (total === 0) return;\r\n\r\n    // Boot-time files still ride along in `changed` when a restart was\r\n    // declined (`restartOnConfigChange: false`) or wasn't possible — they are\r\n    // never hot-reloaded, so keep them out of the reload set either way.\r\n    const codeFiles = [...batch.added, ...batch.changed].filter(\r\n      (p) => !isEnvPath(p) && p !== \"warlock.config.ts\",\r\n    );\r\n\r\n    try {\r\n      await this.layerExecutor.executeBatchReload(\r\n        codeFiles,\r\n        filesOrchestrator.getFiles(),\r\n        batch.deleted,\r\n        batch.changed,\r\n      );\r\n\r\n      typeGenerator.executeTypingsGenerator([...batch.added, ...batch.changed]);\r\n\r\n      filesOrchestrator.checkHealth(batch);\r\n    } catch (error) {\r\n      devServeLog(colors.redBright(`Failed to execute batch reload: ${error}`));\r\n    }\r\n  }\r\n\r\n  /**\r\n   * The boot-time file in this batch that can only be applied by restarting,\r\n   * or `undefined` when the batch is ordinary application code.\r\n   */\r\n  private findRestartTrigger(batch: Batch): string | undefined {\r\n    if (batch.changed.includes(\"warlock.config.ts\")) {\r\n      return \"warlock.config.ts\";\r\n    }\r\n\r\n    return [...batch.added, ...batch.changed].find(isEnvPath);\r\n  }\r\n\r\n  /**\r\n   * Restart so a changed boot-time file actually takes effect.\r\n   *\r\n   * Opt out with `devServer.restartOnConfigChange: false` and the old\r\n   * behaviour returns: a warning telling you to restart yourself. If the\r\n   * restart can't be performed at all (no supervisor, a shutdown that threw),\r\n   * `restartDevServer` reports it and we fall back to the same warning rather\r\n   * than leaving the server running against config it isn't using.\r\n   */\r\n  private async restartForConfigChange(file: string): Promise<void> {\r\n    const devServerConfig = await warlockConfigManager.get(\"devServer\");\r\n\r\n    if (devServerConfig?.restartOnConfigChange === false) {\r\n      devLogWarn(`${file} changed — restart the dev server to apply.`);\r\n      return;\r\n    }\r\n\r\n    devLogInfo(`${file} changed — restarting to apply.`);\r\n\r\n    const restarted = await restartDevServer(this);\r\n\r\n    if (!restarted) {\r\n      devLogWarn(`${file} changed — restart the dev server to apply.`);\r\n    }\r\n  }\r\n\r\n  public async shutdown(): Promise<void> {\r\n    // Always hand the terminal back, even on a repeat/no-op shutdown — a\r\n    // process that exits while stdin is still in raw mode leaves the user's\r\n    // shell without line editing or Ctrl+C.\r\n    devServerShortcuts.release();\r\n\r\n    if (!this.running) return;\r\n    devServeLog(colors.redBright(\"Shutting down Development Server...\"));\r\n    this.running = false;\r\n    await connectorsManager.shutdown();\r\n    devServeLog(colors.greenBright(\"Development Server stopped\"));\r\n  }\r\n\r\n  public isRunning(): boolean {\r\n    return this.running;\r\n  }\r\n}\r\n\r\n\r\nfunction isEnvPath(path: string): boolean {\r\n  const basename = path.split(\"/\").pop() ?? path;\r\n  return basename === \".env\" || basename.startsWith(\".env.\");\r\n}\r\n\r\nfunction parseDuration(ms: number): string {\r\n  if (ms < 1000) return `${ms.toFixed(2)}ms`;\r\n  if (ms > 60_000) return `${(ms / 60_000).toFixed(2)}m`;\r\n  return `${(ms / 1000).toFixed(2)}s`;\r\n}\r\n"],"mappings":"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"}

package/esm/dev-server/layer-executor.mjs

@@ -1,3 +1,4 @@
+import { environmentLoaderOptions } from "../utils/load-environment.mjs";
 import { connectorsManager } from "../connectors/connectors-manager.mjs";
 import { devLogHMR } from "./dev-logger.mjs";
 import { configManager } from "../config/config-manager.mjs";
@@ -69,7 +70,7 @@ var LayerExecutor = class {
 	*/
 	async reloadAffectedModules(chain, filesMap) {
 		const isEnvAffected = chain.some(isEnvPath);
-		if (isEnvAffected) await loadEnv();
+		if (isEnvAffected) await loadEnv(void 0, environmentLoaderOptions);
 		const isAffected = (file) => isFileAffected(file, chain);
 		const affectedModels = chain.map((path) => filesMap.get(path)).filter((file) => !!file && file.type === "model");
 		for (const file of affectedModels) await this.moduleLoader.loadModule(file, "model");

package/esm/dev-server/layer-executor.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"layer-executor.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/layer-executor.ts"],"sourcesContent":["import { loadEnv } from \"@mongez/dotenv\";\r\nimport { configManager } from \"../config/config-manager\";\r\nimport { connectorsManager } from \"../connectors/connectors-manager\";\r\nimport type { DependencyGraph } from \"./dependency-graph\";\r\nimport { devLogHMR } from \"./dev-logger\";\r\nimport { FileManager } from \"./file-manager\";\r\nimport type { ModuleLoader } from \"./module-loader\";\r\nimport type { SpecialFilesCollector } from \"./special-files-collector\";\r\n\r\n/**\r\n * Decides what to reload when a batch of files changes.\r\n *\r\n * Strategy: bump the hook's version counter for every file in the\r\n * invalidation chain, wait for the hook worker to flush, then re-import\r\n * any special files (config / main / routes / events / locales) the chain\r\n * touched and restart any connector whose watched-files overlap the change.\r\n */\r\nexport class LayerExecutor {\r\n  public constructor(\r\n    private readonly dependencyGraph: DependencyGraph,\r\n    private readonly specialFilesCollector: SpecialFilesCollector,\r\n    private readonly moduleLoader: ModuleLoader,\r\n    private readonly bumpVersion: (absolutePath: string) => void,\r\n    private readonly flushVersionBumps: () => Promise<void>,\r\n  ) {}\r\n\r\n  /**\r\n   * Entry point for the file watcher batch.\r\n   *\r\n   * @param changedPaths - code files added or changed in this batch\r\n   * @param filesMap - all tracked files (relativePath → FileManager)\r\n   * @param deletedFiles - paths that were removed from disk\r\n   * @param allChangedPaths - includes .env so we can detect config reloads\r\n   */\r\n  public async executeBatchReload(\r\n    changedPaths: string[],\r\n    filesMap: Map<string, FileManager>,\r\n    deletedFiles: string[],\r\n    allChangedPaths?: string[],\r\n  ): Promise<void> {\r\n    const envFilesChanged = (allChangedPaths ?? []).some(isEnvPath);\r\n\r\n    if (changedPaths.length === 0 && deletedFiles.length === 0 && !envFilesChanged) {\r\n      return;\r\n    }\r\n\r\n    // Deletes: clean up routes/cleanup hooks for files that no longer exist.\r\n    for (const path of deletedFiles) {\r\n      const file = filesMap.get(path);\r\n      if (file) this.moduleLoader.cleanupDeletedModule(file);\r\n    }\r\n\r\n    // Env-only change: reload all configs, restart connectors that watch them.\r\n    if (changedPaths.length === 0 && envFilesChanged) {\r\n      const configPaths = await this.reloadAffectedModules([\".env\"], filesMap);\r\n      await this.restartAffectedConnectors(configPaths);\r\n      return;\r\n    }\r\n\r\n    if (changedPaths.length === 0) return;\r\n\r\n    const invalidationChain = new Set<string>();\r\n    for (const path of changedPaths) {\r\n      for (const file of this.dependencyGraph.getInvalidationChain(path)) {\r\n        invalidationChain.add(file);\r\n      }\r\n      devLogHMR(path, invalidationChain.size - 1);\r\n    }\r\n\r\n    const chain = Array.from(invalidationChain);\r\n\r\n    // Step 1: bump version counters so the next import() is fresh.\r\n    for (const relativePath of chain) {\r\n      const file = filesMap.get(relativePath);\r\n      if (!file) continue;\r\n      this.moduleLoader.runCleanup(file);\r\n      this.bumpVersion(file.absolutePath);\r\n      await file.process({ force: true });\r\n    }\r\n\r\n    // Step 2: wait for the hook worker to ack every bump.\r\n    // Without this, resolve() may still return the old ?v=N URL.\r\n    await this.flushVersionBumps();\r\n\r\n    // Step 3: re-import affected special files.\r\n    const affectedConfigPaths = await this.reloadAffectedModules(chain, filesMap);\r\n\r\n    // Step 4: restart any connector whose watched-files overlap the chain.\r\n    await this.restartAffectedConnectors([...changedPaths, ...affectedConfigPaths]);\r\n  }\r\n\r\n  private async restartAffectedConnectors(affectedFiles: string[]): Promise<void> {\r\n    const toRestart = connectorsManager\r\n      .list()\r\n      .filter(connector => connector.shouldRestart(affectedFiles));\r\n\r\n    for (const connector of toRestart) {\r\n      await connector.restart();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Re-import every special file whose path or dependency-set intersects the\r\n   * invalidation chain. Returns the relative paths of any config files that\r\n   * reloaded so the caller can pass them to the connector-restart pass.\r\n   */\r\n  private async reloadAffectedModules(\r\n    chain: string[],\r\n    filesMap: Map<string, FileManager>,\r\n  ): Promise<string[]> {\r\n    const isEnvAffected = chain.some(isEnvPath);\r\n    if (isEnvAffected) await loadEnv();\r\n\r\n    const isAffected = (file: FileManager) => isFileAffected(file, chain);\r\n\r\n    // Models self-register via the @RegisterModel decorator and rely on the\r\n    // module-loader's registerCleanup() to attach Model.$cleanup (which\r\n    // unregisters them on the next reload). That only happens inside\r\n    // loadModule(), which models hit exactly once — at boot, via\r\n    // autoDiscoverFiles. During HMR they're otherwise re-imported\r\n    // *transitively* through routes, which never re-runs registerCleanup, so\r\n    // after the first reload the cleanup list is empty and the registration\r\n    // leaks (\"Model X is already registered\" on every subsequent edit).\r\n    //\r\n    // Re-importing changed model files through loadModule here re-attaches\r\n    // $cleanup every cycle. It runs before the route pass so the decorator\r\n    // registers once; the transitive route import then hits the cached ?v=N\r\n    // and does not double-register.\r\n    const affectedModels = chain\r\n      .map(path => filesMap.get(path))\r\n      .filter((file): file is FileManager => !!file && file.type === \"model\");\r\n\r\n    for (const file of affectedModels) {\r\n      await this.moduleLoader.loadModule(file, \"model\");\r\n    }\r\n\r\n    const collector = this.specialFilesCollector;\r\n    const affectedConfigs = collector\r\n      .getFilesByType(\"config\")\r\n      .filter(file => (isEnvAffected ? true : isAffected(file)));\r\n    const affectedMains = collector.getFilesByType(\"main\").filter(isAffected);\r\n    const affectedRoutes = collector.getFilesByType(\"route\").filter(isAffected);\r\n    const affectedEvents = collector.getFilesByType(\"event\").filter(isAffected);\r\n    const affectedLocales = collector.getFilesByType(\"locale\").filter(isAffected);\r\n\r\n    const hasSpecialFiles =\r\n      affectedConfigs.length > 0 ||\r\n      affectedMains.length > 0 ||\r\n      affectedRoutes.length > 0 ||\r\n      affectedEvents.length > 0 ||\r\n      affectedLocales.length > 0;\r\n\r\n    // No entry points touched: reloading internal files alone is wasted work\r\n    // because the hook will re-import them on next access anyway. But the\r\n    // dep chain's last hop is usually the user-facing edge — give it a kick.\r\n    if (!hasSpecialFiles) {\r\n      const tail = filesMap.get(chain[chain.length - 1]);\r\n      if (tail) await this.moduleLoader.reloadModule(tail);\r\n      return [];\r\n    }\r\n\r\n    const configPaths: string[] = [];\r\n    for (const file of affectedConfigs) {\r\n      await configManager.reload(file);\r\n      configPaths.push(file.relativePath);\r\n    }\r\n\r\n    // Order matters: locales first (translations used by main), main before\r\n    // routes (registers state routes consume), events between (listeners).\r\n    for (const file of affectedLocales) await this.moduleLoader.reloadModule(file);\r\n    for (const file of affectedMains) await this.moduleLoader.reloadModule(file);\r\n    for (const file of affectedEvents) await this.moduleLoader.reloadModule(file);\r\n    for (const file of affectedRoutes) await this.moduleLoader.reloadModule(file);\r\n\r\n    return configPaths;\r\n  }\r\n}\r\n\r\nfunction isEnvPath(path: string): boolean {\r\n  const basename = path.split(\"/\").pop() ?? path;\r\n  return basename === \".env\" || basename.startsWith(\".env.\");\r\n}\r\n\r\n/**\r\n * A file is \"affected\" if it itself is in the chain or imports something in it.\r\n */\r\nfunction isFileAffected(file: FileManager, chain: string[]): boolean {\r\n  if (chain.includes(file.relativePath)) return true;\r\n  for (const dep of file.dependencies) {\r\n    if (chain.includes(dep)) return true;\r\n  }\r\n  return false;\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"layer-executor.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/layer-executor.ts"],"sourcesContent":["import { loadEnv } from \"@mongez/dotenv\";\r\nimport { configManager } from \"../config/config-manager\";\r\nimport { connectorsManager } from \"../connectors/connectors-manager\";\r\nimport type { DependencyGraph } from \"./dependency-graph\";\r\nimport { devLogHMR } from \"./dev-logger\";\r\nimport { FileManager } from \"./file-manager\";\r\nimport type { ModuleLoader } from \"./module-loader\";\r\nimport type { SpecialFilesCollector } from \"./special-files-collector\";\r\nimport { environmentLoaderOptions } from \"../utils/load-environment\";\r\n\r\n/**\r\n * Decides what to reload when a batch of files changes.\r\n *\r\n * Strategy: bump the hook's version counter for every file in the\r\n * invalidation chain, wait for the hook worker to flush, then re-import\r\n * any special files (config / main / routes / events / locales) the chain\r\n * touched and restart any connector whose watched-files overlap the change.\r\n */\r\nexport class LayerExecutor {\r\n  public constructor(\r\n    private readonly dependencyGraph: DependencyGraph,\r\n    private readonly specialFilesCollector: SpecialFilesCollector,\r\n    private readonly moduleLoader: ModuleLoader,\r\n    private readonly bumpVersion: (absolutePath: string) => void,\r\n    private readonly flushVersionBumps: () => Promise<void>,\r\n  ) {}\r\n\r\n  /**\r\n   * Entry point for the file watcher batch.\r\n   *\r\n   * @param changedPaths - code files added or changed in this batch\r\n   * @param filesMap - all tracked files (relativePath → FileManager)\r\n   * @param deletedFiles - paths that were removed from disk\r\n   * @param allChangedPaths - includes .env so we can detect config reloads\r\n   */\r\n  public async executeBatchReload(\r\n    changedPaths: string[],\r\n    filesMap: Map<string, FileManager>,\r\n    deletedFiles: string[],\r\n    allChangedPaths?: string[],\r\n  ): Promise<void> {\r\n    const envFilesChanged = (allChangedPaths ?? []).some(isEnvPath);\r\n\r\n    if (changedPaths.length === 0 && deletedFiles.length === 0 && !envFilesChanged) {\r\n      return;\r\n    }\r\n\r\n    // Deletes: clean up routes/cleanup hooks for files that no longer exist.\r\n    for (const path of deletedFiles) {\r\n      const file = filesMap.get(path);\r\n      if (file) this.moduleLoader.cleanupDeletedModule(file);\r\n    }\r\n\r\n    // Env-only change: reload all configs, restart connectors that watch them.\r\n    if (changedPaths.length === 0 && envFilesChanged) {\r\n      const configPaths = await this.reloadAffectedModules([\".env\"], filesMap);\r\n      await this.restartAffectedConnectors(configPaths);\r\n      return;\r\n    }\r\n\r\n    if (changedPaths.length === 0) return;\r\n\r\n    const invalidationChain = new Set<string>();\r\n    for (const path of changedPaths) {\r\n      for (const file of this.dependencyGraph.getInvalidationChain(path)) {\r\n        invalidationChain.add(file);\r\n      }\r\n      devLogHMR(path, invalidationChain.size - 1);\r\n    }\r\n\r\n    const chain = Array.from(invalidationChain);\r\n\r\n    // Step 1: bump version counters so the next import() is fresh.\r\n    for (const relativePath of chain) {\r\n      const file = filesMap.get(relativePath);\r\n      if (!file) continue;\r\n      this.moduleLoader.runCleanup(file);\r\n      this.bumpVersion(file.absolutePath);\r\n      await file.process({ force: true });\r\n    }\r\n\r\n    // Step 2: wait for the hook worker to ack every bump.\r\n    // Without this, resolve() may still return the old ?v=N URL.\r\n    await this.flushVersionBumps();\r\n\r\n    // Step 3: re-import affected special files.\r\n    const affectedConfigPaths = await this.reloadAffectedModules(chain, filesMap);\r\n\r\n    // Step 4: restart any connector whose watched-files overlap the chain.\r\n    await this.restartAffectedConnectors([...changedPaths, ...affectedConfigPaths]);\r\n  }\r\n\r\n  private async restartAffectedConnectors(affectedFiles: string[]): Promise<void> {\r\n    const toRestart = connectorsManager\r\n      .list()\r\n      .filter(connector => connector.shouldRestart(affectedFiles));\r\n\r\n    for (const connector of toRestart) {\r\n      await connector.restart();\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Re-import every special file whose path or dependency-set intersects the\r\n   * invalidation chain. Returns the relative paths of any config files that\r\n   * reloaded so the caller can pass them to the connector-restart pass.\r\n   */\r\n  private async reloadAffectedModules(\r\n    chain: string[],\r\n    filesMap: Map<string, FileManager>,\r\n  ): Promise<string[]> {\r\n    const isEnvAffected = chain.some(isEnvPath);\r\n    // Same precedence policy as the boot-time load: an exported variable is not\r\n    // demoted to the file's value just because the file was touched.\r\n    if (isEnvAffected) await loadEnv(undefined, environmentLoaderOptions);\r\n\r\n    const isAffected = (file: FileManager) => isFileAffected(file, chain);\r\n\r\n    // Models self-register via the @RegisterModel decorator and rely on the\r\n    // module-loader's registerCleanup() to attach Model.$cleanup (which\r\n    // unregisters them on the next reload). That only happens inside\r\n    // loadModule(), which models hit exactly once — at boot, via\r\n    // autoDiscoverFiles. During HMR they're otherwise re-imported\r\n    // *transitively* through routes, which never re-runs registerCleanup, so\r\n    // after the first reload the cleanup list is empty and the registration\r\n    // leaks (\"Model X is already registered\" on every subsequent edit).\r\n    //\r\n    // Re-importing changed model files through loadModule here re-attaches\r\n    // $cleanup every cycle. It runs before the route pass so the decorator\r\n    // registers once; the transitive route import then hits the cached ?v=N\r\n    // and does not double-register.\r\n    const affectedModels = chain\r\n      .map(path => filesMap.get(path))\r\n      .filter((file): file is FileManager => !!file && file.type === \"model\");\r\n\r\n    for (const file of affectedModels) {\r\n      await this.moduleLoader.loadModule(file, \"model\");\r\n    }\r\n\r\n    const collector = this.specialFilesCollector;\r\n    const affectedConfigs = collector\r\n      .getFilesByType(\"config\")\r\n      .filter(file => (isEnvAffected ? true : isAffected(file)));\r\n    const affectedMains = collector.getFilesByType(\"main\").filter(isAffected);\r\n    const affectedRoutes = collector.getFilesByType(\"route\").filter(isAffected);\r\n    const affectedEvents = collector.getFilesByType(\"event\").filter(isAffected);\r\n    const affectedLocales = collector.getFilesByType(\"locale\").filter(isAffected);\r\n\r\n    const hasSpecialFiles =\r\n      affectedConfigs.length > 0 ||\r\n      affectedMains.length > 0 ||\r\n      affectedRoutes.length > 0 ||\r\n      affectedEvents.length > 0 ||\r\n      affectedLocales.length > 0;\r\n\r\n    // No entry points touched: reloading internal files alone is wasted work\r\n    // because the hook will re-import them on next access anyway. But the\r\n    // dep chain's last hop is usually the user-facing edge — give it a kick.\r\n    if (!hasSpecialFiles) {\r\n      const tail = filesMap.get(chain[chain.length - 1]);\r\n      if (tail) await this.moduleLoader.reloadModule(tail);\r\n      return [];\r\n    }\r\n\r\n    const configPaths: string[] = [];\r\n    for (const file of affectedConfigs) {\r\n      await configManager.reload(file);\r\n      configPaths.push(file.relativePath);\r\n    }\r\n\r\n    // Order matters: locales first (translations used by main), main before\r\n    // routes (registers state routes consume), events between (listeners).\r\n    for (const file of affectedLocales) await this.moduleLoader.reloadModule(file);\r\n    for (const file of affectedMains) await this.moduleLoader.reloadModule(file);\r\n    for (const file of affectedEvents) await this.moduleLoader.reloadModule(file);\r\n    for (const file of affectedRoutes) await this.moduleLoader.reloadModule(file);\r\n\r\n    return configPaths;\r\n  }\r\n}\r\n\r\nfunction isEnvPath(path: string): boolean {\r\n  const basename = path.split(\"/\").pop() ?? path;\r\n  return basename === \".env\" || basename.startsWith(\".env.\");\r\n}\r\n\r\n/**\r\n * A file is \"affected\" if it itself is in the chain or imports something in it.\r\n */\r\nfunction isFileAffected(file: FileManager, chain: string[]): boolean {\r\n  if (chain.includes(file.relativePath)) return true;\r\n  for (const dep of file.dependencies) {\r\n    if (chain.includes(dep)) return true;\r\n  }\r\n  return false;\r\n}\r\n"],"mappings":"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"}

package/esm/dev-server/read-config-ast.mjs

@@ -0,0 +1,48 @@
+import { readFile } from "node:fs/promises";
+import ts from "typescript";
+
+//#region ../core/src/dev-server/read-config-ast.ts
+/**
+* Parse one config file into an AST.
+*
+* ## Why this is not `ts.createProgram`
+*
+* It was. The typings generator built a whole TypeScript **Program** for each
+* config file just to call `program.getSourceFile(path)` on it. A Warlock
+* config imports `@warlock.js/core`, which in this monorepo resolves to
+* TypeScript **source**, so every one of those Programs resolved and parsed the
+* entire dependency graph behind it.
+*
+* Measured on the reference app's six configs, 2026-08-24:
+*
+* ```
+* ts.createProgram      82,996.00 ms    2,908 source files per program
+* ts.createSourceFile        5.12 ms
+* ratio                 16,212x
+* ```
+*
+* And all of it was discarded. `getTypeChecker()` is never called anywhere in
+* the generator — every question it asks of the AST is syntactic
+* (`isImportDeclaration`, `isTypeAliasDeclaration`, `isVariableDeclaration`,
+* `isObjectLiteralExpression`). Resolving 2,908 files to answer a syntactic
+* question is 2,908 files of work thrown away.
+*
+* A previous pass had already noticed the cost and halved it, from two Programs
+* per file to one — an optimisation inside a premise that did not need to hold.
+*
+* **If a future change here needs a type checker, it needs a Program too, and
+* the cost comes back.** That is the one reason to reconsider this file.
+*/
+async function readConfigAst(filePath) {
+	let contents;
+	try {
+		contents = await readFile(filePath, "utf-8");
+	} catch {
+		return;
+	}
+	return ts.createSourceFile(filePath, contents, ts.ScriptTarget.ESNext, true);
+}
+
+//#endregion
+export { readConfigAst };
+//# sourceMappingURL=read-config-ast.mjs.map

package/esm/dev-server/read-config-ast.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-config-ast.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/read-config-ast.ts"],"sourcesContent":["/**\n * Parse one config file into an AST.\n *\n * ## Why this is not `ts.createProgram`\n *\n * It was. The typings generator built a whole TypeScript **Program** for each\n * config file just to call `program.getSourceFile(path)` on it. A Warlock\n * config imports `@warlock.js/core`, which in this monorepo resolves to\n * TypeScript **source**, so every one of those Programs resolved and parsed the\n * entire dependency graph behind it.\n *\n * Measured on the reference app's six configs, 2026-08-24:\n *\n * ```\n * ts.createProgram      82,996.00 ms    2,908 source files per program\n * ts.createSourceFile        5.12 ms\n * ratio                 16,212x\n * ```\n *\n * And all of it was discarded. `getTypeChecker()` is never called anywhere in\n * the generator — every question it asks of the AST is syntactic\n * (`isImportDeclaration`, `isTypeAliasDeclaration`, `isVariableDeclaration`,\n * `isObjectLiteralExpression`). Resolving 2,908 files to answer a syntactic\n * question is 2,908 files of work thrown away.\n *\n * A previous pass had already noticed the cost and halved it, from two Programs\n * per file to one — an optimisation inside a premise that did not need to hold.\n *\n * **If a future change here needs a type checker, it needs a Program too, and\n * the cost comes back.** That is the one reason to reconsider this file.\n */\n\nimport { readFile } from \"node:fs/promises\";\nimport ts from \"typescript\";\n\nexport async function readConfigAst(filePath: string): Promise<ts.SourceFile | undefined> {\n  let contents: string;\n\n  try {\n    contents = await readFile(filePath, \"utf-8\");\n  } catch {\n    // Callers already treat a missing config as \"nothing to generate\"; a throw\n    // here would turn an absent optional file into a failed generation.\n    return undefined;\n  }\n\n  return ts.createSourceFile(\n    filePath,\n    contents,\n    ts.ScriptTarget.ESNext,\n    // The generator's visitors read `node.parent`, which the Program-backed\n    // source files provided for free.\n    /* setParentNodes */ true,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,eAAsB,cAAc,UAAsD;CACxF,IAAI;CAEJ,IAAI;EACF,WAAW,MAAM,SAAS,UAAU,OAAO;CAC7C,QAAQ;EAGN;CACF;CAEA,OAAO,GAAG,iBACR,UACA,UACA,GAAG,aAAa,QAGK,IACvB;AACF"}

package/esm/dev-server/run-typings-generation.mjs

@@ -0,0 +1,18 @@
+//#region ../core/src/dev-server/run-typings-generation.ts
+function describeCause(thrown) {
+	if (thrown instanceof Error) return thrown.message;
+	return String(thrown);
+}
+async function runTypingsGeneration(ports) {
+	ports.info("Checking for types generation");
+	try {
+		await ports.generate();
+		ports.success("Types generated successfully");
+	} catch (thrown) {
+		ports.error(`Failed to generate types: ${describeCause(thrown)}`);
+	}
+}
+
+//#endregion
+export { runTypingsGeneration };
+//# sourceMappingURL=run-typings-generation.mjs.map

package/esm/dev-server/run-typings-generation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-typings-generation.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/run-typings-generation.ts"],"sourcesContent":["/**\n * Run type generation, in this process.\n *\n * ## Why this is not a spawn\n *\n * It used to be. `type-generator.ts` ran `npx warlock generate.typings`, which\n * resolves to `core/bin/warlock.js` → `import \"../esm/cli/start.mjs\"`. This\n * monorepo consumes packages as TypeScript **source**, so there is no `esm/`\n * directory: every dev boot printed `✗ Failed to generate types`, and an\n * `ERR_MODULE_NOT_FOUND` stack rode along inside an otherwise green core suite.\n *\n * Spawning was the mistake underneath the broken path. The CLI command it\n * launched does two things — add the config files to the orchestrator, then\n * call `typeGenerator.generateAll()` — and the dev server has **already**\n * initialised that orchestrator with those files at boot. So it paid for a\n * second Node process to rediscover state it was holding, in order to call a\n * method that lives in the same module it was calling from.\n *\n * Launching a binary through `npx` is separately prohibited in this workspace:\n * resolve and invoke directly.\n *\n * ## Why a failure here is not fatal\n *\n * Generated typings are editor autocomplete. A dev server that refused to boot\n * because it could not write them would be a worse defect than the one this\n * replaces, so this never throws — but it does say **why**, which the old\n * `Failed to generate types` did not. A failure message that names no cause\n * sends the reader hunting, which is most of what the old line achieved.\n */\n\nexport type TypingsGenerationPorts = {\n  /** `typeGenerator.generateAll()` in production; a fake in tests. */\n  generate(): Promise<void>;\n  info(message: string): void;\n  success(message: string): void;\n  error(message: string): void;\n};\n\nfunction describeCause(thrown: unknown): string {\n  if (thrown instanceof Error) return thrown.message;\n\n  return String(thrown);\n}\n\nexport async function runTypingsGeneration(ports: TypingsGenerationPorts): Promise<void> {\n  ports.info(\"Checking for types generation\");\n\n  try {\n    await ports.generate();\n\n    ports.success(\"Types generated successfully\");\n  } catch (thrown) {\n    ports.error(`Failed to generate types: ${describeCause(thrown)}`);\n  }\n}\n"],"mappings":";AAsCA,SAAS,cAAc,QAAyB;CAC9C,IAAI,kBAAkB,OAAO,OAAO,OAAO;CAE3C,OAAO,OAAO,MAAM;AACtB;AAEA,eAAsB,qBAAqB,OAA8C;CACvF,MAAM,KAAK,+BAA+B;CAE1C,IAAI;EACF,MAAM,MAAM,SAAS;EAErB,MAAM,QAAQ,8BAA8B;CAC9C,SAAS,QAAQ;EACf,MAAM,MAAM,6BAA6B,cAAc,MAAM,GAAG;CAClE;AACF"}

package/esm/dev-server/type-generator.mjs

@@ -3,13 +3,13 @@ import { warlockPath } from "../utils/paths.mjs";
 import "../utils/index.mjs";
 import { devLogError, devLogInfo, devLogSuccess, devServeLog } from "./dev-logger.mjs";
 import { filesOrchestrator } from "./files-orchestrator.mjs";
-import { env } from "@mongez/dotenv";
+import { readConfigAst } from "./read-config-ast.mjs";
+import { runTypingsGeneration } from "./run-typings-generation.mjs";
 import { join, resolve } from "path";
 import { ensureDirectoryAsync } from "@warlock.js/fs";
 import { constants } from "fs";
 import { access, readFile, writeFile } from "fs/promises";
 import ts from "typescript";
-import { spawn } from "child_process";
 
 //#region ../core/src/dev-server/type-generator.ts
 /**
@@ -269,9 +269,10 @@ ${allKeys.map((key) => `    "${key}": true;`).join("\n")}
 	/**
 	* Extract BOTH type info AND keys in a single pass
 	*
-	* This is optimized to create ts.createProgram() only ONCE per file
-	* instead of twice (once for type extraction, once for keys).
-	* This reduces parsing time by ~50%.
+	* One parse serves both extractions. It used to be one whole TypeScript
+	* Program per file — halved from two by an earlier pass, which optimised
+	* inside a premise that did not need to hold. `read-config-ast.ts` has the
+	* numbers.
 	*
 	* @param configPath Absolute path to the config file
 	* @param configName Config name (e.g., "auth", "notifications")
@@ -283,11 +284,7 @@ ${allKeys.map((key) => `    "${key}": true;`).join("\n")}
 			importSource: null,
 			keys: []
 		};
-		const sourceFile = ts.createProgram([configPath], {
-			target: ts.ScriptTarget.ESNext,
-			module: ts.ModuleKind.ESNext,
-			moduleResolution: ts.ModuleResolutionKind.NodeJs
-		}).getSourceFile(configPath);
+		const sourceFile = await readConfigAst(configPath);
 		if (!sourceFile) return {
 			typeName: null,
 			importSource: null,
@@ -355,11 +352,7 @@ ${allKeys.map((key) => `    "${key}": true;`).join("\n")}
 			devServeLog(`⚠️ Storage config not found: ${absolutePath}`);
 			return [];
 		}
-		const sourceFile = ts.createProgram([absolutePath], {
-			target: ts.ScriptTarget.ESNext,
-			module: ts.ModuleKind.ESNext,
-			moduleResolution: ts.ModuleResolutionKind.NodeJs
-		}).getSourceFile(absolutePath);
+		const sourceFile = await readConfigAst(absolutePath);
 		if (!sourceFile) {
 			devServeLog(`⚠️ Could not parse storage config: ${absolutePath}`);
 			return [];
@@ -411,36 +404,34 @@ ${allKeys.map((key) => `    "${key}": true;`).join("\n")}
 		}
 	}
 	/**
-	* Execute generateAll command using spawn
+	* The ports `runTypingsGeneration` needs, bound to this instance and this
+	* package's dev logger.
+	*/
+	get typingsGenerationPorts() {
+		return {
+			generate: () => this.generateAll(),
+			info: (message) => devLogInfo(message),
+			success: (message) => devLogSuccess(message),
+			error: (message) => devLogError(message)
+		};
+	}
+	/**
+	* Generate every config's typings.
+	*
+	* Runs IN THIS PROCESS. It used to spawn `npx warlock generate.typings`,
+	* which could not resolve in a source checkout — see
+	* `run-typings-generation.ts` for the whole story.
 	*/
 	async executeGenerateAllCommand() {
-		devLogInfo("Checking for types generation");
-		const isDevServeCore = env("DEV_SERVER_CORE");
-		spawn(isDevServeCore ? "yarn" : "npx", [isDevServeCore ? "cli" : "warlock", "generate.typings"], {
-			stdio: "inherit",
-			cwd: process.cwd(),
-			shell: true
-		}).on("exit", (code) => {
-			if (code === 0) devLogSuccess("Types generated successfully");
-			else devLogError("Failed to generate types");
-		});
+		await runTypingsGeneration(this.typingsGenerationPorts);
 	}
 	/**
-	* Execute a typings generator for the given files
+	* Regenerate typings after a batch reload — but only when the batch actually
+	* touched a config file, since nothing else contributes to them.
 	*/
 	async executeTypingsGenerator(upcomingFiles) {
-		const configFilesOnly = Array.from(new Set(upcomingFiles)).filter((file) => Path.normalize(file).includes("src/config/"));
-		if (configFilesOnly.length === 0) return;
-		configFilesOnly.map((file) => "./" + Path.toRelative(file));
-		const isDevServeCore = env("DEV_SERVER_CORE");
-		spawn(isDevServeCore ? "yarn" : "npx", [isDevServeCore ? "cli" : "warlock", "generate.typings"], {
-			stdio: "inherit",
-			cwd: process.cwd(),
-			shell: true
-		}).on("exit", (code) => {
-			if (code === 0) devLogSuccess("Types generated successfully");
-			else devLogError("Failed to generate types");
-		});
+		if (!Array.from(new Set(upcomingFiles)).some((file) => Path.normalize(file).includes("src/config/"))) return;
+		await runTypingsGeneration(this.typingsGenerationPorts);
 	}
 };
 /**