@harperfast/harper-pro 5.0.25 → 5.1.0-beta.1

package/dist/core/components/EntryHandler.js

@@ -4,25 +4,39 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EntryHandler = void 0;
-const harper_logger_js_1 = require("../utility/logging/harper_logger.js");
+const harper_logger_ts_1 = require("../utility/logging/harper_logger.js");
 const node_events_1 = require("node:events");
-const Component_js_1 = require("./Component.js");
+const Component_ts_1 = require("./Component.js");
 const chokidar_1 = __importDefault(require("chokidar"));
 const node_path_1 = require("node:path");
 const promises_1 = require("node:fs/promises");
-const deriveURLPath_js_1 = require("./deriveURLPath.js");
+const deriveURLPath_ts_1 = require("./deriveURLPath.js");
 const micromatch_1 = require("micromatch");
+const watcherFallback_ts_1 = require("../utility/watcherFallback.js");
 class EntryHandler extends node_events_1.EventEmitter {
     #component;
     #watcher;
     #logger;
     #pendingFileReads;
     #isInitialScanComplete;
+    // When true, #watch() short-circuits without creating a chokidar watcher.
+    // pause() sets it, resume() clears it. Lets a deploy quiesce the watcher
+    // without losing the EntryHandler instance (and therefore listener
+    // attachments registered by plugins via scope.handleEntry(handler)).
+    #paused = false;
+    // Tracks the in-flight close() promise from pause() so resume() can await
+    // the old watcher's inotify handles releasing before installing a fresh
+    // chokidar instance — otherwise a rapid pause→resume can overlap teardown
+    // and setup, which under inotify pressure can produce spurious EMFILE.
+    #pausedClose;
+    #usingPolling = false;
+    #closed = false;
+    #openCount = 0;
     ready;
     constructor(name, directory, config, logger) {
         super();
-        this.#component = new Component_js_1.Component(name, directory, castConfig(config));
-        this.#logger = logger || (0, harper_logger_js_1.loggerWithTag)(name);
+        this.#component = new Component_ts_1.Component(name, directory, castConfig(config));
+        this.#logger = logger || (0, harper_logger_ts_1.loggerWithTag)(name);
         this.#pendingFileReads = new Set();
         this.#isInitialScanComplete = false;
         this.ready = (0, node_events_1.once)(this, 'ready');
@@ -43,7 +57,7 @@ class EntryHandler extends node_events_1.EventEmitter {
         switch (event) {
             case 'add':
             case 'change': {
-                const urlPath = (0, deriveURLPath_js_1.deriveURLPath)(this.#component, path, 'file');
+                const urlPath = (0, deriveURLPath_ts_1.deriveURLPath)(this.#component, path, 'file');
                 const fileReadPromise = (0, promises_1.readFile)(absolutePath)
                     .then((contents) => {
                     const entry = {
@@ -65,7 +79,7 @@ class EntryHandler extends node_events_1.EventEmitter {
                 break;
             }
             case 'unlink': {
-                const urlPath = (0, deriveURLPath_js_1.deriveURLPath)(this.#component, path, 'file');
+                const urlPath = (0, deriveURLPath_ts_1.deriveURLPath)(this.#component, path, 'file');
                 const entry = {
                     eventType: event,
                     entryType: 'file',
@@ -79,7 +93,7 @@ class EntryHandler extends node_events_1.EventEmitter {
             }
             case 'addDir':
             case 'unlinkDir': {
-                const urlPath = (0, deriveURLPath_js_1.deriveURLPath)(this.#component, path, 'directory');
+                const urlPath = (0, deriveURLPath_ts_1.deriveURLPath)(this.#component, path, 'directory');
                 const entry = {
                     eventType: event,
                     entryType: 'directory',
@@ -94,6 +108,25 @@ class EntryHandler extends node_events_1.EventEmitter {
         }
     }
     #handleError(error) {
+        if ((0, watcherFallback_ts_1.isWatcherExhaustionError)(error)) {
+            // Swallow every exhaustion error — chokidar can emit several before the
+            // failed native watcher closes, and we don't want a flurry of ENOSPC to
+            // surface to consumers in the middle of recovery.
+            if (!this.#usingPolling) {
+                (0, watcherFallback_ts_1.warnWatcherFallback)(this.#component.directory);
+                this.#usingPolling = true;
+                // Reopen with polling. #watch() itself guards against reopen-after-close.
+                // The .catch is required because #watch() internally awaits the failed
+                // watcher's close(), which can reject under the same FD/inotify pressure
+                // that triggered this path; without it Node would treat that as an
+                // unhandled rejection (matches the .catch pattern used in
+                // OptionsWatcher / RootConfigWatcher).
+                this.#watch().catch(() => {
+                    // Teardown errors on an already-failed watcher are not actionable.
+                });
+            }
+            return;
+        }
         this.emit('error', error);
     }
     #handleReady() {
@@ -110,18 +143,61 @@ class EntryHandler extends node_events_1.EventEmitter {
         }
     }
     async #watch() {
+        // If pause() retained an in-flight close, wait for it to release inotify
+        // handles before we install a new watcher. Otherwise a fast pause→resume
+        // can overlap teardown and setup under inotify pressure.
+        if (this.#pausedClose) {
+            await this.#pausedClose;
+            this.#pausedClose = undefined;
+        }
         await this.#watcher?.close();
         this.#watcher = undefined;
+        // If close() landed while a previous close()/recreate was awaiting, don't
+        // install a fresh watcher — it would outlive the EntryHandler.
+        if (this.#closed)
+            return this.ready;
+        // pause() may have landed in the gap before our async close resolved.
+        // If so, do not install a replacement watcher — resume() will.
+        if (this.#paused)
+            return this.ready;
+        // When a fresh watcher is installed (after pause+resume, or update), the
+        // initial scan emits add events anew, so reset the readiness latch so
+        // `ready` resolves after the new scan completes.
+        this.#isInitialScanComplete = false;
         const allowedBases = this.#component.patternBases.map((base) => (0, node_path_1.join)(this.#component.directory, base));
+        this.#openCount++;
         this.#watcher = chokidar_1.default
             .watch(this.#component.commonPatternBase, {
             cwd: this.#component.directory,
             persistent: false,
+            followSymlinks: false,
+            ...(this.#usingPolling ? watcherFallback_ts_1.DIRECTORY_POLLING_FALLBACK_OPTIONS : {}),
             ignored: (path) => {
                 const normalizedPath = path.replace(/\\/g, '/');
                 const normalizedBases = allowedBases.map((base) => base.replace(/\\/g, '/'));
-                return (normalizedPath !== this.#component.directory.replace(/\\/g, '/') &&
-                    normalizedBases.every((base) => !normalizedPath.startsWith(base)));
+                const normalizedDirectory = this.#component.directory.replace(/\\/g, '/');
+                // Determine the path relative to the component directory. Leading '/' is preserved
+                // (or empty when the path *is* the component directory) so the regex anchors below
+                // can use `(?:^|/)` to match the first segment without false positives on names
+                // that merely contain the same substring (e.g. `mynode_modules`, `notgit`).
+                const relativePath = normalizedPath.startsWith(normalizedDirectory)
+                    ? normalizedPath.slice(normalizedDirectory.length)
+                    : normalizedPath;
+                // Skip node_modules at any depth. This allows plugins loaded from node_modules
+                // to still watch their own component files while ignoring their dependencies.
+                if (/(?:^|\/)node_modules(?:\/|$)/.test(relativePath))
+                    return true;
+                // Skip transient package manager and VCS artifacts. Without these, an in-place
+                // `npm install` during a component deploy writes log files and atomic-rename
+                // temp directories that fire change events and drive an auto-reload restart
+                // storm — see harper#488.
+                if (/(?:^|\/)\.git(?:\/|$)/.test(relativePath))
+                    return true;
+                if (/(?:^|\/)\.tmp-/.test(relativePath))
+                    return true;
+                if (/(?:^|\/)(?:npm-debug|yarn-error|yarn-debug|pnpm-debug)\.log(?:\/|$)/.test(relativePath))
+                    return true;
+                return (normalizedPath !== normalizedDirectory && normalizedBases.every((base) => !normalizedPath.startsWith(base)));
             },
         })
             .on('all', this.#handleAll.bind(this))
@@ -129,15 +205,79 @@ class EntryHandler extends node_events_1.EventEmitter {
             .on('ready', this.#handleReady.bind(this));
         return this.ready;
     }
+    // Test-only: simulate the underlying chokidar watcher emitting an error.
+    // Exposed so the polling-fallback path can be exercised without triggering a
+    // real ENOSPC/EMFILE on the host.
+    _simulateWatcherErrorForTests(error) {
+        this.#handleError(error);
+    }
+    // Test-only: whether the watcher has fallen back to polling.
+    get _usingPollingForTests() {
+        return this.#usingPolling;
+    }
+    // Test-only: number of times the underlying watcher has been (re)opened.
+    // Used to assert that a close()-during-fallback race didn't install a
+    // replacement watcher.
+    get _openCountForTests() {
+        return this.#openCount;
+    }
     close() {
-        this.#watcher?.close();
+        this.#closed = true;
+        const pendingReads = [...this.#pendingFileReads];
+        const watcherClose = this.#watcher ? Promise.resolve(this.#watcher.close()).catch(() => { }) : Promise.resolve();
         this.#watcher = undefined;
+        // If paused, there may be an in-flight close from pause() that hasn't settled yet.
+        // Include it so close() doesn't resolve while inotify handles are still releasing.
+        const pausedClose = this.#pausedClose ?? Promise.resolve();
+        this.#pausedClose = undefined;
         this.emit('close');
         this.removeAllListeners();
-        return this;
+        return Promise.allSettled([watcherClose, pausedClose, ...pendingReads]).then(() => this);
+    }
+    /**
+     * Quiesce the watcher without tearing down the EntryHandler. Closes the
+     * underlying chokidar watcher (releasing inotify handles for the watched
+     * tree) but preserves all listeners attached to this instance, so plugins
+     * that registered `scope.handleEntry(handler)` keep their handler wired up
+     * across the pause.
+     *
+     * Idempotent. Awaiting `ready` while paused will not resolve until resume().
+     */
+    pause() {
+        this.#paused = true;
+        // Reset `ready` to a fresh pending promise so the documented "awaiting
+        // ready while paused will not resolve until resume()" contract holds even
+        // when the watcher had already become ready before pause(). The next
+        // 'ready' emit will come from the chokidar instance installed by resume().
+        this.ready = (0, node_events_1.once)(this, 'ready');
+        if (this.#watcher) {
+            // Retain the close promise so resume()→#watch() can await full
+            // teardown before opening a new watcher.
+            this.#pausedClose = Promise.resolve(this.#watcher.close()).catch(() => {
+                // Teardown errors aren't actionable; swallow so resume can proceed.
+            });
+            this.#watcher = undefined;
+        }
+    }
+    /**
+     * Reinstate the watcher previously stopped by pause(). The fresh chokidar
+     * instance does an initial scan and emits add events for every file
+     * currently matching the configured globs — by design, since the typical
+     * caller (Scope, on deploy:end) wants plugins to see the post-deploy tree
+     * as if loading cold.
+     *
+     * No-op if not currently paused.
+     */
+    resume() {
+        if (!this.#paused)
+            return this.ready;
+        this.#paused = false;
+        // `this.ready` was already reset to a pending promise in pause(); just
+        // trigger the watcher recreation and let its 'ready' emit resolve it.
+        return this.#watch();
     }
     update(config) {
-        this.#component = new Component_js_1.Component(this.name, this.directory, castConfig(config));
+        this.#component = new Component_ts_1.Component(this.name, this.directory, castConfig(config));
         return this.#watch();
     }
 }

package/dist/core/components/EntryHandler.js.map

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

package/dist/core/components/OptionsWatcher.js

@@ -4,14 +4,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OptionsWatcher = exports.CannotSetPropertyError = exports.KeyDoesNotExistError = exports.InvalidValueTypeError = exports.InvariantUninitializedOptionsWatcherError = exports.UninitializedOptionsWatcherError = exports.OptionsWatcherConfigFileError = void 0;
-const harper_logger_js_1 = require("../utility/logging/harper_logger.js");
+const harper_logger_ts_1 = require("../utility/logging/harper_logger.js");
 const events_1 = require("events");
 const yaml_1 = __importDefault(require("yaml"));
 const chokidar_1 = __importDefault(require("chokidar"));
 const promises_1 = require("node:fs/promises");
 const util_1 = require("util");
-const DEFAULT_CONFIG_js_1 = require("./DEFAULT_CONFIG.js");
+const DEFAULT_CONFIG_ts_1 = require("./DEFAULT_CONFIG.js");
 const lodash_1 = require("lodash");
+const watcherFallback_ts_1 = require("../utility/watcherFallback.js");
 // This is uniquely for errors coming from the chokidar watcher of the config file.
 class OptionsWatcherConfigFileError extends Error {
     constructor(configFilePath, error) {
@@ -71,15 +72,28 @@ class OptionsWatcher extends events_1.EventEmitter {
     #rootConfig;
     #name;
     #logger;
+    #usingPolling;
+    #closed;
+    #openCount = 0;
+    #pendingReads = new Set();
     ready;
     constructor(name, filePath, logger) {
         super();
         this.#name = name;
         this.#filePath = filePath;
-        this.#logger = logger || (0, harper_logger_js_1.loggerWithTag)(name);
+        this.#logger = logger || (0, harper_logger_ts_1.loggerWithTag)(name);
+        this.#usingPolling = false;
+        this.#closed = false;
         this.ready = (0, events_1.once)(this, 'ready');
+        this.#openWatcher();
+    }
+    #openWatcher() {
+        this.#openCount++;
         this.#watcher = chokidar_1.default
-            .watch(filePath, { persistent: false })
+            .watch(this.#filePath, {
+            persistent: false,
+            ...(this.#usingPolling ? watcherFallback_ts_1.POLLING_FALLBACK_OPTIONS : {}),
+        })
             .on('add', this.#handleChange.bind(this))
             .on('change', this.#handleChange.bind(this))
             .on('error', this.#handleError.bind(this))
@@ -87,9 +101,10 @@ class OptionsWatcher extends events_1.EventEmitter {
             .on('ready', this.#handleChange.bind(this));
     }
     #handleChange() {
-        (0, promises_1.readFile)(this.#filePath, 'utf-8')
+        const read = (0, promises_1.readFile)(this.#filePath, 'utf-8')
             .then((contents) => {
-            this.#rootConfig = yaml_1.default.parse(contents);
+            const parsed = yaml_1.default.parse(contents);
+            this.#rootConfig = parsed && typeof parsed === 'object' ? parsed : undefined;
             // If the extension is in the config file
             if (this.#rootConfig && this.#name in this.#rootConfig) {
                 // If a config object does not exist
@@ -131,9 +146,36 @@ class OptionsWatcher extends events_1.EventEmitter {
                 return;
             }
             this.emit('error', error);
+        })
+            .finally(() => {
+            this.#pendingReads.delete(read);
         });
+        this.#pendingReads.add(read);
     }
     #handleError(error) {
+        if ((0, watcherFallback_ts_1.isWatcherExhaustionError)(error)) {
+            // Swallow every exhaustion error — chokidar can emit several before the
+            // failed native watcher closes, and we don't want a flurry of ENOSPC to
+            // surface to consumers in the middle of recovery.
+            if (!this.#usingPolling) {
+                (0, watcherFallback_ts_1.warnWatcherFallback)(this.#filePath);
+                this.#usingPolling = true;
+                // Close the failed native watcher and reopen with polling. Guard
+                // against reopen-after-close: the caller may have invoked close()
+                // while this teardown was in flight. The .catch is required because
+                // `finally` would re-raise a teardown rejection as an unhandled one.
+                this.#watcher
+                    .close()
+                    .catch(() => {
+                    // Teardown errors on an already-failed watcher are not actionable.
+                })
+                    .finally(() => {
+                    if (!this.#closed)
+                        this.#openWatcher();
+                });
+            }
+            return;
+        }
         this.emit('error', new OptionsWatcherConfigFileError(this.#filePath, error));
     }
     #handleUnlink(path) {
@@ -142,7 +184,7 @@ class OptionsWatcher extends events_1.EventEmitter {
         this.emit('remove');
     }
     #resetConfig() {
-        this.#rootConfig = DEFAULT_CONFIG_js_1.DEFAULT_CONFIG;
+        this.#rootConfig = DEFAULT_CONFIG_ts_1.DEFAULT_CONFIG;
         this.#scopedConfig = this.#rootConfig[this.#name];
     }
     /**
@@ -242,14 +284,34 @@ class OptionsWatcher extends events_1.EventEmitter {
         obj[keys[keys.length - 1]] = value;
         this.emit('change', keys, value, this.#scopedConfig);
     }
+    // Test-only: simulate the underlying chokidar watcher emitting an error.
+    // Exposed so the polling-fallback path can be exercised without triggering a
+    // real ENOSPC/EMFILE on the host.
+    _simulateWatcherErrorForTests(error) {
+        this.#handleError(error);
+    }
+    // Test-only: whether the watcher has fallen back to polling.
+    get _usingPollingForTests() {
+        return this.#usingPolling;
+    }
+    // Test-only: number of times the underlying watcher has been (re)opened.
+    // Used to assert that a close()-during-fallback race didn't install a
+    // replacement watcher.
+    get _openCountForTests() {
+        return this.#openCount;
+    }
     /**
-     * Closes the underlying file watcher, emits the `close` event, and removes any listeners on the OptionsWatcher instance
+     * Closes the underlying file watcher and drains any pending config-file reads.
+     * Emits `close` synchronously, removes all listeners, then returns a Promise that
+     * resolves once the chokidar watcher has fully stopped and all in-flight reads settle.
      */
     close() {
-        this.#watcher.close();
+        this.#closed = true;
+        const pendingReads = [...this.#pendingReads];
+        const watcherClose = Promise.resolve(this.#watcher.close()).catch(() => { });
         this.emit('close');
         this.removeAllListeners();
-        return this;
+        return Promise.allSettled([watcherClose, ...pendingReads]).then(() => this);
     }
     /**
      * Get a value from the configuration using an array of strings representing the key.

package/dist/core/components/OptionsWatcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"OptionsWatcher.js","sourceRoot":"","sources":["../../../core/components/OptionsWatcher.ts"],"names":[],"mappings":";;;;;;AACA,0EAAoE;AACpE,mCAA4C;AAC5C,gDAAwB;AACxB,wDAAoD;AACpD,+CAA4C;AAC5C,+BAAyC;AACzC,2DAAqD;AACrD,mCAAmC;AAgBnC,mFAAmF;AACnF,MAAa,6BAA8B,SAAQ,KAAK;IACvD,YAAY,cAAsB,EAAE,KAAc;QACjD,KAAK,CACJ,8BAA8B,cAAc,KAAK,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,CAC5I,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC7C,CAAC;CACD;AAPD,sEAOC;AAED,MAAa,gCAAiC,SAAQ,KAAK;IAC1D;QACC,KAAK,CACJ,8HAA8H,CAC9H,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IAChD,CAAC;CACD;AAPD,4EAOC;AAED,MAAa,yCAA0C,SAAQ,KAAK;IACnE;QACC,KAAK,CAAC,mFAAmF,CAAC,CAAC;QAC3F,IAAI,CAAC,IAAI,GAAG,2CAA2C,CAAC;IACzD,CAAC;CACD;AALD,8FAKC;AAED,MAAa,qBAAsB,SAAQ,KAAK;IAC/C,YAAY,IAAc,EAAE,KAAc;QACzC,KAAK,CACJ,8BAA8B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,6EAA6E,OAAO,KAAK,GAAG,CACxI,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACrC,CAAC;CACD;AAPD,sDAOC;AAED,MAAa,oBAAqB,SAAQ,KAAK;IAC9C,YAAY,IAAc,EAAE,GAAW;QACtC,KAAK,CAAC,uBAAuB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,kBAAkB,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACpC,CAAC;CACD;AALD,oDAKC;AAED,MAAa,sBAAuB,SAAQ,KAAK;IAChD,YAAY,IAAc;QACzB,KAAK,CAAC,uBAAuB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACtC,CAAC;CACD;AALD,wDAKC;AAED;;;;;;;;GAQG;AACH,MAAa,cAAe,SAAQ,qBAAoC;IACvE,SAAS,CAAS;IAClB,QAAQ,CAAY;IACpB,aAAa,CAAe;IAC5B,WAAW,CAAU;IACrB,KAAK,CAAS;IACd,OAAO,CAAS;IAChB,KAAK,CAAiB;IAEtB,YAAY,IAAY,EAAE,QAAgB,EAAE,MAAe;QAC1D,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,IAAA,gCAAa,EAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,IAAA,aAAI,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,kBAAQ;aACtB,KAAK,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;aACtC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aACxC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aAC3C,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aACzC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aAC3C,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,aAAa;QACZ,IAAA,mBAAQ,EAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC;aAC/B,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YAClB,IAAI,CAAC,WAAW,GAAG,cAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACxC,yCAAyC;YACzC,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACxD,oCAAoC;gBACpC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;oBACzB,SAAS;oBACT,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAClD,yBAAyB;oBACzB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;gBACxC,CAAC;qBAAM,CAAC;oBACP,sDAAsD;oBACtD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;gBAC/D,CAAC;YACF,CAAC;iBAAM,CAAC;gBACP,wDAAwD;gBACxD,yDAAyD;gBACzD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;oBACxB,iCAAiC;oBACjC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;oBAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACrB,CAAC;gBACD,mEAAmE;YACpE,CAAC;QACF,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAChB,oCAAoC;YACpC,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1E,uDAAuD;gBACvD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;oBACtB,IAAI,CAAC,YAAY,EAAE,CAAC;oBACpB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACrB,CAAC;qBAAM,CAAC;oBACP,0EAA0E;oBAC1E,IAAI,CAAC,YAAY,EAAE,CAAC;oBACpB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACpB,CAAC;gBACD,OAAO;YACR,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,YAAY,CAAC,KAAc;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,6BAA6B,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,aAAa,CAAC,IAAY;QACzB,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAClB,sBAAsB,IAAI,+FAA+F,CACzH,CAAC;QACF,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,CAAC;IAED,YAAY;QACX,IAAI,CAAC,WAAW,GAAG,kCAAc,CAAC;QAClC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,cAA2B,EAAE,kBAA+B,EAAE,WAAqB,EAAE;QAC3F,uGAAuG;QACvG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;YAC5E,6EAA6E;YAC7E,IAAI,CAAC,IAAA,wBAAiB,EAAC,kBAAkB,EAAE,cAAc,CAAC,EAAE,CAAC;gBAC5D,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO;QACR,CAAC;QAED,+EAA+E;QAC/E,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,CAAC,GAAG,IAAI,cAAc,CAAC,EAAE,CAAC;gBAC9B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;YACjD,CAAC;QACF,CAAC;QAED,8FAA8F;QAC9F,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAE1C,qGAAqG;YACrG,kCAAkC;YAClC,IACC,OAAO,QAAQ,KAAK,OAAO,YAAY;gBACvC,qHAAqH;gBACrH,oEAAoE;gBACpE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;gBACzD,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,EACxD,CAAC;gBACF,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAC/B,SAAS;YACV,CAAC;YAED,6FAA6F;YAC7F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACnF,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;oBAClC,0CAA0C;oBAC1C,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;gBAC3C,CAAC;qBAAM,CAAC;oBACP,qDAAqD;oBACrD,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAChC,CAAC;gBACD,SAAS;YACV,CAAC;YAED,IAAI,CAAC,IAAA,wBAAiB,EAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAChC,CAAC;QACF,CAAC;IACF,CAAC;IAED,SAAS,CAAC,KAAkB;QAC3B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpG,CAAC;IAED,SAAS,CAAC,IAAc;QACvB,IAAI,KAAK,GAAgB,IAAI,CAAC,aAAa,CAAC;QAE5C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAC;YAE5G,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QAED,OAAO,IAAA,kBAAS,EAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,SAAS,CAAC,IAAc,EAAE,KAAkB;QAC3C,+GAA+G;QAC/G,iEAAiE;QACjE,mCAAmC;QACnC,4DAA4D;QAC5D,mDAAmD;QACnD,yGAAyG;QACzG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACzB,MAAM,IAAI,yCAAyC,EAAE,CAAC;QACvD,CAAC;QAED,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YAC7F,MAAM,IAAI,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YACrD,OAAO;QACR,CAAC;QAED,IAAI,GAAG,GAAgB,IAAI,CAAC,aAAa,CAAC;QAE1C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;gBACnF,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC3C,CAAC;YAED,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;QAED,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAClE,MAAM,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;QAED,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QAEnC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,KAAK;QACJ,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAEtB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEnB,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAE1B,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,GAAa;QAChB,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,CAAC;IAED;;;;OAIG;IACH,MAAM;QACL,OAAO,IAAA,kBAAS,EAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,OAAO;QACN,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;CA8BD;AAvRD,wCAuRC"}
+{"version":3,"file":"OptionsWatcher.js","sourceRoot":"","sources":["../../../core/components/OptionsWatcher.ts"],"names":[],"mappings":"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"}

package/dist/core/components/Scope.js

@@ -9,14 +9,16 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Scope = exports.MissingDefaultFilesOptionError = void 0;
-const harper_logger_js_1 = require("../utility/logging/harper_logger.js");
+const harper_logger_ts_1 = require("../utility/logging/harper_logger.js");
 const node_events_1 = require("node:events");
 const databases_ts_1 = require("../resources/databases.js");
 const Server_ts_1 = require("../server/Server.js");
 const EntryHandler_ts_1 = require("./EntryHandler.js");
 const OptionsWatcher_ts_1 = require("./OptionsWatcher.js");
 const Resources_ts_1 = require("../resources/Resources.js");
+const Models_ts_1 = require("../resources/models/Models.js");
 const requestRestart_ts_1 = require("./requestRestart.js");
+const deployLifecycle_ts_1 = require("./deployLifecycle.js");
 class MissingDefaultFilesOptionError extends Error {
     constructor() {
         super('No default files option exists. Ensure `files` is specified in config.yaml');
@@ -36,27 +38,60 @@ class Scope extends node_events_1.EventEmitter {
     #directory;
     #appName;
     #pluginName;
+    #origin;
     #entryHandler;
     #entryHandlers;
     #logger;
     #pendingInitialLoads;
+    #deployStartHandler;
+    #deployEndHandler;
+    // While a deploy of this component is in flight, EntryHandler events do not
+    // drive requestRestart() — the deploy itself produces hundreds of file
+    // changes that would otherwise pile up. A single coalesced restart is
+    // triggered by the post-deploy re-scan instead.
+    #deployInFlight = false;
     applicationScope;
     options;
     resources;
     server;
     ready;
     databaseEvents;
-    constructor(appName, pluginName, directory, configFilePath, applicationScope) {
+    models;
+    constructor(appName, pluginName, directory, configFilePath, applicationScope, origin = appName) {
         super();
         this.#appName = appName;
         this.#pluginName = pluginName;
+        this.#origin = typeof origin === 'string' ? origin : appName;
         this.#directory = directory;
         this.#configFilePath = configFilePath;
-        this.#logger = logger || (0, harper_logger_js_1.loggerWithTag)(this.#appName);
+        this.#logger = (0, harper_logger_ts_1.loggerWithTag)(this.#appName);
         this.databaseEvents = databases_ts_1.databaseEventsEmitter;
         this.applicationScope = applicationScope;
         this.resources = applicationScope?.resources ?? Resources_ts_1.resources;
-        this.server = applicationScope?.server ?? Server_ts_1.server;
+        this.models = Models_ts_1.models;
+        const baseServer = applicationScope?.server ?? Server_ts_1.server;
+        const scopeRef = this;
+        // Wrap server so http/request/ws/upgrade calls automatically carry this plugin's name,
+        // urlPath, and host — enabling routing and before/after dependencies on named middleware.
+        this.server = new Proxy(baseServer, {
+            get(target, prop, receiver) {
+                if (prop === 'http' || prop === 'request' || prop === 'ws' || prop === 'upgrade') {
+                    const method = Reflect.get(target, prop, receiver);
+                    if (typeof method === 'function') {
+                        return (listener, options) => {
+                            const scopeConfig = scopeRef.options?.getAll() ?? {};
+                            return method.call(target, listener, {
+                                name: pluginName,
+                                urlPath: scopeConfig.urlPath || undefined,
+                                host: scopeConfig.host || undefined,
+                                ...options,
+                            });
+                        };
+                    }
+                }
+                return Reflect.get(target, prop, receiver);
+            },
+        });
         this.#entryHandlers = [];
         this.#pendingInitialLoads = new Set();
         this.ready = (0, node_events_1.once)(this, 'ready');
@@ -65,6 +100,19 @@ class Scope extends node_events_1.EventEmitter {
             .on('error', this.#handleError.bind(this))
             .on('change', this.#optionsWatcherChangeListener.bind(this)())
             .on('ready', this.#handleOptionsWatcherReady.bind(this));
+        // Bridge cross-thread deploy lifecycle events for this component. The
+        // handlers live on the scope for the lifetime of the scope and are torn
+        // down in close().
+        this.#deployStartHandler = (name) => {
+            if (name === this.#appName)
+                this.#onDeployStart(name);
+        };
+        this.#deployEndHandler = (name) => {
+            if (name === this.#appName)
+                this.#onDeployEnd(name);
+        };
+        deployLifecycle_ts_1.deployLifecycle.on('deploy:start', this.#deployStartHandler);
+        deployLifecycle_ts_1.deployLifecycle.on('deploy:end', this.#deployEndHandler);
     }
     get logger() {
         return this.#logger;
@@ -81,6 +129,10 @@ class Scope extends node_events_1.EventEmitter {
     get configFilePath() {
         return this.#configFilePath;
     }
+    ensureTable(options) {
+        options.origin = this.#origin;
+        return (0, databases_ts_1.table)(options);
+    }
     #handleOptionsWatcherReady() {
         // This previously created the default entry handler immediately, but now we wait for the user to call `handleEntry`
         // The issue was that since the component loader was awaiting `scope.ready()` and then calling `pluginModule.handleApplication(scope)`,
@@ -92,15 +144,52 @@ class Scope extends node_events_1.EventEmitter {
     #handleError(error) {
         this.emit('error', error);
     }
-    close() {
-        for (const entryHandler of this.#entryHandlers) {
-            entryHandler.close();
-        }
-        this.options.close();
+    async close() {
+        deployLifecycle_ts_1.deployLifecycle.off('deploy:start', this.#deployStartHandler);
+        deployLifecycle_ts_1.deployLifecycle.off('deploy:end', this.#deployEndHandler);
+        await Promise.allSettled([...this.#entryHandlers.map((h) => h.close()), this.options.close()]);
         this.emit('close');
         this.removeAllListeners();
         return this;
     }
+    #onDeployStart(componentName) {
+        this.#deployInFlight = true;
+        // Pause each EntryHandler so it stops emitting events for the
+        // intermediate filesystem state the deploy is writing, and so it
+        // releases its inotify handles while npm install is unpacking
+        // dependencies. pause() preserves the EntryHandler INSTANCE — listeners
+        // the plugin attached via scope.handleEntry(handler) remain attached.
+        for (const entryHandler of this.#entryHandlers) {
+            entryHandler.pause();
+        }
+        this.#safeEmit('deploy:start', componentName);
+    }
+    #onDeployEnd(componentName) {
+        this.#deployInFlight = false;
+        // Resume each EntryHandler BEFORE notifying plugins. Otherwise a plugin
+        // throwing in its deploy:end handler would abort this function and
+        // leave the watchers permanently paused (surfaced by Gemini review).
+        // The fresh chokidar watcher does an initial scan and emits add events
+        // for the post-deploy tree; the existing per-event listener calls
+        // scope.requestRestart() for each, and the restart debounce in
+        // componentLoader collapses them into a single restart cycle. Plugin
+        // handlers stay attached across the pause.
+        for (const entryHandler of this.#entryHandlers) {
+            void entryHandler.resume();
+        }
+        this.#safeEmit('deploy:end', componentName);
+    }
+    // Swallow and log listener exceptions so one buggy plugin can't stop us
+    // from running the rest of the deploy-lifecycle bookkeeping. EventEmitter
+    // by default rethrows from synchronous listeners.
+    #safeEmit(event, componentName) {
+        try {
+            this.emit(event, componentName);
+        }
+        catch (error) {
+            this.#logger.error?.(`Listener for ${event} threw for ${this.#appName}:`, error);
+        }
+    }
     #createEntryHandler(config) {
         const entryHandler = new EntryHandler_ts_1.EntryHandler(this.#pluginName, this.#directory, config, this.#logger)
             .on('error', this.#handleError.bind(this))
@@ -244,6 +333,13 @@ class Scope extends node_events_1.EventEmitter {
         return entryHandler;
     }
     requestRestart() {
+        if (this.#deployInFlight) {
+            // Suppressed: a deploy is rewriting this component's files. The
+            // post-deploy re-scan in #onDeployEnd will trigger the coalesced
+            // restart instead.
+            this.#logger.debug?.(`Restart suppressed (deploy in flight) for ${this.#appName}`);
+            return;
+        }
         this.#logger.debug?.(`Restart requested from ${this.#pluginName} scope for ${this.#appName}`);
         (0, requestRestart_ts_1.requestRestart)();
     }