reroute-js 0.38.3 → 0.40.0

package/telemetry/src/react/api.d.ts

@@ -1,5 +1,5 @@
 /**
- * reroute-js v0.38.3
+ * reroute-js v0.40.0
  *
  * @license MIT
  * @copyright 2025 stewones <hi@stewan.io>

package/telemetry/src/react/context.d.ts

@@ -1,5 +1,5 @@
 /**
- * reroute-js v0.38.3
+ * reroute-js v0.40.0
  *
  * @license MIT
  * @copyright 2025 stewones <hi@stewan.io>

package/telemetry/src/react/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * reroute-js v0.38.3
+ * reroute-js v0.40.0
  *
  * @license MIT
  * @copyright 2025 stewones <hi@stewan.io>

package/telemetry/src/react/telemetry.d.ts

@@ -1,5 +1,5 @@
 /**
- * reroute-js v0.38.3
+ * reroute-js v0.40.0
  *
  * @license MIT
  * @copyright 2025 stewones <hi@stewan.io>

package/telemetry/src/server/context.d.ts

@@ -1,5 +1,5 @@
 /**
- * reroute-js v0.38.3
+ * reroute-js v0.40.0
  *
  * @license MIT
  * @copyright 2025 stewones <hi@stewan.io>

package/telemetry/src/server/headers/extractor.d.ts

@@ -0,0 +1,32 @@
+/**
+ * reroute-js v0.40.0
+ *
+ * @license MIT
+ * @copyright 2025 stewones <hi@stewan.io>
+ * @see https://github.com/stewones/reroute
+ *
+ * Built with Bun <3
+ */
+import type { HeaderMapping } from './presets';
+/**
+ * Extract headers from request and map them to telemetry attributes
+ *
+ * Takes an array of header mappings and extracts the corresponding values
+ * from the request headers, returning them as a flat object suitable for
+ * adding to telemetry spans/logs.
+ *
+ * @param headers - Request headers (Headers object or plain object)
+ * @param mappings - Array of header-to-attribute mappings
+ * @returns Object with extracted attributes (only includes headers that exist)
+ *
+ * @example
+ * ```typescript
+ * const attrs = extractHeaders(request.headers, [
+ *   { header: 'cf-ipcountry', as: 'geo.country' },
+ *   { header: 'cf-ipcity', as: 'geo.city' },
+ * ]);
+ * // Returns: { 'geo.country': 'US', 'geo.city': 'San Francisco' }
+ * ```
+ */
+export declare function extractHeaders(headers: Headers | Record<string, string | undefined>, mappings: HeaderMapping[]): Record<string, string>;
+//# sourceMappingURL=extractor.d.ts.map

package/telemetry/src/server/headers/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../../../../../packages/telemetry/src/server/headers/extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC7B,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACrD,QAAQ,EAAE,aAAa,EAAE,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBxB"}

package/telemetry/src/server/headers/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * reroute-js v0.40.0
+ *
+ * @license MIT
+ * @copyright 2025 stewones <hi@stewan.io>
+ * @see https://github.com/stewones/reroute
+ *
+ * Built with Bun <3
+ */
+export * from './extractor';
+export * from './presets';
+//# sourceMappingURL=index.d.ts.map

package/telemetry/src/server/headers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../packages/telemetry/src/server/headers/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/telemetry/src/server/headers/presets.d.ts

