@obtrace/browser 1.0.0

package/dist/types/shared/utils.d.ts

@@ -0,0 +1,21 @@
+export declare function nowUnixNano(): string;
+export declare function hex(bytes: Uint8Array): string;
+export declare function randomHex(lenBytes: number): string;
+export declare function toBase64(input: string): string;
+export declare function truncate(input: string, max: number): string;
+export declare function safeJson(value: unknown): string;
+export declare function sanitizeHeaders(headers: Record<string, string> | Headers | undefined): Record<string, string>;
+export declare function stripQuery(url: string): string;
+export declare function createTraceparent(traceId?: string, spanId?: string): string;
+export declare function parseTraceparent(value: string | null | undefined): {
+    traceId: string;
+    parentSpanId: string;
+    flags: string;
+} | null;
+export interface PropagationHeaders {
+    traceId?: string;
+    parentSpanId?: string;
+    traceState?: string;
+    baggage?: string;
+}
+export declare function extractPropagation(headers?: HeadersInit): PropagationHeaders;

package/dist/types/sourcemaps.d.ts

@@ -0,0 +1,14 @@
+export interface SourceMapUploadOptions {
+    apiKey: string;
+    ingestBaseUrl: string;
+    release: string;
+    files: Array<{
+        url: string;
+        sourcemap: string;
+        source?: string;
+    }>;
+}
+export declare function uploadSourceMaps(options: SourceMapUploadOptions): Promise<{
+    uploaded: number;
+    errors: string[];
+}>;

package/dist/types/wrappers/frontend/next.d.ts

@@ -0,0 +1,4 @@
+import type { ObtraceSDKConfig } from "../../shared/types";
+import { initBrowserSDK } from "../../browser/index";
+export declare function initNextBrowserSDK(config: ObtraceSDKConfig): import("./react").BrowserSDK;
+export declare function withNextFetchInstrumentation(fetchImpl: typeof fetch, _sdk: ReturnType<typeof initBrowserSDK>): typeof fetch;

package/dist/types/wrappers/frontend/react.d.ts

@@ -0,0 +1,8 @@
+import type { ObtraceSDKConfig, SDKContext } from "../../shared/types";
+import { type BrowserSDK } from "../../browser/index";
+export declare function obtrace(config: ObtraceSDKConfig): BrowserSDK;
+export declare function getObtrace(): BrowserSDK | null;
+export declare function obtraceLog(level: "debug" | "info" | "warn" | "error" | "fatal", message: string, context?: SDKContext): void;
+export declare function obtraceMetric(name: string, value: number, unit?: string, context?: SDKContext): void;
+export declare function obtraceError(error: unknown, context?: SDKContext): void;
+export type { BrowserSDK, ObtraceSDKConfig, SDKContext };

package/dist/types/wrappers/frontend/vite.d.ts

@@ -0,0 +1,5 @@
+import type { ObtraceSDKConfig } from "../../shared/types";
+export declare function initViteBrowserSDK(config: ObtraceSDKConfig): import("./react").BrowserSDK;
+export declare function createViteConfigFromImportMetaEnv(env: Record<string, string | undefined>, base: Omit<ObtraceSDKConfig, "apiKey" | "ingestBaseUrl" | "serviceName"> & {
+    serviceName?: string;
+}): ObtraceSDKConfig;

package/dist/wrappers/frontend/next.js

@@ -0,0 +1,12 @@
+import { initBrowserSDK } from "../../browser/index";
+export function initNextBrowserSDK(config) {
+    return initBrowserSDK(config);
+}
+export function withNextFetchInstrumentation(fetchImpl, _sdk) {
+    return async (input, init) => {
+        if (typeof window !== "undefined") {
+            return fetch(input, init);
+        }
+        return fetchImpl(input, init);
+    };
+}

package/dist/wrappers/frontend/react.js

@@ -0,0 +1,20 @@
+import { initBrowserSDK } from "../../browser/index";
+let _sdk = null;
+export function obtrace(config) {
+    if (_sdk)
+        return _sdk;
+    _sdk = initBrowserSDK(config);
+    return _sdk;
+}
+export function getObtrace() {
+    return _sdk;
+}
+export function obtraceLog(level, message, context) {
+    _sdk?.log(level, message, context);
+}
+export function obtraceMetric(name, value, unit, context) {
+    _sdk?.metric(name, value, unit, context);
+}
+export function obtraceError(error, context) {
+    _sdk?.captureException(error, context);
+}

package/dist/wrappers/frontend/vite.js

@@ -0,0 +1,19 @@
+import { initBrowserSDK } from "../../browser/index";
+export function initViteBrowserSDK(config) {
+    return initBrowserSDK(config);
+}
+export function createViteConfigFromImportMetaEnv(env, base) {
+    const apiKey = env.VITE_OBTRACE_API_KEY ?? "";
+    const ingestBaseUrl = env.VITE_OBTRACE_INGEST_BASE_URL ?? "";
+    const serviceName = base.serviceName ?? env.VITE_OBTRACE_SERVICE_NAME ?? "vite-app";
+    return {
+        ...base,
+        apiKey,
+        ingestBaseUrl,
+        serviceName,
+        tenantId: base.tenantId ?? env.VITE_OBTRACE_TENANT_ID,
+        projectId: base.projectId ?? env.VITE_OBTRACE_PROJECT_ID,
+        appId: base.appId ?? env.VITE_OBTRACE_APP_ID,
+        env: base.env ?? env.MODE ?? env.VITE_OBTRACE_ENV ?? "dev"
+    };
+}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@obtrace/browser",
+  "version": "1.0.0",
+  "description": "Obtrace Browser SDK with frontend wrappers",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./auto": {
+      "types": "./dist/types/auto.d.ts",
+      "import": "./dist/auto.js"
+    },
+    "./react": {
+      "types": "./dist/types/wrappers/frontend/react.d.ts",
+      "import": "./dist/wrappers/frontend/react.js"
+    },
+    "./sourcemaps": {
+      "types": "./dist/types/sourcemaps.d.ts",
+      "import": "./dist/sourcemaps.js"
+    },
+    "./browser": {
+      "types": "./dist/types/browser_entry.d.ts",
+      "import": "./dist/browser_entry.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "auto": [
+        "./dist/types/auto.d.ts"
+      ],
+      "react": [
+        "./dist/types/wrappers/frontend/react.d.ts"
+      ],
+      "sourcemaps": [
+        "./dist/types/sourcemaps.d.ts"
+      ],
+      "browser": [
+        "./dist/types/browser_entry.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node esbuild.config.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --import tsx --test test/*.test.ts"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "esbuild": "^0.27.4",
+    "tsx": "^4.20.5",
+    "typescript": "^6.0.2"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/context-zone": "^1.30.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.57.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.57.0",
+    "@opentelemetry/instrumentation-document-load": "^0.43.0",
+    "@opentelemetry/instrumentation-fetch": "^0.57.0",
+    "@opentelemetry/instrumentation-user-interaction": "^0.43.0",
+    "@opentelemetry/instrumentation-xml-http-request": "^0.57.0",
+    "@opentelemetry/resources": "^1.30.0",
+    "@opentelemetry/sdk-metrics": "^1.30.0",
+    "@opentelemetry/sdk-trace-web": "^1.30.0",
+    "@opentelemetry/semantic-conventions": "^1.30.0",
+    "@rrweb/types": "^2.0.0-alpha.17",
+    "rrweb": "^2.0.0-alpha.17"
+  }
+}