@rely-net/sdk 1.0.1 → 1.0.3

package/README.md

@@ -5,6 +5,7 @@ Official SDK for [rely.net](https://rely.net) — monitor your application from
 ## What it does
 
 - Sends health check results from inside your app to rely.net
+- Attributes outgoing HTTP calls to vendors (Stripe, OpenAI, etc.) with per-vendor p95 + error rates
 - Tracks custom metrics alongside vendor status
 - Marks deployments on your monitoring charts
 - Captures request telemetry (error rate, response times)
@@ -145,6 +146,21 @@ export const config = {
 }
 ```
 
+## Outgoing vendor calls
+
+The SDK wraps the global `fetch` on init to bucket outgoing HTTP calls by hostname and report p50/p95/p99 + error rates per vendor. rely.net matches hostnames to known vendors (Stripe, OpenAI, Supabase, etc.) so you see vendor latency from your app's perspective — the answer to "is it me or is it Stripe?" without writing any code.
+
+Enabled by default. Disable with:
+
+```ts
+new Rely({
+  apiKey: process.env.RELY_API_KEY!,
+  instrumentFetch: false,
+})
+```
+
+Self-calls to the rely.net ingest endpoint are always skipped.
+
 ## Deployment markers
 
 Deployment markers are sent automatically when the SDK initializes. They appear as vertical lines on your charts in rely.net, making it easy to correlate issues with deploys.
@@ -167,6 +183,7 @@ new Rely({
   environment?: string,     // default: process.env.NODE_ENV
   flushInterval?: number,   // default: 60000 (ms)
   sanitizeErrors?: boolean, // default: true (recommended)
+  instrumentFetch?: boolean,// default: true (wraps global fetch)
   debug?: boolean,          // default: false
 })
 ```

package/dist/index.d.mts

@@ -61,6 +61,16 @@ interface DeploymentPayload {
     deployment_url: string;
     metadata: Record<string, unknown>;
 }
+interface VendorCallWindow {
+    window_start: string;
+    window_end: string;
+    hostname: string;
+    call_count: number;
+    error_count: number;
+    p50_ms: number;
+    p95_ms: number;
+    p99_ms: number;
+}
 interface IngestPayload {
     version: string;
     timestamp: string;
@@ -69,6 +79,7 @@ interface IngestPayload {
     metrics?: MetricDatapoint[];
     runtime?: RuntimeStats;
     request_telemetry?: RequestWindowData;
+    vendor_calls?: VendorCallWindow[];
 }
 interface IngestResponse {
     received: boolean;
@@ -78,6 +89,7 @@ interface IngestResponse {
         metrics: number;
         runtime: boolean;
         request_telemetry: boolean;
+        vendor_calls: number;
     };
     warnings: string[];
     timestamp: string;
@@ -89,6 +101,7 @@ interface RelyClientOptions {
     flushInterval?: number;
     sanitizeErrors?: boolean;
     debug?: boolean;
+    instrumentFetch?: boolean;
 }
 
 declare class RelyClient {
@@ -98,12 +111,16 @@ declare class RelyClient {
     private readonly flushInterval;
     private readonly sanitizeErrors;
     private readonly debug;
+    private readonly instrumentFetchEnabled;
     private healthChecks;
     private pendingMetrics;
     private requestBuffer;
+    private vendorCallBuffer;
     private flushTimer;
     private deploymentSent;
     private isDestroyed;
+    private originalFetch;
+    private ingestHost;
     constructor(options: RelyClientOptions);
     healthCheck(name: string, fn: HealthCheckFn): this;
     metric(name: string, value: number, tags?: Record<string, string>): this;
@@ -119,6 +136,8 @@ declare class RelyClient {
     private sanitize;
     private sanitizeTags;
     private detectFrameworkVersion;
+    private installFetchInstrumentation;
+    private extractHostname;
     private log;
 }
 

package/dist/index.d.ts

@@ -61,6 +61,16 @@ interface DeploymentPayload {
     deployment_url: string;
     metadata: Record<string, unknown>;
 }
+interface VendorCallWindow {
+    window_start: string;
+    window_end: string;
+    hostname: string;
+    call_count: number;
+    error_count: number;
+    p50_ms: number;
+    p95_ms: number;
+    p99_ms: number;
+}
 interface IngestPayload {
     version: string;
     timestamp: string;
@@ -69,6 +79,7 @@ interface IngestPayload {
     metrics?: MetricDatapoint[];
     runtime?: RuntimeStats;
     request_telemetry?: RequestWindowData;
+    vendor_calls?: VendorCallWindow[];
 }
 interface IngestResponse {
     received: boolean;
@@ -78,6 +89,7 @@ interface IngestResponse {
         metrics: number;
         runtime: boolean;
         request_telemetry: boolean;
+        vendor_calls: number;
     };
     warnings: string[];
     timestamp: string;
@@ -89,6 +101,7 @@ interface RelyClientOptions {
     flushInterval?: number;
     sanitizeErrors?: boolean;
     debug?: boolean;
+    instrumentFetch?: boolean;
 }
 
 declare class RelyClient {
@@ -98,12 +111,16 @@ declare class RelyClient {
     private readonly flushInterval;
     private readonly sanitizeErrors;
     private readonly debug;
+    private readonly instrumentFetchEnabled;
     private healthChecks;
     private pendingMetrics;
     private requestBuffer;
+    private vendorCallBuffer;
     private flushTimer;
     private deploymentSent;
     private isDestroyed;
+    private originalFetch;
+    private ingestHost;
     constructor(options: RelyClientOptions);
     healthCheck(name: string, fn: HealthCheckFn): this;
     metric(name: string, value: number, tags?: Record<string, string>): this;
@@ -119,6 +136,8 @@ declare class RelyClient {
     private sanitize;
     private sanitizeTags;
     private detectFrameworkVersion;
+    private installFetchInstrumentation;
+    private extractHostname;
     private log;
 }
 

package/dist/index.js

@@ -110,6 +110,55 @@ var RequestBuffer = class {
   }
 };
 
+// src/collectors/vendorCalls.ts
+function percentile2(arr, p) {
+  if (arr.length === 0) return 0;
+  const sorted = [...arr].sort((a, b) => a - b);
+  const index = Math.ceil(p / 100 * sorted.length) - 1;
+  return sorted[Math.max(0, index)];
+}
+var VendorCallBuffer = class {
+  constructor() {
+    this.hosts = /* @__PURE__ */ new Map();
+    this.windowStart = /* @__PURE__ */ new Date();
+  }
+  record(hostname, durationMs, isError) {
+    if (!hostname) return;
+    let data = this.hosts.get(hostname);
+    if (!data) {
+      data = { durations: [], errors: 0 };
+      this.hosts.set(hostname, data);
+    }
+    data.durations.push(Math.max(0, durationMs));
+    if (isError) data.errors += 1;
+  }
+  get totalCalls() {
+    let total = 0;
+    for (const d of Array.from(this.hosts.values())) total += d.durations.length;
+    return total;
+  }
+  flush() {
+    const windowEnd = (/* @__PURE__ */ new Date()).toISOString();
+    const windowStart = this.windowStart.toISOString();
+    const out = [];
+    for (const [hostname, data] of Array.from(this.hosts.entries())) {
+      out.push({
+        window_start: windowStart,
+        window_end: windowEnd,
+        hostname,
+        call_count: data.durations.length,
+        error_count: data.errors,
+        p50_ms: percentile2(data.durations, 50),
+        p95_ms: percentile2(data.durations, 95),
+        p99_ms: percentile2(data.durations, 99)
+      });
+    }
+    this.hosts = /* @__PURE__ */ new Map();
+    this.windowStart = /* @__PURE__ */ new Date();
+    return out;
+  }
+};
+
 // src/client.ts
 var SDK_VERSION = "1.0.0";
 var SECRET_PATTERNS = [
@@ -156,12 +205,20 @@ var RelyClient = class {
     );
     this.sanitizeErrors = options.sanitizeErrors ?? true;
     this.debug = options.debug ?? false;
+    this.instrumentFetchEnabled = options.instrumentFetch ?? true;
     this.healthChecks = /* @__PURE__ */ new Map();
     this.pendingMetrics = [];
     this.requestBuffer = new RequestBuffer();
+    this.vendorCallBuffer = new VendorCallBuffer();
     this.flushTimer = null;
     this.deploymentSent = false;
     this.isDestroyed = false;
+    this.originalFetch = null;
+    try {
+      this.ingestHost = new URL(this.baseUrl).hostname;
+    } catch {
+      this.ingestHost = "";
+    }
     this.log(`SDK initialized`);
     this.log(`Environment: ${this.environment}`);
     this.log(`Flush interval: ${this.flushInterval / 1e3}s`);
@@ -247,6 +304,9 @@ var RelyClient = class {
     if (this.requestBuffer.totalRequests > 0) {
       payload.request_telemetry = this.requestBuffer.flush();
     }
+    if (this.vendorCallBuffer.totalCalls > 0) {
+      payload.vendor_calls = this.vendorCallBuffer.flush();
+    }
     await this.sendPayload(payload);
   }
   // Destroy the client and stop all background activity.
@@ -258,9 +318,19 @@ var RelyClient = class {
       clearInterval(this.flushTimer);
       this.flushTimer = null;
     }
+    if (this.originalFetch && typeof globalThis !== "undefined") {
+      try {
+        globalThis.fetch = this.originalFetch;
+      } catch {
+      }
+      this.originalFetch = null;
+    }
     this.log("SDK destroyed");
   }
   initialize() {
+    if (this.instrumentFetchEnabled) {
+      this.installFetchInstrumentation();
+    }
     if (this.environment === "production" || this.environment === "staging") {
       this.sendDeploymentMarker();
     }
@@ -400,6 +470,48 @@ var RelyClient = class {
       return "unknown";
     }
   }
+  installFetchInstrumentation() {
+    if (typeof globalThis === "undefined" || typeof globalThis.fetch !== "function") {
+      this.log("Global fetch not available, skipping instrumentation");
+      return;
+    }
+    const original = globalThis.fetch;
+    this.originalFetch = original;
+    const self = this;
+    const wrapped = async function(input, init) {
+      const hostname = self.extractHostname(input);
+      if (!hostname || hostname === self.ingestHost) {
+        return original(input, init);
+      }
+      const start = Date.now();
+      try {
+        const res = await original(input, init);
+        self.vendorCallBuffer.record(
+          hostname,
+          Date.now() - start,
+          res.status >= 400
+        );
+        return res;
+      } catch (err) {
+        self.vendorCallBuffer.record(hostname, Date.now() - start, true);
+        throw err;
+      }
+    };
+    try {
+      globalThis.fetch = wrapped;
+      this.log("Fetch instrumentation installed");
+    } catch {
+    }
+  }
+  extractHostname(input) {
+    try {
+      if (typeof input === "string") return new URL(input).hostname;
+      if (input instanceof URL) return input.hostname;
+      return new URL(input.url).hostname;
+    } catch {
+      return "";
+    }
+  }
   log(message) {
     if (this.debug) {
       console.log(`[Rely] ${message}`);

package/dist/index.mjs

@@ -76,6 +76,55 @@ var RequestBuffer = class {
   }
 };
 
+// src/collectors/vendorCalls.ts
+function percentile2(arr, p) {
+  if (arr.length === 0) return 0;
+  const sorted = [...arr].sort((a, b) => a - b);
+  const index = Math.ceil(p / 100 * sorted.length) - 1;
+  return sorted[Math.max(0, index)];
+}
+var VendorCallBuffer = class {
+  constructor() {
+    this.hosts = /* @__PURE__ */ new Map();
+    this.windowStart = /* @__PURE__ */ new Date();
+  }
+  record(hostname, durationMs, isError) {
+    if (!hostname) return;
+    let data = this.hosts.get(hostname);
+    if (!data) {
+      data = { durations: [], errors: 0 };
+      this.hosts.set(hostname, data);
+    }
+    data.durations.push(Math.max(0, durationMs));
+    if (isError) data.errors += 1;
+  }
+  get totalCalls() {
+    let total = 0;
+    for (const d of Array.from(this.hosts.values())) total += d.durations.length;
+    return total;
+  }
+  flush() {
+    const windowEnd = (/* @__PURE__ */ new Date()).toISOString();
+    const windowStart = this.windowStart.toISOString();
+    const out = [];
+    for (const [hostname, data] of Array.from(this.hosts.entries())) {
+      out.push({
+        window_start: windowStart,
+        window_end: windowEnd,
+        hostname,
+        call_count: data.durations.length,
+        error_count: data.errors,
+        p50_ms: percentile2(data.durations, 50),
+        p95_ms: percentile2(data.durations, 95),
+        p99_ms: percentile2(data.durations, 99)
+      });
+    }
+    this.hosts = /* @__PURE__ */ new Map();
+    this.windowStart = /* @__PURE__ */ new Date();
+    return out;
+  }
+};
+
 // src/client.ts
 var SDK_VERSION = "1.0.0";
 var SECRET_PATTERNS = [
@@ -122,12 +171,20 @@ var RelyClient = class {
     );
     this.sanitizeErrors = options.sanitizeErrors ?? true;
     this.debug = options.debug ?? false;
+    this.instrumentFetchEnabled = options.instrumentFetch ?? true;
     this.healthChecks = /* @__PURE__ */ new Map();
     this.pendingMetrics = [];
     this.requestBuffer = new RequestBuffer();
+    this.vendorCallBuffer = new VendorCallBuffer();
     this.flushTimer = null;
     this.deploymentSent = false;
     this.isDestroyed = false;
+    this.originalFetch = null;
+    try {
+      this.ingestHost = new URL(this.baseUrl).hostname;
+    } catch {
+      this.ingestHost = "";
+    }
     this.log(`SDK initialized`);
     this.log(`Environment: ${this.environment}`);
     this.log(`Flush interval: ${this.flushInterval / 1e3}s`);
@@ -213,6 +270,9 @@ var RelyClient = class {
     if (this.requestBuffer.totalRequests > 0) {
       payload.request_telemetry = this.requestBuffer.flush();
     }
+    if (this.vendorCallBuffer.totalCalls > 0) {
+      payload.vendor_calls = this.vendorCallBuffer.flush();
+    }
     await this.sendPayload(payload);
   }
   // Destroy the client and stop all background activity.
@@ -224,9 +284,19 @@ var RelyClient = class {
       clearInterval(this.flushTimer);
       this.flushTimer = null;
     }
+    if (this.originalFetch && typeof globalThis !== "undefined") {
+      try {
+        globalThis.fetch = this.originalFetch;
+      } catch {
+      }
+      this.originalFetch = null;
+    }
     this.log("SDK destroyed");
   }
   initialize() {
+    if (this.instrumentFetchEnabled) {
+      this.installFetchInstrumentation();
+    }
     if (this.environment === "production" || this.environment === "staging") {
       this.sendDeploymentMarker();
     }
@@ -366,6 +436,48 @@ var RelyClient = class {
       return "unknown";
     }
   }
+  installFetchInstrumentation() {
+    if (typeof globalThis === "undefined" || typeof globalThis.fetch !== "function") {
+      this.log("Global fetch not available, skipping instrumentation");
+      return;
+    }
+    const original = globalThis.fetch;
+    this.originalFetch = original;
+    const self = this;
+    const wrapped = async function(input, init) {
+      const hostname = self.extractHostname(input);
+      if (!hostname || hostname === self.ingestHost) {
+        return original(input, init);
+      }
+      const start = Date.now();
+      try {
+        const res = await original(input, init);
+        self.vendorCallBuffer.record(
+          hostname,
+          Date.now() - start,
+          res.status >= 400
+        );
+        return res;
+      } catch (err) {
+        self.vendorCallBuffer.record(hostname, Date.now() - start, true);
+        throw err;
+      }
+    };
+    try {
+      globalThis.fetch = wrapped;
+      this.log("Fetch instrumentation installed");
+    } catch {
+    }
+  }
+  extractHostname(input) {
+    try {
+      if (typeof input === "string") return new URL(input).hostname;
+      if (input instanceof URL) return input.hostname;
+      return new URL(input.url).hostname;
+    } catch {
+      return "";
+    }
+  }
   log(message) {
     if (this.debug) {
       console.log(`[Rely] ${message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rely-net/sdk",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Official SDK for rely.net — monitor your app from the inside",
   "main": "dist/index.js",
   "module": "dist/index.mjs",