node-easywechat 3.0.0-beta.5 → 3.0.0

package/dist/Pay/Server.js

@@ -0,0 +1,122 @@
+'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 ServerInterface_1 = __importDefault(require("../Core/Contracts/ServerInterface"));
+const Response_1 = __importDefault(require("../Core/Http/Response"));
+const Message_1 = __importDefault(require("./Message"));
+const AES_1 = require("../Core/Support/AES");
+class Server extends ServerInterface_1.default {
+    constructor(merchant = null, request = null) {
+        super();
+        this.merchant = merchant;
+        this.request = request;
+    }
+    /**
+     * 服务端消息处理
+     * @returns
+     */
+    serve() {
+        return __awaiter(this, void 0, void 0, function* () {
+            let message = yield this.getRequestMessage();
+            try {
+                let defaultResponse = new Response_1.default(200, {}, JSON.stringify({
+                    code: 'SUCCESS', message: '成功',
+                }));
+                let response = yield this.handle(defaultResponse, message);
+                if (!(response instanceof Response_1.default)) {
+                    response = defaultResponse;
+                }
+                return response;
+            }
+            catch (e) {
+                return new Response_1.default(200, {}, JSON.stringify({
+                    code: 'ERROR', message: e.message,
+                }));
+            }
+        });
+    }
+    /**
+     * 获取来自微信服务器的推送消息
+     * @param request 未设置该参数时，则从当前服务端收到的请求中获取
+     * @returns
+     */
+    getRequestMessage(request = null) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!request) {
+                request = this.request;
+            }
+            let originContent = '';
+            let body = request.getBody();
+            if (body) {
+                originContent = body.toString();
+            }
+            let attributes = {};
+            try {
+                attributes = JSON.parse(originContent);
+            }
+            catch (e) { }
+            if (Object.keys(attributes).length === 0) {
+                throw new Error('Invalid request body.');
+            }
+            if (!attributes['resource']['ciphertext']) {
+                throw new Error('Invalid request.');
+            }
+            try {
+                let decryptMessage = AES_1.AES_GCM.decrypt(attributes['resource']['ciphertext'], this.merchant.getSecretKey(), attributes['resource']['nonce'], attributes['resource']['associated_data']);
+                attributes = JSON.parse(decryptMessage.toString());
+            }
+            catch (e) {
+                throw new Error('Failed to decrypt request message.');
+            }
+            return new Message_1.default(attributes, originContent);
+        });
+    }
+    /**
+     * 获取解密后的消息
+     * @param request
+     * @returns
+     */
+    getDecryptedMessage(request = null) {
+        return this.getRequestMessage(request);
+    }
+    /**
+     * 处理付款回调
+     * @param handler 消息处理器，需要接受两个参数，参数1是消息，参数2是下一个消息处理器
+     * @returns
+     */
+    handlePaid(handler) {
+        this.with((message, next) => __awaiter(this, void 0, void 0, function* () {
+            return message.getEventType() === 'TRANSACTION.SUCCESS' && message.trade_state === 'SUCCESS'
+                ? handler(message, next) : next(message);
+        }));
+        return this;
+    }
+    /**
+     * 处理退款回调
+     * @param handler 消息处理器，需要接受两个参数，参数1是消息，参数2是下一个消息处理器
+     * @returns
+     */
+    handleRefunded(handler) {
+        this.with((message, next) => __awaiter(this, void 0, void 0, function* () {
+            let eventType = message.getEventType();
+            return [
+                'REFUND.SUCCESS',
+                'REFUND.ABNORMAL',
+                'REFUND.CLOSED',
+            ].findIndex(o => o === eventType) > -1 ? handler(message, next) : next(message);
+        }));
+        return this;
+    }
+}
+;
+module.exports = Server;

package/dist/Pay/Signature.d.ts

@@ -0,0 +1,15 @@
+import MerchantInterface from "./Contracts/MerchantInterface";
+import { AxiosRequestConfig } from "axios";
+declare class Signature {
+    protected merchant: MerchantInterface;
+    constructor(merchant: MerchantInterface);
+    /**
+     * V3版本的签名计算
+     * @param method 请求方式
+     * @param url 请求地址
+     * @param payload 请求载荷
+     * @returns
+     */
+    createHeader(method: string, url: string, payload: AxiosRequestConfig<any>): string;
+}
+export = Signature;

package/dist/Pay/Signature.js

