@juzi/wechaty 1.0.0

package/dist/esm/src/config.js

@@ -0,0 +1,100 @@
+/**
+ *   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.
+ *
+ */
+/// <reference path="./io-peer/json-rpc-peer.d.ts" />
+import { log, } from 'wechaty-puppet';
+import { FileBox } from 'file-box';
+import { OFFICIAL_PUPPET_DEFAULT, } from './puppet-config.js';
+import { packageJson, GIT_COMMIT_HASH, } from './package-json.js';
+const VERSION = packageJson.version || '0.0.0';
+/**
+ * to handle unhandled exceptions
+ */
+if (log.level() === 'verbose' || log.level() === 'silly') {
+    log.info('Config', 'registering process.on("unhandledRejection") for development/debug');
+    /**
+     * Refer to https://nodejs.org/api/process.html#process_event_unhandledrejection
+     * the reason is in type: Error | any
+     */
+    process.on('unhandledRejection', (reason, promise) => {
+        log.error('Config', '###########################');
+        log.error('Config', 'Wechaty unhandledRejection: %s %s', reason.stack || reason, promise);
+        log.error('Config', '###########################');
+        promise.catch(err => {
+            log.error('Config', 'process.on(unhandledRejection) promise.catch(%s)', err.message);
+            console.error('Config', err); // I don't know if log.error has similar full trace print support like console.error
+        });
+    });
+    process.on('uncaughtException', function (error) {
+        const origin = arguments[1]; // to compatible with node 12 or below version typings
+        log.error('Config', '###########################');
+        log.error('Config', 'Wechaty uncaughtException: %s %s', error.stack, origin);
+        log.error('Config', '###########################');
+    });
+}
+const DEFAULT_SETTING = packageJson['wechaty'];
+export class Config {
+    default = DEFAULT_SETTING;
+    apihost = process.env['WECHATY_APIHOST'] || DEFAULT_SETTING['DEFAULT_APIHOST'];
+    serviceIp = process.env['WECHATY_PUPPET_SERVICE_IP'] || '';
+    systemPuppetName() {
+        return (process.env['WECHATY_PUPPET'] || OFFICIAL_PUPPET_DEFAULT).toLowerCase();
+    }
+    name = process.env['WECHATY_NAME'];
+    // DO NOT set DEFAULT, because sometimes user do not want to connect to io cloud service
+    token = process.env['WECHATY_TOKEN'];
+    debug = !!(process.env['WECHATY_DEBUG']);
+    httpPort = process.env['PORT']
+        || process.env['WECHATY_PORT']
+        || DEFAULT_SETTING['DEFAULT_PORT'];
+    docker = !!(process.env['WECHATY_DOCKER']);
+    constructor() {
+        log.verbose('Config', 'constructor()');
+        this.validApiHost(this.apihost);
+    }
+    validApiHost(apihost) {
+        if (/^[a-zA-Z0-9.\-_]+:?[0-9]*$/.test(apihost)) {
+            return true;
+        }
+        throw new Error('validApiHost() fail for ' + apihost);
+    }
+}
+export const CHATIE_OFFICIAL_ACCOUNT_ID = 'gh_051c89260e5d';
+export function qrCodeForChatie() {
+    const CHATIE_OFFICIAL_ACCOUNT_QRCODE = 'http://weixin.qq.com/r/qymXj7DEO_1ErfTs93y5';
+    return FileBox.fromQRCode(CHATIE_OFFICIAL_ACCOUNT_QRCODE);
+}
+// http://jkorpela.fi/chars/spaces.html
+// String.fromCharCode(8197)
+export const FOUR_PER_EM_SPACE = String.fromCharCode(0x2005);
+// mobile: \u2005, PC、mac: \u0020
+export const AT_SEPARATOR_REGEX = /[\u2005\u0020]/;
+export function qrcodeValueToImageUrl(qrcodeValue) {
+    return [
+        'https://wechaty.js.org/qrcode/',
+        encodeURIComponent(qrcodeValue),
+    ].join('');
+}
+export function isProduction() {
+    return process.env['NODE_ENV'] === 'production'
+        || process.env['NODE_ENV'] === 'prod';
+}
+const config = new Config();
+export { log, config, GIT_COMMIT_HASH, VERSION, };
+//# sourceMappingURL=config.js.map

package/dist/esm/src/config.js.map

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

