@digitaldefiance/node-express-suite 3.12.11 → 3.12.13

package/src/services/upnp-manager.d.ts

@@ -0,0 +1,211 @@
+/**
+ * UPnP Manager for Express server integration.
+ *
+ * Orchestrates UPnP port mapping lifecycle: initialization, periodic refresh,
+ * health monitoring, and graceful shutdown. Wraps the core UpnpService with
+ * server-specific concerns like signal handling and exponential backoff on
+ * refresh failures.
+ *
+ * All UPnP failures are non-fatal — the server continues operating even if
+ * port mapping fails, with appropriate log messages for manual intervention.
+ *
+ * Requirements: 4.1, 4.2, 4.3, 4.4, 4.5, 4.6, 4.7, 4.8, 4.9, 4.10
+ */
+import { IUpnpConfig } from '../interfaces/network/upnpTypes';
+import { UpnpConfig } from './upnp-config';
+/**
+ * Options for constructing a UpnpManager.
+ *
+ * Allows passing a config along with an optional description prefix
+ * for port mapping labels.
+ *
+ * @example
+ * ```typescript
+ * const manager = new UpnpManager({
+ *   config: UpnpConfig.fromEnvironment(),
+ *   descriptionPrefix: 'My App',
+ * });
+ * ```
+ */
+export interface UpnpManagerOptions {
+    /** UPnP configuration (IUpnpConfig or UpnpConfig instance) */
+    config: IUpnpConfig | UpnpConfig;
+    /** Prefix for port mapping descriptions (defaults to 'Express App') */
+    descriptionPrefix?: string;
+}
+/**
+ * Manages UPnP port mappings for the Express server lifecycle.
+ *
+ * Handles:
+ * - Creating HTTP port mapping on startup
+ * - Creating WebSocket port mapping when on a separate port
+ * - Removing mappings on shutdown
+ * - Periodic health monitoring and refresh
+ * - SIGTERM/SIGINT signal handling
+ *
+ * @example
+ * ```typescript
+ * const config = UpnpConfig.fromEnvironment();
+ * const manager = new UpnpManager(config);
+ *
+ * await manager.initialize(); // creates mapping, starts refresh timer
+ * // ... server runs ...
+ * await manager.shutdown();   // removes mappings, cleans up
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom description prefix
+ * const manager = new UpnpManager({
+ *   config: UpnpConfig.fromEnvironment(),
+ *   descriptionPrefix: 'My App',
+ * });
+ * // Mappings will be labelled "My App HTTP" and "My App WebSocket"
+ * ```
+ */
+export declare class UpnpManager {
+    /** The underlying UPnP service */
+    private readonly service;
+    /** Server configuration */
+    private readonly config;
+    /** Prefix used in port mapping descriptions */
+    private readonly descriptionPrefix;
+    /** Periodic refresh timer handle */
+    private refreshTimer;
+    /** Consecutive refresh failure count (for exponential backoff) */
+    private consecutiveRefreshFailures;
+    /** Whether the manager has been initialized */
+    private initialized;
+    /** Whether shutdown is in progress or complete */
+    private shuttingDown;
+    /** Bound signal handlers (stored for removal on shutdown) */
+    private readonly boundSignalHandlers;
+    /**
+     * Create a new UpnpManager.
+     *
+     * Accepts either a config directly (backward compatible) or an options
+     * object with an optional `descriptionPrefix`.
+     *
+     * @param configOrOptions - UPnP configuration or options object
+     *
+     * @example
+     * ```typescript
+     * // Direct config (backward compatible)
+     * const manager = new UpnpManager(config);
+     *
+     * // Options object with custom prefix
+     * const manager = new UpnpManager({
+     *   config,
+     *   descriptionPrefix: 'My App',
+     * });
+     * ```
+     */
+    constructor(configOrOptions: IUpnpConfig | UpnpConfig | UpnpManagerOptions);
+    /**
+     * Initialize UPnP: create HTTP port mapping and start the refresh timer.
+     *
+     * **Validates: Requirements 4.4**
+     *
+     * On failure, logs a warning with manual port-forwarding instructions
+     * but does NOT throw — UPnP failure is non-fatal.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Shut down UPnP: stop refresh timer, remove all mappings, close service.
+     *
+     * **Validates: Requirements 4.5, 4.6**
+     *
+     * Safe to call multiple times — subsequent calls are no-ops.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Whether the manager has been successfully initialized.
+     *
+     * @returns `true` if {@link initialize} completed successfully
+     */
+    get isInitialized(): boolean;
+    /**
+     * Whether the manager is shutting down or has shut down.
+     *
+     * @returns `true` if {@link shutdown} has been called
+     */
+    get isShuttingDown(): boolean;
+    /**
+     * Get the external endpoints for advertisement.
+     *
+     * Returns the external IP:port for HTTP and WebSocket endpoints.
+     *
+     * **Validates: Requirement 4.10**
+     *
+     * @returns External endpoints or `null` if UPnP is not initialized or shutting down
+     */
+    getExternalEndpoints(): Promise<{
+        http: string;
+        ws: string;
+    } | null>;
+    /**
+     * Create the HTTP port mapping on the router.
+     *
+     * **Validates: Requirement 4.2** — Uses configurable description prefix
+     */
+    private createHttpMapping;
+    /**
+     * Create the WebSocket port mapping on the router.
+     *
+     * Only called when websocketPort differs from httpPort.
+     *
+     * **Validates: Requirement 4.3** — Uses configurable description prefix
+     */
+    private createWebSocketMapping;
+    /**
+     * Whether the WebSocket port requires a separate mapping.
+     *
+     * @returns `true` if websocketPort differs from httpPort
+     */
+    private get needsWebSocketMapping();
+    /**
+     * Start the periodic refresh timer.
+     *
+     * **Validates: Requirement 4.8** — Refresh mappings before TTL expiration
+     */
+    private startRefreshTimer;
+    /**
+     * Stop the periodic refresh timer.
+     */
+    private stopRefreshTimer;
+    /**
+     * Refresh all active port mappings.
+     *
+     * **Validates: Requirement 4.8** — Re-create each active mapping to renew TTL
+     */
+    private refresh;
+    /**
+     * Schedule an additional refresh with exponential backoff.
+     *
+     * **Validates: Requirement 4.9** — Exponential backoff capped at 8× retryDelay
+     */
+    private scheduleBackoffRefresh;
+    /**
+     * Register SIGTERM and SIGINT handlers for graceful shutdown.
+     *
+     * **Validates: Requirement 4.4** — Register signal handlers during initialization
+     */
+    private registerSignalHandlers;
+    /**
+     * Remove previously registered signal handlers.
+     */
+    private removeSignalHandlers;
+    /**
+     * Handle a process signal by performing graceful shutdown.
+     *
+     * @param signal - The signal name (e.g. `'SIGTERM'`, `'SIGINT'`)
+     */
+    private handleSignal;
+    /**
+     * Log manual port-forwarding instructions when UPnP is unavailable.
+     *
+     * **Validates: Requirement 4.7** — Log warning with manual instructions
+     */
+    private logManualPortForwardingInstructions;
+}
+//# sourceMappingURL=upnp-manager.d.ts.map

