node-easywechat 3.2.0 → 3.3.1

package/dist/OpenWork/JsApiTicket.js

@@ -0,0 +1,152 @@
+'use strict';
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const HttpClient_1 = __importDefault(require("../Core/HttpClient/HttpClient"));
+const Utils_1 = require("../Core/Support/Utils");
+class JsApiTicket {
+    constructor(corpId, key = null, cache = null, httpClient = null) {
+        this.corpId = corpId;
+        this.key = key;
+        this.cache = cache;
+        this.httpClient = httpClient;
+        if (!this.httpClient) {
+            this.httpClient = HttpClient_1.default.create({
+                baseURL: 'https://qyapi.weixin.qq.com/',
+            });
+        }
+    }
+    /**
+     * 获取签名配置
+     * @param url 完整URL地址
+     * @param nonce 随机字符串，默认：随机10位
+     * @param timestamp 时间长，默认：当前时间
+     * @returns
+     */
+    createConfigSignature(url, nonce = null, timestamp = null, jsApiList = [], debug = false, beta = true) {
+        return __awaiter(this, void 0, void 0, function* () {
+            nonce = nonce || (0, Utils_1.randomString)(10);
+            timestamp = timestamp || (0, Utils_1.getTimestamp)();
+            let ticket = yield this.getTicket();
+            return {
+                appId: this.corpId,
+                nonceStr: nonce,
+                timestamp,
+                url,
+                signature: this.getTicketSignature(ticket, nonce, timestamp, url),
+                jsApiList,
+                debug,
+                beta,
+            };
+        });
+    }
+    getTicketSignature(ticket, nonce, timestamp, url) {
+        return (0, Utils_1.createHash)(`jsapi_ticket=${ticket}&noncestr=${nonce}&timestamp=${timestamp}&url=${url}`, 'sha1');
+    }
+    /**
+     * 获取jsapi_ticket的缓存名称
+     * @returns
+     */
+    getKey() {
+        if (!this.key) {
+            this.key = `open_work.jsapi_ticket.${this.corpId}`;
+        }
+        return this.key;
+    }
+    /**
+     * 获取签名凭证jsapi_ticket
+     * @returns
+     */
+    getTicket() {
+        return __awaiter(this, void 0, void 0, function* () {
+            let key = this.getKey();
+            let ticket = '';
+            if (this.cache) {
+                ticket = yield this.cache.get(key);
+            }
+            if (!!ticket && typeof ticket === 'string') {
+                return ticket;
+            }
+            let response = (yield this.httpClient.request('get', '/cgi-bin/get_jsapi_ticket', {})).toObject();
+            if (!response['ticket']) {
+                throw new Error('Failed to get jssdk_ticket: ' + JSON.stringify(response));
+            }
+            if (this.cache) {
+                yield this.cache.set(key, response['ticket'], parseInt(response['expires_in']));
+            }
+            return response['ticket'];
+        });
+    }
+    /**
+     * 获取代理应用的签名配置
+     * @param agentId 代理应用的id
+     * @param url 完整URL地址
+     * @param nonce 随机字符串，默认：随机10位
+     * @param timestamp 时间长，默认：当前时间
+     * @returns
+     */
+    createAgentConfigSignature(agentId, url, nonce = null, timestamp = null, jsApiList = []) {
+        return __awaiter(this, void 0, void 0, function* () {
+            nonce = nonce || (0, Utils_1.randomString)(10);
+            timestamp = timestamp || (0, Utils_1.getTimestamp)();
+            let ticket = yield this.getTicket();
+            return {
+                corpid: this.corpId,
+                agentid: agentId,
+                url,
+                nonceStr: nonce,
+                timestamp,
+                signature: this.getTicketSignature(ticket, nonce, timestamp, url),
+                jsApiList,
+            };
+        });
+    }
+    /**
+     * 获取代理应用的签名凭证jsapi_ticket
+     * @param agentId 代理应用的id
+     * @returns
+     */
+    getAgentTicket(agentId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let key = this.getAgentKey(agentId);
+            let ticket = '';
+            if (this.cache) {
+                ticket = yield this.cache.get(key);
+            }
+            if (!!ticket && typeof ticket === 'string') {
+                return ticket;
+            }
+            let response = (yield this.httpClient.request('get', '/cgi-bin/ticket/get', {
+                params: {
+                    type: 'agent_config',
+                }
+            })).toObject();
+            if (!response['ticket']) {
+                throw new Error('Failed to get jssdk agentTicket: ' + JSON.stringify(response));
+            }
+            if (this.cache) {
+                yield this.cache.set(key, response['ticket'], parseInt(response['expires_in']));
+            }
+            return response['ticket'];
+        });
+    }
+    /**
+     * 获取代理应用的jsapi_ticket的缓存名称
+     * @param agentId 代理应用的id
+     * @returns
+     */
+    getAgentKey(agentId) {
+        return `${this.getKey()}.${agentId}`;
+    }
+}
+;
+module.exports = JsApiTicket;

