@wizai/agent-sip-sdk 0.1.17-alpha → 0.2.0

package/lib/types/api/index.d.ts

@@ -1,4 +1,5 @@
-import type { IApiProps, IRespones, IAgentStatusListResponse, IAgentStatusResponse, IGetAgentSettingParams, IGetAgentSettingResponse, IUpdateAgentTicketParams, IRegisterSSEParams, ICloseSSEParams, ISwitchAgentStatusParams, IOutboundCallParams, IOutboundCallResponse, IAgentResponseTimeParams, IAgentAbnormalCloseParams, IGetCallTaskInfoParams, IGetCallTaskInfoResponse, ISendBeaconParams } from './types';
+import type { ISdkTraceEvent, ISdkTraceConfig, ITrackOpts } from '../tracker/types';
+import type { IApiProps, IRespones, IAgentStatusListResponse, IAgentStatusResponse, IGetAgentSettingParams, IGetAgentSettingResponse, IUpdateAgentTicketParams, IRegisterSSEParams, ICloseSSEParams, ISwitchAgentStatusParams, IOutboundCallParams, IOutboundCallResponse, IAgentResponseTimeParams, IAgentAbnormalCloseParams, IGetCallTaskInfoParams, IGetCallTaskInfoResponse, ISendBeaconParams, IReportPDSTimeline } from './types';
 import { EApiCode } from '../enums/common';
 declare class Api {
     private baseUrl;
@@ -10,6 +11,8 @@ declare class Api {
     private token;
     private getSystemToken;
     private resetSSE;
+    private track;
+    setTrack(fn: (event: string, opts?: ITrackOpts) => void): void;
     constructor(props: IApiProps);
     validateToken(id: string, token: string): Promise<IRespones<boolean>>;
     initToken(): Promise<{
@@ -23,13 +26,26 @@ declare class Api {
     getAgentSetting(params: IGetAgentSettingParams): Promise<IGetAgentSettingResponse>;
     updateAgentHangup(agentId: number): Promise<IGetAgentSettingResponse>;
     updateAgentTicket(data: IUpdateAgentTicketParams): Promise<IRespones<any>>;
-    sendSSEACK(agentId: number): Promise<any>;
+    sendSSEACK(agentId: number): Promise<boolean>;
     registerSSE(data: IRegisterSSEParams): Promise<unknown>;
     closeClientSSE(): void;
     closeSSE(data: ICloseSSEParams): Promise<IRespones<any> | undefined>;
+    sendHeartbeat(agentId: number): Promise<boolean>;
     switchAgentStatus(data: ISwitchAgentStatusParams): Promise<IRespones<IAgentStatusResponse>>;
     outboundCall(data: IOutboundCallParams): Promise<IRespones<IOutboundCallResponse>>;
     saveAgentResponseTime(data: IAgentResponseTimeParams): Promise<IRespones<any>>;
+    reportPDSTimeline(data: IReportPDSTimeline): Promise<boolean>;
+    /**
+     * 埋点上报专用发送：不复用 request()（避开 waitToken/initToken）。
+     * 尽力带 token（非强制，取不到也照发），只看 res.ok 判成功，不强解 body。
+     * keepalive：卸载时用；useBeacon：keepalive 不支持时降级 FormData + sendBeacon。
+     */
+    reportSdkTrace(event: ISdkTraceEvent, opts?: {
+        keepalive?: boolean;
+        useBeacon?: boolean;
+    }): Promise<boolean>;
+    /** 采集开关：全局、不带 token、不校验。失败返回 null（调用方用缓存兜底）。 */
+    getSdkTraceConfig(): Promise<ISdkTraceConfig | null>;
     getCallTaskInfo(data: IGetCallTaskInfoParams): Promise<IGetCallTaskInfoResponse>;
     getAfterCallProcessTime(data: IGetCallTaskInfoParams): Promise<IRespones<number>>;
     formatFormData<T = Record<string, any>>(params: T): FormData;
@@ -47,6 +63,5 @@ declare class Api {
     private request;
     private executePeriodically;
     static getInstance(options?: IApiProps): Api;
-    heartbeat(): Promise<IRespones<boolean>>;
 }
 export default Api;

package/lib/types/api/types.d.ts

@@ -9,7 +9,7 @@ export interface IRequestOptionsType<T = any> {
 export interface IApiProps {
     id: string;
     getSystemToken: () => Promise<string>;
-    resetSSE: () => Promise<void>;
+    resetSSE?: () => Promise<void>;
     baseUrl?: string;
     retryCount?: number;
 }
@@ -150,4 +150,9 @@ export interface ISendBeaconParams {
     Authentication?: string;
     trace?: string;
 }
+export interface IReportPDSTimeline {
+    callId?: string;
+    eventType: number;
+    timestamp?: number;
+}
 export {};

package/lib/types/enums/agent.d.ts

@@ -7,3 +7,7 @@ export declare enum EAgentAction {
     ANSWER = 1,
     HANGUP = 2
 }
+export declare enum EReportPDSTimeEventType {
+    INCOMMING = 1,
+    ACW = 2
+}

package/lib/types/index.d.ts

@@ -13,21 +13,20 @@ declare class AgentSipSDK {
     private agentResponseTime;
     private timer;
     private callDetails;
-    private unloadingHandled;
     private baseUrl;
     private autoFinishACWTimer;
+    private _acwAutoTriggered;
     private heartbeatTimer;
     private heartbeatFailCount;
     private isHeartbeatRunning;
+    private tracker;
     constructor(props: IAgentSipSDKOptions);
     private init;
     getAgentStatusList(): Promise<IGetAgentStatusList>;
     private getTicket;
     private getHostName;
-    private processSSEMessage;
-    private resetSSE;
-    private createSSEAndOpensips;
-    private closeSSEAndOpensips;
+    private createOpensips;
+    private closeSip;
     private waitSIPRegistered;
     private getAgentInfo;
     getAgentStatus(): Promise<IGetAgentStatus>;
@@ -46,12 +45,10 @@ declare class AgentSipSDK {
     }>;
     private sessionEnded;
     private sessionFailed;
-    private openOnunload;
-    private cancelOnunload;
-    private doForceOfflineCleanup;
     private saveAgentResponseTime;
     hangup(): void;
     private timingResTime;
+    private trackIncomingCall;
     private incomingCall;
     answer(): void;
     ignore(): void;
@@ -65,6 +62,8 @@ declare class AgentSipSDK {
     private emitAgentEvent;
     attachAnswerEvent(listener: IAnswerFnType): void;
     removeAnswerEvent(listener: IAnswerFnType): void;
+    attachAutoAnswerEvent(listener: IAnswerFnType): void;
+    removeAutoAnswerEvent(listener: IAnswerFnType): void;
     attachNewMessageEvent(listener: INewMessageFnType): void;
     removeNewMessageEvent(listener: INewMessageFnType): void;
     attchSessionEvent<T extends ISessionType>(type: T, listener: ISessionEventListener<T>): void;

package/lib/types/sip/index.d.ts

@@ -1,6 +1,7 @@
 import type { UAEventMap, IncomingRTCSessionEvent } from 'jssip/lib/UA.d.ts';
 import type { RTCSession, RTCSessionEventMap } from 'jssip/lib/RTCSession.d.ts';
 import type { IAnswerFnType, IAnswerEventPayload, INewMessageFnType, INewMessageEventPayload, ISessionType, ISessionEventListener, ISessionEventPayload } from './types';
+import type { ITrackOpts } from '../tracker/types';
 declare class SIP {
     private callType;
     private ua;
@@ -14,15 +15,22 @@ declare class SIP {
     private audio;
     private ringAudio;
     private answerEvent;
+    private autoAnswerEvent;
     private newMessageEvent;
     private sessionEvent;
     private callDetails;
     private cancelCallId;
     private readonly incomingCallCallback;
+    private readonly trackIncomingCallCallback?;
     private readonly getMediaStream;
+    private readonly applyAnswer?;
+    private readonly track;
     constructor(props: {
         incomingCallCallback: (_e: IncomingRTCSessionEvent) => Promise<IAnswerEventPayload>;
+        trackIncomingCallCallback?: (_callId: string) => void | undefined;
         getMediaStream?: () => Promise<MediaStream>;
+        applyAnswer?: () => void;
+        track?: (event: string, opts?: ITrackOpts) => void;
     });
     /**
      *
@@ -57,6 +65,9 @@ declare class SIP {
     attachAnswerEvent(listener: IAnswerFnType): void;
     removeAnswerEvent(listener: IAnswerFnType): void;
     emitAnswerEvent(data: IAnswerEventPayload): void;
+    attachAutoAnswerEvent(listener: IAnswerFnType): void;
+    removeAutoAnswerEvent(listener: IAnswerFnType): void;
+    emitAutoAnswerEvent(data: IAnswerEventPayload): void;
     attachNewMessageEvent(listener: INewMessageFnType): void;
     removeNewMessageEvent(listener: INewMessageFnType): void;
     emitNewMessageEvent(data: INewMessageEventPayload): void;

package/lib/types/sip/types.d.ts

@@ -21,7 +21,9 @@ export type INewMessageEventPayload = IResponse<{
 } | null>;
 export type INewMessageFnType = (_data: INewMessageEventPayload) => void;
 export type ISessionType = 'success' | 'failed' | 'ended';
-export type ISessionEventPayload<T extends ISessionType> = IResponse<ICallDetails | null>;
+export type ISessionEventPayload<T extends ISessionType> = IResponse<ICallDetails | null> & {
+    _type?: T;
+};
 export type ISessionEventListener<T extends ISessionType> = (_data: ISessionEventPayload<T>) => void;
 export type ISessionEventType<T extends ISessionType> = {
     [K in T]: Array<ISessionEventListener<K>>;

package/lib/types/tracker/configCache.d.ts

@@ -0,0 +1,5 @@
+type Storage = Pick<globalThis.Storage, 'getItem' | 'setItem' | 'removeItem'>;
+/** 返回上次缓存的 collect；无缓存或损坏 → null */
+export declare const readCachedCollect: (storage: Storage) => boolean | null;
+export declare const writeCachedCollect: (storage: Storage, collect: boolean) => void;
+export {};

package/lib/types/tracker/index.d.ts

@@ -0,0 +1,25 @@
+import type { ITrackOpts, ITrackerDeps } from './types';
+export declare class Tracker {
+    private enabled;
+    private traceId;
+    private agentId;
+    private readonly version;
+    private readonly now;
+    private readonly genId;
+    private readonly report;
+    private readonly queue;
+    private lastSent;
+    private bucket;
+    private bucketTs;
+    constructor(deps: ITrackerDeps);
+    /** init 拉到 config 后调；也用于乐观套缓存 */
+    applyConfig(collect: boolean): void;
+    setAgentId(id: string | number): void;
+    resetTraceId(): void;
+    /** 唯一对外入口。全程 try/catch，任何情况不抛、不返回错误。 */
+    track(event: string, opts?: ITrackOpts): void;
+    /** 卸载/重连时把队列残留发出（keepalive 优先，降级 beacon）。 */
+    flush(): void;
+    private isDeduped;
+    private takeToken;
+}

package/lib/types/tracker/queue.d.ts

@@ -0,0 +1,18 @@
+import type { ISdkTraceEvent } from './types';
+export interface TraceQueueOpts {
+    cap: number;
+    ttlMs: number;
+    now: () => number;
+}
+type Storage = Pick<globalThis.Storage, 'getItem' | 'setItem' | 'removeItem'>;
+export declare class TraceQueue {
+    private storage;
+    private opts;
+    constructor(storage: Storage, opts: TraceQueueOpts);
+    private read;
+    /** 入队：追加 + 超容量丢最旧。任何异常吞掉（不影响业务）。 */
+    enqueue(event: ISdkTraceEvent): void;
+    /** 取出全部（过滤超 TTL）并清空。异常吞掉返回空。 */
+    drain(): ISdkTraceEvent[];
+}
+export {};

package/lib/types/tracker/scrub.d.ts

@@ -0,0 +1,7 @@
+/**
+ * message 统一脱敏兜底（PII 第二道防线）：
+ * - url：去 query、把纯数字路径段替成 {id}
+ * - 7 位以上连续数字（手机号/卡号）→ 保留前 3 后 2，中间掩码
+ * - 限长 1024（顺带兜 keepalive/beacon ~64KB）
+ */
+export declare const scrubMessage: (input: string) => string;

package/lib/types/tracker/types.d.ts

@@ -0,0 +1,41 @@
+/** extra 白名单值类型：只允许标量，杜绝嵌套对象（FormData 装不下，且防 PII 后门） */
+export type TraceExtra = Record<string, string | number | boolean>;
+/** 单条埋点事件（上报 body / 入队单元） */
+export interface ISdkTraceEvent {
+    timestamp: number;
+    traceId: string;
+    agentId: string;
+    sdkVersion: string;
+    callId: string;
+    callRecordId: string;
+    event: string;
+    message: string;
+    extra?: TraceExtra;
+}
+/** getSdkTraceConfig 响应 */
+export interface ISdkTraceConfig {
+    collect: boolean;
+}
+/** track() 的可选入参（agentId/sdkVersion/timestamp/traceId 由 Tracker 补齐） */
+export interface ITrackOpts {
+    callId?: string;
+    callRecordId?: string;
+    message?: string;
+    extra?: TraceExtra;
+}
+/** Tracker 的注入依赖——便于单测，不直接耦合 Api/全局 */
+export interface ITrackerDeps {
+    /** 传输：返回是否送达（res.ok）。keepalive/beacon 由 opts 控制 */
+    report: (event: ISdkTraceEvent, opts?: {
+        keepalive?: boolean;
+        useBeacon?: boolean;
+    }) => Promise<boolean>;
+    /** localStorage（默认注入 window.localStorage；测试可注 mock） */
+    storage: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
+    /** 版本常量 */
+    version: string;
+    /** 取当前毫秒（默认 Date.now；测试可注 mock） */
+    now?: () => number;
+    /** 生成 traceId（默认 nanoid；测试可注 mock） */
+    genId?: () => string;
+}

package/lib/types/types.d.ts

@@ -25,6 +25,7 @@ export type IAgentEventPayload = IResponse<IAgentStatusParams>;
 export type IAgentFnType = (_data: IAgentEventPayload) => void;
 export interface ICallDetails {
     callId: string;
+    originCallId: string;
     callType: string;
     taskName: string;
     afterCallProcessTime: string;

package/lib/types/version.d.ts

@@ -0,0 +1 @@
+export declare const SDK_VERSION: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wizai/agent-sip-sdk",
-  "version": "0.1.17-alpha",
+  "version": "0.2.0",
   "description": "Manages SIP clients and agent status, simplifying calls and events.",
   "main": "lib/agent-sip-sdk-cjs.js",
   "module": "lib/agent-sip-sdk-es.js",