package/dist/esm/src/config.spec.d.ts

@@ -0,0 +1,22 @@
+#!/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.
+ *
+ */
+export {};
+//# sourceMappingURL=config.spec.d.ts.map

package/dist/esm/src/config.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.spec.d.ts","sourceRoot":"","sources":["../../../src/config.spec.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/esm/src/config.spec.js

@@ -0,0 +1,82 @@
+#!/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 } from 'tstest';
+import { config } from './config.js';
+// import { Puppet } from './puppet'
+test('important variables', async (t) => {
+    // t.ok('puppet'   in config, 'should exist `puppet` in Config')
+    t.ok('apihost' in config, 'should exist `apihost` in Config');
+    t.ok('token' in config, 'should exist `token` in Config');
+    // t.ok(config.default.DEFAULT_PUPPET      , 'should export DEFAULT_PUPPET')
+    // t.ok(config.default.DEFAULT_PROFILE     , 'should export DEFAULT_PROFILE')
+    t.ok(config.default.DEFAULT_PROTOCOL, 'should export DEFAULT_PROTOCOL');
+    t.ok(config.default.DEFAULT_APIHOST, 'should export DEFAULT_APIHOST');
+});
+test('validApiHost()', async (t) => {
+    const OK_APIHOSTS = [
+        'api.chatie.io',
+        'chatie.io:8080',
+    ];
+    const ERR_APIHOSTS = [
+        'https://api.chatie.io',
+        'chatie.io/',
+    ];
+    OK_APIHOSTS.forEach(apihost => {
+        t.doesNotThrow(() => {
+            config.validApiHost(apihost);
+        });
+    }, 'should not row for right apihost');
+    ERR_APIHOSTS.forEach(apihost => {
+        t.throws(() => {
+            config.validApiHost(apihost);
+        });
+    }, 'should throw for error apihost');
+});
+// test('puppetInstance()', async t => {
+//   // BUG Compitable with Win32 CI
+//   // global instance infected across unit tests... :(
+//   const bak = config.puppetInstance()
+//   config.puppetInstance(null)
+//   t.throws(() => {
+//     config.puppetInstance()
+//   }, Error, 'should throw when not initialized')
+//   config.puppetInstance(bak)
+//   const EXPECTED: Puppet = {userId: 'test'} as any
+//   const mockPuppet = EXPECTED
+//   config.puppetInstance(mockPuppet)
+//   const instance = config.puppetInstance()
+//   t.same(instance, EXPECTED, 'should equal with initialized data')
+//   config.puppetInstance(null)
+//   t.throws(() => {
+//     config.puppetInstance()
+//   }, Error, 'should throw after set to null')
+//   config.puppetInstance(bak)
+// })
+test('systemPuppetName ()', async (t) => {
+    const WECHATY_PUPPET_ORIG = process.env['WECHATY_PUPPET'];
+    delete process.env['WECHATY_PUPPET'];
+    t.equal(config.systemPuppetName(), 'wechaty-puppet-wechat4u', 'should get wechaty-puppet-wechat4u as default puppet name');
+    process.env['WECHATY_PUPPET'] = 'wechaty-puppet-mock';
+    t.equal(config.systemPuppetName(), 'wechaty-puppet-mock', 'should get puppet name from process.env');
+    // restore the original value
+    process.env['WECHATY_PUPPET'] = WECHATY_PUPPET_ORIG;
+});
+//# sourceMappingURL=config.spec.js.map

