@juzi/wechaty 1.0.146 → 1.0.147

package/dist/esm/src/wechaty-mixins/plugin-mixin.d.ts

@@ -15,7 +15,7 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     init(): Promise<void>;
     start(): Promise<void>;
     stop(): Promise<void>;
-    on(event: "error" | "ready" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order", listener: (...args: any[]) => any): any;
+    on(event: "error" | "ready" | "call" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order" | "call-ringing" | "call-accept" | "call-reject" | "call-cancel" | "call-hangup" | "call-ended", listener: (...args: any[]) => any): any;
     addListener<E extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E]): any;
     once<E_1 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_1, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_1]): any;
     prependListener<E_2 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_2, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_2]): any;
@@ -65,7 +65,7 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     init: (() => Promise<void>) & (() => Promise<void>) & (() => Promise<void>);
     start: (() => Promise<void>) & (() => Promise<void>) & (() => Promise<void>);
     stop: (() => Promise<void>) & (() => Promise<void>) & (() => Promise<void>);
-    on(event: "error" | "ready" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order", listener: (...args: any[]) => any): any;
+    on(event: "error" | "ready" | "call" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order" | "call-ringing" | "call-accept" | "call-reject" | "call-cancel" | "call-hangup" | "call-ended", listener: (...args: any[]) => any): any;
     addListener<E_10 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_10, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_10]): any;
     once<E_11 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_11, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_11]): any;
     prependListener<E_12 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_12, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_12]): any;
@@ -82,12 +82,15 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     setMaxListeners(maxListeners: number): any;
     __events: import("../schemas/wechaty-events.js").WechatyEventListeners;
     __puppet?: import("@juzi/wechaty-puppet/dist/esm/src/puppet/puppet-interface.js").PuppetInterface | undefined;
+    __callPool: Map<string, import("../user-modules/call.js").CallImpl>;
     readonly puppet: import("@juzi/wechaty-puppet/dist/esm/src/puppet/puppet-interface.js").PuppetInterface;
     readonly __readyState: import("state-switch/dist/esm/src/interfaces.js").StateSwitchInterface;
     __loginIndicator: import("state-switch/dist/esm/src/boolean-indicator.js").BooleanIndicator;
     __puppetMixinInited: boolean;
     ready(): Promise<void>;
     __setupPuppetEvents(puppet: import("@juzi/wechaty-puppet/dist/esm/src/puppet/puppet-interface.js").PuppetInterface): void;
+    __finalizeIfEnded(call: import("../user-modules/call.js").CallImpl, force?: boolean): Promise<void>;
+    __wechatifiedCall?: import("../user-modules/call.js").CallConstructor | undefined;
     __wechatifiedContact?: import("../user-modules/contact.js").ContactConstructor | undefined;
     __wechatifiedContactSelf?: import("../user-modules/contact-self.js").ContactSelfConstructor | undefined;
     __wechatifiedDelay?: import("../user-modules/delay.js").DelayConstructor | undefined;
@@ -96,6 +99,9 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     __wechatifiedLocation?: import("../user-modules/location.js").LocationConstructor | undefined;
     __wechatifiedMessage?: import("../user-modules/message.js").MessageConstructor | undefined;
     __wechatifiedMiniProgram?: import("../user-modules/mini-program.js").MiniProgramConstructor | undefined;
+    /**
+     * Return the function to uninstall all plugins
+     */
     __wechatifiedPost?: import("../user-modules/post.js").PostConstructor | undefined;
     __wechatifiedRoom?: import("../user-modules/room.js").RoomConstructor | undefined;
     __wechatifiedRoomInvitation?: import("../user-modules/room-invitation.js").RoomInvitationConstructor | undefined;
@@ -114,6 +120,7 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     __wechatifiedImSpecific?: import("../user-modules/im-specific.js").ImSpecificConstructor | undefined;
     __wechatifiedWxxdProduct?: import("../user-modules/wxxd-product.js").WxxdProductConstructor | undefined;
     __wechatifiedWxxdOrder?: import("../user-modules/wxxd-order.js").WxxdOrderConstructor | undefined;
+    readonly Call: import("../user-modules/call.js").CallConstructor;
     readonly Contact: import("../user-modules/contact.js").ContactConstructor;
     readonly ContactSelf: import("../user-modules/contact-self.js").ContactSelfConstructor;
     readonly Delay: import("../user-modules/delay.js").DelayConstructor;
