doc: Add type document.

.gitignore

@@ -4,9 +4,11 @@
 
 # node.js
 #
+typedoc
 node_modules/
 npm-debug.log
 yarn-error.log
+yarn.lock
 
 # Xcode
 #

index.d.ts

@@ -1,9 +1,16 @@
+/// <reference no-default-lib="true" />
+/// <reference lib="esnext" />
 
 /**
+ * 支付宝支付，基于 React Native 的支付宝插件，支持Android/iOS。
+ */
+declare namespace Alipay {
+
+  /**
    * 支付宝端支付
    * 支付宝回调结果, 详情见 https://docs.open.alipay.com/204/105301
    */
-export interface AliOrderResult {
+  export interface OrderResultStr {
     alipay_trade_app_pay_response: {
       /**
        * 长度：64，商户网站唯一订单号	70501111111S001111119
@@ -44,53 +51,67 @@ export interface AliOrderResult {
     },
     sign: string;
     sign_type: 'RSA2' | 'RSA';
-}
+  }
 
-
-interface OrderResult {
   /**
-   * @callback AliOrderResult
+   * 支付订单返回结果
+   * @returns 成功返回
+   * 
+   * ```json
+   * {
+   *   result: '{"alipay_trade_app_pay_response":{"code":"10000","msg":"Success","app_id":"2021001172656340","auth_app_id":"2021001172656340","charset":"UTF-8","timestamp":"2020-07-08 21:30:14","out_trade_no":"123123213123214","total_amount":"0.01","trade_no":"2020070822001414841426413774","seller_id":"2088421915791034"},"sign":"LY7wCsNLp+QnDqCq6VelY/RvyK7ZGY8wsXoKvS+Or7JjONLDUx5P6lDgqRKkpkng7br3y6GZzfGKaZ88Tf4eMnBMKyqU+huR2Um47xUxP383njvHlxuQZsSTLQZRswy4wmb/fPkFfvyH6Or6+oj0eboePOTu63bNr+h03w0QnP4znuHpfRuoVgWpsYh/6B1DL+4xfWRKJ21zm1SV9Feo9RWqnyTaGZyFVi6IKge0dUCYs9hXju95fOUVUOx5YflOFtSEnZafY9Ls4FCRQE1ANkjaKiKIE0+c4c4sEVEf/9Dwh88N+aSQOoLT+AV4RpjMoA8hF2k+vv2OKNeqr6SYGQ==","sign_type":"RSA2"}',
+   *   resultStatus: '9000',
+   *   memo: ''
+   * }
+   * ```
+   * 
+   * @returns 错误返回
+   * 
+   * ```json
+   * {
+   *   memo: "Error Domain=系统繁忙，请稍后再试 Code=1000 \"(null)\"",
+   *   result: "",
+   *   resultStatus: "4000",
+   * }
+   * ```
+   */
+  export interface OrderResult {
+    /**
      * 支付返回结果：
-   * 支付宝支付返回结果文档地址：https://opendocs.alipay.com/open/204/105301#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C%E7%A4%BA%E4%BE%8B%EF%BC%88iOS%7CAndroid%EF%BC%89  
+     * 支付宝支付返回结果，[支付宝文档地址](https://opendocs.alipay.com/open/204/105301#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C%E7%A4%BA%E4%BE%8B%EF%BC%88iOS%7CAndroid%EF%BC%89)  
+     * 支付返回结果字符串通过 `JSON.parse` 进行转换为对象 {@link OrderResultStr}
+     * @typeParam OrderResultStr
+     * @example
+     * 
+     * ```json
      * '{"alipay_trade_app_pay_response":{"code":"10000","msg":"Success","app_id":"2021001172656340","auth_app_id":"2021001172656340","charset":"UTF-8","timestamp":"2020-07-08 21:30:14","out_trade_no":"123123213123214","total_amount":"0.01","trade_no":"2020070822001414841426413774","seller_id":"2088421915791034"},"sign":"LY7wCsNLp+QnDqCq6VelY/RvyK7ZGY8wsXoKvS+Or7JjONLDUx5P6lDgqRKkpkng7br3y6GZzfGKaZ88Tf4eMnBMKyqU+huR2Um47xUxP383njvHlxuQZsSTLQZRswy4wmb/fPkFfvyH6Or6+oj0eboePOTu63bNr+h03w0QnP4znuHpfRuoVgWpsYh/6B1DL+4xfWRKJ21zm1SV9Feo9RWqnyTaGZyFVi6IKge0dUCYs9hXju95fOUVUOx5YflOFtSEnZafY9Ls4FCRQE1ANkjaKiKIE0+c4c4sEVEf/9Dwh88N+aSQOoLT+AV4RpjMoA8hF2k+vv2OKNeqr6SYGQ==","sign_type":"RSA2"}'
+     * ```
+     * 
      */
     result?: string;
     /**
-   * 9000	订单支付成功  
+     * 错误状态码
-   * 8000	正在处理中，支付结果未知（有可能已经支付成功），请查询商户订单列表中订单的支付状态  
+     * - 9000	订单支付成功  
-   * 4000	订单支付失败  
+     * - 8000	正在处理中，支付结果未知（有可能已经支付成功），请查询商户订单列表中订单的支付状态  
-   * 5000	重复请求  
+     * - 4000	订单支付失败  
-   * 6001	用户中途取消  
+     * - 5000	重复请求  
-   * 6002	网络连接出错  
+     * - 6001	用户中途取消  
-   * 6004	支付结果未知（有可能已经支付成功），请查询商户订单列表中订单的支付状态  
+     * - 6002	网络连接出错  
-   * 其它	其它支付错误
+     * - 6004	支付结果未知（有可能已经支付成功），请查询商户订单列表中订单的支付状态  
+     * - 其它	其它支付错误
      */
     resultStatus?: '9000' | '8000' | '4000' | '5000' | '6001' | '6002' | '6004' | string;
     /**
-   * "Error Domain=系统繁忙，请稍后再试 Code=1000 "(null)""
      * 优惠券备注信息
+     * "Error Domain=系统繁忙，请稍后再试 Code=1000 "(null)""
      */
     memo: string;
-}
+  }
-
+  /**
-// 错误返回
+   * 快速登录授权，[支付宝文档](https://opendocs.alipay.com/open/218/105327#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C%E8%AF%B4%E6%98%8E)
-// {
+   * 
-//   memo: "Error Domain=系统繁忙，请稍后再试 Code=1000 \"(null)\"",
-//   result: "",
-//   resultStatus: "4000",
-// }
-// 成功返回
-// { 
-//   result: '{"alipay_trade_app_pay_response":{"code":"10000","msg":"Success","app_id":"2021001172656340","auth_app_id":"2021001172656340","charset":"UTF-8","timestamp":"2020-07-08 21:30:14","out_trade_no":"123123213123214","total_amount":"0.01","trade_no":"2020070822001414841426413774","seller_id":"2088421915791034"},"sign":"LY7wCsNLp+QnDqCq6VelY/RvyK7ZGY8wsXoKvS+Or7JjONLDUx5P6lDgqRKkpkng7br3y6GZzfGKaZ88Tf4eMnBMKyqU+huR2Um47xUxP383njvHlxuQZsSTLQZRswy4wmb/fPkFfvyH6Or6+oj0eboePOTu63bNr+h03w0QnP4znuHpfRuoVgWpsYh/6B1DL+4xfWRKJ21zm1SV9Feo9RWqnyTaGZyFVi6IKge0dUCYs9hXju95fOUVUOx5YflOFtSEnZafY9Ls4FCRQE1ANkjaKiKIE0+c4c4sEVEf/9Dwh88N+aSQOoLT+AV4RpjMoA8hF2k+vv2OKNeqr6SYGQ==","sign_type":"RSA2"}',
-//   resultStatus: '9000',
-//   memo: ''
-// }
-
-/**
- * 快速登录授权
- * https://opendocs.alipay.com/open/218/105327#%E8%BF%94%E5%9B%9E%E7%BB%93%E6%9E%9C%E8%AF%B4%E6%98%8E  
    */
-interface AuthResult {
+  export interface AuthResult {
     /**
      * 长度：144，本次操作返回的结果数据。
      * - `result_code` 具体状态码值请参见“result_code状态代码”。仅当resultStatus为“9000”且result_code为“200”时，代表授权成功。
@@ -110,39 +131,34 @@ interface AuthResult {
      * 长度：无，保留参数，一般无内容。	处理成功
      */
     memo:	string; 
-}
+  }
-
-
-export const Alipay: {
   /**
    * 支付
    * @param payInfo 支付详情
    * @returns result 支付宝回调结果 https://docs.open.alipay.com/204/105301
    */
-  alipay: (payInfo: string) => Promise<OrderResult>;
+  export function alipay(payInfo: string): Promise<OrderResult>;
   /**
    * 快速登录授权
    * @param authInfoStr 验证详情
    * @returns result 支付宝回调结果 https://opendocs.alipay.com/open/218/105327
    */
-  authInfo: (authInfoStr: string) => Promise<AuthResult>;
+  export function authInfo(authInfoStr: string): Promise<AuthResult>;
   /**
    *  获取当前 SDK 版本号
    *  @return 当前 SDK 版本字符串
    */
-  getVersion: () => Promise<string>;
+  export function getVersion(): Promise<string>;
   /**
    * 设置支付宝跳转Scheme，仅 iOS
    * @param scheme scheme = `ap` + `APPID`
    * @platform ios
    */
-  setAlipayScheme: (scheme: string) => void;
+  export function setAlipayScheme(scheme: string): void;
   /**
    * 设置支付宝沙箱环境，仅 Android
    * @param isSandBox
    * @platform android
    */
-  setAlipaySandbox: (isSandbox: boolean) => void;
+  export function setAlipaySandbox(isSandbox: boolean): void;
-};
+}
-
-export default Alipay;

package.json

@@ -3,6 +3,7 @@
   "version": "2.0.7",
   "description": "基于 React Native 的支付宝插件，支持Android/iOS。",
   "main": "index.js",
+  "typings": "index.d.ts",
   "files": [
     "README.md",
     "android",
@@ -11,7 +12,7 @@
     "ios"
   ],
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "typedoc"
   },
   "repository": {
     "type": "git",
@@ -40,6 +41,8 @@
   },
   "devDependencies": {
     "react": "^16.9.0",
-    "react-native": "^0.61.5"
+    "react-native": "^0.61.5",
+    "typedoc": "^0.17.8",
+    "typescript": "^3.9.7"
   }
 }

typedoc.json

@@ -0,0 +1,12 @@
+{
+  "inputFiles": "./index.d.ts",
+  "out": "typedoc",
+  "entryPoint": "Alipay",
+  "name": "React Native Alipay",
+  "mode": "file",
+  "includeDeclarations": true,
+  "excludeExternals": true,
+  "ignoreCompilerErrors": true,
+  "excludePrivate": true,
+  "excludeProtected": true
+}