mobx-lark 2.8.1 → 2.10.0

package/src/module/DocumentAI/type.ts

@@ -1,3 +1,5 @@
+import { Gender } from '../User/type';
+
 export type InvoiceEntityType =
     | `invoice_${'code' | 'no' | 'special_seal'}`
     | `seller_${'name' | 'taxpayer_no'}_in_seal`;
@@ -67,3 +69,189 @@ export interface VehicleInvoice {
         | `total_price${'' | '_little'}`;
     value: string;
 }
+
+export interface BankCardEntity {
+    type: 'card_number' | 'date_of_expiry';
+    value: string;
+}
+
+export interface IDCardEntity {
+    type:
+        | `identity_${'code' | 'name'}`
+        | 'birth'
+        | 'gender'
+        | 'race'
+        | 'address'
+        | 'issued_by'
+        | `valid_date_${'start' | 'end'}`;
+    value: string;
+}
+
+export enum IDCardSide {
+    Cover = 0,
+    Profile = 1
+}
+
+export interface IDCard {
+    entities: IDCardEntity[];
+    side: IDCardSide;
+    corners: number[];
+}
+
+export interface BusinessCardEntity {
+    type:
+        | `${'contact' | 'company'}_names`
+        | 'departments'
+        | 'job_titles'
+        | 'emails'
+        | 'websites'
+        | 'addresses'
+        | `${'mobile' | 'work' | 'other'}_phones`
+        | 'faxes';
+    value: string;
+}
+
+export interface BusinessCard {
+    entities: BusinessCardEntity[];
+}
+
+export interface BusinessLicenseEntity {
+    type:
+        | 'certificate_type'
+        | 'unified_social_credit_code'
+        | `company_${'name' | 'type'}`
+        | 'domicile'
+        | 'legal_representative'
+        | 'registered_capital'
+        | `established_${'time' | 'date'}` // 成立日期、营业期限
+        | 'business_scope'
+        | 'approval_date'
+        | 'website';
+    value: string;
+}
+
+export interface BusinessLicense {
+    entities: BusinessLicenseEntity[];
+}
+
+export type ResumePeriod = Record<`${'start' | 'end'}_${'date' | 'time'}`, string>;
+
+export enum EducationQualification {
+    PrimarySchool = 1,
+    JuniorHighSchool = 2,
+    VocationalHighSchool = 3,
+    HighSchool = 4,
+    AssociateDegree = 5,
+    BachelorDegree = 6,
+    MasterDegree = 7,
+    Doctorate = 8,
+    Other = 9
+}
+
+export interface ResumeEducation
+    extends ResumePeriod, Record<'school' | 'major' | 'degree', string> {
+    qualification: EducationQualification;
+}
+
+export enum CareerType {
+    Internship = 1,
+    FullTime = 2
+}
+
+export interface ResumeCareer
+    extends ResumePeriod, Record<'company' | 'title' | 'type_str' | 'job_description', string> {
+    type: CareerType;
+}
+
+export type ResumeProject = ResumePeriod & Record<'name' | 'title' | 'description', string>;
+
+export interface ResumeLanguage {
+    level: number;
+    description: string;
+}
+
+export type ResumeAward = Record<'award' | 'date' | 'description', string>;
+
+export type ResumeCertificate = Record<'name' | 'desc', string>;
+
+export type ResumeCompetition = ResumeCertificate;
+
+export interface Resume
+    extends
+        Record<
+            | 'file_md5'
+            | `${'' | 'new_'}content`
+            | 'name'
+            | 'email'
+            | 'mobile'
+            | 'country_code'
+            | 'date_of_birth'
+            | `${'current' | 'home'}_location`
+            | 'self_evaluation',
+            string
+        >,
+        Record<`willing_${'positions' | 'locations'}` | 'urls' | 'social_links', string[]> {
+    mobile_is_virtual: boolean;
+    educations: ResumeEducation[];
+    careers: ResumeCareer[];
+    projects: ResumeProject[];
+    work_year: number | null;
+    gender: Gender;
+    languages: ResumeLanguage[];
+    awards: ResumeAward[];
+    certificates: ResumeCertificate[];
+    competitions: ResumeCompetition[];
+}
+
+export interface ContractPrice {
+    contract_price: number;
+    contract_price_original: string;
+    text: string;
+}
+
+export type ContractInitialTerm = Record<`initial_${'time' | 'unit'}`, string>;
+
+export interface ContractTime extends Record<
+    `${'' | 'original_'}time_${'start' | 'end'}` | `text_${'start' | 'end' | 'initial_term'}`,
+    string
+> {
+    initial_term: ContractInitialTerm;
+}
+
+export interface ContractCopy extends Record<'original_copy' | 'key' | 'text', string> {
+    copy_num: number;
+}
+
+export type ContractCurrency = Record<`currency_${'name' | 'text'}`, string>;
+
+export type ContractBodyType = 'buy' | 'sell' | 'third';
+
+export type ContractContact = Record<
+    'contacts' | 'id_number' | 'phone' | 'email' | 'address',
+    string
+>;
+export type ContractBodyEntity = ContractContact & Record<'legal_representative' | 'party', string>;
+
+export interface ContractBodyInfo {
+    body_type: ContractBodyType;
+    value: ContractBodyEntity;
+}
+
+export type ContractBankType = `${'buy' | 'sell' | 'third' | 'uncertain'}_bank`;
+
+export type ContractBankEntity = ContractContact &
+    Record<'bank_name' | `account_${'name' | 'number'}` | 'tax_number', string>;
+
+export interface ContractBankInfo {
+    bank_type: ContractBankType;
+    value: ContractBankEntity;
+}
+
+export interface Contract extends Record<'file_id' | 'header', string> {
+    price: ContractPrice;
+    time: ContractTime;
+    copy: ContractCopy;
+    currency: ContractCurrency;
+    body_info: ContractBodyInfo[];
+    bank_info: ContractBankInfo[];
+}

