@warlock.js/core 5.3.0 → 5.3.2

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

@@ -1 +1 @@
-{"version":3,"file":"seed-command-action.mjs","names":["runInTransaction"],"sources":["../../../../../../../core/src/database/seed-command-action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport {\r\n  DataSource,\r\n  dataSourceRegistry,\r\n  transaction as runInTransaction,\r\n} from \"@warlock.js/cascade\";\r\nimport { CommandActionData } from \"../commands/types\";\r\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\r\nimport { Path } from \"../utils/normalized-path\";\r\nimport { getFilesFromDirectory } from \"../dev-server/utils\";\r\nimport { srcPath } from \"../utils\";\r\nimport { Seeder } from \"./seeds/seeder\";\r\nimport { SeedersManager } from \"./seeds/seeders.manager\";\r\nimport { SeedClock, SeedRecordRef } from \"./seeds/types\";\r\nimport { seedRecordsTableName, seedsTableName } from \"./seeds/utils\";\r\n\r\n/**\r\n * Programmatic-only overrides for {@link seedCommandAction}.\r\n *\r\n * Not derived from CLI flags (the CLI passes only {@link CommandActionData}),\r\n * so a back-fill script or a test can inject behaviour the command line can't\r\n * express.\r\n */\r\nexport type SeedCommandOverrides = {\r\n  /**\r\n   * Clock the run reads for the `now` handed to each seeder and for the\r\n   * seeds-log metadata timestamps. Defaults to `() => new Date()`. Forwarded to\r\n   * {@link SeedersManager}'s `clock` option.\r\n   */\r\n  clock?: SeedClock;\r\n};\r\n\r\nasync function clearAllTables(datasource: DataSource) {\r\n  const tables = await datasource.driver.blueprint.listTables();\r\n\r\n  for (const table of tables) {\r\n    await datasource.driver.truncateTable(table, { cascade: true });\r\n  }\r\n}\r\n\r\ntype SeedRecordRow = SeedRecordRef & { id: number };\r\n\r\n/**\r\n * Undo seeded data by deleting the records a seeder tracked via `track`.\r\n *\r\n * Reads `seed_records` (all seeders, or a single `seederName`), then deletes\r\n * the referenced records in REVERSE seed-order and, within each seed, in\r\n * reverse insertion-order. Insertion id is strictly increasing across the\r\n * whole run, so deleting by descending `id` satisfies both at once. The whole\r\n * operation runs in a single transaction, and the matching seeds-log rows are\r\n * reset afterwards so `once: true` seeds re-run on the next `warlock seed`.\r\n *\r\n * @returns the number of tracked records deleted.\r\n */\r\nexport async function dropSeedRecords(\r\n  datasource: DataSource,\r\n  seederName?: string,\r\n): Promise<number> {\r\n  const driver = datasource.driver;\r\n\r\n  if (!(await driver.blueprint.tableExists(seedRecordsTableName))) {\r\n    return 0;\r\n  }\r\n\r\n  const query = driver.queryBuilder<SeedRecordRow>(seedRecordsTableName);\r\n\r\n  if (seederName) {\r\n    query.where(\"seeder\", seederName);\r\n  }\r\n\r\n  const rows = await query.get();\r\n\r\n  if (rows.length === 0) {\r\n    return 0;\r\n  }\r\n\r\n  // Descending insertion id == reverse seed-order + reverse within-seed order.\r\n  const ordered = [...rows].sort((a, b) => b.id - a.id);\r\n\r\n  await runInTransaction(async () => {\r\n    for (const row of ordered) {\r\n      await driver.deleteMany(row.table, { id: row.recordId });\r\n    }\r\n\r\n    // Clear the tracked refs we just acted on.\r\n    if (seederName) {\r\n      await driver.deleteMany(seedRecordsTableName, { seeder: seederName });\r\n    } else {\r\n      await driver.deleteMany(seedRecordsTableName, {});\r\n    }\r\n\r\n    // Reset the seeds-log rows so `once: true` seeds re-run.\r\n    const seederNames = seederName\r\n      ? [seederName]\r\n      : [...new Set(ordered.map((row) => row.seeder))];\r\n\r\n    for (const name of seederNames) {\r\n      await driver.deleteMany(seedsTableName, { name });\r\n    }\r\n  });\r\n\r\n  return ordered.length;\r\n}\r\n\r\n/**\r\n * Run database seeds.\r\n *\r\n * @example\r\n * ```ts\r\n * import { seedCommandAction } from \"@warlock.js/core\";\r\n *\r\n * await seedCommandAction({\r\n *   command: \"seed\",\r\n *   options: { fresh: true, list: false }\r\n * });\r\n * ```\r\n *\r\n * @param overrides Programmatic-only overrides (e.g. an injected `clock`); the\r\n * CLI never passes this, so the command-line signature stays unchanged.\r\n */\r\nexport async function seedCommandAction(\r\n  options: CommandActionData,\r\n  overrides?: SeedCommandOverrides,\r\n) {\r\n  const { path, fresh, transaction, list, drop } = options.options;\r\n\r\n  const datasource = dataSourceRegistry.get();\r\n\r\n  if (drop) {\r\n    // `--drop` (boolean) undoes every tracked record; `--drop=<name>` scopes to\r\n    // a single seeder.\r\n    const seederName = typeof drop === \"string\" ? drop : undefined;\r\n\r\n    const deleted = await dropSeedRecords(datasource, seederName);\r\n\r\n    const scope = seederName ? colors.cyan(seederName) : \"all seeders\";\r\n    console.log(\r\n      `🗑️  Dropped ${colors.redBright(deleted)} tracked record(s) for ${scope}; matching seeds-log entries reset.`,\r\n    );\r\n    return;\r\n  }\r\n\r\n  if (fresh) {\r\n    await clearAllTables(datasource);\r\n  }\r\n\r\n  if (list) {\r\n    const seedFiles = await listSeedsFiles();\r\n\r\n    if (seedFiles.length === 0) {\r\n      console.log(\"No seeds found.\");\r\n      return;\r\n    }\r\n\r\n    const seedersManager = new SeedersManager();\r\n\r\n    seedersManager.register(...seedFiles);\r\n\r\n    const seeds = seedersManager.sort().seeders.map((seed) => {\r\n      return {\r\n        name: seed.name,\r\n        order: seed.order,\r\n        enabled: seed.enabled,\r\n      };\r\n    });\r\n\r\n    console.table(seeds);\r\n\r\n    console.log(\r\n      `Total Seeds: ${colors.blueBright(seeds.length)}, enabled: ${colors.greenBright(seeds.filter((seed) => seed.enabled !== false).length)}, disabled: ${colors.redBright(seeds.filter((seed) => seed.enabled === false).length)}`,\r\n    );\r\n    return;\r\n  }\r\n\r\n  const seeds = path\r\n    ? [await loadSeedFile(Path.toAbsolute(path as string))]\r\n    : await listSeedsFiles();\r\n\r\n  const seedersManager = new SeedersManager({ clock: overrides?.clock });\r\n\r\n  seedersManager.register(...seeds);\r\n\r\n  await seedersManager.run(transaction as boolean);\r\n}\r\n\r\nasync function listSeedsFiles() {\r\n  const seedsFiles = await getFilesFromDirectory(srcPath(\"app\"), \"*/seeds/*.ts\");\r\n\r\n  const seeds = [];\r\n\r\n  for (const seedFile of seedsFiles) {\r\n    const seed = await loadSeedFile(seedFile);\r\n    seeds.push(seed);\r\n  }\r\n\r\n  return seeds;\r\n}\r\n\r\nasync function loadSeedFile(absPath: string): Promise<Seeder> {\r\n  const relativePath = Path.toRelative(absPath);\r\n  const seedImport = await filesOrchestrator.load<{ default: Seeder }>(relativePath);\r\n\r\n  if (!seedImport || !seedImport.default) {\r\n    throw new Error(`Seeder file ${relativePath} does not export a default seeder.`);\r\n  }\r\n\r\n  return seedImport.default;\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"seed-command-action.mjs","names":["runInTransaction"],"sources":["../../../../../../../core/src/database/seed-command-action.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport {\r\n  DataSource,\r\n  dataSourceRegistry,\r\n  transaction as runInTransaction,\r\n} from \"@warlock.js/cascade\";\r\nimport type { CommandActionData } from \"../commands/types\";\r\nimport { filesOrchestrator } from \"../dev-server/files-orchestrator\";\r\nimport { Path } from \"../utils/normalized-path\";\r\nimport { getFilesFromDirectory } from \"../dev-server/utils\";\r\nimport { srcPath } from \"../utils\";\r\nimport type { Seeder } from \"./seeds/seeder\";\r\nimport { SeedersManager } from \"./seeds/seeders.manager\";\r\nimport type { SeedClock, SeedRecordRef } from \"./seeds/types\";\r\nimport { seedRecordsTableName, seedsTableName } from \"./seeds/utils\";\r\n\r\n/**\r\n * Programmatic-only overrides for {@link seedCommandAction}.\r\n *\r\n * Not derived from CLI flags (the CLI passes only {@link CommandActionData}),\r\n * so a back-fill script or a test can inject behaviour the command line can't\r\n * express.\r\n */\r\nexport type SeedCommandOverrides = {\r\n  /**\r\n   * Clock the run reads for the `now` handed to each seeder and for the\r\n   * seeds-log metadata timestamps. Defaults to `() => new Date()`. Forwarded to\r\n   * {@link SeedersManager}'s `clock` option.\r\n   */\r\n  clock?: SeedClock;\r\n};\r\n\r\nasync function clearAllTables(datasource: DataSource) {\r\n  const tables = await datasource.driver.blueprint.listTables();\r\n\r\n  for (const table of tables) {\r\n    await datasource.driver.truncateTable(table, { cascade: true });\r\n  }\r\n}\r\n\r\ntype SeedRecordRow = SeedRecordRef & { id: number };\r\n\r\n/**\r\n * Undo seeded data by deleting the records a seeder tracked via `track`.\r\n *\r\n * Reads `seed_records` (all seeders, or a single `seederName`), then deletes\r\n * the referenced records in REVERSE seed-order and, within each seed, in\r\n * reverse insertion-order. Insertion id is strictly increasing across the\r\n * whole run, so deleting by descending `id` satisfies both at once. The whole\r\n * operation runs in a single transaction, and the matching seeds-log rows are\r\n * reset afterwards so `once: true` seeds re-run on the next `warlock seed`.\r\n *\r\n * @returns the number of tracked records deleted.\r\n */\r\nexport async function dropSeedRecords(\r\n  datasource: DataSource,\r\n  seederName?: string,\r\n): Promise<number> {\r\n  const driver = datasource.driver;\r\n\r\n  if (!(await driver.blueprint.tableExists(seedRecordsTableName))) {\r\n    return 0;\r\n  }\r\n\r\n  const query = driver.queryBuilder<SeedRecordRow>(seedRecordsTableName);\r\n\r\n  if (seederName) {\r\n    query.where(\"seeder\", seederName);\r\n  }\r\n\r\n  const rows = await query.get();\r\n\r\n  if (rows.length === 0) {\r\n    return 0;\r\n  }\r\n\r\n  // Descending insertion id == reverse seed-order + reverse within-seed order.\r\n  const ordered = [...rows].sort((a, b) => b.id - a.id);\r\n\r\n  await runInTransaction(async () => {\r\n    for (const row of ordered) {\r\n      await driver.deleteMany(row.table, { id: row.recordId });\r\n    }\r\n\r\n    // Clear the tracked refs we just acted on.\r\n    if (seederName) {\r\n      await driver.deleteMany(seedRecordsTableName, { seeder: seederName });\r\n    } else {\r\n      await driver.deleteMany(seedRecordsTableName, {});\r\n    }\r\n\r\n    // Reset the seeds-log rows so `once: true` seeds re-run.\r\n    const seederNames = seederName\r\n      ? [seederName]\r\n      : [...new Set(ordered.map((row) => row.seeder))];\r\n\r\n    for (const name of seederNames) {\r\n      await driver.deleteMany(seedsTableName, { name });\r\n    }\r\n  });\r\n\r\n  return ordered.length;\r\n}\r\n\r\n/**\r\n * Run database seeds.\r\n *\r\n * @example\r\n * ```ts\r\n * import { seedCommandAction } from \"@warlock.js/core\";\r\n *\r\n * await seedCommandAction({\r\n *   command: \"seed\",\r\n *   options: { fresh: true, list: false }\r\n * });\r\n * ```\r\n *\r\n * @param overrides Programmatic-only overrides (e.g. an injected `clock`); the\r\n * CLI never passes this, so the command-line signature stays unchanged.\r\n */\r\nexport async function seedCommandAction(\r\n  options: CommandActionData,\r\n  overrides?: SeedCommandOverrides,\r\n) {\r\n  const { path, fresh, transaction, list, drop } = options.options;\r\n\r\n  const datasource = dataSourceRegistry.get();\r\n\r\n  if (drop) {\r\n    // `--drop` (boolean) undoes every tracked record; `--drop=<name>` scopes to\r\n    // a single seeder.\r\n    const seederName = typeof drop === \"string\" ? drop : undefined;\r\n\r\n    const deleted = await dropSeedRecords(datasource, seederName);\r\n\r\n    const scope = seederName ? colors.cyan(seederName) : \"all seeders\";\r\n    console.log(\r\n      `🗑️  Dropped ${colors.redBright(deleted)} tracked record(s) for ${scope}; matching seeds-log entries reset.`,\r\n    );\r\n    return;\r\n  }\r\n\r\n  if (fresh) {\r\n    await clearAllTables(datasource);\r\n  }\r\n\r\n  if (list) {\r\n    const seedFiles = await listSeedsFiles();\r\n\r\n    if (seedFiles.length === 0) {\r\n      console.log(\"No seeds found.\");\r\n      return;\r\n    }\r\n\r\n    const seedersManager = new SeedersManager();\r\n\r\n    seedersManager.register(...seedFiles);\r\n\r\n    const seeds = seedersManager.sort().seeders.map((seed) => {\r\n      return {\r\n        name: seed.name,\r\n        order: seed.order,\r\n        enabled: seed.enabled,\r\n      };\r\n    });\r\n\r\n    console.table(seeds);\r\n\r\n    console.log(\r\n      `Total Seeds: ${colors.blueBright(seeds.length)}, enabled: ${colors.greenBright(seeds.filter((seed) => seed.enabled !== false).length)}, disabled: ${colors.redBright(seeds.filter((seed) => seed.enabled === false).length)}`,\r\n    );\r\n    return;\r\n  }\r\n\r\n  const seeds = path\r\n    ? [await loadSeedFile(Path.toAbsolute(path as string))]\r\n    : await listSeedsFiles();\r\n\r\n  const seedersManager = new SeedersManager({ clock: overrides?.clock });\r\n\r\n  seedersManager.register(...seeds);\r\n\r\n  await seedersManager.run(transaction as boolean);\r\n}\r\n\r\nasync function listSeedsFiles() {\r\n  const seedsFiles = await getFilesFromDirectory(srcPath(\"app\"), \"*/seeds/*.ts\");\r\n\r\n  const seeds = [];\r\n\r\n  for (const seedFile of seedsFiles) {\r\n    const seed = await loadSeedFile(seedFile);\r\n    seeds.push(seed);\r\n  }\r\n\r\n  return seeds;\r\n}\r\n\r\nasync function loadSeedFile(absPath: string): Promise<Seeder> {\r\n  const relativePath = Path.toRelative(absPath);\r\n  const seedImport = await filesOrchestrator.load<{ default: Seeder }>(relativePath);\r\n\r\n  if (!seedImport || !seedImport.default) {\r\n    throw new Error(`Seeder file ${relativePath} does not export a default seeder.`);\r\n  }\r\n\r\n  return seedImport.default;\r\n}\r\n"],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"seeders.manager.mjs","names":[],"sources":["../../../../../../../../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 { Seeder } from \"./seeder\";\nimport { SeederDependencyCycleError, UnknownSeederDependencyError } from \"./seeder.errors\";\nimport { SeedRecordsTableMigration } from \"./seed-records-table-migration\";\nimport { SeedsTableMigration } from \"./seeds-table-migration\";\nimport {\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":["../../../../../../../../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/dev-server/boot-precondition-error.mjs

@@ -0,0 +1,35 @@
+import { PortInUseError } from "../http/port-preflight.mjs";
+
+//#region ../core/src/dev-server/boot-precondition-error.ts
+/**
+* Marks a startup failure whose cause cannot change because the dev worker
+* tried again — a rejected `Application.onValidateBoot(...)` validator, an
+* unusable configured value, or (via {@link isBootPreconditionError})
+* {@link PortInUseError} itself. Distinct from an ordinary code error or a
+* refused database/cache connection, both of which ARE worth restarting for
+* (the underlying service, or the developer's fix, can change on the next
+* attempt).
+*
+* `start-development-server.ts` checks for this type (never an error
+* message) to decide whether the worker exits with
+* `supervisor.ts`'s `BOOT_PRECONDITION_EXIT_CODE`, which the supervisor
+* treats as terminal — no restart, no crash-budget spend.
+*/
+var BootPreconditionError = class extends Error {
+	constructor(message, options) {
+		super(message, options);
+		this.name = "BootPreconditionError";
+	}
+};
+/**
+* Whether `error` belongs to the boot-precondition class — checked by TYPE,
+* never by message text, so a legitimate error that happens to share
+* wording with a known failure is never misclassified.
+*/
+function isBootPreconditionError(error) {
+	return error instanceof BootPreconditionError || error instanceof PortInUseError;
+}
+
+//#endregion
+export { BootPreconditionError, isBootPreconditionError };
+//# sourceMappingURL=boot-precondition-error.mjs.map

package/esm/dev-server/boot-precondition-error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot-precondition-error.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/boot-precondition-error.ts"],"sourcesContent":["import { PortInUseError } from \"../http/port-preflight\";\n\n/**\n * Marks a startup failure whose cause cannot change because the dev worker\n * tried again — a rejected `Application.onValidateBoot(...)` validator, an\n * unusable configured value, or (via {@link isBootPreconditionError})\n * {@link PortInUseError} itself. Distinct from an ordinary code error or a\n * refused database/cache connection, both of which ARE worth restarting for\n * (the underlying service, or the developer's fix, can change on the next\n * attempt).\n *\n * `start-development-server.ts` checks for this type (never an error\n * message) to decide whether the worker exits with\n * `supervisor.ts`'s `BOOT_PRECONDITION_EXIT_CODE`, which the supervisor\n * treats as terminal — no restart, no crash-budget spend.\n */\nexport class BootPreconditionError extends Error {\n  public constructor(message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = \"BootPreconditionError\";\n  }\n}\n\n/**\n * Whether `error` belongs to the boot-precondition class — checked by TYPE,\n * never by message text, so a legitimate error that happens to share\n * wording with a known failure is never misclassified.\n */\nexport function isBootPreconditionError(error: unknown): boolean {\n  return error instanceof BootPreconditionError || error instanceof PortInUseError;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,IAAa,wBAAb,cAA2C,MAAM;CAC/C,AAAO,YAAY,SAAiB,SAA+B;EACjE,MAAM,SAAS,OAAO;EACtB,KAAK,OAAO;CACd;AACF;;;;;;AAOA,SAAgB,wBAAwB,OAAyB;CAC/D,OAAO,iBAAiB,yBAAyB,iBAAiB;AACpE"}

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

@@ -9,6 +9,7 @@ import { MANIFEST_PATH } from "./flags.mjs";
 import { filesOrchestrator } from "./files-orchestrator.mjs";
 import { restartDevServer } from "./restart-dev-server.mjs";
 import { devServerShortcuts } from "./shortcuts.mjs";
+import { BootPreconditionError } from "./boot-precondition-error.mjs";
 import { LayerExecutor } from "./layer-executor.mjs";
 import { printReadyBlock } from "./ready-block.mjs";
 import { typeGenerator } from "./type-generator.mjs";
@@ -42,7 +43,11 @@ var DevelopmentServer = class {
 			this.setupEventListeners();
 			await this.autoDiscoverFiles();
 			await filesOrchestrator.moduleLoader.loadAll();
-			await Application.runStartupValidators();
+			try {
+				await Application.runStartupValidators();
+			} catch (error) {
+				throw new BootPreconditionError(error.message, { cause: error });
+			}
 			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, 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 { printReadyBlock } from \"./ready-block\";\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\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      // ONE block, AFTER the boot it summarises, replacing the scattered\r\n      // \"N route(s) registered\" / \"Server ready at …\" / \"ready in …\" lines that\r\n      // used to arrive in completion order. Warnings logged during boot sit\r\n      // above it and stay there — see `ready-block.ts`.\r\n      printReadyBlock(duration);\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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAwBA,IAAa,oBAAb,MAA+B;CAK7B,AAAO,YAAY,UAAiC,CAAC,GAAG;iBAHtC;EAIhB,KAAK,UAAU;EACf,cAAc,gCAAgC;CAChD;CAEA,MAAa,QAAuB;EAClC,IAAI;GACF,MAAM,YAAY,YAAY,IAAI;GAIlC,IAAI,KAAK,QAAQ,SAAU,MAAM,gBAAgB,aAAa,GAAI;IAChE,MAAM,YAAY,aAAa;IAC/B,YAAY,OAAO,WAAW,4BAA4B,CAAC;GAC7D;GAEA,MAAM,kBAAkB,KAAK;GAC7B,MAAM,kBAAkB,cAAc;GACtC,MAAM,kBAAkB,WAAW;GAEnC,kBAAkB,sBAAsB,QAAQ,kBAAkB,SAAS,CAAC;GAE5E,KAAK,oBAAoB;GAIzB,MAAM,KAAK,kBAAkB;GAE7B,MAAM,kBAAkB,aAAa,QAAQ;GAK7C,MAAM,YAAY,qBAAqB;GAIvC,MAAM,kBAAkB,iBAAuC;GAE/D,KAAK,gBAAgB,IAAI,cACvB,kBAAkB,mBAAmB,GACrC,kBAAkB,uBAClB,kBAAkB,eACjB,iBAAiB,kBAAkB,YAAY,YAAY,SACtD,kBAAkB,kBAAkB,CAC5C;GAEA,KAAK,UAAU;GAEf,MAAM,WAAW,YAAY,IAAI,IAAI;GAIrC,YAAY,WAAW;IACrB,aAAa,YAAY;IACzB,iBAAiB,YAAY;IAC7B,gBAAgB;GAClB,CAAC;GAMD,gBAAgB,QAAQ;GAGxB,MAAM,kBAAkB,MAAM,qBAAqB,IAAI,WAAW;GAClE,MAAM,kBACJ,KAAK,QAAQ,mBAAmB,iBAAiB,mBAAmB;GACtE,MAAM,iBAAiB,KAAK,QAAQ,kBAAkB,iBAAiB,kBAAkB;GAEzF,IAAI,iBAAiB,cAAc,0BAA0B;GAE7D,IAAI,gBACF,kBAAkB,oBAAoB,mBAAmB,OAAO,SAAY,cAAc;EAE9F,SAAS,OAAO;GACd,YAAY,OAAO,UAAU,uCAAuC,OAAO,CAAC;GAC5E,MAAM,KAAK,SAAS;GACpB,MAAM;EACR;CACF;;;;;CAMA,MAAc,oBAAmC;EAC/C,MAAM,iBAAiB,CAAC,OAAO;EAC/B,KAAK,MAAM,QAAQ,kBAAkB,MAAM,OAAO,GAChD,IAAI,KAAK,QAAS,eAAqC,SAAS,KAAK,IAAI,GACvE,MAAM,kBAAkB,aAAa,WAAW,MAAM,KAAK,IAAI;CAGrE;CAEA,AAAQ,sBAA4B;EAClC,OAAO,GAAG,8BAA8B,UAAiB,KAAK,oBAAoB,KAAK,CAAC;CAC1F;CAEA,MAAc,oBAAoB,OAA6B;EAC7D,IAAI,CAAC,KAAK,WAAW,CAAC,KAAK,eAAe;EAO1C,MAAM,iBAAiB,KAAK,mBAAmB,KAAK;EAEpD,IAAI,gBAKF,MAAM,KAAK,uBAAuB,cAAc;EAQlD,IADc,MAAM,MAAM,SAAS,MAAM,QAAQ,SAAS,MAAM,QAAQ,WAC1D,GAAG;EAKjB,MAAM,YAAY,CAAC,GAAG,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,CAAC,QAClD,MAAM,CAAC,UAAU,CAAC,KAAK,MAAM,mBAChC;EAEA,IAAI;GACF,MAAM,KAAK,cAAc,mBACvB,WACA,kBAAkB,SAAS,GAC3B,MAAM,SACN,MAAM,OACR;GAEA,cAAc,wBAAwB,CAAC,GAAG,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC;GAExE,kBAAkB,YAAY,KAAK;EACrC,SAAS,OAAO;GACd,YAAY,OAAO,UAAU,mCAAmC,OAAO,CAAC;EAC1E;CACF;;;;;CAMA,AAAQ,mBAAmB,OAAkC;EAC3D,IAAI,MAAM,QAAQ,SAAS,mBAAmB,GAC5C,OAAO;EAGT,OAAO,CAAC,GAAG,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,CAAC,KAAK,SAAS;CAC1D;;;;;;;;;;CAWA,MAAc,uBAAuB,MAA6B;EAGhE,KAAI,MAF0B,qBAAqB,IAAI,WAAW,EAE/C,EAAE,0BAA0B,OAAO;GACpD,WAAW,GAAG,KAAK,4CAA4C;GAC/D;EACF;EAEA,WAAW,GAAG,KAAK,gCAAgC;EAInD,IAAI,CAAC,MAFmB,iBAAiB,IAAI,GAG3C,WAAW,GAAG,KAAK,4CAA4C;CAEnE;CAEA,MAAa,WAA0B;EAIrC,mBAAmB,QAAQ;EAE3B,IAAI,CAAC,KAAK,SAAS;EACnB,YAAY,OAAO,UAAU,qCAAqC,CAAC;EACnE,KAAK,UAAU;EACf,MAAM,kBAAkB,SAAS;EACjC,YAAY,OAAO,YAAY,4BAA4B,CAAC;CAC9D;CAEA,AAAO,YAAqB;EAC1B,OAAO,KAAK;CACd;AACF;AAGA,SAAS,UAAU,MAAuB;CACxC,MAAM,WAAW,KAAK,MAAM,GAAG,CAAC,CAAC,IAAI,KAAK;CAC1C,OAAO,aAAa,UAAU,SAAS,WAAW,OAAO;AAC3D"}
+{"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 { BootPreconditionError } from \"./boot-precondition-error\";\r\nimport { devLogInfo, 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 { printReadyBlock } from \"./ready-block\";\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      //\r\n      // Wrapped and re-thrown as a BootPreconditionError: a rejected\r\n      // validator is, by definition, a precondition whose cause cannot\r\n      // change because the worker tried again — the supervisor must not\r\n      // restart into the same rejection. See boot-precondition-error.ts.\r\n      try {\r\n        await Application.runStartupValidators();\r\n      } catch (error) {\r\n        throw new BootPreconditionError((error as Error).message, { cause: error });\r\n      }\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\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      // ONE block, AFTER the boot it summarises, replacing the scattered\r\n      // \"N route(s) registered\" / \"Server ready at …\" / \"ready in …\" lines that\r\n      // used to arrive in completion order. Warnings logged during boot sit\r\n      // above it and stay there — see `ready-block.ts`.\r\n      printReadyBlock(duration);\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\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"],"mappings":"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"}

package/esm/dev-server/files-orchestrator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"files-orchestrator.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/files-orchestrator.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport { init } from \"es-module-lexer\";\r\nimport type { MessagePort } from \"node:worker_threads\";\r\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\r\nimport { DependencyGraph } from \"./dependency-graph\";\r\nimport { devLogDim, devLogSuccess } from \"./dev-logger\";\r\nimport { FileEventHandler } from \"./file-event-handler\";\r\nimport { FileManager } from \"./file-manager\";\r\nimport { FileOperations } from \"./file-operations\";\r\nimport { FilesWatcher } from \"./files-watcher\";\r\nimport { FILE_PROCESSING_BATCH_SIZE } from \"./flags\";\r\nimport { EslintHealthChecker } from \"./health-checker/checkers/eslint-health-checker\";\r\nimport { TypescriptHealthChecker } from \"./health-checker/checkers/typescript-health-checker\";\r\nimport { FileHealthCheckerContract } from \"./health-checker/file-health-checker.contract\";\r\nimport { FilesHealthcareManager } from \"./health-checker/files-healthcare.manager\";\r\nimport { buildTranspileInit } from \"./loader/build-transpile-init.js\";\r\nimport { registerLoader } from \"./loader/register-loader.js\";\r\nimport { ManifestManager } from \"./manifest-manager\";\r\nimport { ModuleLoader } from \"./module-loader\";\r\nimport { packageJsonManager } from \"./package-json-manager\";\r\nimport { Path } from \"../utils/normalized-path\";\r\nimport { SpecialFilesCollector } from \"./special-files-collector\";\r\nimport { tsconfigManager } from \"./tsconfig-manager\";\r\nimport { ensureWarlockDirectory, getFilesFromDirectory } from \"./utils\";\r\n\r\n/**\r\n * Register a cleanup callback that fires before the current module is\r\n * unloaded by HMR. Stack-inspects the caller so user code doesn't need to\r\n * thread the FileManager through.\r\n */\r\nexport function onCleanup(callback: () => any) {\r\n  if (globalThis.__currentModuleFile) {\r\n    globalThis.__currentModuleFile.addCleanup(callback);\r\n    return;\r\n  }\r\n\r\n  const stack = new Error().stack;\r\n  const callerLine = stack?.split(\"\\n\")[2];\r\n  const match = callerLine?.match(/\\((.+?):\\d+:\\d+\\)/) || callerLine?.match(/at (.+?):\\d+:\\d+/);\r\n  const callerFile = match?.[1];\r\n\r\n  if (!callerFile) return;\r\n  const fileManager = filesOrchestrator.files.get(Path.toRelative(callerFile));\r\n  fileManager?.addCleanup(callback);\r\n}\r\n\r\n/**\r\n * Top-level coordinator for the dev server's file system.\r\n *\r\n * Owns: file discovery, the dependency graph, the manifest, the special-files\r\n * index, the file watcher, and the lifecycle of the ESM loader hook (which\r\n * provides cache-busting via `?v=N` version tokens).\r\n */\r\nexport class FilesOrchestrator {\r\n  public readonly filesWatcher = new FilesWatcher();\r\n  public readonly files = new Map<string, FileManager>();\r\n  private readonly manifest = new ManifestManager(this.files);\r\n  private readonly dependencyGraph = new DependencyGraph();\r\n  private readonly healthCheckerManager = new FilesHealthcareManager(this.files);\r\n  public readonly specialFilesCollector = new SpecialFilesCollector();\r\n  public readonly moduleLoader = new ModuleLoader(this.specialFilesCollector);\r\n  public readonly fileOperations: FileOperations;\r\n  private readonly eventHandler: FileEventHandler;\r\n\r\n  /** Main-thread end of the MessageChannel to the loader hook worker. */\r\n  private loaderPort: MessagePort | null = null;\r\n\r\n  /** Resolve callbacks for pending `flushVersionBumps()` calls. */\r\n  private readonly pendingFlushes: Array<() => void> = [];\r\n\r\n  public isInitialized = false;\r\n\r\n  public constructor() {\r\n    this.fileOperations = new FileOperations(\r\n      this.files,\r\n      this.dependencyGraph,\r\n      this.manifest,\r\n      this.specialFilesCollector,\r\n    );\r\n\r\n    this.eventHandler = new FileEventHandler(\r\n      this.fileOperations,\r\n      this.manifest,\r\n      this.dependencyGraph,\r\n      this.files,\r\n    );\r\n  }\r\n\r\n  public async add(relativePath: string): Promise<FileManager> {\r\n    return this.fileOperations.addFile(relativePath);\r\n  }\r\n\r\n  public async load<T>(relativePath: string, type = \"other\") {\r\n    const fileManager = await this.add(relativePath);\r\n    return this.moduleLoader.loadModule<T>(fileManager, fileManager.type || type);\r\n  }\r\n\r\n  public getDependencyGraph(): DependencyGraph {\r\n    return this.dependencyGraph;\r\n  }\r\n\r\n  public getInvalidationChain(file: string): string[] {\r\n    return this.dependencyGraph.getInvalidationChain(file);\r\n  }\r\n\r\n  public getFiles(): Map<string, FileManager> {\r\n    return this.files;\r\n  }\r\n\r\n  public getHealthCheckerManager(): FilesHealthcareManager {\r\n    return this.healthCheckerManager;\r\n  }\r\n\r\n  /**\r\n   * Initialise managers and register the ESM loader hook. Must be called\r\n   * before any user `src/` module is dynamically imported.\r\n   */\r\n  public async init() {\r\n    if (this.isInitialized) return;\r\n    this.isInitialized = true;\r\n\r\n    await init;\r\n    await Promise.all([tsconfigManager.init(), packageJsonManager.init()]);\r\n\r\n    // The loader hook writes itself into .warlock/, so ensure the dir exists.\r\n    await ensureWarlockDirectory();\r\n\r\n    const devServerConfig = await warlockConfigManager.lazyGet(\"devServer\");\r\n    const transpileInit = buildTranspileInit(\r\n      tsconfigManager.tsconfig?.compilerOptions,\r\n      devServerConfig?.transpileCacheDebug === true,\r\n    );\r\n\r\n    this.loaderPort = await registerLoader(transpileInit);\r\n\r\n    this.loaderPort.on(\"message\", (msg: { type: string }) => {\r\n      if (msg.type === \"sync-ack\") {\r\n        this.pendingFlushes.shift()?.();\r\n      }\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Tell the hook worker a file changed. The next `import()` of it will get\r\n   * a fresh `?v=N` URL → Node cache miss → fresh content.\r\n   */\r\n  public bumpVersion(absolutePath: string): void {\r\n    this.loaderPort?.postMessage({ type: \"bump\", absolutePath });\r\n  }\r\n\r\n  /**\r\n   * Wait until the hook worker has processed every pending bump.\r\n   *\r\n   * `postMessage` is async — without this, a follow-up `import()` may\r\n   * resolve before the worker increments the counter and Node will return\r\n   * the cached old module.\r\n   */\r\n  public flushVersionBumps(): Promise<void> {\r\n    if (!this.loaderPort) return Promise.resolve();\r\n\r\n    return new Promise<void>((resolve) => {\r\n      this.pendingFlushes.push(resolve);\r\n      this.loaderPort!.postMessage({ type: \"sync\" });\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Discover files on disk, reconcile against the manifest, build the dep\r\n   * graph, and persist the new manifest. Idempotent.\r\n   */\r\n  public async initializeAll() {\r\n    const [filesInFilesystem, manifestExists] = await Promise.all([\r\n      this.getAllFilesFromFilesystem(),\r\n      this.manifest.init(),\r\n    ]);\r\n\r\n    if (!manifestExists) {\r\n      await this.processFiles(filesInFilesystem);\r\n    } else {\r\n      await this.reconcileFiles(filesInFilesystem);\r\n    }\r\n\r\n    this.dependencyGraph.build(this.files);\r\n    this.fileOperations.updateFileDependents();\r\n    this.fileOperations.syncFilesToManifest();\r\n    await this.manifest.save();\r\n  }\r\n\r\n  public async checkHealth(files: { added: string[]; changed: string[]; deleted: string[] }) {\r\n    const filesToCheck = [...files.added, ...files.changed]\r\n      .map((file) => this.files.get(Path.toRelative(file)))\r\n      .filter((file): file is FileManager => !!file);\r\n\r\n    const filesToDelete = files.deleted\r\n      .map((file) => this.files.get(Path.toRelative(file)))\r\n      .filter((file): file is FileManager => !!file);\r\n\r\n    await this.healthCheckerManager.onFileChanges(filesToCheck);\r\n    this.healthCheckerManager.removeFiles(filesToDelete);\r\n    this.healthCheckerManager.checkFiles(filesToCheck);\r\n  }\r\n\r\n  public async startCheckingHealth(healthCheckers?: FileHealthCheckerContract[]): Promise<void> {\r\n    devLogDim(\"Started File Health Checks in the background.\");\r\n\r\n    const checkers = healthCheckers ?? [new TypescriptHealthChecker(), new EslintHealthChecker()];\r\n    await this.healthCheckerManager.setHealthCheckers(checkers).initialize();\r\n    await this.healthCheckerManager.validateAllFiles();\r\n  }\r\n\r\n  /**\r\n   * Glob the src directory, returning relative paths.\r\n   */\r\n  public async getAllFilesFromFilesystem(): Promise<string[]> {\r\n    const absolutePaths = await getFilesFromDirectory();\r\n    return absolutePaths.map((absPath) => Path.toRelative(absPath));\r\n  }\r\n\r\n  /**\r\n   * Process every file from scratch — used when no manifest exists.\r\n   */\r\n  private async processFiles(filePaths: string[]) {\r\n    devLogDim(`processing ${filePaths.length} files...`);\r\n    await runInBatches(filePaths, FILE_PROCESSING_BATCH_SIZE, async (relativePath) => {\r\n      const fileManager = new FileManager(\r\n        Path.toAbsolute(relativePath),\r\n        this.files,\r\n        this.fileOperations,\r\n      );\r\n      this.files.set(relativePath, fileManager);\r\n      await fileManager.process();\r\n    });\r\n    devLogSuccess(`processed ${filePaths.length} files`);\r\n  }\r\n\r\n  private async reconcileFiles(filesInFilesystem: string[]) {\r\n    const filesInManifest = new Set(this.manifest.getAllFilePaths());\r\n    const filesInFilesystemSet = new Set(filesInFilesystem);\r\n\r\n    const newFiles = filesInFilesystem.filter((f) => !filesInManifest.has(f));\r\n    const deletedFiles = Array.from(filesInManifest).filter((f) => !filesInFilesystemSet.has(f));\r\n    const existingFiles = filesInFilesystem.filter((f) => filesInManifest.has(f));\r\n\r\n    if (newFiles.length > 0 || deletedFiles.length > 0) {\r\n      devLogDim(\r\n        `reconciling: ${colors.green(newFiles.length)} new, ${colors.red(deletedFiles.length)} deleted, ${colors.blue(existingFiles.length)} existing`,\r\n      );\r\n    }\r\n\r\n    await this.processFiles(newFiles);\r\n\r\n    for (const relativePath of deletedFiles) {\r\n      this.manifest.removeFile(relativePath);\r\n      this.files.delete(relativePath);\r\n    }\r\n\r\n    await runInBatches(existingFiles, FILE_PROCESSING_BATCH_SIZE, async (relativePath) => {\r\n      const fileManager = new FileManager(\r\n        Path.toAbsolute(relativePath),\r\n        this.files,\r\n        this.fileOperations,\r\n      );\r\n      this.files.set(relativePath, fileManager);\r\n      await fileManager.init(this.manifest.getFile(relativePath));\r\n    });\r\n  }\r\n\r\n  public async watchFiles() {\r\n    devLogSuccess(\"watching for file changes\");\r\n\r\n    this.filesWatcher.onFileChange((p) => this.eventHandler.handleFileChange(p));\r\n    this.filesWatcher.onFileAdd((p) => this.eventHandler.handleFileAdd(p));\r\n    this.filesWatcher.onFileDelete((p) => this.eventHandler.handleFileDelete(p));\r\n\r\n    const watchConfig = warlockConfigManager.get(\"devServer\")?.watch;\r\n    await this.filesWatcher.watch(watchConfig);\r\n  }\r\n}\r\n\r\nasync function runInBatches<T>(\r\n  items: T[],\r\n  size: number,\r\n  fn: (item: T) => Promise<unknown>,\r\n): Promise<void> {\r\n  if (items.length === 0) return;\r\n  for (let i = 0; i < items.length; i += size) {\r\n    await Promise.all(items.slice(i, i + size).map(fn));\r\n  }\r\n}\r\n\r\nexport const filesOrchestrator = new FilesOrchestrator();\r\n"],"mappings":"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"}
+{"version":3,"file":"files-orchestrator.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/files-orchestrator.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\r\nimport { init } from \"es-module-lexer\";\r\nimport type { MessagePort } from \"node:worker_threads\";\r\nimport { warlockConfigManager } from \"../warlock-config/warlock-config.manager\";\r\nimport { DependencyGraph } from \"./dependency-graph\";\r\nimport { devLogDim, devLogSuccess } from \"./dev-logger\";\r\nimport { FileEventHandler } from \"./file-event-handler\";\r\nimport { FileManager } from \"./file-manager\";\r\nimport { FileOperations } from \"./file-operations\";\r\nimport { FilesWatcher } from \"./files-watcher\";\r\nimport { FILE_PROCESSING_BATCH_SIZE } from \"./flags\";\r\nimport { EslintHealthChecker } from \"./health-checker/checkers/eslint-health-checker\";\r\nimport { TypescriptHealthChecker } from \"./health-checker/checkers/typescript-health-checker\";\r\nimport type { FileHealthCheckerContract } from \"./health-checker/file-health-checker.contract\";\r\nimport { FilesHealthcareManager } from \"./health-checker/files-healthcare.manager\";\r\nimport { buildTranspileInit } from \"./loader/build-transpile-init.js\";\r\nimport { registerLoader } from \"./loader/register-loader.js\";\r\nimport { ManifestManager } from \"./manifest-manager\";\r\nimport { ModuleLoader } from \"./module-loader\";\r\nimport { packageJsonManager } from \"./package-json-manager\";\r\nimport { Path } from \"../utils/normalized-path\";\r\nimport { SpecialFilesCollector } from \"./special-files-collector\";\r\nimport { tsconfigManager } from \"./tsconfig-manager\";\r\nimport { ensureWarlockDirectory, getFilesFromDirectory } from \"./utils\";\r\n\r\n/**\r\n * Register a cleanup callback that fires before the current module is\r\n * unloaded by HMR. Stack-inspects the caller so user code doesn't need to\r\n * thread the FileManager through.\r\n */\r\nexport function onCleanup(callback: () => any) {\r\n  if (globalThis.__currentModuleFile) {\r\n    globalThis.__currentModuleFile.addCleanup(callback);\r\n    return;\r\n  }\r\n\r\n  const stack = new Error().stack;\r\n  const callerLine = stack?.split(\"\\n\")[2];\r\n  const match = callerLine?.match(/\\((.+?):\\d+:\\d+\\)/) || callerLine?.match(/at (.+?):\\d+:\\d+/);\r\n  const callerFile = match?.[1];\r\n\r\n  if (!callerFile) return;\r\n  const fileManager = filesOrchestrator.files.get(Path.toRelative(callerFile));\r\n  fileManager?.addCleanup(callback);\r\n}\r\n\r\n/**\r\n * Top-level coordinator for the dev server's file system.\r\n *\r\n * Owns: file discovery, the dependency graph, the manifest, the special-files\r\n * index, the file watcher, and the lifecycle of the ESM loader hook (which\r\n * provides cache-busting via `?v=N` version tokens).\r\n */\r\nexport class FilesOrchestrator {\r\n  public readonly filesWatcher = new FilesWatcher();\r\n  public readonly files = new Map<string, FileManager>();\r\n  private readonly manifest = new ManifestManager(this.files);\r\n  private readonly dependencyGraph = new DependencyGraph();\r\n  private readonly healthCheckerManager = new FilesHealthcareManager(this.files);\r\n  public readonly specialFilesCollector = new SpecialFilesCollector();\r\n  public readonly moduleLoader = new ModuleLoader(this.specialFilesCollector);\r\n  public readonly fileOperations: FileOperations;\r\n  private readonly eventHandler: FileEventHandler;\r\n\r\n  /** Main-thread end of the MessageChannel to the loader hook worker. */\r\n  private loaderPort: MessagePort | null = null;\r\n\r\n  /** Resolve callbacks for pending `flushVersionBumps()` calls. */\r\n  private readonly pendingFlushes: Array<() => void> = [];\r\n\r\n  public isInitialized = false;\r\n\r\n  public constructor() {\r\n    this.fileOperations = new FileOperations(\r\n      this.files,\r\n      this.dependencyGraph,\r\n      this.manifest,\r\n      this.specialFilesCollector,\r\n    );\r\n\r\n    this.eventHandler = new FileEventHandler(\r\n      this.fileOperations,\r\n      this.manifest,\r\n      this.dependencyGraph,\r\n      this.files,\r\n    );\r\n  }\r\n\r\n  public async add(relativePath: string): Promise<FileManager> {\r\n    return this.fileOperations.addFile(relativePath);\r\n  }\r\n\r\n  public async load<T>(relativePath: string, type = \"other\") {\r\n    const fileManager = await this.add(relativePath);\r\n    return this.moduleLoader.loadModule<T>(fileManager, fileManager.type || type);\r\n  }\r\n\r\n  public getDependencyGraph(): DependencyGraph {\r\n    return this.dependencyGraph;\r\n  }\r\n\r\n  public getInvalidationChain(file: string): string[] {\r\n    return this.dependencyGraph.getInvalidationChain(file);\r\n  }\r\n\r\n  public getFiles(): Map<string, FileManager> {\r\n    return this.files;\r\n  }\r\n\r\n  public getHealthCheckerManager(): FilesHealthcareManager {\r\n    return this.healthCheckerManager;\r\n  }\r\n\r\n  /**\r\n   * Initialise managers and register the ESM loader hook. Must be called\r\n   * before any user `src/` module is dynamically imported.\r\n   */\r\n  public async init() {\r\n    if (this.isInitialized) return;\r\n    this.isInitialized = true;\r\n\r\n    await init;\r\n    await Promise.all([tsconfigManager.init(), packageJsonManager.init()]);\r\n\r\n    // The loader hook writes itself into .warlock/, so ensure the dir exists.\r\n    await ensureWarlockDirectory();\r\n\r\n    const devServerConfig = await warlockConfigManager.lazyGet(\"devServer\");\r\n    const transpileInit = buildTranspileInit(\r\n      tsconfigManager.tsconfig?.compilerOptions,\r\n      devServerConfig?.transpileCacheDebug === true,\r\n    );\r\n\r\n    this.loaderPort = await registerLoader(transpileInit);\r\n\r\n    this.loaderPort.on(\"message\", (msg: { type: string }) => {\r\n      if (msg.type === \"sync-ack\") {\r\n        this.pendingFlushes.shift()?.();\r\n      }\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Tell the hook worker a file changed. The next `import()` of it will get\r\n   * a fresh `?v=N` URL → Node cache miss → fresh content.\r\n   */\r\n  public bumpVersion(absolutePath: string): void {\r\n    this.loaderPort?.postMessage({ type: \"bump\", absolutePath });\r\n  }\r\n\r\n  /**\r\n   * Wait until the hook worker has processed every pending bump.\r\n   *\r\n   * `postMessage` is async — without this, a follow-up `import()` may\r\n   * resolve before the worker increments the counter and Node will return\r\n   * the cached old module.\r\n   */\r\n  public flushVersionBumps(): Promise<void> {\r\n    if (!this.loaderPort) return Promise.resolve();\r\n\r\n    return new Promise<void>((resolve) => {\r\n      this.pendingFlushes.push(resolve);\r\n      this.loaderPort!.postMessage({ type: \"sync\" });\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Discover files on disk, reconcile against the manifest, build the dep\r\n   * graph, and persist the new manifest. Idempotent.\r\n   */\r\n  public async initializeAll() {\r\n    const [filesInFilesystem, manifestExists] = await Promise.all([\r\n      this.getAllFilesFromFilesystem(),\r\n      this.manifest.init(),\r\n    ]);\r\n\r\n    if (!manifestExists) {\r\n      await this.processFiles(filesInFilesystem);\r\n    } else {\r\n      await this.reconcileFiles(filesInFilesystem);\r\n    }\r\n\r\n    this.dependencyGraph.build(this.files);\r\n    this.fileOperations.updateFileDependents();\r\n    this.fileOperations.syncFilesToManifest();\r\n    await this.manifest.save();\r\n  }\r\n\r\n  public async checkHealth(files: { added: string[]; changed: string[]; deleted: string[] }) {\r\n    const filesToCheck = [...files.added, ...files.changed]\r\n      .map((file) => this.files.get(Path.toRelative(file)))\r\n      .filter((file): file is FileManager => !!file);\r\n\r\n    const filesToDelete = files.deleted\r\n      .map((file) => this.files.get(Path.toRelative(file)))\r\n      .filter((file): file is FileManager => !!file);\r\n\r\n    await this.healthCheckerManager.onFileChanges(filesToCheck);\r\n    this.healthCheckerManager.removeFiles(filesToDelete);\r\n    this.healthCheckerManager.checkFiles(filesToCheck);\r\n  }\r\n\r\n  public async startCheckingHealth(healthCheckers?: FileHealthCheckerContract[]): Promise<void> {\r\n    devLogDim(\"Started File Health Checks in the background.\");\r\n\r\n    const checkers = healthCheckers ?? [new TypescriptHealthChecker(), new EslintHealthChecker()];\r\n    await this.healthCheckerManager.setHealthCheckers(checkers).initialize();\r\n    await this.healthCheckerManager.validateAllFiles();\r\n  }\r\n\r\n  /**\r\n   * Glob the src directory, returning relative paths.\r\n   */\r\n  public async getAllFilesFromFilesystem(): Promise<string[]> {\r\n    const absolutePaths = await getFilesFromDirectory();\r\n    return absolutePaths.map((absPath) => Path.toRelative(absPath));\r\n  }\r\n\r\n  /**\r\n   * Process every file from scratch — used when no manifest exists.\r\n   */\r\n  private async processFiles(filePaths: string[]) {\r\n    devLogDim(`processing ${filePaths.length} files...`);\r\n    await runInBatches(filePaths, FILE_PROCESSING_BATCH_SIZE, async (relativePath) => {\r\n      const fileManager = new FileManager(\r\n        Path.toAbsolute(relativePath),\r\n        this.files,\r\n        this.fileOperations,\r\n      );\r\n      this.files.set(relativePath, fileManager);\r\n      await fileManager.process();\r\n    });\r\n    devLogSuccess(`processed ${filePaths.length} files`);\r\n  }\r\n\r\n  private async reconcileFiles(filesInFilesystem: string[]) {\r\n    const filesInManifest = new Set(this.manifest.getAllFilePaths());\r\n    const filesInFilesystemSet = new Set(filesInFilesystem);\r\n\r\n    const newFiles = filesInFilesystem.filter((f) => !filesInManifest.has(f));\r\n    const deletedFiles = Array.from(filesInManifest).filter((f) => !filesInFilesystemSet.has(f));\r\n    const existingFiles = filesInFilesystem.filter((f) => filesInManifest.has(f));\r\n\r\n    if (newFiles.length > 0 || deletedFiles.length > 0) {\r\n      devLogDim(\r\n        `reconciling: ${colors.green(newFiles.length)} new, ${colors.red(deletedFiles.length)} deleted, ${colors.blue(existingFiles.length)} existing`,\r\n      );\r\n    }\r\n\r\n    await this.processFiles(newFiles);\r\n\r\n    for (const relativePath of deletedFiles) {\r\n      this.manifest.removeFile(relativePath);\r\n      this.files.delete(relativePath);\r\n    }\r\n\r\n    await runInBatches(existingFiles, FILE_PROCESSING_BATCH_SIZE, async (relativePath) => {\r\n      const fileManager = new FileManager(\r\n        Path.toAbsolute(relativePath),\r\n        this.files,\r\n        this.fileOperations,\r\n      );\r\n      this.files.set(relativePath, fileManager);\r\n      await fileManager.init(this.manifest.getFile(relativePath));\r\n    });\r\n  }\r\n\r\n  public async watchFiles() {\r\n    devLogSuccess(\"watching for file changes\");\r\n\r\n    this.filesWatcher.onFileChange((p) => this.eventHandler.handleFileChange(p));\r\n    this.filesWatcher.onFileAdd((p) => this.eventHandler.handleFileAdd(p));\r\n    this.filesWatcher.onFileDelete((p) => this.eventHandler.handleFileDelete(p));\r\n\r\n    const watchConfig = warlockConfigManager.get(\"devServer\")?.watch;\r\n    await this.filesWatcher.watch(watchConfig);\r\n  }\r\n}\r\n\r\nasync function runInBatches<T>(\r\n  items: T[],\r\n  size: number,\r\n  fn: (item: T) => Promise<unknown>,\r\n): Promise<void> {\r\n  if (items.length === 0) return;\r\n  for (let i = 0; i < items.length; i += size) {\r\n    await Promise.all(items.slice(i, i + size).map(fn));\r\n  }\r\n}\r\n\r\nexport const filesOrchestrator = new FilesOrchestrator();\r\n"],"mappings":"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"}

