@juzi/wechaty 1.0.150 → 1.0.155

package/dist/cjs/src/package-json.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.packageJson = exports.GIT_COMMIT_HASH = void 0;
-exports.GIT_COMMIT_HASH = 'e4d722bd21b4291abeec2865fb70f4b9b6406561';
+exports.GIT_COMMIT_HASH = '6ef3d89f2a44f5454d45c56ff45765c9eeca8a79';
 exports.packageJson = {
     "name": "@juzi/wechaty",
-    "version": "1.0.150",
+    "version": "1.0.155",
     "description": "Wechaty is a RPA SDK for Chatbot Makers.",
     "type": "module",
     "exports": {
@@ -113,7 +113,7 @@ exports.packageJson = {
     },
     "homepage": "https://github.com/wechaty/",
     "dependencies": {
-        "@juzi/wechaty-puppet-service": "1.0.118",
+        "@juzi/wechaty-puppet-service": "1.0.119",
         "clone-class": "^1.1.1",
         "cmd-ts": "^0.10.0",
         "cockatiel": "^2.0.2",
@@ -136,7 +136,7 @@ exports.packageJson = {
         "@chatie/eslint-config": "^1.0.4",
         "@chatie/semver": "^0.4.7",
         "@chatie/tsconfig": "^4.6.3",
-        "@juzi/wechaty-puppet": "^1.0.142",
+        "@juzi/wechaty-puppet": "^1.0.143",
         "@juzi/wechaty-puppet-mock": "^1.0.1",
         "@swc/core": "1.3.44",
         "@swc/helpers": "^0.3.6",

package/dist/cjs/src/user-modules/voice.d.ts

@@ -19,6 +19,7 @@
  */
 import type { FileBoxInterface } from 'file-box';
 import type { Constructor } from 'clone-class';
+import type * as PUPPET from '@juzi/wechaty-puppet';
 declare const VoiceMixin_base: ((abstract new (...args: any[]) => {
     readonly wechaty: import("../wechaty/wechaty-impl.js").WechatyInterface;
 }) & {
@@ -34,8 +35,10 @@ declare class VoiceMixin extends VoiceMixin_base {
      * Get the voice file (FileBox) via the puppet's dedicated `messageVoice` RPC.
      *
      * Falls back to the generic `messageFile` when the puppet does not implement
-     * `messageVoice` (old puppet without the new RPC → rejection), keeping the
-     * behaviour compatible with the legacy "voice file via messageFile" path.
+     * `messageVoice` — either the method is absent (old puppet built without it,
+     * caught by the `typeof` guard) or it rejects with an unsupported-API error.
+     * Keeps the behaviour compatible with the legacy "voice file via messageFile"
+     * path. A genuine runtime error from a working `messageVoice` is rethrown.
      */
     file(): Promise<FileBoxInterface>;
     /**
@@ -44,14 +47,14 @@ declare class VoiceMixin extends VoiceMixin_base {
      * "confirmed no speech" (`noSpeech=true`) from "normal transcription".
      *
      * Falls back to reading the legacy `messagePayload().text` when the puppet
-     * does not implement `messageVoiceText` (old puppet without the new RPC →
-     * rejection). Old puppets put the ASR result into `payload.text`, so this
-     * keeps the behaviour compatible; `noSpeech` is `false` in the fallback.
+     * does not implement `messageVoiceText` — either the method is absent (old
+     * puppet built without it, caught by the `typeof` guard) or it rejects with
+     * an unsupported-API error. Old puppets put the ASR result into
+     * `payload.text`, so this keeps the behaviour compatible; `noSpeech` is
+     * `false` in the fallback. A genuine runtime error is rethrown (so the bot
+     * does not silently drop `noSpeech` and re-run its own paid ASR).
      */
-    text(): Promise<{
-        text: string;
-        noSpeech: boolean;
-    }>;
+    text(): Promise<PUPPET.payloads.VoiceText>;
 }
 declare const VoiceImpl_base: {
     new (...args: any[]): {};

package/dist/cjs/src/user-modules/voice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../../../src/user-modules/voice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EACV,gBAAgB,EACjB,MAAwB,UAAU,CAAA;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;;;;;;;;AAQ9C,cAAM,UAAW,SAAQ,eAAoB;IAUlC,EAAE,EAAE,MAAM;IARnB,MAAM,CAAC,MAAM,CAAE,EAAE,EAAE,MAAM,GAAG,cAAc;gBAQjC,EAAE,EAAE,MAAM;IAMnB;;;;;;OAMG;IACG,IAAI,IAAK,OAAO,CAAC,gBAAgB,CAAC;IAYxC;;;;;;;;;OASG;IACG,IAAI,IAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CAY5D;;;;;;;AAED,cAAM,SAAU,SAAQ,cAA6C;CAAG;AACxE,UAAU,cAAe,SAAQ,SAAS;CAAI;AAE9C,aAAK,gBAAgB,GAAG,WAAW,CACjC,cAAc,EACd,OAAO,SAAS,CACjB,CAAA;AAED,YAAY,EACV,gBAAgB,EAChB,cAAc,GACf,CAAA;AACD,OAAO,EACL,SAAS,GACV,CAAA"}
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../../../src/user-modules/voice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EACV,gBAAgB,EACjB,MAAwB,UAAU,CAAA;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,KAAK,MAAM,MAAM,sBAAsB,CAAA;;;;;;;;AAsCnD,cAAM,UAAW,SAAQ,eAAoB;IAUlC,EAAE,EAAE,MAAM;IARnB,MAAM,CAAC,MAAM,CAAE,EAAE,EAAE,MAAM,GAAG,cAAc;gBAQjC,EAAE,EAAE,MAAM;IAMnB;;;;;;;;OAQG;IACG,IAAI,IAAK,OAAO,CAAC,gBAAgB,CAAC;IAqBxC;;;;;;;;;;;;OAYG;IACG,IAAI,IAAK,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;CAsBlD;;;;;;;AAED,cAAM,SAAU,SAAQ,cAA6C;CAAG;AACxE,UAAU,cAAe,SAAQ,SAAS;CAAI;AAE9C,aAAK,gBAAgB,GAAG,WAAW,CACjC,cAAc,EACd,OAAO,SAAS,CACjB,CAAA;AAED,YAAY,EACV,gBAAgB,EAChB,cAAc,GACf,CAAA;AACD,OAAO,EACL,SAAS,GACV,CAAA"}

package/dist/cjs/src/user-modules/voice.js

@@ -4,6 +4,34 @@ exports.VoiceImpl = void 0;
 const validation_js_1 = require("../user-mixins/validation.js");
 const config_js_1 = require("../config.js");
 const wechatify_js_1 = require("../user-mixins/wechatify.js");
+/**
+ * gRPC status code for an RPC the server does not implement.
+ * @see https://grpc.github.io/grpc/core/md_doc_statuscodes.html
+ */
+const GRPC_STATUS_UNIMPLEMENTED = 12;
+/**
+ * Whether `e` means the puppet / server does not implement the new voice RPC,
+ * i.e. it is safe to fall back to the legacy path.
+ *
+ * Transient errors (network / timeout / file expired / other gRPC codes) must
+ * NOT match here: otherwise the fallback silently masks real failures and — for
+ * `text()` — discards the `noSpeech` discriminator, making the bot re-run its
+ * own paid ASR on voices the puppet already confirmed as empty.
+ *
+ * Note: the "method does not exist at all" case (an old puppet built against a
+ * wechaty-puppet without the method) is detected up-front via a `typeof` guard
+ * at the call site, NOT here — matching the `'is not a function'` text would
+ * also swallow a genuine `TypeError` raised inside a working implementation.
+ */
+function isUnsupportedError(e) {
+    const err = e;
+    // old wechaty-puppet-service server without the new RPC → gRPC UNIMPLEMENTED
+    if (err?.code === GRPC_STATUS_UNIMPLEMENTED) {
+        return true;
+    }
+    // puppet implements the abstract method via throwUnsupportedError()
+    return (err?.message || '').includes('Unsupported API');
+}
 class VoiceMixin extends (0, wechatify_js_1.wechatifyMixinBase)() {
     id;
     static create(id) {
@@ -20,18 +48,29 @@ class VoiceMixin extends (0, wechatify_js_1.wechatifyMixinBase)() {
      * Get the voice file (FileBox) via the puppet's dedicated `messageVoice` RPC.
      *
      * Falls back to the generic `messageFile` when the puppet does not implement
-     * `messageVoice` (old puppet without the new RPC → rejection), keeping the
-     * behaviour compatible with the legacy "voice file via messageFile" path.
+     * `messageVoice` — either the method is absent (old puppet built without it,
+     * caught by the `typeof` guard) or it rejects with an unsupported-API error.
+     * Keeps the behaviour compatible with the legacy "voice file via messageFile"
+     * path. A genuine runtime error from a working `messageVoice` is rethrown.
      */
     async file() {
         config_js_1.log.verbose('Voice', 'file() for id: "%s"', this.id);
+        const puppet = this.wechaty.puppet;
+        // puppet built against an old wechaty-puppet without the method at all
+        if (typeof puppet.messageVoice !== 'function') {
+            config_js_1.log.verbose('Voice', 'file() messageVoice() absent, fallback to messageFile()');
+            return puppet.messageFile(this.id);
+        }
         try {
-            const fileBox = await this.wechaty.puppet.messageVoice(this.id);
+            const fileBox = await puppet.messageVoice(this.id);
             return fileBox;
         }
         catch (e) {
-            config_js_1.log.verbose('Voice', 'file() messageVoice() failed, fallback to messageFile(): %s', e.message);
-            const fileBox = await this.wechaty.puppet.messageFile(this.id);
+            if (!isUnsupportedError(e)) {
+                throw e;
+            }
+            config_js_1.log.verbose('Voice', 'file() messageVoice() unsupported, fallback to messageFile(): %s', e.message);
+            const fileBox = await puppet.messageFile(this.id);
             return fileBox;
         }
     }
@@ -41,19 +80,32 @@ class VoiceMixin extends (0, wechatify_js_1.wechatifyMixinBase)() {
      * "confirmed no speech" (`noSpeech=true`) from "normal transcription".
      *
      * Falls back to reading the legacy `messagePayload().text` when the puppet
-     * does not implement `messageVoiceText` (old puppet without the new RPC →
-     * rejection). Old puppets put the ASR result into `payload.text`, so this
-     * keeps the behaviour compatible; `noSpeech` is `false` in the fallback.
+     * does not implement `messageVoiceText` — either the method is absent (old
+     * puppet built without it, caught by the `typeof` guard) or it rejects with
+     * an unsupported-API error. Old puppets put the ASR result into
+     * `payload.text`, so this keeps the behaviour compatible; `noSpeech` is
+     * `false` in the fallback. A genuine runtime error is rethrown (so the bot
+     * does not silently drop `noSpeech` and re-run its own paid ASR).
      */
     async text() {
         config_js_1.log.verbose('Voice', 'text() for id: "%s"', this.id);
+        const puppet = this.wechaty.puppet;
+        // puppet built against an old wechaty-puppet without the method at all
+        if (typeof puppet.messageVoiceText !== 'function') {
+            config_js_1.log.verbose('Voice', 'text() messageVoiceText() absent, fallback to messagePayload().text');
+            const payload = await puppet.messagePayload(this.id);
+            return { text: payload.text || '', noSpeech: false };
+        }
         try {
-            const payload = await this.wechaty.puppet.messageVoiceText(this.id);
+            const payload = await puppet.messageVoiceText(this.id);
             return payload;
         }
         catch (e) {
-            config_js_1.log.verbose('Voice', 'text() messageVoiceText() failed, fallback to messagePayload().text: %s', e.message);
-            const payload = await this.wechaty.puppet.messagePayload(this.id);
+            if (!isUnsupportedError(e)) {
+                throw e;
+            }
+            config_js_1.log.verbose('Voice', 'text() messageVoiceText() unsupported, fallback to messagePayload().text: %s', e.message);
+            const payload = await puppet.messagePayload(this.id);
             return { text: payload.text || '', noSpeech: false };
         }
     }

package/dist/cjs/src/user-modules/voice.js.map

@@ -1 +1 @@
-{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../../../src/user-modules/voice.ts"],"names":[],"mappings":";;;AAuBA,gEAA8D;AAC9D,4CAAkC;AAElC,8DAE0D;AAE1D,MAAM,UAAW,SAAQ,IAAA,iCAAkB,GAAE;IAUlC;IART,MAAM,CAAC,MAAM,CAAE,EAAU;QACvB,eAAG,CAAC,OAAO,CAAC,OAAO,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAA;QAE7C,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;QAC1B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,YACS,EAAU;QAEjB,KAAK,EAAE,CAAA;QAFA,OAAE,GAAF,EAAE,CAAQ;QAGjB,eAAG,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAA;IAC7C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI;QACR,eAAG,CAAC,OAAO,CAAC,OAAO,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;QACpD,IAAI;YACF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC/D,OAAO,OAAO,CAAA;SACf;QAAC,OAAO,CAAC,EAAE;YACV,eAAG,CAAC,OAAO,CAAC,OAAO,EAAE,6DAA6D,EAAG,CAAW,CAAC,OAAO,CAAC,CAAA;YACzG,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC9D,OAAO,OAAO,CAAA;SACf;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI;QACR,eAAG,CAAC,OAAO,CAAC,OAAO,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;QACpD,IAAI;YACF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACnE,OAAO,OAAO,CAAA;SACf;QAAC,OAAO,CAAC,EAAE;YACV,eAAG,CAAC,OAAO,CAAC,OAAO,EAAE,yEAAyE,EAAG,CAAW,CAAC,OAAO,CAAC,CAAA;YACrH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACjE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;SACrD;IACH,CAAC;CAEF;AAED,MAAM,SAAU,SAAQ,IAAA,+BAAe,EAAC,UAAU,CAAC,EAAkB;CAAG;AAatE,8BAAS"}
+{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../../../src/user-modules/voice.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/user-modules/voice.spec.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env -S node --no-warnings --loader ts-node/esm
+export {};
+//# sourceMappingURL=voice.spec.d.ts.map

package/dist/cjs/src/user-modules/voice.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.spec.d.ts","sourceRoot":"","sources":["../../../../src/user-modules/voice.spec.ts"],"names":[],"mappings":""}

package/dist/cjs/src/user-modules/voice.spec.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env -S node --no-warnings --loader ts-node/esm
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ *   Wechaty Chatbot SDK - https://github.com/wechaty/wechaty
+ *
+ *   @copyright 2016 Huan LI (李卓桓) <https://github.com/huan>, and
+ *                   Wechaty Contributors <https://github.com/wechaty>.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ *
+ */
+const tstest_1 = require("tstest");
+const file_box_1 = require("file-box");
+const wechaty_puppet_mock_1 = require("@juzi/wechaty-puppet-mock");
+const wechaty_builder_js_1 = require("../wechaty-builder.js");
+const MESSAGE_ID = 'message-id-voice';
+/**
+ * The fallback must trigger ONLY when the puppet does not implement the new
+ * RPC, never on transient failures: otherwise `text()` silently drops the
+ * `noSpeech` discriminator and makes the bot re-run its own paid ASR.
+ *
+ * The puppet is built & started once and reused across cases (`wechaty.Voice`
+ * is unavailable before `start()`). `messageVoice` / `messageVoiceText` are
+ * assigned directly (rather than via `sinon.stub(puppet, ...)`) because the
+ * installed wechaty-puppet-mock predates those methods, so stubbing a
+ * non-existent property would throw.
+ */
+const puppet = new wechaty_puppet_mock_1.PuppetMock();
+const wechaty = wechaty_builder_js_1.WechatyBuilder.build({ puppet });
+let started = false;
+async function ensureStarted() {
+    if (!started) {
+        await wechaty.start();
+        started = true;
+    }
+}
+const voice = () => wechaty.Voice.create(MESSAGE_ID);
+const UNSUPPORTED = new Error('Wechaty Puppet Unsupported API Error.');
+(0, tstest_1.test)('Voice.file() returns the dedicated messageVoice result when supported', async (t) => {
+    await ensureStarted();
+    puppet.messageVoice = tstest_1.sinon.stub().resolves(file_box_1.FileBox.fromBuffer(Buffer.from('voice'), 'voice.silk'));
+    puppet.messageFile = tstest_1.sinon.stub().resolves(file_box_1.FileBox.fromBuffer(Buffer.from('file'), 'file.bin'));
+    const fileBox = await voice().file();
+    t.equal(fileBox.name, 'voice.silk', 'should return the messageVoice FileBox');
+    t.ok(puppet.messageVoice.calledOnceWith(MESSAGE_ID), 'should call messageVoice');
+    t.notOk(puppet.messageFile.called, 'should NOT fall back to messageFile when supported');
+});
+(0, tstest_1.test)('Voice.file() falls back to messageFile on unsupported error', async (t) => {
+    await ensureStarted();
+    puppet.messageVoice = tstest_1.sinon.stub().rejects(UNSUPPORTED);
+    puppet.messageFile = tstest_1.sinon.stub().resolves(file_box_1.FileBox.fromBuffer(Buffer.from('file'), 'file.bin'));
+    const fileBox = await voice().file();
+    t.equal(fileBox.name, 'file.bin', 'should fall back to messageFile');
+    t.ok(puppet.messageFile.calledOnceWith(MESSAGE_ID), 'should call messageFile on fallback');
+});
+(0, tstest_1.test)('Voice.file() falls back to messageFile when messageVoice is absent (old puppet)', async (t) => {
+    await ensureStarted();
+    puppet.messageVoice = undefined; // old puppet built without the method at all
+    puppet.messageFile = tstest_1.sinon.stub().resolves(file_box_1.FileBox.fromBuffer(Buffer.from('file'), 'file.bin'));
+    const fileBox = await voice().file();
+    t.equal(fileBox.name, 'file.bin', 'should fall back to messageFile via the typeof guard');
+    t.ok(puppet.messageFile.calledOnceWith(MESSAGE_ID), 'should call messageFile on fallback');
+});
+(0, tstest_1.test)('Voice.file() rethrows a transient error instead of falling back', async (t) => {
+    await ensureStarted();
+    puppet.messageVoice = tstest_1.sinon.stub().rejects(new Error('socket hang up'));
+    puppet.messageFile = tstest_1.sinon.stub().resolves(file_box_1.FileBox.fromBuffer(Buffer.from('file'), 'file.bin'));
+    await t.rejects(() => voice().file(), /socket hang up/, 'should rethrow the transient error');
+    t.notOk(puppet.messageFile.called, 'should NOT fall back on a transient error');
+});
+(0, tstest_1.test)('Voice.file() rethrows a genuine "is not a function" TypeError from a working messageVoice', async (t) => {
+    await ensureStarted();
+    // method exists but its implementation throws internally — must NOT be
+    // misclassified as unsupported just because the message says "is not a function"
+    puppet.messageVoice = tstest_1.sinon.stub().rejects(new TypeError('innerHelper.process is not a function'));
+    puppet.messageFile = tstest_1.sinon.stub().resolves(file_box_1.FileBox.fromBuffer(Buffer.from('file'), 'file.bin'));
+    await t.rejects(() => voice().file(), /is not a function/, 'should rethrow the internal TypeError');
+    t.notOk(puppet.messageFile.called, 'should NOT mask a real implementation bug');
+});
+(0, tstest_1.test)('Voice.text() returns the dedicated messageVoiceText payload when supported', async (t) => {
+    await ensureStarted();
+    puppet.messageVoiceText = tstest_1.sinon.stub().resolves({ text: 'hello', noSpeech: false });
+    puppet.messagePayload = tstest_1.sinon.stub().resolves({ text: 'legacy' });
+    const result = await voice().text();
+    t.same(result, { text: 'hello', noSpeech: false }, 'should return the messageVoiceText payload');
+    t.ok(puppet.messageVoiceText.calledOnceWith(MESSAGE_ID), 'should call messageVoiceText');
+    t.notOk(puppet.messagePayload.called, 'should NOT fall back to messagePayload when supported');
+});
+(0, tstest_1.test)('Voice.text() preserves noSpeech=true from the puppet (skip paid ASR)', async (t) => {
+    await ensureStarted();
+    puppet.messageVoiceText = tstest_1.sinon.stub().resolves({ text: '', noSpeech: true });
+    puppet.messagePayload = tstest_1.sinon.stub().resolves({ text: '' });
+    const result = await voice().text();
+    t.same(result, { text: '', noSpeech: true }, 'should return the puppet payload verbatim');
+    t.equal(result.noSpeech, true, 'should preserve noSpeech=true so the bot can skip its own ASR');
+    t.ok(puppet.messageVoiceText.calledOnceWith(MESSAGE_ID), 'should call messageVoiceText');
+    t.notOk(puppet.messagePayload.called, 'should NOT fall back when supported');
+});
+(0, tstest_1.test)('Voice.text() falls back to messagePayload().text on unsupported error', async (t) => {
+    await ensureStarted();
+    puppet.messageVoiceText = tstest_1.sinon.stub().rejects(UNSUPPORTED);
+    puppet.messagePayload = tstest_1.sinon.stub().resolves({ text: 'legacy asr' });
+    const result = await voice().text();
+    t.same(result, { text: 'legacy asr', noSpeech: false }, 'should fall back to legacy payload.text with noSpeech=false');
+    t.ok(puppet.messagePayload.calledOnceWith(MESSAGE_ID), 'should call messagePayload on fallback');
+});
+(0, tstest_1.test)('Voice.text() falls back on gRPC UNIMPLEMENTED (code 12)', async (t) => {
+    await ensureStarted();
+    const unimplemented = Object.assign(new Error('12 UNIMPLEMENTED'), { code: 12 });
+    puppet.messageVoiceText = tstest_1.sinon.stub().rejects(unimplemented);
+    puppet.messagePayload = tstest_1.sinon.stub().resolves({ text: 'legacy asr' });
+    const result = await voice().text();
+    t.same(result, { text: 'legacy asr', noSpeech: false }, 'should fall back when the server returns UNIMPLEMENTED');
+    t.ok(puppet.messagePayload.calledOnceWith(MESSAGE_ID), 'should call messagePayload on fallback');
+});
+(0, tstest_1.test)('Voice.text() falls back to messagePayload when messageVoiceText is absent (old puppet)', async (t) => {
+    await ensureStarted();
+    puppet.messageVoiceText = undefined; // old puppet built without the method at all
+    puppet.messagePayload = tstest_1.sinon.stub().resolves({ text: 'legacy asr' });
+    const result = await voice().text();
+    t.same(result, { text: 'legacy asr', noSpeech: false }, 'should fall back via the typeof guard with noSpeech=false');
+    t.ok(puppet.messagePayload.calledOnceWith(MESSAGE_ID), 'should call messagePayload on fallback');
+});
+(0, tstest_1.test)('Voice.text() rethrows a transient error instead of falling back', async (t) => {
+    await ensureStarted();
+    puppet.messageVoiceText = tstest_1.sinon.stub().rejects(new Error('ETIMEDOUT'));
+    puppet.messagePayload = tstest_1.sinon.stub().resolves({ text: 'legacy asr' });
+    await t.rejects(() => voice().text(), /ETIMEDOUT/, 'should rethrow the transient error');
+    t.notOk(puppet.messagePayload.called, 'should NOT fall back on a transient error (would drop noSpeech)');
+});
+(0, tstest_1.test)('Voice.text() rethrows a genuine "is not a function" TypeError from a working messageVoiceText', async (t) => {
+    await ensureStarted();
+    // regression: a real internal TypeError must NOT be downgraded — that would
+    // drop noSpeech and make the bot re-run its own paid ASR
+    puppet.messageVoiceText = tstest_1.sinon.stub().rejects(new TypeError('innerHelper.process is not a function'));
+    puppet.messagePayload = tstest_1.sinon.stub().resolves({ text: 'legacy asr' });
+    await t.rejects(() => voice().text(), /is not a function/, 'should rethrow the internal TypeError');
+    t.notOk(puppet.messagePayload.called, 'should NOT mask a real implementation bug');
+});
+(0, tstest_1.test)('teardown: stop the shared wechaty', async (t) => {
+    await wechaty.stop();
+    t.pass('stopped');
+});
+//# sourceMappingURL=voice.spec.js.map

package/dist/cjs/src/user-modules/voice.spec.js.map

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

package/dist/esm/src/package-json.js

@@ -1,7 +1,7 @@
-export const GIT_COMMIT_HASH = 'e4d722bd21b4291abeec2865fb70f4b9b6406561';
+export const GIT_COMMIT_HASH = '6ef3d89f2a44f5454d45c56ff45765c9eeca8a79';
 export const packageJson = {
     "name": "@juzi/wechaty",
-    "version": "1.0.150",
+    "version": "1.0.155",
     "description": "Wechaty is a RPA SDK for Chatbot Makers.",
     "type": "module",
     "exports": {
@@ -110,7 +110,7 @@ export const packageJson = {
     },
     "homepage": "https://github.com/wechaty/",
     "dependencies": {
-        "@juzi/wechaty-puppet-service": "1.0.118",
+        "@juzi/wechaty-puppet-service": "1.0.119",
         "clone-class": "^1.1.1",
         "cmd-ts": "^0.10.0",
         "cockatiel": "^2.0.2",
@@ -133,7 +133,7 @@ export const packageJson = {
         "@chatie/eslint-config": "^1.0.4",
         "@chatie/semver": "^0.4.7",
         "@chatie/tsconfig": "^4.6.3",
-        "@juzi/wechaty-puppet": "^1.0.142",
+        "@juzi/wechaty-puppet": "^1.0.143",
         "@juzi/wechaty-puppet-mock": "^1.0.1",
         "@swc/core": "1.3.44",
         "@swc/helpers": "^0.3.6",

package/dist/esm/src/user-modules/voice.d.ts

@@ -19,6 +19,7 @@
  */
 import type { FileBoxInterface } from 'file-box';
 import type { Constructor } from 'clone-class';
+import type * as PUPPET from '@juzi/wechaty-puppet';
 declare const VoiceMixin_base: ((abstract new (...args: any[]) => {
     readonly wechaty: import("../wechaty/wechaty-impl.js").WechatyInterface;
 }) & {
@@ -34,8 +35,10 @@ declare class VoiceMixin extends VoiceMixin_base {
      * Get the voice file (FileBox) via the puppet's dedicated `messageVoice` RPC.
      *
      * Falls back to the generic `messageFile` when the puppet does not implement
-     * `messageVoice` (old puppet without the new RPC → rejection), keeping the
-     * behaviour compatible with the legacy "voice file via messageFile" path.
+     * `messageVoice` — either the method is absent (old puppet built without it,
+     * caught by the `typeof` guard) or it rejects with an unsupported-API error.
+     * Keeps the behaviour compatible with the legacy "voice file via messageFile"
+     * path. A genuine runtime error from a working `messageVoice` is rethrown.
      */
     file(): Promise<FileBoxInterface>;
     /**
@@ -44,14 +47,14 @@ declare class VoiceMixin extends VoiceMixin_base {
      * "confirmed no speech" (`noSpeech=true`) from "normal transcription".
      *
      * Falls back to reading the legacy `messagePayload().text` when the puppet
-     * does not implement `messageVoiceText` (old puppet without the new RPC →
-     * rejection). Old puppets put the ASR result into `payload.text`, so this
-     * keeps the behaviour compatible; `noSpeech` is `false` in the fallback.
+     * does not implement `messageVoiceText` — either the method is absent (old
+     * puppet built without it, caught by the `typeof` guard) or it rejects with
+     * an unsupported-API error. Old puppets put the ASR result into
+     * `payload.text`, so this keeps the behaviour compatible; `noSpeech` is
+     * `false` in the fallback. A genuine runtime error is rethrown (so the bot
+     * does not silently drop `noSpeech` and re-run its own paid ASR).
      */
-    text(): Promise<{
-        text: string;
-        noSpeech: boolean;
-    }>;
+    text(): Promise<PUPPET.payloads.VoiceText>;
 }
 declare const VoiceImpl_base: {
     new (...args: any[]): {};

package/dist/esm/src/user-modules/voice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../../../src/user-modules/voice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EACV,gBAAgB,EACjB,MAAwB,UAAU,CAAA;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;;;;;;;;AAQ9C,cAAM,UAAW,SAAQ,eAAoB;IAUlC,EAAE,EAAE,MAAM;IARnB,MAAM,CAAC,MAAM,CAAE,EAAE,EAAE,MAAM,GAAG,cAAc;gBAQjC,EAAE,EAAE,MAAM;IAMnB;;;;;;OAMG;IACG,IAAI,IAAK,OAAO,CAAC,gBAAgB,CAAC;IAYxC;;;;;;;;;OASG;IACG,IAAI,IAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CAY5D;;;;;;;AAED,cAAM,SAAU,SAAQ,cAA6C;CAAG;AACxE,UAAU,cAAe,SAAQ,SAAS;CAAI;AAE9C,aAAK,gBAAgB,GAAG,WAAW,CACjC,cAAc,EACd,OAAO,SAAS,CACjB,CAAA;AAED,YAAY,EACV,gBAAgB,EAChB,cAAc,GACf,CAAA;AACD,OAAO,EACL,SAAS,GACV,CAAA"}
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../../../src/user-modules/voice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EACV,gBAAgB,EACjB,MAAwB,UAAU,CAAA;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,KAAK,MAAM,MAAM,sBAAsB,CAAA;;;;;;;;AAsCnD,cAAM,UAAW,SAAQ,eAAoB;IAUlC,EAAE,EAAE,MAAM;IARnB,MAAM,CAAC,MAAM,CAAE,EAAE,EAAE,MAAM,GAAG,cAAc;gBAQjC,EAAE,EAAE,MAAM;IAMnB;;;;;;;;OAQG;IACG,IAAI,IAAK,OAAO,CAAC,gBAAgB,CAAC;IAqBxC;;;;;;;;;;;;OAYG;IACG,IAAI,IAAK,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;CAsBlD;;;;;;;AAED,cAAM,SAAU,SAAQ,cAA6C;CAAG;AACxE,UAAU,cAAe,SAAQ,SAAS;CAAI;AAE9C,aAAK,gBAAgB,GAAG,WAAW,CACjC,cAAc,EACd,OAAO,SAAS,CACjB,CAAA;AAED,YAAY,EACV,gBAAgB,EAChB,cAAc,GACf,CAAA;AACD,OAAO,EACL,SAAS,GACV,CAAA"}

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

@@ -1,6 +1,34 @@
 import { validationMixin } from '../user-mixins/validation.js';
 import { log } from '../config.js';
 import { wechatifyMixinBase, } from '../user-mixins/wechatify.js';
+/**
+ * gRPC status code for an RPC the server does not implement.
+ * @see https://grpc.github.io/grpc/core/md_doc_statuscodes.html
+ */
+const GRPC_STATUS_UNIMPLEMENTED = 12;
+/**
+ * Whether `e` means the puppet / server does not implement the new voice RPC,
+ * i.e. it is safe to fall back to the legacy path.
+ *
+ * Transient errors (network / timeout / file expired / other gRPC codes) must
+ * NOT match here: otherwise the fallback silently masks real failures and — for
+ * `text()` — discards the `noSpeech` discriminator, making the bot re-run its
+ * own paid ASR on voices the puppet already confirmed as empty.
+ *
+ * Note: the "method does not exist at all" case (an old puppet built against a
+ * wechaty-puppet without the method) is detected up-front via a `typeof` guard
+ * at the call site, NOT here — matching the `'is not a function'` text would
+ * also swallow a genuine `TypeError` raised inside a working implementation.
+ */
+function isUnsupportedError(e) {
+    const err = e;
+    // old wechaty-puppet-service server without the new RPC → gRPC UNIMPLEMENTED
+    if (err?.code === GRPC_STATUS_UNIMPLEMENTED) {
+        return true;
+    }
+    // puppet implements the abstract method via throwUnsupportedError()
+    return (err?.message || '').includes('Unsupported API');
+}
 class VoiceMixin extends wechatifyMixinBase() {
     id;
     static create(id) {
@@ -17,18 +45,29 @@ class VoiceMixin extends wechatifyMixinBase() {
      * Get the voice file (FileBox) via the puppet's dedicated `messageVoice` RPC.
      *
      * Falls back to the generic `messageFile` when the puppet does not implement
-     * `messageVoice` (old puppet without the new RPC → rejection), keeping the
-     * behaviour compatible with the legacy "voice file via messageFile" path.
+     * `messageVoice` — either the method is absent (old puppet built without it,
+     * caught by the `typeof` guard) or it rejects with an unsupported-API error.
+     * Keeps the behaviour compatible with the legacy "voice file via messageFile"
+     * path. A genuine runtime error from a working `messageVoice` is rethrown.
      */
     async file() {
         log.verbose('Voice', 'file() for id: "%s"', this.id);
+        const puppet = this.wechaty.puppet;
+        // puppet built against an old wechaty-puppet without the method at all
+        if (typeof puppet.messageVoice !== 'function') {
+            log.verbose('Voice', 'file() messageVoice() absent, fallback to messageFile()');
+            return puppet.messageFile(this.id);
+        }
         try {
-            const fileBox = await this.wechaty.puppet.messageVoice(this.id);
+            const fileBox = await puppet.messageVoice(this.id);
             return fileBox;
         }
         catch (e) {
-            log.verbose('Voice', 'file() messageVoice() failed, fallback to messageFile(): %s', e.message);
-            const fileBox = await this.wechaty.puppet.messageFile(this.id);
+            if (!isUnsupportedError(e)) {
+                throw e;
+            }
+            log.verbose('Voice', 'file() messageVoice() unsupported, fallback to messageFile(): %s', e.message);
+            const fileBox = await puppet.messageFile(this.id);
             return fileBox;
         }
     }
@@ -38,19 +77,32 @@ class VoiceMixin extends wechatifyMixinBase() {
      * "confirmed no speech" (`noSpeech=true`) from "normal transcription".
      *
      * Falls back to reading the legacy `messagePayload().text` when the puppet
-     * does not implement `messageVoiceText` (old puppet without the new RPC →
-     * rejection). Old puppets put the ASR result into `payload.text`, so this
-     * keeps the behaviour compatible; `noSpeech` is `false` in the fallback.
+     * does not implement `messageVoiceText` — either the method is absent (old
+     * puppet built without it, caught by the `typeof` guard) or it rejects with
+     * an unsupported-API error. Old puppets put the ASR result into
+     * `payload.text`, so this keeps the behaviour compatible; `noSpeech` is
+     * `false` in the fallback. A genuine runtime error is rethrown (so the bot
+     * does not silently drop `noSpeech` and re-run its own paid ASR).
      */
     async text() {
         log.verbose('Voice', 'text() for id: "%s"', this.id);
+        const puppet = this.wechaty.puppet;
+        // puppet built against an old wechaty-puppet without the method at all
+        if (typeof puppet.messageVoiceText !== 'function') {
+            log.verbose('Voice', 'text() messageVoiceText() absent, fallback to messagePayload().text');
+            const payload = await puppet.messagePayload(this.id);
+            return { text: payload.text || '', noSpeech: false };
+        }
         try {
-            const payload = await this.wechaty.puppet.messageVoiceText(this.id);
+            const payload = await puppet.messageVoiceText(this.id);
             return payload;
         }
         catch (e) {
-            log.verbose('Voice', 'text() messageVoiceText() failed, fallback to messagePayload().text: %s', e.message);
-            const payload = await this.wechaty.puppet.messagePayload(this.id);
+            if (!isUnsupportedError(e)) {
+                throw e;
+            }
+            log.verbose('Voice', 'text() messageVoiceText() unsupported, fallback to messagePayload().text: %s', e.message);
+            const payload = await puppet.messagePayload(this.id);
             return { text: payload.text || '', noSpeech: false };
         }
     }

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

@@ -1 +1 @@
-{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../../../src/user-modules/voice.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAElC,OAAO,EACL,kBAAkB,GACnB,MAA4B,6BAA6B,CAAA;AAE1D,MAAM,UAAW,SAAQ,kBAAkB,EAAE;IAUlC;IART,MAAM,CAAC,MAAM,CAAE,EAAU;QACvB,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAA;QAE7C,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;QAC1B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,YACS,EAAU;QAEjB,KAAK,EAAE,CAAA;QAFA,OAAE,GAAF,EAAE,CAAQ;QAGjB,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAA;IAC7C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI;QACR,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;QACpD,IAAI;YACF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC/D,OAAO,OAAO,CAAA;SACf;QAAC,OAAO,CAAC,EAAE;YACV,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,6DAA6D,EAAG,CAAW,CAAC,OAAO,CAAC,CAAA;YACzG,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC9D,OAAO,OAAO,CAAA;SACf;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI;QACR,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,qBAAqB,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;QACpD,IAAI;YACF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACnE,OAAO,OAAO,CAAA;SACf;QAAC,OAAO,CAAC,EAAE;YACV,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,yEAAyE,EAAG,CAAW,CAAC,OAAO,CAAC,CAAA;YACrH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACjE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;SACrD;IACH,CAAC;CAEF;AAED,MAAM,SAAU,SAAQ,eAAe,CAAC,UAAU,CAAC,EAAkB;CAAG;AAYxE,OAAO,EACL,SAAS,GACV,CAAA"}
+{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../../../src/user-modules/voice.ts"],"names":[],"mappings":"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"}

package/dist/esm/src/user-modules/voice.spec.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env -S node --no-warnings --loader ts-node/esm
+export {};
+//# sourceMappingURL=voice.spec.d.ts.map

package/dist/esm/src/user-modules/voice.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.spec.d.ts","sourceRoot":"","sources":["../../../../src/user-modules/voice.spec.ts"],"names":[],"mappings":""}

package/dist/esm/src/user-modules/voice.spec.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env -S node --no-warnings --loader ts-node/esm
+/**
+ *   Wechaty Chatbot SDK - https://github.com/wechaty/wechaty
+ *
+ *   @copyright 2016 Huan LI (李卓桓) <https://github.com/huan>, and
+ *                   Wechaty Contributors <https://github.com/wechaty>.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ *
+ */
+import { test, sinon, } from 'tstest';
+import { FileBox } from 'file-box';
+import { PuppetMock } from '@juzi/wechaty-puppet-mock';
+import { WechatyBuilder } from '../wechaty-builder.js';
+const MESSAGE_ID = 'message-id-voice';
+/**
+ * The fallback must trigger ONLY when the puppet does not implement the new
+ * RPC, never on transient failures: otherwise `text()` silently drops the
+ * `noSpeech` discriminator and makes the bot re-run its own paid ASR.
+ *
+ * The puppet is built & started once and reused across cases (`wechaty.Voice`
+ * is unavailable before `start()`). `messageVoice` / `messageVoiceText` are
+ * assigned directly (rather than via `sinon.stub(puppet, ...)`) because the
+ * installed wechaty-puppet-mock predates those methods, so stubbing a
+ * non-existent property would throw.
+ */
+const puppet = new PuppetMock();
+const wechaty = WechatyBuilder.build({ puppet });
+let started = false;
+async function ensureStarted() {
+    if (!started) {
+        await wechaty.start();
+        started = true;
+    }
+}
+const voice = () => wechaty.Voice.create(MESSAGE_ID);
+const UNSUPPORTED = new Error('Wechaty Puppet Unsupported API Error.');
+test('Voice.file() returns the dedicated messageVoice result when supported', async (t) => {
+    await ensureStarted();
+    puppet.messageVoice = sinon.stub().resolves(FileBox.fromBuffer(Buffer.from('voice'), 'voice.silk'));
+    puppet.messageFile = sinon.stub().resolves(FileBox.fromBuffer(Buffer.from('file'), 'file.bin'));
+    const fileBox = await voice().file();
+    t.equal(fileBox.name, 'voice.silk', 'should return the messageVoice FileBox');
+    t.ok(puppet.messageVoice.calledOnceWith(MESSAGE_ID), 'should call messageVoice');
+    t.notOk(puppet.messageFile.called, 'should NOT fall back to messageFile when supported');
+});
+test('Voice.file() falls back to messageFile on unsupported error', async (t) => {
+    await ensureStarted();
+    puppet.messageVoice = sinon.stub().rejects(UNSUPPORTED);
+    puppet.messageFile = sinon.stub().resolves(FileBox.fromBuffer(Buffer.from('file'), 'file.bin'));
+    const fileBox = await voice().file();
+    t.equal(fileBox.name, 'file.bin', 'should fall back to messageFile');
+    t.ok(puppet.messageFile.calledOnceWith(MESSAGE_ID), 'should call messageFile on fallback');
+});
+test('Voice.file() falls back to messageFile when messageVoice is absent (old puppet)', async (t) => {
+    await ensureStarted();
+    puppet.messageVoice = undefined; // old puppet built without the method at all
+    puppet.messageFile = sinon.stub().resolves(FileBox.fromBuffer(Buffer.from('file'), 'file.bin'));
+    const fileBox = await voice().file();
+    t.equal(fileBox.name, 'file.bin', 'should fall back to messageFile via the typeof guard');
+    t.ok(puppet.messageFile.calledOnceWith(MESSAGE_ID), 'should call messageFile on fallback');
+});
+test('Voice.file() rethrows a transient error instead of falling back', async (t) => {
+    await ensureStarted();
+    puppet.messageVoice = sinon.stub().rejects(new Error('socket hang up'));
+    puppet.messageFile = sinon.stub().resolves(FileBox.fromBuffer(Buffer.from('file'), 'file.bin'));
+    await t.rejects(() => voice().file(), /socket hang up/, 'should rethrow the transient error');
+    t.notOk(puppet.messageFile.called, 'should NOT fall back on a transient error');
+});
+test('Voice.file() rethrows a genuine "is not a function" TypeError from a working messageVoice', async (t) => {
+    await ensureStarted();
+    // method exists but its implementation throws internally — must NOT be
+    // misclassified as unsupported just because the message says "is not a function"
+    puppet.messageVoice = sinon.stub().rejects(new TypeError('innerHelper.process is not a function'));
+    puppet.messageFile = sinon.stub().resolves(FileBox.fromBuffer(Buffer.from('file'), 'file.bin'));
+    await t.rejects(() => voice().file(), /is not a function/, 'should rethrow the internal TypeError');
+    t.notOk(puppet.messageFile.called, 'should NOT mask a real implementation bug');
+});
+test('Voice.text() returns the dedicated messageVoiceText payload when supported', async (t) => {
+    await ensureStarted();
+    puppet.messageVoiceText = sinon.stub().resolves({ text: 'hello', noSpeech: false });
+    puppet.messagePayload = sinon.stub().resolves({ text: 'legacy' });
+    const result = await voice().text();
+    t.same(result, { text: 'hello', noSpeech: false }, 'should return the messageVoiceText payload');
+    t.ok(puppet.messageVoiceText.calledOnceWith(MESSAGE_ID), 'should call messageVoiceText');
+    t.notOk(puppet.messagePayload.called, 'should NOT fall back to messagePayload when supported');
+});
+test('Voice.text() preserves noSpeech=true from the puppet (skip paid ASR)', async (t) => {
+    await ensureStarted();
+    puppet.messageVoiceText = sinon.stub().resolves({ text: '', noSpeech: true });
+    puppet.messagePayload = sinon.stub().resolves({ text: '' });
+    const result = await voice().text();
+    t.same(result, { text: '', noSpeech: true }, 'should return the puppet payload verbatim');
+    t.equal(result.noSpeech, true, 'should preserve noSpeech=true so the bot can skip its own ASR');
+    t.ok(puppet.messageVoiceText.calledOnceWith(MESSAGE_ID), 'should call messageVoiceText');
+    t.notOk(puppet.messagePayload.called, 'should NOT fall back when supported');
+});
+test('Voice.text() falls back to messagePayload().text on unsupported error', async (t) => {
+    await ensureStarted();
+    puppet.messageVoiceText = sinon.stub().rejects(UNSUPPORTED);
+    puppet.messagePayload = sinon.stub().resolves({ text: 'legacy asr' });
+    const result = await voice().text();
+    t.same(result, { text: 'legacy asr', noSpeech: false }, 'should fall back to legacy payload.text with noSpeech=false');
+    t.ok(puppet.messagePayload.calledOnceWith(MESSAGE_ID), 'should call messagePayload on fallback');
+});
+test('Voice.text() falls back on gRPC UNIMPLEMENTED (code 12)', async (t) => {
+    await ensureStarted();
+    const unimplemented = Object.assign(new Error('12 UNIMPLEMENTED'), { code: 12 });
+    puppet.messageVoiceText = sinon.stub().rejects(unimplemented);
+    puppet.messagePayload = sinon.stub().resolves({ text: 'legacy asr' });
+    const result = await voice().text();
+    t.same(result, { text: 'legacy asr', noSpeech: false }, 'should fall back when the server returns UNIMPLEMENTED');
+    t.ok(puppet.messagePayload.calledOnceWith(MESSAGE_ID), 'should call messagePayload on fallback');
+});
+test('Voice.text() falls back to messagePayload when messageVoiceText is absent (old puppet)', async (t) => {
+    await ensureStarted();
+    puppet.messageVoiceText = undefined; // old puppet built without the method at all
+    puppet.messagePayload = sinon.stub().resolves({ text: 'legacy asr' });
+    const result = await voice().text();
+    t.same(result, { text: 'legacy asr', noSpeech: false }, 'should fall back via the typeof guard with noSpeech=false');
+    t.ok(puppet.messagePayload.calledOnceWith(MESSAGE_ID), 'should call messagePayload on fallback');
+});
+test('Voice.text() rethrows a transient error instead of falling back', async (t) => {
+    await ensureStarted();
+    puppet.messageVoiceText = sinon.stub().rejects(new Error('ETIMEDOUT'));
+    puppet.messagePayload = sinon.stub().resolves({ text: 'legacy asr' });
+    await t.rejects(() => voice().text(), /ETIMEDOUT/, 'should rethrow the transient error');
+    t.notOk(puppet.messagePayload.called, 'should NOT fall back on a transient error (would drop noSpeech)');
+});
+test('Voice.text() rethrows a genuine "is not a function" TypeError from a working messageVoiceText', async (t) => {
+    await ensureStarted();
+    // regression: a real internal TypeError must NOT be downgraded — that would
+    // drop noSpeech and make the bot re-run its own paid ASR
+    puppet.messageVoiceText = sinon.stub().rejects(new TypeError('innerHelper.process is not a function'));
+    puppet.messagePayload = sinon.stub().resolves({ text: 'legacy asr' });
+    await t.rejects(() => voice().text(), /is not a function/, 'should rethrow the internal TypeError');
+    t.notOk(puppet.messagePayload.called, 'should NOT mask a real implementation bug');
+});
+test('teardown: stop the shared wechaty', async (t) => {
+    await wechaty.stop();
+    t.pass('stopped');
+});
+//# sourceMappingURL=voice.spec.js.map

package/dist/esm/src/user-modules/voice.spec.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juzi/wechaty",
-  "version": "1.0.150",
+  "version": "1.0.155",
   "description": "Wechaty is a RPA SDK for Chatbot Makers.",
   "type": "module",
   "exports": {
@@ -109,7 +109,7 @@
   },
   "homepage": "https://github.com/wechaty/",
   "dependencies": {
-    "@juzi/wechaty-puppet-service": "1.0.118",
+    "@juzi/wechaty-puppet-service": "1.0.119",
     "clone-class": "^1.1.1",
     "cmd-ts": "^0.10.0",
     "cockatiel": "^2.0.2",
@@ -132,7 +132,7 @@
     "@chatie/eslint-config": "^1.0.4",
     "@chatie/semver": "^0.4.7",
     "@chatie/tsconfig": "^4.6.3",
-    "@juzi/wechaty-puppet": "^1.0.142",
+    "@juzi/wechaty-puppet": "^1.0.143",
     "@juzi/wechaty-puppet-mock": "^1.0.1",
     "@swc/core": "1.3.44",
     "@swc/helpers": "^0.3.6",

package/src/package-json.ts

@@ -4,10 +4,10 @@
  */
 import type { PackageJsonWechaty } from './config'
 
-export const GIT_COMMIT_HASH: string = 'e4d722bd21b4291abeec2865fb70f4b9b6406561'
+export const GIT_COMMIT_HASH: string = '6ef3d89f2a44f5454d45c56ff45765c9eeca8a79'
 export const packageJson: PackageJsonWechaty = {
   "name": "@juzi/wechaty",
-  "version": "1.0.150",
+  "version": "1.0.155",
   "description": "Wechaty is a RPA SDK for Chatbot Makers.",
   "type": "module",
   "exports": {
@@ -116,7 +116,7 @@ export const packageJson: PackageJsonWechaty = {
   },
   "homepage": "https://github.com/wechaty/",
   "dependencies": {
-    "@juzi/wechaty-puppet-service": "1.0.118",
+    "@juzi/wechaty-puppet-service": "1.0.119",
     "clone-class": "^1.1.1",
     "cmd-ts": "^0.10.0",
     "cockatiel": "^2.0.2",
@@ -139,7 +139,7 @@ export const packageJson: PackageJsonWechaty = {
     "@chatie/eslint-config": "^1.0.4",
     "@chatie/semver": "^0.4.7",
     "@chatie/tsconfig": "^4.6.3",
-    "@juzi/wechaty-puppet": "^1.0.142",
+    "@juzi/wechaty-puppet": "^1.0.143",
     "@juzi/wechaty-puppet-mock": "^1.0.1",
     "@swc/core": "1.3.44",
     "@swc/helpers": "^0.3.6",

package/src/user-modules/voice.spec.ts

@@ -0,0 +1,187 @@
+#!/usr/bin/env -S node --no-warnings --loader ts-node/esm
+/**
+ *   Wechaty Chatbot SDK - https://github.com/wechaty/wechaty
+ *
+ *   @copyright 2016 Huan LI (李卓桓) <https://github.com/huan>, and
+ *                   Wechaty Contributors <https://github.com/wechaty>.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ *
+ */
+import {
+  test,
+  sinon,
+}             from 'tstest'
+
+import { FileBox }        from 'file-box'
+import type * as PUPPET   from '@juzi/wechaty-puppet'
+import { PuppetMock }     from '@juzi/wechaty-puppet-mock'
+import { WechatyBuilder } from '../wechaty-builder.js'
+
+const MESSAGE_ID = 'message-id-voice'
+
+/**
+ * The fallback must trigger ONLY when the puppet does not implement the new
+ * RPC, never on transient failures: otherwise `text()` silently drops the
+ * `noSpeech` discriminator and makes the bot re-run its own paid ASR.
+ *
+ * The puppet is built & started once and reused across cases (`wechaty.Voice`
+ * is unavailable before `start()`). `messageVoice` / `messageVoiceText` are
+ * assigned directly (rather than via `sinon.stub(puppet, ...)`) because the
+ * installed wechaty-puppet-mock predates those methods, so stubbing a
+ * non-existent property would throw.
+ */
+const puppet  = new PuppetMock() as any
+const wechaty = WechatyBuilder.build({ puppet })
+
+let started = false
+async function ensureStarted () {
+  if (!started) {
+    await wechaty.start()
+    started = true
+  }
+}
+
+const voice = () => wechaty.Voice.create(MESSAGE_ID)
+
+const UNSUPPORTED = new Error('Wechaty Puppet Unsupported API Error.')
+
+test('Voice.file() returns the dedicated messageVoice result when supported', async t => {
+  await ensureStarted()
+  puppet.messageVoice = sinon.stub().resolves(FileBox.fromBuffer(Buffer.from('voice'), 'voice.silk'))
+  puppet.messageFile  = sinon.stub().resolves(FileBox.fromBuffer(Buffer.from('file'), 'file.bin'))
+
+  const fileBox = await voice().file()
+  t.equal(fileBox.name, 'voice.silk', 'should return the messageVoice FileBox')
+  t.ok(puppet.messageVoice.calledOnceWith(MESSAGE_ID), 'should call messageVoice')
+  t.notOk(puppet.messageFile.called, 'should NOT fall back to messageFile when supported')
+})
+
+test('Voice.file() falls back to messageFile on unsupported error', async t => {
+  await ensureStarted()
+  puppet.messageVoice = sinon.stub().rejects(UNSUPPORTED)
+  puppet.messageFile  = sinon.stub().resolves(FileBox.fromBuffer(Buffer.from('file'), 'file.bin'))
+
+  const fileBox = await voice().file()
+  t.equal(fileBox.name, 'file.bin', 'should fall back to messageFile')
+  t.ok(puppet.messageFile.calledOnceWith(MESSAGE_ID), 'should call messageFile on fallback')
+})
+
+test('Voice.file() falls back to messageFile when messageVoice is absent (old puppet)', async t => {
+  await ensureStarted()
+  puppet.messageVoice = undefined // old puppet built without the method at all
+  puppet.messageFile  = sinon.stub().resolves(FileBox.fromBuffer(Buffer.from('file'), 'file.bin'))
+
+  const fileBox = await voice().file()
+  t.equal(fileBox.name, 'file.bin', 'should fall back to messageFile via the typeof guard')
+  t.ok(puppet.messageFile.calledOnceWith(MESSAGE_ID), 'should call messageFile on fallback')
+})
+
+test('Voice.file() rethrows a transient error instead of falling back', async t => {
+  await ensureStarted()
+  puppet.messageVoice = sinon.stub().rejects(new Error('socket hang up'))
+  puppet.messageFile  = sinon.stub().resolves(FileBox.fromBuffer(Buffer.from('file'), 'file.bin'))
+
+  await t.rejects(() => voice().file(), /socket hang up/, 'should rethrow the transient error')
+  t.notOk(puppet.messageFile.called, 'should NOT fall back on a transient error')
+})
+
+test('Voice.file() rethrows a genuine "is not a function" TypeError from a working messageVoice', async t => {
+  await ensureStarted()
+  // method exists but its implementation throws internally — must NOT be
+  // misclassified as unsupported just because the message says "is not a function"
+  puppet.messageVoice = sinon.stub().rejects(new TypeError('innerHelper.process is not a function'))
+  puppet.messageFile  = sinon.stub().resolves(FileBox.fromBuffer(Buffer.from('file'), 'file.bin'))
+
+  await t.rejects(() => voice().file(), /is not a function/, 'should rethrow the internal TypeError')
+  t.notOk(puppet.messageFile.called, 'should NOT mask a real implementation bug')
+})
+
+test('Voice.text() returns the dedicated messageVoiceText payload when supported', async t => {
+  await ensureStarted()
+  puppet.messageVoiceText = sinon.stub().resolves({ text: 'hello', noSpeech: false })
+  puppet.messagePayload   = sinon.stub().resolves({ text: 'legacy' } as PUPPET.payloads.Message)
+
+  const result = await voice().text()
+  t.same(result, { text: 'hello', noSpeech: false }, 'should return the messageVoiceText payload')
+  t.ok(puppet.messageVoiceText.calledOnceWith(MESSAGE_ID), 'should call messageVoiceText')
+  t.notOk(puppet.messagePayload.called, 'should NOT fall back to messagePayload when supported')
+})
+
+test('Voice.text() preserves noSpeech=true from the puppet (skip paid ASR)', async t => {
+  await ensureStarted()
+  puppet.messageVoiceText = sinon.stub().resolves({ text: '', noSpeech: true })
+  puppet.messagePayload   = sinon.stub().resolves({ text: '' } as PUPPET.payloads.Message)
+
+  const result = await voice().text()
+  t.same(result, { text: '', noSpeech: true }, 'should return the puppet payload verbatim')
+  t.equal(result.noSpeech, true, 'should preserve noSpeech=true so the bot can skip its own ASR')
+  t.ok(puppet.messageVoiceText.calledOnceWith(MESSAGE_ID), 'should call messageVoiceText')
+  t.notOk(puppet.messagePayload.called, 'should NOT fall back when supported')
+})
+
+test('Voice.text() falls back to messagePayload().text on unsupported error', async t => {
+  await ensureStarted()
+  puppet.messageVoiceText = sinon.stub().rejects(UNSUPPORTED)
+  puppet.messagePayload   = sinon.stub().resolves({ text: 'legacy asr' } as PUPPET.payloads.Message)
+
+  const result = await voice().text()
+  t.same(result, { text: 'legacy asr', noSpeech: false }, 'should fall back to legacy payload.text with noSpeech=false')
+  t.ok(puppet.messagePayload.calledOnceWith(MESSAGE_ID), 'should call messagePayload on fallback')
+})
+
+test('Voice.text() falls back on gRPC UNIMPLEMENTED (code 12)', async t => {
+  await ensureStarted()
+  const unimplemented = Object.assign(new Error('12 UNIMPLEMENTED'), { code: 12 })
+  puppet.messageVoiceText = sinon.stub().rejects(unimplemented)
+  puppet.messagePayload   = sinon.stub().resolves({ text: 'legacy asr' } as PUPPET.payloads.Message)
+
+  const result = await voice().text()
+  t.same(result, { text: 'legacy asr', noSpeech: false }, 'should fall back when the server returns UNIMPLEMENTED')
+  t.ok(puppet.messagePayload.calledOnceWith(MESSAGE_ID), 'should call messagePayload on fallback')
+})
+
+test('Voice.text() falls back to messagePayload when messageVoiceText is absent (old puppet)', async t => {
+  await ensureStarted()
+  puppet.messageVoiceText = undefined // old puppet built without the method at all
+  puppet.messagePayload   = sinon.stub().resolves({ text: 'legacy asr' } as PUPPET.payloads.Message)
+
+  const result = await voice().text()
+  t.same(result, { text: 'legacy asr', noSpeech: false }, 'should fall back via the typeof guard with noSpeech=false')
+  t.ok(puppet.messagePayload.calledOnceWith(MESSAGE_ID), 'should call messagePayload on fallback')
+})
+
+test('Voice.text() rethrows a transient error instead of falling back', async t => {
+  await ensureStarted()
+  puppet.messageVoiceText = sinon.stub().rejects(new Error('ETIMEDOUT'))
+  puppet.messagePayload   = sinon.stub().resolves({ text: 'legacy asr' } as PUPPET.payloads.Message)
+
+  await t.rejects(() => voice().text(), /ETIMEDOUT/, 'should rethrow the transient error')
+  t.notOk(puppet.messagePayload.called, 'should NOT fall back on a transient error (would drop noSpeech)')
+})
+
+test('Voice.text() rethrows a genuine "is not a function" TypeError from a working messageVoiceText', async t => {
+  await ensureStarted()
+  // regression: a real internal TypeError must NOT be downgraded — that would
+  // drop noSpeech and make the bot re-run its own paid ASR
+  puppet.messageVoiceText = sinon.stub().rejects(new TypeError('innerHelper.process is not a function'))
+  puppet.messagePayload   = sinon.stub().resolves({ text: 'legacy asr' } as PUPPET.payloads.Message)
+
+  await t.rejects(() => voice().text(), /is not a function/, 'should rethrow the internal TypeError')
+  t.notOk(puppet.messagePayload.called, 'should NOT mask a real implementation bug')
+})
+
+test('teardown: stop the shared wechaty', async t => {
+  await wechaty.stop()
+  t.pass('stopped')
+})

package/src/user-modules/voice.ts

@@ -21,6 +21,7 @@ import type {
   FileBoxInterface,
 }                   from 'file-box'
 import type { Constructor } from 'clone-class'
+import type * as PUPPET from '@juzi/wechaty-puppet'
 import { validationMixin } from '../user-mixins/validation.js'
 import { log } from '../config.js'
 
@@ -28,6 +29,36 @@ import {
   wechatifyMixinBase,
 }                       from '../user-mixins/wechatify.js'
 
+/**
+ * gRPC status code for an RPC the server does not implement.
+ * @see https://grpc.github.io/grpc/core/md_doc_statuscodes.html
+ */
+const GRPC_STATUS_UNIMPLEMENTED = 12
+
+/**
+ * Whether `e` means the puppet / server does not implement the new voice RPC,
+ * i.e. it is safe to fall back to the legacy path.
+ *
+ * Transient errors (network / timeout / file expired / other gRPC codes) must
+ * NOT match here: otherwise the fallback silently masks real failures and — for
+ * `text()` — discards the `noSpeech` discriminator, making the bot re-run its
+ * own paid ASR on voices the puppet already confirmed as empty.
+ *
+ * Note: the "method does not exist at all" case (an old puppet built against a
+ * wechaty-puppet without the method) is detected up-front via a `typeof` guard
+ * at the call site, NOT here — matching the `'is not a function'` text would
+ * also swallow a genuine `TypeError` raised inside a working implementation.
+ */
+function isUnsupportedError (e: unknown): boolean {
+  const err = e as { code?: number | string; message?: string } | undefined
+  // old wechaty-puppet-service server without the new RPC → gRPC UNIMPLEMENTED
+  if (err?.code === GRPC_STATUS_UNIMPLEMENTED) {
+    return true
+  }
+  // puppet implements the abstract method via throwUnsupportedError()
+  return (err?.message || '').includes('Unsupported API')
+}
+
 class VoiceMixin extends wechatifyMixinBase() {
 
   static create (id: string): VoiceInterface {
@@ -48,17 +79,28 @@ class VoiceMixin extends wechatifyMixinBase() {
    * Get the voice file (FileBox) via the puppet's dedicated `messageVoice` RPC.
    *
    * Falls back to the generic `messageFile` when the puppet does not implement
-   * `messageVoice` (old puppet without the new RPC → rejection), keeping the
-   * behaviour compatible with the legacy "voice file via messageFile" path.
+   * `messageVoice` — either the method is absent (old puppet built without it,
+   * caught by the `typeof` guard) or it rejects with an unsupported-API error.
+   * Keeps the behaviour compatible with the legacy "voice file via messageFile"
+   * path. A genuine runtime error from a working `messageVoice` is rethrown.
    */
   async file (): Promise<FileBoxInterface> {
     log.verbose('Voice', 'file() for id: "%s"', this.id)
+    const puppet = this.wechaty.puppet
+    // puppet built against an old wechaty-puppet without the method at all
+    if (typeof (puppet as { messageVoice?: unknown }).messageVoice !== 'function') {
+      log.verbose('Voice', 'file() messageVoice() absent, fallback to messageFile()')
+      return puppet.messageFile(this.id)
+    }
     try {
-      const fileBox = await this.wechaty.puppet.messageVoice(this.id)
+      const fileBox = await puppet.messageVoice(this.id)
       return fileBox
     } catch (e) {
-      log.verbose('Voice', 'file() messageVoice() failed, fallback to messageFile(): %s', (e as Error).message)
-      const fileBox = await this.wechaty.puppet.messageFile(this.id)
+      if (!isUnsupportedError(e)) {
+        throw e
+      }
+      log.verbose('Voice', 'file() messageVoice() unsupported, fallback to messageFile(): %s', (e as Error).message)
+      const fileBox = await puppet.messageFile(this.id)
       return fileBox
     }
   }
@@ -69,18 +111,31 @@ class VoiceMixin extends wechatifyMixinBase() {
    * "confirmed no speech" (`noSpeech=true`) from "normal transcription".
    *
    * Falls back to reading the legacy `messagePayload().text` when the puppet
-   * does not implement `messageVoiceText` (old puppet without the new RPC →
-   * rejection). Old puppets put the ASR result into `payload.text`, so this
-   * keeps the behaviour compatible; `noSpeech` is `false` in the fallback.
+   * does not implement `messageVoiceText` — either the method is absent (old
+   * puppet built without it, caught by the `typeof` guard) or it rejects with
+   * an unsupported-API error. Old puppets put the ASR result into
+   * `payload.text`, so this keeps the behaviour compatible; `noSpeech` is
+   * `false` in the fallback. A genuine runtime error is rethrown (so the bot
+   * does not silently drop `noSpeech` and re-run its own paid ASR).
    */
-  async text (): Promise<{ text: string; noSpeech: boolean }> {
+  async text (): Promise<PUPPET.payloads.VoiceText> {
     log.verbose('Voice', 'text() for id: "%s"', this.id)
+    const puppet = this.wechaty.puppet
+    // puppet built against an old wechaty-puppet without the method at all
+    if (typeof (puppet as { messageVoiceText?: unknown }).messageVoiceText !== 'function') {
+      log.verbose('Voice', 'text() messageVoiceText() absent, fallback to messagePayload().text')
+      const payload = await puppet.messagePayload(this.id)
+      return { text: payload.text || '', noSpeech: false }
+    }
     try {
-      const payload = await this.wechaty.puppet.messageVoiceText(this.id)
+      const payload = await puppet.messageVoiceText(this.id)
       return payload
     } catch (e) {
-      log.verbose('Voice', 'text() messageVoiceText() failed, fallback to messagePayload().text: %s', (e as Error).message)
-      const payload = await this.wechaty.puppet.messagePayload(this.id)
+      if (!isUnsupportedError(e)) {
+        throw e
+      }
+      log.verbose('Voice', 'text() messageVoiceText() unsupported, fallback to messagePayload().text: %s', (e as Error).message)
+      const payload = await puppet.messagePayload(this.id)
       return { text: payload.text || '', noSpeech: false }
     }
   }