package/src/module/Drive/index.ts

@@ -4,7 +4,16 @@ import { buildURLData, splitArray } from 'web-utility';
 
 import { LarkData, LarkDocumentPathTypeMap, LarkDocumentType, UploadTargetType } from '../../type';
 import { UserIdType } from '../User/type';
-import { CopiedFile, DriveFile, DriveFileType, TransferOwner, TransferOption } from './type';
+import {
+    CopiedFile,
+    DriveFile,
+    DriveFileType,
+    PublicFileType,
+    PublicPermission,
+    PublicPermissionPatch,
+    TransferOption,
+    TransferOwner
+} from './type';
 
 export * from './type';
 
@@ -106,6 +115,33 @@ export abstract class DriveFileModel extends BaseListModel<DriveFile> {
         return body!.data!.file;
     }
 
+    /**
+     * @see {@link https://open.feishu.cn/document/server-docs/docs/permission/permission-public/patch-2}
+     */
+    @toggle('uploading')
+    async updatePublicPermission(
+        type: PublicFileType,
+        token: string,
+        permission: PublicPermissionPatch
+    ) {
+        const { body } = await this.client.patch<LarkData<{ permission_public: PublicPermission }>>(
+            `${this.baseURI}/../v2/permissions/${token}/public?${buildURLData({ type })}`,
+            permission
+        );
+        return body!.data!.permission_public;
+    }
+
+    /**
+     * @see {@link https://open.feishu.cn/document/server-docs/docs/permission/permission-public/permission-public-password/create}
+     */
+    @toggle('uploading')
+    async createPublicPassword(type: PublicFileType, token: string) {
+        const { body } = await this.client.post<LarkData<{ password: string }>>(
+            `${this.baseURI}/permissions/${token}/public/password?${buildURLData({ type })}`
+        );
+        return body!.data!.password;
+    }
+
     /**
      * @see {@link https://open.feishu.cn/document/server-docs/docs/permission/permission-member/transfer_owner}
      */

package/src/module/Drive/type.ts

@@ -14,6 +14,38 @@ export type DriveFile = Record<
 export type CopiedFile = Record<'type' | `${'parent_' | ''}token` | 'name' | 'url', string>;
 
 export type DriveFileType = LarkDocumentType | 'minutes' | 'folder' | 'wiki';
+export type PublicFileType = Exclude<DriveFileType, 'folder'>;
+
+type PublicEditableLevel = 'view' | 'edit';
+type PublicLinkAccessLevel = 'readable' | 'editable';
+type PublicLinkShareScope = `${'' | 'partner_'}tenant` | 'anyone';
+
+export type PublicCommentEntity = `anyone_can_${PublicEditableLevel}`;
+export type PublicPermissionLevel = PublicCommentEntity | 'only_full_access';
+export type PublicShareEntity = 'anyone' | 'same_tenant';
+export type PublicCollaboratorEntity =
+    | `collaborator_can_${PublicEditableLevel}`
+    | 'collaborator_full_access';
+export type PublicExternalAccessEntity = 'open' | 'closed' | 'allow_share_partner_tenant';
+export type PublicLinkShareEntity = `${PublicLinkShareScope}_${PublicLinkAccessLevel}` | 'closed';
+
+export interface PublicPermission {
+    external_access_entity: PublicExternalAccessEntity;
+    security_entity: PublicPermissionLevel;
+    comment_entity: PublicCommentEntity;
+    share_entity: PublicShareEntity;
+    manage_collaborator_entity: PublicCollaboratorEntity;
+    link_share_entity: PublicLinkShareEntity;
+    copy_entity: PublicPermissionLevel;
+    lock_switch: boolean;
+}
+
+export type PublicPermissionPatch = Partial<Omit<PublicPermission, 'lock_switch'>>;
+
+export interface PublishedFile {
+    permission: PublicPermission;
+    password?: string;
+}
 
 export interface TransferOwner {
     member_type: 'email' | 'userid' | 'openid';