package/esm/dev-server/health-checker/checkers/eslint-health-checker.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"eslint-health-checker.mjs","names":[],"sources":["../../../../../../../../../core/src/dev-server/health-checker/checkers/eslint-health-checker.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { ESLint } from \"eslint\";\nimport fs from \"fs\";\nimport path from \"path\";\nimport { FileManager } from \"../../file-manager\";\nimport { FileHealthCheckerContract } from \"../file-health-checker.contract\";\nimport { FileHealthResult } from \"../file-health-result\";\nimport { BaseHealthChecker } from \"./base-health-checker\";\n\nexport class EslintHealthChecker extends BaseHealthChecker implements FileHealthCheckerContract {\n  /**\n   * ESLint instance (using new ESLint v9 API with flat config)\n   */\n  private eslint: ESLint | null = null;\n\n  /**\n   * Health checker name\n   */\n  public name: string = \"ESLint\";\n\n  /**\n   * Path to dedicated worker file for ESLint checking\n   * Runs in a separate thread to avoid blocking the main dev server\n   */\n  public workerPath: string = \"./workers/eslint-health.worker\";\n\n  /**\n   * Whether checker is initialized\n   */\n  private initialized: boolean = false;\n\n  /**\n   * Check if file is a lintable file\n   */\n  private isLintableFile(filePath: string): boolean {\n    const ext = filePath.toLowerCase();\n    return (\n      ext.endsWith(\".ts\") || ext.endsWith(\".tsx\") || ext.endsWith(\".js\") || ext.endsWith(\".jsx\")\n    );\n  }\n\n  /**\n   * Initialize the health checker\n   */\n  public initialize(): EslintHealthChecker {\n    try {\n      // Check if eslint.config.js exists (new flat config format)\n      const flatConfigPath = path.join(process.cwd(), \"eslint.config.js\");\n      const flatConfigMjsPath = path.join(process.cwd(), \"eslint.config.mjs\");\n      const flatConfigCjsPath = path.join(process.cwd(), \"eslint.config.cjs\");\n\n      const hasFlatConfig =\n        fs.existsSync(flatConfigPath) ||\n        fs.existsSync(flatConfigMjsPath) ||\n        fs.existsSync(flatConfigCjsPath);\n\n      if (!hasFlatConfig) {\n        // No flat config found, skip initialization\n        this.initialized = true;\n        return this;\n      }\n\n      // Use new ESLint v9 API with flat config\n      // ESLint will automatically find eslint.config.js in the project root\n      this.eslint = new ESLint({\n        cwd: process.cwd(),\n      });\n\n      this.initialized = true;\n    } catch (error) {\n      // Handle any errors during initialization gracefully\n      console.warn(\"ESLint Health Checker: Failed to initialize:\", error);\n      this.initialized = true; // Mark as initialized to prevent retries\n    }\n\n    return this;\n  }\n\n  /**\n   * Display health check results in a pretty format\n   */\n  private displayResults(file: FileManager, result: FileHealthResult): void {\n    const stats = result.getStats();\n\n    // Only display if there are errors or warnings\n    if (stats.errors === 0 && stats.warnings === 0) {\n      return;\n    }\n\n    const fileName = file.relativePath.replace(/\\\\/g, \"/\");\n    const errorCount = stats.errors;\n    const warningCount = stats.warnings;\n    const sourceLines = file.source ? file.source.split(\"\\n\") : [];\n\n    // Display errors\n    if (errorCount > 0) {\n      const errorMessages = result.messages.filter((m) => m.type === \"error\");\n      for (const error of errorMessages) {\n        const icon = colors.redBright(\"✖\");\n        const level = colors.redBright(colors.bold(\"ERROR\"));\n        console.log(\n          `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${error.lineNumber},${error.columnNumber})`)}`,\n        );\n        // Get rule ID from the error if available\n        const ruleId = error.ruleId || \"eslint\";\n        console.log(\n          `  ${colors.magentaBright(ruleId)} ${colors.dim(\"→\")} ${colors.red(error.message)}`,\n        );\n\n        // Display code line with underline indicator\n        if (\n          sourceLines.length > 0 &&\n          error.lineNumber > 0 &&\n          error.lineNumber <= sourceLines.length\n        ) {\n          const lineIndex = error.lineNumber - 1; // Convert to 0-based index\n          const lineContent = sourceLines[lineIndex];\n          const lineNum = error.lineNumber.toString().padStart(4, \" \");\n          const errorLength = error.length || 1;\n          const columnIndex = error.columnNumber - 1; // Convert to 0-based index\n\n          // Display the line with normal color (not all red)\n          console.log(`  ${colors.dim(lineNum)} ${colors.dim(\"│\")} ${lineContent || \"\"}`);\n\n          // Display underline indicator\n          // Padding accounts for: lineNum.length + 1 space + 1 (│) + 1 space = lineNum.length + 3\n          // (The initial 2 spaces indent is already in the console.log)\n          const prefixPadding = lineNum.length + 3;\n          const columnPadding = \" \".repeat(columnIndex);\n          const underline = colors.redBright(\"~\".repeat(Math.max(1, errorLength)));\n          console.log(`  ${colors.dim(\" \".repeat(prefixPadding))}${columnPadding}${underline}`);\n        }\n      }\n    }\n\n    // Display warnings\n    if (warningCount > 0) {\n      const warningMessages = result.messages.filter((m) => m.type === \"warning\");\n      for (const warning of warningMessages) {\n        const icon = colors.yellowBright(\"⚠\");\n        const level = colors.yellowBright(colors.bold(\"WARNING\"));\n        console.log(\n          `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${warning.lineNumber},${warning.columnNumber})`)}`,\n        );\n        // Get rule ID from the warning if available\n        const ruleId = warning.ruleId || \"eslint\";\n        console.log(\n          `  ${colors.magentaBright(ruleId)} ${colors.dim(\"→\")} ${colors.yellow(warning.message)}`,\n        );\n\n        // Display code line with underline indicator\n        if (\n          sourceLines.length > 0 &&\n          warning.lineNumber > 0 &&\n          warning.lineNumber <= sourceLines.length\n        ) {\n          const lineIndex = warning.lineNumber - 1; // Convert to 0-based index\n          const lineContent = sourceLines[lineIndex];\n          const lineNum = warning.lineNumber.toString().padStart(4, \" \");\n          const warningLength = warning.length || 1;\n          const columnIndex = warning.columnNumber - 1; // Convert to 0-based index\n\n          // Display the line with normal color (not all yellow)\n          console.log(`  ${colors.dim(lineNum)} ${colors.dim(\"│\")} ${lineContent || \"\"}`);\n\n          // Display underline indicator\n          // Padding accounts for: lineNum.length + 1 space + 1 (│) + 1 space = lineNum.length + 3\n          // (The initial 2 spaces indent is already in the console.log)\n          const prefixPadding = lineNum.length + 3;\n          const columnPadding = \" \".repeat(columnIndex);\n          const underline = colors.yellowBright(\"~\".repeat(Math.max(1, warningLength)));\n          console.log(`  ${colors.dim(\" \".repeat(prefixPadding))}${columnPadding}${underline}`);\n        }\n      }\n    }\n\n    // Display summary\n    const summary = [];\n    if (errorCount > 0) {\n      summary.push(colors.red(`${errorCount} error${errorCount > 1 ? \"s\" : \"\"}`));\n    }\n    if (warningCount > 0) {\n      summary.push(colors.yellow(`${warningCount} warning${warningCount > 1 ? \"s\" : \"\"}`));\n    }\n  }\n\n  /**\n   * Validate the health of the file\n   */\n  public async validate(file: FileManager, result: FileHealthResult): Promise<FileHealthResult> {\n    // Early exit: skip non-lintable files\n    if (!this.isLintableFile(file.absolutePath)) {\n      result.markAsHealthy();\n      return result;\n    }\n\n    // Early exit: check if ESLint is available\n    if (!this.eslint) {\n      result.markAsHealthy();\n      return result;\n    }\n\n    try {\n      // Use lintText to lint the source code directly from FileManager\n      // This ensures we always use the latest content\n      const lintResults = await this.eslint.lintText(file.source, {\n        filePath: file.absolutePath,\n      });\n\n      if (lintResults.length === 0) {\n        console.log(\"No lint results\", file.relativePath);\n        result.markAsHealthy();\n        return result;\n      }\n\n      const lintResult = lintResults[0];\n\n      // Convert ESLint messages to FileHealthResult format\n      const errors: Array<{\n        message: string;\n        type: \"error\";\n        lineNumber: number;\n        columnNumber: number;\n        length: number;\n        ruleId?: string;\n      }> = [];\n      const warnings: Array<{\n        message: string;\n        type: \"warning\";\n        lineNumber: number;\n        columnNumber: number;\n        length: number;\n        ruleId?: string;\n      }> = [];\n\n      for (const message of lintResult.messages) {\n        const isError = message.severity === 2;\n        const isWarning = message.severity === 1;\n\n        if (isError) {\n          errors.push({\n            message: message.message,\n            type: \"error\",\n            lineNumber: message.line || 1,\n            columnNumber: message.column || 1,\n            length: message.endColumn && message.column ? message.endColumn - message.column : 1,\n            ruleId: message.ruleId || undefined,\n          });\n        } else if (isWarning) {\n          warnings.push({\n            message: message.message,\n            type: \"warning\",\n            lineNumber: message.line || 1,\n            columnNumber: message.column || 1,\n            length: message.endColumn && message.column ? message.endColumn - message.column : 1,\n            ruleId: message.ruleId || undefined,\n          });\n        }\n      }\n\n      // Add errors and warnings to result\n      if (errors.length > 0) {\n        result.addErrors(errors);\n      }\n\n      if (warnings.length > 0) {\n        result.addWarnings(warnings);\n      }\n\n      // If no errors or warnings, mark as healthy\n      if (errors.length === 0 && warnings.length === 0) {\n        result.markAsHealthy();\n      } else {\n        // Display results if there are errors or warnings\n        this.displayResults(file, result);\n      }\n    } catch (error) {\n      // Handle any errors during validation gracefully\n      console.log(\"ESlint Error:\", error);\n      result.markAsHealthy(); // Return healthy on error to avoid blocking\n    }\n\n    return result;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"eslint-health-checker.mjs","names":[],"sources":["../../../../../../../../../core/src/dev-server/health-checker/checkers/eslint-health-checker.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { ESLint } from \"eslint\";\nimport fs from \"fs\";\nimport path from \"path\";\nimport type { FileManager } from \"../../file-manager\";\nimport type { FileHealthCheckerContract } from \"../file-health-checker.contract\";\nimport { FileHealthResult } from \"../file-health-result\";\nimport { BaseHealthChecker } from \"./base-health-checker\";\n\nexport class EslintHealthChecker extends BaseHealthChecker implements FileHealthCheckerContract {\n  /**\n   * ESLint instance (using new ESLint v9 API with flat config)\n   */\n  private eslint: ESLint | null = null;\n\n  /**\n   * Health checker name\n   */\n  public name: string = \"ESLint\";\n\n  /**\n   * Path to dedicated worker file for ESLint checking\n   * Runs in a separate thread to avoid blocking the main dev server\n   */\n  public workerPath: string = \"./workers/eslint-health.worker\";\n\n  /**\n   * Whether checker is initialized\n   */\n  private initialized: boolean = false;\n\n  /**\n   * Check if file is a lintable file\n   */\n  private isLintableFile(filePath: string): boolean {\n    const ext = filePath.toLowerCase();\n    return (\n      ext.endsWith(\".ts\") || ext.endsWith(\".tsx\") || ext.endsWith(\".js\") || ext.endsWith(\".jsx\")\n    );\n  }\n\n  /**\n   * Initialize the health checker\n   */\n  public initialize(): EslintHealthChecker {\n    try {\n      // Check if eslint.config.js exists (new flat config format)\n      const flatConfigPath = path.join(process.cwd(), \"eslint.config.js\");\n      const flatConfigMjsPath = path.join(process.cwd(), \"eslint.config.mjs\");\n      const flatConfigCjsPath = path.join(process.cwd(), \"eslint.config.cjs\");\n\n      const hasFlatConfig =\n        fs.existsSync(flatConfigPath) ||\n        fs.existsSync(flatConfigMjsPath) ||\n        fs.existsSync(flatConfigCjsPath);\n\n      if (!hasFlatConfig) {\n        // No flat config found, skip initialization\n        this.initialized = true;\n        return this;\n      }\n\n      // Use new ESLint v9 API with flat config\n      // ESLint will automatically find eslint.config.js in the project root\n      this.eslint = new ESLint({\n        cwd: process.cwd(),\n      });\n\n      this.initialized = true;\n    } catch (error) {\n      // Handle any errors during initialization gracefully\n      console.warn(\"ESLint Health Checker: Failed to initialize:\", error);\n      this.initialized = true; // Mark as initialized to prevent retries\n    }\n\n    return this;\n  }\n\n  /**\n   * Display health check results in a pretty format\n   */\n  private displayResults(file: FileManager, result: FileHealthResult): void {\n    const stats = result.getStats();\n\n    // Only display if there are errors or warnings\n    if (stats.errors === 0 && stats.warnings === 0) {\n      return;\n    }\n\n    const fileName = file.relativePath.replace(/\\\\/g, \"/\");\n    const errorCount = stats.errors;\n    const warningCount = stats.warnings;\n    const sourceLines = file.source ? file.source.split(\"\\n\") : [];\n\n    // Display errors\n    if (errorCount > 0) {\n      const errorMessages = result.messages.filter((m) => m.type === \"error\");\n      for (const error of errorMessages) {\n        const icon = colors.redBright(\"✖\");\n        const level = colors.redBright(colors.bold(\"ERROR\"));\n        console.log(\n          `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${error.lineNumber},${error.columnNumber})`)}`,\n        );\n        // Get rule ID from the error if available\n        const ruleId = error.ruleId || \"eslint\";\n        console.log(\n          `  ${colors.magentaBright(ruleId)} ${colors.dim(\"→\")} ${colors.red(error.message)}`,\n        );\n\n        // Display code line with underline indicator\n        if (\n          sourceLines.length > 0 &&\n          error.lineNumber > 0 &&\n          error.lineNumber <= sourceLines.length\n        ) {\n          const lineIndex = error.lineNumber - 1; // Convert to 0-based index\n          const lineContent = sourceLines[lineIndex];\n          const lineNum = error.lineNumber.toString().padStart(4, \" \");\n          const errorLength = error.length || 1;\n          const columnIndex = error.columnNumber - 1; // Convert to 0-based index\n\n          // Display the line with normal color (not all red)\n          console.log(`  ${colors.dim(lineNum)} ${colors.dim(\"│\")} ${lineContent || \"\"}`);\n\n          // Display underline indicator\n          // Padding accounts for: lineNum.length + 1 space + 1 (│) + 1 space = lineNum.length + 3\n          // (The initial 2 spaces indent is already in the console.log)\n          const prefixPadding = lineNum.length + 3;\n          const columnPadding = \" \".repeat(columnIndex);\n          const underline = colors.redBright(\"~\".repeat(Math.max(1, errorLength)));\n          console.log(`  ${colors.dim(\" \".repeat(prefixPadding))}${columnPadding}${underline}`);\n        }\n      }\n    }\n\n    // Display warnings\n    if (warningCount > 0) {\n      const warningMessages = result.messages.filter((m) => m.type === \"warning\");\n      for (const warning of warningMessages) {\n        const icon = colors.yellowBright(\"⚠\");\n        const level = colors.yellowBright(colors.bold(\"WARNING\"));\n        console.log(\n          `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${warning.lineNumber},${warning.columnNumber})`)}`,\n        );\n        // Get rule ID from the warning if available\n        const ruleId = warning.ruleId || \"eslint\";\n        console.log(\n          `  ${colors.magentaBright(ruleId)} ${colors.dim(\"→\")} ${colors.yellow(warning.message)}`,\n        );\n\n        // Display code line with underline indicator\n        if (\n          sourceLines.length > 0 &&\n          warning.lineNumber > 0 &&\n          warning.lineNumber <= sourceLines.length\n        ) {\n          const lineIndex = warning.lineNumber - 1; // Convert to 0-based index\n          const lineContent = sourceLines[lineIndex];\n          const lineNum = warning.lineNumber.toString().padStart(4, \" \");\n          const warningLength = warning.length || 1;\n          const columnIndex = warning.columnNumber - 1; // Convert to 0-based index\n\n          // Display the line with normal color (not all yellow)\n          console.log(`  ${colors.dim(lineNum)} ${colors.dim(\"│\")} ${lineContent || \"\"}`);\n\n          // Display underline indicator\n          // Padding accounts for: lineNum.length + 1 space + 1 (│) + 1 space = lineNum.length + 3\n          // (The initial 2 spaces indent is already in the console.log)\n          const prefixPadding = lineNum.length + 3;\n          const columnPadding = \" \".repeat(columnIndex);\n          const underline = colors.yellowBright(\"~\".repeat(Math.max(1, warningLength)));\n          console.log(`  ${colors.dim(\" \".repeat(prefixPadding))}${columnPadding}${underline}`);\n        }\n      }\n    }\n\n    // Display summary\n    const summary = [];\n    if (errorCount > 0) {\n      summary.push(colors.red(`${errorCount} error${errorCount > 1 ? \"s\" : \"\"}`));\n    }\n    if (warningCount > 0) {\n      summary.push(colors.yellow(`${warningCount} warning${warningCount > 1 ? \"s\" : \"\"}`));\n    }\n  }\n\n  /**\n   * Validate the health of the file\n   */\n  public async validate(file: FileManager, result: FileHealthResult): Promise<FileHealthResult> {\n    // Early exit: skip non-lintable files\n    if (!this.isLintableFile(file.absolutePath)) {\n      result.markAsHealthy();\n      return result;\n    }\n\n    // Early exit: check if ESLint is available\n    if (!this.eslint) {\n      result.markAsHealthy();\n      return result;\n    }\n\n    try {\n      // Use lintText to lint the source code directly from FileManager\n      // This ensures we always use the latest content\n      const lintResults = await this.eslint.lintText(file.source, {\n        filePath: file.absolutePath,\n      });\n\n      if (lintResults.length === 0) {\n        console.log(\"No lint results\", file.relativePath);\n        result.markAsHealthy();\n        return result;\n      }\n\n      const lintResult = lintResults[0];\n\n      // Convert ESLint messages to FileHealthResult format\n      const errors: Array<{\n        message: string;\n        type: \"error\";\n        lineNumber: number;\n        columnNumber: number;\n        length: number;\n        ruleId?: string;\n      }> = [];\n      const warnings: Array<{\n        message: string;\n        type: \"warning\";\n        lineNumber: number;\n        columnNumber: number;\n        length: number;\n        ruleId?: string;\n      }> = [];\n\n      for (const message of lintResult.messages) {\n        const isError = message.severity === 2;\n        const isWarning = message.severity === 1;\n\n        if (isError) {\n          errors.push({\n            message: message.message,\n            type: \"error\",\n            lineNumber: message.line || 1,\n            columnNumber: message.column || 1,\n            length: message.endColumn && message.column ? message.endColumn - message.column : 1,\n            ruleId: message.ruleId || undefined,\n          });\n        } else if (isWarning) {\n          warnings.push({\n            message: message.message,\n            type: \"warning\",\n            lineNumber: message.line || 1,\n            columnNumber: message.column || 1,\n            length: message.endColumn && message.column ? message.endColumn - message.column : 1,\n            ruleId: message.ruleId || undefined,\n          });\n        }\n      }\n\n      // Add errors and warnings to result\n      if (errors.length > 0) {\n        result.addErrors(errors);\n      }\n\n      if (warnings.length > 0) {\n        result.addWarnings(warnings);\n      }\n\n      // If no errors or warnings, mark as healthy\n      if (errors.length === 0 && warnings.length === 0) {\n        result.markAsHealthy();\n      } else {\n        // Display results if there are errors or warnings\n        this.displayResults(file, result);\n      }\n    } catch (error) {\n      // Handle any errors during validation gracefully\n      console.log(\"ESlint Error:\", error);\n      result.markAsHealthy(); // Return healthy on error to avoid blocking\n    }\n\n    return result;\n  }\n}\n"],"mappings":"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"}