package/src/services/upnp-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upnp-manager.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/services/upnp-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,WAAW,EAGZ,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAe3C;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,MAAM,EAAE,WAAW,GAAG,UAAU,CAAC;IACjC,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAsBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,WAAW;IACtB,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IAEtC,2BAA2B;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAE/C,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAE3C,oCAAoC;IACpC,OAAO,CAAC,YAAY,CAA+C;IAEnE,kEAAkE;IAClE,OAAO,CAAC,0BAA0B,CAAK;IAEvC,+CAA+C;IAC/C,OAAO,CAAC,WAAW,CAAS;IAE5B,kDAAkD;IAClD,OAAO,CAAC,YAAY,CAAS;IAE7B,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAGlC;IAEF;;;;;;;;;;;;;;;;;;;OAmBG;gBACS,eAAe,EAAE,WAAW,GAAG,UAAU,GAAG,kBAAkB;IAkC1E;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoDjC;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB/B;;;;OAIG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;;OAIG;IACH,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED;;;;;;;;OAQG;IACG,oBAAoB,IAAI,OAAO,CAAC;QACpC,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;KACZ,GAAG,IAAI,CAAC;IAkBT;;;;OAIG;YACW,iBAAiB;IAY/B;;;;;;OAMG;YACW,sBAAsB;IAYpC;;;;OAIG;IACH,OAAO,KAAK,qBAAqB,GAEhC;IAID;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;OAIG;YACW,OAAO;IAsErB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAwB9B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAK9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;;;OAIG;YACW,YAAY;IAO1B;;;;OAIG;IACH,OAAO,CAAC,mCAAmC;CAgB5C"}

