@jiexiaoyin/wecom-api 0.0.2

package/src/modules/disk/index.js

@@ -0,0 +1,245 @@
+/**
+ * 微盘管理模块
+ * API 章节：十八
+ */
+
+const WeComSDK = require('../../sdk');
+const fs = require('fs');
+const path = require('path');
+
+class Disk extends WeComSDK {
+  constructor(config) {
+    super(config);
+  }
+
+  // ========== 空间管理 ==========
+
+  /**
+   * 新建空间
+   * @param {string} spaceName 空间名称
+   * @param {string} spaceOwner 空间负责人 userid
+   * @param {number} spaceType 空间类型: 0-企业空间 1-公共空间 2-共享空间
+   */
+  async createSpace(spaceName, spaceOwner, spaceType = 0) {
+    return this.post('/disk/create_space', {
+      space_name: spaceName,
+      space_owner: spaceOwner,
+      space_type: spaceType
+    });
+  }
+
+  /**
+   * 重命名空间
+   * @param {string} spaceId 空间 id
+   * @param {string} newName 新名称
+   */
+  async renameSpace(spaceId, newName) {
+    return this.post('/disk/rename_space', { spaceid: spaceId, new_name: newName });
+  }
+
+  /**
+   * 解散空间
+   * @param {string} spaceId 空间 id
+   */
+  async deleteSpace(spaceId) {
+    return this.post('/disk/delete_space', { spaceid: spaceId });
+  }
+
+  /**
+   * 获取空间信息
+   * @param {string} spaceId 空间 id
+   */
+  async getSpaceInfo(spaceId) {
+    return this.post('/disk/get_space_info', { spaceid: spaceId });
+  }
+
+  // ========== 空间权限管理 ==========
+
+  /**
+   * 添加成员/部门
+   * @param {string} spaceId 空间 id
+   * @param {string} type 成员类型: 1-成员 2-部门
+   * @param {string} id 成员或部门 id
+   * @param {number} permission 权限: 1-可查看 2-可编辑
+   */
+  async addSpaceMember(spaceId, type, id, permission = 1) {
+    return this.post('/disk/add_space_member', {
+      spaceid: spaceId,
+      type,
+      id,
+      permission
+    });
+  }
+
+  /**
+   * 移除成员/部门
+   * @param {string} spaceId 空间 id
+   * @param {string} type 成员类型: 1-成员 2-部门
+   * @param {string} id 成员或部门 id
+   */
+  async removeSpaceMember(spaceId, type, id) {
+    return this.post('/disk/remove_space_member', { spaceid: spaceId, type, id });
+  }
+
+  /**
+   * 获取邀请链接
+   * @param {string} spaceId 空间 id
+   */
+  async getShareLink(spaceId) {
+    return this.post('/disk/get_share_link', { spaceid: spaceId });
+  }
+
+  // ========== 文件管理 ==========
+
+  /**
+   * 获取文件列表
+   * @param {string} spaceId 空间 id
+   * @param {string} folderId 文件夹 id
+   * @param {number} start 分页起始位置
+   * @param {number} limit 每页数量
+   */
+  async getFileList(spaceId, folderId, start = 0, limit = 100) {
+    return this.post('/disk/get_file_list', {
+      spaceid: spaceId,
+      folder_id: folderId,
+      start,
+      limit
+    });
+  }
+
+  /**
+   * 上传文件
+   * @param {string} spaceId 空间 id
+   * @param {string} folderId 上级文件夹 id
+   * @param {string} fileName 文件名
+   * @param {string} filePath 本地文件路径
+   */
+  async uploadFile(spaceId, folderId, fileName, filePath) {
+    const token = await this.getAccessToken();
+    const url = `${this.baseUrl}/disk/upload_file?access_token=${token}`;
+
+    const FormData = require('form-data');
+    const form = new FormData();
+    form.append('spaceid', spaceId);
+    form.append('folder_id', folderId);
+    form.append('file_name', fileName);
+    form.append('file', fs.createReadStream(filePath));
+
+    const response = await axios.post(url, form, {
+      headers: form.getHeaders()
+    });
+
+    if (response.data.errcode !== 0) {
+      throw new Error(`上传文件失败: ${response.data.errmsg}`);
+    }
+    return response.data;
+  }
+
+  /**
+   * 下载文件
+   * @param {string} fileId 文件 id
+   * @param {string} savePath 保存路径
+   */
+  async downloadFile(fileId, savePath) {
+    const token = await this.getAccessToken();
+    const url = `${this.baseUrl}/disk/download_file?access_token=${token}`;
+
+    const response = await axios.post(url, { fileid: fileId }, {
+      responseType: 'arraybuffer'
+    });
+
+    fs.writeFileSync(savePath, response.data);
+    return { savePath };
+  }
+
+  /**
+   * 新建文件夹
+   * @param {string} spaceId 空间 id
+   * @param {string} parentFolderId 上级文件夹 id
+   * @param {string} folderName 文件夹名
+   */
+  async createFolder(spaceId, parentFolderId, folderName) {
+    return this.post('/disk/create_folder', {
+      spaceid: spaceId,
+      parent_folder_id: parentFolderId,
+      folder_name: folderName
+    });
+  }
+
+  /**
+   * 重命名文件
+   * @param {string} fileId 文件 id
+   * @param {string} newName 新名称
+   */
+  async renameFile(fileId, newName) {
+    return this.post('/disk/rename_file', { fileid: fileId, new_name: newName });
+  }
+
+  /**
+   * 移动文件
+   * @param {string} fileId 文件 id
+   * @param {string} spaceId 目标空间 id
+   * @param {string} targetFolderId 目标文件夹 id
+   */
+  async moveFile(fileId, spaceId, targetFolderId) {
+    return this.post('/disk/move_file', {
+      fileid: fileId,
+      spaceid: spaceId,
+      target_folder_id: targetFolderId
+    });
+  }
+
+  /**
+   * 删除文件
+   * @param {string} fileId 文件 id
+   */
+  async deleteFile(fileId) {
+    return this.post('/disk/delete_file', { fileid: fileId });
+  }
+
+  /**
+   * 获取文件信息
+   * @param {string} fileId 文件 id
+   */
+  async getFileInfo(fileId) {
+    return this.post('/disk/get_file_info', { fileid: fileId });
+  }
+
+  // ========== 文件权限管理 ==========
+
+  /**
+   * 新增成员
+   * @param {string} fileId 文件 id
+   * @param {string} type 成员类型: 1-成员 2-部门
+   * @param {string} id 成员或部门 id
+   * @param {number} permission 权限: 1-可查看 2-可编辑
+   */
+  async addFileMember(fileId, type, id, permission = 1) {
+    return this.post('/disk/add_file_member', {
+      fileid: fileId,
+      type,
+      id,
+      permission
+    });
+  }
+
+  /**
+   * 删除成员
+   * @param {string} fileId 文件 id
+   * @param {string} type 成员类型: 1-成员 2-部门
+   * @param {string} id 成员或部门 id
+   */
+  async removeFileMember(fileId, type, id) {
+    return this.post('/disk/remove_file_member', { fileid: fileId, type, id });
+  }
+
+  /**
+   * 获取文件权限信息
+   * @param {string} fileId 文件 id
+   */
+  async getFilePermission(fileId) {
+    return this.post('/disk/get_file_permission', { fileid: fileId });
+  }
+}
+
+module.exports = Disk;

