@singhak/nodeui-fastify 0.3.0 → 0.5.0

package/README.md

@@ -1,52 +1,52 @@
-# @singhak/nodeui-fastify
-
-Fastify plugin adapter for the NodeUI developer console. Serves the bundled React
-console and its API under `{path}` (default `/nodeui`), records app requests in
-the request-log panel and lists your Fastify routes in the routes panel.
-
-Supports Fastify 4 and 5.
-
-## Install
-
-```bash
-npm install @singhak/nodeui-fastify
-```
-
-## Usage
-
-```ts
-import Fastify from 'fastify';
-import { nodeui } from '@singhak/nodeui-fastify';
-
-const app = Fastify();
-const ui = nodeui();
-
-// Register before your routes so they appear in the routes panel.
-await app.register(ui);
-
-app.get('/hello', async () => ({ hello: 'world' }));
-
-await app.listen({ port: 3000, host: '127.0.0.1' });
-ui.server.mark('listening');
-```
-
-Open `http://127.0.0.1:3000/nodeui` for the console and
-`http://127.0.0.1:3000/nodeui/api/config` for the API.
-
-The plugin is not encapsulated (equivalent to `fastify-plugin`), shuts the
-server down on `app.close()`, and does nothing when NodeUI is disabled (for
-example when `NODE_ENV=production`).
-
-## Options
-
-`nodeui(options?)` accepts any `@singhak/nodeui-core` `NodeUIOptions` (path, host
-allow-lists, auth token, plugins, health checks, etc.). See the
-`@singhak/nodeui-core` README for the full configuration table and safety model.
-
-## Development
-
-```bash
-npm run typecheck
-npm test
-npm run build
-```
+# @singhak/nodeui-fastify
+
+Fastify plugin adapter for the NodeUI developer console. Serves the bundled React
+console and its API under `{path}` (default `/nodeui`), records app requests in
+the request-log panel and lists your Fastify routes in the routes panel.
+
+Supports Fastify 4 and 5.
+
+## Install
+
+```bash
+npm install @singhak/nodeui-fastify
+```
+
+## Usage
+
+```ts
+import Fastify from 'fastify';
+import { nodeui } from '@singhak/nodeui-fastify';
+
+const app = Fastify();
+const ui = nodeui();
+
+// Register before your routes so they appear in the routes panel.
+await app.register(ui);
+
+app.get('/hello', async () => ({ hello: 'world' }));
+
+await app.listen({ port: 3000, host: '127.0.0.1' });
+ui.server.mark('listening');
+```
+
+Open `http://127.0.0.1:3000/nodeui` for the console and
+`http://127.0.0.1:3000/nodeui/api/config` for the API.
+
+The plugin is not encapsulated (equivalent to `fastify-plugin`), shuts the
+server down on `app.close()`, and does nothing when NodeUI is disabled (for
+example when `NODE_ENV=production`).
+
+## Options
+
+`nodeui(options?)` accepts any `@singhak/nodeui-core` `NodeUIOptions` (path, host
+allow-lists, auth token, plugins, health checks, etc.). See the
+`@singhak/nodeui-core` README for the full configuration table and safety model.
+
+## Development
+
+```bash
+npm run typecheck
+npm test
+npm run build
+```

package/dist/index.cjs

@@ -64,7 +64,16 @@ function nodeui(options) {
         await server.handle(req.raw, reply.raw);
         return;
       }
+      const pattern = req.routeOptions?.url ?? req.routerPath;
+      if (pattern) req.raw.nodeuiRoute = pattern;
       recorder(req.raw, reply.raw, () => void 0);
