@be-link/cls-logger 1.0.1-beta.5 → 1.0.1-beta.7

package/dist/ClsLogger.d.ts

@@ -1,110 +1,11 @@
-import type { ClsLoggerInitOptions, FlatFields, PutOptions, QueueItem, ReportLog } from './types';
-export declare class ClsLogger {
-    private sdk;
-    private sdkPromise;
-    private client;
-    private clientPromise;
-    private topicId;
-    private endpoint;
-    private retryTimes;
-    private source;
-    private projectId;
-    private projectName;
-    private appId;
-    private appVersion;
-    private envType;
-    private userGenerateBaseFields;
-    private autoGenerateBaseFields;
-    private storageKey;
-    private batchSize;
-    private memoryQueue;
-    private batchMaxSize;
-    private batchIntervalMs;
-    private batchTimer;
-    private batchTimerDueAt;
-    private initTs;
-    private startupDelayMs;
-    private failedCacheKey;
-    private failedCacheMax;
-    private requestMonitorStarted;
-    private errorMonitorStarted;
-    private performanceMonitorStarted;
-    private behaviorMonitorStarted;
-    private behaviorMonitorCleanup;
-    userId: unknown;
-    userName: unknown;
-    init(options: ClsLoggerInitOptions): void;
-    private getBaseFields;
-    private startRequestMonitor;
-    private startErrorMonitor;
-    private startPerformanceMonitor;
-    private startBehaviorMonitor;
-    /**
-     * 停止行为埋点监听（PV/UV/点击）
-     * - 如需重启：可再次调用 init（或自行调用 init 后的默认启动逻辑）
-     */
-    stopBehaviorMonitor(): void;
-    /**
-     * 获取 CLS client（按环境懒加载 SDK）
-     * - browser: 优先走 UMD 全局变量 `tencentcloudClsSdkJsWeb`
-     * - miniprogram: 优先走 require（webpack/taro 可解析），否则 fallback import()
-     */
-    getInstance(): Promise<{
-        PutLogs: (request: unknown) => Promise<unknown> | unknown;
-    }>;
-    private loadSdk;
-    private detectEnvType;
-    /**
-     * 直接上报：埋点入参必须是一维（扁平）Object
-     * - 非原始值（对象/数组等）会被自动 stringify 成 string
-     * - 最终会把 fields 展开成 CLS 的 content（key/value 都会转成 string）
-     */
-    put(fields: FlatFields, options?: PutOptions): void;
-    private putAsync;
-    /**
-     * 直接上报：把 data 序列化后放入指定 key（默认 “日志内容”）
-     */
-    putJson(data: unknown, clsLoggerKey?: string, options?: PutOptions): void;
-    /**
-     * 入队：写入 localStorage 队列；达到 batchSize 自动 flush
-     * - 埋点入参必须是一维（扁平）Object，非原始值会被 stringify
-     */
-    enqueue(fields: FlatFields, options?: PutOptions): void;
-    /**
-     * 从 localStorage 读取队列并批量上报
-     */
-    flush(): void;
-    /**
-     * 批量上报（每条 item.data 展开为 log content）
-     */
-    putBatch(queue: QueueItem[]): void;
-    private putBatchAsync;
-    /**
-     * 参考《一、概述》：统一上报入口（内存队列 + 批量发送）
-     */
-    report(log: ReportLog): void;
-    private getDesiredBatchFlushDueAt;
-    info(message: string, data?: FlatFields): void;
-    warn(message: string, data?: FlatFields): void;
-    error(message: string, data?: FlatFields): void;
-    track(trackType: string, data?: FlatFields): void;
-    /**
-     * 立即发送内存队列
-     */
-    flushBatch(): Promise<void>;
-    private buildReportFields;
-    private sendReportLogs;
-    private retrySendReportLogs;
-    private cacheFailedReportLogs;
-    flushFailed(): void;
-    /**
-     * 统计/计数类日志：按字段展开上报（若 data 为空默认 1）
-     */
-    stat(param: {
-        pageName: string;
-        scene: string;
-        subScene: string;
-        data?: number | string;
-    }): void;
+import { ClsLoggerCore } from './ClsLoggerCore';
+import type { ClsSdkModule } from './clsSdkTypes';
+/**
+ * 兼容版 ClsLogger（默认入口）
+ * - 保留了自动识别环境 + 动态 import 的逻辑
+ * - 如果业务想瘦身，建议改用 @be-link/cls-logger/web 或 /mini
+ */
+export declare class ClsLogger extends ClsLoggerCore {
+    protected loadSdk(): Promise<ClsSdkModule>;
 }
 //# sourceMappingURL=ClsLogger.d.ts.map

package/dist/ClsLogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClsLogger.d.ts","sourceRoot":"","sources":["../src/ClsLogger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ClsLogger.d.ts","sourceRoot":"","sources":["../src/ClsLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,aAAa;cAC1B,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;CA8EjD"}

package/dist/ClsLoggerCore.d.ts

@@ -0,0 +1,127 @@
+import type { ClsLoggerInitOptions, EnvType, FlatFields, PutOptions, QueueItem, ReportLog } from './types';
+import type { ClsSdkModule } from './clsSdkTypes';
+/**
+ * CLS Logger 核心基类
+ * - 负责所有上报、队列、监控逻辑
+ * - 不包含具体的 SDK 加载实现（由子类负责）
+ * - 这样可以把 web/mini 的 SDK 依赖彻底解耦到子入口
+ */
+export declare abstract class ClsLoggerCore {
+    protected sdk: ClsSdkModule | null;
+    protected sdkPromise: Promise<ClsSdkModule> | null;
+    protected sdkOverride: unknown | null;
+    protected sdkLoaderOverride: (() => unknown | Promise<unknown>) | null;
+    protected client: {
+        PutLogs: (request: unknown) => Promise<unknown> | unknown;
+    } | null;
+    protected clientPromise: Promise<{
+        PutLogs: (request: unknown) => Promise<unknown> | unknown;
+    }> | null;
+    protected topicId: string | null;
+    protected endpoint: string;
+    protected retryTimes: number;
+    protected source: string;
+    protected projectId: string;
+    protected projectName: string;
+    protected appId: string;
+    protected appVersion: string;
+    protected envType: EnvType;
+    protected userGenerateBaseFields: (() => FlatFields) | null;
+    protected autoGenerateBaseFields: (() => FlatFields) | null;
+    protected storageKey: string;
+    protected batchSize: number;
+    protected memoryQueue: ReportLog[];
+    protected batchMaxSize: number;
+    protected batchIntervalMs: number;
+    protected batchTimer: ReturnType<typeof setTimeout> | null;
+    protected batchTimerDueAt: number | null;
+    protected initTs: number;
+    protected startupDelayMs: number;
+    protected failedCacheKey: string;
+    protected failedCacheMax: number;
+    protected requestMonitorStarted: boolean;
+    protected errorMonitorStarted: boolean;
+    protected performanceMonitorStarted: boolean;
+    protected behaviorMonitorStarted: boolean;
+    protected behaviorMonitorCleanup: (() => void) | null;
+    userId: unknown;
+    userName: unknown;
+    /**
+     * 子类必须实现此方法来加载 SDK
+     */
+    protected abstract loadSdk(): Promise<ClsSdkModule>;
+    /**
+     * 子类可按需重写（默认检测 wx）
+     */
+    protected detectEnvType(): EnvType;
+    init(options: ClsLoggerInitOptions): void;
+    private getBaseFields;
+    private startRequestMonitor;
+    private startErrorMonitor;
+    private startPerformanceMonitor;
+    private startBehaviorMonitor;
+    /**
+     * 停止行为埋点监听（PV/UV/点击）
+     * - 如需重启：可再次调用 init（或自行调用 init 后的默认启动逻辑）
+     */
+    stopBehaviorMonitor(): void;
+    /**
+     * 获取 CLS client（按环境懒加载 SDK）
+     */
+    getInstance(): Promise<{
+        PutLogs: (request: unknown) => Promise<unknown> | unknown;
+    }>;
+    /**
+     * 直接上报：埋点入参必须是一维（扁平）Object
+     * - 非原始值（对象/数组等）会被自动 stringify 成 string
+     * - 最终会把 fields 展开成 CLS 的 content（key/value 都会转成 string）
+     */
+    put(fields: FlatFields, options?: PutOptions): void;
+    private putAsync;
+    /**
+     * 直接上报：把 data 序列化后放入指定 key（默认 “日志内容”）
+     */
+    putJson(data: unknown, clsLoggerKey?: string, options?: PutOptions): void;
+    /**
+     * 入队：写入 localStorage 队列；达到 batchSize 自动 flush
+     * - 埋点入参必须是一维（扁平）Object，非原始值会被 stringify
+     */
+    enqueue(fields: FlatFields, options?: PutOptions): void;
+    /**
+     * 从 localStorage 读取队列并批量上报
+     */
+    flush(): void;
+    /**
+     * 批量上报（每条 item.data 展开为 log content）
+     */
+    putBatch(queue: QueueItem[]): void;
+    private putBatchAsync;
+    /**
+     * 参考《一、概述》：统一上报入口（内存队列 + 批量发送）
+     */
+    report(log: ReportLog): void;
+    private getDesiredBatchFlushDueAt;
+    info(message: string, data?: FlatFields): void;
+    warn(message: string, data?: FlatFields): void;
+    error(message: string, data?: FlatFields): void;
+    track(trackType: string, data?: FlatFields): void;
+    /**
+     * 立即发送内存队列
+     */
+    flushBatch(): Promise<void>;
+    private buildReportFields;
+    private sendReportLogs;
+    private retrySendReportLogs;
+    private cacheFailedReportLogs;
+    flushFailed(): void;
+    /**
+     * 统计/计数类日志：按字段展开上报（若 data 为空默认 1）
+     */
+    stat(param: {
+        pageName: string;
+        scene: string;
+        subScene: string;
+        data?: number | string;
+    }): void;
+}
+//# sourceMappingURL=ClsLoggerCore.d.ts.map

package/dist/ClsLoggerCore.d.ts.map

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

package/dist/ClsLoggerMini.d.ts

@@ -0,0 +1,8 @@
+import { ClsLoggerCore } from './ClsLoggerCore';
+import type { ClsSdkModule } from './clsSdkTypes';
+export declare class ClsLoggerMini extends ClsLoggerCore {
+    protected envType: import('./types').EnvType;
+    protected loadSdk(): Promise<ClsSdkModule>;
+    private normalize;
+}
+//# sourceMappingURL=ClsLoggerMini.d.ts.map

package/dist/ClsLoggerMini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClsLoggerMini.d.ts","sourceRoot":"","sources":["../src/ClsLoggerMini.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAKlD,qBAAa,aAAc,SAAQ,aAAa;IAC9C,SAAS,CAAC,OAAO,EAAE,OAAO,SAAS,EAAE,OAAO,CAAiB;cAE7C,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;IAkBhD,OAAO,CAAC,SAAS;CAYlB"}

package/dist/ClsLoggerWeb.d.ts

@@ -0,0 +1,8 @@
+import { ClsLoggerCore } from './ClsLoggerCore';
+import type { ClsSdkModule } from './clsSdkTypes';
+export declare class ClsLoggerWeb extends ClsLoggerCore {
+    protected envType: import('./types').EnvType;
+    protected loadSdk(): Promise<ClsSdkModule>;
+    private normalize;
+}
+//# sourceMappingURL=ClsLoggerWeb.d.ts.map

package/dist/ClsLoggerWeb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClsLoggerWeb.d.ts","sourceRoot":"","sources":["../src/ClsLoggerWeb.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAKlD,qBAAa,YAAa,SAAQ,aAAa;IAC7C,SAAS,CAAC,OAAO,EAAE,OAAO,SAAS,EAAE,OAAO,CAAa;cAEzC,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;IAahD,OAAO,CAAC,SAAS;CASlB"}

package/dist/clsSdkTypes.d.ts

@@ -0,0 +1,18 @@
+export type ClsSdkModule = {
+    AsyncClient: new (options: {
+        endpoint: string;
+        retry_times?: number;
+    }) => {
+        PutLogs: (request: unknown) => Promise<unknown> | unknown;
+    };
+    Log: new (time: number) => {
+        addContent: (k: string, v: string) => void;
+    };
+    LogGroup: new (source: string) => {
+        setSource: (source: string) => void;
+        addLog: (log: unknown) => void;
+        getLogs: () => unknown[];
+    };
+    PutLogsRequest: new (topicId: string, logGroup: unknown) => unknown;
+};
+//# sourceMappingURL=clsSdkTypes.d.ts.map

package/dist/clsSdkTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clsSdkTypes.d.ts","sourceRoot":"","sources":["../src/clsSdkTypes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,EAAE,KAAK,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK;QACxE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;KAC3D,CAAC;IACF,GAAG,EAAE,KAAK,IAAI,EAAE,MAAM,KAAK;QAAE,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;IAC1E,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,KAAK;QAChC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;QACpC,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;QAC/B,OAAO,EAAE,MAAM,OAAO,EAAE,CAAC;KAC1B,CAAC;IACF,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC;CACrE,CAAC"}

package/dist/index.esm.js

@@ -1894,27 +1894,6 @@ function createAutoDeviceInfoBaseFields(envType, opts) {
     };
 }
 
