gws-client 0.6.4 → 1.0.0

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.
Files changed (2) hide show
  1. package/README.md +33 -33
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -2,9 +2,9 @@
2
2
 
3
3
  用于web前端调用GZCA数字证书客户端UKEY证书应用接口,调用前需确保已安装GZCA数字证书客户端并启动,支持TypeScript。
4
4
 
5
- ## 快速开始
5
+ ## 1 快速开始
6
6
 
7
- ### 安装
7
+ ### 1.1 安装
8
8
 
9
9
  #### 使用包管理器
10
10
 
@@ -26,7 +26,7 @@ Install with pnpm
26
26
  pnpm add gws-client
27
27
  ```
28
28
 
29
- ### 使用
29
+ ### 1.2 使用
30
30
 
31
31
  #### ES Module
32
32
 
@@ -84,7 +84,7 @@ async function foo() {
84
84
  | onError | 可选,socket错误时回调 | `(event: Event) => void` | -- |
85
85
  | onClose | 可选,socket关闭时回调 | `(event: Event) => void` | -- |
86
86
  | onMessage | 可选,socket收到消息时回调 | `(data: Record<string, any>) => void` | -- |
87
- | onUkeyChange | 可选,Ukey插入拔出时回调 | `(event: {type: 'remove' \| 'insert', data: CertType}) => void` | -- |
87
+ | onUkeyChange | 可选,Ukey插入拔出时回调 | `(event: {type: 'remove' \| 'insert', data: CertType}) => void` | -- |
88
88
  | theme | 可选,弹窗主题色 | `String` | `#409eff` |
89
89
 
90
90
  #### 示例
@@ -124,9 +124,9 @@ async function pkcs1Sign() {
124
124
  }
125
125
  ```
126
126
 
127
- ## API接口
127
+ ## 2 API接口
128
128
 
129
- ### 销毁
129
+ ### 2.1 销毁
130
130
 
131
131
  断开socket连接
132
132
 
@@ -140,7 +140,7 @@ destroy
140
140
  type Destroy = () => void;
141
141
  ```
142
142
 
143
- ### 重启
143
+ ### 2.2 重启
144
144
 
145
145
  重新连接socket,可重新传入新配置
146
146
 
@@ -154,7 +154,7 @@ restart
154
154
  type Restart = (config?: GwsServiceConfigType) => void;
155
155
  ```
156
156
 
157
- ### 获取签名证书
157
+ ### 2.3 获取签名证书
158
158
 
159
159
  获取签名证书,可获取证书CN项,证书CertB64,sn
160
160
 
@@ -168,7 +168,7 @@ getSignatureCert
168
168
  type GetSignatureCert = (cert?: CertType) => Promise<CertType>;
169
169
  ```
170
170
 
171
- ### 获取签名证书列表
171
+ ### 2.4 获取签名证书列表
172
172
 
173
173
  获取签名证书列表
174
174
 
@@ -182,7 +182,7 @@ getSignatureCertList
182
182
  type GetSignatureCertList = () => Promise<CertType[]>;
183
183
  ```
184
184
 
185
- ### 获取加密证书
185
+ ### 2.5 获取加密证书
186
186
 
187
187
  获取加密证书,可获取证书CN项,证书CertB64,sn
188
188
 
@@ -196,7 +196,7 @@ getEncryptionCert
196
196
  type GetEncryptionCert = (cert?: CertType) => Promise<CertType>;
197
197
  ```
198
198
 
199
- ### 获取加密证书列表
199
+ ### 2.6 获取加密证书列表
200
200
 
201
201
  获取加密证书列表
202
202
 
@@ -210,7 +210,7 @@ getEncryptionCertList
210
210
  type GetEncryptionCertList = () => Promise<CertType[]>;
