node-easywechat 3.7.4 → 3.7.5

package/CHANGELOG.md

@@ -1,6 +1,12 @@
 # CHANGELOG
 
 
+## v3.7.5 (2024-11-16)
+
+- Feat: 企业微信开放平台模块，新增生成授权页地址、获取企业永久授权码两个方法
+
+- Fix: 更新说明文档
+
 ## v3.7.4 (2024-08-14)
 
 - Fix: 更新依赖包

package/README.md

@@ -20,7 +20,7 @@
 
 ### 使用说明
 
-绝大部分API都可以根据 [EasyWeChat 的文档](https://www.easywechat.com/5.x/) 来使用。小部分（如获取请求相关数据、返回响应数据、支付证书等）的操作，由于语言环境的不同，会有不同处理。具体可以查看 [node-easywechat-demo](https://github.com/hpyer/node-easywechat-demo/) 以及下方的[自定义模块说明](#自定义模块模块替换使用方法) 。如果仍有疑问，请提issue，谢谢～
+请参考 [文档](https://hpyer.github.io/node-easywechat/) 来使用。如有需要可以查看 [示例代码](https://github.com/hpyer/node-easywechat-demo/)。如果仍有疑问，请提issue，谢谢～
 
 从 `3.x` 起 SDK 中不再内置具体业务的接口，仅封装底层基础部分，如认证、授权和 API 客户端。至于为什么不再封装业务接口，可以查看 [EasyWeChat 给出说明](https://easywechat.com/6.x/introduction.html#不再封装业务接口)。
 

package/dist/OpenWork/Application.d.ts

@@ -96,6 +96,23 @@ declare class Application implements ApplicationInterface {
      * @returns
      */
     createPreAuthorizationCode(suiteAccessToken?: SuiteAccessToken): Promise<import("../Types/global").WeixinResponse>;
+    /**
+     * 生成授权页地址
+     * @see https://developer.work.weixin.qq.com/document/path/90597#从服务商网站发起
+     * @param callbackUrl 授权后的回调地址
+     * @param pre_auth_code 预授权码，不传则系统自动调用 createPreAuthorizationCode 获取
+     * @param state
+     * @returns
+     */
+    createPreAuthorizationUrl(callbackUrl: string, pre_auth_code?: string, state?: string): Promise<string>;
+    /**
+     * 获取企业永久授权码
+     * @see https://developer.work.weixin.qq.com/document/path/90603
+     * @param authCode 临时授权码
+     * @param suiteAccessToken
+     * @returns
+     */
+    getPermanentCode(authCode: string, suiteAccessToken?: SuiteAccessToken): Promise<import("../Types/global").WeixinResponse>;
     /**
      * 获取企业授权令牌
      * @param corpId

package/dist/OpenWork/Application.js

@@ -211,6 +211,49 @@ class Application {
         }
         return response;
     }
+    /**
+     * 生成授权页地址
+     * @see https://developer.work.weixin.qq.com/document/path/90597#从服务商网站发起
+     * @param callbackUrl 授权后的回调地址
+     * @param pre_auth_code 预授权码，不传则系统自动调用 createPreAuthorizationCode 获取
+     * @param state
+     * @returns
+     */
+    async createPreAuthorizationUrl(callbackUrl, pre_auth_code, state) {
+        let optional = {
+            pre_auth_code,
+            state,
+        };
+        if (!optional['pre_auth_code']) {
+            optional.pre_auth_code = (await this.createPreAuthorizationCode()).pre_auth_code;
+        }
+        let queries = (0, merge_1.default)({
+            suite_id: this.getAccount().getSuiteId(),
+            redirect_uri: callbackUrl,
+        }, optional);
+        return `https://open.work.weixin.qq.com/3rdapp/install?${(0, Utils_1.buildQueryString)(queries)}`;
+    }
+    /**
+     * 获取企业永久授权码
+     * @see https://developer.work.weixin.qq.com/document/path/90603
+     * @param authCode 临时授权码
+     * @param suiteAccessToken
+     * @returns
+     */
+    async getPermanentCode(authCode, suiteAccessToken = null) {
+        if (!suiteAccessToken)
+            suiteAccessToken = this.getSuiteAccessToken();
+        let response = (await this.getClient().request('post', '/cgi-bin/service/get_permanent_code', {
+            params: {
+                auth_code: authCode,
+                suite_access_token: await suiteAccessToken.getToken(),
+            }
+        })).toObject();
+        if (!response['permanent_code']) {
+            throw new Error('Failed to get permanent_code: ' + JSON.stringify(response));
+        }
+        return response;
+    }
     /**
      * 获取企业授权令牌
      * @param corpId

package/package.json

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