package/dist/OpenWork/Message.d.ts

@@ -0,0 +1,78 @@
+import BaseMessage from '../Core/Message';
+declare class Message extends BaseMessage {
+}
+interface Message extends Record<string, any> {
+    /**
+     * 消息密文，兼容模式、安全模式才有
+     */
+    Encrypt?: string;
+    /**
+     * 开发者微信号
+     */
+    ToUserName?: string;
+    /**
+     * 发送方帐号 OpenId
+     */
+    FromUserName?: string;
+    /**
+     * 消息创建时间
+     */
+    CreateTime?: number;
+    /**
+     * 信息类型
+     * - `suite_ticket` [推送suite_ticket](https://developer.work.weixin.qq.com/document/path/90628)
+     * - `create_auth` [授权成功](https://developer.work.weixin.qq.com/document/path/90642#授权成功通知)
+     * - `change_auth` [变更授权](https://developer.work.weixin.qq.com/document/path/90642#变更授权通知)
+     * - `cancel_auth` [取消授权](https://developer.work.weixin.qq.com/document/path/90642#取消授权通知)
+     * - `change_contact` [成员通知事件](https://developer.work.weixin.qq.com/document/path/90639)、[部门通知事件](https://developer.work.weixin.qq.com/document/path/90640)、[标签通知事件](https://developer.work.weixin.qq.com/document/path/90641)
+     * - `share_agent_change` [共享应用事件回调](https://developer.work.weixin.qq.com/document/path/93373)
+     * - `reset_permanent_code` [重置永久授权码通知](https://developer.work.weixin.qq.com/document/path/94758)
+     * - `corp_arch_auth` [授权组织架构权限通知](https://developer.work.weixin.qq.com/document/path/97378)
+     */
+    InfoType?: string;
+    /**
+     * 消息类型
+     * - `event` 事件
+     */
+    MsgType?: string;
+    /**
+     * 事件类型
+     * - `change_app_admin` [应用管理员变更](https://developer.work.weixin.qq.com/document/path/95038)
+     * @scope MsgType='event'
+     */
+    Event?: string;
+    /**
+     * 第三方应用的SuiteId或者代开发应用模板id
+     */
+    SuiteId?: string;
+    /**
+     * 变更类型
+     *
+     * [成员通知事件](https://developer.work.weixin.qq.com/document/path/90639)：
+     * - `create_user` 新增成员
+     * - `update_user` 更新成员
+     * - `delete_user` 删除成员
+     *
+     * [部门通知事件](https://developer.work.weixin.qq.com/document/path/90640)：
+     * - `create_party` 新增部门
+     * - `update_party` 更新部门
+     * - `delete_party` 删除部门
+     *
+     * [标签通知事件](https://developer.work.weixin.qq.com/document/path/90641)：
+     * - `update_tag` 标签变更
+     *
+     * @scope InfoType='change_contact'
+     */
+    ChangeType?: string;
+    /**
+     * 授权企业的CorpID
+     * @scope InfoType='change_contact' | 'corp_arch_auth'
+     */
+    AuthCorpId?: string;
+    /**
+     * 企业应用的id
+     * @scope MsgType='text' | 'image' | 'voice' | 'video' | 'location' | 'link'
+     */
+    AgentID?: string;
+}
+export = Message;

