node-easywechat 2.10.2 → 3.0.0-beta.1

package/dist/Core/Config.js

@@ -0,0 +1,117 @@
+'use strict';
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const merge_1 = __importDefault(require("merge"));
+const Obj_1 = __importDefault(require("./Support/Obj"));
+class Config {
+    constructor(items = {}) {
+        this.items = items;
+        this.requiredKeys = [];
+        this.items = merge_1.default.recursive(true, items);
+        this.checkMissingKeys();
+    }
+    /**
+     * 检查是否有配置项缺失
+     * @returns
+     */
+    checkMissingKeys() {
+        if (!this.requiredKeys || this.requiredKeys.length == 0) {
+            return true;
+        }
+        let missingKeys = this.requiredKeys.filter(key => {
+            return !this.has(key);
+        });
+        if (missingKeys.length > 0) {
+            throw new Error(`${missingKeys.join(',')} cannot be empty.`);
+        }
+        return true;
+    }
+    /**
+     * 获取所有配置项
+     * @returns
+     */
+    all() {
+        return merge_1.default.recursive(true, this.items);
+    }
+    /**
+     * 判断配置项是否存在
+     * @param key
+     * @returns
+     */
+    has(key) {
+        return Obj_1.default.has(this.items, key);
+    }
+    /**
+     * 设置配置项
+     * @param key
+     * @param value
+     */
+    set(key, value) {
+        Obj_1.default.set(this.items, key, value);
+    }
+    /**
+     * 获取配置项
+     * @param key
+     * @param defaultValue
+     * @returns
+     */
+    get(key, defaultValue = null) {
+        if (typeof key === 'string') {
+            return Obj_1.default.get(this.items, key, defaultValue);
+        }
+        return this.getMany(key);
+    }
+    /**
+     * 获取多个配置项
+     * @param keys 键名列表 或者 {键名:默认值} 格式的对象
+     * @returns
+     */
+    getMany(keys) {
+        let config = {};
+        if (!keys || typeof keys.map === undefined)
+            return config;
+        keys.map((key, val) => {
+            if (typeof key === 'number') {
+                config[key] = Obj_1.default.get(this.items, val, null);
+            }
+            else {
+                config[key] = Obj_1.default.get(this.items, key, val);
+            }
+        });
+        return config;
+    }
+    /**
+     * 判断配置项是否存在
+     * @param key
+     * @returns
+     */
+    offsetExists(key) {
+        return this.has('' + key);
+    }
+    /**
+     * 获取配置项
+     * @param key
+     * @returns
+     */
+    offsetGet(key) {
+        return this.get('' + key);
+    }
+    /**
+     * 设置配置项
+     * @param key
+     * @param value
+     */
+    offsetSet(key, value) {
+        this.set('' + key, value);
+    }
+    /**
+     * 删除配置项
+     * @param key
+     */
+    offsetUnset(key) {
+        this.set('' + key, undefined);
+    }
+}
+;
+module.exports = Config;

package/dist/Core/Contracts/AccessTokenInterface.d.ts

@@ -0,0 +1,13 @@
+declare abstract class AccessTokenInterface {
+    /**
+     * 获取token
+     * @returns
+     */
+    getToken(): Promise<string>;
+    /**
+     * 转成url参数
+     * @returns
+     */
+    toQuery(): Promise<Record<string, any>>;
+}
+export = AccessTokenInterface;

package/dist/Core/Contracts/AccessTokenInterface.js

@@ -0,0 +1,28 @@
+'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());
+    });
+};
+class AccessTokenInterface {
+    /**
+     * 获取token
+     * @returns
+     */
+    getToken() {
+        return __awaiter(this, void 0, void 0, function* () { return null; });
+    }
+    /**
+     * 转成url参数
+     * @returns
+     */
+    toQuery() {
+        return __awaiter(this, void 0, void 0, function* () { return null; });
+    }
+}
+;
+module.exports = AccessTokenInterface;

package/dist/Core/Contracts/CacheInterface.d.ts

@@ -1,6 +1,29 @@
-export default abstract class CacheInterface {
-    get(id: string): Promise<any>;
-    has(id: string): Promise<boolean>;
-    set(id: string, data?: any, lifeTime?: number): Promise<boolean>;
-    delete(id: string): Promise<boolean>;
+declare abstract class CacheInterface {
+    /**
+     * 获取缓存
+     * @param key 缓存名
+     * @returns
+     */
+    get(key: string): Promise<any>;
+    /**
+     * 设置缓存
+     * @param key 缓存名
+     * @returns
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * 设置缓存
+     * @param key 缓存名
+     * @param data 数据
+     * @param lifetime 过期时间，单位：秒
+     * @returns
+     */
+    set(key: string, data?: any, lifetime?: number): Promise<boolean>;
+    /**
+     * 删除缓存
+     * @param key 缓存名
+     * @returns
+     */
+    delete(key: string): Promise<boolean>;
 }
+export = CacheInterface;

package/dist/Core/Contracts/CacheInterface.js

@@ -8,28 +8,41 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-Object.defineProperty(exports, "__esModule", { value: true });
 class CacheInterface {
-    get(id) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return null;
-        });
+    /**
+     * 获取缓存
+     * @param key 缓存名
+     * @returns
+     */
+    get(key) {
+        return __awaiter(this, void 0, void 0, function* () { return null; });
     }