package/dist/esm/src/config.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.spec.js","sourceRoot":"","sources":["../../../src/config.spec.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAO,QAAQ,CAAA;AAE9B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,oCAAoC;AAEpC,IAAI,CAAC,qBAAqB,EAAE,KAAK,EAAC,CAAC,EAAC,EAAE;IACpC,gEAAgE;IAChE,CAAC,CAAC,EAAE,CAAC,SAAS,IAAK,MAAM,EAAE,kCAAkC,CAAC,CAAA;IAC9D,CAAC,CAAC,EAAE,CAAC,OAAO,IAAO,MAAM,EAAE,gCAAgC,CAAC,CAAA;IAE5D,4EAA4E;IAC5E,6EAA6E;IAC7E,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,gCAAgC,CAAC,CAAA;IACvE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,EAAG,+BAA+B,CAAC,CAAA;AACxE,CAAC,CAAC,CAAA;AAEF,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAC,CAAC,EAAC,EAAE;IAC/B,MAAM,WAAW,GAAG;QAClB,eAAe;QACf,gBAAgB;KACjB,CAAA;IACD,MAAM,YAAY,GAAG;QACnB,uBAAuB;QACvB,YAAY;KACb,CAAA;IACD,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QAC5B,CAAC,CAAC,YAAY,CAAC,GAAG,EAAE;YAClB,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;QAC9B,CAAC,CAAC,CAAA;IACJ,CAAC,EAAE,kCAAkC,CAAC,CAAA;IACtC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QAC7B,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE;YACZ,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;QAC9B,CAAC,CAAC,CAAA;IACJ,CAAC,EAAE,gCAAgC,CAAC,CAAA;AAEtC,CAAC,CAAC,CAAA;AAEF,wCAAwC;AACxC,oCAAoC;AACpC,wDAAwD;AACxD,wCAAwC;AAExC,gCAAgC;AAChC,qBAAqB;AACrB,8BAA8B;AAC9B,mDAAmD;AACnD,+BAA+B;AAE/B,qDAAqD;AACrD,gCAAgC;AAEhC,sCAAsC;AACtC,6CAA6C;AAC7C,qEAAqE;AAErE,gCAAgC;AAChC,qBAAqB;AACrB,8BAA8B;AAC9B,gDAAgD;AAEhD,+BAA+B;AAC/B,KAAK;AAEL,IAAI,CAAC,qBAAqB,EAAE,KAAK,EAAC,CAAC,EAAC,EAAE;IACpC,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAEzD,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IACpC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,yBAAyB,EAAE,2DAA2D,CAAC,CAAA;IAE1H,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,qBAAqB,CAAA;IACrD,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,qBAAqB,EAAE,yCAAyC,CAAC,CAAA;IAEpG,6BAA6B;IAC7B,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,mBAAmB,CAAA;AACrD,CAAC,CAAC,CAAA"}

package/dist/esm/src/doctor.d.ts

@@ -0,0 +1,9 @@
+export declare class Doctor {
+    constructor();
+    chromedriverVersion(): string;
+    /**
+     * https://gist.github.com/tedmiston/5935757
+     */
+    testTcp(): Promise<boolean>;
+}
+//# sourceMappingURL=doctor.d.ts.map

package/dist/esm/src/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/doctor.ts"],"names":[],"mappings":"AA6BA,qBAAa,MAAM;;IAMV,mBAAmB,IAAK,MAAM;IAWrC;;OAEG;IACI,OAAO,IAAK,OAAO,CAAC,OAAO,CAAC;CA0CpC"}

package/dist/esm/src/doctor.js