package/esm/dev-server/health-checker/checkers/typescript-health-checker.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"typescript-health-checker.mjs","names":[],"sources":["../../../../../../../../../core/src/dev-server/health-checker/checkers/typescript-health-checker.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport ts from \"typescript\";\nimport { FileManager } from \"../../file-manager\";\nimport { tsconfigManager } from \"../../tsconfig-manager\";\nimport { FileHealthCheckerContract } from \"../file-health-checker.contract\";\nimport { FileHealthResult } from \"../file-health-result\";\nimport { BaseHealthChecker } from \"./base-health-checker\";\n\nexport class TypescriptHealthChecker\n  extends BaseHealthChecker\n  implements FileHealthCheckerContract\n{\n  /**\n   * Cached TypeScript program instance\n   */\n  private program: ts.Program | null = null;\n\n  /**\n   * Cached parsed TypeScript configuration\n   */\n  private parsedConfig: ts.ParsedCommandLine | null = null;\n\n  /**\n   * Health checker name\n   */\n  public name: string = \"TypeScript\";\n\n  /**\n   * Path to dedicated worker file for TypeScript checking\n   * Runs in a separate thread to avoid blocking the main dev server\n   */\n  public workerPath: string = \"./workers/ts-health.worker\";\n\n  /**\n   * Whether checker is initialized\n   */\n  private initialized: boolean = false;\n\n  /**\n   * Check if file is a TypeScript file\n   */\n  private isTypeScriptFile(filePath: string): boolean {\n    const ext = filePath.toLowerCase();\n    return ext.endsWith(\".ts\") || ext.endsWith(\".tsx\");\n  }\n\n  /**\n   * Extract line and column from diagnostic location\n   */\n  private getDiagnosticLocation(diagnostic: ts.Diagnostic): {\n    lineNumber: number;\n    columnNumber: number;\n  } {\n    if (diagnostic.file && diagnostic.start !== undefined) {\n      const { line, character } = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);\n      return {\n        lineNumber: line + 1, // TypeScript uses 0-based, we use 1-based\n        columnNumber: character + 1,\n      };\n    }\n    return {\n      lineNumber: 1,\n      columnNumber: 1,\n    };\n  }\n\n  /**\n   * Format diagnostic message\n   */\n  private formatDiagnosticMessage(diagnostic: ts.Diagnostic): string {\n    if (diagnostic.file && diagnostic.start !== undefined) {\n      return ts.formatDiagnostic(diagnostic, {\n        getCurrentDirectory: () => process.cwd(),\n        getCanonicalFileName: (fileName) => fileName,\n        getNewLine: () => \"\\n\",\n      });\n    }\n    return diagnostic.messageText.toString();\n  }\n\n  /**\n   * Display health check results in a pretty format\n   */\n  private displayResults(file: FileManager, result: FileHealthResult): void {\n    const stats = result.getStats();\n\n    // Only display if there are errors or warnings\n    if (stats.errors === 0 && stats.warnings === 0) {\n      return;\n    }\n\n    const fileName = file.relativePath.replace(/\\\\/g, \"/\");\n    const errorCount = stats.errors;\n    const warningCount = stats.warnings;\n    const sourceLines = file.source ? file.source.split(\"\\n\") : [];\n\n    // Display header\n    // console.log(\n    //   `\\n${colors.dim(\"╭─\")} ${colors.bold(colors.cyanBright(\"TypeScript Health\"))} ${colors.dim(\"→\")} ${colors.cyan(fileName)}`,\n    // );\n\n    // Display errors\n    if (errorCount > 0) {\n      const errorMessages = result.messages.filter((m) => m.type === \"error\");\n      for (const error of errorMessages) {\n        const icon = colors.redBright(\"✖\");\n        const level = colors.redBright(colors.bold(\"ERROR\"));\n        console.log(\n          `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${error.lineNumber},${error.columnNumber})`)}`,\n        );\n        // Extract just the message text (remove file path prefix if present)\n        const messageLines = error.message.split(\"\\n\");\n        const cleanMessage = messageLines\n          .map((line) => line.replace(/^[^:]+:\\d+:\\d+ - /, \"\").trim())\n          .filter((line) => line.length > 0)\n          .join(\"\\n\");\n        console.log(`  ${colors.dim(\"→\")} ${colors.red(cleanMessage)}`);\n\n        // Display code line with underline indicator\n        if (\n          sourceLines.length > 0 &&\n          error.lineNumber > 0 &&\n          error.lineNumber <= sourceLines.length\n        ) {\n          const lineIndex = error.lineNumber - 1; // Convert to 0-based index\n          const lineContent = sourceLines[lineIndex];\n          const lineNum = error.lineNumber.toString().padStart(4, \" \");\n          const errorLength = error.length || 1;\n          const columnIndex = error.columnNumber - 1; // Convert to 0-based index\n\n          // Display the line with normal color (not all red)\n          console.log(`  ${colors.dim(lineNum)} ${colors.dim(\"│\")} ${lineContent || \"\"}`);\n\n          // Display underline indicator\n          // Padding accounts for: lineNum.length + 1 space + 1 (│) + 1 space = lineNum.length + 3\n          // (The initial 2 spaces indent is already in the console.log)\n          const prefixPadding = lineNum.length + 3;\n          const columnPadding = \" \".repeat(columnIndex);\n          const underline = colors.redBright(\"~\".repeat(Math.max(1, errorLength)));\n          console.log(`  ${colors.dim(\" \".repeat(prefixPadding))}${columnPadding}${underline}`);\n        }\n      }\n    }\n\n    // Display warnings\n    if (warningCount > 0) {\n      const warningMessages = result.messages.filter((m) => m.type === \"warning\");\n      for (const warning of warningMessages) {\n        const icon = colors.yellowBright(\"⚠\");\n        const level = colors.yellowBright(colors.bold(\"WARNING\"));\n        console.log(\n          `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${warning.lineNumber},${warning.columnNumber})`)}`,\n        );\n        // Extract just the message text (remove file path prefix if present)\n        const messageLines = warning.message.split(\"\\n\");\n        const cleanMessage = messageLines\n          .map((line) => line.replace(/^[^:]+:\\d+:\\d+ - /, \"\").trim())\n          .filter((line) => line.length > 0)\n          .join(\"\\n\");\n        console.log(`  ${colors.dim(\"→\")} ${colors.yellow(cleanMessage)}`);\n\n        // Display code line with underline indicator\n        if (\n          sourceLines.length > 0 &&\n          warning.lineNumber > 0 &&\n          warning.lineNumber <= sourceLines.length\n        ) {\n          const lineIndex = warning.lineNumber - 1; // Convert to 0-based index\n          const lineContent = sourceLines[lineIndex];\n          const lineNum = warning.lineNumber.toString().padStart(4, \" \");\n          const warningLength = warning.length || 1;\n          const columnIndex = warning.columnNumber - 1; // Convert to 0-based index\n\n          // Display the line with normal color (not all yellow)\n          console.log(`  ${colors.dim(lineNum)} ${colors.dim(\"│\")} ${lineContent || \"\"}`);\n\n          // Display underline indicator\n          // Padding accounts for: lineNum.length + 1 space + 1 (│) + 1 space = lineNum.length + 3\n          // (The initial 2 spaces indent is already in the console.log)\n          const prefixPadding = lineNum.length + 3;\n          const columnPadding = \" \".repeat(columnIndex);\n          const underline = colors.yellowBright(\"~\".repeat(Math.max(1, warningLength)));\n          console.log(`  ${colors.dim(\" \".repeat(prefixPadding))}${columnPadding}${underline}`);\n        }\n      }\n    }\n\n    // Display summary\n    const summary = [];\n    if (errorCount > 0) {\n      summary.push(colors.red(`${errorCount} error${errorCount > 1 ? \"s\" : \"\"}`));\n    }\n    if (warningCount > 0) {\n      summary.push(colors.yellow(`${warningCount} warning${warningCount > 1 ? \"s\" : \"\"}`));\n    }\n\n    // console.log(\n    //   `\\n${colors.dim(\"╰─\")} ${colors.bold(\"TypeScript\")} ${colors.dim(\"→\")} ${summary.join(colors.dim(\" and \"))}`,\n    // );\n  }\n\n  /**\n   * Detect when files are changed\n   */\n  public async onFileChanges(files: FileManager[]): Promise<void> {\n    // recreate an incremental program\n    if (!this.parsedConfig) {\n      return;\n    }\n\n    this.program = ts.createProgram(\n      files.map((file) => file.absolutePath),\n      {\n        ...this.parsedConfig.options,\n        incremental: true,\n      },\n      undefined,\n      this.program!,\n    );\n  }\n\n  /**\n   * Initialize the health checker\n   */\n  public initialize(): TypescriptHealthChecker {\n    try {\n      // Verify tsconfigManager is initialized and has config\n      if (!tsconfigManager.tsconfig || Object.keys(tsconfigManager.tsconfig).length === 0) {\n        this.initialized = true;\n        return this;\n      }\n\n      // Parse the config using tsconfigManager's cached config\n      this.parsedConfig = ts.parseJsonConfigFileContent(\n        tsconfigManager.tsconfig,\n        ts.sys,\n        process.cwd(),\n      );\n\n      // Check for config errors\n      if (this.parsedConfig.errors.length > 0) {\n        // Log config errors but continue (will skip validation)\n        console.warn(\n          \"TypeScript Health Checker: tsconfig.json has errors:\",\n          this.parsedConfig.errors.map((e) => ts.formatDiagnostic(e, ts.createCompilerHost({}))),\n        );\n      }\n\n      this.program = ts.createProgram(this.parsedConfig.fileNames, this.parsedConfig.options);\n\n      this.initialized = true;\n    } catch (error) {\n      // Handle any errors during initialization gracefully\n      console.warn(\"TypeScript Health Checker: Failed to initialize:\", error);\n      this.initialized = true; // Mark as initialized to prevent retries\n    }\n\n    return this;\n  }\n\n  /**\n   * Validate the health of the file\n   */\n  public async validate(file: FileManager, result: FileHealthResult): Promise<FileHealthResult> {\n    // Early exit: skip non-TypeScript files\n    if (!this.isTypeScriptFile(file.absolutePath)) {\n      result.markAsHealthy();\n      return result;\n    }\n\n    // Early exit: check if parsed config is available\n    if (!this.parsedConfig) {\n      result.markAsHealthy();\n      return result;\n    }\n\n    try {\n      // Lazy-load program on first validation if not already created\n      if (!this.program) {\n        // Create program with all project files from parsed config (for proper type checking)\n        this.program = ts.createProgram(this.parsedConfig.fileNames, this.parsedConfig.options);\n      }\n\n      // Get source file from program\n      const sourceFile = this.program.getSourceFile(file.absolutePath);\n\n      // If file is not in the program, return healthy (might be excluded)\n      if (!sourceFile) {\n        result.markAsHealthy();\n        return result;\n      }\n\n      // Get diagnostics for the specific file only\n      const syntacticDiagnostics = this.program.getSyntacticDiagnostics(sourceFile);\n      const semanticDiagnostics = this.program.getSemanticDiagnostics(sourceFile);\n\n      // Combine all diagnostics\n      const allDiagnostics = [...syntacticDiagnostics, ...semanticDiagnostics];\n\n      // Convert TypeScript diagnostics to FileHealthResult format\n      const errors: Array<{\n        message: string;\n        type: \"error\";\n        lineNumber: number;\n        columnNumber: number;\n        length: number;\n      }> = [];\n      const warnings: Array<{\n        message: string;\n        type: \"warning\";\n        lineNumber: number;\n        columnNumber: number;\n        length: number;\n      }> = [];\n\n      for (const diagnostic of allDiagnostics) {\n        const location = this.getDiagnosticLocation(diagnostic);\n        const message = this.formatDiagnosticMessage(diagnostic);\n        const errorLength = diagnostic.length || 1;\n\n        if (diagnostic.category === ts.DiagnosticCategory.Error) {\n          errors.push({\n            message,\n            type: \"error\",\n            lineNumber: location.lineNumber,\n            columnNumber: location.columnNumber,\n            length: errorLength,\n          });\n        } else if (diagnostic.category === ts.DiagnosticCategory.Warning) {\n          warnings.push({\n            message,\n            type: \"warning\",\n            lineNumber: location.lineNumber,\n            columnNumber: location.columnNumber,\n            length: errorLength,\n          });\n        }\n      }\n\n      // Add errors and warnings to result\n      if (errors.length > 0) {\n        result.addErrors(errors);\n      }\n      if (warnings.length > 0) {\n        result.addWarnings(warnings);\n      }\n\n      // If no errors or warnings, mark as healthy\n      if (errors.length === 0 && warnings.length === 0) {\n        result.markAsHealthy();\n      } else {\n        // Display results if there are errors or warnings\n        this.displayResults(file, result);\n      }\n    } catch (error) {\n      // Handle any errors during validation gracefully\n      console.warn(`TypeScript Health Checker: Error validating file ${file.relativePath}:`, error);\n      result.markAsHealthy(); // Return healthy on error to avoid blocking\n    }\n\n    return result;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"typescript-health-checker.mjs","names":[],"sources":["../../../../../../../../../core/src/dev-server/health-checker/checkers/typescript-health-checker.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport ts from \"typescript\";\nimport type { FileManager } from \"../../file-manager\";\nimport { tsconfigManager } from \"../../tsconfig-manager\";\nimport type { FileHealthCheckerContract } from \"../file-health-checker.contract\";\nimport { FileHealthResult } from \"../file-health-result\";\nimport { BaseHealthChecker } from \"./base-health-checker\";\n\nexport class TypescriptHealthChecker\n  extends BaseHealthChecker\n  implements FileHealthCheckerContract\n{\n  /**\n   * Cached TypeScript program instance\n   */\n  private program: ts.Program | null = null;\n\n  /**\n   * Cached parsed TypeScript configuration\n   */\n  private parsedConfig: ts.ParsedCommandLine | null = null;\n\n  /**\n   * Health checker name\n   */\n  public name: string = \"TypeScript\";\n\n  /**\n   * Path to dedicated worker file for TypeScript checking\n   * Runs in a separate thread to avoid blocking the main dev server\n   */\n  public workerPath: string = \"./workers/ts-health.worker\";\n\n  /**\n   * Whether checker is initialized\n   */\n  private initialized: boolean = false;\n\n  /**\n   * Check if file is a TypeScript file\n   */\n  private isTypeScriptFile(filePath: string): boolean {\n    const ext = filePath.toLowerCase();\n    return ext.endsWith(\".ts\") || ext.endsWith(\".tsx\");\n  }\n\n  /**\n   * Extract line and column from diagnostic location\n   */\n  private getDiagnosticLocation(diagnostic: ts.Diagnostic): {\n    lineNumber: number;\n    columnNumber: number;\n  } {\n    if (diagnostic.file && diagnostic.start !== undefined) {\n      const { line, character } = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);\n      return {\n        lineNumber: line + 1, // TypeScript uses 0-based, we use 1-based\n        columnNumber: character + 1,\n      };\n    }\n    return {\n      lineNumber: 1,\n      columnNumber: 1,\n    };\n  }\n\n  /**\n   * Format diagnostic message\n   */\n  private formatDiagnosticMessage(diagnostic: ts.Diagnostic): string {\n    if (diagnostic.file && diagnostic.start !== undefined) {\n      return ts.formatDiagnostic(diagnostic, {\n        getCurrentDirectory: () => process.cwd(),\n        getCanonicalFileName: (fileName) => fileName,\n        getNewLine: () => \"\\n\",\n      });\n    }\n    return diagnostic.messageText.toString();\n  }\n\n  /**\n   * Display health check results in a pretty format\n   */\n  private displayResults(file: FileManager, result: FileHealthResult): void {\n    const stats = result.getStats();\n\n    // Only display if there are errors or warnings\n    if (stats.errors === 0 && stats.warnings === 0) {\n      return;\n    }\n\n    const fileName = file.relativePath.replace(/\\\\/g, \"/\");\n    const errorCount = stats.errors;\n    const warningCount = stats.warnings;\n    const sourceLines = file.source ? file.source.split(\"\\n\") : [];\n\n    // Display header\n    // console.log(\n    //   `\\n${colors.dim(\"╭─\")} ${colors.bold(colors.cyanBright(\"TypeScript Health\"))} ${colors.dim(\"→\")} ${colors.cyan(fileName)}`,\n    // );\n\n    // Display errors\n    if (errorCount > 0) {\n      const errorMessages = result.messages.filter((m) => m.type === \"error\");\n      for (const error of errorMessages) {\n        const icon = colors.redBright(\"✖\");\n        const level = colors.redBright(colors.bold(\"ERROR\"));\n        console.log(\n          `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${error.lineNumber},${error.columnNumber})`)}`,\n        );\n        // Extract just the message text (remove file path prefix if present)\n        const messageLines = error.message.split(\"\\n\");\n        const cleanMessage = messageLines\n          .map((line) => line.replace(/^[^:]+:\\d+:\\d+ - /, \"\").trim())\n          .filter((line) => line.length > 0)\n          .join(\"\\n\");\n        console.log(`  ${colors.dim(\"→\")} ${colors.red(cleanMessage)}`);\n\n        // Display code line with underline indicator\n        if (\n          sourceLines.length > 0 &&\n          error.lineNumber > 0 &&\n          error.lineNumber <= sourceLines.length\n        ) {\n          const lineIndex = error.lineNumber - 1; // Convert to 0-based index\n          const lineContent = sourceLines[lineIndex];\n          const lineNum = error.lineNumber.toString().padStart(4, \" \");\n          const errorLength = error.length || 1;\n          const columnIndex = error.columnNumber - 1; // Convert to 0-based index\n\n          // Display the line with normal color (not all red)\n          console.log(`  ${colors.dim(lineNum)} ${colors.dim(\"│\")} ${lineContent || \"\"}`);\n\n          // Display underline indicator\n          // Padding accounts for: lineNum.length + 1 space + 1 (│) + 1 space = lineNum.length + 3\n          // (The initial 2 spaces indent is already in the console.log)\n          const prefixPadding = lineNum.length + 3;\n          const columnPadding = \" \".repeat(columnIndex);\n          const underline = colors.redBright(\"~\".repeat(Math.max(1, errorLength)));\n          console.log(`  ${colors.dim(\" \".repeat(prefixPadding))}${columnPadding}${underline}`);\n        }\n      }\n    }\n\n    // Display warnings\n    if (warningCount > 0) {\n      const warningMessages = result.messages.filter((m) => m.type === \"warning\");\n      for (const warning of warningMessages) {\n        const icon = colors.yellowBright(\"⚠\");\n        const level = colors.yellowBright(colors.bold(\"WARNING\"));\n        console.log(\n          `\\n${icon} ${level} ${colors.dim(\"in\")} ${colors.cyanBright(fileName)}${colors.dim(`(${warning.lineNumber},${warning.columnNumber})`)}`,\n        );\n        // Extract just the message text (remove file path prefix if present)\n        const messageLines = warning.message.split(\"\\n\");\n        const cleanMessage = messageLines\n          .map((line) => line.replace(/^[^:]+:\\d+:\\d+ - /, \"\").trim())\n          .filter((line) => line.length > 0)\n          .join(\"\\n\");\n        console.log(`  ${colors.dim(\"→\")} ${colors.yellow(cleanMessage)}`);\n\n        // Display code line with underline indicator\n        if (\n          sourceLines.length > 0 &&\n          warning.lineNumber > 0 &&\n          warning.lineNumber <= sourceLines.length\n        ) {\n          const lineIndex = warning.lineNumber - 1; // Convert to 0-based index\n          const lineContent = sourceLines[lineIndex];\n          const lineNum = warning.lineNumber.toString().padStart(4, \" \");\n          const warningLength = warning.length || 1;\n          const columnIndex = warning.columnNumber - 1; // Convert to 0-based index\n\n          // Display the line with normal color (not all yellow)\n          console.log(`  ${colors.dim(lineNum)} ${colors.dim(\"│\")} ${lineContent || \"\"}`);\n\n          // Display underline indicator\n          // Padding accounts for: lineNum.length + 1 space + 1 (│) + 1 space = lineNum.length + 3\n          // (The initial 2 spaces indent is already in the console.log)\n          const prefixPadding = lineNum.length + 3;\n          const columnPadding = \" \".repeat(columnIndex);\n          const underline = colors.yellowBright(\"~\".repeat(Math.max(1, warningLength)));\n          console.log(`  ${colors.dim(\" \".repeat(prefixPadding))}${columnPadding}${underline}`);\n        }\n      }\n    }\n\n    // Display summary\n    const summary = [];\n    if (errorCount > 0) {\n      summary.push(colors.red(`${errorCount} error${errorCount > 1 ? \"s\" : \"\"}`));\n    }\n    if (warningCount > 0) {\n      summary.push(colors.yellow(`${warningCount} warning${warningCount > 1 ? \"s\" : \"\"}`));\n    }\n\n    // console.log(\n    //   `\\n${colors.dim(\"╰─\")} ${colors.bold(\"TypeScript\")} ${colors.dim(\"→\")} ${summary.join(colors.dim(\" and \"))}`,\n    // );\n  }\n\n  /**\n   * Detect when files are changed\n   */\n  public async onFileChanges(files: FileManager[]): Promise<void> {\n    // recreate an incremental program\n    if (!this.parsedConfig) {\n      return;\n    }\n\n    this.program = ts.createProgram(\n      files.map((file) => file.absolutePath),\n      {\n        ...this.parsedConfig.options,\n        incremental: true,\n      },\n      undefined,\n      this.program!,\n    );\n  }\n\n  /**\n   * Initialize the health checker\n   */\n  public initialize(): TypescriptHealthChecker {\n    try {\n      // Verify tsconfigManager is initialized and has config\n      if (!tsconfigManager.tsconfig || Object.keys(tsconfigManager.tsconfig).length === 0) {\n        this.initialized = true;\n        return this;\n      }\n\n      // Parse the config using tsconfigManager's cached config\n      this.parsedConfig = ts.parseJsonConfigFileContent(\n        tsconfigManager.tsconfig,\n        ts.sys,\n        process.cwd(),\n      );\n\n      // Check for config errors\n      if (this.parsedConfig.errors.length > 0) {\n        // Log config errors but continue (will skip validation)\n        console.warn(\n          \"TypeScript Health Checker: tsconfig.json has errors:\",\n          this.parsedConfig.errors.map((e) => ts.formatDiagnostic(e, ts.createCompilerHost({}))),\n        );\n      }\n\n      this.program = ts.createProgram(this.parsedConfig.fileNames, this.parsedConfig.options);\n\n      this.initialized = true;\n    } catch (error) {\n      // Handle any errors during initialization gracefully\n      console.warn(\"TypeScript Health Checker: Failed to initialize:\", error);\n      this.initialized = true; // Mark as initialized to prevent retries\n    }\n\n    return this;\n  }\n\n  /**\n   * Validate the health of the file\n   */\n  public async validate(file: FileManager, result: FileHealthResult): Promise<FileHealthResult> {\n    // Early exit: skip non-TypeScript files\n    if (!this.isTypeScriptFile(file.absolutePath)) {\n      result.markAsHealthy();\n      return result;\n    }\n\n    // Early exit: check if parsed config is available\n    if (!this.parsedConfig) {\n      result.markAsHealthy();\n      return result;\n    }\n\n    try {\n      // Lazy-load program on first validation if not already created\n      if (!this.program) {\n        // Create program with all project files from parsed config (for proper type checking)\n        this.program = ts.createProgram(this.parsedConfig.fileNames, this.parsedConfig.options);\n      }\n\n      // Get source file from program\n      const sourceFile = this.program.getSourceFile(file.absolutePath);\n\n      // If file is not in the program, return healthy (might be excluded)\n      if (!sourceFile) {\n        result.markAsHealthy();\n        return result;\n      }\n\n      // Get diagnostics for the specific file only\n      const syntacticDiagnostics = this.program.getSyntacticDiagnostics(sourceFile);\n      const semanticDiagnostics = this.program.getSemanticDiagnostics(sourceFile);\n\n      // Combine all diagnostics\n      const allDiagnostics = [...syntacticDiagnostics, ...semanticDiagnostics];\n\n      // Convert TypeScript diagnostics to FileHealthResult format\n      const errors: Array<{\n        message: string;\n        type: \"error\";\n        lineNumber: number;\n        columnNumber: number;\n        length: number;\n      }> = [];\n      const warnings: Array<{\n        message: string;\n        type: \"warning\";\n        lineNumber: number;\n        columnNumber: number;\n        length: number;\n      }> = [];\n\n      for (const diagnostic of allDiagnostics) {\n        const location = this.getDiagnosticLocation(diagnostic);\n        const message = this.formatDiagnosticMessage(diagnostic);\n        const errorLength = diagnostic.length || 1;\n\n        if (diagnostic.category === ts.DiagnosticCategory.Error) {\n          errors.push({\n            message,\n            type: \"error\",\n            lineNumber: location.lineNumber,\n            columnNumber: location.columnNumber,\n            length: errorLength,\n          });\n        } else if (diagnostic.category === ts.DiagnosticCategory.Warning) {\n          warnings.push({\n            message,\n            type: \"warning\",\n            lineNumber: location.lineNumber,\n            columnNumber: location.columnNumber,\n            length: errorLength,\n          });\n        }\n      }\n\n      // Add errors and warnings to result\n      if (errors.length > 0) {\n        result.addErrors(errors);\n      }\n      if (warnings.length > 0) {\n        result.addWarnings(warnings);\n      }\n\n      // If no errors or warnings, mark as healthy\n      if (errors.length === 0 && warnings.length === 0) {\n        result.markAsHealthy();\n      } else {\n        // Display results if there are errors or warnings\n        this.displayResults(file, result);\n      }\n    } catch (error) {\n      // Handle any errors during validation gracefully\n      console.warn(`TypeScript Health Checker: Error validating file ${file.relativePath}:`, error);\n      result.markAsHealthy(); // Return healthy on error to avoid blocking\n    }\n\n    return result;\n  }\n}\n"],"mappings":"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"}

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