-    has(id) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return false;
-        });
+    /**
+     * 设置缓存
+     * @param key 缓存名
+     * @returns
+     */
+    has(key) {
+        return __awaiter(this, void 0, void 0, function* () { return false; });
     }
-    set(id, data = null, lifeTime = 0) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return false;
-        });
+    /**
+     * 设置缓存
+     * @param key 缓存名
+     * @param data 数据
+     * @param lifetime 过期时间，单位：秒
+     * @returns
+     */
+    set(key, data = null, lifetime = 0) {
+        return __awaiter(this, void 0, void 0, function* () { return false; });
     }
-    delete(id) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return false;
-        });
+    /**
+     * 删除缓存
+     * @param key 缓存名
+     * @returns
+     */
+    delete(key) {
+        return __awaiter(this, void 0, void 0, function* () { return false; });
     }
 }
-exports.default = CacheInterface;
 ;
+module.exports = CacheInterface;

package/dist/Core/Contracts/ConfigInterface.d.ts

@@ -0,0 +1,29 @@
+import ObjectAccessInterface from "./ObjectAccessInterface";
+declare abstract class ConfigInterface extends ObjectAccessInterface {
+    /**
+     * 获取全部配置项
+     * @returns
+     */
+    all(): object;
+    /**
+     * 判断配置项是否存在
+     * @param key 键名
+     * @returns
+     */
+    has(key: string): boolean;
+    /**
+     * 设置配置项
+     * @param key 键名
+     * @param value 键值
+     * @returns
+     */
+    set(key: string, value: any): void;
+    /**
+     * 获取配置项
+     * @param key 键名
+     * @param defaultValue 配置项不存在时返回的默认值
+     * @returns
+     */
+    get(key: string | string[], defaultValue?: any): any;
+}
+export = ConfigInterface;

package/dist/Core/Contracts/ConfigInterface.js

@@ -0,0 +1,34 @@
+'use strict';
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const ObjectAccessInterface_1 = __importDefault(require("./ObjectAccessInterface"));
+class ConfigInterface extends ObjectAccessInterface_1.default {
+    /**
+     * 获取全部配置项
+     * @returns
+     */
+    all() { return null; }
+    /**
+     * 判断配置项是否存在
+     * @param key 键名
+     * @returns
+     */
+    has(key) { return false; }
+    /**
+     * 设置配置项
+     * @param key 键名
+     * @param value 键值
+     * @returns
+     */
+    set(key, value) { }
+    /**
+     * 获取配置项
+     * @param key 键名
+     * @param defaultValue 配置项不存在时返回的默认值
+     * @returns
+     */
+    get(key, defaultValue = null) { return null; }
+}
+;
+module.exports = ConfigInterface;

package/dist/Core/Contracts/ObjectAccessInterface.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 兼容php的ArrayAccess接口
+ */
+declare abstract class ObjectAccessInterface {
+    /**
+     * 判断键是否存在
+     * @param key 键名
+     * @returns
+     */
+    offsetExists(key: any): boolean;
+    /**
+     * 获取键值
+     * @param key 键名
+     * @returns
+     */
+    offsetGet(key: any): any;
+    /**
+     * 设置键值
+     * @param key 键名
+     * @param value 键值
+     * @returns
+     */
+    offsetSet(key: any, value: any): void;
+    /**
+     * 删除键值
+     * @param key 键名
+     * @returns
+     */
+    offsetUnset(key: any): void;
+}
+export = ObjectAccessInterface;

package/dist/Core/Contracts/ObjectAccessInterface.js

@@ -0,0 +1,33 @@
+'use strict';
+/**
+ * 兼容php的ArrayAccess接口
+ */
+class ObjectAccessInterface {
+    /**
+     * 判断键是否存在
+     * @param key 键名
+     * @returns
+     */
+    offsetExists(key) { return false; }
+    /**
+     * 获取键值
+     * @param key 键名
+     * @returns
+     */
+    offsetGet(key) { return null; }
+    /**
+     * 设置键值
+     * @param key 键名
+     * @param value 键值
+     * @returns
+     */
+    offsetSet(key, value) { }
+    /**
+     * 删除键值
+     * @param key 键名
+     * @returns
+     */
+    offsetUnset(key) { }
+}
+;
+module.exports = ObjectAccessInterface;

