@noego/wood 0.0.1

package/dist/dev/backend_watcher.d.cts

@@ -0,0 +1,22 @@
+import { BackendBridge } from '../bridge/backend_bridge.cjs';
+
+interface BackendWatcherOptions {
+    patterns: string[];
+    bridge: BackendBridge;
+    buildFn: () => Promise<void>;
+    cwd: string;
+}
+declare class BackendWatcher {
+    private options;
+    private watcher;
+    private change$;
+    private crashCount;
+    private lastStartTime;
+    private paused;
+    constructor(options: BackendWatcherOptions);
+    start(): void;
+    stop(): void;
+    private rebuild;
+}
+
+export { BackendWatcher, type BackendWatcherOptions };

package/dist/dev/backend_watcher.d.ts

@@ -0,0 +1,22 @@
+import { BackendBridge } from '../bridge/backend_bridge.js';
+
+interface BackendWatcherOptions {
+    patterns: string[];
+    bridge: BackendBridge;
+    buildFn: () => Promise<void>;
+    cwd: string;
+}
+declare class BackendWatcher {
+    private options;
+    private watcher;
+    private change$;
+    private crashCount;
+    private lastStartTime;
+    private paused;
+    constructor(options: BackendWatcherOptions);
+    start(): void;
+    stop(): void;
+    private rebuild;
+}
+
+export { BackendWatcher, type BackendWatcherOptions };

package/dist/dev/backend_watcher.js

@@ -0,0 +1,84 @@
+import { watch } from "chokidar";
+import { Subject, debounceTime, switchMap, from } from "rxjs";
+import { getLogger } from "@noego/logger";
+const logger = getLogger("wood:dev:backend-watcher");
+const MAX_CRASH_RESTARTS = 3;
+const STABILITY_THRESHOLD = 3e4;
+const BOOT_ERROR_THRESHOLD = 5e3;
+class BackendWatcher {
+  constructor(options) {
+    this.options = options;
+    this.watcher = null;
+    this.change$ = new Subject();
+    this.crashCount = 0;
+    this.lastStartTime = 0;
+    this.paused = false;
+  }
+  start() {
+    this.watcher = watch(this.options.patterns, {
+      cwd: this.options.cwd,
+      ignoreInitial: true
+    });
+    this.watcher.on("change", (filePath) => {
+      if (this.paused) {
+        logger.info("file change detected while paused, resuming restarts");
+        this.paused = false;
+        this.crashCount = 0;
+      }
+      logger.debug("backend file changed", { filePath });
+      this.change$.next(filePath);
+    });
+    this.change$.pipe(
+      debounceTime(100),
+      switchMap(() => from(this.rebuild()))
+    ).subscribe({
+      error: (err) => {
+        logger.error("backend watcher pipeline error", { error: String(err) });
+      }
+    });
+  }
+  stop() {
+    this.watcher?.close();
+    this.change$.complete();
+  }
+  async rebuild() {
+    if (this.paused) return;
+    try {
+      logger.info("restarting backend");
+      await this.options.bridge.stop();
+      await this.options.buildFn();
+      const timeSinceLastStart = Date.now() - this.lastStartTime;
+      if (this.lastStartTime > 0 && timeSinceLastStart < STABILITY_THRESHOLD) {
+        this.crashCount++;
+        if (this.crashCount >= MAX_CRASH_RESTARTS) {
+          logger.error(
+            "backend crashed too many times in quick succession, pausing restarts",
+            { crashCount: this.crashCount }
+          );
+          this.paused = true;
+          return;
+        }
+      } else {
+        this.crashCount = 0;
+      }
+      this.lastStartTime = Date.now();
+      await this.options.bridge.start();
+      logger.info("backend restarted successfully");
+    } catch (err) {
+      const timeSinceBoot = Date.now() - this.lastStartTime;
+      if (timeSinceBoot < BOOT_ERROR_THRESHOLD) {
+        logger.error(
+          "backend failed to boot (exited within 5s), pausing auto-restart \u2014 fix the error and save to retry",
+          { error: String(err) }
+        );
+        this.paused = true;
+      } else {
+        logger.error("backend rebuild/restart failed", { error: String(err) });
+      }
+    }
+  }
+}
+export {
+  BackendWatcher
+};
+//# sourceMappingURL=backend_watcher.js.map