@@ -1,4 +1,6 @@
 import { devLogError, devServeLog } from "./dev-logger.mjs";
+import "./supervisor.mjs";
+import { isBootPreconditionError } from "./boot-precondition-error.mjs";
 import { DevelopmentServer } from "./development-server.mjs";
 import { registerDevShortcuts } from "./register-dev-shortcuts.mjs";
 import { colors } from "@mongez/copper";
@@ -24,7 +26,7 @@ async function startDevelopmentServer(options = {}) {
 	} catch (error) {
 		devLogError(`Failed to start Development Server: ${error.message}`);
 		await safeShutdown(devServer);
-		process.exit(1);
+		process.exit(isBootPreconditionError(error) ? 78 : 1);
 	}
 	registerDevShortcuts(devServer);
 	return devServer;

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

@@ -1 +1 @@
-{"version":3,"file":"start-development-server.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/start-development-server.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { devLogError, devServeLog } from \"./dev-logger\";\nimport { DevelopmentServer } from \"./development-server\";\nimport { registerDevShortcuts } from \"./register-dev-shortcuts\";\n\nlet handlersRegistered = false;\n\n/**\n * Options accepted by `startDevelopmentServer`. CLI flags translate to\n * these; programmatic callers (tests, scripts) can pass them directly.\n *\n * `undefined` for any field means \"fall through to `warlock.config.ts >\n * devServer.*` defaults.\" Pass an explicit value only to override.\n */\nexport type StartDevServerOptions = {\n  /**\n   * Delete `.warlock/manifest.json` before starting — forces every file\n   * to be re-parsed from disk instead of restored from the cached graph.\n   */\n  fresh?: boolean;\n  /** Run background type generation. Default from devServer config (true). */\n  generateTypings?: boolean;\n  /** Run file health checkers. Default from devServer config (true). */\n  healthCheckers?: boolean;\n};\n\n/**\n * Start the development server.\n *\n * Boots the file orchestrator, loads app modules, starts late-phase\n * connectors, then wires graceful shutdown for SIGINT/SIGTERM (plus\n * SIGHUP on Windows where Ctrl+C in spawned children lands as SIGHUP).\n *\n * If startup throws, shuts down cleanly and exits 1 — dev should die\n * loudly rather than hang with a half-initialized state.\n */\nexport async function startDevelopmentServer(\n  options: StartDevServerOptions = {},\n): Promise<DevelopmentServer> {\n  // V8 honours inline source maps embedded by the transpile cache (and\n  // tsx's own maps in passthrough mode), so thrown-error stack frames point\n  // at the original `src/**.ts` line/column instead of transpiled output.\n  process.setSourceMapsEnabled(true);\n\n  const devServer = new DevelopmentServer(options);\n\n  registerShutdownHandlers(devServer);\n\n  try {\n    await devServer.start();\n  } catch (error) {\n    devLogError(`Failed to start Development Server: ${(error as Error).message}`);\n    await safeShutdown(devServer);\n    process.exit(1);\n  }\n\n  // Only once the server is actually up — a half-started process has nothing\n  // worth restarting, and taking raw mode before then would swallow the\n  // Ctrl+C of a developer trying to escape a slow boot.\n  registerDevShortcuts(devServer);\n\n  return devServer;\n}\n\n/**\n * Register signal handlers once per process. Guards against handler\n * accumulation if `startDevelopmentServer` is invoked more than once\n * (tests, programmatic restart).\n */\nfunction registerShutdownHandlers(devServer: DevelopmentServer): void {\n  if (handlersRegistered) return;\n  handlersRegistered = true;\n\n  const onSignal = (signal: NodeJS.Signals) => async () => {\n    devServeLog(colors.yellow(`📡 Received ${signal}`));\n    const ok = await safeShutdown(devServer);\n    process.exit(ok ? 0 : 1);\n  };\n\n  process.on(\"SIGINT\", onSignal(\"SIGINT\"));\n  process.on(\"SIGTERM\", onSignal(\"SIGTERM\"));\n  // Ctrl+C in spawned Windows children lands as SIGHUP, not SIGINT.\n  if (process.platform === \"win32\") {\n    process.on(\"SIGHUP\", onSignal(\"SIGHUP\"));\n  }\n}\n\n/**\n * Shut down the dev server without swallowing async errors. Returns\n * whether shutdown completed cleanly so the caller picks the exit code.\n */\nasync function safeShutdown(devServer: DevelopmentServer): Promise<boolean> {\n  try {\n    await devServer.shutdown();\n    return true;\n  } catch (error) {\n    devLogError(`Shutdown failed: ${(error as Error).message}`);\n    return false;\n  }\n}\n"],"mappings":";;;;;;AAKA,IAAI,qBAAqB;;;;;;;;;;;AA+BzB,eAAsB,uBACpB,UAAiC,CAAC,GACN;CAI5B,QAAQ,qBAAqB,IAAI;CAEjC,MAAM,YAAY,IAAI,kBAAkB,OAAO;CAE/C,yBAAyB,SAAS;CAElC,IAAI;EACF,MAAM,UAAU,MAAM;CACxB,SAAS,OAAO;EACd,YAAY,uCAAwC,MAAgB,SAAS;EAC7E,MAAM,aAAa,SAAS;EAC5B,QAAQ,KAAK,CAAC;CAChB;CAKA,qBAAqB,SAAS;CAE9B,OAAO;AACT;;;;;;AAOA,SAAS,yBAAyB,WAAoC;CACpE,IAAI,oBAAoB;CACxB,qBAAqB;CAErB,MAAM,YAAY,WAA2B,YAAY;EACvD,YAAY,OAAO,OAAO,eAAe,QAAQ,CAAC;EAClD,MAAM,KAAK,MAAM,aAAa,SAAS;EACvC,QAAQ,KAAK,KAAK,IAAI,CAAC;CACzB;CAEA,QAAQ,GAAG,UAAU,SAAS,QAAQ,CAAC;CACvC,QAAQ,GAAG,WAAW,SAAS,SAAS,CAAC;CAEzC,IAAI,QAAQ,aAAa,SACvB,QAAQ,GAAG,UAAU,SAAS,QAAQ,CAAC;AAE3C;;;;;AAMA,eAAe,aAAa,WAAgD;CAC1E,IAAI;EACF,MAAM,UAAU,SAAS;EACzB,OAAO;CACT,SAAS,OAAO;EACd,YAAY,oBAAqB,MAAgB,SAAS;EAC1D,OAAO;CACT;AACF"}
+{"version":3,"file":"start-development-server.mjs","names":[],"sources":["../../../../../../../core/src/dev-server/start-development-server.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { isBootPreconditionError } from \"./boot-precondition-error\";\nimport { devLogError, devServeLog } from \"./dev-logger\";\nimport { DevelopmentServer } from \"./development-server\";\nimport { registerDevShortcuts } from \"./register-dev-shortcuts\";\nimport { BOOT_PRECONDITION_EXIT_CODE } from \"./supervisor\";\n\nlet handlersRegistered = false;\n\n/**\n * Options accepted by `startDevelopmentServer`. CLI flags translate to\n * these; programmatic callers (tests, scripts) can pass them directly.\n *\n * `undefined` for any field means \"fall through to `warlock.config.ts >\n * devServer.*` defaults.\" Pass an explicit value only to override.\n */\nexport type StartDevServerOptions = {\n  /**\n   * Delete `.warlock/manifest.json` before starting — forces every file\n   * to be re-parsed from disk instead of restored from the cached graph.\n   */\n  fresh?: boolean;\n  /** Run background type generation. Default from devServer config (true). */\n  generateTypings?: boolean;\n  /** Run file health checkers. Default from devServer config (true). */\n  healthCheckers?: boolean;\n};\n\n/**\n * Start the development server.\n *\n * Boots the file orchestrator, loads app modules, starts late-phase\n * connectors, then wires graceful shutdown for SIGINT/SIGTERM (plus\n * SIGHUP on Windows where Ctrl+C in spawned children lands as SIGHUP).\n *\n * If startup throws, shuts down cleanly and exits 1 — dev should die\n * loudly rather than hang with a half-initialized state.\n */\nexport async function startDevelopmentServer(\n  options: StartDevServerOptions = {},\n): Promise<DevelopmentServer> {\n  // V8 honours inline source maps embedded by the transpile cache (and\n  // tsx's own maps in passthrough mode), so thrown-error stack frames point\n  // at the original `src/**.ts` line/column instead of transpiled output.\n  process.setSourceMapsEnabled(true);\n\n  const devServer = new DevelopmentServer(options);\n\n  registerShutdownHandlers(devServer);\n\n  try {\n    await devServer.start();\n  } catch (error) {\n    devLogError(`Failed to start Development Server: ${(error as Error).message}`);\n    await safeShutdown(devServer);\n\n    // A boot-precondition failure (busy port, rejected validator, ...) has\n    // already printed a good message above — exit with the dedicated code so\n    // the supervisor treats it as terminal instead of restart-looping into\n    // the same failure. Every other error keeps exit 1, the ordinary\n    // restart-worthy path.\n    process.exit(isBootPreconditionError(error) ? BOOT_PRECONDITION_EXIT_CODE : 1);\n  }\n\n  // Only once the server is actually up — a half-started process has nothing\n  // worth restarting, and taking raw mode before then would swallow the\n  // Ctrl+C of a developer trying to escape a slow boot.\n  registerDevShortcuts(devServer);\n\n  return devServer;\n}\n\n/**\n * Register signal handlers once per process. Guards against handler\n * accumulation if `startDevelopmentServer` is invoked more than once\n * (tests, programmatic restart).\n */\nfunction registerShutdownHandlers(devServer: DevelopmentServer): void {\n  if (handlersRegistered) return;\n  handlersRegistered = true;\n\n  const onSignal = (signal: NodeJS.Signals) => async () => {\n    devServeLog(colors.yellow(`📡 Received ${signal}`));\n    const ok = await safeShutdown(devServer);\n    process.exit(ok ? 0 : 1);\n  };\n\n  process.on(\"SIGINT\", onSignal(\"SIGINT\"));\n  process.on(\"SIGTERM\", onSignal(\"SIGTERM\"));\n  // Ctrl+C in spawned Windows children lands as SIGHUP, not SIGINT.\n  if (process.platform === \"win32\") {\n    process.on(\"SIGHUP\", onSignal(\"SIGHUP\"));\n  }\n}\n\n/**\n * Shut down the dev server without swallowing async errors. Returns\n * whether shutdown completed cleanly so the caller picks the exit code.\n */\nasync function safeShutdown(devServer: DevelopmentServer): Promise<boolean> {\n  try {\n    await devServer.shutdown();\n    return true;\n  } catch (error) {\n    devLogError(`Shutdown failed: ${(error as Error).message}`);\n    return false;\n  }\n}\n"],"mappings":";;;;;;;;AAOA,IAAI,qBAAqB;;;;;;;;;;;AA+BzB,eAAsB,uBACpB,UAAiC,CAAC,GACN;CAI5B,QAAQ,qBAAqB,IAAI;CAEjC,MAAM,YAAY,IAAI,kBAAkB,OAAO;CAE/C,yBAAyB,SAAS;CAElC,IAAI;EACF,MAAM,UAAU,MAAM;CACxB,SAAS,OAAO;EACd,YAAY,uCAAwC,MAAgB,SAAS;EAC7E,MAAM,aAAa,SAAS;EAO5B,QAAQ,KAAK,wBAAwB,KAAK,SAAkC,CAAC;CAC/E;CAKA,qBAAqB,SAAS;CAE9B,OAAO;AACT;;;;;;AAOA,SAAS,yBAAyB,WAAoC;CACpE,IAAI,oBAAoB;CACxB,qBAAqB;CAErB,MAAM,YAAY,WAA2B,YAAY;EACvD,YAAY,OAAO,OAAO,eAAe,QAAQ,CAAC;EAClD,MAAM,KAAK,MAAM,aAAa,SAAS;EACvC,QAAQ,KAAK,KAAK,IAAI,CAAC;CACzB;CAEA,QAAQ,GAAG,UAAU,SAAS,QAAQ,CAAC;CACvC,QAAQ,GAAG,WAAW,SAAS,SAAS,CAAC;CAEzC,IAAI,QAAQ,aAAa,SACvB,QAAQ,GAAG,UAAU,SAAS,QAAQ,CAAC;AAE3C;;;;;AAMA,eAAe,aAAa,WAAgD;CAC1E,IAAI;EACF,MAAM,UAAU,SAAS;EACzB,OAAO;CACT,SAAS,OAAO;EACd,YAAY,oBAAqB,MAAgB,SAAS;EAC1D,OAAO;CACT;AACF"}