-function readGlobal(key) {
-    try {
-        const g = globalThis;
-        return g[key] ?? null;
-    }
-    catch {
-        return null;
-    }
-}
-function tryRequire(moduleName) {
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-implied-eval
-        const req = (typeof require === 'function' ? require : null);
-        if (!req)
-            return null;
-        return req(moduleName);
-    }
-    catch {
-        return null;
-    }
-}
 function enterClsSendingGuard() {
     const g = globalThis;
     const next = (g.__beLinkClsLoggerSendingCount__ ?? 0) + 1;
@@ -1924,10 +1903,18 @@ function enterClsSendingGuard() {
         g.__beLinkClsLoggerSendingCount__ = cur > 0 ? cur - 1 : 0;
     };
 }
-class ClsLogger {
+/**
+ * CLS Logger 核心基类
+ * - 负责所有上报、队列、监控逻辑
+ * - 不包含具体的 SDK 加载实现（由子类负责）
+ * - 这样可以把 web/mini 的 SDK 依赖彻底解耦到子入口
+ */
+class ClsLoggerCore {
     constructor() {
         this.sdk = null;
         this.sdkPromise = null;
+        this.sdkOverride = null;
+        this.sdkLoaderOverride = null;
         this.client = null;
         this.clientPromise = null;
         this.topicId = null;
@@ -1960,6 +1947,15 @@ class ClsLogger {
         this.behaviorMonitorStarted = false;
         this.behaviorMonitorCleanup = null;
     }
+    /**
+     * 子类可按需重写（默认检测 wx）
+     */
+    detectEnvType() {
+        const wxAny = globalThis.wx;
+        if (wxAny && typeof wxAny.getSystemInfoSync === 'function')
+            return 'miniprogram';
+        return 'browser';
+    }
     init(options) {
         this.initTs = Date.now();
         const topicId = options?.tencentCloud?.topicID ?? options?.topic_id ?? options?.topicID ?? this.topicId ?? null;
@@ -1995,6 +1991,9 @@ class ClsLogger {
         this.appId = options.appId ?? this.appId;
         this.appVersion = options.appVersion ?? this.appVersion;
         this.envType = nextEnvType;
+        // 可选：外部注入 SDK（优先级：sdkLoader > sdk）
+        this.sdkLoaderOverride = options.sdkLoader ?? this.sdkLoaderOverride;
+        this.sdkOverride = options.sdk ?? this.sdkOverride;
         this.userGenerateBaseFields = options.generateBaseFields ?? this.userGenerateBaseFields;
         this.autoGenerateBaseFields = createAutoDeviceInfoBaseFields(this.envType, options.deviceInfo);
         this.storageKey = options.storageKey ?? this.storageKey;
@@ -2113,8 +2112,6 @@ class ClsLogger {
     }
     /**
      * 获取 CLS client（按环境懒加载 SDK）
-     * - browser: 优先走 UMD 全局变量 `tencentcloudClsSdkJsWeb`
-     * - miniprogram: 优先走 require（webpack/taro 可解析），否则 fallback import()
      */
     async getInstance() {
         if (this.client)
@@ -2137,51 +2134,6 @@ class ClsLogger {
         });
         return this.clientPromise;
     }
-    async loadSdk() {
-        if (this.sdk)
-            return this.sdk;
-        if (this.sdkPromise)
-            return this.sdkPromise;
-        const isMini = this.envType === 'miniprogram';
-        const moduleName = isMini ? 'tencentcloud-cls-sdk-js-mini' : 'tencentcloud-cls-sdk-js-web';
-        // UMD（浏览器脚本）优先读全局变量
-        if (!isMini) {
-            const g = readGlobal('tencentcloudClsSdkJsWeb');
-            if (g?.AsyncClient && g?.Log && g?.LogGroup && g?.PutLogsRequest) {
-                this.sdk = g;
-                return this.sdk;
-            }
-        }
-        // 尽量同步 require（小程序/webpack 里最稳），失败再走 import()
-        const reqMod = tryRequire(moduleName);
-        if (reqMod?.AsyncClient && reqMod?.Log && reqMod?.LogGroup && reqMod?.PutLogsRequest) {
-            this.sdk = reqMod;
-            return this.sdk;
-        }
-        this.sdkPromise = import(moduleName)
-            .then((m) => {
-            const mod = (m?.default && m.default.AsyncClient ? m.default : m);
-            const sdk = {
-                AsyncClient: mod.AsyncClient,
-                Log: mod.Log,
-                LogGroup: mod.LogGroup,
-                PutLogsRequest: mod.PutLogsRequest,
-            };
-            this.sdk = sdk;
-            return sdk;
-        })
-            .catch((err) => {
-            this.sdkPromise = null;
-            throw err;
-        });
-        return this.sdkPromise;
-    }
-    detectEnvType() {
-        const wxAny = globalThis.wx;
-        if (wxAny && typeof wxAny.getSystemInfoSync === 'function')
-            return 'miniprogram';
-        return 'browser';
-    }
     /**
      * 直接上报：埋点入参必须是一维（扁平）Object
      * - 非原始值（对象/数组等）会被自动 stringify 成 string
@@ -2524,6 +2476,122 @@ class ClsLogger {
     }
 }
 
+function readGlobal(key) {
+    try {
+        const g = globalThis;
+        return g[key] ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function tryRequire(moduleName) {
+    try {
+        // 说明：
+        // - ESM 构建（exports.import/module）里通常不存在模块作用域的 require
+        // - 一些小程序运行时/构建链路会把 require 挂到 globalThis 上
+        // 因此这里同时探测“模块作用域 require”与 “globalThis.require”
+        // eslint-disable-next-line @typescript-eslint/no-implied-eval
+        const localReq = (typeof require === 'function' ? require : null);
+        const globalReq = readGlobal('require');
+        const candidates = [localReq, globalReq].filter((fn) => typeof fn === 'function');
+        for (const fn of candidates) {
+            try {
+                return fn(moduleName);
+            }
+            catch {
+                // continue
+            }
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+
+/**
+ * 兼容版 ClsLogger（默认入口）
+ * - 保留了自动识别环境 + 动态 import 的逻辑
+ * - 如果业务想瘦身，建议改用 @be-link/cls-logger/web 或 /mini
+ */
+class ClsLogger extends ClsLoggerCore {
+    async loadSdk() {
+        if (this.sdk)
+            return this.sdk;
+        if (this.sdkPromise)
+            return this.sdkPromise;
+        const normalizeSdk = (m) => {
+            const mod = (m?.default && m.default.AsyncClient ? m.default : m);
+            if (mod?.AsyncClient && mod?.Log && mod?.LogGroup && mod?.PutLogsRequest) {
+                return {
+                    AsyncClient: mod.AsyncClient,
+                    Log: mod.Log,
+                    LogGroup: mod.LogGroup,
+                    PutLogsRequest: mod.PutLogsRequest,
+                };
+            }
+            return null;
+        };
+        // 1) 外部注入的 loader（最高优先级）
+        if (this.sdkLoaderOverride) {
+            try {
+                const loaded = await this.sdkLoaderOverride();
+                const sdk = normalizeSdk(loaded);
+                if (sdk) {
+                    this.sdk = sdk;
+                    return sdk;
+                }
+            }
+            catch {
+                // ignore and fallback
+            }
+        }
+        // 2) 外部直接注入的 sdk
+        if (this.sdkOverride) {
+            const sdk = normalizeSdk(this.sdkOverride);
+            if (sdk) {
+                this.sdk = sdk;
+                return sdk;
+            }
+        }
+        const isMini = this.envType === 'miniprogram';
+        // 静态字面量，方便打包器识别（但在此兼容入口里，仍然可能被一起分析）
+        const WEB_SDK = 'tencentcloud-cls-sdk-js-web';
+        const MINI_SDK = 'tencentcloud-cls-sdk-js-mini';
+        // UMD（浏览器脚本）优先读全局变量
+        if (!isMini) {
+            const g = readGlobal('tencentcloudClsSdkJsWeb');
+            const sdk = normalizeSdk(g);
+            if (sdk) {
+                this.sdk = sdk;
+                return sdk;
+            }
+        }
+        // 尽量同步 require
+        const reqMod = tryRequire(isMini ? MINI_SDK : WEB_SDK);
+        const reqSdk = normalizeSdk(reqMod);
+        if (reqSdk) {
+            this.sdk = reqSdk;
+            return reqSdk;
+        }
+        // 动态 import
+        this.sdkPromise = (isMini ? import(MINI_SDK) : import(WEB_SDK))
+            .then((m) => {
+            const sdk = normalizeSdk(m);
+            if (!sdk)
+                throw new Error(`ClsLogger.loadSdk: invalid sdk module for ${isMini ? MINI_SDK : WEB_SDK}`);
+            this.sdk = sdk;
+            return sdk;
+        })
+            .catch((err) => {
+            this.sdkPromise = null;
+            throw err;
+        });
+        return this.sdkPromise;
+    }
+}
+
 const clsLogger = new ClsLogger();
 
 export { ClsLogger, clsLogger, clsLogger as default };