@forinda/kickjs-otel 1.3.2 → 1.4.0

package/dist/index.d.ts

@@ -1,66 +1,3 @@
-import { AppAdapter, Container, AdapterMiddleware } from '@forinda/kickjs-core';
-
-interface OtelAdapterOptions {
-    /** Service name reported to the OTel backend (default: 'kickjs-app') */
-    serviceName?: string;
-    /** Service version (default: '0.0.0') */
-    serviceVersion?: string;
-    /** Enable HTTP request tracing (default: true) */
-    tracing?: boolean;
-    /** Enable request metrics — counter, histogram (default: true) */
-    metrics?: boolean;
-    /**
-     * Custom span attributes added to every request span.
-     * Receives the Express request object.
-     */
-    customAttributes?: (req: any) => Record<string, string | number | boolean>;
-    /**
-     * Routes to ignore from tracing (e.g., health checks).
-     * Supports exact match or prefix match with trailing *.
-     * @example ['/health', '/_debug/*', '/favicon.ico']
-     */
-    ignoreRoutes?: string[];
-}
-
-/**
- * OpenTelemetry adapter for KickJS — automatic tracing and metrics.
- *
- * Creates spans for each HTTP request with route, method, status code,
- * and duration. Optionally records request count and latency histograms.
- *
- * Works with any OTel-compatible backend: Jaeger, Grafana Tempo, Datadog,
- * Honeycomb, etc. Configure exporters via the OTel SDK before bootstrapping.
- *
- * @example
- * ```ts
- * import { OtelAdapter } from '@forinda/kickjs-otel'
- *
- * // Set up OTel SDK (e.g., with Jaeger exporter) before bootstrap
- * bootstrap({
- *   modules,
- *   adapters: [
- *     new OtelAdapter({
- *       serviceName: 'my-api',
- *       serviceVersion: '1.0.0',
- *       ignoreRoutes: ['/health', '/_debug/*'],
- *     }),
- *   ],
- * })
- * ```
- */
-declare class OtelAdapter implements AppAdapter {
-    name: string;
-    private options;
-    private tracer;
-    private meter;
-    private requestCounter;
-    private requestDuration;
-    constructor(options?: OtelAdapterOptions);
-    beforeStart(_app: any, _container: Container): void;
-    middleware(): AdapterMiddleware[];
-    private onFinish;
-    private shouldIgnore;
-    shutdown(): Promise<void>;
-}
-
-export { OtelAdapter, type OtelAdapterOptions };
+export { OtelAdapter } from './otel.adapter';
+export type { OtelAdapterOptions } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -1 +1,84 @@
-var l=Object.defineProperty;var h=(s,t)=>l(s,"name",{value:t,configurable:!0}),p=(s=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(s,{get:(t,e)=>(typeof require<"u"?require:t)[e]}):s)(function(s){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+s+'" is not supported')});import{Logger as d}from"@forinda/kickjs-core";var u=d.for("OtelAdapter"),c=class{static{h(this,"OtelAdapter")}name="OtelAdapter";options;tracer=null;meter=null;requestCounter=null;requestDuration=null;constructor(t={}){this.options={serviceName:t.serviceName??"kickjs-app",serviceVersion:t.serviceVersion??"0.0.0",tracing:t.tracing??!0,metrics:t.metrics??!0,...t}}beforeStart(t,e){try{let r=p("@opentelemetry/api");this.options.tracing&&(this.tracer=r.trace.getTracer(this.options.serviceName,this.options.serviceVersion),u.info(`Tracing enabled for ${this.options.serviceName}`)),this.options.metrics&&(this.meter=r.metrics.getMeter(this.options.serviceName,this.options.serviceVersion),this.requestCounter=this.meter.createCounter("http.server.request.count",{description:"Total number of HTTP requests"}),this.requestDuration=this.meter.createHistogram("http.server.request.duration",{description:"HTTP request duration in milliseconds",unit:"ms"}),u.info("Metrics enabled \u2014 http.server.request.count, http.server.request.duration"))}catch{u.warn("OpenTelemetry API not found. Install @opentelemetry/api to enable tracing and metrics.")}}middleware(){return[{handler:h((t,e,r)=>{if(this.shouldIgnore(t.path))return r();let i=performance.now(),n=null;if(this.tracer){let o=p("@opentelemetry/api");n=this.tracer.startSpan(`${t.method} ${t.route?.path??t.path}`,{attributes:{"http.method":t.method,"http.url":t.originalUrl,"http.target":t.path,"http.user_agent":t.get("user-agent")??"","net.host.name":t.hostname,...this.options.customAttributes?.(t)??{}}});let a=o.trace.setSpan(o.context.active(),n);o.context.with(a,()=>{this.onFinish(t,e,i,n),r()});return}this.onFinish(t,e,i,null),r()},"handler"),phase:"beforeGlobal"}]}onFinish(t,e,r,i){e.on("finish",()=>{let n=performance.now()-r,o=t.route?.path??t.path,a={"http.method":t.method,"http.route":o,"http.status_code":e.statusCode};i&&(i.setAttributes({"http.status_code":e.statusCode,"http.route":o}),e.statusCode>=400&&i.setStatus({code:2,message:`HTTP ${e.statusCode}`}),i.end()),this.requestCounter&&this.requestCounter.add(1,a),this.requestDuration&&this.requestDuration.record(n,a)})}shouldIgnore(t){return this.options.ignoreRoutes?this.options.ignoreRoutes.some(e=>e.endsWith("*")?t.startsWith(e.slice(0,-1)):t===e):!1}async shutdown(){u.info("OTel adapter shutdown")}};export{c as OtelAdapter};
+import { Logger as h } from "@forinda/kickjs-core";
+var a = /* @__PURE__ */ ((t) => typeof require < "u" ? require : typeof Proxy < "u" ? new Proxy(t, { get: (e, r) => (typeof require < "u" ? require : e)[r] }) : t)(function(t) {
+  if (typeof require < "u") return require.apply(this, arguments);
+  throw Error('Calling `require` for "' + t + "\" in an environment that doesn't expose the `require` function. See https://rolldown.rs/in-depth/bundling-cjs#require-external-modules for more details.");
+}), u = h.for("OtelAdapter"), p = class {
+  name = "OtelAdapter";
+  options;
+  tracer = null;
+  meter = null;
+  requestCounter = null;
+  requestDuration = null;
+  constructor(t = {}) {
+    this.options = {
+      serviceName: t.serviceName ?? "kickjs-app",
+      serviceVersion: t.serviceVersion ?? "0.0.0",
+      tracing: t.tracing ?? !0,
+      metrics: t.metrics ?? !0,
+      ...t
+    };
+  }
+  beforeStart(t, e) {
+    try {
+      const r = a("@opentelemetry/api");
+      this.options.tracing && (this.tracer = r.trace.getTracer(this.options.serviceName, this.options.serviceVersion), u.info(`Tracing enabled for ${this.options.serviceName}`)), this.options.metrics && (this.meter = r.metrics.getMeter(this.options.serviceName, this.options.serviceVersion), this.requestCounter = this.meter.createCounter("http.server.request.count", { description: "Total number of HTTP requests" }), this.requestDuration = this.meter.createHistogram("http.server.request.duration", {
+        description: "HTTP request duration in milliseconds",
+        unit: "ms"
+      }), u.info("Metrics enabled — http.server.request.count, http.server.request.duration"));
+    } catch {
+      u.warn("OpenTelemetry API not found. Install @opentelemetry/api to enable tracing and metrics.");
+    }
+  }
+  middleware() {
+    return [{
+      handler: (t, e, r) => {
+        if (this.shouldIgnore(t.path)) return r();
+        const i = performance.now();
+        let o = null;
+        if (this.tracer) {
+          const s = a("@opentelemetry/api");
+          o = this.tracer.startSpan(`${t.method} ${t.route?.path ?? t.path}`, { attributes: {
+            "http.method": t.method,
+            "http.url": t.originalUrl,
+            "http.target": t.path,
+            "http.user_agent": t.get("user-agent") ?? "",
+            "net.host.name": t.hostname,
+            ...this.options.customAttributes?.(t) ?? {}
+          } });
+          const n = s.trace.setSpan(s.context.active(), o);
+          s.context.with(n, () => {
+            this.onFinish(t, e, i, o), r();
+          });
+          return;
+        }
+        this.onFinish(t, e, i, null), r();
+      },
+      phase: "beforeGlobal"
+    }];
+  }
+  onFinish(t, e, r, i) {
+    e.on("finish", () => {
+      const o = performance.now() - r, s = t.route?.path ?? t.path, n = {
+        "http.method": t.method,
+        "http.route": s,
+        "http.status_code": e.statusCode
+      };
+      i && (i.setAttributes({
+        "http.status_code": e.statusCode,
+        "http.route": s
+      }), e.statusCode >= 400 && i.setStatus({
+        code: 2,
+        message: `HTTP ${e.statusCode}`
+      }), i.end()), this.requestCounter && this.requestCounter.add(1, n), this.requestDuration && this.requestDuration.record(o, n);
+    });
+  }
+  shouldIgnore(t) {
+    return this.options.ignoreRoutes ? this.options.ignoreRoutes.some((e) => e.endsWith("*") ? t.startsWith(e.slice(0, -1)) : t === e) : !1;
+  }
+  async shutdown() {
+    u.info("OTel adapter shutdown");
+  }
+};
+export {
+  p as OtelAdapter
+};