@@ -0,0 +1,44 @@
+'use strict';
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const Utils_1 = require("../Core/Support/Utils");
+const merge_1 = __importDefault(require("merge"));
+const url_1 = __importDefault(require("url"));
+const RSA_1 = __importDefault(require("../Core/Support/RSA"));
+class Signature {
+    constructor(merchant) {
+        this.merchant = merchant;
+    }
+    /**
+     * V3版本的签名计算
+     * @param method 请求方式
+     * @param url 请求地址
+     * @param payload 请求载荷
+     * @returns
+     */
+    createHeader(method, url, payload) {
+        let uri = url_1.default.parse(url);
+        let query = (0, Utils_1.parseQueryString)(uri.query);
+        uri.query = (0, Utils_1.buildQueryString)((0, merge_1.default)(true, query, payload.params));
+        let nonce = (0, Utils_1.randomString)();
+        let timestamp = (0, Utils_1.getTimestamp)();
+        let path = uri.pathname + (uri.query ? '?' + uri.query : '');
+        let body = '';
+        if (payload.data) {
+            if (typeof payload.data === 'object') {
+                body = JSON.stringify(payload.data);
+            }
+            else {
+                body = payload.data;
+            }
+        }
+        let signString = `${method.toUpperCase()}\n${path}\n${timestamp}\n${nonce}\n${body}`;
+        let rsa = new RSA_1.default;
+        rsa.setPublicKey(this.merchant.getCertificate().toString());
+        rsa.setPrivateKey(this.merchant.getPrivateKey().toString());
+        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}"`;
+    }
+}
+module.exports = Signature;

package/dist/Pay/Utils.d.ts

@@ -0,0 +1,54 @@
+import { PayAppConfig, PayBridgeConfig, PaySdkConfig } from '../Types/global';
+import MerchantInterface from './Contracts/MerchantInterface';
+declare class Utils {
+    protected merchant: MerchantInterface;
+    constructor(merchant: MerchantInterface);
+    /**
+     * 创建签名（V3），并返回签名字符串
+     * @param params 参数集合
+     * @returns
+     */
+    protected createSignature(message: string): string;
+    /**
+     * 创建签名（V2），并返回签名字符串
+     * @param params 参数集合
+     * @returns
+     */
+    createV2Signature(params: Record<string, string | number>): string;
+    /**
+     * 构建JSBridge支付参数
+     * @see [v3文档](https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_4.shtml)
+     * @see [v2文档](https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6)
+     * @param prepayId 下单接口返回的prepay_id
+     * @param appId 应用id
+     * @param signType v3仅支持RSA，V2支持MD5、HMAC-SHA256
+     * @returns
+     */
+    buildBridgeConfig(prepayId: string, appId: string, signType?: string): PayBridgeConfig;
+    /**
+     * 构建JS-SDK支付参数
+     * @see https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JS-SDK.html#58
+     * @param prepayId 下单接口返回的prepay_id
+     * @param appId 应用id
+     * @param signType v3仅支持RSA，V2支持MD5、HMAC-SHA256
+     */
+    buildSdkConfig(prepayId: string, appId: string, signType?: string): PaySdkConfig;
+    /**
+     * 构建小程序支付参数
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/payment/wx.requestPayment.html
+     * @param prepayId 下单接口返回的prepay_id
+     * @param appId 应用id
+     * @param signType v3仅支持RSA，V2支持MD5、HMAC-SHA256
+     * @returns
+     */
+    buildMiniAppConfig(prepayId: string, appId: string, signType?: string): PayBridgeConfig;
+    /**
+     * 构建App支付参数
+     * @see https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_2_4.shtml
+     * @param prepayId 下单接口返回的prepay_id
+     * @param appId 应用id
+     * @returns
+     */
+    buildAppConfig(prepayId: string, appId: string): PayAppConfig;
+}
+export = Utils;

package/dist/Pay/Utils.js