package/dist/Core/Contracts/RefreshableAccessTokenInterface.d.ts

@@ -0,0 +1,9 @@
+import AccessTokenInterface from "./AccessTokenInterface";
+declare abstract class RefreshableAccessToken extends AccessTokenInterface {
+    /**
+     * 刷新token
+     * @returns
+     */
+    refresh(): Promise<string>;
+}
+export = RefreshableAccessToken;

package/dist/{Work/MiniProgram/Auth/AuthClient.js → Core/Contracts/RefreshableAccessTokenInterface.js}

@@ -11,20 +11,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-Object.defineProperty(exports, "__esModule", { value: true });
-const BaseClient_1 = __importDefault(require("../../../Core/BaseClient"));
-class AuthClient extends BaseClient_1.default {
+const AccessTokenInterface_1 = __importDefault(require("./AccessTokenInterface"));
+class RefreshableAccessToken extends AccessTokenInterface_1.default {
     /**
-     * 小程序登录，jscode换取session_key
-     * @param code wx.login 获取的 code
+     * 刷新token
+     * @returns
      */
-    session(code) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.httpGet('cgi-bin/miniprogram/jscode2session', {
-                js_code: code,
-                grant_type: 'authorization_code',
-            });
-        });
+    refresh() {
+        return __awaiter(this, void 0, void 0, function* () { return null; });
     }
 }
-exports.default = AuthClient;
+;
+module.exports = RefreshableAccessToken;

package/dist/Core/Contracts/ServerInterface.d.ts

@@ -0,0 +1,8 @@
+import ResponseInterface from "../Http/Contracts/ResponseInterface";
+declare abstract class ServerInterface {
+    /**
+     * 处理消息
+     */
+    serve(): Promise<ResponseInterface>;
+}
+export = ServerInterface;

package/dist/Core/Contracts/ServerInterface.js

@@ -0,0 +1,20 @@
+'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());
+    });
+};
+class ServerInterface {
+    /**
+     * 处理消息
+     */
+    serve() {
+        return __awaiter(this, void 0, void 0, function* () { return null; });
+    }
+}
+;
+module.exports = ServerInterface;

package/dist/Core/Encryptor.d.ts

@@ -1,12 +1,38 @@
 /// <reference types="node" />