package/src/modules/document/index.js

@@ -0,0 +1,282 @@
+/**
+ * 文档管理模块
+ * API 章节：十五 - 文档
+ * 包含：文档管理、收集表、素材管理
+ */
+
+const WeComSDK = require('../../sdk');
+
+class Document extends WeComSDK {
+  constructor(config) {
+    super(config);
+  }
+
+  // ========== 文档管理 ==========
+
+  /**
+   * 创建文档
+   * @param {string} spaceId 空间 ID
+   * @param {string} folderId 文件夹 ID
+   * @param {string} title 文档标题
+   * @param {string} docType 文档类型: doc, sheet, mindmap, docx, ppt, bitable
+   */
+  async createDocument(spaceId, folderId, title, docType = 'doc') {
+    return this.post('/doc/create', {
+      spaceid: spaceId,
+      folderid: folderId,
+      title,
+      doc_type: docType
+    });
+  }
+
+  /**
+   * 重命名文档
+   * @param {string} spaceId 空间 ID
+   * @param {string} objId 文档或文件夹 ID
+   * @param {string} title 新标题
+   */
+  async renameDocument(spaceId, objId, title) {
+    return this.post('/doc/rename', {
+      spaceid: spaceId,
+      obj_id: objId,
+      title
+    });
+  }
+
+  /**
+   * 删除文档
+   * @param {string} spaceId 空间 ID
+   * @param {string} objId 文档或文件夹 ID
+   */
+  async deleteDocument(spaceId, objId) {
+    return this.post('/doc/delete', {
+      spaceid: spaceId,
+      obj_id: objId
+    });
+  }
+
+  /**
+   * 获取文档信息
+   * @param {string} spaceId 空间 ID
+   * @param {string} objId 文档 ID
+   */
+  async getDocumentInfo(spaceId, objId) {
+    return this.post('/doc/get', {
+      spaceid: spaceId,
+      obj_id: objId
+    });
+  }
+
+  /**
+   * 获取文档权限信息
+   * @param {string} spaceId 空间 ID
+   * @param {string} objId 文档或文件夹 ID
+   */
+  async getDocumentAuth(spaceId, objId) {
+    return this.post('/doc/get_auth', {
+      spaceid: spaceId,
+      obj_id: objId
+    });
+  }
+
+  /**
+   * 修改文档安全设置
+   * @param {string} spaceId 空间 ID
+   * @param {string} objId 文档 ID
+   * @param {object} security 安全设置
+   */
+  async updateDocumentSecurity(spaceId, objId, security) {
+    return this.post('/doc/set_security', {
+      spaceid: spaceId,
+      obj_id: objId,
+      security
+    });
+  }
+
+  // ========== 管理收集表 ==========
+
+  /**
+   * 创建收集表
+   * @param {string} spaceId 空间 ID
+   * @param {string} title 收集表标题
+   * @param {string} description 描述
+   * @param {object[]} questions 问题列表
+   */
+  async createSurvey(spaceId, title, description = '', questions = []) {
+    return this.post('/doc/survey/create', {
+      spaceid: spaceId,
+      title,
+      description,
+      questions
+    });
+  }
+
+  /**
+   * 编辑收集表
+   * @param {string} surveyId 收集表 ID
+   * @param {object} params 更新参数
+   */
+  async updateSurvey(surveyId, { title, description, questions, status }) {
+    return this.post('/doc/survey/update', {
+      survey_id: surveyId,
+      title,
+      description,
+      questions,
+      status
+    });
+  }
+
+  /**
+   * 获取收集表信息
+   * @param {string} surveyId 收集表 ID
+   */
+  async getSurveyInfo(surveyId) {
+    return this.post('/doc/survey/get', { survey_id: surveyId });
+  }
+
+  /**
+   * 获取收集表的统计信息
+   * @param {string} surveyId 收集表 ID
+   */
+  async getSurveyStats(surveyId) {
+    return this.post('/doc/survey/stats', { survey_id: surveyId });
+  }
+
+  /**
+   * 读取收集表答案
+   * @param {string} surveyId 收集表 ID
+   * @param {string} token 答案 token
+   */
+  async getSurveyAnswer(surveyId, token) {
+    return this.post('/doc/survey/get_answer', {
+      survey_id: surveyId,
+      token
+    });
+  }
+
+  /**
+   * 获取收集表答案列表
+   * @param {string} surveyId 收集表 ID
+   * @param {number} offset 偏移量
+   * @param {number} size 每页数量
+   */
+  async listSurveyAnswers(surveyId, offset = 0, size = 100) {
+    return this.post('/doc/survey/list_answer', {
+      survey_id: surveyId,
+      offset,
+      limit: size
+    });
+  }
+
+  // ========== 接收外部数据到智能表格 ==========
+
+  /**
+   * 添加记录
+   * @param {string} spaceId 空间 ID
+   * @param {string} tableId 表格 ID
+   * @param {object[]} records 记录列表
+   */
+  async addBitableRecords(spaceId, tableId, records) {
+    return this.post('/doc/bitable/record/add', {
+      spaceid: spaceId,
+      table_id: tableId,
+      records
+    });
+  }
+
+  /**
+   * 更新记录
+   * @param {string} spaceId 空间 ID
+   * @param {string} tableId 表格 ID
+   * @param {object[]} records 记录列表
+   */
+  async updateBitableRecords(spaceId, tableId, records) {
+    return this.post('/doc/bitable/record/update', {
+      spaceid: spaceId,
+      table_id: tableId,
+      records
+    });
+  }
+
+  /**
+   * 删除记录
+   * @param {string} spaceId 空间 ID
+   * @param {string} tableId 表格 ID
+   * @param {string[]} recordIds 记录 ID 列表
+   */
+  async deleteBitableRecords(spaceId, tableId, recordIds) {
+    return this.post('/doc/bitable/record/delete', {
+      spaceid: spaceId,
+      table_id: tableId,
+      record_ids: recordIds
+    });
+  }
+
+  // ========== 素材管理 ==========
+
+  /**
+   * 上传文档图片
+   * @param {string} spaceId 空间 ID
+   * @param {string} filePath 文件路径
+   */
+  async uploadDocImage(spaceId, filePath) {
+    const fs = require('fs');
+    if (!fs.existsSync(filePath)) {
+      throw new Error(`File not found: ${filePath}`);
+    }
+
+    const fileName = require('path').basename(filePath);
+    const fileBuffer = fs.readFileSync(filePath);
+
+    const formData = {
+      media: {
+        value: fileBuffer,
+        options: {
+          filename: fileName,
+          contentType: 'image/jpeg'
+        }
+      }
+    };
+
+    return this.post('/doc/media/upload_image', { media: formData }, {
+      spaceid: spaceId,
+      apiType: 'upload'
+    });
+  }
+
+  // ========== 高级功能账号管理 ==========
+
+  /**
+   * 分配高级功能账号
+   * @param {string} userId 成员 userid
+   * @param {string} type 高级功能类型
+   */
+  async assignAdvancedAccount(userId, type) {
+    return this.post('/doc/advanced_account/assign', {
+      userid: userId,
+      type
+    });
+  }
+
+  /**
+   * 取消高级功能账号
+   * @param {string} userId 成员 userid
+   * @param {string} type 高级功能类型
+   */
+  async cancelAdvancedAccount(userId, type) {
+    return this.post('/doc/advanced_account/cancel', {
+      userid: userId,
+      type
+    });
+  }
+
+  /**
+   * 获取高级功能账号列表
+   * @param {string} type 高级功能类型
+   */
+  async getAdvancedAccountList(type) {
+    return this.post('/doc/advanced_account/list', { type });
+  }
+}
+
+module.exports = Document;