package/dist/dev/backend_watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dev/backend_watcher.ts"],"sourcesContent":["import { watch, type FSWatcher } from 'chokidar';\nimport { Subject, debounceTime, switchMap, from } from 'rxjs';\nimport { getLogger } from '@noego/logger';\nimport { BackendBridge } from '../bridge/backend_bridge.js';\n\nconst logger = getLogger('wood:dev:backend-watcher');\n\nexport interface BackendWatcherOptions {\n  patterns: string[];\n  bridge: BackendBridge;\n  buildFn: () => Promise<void>;\n  cwd: string;\n}\n\nconst MAX_CRASH_RESTARTS = 3;\nconst STABILITY_THRESHOLD = 30_000; // 30 seconds\nconst BOOT_ERROR_THRESHOLD = 5_000; // 5 seconds — quick exit = boot error, don't retry\n\nexport class BackendWatcher {\n  private watcher: FSWatcher | null = null;\n  private change$ = new Subject<string>();\n  private crashCount = 0;\n  private lastStartTime = 0;\n  private paused = false;\n\n  constructor(private options: BackendWatcherOptions) {}\n\n  start(): void {\n    this.watcher = watch(this.options.patterns, {\n      cwd: this.options.cwd,\n      ignoreInitial: true,\n    });\n\n    this.watcher.on('change', (filePath: string) => {\n      if (this.paused) {\n        // A file change while paused resets the pause — the developer likely fixed the issue\n        logger.info('file change detected while paused, resuming restarts');\n        this.paused = false;\n        this.crashCount = 0;\n      }\n      logger.debug('backend file changed', { filePath });\n      this.change$.next(filePath);\n    });\n\n    // RxJS pipeline: debounce rapid saves, switchMap cancels in-progress restarts\n    this.change$.pipe(\n      debounceTime(100),\n      switchMap(() => from(this.rebuild())),\n    ).subscribe({\n      error: (err) => {\n        logger.error('backend watcher pipeline error', { error: String(err) });\n      },\n    });\n  }\n\n  stop(): void {\n    this.watcher?.close();\n    this.change$.complete();\n  }\n\n  private async rebuild(): Promise<void> {\n    if (this.paused) return;\n\n    try {\n      logger.info('restarting backend');\n\n      // Stop backend\n      await this.options.bridge.stop();\n\n      // Rebuild\n      await this.options.buildFn();\n\n      // Check crash threshold — rapid crashes indicate a persistent issue\n      const timeSinceLastStart = Date.now() - this.lastStartTime;\n      if (this.lastStartTime > 0 && timeSinceLastStart < STABILITY_THRESHOLD) {\n        this.crashCount++;\n        if (this.crashCount >= MAX_CRASH_RESTARTS) {\n          logger.error(\n            'backend crashed too many times in quick succession, pausing restarts',\n            { crashCount: this.crashCount },\n          );\n          this.paused = true;\n          return;\n        }\n      } else {\n        this.crashCount = 0;\n      }\n\n      // Start backend\n      this.lastStartTime = Date.now();\n      await this.options.bridge.start();\n\n      // Boot error detection: if the backend exits very quickly after start,\n      // it likely has a fatal error (syntax error, missing dep, etc.)\n      // The bridge's onExit fires and state goes to 'stopped'.\n      // We check inline here — if bridge.start() resolved but then\n      // immediately exits, the next change will see it as a crash.\n      // However, we can also detect it if start() itself throws\n      // (bridge.waitForReady rejects on exit).\n\n      logger.info('backend restarted successfully');\n    } catch (err) {\n      const timeSinceBoot = Date.now() - this.lastStartTime;\n      if (timeSinceBoot < BOOT_ERROR_THRESHOLD) {\n        logger.error(\n          'backend failed to boot (exited within 5s), pausing auto-restart — fix the error and save to retry',\n          { error: String(err) },\n        );\n        this.paused = true;\n      } else {\n        logger.error('backend rebuild/restart failed', { error: String(err) });\n      }\n    }\n  }\n}\n"],"mappings":"AAAA,SAAS,aAA6B;AACtC,SAAS,SAAS,cAAc,WAAW,YAAY;AACvD,SAAS,iBAAiB;AAG1B,MAAM,SAAS,UAAU,0BAA0B;AASnD,MAAM,qBAAqB;AAC3B,MAAM,sBAAsB;AAC5B,MAAM,uBAAuB;AAEtB,MAAM,eAAe;AAAA,EAO1B,YAAoB,SAAgC;AAAhC;AANpB,SAAQ,UAA4B;AACpC,SAAQ,UAAU,IAAI,QAAgB;AACtC,SAAQ,aAAa;AACrB,SAAQ,gBAAgB;AACxB,SAAQ,SAAS;AAAA,EAEoC;AAAA,EAErD,QAAc;AACZ,SAAK,UAAU,MAAM,KAAK,QAAQ,UAAU;AAAA,MAC1C,KAAK,KAAK,QAAQ;AAAA,MAClB,eAAe;AAAA,IACjB,CAAC;AAED,SAAK,QAAQ,GAAG,UAAU,CAAC,aAAqB;AAC9C,UAAI,KAAK,QAAQ;AAEf,eAAO,KAAK,sDAAsD;AAClE,aAAK,SAAS;AACd,aAAK,aAAa;AAAA,MACpB;AACA,aAAO,MAAM,wBAAwB,EAAE,SAAS,CAAC;AACjD,WAAK,QAAQ,KAAK,QAAQ;AAAA,IAC5B,CAAC;AAGD,SAAK,QAAQ;AAAA,MACX,aAAa,GAAG;AAAA,MAChB,UAAU,MAAM,KAAK,KAAK,QAAQ,CAAC,CAAC;AAAA,IACtC,EAAE,UAAU;AAAA,MACV,OAAO,CAAC,QAAQ;AACd,eAAO,MAAM,kCAAkC,EAAE,OAAO,OAAO,GAAG,EAAE,CAAC;AAAA,MACvE;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,OAAa;AACX,SAAK,SAAS,MAAM;AACpB,SAAK,QAAQ,SAAS;AAAA,EACxB;AAAA,EAEA,MAAc,UAAyB;AACrC,QAAI,KAAK,OAAQ;AAEjB,QAAI;AACF,aAAO,KAAK,oBAAoB;AAGhC,YAAM,KAAK,QAAQ,OAAO,KAAK;AAG/B,YAAM,KAAK,QAAQ,QAAQ;AAG3B,YAAM,qBAAqB,KAAK,IAAI,IAAI,KAAK;AAC7C,UAAI,KAAK,gBAAgB,KAAK,qBAAqB,qBAAqB;AACtE,aAAK;AACL,YAAI,KAAK,cAAc,oBAAoB;AACzC,iBAAO;AAAA,YACL;AAAA,YACA,EAAE,YAAY,KAAK,WAAW;AAAA,UAChC;AACA,eAAK,SAAS;AACd;AAAA,QACF;AAAA,MACF,OAAO;AACL,aAAK,aAAa;AAAA,MACpB;AAGA,WAAK,gBAAgB,KAAK,IAAI;AAC9B,YAAM,KAAK,QAAQ,OAAO,MAAM;AAUhC,aAAO,KAAK,gCAAgC;AAAA,IAC9C,SAAS,KAAK;AACZ,YAAM,gBAAgB,KAAK,IAAI,IAAI,KAAK;AACxC,UAAI,gBAAgB,sBAAsB;AACxC,eAAO;AAAA,UACL;AAAA,UACA,EAAE,OAAO,OAAO,GAAG,EAAE;AAAA,QACvB;AACA,aAAK,SAAS;AAAA,MAChB,OAAO;AACL,eAAO,MAAM,kCAAkC,EAAE,OAAO,OAAO,GAAG,EAAE,CAAC;AAAA,MACvE;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/dev/dev_metadata.cjs

