[optimize] get Document Title before copying automatically

Author: TechQuery

ReadMe.md

@@ -150,11 +150,12 @@ await writeFile('document.html', markup);
 ## Scaffolds
 
 1. https://github.com/idea2app/Lark-Next-Bootstrap-ts
+2. https://github.com/idea2app/Lark-Next-Shadcn-ts
 
 ## User cases
 
 1. [idea2app web-site](https://github.com/idea2app/idea2app.github.io/tree/main/models)
-2. [KaiYuanShe web-site](https://github.com/kaiyuanshe/kaiyuanshe.github.io/tree/main/models)
+2. [Open-Source-Bazaar web-site](https://github.com/Open-Source-Bazaar/Open-Source-Bazaar.github.io/tree/main/models)
 
 ## Related with
 

package.json

@@ -1,6 +1,6 @@
 {
     "name": "mobx-lark",
-    "version": "2.6.0-rc.0",
+    "version": "2.6.0-rc.1",
     "license": "LGPL-3.0",
     "author": "shiy2008@gmail.com",
     "description": "Unofficial TypeScript SDK for FeiShu/Lark API, which is based on MobX-RESTful.",

src/Lark.ts

@@ -4,7 +4,7 @@ import { buildURLData, cache, sleep } from 'web-utility';
 import {
     CopiedFile,
     DocumentModel,
-    DriveModel,
+    DriveFileModel,
     UserIdType,
     WikiNode,
     WikiNodeModel
@@ -42,7 +42,7 @@ export class LarkApp implements LarkAppOption {
     client: HTTPClient<Context>;
     accessToken = '';
 
-    driveStore: DriveModel;
+    driveFileStore: DriveFileModel;
     wikiNodeStore: WikiNodeModel;
     documentStore: DocumentModel;
 
@@ -59,7 +59,7 @@ export class LarkApp implements LarkAppOption {
 
         const { client } = this;
 
-        this.driveStore = new (class extends DriveModel {
+        this.driveFileStore = new (class extends DriveFileModel {
             client = client;
         })();
         this.wikiNodeStore = new (class extends WikiNodeModel {
@@ -176,40 +176,40 @@ export class LarkApp implements LarkAppOption {
     }, 'JS ticket');
 
     /**
-     * @see {@link DriveModel#downloadFile}
+     * @see {@link DriveFileModel#downloadOne}
      */
     async downloadFile(id: string) {
         await this.getAccessToken();
 
-        return this.driveStore.downloadFile(id);
+        return this.driveFileStore.downloadOne(id);
     }
 
     /**
-     * @see {@link DriveModel#uploadFile}
+     * @see {@link DriveFileModel#uploadOne}
      */
     async uploadFile(file: File, parent_type: UploadTargetType, parent_node: string) {
         await this.getAccessToken();
 
-        return this.driveStore.uploadFile(file, parent_type, parent_node);
+        return this.driveFileStore.uploadOne(file, parent_type, parent_node);
     }
 
     /**
-     * @see {@link DriveModel#copyFile}
+     * @see {@link DriveFileModel#copyOne}
      * @see {@link WikiNodeModel#moveDocument}
      */
     copyFile(
         URI: `${string}/wiki/${string}`,
-        name: string,
+        name?: string,
         parent_node_token?: string,
         user_id_type?: UserIdType
     ): Promise<WikiNode>;
     copyFile(
         URI: `${string}/${LarkDocumentType}/${string}`,
-        name: string,
+        name?: string,
         folder_token?: string,
         user_id_type?: UserIdType
     ): Promise<CopiedFile>;
-    async copyFile(URI: string, name: string, folder_token?: string, user_id_type?: UserIdType) {
+    async copyFile(URI: string, name?: string, folder_token?: string, user_id_type?: UserIdType) {
         await this.getAccessToken();
 
         let [type, token] = new URL(URI, 'http://localhost').pathname.split('/'),
@@ -220,11 +220,12 @@ export class LarkApp implements LarkAppOption {
             ({
                 obj_type: type,
                 obj_token: token,
+                title: name,
                 space_id,
                 parent_node_token
             } = await this.wiki2drive(token));
 
-        const copidFile = await this.driveStore.copyFile(
+        const copidFile = await this.driveFileStore.copyOne(
             type as LarkDocumentType,
             token,
             name,

src/module/Drive/index.ts

@@ -1,21 +1,38 @@
 import { makeFormData } from 'koajax';
-import { BaseModel, RESTClient, toggle } from 'mobx-restful';
+import { BaseListModel, RESTClient, toggle } from 'mobx-restful';
 import { buildURLData } from 'web-utility';
 
 import { LarkData, LarkDocumentType, UploadTargetType } from '../../type';
 import { UserIdType } from '../User/type';
+import { CopiedFile, DriveFile } from './type';
 
-export type CopiedFile = Record<'token' | 'type' | 'name' | 'parent_token' | 'url', string>;
+export * from './type';
 
-export abstract class DriveModel extends BaseModel {
+export abstract class DriveFileModel extends BaseListModel<DriveFile> {
     baseURI = 'drive/v1';
     abstract client: RESTClient;
 
+    /**
+     * @see {@link https://open.feishu.cn/document/server-docs/docs/drive-v1/file/batch_query}
+     *
+     * @param URI such as `docx/xxxyyyzzz`
+     */
+    @toggle('downloading')
+    async getOne(URI: string, user_id_type?: UserIdType) {
+        let [doc_type, doc_token] = new URL(URI, 'http://localhost').pathname.split('/');
+
+        const { body } = await this.client.post<LarkData<{ metas: DriveFile[] }>>(
+            `${this.baseURI}/metas/batch_query?${buildURLData({ user_id_type })}`,
+            { request_docs: [{ doc_type, doc_token }], with_url: true }
+        );
+        return body!.data!.metas[0];
+    }
+
     /**
      * @see {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/download}
      */
     @toggle('downloading')
-    async downloadFile(id: string) {
+    async downloadOne(id: string) {
         const { headers, body } = await this.client.get<Blob>(
             `${this.baseURI}/medias/${id}/download`,
             {},
@@ -33,7 +50,7 @@ export abstract class DriveModel extends BaseModel {
      * @see {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/media/upload_all}
      */
     @toggle('uploading')
-    async uploadFile(file: File, parent_type: UploadTargetType, parent_node: string) {
+    async uploadOne(file: File, parent_type: UploadTargetType, parent_node: string) {
         const form = makeFormData({
             file,
             file_name: file.name,
@@ -64,13 +81,14 @@ export abstract class DriveModel extends BaseModel {
      * @see {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/drive-v1/file/copy}
      */
     @toggle('uploading')
-    async copyFile(
+    async copyOne(
         type: LarkDocumentType,
         file_token: string,
-        name: string,
+        name?: string,
         folder_token?: string,
         user_id_type?: UserIdType
     ) {
+        name ||= (await this.getOne(`${type}/${file_token}`, user_id_type)).title + ' (copy)';
         folder_token ||= (await this.getRootFolder()).token;
 
         const { body } = await this.client.post<LarkData<{ file: CopiedFile }>>(

src/module/Drive/type.ts

@@ -0,0 +1,12 @@
+export type DriveFile = Record<
+    | `doc_${'token' | 'type'}`
+    | 'title'
+    | 'owner_id'
+    | 'create_time'
+    | `latest_modify_${'user' | 'time'}`
+    | 'url'
+    | 'sec_label_name',
+    string
+>;
+
+export type CopiedFile = Record<'token' | 'type' | 'name' | 'parent_token' | 'url', string>;