node-easywechat 3.1.1 → 3.1.3

package/CHANGELOG.md

@@ -1,6 +1,18 @@
 # CHANGELOG
 
 
+## v3.1.3 (2023-02-01)
+
+- Fix: 修复默认的文件缓存配置项不生效问题 (#35)
+
+## v3.1.2 (2022-12-06)
+
+- Feat: 新作微信支付模块的文件上传方法
+
+- Fix: nodejs版本不能低于15.6.0
+- Fix: 更新依赖的nodejs版本
+- Fix: 修复RSA证书使用格式不正确导致的签名异常问题
+
 ## v3.1.1 (2022-11-15)
 
 - Feat: 增加请求失败时的重试机制，具体见配置项http.retry

package/README.md

@@ -16,6 +16,8 @@
 
 `npm install -S node-easywechat@next`
 
+**注：3.x 版本需要 Node.js 15.6.0 及以上版本**
+
 ### 使用说明
 
 绝大部分API都可以根据 [EasyWechat 的文档](https://www.easywechat.com/5.x/) 来使用。小部分（如获取请求相关数据、返回响应数据、支付证书等）的操作，由于语言环境的不同，会有不同处理。具体可以查看 [node-easywechat-demo](https://github.com/hpyer/node-easywechat-demo/) 以及下方的[自定义模块说明](#自定义模块模块替换使用方法) 。如果仍有疑问，请提issue，谢谢～

package/dist/Core/HttpClient/HttpClient.js

@@ -79,8 +79,13 @@ class HttpClient {
             }
             if (options['formData'] && Object.keys(options['formData']).length > 0) {
                 let formData = new form_data_1.default();
-                for (let key in options['formData']) {
-                    formData.append(key, options['formData'][key]);
+                if (options['formData'] instanceof form_data_1.default) {
+                    formData = options['formData'];
+                }
+                else {
+                    for (let key in options['formData']) {
+                        formData.append(key, options['formData'][key]);
+                    }
                 }
                 if (options.data)
                     for (let key in options.data) {

package/dist/Core/Mixins/CacheMixin.js

@@ -45,7 +45,11 @@ class CacheMixin {
      */
     getCache() {
         if (!this.cache) {
-            this.cache = new FileCache_1.default();
+            let options = null;
+            if (typeof this['getConfig'] === 'function') {
+                options = this['getConfig']()['get']('file_cache');
+            }
+            this.cache = new FileCache_1.default(options);
         }
         return this.cache;
     }

package/dist/Core/Support/PrivateKey.d.ts

@@ -1,12 +1,13 @@
+/// <reference types="node" />
 export declare class PrivateKey {
-    protected key: string;
     protected passphrase?: string;
+    protected key: Buffer;
     constructor(key: string, passphrase?: string);
     /**
-     * 获取私钥
+     * 获取私钥内容
      * @returns
      */
-    getKey(): string;
+    getKey(): Buffer;
     /**
      * 获取密码
      * @returns
@@ -16,5 +17,5 @@ export declare class PrivateKey {
      * 转为字符串
      * @returns
      */
-    toString(): string;
+    toString(): Buffer;
 }

package/dist/Core/Support/PrivateKey.js

@@ -7,14 +7,13 @@ exports.PrivateKey = void 0;
 const fs_1 = __importDefault(require("fs"));
 class PrivateKey {
     constructor(key, passphrase) {
-        this.key = key;
         this.passphrase = passphrase;
         if (fs_1.default.existsSync(key)) {
-            this.key = fs_1.default.readFileSync(key, 'utf8') || '';
+            this.key = fs_1.default.readFileSync(key) || Buffer.from('');
         }
     }
     /**
-     * 获取私钥
+     * 获取私钥内容
      * @returns
      */
     getKey() {

package/dist/Core/Support/PublicKey.d.ts

@@ -1,11 +1,17 @@
+/// <reference types="node" />
 export declare class PublicKey {
-    certificate: string;
+    protected certificate: Buffer;
     constructor(certificate: string);
     /**
      * 获取公钥的序列号
      * @returns
      */
     getSerialNo(): string;
+    /**
+     * 获取证书内容
+     * @returns
+     */
+    getValue(): Buffer;
     /**
      * 转为字符串
      * @returns

package/dist/Core/Support/PublicKey.js

@@ -8,9 +8,8 @@ const fs_1 = __importDefault(require("fs"));
 const crypto_1 = require("crypto");
 class PublicKey {
     constructor(certificate) {
-        this.certificate = certificate;
         if (fs_1.default.existsSync(certificate)) {
-            this.certificate = fs_1.default.readFileSync(certificate, 'utf8') || '';
+            this.certificate = fs_1.default.readFileSync(certificate) || Buffer.from('');
         }
     }
     /**
@@ -25,12 +24,19 @@ class PublicKey {
             throw new Error('Read the $certificate failed, please check it whether or nor correct');
         }
     }
+    /**
+     * 获取证书内容
+     * @returns
+     */
+    getValue() {
+        return this.certificate;
+    }
     /**
      * 转为字符串
      * @returns
      */
     toString() {
-        return this.certificate;
+        return this.certificate.toString();
     }
 }
 exports.PublicKey = PublicKey;

package/dist/Core/Support/Utils.d.ts

@@ -1,11 +1,12 @@
+import Crypto from 'crypto';
 import Stream from 'stream';
-export declare const createHash: (str: string, type?: string) => any;
-export declare const createHmac: (str: string, key: string, type?: string) => any;
+export declare const createHash: (str: Crypto.BinaryLike, type?: string, target?: Crypto.BinaryToTextEncoding) => any;
+export declare const createHmac: (str: Crypto.BinaryLike, key: Crypto.BinaryLike, type?: string, target?: Crypto.BinaryToTextEncoding) => any;
 /**
- * 计算文件的 md5 值
+ * 计算文件的哈希值
  * @param path 文件路径或文件可读流
  */
-export declare const md5File: (path: string | Stream.Readable) => Promise<string>;
+export declare const createFileHash: (path: string | Stream.Readable, type?: string, target?: Crypto.BinaryToTextEncoding) => Promise<string>;
 export declare const getTimestamp: (datetime?: string) => number;
 export declare const buildQueryString: (data: Record<string, any>, options?: Record<string, any>) => string;
 export declare const parseQueryString: (data: string, options?: Record<string, any>) => Record<string, any>;

package/dist/Core/Support/Utils.js

@@ -12,26 +12,26 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createUserAgent = exports.buildXml = exports.parseXml = exports.singleItem = exports.strSnake = exports.strCamel = exports.strStudly = exports.strLcwords = exports.strUcwords = exports.rtrim = exports.ltrim = exports.trim = exports.applyMixins = exports.inArray = exports.isIp = exports.isIpv6 = exports.isIpv4 = exports.isFunction = exports.isObject = exports.isNumber = exports.isArray = exports.isString = exports.makeSignature = exports.randomString = exports.parseQueryString = exports.buildQueryString = exports.getTimestamp = exports.md5File = exports.createHmac = exports.createHash = void 0;
+exports.createUserAgent = exports.buildXml = exports.parseXml = exports.singleItem = exports.strSnake = exports.strCamel = exports.strStudly = exports.strLcwords = exports.strUcwords = exports.rtrim = exports.ltrim = exports.trim = exports.applyMixins = exports.inArray = exports.isIp = exports.isIpv6 = exports.isIpv4 = exports.isFunction = exports.isObject = exports.isNumber = exports.isArray = exports.isString = exports.makeSignature = exports.randomString = exports.parseQueryString = exports.buildQueryString = exports.getTimestamp = exports.createFileHash = exports.createHmac = exports.createHash = void 0;
 const crypto_1 = __importDefault(require("crypto"));
 const qs_1 = __importDefault(require("qs"));
 const xml2js_1 = __importDefault(require("xml2js"));
 const stream_1 = __importDefault(require("stream"));
 const fs_1 = __importDefault(require("fs"));
 const axios_1 = __importDefault(require("axios"));
-const createHash = function (str, type = 'sha1') {
-    return crypto_1.default.createHash(type).update(str).digest('hex');
+const createHash = function (str, type = 'sha1', target = 'hex') {
+    return crypto_1.default.createHash(type).update(str).digest(target);
 };
 exports.createHash = createHash;
-const createHmac = function (str, key, type = 'sha256') {
-    return crypto_1.default.createHmac(type, key).update(str).digest('hex');
+const createHmac = function (str, key, type = 'sha256', target = 'hex') {
+    return crypto_1.default.createHmac(type, key).update(str).digest(target);
 };
 exports.createHmac = createHmac;
 /**
- * 计算文件的 md5 值
+ * 计算文件的哈希值
  * @param path 文件路径或文件可读流
  */
-const md5File = function (path) {
+const createFileHash = function (path, type = 'sha1', target = 'hex') {
     return new Promise((reslove, reject) => {
         let stream;
         if ((0, exports.isString)(path)) {
@@ -41,17 +41,17 @@ const md5File = function (path) {
             stream = new stream_1.default.PassThrough();
             path.pipe(stream);
         }
-        let md5sum = crypto_1.default.createHash('md5');
+        let md5sum = crypto_1.default.createHash(type);
         stream.on('data', function (chunk) {
             md5sum.update(chunk);
         });
         stream.on('end', function () {
-            let str = md5sum.digest('hex').toUpperCase();
+            let str = md5sum.digest(target).toUpperCase();
             reslove(str);
         });
     });
 };
-exports.md5File = md5File;
+exports.createFileHash = createFileHash;
 const getTimestamp = function (datetime = null) {
     let time;
     try {

package/dist/OfficialAccount/AccessToken.js

@@ -12,7 +12,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 const HttpClient_1 = __importDefault(require("../Core/HttpClient/HttpClient"));
-const FileCache_1 = __importDefault(require("../Core/Cache/FileCache"));
 class AccessToken {
     constructor(appId, secret, key = null, cache = null, httpClient = null) {
         this.appId = appId;
@@ -20,9 +19,6 @@ class AccessToken {
         this.key = key;
         this.cache = cache;
         this.httpClient = httpClient;
-        if (!this.cache) {
-            this.cache = new FileCache_1.default();
-        }
         if (!this.httpClient) {
             this.httpClient = HttpClient_1.default.create({
                 baseURL: 'https://api.weixin.qq.com/',
@@ -50,7 +46,10 @@ class AccessToken {
     }
     getToken() {
         return __awaiter(this, void 0, void 0, function* () {
-            let token = yield this.cache.get(this.getKey());
+            let token = '';
+            if (this.cache) {
+                token = yield this.cache.get(this.getKey());
+            }
             if (!!token && typeof token === 'string') {
                 return token;
             }
@@ -76,7 +75,9 @@ class AccessToken {
             if (!response['access_token']) {
                 throw new Error('Failed to get access_token: ' + JSON.stringify(response));
             }
-            yield this.cache.set(this.getKey(), response['access_token'], parseInt(response['expires_in']));
+            if (this.cache) {
+                yield this.cache.set(this.getKey(), response['access_token'], parseInt(response['expires_in']));
+            }
             return response['access_token'];
         });
     }

package/dist/OfficialAccount/JsApiTicket.js

@@ -31,7 +31,10 @@ class JsApiTicket extends AccessToken_1.default {
     getTicket() {
         return __awaiter(this, void 0, void 0, function* () {
             let key = this.getKey();
-            let ticket = yield this.cache.get(key);
+            let ticket = '';
+            if (this.cache) {
+                ticket = yield this.cache.get(key);
+            }
             if (!!ticket && typeof ticket === 'string') {
                 return ticket;
             }
@@ -43,7 +46,9 @@ class JsApiTicket extends AccessToken_1.default {
             if (!response['ticket']) {
                 throw new Error('Failed to get jssdk_ticket: ' + JSON.stringify(response));
             }
-            yield this.cache.set(key, response['ticket'], parseInt(response['expires_in']));
+            if (this.cache) {
+                yield this.cache.set(key, response['ticket'], parseInt(response['expires_in']));
+            }
             return response['ticket'];
         });
     }

package/dist/OpenPlatform/ComponentAccessToken.js

@@ -12,7 +12,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 const HttpClient_1 = __importDefault(require("../Core/HttpClient/HttpClient"));
-const FileCache_1 = __importDefault(require("../Core/Cache/FileCache"));
 class ComponentAccessToken {
     constructor(appId, secret, verifyTicket, key = null, cache = null, httpClient = null) {
         this.appId = appId;
@@ -21,9 +20,6 @@ class ComponentAccessToken {
         this.key = key;
         this.cache = cache;
         this.httpClient = httpClient;
-        if (!this.cache) {
-            this.cache = new FileCache_1.default();
-        }
         if (!this.httpClient) {
             this.httpClient = HttpClient_1.default.create({
                 baseURL: 'https://api.weixin.qq.com/',
@@ -51,7 +47,10 @@ class ComponentAccessToken {
     }
     getToken() {
         return __awaiter(this, void 0, void 0, function* () {
-            let token = yield this.cache.get(this.getKey());
+            let token = '';
+            if (this.cache) {
+                token = yield this.cache.get(this.getKey());
+            }
             if (!!token && typeof token === 'string') {
                 return token;
             }
@@ -77,7 +76,9 @@ class ComponentAccessToken {
             if (!response['component_access_token']) {
                 throw new Error('Failed to get component_access_token: ' + JSON.stringify(response));
             }
-            yield this.cache.set(this.getKey(), response['component_access_token'], parseInt(response['expires_in']) - 100);
+            if (this.cache) {
+                yield this.cache.set(this.getKey(), response['component_access_token'], parseInt(response['expires_in']) - 100);
+            }
             return response['component_access_token'];
         });
     }

package/dist/OpenPlatform/VerifyTicket.js

@@ -8,16 +8,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-const FileCache_1 = __importDefault(require("../Core/Cache/FileCache"));
 class VerifyTicket {
     constructor(appId, key = null, cache = null) {
         this.appId = appId;
         this.key = key;
         this.cache = cache;
-        this.cache = cache !== null && cache !== void 0 ? cache : new FileCache_1.default();
     }
     getKey() {
         if (!this.key) {
@@ -31,13 +26,18 @@ class VerifyTicket {
     }
     setTicket(ticket) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.cache.set(this.getKey(), ticket, 6000);
+            if (this.cache) {
+                yield this.cache.set(this.getKey(), ticket, 6000);
+            }
             return this;
         });
     }
     getTicket() {
         return __awaiter(this, void 0, void 0, function* () {
-            let ticket = yield this.cache.get(this.getKey());
+            let ticket = '';
+            if (this.cache) {
+                ticket = yield this.cache.get(this.getKey());
+            }
             if (!ticket || typeof ticket != 'string') {
                 throw new Error('No component_verify_ticket found.');
             }

package/dist/Pay/Application.js

@@ -13,8 +13,6 @@ const Merchant_1 = __importDefault(require("./Merchant"));
 const Server_1 = __importDefault(require("./Server"));
 const Utils_2 = __importDefault(require("./Utils"));
 const Config_1 = __importDefault(require("../OfficialAccount/Config"));
-const PrivateKey_1 = require("../Core/Support/PrivateKey");
-const PublicKey_1 = require("../Core/Support/PublicKey");
 const Client_1 = __importDefault(require("./Client"));
 /**
  * 微信支付应用
@@ -34,7 +32,7 @@ class Application {
     getMerchant() {
         var _a;
         if (!this.merchant) {
-            this.merchant = new Merchant_1.default(this.config.get('mch_id'), new PrivateKey_1.PrivateKey(this.config.get('private_key')), new PublicKey_1.PublicKey(this.config.get('certificate')), this.config.get('secret_key'), this.config.get('v2_secret_key'), (_a = this.config.get('platform_certs')) !== null && _a !== void 0 ? _a : []);
+            this.merchant = new Merchant_1.default(this.config.get('mch_id'), this.config.get('private_key'), this.config.get('certificate'), this.config.get('secret_key'), this.config.get('v2_secret_key'), (_a = this.config.get('platform_certs')) !== null && _a !== void 0 ? _a : []);
         }
         return this.merchant;
     }

package/dist/Pay/Client.d.ts

@@ -1,3 +1,5 @@
+/// <reference types="node" />
+import fs from 'fs';
 import { Method, AxiosRequestConfig, AxiosInstance } from "axios";
 import HttpClientInterface from "../Core/HttpClient/Contracts/HttpClientInterface";
 import HttpClientMethodsMixin from '../Core/HttpClient/Mixins/HttpClientMethodsMixin';
@@ -16,6 +18,16 @@ declare class Client implements HttpClientInterface {
     setInstance(instance: AxiosInstance): this;
     setLogger(logger: LogHandler): this;
     request(method: Method, url: string, payload?: AxiosRequestConfig<any>): Promise<HttpClientResponse>;
+    /**
+     * 文件上传
+     * @see https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter2_1_1.shtml
+     * @param uri 接口地址
+     * @param file 文件路径或文件可读流
+     * @param meta 文件元信息，包含 filename 和 sha256 两个字段
+     * @param filename 文件名，必须以 .jpg、.bmp、.png 为后缀
+     * @returns
+     */
+    uploadMedia(uri: string, file: string | fs.ReadStream, meta?: Record<string, any>, filename?: string): Promise<HttpClientResponse>;
     /**
      * 判断是否是V3请求
      * @param url 请求地址

package/dist/Pay/Client.js

@@ -11,6 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
+const fs_1 = __importDefault(require("fs"));
 const merge_1 = __importDefault(require("merge"));
 const Utils_1 = require("../Core/Support/Utils");
 const HttpClient_1 = __importDefault(require("../Core/HttpClient/HttpClient"));
@@ -18,6 +19,7 @@ const HttpClientMethodsMixin_1 = __importDefault(require("../Core/HttpClient/Mix
 const PresetMixin_1 = __importDefault(require("../Core/HttpClient/Mixins/PresetMixin"));
 const Signature_1 = __importDefault(require("./Signature"));
 const LegacySignature_1 = __importDefault(require("./LegacySignature"));
+const form_data_1 = __importDefault(require("form-data"));
 class Client {
     constructor(merchant, client, defaultOptions = {}) {
         var _a;
@@ -89,6 +91,42 @@ class Client {
             return this.client.request(method, (0, Utils_1.ltrim)(url, '\\/+'), payload);
         });
     }
+    /**
+     * 文件上传
+     * @see https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter2_1_1.shtml
+     * @param uri 接口地址
+     * @param file 文件路径或文件可读流
+     * @param meta 文件元信息，包含 filename 和 sha256 两个字段
+     * @param filename 文件名，必须以 .jpg、.bmp、.png 为后缀
+     * @returns
+     */
+    uploadMedia(uri, file, meta = null, filename = null) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (typeof file === 'string') {
+                file = fs_1.default.createReadStream(file);
+            }
+            if (!meta) {
+                meta = {
+                    filename: filename !== null && filename !== void 0 ? filename : 'file.jpg',
+                    sha256: yield (0, Utils_1.createFileHash)(file, 'sha256'),
+                };
+            }
+            let metaJson = JSON.stringify(meta);
+            let formData = new form_data_1.default();
+            formData.append('file', file);
+            formData.append('meta', metaJson, {
+                contentType: 'application/json',
+            });
+            return this.client.request('POST', (0, Utils_1.ltrim)(uri, '\\/+'), {
+                formData,
+                headers: {
+                    'authorization': this.createSignature('POST', uri, {
+                        data: metaJson,
+                    }),
+                }
+            });
+        });
+    }
     /**
      * 判断是否是V3请求
      * @param url 请求地址

package/dist/Pay/Merchant.d.ts

@@ -3,12 +3,12 @@ import { PublicKey } from "../Core/Support/PublicKey";
 import MerchantInterface from "./Contracts/MerchantInterface";
 declare class Merchant implements MerchantInterface {
     protected mchId: string;
-    protected privateKey: PrivateKey;
-    protected certificate: PublicKey;
     protected secretKey: string;
     protected v2SecretKey: string;
     protected platformCerts: Record<string, PublicKey>;
-    constructor(mchId: string, privateKey: PrivateKey, certificate: PublicKey, secretKey: string, v2SecretKey?: string, platformCerts?: Record<string, string | PublicKey> | string[] | PublicKey[]);
+    protected privateKey: PrivateKey;
+    protected certificate: PublicKey;
+    constructor(mchId: string, privateKey: string | PrivateKey, certificate: string | PublicKey, secretKey: string, v2SecretKey?: string, platformCerts?: Record<string, string | PublicKey> | string[] | PublicKey[]);
     /**
      * 统一规范化平台证书
      * @param platformCerts 平台证书列表

package/dist/Pay/Merchant.js

@@ -1,13 +1,24 @@
 'use strict';
+const PrivateKey_1 = require("../Core/Support/PrivateKey");
 const PublicKey_1 = require("../Core/Support/PublicKey");
 class Merchant {
     constructor(mchId, privateKey, certificate, secretKey, v2SecretKey = null, platformCerts = []) {
         this.mchId = mchId;
-        this.privateKey = privateKey;
-        this.certificate = certificate;
         this.secretKey = secretKey;
         this.v2SecretKey = v2SecretKey;
         this.platformCerts = {};
+        if (!(privateKey instanceof PrivateKey_1.PrivateKey)) {
+            this.privateKey = new PrivateKey_1.PrivateKey(privateKey);
+        }
+        else {
+            this.privateKey = privateKey;
+        }
+        if (!(certificate instanceof PublicKey_1.PublicKey)) {
+            this.certificate = new PublicKey_1.PublicKey(certificate);
+        }
+        else {
+            this.certificate = certificate;
+        }
         this.platformCerts = this.normalizePlatformCerts(platformCerts);
     }
     /**

package/dist/Pay/Signature.js

@@ -36,8 +36,8 @@ class Signature {
         }
         let signString = `${method.toUpperCase()}\n${pathname}\n${timestamp}\n${nonce}\n${body}`;
         let rsa = new RSA_1.default;
-        rsa.setPublicKey(this.merchant.getCertificate().toString());
-        rsa.setPrivateKey(this.merchant.getPrivateKey().toString());
+        rsa.setPublicKey(this.merchant.getCertificate().getValue());
+        rsa.setPrivateKey(this.merchant.getPrivateKey().getKey());
         let sign = rsa.sign(signString);
         return `WECHATPAY2-SHA256-RSA2048 mchid="${this.merchant.getMerchantId()}",nonce_str="${nonce}",timestamp="${timestamp}",serial_no="${this.merchant.getCertificate().getSerialNo()}",signature="${sign}"`;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-easywechat",
-  "version": "3.1.1",
+  "version": "3.1.3",
   "description": "EasyWechat SDK for Node.js (NOT OFFICIAL)",
   "main": "dist/index.js",
   "scripts": {
@@ -18,6 +18,9 @@
   ],
   "author": "Hpyer",
   "license": "MIT",
+  "engines": {
+    "node": ">=15.6.0"
+  },
   "devDependencies": {
     "@types/node": "^17.0.23",
     "axios-mock-adapter": "^1.21.1",