@owlpane/node 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Owlpane
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+# @owlpane/node
+
+One-line OpenTelemetry setup for Node.js that sends traces and metrics to Owlpane, plus job tracing and
+per-user tagging. Optional NestJS helpers live at `@owlpane/node/nest`.
+
+```ts
+// Run before anything else is imported (for example the first line of main.ts).
+import { owlpane } from "@owlpane/node";
+
+owlpane.start({
+  service: "checkout-api",
+  endpoint: "https://ingest.example.com", // your Owlpane ingest gateway
+  ingestKey: process.env.OWLPANE_INGEST_KEY, // owl_ing_..., one per project
+  release: process.env.GIT_SHA, // shows on the Releases page
+});
+```
+
+Everything can also come from environment variables: `OTEL_EXPORTER_OTLP_ENDPOINT`, `OWLPANE_INGEST_KEY`,
+`OTEL_SERVICE_NAME`, `OWLPANE_RELEASE`, `OWLPANE_ENVIRONMENT`. Set `OTEL_SDK_DISABLED=true` to switch it off.
+
+- **Never blocks your app.** Export is batched and fails quietly; the SDK does nothing when no endpoint is set.
+- **Your key is a write-only credential.** It can send data for one project and cannot read anything.
+- **Privacy.** Query strings, cookies and authorization headers are removed at the gateway as well as here.
+
+Track a background job: `await owlpane.job("nightly-report", "cron", async () => { ... })`.
+Tag the signed-in user (opaque id only): `owlpane.setUser(user.id)`. Email and name are **not** recorded unless you opt in with `traceUserProfile: true` or `OWLPANE_TRACE_USER_PROFILE=1` (discouraged for production).
+
+**LLM usage in Owlpane:** when your app calls the official [`openai`](https://www.npmjs.com/package/openai) client (including Groq via `baseURL: "https://api.groq.com/openai/v1"`), `@opentelemetry/instrumentation-openai` is registered automatically and emits `gen_ai.*` span attributes for the LLM usage page. Disable with `disableInstrumentations: ["@opentelemetry/instrumentation-openai"]`. Raw `fetch` to an LLM API is not instrumented.
+
+Full documentation: the `docs/05-onboarding-applications.md` guide in the Owlpane repository.

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @owlpane/node — one-line OpenTelemetry setup for any Node.js service.
+ *
+ * import { owlpane } from "@owlpane/node";
+ * owlpane.start({ service: "my-api" });   // call before any other app code is imported
+ *
+ * Activation: set OWLPANE_INGEST_URL (or the standard OTEL_EXPORTER_OTLP_ENDPOINT) to turn on.
+ * Without it, start() is a no-op — zero overhead when there is nowhere to send data.
+ *
+ * What you get: HTTP/Express/pg/ioredis/… auto-instrumentation, a `job()` wrapper for background
+ * work (cron, queue, one-off), `setUser()` to tag the current trace with a signed-in user, and
+ * process CPU/memory metrics. Framework-specific helpers (NestJS job discovery, a request
+ * interceptor) are at "@owlpane/node/nest" so this entry point has no framework dependency.
+ */
+import { api } from "@opentelemetry/sdk-node";
+export type InitOptions = {
+    /** Shows up as `service.name`. Falls back to OTEL_SERVICE_NAME, then "node-app". */
+    service?: string;
+    /** OTLP/HTTP endpoint (an Owlpane ingest gateway, or any OTel collector). Falls back to OTEL_EXPORTER_OTLP_ENDPOINT. */
+    endpoint?: string;
+    /** Sent as `Authorization: Bearer <key>` to the ingest gateway. */
+    ingestKey?: string;
+    /** `deployment.environment.name`. Falls back to OTEL_RESOURCE_ATTRIBUTES / NODE_ENV. */
+    environment?: string;
+    /** `service.version` — the release/deploy identifier shown on the Releases page. */
+    release?: string;
+    /** Trace sample ratio 0–1. */
+    sampleRatio?: number;
+    /** Extra resource attributes merged in alongside service/version/environment. */
+    resourceAttributes?: Record<string, string>;
+    /** Auto-instrumentation names to turn off, e.g. ["@opentelemetry/instrumentation-fs"]. */
+    disableInstrumentations?: string[];
+    /** When true, setUser may record enduser.email / enduser.name (off by default). */
+    traceUserProfile?: boolean;
+};
+/** Whether setUser may attach email/name (requires start({ traceUserProfile: true }) or OWLPANE_TRACE_USER_PROFILE=1). */
+export declare function traceUserProfileEnabled(): boolean;
+/** True once `start()` has turned tracing on (an endpoint was configured and it isn't disabled). */
+export declare function isEnabled(): boolean;
+/**
+ * Starts the telemetry pipeline. Call once, as the very first thing the process does — before any
+ * other import — so every module picks up the instrumented http/pg/etc. Safe to call when
+ * unconfigured: it just does nothing.
+ */
+export declare function start(options?: InitOptions): void;
+/** Flushes and stops the pipeline. Call on shutdown so the last batch of spans isn't dropped. */
+export declare function shutdown(): Promise<void>;
+export type JobKind = "cron" | "interval" | "timeout" | "queue" | "task";
+/**
+ * Runs `fn` as a traced, measured unit of background work: a root span named `name` (so the
+ * work's own database/HTTP calls nest under it instead of being dropped as parentless), plus a
+ * `job.duration` histogram recording (job.name, job.kind, job.outcome) that stays exact even when
+ * traces are sampled. Errors are recorded on the span and re-thrown unchanged.
+ */
+export declare function job<T>(name: string, kind: JobKind, attributes: api.Attributes, fn: () => Promise<T>): Promise<T>;
+/**
+ * Tags the current trace with the signed-in user (`enduser.id`), so per-user activity and errors
+ * show up in the console. Call from request middleware/an interceptor once the user is known.
+ * Only the opaque id is recorded — never email or name.
+ */
+export declare function setUser(id: string, profile?: {
+    email?: string;
+    name?: string;
+}): void;
+export declare const owlpane: {
+    start: typeof start;
+    shutdown: typeof shutdown;
+    job: typeof job;
+    setUser: typeof setUser;
+    isEnabled: typeof isEnabled;
+};

package/dist/index.js

@@ -0,0 +1,248 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.owlpane = void 0;
+exports.traceUserProfileEnabled = traceUserProfileEnabled;
+exports.isEnabled = isEnabled;
+exports.start = start;
+exports.shutdown = shutdown;
+exports.job = job;
+exports.setUser = setUser;
+/**
+ * @owlpane/node — one-line OpenTelemetry setup for any Node.js service.
+ *
+ * import { owlpane } from "@owlpane/node";
+ * owlpane.start({ service: "my-api" });   // call before any other app code is imported
+ *
+ * Activation: set OWLPANE_INGEST_URL (or the standard OTEL_EXPORTER_OTLP_ENDPOINT) to turn on.
+ * Without it, start() is a no-op — zero overhead when there is nowhere to send data.
+ *
+ * What you get: HTTP/Express/pg/ioredis/… auto-instrumentation, a `job()` wrapper for background
+ * work (cron, queue, one-off), `setUser()` to tag the current trace with a signed-in user, and
+ * process CPU/memory metrics. Framework-specific helpers (NestJS job discovery, a request
+ * interceptor) are at "@owlpane/node/nest" so this entry point has no framework dependency.
+ */
+const sdk_node_1 = require("@opentelemetry/sdk-node");
+const exporter_metrics_otlp_http_1 = require("@opentelemetry/exporter-metrics-otlp-http");
+const exporter_logs_otlp_http_1 = require("@opentelemetry/exporter-logs-otlp-http");
+const auto_instrumentations_node_1 = require("@opentelemetry/auto-instrumentations-node");
+const instrumentation_openai_1 = require("@opentelemetry/instrumentation-openai");
+const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-http");
+const api_logs_1 = require("@opentelemetry/api-logs");
+const sdk_logs_1 = require("@opentelemetry/sdk-logs");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+const { BatchSpanProcessor, ParentBasedSampler, TraceIdRatioBasedSampler } = sdk_node_1.tracing;
+const { resourceFromAttributes } = sdk_node_1.resources;
+let sdk;
+let logProvider;
+let traceUserProfile = false;
+/** Whether setUser may attach email/name (requires start({ traceUserProfile: true }) or OWLPANE_TRACE_USER_PROFILE=1). */
+function traceUserProfileEnabled() {
+    return traceUserProfile;
+}
+function endpointOf(o) {
+    return (o.endpoint?.trim() || process.env.OTEL_EXPORTER_OTLP_ENDPOINT?.trim() || undefined);
+}
+/** True once `start()` has turned tracing on (an endpoint was configured and it isn't disabled). */
+function isEnabled() {
+    return sdk !== undefined;
+}
+function sampleRatio(o) {
+    if (o.sampleRatio !== undefined)
+        return o.sampleRatio;
+    const raw = process.env.OTEL_TRACES_SAMPLER_ARG;
+    if (!raw)
+        return process.env.NODE_ENV === "production" ? 0.1 : 1;
+    const n = Number.parseFloat(raw);
+    return Number.isFinite(n) && n >= 0 && n <= 1 ? n : 0.1;
+}
+/**
+ * Starts the telemetry pipeline. Call once, as the very first thing the process does — before any
+ * other import — so every module picks up the instrumented http/pg/etc. Safe to call when
+ * unconfigured: it just does nothing.
+ */
+function start(options = {}) {
+    if (process.env.OTEL_SDK_DISABLED === "true")
+        return;
+    traceUserProfile =
+        options.traceUserProfile === true ||
+            ["1", "true", "yes"].includes((process.env.OWLPANE_TRACE_USER_PROFILE ?? "").trim().toLowerCase());
+    const endpoint = endpointOf(options);
+    if (!endpoint)
+        return;
+    if (sdk)
+        return; // already started
+    const serviceName = options.service?.trim() ||
+        process.env.OTEL_SERVICE_NAME?.trim() ||
+        "node-app";
+    const version = options.release?.trim() ||
+        process.env.OWLPANE_RELEASE?.trim() ||
+        "0.0.0";
+    const environment = options.environment?.trim() ||
+        process.env.OWLPANE_ENVIRONMENT?.trim() ||
+        process.env.NODE_ENV?.trim() ||
+        "development";
+    const ingestKey = options.ingestKey?.trim() || process.env.OWLPANE_INGEST_KEY?.trim();
+    const headers = ingestKey ? { Authorization: `Bearer ${ingestKey}` } : undefined;
+    const baseUrl = endpoint.replace(/\/+$/, "");
+    const exportProcessor = new BatchSpanProcessor(new exporter_trace_otlp_http_1.OTLPTraceExporter({ url: `${baseUrl}/v1/traces`, headers }));
+    const ratio = sampleRatio(options);
+    const disabled = new Set(options.disableInstrumentations ?? []);
+    const off = (name) => ({ enabled: !disabled.has(name) });
+    const resource = resourceFromAttributes({
+        [semantic_conventions_1.ATTR_SERVICE_NAME]: serviceName,
+        [semantic_conventions_1.ATTR_SERVICE_VERSION]: version,
+        "deployment.environment.name": environment,
+        ...options.resourceAttributes,
+    });
+    logProvider = new sdk_logs_1.LoggerProvider({
+        resource,
+        processors: [
+            new sdk_logs_1.BatchLogRecordProcessor({
+                exporter: new exporter_logs_otlp_http_1.OTLPLogExporter({ url: `${baseUrl}/v1/logs`, headers }),
+            }),
+        ],
+    });
+    api_logs_1.logs.setGlobalLoggerProvider(logProvider);
+    sdk = new sdk_node_1.NodeSDK({
+        resource,
+        spanProcessors: [exportProcessor],
+        // Metrics go to the same gateway with the same key; left to environment defaults they would be
+        // sent without the credential and refused.
+        metricReaders: [
+            new sdk_node_1.metrics.PeriodicExportingMetricReader({
+                exporter: new exporter_metrics_otlp_http_1.OTLPMetricExporter({ url: `${baseUrl}/v1/metrics`, headers }),
+                exportIntervalMillis: Math.max(5_000, Number(process.env.OWLPANE_METRICS_EXPORT_INTERVAL_MS?.trim()) || 30_000),
+            }),
+        ],
+        sampler: new ParentBasedSampler({
+            root: new TraceIdRatioBasedSampler(ratio),
+        }),
+        instrumentations: [
+            (0, auto_instrumentations_node_1.getNodeAutoInstrumentations)({
+                "@opentelemetry/instrumentation-fs": off("@opentelemetry/instrumentation-fs"),
+                "@opentelemetry/instrumentation-dns": off("@opentelemetry/instrumentation-dns"),
+                // A tcp.connect span per socket and a span per router layer are low-value noise.
+                "@opentelemetry/instrumentation-net": off("@opentelemetry/instrumentation-net"),
+                "@opentelemetry/instrumentation-router": off("@opentelemetry/instrumentation-router"),
+                // Each sync Express layer registers res.once("finish"). Nest + pino-http + HTTP instr. exceed
+                // Node's default MaxListeners (10). Use HTTP + Nest instrumentations for request spans instead.
+                "@opentelemetry/instrumentation-express": off("@opentelemetry/instrumentation-express"),
+                // Only trace queries inside a request or job span, so idle background loops don't emit
+                // hundreds of parentless query spans per minute; wrap loop iterations with job() instead.
+                "@opentelemetry/instrumentation-pg": { requireParentSpan: true, ...off("@opentelemetry/instrumentation-pg") },
+                // nestjs-pino → OTLP logs (Owlpane Logs page) with trace correlation when a span is active.
+                "@opentelemetry/instrumentation-pino": off("@opentelemetry/instrumentation-pino"),
+            }),
+            ...(disabled.has("@opentelemetry/instrumentation-openai")
+                ? []
+                : [new instrumentation_openai_1.OpenAIInstrumentation()]),
+        ],
+    });
+    sdk.start();
+    registerProcessMetrics(serviceName);
+}
+/** Flushes and stops the pipeline. Call on shutdown so the last batch of spans isn't dropped. */
+function shutdown() {
+    return Promise.all([sdk?.shutdown(), logProvider?.shutdown()]).then(() => undefined);
+}
+let jobHistogram;
+function histogram() {
+    jobHistogram ??= sdk_node_1.api.metrics
+        .getMeter("owlpane-jobs")
+        .createHistogram("job.duration", {
+        unit: "s",
+        description: "Background job run time, by job and outcome",
+        advice: {
+            explicitBucketBoundaries: [0.01, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10, 30, 60, 300],
+        },
+    });
+    return jobHistogram;
+}
+/**
+ * Runs `fn` as a traced, measured unit of background work: a root span named `name` (so the
+ * work's own database/HTTP calls nest under it instead of being dropped as parentless), plus a
+ * `job.duration` histogram recording (job.name, job.kind, job.outcome) that stays exact even when
+ * traces are sampled. Errors are recorded on the span and re-thrown unchanged.
+ */
+async function job(name, kind, attributes, fn) {
+    const started = performance.now();
+    const tracer = sdk_node_1.api.trace.getTracer("owlpane-jobs");
+    return tracer.startActiveSpan(name, {
+        root: true,
+        kind: kind === "queue" ? sdk_node_1.api.SpanKind.CONSUMER : sdk_node_1.api.SpanKind.INTERNAL,
+        attributes: { "job.name": name, "job.kind": kind, ...attributes },
+    }, async (span) => {
+        let outcome = "success";
+        try {
+            return await fn();
+        }
+        catch (err) {
+            outcome = "failure";
+            const e = err instanceof Error ? err : new Error(String(err));
+            span.recordException(e);
+            span.setStatus({ code: sdk_node_1.api.SpanStatusCode.ERROR, message: e.message });
+            throw err;
+        }
+        finally {
+            span.setAttribute("job.outcome", outcome);
+            span.end();
+            histogram().record((performance.now() - started) / 1000, {
+                "job.name": name,
+                "job.kind": kind,
+                "job.outcome": outcome,
+            });
+        }
+    });
+}
+// ---------- Users ----------
+/**
+ * Tags the current trace with the signed-in user (`enduser.id`), so per-user activity and errors
+ * show up in the console. Call from request middleware/an interceptor once the user is known.
+ * Only the opaque id is recorded — never email or name.
+ */
+function setUser(id, profile) {
+    if (!id)
+        return;
+    const span = sdk_node_1.api.trace.getActiveSpan();
+    if (!span)
+        return;
+    span.setAttribute("enduser.id", id);
+    if (!traceUserProfile)
+        return;
+    const email = profile?.email?.trim();
+    const name = profile?.name?.trim();
+    if (email)
+        span.setAttribute("enduser.email", email);
+    if (name)
+        span.setAttribute("enduser.name", name);
+}
+// ---------- Process metrics ----------
+/** CPU and resident memory, under semantic-convention names any OTel backend understands. */
+function registerProcessMetrics(meterName) {
+    const meter = sdk_node_1.api.metrics.getMeter(`owlpane-process-${meterName}`);
+    let lastCpu = process.cpuUsage();
+    let lastAt = process.hrtime.bigint();
+    meter
+        .createObservableGauge("process.cpu.utilization", {
+        unit: "1",
+        description: "Share of one CPU core used by this process since the previous reading",
+    })
+        .addCallback((result) => {
+        const now = process.hrtime.bigint();
+        const cpu = process.cpuUsage();
+        const elapsedUs = Number(now - lastAt) / 1000;
+        const usedUs = cpu.user - lastCpu.user + (cpu.system - lastCpu.system);
+        if (elapsedUs > 0)
+            result.observe(usedUs / elapsedUs);
+        lastCpu = cpu;
+        lastAt = now;
+    });
+    meter
+        .createObservableGauge("process.memory.usage", {
+        unit: "By",
+        description: "Resident set size",
+    })
+        .addCallback((result) => result.observe(process.memoryUsage().rss));
+}
+exports.owlpane = { start, shutdown, job, setUser, isEnabled };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/nest.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @owlpane/node/nest — optional NestJS helpers, kept out of the main entry point so a plain Node
+ * or Express service pulls in no NestJS code.
+ *
+ * import { installNestJobTracing, OwlpaneUserInterceptor } from "@owlpane/node/nest";
+ * installNestJobTracing();   // after owlpane.start(), before app.listen()
+ */
+import type { CallHandler, ExecutionContext, NestInterceptor } from "@nestjs/common";
+import type { Observable } from "rxjs";
+import "reflect-metadata";
+/**
+ * Traces every `@Cron`/`@Interval`/`@Timeout` handler (`@nestjs/schedule`) and every BullMQ
+ * processor (`@nestjs/bullmq`) as its own root span, named after the class and method or the
+ * queue and job name. Each run also feeds the `job.duration` histogram.
+ *
+ * Works by patching two library extension points instead of touching job code, so a version bump
+ * that renames either seam only disables tracing for that one (logged), never breaks the app.
+ */
+export declare function installNestJobTracing(): void;
+/**
+ * Register globally (`APP_INTERCEPTOR`) to tag each request's trace with the signed-in user
+ * (`req.user.id`) once auth guards have run, for per-user activity and error views in the console.
+ */
+export declare class OwlpaneUserInterceptor implements NestInterceptor {
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}

package/dist/nest.js

@@ -0,0 +1,129 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OwlpaneUserInterceptor = void 0;
+exports.installNestJobTracing = installNestJobTracing;
+const common_1 = require("@nestjs/common");
+const node_module_1 = require("node:module");
+const node_path_1 = require("node:path");
+require("reflect-metadata");
+const index_1 = require("./index");
+const logger = new common_1.Logger("OwlpaneNest");
+/** Load a peer from the host app (BFF), not from @owlpane/node's copy — otherwise monkey-patches miss. */
+function requireFromHost(specifier) {
+    const roots = new Set();
+    const entry = process.argv[1];
+    if (entry)
+        roots.add((0, node_path_1.join)((0, node_path_1.dirname)(entry), ".."));
+    roots.add(process.cwd());
+    for (const root of roots) {
+        try {
+            return (0, node_module_1.createRequire)((0, node_path_1.join)(root, "package.json"))(specifier);
+        }
+        catch {
+            // try next root
+        }
+    }
+    return require(specifier);
+}
+const SCHEDULER_KIND = {
+    1: "cron",
+    2: "timeout",
+    3: "interval",
+};
+let installed = false;
+/**
+ * Traces every `@Cron`/`@Interval`/`@Timeout` handler (`@nestjs/schedule`) and every BullMQ
+ * processor (`@nestjs/bullmq`) as its own root span, named after the class and method or the
+ * queue and job name. Each run also feeds the `job.duration` histogram.
+ *
+ * Works by patching two library extension points instead of touching job code, so a version bump
+ * that renames either seam only disables tracing for that one (logged), never breaks the app.
+ */
+function installNestJobTracing() {
+    if (installed)
+        return;
+    installed = true;
+    installScheduleTracing();
+    installBullmqTracing();
+}
+function installScheduleTracing() {
+    try {
+        /* eslint-disable @typescript-eslint/no-require-imports -- optional peer dep, loaded lazily */
+        const { ScheduleExplorer } = requireFromHost("@nestjs/schedule/dist/schedule.explorer");
+        const { SCHEDULER_TYPE } = requireFromHost("@nestjs/schedule/dist/schedule.constants");
+        /* eslint-enable @typescript-eslint/no-require-imports */
+        const original = ScheduleExplorer?.prototype?.wrapFunctionInTryCatchBlocks;
+        if (typeof original !== "function")
+            throw new Error("wrapFunctionInTryCatchBlocks not found");
+        ScheduleExplorer.prototype.wrapFunctionInTryCatchBlocks = function (methodRef, instance) {
+            const className = instance?.constructor?.name ?? "Job";
+            const method = methodRef?.name || "run";
+            const kind = SCHEDULER_KIND[Reflect.getMetadata(SCHEDULER_TYPE, methodRef)] ?? "cron";
+            const name = `${className}.${method}`;
+            const traced = function (...args) {
+                return (0, index_1.job)(name, kind, { "code.namespace": className, "code.function": method }, async () => methodRef.apply(this, args));
+            };
+            return original.call(this, traced, instance);
+        };
+    }
+    catch (err) {
+        logger.warn(`Scheduled jobs will not be traced: ${String(err)}`);
+    }
+}
+function installBullmqTracing() {
+    try {
+        /* eslint-disable @typescript-eslint/no-require-imports -- optional peer dep, loaded lazily */
+        const { ProcessorDecoratorService } = requireFromHost("@nestjs/bullmq/dist/instrument/processor-decorator.service");
+        /* eslint-enable @typescript-eslint/no-require-imports */
+        const original = ProcessorDecoratorService?.prototype?.decorate;
+        if (typeof original !== "function")
+            throw new Error("ProcessorDecoratorService.decorate not found");
+        ProcessorDecoratorService.prototype.decorate = function (processor) {
+            const decorated = original.call(this, processor);
+            return (bullJob, ...rest) => {
+                const queue = bullJob?.queueName ?? "queue";
+                const name = `${queue}.${bullJob?.name ?? "job"}`;
+                return (0, index_1.job)(name, "queue", {
+                    "messaging.system": "bullmq",
+                    "messaging.destination.name": queue,
+                    "messaging.message.id": String(bullJob?.id ?? ""),
+                    "job.attempt": (bullJob?.attemptsMade ?? 0) + 1,
+                }, () => decorated(bullJob, ...rest));
+            };
+        };
+    }
+    catch (err) {
+        logger.warn(`Queue jobs will not be traced: ${String(err)}`);
+    }
+}
+/**
+ * Register globally (`APP_INTERCEPTOR`) to tag each request's trace with the signed-in user
+ * (`req.user.id`) once auth guards have run, for per-user activity and error views in the console.
+ */
+let OwlpaneUserInterceptor = class OwlpaneUserInterceptor {
+    intercept(context, next) {
+        if (context.getType() === "http") {
+            const req = context.switchToHttp().getRequest();
+            if (typeof req.user?.id === "string") {
+                (0, index_1.setUser)(req.user.id, (0, index_1.traceUserProfileEnabled)()
+                    ? {
+                        email: typeof req.user.email === "string" ? req.user.email : undefined,
+                        name: typeof req.user.name === "string" ? req.user.name : undefined,
+                    }
+                    : undefined);
+            }
+        }
+        return next.handle();
+    }
+};
+exports.OwlpaneUserInterceptor = OwlpaneUserInterceptor;
+exports.OwlpaneUserInterceptor = OwlpaneUserInterceptor = __decorate([
+    (0, common_1.Injectable)()
+], OwlpaneUserInterceptor);
+//# sourceMappingURL=nest.js.map

package/dist/nest.js.map

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

package/nest.d.ts

@@ -0,0 +1 @@
+export * from "./dist/nest";

package/nest.js

@@ -0,0 +1,4 @@
+// Compatibility shim for TS "node10"/classic module resolution, which does not read package.json
+// "exports" subpaths. Modern resolvers (node16/nodenext/bundler) use the "exports" map instead and
+// never load this file. Keep in sync with the "exports" map in package.json.
+module.exports = require("./dist/nest");

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@owlpane/node",
+  "version": "0.1.1",
+  "description": "Owlpane telemetry SDK for Node.js: one-line OpenTelemetry setup, job tracing, and user tagging. Optional NestJS helpers at @owlpane/node/nest.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/balaji-singh/owlpane-sdk.git",
+    "directory": "packages/node"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./nest": {
+      "types": "./dist/nest.d.ts",
+      "default": "./dist/nest.js"
+    }
+  },
+  "files": [
+    "dist",
+    "nest.js",
+    "nest.d.ts",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test --import tsx test/export.test.ts"
+  },
+  "dependencies": {
+    "@opentelemetry/auto-instrumentations-node": "^0.80.0",
+    "@opentelemetry/instrumentation-openai": "^0.20.0",
+    "@opentelemetry/api-logs": "^0.222.0",
+    "@opentelemetry/exporter-logs-otlp-http": "^0.222.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.222.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.222.0",
+    "@opentelemetry/sdk-logs": "^0.222.0",
+    "@opentelemetry/resources": "^2.6.1",
+    "@opentelemetry/sdk-metrics": "^2.11.0",
+    "@opentelemetry/sdk-node": "^0.222.0",
+    "@opentelemetry/semantic-conventions": "^1.40.0"
+  },
+  "peerDependencies": {
+    "@nestjs/bullmq": "*",
+    "@nestjs/common": "*",
+    "@nestjs/schedule": "*"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/bullmq": {
+      "optional": true
+    },
+    "@nestjs/common": {
+      "optional": true
+    },
+    "@nestjs/schedule": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@nestjs/bullmq": "^11.0.4",
+    "@nestjs/common": "^11.1.16",
+    "@nestjs/schedule": "^6.1.1",
+    "@types/node": "^20.19.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3"
+  }
+}