@@ -149,6 +156,7 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     readonly log: import("brolog/dist/esm/src/logger.js").Loggable;
 }) & ((abstract new (...args: any[]) => {
     __puppet?: import("@juzi/wechaty-puppet/dist/esm/src/puppet/puppet-interface.js").PuppetInterface | undefined;
+    __callPool: Map<string, import("../user-modules/call.js").CallImpl>;
     readonly puppet: import("@juzi/wechaty-puppet/dist/esm/src/puppet/puppet-interface.js").PuppetInterface;
     readonly __readyState: import("state-switch/dist/esm/src/interfaces.js").StateSwitchInterface;
     __loginIndicator: import("state-switch/dist/esm/src/boolean-indicator.js").BooleanIndicator;
@@ -158,6 +166,8 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     ready(): Promise<void>;
     init(): Promise<void>;
     __setupPuppetEvents(puppet: import("@juzi/wechaty-puppet/dist/esm/src/puppet/puppet-interface.js").PuppetInterface): void;
+    __finalizeIfEnded(call: import("../user-modules/call.js").CallImpl, force?: boolean): Promise<void>;
+    __wechatifiedCall?: import("../user-modules/call.js").CallConstructor | undefined;
     __wechatifiedContact?: import("../user-modules/contact.js").ContactConstructor | undefined;
     __wechatifiedContactSelf?: import("../user-modules/contact-self.js").ContactSelfConstructor | undefined;
     __wechatifiedDelay?: import("../user-modules/delay.js").DelayConstructor | undefined;
@@ -166,6 +176,9 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     __wechatifiedLocation?: import("../user-modules/location.js").LocationConstructor | undefined;
     __wechatifiedMessage?: import("../user-modules/message.js").MessageConstructor | undefined;
     __wechatifiedMiniProgram?: import("../user-modules/mini-program.js").MiniProgramConstructor | undefined;
+    /**
+     * Return the function to uninstall all plugins
+     */
     __wechatifiedPost?: import("../user-modules/post.js").PostConstructor | undefined;
     __wechatifiedRoom?: import("../user-modules/room.js").RoomConstructor | undefined;
     __wechatifiedRoomInvitation?: import("../user-modules/room-invitation.js").RoomInvitationConstructor | undefined;
@@ -184,6 +197,7 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     __wechatifiedImSpecific?: import("../user-modules/im-specific.js").ImSpecificConstructor | undefined;
     __wechatifiedWxxdProduct?: import("../user-modules/wxxd-product.js").WxxdProductConstructor | undefined;
     __wechatifiedWxxdOrder?: import("../user-modules/wxxd-order.js").WxxdOrderConstructor | undefined;
+    readonly Call: import("../user-modules/call.js").CallConstructor;
     readonly Contact: import("../user-modules/contact.js").ContactConstructor;
     readonly ContactSelf: import("../user-modules/contact-self.js").ContactSelfConstructor;
     readonly Delay: import("../user-modules/delay.js").DelayConstructor;
@@ -215,7 +229,7 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     __memory?: import("memory-card").MemoryCard | undefined;
     readonly memory: import("memory-card").MemoryCard;
     __options: import("../schemas/wechaty-options.js").WechatyOptions;
-    on(event: "error" | "ready" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order", listener: (...args: any[]) => any): any;
+    on(event: "error" | "ready" | "call" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order" | "call-ringing" | "call-accept" | "call-reject" | "call-cancel" | "call-hangup" | "call-ended", listener: (...args: any[]) => any): any;
     addListener<E_18 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_18, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_18]): any;
     once<E_19 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_19, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_19]): any;
     prependListener<E_20 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_20, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_20]): any;
@@ -239,6 +253,7 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
 }) & {
     readonly log: import("brolog/dist/esm/src/logger.js").Loggable;
 }) & ((abstract new (...args: any[]) => {
+    __wechatifiedCall?: import("../user-modules/call.js").CallConstructor | undefined;
     __wechatifiedContact?: import("../user-modules/contact.js").ContactConstructor | undefined;
     __wechatifiedContactSelf?: import("../user-modules/contact-self.js").ContactSelfConstructor | undefined;
     __wechatifiedDelay?: import("../user-modules/delay.js").DelayConstructor | undefined;
@@ -247,6 +262,9 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     __wechatifiedLocation?: import("../user-modules/location.js").LocationConstructor | undefined;
     __wechatifiedMessage?: import("../user-modules/message.js").MessageConstructor | undefined;
     __wechatifiedMiniProgram?: import("../user-modules/mini-program.js").MiniProgramConstructor | undefined;
+    /**
+     * Return the function to uninstall all plugins
+     */
     __wechatifiedPost?: import("../user-modules/post.js").PostConstructor | undefined;
     __wechatifiedRoom?: import("../user-modules/room.js").RoomConstructor | undefined;
     __wechatifiedRoomInvitation?: import("../user-modules/room-invitation.js").RoomInvitationConstructor | undefined;
@@ -265,6 +283,7 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     __wechatifiedImSpecific?: import("../user-modules/im-specific.js").ImSpecificConstructor | undefined;
     __wechatifiedWxxdProduct?: import("../user-modules/wxxd-product.js").WxxdProductConstructor | undefined;
     __wechatifiedWxxdOrder?: import("../user-modules/wxxd-order.js").WxxdOrderConstructor | undefined;
+    readonly Call: import("../user-modules/call.js").CallConstructor;
     readonly Contact: import("../user-modules/contact.js").ContactConstructor;
     readonly ContactSelf: import("../user-modules/contact-self.js").ContactSelfConstructor;
     readonly Delay: import("../user-modules/delay.js").DelayConstructor;
@@ -299,7 +318,7 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     __options: import("../schemas/wechaty-options.js").WechatyOptions;
     start(): Promise<void>;
     stop(): Promise<void>;
-    on(event: "error" | "ready" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order", listener: (...args: any[]) => any): any;
+    on(event: "error" | "ready" | "call" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order" | "call-ringing" | "call-accept" | "call-reject" | "call-cancel" | "call-hangup" | "call-ended", listener: (...args: any[]) => any): any;
     addListener<E_25 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_25, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_25]): any;
     once<E_26 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_26, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_26]): any;
     prependListener<E_27 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_27, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_27]): any;