package/dist/OpenWork/Message.js

@@ -0,0 +1,9 @@
+'use strict';
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const Message_1 = __importDefault(require("../Core/Message"));
+class Message extends Message_1.default {
+}
+;
+module.exports = Message;

package/dist/OpenWork/ProviderAccessToken.d.ts

@@ -0,0 +1,26 @@
+import CacheInterface from "../Core/Contracts/CacheInterface";
+import HttpClientInterface from "../Core/HttpClient/Contracts/HttpClientInterface";
+import RefreshableAccessTokenInterface from "../Core/Contracts/RefreshableAccessTokenInterface";
+declare class ProviderAccessToken implements RefreshableAccessTokenInterface {
+    protected corpId: string;
+    protected providerSecret: string;
+    protected key: string;
+    protected cache: CacheInterface;
+    protected httpClient: HttpClientInterface;
+    constructor(corpId: string, providerSecret: string, key?: string, cache?: CacheInterface, httpClient?: HttpClientInterface);
+    /**
+     * 获取access_token的缓存名称
+     * @returns
+     */
+    getKey(): string;
+    /**
+     * 设置access_token的缓存名称
+     * @param key
+     * @returns
+     */
+    setKey(key: string): this;
+    getToken(): Promise<string>;
+    toQuery(): Promise<Record<string, any>>;
+    refresh(): Promise<string>;
+}
+export = ProviderAccessToken;

package/dist/OpenWork/ProviderAccessToken.js

@@ -0,0 +1,84 @@
+'use strict';
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const HttpClient_1 = __importDefault(require("../Core/HttpClient/HttpClient"));
+class ProviderAccessToken {
+    constructor(corpId, providerSecret, key = null, cache = null, httpClient = null) {
+        this.corpId = corpId;
+        this.providerSecret = providerSecret;
+        this.key = key;
+        this.cache = cache;
+        this.httpClient = httpClient;
+        if (!this.httpClient) {
+            this.httpClient = HttpClient_1.default.create({
+                baseURL: 'https://qyapi.weixin.qq.com/',
+            });
+        }
+    }
+    /**
+     * 获取access_token的缓存名称
+     * @returns
+     */
+    getKey() {
+        if (!this.key) {
+            this.key = `open_work.access_token.${this.corpId}`;
+        }
+        return this.key;
+    }
+    /**
+     * 设置access_token的缓存名称
+     * @param key
+     * @returns
+     */
+    setKey(key) {
+        this.key = key;
+        return this;
+    }
+    getToken() {
+        return __awaiter(this, void 0, void 0, function* () {
+            let token = '';
+            if (this.cache) {
+                token = yield this.cache.get(this.getKey());
+            }
+            if (!!token && typeof token === 'string') {
+                return token;
+            }
+            return this.refresh();
+        });
+    }
+    toQuery() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return {
+                provider_access_token: yield this.getToken(),
+            };
+        });
+    }
+    refresh() {
+        return __awaiter(this, void 0, void 0, function* () {
+            let response = (yield this.httpClient.request('post', 'cgi-bin/service/get_provider_token', {
+                json: {
+                    corpid: this.corpId,
+                    provider_secret: this.providerSecret,
+                }
+            })).toObject();
+            if (!response['provider_access_token']) {
+                throw new Error('Failed to get provider_access_token: ' + JSON.stringify(response));
+            }
+            if (this.cache) {
+                yield this.cache.set(this.getKey(), response['provider_access_token'], parseInt(response['expires_in']) - 100);
+            }
+            return response['provider_access_token'];
+        });
+    }
+}
+module.exports = ProviderAccessToken;