package/src/services/upnp-manager.js

@@ -0,0 +1,447 @@
+"use strict";
+/**
+ * UPnP Manager for Express server integration.
+ *
+ * Orchestrates UPnP port mapping lifecycle: initialization, periodic refresh,
+ * health monitoring, and graceful shutdown. Wraps the core UpnpService with
+ * server-specific concerns like signal handling and exponential backoff on
+ * refresh failures.
+ *
+ * All UPnP failures are non-fatal — the server continues operating even if
+ * port mapping fails, with appropriate log messages for manual intervention.
+ *
+ * Requirements: 4.1, 4.2, 4.3, 4.4, 4.5, 4.6, 4.7, 4.8, 4.9, 4.10
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpnpManager = void 0;
+const upnp_1 = require("./upnp");
+// ─── Constants ──────────────────────────────────────────────────────────────
+/** Maximum backoff multiplier for repeated refresh failures */
+const MAX_BACKOFF_MULTIPLIER = 8;
+/** Prefix for all UPnP log messages */
+const LOG_PREFIX = '[UPnP]';
+/** Default description prefix for port mapping labels */
+const DEFAULT_DESCRIPTION_PREFIX = 'Express App';
+// ─── Type Guard ─────────────────────────────────────────────────────────────
+/**
+ * Check whether the given value is a UpnpManagerOptions object
+ * (as opposed to a plain IUpnpConfig or UpnpConfig).
+ */
+function isUpnpManagerOptions(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'config' in value &&
+        // UpnpConfig and IUpnpConfig both have 'enabled'; UpnpManagerOptions has 'config'
+        typeof value.config === 'object');
+}
+// ─── Manager ────────────────────────────────────────────────────────────────
+/**
+ * Manages UPnP port mappings for the Express server lifecycle.
+ *
+ * Handles:
+ * - Creating HTTP port mapping on startup
+ * - Creating WebSocket port mapping when on a separate port
+ * - Removing mappings on shutdown
+ * - Periodic health monitoring and refresh
+ * - SIGTERM/SIGINT signal handling
+ *
+ * @example
+ * ```typescript
+ * const config = UpnpConfig.fromEnvironment();
+ * const manager = new UpnpManager(config);
+ *
+ * await manager.initialize(); // creates mapping, starts refresh timer
+ * // ... server runs ...
+ * await manager.shutdown();   // removes mappings, cleans up
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom description prefix
+ * const manager = new UpnpManager({
+ *   config: UpnpConfig.fromEnvironment(),
+ *   descriptionPrefix: 'My App',
+ * });
+ * // Mappings will be labelled "My App HTTP" and "My App WebSocket"
+ * ```
+ */
+class UpnpManager {
+    /** The underlying UPnP service */
+    service;
+    /** Server configuration */
+    config;
+    /** Prefix used in port mapping descriptions */
+    descriptionPrefix;
+    /** Periodic refresh timer handle */
+    refreshTimer = null;
+    /** Consecutive refresh failure count (for exponential backoff) */
+    consecutiveRefreshFailures = 0;
+    /** Whether the manager has been initialized */
+    initialized = false;
+    /** Whether shutdown is in progress or complete */
+    shuttingDown = false;
+    /** Bound signal handlers (stored for removal on shutdown) */
+    boundSignalHandlers;
+    /**
+     * Create a new UpnpManager.
+     *
+     * Accepts either a config directly (backward compatible) or an options
+     * object with an optional `descriptionPrefix`.
+     *
+     * @param configOrOptions - UPnP configuration or options object
+     *
+     * @example
+     * ```typescript
+     * // Direct config (backward compatible)
+     * const manager = new UpnpManager(config);
+     *
+     * // Options object with custom prefix
+     * const manager = new UpnpManager({
+     *   config,
+     *   descriptionPrefix: 'My App',
+     * });
+     * ```
+     */
+    constructor(configOrOptions) {
+        let resolvedConfig;
+        let prefix;
+        if (isUpnpManagerOptions(configOrOptions)) {
+            resolvedConfig = configOrOptions.config;
+            prefix = configOrOptions.descriptionPrefix ?? DEFAULT_DESCRIPTION_PREFIX;
+        }
+        else {
+            resolvedConfig = configOrOptions;
+            prefix = DEFAULT_DESCRIPTION_PREFIX;
+        }
+        this.config = resolvedConfig;
+        this.descriptionPrefix = prefix;
+        this.service = new upnp_1.UpnpService({
+            enabled: resolvedConfig.enabled,
+            httpPort: resolvedConfig.httpPort,
+            websocketPort: resolvedConfig.websocketPort,
+            ttl: resolvedConfig.ttl,
+            refreshInterval: resolvedConfig.refreshInterval,
+            protocol: resolvedConfig.protocol,
+            retryAttempts: resolvedConfig.retryAttempts,
+            retryDelay: resolvedConfig.retryDelay,
+        });
+        // Bind signal handlers so we can remove them later
+        this.boundSignalHandlers = {
+            sigterm: () => void this.handleSignal('SIGTERM'),
+            sigint: () => void this.handleSignal('SIGINT'),
+        };
+    }
+    // ─── Public API ─────────────────────────────────────────────────────────
+    /**
+     * Initialize UPnP: create HTTP port mapping and start the refresh timer.
+     *
+     * **Validates: Requirements 4.4**
+     *
+     * On failure, logs a warning with manual port-forwarding instructions
+     * but does NOT throw — UPnP failure is non-fatal.
+     */
+    async initialize() {
+        if (this.initialized) {
+            console.warn(`${LOG_PREFIX} Already initialized, skipping`);
+            return;
+        }
+        console.log(`${LOG_PREFIX} Initializing UPnP port mapping...`);
+        // Register signal handlers for graceful shutdown
+        this.registerSignalHandlers();
+        try {
+            // Discover external IP
+            const externalIp = await this.service.getExternalIp();
+            console.log(`${LOG_PREFIX} External IP: ${externalIp}`);
+            // Create HTTP port mapping
+            await this.createHttpMapping();
+            console.log(`${LOG_PREFIX} HTTP port mapping created — ` +
+                `external ${externalIp}:${this.config.httpPort} → ` +
+                `internal :${this.config.httpPort}`);
+            // Create WebSocket port mapping if on a different port
+            if (this.needsWebSocketMapping) {
+                await this.createWebSocketMapping();
+                console.log(`${LOG_PREFIX} WebSocket port mapping created — ` +
+                    `external ${externalIp}:${this.config.websocketPort} → ` +
+                    `internal :${this.config.websocketPort}`);
+            }
+            else {
+                console.log(`${LOG_PREFIX} WebSocket using same port as HTTP (${this.config.httpPort}), no additional mapping needed`);
+            }
+            // Start periodic refresh timer
+            this.startRefreshTimer();
+            this.initialized = true;
+            console.log(`${LOG_PREFIX} Initialization complete`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(`${LOG_PREFIX} Initialization failed: ${message}`);
+            this.logManualPortForwardingInstructions();
+            // Non-fatal: server continues without UPnP
+        }
+    }
+    /**
+     * Shut down UPnP: stop refresh timer, remove all mappings, close service.
+     *
+     * **Validates: Requirements 4.5, 4.6**
+     *
+     * Safe to call multiple times — subsequent calls are no-ops.
+     */
+    async shutdown() {
+        if (this.shuttingDown) {
+            return;
+        }
+        this.shuttingDown = true;
+        console.log(`${LOG_PREFIX} Shutting down...`);
+        // Stop refresh timer
+        this.stopRefreshTimer();
+        // Remove signal handlers
+        this.removeSignalHandlers();
+        // Remove all mappings and close the service
+        try {
+            await this.service.close();
+            console.log(`${LOG_PREFIX} All mappings removed and service closed`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`${LOG_PREFIX} Error during shutdown: ${message}`);
+        }
+    }
+    /**
+     * Whether the manager has been successfully initialized.
+     *
+     * @returns `true` if {@link initialize} completed successfully
+     */
+    get isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Whether the manager is shutting down or has shut down.
+     *
+     * @returns `true` if {@link shutdown} has been called
+     */
+    get isShuttingDown() {
+        return this.shuttingDown;
+    }
+    /**
+     * Get the external endpoints for advertisement.
+     *
+     * Returns the external IP:port for HTTP and WebSocket endpoints.
+     *
+     * **Validates: Requirement 4.10**
+     *
+     * @returns External endpoints or `null` if UPnP is not initialized or shutting down
+     */
+    async getExternalEndpoints() {
+        if (!this.initialized || this.shuttingDown) {
+            return null;
+        }
+        try {
+            const externalIp = await this.service.getExternalIp();
+            return {
+                http: `http://${externalIp}:${this.config.httpPort}`,
+                ws: `ws://${externalIp}:${this.config.websocketPort}`,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    // ─── Private: Port Mapping ──────────────────────────────────────────────
+    /**
+     * Create the HTTP port mapping on the router.
+     *
+     * **Validates: Requirement 4.2** — Uses configurable description prefix
+     */
+    async createHttpMapping() {
+        const mapping = {
+            public: this.config.httpPort,
+            private: this.config.httpPort,
+            protocol: 'tcp',
+            description: `${this.descriptionPrefix} HTTP`,
+            ttl: this.config.ttl,
+        };
+        await this.service.createPortMapping(mapping);
+    }
+    /**
+     * Create the WebSocket port mapping on the router.
+     *
+     * Only called when websocketPort differs from httpPort.
+     *
+     * **Validates: Requirement 4.3** — Uses configurable description prefix
+     */
+    async createWebSocketMapping() {
+        const mapping = {
+            public: this.config.websocketPort,
+            private: this.config.websocketPort,
+            protocol: 'tcp',
+            description: `${this.descriptionPrefix} WebSocket`,
+            ttl: this.config.ttl,
+        };
+        await this.service.createPortMapping(mapping);
+    }
+    /**
+     * Whether the WebSocket port requires a separate mapping.
+     *
+     * @returns `true` if websocketPort differs from httpPort
+     */
+    get needsWebSocketMapping() {
+        return this.config.websocketPort !== this.config.httpPort;
+    }
+    // ─── Private: Refresh ───────────────────────────────────────────────────
+    /**
+     * Start the periodic refresh timer.
+     *
+     * **Validates: Requirement 4.8** — Refresh mappings before TTL expiration
+     */
+    startRefreshTimer() {
+        if (this.refreshTimer) {
+            return;
+        }
+        const intervalMs = this.config.refreshInterval;
+        console.log(`${LOG_PREFIX} Refresh timer started (interval: ${intervalMs}ms)`);
+        this.refreshTimer = setInterval(() => {
+            void this.refresh();
+        }, intervalMs);
+        // Allow the process to exit even if the timer is still running
+        if (this.refreshTimer &&
+            typeof this.refreshTimer === 'object' &&
+            'unref' in this.refreshTimer) {
+            this.refreshTimer.unref();
+        }
+    }
+    /**
+     * Stop the periodic refresh timer.
+     */
+    stopRefreshTimer() {
+        if (this.refreshTimer) {
+            clearInterval(this.refreshTimer);
+            this.refreshTimer = null;
+            console.log(`${LOG_PREFIX} Refresh timer stopped`);
+        }
+    }
+    /**
+     * Refresh all active port mappings.
+     *
+     * **Validates: Requirement 4.8** — Re-create each active mapping to renew TTL
+     */
+    async refresh() {
+        if (this.shuttingDown) {
+            return;
+        }
+        try {
+            // Get current active mappings from the service
+            const activeMappings = await this.service.getMappings();
+            if (activeMappings.length === 0) {
+                // No active mappings — try to recreate
+                console.warn(`${LOG_PREFIX} No active mappings found during refresh, recreating...`);
+                await this.createHttpMapping();
+                if (this.needsWebSocketMapping) {
+                    await this.createWebSocketMapping();
+                }
+                this.consecutiveRefreshFailures = 0;
+                console.log(`${LOG_PREFIX} Mapping(s) recreated successfully`);
+                return;
+            }
+            // Refresh each active mapping by re-creating it
+            const errors = [];
+            for (const mapping of activeMappings) {
+                try {
+                    await this.service.createPortMapping(mapping);
+                }
+                catch (error) {
+                    const msg = error instanceof Error ? error.message : String(error);
+                    errors.push(`${mapping.public}/${mapping.protocol}: ${msg}`);
+                }
+            }
+            if (errors.length > 0) {
+                console.warn(`${LOG_PREFIX} Partial refresh failure: ${errors.join('; ')}`);
+                this.consecutiveRefreshFailures++;
+                this.scheduleBackoffRefresh();
+                return;
+            }
+            // Verify mappings still exist after refresh
+            const verifiedMappings = await this.service.getMappings();
+            if (verifiedMappings.length < activeMappings.length) {
+                console.warn(`${LOG_PREFIX} Mapping verification failed — ` +
+                    `expected ${activeMappings.length}, found ${verifiedMappings.length}. Recreating...`);
+                await this.createHttpMapping();
+                if (this.needsWebSocketMapping) {
+                    await this.createWebSocketMapping();
+                }
+            }
+            this.consecutiveRefreshFailures = 0;
+            console.log(`${LOG_PREFIX} Refresh complete (${verifiedMappings.length} mapping(s) active)`);
+        }
+        catch (error) {
+            this.consecutiveRefreshFailures++;
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`${LOG_PREFIX} Refresh failed (attempt ${this.consecutiveRefreshFailures}): ${message}`);
+            this.scheduleBackoffRefresh();
+        }
+    }
+    /**
+     * Schedule an additional refresh with exponential backoff.
+     *
+     * **Validates: Requirement 4.9** — Exponential backoff capped at 8× retryDelay
+     */
+    scheduleBackoffRefresh() {
+        const multiplier = Math.min(Math.pow(2, this.consecutiveRefreshFailures - 1), MAX_BACKOFF_MULTIPLIER);
+        const backoffMs = this.config.retryDelay * multiplier;
+        console.warn(`${LOG_PREFIX} Scheduling backoff refresh in ${backoffMs}ms ` +
+            `(failure #${this.consecutiveRefreshFailures})`);
+        const timer = setTimeout(() => {
+            void this.refresh();
+        }, backoffMs);
+        // Don't prevent process exit
+        if (timer && typeof timer === 'object' && 'unref' in timer) {
+            timer.unref();
+        }
+    }
+    // ─── Private: Signal Handling ───────────────────────────────────────────
+    /**
+     * Register SIGTERM and SIGINT handlers for graceful shutdown.
+     *
+     * **Validates: Requirement 4.4** — Register signal handlers during initialization
+     */
+    registerSignalHandlers() {
+        process.on('SIGTERM', this.boundSignalHandlers.sigterm);
+        process.on('SIGINT', this.boundSignalHandlers.sigint);
+    }
+    /**
+     * Remove previously registered signal handlers.
+     */
+    removeSignalHandlers() {
+        process.removeListener('SIGTERM', this.boundSignalHandlers.sigterm);
+        process.removeListener('SIGINT', this.boundSignalHandlers.sigint);
+    }
+    /**
+     * Handle a process signal by performing graceful shutdown.
+     *
+     * @param signal - The signal name (e.g. `'SIGTERM'`, `'SIGINT'`)
+     */
+    async handleSignal(signal) {
+        console.log(`${LOG_PREFIX} Received ${signal}, shutting down UPnP...`);
+        await this.shutdown();
+    }
+    // ─── Private: Logging Helpers ───────────────────────────────────────────
+    /**
+     * Log manual port-forwarding instructions when UPnP is unavailable.
+     *
+     * **Validates: Requirement 4.7** — Log warning with manual instructions
+     */
+    logManualPortForwardingInstructions() {
+        let instructions = `${LOG_PREFIX} UPnP not available. Manual port forwarding required:\n` +
+            `  Forward external port ${this.config.httpPort} to internal port ${this.config.httpPort}\n` +
+            `  Protocol: TCP\n` +
+            `  Description: ${this.descriptionPrefix} HTTP`;
+        if (this.needsWebSocketMapping) {
+            instructions +=
+                `\n  Forward external port ${this.config.websocketPort} to internal port ${this.config.websocketPort}\n` +
+                    `  Protocol: TCP\n` +
+                    `  Description: ${this.descriptionPrefix} WebSocket`;
+        }
+        console.warn(instructions);
+    }
+}
+exports.UpnpManager = UpnpManager;
+//# sourceMappingURL=upnp-manager.js.map

package/src/services/upnp-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upnp-manager.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/services/upnp-manager.ts"],"names":[],"mappings":"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"}