@warlock.js/core 5.31.0 → 5.33.0

package/esm/connectors/storage.connector.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage.connector.mjs","names":[],"sources":["../../../../../../../../packages/core/src/connectors/storage.connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { log } from \"@warlock.js/logger\";\nimport { storage } from \"../storage\";\nimport { environment } from \"../utils/environment\";\nimport { localStorageWarning } from \"./single-server-warnings\";\nimport { loadS3 } from \"../storage/drivers/cloud-driver\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Cache Connector\n * Manages cache engine connection lifecycle\n */\nexport class StorageConnector extends BaseConnector {\n  public readonly name = \"storage\";\n  public readonly priority = ConnectorPriority.STORAGE;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger cache restart\n   */\n  protected readonly watchedFiles = [\"src/config/storage.ts\", \"src/config/storage.tsx\"];\n\n  /**\n   * Initialize storage.\n   *\n   * Unlike its siblings (database, cache, herald), this connector does NOT\n   * early-return when `config.get(\"storage\")` is absent. Storage is\n   * intentionally always-on: `storage.init()` registers a built-in `local`\n   * driver rooted at `uploadsPath()` before reading configured drivers, so file\n   * storage works out of the box even when a project ships no\n   * `src/config/storage.ts`. A config-presence guard here would break that.\n   *\n   * That fallback is real as of 4.11.0. Until then this comment described it\n   * and nothing implemented it, so every app without `src/config/storage.ts`\n   * died at boot with `Storage driver \"local\" is not configured` — a decision\n   * to skip the guard, taken on the authority of behaviour nobody had written.\n   * See `Storage.registerBuiltInLocalDriver`.\n   */\n  public async start(): Promise<void> {\n    await loadS3();\n    await storage.init();\n\n    const warning = localStorageWarning(\n      config.get(\"storage.default\", \"local\"),\n      environment(),\n      config.get(\"storage.silenceSingleServerWarning\") === true,\n    );\n\n    if (warning) log.warn(\"storage\", \"single-server\", warning);\n\n    this.active = true;\n  }\n\n  /**\n   * Shutdown cache connection\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    storage.reset();\n\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAaA,IAAa,mBAAb,cAAsC,cAAc;;;cAC3B;;;sBAOW,CAAC,yBAAyB,wBAAwB;;;;;;;;;;;;;;;;;;CAkBpF,MAAa,QAAuB;EAClC,MAAM,OAAO;EACb,MAAM,QAAQ,KAAK;EAEnB,MAAM,UAAU,oBACd,OAAO,IAAI,mBAAmB,OAAO,GACrC,YAAY,GACZ,OAAO,IAAI,oCAAoC,MAAM,IACvD;EAEA,IAAI,SAAS,IAAI,KAAK,WAAW,iBAAiB,OAAO;EAEzD,KAAK,SAAS;CAChB;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,QAAQ,MAAM;EAEd,KAAK,SAAS;CAChB;AACF"}
+{"version":3,"file":"storage.connector.mjs","names":["config"],"sources":["../../../../../../../../packages/core/src/connectors/storage.connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { log } from \"@warlock.js/logger\";\nimport { storage } from \"../storage\";\nimport { environment } from \"../utils/environment\";\nimport { localStorageWarning } from \"./single-server-warnings\";\nimport { loadS3 } from \"../storage/drivers/cloud-driver\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, ConnectorPriority } from \"./types\";\n\n/**\n * Cache Connector\n * Manages cache engine connection lifecycle\n */\nexport class StorageConnector extends BaseConnector {\n  public readonly name = \"storage\";\n  public readonly priority = ConnectorPriority.STORAGE;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Early;\n\n  /**\n   * Files that trigger cache restart\n   */\n  protected readonly watchedFiles = [\"src/config/storage.ts\", \"src/config/storage.tsx\"];\n\n  /**\n   * Initialize storage.\n   *\n   * Unlike its siblings (database, cache, herald), this connector does NOT\n   * early-return when `config.get(\"storage\")` is absent. Storage is\n   * intentionally always-on: `storage.init()` registers a built-in `local`\n   * driver rooted at `uploadsPath()` before reading configured drivers, so file\n   * storage works out of the box even when a project ships no\n   * `src/config/storage.ts`. A config-presence guard here would break that.\n   *\n   * That fallback is real as of 4.11.0. Until then this comment described it\n   * and nothing implemented it, so every app without `src/config/storage.ts`\n   * died at boot with `Storage driver \"local\" is not configured` — a decision\n   * to skip the guard, taken on the authority of behaviour nobody had written.\n   * See `Storage.registerBuiltInLocalDriver`.\n   */\n  public async start(): Promise<void> {\n    await loadS3();\n    await storage.init();\n\n    const warning = localStorageWarning(\n      config.get(\"storage.default\", \"local\"),\n      environment(),\n      config.get(\"storage.silenceSingleServerWarning\") === true,\n    );\n\n    if (warning) log.warn(\"storage\", \"single-server\", warning);\n\n    this.active = true;\n  }\n\n  /**\n   * Shutdown cache connection\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    storage.reset();\n\n    this.active = false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAaA,IAAa,mBAAb,cAAsC,cAAc;;;cAC3B;;;sBAOW,CAAC,yBAAyB,wBAAwB;;;;;;;;;;;;;;;;;;CAkBpF,MAAa,QAAuB;EAClC,MAAM,OAAO;EACb,MAAM,QAAQ,KAAK;EAEnB,MAAM,UAAU,oBACdA,WAAO,IAAI,mBAAmB,OAAO,GACrC,YAAY,GACZA,WAAO,IAAI,oCAAoC,MAAM,IACvD;EAEA,IAAI,SAAS,IAAI,KAAK,WAAW,iBAAiB,OAAO;EAEzD,KAAK,SAAS;CAChB;;;;CAKA,MAAa,WAA0B;EACrC,IAAI,CAAC,KAAK,QACR;EAGF,QAAQ,MAAM;EAEd,KAAK,SAAS;CAChB;AACF"}

package/esm/connectors/types.d.mts

@@ -1,13 +1,12 @@
 import { NamedApiRoute } from "../router/types.mjs";
 import { ResolvedBuildConfig } from "../production/resolve-build-config.mjs";
 import { BuildOptions } from "esbuild";
-
 //#region ../../packages/core/src/connectors/types.d.ts
 /**
  * Connector Interface
  * All service connectors (Database, HTTP, Cache, etc.) must implement this interface
  */
-interface Connector {
+export interface Connector {
   /**
    * Unique name of the connector
    */
@@ -67,10 +66,14 @@ interface Connector {
  * 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; /** Fresh registration-only snapshot, present only when the Web connector is configured. */
+export 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;
+  /** Fresh registration-only snapshot, present only when the Web connector is configured. */
   readonly namedApiRoutes?: readonly NamedApiRoute[];
 };
 /**
@@ -83,11 +86,11 @@ type ConnectorBuildContext = {
  * A contributor reaching them would reintroduce the failure the user-level
  * guard exists to prevent.
  */
-type ConnectorEsbuildPatch = Pick<BuildOptions, "jsx" | "jsxImportSource" | "define" | "external" | "loader" | "plugins">;
+export type ConnectorEsbuildPatch = Pick<BuildOptions, "jsx" | "jsxImportSource" | "define" | "external" | "loader" | "plugins">;
 /**
  * What `generate` may hand back to the builder.
  */
-type ConnectorBuildGenerateResult = {
+export type ConnectorBuildGenerateResult = {
   /**
    * Lines appended verbatim to section 4 of the generated entry, AFTER the
    * `./routes` import — page registration must see the routes app code
@@ -95,7 +98,8 @@ type ConnectorBuildGenerateResult = {
    *
    * @example ['await import("./pages");']
    */
-  entryImports?: string[]; /** Merged into the esbuild call: defaults < this patch < user `build` */
+  entryImports?: string[];
+  /** Merged into the esbuild call: defaults < this patch < user `build` */
   esbuild?: ConnectorEsbuildPatch;
 };
 /**
@@ -112,7 +116,7 @@ type ConnectorBuildGenerateResult = {
  * read time by rejecting unknown enumerable keys (`assertClosedContribution`):
  * the type narrows, the runtime asserts.
  */
-type ConnectorBuildContribution = {
+export type ConnectorBuildContribution = {
   /**
    * Write files into `ctx.productionDir` and/or patch the bundle.
    *
@@ -134,7 +138,7 @@ type ConnectorBuildContribution = {
    */
   typings?(context: ConnectorBuildContext): Promise<void> | void;
 };
-type ConnectorName = "logger" | "mailer" | "http" | "database" | "cache" | "storage" | "herald" | "socket" | "notifications" | "access" | "ai" | (string & {});
+export 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).
  *
@@ -144,14 +148,14 @@ type ConnectorName = "logger" | "mailer" | "http" | "database" | "cache" | "stor
  *   things user code registered (http scans the router; socket
  *   depends on http's instance).
  */
-declare enum ConnectorLifecyclePhase {
+export declare enum ConnectorLifecyclePhase {
   Early = "early",
   Late = "late"
 }
 /**
  * Connector priority constants
  */
-declare enum ConnectorPriority {
+export declare enum ConnectorPriority {
   LOGGER = 0,
   MAILER = 1,
   DATABASE = 2,
@@ -165,5 +169,4 @@ declare enum ConnectorPriority {
   AI = 10
 }
 //#endregion
-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":["../../../../../../../../packages/core/src/connectors/types.ts"],"mappings":";;;;;;;AAQA;;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;EAiCuB;;AAAa;AAalD;;EAvCE,aAAA,CAAc,YAAA;EAuCoB;AACtB;AAOd;;;;;;;EARoC,SA5BzB,KAAA,GAAQ,0BAAA;AAAA;AA+DnB;;;;AAAA,KAxDY,qBAAA;EAgEP,uEA9DH,aAAA,UAqEe;EAnEf,OAAA,UA4EkB;EA1ElB,OAAA,EAAS,mBAAA,EA0EwC;EAAA,SAxExC,cAAA,YAA0B,aAAa;AAAA;;;;;;;;;;;KAatC,qBAAA,GAAwB,IAAI,CACtC,YAAA;;;;KAOU,4BAAA;EAsDA;;;;AAAa;AAuBzB;;EArEE,YAAA,aAsEA;EApEA,OAAA,GAAU,qBAAqB;AAAA;;;;;;;;;;;;;;;KAiBrB,0BAAA;EAqER;;;;;EA/DF,QAAA,EACE,OAAA,EAAS,qBAAA,GACR,OAAA,CAAQ,4BAAA,WAAuC,4BAAA;;;;;;EAOlD,IAAA,EAAM,OAAA,EAAS,qBAAA,GAAwB,OAAA;;;;;;;;EASvC,OAAA,EAAS,OAAA,EAAS,qBAAA,GAAwB,OAAA;AAAA;AAAA,KAGhC,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"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/connectors/types.ts"],"mappings":";;;;;;;;iBAQiB;;;;WAIN,MAAM;;;;;WAMN;;;;;WAMA,gBAAgB;;;;EAKzB;;;;;EAMA,eAAe;;;;;EAMf,SAAS;;;;;EAMT,WAAW;;;;;EAMX,YAAY;;;;;;EAOZ,cAAc;;;;;;;;;;WAWL,QAAQ;;;;;;YAOP;;EAEV;;EAEA;;EAEA,SAAS;;WAEA,0BAA0B;;;;;;;;;;;;YAazB,wBAAwB,KAClC;;;;YAOU;;;;;;;;EAQV;;EAEA,UAAU;;;;;;;;;;;;;;;;YAiBA;;;;;;EAMV,UACE,SAAS,wBACR,QAAQ,uCAAuC;;;;;;EAOlD,MAAM,SAAS,wBAAwB;;;;;;;;EASvC,SAAS,SAAS,wBAAwB;;YAGhC;;;;;;;;;;oBAuBA;EACV;EACA;;;;;oBAMU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA"}

package/esm/container/container-instance-registry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"container-instance-registry.mjs","names":[],"sources":["../../../../../../../../packages/core/src/container/container-instance-registry.ts"],"sourcesContent":["/**\n * A single loaded copy of the container module, as seen by\n * {@link registerContainerInstance}.\n */\nexport type ContainerInstanceRecord = {\n  /**\n   * Generated once per module evaluation — never derived from anything a\n   * duplicate evaluation could coincidentally share.\n   */\n  id: string;\n  /**\n   * `import.meta.url` of this evaluation, when the runtime exposes it\n   * cheaply. Omitted rather than guessed when unavailable.\n   */\n  moduleUrl?: string;\n};\n\n/**\n * `globalThis` key the registry is stored under. A `Symbol.for` registry\n * key (not a module-scope variable) is required because the whole point of\n * this file is that it gets evaluated more than once per process — Vite's\n * SSR module runner and Node's ESM loader each hold their own copy of\n * `@warlock.js/core` in the monorepo dev path, and `globalThis` is the only\n * object both evaluations actually share.\n */\nconst registryKey = Symbol.for(\"warlock.js/core/container-instance-registry\");\n\ntype GlobalWithContainerRegistry = typeof globalThis & {\n  [registryKey]?: ContainerInstanceRecord[];\n};\n\nfunction getRegistry(): ContainerInstanceRecord[] {\n  const globalWithRegistry = globalThis as GlobalWithContainerRegistry;\n\n  if (!globalWithRegistry[registryKey]) {\n    globalWithRegistry[registryKey] = [];\n  }\n\n  return globalWithRegistry[registryKey];\n}\n\n/**\n * Registers this module evaluation as a live container instance.\n *\n * Called once at module load, and only ever appends — it never reads back\n * what it just wrote to decide anything, so it cannot itself judge whether\n * a duplicate exists. That judgment happens later, and only on the\n * container's miss/throw path (see `getRegisteredContainerInstanceCount`\n * usage in `index.ts`), specifically so re-evaluation under a test runner's\n * module reset is never mistaken for duplication at load time.\n */\nexport function registerContainerInstance(): void {\n  const record: ContainerInstanceRecord = {\n    id: `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`,\n  };\n\n  if (typeof import.meta !== \"undefined\" && import.meta.url) {\n    record.moduleUrl = import.meta.url;\n  }\n\n  getRegistry().push(record);\n}\n\n/**\n * All container instances registered on this process/runtime so far.\n */\nexport function getRegisteredContainerInstances(): readonly ContainerInstanceRecord[] {\n  return getRegistry();\n}\n\n/**\n * Clears the registry. Test-only: lets a spec simulate a second loaded\n * instance, or reset back to the innocent single-instance case, without\n * actually loading a second copy of the module.\n */\nexport function resetContainerInstanceRegistryForTests(): void {\n  getRegistry().length = 0;\n}\n"],"mappings":";;;;;;;;;AAyBA,MAAM,cAAc,OAAO,IAAI,6CAA6C;AAM5E,SAAS,cAAyC;CAChD,MAAM,qBAAqB;CAE3B,IAAI,CAAC,mBAAmB,cACtB,mBAAmB,eAAe,CAAC;CAGrC,OAAO,mBAAmB;AAC5B;;;;;;;;;;;AAYA,SAAgB,4BAAkC;CAChD,MAAM,SAAkC,EACtC,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IACtE;CAEA,IAAI,OAAO,OAAO,SAAS,eAAe,OAAO,KAAK,KACpD,OAAO,YAAY,OAAO,KAAK;CAGjC,YAAY,CAAC,CAAC,KAAK,MAAM;AAC3B;;;;AAKA,SAAgB,kCAAsE;CACpF,OAAO,YAAY;AACrB"}
+{"version":3,"file":"container-instance-registry.mjs","names":[],"sources":["../../../../../../../../packages/core/src/container/container-instance-registry.ts"],"sourcesContent":["/**\n * A single loaded copy of the container module, as seen by\n * {@link registerContainerInstance}.\n */\nexport type ContainerInstanceRecord = {\n  /**\n   * Generated once per module evaluation — never derived from anything a\n   * duplicate evaluation could coincidentally share.\n   */\n  id: string;\n  /**\n   * `import.meta.url` of this evaluation, when the runtime exposes it\n   * cheaply. Omitted rather than guessed when unavailable.\n   */\n  moduleUrl?: string;\n};\n\n/**\n * `globalThis` key the registry is stored under. A `Symbol.for` registry\n * key (not a module-scope variable) is required because the whole point of\n * this file is that it gets evaluated more than once per process — Vite's\n * SSR module runner and Node's ESM loader each hold their own copy of\n * `@warlock.js/core` in the monorepo dev path, and `globalThis` is the only\n * object both evaluations actually share.\n */\nconst registryKey = Symbol.for(\"warlock.js/core/container-instance-registry\");\n\ntype GlobalWithContainerRegistry = typeof globalThis & {\n  [registryKey]?: ContainerInstanceRecord[];\n};\n\nfunction getRegistry(): ContainerInstanceRecord[] {\n  const globalWithRegistry = globalThis as GlobalWithContainerRegistry;\n\n  if (!globalWithRegistry[registryKey]) {\n    globalWithRegistry[registryKey] = [];\n  }\n\n  return globalWithRegistry[registryKey];\n}\n\n/**\n * Registers this module evaluation as a live container instance.\n *\n * Called once at module load, and only ever appends — it never reads back\n * what it just wrote to decide anything, so it cannot itself judge whether\n * a duplicate exists. That judgment happens later, and only on the\n * container's miss/throw path (see `getRegisteredContainerInstanceCount`\n * usage in `index.ts`), specifically so re-evaluation under a test runner's\n * module reset is never mistaken for duplication at load time.\n */\nexport function registerContainerInstance(): void {\n  const record: ContainerInstanceRecord = {\n    id: `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`,\n  };\n\n  if (typeof import.meta !== \"undefined\" && import.meta.url) {\n    record.moduleUrl = import.meta.url;\n  }\n\n  getRegistry().push(record);\n}\n\n/**\n * All container instances registered on this process/runtime so far.\n */\nexport function getRegisteredContainerInstances(): readonly ContainerInstanceRecord[] {\n  return getRegistry();\n}\n\n/**\n * Clears the registry. Test-only: lets a spec simulate a second loaded\n * instance, or reset back to the innocent single-instance case, without\n * actually loading a second copy of the module.\n */\nexport function resetContainerInstanceRegistryForTests(): void {\n  getRegistry().length = 0;\n}\n"],"mappings":";;;;;;;;;AAyBA,MAAM,cAAc,OAAO,IAAI,6CAA6C;AAM5E,SAAS,cAAyC;CAChD,MAAM,qBAAqB;CAE3B,IAAI,CAAC,mBAAmB,cACtB,mBAAmB,eAAe,CAAC;CAGrC,OAAO,mBAAmB;AAC5B;;;;;;;;;;;AAYA,SAAgB,4BAAkC;CAChD,MAAM,SAAkC,EACtC,IAAI,GAAG,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IACtE;CAEA,IAAI,OAAO,gBAAgB,eAAe,YAAY,KACpD,OAAO,YAAY,YAAY;CAGjC,YAAY,CAAC,CAAC,KAAK,MAAM;AAC3B;;;;AAKA,SAAgB,kCAAsE;CACpF,OAAO,YAAY;AACrB"}

package/esm/container/development-app-modules.d.mts

@@ -9,8 +9,9 @@
  * contract: it is not a package-root dev-server export and it exposes no module
  * namespace.
  */
-type DevelopmentAppModuleEntry = Readonly<{
-  /** The file's plain `file://` URL (no query), as `ModuleLoader` imports it. */url: string;
+export type DevelopmentAppModuleEntry = Readonly<{
+  /** The file's plain `file://` URL (no query), as `ModuleLoader` imports it. */
+  url: string;
   /**
    * How many times core has bumped this file. It is the SAME counter the loader
    * hook thread keeps (`version-registry.ts`), so `${url}?v=${generation}` is
@@ -22,10 +23,11 @@ type DevelopmentAppModuleEntry = Readonly<{
    */
   generation: number;
 }>;
-type DevelopmentAppModules = {
-  /** `undefined` when the file was never bumped: its generation is 0. */get(absolutePath: string): DevelopmentAppModuleEntry | undefined; /** Called once per bumped file, after the hook thread flushed the bump. */
+export type DevelopmentAppModules = {
+  /** `undefined` when the file was never bumped: its generation is 0. */
+  get(absolutePath: string): DevelopmentAppModuleEntry | undefined;
+  /** Called once per bumped file, after the hook thread flushed the bump. */
   subscribe(listener: (entry: DevelopmentAppModuleEntry) => void): () => void;
 };
 //#endregion
-export { DevelopmentAppModuleEntry, DevelopmentAppModules };
 //# sourceMappingURL=development-app-modules.d.mts.map

package/esm/container/development-app-modules.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"development-app-modules.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/container/development-app-modules.ts"],"mappings":";;AAUA;;;;;;;;AAYY;KAZA,yBAAA,GAA4B,QAAQ;EAef,+EAb/B,GAAA;EAiBqD;;;;;;;;;EAPrD,UAAA;AAAA;AAAA,KAGU,qBAAA;yEAEV,GAAA,CAAI,YAAA,WAAuB,yBAAA;EAE3B,SAAA,CAAU,QAAA,GAAW,KAAA,EAAO,yBAAyB;AAAA"}
+{"version":3,"file":"development-app-modules.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/container/development-app-modules.ts"],"mappings":";;;;;;;;;;;YAUY,4BAA4B;;EAEtC;;;;;;;;;;EAUA;;YAGU;;EAEV,IAAI,uBAAuB;;EAE3B,UAAU,WAAW,OAAO"}

package/esm/container/development-model-modules.d.mts

@@ -6,17 +6,18 @@
  * This is intentionally a container-only internal contract: it is not a
  * package-root dev-server export and it exposes no module namespace.
  */
-type DevelopmentModelModuleState = "ready" | "removed";
-type DevelopmentModelModuleEntry = Readonly<{
-  /** Exact file URL used by ModuleLoader to import the module. */url: string; /** Monotonic for this canonical path, including removal and re-addition. */
+export type DevelopmentModelModuleState = "ready" | "removed";
+export type DevelopmentModelModuleEntry = Readonly<{
+  /** Exact file URL used by ModuleLoader to import the module. */
+  url: string;
+  /** Monotonic for this canonical path, including removal and re-addition. */
   generation: number;
   hasDefault: boolean;
   state: DevelopmentModelModuleState;
 }>;
-type DevelopmentModelModules = {
+export type DevelopmentModelModules = {
   get(absolutePath: string): DevelopmentModelModuleEntry | undefined;
   subscribe(listener: (entry: DevelopmentModelModuleEntry) => void): () => void;
 };
 //#endregion
-export { DevelopmentModelModuleEntry, DevelopmentModelModuleState, DevelopmentModelModules };
 //# sourceMappingURL=development-model-modules.d.mts.map

package/esm/container/development-model-modules.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"development-model-modules.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/container/development-model-modules.ts"],"mappings":";;AAOA;;;;AAAuC;AAEvC;KAFY,2BAAA;AAAA,KAEA,2BAAA,GAA8B,QAAQ;EAAA,gEAEhD,GAAA;EAEA,UAAA;EACA,UAAA;EACA,KAAA,EAAO,2BAAA;AAAA;AAAA,KAGG,uBAAA;EACV,GAAA,CAAI,YAAA,WAAuB,2BAAA;EAC3B,SAAA,CAAU,QAAA,GAAW,KAAA,EAAO,2BAA2B;AAAA"}
+{"version":3,"file":"development-model-modules.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/container/development-model-modules.ts"],"mappings":";;;;;;;;YAOY;YAEA,8BAA8B;;EAExC;;EAEA;EACA;EACA,OAAO;;YAGG;EACV,IAAI,uBAAuB;EAC3B,UAAU,WAAW,OAAO"}

package/esm/container/index.d.mts

@@ -1,15 +1,15 @@
 import { Router } from "../router/router.mjs";
+import "../router/index.mjs";
 import { DevelopmentAppModuleEntry, DevelopmentAppModules } from "./development-app-modules.mjs";
 import { DevelopmentModelModuleEntry, DevelopmentModelModuleState, DevelopmentModelModules } from "./development-model-modules.mjs";
 import { DataSource } from "@warlock.js/cascade";
 import { FastifyInstance } from "fastify";
 import { Server } from "socket.io";
-
 //#region ../../packages/core/src/container/index.d.ts
 /**
  * Known container types for better IDE support
  */
-type ContainerTypes = {
+export type ContainerTypes = {
   router: Router;
   "http.server": FastifyInstance;
   "http.baseUrl": string;
@@ -63,7 +63,7 @@ declare class Container {
    */
   delete(key: string): void;
 }
-declare const container: Container;
+export declare const container: Container;
 //#endregion
-export { ContainerTypes, container };
+export type { DevelopmentAppModuleEntry, DevelopmentAppModules, DevelopmentModelModuleEntry, DevelopmentModelModuleState, DevelopmentModelModules };
 //# sourceMappingURL=index.d.mts.map

package/esm/container/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/container/index.ts"],"mappings":";;;;;;;;;AA0BA;;KAAY,cAAA;EACV,MAAA,EAAQ,MAAA;EACR,aAAA,EAAe,eAAA;EACf,cAAA;EACA,MAAA,EAAQ,MAAA;EACR,iBAAA,EAAmB,UAAA;EACnB,0BAAA,EAA4B,uBAAA;EAC5B,wBAAA,EAA0B,qBAAA;AAAA;AAAA,KAGvB,aAAA,SAAsB,cAAc;AAAA,cAEnC,SAAA;EAVJ;;;EAcO,GAAA,iBAAoB,cAAA,EAAgB,GAAA,EAAK,CAAA,EAAG,KAAA,EAAO,cAAA,CAAe,CAAA;EAClE,GAAA,UAAa,GAAA,UAAa,KAAA,EAAO,CAAA;EAZxC;;;;;;;AAE+C;AAC/C;;;EAyBO,GAAA,iBAAoB,cAAA,EAAgB,GAAA,EAAK,CAAA,GAAI,cAAA,CAAe,CAAA;EAC5D,GAAA,UAAa,GAAA,WAAc,CAAA;EAtB9B;;;EAmCG,GAAA,CAAI,GAAA,EAAK,aAAA;EA/BgC;;;;;;;;;EA4CzC,MAAA,iBAAuB,cAAA,EAAgB,GAAA,EAAK,CAAA,GAAI,cAAA,CAAe,CAAA;EAC/D,MAAA,UAAgB,GAAA,WAAc,CAAA;EADc;;;EAS5C,SAAA,iBAA0B,cAAA,EAAgB,GAAA,EAAK,CAAA,GAAI,cAAA,CAAe,CAAA;EAClE,SAAA,UAAmB,GAAA,WAAc,CAAA;EADc;;;EAS/C,MAAA,CAAO,GAAA;AAAA;AAAA,cAKH,SAAA,EAAS,SAAkB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/container/index.ts"],"mappings":";;;;;;;;;;;YA0BY;EACV,QAAQ;EACR,eAAe;EACf;EACA,QAAQ;EACR,mBAAmB;EACnB,4BAA4B;EAC5B,0BAA0B;;KAGvB,sBAAsB;cAErB;;;;EAIG,IAAI,gBAAgB,gBAAgB,KAAK,GAAG,OAAO,eAAe;EAClE,IAAI,SAAS,aAAa,OAAO;;;;;;;;;;;;EAgBjC,IAAI,gBAAgB,gBAAgB,KAAK,IAAI,eAAe;EAC5D,IAAI,SAAS,cAAc;;;;EAa3B,IAAI,KAAK;;;;;;;;;;EAaT,OAAO,gBAAgB,gBAAgB,KAAK,IAAI,eAAe;EAC/D,OAAO,SAAS,cAAc;;;;EAQ9B,UAAU,gBAAgB,gBAAgB,KAAK,IAAI,eAAe;EAClE,UAAU,SAAS,cAAc;;;;EAQjC,OAAO;;qBAKH,WAAS"}

package/esm/database/index.d.mts

@@ -1,5 +1,7 @@
 import { DatabaseLogModel } from "./models/database-log/database-log.mjs";
+import "./models/database-log/index.mjs";
 import { SeedClock, SeedContext, SeedRecordRef, SeedResult, SeederMetadata, Track, TrackableModel } from "./seeds/types.mjs";
 import { Seeder, seeder } from "./seeds/seeder.mjs";
 import { SeederDependencyCycleError, UnknownSeederDependencyError } from "./seeds/seeder.errors.mjs";
-import { useComputedModel, useComputedSlug, useHashedPassword } from "./utils.mjs";
+import { useComputedModel, useComputedSlug, useHashedPassword } from "./utils.mjs";
+export { DatabaseLogModel, SeedClock, SeedContext, SeedRecordRef, SeedResult, Seeder, SeederDependencyCycleError, SeederMetadata, Track, TrackableModel, UnknownSeederDependencyError, seeder, useComputedModel, useComputedSlug, useHashedPassword };

package/esm/database/index.mjs

@@ -4,4 +4,4 @@ import { seeder } from "./seeds/seeder.mjs";
 import { SeederDependencyCycleError, UnknownSeederDependencyError } from "./seeds/seeder.errors.mjs";
 import { useComputedModel, useComputedSlug, useHashedPassword } from "./utils.mjs";
 
-export {  };
+export { DatabaseLogModel, SeederDependencyCycleError, UnknownSeederDependencyError, seeder, useComputedModel, useComputedSlug, useHashedPassword };

package/esm/database/migrate-action.mjs

@@ -148,5 +148,5 @@ async function loadAllMigrations() {
 }
 
 //#endregion
-export { migrateAction };
+export { loadAllMigrations, loadMigrationFile, migrateAction };
 //# sourceMappingURL=migrate-action.mjs.map

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

@@ -1,6 +1,5 @@
 import { Infer } from "@warlock.js/seal";
 import { Model } from "@warlock.js/cascade";
-
 //#region ../../packages/core/src/database/models/database-log/database-log.d.ts
 declare const schema: import("@warlock.js/seal").ObjectValidator<{
   module: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
@@ -13,7 +12,7 @@ declare const schema: import("@warlock.js/seal").ObjectValidator<{
   date: import("@warlock.js/seal").StringValidator & import("@warlock.js/seal").StandardSchemaV1<string, string>;
 }>;
 type LogSchema = Infer.Output<typeof schema>;
-declare class DatabaseLogModel extends Model<LogSchema> {
+export declare class DatabaseLogModel extends Model<LogSchema> {
   /**
    * Table name
    */
@@ -50,5 +49,5 @@ declare class DatabaseLogModel extends Model<LogSchema> {
   get(field: string, defaultValue?: any): any;
 }
 //#endregion
-export { DatabaseLogModel };
+export {};
 //# sourceMappingURL=database-log.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"database-log.d.mts","names":[],"sources":["../../../../../../../../../../packages/core/src/database/models/database-log/database-log.ts"],"mappings":";;;;cAGM,MAAA,6BAAM,eAAA;;;;;;;;;;KASP,SAAA,GAAY,KAAA,CAAM,MAAM,QAAQ,MAAA;AAAA,cAExB,gBAAA,SAAyB,KAAK,CAAC,SAAA;;;;SAI5B,KAAA;;;;SAKA,MAAA,6BAAM,eAAA;;;;;;;;;;EAXR;;;;EAAA,wBAiBY,YAAA;EAjBW;;AAAM;EAAN,IAyBxB,OAAA;EAvBiB;;;EAAA,IA8BjB,KAAA;EA9B+B;;;EAqCnC,GAAA,CAAI,KAAA,UAAe,YAAA;AAAA"}
+{"version":3,"file":"database-log.d.mts","names":[],"sources":["../../../../../../../../../../packages/core/src/database/models/database-log/database-log.ts"],"mappings":";;;cAGM,mCAAM;;;;;;;;;;KASP,YAAY,MAAM,cAAc;qBAExB,yBAAyB,MAAM;;;;SAI5B;;;;SAKA,mCAAM;;;;;;;;;;;;;;0BAMI;;;;MAQb;;;;MAOA;;;;EAOJ,IAAI,eAAe"}

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

@@ -1 +1,2 @@
-import { DatabaseLogModel } from "./database-log.mjs";
+import { DatabaseLogModel } from "./database-log.mjs";
+export { DatabaseLogModel };

package/esm/database/models/database-log/index.mjs

@@ -1,3 +1,3 @@
 import { DatabaseLogModel } from "./database-log.mjs";
 
-export {  };
+export { DatabaseLogModel };

package/esm/database/seed-command-action.mjs

@@ -119,5 +119,5 @@ async function loadSeedFile(absPath) {
 }
 
 //#endregion
-export { seedCommandAction };
+export { clearAllTables, dropSeedRecords, seedCommandAction };
 //# sourceMappingURL=seed-command-action.mjs.map

package/esm/database/seeds/seeder.d.mts

@@ -1,7 +1,6 @@
 import { SeedContext, SeedResult } from "./types.mjs";
-
 //#region ../../packages/core/src/database/seeds/seeder.d.ts
-type Seeder = {
+export type Seeder = {
   /**
    * Seed name
    */
@@ -55,7 +54,6 @@ type Seeder = {
 /**
  * Create a new seeder
  */
-declare function seeder(seeder: Seeder): Seeder;
+export declare function seeder(seeder: Seeder): Seeder;
 //#endregion
-export { Seeder, seeder };
 //# sourceMappingURL=seeder.d.mts.map

package/esm/database/seeds/seeder.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"seeder.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/database/seeds/seeder.ts"],"mappings":";;;KAEY,MAAA;;AAAZ;;EAIE,IAAA;EA6CS;;;EAzCT,OAAA;EAyC8B;;;EArC9B,WAAA;EAIA;;;EAAA,SAAA;EAiCA;;;EA7BA,IAAA;EA6B+B;;AAAU;EAzBzC,KAAA;EA+BoB;;;;;;;EAvBpB,SAAA;;;;;;;;;;;;;;;;;EAiBA,GAAA,CAAI,GAAA,EAAK,WAAA,GAAc,OAAA,CAAQ,UAAA;AAAA;;;;iBAMjB,MAAA,CAAO,MAAA,EAAQ,MAAA,GAAM,MAAA"}
+{"version":3,"file":"seeder.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/database/seeds/seeder.ts"],"mappings":";;YAEY;;;;EAIV;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;EAIA;;;;;;;;EAQA;;;;;;;;;;;;;;;;;EAiBA,IAAI,KAAK,cAAc,QAAQ;;;;;wBAMjB,OAAO,QAAQ,SAAM"}

package/esm/database/seeds/seeder.errors.d.mts

@@ -4,7 +4,7 @@
  * registered with the manager. Surfaces the offending dependent + the missing
  * dependency so the misconfiguration is obvious without spelunking.
  */
-declare class UnknownSeederDependencyError extends Error {
+export declare class UnknownSeederDependencyError extends Error {
   readonly seeder: string;
   readonly dependency: string;
   /** Stable Warlock error code; `warlock explain WL6001` prints the fix. */
@@ -15,12 +15,11 @@ declare class UnknownSeederDependencyError extends Error {
  * Thrown when the `dependsOn` graph contains a cycle, which would make a
  * deterministic run order impossible. Carries the cycle path for diagnosis.
  */
-declare class SeederDependencyCycleError extends Error {
+export declare class SeederDependencyCycleError extends Error {
   readonly cycle: string[];
   /** Stable Warlock error code; `warlock explain WL6002` prints the fix. */
   readonly code = "WL6002";
   constructor(cycle: string[]);
 }
 //#endregion
-export { SeederDependencyCycleError, UnknownSeederDependencyError };
 //# sourceMappingURL=seeder.errors.d.mts.map

package/esm/database/seeds/seeder.errors.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"seeder.errors.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/database/seeds/seeder.errors.ts"],"mappings":";;AAKA;;;;cAAa,4BAAA,SAAqC,KAAK;EAAA,SAKnC,MAAA;EAAA,SACA,UAAA;EAJF;EAAA,SAAA,IAAA;cAGE,MAAA,UACA,UAAA;AAAA;;AAAkB;AAatC;;cAAa,0BAAA,SAAmC,KAAK;EAAA,SAIhB,KAAA;EAJW;EAAA,SAE9B,IAAA;cAEmB,KAAA;AAAA"}
+{"version":3,"file":"seeder.errors.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/database/seeds/seeder.errors.ts"],"mappings":";;;;;;qBAKa,qCAAqC;WAK9B;WACA;;WAJF;EAEhB,YACkB,gBACA;;;;;;qBAaP,mCAAmC;WAIX;;WAFnB;EAEhB,YAAmC"}

package/esm/database/seeds/seeders.manager.mjs

@@ -148,7 +148,8 @@ var SeedersManager = class {
 			if (status === "visited") return;
 			if (status === "visiting") {
 				const cycleStart = path.indexOf(seeder.name);
-				throw new SeederDependencyCycleError(path.slice(cycleStart >= 0 ? cycleStart : 0).concat(seeder.name));
+				const cycle = path.slice(cycleStart >= 0 ? cycleStart : 0).concat(seeder.name);
+				throw new SeederDependencyCycleError(cycle);
 			}
 			state.set(seeder.name, "visiting");
 			for (const dependency of seeder.dependsOn ?? []) visit(byName.get(dependency), [...path, seeder.name]);

package/esm/database/seeds/seeders.manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"seeders.manager.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/database/seeds/seeders.manager.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport {\n  type DataSource,\n  type DriverContract,\n  DatabaseWriterValidationError,\n  dataSourceRegistry,\n  migrationRunner,\n  transaction,\n} from \"@warlock.js/cascade\";\nimport type { Seeder } from \"./seeder\";\nimport { SeederDependencyCycleError, UnknownSeederDependencyError } from \"./seeder.errors\";\nimport { SeedRecordsTableMigration } from \"./seed-records-table-migration\";\nimport { SeedsTableMigration } from \"./seeds-table-migration\";\nimport type {\n  SeedClock,\n  SeederMetadata,\n  SeedRecordRef,\n  SeedResult,\n  Track,\n  TrackableModel,\n} from \"./types\";\nimport { seedRecordsTableName, seedsTableName } from \"./utils\";\n\nexport type SeedersManagerOptions = {\n  datasource?: DataSource;\n  /**\n   * Clock the manager reads for the `now` it hands each seeder AND for its own\n   * metadata timestamps (`createdAt` / `firstRunAt` / `lastRunAt` / a tracked\n   * ref's `runAt`). Defaults to `() => new Date()`. Override it to make a\n   * historical back-fill or a test deterministic — every timestamp a run\n   * produces then comes from this one clock.\n   */\n  clock?: SeedClock;\n};\n\nexport class SeedersManager {\n  public seeders: Seeder[] = [];\n\n  // Not optional: the constructor assigns unconditionally, falling back to\n  // dataSourceRegistry.get(), which itself returns a DataSource rather than\n  // undefined. The `?` here described the OPTIONS field, not this one, and made\n  // every read of `this.datasource.driver` a type error. The options field stays\n  // optional, because that input genuinely is.\n  protected datasource: DataSource;\n\n  /**\n   * The single clock every timestamp in a run reads from. Defaults to\n   * `() => new Date()`; overridable via {@link SeedersManagerOptions.clock}.\n   */\n  protected readonly now: SeedClock;\n\n  public constructor(protected options?: SeedersManagerOptions) {\n    this.datasource = options?.datasource ?? dataSourceRegistry.get();\n    this.now = options?.clock ?? (() => new Date());\n  }\n\n  /**\n   * Register new seeder\n   */\n  public register(...seeders: Seeder[]) {\n    this.seeders.push(...seeders);\n    return this;\n  }\n\n  /**\n   * Initialize before running\n   */\n  protected async init() {\n    if (!(await this.driver.blueprint.tableExists(seedsTableName))) {\n      await migrationRunner.run(SeedsTableMigration);\n    }\n\n    if (!(await this.driver.blueprint.tableExists(seedRecordsTableName))) {\n      await migrationRunner.run(SeedRecordsTableMigration);\n    }\n  }\n\n  /**\n   * Run seeders\n   */\n  public async run(withTransaction = true) {\n    await this.init();\n\n    this.prepareSeeders();\n\n    console.log(`🌱 Running ${this.seeders.length} seeder(s)...\\n`);\n\n    let successCount = 0;\n    let skippedCount = 0;\n    let failedCount = 0;\n\n    for (const seeder of this.seeders) {\n      // Check if already executed\n      if (seeder.once && (await this.seederIsExecutedBefore(seeder))) {\n        console.log(`⏭️  Skipping ${colors.yellow(seeder.name)} (already executed)`);\n        skippedCount++;\n        continue;\n      }\n\n      try {\n        console.log(`🔄 Running ${colors.green(seeder.name)}...`);\n        const startTime = Date.now();\n\n        const refs: SeedRecordRef[] = [];\n        const track = this.createTracker(seeder, refs);\n\n        const runSeeder = async () => {\n          // Keep LAST-RUN refs only: drop the prior refs for this seeder before\n          // writing the new ones, so `--drop` undo stays bounded.\n          await this.driver.deleteMany(seedRecordsTableName, { seeder: seeder.name });\n\n          const result = await seeder.run({\n            track,\n            now: this.now,\n            batchSize: seeder.batchSize ?? 0,\n          });\n\n          if (refs.length > 0) {\n            await this.driver.insertMany(\n              seedRecordsTableName,\n              refs.map((ref) => ({ ...ref })),\n            );\n          }\n\n          return result;\n        };\n\n        const result = withTransaction ? await transaction(runSeeder) : await runSeeder();\n\n        const duration = Date.now() - startTime;\n\n        // Auto-derive recordsCreated from the track count; a returned\n        // SeedResult is an optional fallback when nothing was tracked.\n        const recordsCreated = refs.length > 0 ? refs.length : (result?.recordsCreated ?? 0);\n\n        await this.storeSeedsResults(seeder, { recordsCreated });\n\n        console.log(\n          `✅ ${colors.green(seeder.name)} completed (${duration}ms, ${recordsCreated} records)\\n`,\n        );\n        successCount++;\n      } catch (error: any) {\n        const err = error as Error;\n        console.error(`❌ ${colors.red(seeder.name)} failed:`, err.message);\n        console.log(err);\n        failedCount++;\n\n        if (error instanceof DatabaseWriterValidationError) {\n          console.log(error.errors);\n        }\n\n        // Re-throw to stop execution (or continue to next seed based on your preference)\n        throw error;\n      }\n    }\n\n    // Summary\n    console.log(\"\\n\" + \"=\".repeat(50));\n    console.log(`✅ Success: ${successCount}`);\n\n    if (skippedCount > 0) console.log(`⏭️  Skipped: ${skippedCount}`);\n\n    if (failedCount > 0) console.log(`❌ Failed: ${failedCount}`);\n\n    console.log(\"=\".repeat(50));\n  }\n\n  /**\n   * Build a `track` helper bound to the given seeder. Tracked refs are pushed\n   * into `refs` and persisted (within the run transaction) by the caller.\n   *\n   * Every overload returns its first argument so it can be chained inline.\n   */\n  protected createTracker(seeder: Seeder, refs: SeedRecordRef[]): Track {\n    const push = (table: string, recordId: number | string) => {\n      refs.push({ seeder: seeder.name, table, recordId, runAt: this.now() });\n    };\n\n    function track<T extends TrackableModel>(model: T): T;\n    function track<T extends TrackableModel>(models: T[]): T[];\n    function track(table: string, id: number | string): string;\n    function track(\n      arg: TrackableModel | TrackableModel[] | string,\n      id?: number | string,\n    ): TrackableModel | TrackableModel[] | string {\n      if (typeof arg === \"string\") {\n        push(arg, id as number | string);\n\n        return arg;\n      }\n\n      if (Array.isArray(arg)) {\n        for (const model of arg) {\n          push(model.getTableName(), model.id);\n        }\n\n        return arg;\n      }\n\n      push(arg.getTableName(), arg.id);\n\n      return arg;\n    }\n\n    return track;\n  }\n\n  /**\n   * Sort seeds\n   */\n  public sort() {\n    this.seeders = this.seeders.sort((a, b) => {\n      const orderA = a.order ?? Number.MAX_SAFE_INTEGER;\n      const orderB = b.order ?? Number.MAX_SAFE_INTEGER;\n      return orderA - orderB;\n    });\n\n    return this;\n  }\n\n  /**\n   * Prepare seeders to order by the seeder order, then resolve `dependsOn`.\n   *\n   * Dependencies are honored via a topological sort layered over the existing\n   * numeric `order` tie-break: among seeders whose dependencies are already\n   * satisfied, the lowest `order` (then registration order) runs first. Throws\n   * {@link UnknownSeederDependencyError} for a missing dependency and\n   * {@link SeederDependencyCycleError} for a cycle.\n   */\n  public prepareSeeders() {\n    this.seeders = this.seeders.filter((seeder) => seeder.enabled !== false);\n\n    this.sort();\n\n    this.seeders = this.resolveDependencies(this.seeders);\n\n    return this;\n  }\n\n  /**\n   * Topologically sort `seeders` by their `dependsOn` names. The input is\n   * assumed pre-sorted by `order` (see {@link sort}); that ordering is used as\n   * the tie-break so dependency-free siblings keep their `order` sequence.\n   */\n  protected resolveDependencies(seeders: Seeder[]): Seeder[] {\n    const byName = new Map<string, Seeder>();\n\n    for (const seeder of seeders) {\n      byName.set(seeder.name, seeder);\n    }\n\n    // Validate dependencies up-front so an unknown name is a clear error rather\n    // than a silently dropped edge.\n    for (const seeder of seeders) {\n      for (const dependency of seeder.dependsOn ?? []) {\n        if (!byName.has(dependency)) {\n          throw new UnknownSeederDependencyError(seeder.name, dependency);\n        }\n      }\n    }\n\n    const sorted: Seeder[] = [];\n    const state = new Map<string, \"visiting\" | \"visited\">();\n\n    const visit = (seeder: Seeder, path: string[]) => {\n      const status = state.get(seeder.name);\n\n      if (status === \"visited\") {\n        return;\n      }\n\n      if (status === \"visiting\") {\n        const cycleStart = path.indexOf(seeder.name);\n        const cycle = path.slice(cycleStart >= 0 ? cycleStart : 0).concat(seeder.name);\n\n        throw new SeederDependencyCycleError(cycle);\n      }\n\n      state.set(seeder.name, \"visiting\");\n\n      for (const dependency of seeder.dependsOn ?? []) {\n        // Presence already validated above; the `!` is safe.\n        visit(byName.get(dependency)!, [...path, seeder.name]);\n      }\n\n      state.set(seeder.name, \"visited\");\n      sorted.push(seeder);\n    };\n\n    // Iterate in the incoming (order-sorted, registration-stable) sequence so\n    // dependency-free seeders preserve their `order` tie-break.\n    for (const seeder of seeders) {\n      visit(seeder, []);\n    }\n\n    return sorted;\n  }\n\n  /**\n   * Store seed results in db\n   */\n  public async storeSeedsResults(seeder: Seeder, result: SeedResult) {\n    const oldResult = await this.getMetadata(seeder);\n\n    // log with an emoji icon at beginning of text no of total craeted records\n    console.log(`📊 Total records created: ${result.recordsCreated}`);\n\n    // Read the single overridable clock once so every timestamp in this write\n    // is identical (and pinned in a deterministic / historical run).\n    const now = this.now();\n\n    if (oldResult) {\n      // Update existing record - use query builder with WHERE clause\n      await this.driver\n        .queryBuilder(seedsTableName)\n        .where(\"name\", seeder.name)\n        .update({\n          runCount: oldResult.runCount + 1,\n          lastRunAt: now,\n          totalRecordsCreated: oldResult.totalRecordsCreated + result.recordsCreated,\n          lastRunRecordsCreated: result.recordsCreated,\n        });\n\n      // now display total created records so far\n      console.log(\n        `📊 Total records created so far: ${oldResult.totalRecordsCreated + result.recordsCreated}`,\n      );\n    } else {\n      // Insert new record\n      await this.driver.insert(seedsTableName, {\n        name: seeder.name,\n        createdAt: now,\n        firstRunAt: now,\n        lastRunAt: now,\n        runCount: 1,\n        totalRecordsCreated: result.recordsCreated,\n        lastRunRecordsCreated: result.recordsCreated,\n      });\n    }\n  }\n\n  /**\n   * Get seed info from database\n   */\n  // Returns null when the seeder has never run. first() has always resolved to\n  // SeederMetadata | null; annotating it as non-null pushed that lie to every\n  // caller, each of which already branches on the absent case.\n  protected getMetadata(seeder: Seeder): Promise<SeederMetadata | null> {\n    const driver = this.datasource.driver;\n\n    return driver.queryBuilder(seedsTableName).where(\"name\", seeder.name).first();\n  }\n\n  /**\n   * Get driver instance\n   */\n  protected get driver(): DriverContract {\n    return this.datasource.driver;\n  }\n\n  /**\n   * Check if seeder has been executed before\n   */\n  protected async seederIsExecutedBefore(seeder: Seeder) {\n    return !!(await this.getMetadata(seeder));\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"seeders.manager.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/database/seeds/seeders.manager.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport {\n  type DataSource,\n  type DriverContract,\n  DatabaseWriterValidationError,\n  dataSourceRegistry,\n  migrationRunner,\n  transaction,\n} from \"@warlock.js/cascade\";\nimport type { Seeder } from \"./seeder\";\nimport { SeederDependencyCycleError, UnknownSeederDependencyError } from \"./seeder.errors\";\nimport { SeedRecordsTableMigration } from \"./seed-records-table-migration\";\nimport { SeedsTableMigration } from \"./seeds-table-migration\";\nimport type {\n  SeedClock,\n  SeederMetadata,\n  SeedRecordRef,\n  SeedResult,\n  Track,\n  TrackableModel,\n} from \"./types\";\nimport { seedRecordsTableName, seedsTableName } from \"./utils\";\n\nexport type SeedersManagerOptions = {\n  datasource?: DataSource;\n  /**\n   * Clock the manager reads for the `now` it hands each seeder AND for its own\n   * metadata timestamps (`createdAt` / `firstRunAt` / `lastRunAt` / a tracked\n   * ref's `runAt`). Defaults to `() => new Date()`. Override it to make a\n   * historical back-fill or a test deterministic — every timestamp a run\n   * produces then comes from this one clock.\n   */\n  clock?: SeedClock;\n};\n\nexport class SeedersManager {\n  public seeders: Seeder[] = [];\n\n  // Not optional: the constructor assigns unconditionally, falling back to\n  // dataSourceRegistry.get(), which itself returns a DataSource rather than\n  // undefined. The `?` here described the OPTIONS field, not this one, and made\n  // every read of `this.datasource.driver` a type error. The options field stays\n  // optional, because that input genuinely is.\n  protected datasource: DataSource;\n\n  /**\n   * The single clock every timestamp in a run reads from. Defaults to\n   * `() => new Date()`; overridable via {@link SeedersManagerOptions.clock}.\n   */\n  protected readonly now: SeedClock;\n\n  public constructor(protected options?: SeedersManagerOptions) {\n    this.datasource = options?.datasource ?? dataSourceRegistry.get();\n    this.now = options?.clock ?? (() => new Date());\n  }\n\n  /**\n   * Register new seeder\n   */\n  public register(...seeders: Seeder[]) {\n    this.seeders.push(...seeders);\n    return this;\n  }\n\n  /**\n   * Initialize before running\n   */\n  protected async init() {\n    if (!(await this.driver.blueprint.tableExists(seedsTableName))) {\n      await migrationRunner.run(SeedsTableMigration);\n    }\n\n    if (!(await this.driver.blueprint.tableExists(seedRecordsTableName))) {\n      await migrationRunner.run(SeedRecordsTableMigration);\n    }\n  }\n\n  /**\n   * Run seeders\n   */\n  public async run(withTransaction = true) {\n    await this.init();\n\n    this.prepareSeeders();\n\n    console.log(`🌱 Running ${this.seeders.length} seeder(s)...\\n`);\n\n    let successCount = 0;\n    let skippedCount = 0;\n    let failedCount = 0;\n\n    for (const seeder of this.seeders) {\n      // Check if already executed\n      if (seeder.once && (await this.seederIsExecutedBefore(seeder))) {\n        console.log(`⏭️  Skipping ${colors.yellow(seeder.name)} (already executed)`);\n        skippedCount++;\n        continue;\n      }\n\n      try {\n        console.log(`🔄 Running ${colors.green(seeder.name)}...`);\n        const startTime = Date.now();\n\n        const refs: SeedRecordRef[] = [];\n        const track = this.createTracker(seeder, refs);\n\n        const runSeeder = async () => {\n          // Keep LAST-RUN refs only: drop the prior refs for this seeder before\n          // writing the new ones, so `--drop` undo stays bounded.\n          await this.driver.deleteMany(seedRecordsTableName, { seeder: seeder.name });\n\n          const result = await seeder.run({\n            track,\n            now: this.now,\n            batchSize: seeder.batchSize ?? 0,\n          });\n\n          if (refs.length > 0) {\n            await this.driver.insertMany(\n              seedRecordsTableName,\n              refs.map((ref) => ({ ...ref })),\n            );\n          }\n\n          return result;\n        };\n\n        const result = withTransaction ? await transaction(runSeeder) : await runSeeder();\n\n        const duration = Date.now() - startTime;\n\n        // Auto-derive recordsCreated from the track count; a returned\n        // SeedResult is an optional fallback when nothing was tracked.\n        const recordsCreated = refs.length > 0 ? refs.length : (result?.recordsCreated ?? 0);\n\n        await this.storeSeedsResults(seeder, { recordsCreated });\n\n        console.log(\n          `✅ ${colors.green(seeder.name)} completed (${duration}ms, ${recordsCreated} records)\\n`,\n        );\n        successCount++;\n      } catch (error: any) {\n        const err = error as Error;\n        console.error(`❌ ${colors.red(seeder.name)} failed:`, err.message);\n        console.log(err);\n        failedCount++;\n\n        if (error instanceof DatabaseWriterValidationError) {\n          console.log(error.errors);\n        }\n\n        // Re-throw to stop execution (or continue to next seed based on your preference)\n        throw error;\n      }\n    }\n\n    // Summary\n    console.log(\"\\n\" + \"=\".repeat(50));\n    console.log(`✅ Success: ${successCount}`);\n\n    if (skippedCount > 0) console.log(`⏭️  Skipped: ${skippedCount}`);\n\n    if (failedCount > 0) console.log(`❌ Failed: ${failedCount}`);\n\n    console.log(\"=\".repeat(50));\n  }\n\n  /**\n   * Build a `track` helper bound to the given seeder. Tracked refs are pushed\n   * into `refs` and persisted (within the run transaction) by the caller.\n   *\n   * Every overload returns its first argument so it can be chained inline.\n   */\n  protected createTracker(seeder: Seeder, refs: SeedRecordRef[]): Track {\n    const push = (table: string, recordId: number | string) => {\n      refs.push({ seeder: seeder.name, table, recordId, runAt: this.now() });\n    };\n\n    function track<T extends TrackableModel>(model: T): T;\n    function track<T extends TrackableModel>(models: T[]): T[];\n    function track(table: string, id: number | string): string;\n    function track(\n      arg: TrackableModel | TrackableModel[] | string,\n      id?: number | string,\n    ): TrackableModel | TrackableModel[] | string {\n      if (typeof arg === \"string\") {\n        push(arg, id as number | string);\n\n        return arg;\n      }\n\n      if (Array.isArray(arg)) {\n        for (const model of arg) {\n          push(model.getTableName(), model.id);\n        }\n\n        return arg;\n      }\n\n      push(arg.getTableName(), arg.id);\n\n      return arg;\n    }\n\n    return track;\n  }\n\n  /**\n   * Sort seeds\n   */\n  public sort() {\n    this.seeders = this.seeders.sort((a, b) => {\n      const orderA = a.order ?? Number.MAX_SAFE_INTEGER;\n      const orderB = b.order ?? Number.MAX_SAFE_INTEGER;\n      return orderA - orderB;\n    });\n\n    return this;\n  }\n\n  /**\n   * Prepare seeders to order by the seeder order, then resolve `dependsOn`.\n   *\n   * Dependencies are honored via a topological sort layered over the existing\n   * numeric `order` tie-break: among seeders whose dependencies are already\n   * satisfied, the lowest `order` (then registration order) runs first. Throws\n   * {@link UnknownSeederDependencyError} for a missing dependency and\n   * {@link SeederDependencyCycleError} for a cycle.\n   */\n  public prepareSeeders() {\n    this.seeders = this.seeders.filter((seeder) => seeder.enabled !== false);\n\n    this.sort();\n\n    this.seeders = this.resolveDependencies(this.seeders);\n\n    return this;\n  }\n\n  /**\n   * Topologically sort `seeders` by their `dependsOn` names. The input is\n   * assumed pre-sorted by `order` (see {@link sort}); that ordering is used as\n   * the tie-break so dependency-free siblings keep their `order` sequence.\n   */\n  protected resolveDependencies(seeders: Seeder[]): Seeder[] {\n    const byName = new Map<string, Seeder>();\n\n    for (const seeder of seeders) {\n      byName.set(seeder.name, seeder);\n    }\n\n    // Validate dependencies up-front so an unknown name is a clear error rather\n    // than a silently dropped edge.\n    for (const seeder of seeders) {\n      for (const dependency of seeder.dependsOn ?? []) {\n        if (!byName.has(dependency)) {\n          throw new UnknownSeederDependencyError(seeder.name, dependency);\n        }\n      }\n    }\n\n    const sorted: Seeder[] = [];\n    const state = new Map<string, \"visiting\" | \"visited\">();\n\n    const visit = (seeder: Seeder, path: string[]) => {\n      const status = state.get(seeder.name);\n\n      if (status === \"visited\") {\n        return;\n      }\n\n      if (status === \"visiting\") {\n        const cycleStart = path.indexOf(seeder.name);\n        const cycle = path.slice(cycleStart >= 0 ? cycleStart : 0).concat(seeder.name);\n\n        throw new SeederDependencyCycleError(cycle);\n      }\n\n      state.set(seeder.name, \"visiting\");\n\n      for (const dependency of seeder.dependsOn ?? []) {\n        // Presence already validated above; the `!` is safe.\n        visit(byName.get(dependency)!, [...path, seeder.name]);\n      }\n\n      state.set(seeder.name, \"visited\");\n      sorted.push(seeder);\n    };\n\n    // Iterate in the incoming (order-sorted, registration-stable) sequence so\n    // dependency-free seeders preserve their `order` tie-break.\n    for (const seeder of seeders) {\n      visit(seeder, []);\n    }\n\n    return sorted;\n  }\n\n  /**\n   * Store seed results in db\n   */\n  public async storeSeedsResults(seeder: Seeder, result: SeedResult) {\n    const oldResult = await this.getMetadata(seeder);\n\n    // log with an emoji icon at beginning of text no of total craeted records\n    console.log(`📊 Total records created: ${result.recordsCreated}`);\n\n    // Read the single overridable clock once so every timestamp in this write\n    // is identical (and pinned in a deterministic / historical run).\n    const now = this.now();\n\n    if (oldResult) {\n      // Update existing record - use query builder with WHERE clause\n      await this.driver\n        .queryBuilder(seedsTableName)\n        .where(\"name\", seeder.name)\n        .update({\n          runCount: oldResult.runCount + 1,\n          lastRunAt: now,\n          totalRecordsCreated: oldResult.totalRecordsCreated + result.recordsCreated,\n          lastRunRecordsCreated: result.recordsCreated,\n        });\n\n      // now display total created records so far\n      console.log(\n        `📊 Total records created so far: ${oldResult.totalRecordsCreated + result.recordsCreated}`,\n      );\n    } else {\n      // Insert new record\n      await this.driver.insert(seedsTableName, {\n        name: seeder.name,\n        createdAt: now,\n        firstRunAt: now,\n        lastRunAt: now,\n        runCount: 1,\n        totalRecordsCreated: result.recordsCreated,\n        lastRunRecordsCreated: result.recordsCreated,\n      });\n    }\n  }\n\n  /**\n   * Get seed info from database\n   */\n  // Returns null when the seeder has never run. first() has always resolved to\n  // SeederMetadata | null; annotating it as non-null pushed that lie to every\n  // caller, each of which already branches on the absent case.\n  protected getMetadata(seeder: Seeder): Promise<SeederMetadata | null> {\n    const driver = this.datasource.driver;\n\n    return driver.queryBuilder(seedsTableName).where(\"name\", seeder.name).first();\n  }\n\n  /**\n   * Get driver instance\n   */\n  protected get driver(): DriverContract {\n    return this.datasource.driver;\n  }\n\n  /**\n   * Check if seeder has been executed before\n   */\n  protected async seederIsExecutedBefore(seeder: Seeder) {\n    return !!(await this.getMetadata(seeder));\n  }\n}\n"],"mappings":"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"}

package/esm/database/seeds/types.d.mts

@@ -1,8 +1,8 @@
 //#region ../../packages/core/src/database/seeds/types.d.ts
-type SeedResult = {
+export type SeedResult = {
   recordsCreated: number;
 };
-type SeederMetadata = {
+export type SeederMetadata = {
   name: string;
   createdAt: number;
   firstRunAt: number;
@@ -18,7 +18,7 @@ type SeederMetadata = {
  * this structural type keeps `track` decoupled from the concrete `Model`
  * class so seeds can also hand in lightweight test doubles.
  */
-type TrackableModel = {
+export type TrackableModel = {
   /**
    * Owning table / collection name.
    */
@@ -31,7 +31,7 @@ type TrackableModel = {
 /**
  * A single tracked record reference, persisted to the `seed_records` table.
  */
-type SeedRecordRef = {
+export type SeedRecordRef = {
   /**
    * Owning seeder name.
    */
@@ -60,7 +60,7 @@ type SeedRecordRef = {
  * const user = track(await User.create({ ... }));
  * ```
  */
-type Track = {
+export type Track = {
   /**
    * Track a single model. Reads `model.getTableName()` + `model.id`.
    *
@@ -89,11 +89,11 @@ type Track = {
  * manager's own metadata timestamps deterministic — both read from this single
  * clock, so a test or a back-fill can pin every timestamp to one value.
  */
-type SeedClock = () => Date;
+export type SeedClock = () => Date;
 /**
  * Context passed to a seeder's `run()`.
  */
-type SeedContext = {
+export type SeedContext = {
   /**
    * Tracker used to register created records for later undo via
    * `warlock seed --drop`.
@@ -128,5 +128,4 @@ type SeedContext = {
   batchSize: number;
 };
 //#endregion
-export { SeedClock, SeedContext, SeedRecordRef, SeedResult, SeederMetadata, Track, TrackableModel };
 //# sourceMappingURL=types.d.mts.map

package/esm/database/seeds/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/database/seeds/types.ts"],"mappings":";KAAY,UAAA;EACV,cAAc;AAAA;AAAA,KAGJ,cAAA;EACV,IAAA;EACA,SAAA;EACA,UAAA;EACA,SAAA;EACA,QAAA;EACA,mBAAA;EACA,qBAAA;AAAA;;;;;;;AAAqB;KAUX,cAAA;EAAc;;;EAIxB,YAAA;EAUU;;;EANV,EAAE;AAAA;;;;KAMQ,aAAA;EAgBC;AAAA;AAcb;EA1BE,MAAA;EA0Be;;;EAtBf,KAAA;EAkCW;;;EA9BX,QAAA;EA8B0C;;;EA1B1C,KAAA,EAAO,IAAI;AAAA;;;;;;;;;;AAgCwB;AAYrC;KA9BY,KAAA;;;AA8BsB;AAKlC;;aA7Ba,cAAA,EAAgB,KAAA,EAAO,CAAA,GAAI,CAAA;EAgDxB;;;;;EAAA,WA1CH,cAAA,EAAgB,MAAA,EAAQ,CAAA,KAAM,CAAA;EAuDhC;AAAA;;;;EAAA,CAjDR,KAAA,UAAe,EAAA;AAAA;;;;;;;;;;KAYN,SAAA,SAAkB,IAAI;;;;KAKtB,WAAA;;;;;EAKV,KAAA,EAAO,KAAA;;;;;;;;;;;;;;EAcP,GAAA,EAAK,SAAS;;;;;;;;;;;;;EAad,SAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/database/seeds/types.ts"],"mappings":";YAAY;EACV;;YAGU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;;;;;;;;;YAUU;;;;EAIV;;;;EAIA;;;;;YAMU;;;;EAIV;;;;EAIA;;;;EAIA;;;;EAIA,OAAO;;;;;;;;;;;;;YAcG;;;;;;GAMT,UAAU,gBAAgB,OAAO,IAAI;;;;;;GAMrC,UAAU,gBAAgB,QAAQ,MAAM;;;;;;GAMxC,eAAe;;;;;;;;;;;YAYN,kBAAkB;;;;YAKlB;;;;;EAKV,OAAO;;;;;;;;;;;;;;EAcP,KAAK;;;;;;;;;;;;;EAaL"}

package/esm/database/utils.d.mts

@@ -1,6 +1,5 @@
 import { ComputedCallback, SchemaContext } from "@warlock.js/seal";
 import { Model } from "@warlock.js/cascade";
-
 //#region ../../packages/core/src/database/utils.d.ts
 /**
  * Hash password on saving if password changes.
@@ -9,16 +8,16 @@ import { Model } from "@warlock.js/cascade";
  * `encryption.password.salt`). Core must never import `@warlock.js/auth`:
  * auth depends on core, and its `authService.hashPassword` only delegates here.
  */
-declare const useHashedPassword: () => import("@warlock.js/seal").TransformerCallback;
+export 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
  */
-declare function useComputedModel(callback: ComputedCallbackModel): ComputedCallback;
+export declare function useComputedModel(callback: ComputedCallbackModel): ComputedCallback;
 /**
  * Generate slug based on a field on saving
  */
-declare function useComputedSlug(field?: string, scope?: "global" | "sibling"): ComputedCallback;
+export declare function useComputedSlug(field?: string, scope?: "global" | "sibling"): ComputedCallback;
 //#endregion
-export { useComputedModel, useComputedSlug, useHashedPassword };
+export {};
 //# sourceMappingURL=utils.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/database/utils.ts"],"mappings":";;;;;;AAaA;;;;AAOI;cAPS,iBAAA,mCAAiB,mBAO1B;AAAA,KAEC,qBAAA,IACH,IAAA,OACA,KAAA,EAAO,KAAA,EACP,OAAA,EAAS,aAAA,WACA,OAAA;;;;iBAKK,gBAAA,CAAiB,QAAA,EAAU,qBAAA,GAAqB,gBAAA;;;;iBAWhD,eAAA,CAAgB,KAAA,WAAiB,KAAA,0BAAuC,gBAAA"}
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/database/utils.ts"],"mappings":";;;;;;;;;;qBAaa,oDAAiB;KASzB,yBACH,WACA,OAAO,OACP,SAAS,wBACA;;;;wBAKK,iBAAiB,UAAU,wBAAqB;;;;wBAWhD,gBAAgB,gBAAiB,+BAAuC"}

package/esm/dev-server/app-module-registry.mjs

@@ -48,5 +48,5 @@ function getDevelopmentAppModuleRegistry() {
 }
 
 //#endregion
-export { getDevelopmentAppModuleRegistry };
+export { DevelopmentAppModuleRegistry, getDevelopmentAppModuleRegistry };
 //# sourceMappingURL=app-module-registry.mjs.map

package/esm/dev-server/create-worker.mjs

@@ -10,7 +10,7 @@ import { Worker } from "worker_threads";
 *
 * The worker shares the CALLING module's extension: `.ts` when core runs from
 * source (loaded via tsx), `.mjs` when core is published. Source workers are
-* loaded through tsx's `tsImport` API from a JavaScript bootstrap; published
+* loaded after registering tsx in a JavaScript bootstrap; published
 * `.mjs` workers run as-is.
 *
 * @param workerPath - Relative path to worker file WITHOUT extension (e.g., "./workers/ts-health.worker")
@@ -35,8 +35,10 @@ function createWorker(workerPath, baseUrl, options) {
 	const workerFilePath = fileURLToPath$1(workerUrl);
 	const workerOptions = { ...options };
 	if (isSource) {
-		const tsxApi = pathToFileURL(createRequire(import.meta.url).resolve("tsx/esm/api")).href;
-		return new Worker(`import(${JSON.stringify(tsxApi)}).then(({ tsImport }) => tsImport(${JSON.stringify(workerUrl.href)}, ${JSON.stringify(baseUrl)}));`, {
+		const require = createRequire(import.meta.url);
+		const tsxApi = pathToFileURL(require.resolve("tsx/esm/api")).href;
+		const bootstrap = `import(${JSON.stringify(tsxApi)}).then(({ register }) => { register(); return import(${JSON.stringify(workerUrl.href)}); });`;
+		return new Worker(bootstrap, {
 			...workerOptions,
 			eval: true
 		});