-export default class Encryptor {
+declare class Encryptor {
     protected appId: string;
     protected token: string;
-    protected aesKey: Buffer;
+    protected aesKey: string | Buffer;
+    protected receiveId: string;
     protected blockSize: number;
-    constructor(appId: string, token: string, aesKey: string);
+    constructor(appId?: string, token?: string, aesKey?: string | Buffer, receiveId?: string);
+    /**
+     * 获取配置的token
+     * @returns
+     */
     getToken(): string;
-    signature(...args: any[]): string;
+    /**
+     * 计算消息签名
+     * @param args
+     * @returns
+     */
+    createSignature(...args: any[]): string;
+    /**
+     * 加密
+     * @param text
+     * @param nonce
+     * @param timestamp
+     * @returns
+     */
     encrypt(text: string, nonce?: string, timestamp?: number): string;
+    /**
+     * 解密
+     * @param text
+     * @param msgSignature
+     * @param nonce
+     * @param timestamp
+     * @returns
+     */
     decrypt(text: string, msgSignature: string, nonce: string, timestamp: number): string;
 }
+export = Encryptor;

package/dist/Core/Encryptor.js

@@ -2,28 +2,44 @@
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-Object.defineProperty(exports, "__esModule", { value: true });
 const crypto_1 = __importDefault(require("crypto"));
-const Utils_1 = require("./Utils");
-const AES_1 = require("./AES");
-const PKCS_1 = require("./PKCS");
+const Utils_1 = require("./Support/Utils");
+const AES_1 = require("./Support/AES");
+const PKCS_1 = __importDefault(require("./Support/PKCS"));
 class Encryptor {
-    constructor(appId, token, aesKey) {
-        this.appId = null;
-        this.token = null;
-        this.aesKey = null;
-        this.blockSize = 32;
+    constructor(appId = null, token = null, aesKey = null, receiveId = null) {
         this.appId = appId;
         this.token = token;
-        this.aesKey = Buffer.from(aesKey + '=', 'base64');
+        this.aesKey = aesKey;
+        this.receiveId = receiveId;
+        this.blockSize = 32;
+        if (typeof this.aesKey === 'string') {
+            this.aesKey = Buffer.from(this.aesKey + '=', 'base64');
+        }
     }
+    /**
+     * 获取配置的token
+     * @returns
+     */
     getToken() {
         return this.token;
     }
-    signature(...args) {
+    /**
+     * 计算消息签名
+     * @param args
+     * @returns
+     */
+    createSignature(...args) {
         args.sort();
         return (0, Utils_1.createHash)(args.join(''), 'sha1');
     }
+    /**
+     * 加密
+     * @param text
+     * @param nonce
+     * @param timestamp
+     * @returns
+     */
     encrypt(text, nonce = null, timestamp = null) {
         let encrypted = '';
         try {
@@ -32,7 +48,7 @@ class Encryptor {
             let msg = Buffer.from(text);
             let msgLength = Buffer.alloc(4);
             msgLength.writeUInt32BE(msg.length, 0);
-            let encoded = PKCS_1.PKCS7.pad(Buffer.concat([randomString, msgLength, msg, Buffer.from(this.appId)]), this.blockSize);
+            let encoded = PKCS_1.default.pad(Buffer.concat([randomString, msgLength, msg, Buffer.from(this.appId)]), this.blockSize);
             encrypted = AES_1.AES.encrypt(encoded, this.aesKey, this.aesKey.slice(0, 16), false, 'aes-256-cbc').toString('base64');
         }
         catch (e) {
@@ -44,26 +60,34 @@ class Encryptor {
             timestamp = (0, Utils_1.getTimestamp)();
         let response = {
             Encrypt: encrypted,
-            MsgSignature: this.signature(this.token, timestamp, nonce, encrypted),
+            MsgSignature: this.createSignature(this.token, timestamp, nonce, encrypted),
             TimeStamp: timestamp,
             Nonce: nonce,
         };
         return (0, Utils_1.buildXml)(response);
     }
+    /**
+     * 解密
+     * @param text
+     * @param msgSignature
+     * @param nonce
+     * @param timestamp
+     * @returns
+     */
     decrypt(text, msgSignature, nonce, timestamp) {
-        let signature = this.signature(this.token, nonce, timestamp, text);
+        let signature = this.createSignature(this.token, nonce, timestamp, text);
         if (signature !== msgSignature) {
             throw new Error('Invalid Signature.');
         }
         let deciphered = AES_1.AES.decrypt(Buffer.from(text, 'base64'), this.aesKey, this.aesKey.slice(0, 16), false, 'aes-256-cbc');
-        deciphered = PKCS_1.PKCS7.unpad(deciphered, this.blockSize);
+        deciphered = PKCS_1.default.unpad(deciphered, this.blockSize);
         let content = deciphered.slice(16);
         let length = content.slice(0, 4).readUInt32BE(0);
-        if (content.slice(length + 4).toString() !== this.appId) {
+        if (this.receiveId && content.slice(length + 4).toString() !== this.receiveId) {
             throw new Error('Invalid appId.');
         }
         return content.slice(4, length + 4).toString();
     }
 }
-exports.default = Encryptor;
 ;
+module.exports = Encryptor;

package/dist/Core/Http/Contracts/MessageInterface.d.ts

@@ -0,0 +1,69 @@
+/// <reference types="node" />
+declare abstract class MessageInterface {
+    /**
+     * 获取 HTTP 协议版本，如：'1.1', '1.0'
+     * @returns
+     */
+    getProtocolVersion(): string;
+    /**
+     * 设置 HTTP 协议版本
+     * @param version
+     * @returns
+     */
+    withProtocolVersion(version: string): this;
+    /**
+     * 获取所有headers
+     * @returns
+     */
+    getHeaders(): Record<string, any>;
+    /**
+     * 判断header是否存在
+     * @param name
+     * @returns
+     */
+    hasHeader(name: string): boolean;
+    /**
+     * 获取header
+     * @param name
+     * @returns
+     */
+    getHeader(name: string): any;
+    /**
+     * 获取header，逗号分隔同名header
+     * @param name
+     * @returns
+     */
+    getHeaderLine(name: string): string;
+    /**
+     * 设置header值
+     * @param name
+     * @param value
+     * @returns
+     */
+    withHeader(name: string, value: string | string[]): this;
+    /**
+     * 附加header值
+     * @param name
+     * @param value
+     * @returns
+     */
+    withAddedHeader(name: string, value: string | string[]): this;
+    /**
+     * 删除header
+     * @param name
+     * @returns
+     */
+    withoutHeader(name: string): this;
+    /**
+     * 获取body内容
+     * @returns
+     */
+    getBody(): Buffer;
+    /**
+     * 设置body内容
+     * @param body
+     * @returns
+     */
+    withBody(body: any): this;
+}
+export = MessageInterface;