@@ -0,0 +1,134 @@
+/**
+ * reroute-js v0.40.0
+ *
+ * @license MIT
+ * @copyright 2025 stewones <hi@stewan.io>
+ * @see https://github.com/stewones/reroute
+ *
+ * Built with Bun <3
+ */
+/**
+ * Header mapping presets for common CDN and proxy providers
+ *
+ * These presets provide ready-to-use header mappings for extracting
+ * geolocation and request metadata from popular services like Cloudflare.
+ */
+/**
+ * Header mapping type
+ */
+type HeaderMapping = {
+    header: string;
+    as: string;
+};
+/**
+ * Reroute default header presets
+ *
+ * Common HTTP headers that are useful for telemetry and debugging.
+ * These work with any HTTP server/proxy setup.
+ */
+declare class RerouteHeaders {
+    /**
+     * Standard HTTP headers
+     *
+     * Captures commonly used HTTP headers for request tracking and debugging.
+     *
+     * Captured attributes:
+     * - `http.user_agent` - User-Agent header
+     * - `http.referer` - Referer header (where the request came from)
+     * - `http.accept_language` - Accept-Language header (user's language preferences)
+     * - `http.accept_encoding` - Accept-Encoding header (supported compression)
+     *
+     * @example
+     * ```typescript
+     * import { RerouteHeaders } from 'reroute-js/telemetry/server';
+     *
+     * telemetry: {
+     *   capture: [
+     *     ...RerouteHeaders.http(),
+     *   ]
+     * }
+     * ```
+     */
+    static http(): HeaderMapping[];
+    /**
+     * Request tracking headers
+     *
+     * Captures headers commonly used for distributed tracing and request correlation.
+     *
+     * Captured attributes:
+     * - `request.id` - X-Request-ID header (unique request identifier)
+     * - `request.correlation_id` - X-Correlation-ID header (correlation across services)
+     * - `request.forwarded_for` - X-Forwarded-For header (original client IP through proxies)
+     * - `request.real_ip` - X-Real-IP header (client's real IP address)
+     *
+     * @example
+     * ```typescript
+     * import { RerouteHeaders } from 'reroute-js/telemetry/server';
+     *
+     * telemetry: {
+     *   capture: [
+     *     ...RerouteHeaders.request(),
+     *   ]
+     * }
+     * ```
+     */
+    static request(): HeaderMapping[];
+    /**
+     * All Reroute default headers
+     *
+     * Combines http() and request() for comprehensive request metadata.
+     *
+     * @example
+     * ```typescript
+     * import { RerouteHeaders } from 'reroute-js/telemetry/server';
+     *
+     * telemetry: {
+     *   capture: [
+     *     ...RerouteHeaders.all(),
+     *   ]
+     * }
+     * ```
+     */
+    static all(): HeaderMapping[];
+}
+/**
+ * Cloudflare header presets
+ *
+ * Cloudflare adds geolocation and request metadata headers when proxying requests.
+ * These presets extract that information into structured telemetry attributes.
+ *
+ * @see https://developers.cloudflare.com/fundamentals/reference/http-request-headers/
+ */
+declare class CloudflareHeaders {
+    /**
+     * Cloudflare geolocation headers
+     *
+     * Extracts IP address and geographic location data from Cloudflare headers.
+     * Available when your app is behind Cloudflare's proxy.
+     *
+     * Captured attributes:
+     * - `geo.ip` - Client IP address
+     * - `geo.country` - ISO 3166-1 Alpha 2 country code
+     * - `geo.city` - City name
+     * - `geo.region` - Region/state name
+     * - `geo.region_code` - ISO 3166-2 region code
+     * - `geo.continent` - Continent code (e.g., NA, EU, AS)
+     * - `geo.timezone` - IANA timezone (e.g., America/Los_Angeles)
+     * - `geo.postal_code` - Postal/ZIP code
+     * - `geo.metro_code` - Metro code (US only)
+     *
+     * @example
+     * ```typescript
+     * import { CloudflareHeaders } from 'reroute-js/telemetry/server';
+     *
+     * telemetry: {
+     *   capture: [
+     *     ...CloudflareHeaders.geo(),
+     *   ]
+     * }
+     * ```
+     */
+    static geo(): HeaderMapping[];
+}
+export { RerouteHeaders, CloudflareHeaders, type HeaderMapping };
+//# sourceMappingURL=presets.d.ts.map

package/telemetry/src/server/headers/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../../../../../packages/telemetry/src/server/headers/presets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,KAAK,aAAa,GAAG;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACX,CAAC;AAEF;;;;;GAKG;AAEH,cAAM,cAAc;IACnB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,IAAI,IAAI,aAAa,EAAE;IAS9B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,OAAO,IAAI,aAAa,EAAE;IASjC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,GAAG,IAAI,aAAa,EAAE;CAG7B;AAED;;;;;;;GAOG;AAEH,cAAM,iBAAiB;IACtB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,GAAG,IAAI,aAAa,EAAE;CAa7B;AAED,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,CAAC"}

package/telemetry/src/server/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * reroute-js v0.38.3
+ * reroute-js v0.40.0
  *
  * @license MIT
  * @copyright 2025 stewones <hi@stewan.io>
@@ -8,6 +8,7 @@
  * Built with Bun <3
  */
 export * from './context';
+export * from './headers';
 export * from './instrumentation';
 export * from './plugin';
 export * from './sourcemap';

package/telemetry/src/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/telemetry/src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/telemetry/src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/telemetry/src/server/instrumentation.d.ts

@@ -1,5 +1,5 @@
 /**
- * reroute-js v0.38.3
+ * reroute-js v0.40.0
  *
  * @license MIT
  * @copyright 2025 stewones <hi@stewan.io>

package/telemetry/src/server/plugin.d.ts

@@ -1,5 +1,5 @@
 /**
- * reroute-js v0.38.3
+ * reroute-js v0.40.0
  *
  * @license MIT
  * @copyright 2025 stewones <hi@stewan.io>

package/telemetry/src/server/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../../packages/telemetry/src/server/plugin.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKpE;;;;GAIG;AACH,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;CAAG;AAoEnE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,sBAA2B,IAE/C,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;IAg9BzB"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../../../packages/telemetry/src/server/plugin.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMpE;;;;GAIG;AACH,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;CAAG;AAoEnE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,sBAA2B,IAE/C,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;IAo9BzB"}

package/telemetry/src/server/sourcemap.d.ts

@@ -1,5 +1,5 @@
 /**
- * reroute-js v0.38.3
+ * reroute-js v0.40.0
  *
  * @license MIT
  * @copyright 2025 stewones <hi@stewan.io>