harper 5.1.20 → 5.2.0-alpha.5

package/dist/server/static.js

@@ -7,6 +7,8 @@ exports.handleApplication = handleApplication;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const resolveBaseURLPath_ts_1 = require("../components/resolveBaseURLPath.js");
+const common_utils_ts_1 = require("../utility/common_utils.js");
+const micromatch_1 = require("micromatch");
 const send_1 = __importDefault(require("send"));
 /**
  * The static plugin handles serving static files from the respective application directory.
@@ -16,13 +18,126 @@ const send_1 = __importDefault(require("send"));
  * - `index`: If enabled, it will serve `index.html` files from directories.
  * - `extensions`: An array of file extensions to try when serving files. If a file is not found, it will try appending each extension in order. For example, if set to `['html'], and the request is `/page`, it will try `/page.html` if `/page` is not found.
  * - `fallthrough`: If true, it will fall through to the next handler if the file is not found. If false, it will return a 404 error.
+ * - `maxAge`: Freshness lifetime for served files — a number of seconds or a duration string
+ *   (`'5m'`, `'1d'`). Emitted as `Cache-Control: public, max-age=<seconds>`. Defaults to 0
+ *   (revalidate every request via the ETag/Last-Modified that are always emitted).
+ * - `immutable`: If true, adds the `immutable` directive to `Cache-Control` — for content-hashed
+ *   assets that never change under the same URL. Requires `maxAge` to be meaningful.
+ * - `cacheControl`: Full `Cache-Control` override string (takes precedence over `maxAge`/`immutable`),
+ *   or `false` to suppress the header entirely. Static files are served before authentication, so
+ *   they are public by construction — do not put per-user content behind this handler.
+ * - `cacheOverrides`: A map of glob pattern → partial cache options (`maxAge` / `immutable` /
+ *   `cacheControl`), letting specific files opt out of the top-level defaults. The typical case is
+ *   long-lived `immutable` defaults for content-hashed assets while `index.html` gets a short window
+ *   or `stale-while-revalidate`. Patterns are matched (via `micromatch`, same engine as `files`)
+ *   against the mount-relative URL path **and** the served file's basename — so `index.html` also
+ *   targets the directory-index (`/`) serve. Entries are tested in config order and the first match
+ *   wins; each is a partial (keys present replace the default, absent keys inherit), with the same
+ *   `cacheControl`-beats-`maxAge`/`immutable` precedence as the top level. Example:
+ *   ```yaml
+ *   static:
+ *     files: 'web/**'
+ *     maxAge: 1y
+ *     immutable: true
+ *     cacheOverrides:
+ *       'index.html': { cacheControl: 'public, max-age=0, stale-while-revalidate=60' }
+ *       '*.html': { maxAge: 5m, immutable: false }
+ *   ```
  * - `notFound`: Can be specified as a string to serve a custom 404 page, or an object with `file` and `statusCode` properties to serve a custom file with a specific status code. This is useful for hosting SPAs that use client-side routing. Make sure to set `fallthrough` to `false`!
+ * - `before` / `after`: Position this handler in the HTTP middleware chain relative to another named
+ *   handler. By default the handler runs `before: 'authentication'` — and therefore before the REST
+ *   handler — so plain file requests skip credential parsing. That default means a `fallthrough: false`
+ *   catch-all answers GETs for exported REST resources too; an SPA with history-mode routing should set
+ *   `after: 'rest'` so the API is matched first and only unmatched URLs receive the `notFound` fallback.
+ *   `before: false` clears the default without adding a new constraint (registration order applies).
+ *   Handler names are the component config keys as registered (e.g. `rest`, not the legacy `REST` alias);
+ *   a name that matches no registered handler is ignored, with a warning logged by the middleware chain.
+ *   Ordering is applied when the component loads; changing `before`/`after` triggers a component restart.
  *
  * This plugin dynamically updates its behavior based on the current configuration file. Users can make updates and immediately see the changes reflect in the next request.
  *
  * Updates to the `files` option will clear the in-memory maps and allow them to regenerate based on the new configuration (since the default EntryHandler will regenerate anyways).
  * Updates to `urlPath` request a restart: the HTTP route mount is registered once at load and cannot be re-registered on a live server (#1583).
  */