211
211
  ```
212
212
 
213
- ### 获取证书详情
213
+ ### 2.7 获取证书详情
214
214
 
215
215
  获取证书详情,可获取证书公钥CertPublicKey,证书序列号CertSerial,证书有效期CertValidTime
216
216
 
@@ -232,7 +232,7 @@ type GetCertInfo = (params: {
232
232
  | ------- | ---------------- | -------- | ------ |
233
233
  | CertB64 | 必填,证书Base64 | `String` | -- |
234
234
 
235
- ### PKCS1签名
235
+ ### 2.8 PKCS1签名
236
236
 
237
237
  PKCS1签名,返回签名值
238
238
 
@@ -256,7 +256,7 @@ type Pkcs1Sign = (
256
256
  | Data | 必填,待签名原文 | `String` | -- |
257
257
  | IsLogin | 可选,证书登录状态 | `Y` \| `N` | -- |
258
258
 
259
- ### PKCS1验签
259
+ ### 2.9 PKCS1验签
260
260
 
261
261
  PKCS1验签,传入curCert时使用该证书,返回验签结果,`true`为验签成功,验签失败时返回`Promise.reject`
262
262
 
@@ -285,7 +285,7 @@ type Pkcs1VerifySignature = (
285
285
  | SignData | 必填,Base64编码的签名值 | `String` | -- |
286
286
  | CertB64 | 可选,Base64编码的签名证书 | `String` | -- |
287
287
 
288
- ### PKCS1 B64签名
288
+ ### 2.10 PKCS1 B64签名
289
289
 
290
290
  PKCS1 base64签名,传入curCert时使用该证书,返回签名值
291
291
 
@@ -311,7 +311,7 @@ type Pkcs1Base64Sign = (params: {
311
311
  | DataB64 | 与Data二选一 , Base64编码的待签名原文,同时存在时使用DataB64 | `String` | -- |
312
312
  | IsLogin | 可选,证书登录状态 | `Y` \| `N` | -- |
313
313
 
314
- ### PKCS1 B64验签
314
+ ### 2.11 PKCS1 B64验签
315
315
 
316
316
  PKCS1 base64验签,返回验签结果,`true`为验签成功,验签失败时返回`Promise.reject`
317
317
 
@@ -339,7 +339,7 @@ type Pkcs1Base64VerifySignature = (params: {
339
339
  | SignData | 必填,Base64编码的签名值 | `String` | -- |
340
340
  | CertB64 | 可选,Base64编码的签名证书 | `String` | -- |
341
341
 
342
- ### PKCS1哈希签名
342
+ ### 2.12 PKCS1哈希签名
343
343
 
344
344
  PKCS1哈希签名,返回签名值
345
345
 
@@ -366,7 +366,7 @@ type Pkcs1HashSign = (
366
366
  | HashAlg | 可选,哈希算法 | `sm3` \| `sha1`\| `sha256` | `sm3` |
367
367
  | IsLogin | 可选,证书登录状态 | `Y` \| `N` | -- |
368
368
 
369
- ### PKCS1哈希验签
369
+ ### 2.13 PKCS1哈希验签
370
370
 
371
371
  PKCS1哈希验签,返回验签结果,传入curCert时使用该证书,`true`为验签成功,验签失败时返回`Promise.reject`
372
372
 
@@ -394,7 +394,7 @@ type Pkcs1Base64VerifySignature = (params: {
394
394
  | CertB64 | 可选,Base64编码的签名证书 | `String` | -- |
395
395
  | HashAlg | 可选,哈希算法 | `sm3` \| `sha1`\| `sha256` | `sm3` |
396
396
 
397
- ### PKCS7签名
397
+ ### 2.14 PKCS7签名
398
398
 
399
399
  PKCS7签名,返回签名值
400
400
 
@@ -425,7 +425,7 @@ type Pkcs7Sign = (
425
425
  | IsDetached | 必填,Y为detach,N为attach,attach模式签名值带了原文 | `Y` \| `N` | -- |
426
426
  | IsLogin | 可选,证书登录状态 | `Y` \| `N` | -- |
427
427
 
428
- ### PKCS7验签
428
+ ### 2.15 PKCS7验签
429
429
 
430
430
  PKCS7验签,返回验签结果,传入curCert时使用该证书,`true`为验签成功,验签失败时返回`Promise.reject`
431
431
 
@@ -451,7 +451,7 @@ type Pkcs7VerifySignature = (params: {
451
451
  | DataB64 | 与Data二选一 , Base64编码的待签名原文,同时存在时使用DataB64 | `String` | -- |
452
452
  | SignData | 必填,签名值 | `String` | -- |
453
453
 
454
- ### base64编码
454
+ ### 2.16 base64编码
455
455
 
456
456
  base64编码,返回base64编码内容
457
457
 
@@ -471,7 +471,7 @@ type Base64Encode = (params: { Data: string }) => string;
471
471
  | ---- | ---------------------- | -------- | ------ |
472
472
  | Data | 必填,base64待编码内容 | `String` | -- |
473
473
 
474
- ### base64解码
474
+ ### 2.17 base64解码
475
475
 
476
476
  base64解码,返回base64解码内容
477
477
 
@@ -491,7 +491,7 @@ type Base64Decode = (params: { DataB64: string }) => string;
491
491
  | ------- | ---------------------- | -------- | ------ |
492
492
  | DataB64 | 必填,base64待解码内容 | `String` | -- |
493
493
 
494
- ### SM3哈希
494
+ ### 2.18 SM3哈希
495
495
 
496
496
  SM3哈希,返回SM3哈希值
497
497
 
@@ -511,7 +511,7 @@ type Sm3Hash = (params: { Data: string }) => Promise<string>;
511
511
  | ---- | ------------------------ | -------- | ------ |
512
512
  | Data | 必填,待计算杂凑值的原文 | `String` | -- |
513
513
 
514
- ### SM3 B64哈希
514
+ ### 2.19 SM3 B64哈希
515
515
 
516
516
  SM3 B64哈希
517
517
 
@@ -531,7 +531,7 @@ type Sm3HexHash = (params: { DataB64: string }) => Promise<string>;
531
531
  | ------- | ------------------------------ | -------- | ------ |
532
532
  | DataB64 | 必填,待计算杂凑值的原文base64 | `String` | -- |
533
533
 
534
- ### SM3 文件哈希
534
+ ### 2.20 SM3 文件哈希
535
535
 
536
536
  SM3 文件哈希
537
537
 
@@ -551,7 +551,7 @@ type Sm3FileHash = (params: { SrcFile: string }) => Promise<string>;
551
551
  | ------- | ------------------------------------------------------- | -------- | ------ |
552
552
  | SrcFile | 必填,待计算杂凑值的本地文件全路径。建议使用正斜杠(/) | `String` | -- |
553
553
 
554
- ### SM3哈希加密
554
+ ### 2.21 SM3哈希加密
555
555
 
556
556
  SM3哈希加密
557
557
 
@@ -579,7 +579,7 @@ type Sm3HashEncryption = (params: {
579
579
  | Key | 与KeyB64二选一,密钥 | `String` | -- |
580
580
  | KeyB64 | 与Key二选一 , base64编码的密钥,同时存在时使用KeyB64 | `String` | -- |
581
581
 
582
- ### PKCS7加密
582
+ ### 2.22 PKCS7加密
583
583
 
584
584
  PKCS7加密,返回加密字符串
585
585
 
@@ -605,7 +605,7 @@ type Pkcs7Encryption = (params: {
605
605
  | DataB64 | 与Data二选一 , Base64编码的待加密原文,同时存在时使用DataB64 | `String` | -- |
606
606
  | CertB64List | 必填,加密证书base64,多个以\|连接 | `String` | -- |
607
607
 
608
- ### PKCS7解密
608
+ ### 2.23 PKCS7解密
609
609
 
610
610
  PKCS7解密,返回解密字符串
611
611
 
@@ -631,7 +631,7 @@ type Pkcs7Decryption = (params: {
631
631
  | shouldDecodeBase64 | 可选,是否需要base64解码 | `Boolean` | -- |
632
632
  | IsLogin | 可选,证书登录状态 | `Y` \| `N` | -- |
633
633
 
634
- ### 非对称加密
634
+ ### 2.24 非对称加密
635
635
 
636
636
  非对称加密,返回加密字符串
637
637
 
@@ -653,7 +653,7 @@ type AsymmetricDecryption = (params: { Data: string;IsLogin?: string }) => Pro
653
653
  | CertB64 | 可选,加密证书B64 | `String` | -- |
654
654
  | IsLogin | 可选,证书登录状态 | `Y` \| `N` | -- |
655
655
 
656
- ### 非对称解密
656
+ ### 2.25 非对称解密
657
657
 
658
658
  非对称解密,返回解密字符串
659
659
 
@@ -676,7 +676,7 @@ type AsymmetricDecryption = (
676
676
  | ---- | ---------------- | -------- | ------ |
677
677
  | Data | 必填,待解密原文 | `String` | -- |
678
678
 
679
- ### SM4对称加密
679
+ ### 2.26 SM4对称加密
680
680
 
681
681
  SM4对称加密,传入curCert时使用该证书,返回加密字符串,加密密钥
682
682
 
@@ -705,7 +705,7 @@ type Sm4Encryption = (params: {
705
705
  | Data | 加密密文 | `String` |
706
706
  | KeyB64 | Base64对称密钥 | `String` |
707
707
 
708
- ### SM4对称解密
708
+ ### 2.27 SM4对称解密
709
709
 
710
710
  SM4对称解密,返回解密字符串
711
711
 
@@ -729,7 +729,7 @@ type Sm4Decryption = (params: {
729
729
  | Data | 必填,待解密原文 | `String` | -- |
730
730
  | KeyB64 | 必填,Base64对称密钥 | `String` | -- |
731
731
 
732
- ### 获取印章列表
732
+ ### 2.28 获取印章列表
733
733
 
734
734
  获取印章列表,传入curCert时使用该证书,可获取印章SealId
735
735
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "gws-client",
3
- "version": "0.6.4",
3
+ "version": "1.0.0",
4
4
  "type": "module",
5
5
  "module": "dist/index.es.js",
6
6
  "main": "dist/index.cjs.js",