@ztlink-imk/ztlinkcloud-agent-sdk 1.0.1 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -4,7 +4,9 @@
4
4
  npm i @ztlink-imk/ztlinkcloud-agent-sdk
5
5
  ```
6
6
 
7
- SDK 实现不在本包内:客户服务端签发 Ticket 时,响应 `data.sdk` 同时给出运行时地址(带 CDN 签名)、版本与 integrity。浏览器加载该脚本后得到 `window.ImkAgentSdk`。本包负责注入脚本并提供公共类型,没有运行时依赖。
7
+ SDK 实现不在本包内:客户服务端签发 Ticket 时,响应 `data.sdk` 同时给出运行时地址(带 CDN 签名)、版本、integrity 与浏览器 SDK 的服务地址。浏览器加载该脚本后得到 `window.ImkAgentSdk`。本包负责注入脚本并提供公共类型,没有运行时依赖。
8
+
9
+ 前端不配置任何 IMK 服务地址:服务基址随 `sdk` 下发,业务通知地址随坐席登录结果下发。该写法自本包 1.0.2 起(运行时 1.0.4)(需服务端 HTTP v0.16.0 下发地址)。客户服务端原样转发 `sdk`,不解析其内容。
8
10
 
9
11
  客户通过本包锁定**大版本**;大版本内的小版本由服务端决定,发版或回退后客户刷新页面即生效。
10
12
 
@@ -23,8 +25,8 @@ import { loadAgentSdk, AgentSdkLoadError } from '@ztlink-imk/ztlinkcloud-agent-s
23
25
  const { ticket, sdk } = await fetchTicketFromHostBackend();
24
26
 
25
27
  try {
26
- const runtime = await loadAgentSdk(sdk); // sdk 为 { version, url, integrity },原样传入
27
- const core = runtime.createCallCenter({ apiBaseUrl, wsUrl });
28
+ const runtime = await loadAgentSdk(sdk); // 原样传入 Ticket 响应中的 data.sdk
29
+ const core = runtime.createCallCenter(); // 不传地址,服务地址由 sdk 与登录结果下发
28
30
  const panel = runtime.mountPanel('#imk-panel', { core }); // 不需要界面时可不调用
29
31
  await core.initialize(ticket);
30
32
  } catch (error) {
@@ -36,11 +38,12 @@ try {
36
38
  ```
37
39
 
38
40
  - 产物为 ESM + CJS,附带自包含的 `.d.ts`;JavaScript 项目不需要类型也可直接使用。
39
- - 同一页面重复调用返回同一个运行时。页面已加载的版本与本次 `sdk.version` 不同时不替换已运行的代码,控制台提示刷新页面后生效;需要自行提示时比较 `runtime.version !== sdk.version`。
41
+ - 同一页面重复调用只加载一次运行时,返回值绑定本次 `sdk`。页面已加载的版本与本次 `sdk.version` 不同时不替换已运行的代码,控制台提示刷新页面后生效;需要自行提示时比较 `runtime.version !== sdk.version`。
42
+ - `createCallCenter` 的 `apiBaseUrl`、`wsUrl` 选项已弃用:显式传入时仍优先使用,新接入不要传。
40
43
 
41
44
  | 错误码 | 含义 | 处理 |
42
45
  |---|---|---|
43
- | `INVALID_ARGUMENT` | `sdk` 缺少非空的 `version`/`url`/`integrity` | 检查宿主后端是否原样转发 `data.sdk` |
46
+ | `INVALID_ARGUMENT` | `sdk` 缺少非空的 `version`/`url`/`integrity`,或 `apiBaseUrl` 不是合法 http(s) 基址 | 检查宿主后端是否原样转发 `data.sdk` |
44
47
  | `MAJOR_VERSION_MISMATCH` | 下发版本或页面已加载的运行时大版本与加载器不一致 | 升级加载器包 |
45
48
  | `LOAD_FAILED` | 网络、签名过期、CORS、integrity 校验失败等,浏览器不区分原因 | 重新签发 Ticket 获取新地址后重试 |
46
49
 