@@ -329,7 +348,7 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     readonly memory: import("memory-card").MemoryCard;
     __options: import("../schemas/wechaty-options.js").WechatyOptions;
     init(): Promise<void>;
-    on(event: "error" | "ready" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order", listener: (...args: any[]) => any): any;
+    on(event: "error" | "ready" | "call" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order" | "call-ringing" | "call-accept" | "call-reject" | "call-cancel" | "call-hangup" | "call-ended", listener: (...args: any[]) => any): any;
     addListener<E_32 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_32, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_32]): any;
     once<E_33 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_33, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_33]): any;
     prependListener<E_34 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_34, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_34]): any;
@@ -378,7 +397,7 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     init: (() => Promise<void>) & (() => Promise<void>) & (() => Promise<void>);
     start: (() => Promise<void>) & (() => Promise<void>) & (() => Promise<void>);
     stop: (() => Promise<void>) & (() => Promise<void>) & (() => Promise<void>);
-    on(event: "error" | "ready" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order", listener: (...args: any[]) => any): any;
+    on(event: "error" | "ready" | "call" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order" | "call-ringing" | "call-accept" | "call-reject" | "call-cancel" | "call-hangup" | "call-ended", listener: (...args: any[]) => any): any;
     addListener<E_39 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_39, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_39]): any;
     once<E_40 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_40, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_40]): any;
     prependListener<E_41 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_41, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_41]): any;
@@ -421,12 +440,15 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     sleep(milliseconds: number): Promise<void>;
     ding(data?: string | undefined): void;
     __puppet?: import("@juzi/wechaty-puppet/dist/esm/src/puppet/puppet-interface.js").PuppetInterface | undefined;
+    __callPool: Map<string, import("../user-modules/call.js").CallImpl>;
     readonly puppet: import("@juzi/wechaty-puppet/dist/esm/src/puppet/puppet-interface.js").PuppetInterface;
     readonly __readyState: import("state-switch/dist/esm/src/interfaces.js").StateSwitchInterface;
     __loginIndicator: import("state-switch/dist/esm/src/boolean-indicator.js").BooleanIndicator;
     __puppetMixinInited: boolean;
     ready(): Promise<void>;
     __setupPuppetEvents(puppet: import("@juzi/wechaty-puppet/dist/esm/src/puppet/puppet-interface.js").PuppetInterface): void;
+    __finalizeIfEnded(call: import("../user-modules/call.js").CallImpl, force?: boolean): Promise<void>;
+    __wechatifiedCall?: import("../user-modules/call.js").CallConstructor | undefined;
     __wechatifiedContact?: import("../user-modules/contact.js").ContactConstructor | undefined;
     __wechatifiedContactSelf?: import("../user-modules/contact-self.js").ContactSelfConstructor | undefined;
     __wechatifiedDelay?: import("../user-modules/delay.js").DelayConstructor | undefined;
@@ -435,6 +457,9 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     __wechatifiedLocation?: import("../user-modules/location.js").LocationConstructor | undefined;
     __wechatifiedMessage?: import("../user-modules/message.js").MessageConstructor | undefined;
     __wechatifiedMiniProgram?: import("../user-modules/mini-program.js").MiniProgramConstructor | undefined;
+    /**
+     * Return the function to uninstall all plugins
+     */
     __wechatifiedPost?: import("../user-modules/post.js").PostConstructor | undefined;
     __wechatifiedRoom?: import("../user-modules/room.js").RoomConstructor | undefined;
     __wechatifiedRoomInvitation?: import("../user-modules/room-invitation.js").RoomInvitationConstructor | undefined;