package/dist/otel.adapter.d.ts

@@ -0,0 +1,43 @@
+import { type AppAdapter, type AdapterMiddleware, type Container } from '@forinda/kickjs-core';
+import type { OtelAdapterOptions } from './types';
+/**
+ * OpenTelemetry adapter for KickJS — automatic tracing and metrics.
+ *
+ * Creates spans for each HTTP request with route, method, status code,
+ * and duration. Optionally records request count and latency histograms.
+ *
+ * Works with any OTel-compatible backend: Jaeger, Grafana Tempo, Datadog,
+ * Honeycomb, etc. Configure exporters via the OTel SDK before bootstrapping.
+ *
+ * @example
+ * ```ts
+ * import { OtelAdapter } from '@forinda/kickjs-otel'
+ *
+ * // Set up OTel SDK (e.g., with Jaeger exporter) before bootstrap
+ * bootstrap({
+ *   modules,
+ *   adapters: [
+ *     new OtelAdapter({
+ *       serviceName: 'my-api',
+ *       serviceVersion: '1.0.0',
+ *       ignoreRoutes: ['/health', '/_debug/*'],
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+export declare class OtelAdapter implements AppAdapter {
+    name: string;
+    private options;
+    private tracer;
+    private meter;
+    private requestCounter;
+    private requestDuration;
+    constructor(options?: OtelAdapterOptions);
+    beforeStart(_app: any, _container: Container): void;
+    middleware(): AdapterMiddleware[];
+    private onFinish;
+    private shouldIgnore;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=otel.adapter.d.ts.map

package/dist/otel.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.adapter.d.ts","sourceRoot":"","sources":["../src/otel.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACf,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAIjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,WAAY,YAAW,UAAU;IAC5C,IAAI,SAAgB;IACpB,OAAO,CAAC,OAAO,CAGK;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,cAAc,CAAY;IAClC,OAAO,CAAC,eAAe,CAAY;gBAEvB,OAAO,GAAE,kBAAuB;IAU5C,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,GAAG,IAAI;IA+BnD,UAAU,IAAI,iBAAiB,EAAE;IA2CjC,OAAO,CAAC,QAAQ;IAgChB,OAAO,CAAC,YAAY;IAUd,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}

package/dist/types.d.ts

@@ -0,0 +1,22 @@
+export interface OtelAdapterOptions {
+    /** Service name reported to the OTel backend (default: 'kickjs-app') */
+    serviceName?: string;
+    /** Service version (default: '0.0.0') */
+    serviceVersion?: string;
+    /** Enable HTTP request tracing (default: true) */
+    tracing?: boolean;
+    /** Enable request metrics — counter, histogram (default: true) */
+    metrics?: boolean;
+    /**
+     * Custom span attributes added to every request span.
+     * Receives the Express request object.
+     */
+    customAttributes?: (req: any) => Record<string, string | number | boolean>;
+    /**
+     * Routes to ignore from tracing (e.g., health checks).
+     * Supports exact match or prefix match with trailing *.
+     * @example ['/health', '/_debug/*', '/favicon.ico']
+     */
+    ignoreRoutes?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;IAE1E;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forinda/kickjs-otel",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "description": "OpenTelemetry adapter for KickJS — automatic tracing, metrics, and export to any OTel backend",
   "keywords": [
     "kickjs",
@@ -36,7 +36,8 @@
     "@forinda/kickjs-queue",
     "@forinda/kickjs-multi-tenant",
     "@forinda/kickjs-devtools",
-    "@forinda/kickjs-notifications"
+    "@forinda/kickjs-notifications",
+    "vite"
   ],
   "type": "module",
   "main": "dist/index.js",