@@ -0,0 +1,142 @@
+'use strict';
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+const RSA_1 = __importDefault(require("../Core/Support/RSA"));
+const Utils_1 = require("../Core/Support/Utils");
+class Utils {
+    constructor(merchant) {
+        this.merchant = merchant;
+    }
+    /**
+     * 创建签名（V3），并返回签名字符串
+     * @param params 参数集合
+     * @returns
+     */
+    createSignature(message) {
+        let rsa = new RSA_1.default;
+        rsa.setPublicKey(this.merchant.getCertificate().toString());
+        rsa.setPrivateKey(this.merchant.getPrivateKey().toString());
+        return rsa.sign(message);
+    }
+    /**
+     * 创建签名（V2），并返回签名字符串
+     * @param params 参数集合
+     * @returns
+     */
+    createV2Signature(params) {
+        let signString = '';
+        let sparator = '';
+        let keys = Object.keys(params);
+        keys = keys.sort();
+        for (let i = 0; i < keys.length; i++) {
+            if (keys[i] == 'sign' || keys[i] == 'paySign' || typeof params[keys[i]] === undefined || params[keys[i]] === null)
+                continue;
+            signString += sparator + keys[i] + '=' + params[keys[i]];
+            sparator = '&';
+        }
+        let key = this.merchant.getV2SecretKey();
+        if (!key) {
+            throw new Error('Missing V2 API key.');
+        }
+        signString += '&key=' + key;
+        let sign = '';
+        let type = params['signType'] ? (params['signType'] + '').toLowerCase() : 'md5';
+        switch (type) {
+            case 'sha1':
+            case 'md5':
+                sign = (0, Utils_1.createHash)(signString, type);
+                break;
+            case 'hmac-sha256':
+            case 'hmac_sha256':
+                type = type.replace(/^hmac[\-|_]/i, '');
+                sign = (0, Utils_1.createHmac)(signString, key, type);
+                break;
+        }
+        if (!sign) {
+            throw new Error('Failed to sign the request.');
+        }
+        return (sign + '').toUpperCase();
+    }
+    /**
+     * 构建JSBridge支付参数
+     * @see [v3文档](https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_1_4.shtml)
+     * @see [v2文档](https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6)
+     * @param prepayId 下单接口返回的prepay_id
+     * @param appId 应用id
+     * @param signType v3仅支持RSA，V2支持MD5、HMAC-SHA256
+     * @returns
+     */
+    buildBridgeConfig(prepayId, appId, signType = 'RSA') {
+        let params = {
+            appId,
+            timeStamp: (0, Utils_1.getTimestamp)(),
+            nonceStr: (0, Utils_1.randomString)(),
+            package: 'prepay_id=' + prepayId,
+            signType,
+            paySign: '',
+        };
+        // v2
+        if (signType != 'RSA') {
+            params.paySign = this.createV2Signature(params);
+        }
+        // v3
+        else {
+            let message = `${params.appId}\n${params.timeStamp}\n${params.nonceStr}\n${params.package}\n`;
+            params.paySign = this.createSignature(message);
+        }
+        return params;
+    }
+    /**
+     * 构建JS-SDK支付参数
+     * @see https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JS-SDK.html#58
+     * @param prepayId 下单接口返回的prepay_id
+     * @param appId 应用id
+     * @param signType v3仅支持RSA，V2支持MD5、HMAC-SHA256
+     */
+    buildSdkConfig(prepayId, appId, signType = 'RSA') {
+        let config = this.buildBridgeConfig(prepayId, appId, signType);
+        return {
+            appId: config.appId,
+            timestamp: config.timeStamp,
+            nonceStr: config.nonceStr,
+            package: config.package,
+            signType: config.signType,
+            paySign: config.paySign,
+        };
+    }
+    /**
+     * 构建小程序支付参数
+     * @see https://developers.weixin.qq.com/miniprogram/dev/api/payment/wx.requestPayment.html
+     * @param prepayId 下单接口返回的prepay_id
+     * @param appId 应用id
+     * @param signType v3仅支持RSA，V2支持MD5、HMAC-SHA256
+     * @returns
+     */
+    buildMiniAppConfig(prepayId, appId, signType = 'RSA') {
+        return this.buildBridgeConfig(prepayId, appId, signType);
+    }
+    /**
+     * 构建App支付参数
+     * @see https://pay.weixin.qq.com/wiki/doc/apiv3_partner/apis/chapter4_2_4.shtml
+     * @param prepayId 下单接口返回的prepay_id
+     * @param appId 应用id
+     * @returns
+     */
+    buildAppConfig(prepayId, appId) {
+        let params = {
+            appId,
+            partnerid: this.merchant.getMerchantId(),
+            prepayid: prepayId,
+            nonceStr: (0, Utils_1.randomString)(),
+            timestamp: (0, Utils_1.getTimestamp)(),
+            package: 'Sign=WXPay',
+            sign: '',
+        };
+        let message = `${params.appId}\n${params.timestamp}\n${params.nonceStr}\n${params.prepayid}\n`;
+        params.sign = this.createSignature(message);
+        return params;
+    }
+}
+;
+module.exports = Utils;

package/dist/Types/global.d.ts

@@ -3,6 +3,7 @@ import ProviderInterface from 'node-socialite/dist/Core/ProviderInterface';
 import OfficialAccountApplicationInterface from '../OfficialAccount/Contracts/ApplicationInterface';
 import Message from '../Core/Message';
 import HttpClientResponseInterface from '../Core/HttpClient/Contracts/HttpClientResponseInterface';
