simplex-chat 6.5.0-beta.4.4 → 6.5.1

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.
@@ -6,7 +6,7 @@
6
6
 
7
7
  # Class: ChatApi
8
8
 
9
- Defined in: [src/api.ts:62](../src/api.ts#L62)
9
+ Defined in: [src/api.ts:97](../src/api.ts#L97)
10
10
 
11
11
  Main API class for interacting with the chat core library.
12
12
 
@@ -16,7 +16,7 @@ Main API class for interacting with the chat core library.
16
16
 
17
17
  > `protected` **ctrl\_**: `bigint` \| `undefined`
18
18
 
19
- Defined in: [src/api.ts:68](../src/api.ts#L68)
19
+ Defined in: [src/api.ts:103](../src/api.ts#L103)
20
20
 
21
21
  ## Accessors
22
22
 
@@ -26,7 +26,7 @@ Defined in: [src/api.ts:68](../src/api.ts#L68)
26
26
 
27
27
  > **get** **ctrl**(): `bigint`
28
28
 
29
- Defined in: [src/api.ts:295](../src/api.ts#L295)
29
+ Defined in: [src/api.ts:329](../src/api.ts#L329)
30
30
 
31
31
  Chat controller reference
32
32
 
@@ -42,7 +42,7 @@ Chat controller reference
42
42
 
43
43
  > **get** **initialized**(): `boolean`
44
44
 
45
- Defined in: [src/api.ts:281](../src/api.ts#L281)
45
+ Defined in: [src/api.ts:315](../src/api.ts#L315)
46
46
 
47
47
  Chat controller is initialized
48
48
 
@@ -58,7 +58,7 @@ Chat controller is initialized
58
58
 
59
59
  > **get** **started**(): `boolean`
60
60
 
61
- Defined in: [src/api.ts:288](../src/api.ts#L288)
61
+ Defined in: [src/api.ts:322](../src/api.ts#L322)
62
62
 
63
63
  Chat controller is started
64
64
 
@@ -72,7 +72,7 @@ Chat controller is started
72
72
 
73
73
  > **apiAcceptContactRequest**(`contactReqId`): `Promise`\<`Contact`\>
74
74
 
75
- Defined in: [src/api.ts:697](../src/api.ts#L697)
75
+ Defined in: [src/api.ts:731](../src/api.ts#L731)
76
76
 
77
77
  Accept contact request.
78
78
  Network usage: interactive.
@@ -93,7 +93,7 @@ Network usage: interactive.
93
93
 
94
94
  > **apiAcceptMember**(`groupId`, `groupMemberId`, `memberRole`): `Promise`\<`GroupMember`\>
95
95
 
96
- Defined in: [src/api.ts:517](../src/api.ts#L517)
96
+ Defined in: [src/api.ts:551](../src/api.ts#L551)
97
97
 
98
98
  Accept group member. Requires Admin role.
99
99
  Network usage: background.
@@ -122,7 +122,7 @@ Network usage: background.
122
122
 
123
123
  > **apiAddMember**(`groupId`, `contactId`, `memberRole`): `Promise`\<`GroupMember`\>
124
124
 
125
- Defined in: [src/api.ts:497](../src/api.ts#L497)
125
+ Defined in: [src/api.ts:531](../src/api.ts#L531)
126
126
 
127
127
  Add contact to group. Requires bot to have Admin role.
128
128
  Network usage: interactive.
@@ -151,7 +151,7 @@ Network usage: interactive.
151
151
 
152
152
  > **apiBlockMembersForAll**(`groupId`, `groupMemberIds`, `blocked`): `Promise`\<`void`\>
153
153
 
154
- Defined in: [src/api.ts:537](../src/api.ts#L537)
154
+ Defined in: [src/api.ts:571](../src/api.ts#L571)
155
155
 
156
156
  Block members. Requires Moderator role.
157
157
  Network usage: background.
@@ -180,7 +180,7 @@ Network usage: background.
180
180
 
181
181
  > **apiCancelFile**(`fileId`): `Promise`\<`void`\>
182
182
 
183
- Defined in: [src/api.ts:487](../src/api.ts#L487)
183
+ Defined in: [src/api.ts:521](../src/api.ts#L521)
184
184
 
185
185
  Cancel file.
186
186
  Network usage: background.
@@ -201,7 +201,7 @@ Network usage: background.
201
201
 
202
202
  > **apiChatItemReaction**(`chatType`, `chatId`, `chatItemId`, `add`, `reaction`): `Promise`\<`ChatItemDeletion`[]\>
203
203
 
204
- Defined in: [src/api.ts:461](../src/api.ts#L461)
204
+ Defined in: [src/api.ts:495](../src/api.ts#L495)
205
205
 
206
206
  Add/remove message reaction.
207
207
  Network usage: background.
@@ -238,7 +238,7 @@ Network usage: background.
238
238
 
239
239
  > **apiConnect**(`userId`, `incognito`, `preparedLink?`): `Promise`\<[`ConnReqType`](api.Enumeration.ConnReqType.md)\>
240
240
 
241
- Defined in: [src/api.ts:666](../src/api.ts#L666)
241
+ Defined in: [src/api.ts:700](../src/api.ts#L700)
242
242
 
243
243
  Connect via prepared SimpleX link. The link can be 1-time invitation link, contact address or group link
244
244
  Network usage: interactive.
@@ -267,7 +267,7 @@ Network usage: interactive.
267
267
 
268
268
  > **apiConnectActiveUser**(`connLink`): `Promise`\<[`ConnReqType`](api.Enumeration.ConnReqType.md)\>
269
269
 
270
- Defined in: [src/api.ts:675](../src/api.ts#L675)
270
+ Defined in: [src/api.ts:709](../src/api.ts#L709)
271
271
 
272
272
  Connect via SimpleX link as string in the active user profile.
273
273
  Network usage: interactive.
@@ -288,7 +288,7 @@ Network usage: interactive.
288
288
 
289
289
  > **apiConnectPlan**(`userId`, `connectionLink`): `Promise`\<\[`ConnectionPlan`, `CreatedConnLink`\]\>
290
290
 
291
- Defined in: [src/api.ts:656](../src/api.ts#L656)
291
+ Defined in: [src/api.ts:690](../src/api.ts#L690)
292
292
 
293
293
  Determine SimpleX link type and if the bot is already connected via this link.
294
294
  Network usage: interactive.
@@ -313,7 +313,7 @@ Network usage: interactive.
313
313
 
314
314
  > **apiCreateActiveUser**(`profile?`): `Promise`\<`User`\>
315
315
 
316
- Defined in: [src/api.ts:774](../src/api.ts#L774)
316
+ Defined in: [src/api.ts:849](../src/api.ts#L849)
317
317
 
318
318
  Create new user profile
319
319
  Network usage: no.
@@ -334,7 +334,7 @@ Network usage: no.
334
334
 
335
335
  > **apiCreateGroupLink**(`groupId`, `memberRole`): `Promise`\<`string`\>
336
336
 
337
- Defined in: [src/api.ts:597](../src/api.ts#L597)
337
+ Defined in: [src/api.ts:631](../src/api.ts#L631)
338
338
 
339
339
  Create group link.
340
340
  Network usage: interactive.
@@ -359,7 +359,7 @@ Network usage: interactive.
359
359
 
360
360
  > **apiCreateLink**(`userId`): `Promise`\<`string`\>
361
361
 
362
- Defined in: [src/api.ts:643](../src/api.ts#L643)
362
+ Defined in: [src/api.ts:677](../src/api.ts#L677)
363
363
 
364
364
  Create 1-time invitation link.
365
365
  Network usage: interactive.
@@ -376,11 +376,37 @@ Network usage: interactive.
376
376
 
377
377
  ***
378
378
 
379
+ ### apiCreateMemberContact()
380
+
381
+ > **apiCreateMemberContact**(`groupId`, `groupMemberId`): `Promise`\<`Contact`\>
382
+
383
+ Defined in: [src/api.ts:915](../src/api.ts#L915)
384
+
385
+ Create a direct message contact with a group member.
386
+ Returns the created contact.
387
+ Network usage: interactive.
388
+
389
+ #### Parameters
390
+
391
+ ##### groupId
392
+
393
+ `number`
394
+
395
+ ##### groupMemberId
396
+
397
+ `number`
398
+
399
+ #### Returns
400
+
401
+ `Promise`\<`Contact`\>
402
+
403
+ ***
404
+
379
405
  ### apiCreateUserAddress()
380
406
 
381
407
  > **apiCreateUserAddress**(`userId`): `Promise`\<`CreatedConnLink`\>
382
408
 
383
- Defined in: [src/api.ts:312](../src/api.ts#L312)
409
+ Defined in: [src/api.ts:346](../src/api.ts#L346)
384
410
 
385
411
  Create bot address.
386
412
  Network usage: interactive.
@@ -399,9 +425,9 @@ Network usage: interactive.
399
425
 
400
426
  ### apiDeleteChat()
401
427
 
402
- > **apiDeleteChat**(`chatType`, `chatId`, `deleteMode`): `Promise`\<`void`\>
428
+ > **apiDeleteChat**(`chatType`, `chatId`, `deleteMode?`): `Promise`\<`void`\>
403
429
 
404
- Defined in: [src/api.ts:737](../src/api.ts#L737)
430
+ Defined in: [src/api.ts:771](../src/api.ts#L771)
405
431
 
406
432
  Delete chat.
407
433
  Network usage: background.
@@ -416,7 +442,7 @@ Network usage: background.
416
442
 
417
443
  `number`
418
444
 
419
- ##### deleteMode
445
+ ##### deleteMode?
420
446
 
421
447
  `ChatDeleteMode` = `...`
422
448
 
@@ -430,7 +456,7 @@ Network usage: background.
430
456
 
431
457
  > **apiDeleteChatItems**(`chatType`, `chatId`, `chatItemIds`, `deleteMode`): `Promise`\<`ChatItemDeletion`[]\>
432
458
 
433
- Defined in: [src/api.ts:436](../src/api.ts#L436)
459
+ Defined in: [src/api.ts:470](../src/api.ts#L470)
434
460
 
435
461
  Delete message.
436
462
  Network usage: background.
@@ -463,7 +489,7 @@ Network usage: background.
463
489
 
464
490
  > **apiDeleteGroupLink**(`groupId`): `Promise`\<`void`\>
465
491
 
466
- Defined in: [src/api.ts:619](../src/api.ts#L619)
492
+ Defined in: [src/api.ts:653](../src/api.ts#L653)
467
493
 
468
494
  Delete group link.
469
495
  Network usage: background.
@@ -484,7 +510,7 @@ Network usage: background.
484
510
 
485
511
  > **apiDeleteMemberChatItem**(`groupId`, `chatItemIds`): `Promise`\<`ChatItemDeletion`[]\>
486
512
 
487
- Defined in: [src/api.ts:451](../src/api.ts#L451)
513
+ Defined in: [src/api.ts:485](../src/api.ts#L485)
488
514
 
489
515
  Moderate message. Requires Moderator role (and higher than message author's).
490
516
  Network usage: background.
@@ -509,7 +535,7 @@ Network usage: background.
509
535
 
510
536
  > **apiDeleteUser**(`userId`, `delSMPQueues`, `viewPwd?`): `Promise`\<`void`\>
511
537
 
512
- Defined in: [src/api.ts:804](../src/api.ts#L804)
538
+ Defined in: [src/api.ts:879](../src/api.ts#L879)
513
539
 
514
540
  Delete user profile.
515
541
  Network usage: background.
@@ -538,7 +564,7 @@ Network usage: background.
538
564
 
539
565
  > **apiDeleteUserAddress**(`userId`): `Promise`\<`void`\>
540
566
 
541
- Defined in: [src/api.ts:322](../src/api.ts#L322)
567
+ Defined in: [src/api.ts:356](../src/api.ts#L356)
542
568
 
543
569
  Deletes a user address.
544
570
  Network usage: background.
@@ -559,7 +585,7 @@ Network usage: background.
559
585
 
560
586
  > **apiGetActiveUser**(): `Promise`\<`User` \| `undefined`\>
561
587
 
562
- Defined in: [src/api.ts:754](../src/api.ts#L754)
588
+ Defined in: [src/api.ts:829](../src/api.ts#L829)
563
589
 
564
590
  Get active user profile
565
591
  Network usage: no.
@@ -570,11 +596,40 @@ Network usage: no.
570
596
 
571
597
  ***
572
598
 
599
+ ### apiGetChat()
600
+
601
+ > **apiGetChat**(`chatType`, `chatId`, `count`): `Promise`\<`any`\>
602
+
603
+ Defined in: [src/api.ts:819](../src/api.ts#L819)
604
+
605
+ Get chat items.
606
+ Network usage: no.
607
+
608
+ #### Parameters
609
+
610
+ ##### chatType
611
+
612
+ `ChatType`
613
+
614
+ ##### chatId
615
+
616
+ `number`
617
+
618
+ ##### count
619
+
620
+ `number`
621
+
622
+ #### Returns
623
+
624
+ `Promise`\<`any`\>
625
+
626
+ ***
627
+
573
628
  ### apiGetGroupLink()
574
629
 
575
630
  > **apiGetGroupLink**(`groupId`): `Promise`\<`GroupLink`\>
576
631
 
577
- Defined in: [src/api.ts:628](../src/api.ts#L628)
632
+ Defined in: [src/api.ts:662](../src/api.ts#L662)
578
633
 
579
634
  Get group link.
580
635
  Network usage: no.
@@ -595,7 +650,7 @@ Network usage: no.
595
650
 
596
651
  > **apiGetGroupLinkStr**(`groupId`): `Promise`\<`string`\>
597
652
 
598
- Defined in: [src/api.ts:634](../src/api.ts#L634)
653
+ Defined in: [src/api.ts:668](../src/api.ts#L668)
599
654
 
600
655
  #### Parameters
601
656
 
@@ -613,7 +668,7 @@ Defined in: [src/api.ts:634](../src/api.ts#L634)
613
668
 
614
669
  > **apiGetUserAddress**(`userId`): `Promise`\<`UserContactLink` \| `undefined`\>
615
670
 
616
- Defined in: [src/api.ts:332](../src/api.ts#L332)
671
+ Defined in: [src/api.ts:366](../src/api.ts#L366)
617
672
 
618
673
  Get bot address and settings.
619
674
  Network usage: no.
@@ -634,7 +689,7 @@ Network usage: no.
634
689
 
635
690
  > **apiJoinGroup**(`groupId`): `Promise`\<`GroupInfo`\>
636
691
 
637
- Defined in: [src/api.ts:507](../src/api.ts#L507)
692
+ Defined in: [src/api.ts:541](../src/api.ts#L541)
638
693
 
639
694
  Join group.
640
695
  Network usage: interactive.
@@ -655,7 +710,7 @@ Network usage: interactive.
655
710
 
656
711
  > **apiLeaveGroup**(`groupId`): `Promise`\<`GroupInfo`\>
657
712
 
658
- Defined in: [src/api.ts:557](../src/api.ts#L557)
713
+ Defined in: [src/api.ts:591](../src/api.ts#L591)
659
714
 
660
715
  Leave group.
661
716
  Network usage: background.
@@ -676,7 +731,7 @@ Network usage: background.
676
731
 
677
732
  > **apiListContacts**(`userId`): `Promise`\<`Contact`[]\>
678
733
 
679
- Defined in: [src/api.ts:717](../src/api.ts#L717)
734
+ Defined in: [src/api.ts:751](../src/api.ts#L751)
680
735
 
681
736
  Get contacts.
682
737
  Network usage: no.
@@ -697,7 +752,7 @@ Network usage: no.
697
752
 
698
753
  > **apiListGroups**(`userId`, `contactId?`, `search?`): `Promise`\<`GroupInfo`[]\>
699
754
 
700
- Defined in: [src/api.ts:727](../src/api.ts#L727)
755
+ Defined in: [src/api.ts:761](../src/api.ts#L761)
701
756
 
702
757
  Get groups.
703
758
  Network usage: no.
@@ -726,7 +781,7 @@ Network usage: no.
726
781
 
727
782
  > **apiListMembers**(`groupId`): `Promise`\<`GroupMember`[]\>
728
783
 
729
- Defined in: [src/api.ts:567](../src/api.ts#L567)
784
+ Defined in: [src/api.ts:601](../src/api.ts#L601)
730
785
 
731
786
  Get group members.
732
787
  Network usage: no.
@@ -747,7 +802,7 @@ Network usage: no.
747
802
 
748
803
  > **apiListUsers**(): `Promise`\<`UserInfo`[]\>
749
804
 
750
- Defined in: [src/api.ts:784](../src/api.ts#L784)
805
+ Defined in: [src/api.ts:859](../src/api.ts#L859)
751
806
 
752
807
  Get all user profiles
753
808
  Network usage: no.
@@ -762,7 +817,7 @@ Network usage: no.
762
817
 
763
818
  > **apiNewGroup**(`userId`, `groupProfile`): `Promise`\<`GroupInfo`\>
764
819
 
765
- Defined in: [src/api.ts:577](../src/api.ts#L577)
820
+ Defined in: [src/api.ts:611](../src/api.ts#L611)
766
821
 
767
822
  Create group.
768
823
  Network usage: no.
@@ -787,7 +842,7 @@ Network usage: no.
787
842
 
788
843
  > **apiReceiveFile**(`fileId`): `Promise`\<`AChatItem`\>
789
844
 
790
- Defined in: [src/api.ts:477](../src/api.ts#L477)
845
+ Defined in: [src/api.ts:511](../src/api.ts#L511)
791
846
 
792
847
  Receive file.
793
848
  Network usage: no.
@@ -808,7 +863,7 @@ Network usage: no.
808
863
 
809
864
  > **apiRejectContactRequest**(`contactReqId`): `Promise`\<`void`\>
810
865
 
811
- Defined in: [src/api.ts:707](../src/api.ts#L707)
866
+ Defined in: [src/api.ts:741](../src/api.ts#L741)
812
867
 
813
868
  Reject contact request. The user who sent the request is **not notified**.
814
869
  Network usage: no.
@@ -827,9 +882,9 @@ Network usage: no.
827
882
 
828
883
  ### apiRemoveMembers()
829
884
 
830
- > **apiRemoveMembers**(`groupId`, `memberIds`, `withMessages`): `Promise`\<`GroupMember`[]\>
885
+ > **apiRemoveMembers**(`groupId`, `memberIds`, `withMessages?`): `Promise`\<`GroupMember`[]\>
831
886
 
832
- Defined in: [src/api.ts:547](../src/api.ts#L547)
887
+ Defined in: [src/api.ts:581](../src/api.ts#L581)
833
888
 
834
889
  Remove members. Requires Admin role.
835
890
  Network usage: background.
@@ -844,7 +899,7 @@ Network usage: background.
844
899
 
845
900
  `number`[]
846
901
 
847
- ##### withMessages
902
+ ##### withMessages?
848
903
 
849
904
  `boolean` = `false`
850
905
 
@@ -854,11 +909,37 @@ Network usage: background.
854
909
 
855
910
  ***
856
911
 
912
+ ### apiSendMemberContactInvitation()
913
+
914
+ > **apiSendMemberContactInvitation**(`contactId`, `message?`): `Promise`\<`Contact`\>
915
+
916
+ Defined in: [src/api.ts:926](../src/api.ts#L926)
917
+
918
+ Send a direct message invitation to a group member contact.
919
+ The contact must have been created with [apiCreateMemberContact](#apicreatemembercontact).
920
+ Network usage: interactive.
921
+
922
+ #### Parameters
923
+
924
+ ##### contactId
925
+
926
+ `number`
927
+
928
+ ##### message?
929
+
930
+ `string` \| `MsgContent`
931
+
932
+ #### Returns
933
+
934
+ `Promise`\<`Contact`\>
935
+
936
+ ***
937
+
857
938
  ### apiSendMessages()
858
939
 
859
- > **apiSendMessages**(`chat`, `messages`, `liveMessage`): `Promise`\<`AChatItem`[]\>
940
+ > **apiSendMessages**(`chat`, `messages`, `liveMessage?`): `Promise`\<`AChatItem`[]\>
860
941
 
861
- Defined in: [src/api.ts:381](../src/api.ts#L381)
942
+ Defined in: [src/api.ts:415](../src/api.ts#L415)
862
943
 
863
944
  Send messages.
864
945
  Network usage: background.
@@ -867,13 +948,13 @@ Network usage: background.
867
948
 
868
949
  ##### chat
869
950
 
870
- `ChatInfo` | `ChatRef` | \[`ChatType`, `number`\]
951
+ `ChatInfo` \| `ChatRef` \| \[`ChatType`, `number`\]
871
952
 
872
953
  ##### messages
873
954
 
874
955
  `ComposedMessage`[]
875
956
 
876
- ##### liveMessage
957
+ ##### liveMessage?
877
958
 
878
959
  `boolean` = `false`
879
960
 
@@ -887,7 +968,7 @@ Network usage: background.
887
968
 
888
969
  > **apiSendTextMessage**(`chat`, `text`, `inReplyTo?`): `Promise`\<`AChatItem`[]\>
889
970
 
890
- Defined in: [src/api.ts:403](../src/api.ts#L403)
971
+ Defined in: [src/api.ts:437](../src/api.ts#L437)
891
972
 
892
973
  Send text message.
893
974
  Network usage: background.
@@ -896,7 +977,7 @@ Network usage: background.
896
977
 
897
978
  ##### chat
898
979
 
899
- `ChatInfo` | `ChatRef` | \[`ChatType`, `number`\]
980
+ `ChatInfo` \| `ChatRef` \| \[`ChatType`, `number`\]
900
981
 
901
982
  ##### text
902
983
 
@@ -916,7 +997,7 @@ Network usage: background.
916
997
 
917
998
  > **apiSendTextReply**(`chatItem`, `text`): `Promise`\<`AChatItem`[]\>
918
999
 
919
- Defined in: [src/api.ts:411](../src/api.ts#L411)
1000
+ Defined in: [src/api.ts:445](../src/api.ts#L445)
920
1001
 
921
1002
  Send text message in reply to received message.
922
1003
  Network usage: background.
@@ -941,7 +1022,7 @@ Network usage: background.
941
1022
 
942
1023
  > **apiSetActiveUser**(`userId`, `viewPwd?`): `Promise`\<`User`\>
943
1024
 
944
- Defined in: [src/api.ts:794](../src/api.ts#L794)
1025
+ Defined in: [src/api.ts:869](../src/api.ts#L869)
945
1026
 
946
1027
  Set active user profile
947
1028
  Network usage: no.
@@ -966,7 +1047,7 @@ Network usage: no.
966
1047
 
967
1048
  > **apiSetAddressSettings**(`userId`, `__namedParameters`): `Promise`\<`void`\>
968
1049
 
969
- Defined in: [src/api.ts:364](../src/api.ts#L364)
1050
+ Defined in: [src/api.ts:398](../src/api.ts#L398)
970
1051
 
971
1052
  Set bot address settings.
972
1053
  Network usage: interactive.
@@ -987,11 +1068,61 @@ Network usage: interactive.
987
1068
 
988
1069
  ***
989
1070
 
1071
+ ### apiSetAutoAcceptMemberContacts()
1072
+
1073
+ > **apiSetAutoAcceptMemberContacts**(`userId`, `onOff`): `Promise`\<`void`\>
1074
+
1075
+ Defined in: [src/api.ts:808](../src/api.ts#L808)
1076
+
1077
+ Set auto-accept member contacts.
1078
+ Network usage: no.
1079
+
1080
+ #### Parameters
1081
+
1082
+ ##### userId
1083
+
1084
+ `number`
1085
+
1086
+ ##### onOff
1087
+
1088
+ `boolean`
1089
+
1090
+ #### Returns
1091
+
1092
+ `Promise`\<`void`\>
1093
+
1094
+ ***
1095
+
1096
+ ### apiSetContactCustomData()
1097
+
1098
+ > **apiSetContactCustomData**(`contactId`, `customData?`): `Promise`\<`void`\>
1099
+
1100
+ Defined in: [src/api.ts:798](../src/api.ts#L798)
1101
+
1102
+ Set contact custom data.
1103
+ Network usage: no.
1104
+
1105
+ #### Parameters
1106
+
1107
+ ##### contactId
1108
+
1109
+ `number`
1110
+
1111
+ ##### customData?
1112
+
1113
+ `object`
1114
+
1115
+ #### Returns
1116
+
1117
+ `Promise`\<`void`\>
1118
+
1119
+ ***
1120
+
990
1121
  ### apiSetContactPrefs()
991
1122
 
992
1123
  > **apiSetContactPrefs**(`contactId`, `preferences`): `Promise`\<`void`\>
993
1124
 
994
- Defined in: [src/api.ts:830](../src/api.ts#L830)
1125
+ Defined in: [src/api.ts:905](../src/api.ts#L905)
995
1126
 
996
1127
  Configure chat preference overrides for the contact.
997
1128
  Network usage: background.
@@ -1012,11 +1143,36 @@ Network usage: background.
1012
1143
 
1013
1144
  ***
1014
1145
 
1146
+ ### apiSetGroupCustomData()
1147
+
1148
+ > **apiSetGroupCustomData**(`groupId`, `customData?`): `Promise`\<`void`\>
1149
+
1150
+ Defined in: [src/api.ts:788](../src/api.ts#L788)
1151
+
1152
+ Set group custom data.
1153
+ Network usage: no.
1154
+
1155
+ #### Parameters
1156
+
1157
+ ##### groupId
1158
+
1159
+ `number`
1160
+
1161
+ ##### customData?
1162
+
1163
+ `object`
1164
+
1165
+ #### Returns
1166
+
1167
+ `Promise`\<`void`\>
1168
+
1169
+ ***
1170
+
1015
1171
  ### apiSetGroupLinkMemberRole()
1016
1172
 
1017
1173
  > **apiSetGroupLinkMemberRole**(`groupId`, `memberRole`): `Promise`\<`void`\>
1018
1174
 
1019
- Defined in: [src/api.ts:610](../src/api.ts#L610)
1175
+ Defined in: [src/api.ts:644](../src/api.ts#L644)
1020
1176
 
1021
1177
  Set member role for group link.
1022
1178
  Network usage: no.
@@ -1041,7 +1197,7 @@ Network usage: no.
1041
1197
 
1042
1198
  > **apiSetMembersRole**(`groupId`, `groupMemberIds`, `memberRole`): `Promise`\<`void`\>
1043
1199
 
1044
- Defined in: [src/api.ts:527](../src/api.ts#L527)
1200
+ Defined in: [src/api.ts:561](../src/api.ts#L561)
1045
1201
 
1046
1202
  Set members role. Requires Admin role.
1047
1203
  Network usage: background.
@@ -1070,7 +1226,7 @@ Network usage: background.
1070
1226
 
1071
1227
  > **apiSetProfileAddress**(`userId`, `enable`): `Promise`\<`UserProfileUpdateSummary`\>
1072
1228
 
1073
- Defined in: [src/api.ts:350](../src/api.ts#L350)
1229
+ Defined in: [src/api.ts:384](../src/api.ts#L384)
1074
1230
 
1075
1231
  Add address to bot profile.
1076
1232
  Network usage: interactive.
@@ -1095,7 +1251,7 @@ Network usage: interactive.
1095
1251
 
1096
1252
  > **apiUpdateChatItem**(`chatType`, `chatId`, `chatItemId`, `msgContent`, `liveMessage`): `Promise`\<`ChatItem`\>
1097
1253
 
1098
- Defined in: [src/api.ts:419](../src/api.ts#L419)
1254
+ Defined in: [src/api.ts:453](../src/api.ts#L453)
1099
1255
 
1100
1256
  Update message.
1101
1257
  Network usage: background.
@@ -1132,7 +1288,7 @@ Network usage: background.
1132
1288
 
1133
1289
  > **apiUpdateGroupProfile**(`groupId`, `groupProfile`): `Promise`\<`GroupInfo`\>
1134
1290
 
1135
- Defined in: [src/api.ts:587](../src/api.ts#L587)
1291
+ Defined in: [src/api.ts:621](../src/api.ts#L621)
1136
1292
 
1137
1293
  Update group profile.
1138
1294
  Network usage: background.
@@ -1157,7 +1313,7 @@ Network usage: background.
1157
1313
 
1158
1314
  > **apiUpdateProfile**(`userId`, `profile`): `Promise`\<`UserProfileUpdateSummary` \| `undefined`\>
1159
1315
 
1160
- Defined in: [src/api.ts:814](../src/api.ts#L814)
1316
+ Defined in: [src/api.ts:889](../src/api.ts#L889)
1161
1317
 
1162
1318
  Update user profile.
1163
1319
  Network usage: background.
@@ -1182,7 +1338,7 @@ Network usage: background.
1182
1338
 
1183
1339
  > **close**(): `Promise`\<`void`\>
1184
1340
 
1185
- Defined in: [src/api.ts:114](../src/api.ts#L114)
1341
+ Defined in: [src/api.ts:148](../src/api.ts#L148)
1186
1342
 
1187
1343
  Close chat database.
1188
1344
  Usually doesn't need to be called in chat bots.
@@ -1195,9 +1351,9 @@ Usually doesn't need to be called in chat bots.
1195
1351
 
1196
1352
  ### off()
1197
1353
 
1198
- > **off**\<`K`\>(`event`, `subscriber`): `void`
1354
+ > **off**\<`K`\>(`event`, `subscriber?`): `void`
1199
1355
 
1200
- Defined in: [src/api.ts:253](../src/api.ts#L253)
1356
+ Defined in: [src/api.ts:287](../src/api.ts#L287)
1201
1357
 
1202
1358
  Unsubscribe all or a specific handler from a specific event.
1203
1359
 
@@ -1215,11 +1371,11 @@ Unsubscribe all or a specific handler from a specific event.
1215
1371
 
1216
1372
  The event type to unsubscribe from.
1217
1373
 
1218
- ##### subscriber
1374
+ ##### subscriber?
1219
1375
 
1220
- An optional subscriber function for the event.
1376
+ [`EventSubscriberFunc`](api.TypeAlias.EventSubscriberFunc.md)\<`K`\> \| `undefined`
1221
1377
 
1222
- [`EventSubscriberFunc`](api.TypeAlias.EventSubscriberFunc.md)\<`K`\> | `undefined`
1378
+ An optional subscriber function for the event.
1223
1379
 
1224
1380
  #### Returns
1225
1381
 
@@ -1229,19 +1385,19 @@ An optional subscriber function for the event.
1229
1385
 
1230
1386
  ### offAny()
1231
1387
 
1232
- > **offAny**(`receiver`): `void`
1388
+ > **offAny**(`receiver?`): `void`
1233
1389
 
1234
- Defined in: [src/api.ts:269](../src/api.ts#L269)
1390
+ Defined in: [src/api.ts:303](../src/api.ts#L303)
1235
1391
 
1236
1392
  Unsubscribe all or a specific handler from any events.
1237
1393
 
1238
1394
  #### Parameters
1239
1395
 
1240
- ##### receiver
1396
+ ##### receiver?
1241
1397
 
1242
- An optional subscriber function for the event.
1398
+ [`EventSubscriberFunc`](api.TypeAlias.EventSubscriberFunc.md)\<`Tag`\> \| `undefined`
1243
1399
 
1244
- [`EventSubscriberFunc`](api.TypeAlias.EventSubscriberFunc.md)\<`Tag`\> | `undefined`
1400
+ An optional subscriber function for the event.
1245
1401
 
1246
1402
  #### Returns
1247
1403
 
@@ -1255,7 +1411,7 @@ An optional subscriber function for the event.
1255
1411
 
1256
1412
  > **on**\<`K`\>(`subscribers`): `void`
1257
1413
 
1258
- Defined in: [src/api.ts:163](../src/api.ts#L163)
1414
+ Defined in: [src/api.ts:197](../src/api.ts#L197)
1259
1415
 
1260
1416
  Subscribe multiple event handlers at once.
1261
1417
 
@@ -1285,7 +1441,7 @@ If the same function is subscribed to event.
1285
1441
 
1286
1442
  > **on**\<`K`\>(`event`, `subscriber`): `void`
1287
1443
 
1288
- Defined in: [src/api.ts:171](../src/api.ts#L171)
1444
+ Defined in: [src/api.ts:205](../src/api.ts#L205)
1289
1445
 
1290
1446
  Subscribe a handler to a specific event.
1291
1447
 
@@ -1323,7 +1479,7 @@ If the same function is subscribed to event.
1323
1479
 
1324
1480
  > **onAny**(`receiver`): `void`
1325
1481
 
1326
- Defined in: [src/api.ts:194](../src/api.ts#L194)
1482
+ Defined in: [src/api.ts:228](../src/api.ts#L228)
1327
1483
 
1328
1484
  Subscribe a handler to any event.
1329
1485
 
@@ -1349,7 +1505,7 @@ If the same function is subscribed to event.
1349
1505
 
1350
1506
  > **once**\<`K`\>(`event`, `subscriber`): `void`
1351
1507
 
1352
- Defined in: [src/api.ts:205](../src/api.ts#L205)
1508
+ Defined in: [src/api.ts:239](../src/api.ts#L239)
1353
1509
 
1354
1510
  Subscribe a handler to a specific event to be delivered one time.
1355
1511
 
@@ -1385,13 +1541,13 @@ If the same function is subscribed to event.
1385
1541
 
1386
1542
  ### recvChatEvent()
1387
1543
 
1388
- > **recvChatEvent**(`wait`): `Promise`\<`ChatEvent` \| `undefined`\>
1544
+ > **recvChatEvent**(`wait?`): `Promise`\<`ChatEvent` \| `undefined`\>
1389
1545
 
1390
- Defined in: [src/api.ts:304](../src/api.ts#L304)
1546
+ Defined in: [src/api.ts:338](../src/api.ts#L338)
1391
1547
 
1392
1548
  #### Parameters
1393
1549
 
1394
- ##### wait
1550
+ ##### wait?
1395
1551
 
1396
1552
  `number` = `5_000_000`
1397
1553
 
@@ -1405,7 +1561,7 @@ Defined in: [src/api.ts:304](../src/api.ts#L304)
1405
1561
 
1406
1562
  > **sendChatCmd**(`cmd`): `Promise`\<`ChatResponse`\>
1407
1563
 
1408
- Defined in: [src/api.ts:300](../src/api.ts#L300)
1564
+ Defined in: [src/api.ts:334](../src/api.ts#L334)
1409
1565
 
1410
1566
  #### Parameters
1411
1567
 
@@ -1423,7 +1579,7 @@ Defined in: [src/api.ts:300](../src/api.ts#L300)
1423
1579
 
1424
1580
  > **startChat**(): `Promise`\<`void`\>
1425
1581
 
1426
- Defined in: [src/api.ts:88](../src/api.ts#L88)
1582
+ Defined in: [src/api.ts:122](../src/api.ts#L122)
1427
1583
 
1428
1584
  Start chat controller. Must be called with the existing user profile.
1429
1585
 
@@ -1437,7 +1593,7 @@ Start chat controller. Must be called with the existing user profile.
1437
1593
 
1438
1594
  > **stopChat**(): `Promise`\<`void`\>
1439
1595
 
1440
- Defined in: [src/api.ts:102](../src/api.ts#L102)
1596
+ Defined in: [src/api.ts:136](../src/api.ts#L136)
1441
1597
 
1442
1598
  Stop chat controller.
1443
1599
  Must be called before closing the database.
@@ -1453,9 +1609,9 @@ Usually doesn't need to be called in chat bots.
1453
1609
 
1454
1610
  #### Call Signature
1455
1611
 
1456
- > **wait**\<`K`\>(`event`): `Promise`\<`ChatEvent` & \{ `type`: `K`; \}\>
1612
+ > **wait**\<`K`\>(`event`): `Promise`\<`ChatEvent` & `object`\>
1457
1613
 
1458
- Defined in: [src/api.ts:213](../src/api.ts#L213)
1614
+ Defined in: [src/api.ts:247](../src/api.ts#L247)
1459
1615
 
1460
1616
  Waits for specific event, with an optional predicate.
1461
1617
  Returns `undefined` on timeout if specified.
@@ -1474,13 +1630,13 @@ Returns `undefined` on timeout if specified.
1474
1630
 
1475
1631
  ##### Returns
1476
1632
 
1477
- `Promise`\<`ChatEvent` & \{ `type`: `K`; \}\>
1633
+ `Promise`\<`ChatEvent` & `object`\>
1478
1634
 
1479
1635
  #### Call Signature
1480
1636
 
1481
- > **wait**\<`K`\>(`event`, `predicate`): `Promise`\<`ChatEvent` & \{ `type`: `K`; \}\>
1637
+ > **wait**\<`K`\>(`event`, `predicate`): `Promise`\<`ChatEvent` & `object`\>
1482
1638
 
1483
- Defined in: [src/api.ts:214](../src/api.ts#L214)
1639
+ Defined in: [src/api.ts:248](../src/api.ts#L248)
1484
1640
 
1485
1641
  Waits for specific event, with an optional predicate.
1486
1642
  Returns `undefined` on timeout if specified.
@@ -1499,17 +1655,17 @@ Returns `undefined` on timeout if specified.
1499
1655
 
1500
1656
  ###### predicate
1501
1657
 
1502
- (`event`) => `boolean` | `undefined`
1658
+ ((`event`) => `boolean`) \| `undefined`
1503
1659
 
1504
1660
  ##### Returns
1505
1661
 
1506
- `Promise`\<`ChatEvent` & \{ `type`: `K`; \}\>
1662
+ `Promise`\<`ChatEvent` & `object`\>
1507
1663
 
1508
1664
  #### Call Signature
1509
1665
 
1510
1666
  > **wait**\<`K`\>(`event`, `timeout`): `Promise`\<ChatEvent & \{ type: K; \} \| `undefined`\>
1511
1667
 
1512
- Defined in: [src/api.ts:215](../src/api.ts#L215)
1668
+ Defined in: [src/api.ts:249](../src/api.ts#L249)
1513
1669
 
1514
1670
  Waits for specific event, with an optional predicate.
1515
1671
  Returns `undefined` on timeout if specified.
@@ -1538,7 +1694,7 @@ Returns `undefined` on timeout if specified.
1538
1694
 
1539
1695
  > **wait**\<`K`\>(`event`, `predicate`, `timeout`): `Promise`\<ChatEvent & \{ type: K; \} \| `undefined`\>
1540
1696
 
1541
- Defined in: [src/api.ts:216](../src/api.ts#L216)
1697
+ Defined in: [src/api.ts:250](../src/api.ts#L250)
1542
1698
 
1543
1699
  Waits for specific event, with an optional predicate.
1544
1700
  Returns `undefined` on timeout if specified.
@@ -1557,7 +1713,7 @@ Returns `undefined` on timeout if specified.
1557
1713
 
1558
1714
  ###### predicate
1559
1715
 
1560
- (`event`) => `boolean` | `undefined`
1716
+ ((`event`) => `boolean`) \| `undefined`
1561
1717
 
1562
1718
  ###### timeout
1563
1719
 
@@ -1571,25 +1727,19 @@ Returns `undefined` on timeout if specified.
1571
1727
 
1572
1728
  ### init()
1573
1729
 
1574
- > `static` **init**(`dbFilePrefix`, `dbKey?`, `confirm?`): `Promise`\<`ChatApi`\>
1730
+ > `static` **init**(`db`, `confirm?`): `Promise`\<`ChatApi`\>
1575
1731
 
1576
- Defined in: [src/api.ts:76](../src/api.ts#L76)
1732
+ Defined in: [src/api.ts:110](../src/api.ts#L110)
1577
1733
 
1578
1734
  Initializes the ChatApi.
1579
1735
 
1580
1736
  #### Parameters
1581
1737
 
1582
- ##### dbFilePrefix
1583
-
1584
- `string`
1585
-
1586
- File prefix for the database files.
1587
-
1588
- ##### dbKey?
1738
+ ##### db
1589
1739
 
1590
- `string` = `""`
1740
+ [`DbConfig`](api.TypeAlias.DbConfig.md)
1591
1741
 
1592
- Database encryption key.
1742
+ Database configuration (sqlite or postgres).
1593
1743
 
1594
1744
  ##### confirm?
1595
1745