package/src/modules/hr/index.js

@@ -0,0 +1,93 @@
+/**
+ * 人事助手模块
+ * API 章节：二十四 - 人事助手
+ * 包含：花名册管理
+ */
+
+const WeComSDK = require('../../sdk');
+
+class HR extends WeComSDK {
+  constructor(config) {
+    super(config);
+  }
+
+  // ========== 花名册 ==========
+
+  /**
+   * 获取员工字段配置
+   * @param {number} fieldType 字段类型: 1-系统字段 2-自定义字段
+   */
+  async getUserFields(fieldType = 1) {
+    return this.post('/hr/getuserfieldconfig', { field_type: fieldType });
+  }
+
+  /**
+   * 获取员工花名册信息
+   * @param {string} userId 员工 userid
+   * @param {string[]} fieldIds 字段 ID 列表
+   */
+  async getUserProfile(userId, fieldIds = []) {
+    return this.post('/hr/getuserprofile', {
+      userid: userId,
+      field_ids: fieldIds
+    });
+  }
+
+  /**
+   * 批量获取员工花名册信息
+   * @param {string[]} userIds 员工 userid 列表
+   * @param {string[]} fieldIds 字段 ID 列表
+   */
+  async batchGetUserProfiles(userIds, fieldIds = []) {
+    return this.post('/hr/batchgetuserprofile', {
+      userids: userIds,
+      field_ids: fieldIds
+    });
+  }
+
+  /**
+   * 更新员工花名册信息
+   * @param {string} userId 员工 userid
+   * @param {object} fieldData 字段数据
+   */
+  async updateUserProfile(userId, fieldData) {
+    return this.post('/hr/updateuserprofile', {
+      userid: userId,
+      field_data: fieldData
+    });
+  }
+
+  // ========== 员工入职管理 ==========
+
+  /**
+   * 获取入职登记表 ID
+   * @param {string} groupId 登记表模板组 ID
+   */
+  async getRegisterId(groupId) {
+    return this.post('/hr/get_register_id', { group_id: groupId });
+  }
+
+  /**
+   * 获取员工登记信息
+   * @param {string} registerId 登记表 ID
+   * @param {string} userId 员工 userid
+   */
+  async getRegisterInfo(registerId, userId) {
+    return this.post('/hr/get_register_info', {
+      register_id: registerId,
+      userid: userId
+    });
+  }
+
+  // ========== 员工离职管理 ==========
+
+  /**
+   * 获取离职交接人员列表
+   * @param {string} userId 离职员工 userid
+   */
+  async getDimissionHandoverList(userId) {
+    return this.post('/hr/get_dimission_handover_list', { userid: userId });
+  }
+}
+
+module.exports = HR;