@@ -0,0 +1,94 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var dev_metadata_exports = {};
+__export(dev_metadata_exports, {
+  DEFAULT_WOOD_REMOTE_DEBUGGING_PORT: () => DEFAULT_WOOD_REMOTE_DEBUGGING_PORT,
+  WOOD_DEV_DIRECTORY: () => WOOD_DEV_DIRECTORY,
+  WOOD_DEV_METADATA_BASENAME: () => WOOD_DEV_METADATA_BASENAME,
+  readWoodDevMetadata: () => readWoodDevMetadata,
+  removeWoodDevMetadata: () => removeWoodDevMetadata,
+  resolveWoodDevDirectory: () => resolveWoodDevDirectory,
+  resolveWoodDevMetadataPath: () => resolveWoodDevMetadataPath,
+  resolveWoodRemoteDebuggingPort: () => resolveWoodRemoteDebuggingPort,
+  writeWoodDevMetadata: () => writeWoodDevMetadata
+});
+module.exports = __toCommonJS(dev_metadata_exports);
+var import_node_fs = require("node:fs");
+var import_node_path = __toESM(require("node:path"), 1);
+const DEFAULT_WOOD_REMOTE_DEBUGGING_PORT = 9333;
+const WOOD_DEV_DIRECTORY = ".wood";
+const WOOD_DEV_METADATA_BASENAME = "dev.json";
+function resolveWoodRemoteDebuggingPort(env = process.env) {
+  const rawPort = env.WOOD_REMOTE_DEBUGGING_PORT;
+  const parsedPort = rawPort ? Number.parseInt(rawPort, 10) : DEFAULT_WOOD_REMOTE_DEBUGGING_PORT;
+  if (Number.isFinite(parsedPort) && parsedPort > 0) {
+    return parsedPort;
+  }
+  return DEFAULT_WOOD_REMOTE_DEBUGGING_PORT;
+}
+function resolveWoodDevDirectory(projectRoot) {
+  return import_node_path.default.join(projectRoot, WOOD_DEV_DIRECTORY);
+}
+function resolveWoodDevMetadataPath(projectRoot) {
+  return import_node_path.default.join(resolveWoodDevDirectory(projectRoot), WOOD_DEV_METADATA_BASENAME);
+}
+function writeWoodDevMetadata(projectRoot, metadata) {
+  const directory = resolveWoodDevDirectory(projectRoot);
+  (0, import_node_fs.mkdirSync)(directory, { recursive: true });
+  const metadataPath = resolveWoodDevMetadataPath(projectRoot);
+  (0, import_node_fs.writeFileSync)(metadataPath, `${JSON.stringify(metadata, null, 2)}
+`, "utf8");
+  return metadataPath;
+}
+function readWoodDevMetadata(projectRoot) {
+  const metadataPath = resolveWoodDevMetadataPath(projectRoot);
+  if (!(0, import_node_fs.existsSync)(metadataPath)) {
+    throw new Error(`Wood dev metadata not found at ${metadataPath}. Start the app with "wood dev" first.`);
+  }
+  return JSON.parse((0, import_node_fs.readFileSync)(metadataPath, "utf8"));
+}
+function removeWoodDevMetadata(projectRoot) {
+  const metadataPath = resolveWoodDevMetadataPath(projectRoot);
+  if ((0, import_node_fs.existsSync)(metadataPath)) {
+    (0, import_node_fs.rmSync)(metadataPath, { force: true });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_WOOD_REMOTE_DEBUGGING_PORT,
+  WOOD_DEV_DIRECTORY,
+  WOOD_DEV_METADATA_BASENAME,
+  readWoodDevMetadata,
+  removeWoodDevMetadata,
+  resolveWoodDevDirectory,
+  resolveWoodDevMetadataPath,
+  resolveWoodRemoteDebuggingPort,
+  writeWoodDevMetadata
+});
+//# sourceMappingURL=dev_metadata.cjs.map

package/dist/dev/dev_metadata.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dev/dev_metadata.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';\nimport path from 'node:path';\n\nexport const DEFAULT_WOOD_REMOTE_DEBUGGING_PORT = 9333;\nexport const WOOD_DEV_DIRECTORY = '.wood';\nexport const WOOD_DEV_METADATA_BASENAME = 'dev.json';\n\nexport interface WoodDevMetadata {\n  projectRoot: string;\n  projectName: string;\n  mode: 'development';\n  debugPort: number;\n  browserUrl: string;\n  pid?: number;\n  startedAt: string;\n}\n\nexport function resolveWoodRemoteDebuggingPort(\n  env: NodeJS.ProcessEnv = process.env,\n): number {\n  const rawPort = env.WOOD_REMOTE_DEBUGGING_PORT;\n  const parsedPort = rawPort ? Number.parseInt(rawPort, 10) : DEFAULT_WOOD_REMOTE_DEBUGGING_PORT;\n  if (Number.isFinite(parsedPort) && parsedPort > 0) {\n    return parsedPort;\n  }\n  return DEFAULT_WOOD_REMOTE_DEBUGGING_PORT;\n}\n\nexport function resolveWoodDevDirectory(projectRoot: string): string {\n  return path.join(projectRoot, WOOD_DEV_DIRECTORY);\n}\n\nexport function resolveWoodDevMetadataPath(projectRoot: string): string {\n  return path.join(resolveWoodDevDirectory(projectRoot), WOOD_DEV_METADATA_BASENAME);\n}\n\nexport function writeWoodDevMetadata(projectRoot: string, metadata: WoodDevMetadata): string {\n  const directory = resolveWoodDevDirectory(projectRoot);\n  mkdirSync(directory, { recursive: true });\n  const metadataPath = resolveWoodDevMetadataPath(projectRoot);\n  writeFileSync(metadataPath, `${JSON.stringify(metadata, null, 2)}\\n`, 'utf8');\n  return metadataPath;\n}\n\nexport function readWoodDevMetadata(projectRoot: string): WoodDevMetadata {\n  const metadataPath = resolveWoodDevMetadataPath(projectRoot);\n  if (!existsSync(metadataPath)) {\n    throw new Error(`Wood dev metadata not found at ${metadataPath}. Start the app with \"wood dev\" first.`);\n  }\n\n  return JSON.parse(readFileSync(metadataPath, 'utf8')) as WoodDevMetadata;\n}\n\nexport function removeWoodDevMetadata(projectRoot: string): void {\n  const metadataPath = resolveWoodDevMetadataPath(projectRoot);\n  if (existsSync(metadataPath)) {\n    rmSync(metadataPath, { force: true });\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA2E;AAC3E,uBAAiB;AAEV,MAAM,qCAAqC;AAC3C,MAAM,qBAAqB;AAC3B,MAAM,6BAA6B;AAYnC,SAAS,+BACd,MAAyB,QAAQ,KACzB;AACR,QAAM,UAAU,IAAI;AACpB,QAAM,aAAa,UAAU,OAAO,SAAS,SAAS,EAAE,IAAI;AAC5D,MAAI,OAAO,SAAS,UAAU,KAAK,aAAa,GAAG;AACjD,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEO,SAAS,wBAAwB,aAA6B;AACnE,SAAO,iBAAAA,QAAK,KAAK,aAAa,kBAAkB;AAClD;AAEO,SAAS,2BAA2B,aAA6B;AACtE,SAAO,iBAAAA,QAAK,KAAK,wBAAwB,WAAW,GAAG,0BAA0B;AACnF;AAEO,SAAS,qBAAqB,aAAqB,UAAmC;AAC3F,QAAM,YAAY,wBAAwB,WAAW;AACrD,gCAAU,WAAW,EAAE,WAAW,KAAK,CAAC;AACxC,QAAM,eAAe,2BAA2B,WAAW;AAC3D,oCAAc,cAAc,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAAA,GAAM,MAAM;AAC5E,SAAO;AACT;AAEO,SAAS,oBAAoB,aAAsC;AACxE,QAAM,eAAe,2BAA2B,WAAW;AAC3D,MAAI,KAAC,2BAAW,YAAY,GAAG;AAC7B,UAAM,IAAI,MAAM,kCAAkC,YAAY,wCAAwC;AAAA,EACxG;AAEA,SAAO,KAAK,UAAM,6BAAa,cAAc,MAAM,CAAC;AACtD;AAEO,SAAS,sBAAsB,aAA2B;AAC/D,QAAM,eAAe,2BAA2B,WAAW;AAC3D,UAAI,2BAAW,YAAY,GAAG;AAC5B,+BAAO,cAAc,EAAE,OAAO,KAAK,CAAC;AAAA,EACtC;AACF;","names":["path"]}

