apass-opensdk-hugong 1.0.6 → 1.0.7

package/apass/object_.js

@@ -1,69 +1,186 @@
-class Object_{
+class Object_ {
   #hg = null
-  constructor(hg){
+  constructor(hg) {
     this.#hg = hg
   }
 
-  async clearData(table,where){
-    await application.data.object(table).select('_id').where( where ? where : {_id : application.operator.gte(0)}).findStream(async records=>{
+  /**
+   * 清空表中满足条件的数据
+   * @param table  表名
+   * @param where  条件对象；省略时全部清空
+   * @param useSystemAuth 是否使用系统权限；默认 false
+   */
+  async clearData(table, where, useSystemAuth = false) {
+    const object = application.data.object(table).select('_id').where(where ? where : { _id: application.operator.gte(0) })
+    if (useSystemAuth) {
+      object.useSystemAuth()
+    }
+    await object.findStream(async records => {
       this.#hg.log4('clear data len', records.length)
-      await application.data.object(table).batchDelete(records.map(it=>({_id: it._id})))
+      const object = application.data.object(table)
+      if (useSystemAuth) {
+        object.useSystemAuth()
+      }
+      await object.batchDelete(records.map(it => ({ _id: it._id })))
     })
   }
 
-  async findList(table,field,where,callback,orderby){
+  /**
+   * 查询列表
+   * @param table    表名
+   * @param field    需要返回的字段，默认 ['_id','_name']
+   * @param where    过滤条件
+   * @param callback 每批记录回调；提供时方法返回 void
+   * @param orderby  排序字段，默认 '_id'
+   * @param useSystemAuth 是否使用系统权限；默认 false
+   * @returns        无 callback 时返回全部记录
+   */
+  async findList(table, fields, where, callback, orderby, useSystemAuth = false) {
     const list = []
-    await application.data.object(table).select(field || ['_id','_name']).where(where || {_id : application.operator.gte(0)}).orderByDesc(orderby || '_id').findStream(async records=>{
-      if(callback){
+    const object = application.data.object(table).select(fields || ['_id', '_name']).where(where || { _id: application.operator.gte(0) }).orderByDesc(orderby || '_id')
+    if (useSystemAuth) {
+      object.useSystemAuth()
+    }
+    await object.findStream(async records => {
+      if (callback) {
         this.#hg.log4('find all len', records.length)
         await callback(records)
-      }else{
+      } else {
         this.#hg.log4('find all size', records.length)
         list.push(...records)
       }
     })
-    if(!callback){
+    if (!callback) {
       this.#hg.log4('find all len', list.length)
     }
     return list
   }
-  async findOne(table,field,where){
-    return await application.data.object(table).select(field || ['_id','_name']).where(where || {_id : application.operator.gte(0)}).findOne()
+  /**
+   * 查询单条记录
+   * @param table  表名
+   * @param field  需要返回的字段，默认 ['_id','_name']
+   * @param where  过滤条件
+   * @param useSystemAuth 是否使用系统权限；默认 false
+   * @returns      记录对象或 null
+   */
+  async findOne(table, fields, where, useSystemAuth = false) {
+    const object = application.data.object(table).select(fields || ['_id', '_name']).where(where || { _id: application.operator.gte(0) })
+    if (useSystemAuth) {
+      object.useSystemAuth()
+    }
+    return await object.findOne()
   }
-  async findOneById(table,id,field){
-    return await application.data.object(table).select(field || ['_id','_name']).where({_id: id}).findOne()
+  /**
+   * 根据 ID 查询单条记录
+   * @param table  表名
+   * @param id     记录 ID
+   * @param fields 需要返回的字段，默认 ['_id','_name']
+   * @param useSystemAuth 是否使用系统权限；默认 false
+   * @returns      记录对象或 null
+   */
+  async findOneById(table, id, fields, useSystemAuth = false) {
+    const object = application.data.object(table).select(fields || ['_id', '_name']).where({ _id: id })
+    if (useSystemAuth) {
+      object.useSystemAuth()
+    }
+    return await object.findOne()
   }
 
-  async batchCreate(table,list){
-    if(list.length){
-      return await application.data.object(table).useSystemAuth().batchCreate(list)
+  /**
+   * 批量创建记录
+   * @param table  表名
+   * @param list   记录列表
+   * @param useSystemAuth 是否使用系统权限；默认 false
+   * @returns      创建的记录 ID 列表或 null
+   */
+  async batchCreate(table, list, useSystemAuth = false) {
+    if (list.length) {
+      const object = application.data.object(table)
+      if (useSystemAuth) {
+        object.useSystemAuth()
+      }
+      return await object.batchCreate(list)
     }
     return null
   }
-  async create(table,data){
-    return await application.data.object(table).useSystemAuth().create(data)
+  /**
+   * 创建单条记录
+   * @param table  表名
+   * @param data   记录数据
+   * @param useSystemAuth 是否使用系统权限；默认 false
+   * @returns      创建的记录 ID 或 null
+   */
+  async create(table, data, useSystemAuth = false) {
+    const object = application.data.object(table)
+    if (useSystemAuth) {
+      object.useSystemAuth()
+    }
+    return await object.create(data)
   }
 
-  async batchUpdate(table,list){
-    if(list.length){
-      return application.data.object(table).useSystemAuth().batchUpdate(list)
+  /**
+   * 批量更新记录
+   * @param table  表名
+   * @param list   记录列表
+   * @param useSystemAuth 是否使用系统权限；默认 false
+   * @returns      更新的记录 ID 列表或 null
+   */
+  async batchUpdate(table, list, useSystemAuth = false) {
+    if (list.length) {
+      const object = application.data.object(table)
+      if (useSystemAuth) {
+        object.useSystemAuth()
+      }
+      return await object.batchUpdate(list)
     }
     return null
   }
-  async update(table,data){
-    return application.data.object(table).useSystemAuth().update(data)
+  /**
+   * 更新单条记录
+   * @param table  表名
+   * @param data   记录数据
+   * @param useSystemAuth 是否使用系统权限；默认 false
+   * @returns      更新的记录 ID 或 null
+   */
+  async update(table, data, useSystemAuth = false) {
+    const object = application.data.object(table)
+    if (useSystemAuth) {
+      object.useSystemAuth()
+    }
+    return await object.update(data)
   }
-
-  async delete(table,_id){
-    return application.data.object(table).useSystemAuth().delete(_id)
+  /**
+   * 删除单条记录
+   * @param table  表名
+   * @param _id    记录 ID
+   * @param useSystemAuth 是否使用系统权限；默认 false
+   * @returns      删除的记录 ID 或 null
+   */
+  async deleteOne(table, _id, useSystemAuth = false) {
+    const object = application.data.object(table)
+    if (useSystemAuth) {
+      object.useSystemAuth()
+    }
+    return await object.delete(_id)
   }
-  async delete(table,_ids){
-    if(_ids.length){
-      return application.data.object(table).useSystemAuth().batchDelete(_ids)
+  /**
+   * 批量删除记录
+   * @param table  表名
+   * @param _ids   记录 ID 列表
+   * @param useSystemAuth 是否使用系统权限；默认 false
+   * @returns      删除的记录 ID 列表或 null
+   */
+  async deleteBatchByIds(table, _ids, useSystemAuth = false) {
+    if (_ids.length) {
+      const object = application.data.object(table)
+      if (useSystemAuth) {
+        object.useSystemAuth()
+      }
+      return await object.batchDelete(_ids)
     }
     return null
   }
-  
+
 
 }
 module.exports = Object_

package/index.d.ts

@@ -1,90 +1,79 @@
-// HG.d.ts
-export = HG;
-
-declare class HG {
-  constructor(logger: any);
-
-  /* ── 公开属性 ──────────────────────────── */
-  // users: import('./opensdk/users');
-  // document: import('./opensdk/document');
-  // employee: import('./opensdk/employee');
-  // contract: import('./opensdk/contract');
-  object: import('./apass/object_');
-  utils: import('./utils/index');
-  readonly _time: number | null;
-
-  /* ── 公开方法 ──────────────────────────── */
-  setLogger(logger: any): Promise<void>;
-  initEnvAppId(): Promise<void>;
-  timeRun<T = any>(fn?: () => Promise<T>): Promise<T | null>;
-  sleep(time?: number): Promise<void>;
-
-  newTime(): void;
-  printTime(): void;
-
-  setAppId(app_id: string, app_secret: string): void;
-  getToken(): Promise<string>;
-
-  requestGet(url: string, params?: any, headers?: any): Promise<any>;
-  request(
-    url: string | [string, any],
-    data?: any,
-    headers?: any,
-    method?: string
-  ): Promise<any>;
-
-  paginatedSearchGet(
-    url: string,
-    params?: any,
-    callback?: (items: any[]) => Promise<void> | void
-  ): Promise<any[]>;
-
-  paginatedSearch(
-    url: string,
-    params?: any,
-    data?: any,
-    callback?: (items: any[]) => Promise<void> | void,
-    method?: string
-  ): Promise<any[]>;
-
-  toMultilingual(
-    zh: string | any[],
-    en?: string
-  ): any;
-
-  toText(textArr: Array<{ language_code: number; text: string }>): string;
-
-  toSafeValue<T = any>(
-    obj: Record<string, any> | null | undefined,
-    key: string,
-    defValue?: T
-  ): T;
-
-  listFind<T = any>(
-    list: T[],
-    key: keyof T,
-    target: any,
-    defValue?: T
-  ): T;
-
-  listMap<T = any>(list: T[], key: keyof T): any[];
-
-  textToFloat(textAmount?: string, defValue?: number): number;
-
-  toValue<T = any>(
-    obj: Record<string, any>,
-    path: string,
-    fallback?: T
-  ): T;
-
-  /* ── 日志工具 ──────────────────────────── */
-  log(...args: any[]): void;
-  log4(...args: any[]): void;
-  log8(...args: any[]): void;
-  logm(space: number, ...args: any[]): void;
-  error(...args: any[]): void;
-  warn(...args: any[]): void;
-
-  /* ── 语言转换 ──────────────────────────── */
-  toLanguageByList(list: any[]): any[];
+declare module 'HG' {
+  import { AxiosRequestConfig, AxiosResponse } from 'axios';
+
+  export interface HGLogger {
+    log:   (...args: any[]) => void;
+    error: (...args: any[]) => void;
+    warn:  (...args: any[]) => void;
+  }
+
+  export interface MultilingualData {
+    zh?: string;
+    en?: string;
+  }
+
+  export default class HG {
+    constructor(logger: HGLogger);
+
+    /* 属性 */
+    readonly object: any;   // 对应 new Object_(this)
+    readonly utils: any;     // 对应 new Utils(this)
+    private _time: number | null;
+
+    /* 公有方法 */
+    setLogger(logger: HGLogger): Promise<void>;
+
+    /* 计时相关 */
+    timeRun<T = any>(fn?: () => T | Promise<T>): Promise<T>;
+    newTime(): void;
+    printTime(): void;
+
+    /* 工具方法 */
+    sleep(time?: number): Promise<void>;
+
+    /* 网络请求 */
+    request<T = any>(config: AxiosRequestConfig): Promise<T>;
+    axios<T = any>(config: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+
+    /* 多语言 */
+    toMultilingualByOpenPlatform(
+      zh: string | any[],
+      en?: string
+    ): application.constants.type.Multilingual;
+
+    toTextByMultilingual(
+      textArr: Array<{ language_code: string; text: string }>
+    ): string;
+
+    /* JSON 取值 */
+    toValue<T = any>(
+      obj: any,
+      path: string,
+      defaultValue?: T
+    ): T | undefined;
+
+    /* 数组辅助 */
+    listFind<T = any>(
+      list: T[],
+      key: keyof T,
+      target: any,
+      defValue?: T
+    ): T | undefined;
+
+    listMap<T = any, K extends keyof T = keyof T>(
+      list: T[],
+      key: K
+    ): Array<T[K]>;
+
+    /* 字符串转数字 */
+    textToFloat(textAmount: string | number | null | undefined, defValue?: number): number;
+
+    /* 日志 */
+    log(...arg: any[]): void;
+    log4(...arg: any[]): void;
+    log8(...arg: any[]): void;
+    logm(space: number, ...arg: any[]): void;
+    error(...arg: any[]): void;
+    warn(...arg: any[]): void;
+  }
 }

package/index.js

@@ -1,42 +1,25 @@
-const Users = require('./opensdk/users')
-const Document = require('./opensdk/document')
 const Utils = require('./utils/index')
-const Employee = require('./opensdk/employee')
-const Contract = require('./opensdk/contract')
 const Object_ = require('./apass/object_')
-class HG{
+class HG {
   #logger
-  #app_id
-  #app_secret
-  constructor(logger){
+  constructor(logger) {
     this.setLogger(logger)
-    this.users = new Users(this)
-    this.document = new Document(this)
-    this.employee = new Employee(this)
-    this.contract = new Contract(this)
     this.object = new Object_(this)
-    
     this.utils = new Utils(this)
     this._time = null
   }
-  async setLogger(logger){
+  async setLogger(logger) {
     this.#logger = logger
-    await this.initEnvAppId()
-  }
-  async initEnvAppId(){
-    this.#app_id = await application.globalVar.getVar('app_id')
-    this.#app_secret =await application.globalVar.getVar('app_secret')
-    this.log4(`app_id=${this.#app_id}，app_secret=${this.#app_secret}`)
   }
   /**
    * 运行函数
    * @param {*} fn 
    * @returns 
    */
-  async timeRun(fn){
+  async timeRun(fn) {
     this.newTime()
     let result = null
-    if(fn){
+    if (fn) {
       result = await fn()
     }
     this.printTime()
@@ -47,16 +30,16 @@ class HG{
    * @param {*} time 毫秒
    * @returns 
    */
-  async sleep(time){
-    return new Promise((r)=>setTimeout(()=>{ this.log4(`sleep ${(time || 1000)/1000}s`);r();},time || 1000))
+  async sleep(time) {
+    return new Promise((r) => setTimeout(() => { this.log4(`sleep ${(time || 1000) / 1000}s`); r(); }, time || 1000))
   }
 
   /**
    * 时间计划-记录
    */
-  newTime(){
-    if(this._time){
-      this.log4('#time reset to before',(Date.now() - this._time)/1000, 's')
+  newTime() {
+    if (this._time) {
+      this.log4('#time reset to before', (Date.now() - this._time) / 1000, 's')
     }
     this.log4('#time reset')
     this._time = Date.now()
@@ -64,250 +47,107 @@ class HG{
   /**
    * 时间计划-打印耗时
    */
-  printTime(){
-    if(!this._time){
-      return this.#logger.error('#time Error','The time has not been initialized ')
-    }
-    this.log4('#time',(Date.now() - this._time)/1000, 's')
-  }
-
-  /**
-   * 设置app_id
-   * @param {*} app_id 
-   * @param {*} app_secret 
-   */
-   setAppId(app_id,app_secret){
-    this.#app_id = app_id
-    this.#app_secret = app_secret
-  }
-
-  /**
-   * 开平token
-   * @returns 
-   */
-  async getToken(){
-    if(!this.#app_id){
-      await this.initEnvAppId()
+  printTime() {
+    if (!this._time) {
+      return this.#logger.error('#time Error', 'The time has not been initialized ')
     }
-    const result = await this.request('https://open.feishu.cn/open-apis/auth/v3/app_access_token/internal',{ app_id: this.#app_id, app_secret: this.#app_secret},false)
-    return result.tenant_access_token
-  }
-
-  async requestGet(url, params, headers=true){
-    return this.request([url, params], null, headers, 'GET')
+    this.log4('#time', (Date.now() - this._time) / 1000, 's')
   }
 
   /**
-   * 统一网络请求
-   * @param {*} url 
-   * @param {*} params 
-   * @param {*} data 
-   * @param {*} headers 
-   * @param {*} method 
+   * 统一网络请求(使用axios)
+   * @param {*} config 
    * @returns 
    */
-  async request(url, data, headers = true, method = 'POST'){
-    let newHeaders = { 'Content-Type': 'application/json; charset=utf-8' }
-    if(typeof headers === 'boolean' && headers === true){
-      newHeaders['Authorization'] = `Bearer ${ await this.getToken() }`
-    }else{
-      newHeaders = { ...newHeaders,...(headers || {}) }
-    }
-    this.log4('req =',url,data,newHeaders)
-    let _url = url
-    let params = null
-    if(Array.isArray(url)){
-      _url = url[0]
-      params =  url[1]
-    }
-    return new Promise((r,s)=>{
+  async request(config) {
+    this.log4('req =', config)
+    return new Promise((r, s) => {
       const now = Date.now()
-      axios({ method, params, url: _url, data, headers: newHeaders}).then(response=>{
-        this.log8('resp =',(Date.now() - now) / 1000, 's',response.status, response.statusText,response.data)
+      axios(config).then(response => {
+        this.log8('resp =', (Date.now() - now) / 1000, 's', response.status, response.statusText, response.data)
         r(response.data)
-      }).catch(e=>{
-        console.log(e)
-        this.#logger.error('resp =',(Date.now() - now) / 1000, 's',e.response.data)
-        s(e.response.data)
+      }).catch(err => {
+        this.#logger.error('resp =', (Date.now() - now) / 1000, 's', err.response.data)
+        s(err.response.data)
       })
     })
   }
   /**
-   * 分页返回开放平台数据
-   * @param {*} url 
-   * @param {*} params 
-   * @param {*} callback callback(items) 结果回调（根据总数可能多次调用）- 可选
-   * @returns 如果callback为传递则一次性返回所有的数据
-   */
-  async paginatedSearchGet(url,params,callback){
-    return this.paginatedSearch(url, params, null, callback, 'GET')
-  }
-  /**
-   * 分页返回开放平台数据
-   * @param {*} url 
-   * @param {*} params 
-   * @param {*} data 
-   * @param {*} callback callback(items) 结果回调（根据总数可能多次调用）- 可选
-   * @returns 如果callback为传递则一次性返回所有的数据
+   * 直接调用axios
+   * @param {*} config 
+   * @returns 
    */
-   async paginatedSearch(url,params,data,callback,method='POST'){
-    let list =  []
-    let page_token = null
-    let has_more = false
-    do {
-      const result = await this.request([url, {...(params || {page_size: 100}), page_token}],data,true,method)
-      page_token = result.data.page_token
-      has_more = result.data.has_more
-      if(callback){
-          await callback(result.data.hasOwnProperty('items') ? result.data.items || [] : result.data)
-      }else{
-        if(result.data.hasOwnProperty('items')){
-          list.push(...(result.data.items || []))
-        }else{
-          list.push(result.data)
-        }
-      }
-    } while (has_more);
-    return list
+  axios(config) {
+    return axios(config)
   }
-
   /**
-   * 生成多语言对象
+   * 生成多语言对象(将开放平台返回的多语言对象转换为application.constants.type.Multilingual)
    * @param {*} zh 
    * @param {*} en 
    * @returns 
    */
-  toMultilingual(zh,en){
-    if(Array.isArray(zh)){
-      //开放平台一般返回内容
-      if(zh[0].hasOwnProperty('lang')){
-        const _zh = this.toSafeValue(zh.find(it=>it.lang == 'zh-CN'),'value')
-        const _en = this.toSafeValue(zh.find(it=>it.lang == 'en-US'),'value')
+  toMultilingualByOpenPlatform(zh, en) {
+    if (Array.isArray(zh)) {
+      if (zh[0].hasOwnProperty('lang')) {
+        const _zh = this.toValue(zh.find(it => it.lang == 'zh-CN'), 'value')
+        const _en = this.toValue(zh.find(it => it.lang == 'en-US'), 'value')
         return new application.constants.type.Multilingual({ zh: _zh || _en, en: _en || _zh })
       }
-      if(zh[0].hasOwnProperty('locale')){
-        const _zh = this.toSafeValue(zh.find(it=>it.locale == 'zh_CN' || it.locale == 'zh-CN'),'value')
-        const _en = this.toSafeValue(zh.find(it=>it.locale == 'en_US' || it.locale == 'en-US'),'value')
+      if (zh[0].hasOwnProperty('locale')) {
+        const _zh = this.toValue(zh.find(it => it.locale == 'zh_CN' || it.locale == 'zh-CN'), 'value')
+        const _en = this.toValue(zh.find(it => it.locale == 'en_US' || it.locale == 'en-US'), 'value')
         return new application.constants.type.Multilingual({ zh: _zh || _en, en: _en || _zh })
       }
     }
     return new application.constants.type.Multilingual({ zh: zh || en, en: en || zh })
   }
-
-  toText(textArr){
-    if(!textArr || !textArr.length) return '--'
-    return textArr.find(it=>it.language_code == '2052').text
-  }
-
   /**
-   * 安全的取值
-   * @param {*} obj 
-   * @param {*} key 
-   * @param {*} defValue 
+   * 从多语言对象中获取中文
+   * @param {*} textArr 
    * @returns 
    */
-  toSafeValue(obj,key,defValue){
-    const _obj = obj || {}
-    if(!_obj){
-      return defValue
-    }
-    if(!_obj.hasOwnProperty(key)){
-      return defValue
-    }
-    return _obj[key] || defValue
-  }
-
-  listFind(list,key,target,defValue){
-    return list.find(it=>it[ key ] == target) || defValue
-  }
-  listMap(list,key){
-    return list.map(it=>it[ key ])
-  }
-
-  textToFloat(textAmount,defValue = 0) {
-    return parseFloat((textAmount || '').replace(/,/g, '') || defValue);
+  toTextByMultilingual(textArr) {
+    if (!textArr || !textArr.length) return '--'
+    return textArr.find(it => it.language_code == '2052').text
   }
-
-
   /**
-   * 从JSON中进行取值
+   * 从JSON中根据路径获取值
    * @param {*} obj 
    * @param {*} path 
-   * @param {*} fallback 
+   * @param {*} defaultValue 
    * @returns 
    */
-  toValue(obj, path, fallback = undefined) {  
-    return path.split('.').reduce((acc, key) => acc?.[key], obj) ?? fallback;
+  toValue(obj, path, defaultValue = undefined) {
+    return path.split('.').reduce((acc, key) => acc?.[key], obj) ?? defaultValue;
+  }
+  listFind(list, key, target, defValue) {
+    return list.find(it => it[key] == target) || defValue
+  }
+  listMap(list, key) {
+    return list.map(it => it[key])
+  }
+  textToFloat(textAmount, defValue = 0) {
+    return parseFloat((textAmount || '').replace(/,/g, '') || defValue);
   }
 
-  log(...arg){
+  log(...arg) {
     this.#logger.log(...arg)
   }
-  log4(...arg){
-    this.logm(4,...arg)
+  log4(...arg) {
+    this.logm(4, ...arg)
   }
-  log8(...arg){
-    this.logm(8,...arg)
+  log8(...arg) {
+    this.logm(8, ...arg)
   }
-  logm(space,...arg){
+  logm(space, ...arg) {
     const result = ''.padEnd(space, "-");
-    this.#logger.log(result,...arg)
+    this.#logger.log(result, ...arg)
   }
-  error(...arg){
+  error(...arg) {
     this.#logger.error(...arg)
   }
-  warn(...arg){
+  warn(...arg) {
     this.#logger.warn(...arg)
   }
-
-  toLanguageByList(list){
-    // 定义语言代码映射
-    const languageMap = {
-      1033: "en_us",
-      2052: "zh_cn"
-    };
-    // 递归处理函数
-    const processJson = (data) => {
-      const result = [];
-
-      data.forEach(item => {
-        const newItem = {};
-        for (const key in item) {
-          const value = item[key];
-          if (Array.isArray(value)) {
-            // 如果是数组，处理数组中的每个对象
-            const newList = value.map(entry => {
-              if (entry.language_code in languageMap) {
-                return { [languageMap[entry.language_code]]: entry.text };
-              }
-              return null; // 如果 language_code 不在映射中，则忽略
-            }).filter(Boolean); // 过滤掉 null 值
-            if (newList.length > 0) {
-              newItem[key] = newList.reduce((obj,item)=>({...obj, ...item}),{});
-            }
-          } else if (typeof value === 'object' && value !== null) {
-            // 如果是对象，递归处理
-            const processedValue = processJson([value])[0];
-            //console.log('processedValue',processedValue)
-            if (Object.keys(processedValue).length > 0) {
-              newItem[key] = processedValue;
-            }
-          }else{
-            newItem[key] = value
-          }
-        }
-        if (Object.keys(newItem).length > 0) {
-          result.push(newItem);
-        }
-      });
-      return result;
-    };
-    // 调用处理函数
-    const processedData = processJson(list);
-    return processedData
-  }
-
-
-  
 }
 module.exports = HG

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apass-opensdk-hugong",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "飞书Apass低代码平台-飞书开放平台-相关的接口整合和常用的方法整合",
   "main": "index.js",
   "types": "index.d.ts",

package/readme.md

@@ -1,44 +1,13 @@
 # apass-opensdk-hugong
 ## 简介
-apass-opensdk-hugong 是一个基于apass-opensdk的封装，提供了一些常用的功能
+apass-opensdk-hugong 是一个Nodejs的SDK，提供了一些常用的功能
 - 什么人可以使用这个SDK
-- 从事飞书低代码平台（APASS）开发人员.
+- 从事飞书低代码平台（APASS）开发人员.传统Nodejs开发人员.
 
 ## 安装
 
 ```
 在飞书低代码平台（云函数）依赖管理-右侧-搜索： apass-opensdk-hugong
-
-最近有同学私聊我说Apass无法安装1.0.0以上的包，解决思路： 先安装1.0.0版本，然后打开yarn.lock文件
-====== 找到这一行 =====
-apass-opensdk-hugong@1.0.0:
-  version "1.0.0"
-  resolved "https://registry.npmmirror.com/apass-opensdk-hugong/-/apass-opensdk-hugong-1.0.0.tgz#ef2d0a19e793358784cb764de4b885fd86befd66"
-  integrity sha512-Q8Gpo9v8a/2G43y/Lh2POyDEOcealFuUlGdqGSA9wyfjET4+LWs/PnzK9EB1YZCjQotW7cGO/9a0MiQ6Sgw1LA==
-====== 找到这一行 =====
-
-将版本改为最新的版本号后，然后保存，重写部署即可使用NPM源最新的版本
-修改后的yarn.lock文件如下， 一共三处地方：
-apass-opensdk-hugong@1.0.3:
-  version "1.0.3"
-  resolved "https://registry.npmmirror.com/apass-opensdk-hugong/-/apass-opensdk-hugong-1.0.3.tgz#ef2d0a19e793358784cb764de4b885fd86befd66"
-  integrity sha512-Q8Gpo9v8a/2G43y/Lh2POyDEOcealFuUlGdqGSA9wyfjET4+LWs/PnzK9EB1YZCjQotW7cGO/9a0MiQ6Sgw1LA==
-
-
-======
-package.json
-{
-  "dependencies": {
-    "apass-opensdk-hugong": "1.0.0"
-  }
-}
-//改成
-{
-  "dependencies": {
-    "apass-opensdk-hugong": "1.0.5"
-  }
-}
-部署后刷新页面即可生效
 ```
 
 ## 如何使用
@@ -47,13 +16,14 @@ const Hugong = require('apass-opensdk-hugong');
 初始化（主函数内），函数外不需要入参logger
 const hg = new Hugong(logger)
 
-如果在外部初始化后需要在函数中初始化logger模块
+也可以单独初始化logger模块
 hg.setLogger(logger)
 ```
 ## 常用
 ```
-显示运行时间
+记录时间
 hg.newTime()
+打印运行时间
 hg.printTime()
 
 安全的取值
@@ -78,7 +48,7 @@ await hg.utils.splitArray([...], 10, async (items)=>{ // do something  })
 hg.utils.unique([1,2,3,1,2,3]) // [1,2,3]
 
 ```
-## 文件上传/下载
+## Apass相关，文件上传/下载
 
 ```
 1）从网络下载文件后上传到飞书租户空间，返回上传后的文件信息
@@ -115,73 +85,11 @@ list是excel所有的内容，建议小文件使用(10M以下)，如果是大文
 ```
 对象数据新增多语言对象
 
-生成多语言对象
-hg.toMultilingual([{ lang: 'en-US', value: 'Regular' },{ lang: 'zh-CN', value: '正式' }]) 常用于开放平台返回的多语言数据转换
-hg.toMultilingual(zh,en)
-
-
-
-```
-
-## 飞书人事
-
-搜索员工信息
-
-```
-设置appid和appsecret
-await hg.setAppId('cli_000000000','0000000000000')
-
-/**
-* 搜索员工信息
-* @param {*} params 
-* @param {*} data 
-* @param {*} callback callback(items) 结果回调（根据总数可能多次调用）- 可选
-* @returns 如果callback为传递则一次性返回所有的数据
-*/
-await hg.employee.search(params,data,callback)
-
-// 示例[具体参数请参考开放平台定义](https://open.feishu.cn/document/server-docs/corehr-v1/employee/search)
-await hg.employee.search({ page_size:100,user_id_type:'user_id',},{ /* 要查询的字段 */}, async (items)=>{
-    // do something 假设服务端有300条数据，每次返回100条，会调用3次, 如果希望一次性返回所有数据，callback传null即可
-})
-const list = await hg.employee.search(params,data) //这将一次性返回所有数据
-```
-## 开放平台分页获取所有数据
-
-所有的分页接口都可以使用
+生成多语言对象(将开放平台返回的多语言对象转换为application.constants.type.Multilingual)
+hg.toMultilingualByOpenPlatform([{ lang: 'en-US', value: 'Regular' },{ lang: 'zh-CN', value: '正式' }]) 
+hg.toMultilingualByOpenPlatform(zh,en)
 
 ```
-设置appid和appsecret
-await hg.setAppId('cli_000000000','0000000000000')
-
-/**
-* GET类型接口分页返回开放平台数据
-* @param {*} url 
-* @param {*} params 
-* @param {*} callback callback(items) 结果回调（根据总数可能多次调用）- 可选
-* @returns callback为null，则一次性返回所有的数据
-*/
-hg.paginatedSearchGet(url,params,callback)
-
-/**
-* POST接口分页返回开放平台数据
-* @param {*} url 
-* @param {*} params 
-* @param {*} data 
-* @param {*} callback callback(items) 结果回调（根据总数可能多次调用）- 可选
-* @returns callback为null，则一次性返回所有的数据
-*/
-await hg.paginatedSearch(url,params,data,callback)
-
-示例1
-const list = await hg.paginatedSearchGet(url, params, data)
-示例2
-await hg.paginatedSearchGet(url, params, async (items)=>{
-    // do something  假设服务端有300条数据，每次返回100条，会调用3次, 如果希望一次性返回所有数据，callback传null即可
-})
-```
-
-
 
 ## 交流学习
 

package/utils/index.js

@@ -1,9 +1,9 @@
 const Url = require('./url')
 const File_ = require('./file_')
 const Date_ = require('./date_')
-class Utils{
+class Utils {
   #hg = null
-  constructor(hg){
+  constructor(hg) {
     this.#hg = hg
 
     this.url = new Url(hg)
@@ -18,13 +18,13 @@ class Utils{
    * @param {*} callback(item) 分割后回调(不传递则方法返回切割长度后的数组)
    * @returns 
    */
-   async splitArray(list, chunkSize, callback) {
+  async splitArray(list, chunkSize, callback) {
     const result = [];
     this.#hg.log4('splitArray len ', list.length)
     for (let i = 0; i < list.length; i += chunkSize) {
       const batch = list.slice(i, i + chunkSize)
-      this.#hg.log8('splitArray item ',i, i + chunkSize)
-      if(callback){
+      this.#hg.log8('splitArray item ', i, i + chunkSize)
+      if (callback) {
         await callback(batch)
         continue
       }
@@ -33,7 +33,7 @@ class Utils{
     return result;
   }
 
-  toMD5(data){
+  toMD5(data) {
     const crypto = require('crypto');
     const hash = crypto.createHash('md5');
     hash.update(data);
@@ -50,8 +50,8 @@ class Utils{
    * @param {*} currency 
    * @returns 
    */
-   formatCurrency(amount, locale = 'en-US', currency = 'USD') {  
-    return new Intl.NumberFormat(locale, { style: 'currency',    currency,  }).format(amount);
+  formatCurrency(amount, locale = 'en-US', currency = 'USD') {
+    return new Intl.NumberFormat(locale, { style: 'currency', currency, }).format(amount);
   }
 
   /**
@@ -60,7 +60,7 @@ class Utils{
    * @param {*} size 
    * @returns 
    */
-  chunkAll(arr, size) {  
+  chunkAll(arr, size) {
     return Array.from({ length: Math.ceil(arr.length / size) }, (_, i) => arr.slice(i * size, i * size + size));
   }
 
@@ -72,10 +72,10 @@ class Utils{
    * @param {*} step 
    * @returns 
    */
-  range(start, end, step = 1) {  
+  range(start, end, step = 1) {
     return Array.from({ length: (end - start) / step + 1 }, (_, i) => start + i * step);
   }
-  
+
   /**
    * 移除重复项
    * @param {*} arr 

package/opensdk/contract.js

@@ -1,17 +0,0 @@
-class Contract{
-  #hg = null
-  constructor(hg){
-    this.#hg = hg
-  }
-  
-  /**
-   * 通过手机号或邮箱获取用户 ID
-   * @param {*} user_id_type  user_id、open_id、union_id
-   * @returns 
-   */
-  async batch_get_id(data,user_id_type){
-    return await this.#hg.request(`https://open.feishu.cn/open-apis/contact/v3/users/batch_get_id?user_id_type=${user_id_type || 'open_id'}`,data,true)
-  }
-
-}
-module.exports = Contract

package/opensdk/document.js

@@ -1,46 +0,0 @@
-class Document{
-  #hg = null
-  constructor(hg){
-    this.#hg = hg
-  }
-  /**
-   * 增加协作者权限 https://open.feishu.cn/document/server-docs/docs/permission/permission-member/create 
-   * @param {*} app_token app_token 多维表格 App 的唯一标识
-   * @param {*} type 文件类型 bitable：多维表格
-   * @param {*} data {
-        "member_type": "openchat",
-        "member_id": "oc_b962e8debdc37712a1d60bb97087a8e8",
-        "perm": "edit",
-        "perm_type": "container",
-        "type": "chat"
-      }
-   */
-  async permissions(app_token,type,data){
-    if(!type){ 
-      throw 'type is not empty'
-    }
-    return await this.#hg.request(`https://open.feishu.cn/open-apis/drive/v1/permissions/${app_token}/members?type=${type}&need_notification=false`,data,true)
-  }
-  /**
-   * 复制多维表格 https://open.feishu.cn/document/server-docs/docs/bitable-v1/app/copy
-   * @param {*} app_token 要复制的多维表格 App 的唯一标识
-   * @param {*} name 多维表格 App 名称。最长为 255 个字符
-   * @param {*} folder_token 文件夹
-   * @returns 
-   */
-  async copy(app_token,name,folder_token,without_content,time_zone){
-    return await this.#hg.request(`https://open.feishu.cn/open-apis/bitable/v1/apps/${app_token}/copy`,{ name,folder_token,without_content: without_content || false,time_zone: time_zone || 'Asia/Shanghai' },true)
-  }
-  /**
-   * 创建多维表格 https://open.feishu.cn/document/server-docs/docs/bitable-v1/app/create
-   * @param {*} name 多维表格 App 名称
-   * @param {*} folder_token 多维表格 App 归属文件夹
-   * @param {*} time_zone 
-   * @returns 
-   */
-  async create(name, folder_token, time_zone){
-    return await this.#hg.request('https://open.feishu.cn/open-apis/bitable/v1/apps',{ name, folder_token, time_zone: time_zone || 'Asia/Shanghai' },true)
-  }
-
-}
-module.exports = Document

package/opensdk/employee.js

@@ -1,34 +0,0 @@
-class Employee{
-  #hg = null
-  constructor(hg){
-    this.#hg = hg
-  }
-  
-  /**
-   * 搜索员工信息
-   * @param {*} params 
-   * @param {*} data 
-   * @param {*} callback(items) 结果回调（根据总数可能多次调用）
-   */
-  async search(params,data,callback){
-    return await this.#hg.paginatedSearch(`https://open.feishu.cn/open-apis/corehr/v2/employees/search`,params,data,callback)
-  }
-
-  /**
-   * 批量查询员工薪资档案
-   * @param {*} _id 
-   * @param {*} user_id 
-   */
-   async archives_query(effective_start_date,effective_end_date,user_id_list,user_id_type){
-    return await this.#hg.paginatedSearch(`https://open.feishu.cn/open-apis/compensation/v1/archives/query`, {
-      page_size, 
-      user_id_type: 'people_corehr_id',
-    },{
-      user_id_list,
-      effective_start_date,
-      effective_end_date,
-    })
-  }
-
-}
-module.exports = Employee

package/opensdk/users.js

@@ -1,17 +0,0 @@
-class Users{
-  #hg = null
-  constructor(hg){
-    this.#hg = hg
-  }
-  
-  /**
-   * 通过手机号或邮箱获取用户 ID
-   * @param {*} user_id_type  user_id、open_id、union_id
-   * @returns 
-   */
-  async batch_get_id(data,user_id_type){
-    return await this.#hg.request(`https://open.feishu.cn/open-apis/contact/v3/users/batch_get_id?user_id_type=${user_id_type || 'open_id'}`,data,true)
-  }
-
-}
-module.exports = Users