package/esm/dev-server/supervisor.mjs

@@ -14,6 +14,17 @@ const WORKER_ENV_FLAG = "WARLOCK_DEV_WORKER";
 * a stray supervisor-less exit reads sensibly in a shell.
 */
 const RESTART_EXIT_CODE = 75;
+/**
+* Exit code a worker uses when it hit a startup precondition whose cause
+* cannot change by trying again — a busy port, a rejected boot validator, an
+* unusable configured value. Chosen as EX_CONFIG, whose conventional meaning
+* ("configuration error") matches the class. The supervisor treats this as
+* terminal: no restart, no crash-budget spend, and no extra banner — the
+* worker has already printed a good message, and the whole point of this
+* exit code is that the supervisor does not scroll it away with a
+* "restarting" line and then reprint the same failure a moment later.
+*/
+const BOOT_PRECONDITION_EXIT_CODE = 78;
 /** Signals the supervisor must hand to the worker rather than act on itself. */
 const FORWARDED_SIGNALS = ["SIGTERM", "SIGHUP"];
 /**
@@ -83,6 +94,10 @@ function superviseDevServer(now = Date.now) {
 				spawnWorker();
 				return;
 			}
+			if (code === 78) {
+				process.exit(code);
+				return;
+			}
 			if ((signal !== null || (code ?? 0) !== 0) && shouldRecoverFromCrash(now() - spawnedAt)) {
 				devLogWarn(`Development server ${signal ? `was killed by ${signal}` : `exited with code ${code}`} — restarting.`);
 				spawnWorker();