package/dist/OpenWork/Server.d.ts

@@ -0,0 +1,103 @@
+import ServerRequestInterface from '../Core/Http/Contracts/ServerRequestInterface';
+import Encryptor from '../Core/Encryptor';
+import ServerInterface from '../Core/Contracts/ServerInterface';
+import Response from '../Core/Http/Response';
+import Message from './Message';
+import { ServerHandlerClosure } from '../Types/global';
+declare class Server extends ServerInterface {
+    protected encryptor: Encryptor;
+    protected providerEncryptor: Encryptor;
+    protected request: ServerRequestInterface;
+    protected defaultSuiteTicketHandler: ServerHandlerClosure;
+    constructor(encryptor: Encryptor, providerEncryptor: Encryptor, request?: ServerRequestInterface);
+    /**
+     * 服务端消息处理
+     * @returns
+     */
+    serve(): Promise<Response>;
+    withDefaultSuiteTicketHandler(handler: ServerHandlerClosure): this;
+    /**
+     * 设置联系人变化的消息处理器
+     * @param handler
+     */
+    handleSuiteTicketRefreshed(handler: ServerHandlerClosure): this;
+    /**
+     * 设置授权成功的消息处理器
+     * @param handler
+     */
+    handleAuthCreated(handler: ServerHandlerClosure): this;
+    /**
+     * 设置变更授权的消息处理器
+     * @param handler
+     */
+    handleAuthUpdated(handler: ServerHandlerClosure): this;
+    /**
+     * 设置取消授权的消息处理器
+     * @param handler
+     */
+    handleAuthCancelled(handler: ServerHandlerClosure): this;
+    /**
+     * 设置用户创建的消息处理器
+     * @param handler
+     */
+    handleUserCreated(handler: ServerHandlerClosure): this;
+    /**
+     * 设置用户更新的消息处理器
+     * @param handler
+     */
+    handleUserUpdated(handler: ServerHandlerClosure): this;
+    /**
+     * 设置用户删除的消息处理器
+     * @param handler
+     */
+    handleUserDeleted(handler: ServerHandlerClosure): this;
+    /**
+     * 设置部门创建的消息处理器
+     * @param handler
+     */
+    handlePartyCreated(handler: ServerHandlerClosure): this;
+    /**
+     * 设置部门更新的消息处理器
+     * @param handler
+     */
+    handlePartyUpdated(handler: ServerHandlerClosure): this;
+    /**
+     * 设置部门删除的消息处理器
+     * @param handler
+     */
+    handlePartyDeleted(handler: ServerHandlerClosure): this;
+    /**
+     * 设置用户标签变化的消息处理器
+     * @param handler
+     */
+    handleUserTagUpdated(handler: ServerHandlerClosure): this;
+    /**
+     * 设置共享应用事件的消息处理器
+     * @param handler
+     */
+    handleShareAgentChanged(handler: ServerHandlerClosure): this;
+    /**
+     * 设置重置永久授权码的消息处理器
+     * @param handler
+     */
+    handleResetPermanentCode(handler: ServerHandlerClosure): this;
+    /**
+     * 设置应用管理员变更的消息处理器
+     * @param handler
+     */
+    handleChangeAppAdmin(handler: ServerHandlerClosure): this;
+    /**
+     * 获取来自微信服务器的推送消息
+     * @param request 未设置该参数时，则从当前服务端收到的请求中获取
+     * @returns
+     */
+    getRequestMessage(request?: ServerRequestInterface): Promise<Message>;
+    protected decryptRequestMessage(query: Record<string, any>): ServerHandlerClosure;
+    /**
+     * 获取解密后的消息
+     * @param request 未设置该参数时，则从当前服务端收到的请求中获取
+     * @returns
+     */
+    getDecryptedMessage(request?: ServerRequestInterface): Promise<import("../Core/Message")>;
+}
+export = Server;