@@ -0,0 +1,78 @@
+/**
+ *   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 { createServer, Socket, } from 'net';
+import { spawnSync as spawn } from 'child_process';
+import { log, } from 'wechaty-puppet';
+export class Doctor {
+    constructor() {
+        log.verbose('Doctor', 'constructor()');
+    }
+    chromedriverVersion() {
+        let version;
+        try {
+            const cmd = spawn('chromedriver', ['--version']);
+            version = String(cmd.error) || cmd.stdout.toString() || cmd.stderr.toString();
+        }
+        catch (e) {
+            version = e.message;
+        }
+        return version;
+    }
+    /**
+     * https://gist.github.com/tedmiston/5935757
+     */
+    testTcp() {
+        log.verbose('Doctor', 'testTcp()');
+        return new Promise((resolve, reject) => {
+            /**
+             * Server
+             */
+            const server = createServer(socket => socket.pipe(socket));
+            /**
+             * Promise Reject
+             */
+            server.on('error', reject);
+            server.on('close', () => log.silly('Doctor', 'testTcp() server closed'));
+            server.listen(8788, 'localhost', () => {
+                /**
+                 * Client
+                 */
+                const client = new Socket();
+                client.connect(8788, 'localhost', () => {
+                    log.silly('Doctor', 'testTcp() client connected');
+                    client.write('ding');
+                });
+                client.on('data', () => {
+                    /**
+                     * Promise Resolve
+                     */
+                    resolve(true);
+                    client.destroy(); // kill client after server's response
+                });
+                /**
+                 * Promise Reject
+                 */
+                client.on('error', reject);
+                client.on('close', () => server.close());
+            });
+        });
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/esm/src/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EACL,YAAY,EACZ,MAAM,GACP,MAAwB,KAAK,CAAA;AAC9B,OAAO,EAAE,SAAS,IAAI,KAAK,EAAE,MAAM,eAAe,CAAA;AAElD,OAAO,EACL,GAAG,GACJ,MAAwB,gBAAgB,CAAA;AAEzC,MAAM,OAAO,MAAM;IAEjB;QACE,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAA;IACxC,CAAC;IAEM,mBAAmB;QACxB,IAAI,OAAe,CAAA;QACnB,IAAI;YACF,MAAM,GAAG,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC,WAAW,CAAC,CAAC,CAAA;YAChD,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAA;SAC9E;QAAC,OAAO,CAAC,EAAE;YACV,OAAO,GAAI,CAAW,CAAC,OAAO,CAAA;SAC/B;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;OAEG;IACI,OAAO;QACZ,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;QAElC,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C;;eAEG;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;YAC1D;;eAEG;YACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YAC1B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAA;YAExE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;gBACpC;;mBAEG;gBACH,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAA;gBAC3B,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;oBACrC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,4BAA4B,CAAC,CAAA;oBACjD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;gBACtB,CAAC,CAAC,CAAA;gBAEF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;oBACrB;;uBAEG;oBACH,OAAO,CAAC,IAAI,CAAC,CAAA;oBAEb,MAAM,CAAC,OAAO,EAAE,CAAA,CAAC,sCAAsC;gBACzD,CAAC,CAAC,CAAA;gBACF;;mBAEG;gBACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;gBAE1B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA;YAC1C,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;CAEF"}

package/dist/esm/src/helper-functions/open-graph.d.ts

@@ -0,0 +1,22 @@
+/**
+ *   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 og from 'open-graph';
+export declare function openGraph(url: string): Promise<og.Data>;
+//# sourceMappingURL=open-graph.d.ts.map

package/dist/esm/src/helper-functions/open-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-graph.d.ts","sourceRoot":"","sources":["../../../../src/helper-functions/open-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,wBAAsB,SAAS,CAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,CAY9D"}

package/dist/esm/src/helper-functions/open-graph.js

@@ -0,0 +1,36 @@
+/**
+ *   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 og from 'open-graph';
+export async function openGraph(url) {
+    return new Promise((resolve, reject) => {
+        og(url, (err, meta) => {
+            if (err) {
+                reject(err);
+            }
+            else if (!meta) {
+                reject(new Error('meta is undefined'));
+            }
+            else {
+                resolve(meta);
+            }
+        });
+    });
+}
+//# sourceMappingURL=open-graph.js.map

package/dist/esm/src/helper-functions/open-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-graph.js","sourceRoot":"","sources":["../../../../src/helper-functions/open-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,MAAM,CAAC,KAAK,UAAU,SAAS,CAAE,GAAW;IAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YACpB,IAAI,GAAG,EAAE;gBACP,MAAM,CAAC,GAAG,CAAC,CAAA;aACZ;iBAAM,IAAI,CAAC,IAAI,EAAE;gBAChB,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAA;aACvC;iBAAM;gBACL,OAAO,CAAC,IAAI,CAAC,CAAA;aACd;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/esm/src/helper-functions/stringify-filter.d.ts

@@ -0,0 +1,3 @@
+declare function stringifyFilter(_key: string, value: any): any;
+export { stringifyFilter, };
+//# sourceMappingURL=stringify-filter.d.ts.map

package/dist/esm/src/helper-functions/stringify-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringify-filter.d.ts","sourceRoot":"","sources":["../../../../src/helper-functions/stringify-filter.ts"],"names":[],"mappings":"AAEA,iBAAS,eAAe,CAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAMjD;AAED,OAAO,EACL,eAAe,GAChB,CAAA"}

package/dist/esm/src/helper-functions/stringify-filter.js

@@ -0,0 +1,9 @@
+// https://stackoverflow.com/a/38251445/1123955
+function stringifyFilter(_key, value) {
+    if (value instanceof RegExp) {
+        return value.toString();
+    }
+    return value;
+}
+export { stringifyFilter, };
+//# sourceMappingURL=stringify-filter.js.map

package/dist/esm/src/helper-functions/stringify-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringify-filter.js","sourceRoot":"","sources":["../../../../src/helper-functions/stringify-filter.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAE/C,SAAS,eAAe,CAAE,IAAY,EAAE,KAAU;IAChD,IAAI,KAAK,YAAY,MAAM,EAAE;QAC3B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAA;KACxB;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,OAAO,EACL,eAAe,GAChB,CAAA"}

package/dist/esm/src/io-client.d.ts

@@ -0,0 +1,28 @@
+import type { WechatyInterface } from './wechaty/mod.js';
+export interface IoClientOptions {
+    token: string;
+    wechaty: WechatyInterface;
+    port?: number;
+}
+export declare class IoClient {
+    /**
+     * Huan(20161026): keep io `null-able` or not?
+     * Huan(202002): make it optional.
+     */
+    private io?;
+    private puppetServer?;
+    private state;
+    protected options: Required<IoClientOptions>;
+    constructor(options: IoClientOptions);
+    private startPuppetServer;
+    private stopPuppetServer;
+    start(): Promise<void>;
+    private hookWechaty;
+    private startIo;
+    private stopIo;
+    private onMessage;
+    stop(): Promise<void>;
+    restart(): Promise<void>;
+    quit(): Promise<void>;
+}
+//# sourceMappingURL=io-client.d.ts.map