+/**
+ * Resolve the effective cache-header inputs for a given served file: the live top-level
+ * `maxAge`/`immutable`/`cacheControl` options, with the first matching `cacheOverrides` entry layered
+ * on top (a partial — keys present replace the default, absent keys inherit). Patterns are matched
+ * (via `micromatch`, same engine as `files`) against the mount-relative URL path and the file's
+ * basename, so `index.html` also targets the directory-index (`/`) serve.
+ */
+function resolveCacheOptions(scope, urlKey, basename) {
+    let maxAge = scope.options.get(['maxAge']);
+    let immutable = scope.options.get(['immutable']);
+    let cacheControl = scope.options.get(['cacheControl']);
+    const overrides = scope.options.get(['cacheOverrides']);
+    if (overrides !== undefined) {
+        if (typeof overrides !== 'object' || overrides === null || Array.isArray(overrides)) {
+            throw new Error(`Invalid cacheOverrides option: ${overrides}. Must be a map of glob pattern to cache options.`);
+        }
+        for (const pattern of Object.keys(overrides)) {
+            if ((0, micromatch_1.isMatch)(urlKey, pattern) || (0, micromatch_1.isMatch)(basename, pattern)) {
+                const override = overrides[pattern];
+                if (typeof override !== 'object' || override === null || Array.isArray(override)) {
+                    throw new Error(`Invalid cacheOverrides['${pattern}'] value: ${override}. Must be an object with maxAge/immutable/cacheControl.`);
+                }
+                // partial merge: only keys present in the override replace the top-level default
+                if ('maxAge' in override)
+                    maxAge = override.maxAge;
+                if ('immutable' in override)
+                    immutable = override.immutable;
+                if ('cacheControl' in override)
+                    cacheControl = override.cacheControl;
+                break; // first match wins
+            }
+        }
+    }
+    immutable = immutable ?? false;
+    if (maxAge !== undefined && typeof maxAge !== 'number' && typeof maxAge !== 'string') {
+        throw new Error(`Invalid maxAge option: ${maxAge}. Must be a number of seconds or a duration string like '5m'.`);
+    }
+    const maxAgeMs = maxAge === undefined ? 0 : (0, common_utils_ts_1.convertToMS)(maxAge);
+    if (Number.isNaN(maxAgeMs)) {
+        throw new Error(`Invalid maxAge option: ${maxAge}. Must be a number of seconds or a duration string like '5m'.`);
+    }
+    if (typeof immutable !== 'boolean') {
+        throw new Error(`Invalid immutable option: ${immutable}. Must be a boolean.`);
+    }
+    if (cacheControl !== undefined && typeof cacheControl !== 'string' && cacheControl !== false) {
+        throw new Error(`Invalid cacheControl option: ${cacheControl}. Must be a string or false.`);
+    }
+    const customCacheControl = typeof cacheControl === 'string' ? cacheControl : undefined;
+    return { cacheControlDisabled: cacheControl === false, maxAgeMs, immutable, customCacheControl };
+}
+/**
+ * Serve a file through `send`, applying the plugin's cache-header options (read live from the
+ * component config, like `fallthrough`, and layered with any matching `cacheOverrides` entry).
+ * `cacheControl` as a string overrides `maxAge`/`immutable` via send's `headers` event;
+ * `cacheControl: false` suppresses the header entirely. Applied only to the main file serve — the
+ * `notFound` fallback keeps send's default `max-age=0`, which is the right policy for SPA index
+ * fallbacks.
+ */
+function serveFile(req, path, scope) {
+    // The staticFiles map keys are the mount-relative URL path (leading slash stripped for matching);
+    // for a directory-index serve req.pathname is the directory, so also match the served basename.
+    const urlKey = typeof req.pathname === 'string' ? req.pathname.replace(/^\//, '') : '';
+    const basename = path.slice(Math.max(path.lastIndexOf('/'), path.lastIndexOf('\\')) + 1);
+    const { cacheControlDisabled, maxAgeMs, immutable, customCacheControl } = resolveCacheOptions(scope, urlKey, basename);
+    const stream = (0, send_1.default)(req, path, {
+        // suppress send's own header when we set a full override below (or when disabled)
+        cacheControl: cacheControlDisabled || customCacheControl !== undefined ? false : true,
+        maxAge: maxAgeMs,
+        immutable,
+    });
+    // an empty-string override intentionally behaves like `false` (send's header is suppressed
+    // above and no override is written)
+    if (customCacheControl) {
+        stream.on('headers', (response) => {
+            response.setHeader('Cache-Control', customCacheControl);
+        });
+    }
+    return stream;
+}
 function handleApplication(scope) {
     // in-memory map of static files
     // keys are the URL paths relative to the mount base, values are the absolute paths to the files
@@ -32,6 +147,28 @@ function handleApplication(scope) {
     // cannot be re-registered at runtime. Capture the matching base once so map keys always agree
     // with the registered route (#1583).
     const baseURLPath = (0, resolveBaseURLPath_ts_1.resolveBaseURLPath)(scope.pluginName, scope.options.getAll()?.urlPath);
+    // A bare `before:` / `after:` key in YAML parses as null — treat it as unset, like before this
+    // option was validated.
+    const before = scope.options.get(['before']) ?? undefined;
+    const after = scope.options.get(['after']) ?? undefined;
+    validateOrderingOption('before', before, true);
+    validateOrderingOption('after', after, false);
+    // Default to the pre-authentication hoist only when no ordering was configured at all.
+    const noOrderingConfigured = before === undefined && after === undefined;
+    // With the default ordering this handler answers unmatched GETs ahead of the REST handler, so a
+    // `fallthrough: false` catch-all makes any exported REST resources unreachable over GET.
+    // Reads the live option values (not the registration-time ones above): a config save can change
+    // the ordering options together with `fallthrough`, and this re-runs from the change listener.
+    const warnIfBlockingRest = () => {
+        const liveBefore = scope.options.get(['before']) ?? undefined;
+        const liveAfter = scope.options.get(['after']) ?? undefined;
+        if (liveAfter === undefined &&
+            (liveBefore === undefined || liveBefore === 'authentication') &&
+            scope.options.get(['fallthrough']) === false) {
+            scope.logger.warn(`The static handler runs before authentication and REST by default, so \`fallthrough: false\` answers every unmatched GET itself — including GETs for any exported REST resources. If this application serves an API, add \`after: 'rest'\` to the static options so API requests are matched first, or remove \`fallthrough: false\`.`);
+        }
+    };
+    warnIfBlockingRest();
     scope.options.on('change', (key) => {
         if (key[0] === 'files') {
             // If the files option changes, clear the maps and let the entry handler regenerate them
@@ -45,6 +182,16 @@ function handleApplication(scope) {
             scope.requestRestart();
             return;
         }
+        if (key[0] === 'fallthrough') {
+            warnIfBlockingRest();
+            return;
+        }
+        // `before`/`after` are consumed once at registration; the middleware chain can only pick
+        // up a new ordering by reloading the component. (Scope's own auto-restart on option
+        // changes is bypassed once a plugin registers its own 'change' listener, as we do above.)
+        if (key[0] === 'before' || key[0] === 'after') {
+            scope.requestRestart();
+        }
     });
     // Handle entry events for the default entry handler based on the `files` and `urlPath` options
     scope.handleEntry((entry) => {
@@ -160,7 +307,7 @@ function handleApplication(scope) {
             // The benefit to using `send` is that it handles a lot of edge cases and headers for us.
             return {
                 handlesHeaders: true,
-                body: (0, send_1.default)(req, (0, node_fs_1.realpathSync)(staticFile)),
+                body: serveFile(req, (0, node_fs_1.realpathSync)(staticFile), scope),
             };
         }
         // If fallthrough is true pass along the request to the next handler
@@ -186,7 +333,19 @@ function handleApplication(scope) {
             handlesHeaders: true,
             body: (0, send_1.default)(req, (0, node_fs_1.realpathSync)(notFoundPath)),
         };
-    }, { before: scope.options.get(['before']) ?? 'authentication' });
+    }, {
+        // `after` (e.g. `after: 'rest'`) must suppress the default pre-authentication hoist —
+        // combining the two constraints would be a cycle, which falls back to registration order.
+        before: typeof before === 'string' ? before : noOrderingConfigured ? 'authentication' : undefined,
+        after: after,
+    });
+}
+function validateOrderingOption(name, value, allowFalse) {
+    if (value === undefined || (typeof value === 'string' && value.length > 0))
+        return;
+    if (allowFalse && value === false)
+        return;
+    throw new Error(`Invalid \`${name}\` option: ${value}. Must be the name of another handler${allowFalse ? ', or false to clear the default ordering' : ''}.`);
 }
 function validateNotFoundOption(notFound) {
     if (notFound === undefined || typeof notFound === 'string')

package/dist/server/static.js.map

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

package/dist/server/status/index.d.ts

@@ -5,6 +5,7 @@ export type { StatusId, StatusRecord, StatusValueMap } from './definitions.ts';
 export { STATUS_IDS, DEFAULT_STATUS_ID } from './definitions.ts';
 type StatusRequestBody = {
     id: StatusId;
+    middleware?: boolean;
 };
 type StatusWriteRequestBody<T extends StatusId = StatusId> = {
     id?: T;
@@ -21,6 +22,8 @@ interface AllStatusSummary {
     systemStatus: Promise<AsyncIterable<StatusRecord>>;
     componentStatus: AggregatedComponentStatusWithName[];
     restartRequired: boolean;
+    middlewareChains?: MiddlewareChainsSummary | null;
 }
-declare function getStatus({ id }: Partial<StatusRequestBody>): Promise<StatusRecord | AllStatusSummary>;
+type MiddlewareChainsSummary = ReturnType<typeof import('../http.ts').describeMiddlewareChains>;
+declare function getStatus({ id, middleware }: Partial<StatusRequestBody>): Promise<StatusRecord | AllStatusSummary>;
 declare function setStatus<T extends StatusId = StatusId>({ status, id, }: StatusWriteRequestBody<T>): Promise<StatusRecord<T>>;

package/dist/server/status/index.js

@@ -11,6 +11,9 @@ const statusValidator_ts_1 = require("../../validation/statusValidator.js");
 const definitions_ts_1 = require("./definitions.js");
 const index_ts_1 = require("../../components/status/index.js");
 const requestRestart_ts_1 = require("../../components/requestRestart.js");
+const itc_js_1 = require("../threads/itc.js");
+const manageThreads_js_1 = require("../threads/manageThreads.js");
+const hdbTerms_ts_1 = require("../../utility/hdbTerms.js");
 var definitions_ts_2 = require("./definitions.js");
 Object.defineProperty(exports, "STATUS_IDS", { enumerable: true, get: function () { return definitions_ts_2.STATUS_IDS; } });
 Object.defineProperty(exports, "DEFAULT_STATUS_ID", { enumerable: true, get: function () { return definitions_ts_2.DEFAULT_STATUS_ID; } });
@@ -53,7 +56,61 @@ function clearStatus({ id }) {
     statusLogger.debug?.('clearStatus', id);
     return getStatusTable().delete(id);
 }
-async function getAllStatus() {
+let nextChainsRequestId = 1;
+let chainsResponseListenerAttached = false;
+const pendingChainsRequests = new Map();
+function attachChainsResponseListener() {
+    if (chainsResponseListenerAttached)
+        return;
+    (0, manageThreads_js_1.onMessageByType)(hdbTerms_ts_1.ITC_EVENT_TYPES.MIDDLEWARE_CHAINS_RESPONSE, ({ message }) => {
+        const resolve = pendingChainsRequests.get(message.requestId);
+        if (resolve) {
+            pendingChainsRequests.delete(message.requestId);
+            resolve(message.chains);
+        }
+    });
+    chainsResponseListenerAttached = true;
+}
+// App HTTP middleware is only registered on worker threads, so when get_status runs on the main
+// thread we ask an HTTP worker for its resolved chains (all workers register identically). Returns
+// null if no worker answers within the timeout — mirrors queryWorkerForOpenApi in operationsServer.
+function queryWorkerForMiddlewareChains() {
+    attachChainsResponseListener();
+    const requestId = nextChainsRequestId++;
+    return new Promise((resolve) => {
+        const timeoutHandle = setTimeout(() => {
+            pendingChainsRequests.delete(requestId);
+            resolve(null);
+        }, 5000);
+        pendingChainsRequests.set(requestId, (chains) => {
+            clearTimeout(timeoutHandle);
+            resolve(chains);
+        });
+        (0, itc_js_1.sendItcEvent)({ type: hdbTerms_ts_1.ITC_EVENT_TYPES.MIDDLEWARE_CHAINS_REQUEST, message: { requestId } }).catch(() => {
+            clearTimeout(timeoutHandle);
+            pendingChainsRequests.delete(requestId);
+            resolve(null);
+        });
+    });
+}
+// Introspect the resolved HTTP/upgrade/WebSocket middleware order (#1573). In a multi-worker
+// deployment the app middleware is registered on the HTTP worker threads while the main thread
+// carries only the operations-API middleware, so when an HTTP worker exists we fetch the chains from
+// one over ITC. With no HTTP worker this thread is the app server itself (single-thread mode, or a
+// worker serving the request) and reports locally. Job workers don't serve HTTP, so they're ignored.
+async function getMiddlewareChains() {
+    try {
+        if (manageThreads_js_1.workers.some((worker) => worker.name === hdbTerms_ts_1.THREAD_TYPES.HTTP))
+            return await queryWorkerForMiddlewareChains();
+        const { describeMiddlewareChains } = await import("../http.js");
+        return describeMiddlewareChains();
+    }
+    catch (error) {
+        statusLogger.debug?.('getMiddlewareChains failed', error);
+        return null;
+    }
+}
+async function getAllStatus(includeMiddleware = false) {
     statusLogger.debug?.('getAllStatus');
     const statusRecords = getStatusTable().search([]);
     // Get aggregated component statuses from all threads
@@ -64,16 +121,19 @@ async function getAllStatus() {
     }));
     // Get restart flag status
     const restartRequired = (0, requestRestart_ts_1.restartNeeded)();
-    return {
+    const summary = {
         systemStatus: statusRecords,
         componentStatus: componentStatusArray,
         restartRequired,
     };
+    if (includeMiddleware)
+        summary.middlewareChains = await getMiddlewareChains();
+    return summary;
 }
-function getStatus({ id }) {
+function getStatus({ id, middleware }) {
     if (!id) {
         statusLogger.debug?.('getStatus', 'all');
-        return getAllStatus();
+        return getAllStatus(middleware === true);
     }
     statusLogger.debug?.('getStatus', id);
     return getStatusTable().get(id);

package/dist/server/status/index.js.map

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

package/dist/server/threads/manageThreads.d.ts

@@ -25,6 +25,16 @@ export function setMainIsWorker(isWorker: any): void;
 export function setTerminateTimeout(newTimeout: any): void;
 export function extendShutdownDeadline(deadlineMs: any): void;
 export function restoreShutdownDeadline(): void;
+/**
+ * Register a provider that contributes an extra `workerData` property to every worker spawned
+ * from this thread. `provider(options)` receives the startWorker options (`options.name` is the
+ * thread type, e.g. 'http' or 'job') and returns the value to place at `workerData[name]`, or
+ * undefined to skip that worker. Values must be structured-cloneable; a provider that throws or
+ * returns a non-cloneable value is logged and skipped so it can never break a spawn.
+ * Returns a function that unregisters the provider.
+ */
+export function registerWorkerDataProvider(name: any, provider: any): () => void;
+export function onThreadExit(listener: any): void;
 export let getThreadInfo: any;
 export function watchDir(dir: any, beforeRestartCallback: any): Promise<void>;
 import { Worker } from "node:worker_threads";

package/dist/server/threads/manageThreads.js

@@ -123,6 +123,8 @@ module.exports = {
     setTerminateTimeout,
     extendShutdownDeadline,
     restoreShutdownDeadline,
+    registerWorkerDataProvider,
+    onThreadExit,
     restartNumber: workerData?.restartNumber || 1,
 };
 connectedPorts.onMessageByType = onMessageByType;
@@ -167,6 +169,63 @@ function setMainIsWorker(isWorker) {
     module.exports.threadsHaveStarted();
 }
 let workerCount = 1; // should be assigned when workers are created
+// Every workerData key core itself produces or consumes — providers may not collide with these.
+// Covers the keys startWorker spreads below plus keys read elsewhere: `noServerStart` is set by
+// the embedding entry point (index.ts) and read by threadServer.js to skip startServers(); a
+// provider shadowing it would wedge HTTP worker startup.
+const RESERVED_WORKER_DATA_KEYS = [
+    'addPorts',
+    'addThreadIds',
+    'workerIndex',
+    'workerCount',
+    'name',
+    'restartNumber',
+    'ticketKeys',
+    'noServerStart',
+    '__proto__', // never a legitimate payload name; spread would define it as an own property
+];
+const workerDataProviders = new Map();
+/**
+ * Register a provider that contributes an extra `workerData` property to every worker spawned
+ * from this thread. `provider(options)` receives the startWorker options (`options.name` is the
+ * thread type, e.g. 'http' or 'job') and returns the value to place at `workerData[name]`, or
+ * undefined to skip that worker. Values must be structured-cloneable; a provider that throws or
+ * returns a non-cloneable value is logged and skipped so it can never break a spawn.
+ * Returns a function that unregisters the provider.
+ */
+function registerWorkerDataProvider(name, provider) {
+    if (RESERVED_WORKER_DATA_KEYS.includes(name) || workerDataProviders.has(name)) {
+        throw new Error(`workerData provider name '${name}' is already in use`);
+    }
+    if (typeof provider !== 'function')
+        throw new Error('workerData provider must be a function');
+    workerDataProviders.set(name, provider);
+    return () => {
+        if (workerDataProviders.get(name) === provider)
+            workerDataProviders.delete(name);
+    };
+}
+function collectProvidedWorkerData(options) {
+    if (workerDataProviders.size === 0)
+        return undefined;
+    let provided;
+    for (const [name, provider] of workerDataProviders) {
+        try {
+            const value = provider(options);
+            if (value === undefined)
+                continue;
+            // Use the clone, not the original: this both pre-flights cloneability (so a bad value
+            // can't break the Worker spawn) and detaches the payload from accessor-backed objects
+            // or later mutation that could still throw inside new Worker(). Null prototype so a
+            // provider name can never collide with Object.prototype members.
+            (provided ??= Object.create(null))[name] = structuredClone(value);
+        }
+        catch (error) {
+            harperLogger.error(`workerData provider '${name}' failed and will be skipped for this worker:`, error);
+        }
+    }
+    return provided;
+}
 let ticketKeys;
 function getTicketKeys() {
     if (ticketKeys)
@@ -204,6 +263,11 @@ listenersByType.set(hdbTerms.ITC_EVENT_TYPES.USER, null);
 listenersByType.set(hdbTerms.ITC_EVENT_TYPES.COMPONENT_STATUS_REQUEST, null);
 listenersByType.set(hdbTerms.ITC_EVENT_TYPES.RESOURCE_OPENAPI_REQUEST, null);
 listenersByType.set(hdbTerms.ITC_EVENT_TYPES.RESOURCE_OPENAPI_RESPONSE, null);
+listenersByType.set(hdbTerms.ITC_EVENT_TYPES.MIDDLEWARE_CHAINS_REQUEST, null);
+listenersByType.set(hdbTerms.ITC_EVENT_TYPES.MIDDLEWARE_CHAINS_RESPONSE, null);
+listenersByType.set(hdbTerms.ITC_EVENT_TYPES.OPERATION_REGISTERED, null);
+listenersByType.set(hdbTerms.ITC_EVENT_TYPES.OPERATION_EXECUTE_REQUEST, null);
+listenersByType.set(hdbTerms.ITC_EVENT_TYPES.OPERATION_EXECUTE_RESPONSE, null);
 function startWorker(path, options = {}) {
     // Take a percentage of total memory to determine the max memory for each thread. The percentage is based
     // on the thread count. Generally, it is unrealistic to efficiently use the majority of total memory for a single
@@ -270,6 +334,7 @@ function startWorker(path, options = {}) {
         argv: process.argv.slice(2),
         // pass these in synchronously to the worker so it has them on startup:
         workerData: {
+            ...collectProvidedWorkerData(options),
             addPorts: portsToSend,
             addThreadIds: channelsToConnect.map((channel) => channel.existingPort.threadId),
             workerIndex: options.workerIndex,
@@ -363,10 +428,16 @@ startReplacementThreads = true) {
         // make a copy of the workers before iterating them, as the workers array mutates a lot during this
         let waitingToFinish = []; // promises for workers we have shut down and are waiting to exit
         // We can only start the replacement *before* the old worker releases its port when the OS lets
-        // both listen on the same port at once (SO_REUSEPORT). Without that — Windows (no SO_REUSEPORT)
-        // and Bun — the replacement can't bind until the old worker exits, so there we keep the original
-        // ordering: shut the old worker down first, then start the replacement (an unavoidable brief gap).
-        const canPreStartReplacement = process.platform !== 'win32' && !isBun;
+        // both listen on the same port at once (SO_REUSEPORT). Without that — Windows (no SO_REUSEPORT),
+        // macOS (unreliable SO_REUSEPORT, so workers bind exclusively), and Bun — the replacement can't
+        // bind a port the old worker still holds: its EADDRINUSE would be swallowed and the port left
+        // unbound once the old worker exits (this silently killed worker-owned listeners like MQTT on
+        // macOS after every component-reload restart). So there we keep the original ordering: shut the
+        // old worker down first (server.close() releases its ports immediately), then start the
+        // replacement — an unavoidable brief gap, but only for worker-owned listeners, since the main
+        // thread keeps serving the HTTP ports throughout. This ordering is also what lets
+        // listenOnPorts() treat a dedicated listener's EADDRINUSE as an external conflict.
+        const canPreStartReplacement = process.platform !== 'win32' && process.platform !== 'darwin' && !isBun;
         for (let worker of workers.slice(0)) {
             if ((name && worker.name !== name) || worker.wasShutdown)
                 continue; // filter by type, if specified
@@ -747,11 +818,38 @@ else {
     getThreadInfo = getChildWorkerInfo;
 }
 module.exports.getThreadInfo = getThreadInfo;
+// Listeners notified when a connected thread's port closes (worker exit/restart), so
+// modules holding per-thread state (e.g. registeredOperations' registry and in-flight
+// forwards) can clean up.
+const threadExitListeners = [];
+function onThreadExit(listener) {
+    threadExitListeners.push(listener);
+}
+// Thread ids already reported to threadExitListeners, so a dead worker is only reported once
+// regardless of which of the two removal paths below observes it first. Node worker_threads
+// ids are monotonically increasing and never reused within a process, so this never needs
+// pruning (unbounded growth is one entry per worker restart over the process lifetime).
+const notifiedDeadThreadIds = new Set();
+function notifyThreadExit(deadThreadId) {
+    if (deadThreadId == null || notifiedDeadThreadIds.has(deadThreadId))
+        return;
+    notifiedDeadThreadIds.add(deadThreadId);
+    for (const listener of threadExitListeners) {
+        try {
+            listener(deadThreadId);
+        }
+        catch (error) {
+            harperLogger.error(error);
+        }
+    }
+}
 function removePort(port, deadThreadId) {
     const idx = connectedPorts.indexOf(port);
     if (idx === -1)
         return;
     connectedPorts.splice(idx, 1);
+    if (deadThreadId != null)
+        notifyThreadExit(deadThreadId);
     // Notify remaining peers to remove this dead sibling port. In Bun, sibling
     // MessagePorts don't emit 'close' when a peer worker exits, so we broadcast
     // a REMOVE_PORT message from here (which fires reliably on Worker 'exit')
@@ -790,6 +888,11 @@ function addPort(port, keepRef, isJobWorker) {
             const idx = connectedPorts.findIndex((p) => p.threadId === message.threadId);
             if (idx !== -1)
                 connectedPorts.splice(idx, 1);
+            // A sibling's port-to-the-dead-worker can close (and broadcast this) before this
+            // thread's OWN port to that worker fires its 'close'/'exit' — at which point
+            // removePort() would no-op (already spliced) and threadExitListeners would never
+            // fire. Notify here too; notifyThreadExit dedupes so it isn't reported twice.
+            notifyThreadExit(message.threadId);
         }
         else {
             notifyMessageListeners(message, port);