@@ -76,7 +79,8 @@ try {
76
79
  fetchTicketFromHostBackend()
77
80
  .then(function (data) {
78
81
  return loadAgentSdk(data.sdk).then(function (runtime) {
79
- var core = runtime.createCallCenter({ apiBaseUrl: '...', wsUrl: '...' });
82
+ // 原生脚本没有加载器包装,传入下发的 sdk,服务地址从中读取
83
+ var core = runtime.createCallCenter({ sdk: data.sdk });
80
84
  runtime.mountPanel('#imk-panel', { core: core });
81
85
  return core.initialize(data.ticket);
82
86
  });
package/dist/index.cjs CHANGED
@@ -46,10 +46,28 @@ function majorOf(version) {
46
46
  return match ? Number(match[1]) : null;
47
47
  }
48
48
  var INTEGRITY_PATTERN = /^sha384-[A-Za-z0-9+/]{64}$/;
49
+ function isApiBaseUrl(value) {
50
+ if (typeof value !== "string") return false;
51
+ try {
52
+ const url = new URL(value);
53
+ return (url.protocol === "https:" || url.protocol === "http:") && !url.username && !url.password && !url.search && !url.hash;
54
+ } catch {
55
+ return false;
56
+ }
57
+ }
49
58
  function isDelivery(sdk) {
50
59
  if (typeof sdk !== "object" || sdk === null) return false;
51
- const { version, url, integrity } = sdk;
52
- return [version, url].every((field) => typeof field === "string" && field !== "") && typeof integrity === "string" && INTEGRITY_PATTERN.test(integrity);
60
+ const { version, url, integrity, apiBaseUrl } = sdk;
61
+ return [version, url].every((field) => typeof field === "string" && field !== "") && typeof integrity === "string" && INTEGRITY_PATTERN.test(integrity) && (apiBaseUrl === void 0 || isApiBaseUrl(apiBaseUrl));
62
+ }
63
+ function bind(runtime, sdk) {
64
+ return Object.freeze({
65
+ version: runtime.version,
66
+ createCallCenter: (options = {}) => runtime.createCallCenter(
67
+ options.apiBaseUrl === void 0 && sdk.apiBaseUrl !== void 0 ? { ...options, apiBaseUrl: sdk.apiBaseUrl } : options
68
+ ),
69
+ mountPanel: (...args) => runtime.mountPanel(...args)
70
+ });
53
71
  }
54
72
  function adopt(runtime, sdk) {
55
73
  if (majorOf(runtime.version) !== SUPPORTED_MAJOR)
@@ -87,15 +105,15 @@ async function loadAgentSdk(sdk) {
87
105
  if (!isDelivery(sdk))
88
106
  throw new AgentSdkLoadError(
89
107
  "INVALID_ARGUMENT",
90
- "sdk \u9700\u5305\u542B\u975E\u7A7A\u7684 version\u3001url \u53CA sha384 \u683C\u5F0F\u7684 integrity"
108
+ "sdk \u9700\u5305\u542B\u975E\u7A7A\u7684 version\u3001url\u3001sha384 \u683C\u5F0F\u7684 integrity\uFF0CapiBaseUrl \u5B58\u5728\u65F6\u987B\u4E3A\u5408\u6CD5 http(s) \u57FA\u5740"
91
109
  );
92
110
  if (majorOf(sdk.version) !== SUPPORTED_MAJOR)
93
111
  throw new AgentSdkLoadError("MAJOR_VERSION_MISMATCH", "\u670D\u52A1\u7AEF\u4E0B\u53D1\u7684\u8FD0\u884C\u65F6\u5927\u7248\u672C\u4E0E\u52A0\u8F7D\u5668\u4E0D\u4E00\u81F4");
94
112
  const loaded = window.ImkAgentSdk;
95
- if (loaded) return adopt(loaded, sdk);
113
+ if (loaded) return bind(adopt(loaded, sdk), sdk);
96
114
  pending ??= inject(sdk).catch((error) => {
97
115
  pending = null;
98
116
  throw error;
99
117
  });
100
- return adopt(await pending, sdk);
118
+ return bind(adopt(await pending, sdk), sdk);
101
119
  }
package/dist/index.d.cts CHANGED
@@ -7,7 +7,7 @@
7
7
  * 错误对象与消息都已脱敏:不含 Token、密码、请求体和服务端原始报文。
8
8
  */
9
9
  /** 后端契约错误码(http-contract.md §12) */
10
- type ServerErrorCode = 'BAD_REQUEST' | 'VALIDATION_ERROR' | 'TOKEN_MISSING' | 'TOKEN_INVALID' | 'TOKEN_EXPIRED' | 'SESSION_REVOKED' | 'SESSION_EXPIRED' | 'TICKET_INVALID' | 'TICKET_EXPIRED' | 'TICKET_USED' | 'REFRESH_TOKEN_INVALID' | 'REFRESH_TOKEN_REPLAYED' | 'REFRESH_NOT_COMMITTED' | 'PERMISSION_DENIED' | 'APP_DISABLED' | 'AGENT_DISABLED' | 'AGENT_NOT_FOUND' | 'AGENT_ALREADY_EXISTS' | 'CALL_CONTROL_REJECTED' | 'AGENT_SIP_NOT_READY' | 'AGENT_CONFLICT' | 'RATE_LIMITED' | 'INTERNAL_ERROR' | 'PROVIDER_BAD_RESPONSE' | 'SERVICE_UNAVAILABLE' | 'SIP_CREDENTIAL_UNAVAILABLE' | 'PROVIDER_TIMEOUT' | 'NOT_FOUND' | 'METHOD_NOT_ALLOWED' | 'UNSUPPORTED_MEDIA_TYPE';
10
+ type ServerErrorCode = 'BAD_REQUEST' | 'VALIDATION_ERROR' | 'TOKEN_MISSING' | 'TOKEN_INVALID' | 'TOKEN_EXPIRED' | 'SESSION_REVOKED' | 'SESSION_EXPIRED' | 'TICKET_INVALID' | 'TICKET_EXPIRED' | 'TICKET_USED' | 'REFRESH_TOKEN_INVALID' | 'REFRESH_TOKEN_REPLAYED' | 'REFRESH_NOT_COMMITTED' | 'PERMISSION_DENIED' | 'APP_DISABLED' | 'AGENT_DISABLED' | 'AGENT_NOT_FOUND' | 'AGENT_ALREADY_EXISTS' | 'CALL_CONTROL_REJECTED' | 'AGENT_SIP_NOT_READY' | 'AGENT_CONFLICT' | 'RATE_LIMITED' | 'INTERNAL_ERROR' | 'PROVIDER_BAD_RESPONSE' | 'SERVICE_UNAVAILABLE' | 'SIP_CREDENTIAL_UNAVAILABLE' | 'PROVIDER_TIMEOUT' | 'NOT_FOUND' | 'METHOD_NOT_ALLOWED' | 'UNSUPPORTED_MEDIA_TYPE' | 'NUMBER_UNAVAILABLE' | 'CALLEE_CALLING';
11
11
  /** SDK 本地错误码 */
12
12
  type SdkErrorCode = 'DESTROYED' | 'NOT_INITIALIZED' | 'ALREADY_INITIALIZED' | 'INITIALIZE_IN_PROGRESS' | 'INITIALIZE_FAILED' | 'NOT_AUTHENTICATED' | 'COMMAND_IN_PROGRESS' | 'NOT_REGISTERED' | 'REGISTRATION_FAILED' | 'SIGNALING_UNAVAILABLE' | 'INVALID_NUMBER' | 'INVALID_ARGUMENT' | 'CALL_IN_PROGRESS' | 'CALL_NOT_FOUND' | 'INVALID_CALL_STATE' | 'CALL_STATE_CHANGED' | 'CALL_STATE_UNKNOWN' | 'CALL_ENDED' | 'HOLD_TRANSITION_IN_PROGRESS' | 'HOLD_FAILED' | 'HOLD_TIMEOUT' | 'MEDIA_PERMISSION_DENIED' | 'MEDIA_DEVICE_UNAVAILABLE' | 'NETWORK_ERROR' | 'TIMEOUT' | 'ABORTED';
13
13
  type ErrorCode = ServerErrorCode | SdkErrorCode;
@@ -47,9 +47,31 @@ interface DiagnosticEntry {
47
47
  readonly code: string;
48
48
  readonly at: number;
49
49
  }
50
+ /** 服务端随 Ticket 下发的 SDK 信息(Ticket 响应 data.sdk),宿主原样传入,不理解其内容。 */
51
+ interface SdkDelivery {
52
+ /** 运行时完整版本号,如 1.2.3。 */
53
+ readonly version: string;
54
+ /** 带 CDN 签名的运行时地址;不含 Ticket,签名有效期有限,需用本次签发的值。 */
55
+ readonly url: string;
56
+ /** 运行时文件的 SRI 值(sha384-...),浏览器据此校验下载内容。 */
57
+ readonly integrity: string;
58
+ /** 浏览器 SDK 服务基址(HTTP v0.16.0 起下发);可选以兼容未升级的服务端。 */
59
+ readonly apiBaseUrl?: string;
60
+ }
50
61
  interface CallCenterOptions {
51
- readonly apiBaseUrl: string;
52
- /** 业务通知 WS 地址(ws/wss);不传则不建立通知连接,SIP 与 HTTP 行为不变。 */
62
+ /**
63
+ * 服务端随 Ticket 下发的 SDK 信息;未显式传 apiBaseUrl 时取其中的 apiBaseUrl。
64
+ * 经加载器创建时由加载器填入服务基址,宿主无需传入。
65
+ */
66
+ readonly sdk?: SdkDelivery;
67
+ /**
68
+ * @deprecated 服务基址改由服务端随 Ticket 下发(sdk.apiBaseUrl),宿主不再配置;显式传入时优先使用。
69
+ */
70
+ readonly apiBaseUrl?: string;
71
+ /**
72
+ * @deprecated 通知地址改由服务端随登录结果下发,宿主不再配置;显式传入(ws/wss)时优先使用,
73
+ * 未传时按每次登录结果建立,登录结果不含通知地址则不建立通知连接。
74
+ */
53
75
  readonly wsUrl?: string;
54
76
  readonly device?: DeviceInfo;
55
77
  readonly requestTimeoutMs?: number;
@@ -120,24 +142,26 @@ interface CallSnapshot {
120
142
  readonly callId: string;
121
143
  readonly direction: 'outbound' | 'inbound';
122
144
  readonly status: CallStatus;
123
- /** 外呼为目标号码,回呼为 INVITE 的 anumber。 */
145
+ /** 外呼为目标号码,回呼为 INVITE From 的号码(anumber)。 */
124
146
  readonly remoteNumber: string;
125
- /** 回呼原始号码;三个请求头全部校验完成后才随来电快照发布,不受 setDisplay 修改影响。 */
147
+ /** 回呼原始号码;From、To 及出现时的 bnumber 头校验完成后才随来电快照发布,不受 setDisplay 修改影响。 */
126
148
  readonly callbackNumbers?: {
127
- /** 来电主号码。 */
149
+ /** 来电主号码,取自 INVITE From。 */
128
150
  readonly anumber: string;
129
- /** 被叫号码。 */
130
- readonly bnumber: string;
131
- /** 外显号码。 */
151
+ /** 被叫号码,取自 INVITE 的可选 bnumber 头;FS 未下发时缺失。 */
152
+ readonly bnumber?: string;
153
+ /** 外显号码,取自 INVITE To。 */
132
154
  readonly xnumber: string;
133
155
  };
134
156
  readonly display?: CallDisplay;
135
157
  /**
136
- * 外呼经 AXB 分配的外显号码(WS-10):仅当业务通知的 bnumber 与本次拨打号码完全一致时写入,
137
- * 来电与未匹配的外呼不携带;更新通过同状态 call.status 发布,不改变通话状态。
158
+ * 外呼的呼叫会话标识(HTTP v0.17.0 呼前取号返回):与振铃/应答通知的 data.callSessionId 相同,
159
+ * 宿主据此判断通知是否属于本次外呼;随外呼首个快照写入且不再改变,来电不携带。
138
160
  */
161
+ readonly callSessionId?: string;
162
+ /** 外呼的外显号码(X 号码,INVITE 目标):取自呼前取号结果,随首个快照写入且不再改变;来电不携带。 */
139
163
  readonly xnumber?: string;
140
- /** 外呼 X 号码归属省区;仅省市齐全时随号码写入;同号后续缺失保留,换号且无省市时清除。 */
164
+ /** 外呼 X 号码归属省区;呼前取号同时返回省市时写入,否则与 xcity 一起缺失。 */
141
165
  readonly xprovince?: string;
142
166
  /** 外呼 X 号码归属城市;与 xprovince 成对出现。 */
143
167
  readonly xcity?: string;
@@ -158,13 +182,33 @@ interface CallSnapshot {
158
182
  */
159
183
  readonly sipStatus?: number;
160
184
  }
161
- /** 外呼可选展示信息,不作为号码路由或客户接听证据。 */
185
+ /** 外呼可选展示信息与通话记录字段,不作为号码路由或客户接听证据。 */
162
186
  interface DialOptions {
163
187
  readonly display?: CallDisplay;
188
+ /**
189
+ * 被叫姓名(HTTP v0.18.0):随呼前取号透传,写入外呼通话记录;不超过 64 个字符(按 Unicode 码点计),
190
+ * 原样提交、不裁剪。不传则正文不带、记录该列为空;不合规在本地以 INVALID_ARGUMENT reject,不发 HTTP。不影响展示。
191
+ */
192
+ readonly calleeName?: string;
193
+ /**
194
+ * 发起端(HTTP v0.18.0):'PC' 或 'APP',大小写敏感;随呼前取号透传,写入外呼通话记录。
195
+ * 不传则正文不带、记录该列为空;其他值在本地以 INVALID_ARGUMENT reject,不发 HTTP。
196
+ */
197
+ readonly source?: 'PC' | 'APP';
164
198
  }
165
199
  /** 一键拨打只等待当前在途准备,不领取 Ticket 或发起注册。 */
166
200
  interface QuickDialOptions {
167
201
  readonly display?: CallDisplay;
202
+ /**
203
+ * 被叫姓名(HTTP v0.18.0):随呼前取号透传,写入外呼通话记录;不超过 64 个字符(按 Unicode 码点计),
204
+ * 原样提交、不裁剪。不传则正文不带、记录该列为空;不合规在本地以 INVALID_ARGUMENT reject,不发 HTTP。不影响展示。
205
+ */
206
+ readonly calleeName?: string;
207
+ /**
208
+ * 发起端(HTTP v0.18.0):'PC' 或 'APP',大小写敏感;随呼前取号透传,写入外呼通话记录。
209
+ * 不传则正文不带、记录该列为空;其他值在本地以 INVALID_ARGUMENT reject,不发 HTTP。
210
+ */
211
+ readonly source?: 'PC' | 'APP';
168
212
  /** 认证中、登录连接材料 加载或注册中的等待上限,默认 10000 毫秒。 */
169
213
  readonly waitMs?: number;
170
214
  }
@@ -262,18 +306,12 @@ interface CallCenterState {
262
306
  readonly workStatus: WorkStatus | null;
263
307
  }
264
308
  type BackgroundPhase = 'refresh' | 'credentials' | 'registration' | 'signaling' | 'media';
265
- /** 通知事件类型:来源上报的三种事件原名,及 AXB 回调晚于振铃时单独推送的 AXB_BOUND。 */
266
- type NotificationEventType = 'CALL_RINGING' | 'CALL_ANSWERED' | 'EventCallCDR' | 'AXB_BOUND';
267
- /** 通知数据的来源形状:可选 X/B 号码与成对省市;xnumber 缺失与显式 null 是两种不同事实。 */
309
+ /** 通知事件类型:来源上报的事件原名。 */
310
+ type NotificationEventType = 'CALL_RINGING' | 'CALL_ANSWERED';
311
+ /** 通知数据:呼叫会话标识,与 sessionID 同值;外呼时 FS 取 SIP 头 X-Uui 第一段作为 sessionID,即呼前取号返回的 callSessionId。 */
268
312
  interface NotificationEventData {
269
- /** 来源号码;缺失时不出现,null 与空串原样保留,不补值、不推断。 */
270
- readonly xnumber?: string | null;
271
- /** AXB 回调 B 号;仅号码来自回调时出现,供匹配当前外呼的拨打号码。 */
272
- readonly bnumber?: string;
273
- /** X 号码归属省区;非空字符串,≤32 字符,省市任一非法或缺失时两项一起省略。 */
274
- readonly xprovince?: string;
275
- /** X 号码归属城市;与 xprovince 成对出现。 */
276
- readonly xcity?: string;
313
+ /** 与外呼快照 callSessionId 相同时,该通知属于这次外呼;非空,≤128 字符。 */
314
+ readonly callSessionId: string;
277
315
  }
278
316
  /**
279
317
  * 独立业务通知的来源投影(WS-01 契约补充 §3)。
@@ -294,7 +332,7 @@ interface NotificationEvent {
294
332
  readonly eventType: NotificationEventType;
295
333
  /** 来源确认接收成功时的 UTC 毫秒时刻,不保证源业务顺序 */
296
334
  readonly occurredAt: IsoDateTime;
297
- /** 可选号码段;来源未给出时整段缺失 */
335
+ /** 呼叫会话标识;来源当前始终下发,契约上仍可整段缺失 */
298
336
  readonly data?: NotificationEventData;
299
337
  }
300
338
  interface CallCenterEventMap {
@@ -428,7 +466,7 @@ interface AgentsApi {
428
466
  disable(agentId: string): Promise<AgentResource>;
429
467
  }
430
468
  /** 本 SDK 消费的后端 HTTP 契约版本(openapi-v1.yaml info.version) */
431
- declare const CONTRACT_VERSION: "0.15.0";
469
+ declare const CONTRACT_VERSION: "0.19.0";
432
470
 
433
471
  /** 宿主稳定门面;仅描述已验收能力,不从内部实现推导额外类型。 */
434
472
  interface CallCenter {
@@ -473,15 +511,6 @@ interface CallCenter {
473
511
  * 加载器按此返回;同一大版本内只允许向后兼容的新增,不删除、不改名、不改语义。
474
512
  */
475
513
 
476
- /** 服务端随 Ticket 下发的 SDK 信息(Ticket 响应 data.sdk),宿主原样交给加载器。 */
477
- interface SdkDelivery {
478
- /** 运行时完整版本号,如 1.2.3。 */
479
- readonly version: string;
480
- /** 带 CDN 签名的运行时地址;不含 Ticket,签名有效期有限,需用本次签发的值。 */
481
- readonly url: string;
482
- /** 运行时文件的 SRI 值(sha384-...),浏览器据此校验下载内容。 */
483
- readonly integrity: string;
484
- }
485
514
  /** mountPanel 选项。 */
486
515
  interface PanelOptions {
487
516
  /** 宿主创建的唯一 Core 实例;面板只订阅和调用,不销毁。 */
@@ -492,6 +521,11 @@ interface PanelOptions {
492
521
  readonly contactName?: string;
493
522
  /** 宿主可选展示的补充说明,不参与通话资格判断。 */
494
523
  readonly supplementaryInfo?: string;
524
+ /**
525
+ * 是否以页面顶部 toast 提示面板错误,默认开启,仅挂载时读取。
526
+ * 关闭后面板不显示任何错误提示,宿主依错误码与 sdk.error 事件自行提示。
527
+ */
528
+ readonly toast?: boolean;
495
529
  }
496
530
  /** 可在挂载后更新的展示字段;initiallyVisible 只在挂载时读取,不在此列。 */
497
531
  type PanelUpdateOptions = Partial<Pick<PanelOptions, 'contactName' | 'supplementaryInfo'>>;
@@ -523,10 +557,12 @@ interface ImkAgentSdkRuntime {
523
557
  readonly version: string;
524
558
  /**
525
559
  * 创建 Core 实例;创建本身不发请求。
526
- * @param options 实例选项
560
+ * 经 loadAgentSdk 取得的运行时已绑定本次 sdk,宿主不传服务地址:`createCallCenter()`。
561
+ * @param options 实例选项,可省略;apiBaseUrl、wsUrl 已弃用,显式传入时优先
527
562
  * @returns 宿主唯一的 CallCenter 实例,由宿主负责 destroy
563
+ * @throws CallCenterError INVALID_ARGUMENT:选项不合法,或既无 apiBaseUrl 也无 sdk.apiBaseUrl
528
564
  */
529
- createCallCenter(options: CallCenterOptions): CallCenter;
565
+ createCallCenter(options?: CallCenterOptions): CallCenter;
530
566
  /**
531
567
  * 在目标元素内以 Shadow DOM 挂载通话面板;不需要界面的宿主可不调用。
532
568
  * @param target CSS 选择器或元素
@@ -543,16 +579,9 @@ declare global {
543
579
  }
544
580
  }
545
581
 
546
- /**
547
- * 按服务端下发的 SdkDelivery 注入运行时脚本,等待加载完成后返回 window.ImkAgentSdk。
548
- *
549
- * 客户通过本包锁定大版本;大版本内的小版本由服务端版本指针决定。
550
- * 同一页面只加载一次运行时,已运行的代码不会被替换,新版本在刷新页面后生效。
551
- */
552
-
553
582
  /** 加载失败的稳定错误码。 */
554
583
  type AgentSdkLoadErrorCode =
555
- /** sdk 参数缺失或字段不是非空字符串。 */
584
+ /** sdk 参数缺失、字段不是非空字符串,或 apiBaseUrl 不是合法 http(s) 基址。 */
556
585
  'INVALID_ARGUMENT'
557
586
  /** 下发版本或页面已加载的运行时与本加载器大版本不一致,需升级加载器包。 */
558
587
  | 'MAJOR_VERSION_MISMATCH'
@@ -571,10 +600,11 @@ declare class AgentSdkLoadError extends Error {
571
600
  /**
572
601
  * 加载服务端下发的 SDK 运行时。
573
602
  *
574
- * 同一页面重复调用返回同一个运行时;页面已通过原生脚本加载时直接采用。
603
+ * 同一页面重复调用只加载一次运行时;页面已通过原生脚本加载时直接采用。
575
604
  * 已加载版本与本次 sdk.version 不同时不替换,console 提示刷新页面后生效。
605
+ * 返回值绑定本次 sdk(见 {@link bind}),createCallCenter() 无需传服务地址。
576
606
  * @param sdk Ticket 响应中的 data.sdk,原样传入
577
- * @returns window.ImkAgentSdk
607
+ * @returns 绑定本次 sdk 的 window.ImkAgentSdk 包装
578
608
  * @throws AgentSdkLoadError INVALID_ARGUMENT / MAJOR_VERSION_MISMATCH / LOAD_FAILED
579
609
  */
580
610
  declare function loadAgentSdk(sdk: SdkDelivery): Promise<ImkAgentSdkRuntime>;
package/dist/index.d.ts CHANGED
@@ -7,7 +7,7 @@
7
7
  * 错误对象与消息都已脱敏:不含 Token、密码、请求体和服务端原始报文。
8
8
  */
9
9
  /** 后端契约错误码(http-contract.md §12) */
10
- type ServerErrorCode = 'BAD_REQUEST' | 'VALIDATION_ERROR' | 'TOKEN_MISSING' | 'TOKEN_INVALID' | 'TOKEN_EXPIRED' | 'SESSION_REVOKED' | 'SESSION_EXPIRED' | 'TICKET_INVALID' | 'TICKET_EXPIRED' | 'TICKET_USED' | 'REFRESH_TOKEN_INVALID' | 'REFRESH_TOKEN_REPLAYED' | 'REFRESH_NOT_COMMITTED' | 'PERMISSION_DENIED' | 'APP_DISABLED' | 'AGENT_DISABLED' | 'AGENT_NOT_FOUND' | 'AGENT_ALREADY_EXISTS' | 'CALL_CONTROL_REJECTED' | 'AGENT_SIP_NOT_READY' | 'AGENT_CONFLICT' | 'RATE_LIMITED' | 'INTERNAL_ERROR' | 'PROVIDER_BAD_RESPONSE' | 'SERVICE_UNAVAILABLE' | 'SIP_CREDENTIAL_UNAVAILABLE' | 'PROVIDER_TIMEOUT' | 'NOT_FOUND' | 'METHOD_NOT_ALLOWED' | 'UNSUPPORTED_MEDIA_TYPE';
10
+ type ServerErrorCode = 'BAD_REQUEST' | 'VALIDATION_ERROR' | 'TOKEN_MISSING' | 'TOKEN_INVALID' | 'TOKEN_EXPIRED' | 'SESSION_REVOKED' | 'SESSION_EXPIRED' | 'TICKET_INVALID' | 'TICKET_EXPIRED' | 'TICKET_USED' | 'REFRESH_TOKEN_INVALID' | 'REFRESH_TOKEN_REPLAYED' | 'REFRESH_NOT_COMMITTED' | 'PERMISSION_DENIED' | 'APP_DISABLED' | 'AGENT_DISABLED' | 'AGENT_NOT_FOUND' | 'AGENT_ALREADY_EXISTS' | 'CALL_CONTROL_REJECTED' | 'AGENT_SIP_NOT_READY' | 'AGENT_CONFLICT' | 'RATE_LIMITED' | 'INTERNAL_ERROR' | 'PROVIDER_BAD_RESPONSE' | 'SERVICE_UNAVAILABLE' | 'SIP_CREDENTIAL_UNAVAILABLE' | 'PROVIDER_TIMEOUT' | 'NOT_FOUND' | 'METHOD_NOT_ALLOWED' | 'UNSUPPORTED_MEDIA_TYPE' | 'NUMBER_UNAVAILABLE' | 'CALLEE_CALLING';
11
11
  /** SDK 本地错误码 */
12
12
  type SdkErrorCode = 'DESTROYED' | 'NOT_INITIALIZED' | 'ALREADY_INITIALIZED' | 'INITIALIZE_IN_PROGRESS' | 'INITIALIZE_FAILED' | 'NOT_AUTHENTICATED' | 'COMMAND_IN_PROGRESS' | 'NOT_REGISTERED' | 'REGISTRATION_FAILED' | 'SIGNALING_UNAVAILABLE' | 'INVALID_NUMBER' | 'INVALID_ARGUMENT' | 'CALL_IN_PROGRESS' | 'CALL_NOT_FOUND' | 'INVALID_CALL_STATE' | 'CALL_STATE_CHANGED' | 'CALL_STATE_UNKNOWN' | 'CALL_ENDED' | 'HOLD_TRANSITION_IN_PROGRESS' | 'HOLD_FAILED' | 'HOLD_TIMEOUT' | 'MEDIA_PERMISSION_DENIED' | 'MEDIA_DEVICE_UNAVAILABLE' | 'NETWORK_ERROR' | 'TIMEOUT' | 'ABORTED';
13
13
  type ErrorCode = ServerErrorCode | SdkErrorCode;
@@ -47,9 +47,31 @@ interface DiagnosticEntry {
47
47
  readonly code: string;
48
48
  readonly at: number;
49
49
  }
50
+ /** 服务端随 Ticket 下发的 SDK 信息(Ticket 响应 data.sdk),宿主原样传入,不理解其内容。 */
51
+ interface SdkDelivery {
52
+ /** 运行时完整版本号,如 1.2.3。 */
53
+ readonly version: string;
54
+ /** 带 CDN 签名的运行时地址;不含 Ticket,签名有效期有限,需用本次签发的值。 */
55
+ readonly url: string;
56
+ /** 运行时文件的 SRI 值(sha384-...),浏览器据此校验下载内容。 */
57
+ readonly integrity: string;
58
+ /** 浏览器 SDK 服务基址(HTTP v0.16.0 起下发);可选以兼容未升级的服务端。 */
59
+ readonly apiBaseUrl?: string;
60
+ }
50
61
  interface CallCenterOptions {
51
- readonly apiBaseUrl: string;
52
- /** 业务通知 WS 地址(ws/wss);不传则不建立通知连接,SIP 与 HTTP 行为不变。 */
62
+ /**
63
+ * 服务端随 Ticket 下发的 SDK 信息;未显式传 apiBaseUrl 时取其中的 apiBaseUrl。
64
+ * 经加载器创建时由加载器填入服务基址,宿主无需传入。
65
+ */
66
+ readonly sdk?: SdkDelivery;
67
+ /**
68
+ * @deprecated 服务基址改由服务端随 Ticket 下发(sdk.apiBaseUrl),宿主不再配置;显式传入时优先使用。
69
+ */
70
+ readonly apiBaseUrl?: string;
71
+ /**
72
+ * @deprecated 通知地址改由服务端随登录结果下发,宿主不再配置;显式传入(ws/wss)时优先使用,
73
+ * 未传时按每次登录结果建立,登录结果不含通知地址则不建立通知连接。
74
+ */
53
75
  readonly wsUrl?: string;
54
76
  readonly device?: DeviceInfo;
55
77
  readonly requestTimeoutMs?: number;
@@ -120,24 +142,26 @@ interface CallSnapshot {
120
142
  readonly callId: string;
121
143
  readonly direction: 'outbound' | 'inbound';
122
144
  readonly status: CallStatus;
123
- /** 外呼为目标号码,回呼为 INVITE 的 anumber。 */
145
+ /** 外呼为目标号码,回呼为 INVITE From 的号码(anumber)。 */
124
146
  readonly remoteNumber: string;
125
- /** 回呼原始号码;三个请求头全部校验完成后才随来电快照发布,不受 setDisplay 修改影响。 */
147
+ /** 回呼原始号码;From、To 及出现时的 bnumber 头校验完成后才随来电快照发布,不受 setDisplay 修改影响。 */
126
148
  readonly callbackNumbers?: {
127
- /** 来电主号码。 */
149
+ /** 来电主号码,取自 INVITE From。 */
128
150
  readonly anumber: string;
129
- /** 被叫号码。 */
130
- readonly bnumber: string;
131
- /** 外显号码。 */
151
+ /** 被叫号码,取自 INVITE 的可选 bnumber 头;FS 未下发时缺失。 */
152
+ readonly bnumber?: string;
153
+ /** 外显号码,取自 INVITE To。 */
132
154
  readonly xnumber: string;
133
155
  };
134
156
  readonly display?: CallDisplay;
135
157
  /**
136
- * 外呼经 AXB 分配的外显号码(WS-10):仅当业务通知的 bnumber 与本次拨打号码完全一致时写入,
137
- * 来电与未匹配的外呼不携带;更新通过同状态 call.status 发布,不改变通话状态。
158
+ * 外呼的呼叫会话标识(HTTP v0.17.0 呼前取号返回):与振铃/应答通知的 data.callSessionId 相同,
159
+ * 宿主据此判断通知是否属于本次外呼;随外呼首个快照写入且不再改变,来电不携带。
138
160
  */
161
+ readonly callSessionId?: string;
162
+ /** 外呼的外显号码(X 号码,INVITE 目标):取自呼前取号结果,随首个快照写入且不再改变;来电不携带。 */
139
163
  readonly xnumber?: string;
140
- /** 外呼 X 号码归属省区;仅省市齐全时随号码写入;同号后续缺失保留,换号且无省市时清除。 */
164
+ /** 外呼 X 号码归属省区;呼前取号同时返回省市时写入,否则与 xcity 一起缺失。 */
141
165
  readonly xprovince?: string;
142
166
  /** 外呼 X 号码归属城市;与 xprovince 成对出现。 */
143
167
  readonly xcity?: string;
@@ -158,13 +182,33 @@ interface CallSnapshot {
158
182
  */
159
183
  readonly sipStatus?: number;
160
184
  }
161
- /** 外呼可选展示信息,不作为号码路由或客户接听证据。 */
185
+ /** 外呼可选展示信息与通话记录字段,不作为号码路由或客户接听证据。 */
162
186
  interface DialOptions {
163
187
  readonly display?: CallDisplay;
188
+ /**
189
+ * 被叫姓名(HTTP v0.18.0):随呼前取号透传,写入外呼通话记录;不超过 64 个字符(按 Unicode 码点计),
190
+ * 原样提交、不裁剪。不传则正文不带、记录该列为空;不合规在本地以 INVALID_ARGUMENT reject,不发 HTTP。不影响展示。
191
+ */
192
+ readonly calleeName?: string;
193
+ /**
194
+ * 发起端(HTTP v0.18.0):'PC' 或 'APP',大小写敏感;随呼前取号透传,写入外呼通话记录。
195
+ * 不传则正文不带、记录该列为空;其他值在本地以 INVALID_ARGUMENT reject,不发 HTTP。
196
+ */
197
+ readonly source?: 'PC' | 'APP';
164
198
  }
165
199
  /** 一键拨打只等待当前在途准备,不领取 Ticket 或发起注册。 */
166
200
  interface QuickDialOptions {
167
201
  readonly display?: CallDisplay;
202
+ /**
203
+ * 被叫姓名(HTTP v0.18.0):随呼前取号透传,写入外呼通话记录;不超过 64 个字符(按 Unicode 码点计),
204
+ * 原样提交、不裁剪。不传则正文不带、记录该列为空;不合规在本地以 INVALID_ARGUMENT reject,不发 HTTP。不影响展示。
205
+ */
206
+ readonly calleeName?: string;
207
+ /**
208
+ * 发起端(HTTP v0.18.0):'PC' 或 'APP',大小写敏感;随呼前取号透传,写入外呼通话记录。
209
+ * 不传则正文不带、记录该列为空;其他值在本地以 INVALID_ARGUMENT reject,不发 HTTP。
210
+ */
211
+ readonly source?: 'PC' | 'APP';
168
212
  /** 认证中、登录连接材料 加载或注册中的等待上限,默认 10000 毫秒。 */
169
213
  readonly waitMs?: number;
170
214
  }
@@ -262,18 +306,12 @@ interface CallCenterState {
262
306
  readonly workStatus: WorkStatus | null;
263
307
  }
264
308
  type BackgroundPhase = 'refresh' | 'credentials' | 'registration' | 'signaling' | 'media';
265
- /** 通知事件类型:来源上报的三种事件原名,及 AXB 回调晚于振铃时单独推送的 AXB_BOUND。 */
266
- type NotificationEventType = 'CALL_RINGING' | 'CALL_ANSWERED' | 'EventCallCDR' | 'AXB_BOUND';
267
- /** 通知数据的来源形状:可选 X/B 号码与成对省市;xnumber 缺失与显式 null 是两种不同事实。 */
309
+ /** 通知事件类型:来源上报的事件原名。 */
310
+ type NotificationEventType = 'CALL_RINGING' | 'CALL_ANSWERED';
311
+ /** 通知数据:呼叫会话标识,与 sessionID 同值;外呼时 FS 取 SIP 头 X-Uui 第一段作为 sessionID,即呼前取号返回的 callSessionId。 */
268
312
  interface NotificationEventData {
269
- /** 来源号码;缺失时不出现,null 与空串原样保留,不补值、不推断。 */
270
- readonly xnumber?: string | null;
271
- /** AXB 回调 B 号;仅号码来自回调时出现,供匹配当前外呼的拨打号码。 */
272
- readonly bnumber?: string;
273
- /** X 号码归属省区;非空字符串,≤32 字符,省市任一非法或缺失时两项一起省略。 */
274
- readonly xprovince?: string;
275
- /** X 号码归属城市;与 xprovince 成对出现。 */
276
- readonly xcity?: string;
313
+ /** 与外呼快照 callSessionId 相同时,该通知属于这次外呼;非空,≤128 字符。 */
314
+ readonly callSessionId: string;
277
315
  }
278
316
  /**
279
317
  * 独立业务通知的来源投影(WS-01 契约补充 §3)。
@@ -294,7 +332,7 @@ interface NotificationEvent {
294
332
  readonly eventType: NotificationEventType;
295
333
  /** 来源确认接收成功时的 UTC 毫秒时刻,不保证源业务顺序 */
296
334
  readonly occurredAt: IsoDateTime;
297
- /** 可选号码段;来源未给出时整段缺失 */
335
+ /** 呼叫会话标识;来源当前始终下发,契约上仍可整段缺失 */
298
336
  readonly data?: NotificationEventData;
299
337
  }
300
338
  interface CallCenterEventMap {
@@ -428,7 +466,7 @@ interface AgentsApi {
428
466
  disable(agentId: string): Promise<AgentResource>;
429
467
  }
430
468
  /** 本 SDK 消费的后端 HTTP 契约版本(openapi-v1.yaml info.version) */
431
- declare const CONTRACT_VERSION: "0.15.0";
469
+ declare const CONTRACT_VERSION: "0.19.0";
432
470
 
433
471
  /** 宿主稳定门面;仅描述已验收能力,不从内部实现推导额外类型。 */
434
472
  interface CallCenter {
@@ -473,15 +511,6 @@ interface CallCenter {
473
511
  * 加载器按此返回;同一大版本内只允许向后兼容的新增,不删除、不改名、不改语义。
474
512
  */
475
513
 
476
- /** 服务端随 Ticket 下发的 SDK 信息(Ticket 响应 data.sdk),宿主原样交给加载器。 */
477
- interface SdkDelivery {
478
- /** 运行时完整版本号,如 1.2.3。 */
479
- readonly version: string;
480
- /** 带 CDN 签名的运行时地址;不含 Ticket,签名有效期有限,需用本次签发的值。 */
481
- readonly url: string;
482
- /** 运行时文件的 SRI 值(sha384-...),浏览器据此校验下载内容。 */
483
- readonly integrity: string;
484
- }
485
514
  /** mountPanel 选项。 */
486
515
  interface PanelOptions {
487
516
  /** 宿主创建的唯一 Core 实例;面板只订阅和调用,不销毁。 */
@@ -492,6 +521,11 @@ interface PanelOptions {
492
521
  readonly contactName?: string;
493
522
  /** 宿主可选展示的补充说明,不参与通话资格判断。 */
494
523
  readonly supplementaryInfo?: string;
524
+ /**
525
+ * 是否以页面顶部 toast 提示面板错误,默认开启,仅挂载时读取。
526
+ * 关闭后面板不显示任何错误提示,宿主依错误码与 sdk.error 事件自行提示。
527
+ */
528
+ readonly toast?: boolean;
495
529
  }
496
530
  /** 可在挂载后更新的展示字段;initiallyVisible 只在挂载时读取,不在此列。 */
497
531
  type PanelUpdateOptions = Partial<Pick<PanelOptions, 'contactName' | 'supplementaryInfo'>>;
@@ -523,10 +557,12 @@ interface ImkAgentSdkRuntime {
523
557
  readonly version: string;
524
558
  /**
525
559
  * 创建 Core 实例;创建本身不发请求。
526
- * @param options 实例选项
560
+ * 经 loadAgentSdk 取得的运行时已绑定本次 sdk,宿主不传服务地址:`createCallCenter()`。
561
+ * @param options 实例选项,可省略;apiBaseUrl、wsUrl 已弃用,显式传入时优先
527
562
  * @returns 宿主唯一的 CallCenter 实例,由宿主负责 destroy
563
+ * @throws CallCenterError INVALID_ARGUMENT:选项不合法,或既无 apiBaseUrl 也无 sdk.apiBaseUrl
528
564
  */
529
- createCallCenter(options: CallCenterOptions): CallCenter;
565
+ createCallCenter(options?: CallCenterOptions): CallCenter;
530
566
  /**
531
567
  * 在目标元素内以 Shadow DOM 挂载通话面板;不需要界面的宿主可不调用。
532
568
  * @param target CSS 选择器或元素
@@ -543,16 +579,9 @@ declare global {
543
579
  }
544
580
  }
545
581
 
546
- /**
547
- * 按服务端下发的 SdkDelivery 注入运行时脚本,等待加载完成后返回 window.ImkAgentSdk。
548
- *
549
- * 客户通过本包锁定大版本;大版本内的小版本由服务端版本指针决定。
550
- * 同一页面只加载一次运行时,已运行的代码不会被替换,新版本在刷新页面后生效。
551
- */
552
-
553
582
  /** 加载失败的稳定错误码。 */
554
583
  type AgentSdkLoadErrorCode =
555
- /** sdk 参数缺失或字段不是非空字符串。 */
584
+ /** sdk 参数缺失、字段不是非空字符串,或 apiBaseUrl 不是合法 http(s) 基址。 */
556
585
  'INVALID_ARGUMENT'
557
586
  /** 下发版本或页面已加载的运行时与本加载器大版本不一致,需升级加载器包。 */
558
587
  | 'MAJOR_VERSION_MISMATCH'
@@ -571,10 +600,11 @@ declare class AgentSdkLoadError extends Error {
571
600
  /**
572
601
  * 加载服务端下发的 SDK 运行时。
573
602
  *
574
- * 同一页面重复调用返回同一个运行时;页面已通过原生脚本加载时直接采用。
603
+ * 同一页面重复调用只加载一次运行时;页面已通过原生脚本加载时直接采用。
575
604
  * 已加载版本与本次 sdk.version 不同时不替换,console 提示刷新页面后生效。
605
+ * 返回值绑定本次 sdk(见 {@link bind}),createCallCenter() 无需传服务地址。
576
606
  * @param sdk Ticket 响应中的 data.sdk,原样传入
577
- * @returns window.ImkAgentSdk
607
+ * @returns 绑定本次 sdk 的 window.ImkAgentSdk 包装
578
608
  * @throws AgentSdkLoadError INVALID_ARGUMENT / MAJOR_VERSION_MISMATCH / LOAD_FAILED
579
609
  */
580
610
  declare function loadAgentSdk(sdk: SdkDelivery): Promise<ImkAgentSdkRuntime>;
package/dist/index.js CHANGED
@@ -19,10 +19,28 @@ function majorOf(version) {
19
19
  return match ? Number(match[1]) : null;
20
20
  }
21
21
  var INTEGRITY_PATTERN = /^sha384-[A-Za-z0-9+/]{64}$/;
22
+ function isApiBaseUrl(value) {
23
+ if (typeof value !== "string") return false;
24
+ try {
25
+ const url = new URL(value);
26
+ return (url.protocol === "https:" || url.protocol === "http:") && !url.username && !url.password && !url.search && !url.hash;
27
+ } catch {
28
+ return false;
29
+ }
30
+ }
22
31
  function isDelivery(sdk) {
23
32
  if (typeof sdk !== "object" || sdk === null) return false;
24
- const { version, url, integrity } = sdk;
25
- return [version, url].every((field) => typeof field === "string" && field !== "") && typeof integrity === "string" && INTEGRITY_PATTERN.test(integrity);
33
+ const { version, url, integrity, apiBaseUrl } = sdk;
34
+ return [version, url].every((field) => typeof field === "string" && field !== "") && typeof integrity === "string" && INTEGRITY_PATTERN.test(integrity) && (apiBaseUrl === void 0 || isApiBaseUrl(apiBaseUrl));
35
+ }
36
+ function bind(runtime, sdk) {
37
+ return Object.freeze({
38
+ version: runtime.version,
39
+ createCallCenter: (options = {}) => runtime.createCallCenter(
40
+ options.apiBaseUrl === void 0 && sdk.apiBaseUrl !== void 0 ? { ...options, apiBaseUrl: sdk.apiBaseUrl } : options
41
+ ),
42
+ mountPanel: (...args) => runtime.mountPanel(...args)
43
+ });
26
44
  }
27
45
  function adopt(runtime, sdk) {
28
46
  if (majorOf(runtime.version) !== SUPPORTED_MAJOR)
@@ -60,17 +78,17 @@ async function loadAgentSdk(sdk) {
60
78
  if (!isDelivery(sdk))
61
79
  throw new AgentSdkLoadError(
62
80
  "INVALID_ARGUMENT",
63
- "sdk \u9700\u5305\u542B\u975E\u7A7A\u7684 version\u3001url \u53CA sha384 \u683C\u5F0F\u7684 integrity"
81
+ "sdk \u9700\u5305\u542B\u975E\u7A7A\u7684 version\u3001url\u3001sha384 \u683C\u5F0F\u7684 integrity\uFF0CapiBaseUrl \u5B58\u5728\u65F6\u987B\u4E3A\u5408\u6CD5 http(s) \u57FA\u5740"
64
82
  );
65
83
  if (majorOf(sdk.version) !== SUPPORTED_MAJOR)
66
84
  throw new AgentSdkLoadError("MAJOR_VERSION_MISMATCH", "\u670D\u52A1\u7AEF\u4E0B\u53D1\u7684\u8FD0\u884C\u65F6\u5927\u7248\u672C\u4E0E\u52A0\u8F7D\u5668\u4E0D\u4E00\u81F4");
67
85
  const loaded = window.ImkAgentSdk;
68
- if (loaded) return adopt(loaded, sdk);
86
+ if (loaded) return bind(adopt(loaded, sdk), sdk);
69
87
  pending ??= inject(sdk).catch((error) => {
70
88
  pending = null;
71
89
  throw error;
72
90
  });
73
- return adopt(await pending, sdk);
91
+ return bind(adopt(await pending, sdk), sdk);
74
92
  }
75
93
  export {
76
94
  AgentSdkLoadError,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ztlink-imk/ztlinkcloud-agent-sdk",
3
- "version": "1.0.1",
3
+ "version": "1.0.3",
4
4
  "license": "UNLICENSED",
5
5
  "description": "IMK 呼叫中心坐席 SDK 加载器与公共类型:按服务端下发的地址加载 SDK 运行时",
6
6
  "type": "module",
@@ -20,13 +20,14 @@
20
20
  "./package.json": "./package.json"
21
21
  },
22
22
  "devDependencies": {
23
- "@imk/agent-core": "1.0.1"
23
+ "@imk/agent-core": "1.0.5"
24
24
  },
25
25
  "publishConfig": {
26
26
  "access": "public"
27
27
  },
28
28
  "scripts": {
29
29
  "build": "tsup",
30
- "typecheck": "tsc -p tsconfig.json"
30
+ "typecheck": "tsc -p tsconfig.json",
31
+ "test": "vitest run"
31
32
  }
32
33
  }