+import { PublicKey } from "../Core/Support/PublicKey";
 
 declare module 'axios' {
   export interface AxiosRequestConfig {
@@ -153,10 +154,24 @@ export declare interface PayConfig extends BaseConfig {
   mch_id?: string;
 
   /**
-   * pfx 证书路径（敏感接口（如退款、发送红包等）需要）
+   * 商户证书路径
    */
   certificate?: string;
 
+  /**
+   * 商户证书私钥路径
+   */
+  private_key?: string;
+
+  /**
+   * 平台证书（v3接口需要）
+   *
+   * 支持路径列表或者PublicKey对象列表或者，以serial_no为key，证书内容或PublicKey对象为value的对象
+   *
+   * 下载工具：https://github.com/wechatpay-apiv3/CertificateDownloader
+   */
+  platform_certs?: string[] | PublicKey[] | Record<string, string | PublicKey>;
+
   /**
    * v3 API密钥
    */
@@ -324,3 +339,97 @@ export declare type PaymentScannedHandler = (message: Message, fail: PaymentFail
  * @param response 响应对象，仅在 type 为 after 时返回
  */
 export declare type LogHandler = (type: 'before' | 'after', options: AxiosRequestConfig, usedTime?: number, response?: AxiosResponse) => void | Promise<void>;
+
+/**
+ * 支付参数 JsBridge
+ */
+export declare interface PayBridgeConfig {
+  /**
+   * 应用id
+   */
+  appId: string;
+  /**
+   * 时间戳
+   */
+  timeStamp: number;
+  /**
+   * 随机字符串
+   */
+  nonceStr: string;
+  /**
+   * 订单详情扩展字符串
+   */
+  package: string;
+  /**
+   * 签名方式
+   */
+  signType: string;
+  /**
+   * 签名
+   */
+  paySign: string;
+}
+
+/**
+ * 支付参数 JsSdk
+ */
+export declare interface PaySdkConfig {
+  /**
+   * 应用id
+   */
+  appId: string;
+  /**
+   * 时间戳
+   */
+  timestamp: number;
+  /**
+   * 随机字符串
+   */
+  nonceStr: string;
+  /**
+   * 订单详情扩展字符串
+   */
+  package: string;
+  /**
+   * 签名方式
+   */
+  signType: string;
+  /**
+   * 签名
+   */
+  paySign: string;
+}
+
+/**
+ * 支付参数 App
+ */
+export declare interface PayAppConfig {
+  /**
+   * 应用id
+   */
+  appId: string;
+  /**
+   * 商户id
+   */
+  partnerid: string;
+  /**
+   * 预支付交易会话ID
+   */
+  prepayid: string;
+  /**
+   * 订单详情扩展字符串
+   */
+  package: string;
+  /**
+   * 随机字符串
+   */
+  nonceStr: string;
+  /**
+   * 时间戳
+   */
+  timestamp: number;
+  /**
+   * 签名
+   */
+  sign: string;
+}

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-import { OfficialAccountConfig, MiniAppConfig, LogHandler, ServerEventType, ServerHandlerClosure } from './Types/global';
+import { OfficialAccountConfig, MiniAppConfig, LogHandler, ServerEventType, ServerHandlerClosure, PayConfig } from './Types/global';
 import OfficialAccount from './OfficialAccount/Application';
 import MiniApp from './MiniApp/Application';
+import Pay from './Pay/Application';
 import CacheInterface from './Core/Contracts/CacheInterface';
 import ServerRequest from './Core/Http/ServerRequest';
-import Message from './Core/Message';
 import FormData from 'form-data';
-export { OfficialAccount, OfficialAccountConfig, MiniApp, MiniAppConfig, CacheInterface, ServerRequest, LogHandler, ServerEventType, ServerHandlerClosure, Message, 
+export { OfficialAccount, OfficialAccountConfig, MiniApp, MiniAppConfig, Pay, PayConfig, CacheInterface, ServerRequest, LogHandler, ServerEventType, ServerHandlerClosure, 
 /**
  * 表单对象
  * @see https://github.com/axios/axios#formdata

package/dist/index.js

@@ -3,16 +3,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FormData = exports.Message = exports.ServerRequest = exports.CacheInterface = exports.MiniApp = exports.OfficialAccount = void 0;
+exports.FormData = exports.ServerRequest = exports.CacheInterface = exports.Pay = exports.MiniApp = exports.OfficialAccount = void 0;
 const Application_1 = __importDefault(require("./OfficialAccount/Application"));
 exports.OfficialAccount = Application_1.default;
 const Application_2 = __importDefault(require("./MiniApp/Application"));
 exports.MiniApp = Application_2.default;
+const Application_3 = __importDefault(require("./Pay/Application"));
+exports.Pay = Application_3.default;
 const CacheInterface_1 = __importDefault(require("./Core/Contracts/CacheInterface"));
 exports.CacheInterface = CacheInterface_1.default;
 const ServerRequest_1 = __importDefault(require("./Core/Http/ServerRequest"));
 exports.ServerRequest = ServerRequest_1.default;
-const Message_1 = __importDefault(require("./Core/Message"));
-exports.Message = Message_1.default;
 const form_data_1 = __importDefault(require("form-data"));
 exports.FormData = form_data_1.default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-easywechat",
-  "version": "3.0.0-beta.5",
+  "version": "3.0.0",
   "description": "EasyWechat SDK for Node.js (NOT OFFICIAL)",
   "main": "dist/index.js",
   "scripts": {