chore: expose chainable async/sync fn, fix Rsa::from, optim d.ts

Author: TheNorthMemory

index.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
 import { AgentOptions } from "https";
-import { CipherKey, BinaryLike, KeyLike } from 'crypto'
+import { CipherKey, BinaryLike, KeyLike, KeyObject } from 'crypto'
 import { AxiosInstance, AxiosRequestConfig, AxiosResponse } from "axios";
 import { default as Base } from '@thenorthmemory/multipart';
 
@@ -132,6 +132,14 @@ export namespace WechatpayAxiosPlugin {
      * Crypto hash functions utils.
      */
     class Hash {
+        static ALGO_MD5: 'MD5';
+
+        static ALGO_HMAC_SHA256: 'HMAC-SHA256';
+
+        static isKeyObject(thing: any): boolean;
+
+        static keyObjectFrom(thing: Buffer): KeyObject;
+
         /**
          * Calculate the input string with an optional secret `key` in MD5,
          * when the `key` is Falsey, this method works as normal `MD5`.
@@ -429,11 +437,26 @@ export namespace WechatpayAxiosPlugin {
         /**
          * Alias of the `RSA_PKCS1_OAEP_PADDING` mode
          */
-        readonly RSA_PKCS1_OAEP_PADDING: 4;
+        static RSA_PKCS1_OAEP_PADDING: 4;
         /**
          * Alias of the `RSA_PKCS1_PADDING` mode
          */
-        readonly RSA_PKCS1_PADDING: 1;
+        static RSA_PKCS1_PADDING: 1;
+
+        static KEY_TYPE_PUBLIC: 'public';
+
+        static KEY_TYPE_PRIVATE: 'private';
+
+        static isKeyObject(thing: any): boolean;
+
+        static fromPkcs8(str: string): KeyObject;
+
+        static fromPkcs1(str: string, type: 'public' | 'private'): KeyObject;
+
+        static fromSpki(str: string): KeyObject;
+
+        static from(thing: KeyLike, type: 'public' | 'private'): KeyObject;
+
         /**
          * Encrypts text with sha256WithRSAEncryption/RSA_PKCS1_OAEP_PADDING.
          * Node Limits >= 12.9.0 (`oaepHash` was added)

lib/decorator.js

@@ -32,7 +32,7 @@ const EV3_RES_HEADER_PLATFORM_SERIAL = 'Cannot found the serial(`%s`)\'s configu
 const EV3_RES_HEADER_SIGNATURE_DIGEST = 'Verify the response\'s data with: timestamp=%s, nonce=%s, signature=%s, cert={%s: ...} failed.';
 
 function isValidAsymmetricKey(thing) {
-  return ((utils.isString(thing) || utils.isBuffer(thing)) && thing.length) || Rsa.isKeyObject(thing);
+  return ((utils.isString(thing) || utils.isBuffer(thing)) && thing.length > 0) || Rsa.isKeyObject(thing);
 }
 
 /**

lib/rsa.js

@@ -102,7 +102,7 @@ class Rsa {
     let input = thing;
     if (format && kind && offset) {
       const key = Buffer.from(thing.slice(offset), base64);
-      input = { key, format, type };
+      input = { key, format, type: kind };
     }
 
     return (protocol.startsWith(this.KEY_TYPE_PRIVATE) || type === this.KEY_TYPE_PRIVATE ? createPrivateKey : createPublicKey)(input);

lib/wechatpay.js

@@ -1,6 +1,8 @@
 const Decorator = require('./decorator');
 
+const chain = 'chain';
 const CLIENT = Symbol('CLIENT');
+const enumerable = true;
 
 /**
  * Normalize the `str` by the rules: `PascalCase` -> `camelCase` & `camelCase` -> `camel-case` & `$dynamic$` -> `{dynamic}`
@@ -98,19 +100,19 @@ class Wechatpay {
   chain(pathname) {
     const client = this[CLIENT];
 
-    /* eslint-disable object-curly-newline, arrow-body-style */
+    /* eslint-disable object-curly-newline, arrow-body-style, object-property-newline */
     return ['post', 'put', 'patch'].reduce((resource, method) => {
-      return Object.defineProperty(resource, method, { value: { [method](data, config) {
+      return Object.defineProperty(resource, method, { enumerable, value: { async [method](data, config) {
         return client.request(pathname, method, data, config);
       } }[method] });
     }, ['delete', 'get'].reduce((resource, method) => {
-      return Object.defineProperty(resource, method, { value: { [method](config) {
+      return Object.defineProperty(resource, method, { enumerable, value: { async [method](config) {
         return client.request(pathname, method, undefined, config);
       } }[method] });
-    }, Object.defineProperty({ [pathname](data, config) {
+    }, Object.defineProperty({ async [pathname](data, config) {
       return client.request(pathname, 'post', data, config);
-    } }[pathname], 'chain', { value: (thing) => this.compose(pathname, thing) })));
-    /* eslint-enable object-curly-newline, arrow-body-style */
+    } }[pathname], chain, { enumerable, value: { [chain]: (thing) => this.compose(pathname, thing) }[chain] })));
+    /* eslint-enable object-curly-newline, arrow-body-style, object-property-newline */
   }
 
   /**