@jiexiaoyin/wecom-api 0.0.2

package/src/modules/approval/index.js

@@ -0,0 +1,146 @@
+/**
+ * 审批管理模块
+ * API 章节：二十二
+ */
+
+const WeComSDK = require('../../sdk');
+
+class Approval extends WeComSDK {
+  constructor(config) {
+    super(config);
+  }
+
+  /**
+   * 获取审批模板详情
+   * @param {string} templateId 模板 ID
+   */
+  async getTemplateDetail(templateId) {
+    return this.post('/approval/get_template_detail', { template_id: templateId });
+  }
+
+  /**
+   * 提交审批申请
+   * @param {object} params 审批参数
+   */
+  async submitApproval(params) {
+    const { templateId, creator, useTemplate_approver, approver, content } = params;
+    return this.post('/approval/start', {
+      template_id: templateId,
+      creator,
+      use_template_approver: useTemplate_approver || 0,
+      approver,
+      content
+    });
+  }
+
+  /**
+   * 批量获取审批单号（正确路径：/oa/getapprovalinfo）
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   * @param {string} cursor 分页游标
+   * @param {number} size 每页数量
+   */
+  async getApprovalIds(startTime, endTime, cursor = '', size = 100) {
+    return this.post('/oa/getapprovalinfo', {
+      starttime: startTime,
+      endtime: endTime,
+      cursor: cursor,
+      limit: size
+    });
+  }
+
+  /**
+   * 获取审批申请详情（正确路径：/oa/getapprovaldetail）
+   * @param {string} spNo 审批单号
+   */
+  async getApprovalDetail(spNo) {
+    return this.post('/oa/getapprovaldetail', { sp_no: spNo });
+  }
+
+  /**
+   * 获取企业假期管理配置
+   */
+  async getLeaveConfig() {
+    return this.post('/approval/getcorpconf', {});
+  }
+
+  /**
+   * 获取成员假期余额
+   * @param {string} userId 成员 userid
+   */
+  async getLeaveBalance(userId) {
+    return this.post('/approval/get_balances', { userid: userId });
+  }
+
+  /**
+   * 修改成员假期余额
+   * @param {string} userId 成员 userid
+   * @param {string} leaveType 假期类型
+   * @param {number} balance 假期时长（天数）
+   */
+  async updateLeaveBalance(userId, leaveType, balance) {
+    return this.post('/approval/set_balances', {
+      userid: userId,
+      leave_type: leaveType,
+      balance
+    });
+  }
+
+  /**
+   * 创建审批模板
+   * @param {object} params 模板参数
+   */
+  async createTemplate(params) {
+    return this.post('/approval/template/create', params);
+  }
+
+  /**
+   * 更新审批模板
+   * @param {string} templateId 模板 ID
+   * @param {object} params 更新参数
+   */
+  async updateTemplate(templateId, params) {
+    return this.post('/approval/template/update', {
+      template_id: templateId,
+      ...params
+    });
+  }
+
+  /**
+   * 获取审批流程引擎配置
+   * @param {string} templateId 模板 ID
+   */
+  async getApprovalProcess(templateId) {
+    return this.post('/approval/get_process', { template_id: templateId });
+  }
+
+  /**
+   * 设置审批流程
+   * @param {string} templateId 模板 ID
+   * @param {object} process 流程配置
+   */
+  async setApprovalProcess(templateId, process) {
+    return this.post('/approval/set_process', {
+      template_id: templateId,
+      process
+    });
+  }
+
+  /**
+   * 审批单回调通知（通过回调模块处理，此处仅提供查询）
+   * @param {number} startTime 开始时间戳
+   * @param {number} endTime 结束时间戳
+   * @param {string} cursor 分页游标
+   * @param {number} size 每页数量
+   */
+  async getApprovalCallbackList(startTime, endTime, cursor = '', size = 100) {
+    return this.post('/approval/callback_list', {
+      starttime: startTime,
+      endtime: endTime,
+      cursor,
+      limit: size
+    });
+  }
+}
+
+module.exports = Approval;

package/src/modules/auth/index.js

@@ -0,0 +1,103 @@
+/**
+ * 身份验证模块
+ * API 章节：四 - 身份验证
+ * 包含：网页授权登录、企业微信 Web 登录、二次验证
+ */
+
+const WeComSDK = require('../../sdk');
+
+class Auth extends WeComSDK {
+  constructor(config) {
+    super(config);
+    this.redirectUri = config.redirectUri || '';
+  }
+
+  // ========== 网页授权登录 ==========
+
+  /**
+   * 构造网页授权链接
+   * @param {string} redirectUri 授权回调地址
+   * @param {string} state 自定义状态
+   * @param {string} scope 授权作用域: snsapi_base 或 snsapi_userinfo
+   */
+  getWebAuthUrl(redirectUri, state = '', scope = 'snsapi_userinfo') {
+    const encodedUri = encodeURIComponent(redirectUri);
+    return `https://open.work.weixin.qq.com/wwopen/sso/qrConnect?appid=${this.corpId}&agentid=${this.agentId}&redirect_uri=${encodedUri}&state=${state}&scope=${scope}`;
+  }
+
+  /**
+   * 获取访问用户身份（用户同意授权后获取）
+   * @param {string} code 授权 code
+   */
+  async getUserInfo(code) {
+    return this.get('/user/getuserinfo', { code });
+  }
+
+  /**
+   * 获取访问用户敏感信息
+   * @param {string} code 授权 code
+   */
+  async getUserDetail(code) {
+    return this.post('/user/getuserdetail', { code });
+  }
+
+  // ========== 企业微信 Web 登录 ==========
+
+  /**
+   * 获取用户登录身份（Web 登录）
+   * @param {string} code 登录 code
+   */
+  async getWebLoginUserInfo(code) {
+    return this.post('/user/get_login_info', { code });
+  }
+
+  // ========== 二次验证 ==========
+
+  /**
+   * 获取用户二次验证信息
+   * @param {string} userId 用户 ID
+   */
+  async getSecondVerifyInfo(userId) {
+    return this.post('/user/get_second_verification_info', { userid: userId });
+  }
+
+  /**
+   * 登录二次验证
+   * @param {string} userId 用户 ID
+   * @param {string} verificationCode 验证码
+   */
+  async secondVerify(userId, verificationCode) {
+    return this.post('/user/second_verification', {
+      userid: userId,
+      verification_code: verificationCode
+    });
+  }
+
+  /**
+   * 使用二次验证
+   * @param {string} userId 用户 ID
+   */
+  async applySecondVerify(userId) {
+    return this.post('/user/apply_second_verification', { userid: userId });
+  }
+
+  // ========== 登录辅助方法 ==========
+
+  /**
+   * 通过 code 获取用户 ID
+   * @param {string} code 授权 code
+   */
+  async getUserIdByCode(code) {
+    try {
+      const result = await this.getUserInfo(code);
+      if (result.ErrCode === 0) {
+        return result.UserId;
+      }
+      return null;
+    } catch (e) {
+      return null;
+    }
+  }
+}
+
+module.exports = Auth;