@softprobe/web-record 0.1.6 → 0.1.8

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,wBAAwB,EACxB,SAAS,GACV,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC"}

package/dist/otlp.d.ts

@@ -27,10 +27,31 @@ export type BuildRecordingSpanInput = {
     serviceName?: string;
     environment?: string;
 };
+export type BuildClientRequestSpanInput = {
+    traceId: string;
+    spanId: string;
+    sessionId: string;
+    method: string;
+    scheme: string;
+    serverAddress: string;
+    path: string;
+    statusCode: number;
+    failed: boolean;
+    requestBody?: string;
+    responseBody?: string;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    serviceName?: string;
+    environment?: string;
+};
 /** Build an OTLP JSON ExportTraceServiceRequest for one recording flush. */
 export declare function buildRecordingExport(input: BuildRecordingSpanInput): {
     resourceSpans: unknown[];
 };
+/** Build an OTLP client span for an explicitly selected browser API request. */
+export declare function buildClientRequestExport(input: BuildClientRequestSpanInput): {
+    resourceSpans: unknown[];
+};
 export declare function randomHexId(bytes: number): string;
 export declare function msToUnixNano(ms: number): string;
 export { SPAN_NAME, EVENT_NAME, EVENTS_ATTR };

package/dist/otlp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"otlp.d.ts","sourceRoot":"","sources":["../src/otlp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,QAAA,MAAM,SAAS,4BAA4B,CAAC;AAC5C,QAAA,MAAM,UAAU,uBAAuB,CAAC;AACxC,QAAA,MAAM,WAAW,wBAAwB,CAAC;AAE1C,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,WAAW,CAAC;AAEpD,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAyBF,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,uBAAuB,GAAG;IACpE,aAAa,EAAE,OAAO,EAAE,CAAC;CAC1B,CAmDA;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"otlp.d.ts","sourceRoot":"","sources":["../src/otlp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,QAAA,MAAM,SAAS,4BAA4B,CAAC;AAC5C,QAAA,MAAM,UAAU,uBAAuB,CAAC;AACxC,QAAA,MAAM,WAAW,wBAAwB,CAAC;AAE1C,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,WAAW,CAAC;AAEpD,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAyBF,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,uBAAuB,GAAG;IACpE,aAAa,EAAE,OAAO,EAAE,CAAC;CAC1B,CAmDA;AAED,gFAAgF;AAChF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,2BAA2B,GAAG;IAC5E,aAAa,EAAE,OAAO,EAAE,CAAC;CAC1B,CA8CA;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC"}

package/dist/otlp.js

@@ -69,6 +69,54 @@ export function buildRecordingExport(input) {
         ],
     };
 }