@@ -52,8 +53,8 @@
   ],
   "dependencies": {
     "reflect-metadata": "^0.2.2",
-    "@forinda/kickjs-core": "1.3.2",
-    "@forinda/kickjs-http": "1.3.2"
+    "@forinda/kickjs-core": "1.4.0",
+    "@forinda/kickjs-http": "1.4.0"
   },
   "peerDependencies": {
     "@opentelemetry/api": ">=1.4.0",
@@ -74,12 +75,11 @@
     }
   },
   "devDependencies": {
-    "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/sdk-trace-base": "^1.30.1",
-    "@opentelemetry/sdk-metrics": "^1.30.1",
-    "@opentelemetry/semantic-conventions": "^1.28.0",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/sdk-trace-base": "^2.6.1",
+    "@opentelemetry/sdk-metrics": "^2.6.1",
+    "@opentelemetry/semantic-conventions": "^1.4.0",
     "@types/node": "^24.5.2",
-    "tsup": "^8.5.0",
     "typescript": "^5.9.2"
   },
   "publishConfig": {
@@ -100,8 +100,9 @@
     "url": "https://github.com/forinda/kick-js/issues"
   },
   "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
+    "build": "vite build && pnpm build:types",
+    "build:types": "tsc -p tsconfig.build.json",
+    "dev": "vite build --watch",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist .turbo",
     "lint": "tsc --noEmit"