@@ -453,6 +478,7 @@ declare const pluginMixin: <MixinBase extends typeof WechatySkeleton & ((abstrac
     __wechatifiedImSpecific?: import("../user-modules/im-specific.js").ImSpecificConstructor | undefined;
     __wechatifiedWxxdProduct?: import("../user-modules/wxxd-product.js").WxxdProductConstructor | undefined;
     __wechatifiedWxxdOrder?: import("../user-modules/wxxd-order.js").WxxdOrderConstructor | undefined;
+    readonly Call: import("../user-modules/call.js").CallConstructor;
     readonly Contact: import("../user-modules/contact.js").ContactConstructor;
     readonly ContactSelf: import("../user-modules/contact-self.js").ContactSelfConstructor;
     readonly Delay: import("../user-modules/delay.js").DelayConstructor;

package/dist/esm/src/wechaty-mixins/plugin-mixin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-mixin.d.ts","sourceRoot":"","sources":["../../../../src/wechaty-mixins/plugin-mixin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,wBAAwB,EACzB,MAAkC,cAAc,CAAA;AAKjD,OAAO,KAAK,EACV,eAAe,EAChB,MAA4B,mBAAmB,CAAA;AAKhD,UAAU,QAAQ;IAChB,GAAG,CACD,GAAG,OAAO,EAAE,CACR,aAAa,GACb,aAAa,EAAE,CAClB,EAAE,GACF,wBAAwB,CAAA;CAC5B;AAED,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASb;;;;;;;;;;;;;;;;;;OAkBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sDAtBmB,GAAG,EAAE;IAI3B;;;;;;;;;;;;;;;;;;OAkBG;oBAEW,CACV,aAAa,GAAG,aAAa,EAAE,CAChC,EAAE,GACF,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAvB3B;;;;;;;;;;;;;;;;;;OAkBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkCN,CAAA;AAED,aAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;AAEjD,aAAK,4BAA4B,GAAG,KAAK,CAAA;AAEzC,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,4BAA4B,EACjC,WAAW,GACZ,CAAA"}
+{"version":3,"file":"plugin-mixin.d.ts","sourceRoot":"","sources":["../../../../src/wechaty-mixins/plugin-mixin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,wBAAwB,EACzB,MAAkC,cAAc,CAAA;AAKjD,OAAO,KAAK,EACV,eAAe,EAChB,MAA4B,mBAAmB,CAAA;AAKhD,UAAU,QAAQ;IAChB,GAAG,CACD,GAAG,OAAO,EAAE,CACR,aAAa,GACb,aAAa,EAAE,CAClB,EAAE,GACF,wBAAwB,CAAA;CAC5B;AAED,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IASb;;;;;;;;;;;;;;;;;;OAkBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqBD;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAFH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAFH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sDA7CiB,GAAG,EAAE;IAI3B;;;;;;;;;;;;;;;;;;OAkBG;oBAEW,CACV,aAAa,GAAG,aAAa,EAAE,CAChC,EAAE,GACF,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAvB3B;;;;;;;;;;;;;;;;;;OAkBG;;;;;;;;;;;;;;;;;;;;;;;IAqBD;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAWR,CAAA;AAED,aAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;AAEjD,aAAK,4BAA4B,GAAG,KAAK,CAAA;AAEzC,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,4BAA4B,EACjC,WAAW,GACZ,CAAA"}

package/dist/esm/src/wechaty-mixins/puppet-mixin.d.ts

@@ -1,5 +1,6 @@
 import * as PUPPET from '@juzi/wechaty-puppet';
 import { BooleanIndicator, StateSwitchInterface } from 'state-switch';
+import type { CallImpl } from '../user-modules/mod.js';
 /**
  * Huan(202111): `puppetMixin` must extend `pluginMixin`
  *  because the `wechaty-redux` plugin need to be installed before
@@ -9,6 +10,7 @@ import { BooleanIndicator, StateSwitchInterface } from 'state-switch';
  *  because the Io need the puppet instance to be ready when it starts
  */
 declare const puppetMixin: <MixinBase extends ((abstract new (...args: any[]) => {
+    __wechatifiedCall?: import("../user-modules/call.js").CallConstructor | undefined;
     __wechatifiedContact?: import("../user-modules/contact.js").ContactConstructor | undefined;
     __wechatifiedContactSelf?: import("../user-modules/contact-self.js").ContactSelfConstructor | undefined;
     __wechatifiedDelay?: import("../user-modules/delay.js").DelayConstructor | undefined;
@@ -35,6 +37,7 @@ declare const puppetMixin: <MixinBase extends ((abstract new (...args: any[]) =>
     __wechatifiedImSpecific?: import("../user-modules/im-specific.js").ImSpecificConstructor | undefined;
     __wechatifiedWxxdProduct?: import("../user-modules/wxxd-product.js").WxxdProductConstructor | undefined;
     __wechatifiedWxxdOrder?: import("../user-modules/wxxd-order.js").WxxdOrderConstructor | undefined;
+    readonly Call: import("../user-modules/call.js").CallConstructor;
     readonly Contact: import("../user-modules/contact.js").ContactConstructor;
     readonly ContactSelf: import("../user-modules/contact-self.js").ContactSelfConstructor;
     readonly Delay: import("../user-modules/delay.js").DelayConstructor;
@@ -69,7 +72,7 @@ declare const puppetMixin: <MixinBase extends ((abstract new (...args: any[]) =>
     __options: import("../schemas/wechaty-options.js").WechatyOptions;
     start(): Promise<void>;
     stop(): Promise<void>;
-    on(event: "error" | "ready" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order", listener: (...args: any[]) => any): any;
+    on(event: "error" | "ready" | "call" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order" | "call-ringing" | "call-accept" | "call-reject" | "call-cancel" | "call-hangup" | "call-ended", listener: (...args: any[]) => any): any;
     addListener<E extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E]): any;
     once<E_1 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_1, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_1]): any;
     prependListener<E_2 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_2, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_2]): any;
@@ -99,7 +102,7 @@ declare const puppetMixin: <MixinBase extends ((abstract new (...args: any[]) =>
     init(): Promise<void>;
     start(): Promise<void>;
     stop(): Promise<void>;
-    on(event: "error" | "ready" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order", listener: (...args: any[]) => any): any;
+    on(event: "error" | "ready" | "call" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order" | "call-ringing" | "call-accept" | "call-reject" | "call-cancel" | "call-hangup" | "call-ended", listener: (...args: any[]) => any): any;
     addListener<E_11 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_11, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_11]): any;
     once<E_12 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_12, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_12]): any;
     prependListener<E_13 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_13, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_13]): any;
@@ -128,7 +131,7 @@ declare const puppetMixin: <MixinBase extends ((abstract new (...args: any[]) =>
     readonly memory: import("memory-card").MemoryCard;
     __options: import("../schemas/wechaty-options.js").WechatyOptions;
     init(): Promise<void>;
-    on(event: "error" | "ready" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order", listener: (...args: any[]) => any): any;
+    on(event: "error" | "ready" | "call" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order" | "call-ringing" | "call-accept" | "call-reject" | "call-cancel" | "call-hangup" | "call-ended", listener: (...args: any[]) => any): any;
     addListener<E_18 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_18, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_18]): any;
     once<E_19 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_19, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_19]): any;
     prependListener<E_20 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_20, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_20]): any;
@@ -150,6 +153,8 @@ declare const puppetMixin: <MixinBase extends ((abstract new (...args: any[]) =>
     readonly log: import("brolog/dist/esm/src/logger.js").Loggable;
 })>(mixinBase: MixinBase) => ((abstract new (...args: any[]) => {
     __puppet?: PUPPET.impls.PuppetInterface | undefined;
+    /** Registry of active Call instances keyed by callId. */
+    __callPool: Map<string, CallImpl>;
     readonly puppet: PUPPET.impls.PuppetInterface;
     readonly __readyState: StateSwitchInterface;
     __loginIndicator: BooleanIndicator;
@@ -159,6 +164,34 @@ declare const puppetMixin: <MixinBase extends ((abstract new (...args: any[]) =>
     ready(): Promise<void>;
     init(): Promise<void>;
     __setupPuppetEvents(puppet: PUPPET.impls.PuppetInterface): void;
+    /**
+     * Decide whether a call has reached its terminal state and, if so, drive
+     * the local lifecycle to ended by invoking {@link CallImpl.__markEnded},
+     * which routes through __finalize and is responsible for emitting both
+     * the object 'ended' and the bot 'call-ended' lifecycle events as well
+     * as evicting the call from the pool. This method does NOT emit
+     * 'call-ended' directly — that would risk a double-emit if a local
+     * control path (reject/cancel/hangup) finalizes the call before the
+     * puppet echo reaches here. The `__endedEmitted` sentinel inside
+     * __finalize makes the joint behavior idempotent.
+     *
+     * Strategy:
+     *   - `force=true` short-circuits when the caller already knows the call is
+     *     over (Cancel from the receiver's perspective).
+     *   - Otherwise, refresh the payload via dirty + ready and check
+     *     `endTime`, with a short retry budget so transient puppet hiccups do
+     *     not strand a Call in the pool.
+     *   - As a last-resort heuristic, an ended-leaning signal (Reject / Hangup)
+     *     on a strict 1v1 call (participants.length === 2: the starter plus
+     *     exactly one invitee) is treated as terminal even if sync never
+     *     recovered: in 1v1 the protocol has no other peer to keep the
+     *     session alive. Other roster shapes (length 0/1/3+) fall through
+     *     and wait for the next dirty signal — length<=1 is a stranded-but-
+     *     recoverable shape (empty roster from a sync hiccup, or a multi-
+     *     party call whose other members already left).
+     */
+    __finalizeIfEnded(call: CallImpl, force?: boolean): Promise<void>;
+    __wechatifiedCall?: import("../user-modules/call.js").CallConstructor | undefined;
     __wechatifiedContact?: import("../user-modules/contact.js").ContactConstructor | undefined;
     __wechatifiedContactSelf?: import("../user-modules/contact-self.js").ContactSelfConstructor | undefined;
     __wechatifiedDelay?: import("../user-modules/delay.js").DelayConstructor | undefined;
@@ -185,6 +218,7 @@ declare const puppetMixin: <MixinBase extends ((abstract new (...args: any[]) =>
     __wechatifiedImSpecific?: import("../user-modules/im-specific.js").ImSpecificConstructor | undefined;
     __wechatifiedWxxdProduct?: import("../user-modules/wxxd-product.js").WxxdProductConstructor | undefined;
     __wechatifiedWxxdOrder?: import("../user-modules/wxxd-order.js").WxxdOrderConstructor | undefined;
+    readonly Call: import("../user-modules/call.js").CallConstructor;
     readonly Contact: import("../user-modules/contact.js").ContactConstructor;
     readonly ContactSelf: import("../user-modules/contact-self.js").ContactSelfConstructor;
     readonly Delay: import("../user-modules/delay.js").DelayConstructor;
@@ -216,7 +250,7 @@ declare const puppetMixin: <MixinBase extends ((abstract new (...args: any[]) =>
     __memory?: import("memory-card").MemoryCard | undefined;
     readonly memory: import("memory-card").MemoryCard;
     __options: import("../schemas/wechaty-options.js").WechatyOptions;
-    on(event: "error" | "ready" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order", listener: (...args: any[]) => any): any;
+    on(event: "error" | "ready" | "call" | "tag" | "login" | "start" | "stop" | "logout" | "room-invite" | "room-join" | "room-leave" | "room-topic" | "room-announce" | "dong" | "friendship" | "heartbeat" | "message" | "post" | "puppet" | "scan" | "tag-group" | "post-comment" | "post-tap" | "verify-code" | "dirty" | "login-url" | "intent-comment" | "verify-slide" | "contact-enter-conversation" | "contact-lead-filled" | "wxxd-shop" | "wxxd-product" | "wxxd-order" | "call-ringing" | "call-accept" | "call-reject" | "call-cancel" | "call-hangup" | "call-ended", listener: (...args: any[]) => any): any;
     addListener<E_25 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_25, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_25]): any;
     once<E_26 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_26, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_26]): any;
     prependListener<E_27 extends keyof import("../schemas/wechaty-events.js").WechatyEventListeners>(event: E_27, listener: import("../schemas/wechaty-events.js").WechatyEventListeners[E_27]): any;
@@ -241,7 +275,7 @@ declare const puppetMixin: <MixinBase extends ((abstract new (...args: any[]) =>
     readonly log: import("brolog/dist/esm/src/logger.js").Loggable;
 }) & MixinBase;
 declare type PuppetMixin = ReturnType<typeof puppetMixin>;
-declare type ProtectedPropertyPuppetMixin = '__puppet' | '__readyState' | '__setupPuppetEvents' | '__loginIndicator';
+declare type ProtectedPropertyPuppetMixin = '__puppet' | '__callPool' | '__readyState' | '__setupPuppetEvents' | '__finalizeIfEnded' | '__loginIndicator';
 export type { PuppetMixin, ProtectedPropertyPuppetMixin, };
 export { puppetMixin, };
 //# sourceMappingURL=puppet-mixin.d.ts.map

package/dist/esm/src/wechaty-mixins/puppet-mixin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"puppet-mixin.d.ts","sourceRoot":"","sources":["../../../../src/wechaty-mixins/puppet-mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAW,sBAAsB,CAAA;AAQnD,OAAO,EAEL,gBAAgB,EAChB,oBAAoB,EACrB,MAAO,cAAc,CAAA;AA0BtB;;;;;;;GAOG;AACH,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sDAqBS,GAAG,EAAE;;;2BANH,oBAAoB;sBAE1B,gBAAgB;;aAmBT,QAAQ,IAAI,CAAC;YA+Cd,QAAQ,IAAI,CAAC;aAuBrB,QAAQ,IAAI,CAAC;YAML,QAAQ,IAAI,CAAC;gCA8CR,OAAO,KAAK,CAAC,eAAe,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA4lBnE,CAAA;AAED,aAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;AAEjD,aAAK,4BAA4B,GAC7B,UAAU,GACV,cAAc,GACd,qBAAqB,GACrB,kBAAkB,CAAA;AAEtB,YAAY,EACV,WAAW,EACX,4BAA4B,GAC7B,CAAA;AACD,OAAO,EACL,WAAW,GACZ,CAAA"}
+{"version":3,"file":"puppet-mixin.d.ts","sourceRoot":"","sources":["../../../../src/wechaty-mixins/puppet-mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAW,sBAAsB,CAAA;AAQnD,OAAO,EAEL,gBAAgB,EAChB,oBAAoB,EACrB,MAAO,cAAc,CAAA;AAItB,OAAO,KAAK,EACV,QAAQ,EAST,MAAoC,wBAAwB,CAAA;AAa7D;;;;;;;GAOG;AACH,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sDAwBS,GAAG,EAAE;;IAjB3B,yDAAyD;gBAC7C,IAAI,MAAM,EAAE,QAAQ,CAAC;;2BAUT,oBAAoB;sBAE1B,gBAAgB;;aAmBT,QAAQ,IAAI,CAAC;YA+Cd,QAAQ,IAAI,CAAC;aAyBrB,QAAQ,IAAI,CAAC;YAML,QAAQ,IAAI,CAAC;gCA8CR,OAAO,KAAK,CAAC,eAAe,GAAG,IAAI;IAsrBhE;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;4BAC4B,QAAQ,oBAAkB,QAAQ,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA4DzE,CAAA;AAED,aAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;AAEjD,aAAK,4BAA4B,GAC7B,UAAU,GACV,YAAY,GACZ,cAAc,GACd,qBAAqB,GACrB,mBAAmB,GACnB,kBAAkB,CAAA;AAEtB,YAAY,EACV,WAAW,EACX,4BAA4B,GAC7B,CAAA;AACD,OAAO,EACL,WAAW,GACZ,CAAA"}

package/dist/esm/src/wechaty-mixins/puppet-mixin.js

@@ -19,6 +19,8 @@ const puppetMixin = (mixinBase) => {
     log.verbose('WechatyPuppetMixin', 'puppetMixin(%s)', mixinBase.name);
     class PuppetMixin extends mixinBase {
         __puppet;
+        /** Registry of active Call instances keyed by callId. */
+        __callPool = new Map();
         get puppet() {
             if (!this.__puppet) {
                 throw new Error('NOPUPPET');
@@ -99,6 +101,7 @@ const puppetMixin = (mixinBase) => {
             log.verbose('WechatyPuppetMixin', 'stop() super.stop() ...');
             await super.stop();
             log.verbose('WechatyPuppetMixin', 'stop() super.stop() ... done');
+            this.__callPool.clear();
         }
         async ready() {
             log.verbose('WechatyPuppetMixin', 'ready()');
@@ -636,6 +639,29 @@ const puppetMixin = (mixinBase) => {
                                         await order?.ready(true);
                                         break;
                                     }
+                                    case PUPPET.types.Payload.Call: {
+                                        /**
+                                         * Invalidate the puppet-side cache so the next callPayload()
+                                         * pull reflects the latest server state, then refresh the
+                                         * user-layer Call payload so getters (media / participants /
+                                         * endTime) reflect the new view immediately. Whether the
+                                         * call is still alive is still decided by the call-event
+                                         * handler via __finalizeIfEnded; we do not touch the pool
+                                         * here, and we do not emit a synthetic user event — the
+                                         * UI is expected to read getters when it needs the value.
+                                         */
+                                        await this.puppet.callPayloadDirty(payloadId);
+                                        const call = this.__callPool.get(payloadId);
+                                        if (call) {
+                                            try {
+                                                await call.ready(true);
+                                            }
+                                            catch (e) {
+                                                log.warn('WechatyPuppetMixin', 'dirty(Call) ready failed for callId=%s: %s', payloadId, e.message);
+                                            }
+                                        }
+                                        break;
+                                    }
                                     case PUPPET.types.Payload.Unspecified:
                                     default:
                                         log.warn('unknown payload type: ' + payloadType);
@@ -676,6 +702,68 @@ const puppetMixin = (mixinBase) => {
                             this.emit('wxxd-order', payload?.payload);
                         });
                         break;
+                    case 'call':
+                        puppet.on('call', async (payload) => {
+                            try {
+                                if (payload.signal === PUPPET.types.CallSignal.Invite) {
+                                    if (this.__callPool.has(payload.callId)) {
+                                        log.warn('WechatyPuppetMixin', '__setupPuppetEvents() duplicate Invite for callId=%s, ignoring', payload.callId);
+                                        return;
+                                    }
+                                    const call = new this.Call({
+                                        id: payload.callId,
+                                        direction: 'incoming',
+                                    });
+                                    await call.ready();
+                                    this.__callPool.set(call.id, call);
+                                    this.emit('call', call);
+                                    return;
+                                }
+                                const call = this.__callPool.get(payload.callId);
+                                if (!call) {
+                                    // Under the protocol-mints-id model, signals for an unknown callId
+                                    // are expected within race windows (e.g. a Ringing ack arriving
+                                    // before callInvite returns) or after the Call has been finalized
+                                    // and removed from the pool. Drop silently — log.warn, not error.
+                                    log.warn('WechatyPuppetMixin', '__setupPuppetEvents() call event for unknown callId=%s, dropping', payload.callId);
+                                    return;
+                                }
+                                const actor = await this.Contact.find({ id: payload.contactId });
+                                if (!actor) {
+                                    log.warn('WechatyPuppetMixin', '__setupPuppetEvents() actor contact not found for callId=%s contactId=%s, dropping', payload.callId, payload.contactId);
+                                    return;
+                                }
+                                call.__handleSignal(payload.signal, actor, payload.reason);
+                                switch (payload.signal) {
+                                    case PUPPET.types.CallSignal.Ringing:
+                                        this.emit('call-ringing', call);
+                                        break;
+                                    case PUPPET.types.CallSignal.Accept:
+                                        this.emit('call-accept', call, actor);
+                                        break;
+                                    case PUPPET.types.CallSignal.Reject:
+                                        this.emit('call-reject', call, actor, payload.reason);
+                                        await this.__finalizeIfEnded(call);
+                                        break;
+                                    case PUPPET.types.CallSignal.Cancel:
+                                        this.emit('call-cancel', call, payload.reason);
+                                        // Cancel is a peer-side terminal action on the receiving side:
+                                        // the caller has withdrawn, so the local call necessarily ends.
+                                        await this.__finalizeIfEnded(call, /* force */ true);
+                                        break;
+                                    case PUPPET.types.CallSignal.Hangup:
+                                        this.emit('call-hangup', call, actor, payload.reason);
+                                        await this.__finalizeIfEnded(call);
+                                        break;
+                                    default:
+                                        break;
+                                }
+                            }
+                            catch (e) {
+                                this.emit('error', GError.from(e));
+                            }
+                        });
+                        break;
                     default:
                         /**
                          * Check: The eventName here should have the type `never`
@@ -685,6 +773,67 @@ const puppetMixin = (mixinBase) => {
             }
             log.verbose('WechatyPuppetMixin', '__setupPuppetEvents() ... done');
         }
+        /**
+         * Decide whether a call has reached its terminal state and, if so, drive
+         * the local lifecycle to ended by invoking {@link CallImpl.__markEnded},
+         * which routes through __finalize and is responsible for emitting both
+         * the object 'ended' and the bot 'call-ended' lifecycle events as well
+         * as evicting the call from the pool. This method does NOT emit
+         * 'call-ended' directly — that would risk a double-emit if a local
+         * control path (reject/cancel/hangup) finalizes the call before the
+         * puppet echo reaches here. The `__endedEmitted` sentinel inside
+         * __finalize makes the joint behavior idempotent.
+         *
+         * Strategy:
+         *   - `force=true` short-circuits when the caller already knows the call is
+         *     over (Cancel from the receiver's perspective).
+         *   - Otherwise, refresh the payload via dirty + ready and check
+         *     `endTime`, with a short retry budget so transient puppet hiccups do
+         *     not strand a Call in the pool.
+         *   - As a last-resort heuristic, an ended-leaning signal (Reject / Hangup)
+         *     on a strict 1v1 call (participants.length === 2: the starter plus
+         *     exactly one invitee) is treated as terminal even if sync never
+         *     recovered: in 1v1 the protocol has no other peer to keep the
+         *     session alive. Other roster shapes (length 0/1/3+) fall through
+         *     and wait for the next dirty signal — length<=1 is a stranded-but-
+         *     recoverable shape (empty roster from a sync hiccup, or a multi-
+         *     party call whose other members already left).
+         */
+        async __finalizeIfEnded(call, force = false) {
+            let ended = force;
+            if (!ended) {
+                for (let attempt = 0; attempt < 3 && !ended; attempt++) {
+                    try {
+                        await call.sync();
+                        ended = !!call.endTime();
+                    }
+                    catch (e) {
+                        log.warn('WechatyPuppetMixin', '__finalizeIfEnded() sync attempt %d failed for callId=%s: %s', attempt + 1, call.id, e.message);
+                    }
+                    if (!ended && attempt < 2) {
+                        await new Promise(resolve => setTimeout(resolve, 500));
+                    }
+                }
+            }
+            if (!ended) {
+                try {
+                    const participants = await call.participants();
+                    if (participants.length === 2) {
+                        log.warn('WechatyPuppetMixin', '__finalizeIfEnded() 1v1 fallback after sync failure for callId=%s (rosterLength=%d)', call.id, participants.length);
+                        ended = true;
+                    }
+                    else {
+                        log.error('WechatyPuppetMixin', '__finalizeIfEnded() sync failed, leaving callId=%s in pool for next dirty signal (rosterLength=%d)', call.id, participants.length);
+                    }
+                }
+                catch (e) {
+                    log.error('WechatyPuppetMixin', '__finalizeIfEnded() participants lookup failed for callId=%s: %s', call.id, e.message);
+                }
+            }
+            if (ended) {
+                call.__markEnded();
+            }
+        }
     }
     return PuppetMixin;
 };