package/dist/dev/dev_metadata.d.cts

@@ -0,0 +1,20 @@
+declare const DEFAULT_WOOD_REMOTE_DEBUGGING_PORT = 9333;
+declare const WOOD_DEV_DIRECTORY = ".wood";
+declare const WOOD_DEV_METADATA_BASENAME = "dev.json";
+interface WoodDevMetadata {
+    projectRoot: string;
+    projectName: string;
+    mode: 'development';
+    debugPort: number;
+    browserUrl: string;
+    pid?: number;
+    startedAt: string;
+}
+declare function resolveWoodRemoteDebuggingPort(env?: NodeJS.ProcessEnv): number;
+declare function resolveWoodDevDirectory(projectRoot: string): string;
+declare function resolveWoodDevMetadataPath(projectRoot: string): string;
+declare function writeWoodDevMetadata(projectRoot: string, metadata: WoodDevMetadata): string;
+declare function readWoodDevMetadata(projectRoot: string): WoodDevMetadata;
+declare function removeWoodDevMetadata(projectRoot: string): void;
+
+export { DEFAULT_WOOD_REMOTE_DEBUGGING_PORT, WOOD_DEV_DIRECTORY, WOOD_DEV_METADATA_BASENAME, type WoodDevMetadata, readWoodDevMetadata, removeWoodDevMetadata, resolveWoodDevDirectory, resolveWoodDevMetadataPath, resolveWoodRemoteDebuggingPort, writeWoodDevMetadata };

package/dist/dev/dev_metadata.d.ts

@@ -0,0 +1,20 @@
+declare const DEFAULT_WOOD_REMOTE_DEBUGGING_PORT = 9333;
+declare const WOOD_DEV_DIRECTORY = ".wood";
+declare const WOOD_DEV_METADATA_BASENAME = "dev.json";
+interface WoodDevMetadata {
+    projectRoot: string;
+    projectName: string;
+    mode: 'development';
+    debugPort: number;
+    browserUrl: string;
+    pid?: number;
+    startedAt: string;
+}
+declare function resolveWoodRemoteDebuggingPort(env?: NodeJS.ProcessEnv): number;
+declare function resolveWoodDevDirectory(projectRoot: string): string;
+declare function resolveWoodDevMetadataPath(projectRoot: string): string;
+declare function writeWoodDevMetadata(projectRoot: string, metadata: WoodDevMetadata): string;
+declare function readWoodDevMetadata(projectRoot: string): WoodDevMetadata;
+declare function removeWoodDevMetadata(projectRoot: string): void;
+
+export { DEFAULT_WOOD_REMOTE_DEBUGGING_PORT, WOOD_DEV_DIRECTORY, WOOD_DEV_METADATA_BASENAME, type WoodDevMetadata, readWoodDevMetadata, removeWoodDevMetadata, resolveWoodDevDirectory, resolveWoodDevMetadataPath, resolveWoodRemoteDebuggingPort, writeWoodDevMetadata };

package/dist/dev/dev_metadata.js

@@ -0,0 +1,52 @@
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import path from "node:path";
+const DEFAULT_WOOD_REMOTE_DEBUGGING_PORT = 9333;
+const WOOD_DEV_DIRECTORY = ".wood";
+const WOOD_DEV_METADATA_BASENAME = "dev.json";
+function resolveWoodRemoteDebuggingPort(env = process.env) {
+  const rawPort = env.WOOD_REMOTE_DEBUGGING_PORT;
+  const parsedPort = rawPort ? Number.parseInt(rawPort, 10) : DEFAULT_WOOD_REMOTE_DEBUGGING_PORT;
+  if (Number.isFinite(parsedPort) && parsedPort > 0) {
+    return parsedPort;
+  }
+  return DEFAULT_WOOD_REMOTE_DEBUGGING_PORT;
+}
+function resolveWoodDevDirectory(projectRoot) {
+  return path.join(projectRoot, WOOD_DEV_DIRECTORY);
+}
+function resolveWoodDevMetadataPath(projectRoot) {
+  return path.join(resolveWoodDevDirectory(projectRoot), WOOD_DEV_METADATA_BASENAME);
+}
+function writeWoodDevMetadata(projectRoot, metadata) {
+  const directory = resolveWoodDevDirectory(projectRoot);
+  mkdirSync(directory, { recursive: true });
+  const metadataPath = resolveWoodDevMetadataPath(projectRoot);
+  writeFileSync(metadataPath, `${JSON.stringify(metadata, null, 2)}
+`, "utf8");
+  return metadataPath;
+}
+function readWoodDevMetadata(projectRoot) {
+  const metadataPath = resolveWoodDevMetadataPath(projectRoot);
+  if (!existsSync(metadataPath)) {
+    throw new Error(`Wood dev metadata not found at ${metadataPath}. Start the app with "wood dev" first.`);
+  }
+  return JSON.parse(readFileSync(metadataPath, "utf8"));
+}
+function removeWoodDevMetadata(projectRoot) {
+  const metadataPath = resolveWoodDevMetadataPath(projectRoot);
+  if (existsSync(metadataPath)) {
+    rmSync(metadataPath, { force: true });
+  }
+}
+export {
+  DEFAULT_WOOD_REMOTE_DEBUGGING_PORT,
+  WOOD_DEV_DIRECTORY,
+  WOOD_DEV_METADATA_BASENAME,
+  readWoodDevMetadata,
+  removeWoodDevMetadata,
+  resolveWoodDevDirectory,
+  resolveWoodDevMetadataPath,
+  resolveWoodRemoteDebuggingPort,
+  writeWoodDevMetadata
+};
+//# sourceMappingURL=dev_metadata.js.map

