revise room.say() mention function

[windmemory]

I'm submitting a...

[ ] Bug Fix
[ ] Feature
[x] Other (Refactoring, Added tests, Documentation, ...)

Refer to #1718

This PR involves a BREAKING CHANGE

[huan]

Please also add a unit test for the new Tagged Template modification.

And also please add a description of your BREAKING CHANGE with your PR, so that we could put it into the CHANGELOG later.

[windmemory]

BREAKING CHANGE:

room.say() function no longer accept arguments like below:

room.say(text: string, mention: Contact[])

Alternative solution

To mention multiple contacts when sending out text messages, there are two new ways of doing that:

room.say(text: string, ...mentionList: Contact[])

Sample code:

// Assume you got there Contact instance
// contactA assume the name is Alex
// contactB assume the name is Bob
// contactC assume the name is Carson
await room.say('let\'s party', contactA, contactB, contactC)

Send out text will be

@Alex @Bob @Carson let's party

Tagged Template

Sample code:

// Assume you got there Contact instance
// contactA assume the name is Alex
// contactB assume the name is Bob
// contactC assume the name is Carson
room.say`Hello ${contactA} and ${contactB}, this is ${contactC}`

Send out text will be

Hello @Alex and @Bob, this is @Carson

[huan]

Good job for adding the unit tests.

Please:

1. Bump the minor version in package.json file, and add the BREAKING CHANGES to README(in HISTORY section, with the new VERSION).
2. Follow my latest comments before we merge this PR.

[huan]

import { 
  ContactPayload,
  RoomMemberPayload,
  RoomPayload,
}                            from 'wechaty-puppet'

[huan]

Please add subtests for each room.say test.

i.e.

test('say()', async t => {
  // tear up...
  test('say() with param1', async t => {
    // do say() test 1
  })
  test('say() with param2', async t => {
    // do say() test 2
  })
  // other subtests ...
})

[huan]

Please add a new private function for the following codes for sayTemplateStringsArray().

    } else if (textOrListOrContactOrFileOrUrl instanceof Array) {
      return sayTemplateStringsArray(
        textOrListOrContactOrFileOrUrl, 
        ...mentionList,
      )
    }

[windmemory]

@huan Done.

[huan]

Thanks for your great PR!