@forinda/kickjs-devtools 1.6.0 → 1.7.0

package/dist/adapter.d.ts

@@ -1,4 +1,4 @@
-import { type AppAdapter, type AdapterMiddleware, type Container, type Ref, type ComputedRef } from '@forinda/kickjs-core';
+import { type AppAdapter, type AdapterContext, type AdapterMiddleware, type Ref, type ComputedRef } from '@forinda/kickjs-core';
 /** Per-route latency stats */
 interface RouteStats {
     count: number;
@@ -97,10 +97,10 @@ export declare class DevToolsAdapter implements AppAdapter {
      * constructor-provided refs.
      */
     private getPeerAdapters;
-    beforeMount(app: any, container: Container): void;
+    beforeMount({ app, container }: AdapterContext): void;
     middleware(): AdapterMiddleware[];
     onRouteMount(controllerClass: any, mountPath: string): void;
-    afterStart(_server: any, _container: Container): void;
+    afterStart({}: AdapterContext): void;
     shutdown(): void;
     /** Find the public/devtools directory relative to the built dist or source */
     private resolvePublicDir;

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,SAAS,EAOd,KAAK,GAAG,EACR,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAA;AAa7B,8BAA8B;AAC9B,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,mFAAmF;IACnF,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,uFAAuF;IACvF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,iDAAiD;IACjD,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5C,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAA;IAEhB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,eAAgB,YAAW,UAAU;IAChD,QAAQ,CAAC,IAAI,qBAAoB;IAEjC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,kBAAkB,CAAQ;IAClC,OAAO,CAAC,MAAM,CAAgB;IAG9B,8BAA8B;IAC9B,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAClC,yCAAyC;IACzC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAChC,mDAAmD;IACnD,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACtC,wBAAwB;IACxB,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACvC,iCAAiC;IACjC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC3C,iCAAiC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAGjD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,YAAY,CAAY;gBAEpB,OAAO,GAAE,eAAoB;IAmDzC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAQvB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IA4JjD,UAAU,IAAI,iBAAiB,EAAE;IAuCjC,YAAY,CAAC,eAAe,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IA8B3D,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,GAAG,IAAI;IAQrD,QAAQ,IAAI,IAAI;IAKhB,8EAA8E;IAC9E,OAAO,CAAC,gBAAgB;CAYzB"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,iBAAiB,EAQtB,KAAK,GAAG,EACR,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAA;AAa7B,8BAA8B;AAC9B,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,mFAAmF;IACnF,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,uFAAuF;IACvF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,iDAAiD;IACjD,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5C,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAA;IAEhB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,eAAgB,YAAW,UAAU;IAChD,QAAQ,CAAC,IAAI,qBAAoB;IAEjC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAU;IAChC,OAAO,CAAC,kBAAkB,CAAQ;IAClC,OAAO,CAAC,MAAM,CAAgB;IAG9B,8BAA8B;IAC9B,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAClC,yCAAyC;IACzC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAChC,mDAAmD;IACnD,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACtC,wBAAwB;IACxB,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACvC,iCAAiC;IACjC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC3C,iCAAiC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAGjD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,YAAY,CAAY;gBAEpB,OAAO,GAAE,eAAoB;IAmDzC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAQvB,WAAW,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,cAAc,GAAG,IAAI;IA4JrD,UAAU,IAAI,iBAAiB,EAAE;IAuCjC,YAAY,CAAC,eAAe,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IA8B3D,UAAU,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI;IAQpC,QAAQ,IAAI,IAAI;IAKhB,8EAA8E;IAC9E,OAAO,CAAC,gBAAgB;CAYzB"}

package/dist/index.js

@@ -26,40 +26,40 @@ var h = S("DevTools"), j = class {
   adapterStatuses = {};
   stopErrorWatch = null;
   peerAdapters = [];
-  constructor(r = {}) {
-    if (this.basePath = r.basePath ?? "/_debug", this.enabled = r.enabled ?? process.env.NODE_ENV !== "production", this.exposeConfig = r.exposeConfig ?? !1, this.configPrefixes = r.configPrefixes ?? ["APP_", "NODE_ENV"], this.errorRateThreshold = r.errorRateThreshold ?? 0.5, this.peerAdapters = r.adapters ?? [], r.secret === !1 ? this.secret = !1 : r.secret ? this.secret = r.secret : this.secret = D(16).toString("hex"), this.requestCount = l(0), this.errorCount = l(0), this.clientErrorCount = l(0), this.startedAt = l(Date.now()), this.routeLatency = C({}), this.errorRate = p(() => this.requestCount.value > 0 ? this.errorCount.value / this.requestCount.value : 0), this.uptimeSeconds = p(() => Math.floor((Date.now() - this.startedAt.value) / 1e3)), r.onErrorRateExceeded) {
-      const n = r.onErrorRateExceeded, s = this.errorRateThreshold;
+  constructor(s = {}) {
+    if (this.basePath = s.basePath ?? "/_debug", this.enabled = s.enabled ?? process.env.NODE_ENV !== "production", this.exposeConfig = s.exposeConfig ?? !1, this.configPrefixes = s.configPrefixes ?? ["APP_", "NODE_ENV"], this.errorRateThreshold = s.errorRateThreshold ?? 0.5, this.peerAdapters = s.adapters ?? [], s.secret === !1 ? this.secret = !1 : s.secret ? this.secret = s.secret : this.secret = D(16).toString("hex"), this.requestCount = l(0), this.errorCount = l(0), this.clientErrorCount = l(0), this.startedAt = l(Date.now()), this.routeLatency = C({}), this.errorRate = p(() => this.requestCount.value > 0 ? this.errorCount.value / this.requestCount.value : 0), this.uptimeSeconds = p(() => Math.floor((Date.now() - this.startedAt.value) / 1e3)), s.onErrorRateExceeded) {
+      const n = s.onErrorRateExceeded, r = this.errorRateThreshold;
       this.stopErrorWatch = m(this.errorRate, (i) => {
-        i > s && n(i);
+        i > r && n(i);
       });
     } else this.stopErrorWatch = m(this.errorRate, (n) => {
       n > this.errorRateThreshold && h.warn(`Error rate elevated: ${(n * 100).toFixed(1)}%`);
     });
   }
   getPeerAdapters() {
-    const r = this.appRef?.__kickApp;
-    return r && typeof r.getAdapters == "function" ? r.getAdapters() : this.peerAdapters;
+    const s = this.appRef?.__kickApp;
+    return s && typeof s.getAdapters == "function" ? s.getAdapters() : this.peerAdapters;
   }
-  beforeMount(r, n) {
+  beforeMount({ app: s, container: n }) {
     if (!this.enabled) return;
-    this.appRef = r, this.container = n, this.startedAt.value = Date.now(), this.routes = [], this.adapterStatuses[this.name] = "running";
-    const s = v();
+    this.appRef = s, this.container = n, this.startedAt.value = Date.now(), this.routes = [], this.adapterStatuses[this.name] = "running";
+    const r = v();
     if (this.secret !== !1) {
       const o = this.secret;
-      s.use((e, t, a) => {
+      r.use((e, t, a) => {
         if ((e.headers["x-devtools-token"] ?? e.query?.token) === o || e.path === "/" && e.method === "GET" && !e.query?.token || e.path.endsWith(".js") || e.path.endsWith(".css")) return a();
         t.status(403).json({ error: "Forbidden — invalid or missing devtools token" });
       });
     }
-    s.get("/routes", (o, e) => {
+    r.get("/routes", (o, e) => {
       e.json({ routes: this.routes });
-    }), s.get("/container", (o, e) => {
+    }), r.get("/container", (o, e) => {
       const t = this.container?.getRegistrations() ?? [];
       e.json({
         registrations: t,
         count: t.length
       });
-    }), s.get("/metrics", (o, e) => {
+    }), r.get("/metrics", (o, e) => {
       e.json({
         requests: this.requestCount.value,
         serverErrors: this.errorCount.value,
@@ -69,7 +69,7 @@ var h = S("DevTools"), j = class {
         startedAt: new Date(this.startedAt.value).toISOString(),
         routeLatency: this.routeLatency
       });
-    }), s.get("/health", (o, e) => {
+    }), r.get("/health", (o, e) => {
       const t = this.errorRate.value < this.errorRateThreshold, a = t ? "healthy" : "degraded";
       e.status(t ? 200 : 503).json({
         status: a,
@@ -77,7 +77,7 @@ var h = S("DevTools"), j = class {
         uptime: this.uptimeSeconds.value,
         adapters: this.adapterStatuses
       });
-    }), s.get("/state", (o, e) => {
+    }), r.get("/state", (o, e) => {
       const t = this.getPeerAdapters().find((a) => a.name === "WsAdapter" && typeof a.getStats == "function");
       e.json({
         reactive: {
@@ -93,7 +93,7 @@ var h = S("DevTools"), j = class {
         routeLatency: this.routeLatency,
         ...t ? { ws: t.getStats() } : {}
       });
-    }), s.get("/ws", (o, e) => {
+    }), r.get("/ws", (o, e) => {
       const t = this.getPeerAdapters().find((a) => a.name === "WsAdapter" && typeof a.getStats == "function");
       if (!t) {
         e.json({
@@ -106,7 +106,7 @@ var h = S("DevTools"), j = class {
         enabled: !0,
         ...t.getStats()
       });
-    }), s.get("/queues", async (o, e) => {
+    }), r.get("/queues", async (o, e) => {
       const t = this.getPeerAdapters().find((a) => a.name === "QueueAdapter" && typeof a.getQueueNames == "function");
       if (!t) {
         e.json({
@@ -135,7 +135,7 @@ var h = S("DevTools"), j = class {
           error: "Failed to fetch queue stats"
         });
       }
-    }), this.exposeConfig && s.get("/config", (o, e) => {
+    }), this.exposeConfig && r.get("/config", (o, e) => {
       const t = {};
       for (const [a, u] of Object.entries(process.env))
         u !== void 0 && (t[a] = this.configPrefixes.some((d) => a.startsWith(d)) ? u : "[REDACTED]");
@@ -143,24 +143,24 @@ var h = S("DevTools"), j = class {
     });
     const i = this.resolvePublicDir();
     if (i) {
-      s.use(A(i));
+      r.use(A(i));
       const o = E(c(i, "index.html"), "utf-8");
-      s.get("/", (e, t) => {
+      r.get("/", (e, t) => {
         const a = o.replace("<body", `<body data-base="${this.basePath}"`);
         t.type("html").send(a);
       });
-    } else s.get("/", (o, e) => {
+    } else r.get("/", (o, e) => {
       e.type("html").send("<h1>DevTools: public directory not found</h1>");
     });
-    r.use(this.basePath, s), this.secret ? (h.info(`DevTools mounted at ${this.basePath} [token: ${this.secret}]`), h.info(`Access: ${this.basePath}?token=${this.secret}`)) : h.info(`DevTools mounted at ${this.basePath} [no guard]`);
+    s.use(this.basePath, r), this.secret ? (h.info(`DevTools mounted at ${this.basePath} [token: ${this.secret}]`), h.info(`Access: ${this.basePath}?token=${this.secret}`)) : h.info(`DevTools mounted at ${this.basePath} [no guard]`);
   }
   middleware() {
     return this.enabled ? [{
-      handler: (r, n, s) => {
+      handler: (s, n, r) => {
         const i = Date.now();
         this.requestCount.value++, n.on("finish", () => {
           n.statusCode >= 500 ? this.errorCount.value++ : n.statusCode >= 400 && this.clientErrorCount.value++;
-          const o = `${r.method} ${r.route?.path ?? r.path}`, e = Date.now() - i;
+          const o = `${s.method} ${s.route?.path ?? s.path}`, e = Date.now() - i;
           this.routeLatency[o] || (this.routeLatency[o] = {
             count: 0,
             totalMs: 0,
@@ -169,34 +169,34 @@ var h = S("DevTools"), j = class {
           });
           const t = this.routeLatency[o];
           t.count++, t.totalMs += e, t.minMs = Math.min(t.minMs, e), t.maxMs = Math.max(t.maxMs, e);
-        }), s();
+        }), r();
       },
       phase: "beforeGlobal"
     }] : [];
   }
-  onRouteMount(r, n) {
+  onRouteMount(s, n) {
     if (!this.enabled) return;
-    const s = Reflect.getMetadata(f.ROUTES, r) ?? [], i = Reflect.getMetadata(f.CLASS_MIDDLEWARES, r) ?? [];
-    for (const o of s) {
-      const e = Reflect.getMetadata(f.METHOD_MIDDLEWARES, r.prototype, o.handlerName) ?? [];
+    const r = Reflect.getMetadata(f.ROUTES, s) ?? [], i = Reflect.getMetadata(f.CLASS_MIDDLEWARES, s) ?? [];
+    for (const o of r) {
+      const e = Reflect.getMetadata(f.METHOD_MIDDLEWARES, s.prototype, o.handlerName) ?? [];
       this.routes.push({
         method: o.method.toUpperCase(),
         path: `${n}${o.path === "/" ? "" : o.path}`,
-        controller: r.name,
+        controller: s.name,
         handler: o.handlerName,
         middleware: [...i.map((t) => t.name || "anonymous"), ...e.map((t) => t.name || "anonymous")]
       });
     }
   }
-  afterStart(r, n) {
+  afterStart({}) {
     this.enabled && h.info(`DevTools ready — ${this.routes.length} routes tracked, ${this.container?.getRegistrations().length ?? 0} DI bindings`);
   }
   shutdown() {
     this.stopErrorWatch?.(), this.adapterStatuses[this.name] = "stopped";
   }
   resolvePublicDir() {
-    const r = b(R(import.meta.url)), n = [c(r, "..", "public", "devtools"), c(r, "..", "..", "public", "devtools")];
-    for (const s of n) if (y(c(s, "index.html"))) return s;
+    const s = b(R(import.meta.url)), n = [c(s, "..", "public", "devtools"), c(s, "..", "..", "public", "devtools")];
+    for (const r of n) if (y(c(r, "index.html"))) return r;
     return null;
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forinda/kickjs-devtools",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Development introspection dashboard for KickJS — routes, DI container, metrics, health",
   "keywords": [
     "kickjs",
@@ -53,7 +53,7 @@
   ],
   "dependencies": {
     "reflect-metadata": "^0.2.2",
-    "@forinda/kickjs-core": "1.6.0"
+    "@forinda/kickjs-core": "1.7.0"
   },
   "peerDependencies": {
     "express": "^5.1.0"