package/dist/dev/dev_metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dev/dev_metadata.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';\nimport path from 'node:path';\n\nexport const DEFAULT_WOOD_REMOTE_DEBUGGING_PORT = 9333;\nexport const WOOD_DEV_DIRECTORY = '.wood';\nexport const WOOD_DEV_METADATA_BASENAME = 'dev.json';\n\nexport interface WoodDevMetadata {\n  projectRoot: string;\n  projectName: string;\n  mode: 'development';\n  debugPort: number;\n  browserUrl: string;\n  pid?: number;\n  startedAt: string;\n}\n\nexport function resolveWoodRemoteDebuggingPort(\n  env: NodeJS.ProcessEnv = process.env,\n): number {\n  const rawPort = env.WOOD_REMOTE_DEBUGGING_PORT;\n  const parsedPort = rawPort ? Number.parseInt(rawPort, 10) : DEFAULT_WOOD_REMOTE_DEBUGGING_PORT;\n  if (Number.isFinite(parsedPort) && parsedPort > 0) {\n    return parsedPort;\n  }\n  return DEFAULT_WOOD_REMOTE_DEBUGGING_PORT;\n}\n\nexport function resolveWoodDevDirectory(projectRoot: string): string {\n  return path.join(projectRoot, WOOD_DEV_DIRECTORY);\n}\n\nexport function resolveWoodDevMetadataPath(projectRoot: string): string {\n  return path.join(resolveWoodDevDirectory(projectRoot), WOOD_DEV_METADATA_BASENAME);\n}\n\nexport function writeWoodDevMetadata(projectRoot: string, metadata: WoodDevMetadata): string {\n  const directory = resolveWoodDevDirectory(projectRoot);\n  mkdirSync(directory, { recursive: true });\n  const metadataPath = resolveWoodDevMetadataPath(projectRoot);\n  writeFileSync(metadataPath, `${JSON.stringify(metadata, null, 2)}\\n`, 'utf8');\n  return metadataPath;\n}\n\nexport function readWoodDevMetadata(projectRoot: string): WoodDevMetadata {\n  const metadataPath = resolveWoodDevMetadataPath(projectRoot);\n  if (!existsSync(metadataPath)) {\n    throw new Error(`Wood dev metadata not found at ${metadataPath}. Start the app with \"wood dev\" first.`);\n  }\n\n  return JSON.parse(readFileSync(metadataPath, 'utf8')) as WoodDevMetadata;\n}\n\nexport function removeWoodDevMetadata(projectRoot: string): void {\n  const metadataPath = resolveWoodDevMetadataPath(projectRoot);\n  if (existsSync(metadataPath)) {\n    rmSync(metadataPath, { force: true });\n  }\n}\n"],"mappings":"AAAA,SAAS,YAAY,WAAW,cAAc,QAAQ,qBAAqB;AAC3E,OAAO,UAAU;AAEV,MAAM,qCAAqC;AAC3C,MAAM,qBAAqB;AAC3B,MAAM,6BAA6B;AAYnC,SAAS,+BACd,MAAyB,QAAQ,KACzB;AACR,QAAM,UAAU,IAAI;AACpB,QAAM,aAAa,UAAU,OAAO,SAAS,SAAS,EAAE,IAAI;AAC5D,MAAI,OAAO,SAAS,UAAU,KAAK,aAAa,GAAG;AACjD,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEO,SAAS,wBAAwB,aAA6B;AACnE,SAAO,KAAK,KAAK,aAAa,kBAAkB;AAClD;AAEO,SAAS,2BAA2B,aAA6B;AACtE,SAAO,KAAK,KAAK,wBAAwB,WAAW,GAAG,0BAA0B;AACnF;AAEO,SAAS,qBAAqB,aAAqB,UAAmC;AAC3F,QAAM,YAAY,wBAAwB,WAAW;AACrD,YAAU,WAAW,EAAE,WAAW,KAAK,CAAC;AACxC,QAAM,eAAe,2BAA2B,WAAW;AAC3D,gBAAc,cAAc,GAAG,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;AAAA,GAAM,MAAM;AAC5E,SAAO;AACT;AAEO,SAAS,oBAAoB,aAAsC;AACxE,QAAM,eAAe,2BAA2B,WAAW;AAC3D,MAAI,CAAC,WAAW,YAAY,GAAG;AAC7B,UAAM,IAAI,MAAM,kCAAkC,YAAY,wCAAwC;AAAA,EACxG;AAEA,SAAO,KAAK,MAAM,aAAa,cAAc,MAAM,CAAC;AACtD;AAEO,SAAS,sBAAsB,aAA2B;AAC/D,QAAM,eAAe,2BAA2B,WAAW;AAC3D,MAAI,WAAW,YAAY,GAAG;AAC5B,WAAO,cAAc,EAAE,OAAO,KAAK,CAAC;AAAA,EACtC;AACF;","names":[]}

package/dist/dev/esbuild_backend.cjs

