spanport 0.1.1 → 1.0.0

package/README.md

@@ -1,6 +1,6 @@
 # spanport (Node.js SDK)
 
-Send your Node.js app's logs to Spanport. Keep logging the way you already do.
+Send your Node.js app's logs, and where each request spends its time, to Spanport. Keep logging the way you already do.
 
 ```bash
 npm install spanport
@@ -49,12 +49,42 @@ Node.js 22.15 or newer. ES module; CommonJS apps can `require("spanport")`.
 At start-up the SDK prints, on stderr:
 
 ```
-INFO spanport: sending logs for service orders-api to http://localhost:4318
+INFO spanport: sending logs and traces for service orders-api to http://localhost:4318
 INFO spanport: data key ...a1b2 accepted
 ```
 
 If the second line is missing or says something else, see [Troubleshooting](#troubleshooting).
 
+## Request timing (traces)
+
+`init()` also times each request your app handles and every step inside it, and sends them as traces; open **Requests** in Spanport to see them as a waterfall (request → controller → service → database / outgoing calls). Pass `traces: false` to send logs only.
+
+- **Always on:** incoming HTTP requests and outgoing `http`/`https` calls. Outgoing calls carry a W3C `traceparent` header, so your other services running the SDK join the same trace (shown as a service call).
+- **If your app has them installed**, also: route names for Express and NestJS (`npm install @opentelemetry/instrumentation-express`), Postgres queries (`@opentelemetry/instrumentation-pg`) and `fetch` calls (`@opentelemetry/instrumentation-undici`). On start-up the SDK says which it found: `spanport: also timing: ...`.
+- **Call `init()` before your framework loads**, from a small file imported first, so Express and Postgres get timed:
+
+```ts
+// src/spanport.ts
+import * as spanport from "spanport";
+spanport.init({ dataKey: process.env.SPANPORT_DATA_KEY ?? "", service: "kosha-backend" });
+
+// src/main.ts: the very first import
+import "./spanport";
+import { NestFactory } from "@nestjs/core";
+```
+
+**Your own code**: time every method of a controller or service, or any block:
+
+```ts
+@spanport.trace()        // "VariablesService.list", "VariablesService.find", ...
+@Injectable()
+export class VariablesService { ... }
+
+const prompt = await spanport.withSpan("build prompt", () => render(template, data));
+```
+
+Works with NestJS decorators (route paths and guards keep working) and with sync or async methods. A thrown error marks the step failed and is rethrown unchanged. Logs written during a step carry its trace, so **See logs** on a request in Spanport shows them.
+
 ## What Spanport receives
 
 | You write | Message | Level | Fields you can filter on |

package/dist/constants.d.ts

@@ -3,6 +3,22 @@ export declare const DATA_KEY_PREFIX = "sp_ingest_";
 export declare const DEFAULT_COLLECTOR_URL = "http://localhost:4318";
 export declare const DEFAULT_SERVER_URL = "http://localhost:8000";
 export declare const OTLP_LOGS_PATH = "/v1/logs";
+export declare const OTLP_TRACES_PATH = "/v1/traces";
+/**
+ * Instrumentations switched on only when the app has installed them (they patch libraries the
+ * SDK doesn't depend on): Express and NestJS route names, Postgres queries, fetch calls.
+ */
+export declare const OPTIONAL_INSTRUMENTATIONS: readonly {
+    module: string;
+    exportName: string;
+}[];
+/** Node built-ins the HTTP instrumentation patches; required once when tracing starts. */
+export declare const PATCHED_BUILTINS: readonly string[];
+/** Separates a decorated class's name from its method in span names, e.g. "UsersService.find". */
+export declare const SPAN_NAME_SEPARATOR = ".";
+export declare const CONSTRUCTOR_NAME = "constructor";
+/** The name a class decorator falls back to for an anonymous class. */
+export declare const ANONYMOUS_CLASS_NAME = "AnonymousClass";
 export declare const CURRENT_API_KEY_PATH = "/api/v1/api-keys/current";
 export declare const AUTHORIZATION_HEADER = "Authorization";
 export declare const BEARER_PREFIX = "Bearer ";

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,eAAO,MAAM,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAC1D,eAAO,MAAM,cAAc,aAAa,CAAC;AACzC,eAAO,MAAM,oBAAoB,6BAA6B,CAAC;AAC/D,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AACpD,eAAO,MAAM,aAAa,YAAY,CAAC;AACvC,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAwB,CAAC;AAC5E,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,oDAAqD,CAAC;AAE3F,mDAAmD;AACnD,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AACrD,oEAAoE;AACpE,eAAO,MAAM,cAAc,aAAa,CAAC;AACzC,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,qEAAqE;AACrE,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,cAAc,YAAY,CAAC;AACxC,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAE1C,mGAAmG;AACnG,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAAuB,CAAC;AACpE,eAAO,MAAM,WAAW,UAAU,CAAC;AACnC,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAA0B,CAAC;AACpE,eAAO,MAAM,cAAc,aAAa,CAAC;AACzC,eAAO,MAAM,aAAa,YAAY,CAAC;AACvC,eAAO,MAAM,cAAc,OAAO,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,eAAO,MAAM,eAAe,eAAe,CAAC;AAC5C,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAC1D,eAAO,MAAM,cAAc,aAAa,CAAC;AACzC,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAItF,CAAC;AACF,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAAgC,CAAC;AAC/E,kGAAkG;AAClG,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAC9C,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AACrD,eAAO,MAAM,oBAAoB,6BAA6B,CAAC;AAC/D,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AACpD,eAAO,MAAM,aAAa,YAAY,CAAC;AACvC,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAwB,CAAC;AAC5E,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,oDAAqD,CAAC;AAE3F,mDAAmD;AACnD,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AACrD,oEAAoE;AACpE,eAAO,MAAM,cAAc,aAAa,CAAC;AACzC,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,qEAAqE;AACrE,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,cAAc,YAAY,CAAC;AACxC,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAE1C,mGAAmG;AACnG,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAAuB,CAAC;AACpE,eAAO,MAAM,WAAW,UAAU,CAAC;AACnC,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAA0B,CAAC;AACpE,eAAO,MAAM,cAAc,aAAa,CAAC;AACzC,eAAO,MAAM,aAAa,YAAY,CAAC;AACvC,eAAO,MAAM,cAAc,OAAO,CAAC"}

package/dist/constants.js

@@ -3,6 +3,23 @@ export const DATA_KEY_PREFIX = "sp_ingest_";
 export const DEFAULT_COLLECTOR_URL = "http://localhost:4318";
 export const DEFAULT_SERVER_URL = "http://localhost:8000";
 export const OTLP_LOGS_PATH = "/v1/logs";
+export const OTLP_TRACES_PATH = "/v1/traces";
+/**
+ * Instrumentations switched on only when the app has installed them (they patch libraries the
+ * SDK doesn't depend on): Express and NestJS route names, Postgres queries, fetch calls.
+ */
+export const OPTIONAL_INSTRUMENTATIONS = [
+    { module: "@opentelemetry/instrumentation-express", exportName: "ExpressInstrumentation" },
+    { module: "@opentelemetry/instrumentation-pg", exportName: "PgInstrumentation" },
+    { module: "@opentelemetry/instrumentation-undici", exportName: "UndiciInstrumentation" },
+];
+/** Node built-ins the HTTP instrumentation patches; required once when tracing starts. */
+export const PATCHED_BUILTINS = ["node:http", "node:https"];
+/** Separates a decorated class's name from its method in span names, e.g. "UsersService.find". */
+export const SPAN_NAME_SEPARATOR = ".";
+export const CONSTRUCTOR_NAME = "constructor";
+/** The name a class decorator falls back to for an anonymous class. */
+export const ANONYMOUS_CLASS_NAME = "AnonymousClass";
 export const CURRENT_API_KEY_PATH = "/api/v1/api-keys/current";
 export const AUTHORIZATION_HEADER = "Authorization";
 export const BEARER_PREFIX = "Bearer ";

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAC1D,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AACzC,MAAM,CAAC,MAAM,oBAAoB,GAAG,0BAA0B,CAAC;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC;AACpD,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AACvC,MAAM,CAAC,MAAM,qBAAqB,GAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AACzC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC,oFAAoF;AACpF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAE3F,mDAAmD;AACnD,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAC7B,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAC5B,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAC5B,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAE7B,MAAM,CAAC,MAAM,sBAAsB,GAAG,cAAc,CAAC;AACrD,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AACzC,yEAAyE;AACzE,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAE9C,qEAAqE;AACrE,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC;AACjD,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AACxC,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAE1C,mGAAmG;AACnG,MAAM,CAAC,MAAM,cAAc,GAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AACnC,MAAM,CAAC,MAAM,WAAW,GAAsB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AACzC,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAC1D,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAsD;IAC1F,EAAE,MAAM,EAAE,wCAAwC,EAAE,UAAU,EAAE,wBAAwB,EAAE;IAC1F,EAAE,MAAM,EAAE,mCAAmC,EAAE,UAAU,EAAE,mBAAmB,EAAE;IAChF,EAAE,MAAM,EAAE,uCAAuC,EAAE,UAAU,EAAE,uBAAuB,EAAE;CACzF,CAAC;AACF,0FAA0F;AAC1F,MAAM,CAAC,MAAM,gBAAgB,GAAsB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AAC/E,kGAAkG;AAClG,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;AAC9C,uEAAuE;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,0BAA0B,CAAC;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC;AACpD,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AACvC,MAAM,CAAC,MAAM,qBAAqB,GAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AACzC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC,oFAAoF;AACpF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAE3F,mDAAmD;AACnD,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAC7B,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAC5B,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAC5B,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAE7B,MAAM,CAAC,MAAM,sBAAsB,GAAG,cAAc,CAAC;AACrD,oEAAoE;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AACzC,yEAAyE;AACzE,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAE9C,qEAAqE;AACrE,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC;AACjD,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AACxC,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAE1C,mGAAmG;AACnG,MAAM,CAAC,MAAM,cAAc,GAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AACnC,MAAM,CAAC,MAAM,WAAW,GAAsB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AACzC,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Spanport SDK: send your Node.js app's logs to Spanport.
+ * Spanport SDK: send your Node.js app's logs and traces (request timings) to Spanport.
  *
  *     import * as spanport from "spanport";
  *     spanport.init({ dataKey: "sp_ingest_...", service: "orders-api" });
@@ -21,7 +21,10 @@ export interface SpanportOptions {
     checkKey?: boolean;
     /** Set false to stop copying console.* calls to Spanport. Default true. */
     captureConsole?: boolean;
+    /** Set false to send no traces (request timings). Default true. */
+    traces?: boolean;
 }
+export { trace, withSpan } from "./spans.js";
 /**
  * Start sending this app's logs to Spanport. Call once at start-up. Never throws.
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAqB5C,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAWD;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAMnD;AAED;;;GAGG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAU9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CAIpC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAsB5C,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AASD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAK7C;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAMnD;AAED;;;GAGG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAU9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CAIpC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 /**
- * Spanport SDK: send your Node.js app's logs to Spanport.
+ * Spanport SDK: send your Node.js app's logs and traces (request timings) to Spanport.
  *
  *     import * as spanport from "spanport";
  *     spanport.init({ dataKey: "sp_ingest_...", service: "orders-api" });
@@ -17,7 +17,9 @@ import { createLogStream } from "./logStream.js";
 import { buildLoggerProvider, buildOtlpExporter, toLogRecord } from "./pipeline.js";
 import { sdkError, sdkInfo, sdkWarning } from "./sdkMessages.js";
 import { consoleSeverity } from "./severity.js";
+import { buildTraceExporter, startTracing } from "./tracing.js";
 import { isHttpUrl } from "./urls.js";
+export { trace, withSpan } from "./spans.js";
 let active;
 let exitFlushInstalled = false;
 /**
@@ -44,7 +46,7 @@ export async function shutdown() {
         return;
     pipeline.restoreConsole?.();
     try {
-        await pipeline.provider.shutdown();
+        await Promise.all([pipeline.provider.shutdown(), pipeline.tracing?.stop()]);
     }
     catch (error) {
         sdkWarning(`shutdown failed; some queued logs may not have been sent: ${describe(error)}`);
@@ -82,11 +84,20 @@ function start(options) {
         : captureConsole((method, message) => {
             logger.emit(toLogRecord({ body: message, severity: consoleSeverity(method), attributes: {} }, CONSOLE_SOURCE));
         });
-    active = { provider, logger, restoreConsole };
+    const serverUrl = options.serverUrl ?? DEFAULT_SERVER_URL;
+    const tracing = options.traces === false
+        ? undefined
+        : startTracing(options.service, buildTraceExporter(collectorUrl, options.dataKey), {
+            collectorUrl,
+            serverUrl: isHttpUrl(serverUrl) ? serverUrl : collectorUrl,
+        });
+    active = { provider, logger, restoreConsole, tracing };
     installExitFlush();
-    sdkInfo(`sending logs for service ${options.service} to ${collectorUrl}`);
+    sdkInfo(`sending logs${tracing ? " and traces" : ""} for service ${options.service} to ${collectorUrl}`);
+    if (tracing?.optional.length)
+        sdkInfo(`also timing: ${tracing.optional.join(", ")}`);
     if (options.checkKey !== false) {
-        void checkDataKey(options.serverUrl ?? DEFAULT_SERVER_URL, options.dataKey);
+        void checkDataKey(serverUrl, options.dataKey);
     }
 }
 /** Send what is queued when the app exits normally. Installed once, however often init runs. */

package/dist/index.js.map

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

package/dist/spans.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Your own steps in a trace: `withSpan(name, fn)` for any block, and the `trace()` class decorator
+ * that times every method of a controller or service as "ClassName.method".
+ */
+/**
+ * Run `work` inside a span named `name`, nested under the current one. Works for sync and async
+ * work; a thrown error or rejected promise marks the span failed and is rethrown unchanged.
+ *
+ *     const user = await spanport.withSpan("load user", () => repo.find(id));
+ *
+ * @returns Whatever `work` returns.
+ */
+export declare function withSpan<T>(name: string, work: () => T): T;
+/**
+ * Class decorator: every method becomes a step of the trace, named "ClassName.method".
+ *
+ *     @spanport.trace()
+ *     @Injectable()
+ *     export class VariablesService { ... }
+ *
+ * Works with TypeScript's legacy decorators (NestJS) and standard ones. Method metadata (e.g.
+ * NestJS route paths) is copied to the timed method, so frameworks keep working.
+ *
+ * @param name - The name used before the dot; the class's own name by default.
+ */
+export declare function trace(name?: string): (target: abstract new (...args: never[]) => unknown) => void;
+//# sourceMappingURL=spans.d.ts.map

package/dist/spans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spans.d.ts","sourceRoot":"","sources":["../src/spans.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAuB1D;AAQD;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,IAEzB,QAAQ,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,KAAG,IAAI,CAUlE"}

package/dist/spans.js

@@ -0,0 +1,86 @@
+/**
+ * Your own steps in a trace: `withSpan(name, fn)` for any block, and the `trace()` class decorator
+ * that times every method of a controller or service as "ClassName.method".
+ */
+import { SpanStatusCode, trace as otelTrace } from "@opentelemetry/api";
+import { ANONYMOUS_CLASS_NAME, CONSTRUCTOR_NAME, SDK_SCOPE_NAME, SPAN_NAME_SEPARATOR, } from "./constants.js";
+/**
+ * Run `work` inside a span named `name`, nested under the current one. Works for sync and async
+ * work; a thrown error or rejected promise marks the span failed and is rethrown unchanged.
+ *
+ *     const user = await spanport.withSpan("load user", () => repo.find(id));
+ *
+ * @returns Whatever `work` returns.
+ */
+export function withSpan(name, work) {
+    return otelTrace.getTracer(SDK_SCOPE_NAME).startActiveSpan(name, (span) => {
+        try {
+            const result = work();
+            if (result instanceof Promise) {
+                return result.then((value) => {
+                    span.end();
+                    return value;
+                }, (error) => {
+                    fail(span, error);
+                    throw error;
+                });
+            }
+            span.end();
+            return result;
+        }
+        catch (error) {
+            fail(span, error);
+            throw error;
+        }
+    });
+}
+function fail(span, error) {
+    span.recordException(error instanceof Error ? error : String(error));
+    span.setStatus({ code: SpanStatusCode.ERROR, message: error instanceof Error ? error.message : String(error) });
+    span.end();
+}
+/**
+ * Class decorator: every method becomes a step of the trace, named "ClassName.method".
+ *
+ *     @spanport.trace()
+ *     @Injectable()
+ *     export class VariablesService { ... }
+ *
+ * Works with TypeScript's legacy decorators (NestJS) and standard ones. Method metadata (e.g.
+ * NestJS route paths) is copied to the timed method, so frameworks keep working.
+ *
+ * @param name - The name used before the dot; the class's own name by default.
+ */
+export function trace(name) {
+    // Standard decorators also pass a context object; it isn't needed, so it isn't declared.
+    return (target) => {
+        const className = name ?? (target.name || ANONYMOUS_CLASS_NAME);
+        const prototype = target.prototype;
+        for (const methodName of Object.getOwnPropertyNames(prototype)) {
+            const descriptor = Object.getOwnPropertyDescriptor(prototype, methodName);
+            if (methodName === CONSTRUCTOR_NAME || typeof descriptor?.value !== "function")
+                continue;
+            const timed = timedMethod(`${className}${SPAN_NAME_SEPARATOR}${methodName}`, descriptor.value);
+            Object.defineProperty(prototype, methodName, { ...descriptor, value: timed });
+        }
+    };
+}
+/** A method that runs the original inside a span, carrying over its name and metadata. */
+function timedMethod(spanName, original) {
+    const timed = function (...args) {
+        return withSpan(spanName, () => original.apply(this, args));
+    };
+    Object.defineProperty(timed, "name", { value: original.name });
+    copyMetadata(original, timed);
+    return timed;
+}
+/** Copy reflect-metadata entries (NestJS route paths, guards...) from one function to another. */
+function copyMetadata(from, to) {
+    const reflect = Reflect;
+    if (!reflect.getMetadataKeys || !reflect.getMetadata || !reflect.defineMetadata)
+        return;
+    for (const key of reflect.getMetadataKeys(from)) {
+        reflect.defineMetadata(key, reflect.getMetadata(key, from), to);
+    }
+}
+//# sourceMappingURL=spans.js.map

package/dist/spans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spans.js","sourceRoot":"","sources":["../src/spans.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAa,cAAc,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEnF,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAWxB;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAI,IAAY,EAAE,IAAa;IACrD,OAAO,SAAS,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;QACxE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC;YACtB,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;gBAC9B,OAAO,MAAM,CAAC,IAAI,CAChB,CAAC,KAAc,EAAE,EAAE;oBACjB,IAAI,CAAC,GAAG,EAAE,CAAC;oBACX,OAAO,KAAK,CAAC;gBACf,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;oBACjB,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;oBAClB,MAAM,KAAK,CAAC;gBACd,CAAC,CACG,CAAC;YACT,CAAC;YACD,IAAI,CAAC,GAAG,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAClB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,IAAI,CAAC,IAAU,EAAE,KAAc;IACtC,IAAI,CAAC,eAAe,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChH,IAAI,CAAC,GAAG,EAAE,CAAC;AACb,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CAAC,IAAa;IACjC,yFAAyF;IACzF,OAAO,CAAC,MAAkD,EAAQ,EAAE;QAClE,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,oBAAoB,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG,MAAM,CAAC,SAAoC,CAAC;QAC9D,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/D,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YAC1E,IAAI,UAAU,KAAK,gBAAgB,IAAI,OAAO,UAAU,EAAE,KAAK,KAAK,UAAU;gBAAE,SAAS;YACzF,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,SAAS,GAAG,mBAAmB,GAAG,UAAU,EAAE,EAAE,UAAU,CAAC,KAAoB,CAAC,CAAC;YAC9G,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,GAAG,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,0FAA0F;AAC1F,SAAS,WAAW,CAAC,QAAgB,EAAE,QAAqB;IAC1D,MAAM,KAAK,GAAG,UAAyB,GAAG,IAAe;QACvD,OAAO,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC;IACF,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/D,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kGAAkG;AAClG,SAAS,YAAY,CAAC,IAAiB,EAAE,EAAe;IACtD,MAAM,OAAO,GAAG,OAAqC,CAAC;IACtD,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,cAAc;QAAE,OAAO;IACxF,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,OAAO,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/tracing.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Traces: each request the app handles, and each step inside it (outgoing HTTP, database calls,
+ * decorated controllers and services), sent in the background to the collector's /v1/traces.
+ */
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import { type SpanExporter, TracerProvider } from "@opentelemetry/sdk-trace";
+export interface ActiveTracing {
+    provider: TracerProvider;
+    /** Names of the optional instrumentations the app had installed. */
+    optional: string[];
+    /** Send what is queued, then stop tracing and put the globals back. */
+    stop: () => Promise<void>;
+}
+/** Hosts the SDK itself talks to; requests to them are never traced, so Spanport never traces itself. */
+export interface OwnHosts {
+    collectorUrl: string;
+    serverUrl: string;
+}
+/**
+ * Exporter that sends span batches to the collector with the data key as a bearer token.
+ *
+ * @param collectorUrl - Base URL of the OTel Collector, e.g. "http://localhost:4318".
+ * @param dataKey - The raw data key.
+ */
+export declare function buildTraceExporter(collectorUrl: string, dataKey: string): OTLPTraceExporter;
+/**
+ * Start tracing: keep the current request across awaits, register the tracer provider and switch
+ * on HTTP timing plus any optional instrumentation the app has installed.
+ *
+ * @param service - Service name shown in Spanport.
+ * @param exporter - Where span batches go; OTLP in real use, in-memory in tests.
+ * @param ownHosts - The SDK's own collector and server, never traced.
+ * @param loadModule - Loads an optional instrumentation by name; tests pass their own.
+ * @returns The running tracing, and how to stop it.
+ */
+export declare function startTracing(service: string, exporter: SpanExporter, ownHosts: OwnHosts, loadModule?: (name: string) => unknown): ActiveTracing;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAI5E,OAAO,EAAsB,KAAK,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAYjG,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,cAAc,CAAC;IACzB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,uEAAuE;IACvE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,yGAAyG;AACzG,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAK3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,QAAQ,EAClB,UAAU,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAA0B,GACvD,aAAa,CA8Bf"}

package/dist/tracing.js

@@ -0,0 +1,128 @@
+/**
+ * Traces: each request the app handles, and each step inside it (outgoing HTTP, database calls,
+ * decorated controllers and services), sent in the background to the collector's /v1/traces.
+ */
+import { createRequire } from "node:module";
+import { context, propagation, trace } from "@opentelemetry/api";
+import { AsyncLocalStorageContextManager } from "@opentelemetry/context-async-hooks";
+import { W3CTraceContextPropagator } from "@opentelemetry/core";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import { registerInstrumentations } from "@opentelemetry/instrumentation";
+import { HttpInstrumentation } from "@opentelemetry/instrumentation-http";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { BatchSpanProcessor, TracerProvider } from "@opentelemetry/sdk-trace";
+import { AUTHORIZATION_HEADER, BEARER_PREFIX, OPTIONAL_INSTRUMENTATIONS, OTLP_TRACES_PATH, PATCHED_BUILTINS, SERVICE_NAME_ATTRIBUTE, } from "./constants.js";
+import { joinUrl } from "./urls.js";
+/**
+ * Exporter that sends span batches to the collector with the data key as a bearer token.
+ *
+ * @param collectorUrl - Base URL of the OTel Collector, e.g. "http://localhost:4318".
+ * @param dataKey - The raw data key.
+ */
+export function buildTraceExporter(collectorUrl, dataKey) {
+    return new OTLPTraceExporter({
+        url: joinUrl(collectorUrl, OTLP_TRACES_PATH),
+        headers: { [AUTHORIZATION_HEADER]: BEARER_PREFIX + dataKey },
+    });
+}
+/**
+ * Start tracing: keep the current request across awaits, register the tracer provider and switch
+ * on HTTP timing plus any optional instrumentation the app has installed.
+ *
+ * @param service - Service name shown in Spanport.
+ * @param exporter - Where span batches go; OTLP in real use, in-memory in tests.
+ * @param ownHosts - The SDK's own collector and server, never traced.
+ * @param loadModule - Loads an optional instrumentation by name; tests pass their own.
+ * @returns The running tracing, and how to stop it.
+ */
+export function startTracing(service, exporter, ownHosts, loadModule = requireInstalled) {
+    const contextManager = new AsyncLocalStorageContextManager().enable();
+    context.setGlobalContextManager(contextManager);
+    // Outgoing calls carry a W3C traceparent header, so another service running the SDK joins
+    // the same trace (Spanport then shows the call as a service call).
+    propagation.setGlobalPropagator(new W3CTraceContextPropagator());
+    const provider = new TracerProvider({
+        resource: resourceFromAttributes({ [SERVICE_NAME_ATTRIBUTE]: service }),
+        spanProcessors: [new BatchSpanProcessor({ exporter })],
+    });
+    trace.setGlobalTracerProvider(provider);
+    useHttpInstrumentation(provider, ownHosts);
+    const optional = loadOptionalInstrumentations(loadModule);
+    const unregisterOptional = registerInstrumentations({
+        tracerProvider: provider,
+        instrumentations: optional.map((loaded) => loaded.instrumentation),
+    });
+    return {
+        provider,
+        optional: optional.map((loaded) => loaded.module),
+        stop: async () => {
+            unregisterOptional();
+            // The HTTP instrumentation stays on (see useHttpInstrumentation); with its provider shut
+            // down, the spans it makes go nowhere.
+            await provider.shutdown();
+            trace.disable();
+            context.disable();
+            propagation.disable();
+        },
+    };
+}
+// The HTTP instrumentation is switched on once per process and stays on. Node's http module is
+// patched when it is require()d, which happens once; switched off, the instrumentation can't
+// patch it again, so a later init() (after shutdown()) would time nothing.
+let httpInstrumentation;
+/**
+ * Time incoming requests and outgoing http/https calls (except the SDK's own) into `provider`.
+ */
+function useHttpInstrumentation(provider, ownHosts) {
+    const ownOrigins = new Set([new URL(ownHosts.collectorUrl).host, new URL(ownHosts.serverUrl).host]);
+    const config = {
+        ignoreOutgoingRequestHook: (request) => ownOrigins.has(outgoingHost(request)),
+    };
+    if (httpInstrumentation) {
+        httpInstrumentation.setConfig(config);
+        httpInstrumentation.setTracerProvider(provider);
+        return;
+    }
+    httpInstrumentation = new HttpInstrumentation(config);
+    registerInstrumentations({ tracerProvider: provider, instrumentations: [httpInstrumentation] });
+    // Node's http/https are usually loaded already, and ESM imports never go through require, so
+    // require them once now: that patches the shared module object ESM and CommonJS code both use.
+    for (const builtin of PATCHED_BUILTINS)
+        requireFromApp(builtin);
+}
+/** "host:port" of an outgoing request, as URL.host writes it (no port for the default one). */
+function outgoingHost(request) {
+    const host = request.hostname ?? request.host ?? "";
+    return request.port ? `${host}:${String(request.port)}` : host;
+}
+/** The optional instrumentations the app has installed; anything missing is skipped quietly. */
+function loadOptionalInstrumentations(loadModule) {
+    const loaded = [];
+    for (const { module, exportName } of OPTIONAL_INSTRUMENTATIONS) {
+        const instrumentation = construct(loadModule(module), exportName);
+        if (instrumentation)
+            loaded.push({ module, instrumentation });
+    }
+    return loaded;
+}
+/** `new exports[exportName]()`, or undefined when the module or the class isn't there. */
+function construct(moduleExports, exportName) {
+    if (typeof moduleExports !== "object" || moduleExports === null)
+        return undefined;
+    const exported = moduleExports[exportName];
+    if (typeof exported !== "function")
+        return undefined;
+    return new exported();
+}
+const requireFromApp = createRequire(import.meta.url);
+/** The module if the app has it installed, else undefined. */
+function requireInstalled(name) {
+    try {
+        return requireFromApp(name);
+    }
+    catch {
+        // Not installed: that instrumentation is simply off.
+        return undefined;
+    }
+}
+//# sourceMappingURL=tracing.js.map

package/dist/tracing.js.map

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

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "spanport",
-  "version": "0.1.1",
-  "description": "Send your Node.js app's logs to Spanport. Keep logging the way you already do.",
+  "version": "1.0.0",
+  "description": "Send your Node.js app's logs and request traces to Spanport. Keep logging the way you already do.",
   "keywords": [
     "logging",
+    "tracing",
     "observability",
     "opentelemetry",
     "otlp",
@@ -11,7 +12,7 @@
   ],
   "license": "Apache-2.0",
   "author": "Nitish Bharadwaj <nitishbharadwaj2002@gmail.com>",
-  "homepage": "https://github.com/span-port/spanport",
+  "homepage": "https://github.com/span-port/spanport/tree/sdk-node-v1.0.0/sdk/node#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/span-port/spanport.git",
@@ -42,14 +43,18 @@
   },
   "dependencies": {
     "@opentelemetry/api": ">=1.10.0 <1.11.0",
+    "@opentelemetry/context-async-hooks": ">=3.0.0 <4.0.0",
+    "@opentelemetry/core": ">=3.0.0 <4.0.0",
     "@opentelemetry/exporter-logs-otlp-http": ">=0.300.0 <0.301.0",
+    "@opentelemetry/exporter-trace-otlp-http": ">=0.300.0 <0.301.0",
+    "@opentelemetry/instrumentation": ">=0.300.0 <0.301.0",
+    "@opentelemetry/instrumentation-http": ">=0.300.0 <0.301.0",
     "@opentelemetry/resources": ">=3.0.0 <4.0.0",
-    "@opentelemetry/sdk-logs": ">=3.0.0 <4.0.0"
+    "@opentelemetry/sdk-logs": ">=3.0.0 <4.0.0",
+    "@opentelemetry/sdk-trace": ">=3.0.0 <4.0.0"
   },
   "devDependencies": {
     "@eslint/js": "10.0.1",
-    "@opentelemetry/context-async-hooks": "3.0.0",
-    "@opentelemetry/sdk-trace": "3.0.0",
     "@types/node": "22.20.5",
     "eslint": "10.13.0",
     "typescript": "6.0.3",