package/dist/esm/src/io-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io-client.d.ts","sourceRoot":"","sources":["../../../src/io-client.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAO,kBAAkB,CAAA;AAOzD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAK,MAAM,CAAC;IACjB,OAAO,EAAG,gBAAgB,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAMD,qBAAa,QAAQ;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,CAAI;IACf,OAAO,CAAC,YAAY,CAAC,CAAc;IAEnC,OAAO,CAAC,KAAK,CAAa;IAE1B,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAA;gBAG1C,OAAO,EAAE,eAAe;YAoBZ,iBAAiB;YAqBjB,gBAAgB;IAYjB,KAAK,IAAK,OAAO,CAAC,IAAI,CAAC;YA6BtB,WAAW;YAqBX,OAAO;YA2BP,MAAM;YAYN,SAAS;IAoBV,IAAI,IAAK,OAAO,CAAC,IAAI,CAAC;IAetB,OAAO,IAAK,OAAO,CAAC,IAAI,CAAC;IAYzB,IAAI,IAAK,OAAO,CAAC,IAAI,CAAC;CA6BpC"}

package/dist/esm/src/io-client.js

@@ -0,0 +1,213 @@
+/**
+ *   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 { StateSwitch } from 'state-switch';
+import { PuppetServer, } from 'wechaty-puppet-service';
+import { log, } from './config.js';
+import { Io } from './io.js';
+const DEFAULT_IO_CLIENT_OPTIONS = {
+    port: 8788,
+};
+export class IoClient {
+    /**
+     * Huan(20161026): keep io `null-able` or not?
+     * Huan(202002): make it optional.
+     */
+    io;
+    puppetServer;
+    state;
+    options;
+    constructor(options) {
+        log.verbose('IoClient', 'constructor({%s})', Object.keys(options)
+            .map(key => {
+            return `${key}:${options[key]}`;
+        })
+            .reduce((acc, cur) => `${acc}, ${cur}`));
+        const normalizedOptions = {
+            ...DEFAULT_IO_CLIENT_OPTIONS,
+            ...options,
+        };
+        this.options = normalizedOptions;
+        this.state = new StateSwitch('IoClient', { log });
+    }
+    async startPuppetServer() {
+        log.verbose('IoClient', 'startPuppetServer()');
+        if (this.puppetServer) {
+            throw new Error('puppet server exists');
+        }
+        const options = {
+            endpoint: '0.0.0.0:' + this.options.port,
+            /**
+             * Huan(202110): FIXME: remove the any
+             *  by updating the puppet-service server code
+             *  to use PuppetInterface
+             */
+            puppet: this.options.wechaty.puppet,
+            token: this.options.token,
+        };
+        this.puppetServer = new PuppetServer(options);
+        await this.puppetServer.start();
+    }
+    async stopPuppetServer() {
+        log.verbose('IoClient', 'stopPuppetServer()');
+        if (!this.puppetServer) {
+            log.error('IoClient', 'stopPuppetServer() this.puppetServer is `undefined`');
+            return;
+        }
+        await this.puppetServer.stop();
+        this.puppetServer = undefined;
+    }
+    async start() {
+        log.verbose('IoClient', 'start()');
+        if (this.state.active()) {
+            log.warn('IoClient', 'start() with a on state, wait and return');
+            await this.state.stable('active');
+            return;
+        }
+        this.state.active('pending');
+        try {
+            await this.hookWechaty(this.options.wechaty);
+            await this.startIo();
+            await this.options.wechaty.start();
+            await this.startPuppetServer();
+            this.state.active(true);
+        }
+        catch (e) {
+            log.error('IoClient', 'start() exception: %s', e.message);
+            this.state.inactive(true);
+            throw e;
+        }
+    }
+    async hookWechaty(wechaty) {
+        log.verbose('IoClient', 'hookWechaty()');
+        if (this.state.inactive()) {
+            const e = new Error('state.off() is true, skipped');
+            log.warn('IoClient', 'initWechaty() %s', e.message);
+            throw e;
+        }
+        wechaty
+            .on('login', user => log.info('IoClient', `${user.name()} logged in`))
+            .on('logout', user => log.info('IoClient', `${user.name()} logged out`))
+            .on('message', msg => this.onMessage(msg))
+            .on('scan', (url, code) => {
+            log.info('IoClient', [
+                `[${code}] ${url}`,
+                `Online QR Code Image: https://wechaty.js.org/qrcode/${encodeURIComponent(url)}`,
+            ].join('\n'));
+        });
+    }
+    async startIo() {
+        log.verbose('IoClient', 'startIo() with token %s', this.options.token);
+        if (this.state.inactive()) {
+            const e = new Error('startIo() state.off() is true, skipped');
+            log.warn('IoClient', e.message);
+            throw e;
+        }
+        if (this.io) {
+            throw new Error('io exists');
+        }
+        this.io = new Io({
+            servicePort: this.options.port,
+            token: this.options.token,
+            wechaty: this.options.wechaty,
+        });
+        try {
+            await this.io.start();
+        }
+        catch (e) {
+            log.verbose('IoClient', 'startIo() init fail: %s', e.message);
+            throw e;
+        }
+    }
+    async stopIo() {
+        log.verbose('IoClient', 'stopIo()');
+        if (!this.io) {
+            log.warn('IoClient', 'stopIo() io does not exist');
+            return;
+        }
+        await this.io.stop();
+        this.io = undefined;
+    }
+    async onMessage(msg) {
+        log.verbose('IoClient', 'onMessage(%s)', msg);
+        // const from = m.from()
+        // const to = m.to()
+        // const content = m.toString()
+        // const room = m.room()
+        // log.info('Bot', '%s<%s>:%s'
+        //               , (room ? '['+room.topic()+']' : '')
+        //               , from.name()
+        //               , m.toStringDigest()
+        //         )
+        // if (/^wechaty|chatie|botie/i.test(m.text()) && !m.self()) {
+        //   await m.say('https://www.chatie.io')
+        //     .then(_ => log.info('Bot', 'REPLIED to magic word "chatie"'))
+        // }
+    }
+    async stop() {
+        log.verbose('IoClient', 'stop()');
+        this.state.inactive('pending');
+        await this.stopIo();
+        await this.stopPuppetServer();
+        await this.options.wechaty.stop();
+        this.state.inactive(true);
+        // XXX 20161026
+        // this.io = null
+    }
+    async restart() {
+        log.verbose('IoClient', 'restart()');
+        try {
+            await this.stop();
+            await this.start();
+        }
+        catch (e) {
+            log.error('IoClient', 'restart() exception %s', e.message);
+            throw e;
+        }
+    }
+    async quit() {
+        log.verbose('IoClient', 'quit()');
+        if (this.state.inactive() === 'pending') {
+            log.warn('IoClient', 'quit() with state.off() = `pending`, skipped');
+            throw new Error('quit() with state.off() = `pending`');
+        }
+        this.state.inactive('pending');
+        try {
+            // if (this.options.wechaty) {
+            await this.options.wechaty.stop();
+            // this.wechaty = null
+            // } else { log.warn('IoClient', 'quit() no this.wechaty') }
+            if (this.io) {
+                await this.io.stop();
+                // this.io = null
+            }
+            else {
+                log.warn('IoClient', 'quit() no this.io');
+            }
+        }
+        catch (e) {
+            log.error('IoClient', 'exception: %s', e.message);
+            throw e;
+        }
+        finally {
+            this.state.inactive(true);
+        }
+    }
+}
+//# sourceMappingURL=io-client.js.map