@@ -0,0 +1,124 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var esbuild_backend_exports = {};
+__export(esbuild_backend_exports, {
+  EsbuildBackend: () => EsbuildBackend
+});
+module.exports = __toCommonJS(esbuild_backend_exports);
+var import_esbuild = require("esbuild");
+var import_path = __toESM(require("path"), 1);
+var import_logger = require("@noego/logger");
+const logger = (0, import_logger.getLogger)("wood:dev:esbuild");
+const DEFAULT_EXTERNALS = [
+  "electron",
+  "better-sqlite3",
+  "original-fs"
+];
+class EsbuildBackend {
+  constructor(options) {
+    this.ctx = null;
+    this.options = options;
+  }
+  /** Run a one-shot build of the backend bundle. */
+  async build() {
+    const external = [
+      ...DEFAULT_EXTERNALS,
+      ...this.options.external ?? []
+    ];
+    logger.info("building backend", { entryPoint: this.options.entryPoint });
+    const startTime = Date.now();
+    const result = await (0, import_esbuild.build)({
+      entryPoints: [import_path.default.resolve(this.options.cwd, this.options.entryPoint)],
+      outfile: import_path.default.resolve(this.options.cwd, this.options.outfile),
+      bundle: true,
+      platform: "node",
+      format: "esm",
+      target: "node20",
+      sourcemap: true,
+      external,
+      logLevel: "warning"
+    });
+    const elapsed = Date.now() - startTime;
+    logger.info("backend built", { elapsed: `${elapsed}ms` });
+    if (result.errors.length > 0) {
+      logger.error("esbuild errors", { errors: result.errors });
+    }
+    if (result.warnings.length > 0) {
+      logger.warn("esbuild warnings", { warnings: result.warnings });
+    }
+    return result;
+  }
+  /**
+   * Create an incremental build context for fast rebuilds.
+   * Call `rebuild()` after the initial `build()` for subsequent builds.
+   */
+  async createContext() {
+    const external = [
+      ...DEFAULT_EXTERNALS,
+      ...this.options.external ?? []
+    ];
+    this.ctx = await (0, import_esbuild.context)({
+      entryPoints: [import_path.default.resolve(this.options.cwd, this.options.entryPoint)],
+      outfile: import_path.default.resolve(this.options.cwd, this.options.outfile),
+      bundle: true,
+      platform: "node",
+      format: "esm",
+      target: "node20",
+      sourcemap: true,
+      external,
+      logLevel: "warning"
+    });
+    logger.info("esbuild incremental context created");
+  }
+  /** Perform an incremental rebuild using the existing context. */
+  async rebuild() {
+    if (!this.ctx) {
+      throw new Error("No esbuild context \u2014 call createContext() first");
+    }
+    logger.debug("rebuilding backend (incremental)");
+    const startTime = Date.now();
+    const result = await this.ctx.rebuild();
+    const elapsed = Date.now() - startTime;
+    logger.info("backend rebuilt", { elapsed: `${elapsed}ms` });
+    return result;
+  }
+  /** Dispose the incremental context. */
+  async dispose() {
+    if (this.ctx) {
+      await this.ctx.dispose();
+      this.ctx = null;
+      logger.debug("esbuild context disposed");
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EsbuildBackend
+});
+//# sourceMappingURL=esbuild_backend.cjs.map

package/dist/dev/esbuild_backend.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dev/esbuild_backend.ts"],"sourcesContent":["import { build, type BuildResult, type BuildContext, context } from 'esbuild';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\n\nconst logger = getLogger('wood:dev:esbuild');\n\nexport interface EsbuildBackendOptions {\n  /** Entry point for the backend (e.g. src/main/backend.ts) */\n  entryPoint: string;\n  /** Output file path (e.g. out/backend/index.js) */\n  outfile: string;\n  /** Working directory for resolution */\n  cwd: string;\n  /** Extra externals beyond the defaults */\n  external?: string[];\n}\n\n/** Externals that should never be bundled into the backend */\nconst DEFAULT_EXTERNALS = [\n  'electron',\n  'better-sqlite3',\n  'original-fs',\n];\n\nexport class EsbuildBackend {\n  private ctx: BuildContext | null = null;\n  private options: EsbuildBackendOptions;\n\n  constructor(options: EsbuildBackendOptions) {\n    this.options = options;\n  }\n\n  /** Run a one-shot build of the backend bundle. */\n  async build(): Promise<BuildResult> {\n    const external = [\n      ...DEFAULT_EXTERNALS,\n      ...(this.options.external ?? []),\n    ];\n\n    logger.info('building backend', { entryPoint: this.options.entryPoint });\n    const startTime = Date.now();\n\n    const result = await build({\n      entryPoints: [path.resolve(this.options.cwd, this.options.entryPoint)],\n      outfile: path.resolve(this.options.cwd, this.options.outfile),\n      bundle: true,\n      platform: 'node',\n      format: 'esm',\n      target: 'node20',\n      sourcemap: true,\n      external,\n      logLevel: 'warning',\n    });\n\n    const elapsed = Date.now() - startTime;\n    logger.info('backend built', { elapsed: `${elapsed}ms` });\n\n    if (result.errors.length > 0) {\n      logger.error('esbuild errors', { errors: result.errors });\n    }\n    if (result.warnings.length > 0) {\n      logger.warn('esbuild warnings', { warnings: result.warnings });\n    }\n\n    return result;\n  }\n\n  /**\n   * Create an incremental build context for fast rebuilds.\n   * Call `rebuild()` after the initial `build()` for subsequent builds.\n   */\n  async createContext(): Promise<void> {\n    const external = [\n      ...DEFAULT_EXTERNALS,\n      ...(this.options.external ?? []),\n    ];\n\n    this.ctx = await context({\n      entryPoints: [path.resolve(this.options.cwd, this.options.entryPoint)],\n      outfile: path.resolve(this.options.cwd, this.options.outfile),\n      bundle: true,\n      platform: 'node',\n      format: 'esm',\n      target: 'node20',\n      sourcemap: true,\n      external,\n      logLevel: 'warning',\n    });\n\n    logger.info('esbuild incremental context created');\n  }\n\n  /** Perform an incremental rebuild using the existing context. */\n  async rebuild(): Promise<BuildResult> {\n    if (!this.ctx) {\n      throw new Error('No esbuild context — call createContext() first');\n    }\n\n    logger.debug('rebuilding backend (incremental)');\n    const startTime = Date.now();\n\n    const result = await this.ctx.rebuild();\n\n    const elapsed = Date.now() - startTime;\n    logger.info('backend rebuilt', { elapsed: `${elapsed}ms` });\n\n    return result;\n  }\n\n  /** Dispose the incremental context. */\n  async dispose(): Promise<void> {\n    if (this.ctx) {\n      await this.ctx.dispose();\n      this.ctx = null;\n      logger.debug('esbuild context disposed');\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAAoE;AACpE,kBAAiB;AACjB,oBAA0B;AAE1B,MAAM,aAAS,yBAAU,kBAAkB;AAc3C,MAAM,oBAAoB;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,eAAe;AAAA,EAI1B,YAAY,SAAgC;AAH5C,SAAQ,MAA2B;AAIjC,SAAK,UAAU;AAAA,EACjB;AAAA;AAAA,EAGA,MAAM,QAA8B;AAClC,UAAM,WAAW;AAAA,MACf,GAAG;AAAA,MACH,GAAI,KAAK,QAAQ,YAAY,CAAC;AAAA,IAChC;AAEA,WAAO,KAAK,oBAAoB,EAAE,YAAY,KAAK,QAAQ,WAAW,CAAC;AACvE,UAAM,YAAY,KAAK,IAAI;AAE3B,UAAM,SAAS,UAAM,sBAAM;AAAA,MACzB,aAAa,CAAC,YAAAA,QAAK,QAAQ,KAAK,QAAQ,KAAK,KAAK,QAAQ,UAAU,CAAC;AAAA,MACrE,SAAS,YAAAA,QAAK,QAAQ,KAAK,QAAQ,KAAK,KAAK,QAAQ,OAAO;AAAA,MAC5D,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,WAAW;AAAA,MACX;AAAA,MACA,UAAU;AAAA,IACZ,CAAC;AAED,UAAM,UAAU,KAAK,IAAI,IAAI;AAC7B,WAAO,KAAK,iBAAiB,EAAE,SAAS,GAAG,OAAO,KAAK,CAAC;AAExD,QAAI,OAAO,OAAO,SAAS,GAAG;AAC5B,aAAO,MAAM,kBAAkB,EAAE,QAAQ,OAAO,OAAO,CAAC;AAAA,IAC1D;AACA,QAAI,OAAO,SAAS,SAAS,GAAG;AAC9B,aAAO,KAAK,oBAAoB,EAAE,UAAU,OAAO,SAAS,CAAC;AAAA,IAC/D;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,gBAA+B;AACnC,UAAM,WAAW;AAAA,MACf,GAAG;AAAA,MACH,GAAI,KAAK,QAAQ,YAAY,CAAC;AAAA,IAChC;AAEA,SAAK,MAAM,UAAM,wBAAQ;AAAA,MACvB,aAAa,CAAC,YAAAA,QAAK,QAAQ,KAAK,QAAQ,KAAK,KAAK,QAAQ,UAAU,CAAC;AAAA,MACrE,SAAS,YAAAA,QAAK,QAAQ,KAAK,QAAQ,KAAK,KAAK,QAAQ,OAAO;AAAA,MAC5D,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,WAAW;AAAA,MACX;AAAA,MACA,UAAU;AAAA,IACZ,CAAC;AAED,WAAO,KAAK,qCAAqC;AAAA,EACnD;AAAA;AAAA,EAGA,MAAM,UAAgC;AACpC,QAAI,CAAC,KAAK,KAAK;AACb,YAAM,IAAI,MAAM,sDAAiD;AAAA,IACnE;AAEA,WAAO,MAAM,kCAAkC;AAC/C,UAAM,YAAY,KAAK,IAAI;AAE3B,UAAM,SAAS,MAAM,KAAK,IAAI,QAAQ;AAEtC,UAAM,UAAU,KAAK,IAAI,IAAI;AAC7B,WAAO,KAAK,mBAAmB,EAAE,SAAS,GAAG,OAAO,KAAK,CAAC;AAE1D,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,MAAM,UAAyB;AAC7B,QAAI,KAAK,KAAK;AACZ,YAAM,KAAK,IAAI,QAAQ;AACvB,WAAK,MAAM;AACX,aAAO,MAAM,0BAA0B;AAAA,IACzC;AAAA,EACF;AACF;","names":["path"]}

package/dist/dev/esbuild_backend.d.cts

@@ -0,0 +1,30 @@
+import { BuildResult } from 'esbuild';
+
+interface EsbuildBackendOptions {
+    /** Entry point for the backend (e.g. src/main/backend.ts) */
+    entryPoint: string;
+    /** Output file path (e.g. out/backend/index.js) */
+    outfile: string;
+    /** Working directory for resolution */
+    cwd: string;
+    /** Extra externals beyond the defaults */
+    external?: string[];
+}
+declare class EsbuildBackend {
+    private ctx;
+    private options;
+    constructor(options: EsbuildBackendOptions);
+    /** Run a one-shot build of the backend bundle. */
+    build(): Promise<BuildResult>;
+    /**
+     * Create an incremental build context for fast rebuilds.
+     * Call `rebuild()` after the initial `build()` for subsequent builds.
+     */
+    createContext(): Promise<void>;
+    /** Perform an incremental rebuild using the existing context. */
+    rebuild(): Promise<BuildResult>;
+    /** Dispose the incremental context. */
+    dispose(): Promise<void>;
+}
+
+export { EsbuildBackend, type EsbuildBackendOptions };

package/dist/dev/esbuild_backend.d.ts

@@ -0,0 +1,30 @@
+import { BuildResult } from 'esbuild';
+
+interface EsbuildBackendOptions {
+    /** Entry point for the backend (e.g. src/main/backend.ts) */
+    entryPoint: string;
+    /** Output file path (e.g. out/backend/index.js) */
+    outfile: string;
+    /** Working directory for resolution */
+    cwd: string;
+    /** Extra externals beyond the defaults */
+    external?: string[];
+}
+declare class EsbuildBackend {
+    private ctx;
+    private options;
+    constructor(options: EsbuildBackendOptions);
+    /** Run a one-shot build of the backend bundle. */
+    build(): Promise<BuildResult>;
+    /**
+     * Create an incremental build context for fast rebuilds.
+     * Call `rebuild()` after the initial `build()` for subsequent builds.
+     */
+    createContext(): Promise<void>;
+    /** Perform an incremental rebuild using the existing context. */
+    rebuild(): Promise<BuildResult>;
+    /** Dispose the incremental context. */
+    dispose(): Promise<void>;
+}
+
+export { EsbuildBackend, type EsbuildBackendOptions };

package/dist/dev/esbuild_backend.js

@@ -0,0 +1,90 @@
+import { build, context } from "esbuild";
+import path from "path";
+import { getLogger } from "@noego/logger";
+const logger = getLogger("wood:dev:esbuild");
+const DEFAULT_EXTERNALS = [
+  "electron",
+  "better-sqlite3",
+  "original-fs"
+];
+class EsbuildBackend {
+  constructor(options) {
+    this.ctx = null;
+    this.options = options;
+  }
+  /** Run a one-shot build of the backend bundle. */
+  async build() {
+    const external = [
+      ...DEFAULT_EXTERNALS,
+      ...this.options.external ?? []
+    ];
+    logger.info("building backend", { entryPoint: this.options.entryPoint });
+    const startTime = Date.now();
+    const result = await build({
+      entryPoints: [path.resolve(this.options.cwd, this.options.entryPoint)],
+      outfile: path.resolve(this.options.cwd, this.options.outfile),
+      bundle: true,
+      platform: "node",
+      format: "esm",
+      target: "node20",
+      sourcemap: true,
+      external,
+      logLevel: "warning"
+    });
+    const elapsed = Date.now() - startTime;
+    logger.info("backend built", { elapsed: `${elapsed}ms` });
+    if (result.errors.length > 0) {
+      logger.error("esbuild errors", { errors: result.errors });
+    }
+    if (result.warnings.length > 0) {
+      logger.warn("esbuild warnings", { warnings: result.warnings });
+    }
+    return result;
+  }
+  /**
+   * Create an incremental build context for fast rebuilds.
+   * Call `rebuild()` after the initial `build()` for subsequent builds.
+   */
+  async createContext() {
+    const external = [
+      ...DEFAULT_EXTERNALS,
+      ...this.options.external ?? []
+    ];
+    this.ctx = await context({
+      entryPoints: [path.resolve(this.options.cwd, this.options.entryPoint)],
+      outfile: path.resolve(this.options.cwd, this.options.outfile),
+      bundle: true,
+      platform: "node",
+      format: "esm",
+      target: "node20",
+      sourcemap: true,
+      external,
+      logLevel: "warning"
+    });
+    logger.info("esbuild incremental context created");
+  }
+  /** Perform an incremental rebuild using the existing context. */
+  async rebuild() {
+    if (!this.ctx) {
+      throw new Error("No esbuild context \u2014 call createContext() first");
+    }
+    logger.debug("rebuilding backend (incremental)");
+    const startTime = Date.now();
+    const result = await this.ctx.rebuild();
+    const elapsed = Date.now() - startTime;
+    logger.info("backend rebuilt", { elapsed: `${elapsed}ms` });
+    return result;
+  }
+  /** Dispose the incremental context. */
+  async dispose() {
+    if (this.ctx) {
+      await this.ctx.dispose();
+      this.ctx = null;
+      logger.debug("esbuild context disposed");
+    }
+  }
+}
+export {
+  EsbuildBackend
+};
+//# sourceMappingURL=esbuild_backend.js.map

package/dist/dev/esbuild_backend.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dev/esbuild_backend.ts"],"sourcesContent":["import { build, type BuildResult, type BuildContext, context } from 'esbuild';\nimport path from 'path';\nimport { getLogger } from '@noego/logger';\n\nconst logger = getLogger('wood:dev:esbuild');\n\nexport interface EsbuildBackendOptions {\n  /** Entry point for the backend (e.g. src/main/backend.ts) */\n  entryPoint: string;\n  /** Output file path (e.g. out/backend/index.js) */\n  outfile: string;\n  /** Working directory for resolution */\n  cwd: string;\n  /** Extra externals beyond the defaults */\n  external?: string[];\n}\n\n/** Externals that should never be bundled into the backend */\nconst DEFAULT_EXTERNALS = [\n  'electron',\n  'better-sqlite3',\n  'original-fs',\n];\n\nexport class EsbuildBackend {\n  private ctx: BuildContext | null = null;\n  private options: EsbuildBackendOptions;\n\n  constructor(options: EsbuildBackendOptions) {\n    this.options = options;\n  }\n\n  /** Run a one-shot build of the backend bundle. */\n  async build(): Promise<BuildResult> {\n    const external = [\n      ...DEFAULT_EXTERNALS,\n      ...(this.options.external ?? []),\n    ];\n\n    logger.info('building backend', { entryPoint: this.options.entryPoint });\n    const startTime = Date.now();\n\n    const result = await build({\n      entryPoints: [path.resolve(this.options.cwd, this.options.entryPoint)],\n      outfile: path.resolve(this.options.cwd, this.options.outfile),\n      bundle: true,\n      platform: 'node',\n      format: 'esm',\n      target: 'node20',\n      sourcemap: true,\n      external,\n      logLevel: 'warning',\n    });\n\n    const elapsed = Date.now() - startTime;\n    logger.info('backend built', { elapsed: `${elapsed}ms` });\n\n    if (result.errors.length > 0) {\n      logger.error('esbuild errors', { errors: result.errors });\n    }\n    if (result.warnings.length > 0) {\n      logger.warn('esbuild warnings', { warnings: result.warnings });\n    }\n\n    return result;\n  }\n\n  /**\n   * Create an incremental build context for fast rebuilds.\n   * Call `rebuild()` after the initial `build()` for subsequent builds.\n   */\n  async createContext(): Promise<void> {\n    const external = [\n      ...DEFAULT_EXTERNALS,\n      ...(this.options.external ?? []),\n    ];\n\n    this.ctx = await context({\n      entryPoints: [path.resolve(this.options.cwd, this.options.entryPoint)],\n      outfile: path.resolve(this.options.cwd, this.options.outfile),\n      bundle: true,\n      platform: 'node',\n      format: 'esm',\n      target: 'node20',\n      sourcemap: true,\n      external,\n      logLevel: 'warning',\n    });\n\n    logger.info('esbuild incremental context created');\n  }\n\n  /** Perform an incremental rebuild using the existing context. */\n  async rebuild(): Promise<BuildResult> {\n    if (!this.ctx) {\n      throw new Error('No esbuild context — call createContext() first');\n    }\n\n    logger.debug('rebuilding backend (incremental)');\n    const startTime = Date.now();\n\n    const result = await this.ctx.rebuild();\n\n    const elapsed = Date.now() - startTime;\n    logger.info('backend rebuilt', { elapsed: `${elapsed}ms` });\n\n    return result;\n  }\n\n  /** Dispose the incremental context. */\n  async dispose(): Promise<void> {\n    if (this.ctx) {\n      await this.ctx.dispose();\n      this.ctx = null;\n      logger.debug('esbuild context disposed');\n    }\n  }\n}\n"],"mappings":"AAAA,SAAS,OAA4C,eAAe;AACpE,OAAO,UAAU;AACjB,SAAS,iBAAiB;AAE1B,MAAM,SAAS,UAAU,kBAAkB;AAc3C,MAAM,oBAAoB;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,eAAe;AAAA,EAI1B,YAAY,SAAgC;AAH5C,SAAQ,MAA2B;AAIjC,SAAK,UAAU;AAAA,EACjB;AAAA;AAAA,EAGA,MAAM,QAA8B;AAClC,UAAM,WAAW;AAAA,MACf,GAAG;AAAA,MACH,GAAI,KAAK,QAAQ,YAAY,CAAC;AAAA,IAChC;AAEA,WAAO,KAAK,oBAAoB,EAAE,YAAY,KAAK,QAAQ,WAAW,CAAC;AACvE,UAAM,YAAY,KAAK,IAAI;AAE3B,UAAM,SAAS,MAAM,MAAM;AAAA,MACzB,aAAa,CAAC,KAAK,QAAQ,KAAK,QAAQ,KAAK,KAAK,QAAQ,UAAU,CAAC;AAAA,MACrE,SAAS,KAAK,QAAQ,KAAK,QAAQ,KAAK,KAAK,QAAQ,OAAO;AAAA,MAC5D,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,WAAW;AAAA,MACX;AAAA,MACA,UAAU;AAAA,IACZ,CAAC;AAED,UAAM,UAAU,KAAK,IAAI,IAAI;AAC7B,WAAO,KAAK,iBAAiB,EAAE,SAAS,GAAG,OAAO,KAAK,CAAC;AAExD,QAAI,OAAO,OAAO,SAAS,GAAG;AAC5B,aAAO,MAAM,kBAAkB,EAAE,QAAQ,OAAO,OAAO,CAAC;AAAA,IAC1D;AACA,QAAI,OAAO,SAAS,SAAS,GAAG;AAC9B,aAAO,KAAK,oBAAoB,EAAE,UAAU,OAAO,SAAS,CAAC;AAAA,IAC/D;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,gBAA+B;AACnC,UAAM,WAAW;AAAA,MACf,GAAG;AAAA,MACH,GAAI,KAAK,QAAQ,YAAY,CAAC;AAAA,IAChC;AAEA,SAAK,MAAM,MAAM,QAAQ;AAAA,MACvB,aAAa,CAAC,KAAK,QAAQ,KAAK,QAAQ,KAAK,KAAK,QAAQ,UAAU,CAAC;AAAA,MACrE,SAAS,KAAK,QAAQ,KAAK,QAAQ,KAAK,KAAK,QAAQ,OAAO;AAAA,MAC5D,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,WAAW;AAAA,MACX;AAAA,MACA,UAAU;AAAA,IACZ,CAAC;AAED,WAAO,KAAK,qCAAqC;AAAA,EACnD;AAAA;AAAA,EAGA,MAAM,UAAgC;AACpC,QAAI,CAAC,KAAK,KAAK;AACb,YAAM,IAAI,MAAM,sDAAiD;AAAA,IACnE;AAEA,WAAO,MAAM,kCAAkC;AAC/C,UAAM,YAAY,KAAK,IAAI;AAE3B,UAAM,SAAS,MAAM,KAAK,IAAI,QAAQ;AAEtC,UAAM,UAAU,KAAK,IAAI,IAAI;AAC7B,WAAO,KAAK,mBAAmB,EAAE,SAAS,GAAG,OAAO,KAAK,CAAC;AAE1D,WAAO;AAAA,EACT;AAAA;AAAA,EAGA,MAAM,UAAyB;AAC7B,QAAI,KAAK,KAAK;AACZ,YAAM,KAAK,IAAI,QAAQ;AACvB,WAAK,MAAM;AACX,aAAO,MAAM,0BAA0B;AAAA,IACzC;AAAA,EACF;AACF;","names":[]}