raffel 0.1.2

package/dist/server/fs-routes/udp/loader.js

@@ -0,0 +1,282 @@
+/**
+ * UDP Custom Handler Loader
+ *
+ * Loads custom UDP handlers from file system and creates servers.
+ */
+import { createSocket } from 'node:dgram';
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join, parse as parsePath } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { createLogger } from '../../../utils/logger.js';
+import { sid } from '../../../utils/id/index.js';
+import { createContext } from '../../../types/context.js';
+const logger = createLogger('udp-loader');
+// === Default Configuration ===
+const DEFAULT_CONFIG = {
+    port: 9001,
+    host: '0.0.0.0',
+    type: 'udp4',
+    reuseAddr: true,
+    reusePort: false,
+    recvBufferSize: 65536,
+    sendBufferSize: 65536,
+    ipv6Only: false,
+    multicast: null,
+};
+// === Main Loader ===
+/**
+ * Load UDP handlers from directory.
+ */
+export async function loadUdpHandlers(options) {
+    const startTime = Date.now();
+    const extensions = options.extensions ?? ['.ts', '.js'];
+    const handlers = [];
+    if (!existsSync(options.udpDir)) {
+        logger.debug({ dir: options.udpDir }, 'UDP directory not found');
+        return {
+            handlers: [],
+            stats: { handlers: 0, duration: Date.now() - startTime },
+        };
+    }
+    const entries = readdirSync(options.udpDir);
+    for (const entry of entries) {
+        const fullPath = join(options.udpDir, entry);
+        const stat = statSync(fullPath);
+        if (!stat.isFile())
+            continue;
+        const { name, ext } = parsePath(entry);
+        if (!extensions.includes(ext))
+            continue;
+        if (name.startsWith('_'))
+            continue;
+        try {
+            const exports = await importFile(fullPath);
+            if (!exports.onMessage) {
+                logger.warn({ filePath: fullPath }, 'UDP file missing onMessage export');
+                continue;
+            }
+            const config = resolveConfig(exports.config, options.defaultPort);
+            handlers.push({
+                name,
+                filePath: fullPath,
+                config,
+                handlers: exports,
+            });
+            logger.info({ name, port: config.port }, 'Loaded UDP handler');
+        }
+        catch (err) {
+            logger.error({ err, filePath: fullPath }, 'Failed to load UDP handler');
+        }
+    }
+    return {
+        handlers,
+        stats: {
+            handlers: handlers.length,
+            duration: Date.now() - startTime,
+        },
+    };
+}
+// === Config Resolution ===
+function resolveConfig(config, defaultPort) {
+    const resolved = {
+        ...DEFAULT_CONFIG,
+        ...config,
+        port: config?.port ?? defaultPort ?? DEFAULT_CONFIG.port,
+        multicast: config?.multicast ?? null,
+    };
+    return resolved;
+}
+// === Server Creation ===
+/**
+ * Create a UDP server instance from a loaded handler.
+ */
+export function createUdpServer(handler) {
+    const { name, config, handlers } = handler;
+    const socket = createSocket({
+        type: config.type,
+        reuseAddr: config.reuseAddr,
+        recvBufferSize: config.recvBufferSize,
+        sendBufferSize: config.sendBufferSize,
+        ipv6Only: config.ipv6Only,
+    });
+    // Create base context (without sender info)
+    function createBaseContext() {
+        const baseCtx = createContext(sid());
+        let currentSender;
+        return {
+            ...baseCtx,
+            socket,
+            address: { host: config.host, port: config.port },
+            sender: currentSender,
+            async send(data, port, address) {
+                const buf = typeof data === 'string' ? Buffer.from(data) : data;
+                return new Promise((resolve, reject) => {
+                    socket.send(buf, port, address, (err) => {
+                        if (err)
+                            reject(err);
+                        else
+                            resolve();
+                    });
+                });
+            },
+            async broadcast(data, targets) {
+                const buf = typeof data === 'string' ? Buffer.from(data) : data;
+                await Promise.all(targets.map(({ port, address }) => new Promise((resolve, reject) => {
+                    socket.send(buf, port, address, (err) => {
+                        if (err)
+                            reject(err);
+                        else
+                            resolve();
+                    });
+                })));
+            },
+            async reply(data) {
+                if (!currentSender) {
+                    throw new Error('No sender to reply to');
+                }
+                const buf = typeof data === 'string' ? Buffer.from(data) : data;
+                return new Promise((resolve, reject) => {
+                    socket.send(buf, currentSender.port, currentSender.address, (err) => {
+                        if (err)
+                            reject(err);
+                        else
+                            resolve();
+                    });
+                });
+            },
+        };
+    }
+    // Message handler
+    socket.on('message', async (data, rinfo) => {
+        const ctx = createBaseContext();
+        ctx.sender = rinfo;
+        try {
+            const response = await handlers.onMessage(data, rinfo, ctx);
+            // If handler returns a Buffer, send it back
+            if (response) {
+                socket.send(response, rinfo.port, rinfo.address, (err) => {
+                    if (err) {
+                        logger.error({ err, rinfo }, 'Error sending UDP response');
+                    }
+                });
+            }
+        }
+        catch (err) {
+            logger.error({ err, rinfo }, 'Error in onMessage handler');
+        }
+    });
+    // Listening handler
+    socket.on('listening', () => {
+        const addr = socket.address();
+        logger.info({ name, host: addr.address, port: addr.port }, 'UDP server listening');
+        if (handlers.onListening) {
+            const ctx = createBaseContext();
+            Promise.resolve(handlers.onListening(ctx)).catch(err => {
+                logger.error({ err }, 'Error in onListening handler');
+            });
+        }
+    });
+    // Error handler
+    socket.on('error', (error) => {
+        if (handlers.onError) {
+            const ctx = createBaseContext();
+            Promise.resolve(handlers.onError(error, ctx)).catch(err => {
+                logger.error({ err }, 'Error in onError handler');
+            });
+        }
+        else {
+            logger.error({ error }, 'UDP socket error');
+        }
+    });
+    // Close handler
+    socket.on('close', () => {
+        if (handlers.onClose) {
+            const ctx = createBaseContext();
+            Promise.resolve(handlers.onClose(ctx)).catch(err => {
+                logger.error({ err }, 'Error in onClose handler');
+            });
+        }
+        logger.info({ name }, 'UDP server closed');
+    });
+    return {
+        name,
+        socket,
+        port: config.port,
+        host: config.host,
+        async start() {
+            return new Promise((resolve, reject) => {
+                socket.once('error', reject);
+                socket.bind(config.port, config.host, () => {
+                    socket.removeListener('error', reject);
+                    // Configure multicast if enabled
+                    if (config.multicast) {
+                        try {
+                            socket.addMembership(config.multicast.group, config.multicast.interface);
+                            if (config.multicast.ttl !== undefined) {
+                                socket.setMulticastTTL(config.multicast.ttl);
+                            }
+                            socket.setMulticastLoopback(config.multicast.loopback ?? false);
+                            logger.info({ name, group: config.multicast.group }, 'Joined multicast group');
+                        }
+                        catch (err) {
+                            logger.error({ err, config: config.multicast }, 'Failed to configure multicast');
+                        }
+                    }
+                    // Set buffer sizes after bind
+                    if (config.recvBufferSize) {
+                        socket.setRecvBufferSize(config.recvBufferSize);
+                    }
+                    if (config.sendBufferSize) {
+                        socket.setSendBufferSize(config.sendBufferSize);
+                    }
+                    resolve();
+                });
+            });
+        },
+        async stop() {
+            return new Promise((resolve) => {
+                // Leave multicast group if joined
+                if (config.multicast) {
+                    try {
+                        socket.dropMembership(config.multicast.group, config.multicast.interface);
+                    }
+                    catch {
+                        // Ignore errors
+                    }
+                }
+                socket.close(() => {
+                    resolve();
+                });
+            });
+        },
+        async send(data, port, address) {
+            const buf = typeof data === 'string' ? Buffer.from(data) : data;
+            return new Promise((resolve, reject) => {
+                socket.send(buf, port, address, (err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        },
+        async broadcast(data, targets) {
+            const buf = typeof data === 'string' ? Buffer.from(data) : data;
+            await Promise.all(targets.map(({ port, address }) => new Promise((resolve, reject) => {
+                socket.send(buf, port, address, (err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            })));
+        },
+    };
+}
+// === File Import ===
+async function importFile(filePath) {
+    const fileUrl = pathToFileURL(filePath).href;
+    const urlWithCacheBust = `${fileUrl}?t=${Date.now()}`;
+    return import(urlWithCacheBust);
+}
+//# sourceMappingURL=loader.js.map

package/dist/server/fs-routes/udp/loader.js.map

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

package/dist/server/fs-routes/udp/types.d.ts

@@ -0,0 +1,164 @@
+/**
+ * UDP Custom Handler Types
+ *
+ * Type definitions for custom UDP handlers with full control.
+ */
+import type { Socket as UdpSocket, RemoteInfo, SocketType } from 'node:dgram';
+import type { Context } from '../../../types/index.js';
+export interface UdpConfig {
+    /** Port to listen on */
+    port: number;
+    /** Host to bind to (default: '0.0.0.0') */
+    host?: string;
+    /** Socket type (default: 'udp4') */
+    type?: SocketType;
+    /** Reuse address (default: true) */
+    reuseAddr?: boolean;
+    /** Reuse port (default: false) */
+    reusePort?: boolean;
+    /** Receive buffer size */
+    recvBufferSize?: number;
+    /** Send buffer size */
+    sendBufferSize?: number;
+    /** Enable IPv6 only (for udp6) */
+    ipv6Only?: boolean;
+    /** Enable multicast */
+    multicast?: UdpMulticastConfig;
+}
+export interface UdpMulticastConfig {
+    /** Multicast group to join */
+    group: string;
+    /** Interface to use for multicast */
+    interface?: string;
+    /** Multicast TTL (default: 1) */
+    ttl?: number;
+    /** Enable multicast loopback (default: false) */
+    loopback?: boolean;
+}
+/**
+ * Context available in UDP handlers.
+ */
+export interface UdpContext extends Omit<Context, 'deadline' | 'signal'> {
+    /** The UDP socket */
+    socket: UdpSocket;
+    /** Server address */
+    address: {
+        host: string;
+        port: number;
+    };
+    /** Send data to an address */
+    send(data: Buffer | string, port: number, address: string): Promise<void>;
+    /** Send to multiple addresses */
+    broadcast(data: Buffer | string, targets: Array<{
+        port: number;
+        address: string;
+    }>): Promise<void>;
+    /** Reply to the sender (shortcut) */
+    reply(data: Buffer | string): Promise<void>;
+    /** Current message sender info (only in onMessage) */
+    sender?: RemoteInfo;
+}
+/**
+ * UDP handler file exports.
+ *
+ * @example
+ * ```typescript
+ * // src/udp/metrics-collector.ts
+ * import type { RemoteInfo } from 'node:dgram'
+ * import type { UdpContext } from 'raffel'
+ *
+ * export const config = {
+ *   port: 9001,
+ * }
+ *
+ * export function onMessage(data: Buffer, rinfo: RemoteInfo, ctx: UdpContext) {
+ *   const metrics = parseMetrics(data)
+ *   storeMetrics(metrics)
+ *   // No response (fire-and-forget)
+ * }
+ *
+ * // Or with response
+ * export async function onMessage(data: Buffer, rinfo: RemoteInfo, ctx: UdpContext) {
+ *   const result = await processRequest(data)
+ *   return Buffer.from(JSON.stringify(result))
+ *   // Automatically sent back to sender
+ * }
+ * ```
+ */
+export interface UdpHandlerExports {
+    /** UDP configuration */
+    config?: UdpConfig;
+    /**
+     * Called when a message is received.
+     * Return a Buffer to automatically send a response.
+     */
+    onMessage: UdpMessageHandler;
+    /**
+     * Called when socket is ready to receive.
+     */
+    onListening?: UdpListeningHandler;
+    /**
+     * Called on socket error.
+     */
+    onError?: UdpErrorHandler;
+    /**
+     * Called when socket closes.
+     */
+    onClose?: UdpCloseHandler;
+}
+export type UdpMessageHandler = (data: Buffer, rinfo: RemoteInfo, ctx: UdpContext) => void | Buffer | Promise<void | Buffer>;
+export type UdpListeningHandler = (ctx: UdpContext) => void | Promise<void>;
+export type UdpErrorHandler = (error: Error, ctx: UdpContext) => void | Promise<void>;
+export type UdpCloseHandler = (ctx: UdpContext) => void | Promise<void>;
+export interface LoadedUdpHandler {
+    /** Handler name (from filename) */
+    name: string;
+    /** File path */
+    filePath: string;
+    /** Resolved configuration */
+    config: ResolvedUdpConfig;
+    /** Handler exports */
+    handlers: UdpHandlerExports;
+}
+export interface ResolvedUdpConfig extends Required<Omit<UdpConfig, 'multicast'>> {
+    multicast: UdpMulticastConfig | null;
+}
+export interface UdpLoaderOptions {
+    /** Base directory */
+    baseDir: string;
+    /** UDP directory path */
+    udpDir: string;
+    /** File extensions to load */
+    extensions?: string[];
+    /** Default port if not specified in handler */
+    defaultPort?: number;
+}
+export interface UdpLoaderResult {
+    handlers: LoadedUdpHandler[];
+    stats: {
+        handlers: number;
+        duration: number;
+    };
+}
+export interface UdpServerInstance {
+    /** Handler name */
+    name: string;
+    /** UDP socket */
+    socket: UdpSocket;
+    /** Port */
+    port: number;
+    /** Host */
+    host: string;
+    /** Start the server */
+    start(): Promise<void>;
+    /** Stop the server */
+    stop(): Promise<void>;
+    /** Send data to address */
+    send(data: Buffer | string, port: number, address: string): Promise<void>;
+    /** Broadcast to multiple addresses */
+    broadcast(data: Buffer | string, targets: Array<{
+        port: number;
+        address: string;
+    }>): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/fs-routes/udp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/fs-routes/udp/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAItD,MAAM,WAAW,SAAS;IACxB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAA;IAEZ,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,oCAAoC;IACpC,IAAI,CAAC,EAAE,UAAU,CAAA;IAEjB,oCAAoC;IACpC,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB,kCAAkC;IAClC,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB,0BAA0B;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,uBAAuB;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB,uBAAuB;IACvB,SAAS,CAAC,EAAE,kBAAkB,CAAA;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAA;IAEb,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAID;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,QAAQ,CAAC;IACtE,qBAAqB;IACrB,MAAM,EAAE,SAAS,CAAA;IAEjB,qBAAqB;IACrB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAEvC,8BAA8B;IAC9B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzE,iCAAiC;IACjC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElG,qCAAqC;IACrC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE3C,sDAAsD;IACtD,MAAM,CAAC,EAAE,UAAU,CAAA;CACpB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,MAAM,CAAC,EAAE,SAAS,CAAA;IAElB;;;OAGG;IACH,SAAS,EAAE,iBAAiB,CAAA;IAE5B;;OAEG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAA;IAEjC;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,CAAA;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,CAAA;CAC1B;AAID,MAAM,MAAM,iBAAiB,GAAG,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,UAAU,KACZ,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CAAA;AAE3C,MAAM,MAAM,mBAAmB,GAAG,CAChC,GAAG,EAAE,UAAU,KACZ,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEzB,MAAM,MAAM,eAAe,GAAG,CAC5B,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,UAAU,KACZ,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEzB,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,UAAU,KACZ,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAIzB,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAA;IAEZ,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAA;IAEhB,6BAA6B;IAC7B,MAAM,EAAE,iBAAiB,CAAA;IAEzB,sBAAsB;IACtB,QAAQ,EAAE,iBAAiB,CAAA;CAC5B;AAED,MAAM,WAAW,iBAAkB,SAAQ,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC/E,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAAA;CACrC;AAID,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAA;IAEf,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAA;IAEd,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IAErB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,gBAAgB,EAAE,CAAA;IAC5B,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;CACF;AAID,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAA;IAEZ,iBAAiB;IACjB,MAAM,EAAE,SAAS,CAAA;IAEjB,WAAW;IACX,IAAI,EAAE,MAAM,CAAA;IAEZ,WAAW;IACX,IAAI,EAAE,MAAM,CAAA;IAEZ,uBAAuB;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtB,sBAAsB;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAErB,2BAA2B;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzE,sCAAsC;IACtC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACnG"}

package/dist/server/fs-routes/udp/types.js

@@ -0,0 +1,7 @@
+/**
+ * UDP Custom Handler Types
+ *
+ * Type definitions for custom UDP handlers with full control.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/fs-routes/udp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/server/fs-routes/udp/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/server/fs-routes/watcher.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Hot Reload Watcher
+ *
+ * Watches discovery directories for changes and triggers reload.
+ */
+import { type DiscoveryResult } from './loader.js';
+import type { DiscoveryLoaderOptions } from './types.js';
+export interface DiscoveryWatcherOptions extends DiscoveryLoaderOptions {
+    /** Debounce delay in ms (default: 100) */
+    debounceMs?: number;
+    /** Called when handlers are reloaded */
+    onReload?: (result: DiscoveryResult) => void | Promise<void>;
+}
+export interface DiscoveryWatcher {
+    /** Start watching for changes */
+    start(): Promise<DiscoveryResult>;
+    /** Stop watching */
+    stop(): void;
+    /** Force reload all handlers */
+    reload(): Promise<DiscoveryResult>;
+    /** Check if watcher is active */
+    readonly isWatching: boolean;
+    /** Get current discovery result */
+    readonly result: DiscoveryResult | null;
+}
+/**
+ * Create a discovery watcher for hot reload
+ */
+export declare function createDiscoveryWatcher(options: DiscoveryWatcherOptions): DiscoveryWatcher;
+/**
+ * Check if running in development mode
+ */
+export declare function isDevelopment(): boolean;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/server/fs-routes/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../../src/server/fs-routes/watcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAmC,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AACnF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAIxD,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;IACrE,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7D;AAED,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC,CAAA;IAEjC,oBAAoB;IACpB,IAAI,IAAI,IAAI,CAAA;IAEZ,gCAAgC;IAChC,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC,CAAA;IAElC,iCAAiC;IACjC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAE5B,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAA;CACxC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CAiLzF;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC"}

package/dist/server/fs-routes/watcher.js

@@ -0,0 +1,158 @@
+/**
+ * Hot Reload Watcher
+ *
+ * Watches discovery directories for changes and triggers reload.
+ */
+import { watch } from 'node:fs';
+import { join, extname } from 'node:path';
+import { existsSync } from 'node:fs';
+import { createLogger } from '../../utils/logger.js';
+import { loadDiscovery, clearModuleCache } from './loader.js';
+const logger = createLogger('fs-watcher');
+/**
+ * Create a discovery watcher for hot reload
+ */
+export function createDiscoveryWatcher(options) {
+    const { debounceMs = 100, onReload, onError, ...loaderOptions } = options;
+    const watchers = [];
+    let currentResult = null;
+    let reloadTimeout = null;
+    let isWatching = false;
+    const extensions = loaderOptions.extensions ?? ['.ts', '.js'];
+    /**
+     * Get directories to watch
+     */
+    function getWatchDirs() {
+        const baseDir = loaderOptions.baseDir ?? process.cwd();
+        const dirs = [];
+        const config = loaderOptions.discovery === true
+            ? { http: true, channels: true, rpc: true, streams: true, rest: true, resources: true, tcp: true, udp: true }
+            : loaderOptions.discovery || {};
+        const defaults = {
+            http: './src/http',
+            channels: './src/channels',
+            rpc: './src/rpc',
+            streams: './src/streams',
+            rest: './src/rest',
+            resources: './src/resources',
+            tcp: './src/tcp',
+            udp: './src/udp',
+        };
+        for (const [key, defaultPath] of Object.entries(defaults)) {
+            const value = config[key];
+            if (value) {
+                const dir = value === true ? join(baseDir, defaultPath) : join(baseDir, value);
+                if (existsSync(dir)) {
+                    dirs.push(dir);
+                }
+            }
+        }
+        return dirs;
+    }
+    /**
+     * Schedule a debounced reload
+     */
+    function scheduleReload(changedFile) {
+        if (reloadTimeout) {
+            clearTimeout(reloadTimeout);
+        }
+        reloadTimeout = setTimeout(async () => {
+            reloadTimeout = null;
+            try {
+                logger.info({ file: changedFile }, 'File changed, reloading handlers...');
+                // Clear cache for changed file
+                clearModuleCache(changedFile);
+                // Reload all handlers
+                const result = await loadDiscovery(loaderOptions);
+                currentResult = result;
+                logger.info({ total: result.stats.total, duration: result.stats.duration }, 'Handlers reloaded');
+                if (onReload) {
+                    await onReload(result);
+                }
+            }
+            catch (err) {
+                logger.error({ err }, 'Failed to reload handlers');
+                if (onError) {
+                    onError(err);
+                }
+            }
+        }, debounceMs);
+    }
+    /**
+     * Handle file change event
+     */
+    function handleChange(eventType, filename, dir) {
+        if (!filename)
+            return;
+        // Check if it's a relevant file
+        const ext = extname(filename);
+        if (!extensions.includes(ext))
+            return;
+        const fullPath = join(dir, filename);
+        scheduleReload(fullPath);
+    }
+    return {
+        async start() {
+            if (isWatching) {
+                throw new Error('Watcher is already running');
+            }
+            // Initial load
+            currentResult = await loadDiscovery(loaderOptions);
+            // Start watching if hot reload is enabled
+            if (loaderOptions.hotReload !== false) {
+                const dirs = getWatchDirs();
+                for (const dir of dirs) {
+                    try {
+                        const watcher = watch(dir, { recursive: true }, (eventType, filename) => handleChange(eventType, filename, dir));
+                        watcher.on('error', (err) => {
+                            logger.error({ err, dir }, 'Watcher error');
+                            if (onError) {
+                                onError(err);
+                            }
+                        });
+                        watchers.push(watcher);
+                        logger.debug({ dir }, 'Watching directory');
+                    }
+                    catch (err) {
+                        logger.warn({ err, dir }, 'Failed to watch directory');
+                    }
+                }
+                isWatching = true;
+                logger.info({ dirs: dirs.length }, 'Hot reload watcher started');
+            }
+            return currentResult;
+        },
+        stop() {
+            if (reloadTimeout) {
+                clearTimeout(reloadTimeout);
+                reloadTimeout = null;
+            }
+            for (const watcher of watchers) {
+                watcher.close();
+            }
+            watchers.length = 0;
+            isWatching = false;
+            logger.info('Hot reload watcher stopped');
+        },
+        async reload() {
+            currentResult = await loadDiscovery(loaderOptions);
+            if (onReload) {
+                await onReload(currentResult);
+            }
+            return currentResult;
+        },
+        get isWatching() {
+            return isWatching;
+        },
+        get result() {
+            return currentResult;
+        },
+    };
+}
+/**
+ * Check if running in development mode
+ */
+export function isDevelopment() {
+    return process.env.NODE_ENV !== 'production';
+}
+//# sourceMappingURL=watcher.js.map