@heystack/otel 0.0.1

package/README.md

@@ -0,0 +1,15 @@
+# @heystack/otel
+
+One-call OpenTelemetry tracing that exports to Heystack.
+
+```bash
+npm install @heystack/otel
+```
+
+At the very top of your app's entry file:
+```ts
+import { initHeystack } from "@heystack/otel";
+initHeystack({ apiKey: process.env.HEYSTACK_KEY!, service: "my-app" });
+```
+
+Then run your app and make a request — traces appear in your Heystack dashboard within seconds.

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { NodeSDK } from "@opentelemetry/sdk-node";
+export interface HeystackOptions {
+    /** Your Heystack ingest key (sk_live_...). */
+    apiKey: string;
+    /** The OTel service.name this app reports as (must match the app's service in Heystack). */
+    service: string;
+    /** Override the ingest endpoint (defaults to Heystack production). */
+    endpoint?: string;
+}
+export interface ExporterConfig {
+    url: string;
+    headers: {
+        Authorization: string;
+    };
+}
+/** Pure: derive the OTLP/HTTP exporter URL + auth header. Unit-tested. */
+export declare function buildExporterConfig(o: HeystackOptions): ExporterConfig;
+/**
+ * Initialise Heystack OpenTelemetry tracing. Call once, as early as possible in
+ * your app's entry point. Returns the started NodeSDK.
+ */
+export declare function initHeystack(o: HeystackOptions): NodeSDK;

package/dist/index.js

@@ -0,0 +1,21 @@
+import { NodeSDK } from "@opentelemetry/sdk-node";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+const DEFAULT_ENDPOINT = "https://ingest.heystack.dev";
+/** Pure: derive the OTLP/HTTP exporter URL + auth header. Unit-tested. */
+export function buildExporterConfig(o) {
+    const base = (o.endpoint ?? DEFAULT_ENDPOINT).replace(/\/+$/, "");
+    return { url: `${base}/v1/traces`, headers: { Authorization: `Bearer ${o.apiKey}` } };
+}
+/**
+ * Initialise Heystack OpenTelemetry tracing. Call once, as early as possible in
+ * your app's entry point. Returns the started NodeSDK.
+ */
+export function initHeystack(o) {
+    const cfg = buildExporterConfig(o);
+    const sdk = new NodeSDK({
+        serviceName: o.service,
+        traceExporter: new OTLPTraceExporter({ url: cfg.url, headers: cfg.headers }),
+    });
+    sdk.start();
+    return sdk;
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@heystack/otel",
+  "version": "0.0.1",
+  "description": "One-call OpenTelemetry tracing that exports to Heystack.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
+  "files": ["dist", "README.md"],
+  "publishConfig": { "access": "public" },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "@opentelemetry/sdk-node": "^0.57.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.57.0",
+    "@opentelemetry/resources": "^1.30.0",
+    "@opentelemetry/semantic-conventions": "^1.30.0"
+  },
+  "devDependencies": {
+    "vitest": "^2.1.0",
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  }
+}