+      (0, import_nodeui_core.enterRequestContext)(req.raw);
+    });
+    app.addHook("onError", (req, _reply, error, hookDone) => {
+      server.recordError(error, {
+        route: req.routeOptions?.url
+      });
+      hookDone();
     });
     app.addHook("onClose", (_instance, next) => {
       server.shutdown();

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { FastifyInstance, FastifyPluginCallback, RouteOptions } from 'fastify';\r\nimport {\r\n  createNodeUI,\r\n  type NodeUIOptions,\r\n  type NodeUIServer,\r\n  type RouteEntry,\r\n} from '@singhak/nodeui-core';\r\n\r\nexport interface NodeUIFastifyPlugin extends FastifyPluginCallback {\r\n  /** Handle to the underlying server (mark, shutdown, config). */\r\n  server: NodeUIServer;\r\n  /** Pushes an external log entry into the log viewer (logger adapter). */\r\n  addLogSource: NodeUIServer['addLogSource'];\r\n}\r\n\r\nfunction pathnameOf(url: string | undefined): string {\r\n  try {\r\n    return new URL(url ?? '/', 'http://localhost').pathname;\r\n  } catch {\r\n    return url ?? '/';\r\n  }\r\n}\r\n\r\n/**\r\n * Creates the NodeUI Fastify plugin. Register it before your routes so the\r\n * routes panel and request log see them.\r\n *\r\n * @example\r\n * const ui = nodeui();\r\n * await app.register(ui);\r\n * await app.listen({ port: 3000, host: '127.0.0.1' });\r\n * ui.server.mark('listening');\r\n */\r\nexport function nodeui(options?: NodeUIOptions): NodeUIFastifyPlugin {\r\n  const server = createNodeUI(options);\r\n  const prefix = server.config.path;\r\n  const isUnderPrefix = (p: string): boolean => p === prefix || p.startsWith(`${prefix}/`);\r\n  const recorder = server.middleware();\r\n  const routes = new Map<string, RouteEntry>();\r\n\r\n  const plugin = ((app: FastifyInstance, _opts: unknown, done: (err?: Error) => void) => {\r\n    if (!server.active) {\r\n      done();\r\n      return;\r\n    }\r\n\r\n    server.setRoutes(() =>\r\n      [...routes.values()].sort(\r\n        (a, b) => a.path.localeCompare(b.path) || a.method.localeCompare(b.method),\r\n      ),\r\n    );\r\n\r\n    app.addHook('onRoute', (route: RouteOptions) => {\r\n      const methods = Array.isArray(route.method) ? route.method : [route.method];\r\n      const handler = (route.handler as { name?: string } | undefined)?.name || 'anonymous';\r\n      for (const m of methods) {\r\n        const method = String(m).toUpperCase();\r\n        if (isUnderPrefix(route.url)) continue;\r\n        routes.set(`${method} ${route.url}`, { method, path: route.url, handler });\r\n      }\r\n    });\r\n\r\n    app.addHook('onRequest', async (req, reply) => {\r\n      if (isUnderPrefix(pathnameOf(req.raw.url))) {\r\n        reply.hijack();\r\n        await server.handle(req.raw, reply.raw);\r\n        return;\r\n      }\r\n      // Core's middleware records the request (finish listener) then calls next.\r\n      recorder(req.raw, reply.raw, () => undefined);\r\n    });\r\n\r\n    app.addHook('onClose', (_instance, next) => {\r\n      server.shutdown();\r\n      next();\r\n    });\r\n    done();\r\n  }) as NodeUIFastifyPlugin;\r\n\r\n  // Same effect as fastify-plugin: expose hooks to the parent scope.\r\n  const marks = plugin as unknown as Record<symbol, unknown>;\r\n  marks[Symbol.for('skip-override')] = true;\r\n  marks[Symbol.for('fastify.display-name')] = 'nodeui-fastify';\r\n  plugin.server = server;\r\n  plugin.addLogSource = server.addLogSource;\r\n  return plugin;\r\n}\r\n\r\nexport * from '@singhak/nodeui-core';\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,yBAKO;AAkFP,0BAAc,iCAxFd;AAeA,SAAS,WAAW,KAAiC;AACnD,MAAI;AACF,WAAO,IAAI,IAAI,OAAO,KAAK,kBAAkB,EAAE;AAAA,EACjD,QAAQ;AACN,WAAO,OAAO;AAAA,EAChB;AACF;AAYO,SAAS,OAAO,SAA8C;AACnE,QAAM,aAAS,iCAAa,OAAO;AACnC,QAAM,SAAS,OAAO,OAAO;AAC7B,QAAM,gBAAgB,CAAC,MAAuB,MAAM,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG;AACvF,QAAM,WAAW,OAAO,WAAW;AACnC,QAAM,SAAS,oBAAI,IAAwB;AAE3C,QAAM,UAAU,CAAC,KAAsB,OAAgB,SAAgC;AACrF,QAAI,CAAC,OAAO,QAAQ;AAClB,WAAK;AACL;AAAA,IACF;AAEA,WAAO;AAAA,MAAU,MACf,CAAC,GAAG,OAAO,OAAO,CAAC,EAAE;AAAA,QACnB,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,KAAK,EAAE,OAAO,cAAc,EAAE,MAAM;AAAA,MAC3E;AAAA,IACF;AAEA,QAAI,QAAQ,WAAW,CAAC,UAAwB;AAC9C,YAAM,UAAU,MAAM,QAAQ,MAAM,MAAM,IAAI,MAAM,SAAS,CAAC,MAAM,MAAM;AAC1E,YAAM,UAAW,MAAM,SAA2C,QAAQ;AAC1E,iBAAW,KAAK,SAAS;AACvB,cAAM,SAAS,OAAO,CAAC,EAAE,YAAY;AACrC,YAAI,cAAc,MAAM,GAAG,EAAG;AAC9B,eAAO,IAAI,GAAG,MAAM,IAAI,MAAM,GAAG,IAAI,EAAE,QAAQ,MAAM,MAAM,KAAK,QAAQ,CAAC;AAAA,MAC3E;AAAA,IACF,CAAC;AAED,QAAI,QAAQ,aAAa,OAAO,KAAK,UAAU;AAC7C,UAAI,cAAc,WAAW,IAAI,IAAI,GAAG,CAAC,GAAG;AAC1C,cAAM,OAAO;AACb,cAAM,OAAO,OAAO,IAAI,KAAK,MAAM,GAAG;AACtC;AAAA,MACF;AAEA,eAAS,IAAI,KAAK,MAAM,KAAK,MAAM,MAAS;AAAA,IAC9C,CAAC;AAED,QAAI,QAAQ,WAAW,CAAC,WAAW,SAAS;AAC1C,aAAO,SAAS;AAChB,WAAK;AAAA,IACP,CAAC;AACD,SAAK;AAAA,EACP;AAGA,QAAM,QAAQ;AACd,QAAM,uBAAO,IAAI,eAAe,CAAC,IAAI;AACrC,QAAM,uBAAO,IAAI,sBAAsB,CAAC,IAAI;AAC5C,SAAO,SAAS;AAChB,SAAO,eAAe,OAAO;AAC7B,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { FastifyInstance, FastifyPluginCallback, RouteOptions } from 'fastify';\r\nimport {\r\n  createNodeUI,\r\n  enterRequestContext,\r\n  type NodeUIOptions,\r\n  type NodeUIServer,\r\n  type RouteEntry,\r\n} from '@singhak/nodeui-core';\r\n\r\nexport interface NodeUIFastifyPlugin extends FastifyPluginCallback {\r\n  /** Handle to the underlying server (mark, shutdown, config). */\r\n  server: NodeUIServer;\r\n  /** Pushes an external log entry into the log viewer (logger adapter). */\r\n  addLogSource: NodeUIServer['addLogSource'];\r\n}\r\n\r\nfunction pathnameOf(url: string | undefined): string {\r\n  try {\r\n    return new URL(url ?? '/', 'http://localhost').pathname;\r\n  } catch {\r\n    return url ?? '/';\r\n  }\r\n}\r\n\r\n/**\r\n * Creates the NodeUI Fastify plugin. Register it before your routes so the\r\n * routes panel and request log see them.\r\n *\r\n * @example\r\n * const ui = nodeui();\r\n * await app.register(ui);\r\n * await app.listen({ port: 3000, host: '127.0.0.1' });\r\n * ui.server.mark('listening');\r\n */\r\nexport function nodeui(options?: NodeUIOptions): NodeUIFastifyPlugin {\r\n  const server = createNodeUI(options);\r\n  const prefix = server.config.path;\r\n  const isUnderPrefix = (p: string): boolean => p === prefix || p.startsWith(`${prefix}/`);\r\n  const recorder = server.middleware();\r\n  const routes = new Map<string, RouteEntry>();\r\n\r\n  const plugin = ((app: FastifyInstance, _opts: unknown, done: (err?: Error) => void) => {\r\n    if (!server.active) {\r\n      done();\r\n      return;\r\n    }\r\n\r\n    server.setRoutes(() =>\r\n      [...routes.values()].sort(\r\n        (a, b) => a.path.localeCompare(b.path) || a.method.localeCompare(b.method),\r\n      ),\r\n    );\r\n\r\n    app.addHook('onRoute', (route: RouteOptions) => {\r\n      const methods = Array.isArray(route.method) ? route.method : [route.method];\r\n      const handler = (route.handler as { name?: string } | undefined)?.name || 'anonymous';\r\n      for (const m of methods) {\r\n        const method = String(m).toUpperCase();\r\n        if (isUnderPrefix(route.url)) continue;\r\n        routes.set(`${method} ${route.url}`, { method, path: route.url, handler });\r\n      }\r\n    });\r\n\r\n    app.addHook('onRequest', async (req, reply) => {\r\n      if (isUnderPrefix(pathnameOf(req.raw.url))) {\r\n        reply.hijack();\r\n        await server.handle(req.raw, reply.raw);\r\n        return;\r\n      }\r\n      // Expose the matched route pattern to core's request recorder.\r\n      const pattern =\r\n        (req as { routeOptions?: { url?: string } }).routeOptions?.url ??\r\n        (req as { routerPath?: string }).routerPath;\r\n      if (pattern) (req.raw as { nodeuiRoute?: string }).nodeuiRoute = pattern;\r\n      // Core's middleware records the request (finish listener) then calls next.\r\n      recorder(req.raw, reply.raw, () => undefined);\r\n      // Attribute outgoing calls and logs from the route handler to this request.\r\n      enterRequestContext(req.raw);\r\n    });\r\n\r\n    app.addHook('onError', (req, _reply, error, hookDone) => {\r\n      server.recordError(error, {\r\n        route: (req as { routeOptions?: { url?: string } }).routeOptions?.url,\r\n      });\r\n      hookDone();\r\n    });\r\n\r\n    app.addHook('onClose', (_instance, next) => {\r\n      server.shutdown();\r\n      next();\r\n    });\r\n    done();\r\n  }) as NodeUIFastifyPlugin;\r\n\r\n  // Same effect as fastify-plugin: expose hooks to the parent scope.\r\n  const marks = plugin as unknown as Record<symbol, unknown>;\r\n  marks[Symbol.for('skip-override')] = true;\r\n  marks[Symbol.for('fastify.display-name')] = 'nodeui-fastify';\r\n  plugin.server = server;\r\n  plugin.addLogSource = server.addLogSource;\r\n  return plugin;\r\n}\r\n\r\nexport * from '@singhak/nodeui-core';\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,yBAMO;AAgGP,0BAAc,iCAvGd;AAgBA,SAAS,WAAW,KAAiC;AACnD,MAAI;AACF,WAAO,IAAI,IAAI,OAAO,KAAK,kBAAkB,EAAE;AAAA,EACjD,QAAQ;AACN,WAAO,OAAO;AAAA,EAChB;AACF;AAYO,SAAS,OAAO,SAA8C;AACnE,QAAM,aAAS,iCAAa,OAAO;AACnC,QAAM,SAAS,OAAO,OAAO;AAC7B,QAAM,gBAAgB,CAAC,MAAuB,MAAM,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG;AACvF,QAAM,WAAW,OAAO,WAAW;AACnC,QAAM,SAAS,oBAAI,IAAwB;AAE3C,QAAM,UAAU,CAAC,KAAsB,OAAgB,SAAgC;AACrF,QAAI,CAAC,OAAO,QAAQ;AAClB,WAAK;AACL;AAAA,IACF;AAEA,WAAO;AAAA,MAAU,MACf,CAAC,GAAG,OAAO,OAAO,CAAC,EAAE;AAAA,QACnB,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,KAAK,EAAE,OAAO,cAAc,EAAE,MAAM;AAAA,MAC3E;AAAA,IACF;AAEA,QAAI,QAAQ,WAAW,CAAC,UAAwB;AAC9C,YAAM,UAAU,MAAM,QAAQ,MAAM,MAAM,IAAI,MAAM,SAAS,CAAC,MAAM,MAAM;AAC1E,YAAM,UAAW,MAAM,SAA2C,QAAQ;AAC1E,iBAAW,KAAK,SAAS;AACvB,cAAM,SAAS,OAAO,CAAC,EAAE,YAAY;AACrC,YAAI,cAAc,MAAM,GAAG,EAAG;AAC9B,eAAO,IAAI,GAAG,MAAM,IAAI,MAAM,GAAG,IAAI,EAAE,QAAQ,MAAM,MAAM,KAAK,QAAQ,CAAC;AAAA,MAC3E;AAAA,IACF,CAAC;AAED,QAAI,QAAQ,aAAa,OAAO,KAAK,UAAU;AAC7C,UAAI,cAAc,WAAW,IAAI,IAAI,GAAG,CAAC,GAAG;AAC1C,cAAM,OAAO;AACb,cAAM,OAAO,OAAO,IAAI,KAAK,MAAM,GAAG;AACtC;AAAA,MACF;AAEA,YAAM,UACH,IAA4C,cAAc,OAC1D,IAAgC;AACnC,UAAI,QAAS,CAAC,IAAI,IAAiC,cAAc;AAEjE,eAAS,IAAI,KAAK,MAAM,KAAK,MAAM,MAAS;AAE5C,kDAAoB,IAAI,GAAG;AAAA,IAC7B,CAAC;AAED,QAAI,QAAQ,WAAW,CAAC,KAAK,QAAQ,OAAO,aAAa;AACvD,aAAO,YAAY,OAAO;AAAA,QACxB,OAAQ,IAA4C,cAAc;AAAA,MACpE,CAAC;AACD,eAAS;AAAA,IACX,CAAC;AAED,QAAI,QAAQ,WAAW,CAAC,WAAW,SAAS;AAC1C,aAAO,SAAS;AAChB,WAAK;AAAA,IACP,CAAC;AACD,SAAK;AAAA,EACP;AAGA,QAAM,QAAQ;AACd,QAAM,uBAAO,IAAI,eAAe,CAAC,IAAI;AACrC,QAAM,uBAAO,IAAI,sBAAsB,CAAC,IAAI;AAC5C,SAAO,SAAS;AAChB,SAAO,eAAe,OAAO;AAC7B,SAAO;AACT;","names":[]}

package/dist/index.mjs

@@ -1,6 +1,7 @@
 // src/index.ts
 import {
-  createNodeUI
+  createNodeUI,
+  enterRequestContext
 } from "@singhak/nodeui-core";
 export * from "@singhak/nodeui-core";
 function pathnameOf(url) {
@@ -41,7 +42,16 @@ function nodeui(options) {
         await server.handle(req.raw, reply.raw);
         return;
       }
+      const pattern = req.routeOptions?.url ?? req.routerPath;
+      if (pattern) req.raw.nodeuiRoute = pattern;
       recorder(req.raw, reply.raw, () => void 0);
+      enterRequestContext(req.raw);
+    });
+    app.addHook("onError", (req, _reply, error, hookDone) => {
+      server.recordError(error, {
+        route: req.routeOptions?.url
+      });
+      hookDone();
     });
     app.addHook("onClose", (_instance, next) => {
       server.shutdown();

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { FastifyInstance, FastifyPluginCallback, RouteOptions } from 'fastify';\r\nimport {\r\n  createNodeUI,\r\n  type NodeUIOptions,\r\n  type NodeUIServer,\r\n  type RouteEntry,\r\n} from '@singhak/nodeui-core';\r\n\r\nexport interface NodeUIFastifyPlugin extends FastifyPluginCallback {\r\n  /** Handle to the underlying server (mark, shutdown, config). */\r\n  server: NodeUIServer;\r\n  /** Pushes an external log entry into the log viewer (logger adapter). */\r\n  addLogSource: NodeUIServer['addLogSource'];\r\n}\r\n\r\nfunction pathnameOf(url: string | undefined): string {\r\n  try {\r\n    return new URL(url ?? '/', 'http://localhost').pathname;\r\n  } catch {\r\n    return url ?? '/';\r\n  }\r\n}\r\n\r\n/**\r\n * Creates the NodeUI Fastify plugin. Register it before your routes so the\r\n * routes panel and request log see them.\r\n *\r\n * @example\r\n * const ui = nodeui();\r\n * await app.register(ui);\r\n * await app.listen({ port: 3000, host: '127.0.0.1' });\r\n * ui.server.mark('listening');\r\n */\r\nexport function nodeui(options?: NodeUIOptions): NodeUIFastifyPlugin {\r\n  const server = createNodeUI(options);\r\n  const prefix = server.config.path;\r\n  const isUnderPrefix = (p: string): boolean => p === prefix || p.startsWith(`${prefix}/`);\r\n  const recorder = server.middleware();\r\n  const routes = new Map<string, RouteEntry>();\r\n\r\n  const plugin = ((app: FastifyInstance, _opts: unknown, done: (err?: Error) => void) => {\r\n    if (!server.active) {\r\n      done();\r\n      return;\r\n    }\r\n\r\n    server.setRoutes(() =>\r\n      [...routes.values()].sort(\r\n        (a, b) => a.path.localeCompare(b.path) || a.method.localeCompare(b.method),\r\n      ),\r\n    );\r\n\r\n    app.addHook('onRoute', (route: RouteOptions) => {\r\n      const methods = Array.isArray(route.method) ? route.method : [route.method];\r\n      const handler = (route.handler as { name?: string } | undefined)?.name || 'anonymous';\r\n      for (const m of methods) {\r\n        const method = String(m).toUpperCase();\r\n        if (isUnderPrefix(route.url)) continue;\r\n        routes.set(`${method} ${route.url}`, { method, path: route.url, handler });\r\n      }\r\n    });\r\n\r\n    app.addHook('onRequest', async (req, reply) => {\r\n      if (isUnderPrefix(pathnameOf(req.raw.url))) {\r\n        reply.hijack();\r\n        await server.handle(req.raw, reply.raw);\r\n        return;\r\n      }\r\n      // Core's middleware records the request (finish listener) then calls next.\r\n      recorder(req.raw, reply.raw, () => undefined);\r\n    });\r\n\r\n    app.addHook('onClose', (_instance, next) => {\r\n      server.shutdown();\r\n      next();\r\n    });\r\n    done();\r\n  }) as NodeUIFastifyPlugin;\r\n\r\n  // Same effect as fastify-plugin: expose hooks to the parent scope.\r\n  const marks = plugin as unknown as Record<symbol, unknown>;\r\n  marks[Symbol.for('skip-override')] = true;\r\n  marks[Symbol.for('fastify.display-name')] = 'nodeui-fastify';\r\n  plugin.server = server;\r\n  plugin.addLogSource = server.addLogSource;\r\n  return plugin;\r\n}\r\n\r\nexport * from '@singhak/nodeui-core';\r\n"],"mappings":";AACA;AAAA,EACE;AAAA,OAIK;AAkFP,cAAc;AAzEd,SAAS,WAAW,KAAiC;AACnD,MAAI;AACF,WAAO,IAAI,IAAI,OAAO,KAAK,kBAAkB,EAAE;AAAA,EACjD,QAAQ;AACN,WAAO,OAAO;AAAA,EAChB;AACF;AAYO,SAAS,OAAO,SAA8C;AACnE,QAAM,SAAS,aAAa,OAAO;AACnC,QAAM,SAAS,OAAO,OAAO;AAC7B,QAAM,gBAAgB,CAAC,MAAuB,MAAM,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG;AACvF,QAAM,WAAW,OAAO,WAAW;AACnC,QAAM,SAAS,oBAAI,IAAwB;AAE3C,QAAM,UAAU,CAAC,KAAsB,OAAgB,SAAgC;AACrF,QAAI,CAAC,OAAO,QAAQ;AAClB,WAAK;AACL;AAAA,IACF;AAEA,WAAO;AAAA,MAAU,MACf,CAAC,GAAG,OAAO,OAAO,CAAC,EAAE;AAAA,QACnB,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,KAAK,EAAE,OAAO,cAAc,EAAE,MAAM;AAAA,MAC3E;AAAA,IACF;AAEA,QAAI,QAAQ,WAAW,CAAC,UAAwB;AAC9C,YAAM,UAAU,MAAM,QAAQ,MAAM,MAAM,IAAI,MAAM,SAAS,CAAC,MAAM,MAAM;AAC1E,YAAM,UAAW,MAAM,SAA2C,QAAQ;AAC1E,iBAAW,KAAK,SAAS;AACvB,cAAM,SAAS,OAAO,CAAC,EAAE,YAAY;AACrC,YAAI,cAAc,MAAM,GAAG,EAAG;AAC9B,eAAO,IAAI,GAAG,MAAM,IAAI,MAAM,GAAG,IAAI,EAAE,QAAQ,MAAM,MAAM,KAAK,QAAQ,CAAC;AAAA,MAC3E;AAAA,IACF,CAAC;AAED,QAAI,QAAQ,aAAa,OAAO,KAAK,UAAU;AAC7C,UAAI,cAAc,WAAW,IAAI,IAAI,GAAG,CAAC,GAAG;AAC1C,cAAM,OAAO;AACb,cAAM,OAAO,OAAO,IAAI,KAAK,MAAM,GAAG;AACtC;AAAA,MACF;AAEA,eAAS,IAAI,KAAK,MAAM,KAAK,MAAM,MAAS;AAAA,IAC9C,CAAC;AAED,QAAI,QAAQ,WAAW,CAAC,WAAW,SAAS;AAC1C,aAAO,SAAS;AAChB,WAAK;AAAA,IACP,CAAC;AACD,SAAK;AAAA,EACP;AAGA,QAAM,QAAQ;AACd,QAAM,uBAAO,IAAI,eAAe,CAAC,IAAI;AACrC,QAAM,uBAAO,IAAI,sBAAsB,CAAC,IAAI;AAC5C,SAAO,SAAS;AAChB,SAAO,eAAe,OAAO;AAC7B,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type { FastifyInstance, FastifyPluginCallback, RouteOptions } from 'fastify';\r\nimport {\r\n  createNodeUI,\r\n  enterRequestContext,\r\n  type NodeUIOptions,\r\n  type NodeUIServer,\r\n  type RouteEntry,\r\n} from '@singhak/nodeui-core';\r\n\r\nexport interface NodeUIFastifyPlugin extends FastifyPluginCallback {\r\n  /** Handle to the underlying server (mark, shutdown, config). */\r\n  server: NodeUIServer;\r\n  /** Pushes an external log entry into the log viewer (logger adapter). */\r\n  addLogSource: NodeUIServer['addLogSource'];\r\n}\r\n\r\nfunction pathnameOf(url: string | undefined): string {\r\n  try {\r\n    return new URL(url ?? '/', 'http://localhost').pathname;\r\n  } catch {\r\n    return url ?? '/';\r\n  }\r\n}\r\n\r\n/**\r\n * Creates the NodeUI Fastify plugin. Register it before your routes so the\r\n * routes panel and request log see them.\r\n *\r\n * @example\r\n * const ui = nodeui();\r\n * await app.register(ui);\r\n * await app.listen({ port: 3000, host: '127.0.0.1' });\r\n * ui.server.mark('listening');\r\n */\r\nexport function nodeui(options?: NodeUIOptions): NodeUIFastifyPlugin {\r\n  const server = createNodeUI(options);\r\n  const prefix = server.config.path;\r\n  const isUnderPrefix = (p: string): boolean => p === prefix || p.startsWith(`${prefix}/`);\r\n  const recorder = server.middleware();\r\n  const routes = new Map<string, RouteEntry>();\r\n\r\n  const plugin = ((app: FastifyInstance, _opts: unknown, done: (err?: Error) => void) => {\r\n    if (!server.active) {\r\n      done();\r\n      return;\r\n    }\r\n\r\n    server.setRoutes(() =>\r\n      [...routes.values()].sort(\r\n        (a, b) => a.path.localeCompare(b.path) || a.method.localeCompare(b.method),\r\n      ),\r\n    );\r\n\r\n    app.addHook('onRoute', (route: RouteOptions) => {\r\n      const methods = Array.isArray(route.method) ? route.method : [route.method];\r\n      const handler = (route.handler as { name?: string } | undefined)?.name || 'anonymous';\r\n      for (const m of methods) {\r\n        const method = String(m).toUpperCase();\r\n        if (isUnderPrefix(route.url)) continue;\r\n        routes.set(`${method} ${route.url}`, { method, path: route.url, handler });\r\n      }\r\n    });\r\n\r\n    app.addHook('onRequest', async (req, reply) => {\r\n      if (isUnderPrefix(pathnameOf(req.raw.url))) {\r\n        reply.hijack();\r\n        await server.handle(req.raw, reply.raw);\r\n        return;\r\n      }\r\n      // Expose the matched route pattern to core's request recorder.\r\n      const pattern =\r\n        (req as { routeOptions?: { url?: string } }).routeOptions?.url ??\r\n        (req as { routerPath?: string }).routerPath;\r\n      if (pattern) (req.raw as { nodeuiRoute?: string }).nodeuiRoute = pattern;\r\n      // Core's middleware records the request (finish listener) then calls next.\r\n      recorder(req.raw, reply.raw, () => undefined);\r\n      // Attribute outgoing calls and logs from the route handler to this request.\r\n      enterRequestContext(req.raw);\r\n    });\r\n\r\n    app.addHook('onError', (req, _reply, error, hookDone) => {\r\n      server.recordError(error, {\r\n        route: (req as { routeOptions?: { url?: string } }).routeOptions?.url,\r\n      });\r\n      hookDone();\r\n    });\r\n\r\n    app.addHook('onClose', (_instance, next) => {\r\n      server.shutdown();\r\n      next();\r\n    });\r\n    done();\r\n  }) as NodeUIFastifyPlugin;\r\n\r\n  // Same effect as fastify-plugin: expose hooks to the parent scope.\r\n  const marks = plugin as unknown as Record<symbol, unknown>;\r\n  marks[Symbol.for('skip-override')] = true;\r\n  marks[Symbol.for('fastify.display-name')] = 'nodeui-fastify';\r\n  plugin.server = server;\r\n  plugin.addLogSource = server.addLogSource;\r\n  return plugin;\r\n}\r\n\r\nexport * from '@singhak/nodeui-core';\r\n"],"mappings":";AACA;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AAgGP,cAAc;AAvFd,SAAS,WAAW,KAAiC;AACnD,MAAI;AACF,WAAO,IAAI,IAAI,OAAO,KAAK,kBAAkB,EAAE;AAAA,EACjD,QAAQ;AACN,WAAO,OAAO;AAAA,EAChB;AACF;AAYO,SAAS,OAAO,SAA8C;AACnE,QAAM,SAAS,aAAa,OAAO;AACnC,QAAM,SAAS,OAAO,OAAO;AAC7B,QAAM,gBAAgB,CAAC,MAAuB,MAAM,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG;AACvF,QAAM,WAAW,OAAO,WAAW;AACnC,QAAM,SAAS,oBAAI,IAAwB;AAE3C,QAAM,UAAU,CAAC,KAAsB,OAAgB,SAAgC;AACrF,QAAI,CAAC,OAAO,QAAQ;AAClB,WAAK;AACL;AAAA,IACF;AAEA,WAAO;AAAA,MAAU,MACf,CAAC,GAAG,OAAO,OAAO,CAAC,EAAE;AAAA,QACnB,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,KAAK,EAAE,OAAO,cAAc,EAAE,MAAM;AAAA,MAC3E;AAAA,IACF;AAEA,QAAI,QAAQ,WAAW,CAAC,UAAwB;AAC9C,YAAM,UAAU,MAAM,QAAQ,MAAM,MAAM,IAAI,MAAM,SAAS,CAAC,MAAM,MAAM;AAC1E,YAAM,UAAW,MAAM,SAA2C,QAAQ;AAC1E,iBAAW,KAAK,SAAS;AACvB,cAAM,SAAS,OAAO,CAAC,EAAE,YAAY;AACrC,YAAI,cAAc,MAAM,GAAG,EAAG;AAC9B,eAAO,IAAI,GAAG,MAAM,IAAI,MAAM,GAAG,IAAI,EAAE,QAAQ,MAAM,MAAM,KAAK,QAAQ,CAAC;AAAA,MAC3E;AAAA,IACF,CAAC;AAED,QAAI,QAAQ,aAAa,OAAO,KAAK,UAAU;AAC7C,UAAI,cAAc,WAAW,IAAI,IAAI,GAAG,CAAC,GAAG;AAC1C,cAAM,OAAO;AACb,cAAM,OAAO,OAAO,IAAI,KAAK,MAAM,GAAG;AACtC;AAAA,MACF;AAEA,YAAM,UACH,IAA4C,cAAc,OAC1D,IAAgC;AACnC,UAAI,QAAS,CAAC,IAAI,IAAiC,cAAc;AAEjE,eAAS,IAAI,KAAK,MAAM,KAAK,MAAM,MAAS;AAE5C,0BAAoB,IAAI,GAAG;AAAA,IAC7B,CAAC;AAED,QAAI,QAAQ,WAAW,CAAC,KAAK,QAAQ,OAAO,aAAa;AACvD,aAAO,YAAY,OAAO;AAAA,QACxB,OAAQ,IAA4C,cAAc;AAAA,MACpE,CAAC;AACD,eAAS;AAAA,IACX,CAAC;AAED,QAAI,QAAQ,WAAW,CAAC,WAAW,SAAS;AAC1C,aAAO,SAAS;AAChB,WAAK;AAAA,IACP,CAAC;AACD,SAAK;AAAA,EACP;AAGA,QAAM,QAAQ;AACd,QAAM,uBAAO,IAAI,eAAe,CAAC,IAAI;AACrC,QAAM,uBAAO,IAAI,sBAAsB,CAAC,IAAI;AAC5C,SAAO,SAAS;AAChB,SAAO,eAAe,OAAO;AAC7B,SAAO;AACT;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@singhak/nodeui-fastify",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Fastify plugin adapter for the NodeUI developer console.",
   "license": "Apache-2.0",
   "main": "./dist/index.cjs",
@@ -47,7 +47,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@singhak/nodeui-core": "^0.3.0"
+    "@singhak/nodeui-core": "^0.5.0"
   },
   "peerDependencies": {
     "fastify": "^4.0.0 || ^5.0.0"