+/** Build an OTLP client span for an explicitly selected browser API request. */
+export function buildClientRequestExport(input) {
+    const attrs = [
+        stringAttr("sp.session.id", input.sessionId),
+        stringAttr("http.request.method", input.method),
+        stringAttr("url.scheme", input.scheme),
+        stringAttr("server.address", input.serverAddress),
+        stringAttr("url.path", input.path),
+        intAttr("http.response.status_code", input.statusCode),
+        ...(input.requestBody === undefined
+            ? []
+            : [stringAttr("http.request.body.content", input.requestBody)]),
+        ...(input.responseBody === undefined
+            ? []
+            : [stringAttr("http.response.body.content", input.responseBody)]),
+    ];
+    const resourceAttrs = [];
+    if (input.serviceName)
+        resourceAttrs.push(stringAttr("service.name", input.serviceName));
+    if (input.environment) {
+        resourceAttrs.push(stringAttr("deployment.environment.name", input.environment));
+    }
+    return {
+        resourceSpans: [
+            {
+                resource: { attributes: resourceAttrs },
+                scopeSpans: [
+                    {
+                        scope: { name: "softprobe.web.record", version: "0.1.0" },
+                        spans: [
+                            {
+                                traceId: input.traceId,
+                                spanId: input.spanId,
+                                name: `HTTP ${input.method}`,
+                                kind: 3,
+                                startTimeUnixNano: input.startTimeUnixNano,
+                                endTimeUnixNano: input.endTimeUnixNano,
+                                attributes: attrs,
+                                events: [],
+                                status: { code: input.failed ? 2 : 1 },
+                            },
+                        ],
+                    },
+                ],
+            },
+        ],
+    };
+}
 export function randomHexId(bytes) {
     const buf = new Uint8Array(bytes);
     crypto.getRandomValues(buf);

package/dist/otlp.js.map

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

package/dist/sdk.d.ts

@@ -1,5 +1,5 @@
 import { type eventWithTime } from "@rrweb/types";
-import type { RecordingHandle, Tags, WebRecordController, WebRecordInitOptions } from "./types.js";
+import type { RecordingHandle, RecordingUploadStatus, Tags, WebRecordController, WebRecordInitOptions } from "./types.js";
 type Compressible = eventWithTime & {
     data?: unknown;
     isCompressed?: boolean;
@@ -9,12 +9,17 @@ export declare class RecordSdk implements WebRecordController {
     readonly enabled: boolean;
     private _sessionId;
     private readonly otlpEndpoint;
-    private readonly publicKey;
+    private readonly apiKey;
+    private readonly apiOrigins;
+    private readonly sessionIdStorageKey;
     private readonly intervalMs;
     private readonly serviceName?;
     private readonly environment?;
     private readonly userId?;
     private readonly maskAllInputs;
+    private readonly maskTextSelector?;
+    private readonly blockSelector?;
+    private readonly onUploadStatus?;
     private readonly recordOptions;
     private readonly replacers;
     private tags;
@@ -26,11 +31,22 @@ export declare class RecordSdk implements WebRecordController {
     private systemInfo;
     private stopHandle;
     private saving;
+    private recordingFlush;
+    private readonly pendingClientSpanExports;
+    /** 连续导出失败次数;成功即归零。 */
+    private consecutiveFailures;
+    /** 退避到期时间戳(ms);在此之前定时器不再尝试导出。 */
+    private nextAttemptAt;
+    /** 熔断标志:连败到上限后置位,导出与采集一起停。 */
+    private exportDisabled;
     private fetchImpl;
     /** Serializes setSessionId drains so overlapping navigations cannot race. */
     private sessionSwitch;
+    private _uploadStatus;
+    private readonly onPageHide;
     private constructor();
     get sessionId(): string;
+    get uploadStatus(): RecordingUploadStatus;
     static init(options?: WebRecordInitOptions): WebRecordController;
     record(opts?: {
         tags?: Tags;
@@ -46,7 +62,28 @@ export declare class RecordSdk implements WebRecordController {
      */
     private drainFlush;
     compressEvent(event: Compressible): Compressible;
-    flush(): Promise<boolean>;
+    flush(options?: {
+        keepalive?: boolean;
+    }): Promise<boolean>;
+    private flushRecordingBatch;
+    private flushPendingClientSpanExports;
+    private setUploadStatus;
+    private createRequestSpan;
+    private exportClientRequestSpan;
+    /**
+     * 导出失败后的退避与熔断。
+     *
+     * <p>现场实证(2026-08-25,甲方内网):到不了配置的 collector,原实现每 5 秒把同一批
+     * 事件原样重发,失败 429 次没停过 —— 控制台被刷爆,主线程每轮还白做一次
+     * `JSON.stringify` + 压缩,页面肉眼可见地卡。三条对策:
+     * <ul>
+     *   <li>连败指数退避,不再固定间隔硬打;</li>
+     *   <li>只在连败的<b>第一条</b>打日志,后续静默;</li>
+     *   <li>连败到上限就停掉采集并清空缓冲,再打一条写明端点和处置办法。</li>
+     * </ul>
+     * 单次失败仍然保留缓冲(可能只是网络抖动),这一点不变。
+     */
+    private noteExportFailure;
     private collectSystemInfo;
 }
 export {};

package/dist/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAiB7D,OAAO,KAAK,EACV,eAAe,EAEf,IAAI,EACJ,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAMpB,KAAK,YAAY,GAAG,aAAa,GAAG;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,qBAAa,SAAU,YAAW,mBAAmB;IACnD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,IAAI,CAAO;IACnB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAuD;IACzE,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAe;IAChC,6EAA6E;IAC7E,OAAO,CAAC,aAAa,CAAoC;IAEzD,OAAO;IAgCP,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,MAAM,CAAC,IAAI,CAAC,OAAO,GAAE,oBAAiD,GAAG,mBAAmB;IAsC5F,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,eAAe,GAAG,IAAI;IA2CtD,IAAI,IAAI,IAAI;IAIZ,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,UAAQ,GAAG,IAAI;IAI3C,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAUhC,eAAe;IAQ7B;;;;OAIG;YACW,UAAU;IAcxB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY;IAkB1C,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;YA0DjB,iBAAiB;CAqDhC"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"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"}

package/dist/sdk.js

@@ -1,21 +1,31 @@
 import { EventType } from "@rrweb/types";
 import { pack, record as rrwebRecord } from "rrweb";
 import { asNonEmptyString, deriveOtlpEndpoint, resolveSoftprobeConfigFromObject, MissingSoftprobeCredentialsError, } from "@softprobe/tracing/config";
-import { initializeHttpInterceptor, updateHttpInterceptorSessionId, } from "./http-interceptor.js";
-import { buildRecordingExport, msToUnixNano, randomHexId, } from "./otlp.js";
+import { initializeHttpInterceptor, } from "./http-interceptor.js";
+import { buildClientRequestExport, buildRecordingExport, msToUnixNano, randomHexId, } from "./otlp.js";
 const MAX_EVENTS = 500;
+/** 连续导出失败多少次后彻底放弃采集(见 {@link RecordSdk.noteExportFailure})。 */
+const MAX_CONSECUTIVE_EXPORT_FAILURES = 5;
+/** 退避上限。不可达时不应一直定期打点。 */
+const BACKOFF_MAX_MS = 5 * 60_000;
 const COOKIE_NAME = "_sp_vid";
 const COOKIE_MAX_AGE = 365 * 24 * 60 * 60;
+const SESSION_ID_STORAGE_PREFIX = "_sp_session_id:";
 export class RecordSdk {
     enabled;
     _sessionId;
     otlpEndpoint;
-    publicKey;
+    apiKey;
+    apiOrigins;
+    sessionIdStorageKey;
     intervalMs;
     serviceName;
     environment;
     userId;
     maskAllInputs;
+    maskTextSelector;
+    blockSelector;
+    onUploadStatus;
     recordOptions;
     replacers;
     tags;
@@ -27,19 +37,43 @@ export class RecordSdk {
     systemInfo = null;
     stopHandle = null;
     saving = false;
+    recordingFlush = null;
+    pendingClientSpanExports = new Set();
+    /** 连续导出失败次数;成功即归零。 */
+    consecutiveFailures = 0;
+    /** 退避到期时间戳(ms);在此之前定时器不再尝试导出。 */
+    nextAttemptAt = 0;
+    /** 熔断标志:连败到上限后置位,导出与采集一起停。 */
+    exportDisabled = false;
     fetchImpl;
     /** Serializes setSessionId drains so overlapping navigations cannot race. */
     sessionSwitch = Promise.resolve();
+    _uploadStatus = "idle";
+    onPageHide = () => {
+        if (!this.enabled || (this.events.length === 0 && !this.saving && this.pendingClientSpanExports.size === 0))
+            return;
+        this.setUploadStatus("incomplete");
+        // A keepalive request is best-effort. If an ordinary export is already in
+        // flight, do not duplicate its batch; report it as incomplete until it
+        // resolves or fails.
+        if (!this.saving)
+            void this.flush({ keepalive: true });
+    };
     constructor(options) {
         this.enabled = options.enabled;
-        this.publicKey = options.publicKey ?? "";
+        this.apiKey = options.apiKey ?? options.publicKey ?? "";
+        this.apiOrigins = [...(options.apiOrigins ?? [])];
         this.otlpEndpoint = options.otlpEndpoint;
-        this._sessionId = asNonEmptyString(options.sessionId) ?? uuid();
+        this.sessionIdStorageKey = `${SESSION_ID_STORAGE_PREFIX}${options.serviceName ?? "default"}`;
+        this._sessionId = getOrCreateSessionId(options.sessionId, this.sessionIdStorageKey);
         this.intervalMs = Math.max(options.interval ?? 5000, 5000);
         this.serviceName = options.serviceName;
         this.environment = options.environment;
         this.userId = options.userId;
         this.maskAllInputs = options.maskAllInputs !== false;
+        this.maskTextSelector = options.maskTextSelector;
+        this.blockSelector = options.blockSelector;
+        this.onUploadStatus = options.onUploadStatus;
         this.recordOptions = options.recordOptions ?? {};
         this.replacers = options.replacers ?? {};
         this.tags = { ...(options.tags ?? {}) };
@@ -53,7 +87,11 @@ export class RecordSdk {
                     throw new Error("fetch is not available");
                 });
         if (this.enabled) {
-            initializeHttpInterceptor(() => this._sessionId);
+            initializeHttpInterceptor({
+                apiOrigins: this.apiOrigins,
+                httpBodyCapture: options.httpBodyCapture,
+                createRequestSpan: (method, url) => this.createRequestSpan(method, url),
+            });
             if (!options.manual) {
                 this.record();
             }
@@ -62,11 +100,14 @@ export class RecordSdk {
     get sessionId() {
         return this._sessionId;
     }
+    get uploadStatus() {
+        return this._uploadStatus;
+    }
     static init(options = {}) {
         const softDisable = options.softDisable !== false;
         try {
             const resolved = resolveSoftprobeConfigFromObject({
-                publicKey: options.publicKey,
+                publicKey: options.apiKey ?? options.publicKey,
                 baseUrl: options.baseUrl,
                 otlpEndpoint: options.otlpEndpoint,
                 environment: options.environment,
@@ -101,13 +142,22 @@ export class RecordSdk {
     record(opts) {
         if (!this.enabled)
             return null;
+        // 熔断后不再重新武装。宿主(SPA)每次路由变化都会调 record(),不挡住的话
+        // 每导航一次就白起一轮 rrweb 采集,下一个 tick 再自己停掉。
+        if (this.exportDisabled)
+            return null;
         if (this.stopHandle)
             return this.stopHandle;
         if (opts?.tags)
             this.setTags(opts.tags);
+        if (typeof window !== "undefined") {
+            window.addEventListener("pagehide", this.onPageHide);
+        }
         const stopFn = rrwebRecord({
             maskAllInputs: this.maskAllInputs,
             ...this.recordOptions,
+            ...(this.maskTextSelector ? { maskTextSelector: this.maskTextSelector } : {}),
+            ...(this.blockSelector ? { blockSelector: this.blockSelector } : {}),
             emit: (raw) => {
                 const event = raw;
                 if (this.events.length >= MAX_EVENTS)
@@ -120,6 +170,14 @@ export class RecordSdk {
             },
         });
         const intervalId = setInterval(() => {
+            // 熔断后连采集一起停:导出不出去还继续录,只是白耗主线程和内存。
+            if (this.exportDisabled) {
+                this.stop();
+                return;
+            }
+            // 退避未到,这轮跳过。这里刻意不打日志——日志本身就是故障放大器。
+            if (Date.now() < this.nextAttemptAt)
+                return;
             void this.flush();
             if (this.events.length) {
                 const last = this.events[this.events.length - 1];
@@ -133,6 +191,9 @@ export class RecordSdk {
         this.stopHandle = {
             stop: () => {
                 clearInterval(intervalId);
+                if (typeof window !== "undefined") {
+                    window.removeEventListener("pagehide", this.onPageHide);
+                }
                 stopFn?.();
                 void this.flush();
                 this.stopHandle = null;
@@ -159,8 +220,13 @@ export class RecordSdk {
     async switchSessionId(next) {
         await this.drainFlush();
         this._sessionId = next;
-        if (this.enabled) {
-            updateHttpInterceptorSessionId(() => this._sessionId);
+        try {
+            if (typeof sessionStorage !== "undefined") {
+                sessionStorage.setItem(this.sessionIdStorageKey, next);
+            }
+        }
+        catch {
+            // Storage can be unavailable in restricted browser contexts.
         }
     }
     /**
@@ -202,10 +268,35 @@ export class RecordSdk {
         }
         return event;
     }
-    async flush() {
-        if (!this.enabled || this.events.length === 0 || this.saving)
+    async flush(options = {}) {
+        if (this.exportDisabled)
+            return false;
+        if (!this.enabled)
             return true;
+        let recordingResult = true;
+        if (this.saving) {
+            recordingResult = await (this.recordingFlush ?? Promise.resolve(true));
+        }
+        else if (this.events.length > 0) {
+            const recordingFlush = this.flushRecordingBatch(options);
+            this.recordingFlush = recordingFlush;
+            try {
+                recordingResult = await recordingFlush;
+            }
+            finally {
+                if (this.recordingFlush === recordingFlush)
+                    this.recordingFlush = null;
+            }
+        }
+        const clientSpansResult = await this.flushPendingClientSpanExports();
+        return recordingResult && clientSpansResult;
+    }
+    async flushRecordingBatch(options) {
+        if (this.exportDisabled || !this.enabled || this.events.length === 0)
+            return !this.exportDisabled;
         this.saving = true;
+        if (!options.keepalive)
+            this.setUploadStatus("pending");
         // Splice out the batch BEFORE await so events recorded while export is in
         // flight stay in `this.events` and are not dropped on success.
         const batch = this.events.splice(0, this.events.length);
@@ -239,26 +330,160 @@ export class RecordSdk {
                 method: "POST",
                 headers: {
                     "Content-Type": "application/json",
-                    Authorization: `Bearer ${this.publicKey}`,
+                    Authorization: `Bearer ${this.apiKey}`,
                 },
                 body: JSON.stringify(body),
                 redirect: "follow",
+                ...(options.keepalive ? { keepalive: true } : {}),
             });
             if (!res.ok) {
                 throw new Error(`OTLP export failed: ${res.status} ${await res.text()}`);
             }
             this.batchIndex = batchIndex + 1;
+            this.consecutiveFailures = 0;
+            this.nextAttemptAt = 0;
+            this.setUploadStatus("uploaded");
             return true;
         }
         catch (error) {
-            console.error("[@softprobe/web-record] Failed to flush recording:", error);
             this.events.unshift(...batch);
+            this.setUploadStatus("failed");
+            this.noteExportFailure(error);
             return false;
         }
         finally {
             this.saving = false;
         }
     }
+    async flushPendingClientSpanExports() {
+        let succeeded = true;
+        while (this.pendingClientSpanExports.size > 0) {
+            const batch = [...this.pendingClientSpanExports];
+            const results = await Promise.all(batch);
+            succeeded = results.every(Boolean) && succeeded;
+        }
+        return succeeded;
+    }
+    setUploadStatus(status) {
+        this._uploadStatus = status;
+        try {
+            this.onUploadStatus?.(status);
+        }
+        catch {
+            // Application status rendering must not interrupt recording or export.
+        }
+    }
+    createRequestSpan(method, rawUrl) {
+        let url;
+        try {
+            url = new URL(rawUrl, typeof location !== "undefined" ? location.href : undefined);
+            const endpoint = new URL(this.otlpEndpoint);
+            // Exclude only the collector endpoint itself. An application may use a
+            // same-origin gateway for its own API and telemetry ingestion.
+            if (url.origin === endpoint.origin && url.pathname === endpoint.pathname)
+                return null;
+        }
+        catch {
+            return null;
+        }
+        const traceId = randomHexId(16);
+        const spanId = randomHexId(8);
+        const sessionId = this._sessionId;
+        const startMs = Date.now();
+        let finished = false;
+        let resolveCompletion;
+        const completion = new Promise((resolve) => { resolveCompletion = resolve; });
+        this.pendingClientSpanExports.add(completion);
+        void completion.finally(() => this.pendingClientSpanExports.delete(completion));
+        return {
+            traceparent: `00-${traceId}-${spanId}-01`,
+            finish: (statusCode, error, bodies) => {
+                if (finished)
+                    return;
+                finished = true;
+                const endMs = Date.now();
+                try {
+                    const body = buildClientRequestExport({
+                        traceId,
+                        spanId,
+                        sessionId,
+                        method,
+                        scheme: url.protocol.slice(0, -1),
+                        serverAddress: url.hostname,
+                        path: url.pathname,
+                        statusCode,
+                        failed: Boolean(error) || statusCode >= 500,
+                        requestBody: bodies?.requestBody,
+                        responseBody: bodies?.responseBody,
+                        startTimeUnixNano: msToUnixNano(startMs),
+                        endTimeUnixNano: msToUnixNano(endMs),
+                        serviceName: this.serviceName,
+                        environment: this.environment,
+                    });
+                    void this.exportClientRequestSpan(body).then(resolveCompletion, () => resolveCompletion(false));
+                }
+                catch {
+                    resolveCompletion(false);
+                }
+            },
+        };
+    }
+    async exportClientRequestSpan(body) {
+        this.setUploadStatus("pending");
+        try {
+            const response = await this.fetchImpl(this.otlpEndpoint, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify(body),
+                redirect: "follow",
+                // Client spans close with the application request and are often
+                // exported immediately before a full-page navigation.
+                keepalive: true,
+            });
+            if (!response.ok)
+                throw new Error(`OTLP export failed: ${response.status}`);
+            this.setUploadStatus("uploaded");
+            return true;
+        }
+        catch {
+            this.setUploadStatus("failed");
+            return false;
+        }
+    }
+    /**
+     * 导出失败后的退避与熔断。
+     *
+     * <p>现场实证(2026-08-25,甲方内网):到不了配置的 collector,原实现每 5 秒把同一批
+     * 事件原样重发,失败 429 次没停过 —— 控制台被刷爆,主线程每轮还白做一次
+     * `JSON.stringify` + 压缩,页面肉眼可见地卡。三条对策:
+     * <ul>
+     *   <li>连败指数退避,不再固定间隔硬打;</li>
+     *   <li>只在连败的<b>第一条</b>打日志,后续静默;</li>
+     *   <li>连败到上限就停掉采集并清空缓冲,再打一条写明端点和处置办法。</li>
+     * </ul>
+     * 单次失败仍然保留缓冲(可能只是网络抖动),这一点不变。
+     */
+    noteExportFailure(error) {
+        this.consecutiveFailures += 1;
+        if (this.consecutiveFailures === 1) {
+            console.error("[@softprobe/web-record] Failed to flush recording:", error);
+        }
+        if (this.consecutiveFailures >= MAX_CONSECUTIVE_EXPORT_FAILURES) {
+            this.exportDisabled = true;
+            this.events.length = 0;
+            console.error(`[@softprobe/web-record] Giving up after ${this.consecutiveFailures} ` +
+                `consecutive export failures; session recording disabled. ` +
+                `Endpoint: ${this.otlpEndpoint}. On a closed network, point ` +
+                `SOFTPROBE_BASE_URL at a reachable collector or disable web recording.`);
+            return;
+        }
+        this.nextAttemptAt =
+            Date.now() +
+                Math.min(BACKOFF_MAX_MS, this.intervalMs * 2 ** (this.consecutiveFailures - 1));
+    }
     async collectSystemInfo() {
         let ua = "";
         let os = "Unknown";
@@ -314,6 +539,27 @@ function uuid() {
             (crypto.getRandomValues(new Uint8Array(1))[0] & (15 >> (n / 4)))).toString(16);
     });
 }
+function getOrCreateSessionId(candidate, storageKey) {
+    const provided = asNonEmptyString(candidate);
+    try {
+        if (typeof sessionStorage !== "undefined") {
+            if (provided) {
+                sessionStorage.setItem(storageKey, provided);
+                return provided;
+            }
+            const stored = asNonEmptyString(sessionStorage.getItem(storageKey));
+            if (stored)
+                return stored;
+            const generated = uuid();
+            sessionStorage.setItem(storageKey, generated);
+            return generated;
+        }
+    }
+    catch {
+        // sessionStorage may throw for blocked or opaque origins; use an in-memory ID.
+    }
+    return provided ?? uuid();
+}
 function getOrCreateVisitorId() {
     if (typeof document === "undefined")
         return uuid();