@juzi/wechaty 1.0.19 → 1.0.21

package/dist/esm/src/user-modules/tag.js

@@ -32,11 +32,19 @@ class TagMixin extends wechatifyMixinBase() {
     name() {
         return this.payload.name;
     }
-    static async list() {
-        log.verbose('Tag', 'list()');
+    group() {
+        return this.wechaty.TagGroup.load(this.groupId());
+    }
+    static pool = [];
+    static async list(forceSync = false) {
+        log.verbose('Tag', 'list(%s)', forceSync);
+        if (this.pool.length > 0 && !forceSync) {
+            return this.pool;
+        }
         try {
             const payloads = await this.wechaty.puppet.tagTagList();
-            return payloads.map(payload => new this(payload));
+            this.pool = payloads.map(payload => new this(payload));
+            return this.pool;
         }
         catch (e) {
             this.wechaty.emitError(e);
@@ -44,23 +52,46 @@ class TagMixin extends wechatifyMixinBase() {
             return [];
         }
     }
+    static async sync() {
+        log.verbose('Tag', 'sync()');
+        await this.list(true);
+    }
+    static load(tag) {
+        log.verbose('TagGroup', 'load(%s)', tag);
+        for (const item of this.pool) {
+            if (item.id() === tag.id && (item.groupId() === tag.groupId || (!item.groupId() && !tag.groupId))) {
+                return item;
+            }
+        }
+        return undefined;
+    }
     async contactList() {
-        log.verbose('Tag', 'contactList() for tag id: %s', this.id());
-        const contactIds = await this.wechaty.puppet.tagTagContactList(this.groupId(), this.id());
+        log.verbose('Tag', 'contactList() for tag : %s', this);
+        const tag = { id: this.id(), groupId: this.groupId() };
+        const contactIds = await this.wechaty.puppet.tagTagContactList(tag);
         const contactPromises = contactIds.map(id => this.wechaty.Contact.find({ id }));
         return Promise.all(contactPromises);
     }
-    async tag(contact) {
-        log.verbose('Tag', 'tag(%s) for tag id: %s', contact, this.id());
-        const contactId = contact.id;
-        await this.wechaty.puppet.tagContactTagAdd(this.groupId(), this.id(), contactId);
+    async tag(contacts) {
+        log.verbose('Tag', 'tag(%s) for tag : %s', contacts, this);
+        const tag = { id: this.id(), groupId: this.groupId() };
+        let contactIds;
+        if (Array.isArray(contacts)) {
+            contactIds = contacts.map(c => c.id);
+        }
+        else {
+            contactIds = [contacts.id];
+        }
+        await this.wechaty.puppet.tagContactTagAdd([tag], contactIds);
     }
-    static async createTag(tagGroupId, name) {
-        log.verbose('Tag', 'createTag(%s, %s)', tagGroupId, name);
+    static async createTag(name, tagGroup) {
+        log.verbose('Tag', 'createTag(%s, %s)', tagGroup, name);
         try {
-            const payload = await this.wechaty.puppet.tagTagAdd(tagGroupId, name);
+            const payload = await this.wechaty.puppet.tagTagAdd(name, tagGroup?.name());
             if (payload) {
-                return new this(payload);
+                const newTag = new this(payload);
+                this.pool.push(newTag);
+                return newTag;
             }
         }
         catch (e) {
@@ -68,16 +99,21 @@ class TagMixin extends wechatifyMixinBase() {
             log.error('Contact', 'createTag() exception: %s', e.message);
         }
     }
-    static async deleteTag(tag) {
-        log.verbose('Tag', 'deleteTag(%s, %s)', tag);
+    static async deleteTag(tagInstance) {
+        log.verbose('Tag', 'deleteTag(%s, %s)', tagInstance);
+        const tag = { id: tagInstance.id(), groupId: tagInstance.groupId() };
         try {
-            await this.wechaty.puppet.tagTagDelete(tag.groupId(), tag.id());
+            await this.wechaty.puppet.tagTagDelete(tag);
+            this.pool.splice(this.pool.indexOf(tagInstance), 1);
         }
         catch (e) {
             this.wechaty.emitError(e);
-            log.error('Contact', 'deleteTag() exception: %s', e.message);
+            log.error('Tag', 'deleteTag() exception: %s', e.message);
         }
     }
+    toString() {
+        return `<Tag#${this.name() || this.id()}>`;
+    }
 }
 class TagImpl extends validationMixin(TagMixin)() {
 }

package/dist/esm/src/user-modules/tag.js.map

@@ -1 +1 @@
-{"version":3,"file":"tag.js","sourceRoot":"","sources":["../../../../src/user-modules/tag.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tag.js","sourceRoot":"","sources":["../../../../src/user-modules/tag.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juzi/wechaty",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "Wechaty is a RPA SDK for Chatbot Makers.",
   "type": "module",
   "exports": {
@@ -109,8 +109,8 @@
   },
   "homepage": "https://github.com/wechaty/",
   "dependencies": {
-    "@juzi/wechaty-puppet": "^1.0.12",
-    "@juzi/wechaty-puppet-service": "^1.0.17",
+    "@juzi/wechaty-puppet": "^1.0.15",
+    "@juzi/wechaty-puppet-service": "^1.0.18",
     "clone-class": "^1.1.1",
     "cmd-ts": "^0.10.0",
     "cockatiel": "^2.0.2",

package/src/package-json.ts

@@ -4,10 +4,10 @@
  */
 import type { PackageJsonWechaty } from './config'
 
-export const GIT_COMMIT_HASH: string = '57a2595e3a5d5a2b1705ee967dbf2429a569bfbd'
+export const GIT_COMMIT_HASH: string = 'fc0b844832f84f684254ef8a0b1c7431675fdc2f'
 export const packageJson: PackageJsonWechaty = {
   "name": "@juzi/wechaty",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "description": "Wechaty is a RPA SDK for Chatbot Makers.",
   "type": "module",
   "exports": {
@@ -116,8 +116,8 @@ export const packageJson: PackageJsonWechaty = {
   },
   "homepage": "https://github.com/wechaty/",
   "dependencies": {
-    "@juzi/wechaty-puppet": "^1.0.12",
-    "@juzi/wechaty-puppet-service": "^1.0.17",
+    "@juzi/wechaty-puppet": "^1.0.15",
+    "@juzi/wechaty-puppet-service": "^1.0.18",
     "clone-class": "^1.1.1",
     "cmd-ts": "^0.10.0",
     "cockatiel": "^2.0.2",

package/src/user-modules/contact.ts

@@ -207,28 +207,6 @@ class ContactMixin extends MixinBase implements SayableSayer {
     log.verbose('Contact', 'static delete(%s)', contact.id)
   }
 
-  /**
-   * Get tags for all contact
-   *
-   * @static
-   * @returns {Promise<TagInterface[]>}
-   * @example
-   * const tags = await wechaty.Contact.tags()
-   */
-  static async tags (): Promise<TagInterface[]> {
-    log.verbose('Contact', 'static tags() for %s', this)
-
-    try {
-      const tagIdList = await this.wechaty.puppet.tagTagList()
-      const tagList = tagIdList.map(id => this.wechaty.Tag.create(id))
-      return tagList
-    } catch (e) {
-      this.wechaty.emitError(e)
-      log.error('Contact', 'static tags() exception: %s', (e as Error).message)
-      return []
-    }
-  }
-
   /**
    *
    * Instance properties
@@ -674,8 +652,13 @@ class ContactMixin extends MixinBase implements SayableSayer {
 
     try {
       const tagPayloadList = await this.wechaty.puppet.tagContactTagList(this.id)
-      const tagList = tagPayloadList.map(tag => this.wechaty.Tag.create(tag))
-      return tagList
+
+      let tagList = tagPayloadList.map(tag => this.wechaty.Tag.load(tag))
+      if (tagList.some(tag => typeof tag === 'undefined')) {
+        await this.wechaty.Tag.sync()
+        tagList = tagPayloadList.map(tag => this.wechaty.Tag.load(tag))
+      }
+      return tagList.filter(tag => !!tag) as TagInterface[]
     } catch (e) {
       this.wechaty.emitError(e)
       log.error('Contact', 'tags() exception: %s', (e as Error).message)
@@ -687,10 +670,20 @@ class ContactMixin extends MixinBase implements SayableSayer {
    * Add a Tag
    */
 
-  async tag (tag: TagInterface): Promise<void> {
-    log.verbose('Contact', 'tag(%s) for %s', tag, this)
+  async tag (tags: TagInterface | TagInterface[]): Promise<void> {
+    log.verbose('Contact', 'tag(%s) for %s', JSON.stringify(tags), this)
 
-    await this.wechaty.puppet.tagContactTagAdd(tag.groupId(), tag.id(), this.id)
+    if (!Array.isArray(tags)) {
+      tags = [tags]
+    }
+
+    const tagIdentifiers = tags.map(tag => {
+      return {
+        id: tag.id(),
+        groupId: tag.groupId(),
+      }
+    })
+    await this.wechaty.puppet.tagContactTagAdd(tagIdentifiers, [this.id])
 
   }
 
@@ -698,10 +691,21 @@ class ContactMixin extends MixinBase implements SayableSayer {
    * Remove a Tag
    */
 
-  async tagRemove (tag: TagInterface): Promise<void> {
-    log.verbose('Contact', 'tagRemove(%s) for %s', tag, this)
+  async tagRemove (tags: TagInterface | TagInterface[]): Promise<void> {
+    log.verbose('Contact', 'tagRemove(%s) for %s', JSON.stringify(tags), this)
+
+    if (!Array.isArray(tags)) {
+      tags = [tags]
+    }
+
+    const tagIdentifiers = tags.map(tag => {
+      return {
+        id: tag.id(),
+        groupId: tag.groupId(),
+      }
+    })
 
-    await this.wechaty.puppet.tagContactTagRemove(tag.groupId(), tag.id(), this.id)
+    await this.wechaty.puppet.tagContactTagRemove(tagIdentifiers, [this.id])
 
   }
 

package/src/user-modules/room.ts

@@ -728,9 +728,16 @@ class RoomMixin extends MixinBase implements SayableSayer {
    *   }
    * }
    */
-  async remove (contact: ContactInterface): Promise<void> {
-    log.verbose('Room', 'del(%s)', contact)
-    await this.wechaty.puppet.roomDel(this.id, contact.id)
+  async remove (contacts: ContactInterface | ContactInterface[]): Promise<void> {
+    log.verbose('Room', 'del(%s)', contacts)
+
+    let contactIds: string[]
+    if (Array.isArray(contacts)) {
+      contactIds = contacts.map(c => c.id)
+    } else {
+      contactIds = [contacts.id]
+    }
+    await this.wechaty.puppet.roomDel(this.id, contactIds)
     // this.delLocal(contact)
   }
 
@@ -738,7 +745,7 @@ class RoomMixin extends MixinBase implements SayableSayer {
    * Huan(202106): will be removed after Dec 31, 2023
    * @deprecated use remove(contact) instead.
    */
-  async del (contact: ContactImpl): Promise<void> {
+  async del (contact: ContactImpl | ContactImpl[]): Promise<void> {
     log.warn('Room', 'del() is DEPRECATED, use remove() instead.\n%s', new Error().stack)
     return this.remove(contact)
   }

package/src/user-modules/tag-group.ts

@@ -26,6 +26,7 @@ import { validationMixin } from '../user-mixins/validation.js'
 import {
   wechatifyMixinBase,
 } from '../user-mixins/wechatify.js'
+import type { TagInterface } from './tag.js'
 
 class TagGroupMixin extends wechatifyMixinBase() {
 
@@ -58,13 +59,52 @@ class TagGroupMixin extends wechatifyMixinBase() {
     return this.payload.name
   }
 
+  private static pool: TagGroupInterface[] = []
+
+  static async list (forceSync = false): Promise<TagGroupInterface[]> {
+    log.verbose('TagGroup', 'list(%s)', forceSync)
+
+    if (this.pool.length > 0 && !forceSync) {
+      return this.pool
+    }
+
+    try {
+      const payloads = await this.wechaty.puppet.tagGroupList()
+      this.pool = payloads.map(payload => new this(payload))
+      return this.pool
+    } catch (e) {
+      this.wechaty.emitError(e)
+      log.error('TagGroup', 'list() exception: %s', (e as Error).message)
+      return []
+    }
+  }
+
+  static async sync (): Promise<void> {
+    log.verbose('TagGroup', 'sync()')
+
+    await this.list(true)
+  }
+
+  static load (tagGroupId: string): TagGroupInterface | undefined {
+    log.verbose('TagGroup', 'load(%s)', tagGroupId)
+
+    for (const item of this.pool) {
+      if (item.id() === tagGroupId) {
+        return item
+      }
+    }
+    return undefined
+  }
+
   static async createTagGroup (name: string): Promise<TagGroupInterface | void> {
     log.verbose('TagGroup', 'createTagGroup(%s, %s)', name)
 
     try {
       const payload = await this.wechaty.puppet.tagGroupAdd(name)
       if (payload) {
-        return new this(payload)
+        const newTagGroup = new this(payload)
+        this.pool.push(newTagGroup)
+        return newTagGroup
       }
     } catch (e) {
       this.wechaty.emitError(e)
@@ -77,23 +117,19 @@ class TagGroupMixin extends wechatifyMixinBase() {
 
     try {
       await this.wechaty.puppet.tagGroupDelete(tagGroup.id())
+      this.pool.splice(this.pool.indexOf(tagGroup), 1)
     } catch (e) {
       this.wechaty.emitError(e)
-      log.error('Contact', 'createTag() exception: %s', (e as Error).message)
+      log.error('TagGroup', 'deleteTagGroup() exception: %s', (e as Error).message)
     }
   }
 
-  static async list (): Promise<TagGroupInterface[]> {
-    log.verbose('TagGroup', 'list()')
+  async tags (): Promise<TagInterface[]> {
+    return (await this.wechaty.Tag.list()).filter(tag => tag.groupId() === this.id())
+  }
 
-    try {
-      const payloads = await this.wechaty.puppet.tagGroupList()
-      return payloads.map(payload => new this(payload))
-    } catch (e) {
-      this.wechaty.emitError(e)
-      log.error('TagGroup', 'list() exception: %s', (e as Error).message)
-      return []
-    }
+  override toString () {
+    return `<TagGroup#${this.name() || this.id()}>`
   }
 
 }

package/src/user-modules/tag.ts

@@ -18,6 +18,7 @@
  *
  */
 import type * as PUPPET from '@juzi/wechaty-puppet'
+import type { TagIdentifier } from '@juzi/wechaty-puppet/filters'
 
 import type { Constructor } from 'clone-class'
 import { log } from '../config.js'
@@ -27,6 +28,7 @@ import {
   wechatifyMixinBase,
 }                     from '../user-mixins/wechatify.js'
 import type { ContactInterface } from './contact.js'
+import type { TagGroupInterface } from './tag-group.js'
 
 class TagMixin extends wechatifyMixinBase() {
 
@@ -67,12 +69,23 @@ class TagMixin extends wechatifyMixinBase() {
     return this.payload.name
   }
 
-  static async list (): Promise<TagInterface[]> {
-    log.verbose('Tag', 'list()')
+  group (): TagGroupInterface | undefined {
+    return this.wechaty.TagGroup.load(this.groupId())
+  }
+
+  private static pool: TagInterface[] = []
+
+  static async list (forceSync = false): Promise<TagInterface[]> {
+    log.verbose('Tag', 'list(%s)', forceSync)
+
+    if (this.pool.length > 0 && !forceSync) {
+      return this.pool
+    }
 
     try {
       const payloads = await this.wechaty.puppet.tagTagList()
-      return payloads.map(payload => new this(payload))
+      this.pool = payloads.map(payload => new this(payload))
+      return this.pool
     } catch (e) {
       this.wechaty.emitError(e)
       log.error('Tag', 'list() exception: %s', (e as Error).message)
@@ -80,28 +93,54 @@ class TagMixin extends wechatifyMixinBase() {
     }
   }
 
+  static async sync (): Promise<void> {
+    log.verbose('Tag', 'sync()')
+
+    await this.list(true)
+  }
+
+  static load (tag: TagIdentifier): TagInterface | undefined {
+    log.verbose('TagGroup', 'load(%s)', tag)
+
+    for (const item of this.pool) {
+      if (item.id() === tag.id && (item.groupId() === tag.groupId || (!item.groupId() && !tag.groupId))) {
+        return item
+      }
+    }
+    return undefined
+  }
+
   async contactList (): Promise<ContactInterface[]> {
-    log.verbose('Tag', 'contactList() for tag id: %s', this.id())
+    log.verbose('Tag', 'contactList() for tag : %s', this)
 
-    const contactIds = await this.wechaty.puppet.tagTagContactList(this.groupId(), this.id())
+    const tag = { id: this.id(), groupId: this.groupId() } as TagIdentifier
+    const contactIds = await this.wechaty.puppet.tagTagContactList(tag)
     const contactPromises = contactIds.map(id => this.wechaty.Contact.find({ id })) as Promise<ContactInterface>[]
     return Promise.all(contactPromises)
   }
 
-  async tag (contact: ContactInterface): Promise<void> {
-    log.verbose('Tag', 'tag(%s) for tag id: %s', contact, this.id())
+  async tag (contacts: ContactInterface | ContactInterface[]): Promise<void> {
+    log.verbose('Tag', 'tag(%s) for tag : %s', contacts, this)
 
-    const contactId = contact.id
-    await this.wechaty.puppet.tagContactTagAdd(this.groupId(), this.id(), contactId)
+    const tag = { id: this.id(), groupId: this.groupId() } as TagIdentifier
+    let contactIds: string[]
+    if (Array.isArray(contacts)) {
+      contactIds = contacts.map(c => c.id)
+    } else {
+      contactIds = [contacts.id]
+    }
+    await this.wechaty.puppet.tagContactTagAdd([tag], contactIds)
   }
 
-  static async createTag (tagGroupId: string | undefined, name: string): Promise<TagInterface | void> {
-    log.verbose('Tag', 'createTag(%s, %s)', tagGroupId, name)
+  static async createTag (name: string, tagGroup?: TagGroupInterface): Promise<TagInterface | void> {
+    log.verbose('Tag', 'createTag(%s, %s)', tagGroup, name)
 
     try {
-      const payload = await this.wechaty.puppet.tagTagAdd(tagGroupId, name)
+      const payload = await this.wechaty.puppet.tagTagAdd(name, tagGroup?.name())
       if (payload) {
-        return new this(payload)
+        const newTag = new this(payload)
+        this.pool.push(newTag)
+        return newTag
       }
     } catch (e) {
       this.wechaty.emitError(e)
@@ -109,17 +148,24 @@ class TagMixin extends wechatifyMixinBase() {
     }
   }
 
-  static async deleteTag (tag: TagInterface): Promise<void> {
-    log.verbose('Tag', 'deleteTag(%s, %s)', tag)
+  static async deleteTag (tagInstance: TagInterface): Promise<void> {
+    log.verbose('Tag', 'deleteTag(%s, %s)', tagInstance)
+
+    const tag = { id: tagInstance.id(), groupId: tagInstance.groupId() } as TagIdentifier
 
     try {
-      await this.wechaty.puppet.tagTagDelete(tag.groupId(), tag.id())
+      await this.wechaty.puppet.tagTagDelete(tag)
+      this.pool.splice(this.pool.indexOf(tagInstance), 1)
     } catch (e) {
       this.wechaty.emitError(e)
-      log.error('Contact', 'deleteTag() exception: %s', (e as Error).message)
+      log.error('Tag', 'deleteTag() exception: %s', (e as Error).message)
     }
   }
 
+  override toString () {
+    return `<Tag#${this.name() || this.id()}>`
+  }
+
 }
 
 class TagImpl extends validationMixin(TagMixin)<TagInterface>() {}