@blokjs/runner 0.2.0

package/dist/hmr/FileWatcher.js

@@ -0,0 +1,185 @@
+/**
+ * File Watcher for Hot Module Replacement (HMR)
+ *
+ * Watches file system for changes in nodes, workflows, and triggers,
+ * then emits reload events for the appropriate components.
+ *
+ * Uses Node.js fs.watch with debouncing to avoid duplicate events.
+ */
+import { EventEmitter } from "node:events";
+import { watch } from "node:fs";
+import { readdir, stat } from "node:fs/promises";
+import { extname, join, relative } from "node:path";
+const DEFAULT_CONFIG = {
+    nodePaths: [],
+    workflowPaths: [],
+    triggerPaths: [],
+    extensions: [".ts", ".js", ".json"],
+    debounceMs: 250,
+    ignorePatterns: ["node_modules", "dist", ".git", "__tests__", ".d.ts"],
+    verbose: false,
+};
+export class FileWatcher extends EventEmitter {
+    config;
+    watchers = new Map();
+    debounceTimers = new Map();
+    knownFiles = new Set();
+    running = false;
+    constructor(config = {}) {
+        super();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Start watching all configured directories
+     */
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        const allPaths = [
+            ...this.config.nodePaths.map((p) => ({ path: p, category: "node" })),
+            ...this.config.workflowPaths.map((p) => ({ path: p, category: "workflow" })),
+            ...this.config.triggerPaths.map((p) => ({ path: p, category: "trigger" })),
+        ];
+        for (const { path, category } of allPaths) {
+            await this.watchDirectory(path, category);
+        }
+        this.emit("ready", { watchedPaths: allPaths.map((p) => p.path) });
+    }
+    /**
+     * Stop all watchers and clean up
+     */
+    async stop() {
+        this.running = false;
+        for (const [_path, watcher] of this.watchers) {
+            watcher.close();
+        }
+        this.watchers.clear();
+        for (const timer of this.debounceTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.debounceTimers.clear();
+        this.knownFiles.clear();
+        this.removeAllListeners();
+    }
+    /**
+     * Get current watcher status
+     */
+    getStatus() {
+        return {
+            running: this.running,
+            watchedDirectories: this.watchers.size,
+            knownFiles: this.knownFiles.size,
+        };
+    }
+    async watchDirectory(dirPath, category) {
+        try {
+            // Index existing files
+            await this.indexDirectory(dirPath);
+            // Create recursive watcher
+            const watcher = watch(dirPath, { recursive: true }, (eventType, filename) => {
+                if (!filename)
+                    return;
+                const fullPath = join(dirPath, filename);
+                this.handleFsEvent(eventType, fullPath, dirPath, category);
+            });
+            watcher.on("error", (err) => {
+                this.emit("error", { path: dirPath, error: err });
+            });
+            this.watchers.set(dirPath, watcher);
+            if (this.config.verbose) {
+                this.emit("log", `Watching ${category} directory: ${dirPath}`);
+            }
+        }
+        catch (err) {
+            this.emit("error", { path: dirPath, error: err });
+        }
+    }
+    async indexDirectory(dirPath) {
+        try {
+            const entries = await readdir(dirPath, { recursive: true });
+            for (const entry of entries) {
+                const fullPath = join(dirPath, entry.toString());
+                if (this.shouldIgnore(fullPath))
+                    continue;
+                if (!this.isWatchedExtension(fullPath))
+                    continue;
+                try {
+                    const stats = await stat(fullPath);
+                    if (stats.isFile()) {
+                        this.knownFiles.add(fullPath);
+                    }
+                }
+                catch {
+                    // File may have been deleted between readdir and stat
+                }
+            }
+        }
+        catch {
+            // Directory may not exist yet
+        }
+    }
+    handleFsEvent(eventType, filePath, baseDir, category) {
+        if (this.shouldIgnore(filePath))
+            return;
+        if (!this.isWatchedExtension(filePath))
+            return;
+        // Debounce to avoid duplicate events
+        const existing = this.debounceTimers.get(filePath);
+        if (existing) {
+            clearTimeout(existing);
+        }
+        this.debounceTimers.set(filePath, setTimeout(async () => {
+            this.debounceTimers.delete(filePath);
+            await this.processChange(filePath, baseDir, category);
+        }, this.config.debounceMs));
+    }
+    async processChange(filePath, baseDir, category) {
+        const relativePath = relative(baseDir, filePath);
+        let eventType;
+        try {
+            const stats = await stat(filePath);
+            if (stats.isFile()) {
+                if (this.knownFiles.has(filePath)) {
+                    eventType = `${category}:change`;
+                }
+                else {
+                    this.knownFiles.add(filePath);
+                    eventType = `${category}:add`;
+                }
+            }
+            else {
+                return;
+            }
+        }
+        catch {
+            // File was deleted
+            if (this.knownFiles.has(filePath)) {
+                this.knownFiles.delete(filePath);
+                eventType = `${category}:remove`;
+            }
+            else {
+                return;
+            }
+        }
+        const event = {
+            type: eventType,
+            filePath,
+            relativePath,
+            timestamp: Date.now(),
+        };
+        this.emit("change", event);
+        this.emit(eventType, event);
+        if (this.config.verbose) {
+            this.emit("log", `[HMR] ${eventType}: ${relativePath}`);
+        }
+    }
+    shouldIgnore(filePath) {
+        return this.config.ignorePatterns.some((pattern) => filePath.includes(pattern));
+    }
+    isWatchedExtension(filePath) {
+        const ext = extname(filePath);
+        return this.config.extensions.includes(ext);
+    }
+}
+//# sourceMappingURL=FileWatcher.js.map

package/dist/hmr/FileWatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileWatcher.js","sourceRoot":"","sources":["../../src/hmr/FileWatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAkB,KAAK,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAoCpD,MAAM,cAAc,GAAgC;IACnD,SAAS,EAAE,EAAE;IACb,aAAa,EAAE,EAAE;IACjB,YAAY,EAAE,EAAE;IAChB,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC;IACnC,UAAU,EAAE,GAAG;IACf,cAAc,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC;IACtE,OAAO,EAAE,KAAK;CACd,CAAC;AAEF,MAAM,OAAO,WAAY,SAAQ,YAAY;IACpC,MAAM,CAA8B;IACpC,QAAQ,GAA2B,IAAI,GAAG,EAAE,CAAC;IAC7C,cAAc,GAAgC,IAAI,GAAG,EAAE,CAAC;IACxD,UAAU,GAAgB,IAAI,GAAG,EAAE,CAAC;IACpC,OAAO,GAAG,KAAK,CAAC;IAExB,YAAY,SAA4B,EAAE;QACzC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACV,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,MAAM,QAAQ,GAAG;YAChB,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAe,EAAE,CAAC,CAAC;YAC7E,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,UAAmB,EAAE,CAAC,CAAC;YACrF,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAkB,EAAE,CAAC,CAAC;SACnF,CAAC;QAEF,KAAK,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC3C,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QAErB,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9C,OAAO,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAEtB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,CAAC;YAClD,YAAY,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAE5B,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,SAAS;QACR,OAAO;YACN,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;YACtC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;SAChC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,OAAe,EAAE,QAAyC;QACtF,IAAI,CAAC;YACJ,uBAAuB;YACvB,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YAEnC,2BAA2B;YAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;gBAC3E,IAAI,CAAC,QAAQ;oBAAE,OAAO;gBACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBACzC,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC5D,CAAC,CAAC,CAAC;YAEH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAEpC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,QAAQ,eAAe,OAAO,EAAE,CAAC,CAAC;YAChE,CAAC;QACF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACnD,CAAC;IACF,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,OAAe;QAC3C,IAAI,CAAC;YACJ,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE5D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAEjD,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC;oBAAE,SAAS;gBAC1C,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC;oBAAE,SAAS;gBAEjD,IAAI,CAAC;oBACJ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACnC,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;wBACpB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAC/B,CAAC;gBACF,CAAC;gBAAC,MAAM,CAAC;oBACR,sDAAsD;gBACvD,CAAC;YACF,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,8BAA8B;QAC/B,CAAC;IACF,CAAC;IAEO,aAAa,CACpB,SAAiB,EACjB,QAAgB,EAChB,OAAe,EACf,QAAyC;QAEzC,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC;YAAE,OAAO;QACxC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC;YAAE,OAAO;QAE/C,qCAAqC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,QAAQ,EAAE,CAAC;YACd,YAAY,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,GAAG,CACtB,QAAQ,EACR,UAAU,CAAC,KAAK,IAAI,EAAE;YACrB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACrC,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACvD,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAC1B,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CAC1B,QAAgB,EAChB,OAAe,EACf,QAAyC;QAEzC,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACjD,IAAI,SAAuB,CAAC;QAE5B,IAAI,CAAC;YACJ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnC,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBACpB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACnC,SAAS,GAAG,GAAG,QAAQ,SAAyB,CAAC;gBAClD,CAAC;qBAAM,CAAC;oBACP,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAC9B,SAAS,GAAG,GAAG,QAAQ,MAAsB,CAAC;gBAC/C,CAAC;YACF,CAAC;iBAAM,CAAC;gBACP,OAAO;YACR,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,mBAAmB;YACnB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACjC,SAAS,GAAG,GAAG,QAAQ,SAAyB,CAAC;YAClD,CAAC;iBAAM,CAAC;gBACP,OAAO;YACR,CAAC;QACF,CAAC;QAED,MAAM,KAAK,GAAa;YACvB,IAAI,EAAE,SAAS;YACf,QAAQ;YACR,YAAY;YACZ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACrB,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAE5B,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,SAAS,KAAK,YAAY,EAAE,CAAC,CAAC;QACzD,CAAC;IACF,CAAC;IAEO,YAAY,CAAC,QAAgB;QACpC,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACjF,CAAC;IAEO,kBAAkB,CAAC,QAAgB;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;CACD"}

package/dist/hmr/HmrDevConsole.d.ts

@@ -0,0 +1,13 @@
+/**
+ * HMR Dev Console - Formatted developer-friendly output for hot reload events.
+ *
+ * Subscribes to HotReloadManager events and prints timestamped,
+ * color-coded messages to the console during development.
+ */
+import type { HotReloadManager } from "./HotReloadManager";
+export declare class HmrDevConsole {
+    private hmr;
+    constructor(hmr: HotReloadManager);
+    printStats(): void;
+    private formatEventType;
+}

package/dist/hmr/HmrDevConsole.js

@@ -0,0 +1,46 @@
+/**
+ * HMR Dev Console - Formatted developer-friendly output for hot reload events.
+ *
+ * Subscribes to HotReloadManager events and prints timestamped,
+ * color-coded messages to the console during development.
+ */
+export class HmrDevConsole {
+    hmr;
+    constructor(hmr) {
+        this.hmr = hmr;
+        this.hmr.on("ready", (info) => {
+            console.log("\n  [HMR] Hot reload active");
+            console.log(`  Watching ${info.watchedPaths.length} director${info.watchedPaths.length === 1 ? "y" : "ies"}`);
+            for (const p of info.watchedPaths) {
+                console.log(`    - ${p}`);
+            }
+            console.log("");
+        });
+        this.hmr.on("reload", (event) => {
+            const timestamp = new Date().toLocaleTimeString();
+            const label = this.formatEventType(event.type);
+            console.log(`  [HMR] [${timestamp}] ${label}: ${event.relativePath}`);
+        });
+        this.hmr.on("reload-error", ({ event, error }) => {
+            const timestamp = new Date().toLocaleTimeString();
+            console.error(`  [HMR] [${timestamp}] ERROR ${event.relativePath}: ${error.message}`);
+        });
+        this.hmr.on("disabled", ({ reason }) => {
+            console.error(`\n  [HMR] DISABLED: ${reason}\n`);
+        });
+    }
+    printStats() {
+        const stats = this.hmr.getStats();
+        const uptime = Math.round(stats.uptime / 1000);
+        console.log("\n  [HMR] Stats:");
+        console.log(`    Total reloads: ${stats.totalReloads}`);
+        console.log(`    Nodes: ${stats.nodeReloads} | Workflows: ${stats.workflowReloads} | Triggers: ${stats.triggerReloads}`);
+        console.log(`    Errors: ${stats.errors}`);
+        console.log(`    Uptime: ${uptime}s\n`);
+    }
+    formatEventType(type) {
+        const [category, action] = type.split(":");
+        return `${category} ${action}`;
+    }
+}
+//# sourceMappingURL=HmrDevConsole.js.map

package/dist/hmr/HmrDevConsole.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HmrDevConsole.js","sourceRoot":"","sources":["../../src/hmr/HmrDevConsole.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,OAAO,aAAa;IACL;IAApB,YAAoB,GAAqB;QAArB,QAAG,GAAH,GAAG,CAAkB;QACxC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAgC,EAAE,EAAE;YACzD,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,YAAY,CAAC,MAAM,YAAY,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9G,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACnC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC3B,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAe,EAAE,EAAE;YACzC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,kBAAkB,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,YAAY,SAAS,KAAK,KAAK,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAqC,EAAE,EAAE;YACnF,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,kBAAkB,EAAE,CAAC;YAClD,OAAO,CAAC,KAAK,CAAC,YAAY,SAAS,WAAW,KAAK,CAAC,YAAY,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACvF,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,EAAE,MAAM,EAAsB,EAAE,EAAE;YAC1D,OAAO,CAAC,KAAK,CAAC,uBAAuB,MAAM,IAAI,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,UAAU;QACT,MAAM,KAAK,GAAmB,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,sBAAsB,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CACV,cAAc,KAAK,CAAC,WAAW,iBAAiB,KAAK,CAAC,eAAe,gBAAgB,KAAK,CAAC,cAAc,EAAE,CAC3G,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,KAAK,CAAC,CAAC;IACzC,CAAC;IAEO,eAAe,CAAC,IAAY;QACnC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3C,OAAO,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC;IAChC,CAAC;CACD"}

package/dist/hmr/HotReloadManager.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Hot Reload Manager for Blok Framework
+ *
+ * Orchestrates hot module replacement across the framework:
+ * - Node hot-reload: Invalidates module cache and re-imports changed nodes
+ * - Workflow hot-reload: Re-reads workflow JSON/TS and reinitializes Configuration
+ * - Trigger hot-reload: Signals triggers to reload their workflow registrations
+ *
+ * Integrates with RuntimeRegistry.replace() for runtime adapter hot-swapping.
+ */
+import { EventEmitter } from "node:events";
+import { type FileWatcherConfig, type HMREvent } from "./FileWatcher";
+export interface HotReloadStats {
+    totalReloads: number;
+    nodeReloads: number;
+    workflowReloads: number;
+    triggerReloads: number;
+    errors: number;
+    lastReload: number | null;
+    lastError: string | null;
+    uptime: number;
+}
+export type ReloadHandler = (event: HMREvent) => Promise<void> | void;
+export interface HotReloadManagerConfig extends FileWatcherConfig {
+    /** Enable/disable hot reload (default: true in dev, false in prod) */
+    enabled?: boolean;
+    /** Maximum consecutive errors before disabling hot-reload */
+    maxConsecutiveErrors?: number;
+    /** Cooldown between reloads of the same file in ms (default: 1000) */
+    cooldownMs?: number;
+}
+export declare class HotReloadManager extends EventEmitter {
+    private fileWatcher;
+    private config;
+    private stats;
+    private startTime;
+    private consecutiveErrors;
+    private disabled;
+    private cooldowns;
+    /** User-registered handlers for specific event types */
+    private nodeChangeHandlers;
+    private workflowChangeHandlers;
+    private triggerChangeHandlers;
+    constructor(config?: HotReloadManagerConfig);
+    /**
+     * Start the hot reload system
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the hot reload system
+     */
+    stop(): Promise<void>;
+    /**
+     * Register a handler for node changes
+     */
+    onNodeChange(handler: ReloadHandler): void;
+    /**
+     * Register a handler for workflow changes
+     */
+    onWorkflowChange(handler: ReloadHandler): void;
+    /**
+     * Register a handler for trigger changes
+     */
+    onTriggerChange(handler: ReloadHandler): void;
+    /**
+     * Get current stats
+     */
+    getStats(): HotReloadStats;
+    /**
+     * Invalidate a module from Node.js require cache
+     */
+    invalidateModule(modulePath: string): boolean;
+    /**
+     * Generate a cache-busted path for ESM dynamic import().
+     * Node.js does not expose an ESM module cache, so we append
+     * a timestamp query string to force re-evaluation.
+     */
+    invalidateEsmModule(modulePath: string): string;
+    /**
+     * Invalidate all modules matching a pattern
+     */
+    invalidateModules(pattern: string | RegExp): number;
+    private handleChange;
+}

package/dist/hmr/HotReloadManager.js

@@ -0,0 +1,195 @@
+/**
+ * Hot Reload Manager for Blok Framework
+ *
+ * Orchestrates hot module replacement across the framework:
+ * - Node hot-reload: Invalidates module cache and re-imports changed nodes
+ * - Workflow hot-reload: Re-reads workflow JSON/TS and reinitializes Configuration
+ * - Trigger hot-reload: Signals triggers to reload their workflow registrations
+ *
+ * Integrates with RuntimeRegistry.replace() for runtime adapter hot-swapping.
+ */
+import { EventEmitter } from "node:events";
+import { FileWatcher } from "./FileWatcher";
+export class HotReloadManager extends EventEmitter {
+    fileWatcher;
+    config;
+    stats;
+    startTime;
+    consecutiveErrors = 0;
+    disabled = false;
+    cooldowns = new Map();
+    /** User-registered handlers for specific event types */
+    nodeChangeHandlers = [];
+    workflowChangeHandlers = [];
+    triggerChangeHandlers = [];
+    constructor(config = {}) {
+        super();
+        this.config = {
+            enabled: process.env.NODE_ENV !== "production",
+            maxConsecutiveErrors: 5,
+            cooldownMs: 1000,
+            ...config,
+        };
+        this.startTime = Date.now();
+        this.stats = {
+            totalReloads: 0,
+            nodeReloads: 0,
+            workflowReloads: 0,
+            triggerReloads: 0,
+            errors: 0,
+            lastReload: null,
+            lastError: null,
+            uptime: 0,
+        };
+        this.fileWatcher = new FileWatcher(this.config);
+    }
+    /**
+     * Start the hot reload system
+     */
+    async start() {
+        if (!this.config.enabled) {
+            this.emit("log", "[HMR] Hot reload is disabled (production mode)");
+            return;
+        }
+        this.fileWatcher.on("change", (event) => this.handleChange(event));
+        this.fileWatcher.on("error", (err) => {
+            this.emit("error", err);
+        });
+        this.fileWatcher.on("log", (msg) => this.emit("log", msg));
+        this.fileWatcher.on("ready", (info) => {
+            this.emit("ready", info);
+            this.emit("log", `[HMR] Hot reload active, watching ${info.watchedPaths.length} directories`);
+        });
+        await this.fileWatcher.start();
+    }
+    /**
+     * Stop the hot reload system
+     */
+    async stop() {
+        await this.fileWatcher.stop();
+        this.cooldowns.clear();
+        this.emit("log", "[HMR] Hot reload stopped");
+    }
+    /**
+     * Register a handler for node changes
+     */
+    onNodeChange(handler) {
+        this.nodeChangeHandlers.push(handler);
+    }
+    /**
+     * Register a handler for workflow changes
+     */
+    onWorkflowChange(handler) {
+        this.workflowChangeHandlers.push(handler);
+    }
+    /**
+     * Register a handler for trigger changes
+     */
+    onTriggerChange(handler) {
+        this.triggerChangeHandlers.push(handler);
+    }
+    /**
+     * Get current stats
+     */
+    getStats() {
+        return {
+            ...this.stats,
+            uptime: Date.now() - this.startTime,
+        };
+    }
+    /**
+     * Invalidate a module from Node.js require cache
+     */
+    invalidateModule(modulePath) {
+        try {
+            // Clear from require cache
+            const resolved = require.resolve(modulePath);
+            if (require.cache[resolved]) {
+                delete require.cache[resolved];
+                return true;
+            }
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Generate a cache-busted path for ESM dynamic import().
+     * Node.js does not expose an ESM module cache, so we append
+     * a timestamp query string to force re-evaluation.
+     */
+    invalidateEsmModule(modulePath) {
+        return `${modulePath}?t=${Date.now()}`;
+    }
+    /**
+     * Invalidate all modules matching a pattern
+     */
+    invalidateModules(pattern) {
+        let count = 0;
+        const regex = typeof pattern === "string" ? new RegExp(pattern) : pattern;
+        for (const key of Object.keys(require.cache)) {
+            if (regex.test(key)) {
+                delete require.cache[key];
+                count++;
+            }
+        }
+        return count;
+    }
+    async handleChange(event) {
+        if (this.disabled)
+            return;
+        // Check cooldown
+        const lastReload = this.cooldowns.get(event.filePath);
+        if (lastReload && Date.now() - lastReload < (this.config.cooldownMs || 1000)) {
+            return;
+        }
+        this.cooldowns.set(event.filePath, Date.now());
+        try {
+            const category = event.type.split(":")[0];
+            let handlers;
+            switch (category) {
+                case "node":
+                    handlers = this.nodeChangeHandlers;
+                    // Invalidate module cache for the changed node
+                    this.invalidateModule(event.filePath);
+                    this.stats.nodeReloads++;
+                    break;
+                case "workflow":
+                    handlers = this.workflowChangeHandlers;
+                    this.stats.workflowReloads++;
+                    break;
+                case "trigger":
+                    handlers = this.triggerChangeHandlers;
+                    this.stats.triggerReloads++;
+                    break;
+                default:
+                    return;
+            }
+            // Execute all registered handlers
+            for (const handler of handlers) {
+                await handler(event);
+            }
+            this.stats.totalReloads++;
+            this.stats.lastReload = Date.now();
+            this.consecutiveErrors = 0;
+            this.emit("reload", event);
+            this.emit("log", `[HMR] ${event.type}: ${event.relativePath} reloaded successfully`);
+        }
+        catch (err) {
+            this.stats.errors++;
+            this.consecutiveErrors++;
+            this.stats.lastError = err instanceof Error ? err.message : String(err);
+            this.emit("reload-error", { event, error: err });
+            this.emit("log", `[HMR] Error reloading ${event.relativePath}: ${this.stats.lastError}`);
+            if (this.consecutiveErrors >= (this.config.maxConsecutiveErrors || 5)) {
+                this.disabled = true;
+                this.emit("disabled", {
+                    reason: `Too many consecutive errors (${this.consecutiveErrors})`,
+                });
+                this.emit("log", `[HMR] Hot reload disabled after ${this.consecutiveErrors} consecutive errors`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=HotReloadManager.js.map

package/dist/hmr/HotReloadManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HotReloadManager.js","sourceRoot":"","sources":["../../src/hmr/HotReloadManager.ts"],"names":[],"mappings":"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"}

package/dist/hmr/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Hot Module Replacement (HMR) System for Blok
+ *
+ * Provides file-watching and hot-reload capabilities for development:
+ * - FileWatcher: Low-level file system monitoring with debouncing
+ * - HotReloadManager: High-level orchestrator for node/workflow/trigger reloads
+ *
+ * @example
+ * ```typescript
+ * import { HotReloadManager } from "@blokjs/runner";
+ *
+ * const hmr = new HotReloadManager({
+ *   nodePaths: ["./src/nodes"],
+ *   workflowPaths: ["./workflows"],
+ *   triggerPaths: ["./src/triggers"],
+ *   verbose: true,
+ * });
+ *
+ * // Register reload handlers
+ * hmr.onNodeChange(async (event) => {
+ *   console.log(`Node changed: ${event.relativePath}`);
+ *   // Re-register node in NodeMap
+ *   const mod = await import(event.filePath);
+ *   nodeMap.addNode(event.relativePath, mod.default);
+ * });
+ *
+ * hmr.onWorkflowChange(async (event) => {
+ *   console.log(`Workflow changed: ${event.relativePath}`);
+ *   // Workflow will be re-read on next request via Configuration.init()
+ * });
+ *
+ * await hmr.start();
+ * ```
+ */
+export { FileWatcher } from "./FileWatcher";
+export type { FileWatcherConfig, HMREvent, HMREventType } from "./FileWatcher";
+export { HotReloadManager } from "./HotReloadManager";
+export type { HotReloadManagerConfig, HotReloadStats, ReloadHandler } from "./HotReloadManager";
+export { HmrDevConsole } from "./HmrDevConsole";

package/dist/hmr/index.js

@@ -0,0 +1,38 @@
+/**
+ * Hot Module Replacement (HMR) System for Blok
+ *
+ * Provides file-watching and hot-reload capabilities for development:
+ * - FileWatcher: Low-level file system monitoring with debouncing
+ * - HotReloadManager: High-level orchestrator for node/workflow/trigger reloads
+ *
+ * @example
+ * ```typescript
+ * import { HotReloadManager } from "@blokjs/runner";
+ *
+ * const hmr = new HotReloadManager({
+ *   nodePaths: ["./src/nodes"],
+ *   workflowPaths: ["./workflows"],
+ *   triggerPaths: ["./src/triggers"],
+ *   verbose: true,
+ * });
+ *
+ * // Register reload handlers
+ * hmr.onNodeChange(async (event) => {
+ *   console.log(`Node changed: ${event.relativePath}`);
+ *   // Re-register node in NodeMap
+ *   const mod = await import(event.filePath);
+ *   nodeMap.addNode(event.relativePath, mod.default);
+ * });
+ *
+ * hmr.onWorkflowChange(async (event) => {
+ *   console.log(`Workflow changed: ${event.relativePath}`);
+ *   // Workflow will be re-read on next request via Configuration.init()
+ * });
+ *
+ * await hmr.start();
+ * ```
+ */
+export { FileWatcher } from "./FileWatcher";
+export { HotReloadManager } from "./HotReloadManager";
+export { HmrDevConsole } from "./HmrDevConsole";
+//# sourceMappingURL=index.js.map

package/dist/hmr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hmr/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}