mobx-lark 2.4.3 → 2.5.0

package/dist/module/Document/index.d.ts

@@ -1,15 +1,106 @@
-import { BaseListModel } from 'mobx-restful';
-import { Block, Document, IframeBlock, OrderedBlock, QuoteContainerBlock, TextBlock } from './type';
+import { BaseListModel, IDType, ListModel, NewData } from 'mobx-restful';
+import { UserIdType } from '../User/type';
+import { Block, Document, DocumentBlockUpdateResult, PageBlock } from './type';
 export * from './type';
 export * from './component';
 export type FileURLResolver = (token: string) => string | Promise<string>;
 export declare abstract class DocumentModel extends BaseListModel<Document> {
-    #private;
     domain: string;
     baseURI: string;
     constructor(domain: string);
+    /**
+     * @see {@link https://open.feishu.cn/document/server-docs/docs/docs/docx-v1/document/get}
+     */
+    getOne(id: IDType): Promise<Document>;
+    /**
+     * @see {@link https://open.feishu.cn/document/server-docs/docs/docs/docx-v1/document/create}
+     */
+    updateOne(data: Partial<NewData<Document>>, id?: IDType): Promise<Document>;
+    /**
+     * @see {@link https://open.feishu.cn/document/server-docs/docs/docs/docx-v1/document/raw_content}
+     * @see {@link https://open.feishu.cn/document/docs/docs-v1/get}
+     */
+    getOneContent(doc_token: string, content_type?: 'text' | 'markdown', lang?: 'zh' | 'en' | 'ja'): Promise<string>;
+    getOneBlocks(id: string, resolveFileURL?: FileURLResolver): Promise<Block<any, any, any>[]>;
+    updateOneBlocks(id: string, markUpDown: string, user_id_type?: UserIdType): Promise<DocumentBlockUpdateResult & {
+        children: Block<any, any, any>[];
+        block_id_relations: Record<`${"temporary_" | ""}block_id`, string>[];
+    }>;
+}
+declare const DocumentBlockModel_base: (abstract new (...args: any[]) => {
+    stream?: AsyncGenerator<Block<any, any, any>, void, any> | undefined;
+    openStream(filter: Partial<NewData<Block<any, any, any>>>): AsyncGenerator<Block<any, any, any>, void, any>;
+    clearList(): void;
+    clear(): void;
+    restoreList({ filter, pageIndex, pageSize, allItems, totalCount }?: Partial<Pick<ListModel<Block<any, any, any>, Partial<NewData<Block<any, any, any>>>>, "filter" | "pageIndex" | "pageSize" | "allItems" | "totalCount">> | undefined): Promise<void>;
+    loadStream(filter: Partial<NewData<Block<any, any, any>>>, newCount: number): Promise<Block<any, any, any>[]>;
+    loadPage(pageIndex: number, pageSize: number, filter: Partial<NewData<Block<any, any, any>>>): Promise<{
+        pageData: Block<any, any, any>[];
+        totalCount: number;
+    }>;
+    pageIndex: number;
+    pageSize: number;
+    filter: Partial<NewData<Block<any, any, any>>>;
+    totalCount: number;
+    pageList: Block<any, any, any>[][];
+    readonly currentPage: Block<any, any, any>[];
+    readonly pageCount: number;
+    readonly allItems: Block<any, any, any>[];
+    readonly noMore: boolean;
+    statistic: Partial<Record<string, Record<string, number>>>;
+    turnTo(pageIndex: number, pageSize?: number): ListModel<Block<any, any, any>, Partial<NewData<Block<any, any, any>>>>;
+    loadNewPage(pageIndex: number, pageSize: number, filter: Partial<NewData<Block<any, any, any>>>): Promise<{
+        pageData: Block<any, any, any>[];
+        totalCount: number;
+    }>;
+    getList(filter?: Partial<NewData<Block<any, any, any>>> | undefined, pageIndex?: number, pageSize?: number): Promise<Block<any, any, any>[]>;
+    refreshList(): Promise<Block<any, any, any>[]>;
+    getAllInStream(filter?: Partial<NewData<Block<any, any, any>>> | undefined, pageSize?: number): AsyncGenerator<Block<any, any, any>, void, unknown>;
+    getAll(filter?: Partial<NewData<Block<any, any, any>>> | undefined, pageSize?: number): Promise<Block<any, any, any>[]>;
+    countAll(keys: string[], filter?: Partial<NewData<Block<any, any, any>>> | undefined, pageSize?: number): Promise<Partial<Record<string, Record<string, number>>>>;
+    indexOf(id: IDType): number;
+    changeOne(data: Partial<Block<any, any, any>>, id: IDType, patch?: boolean): void;
+    updateOne(data: Partial<NewData<Block<any, any, any>>>, id?: IDType): Promise<Block<any, any, any>>;
+    removeOne(id: IDType): Promise<void>;
+    deleteOne(id: IDType): Promise<void>;
+    client: import("mobx-restful").RESTClient;
+    baseURI: string;
+    indexKey: any;
+    currentOne: Block<any, any, any>;
+    clearCurrent(): void;
+    getOne(id: IDType): Promise<Block<any, any, any>>;
+    downloading: number;
+    uploading: number;
+    [Symbol.asyncIterator]: (filter?: Partial<NewData<Block<any, any, any>>> | undefined, pageSize?: number) => AsyncGenerator<Block<any, any, any>, void, unknown>;
+}) & import("web-utility").AbstractClass<ListModel<Block<any, any, any>, Partial<NewData<Block<any, any, any>>>>>;
+export declare abstract class DocumentBlockModel extends DocumentBlockModel_base {
+    #private;
+    domain: string;
+    documentId: string;
+    constructor(domain: string, documentId: string);
+    openStream(): AsyncGenerator<Block<any, any, any>, void, unknown>;
     /**
      * @see {@link https://open.feishu.cn/document/server-docs/docs/docs/docx-v1/document/list}
      */
-    getOneBlocks(id: string, resolveFileURL?: FileURLResolver): Promise<(OrderedBlock | QuoteContainerBlock | IframeBlock | TextBlock | Block<any, any, any>)[]>;
+    getRenderableAll(resolveFileURL?: FileURLResolver): Promise<Block<any, any, any>[]>;
+    /**
+     * @see {@link https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document/convert}
+     */
+    convertFrom(markUpDown: string, user_id_type?: UserIdType): Promise<{
+        first_level_block_ids: string[];
+        blocks: Block<any, any>[];
+        block_id_to_image_urls: Record<"block_id" | "image_url", string>[];
+    }>;
+    getRoot(): Promise<PageBlock | undefined>;
+    /**
+     * @see {@link https://open.feishu.cn/document/server-docs/docs/docs/docx-v1/document-block/batch_delete}
+     */
+    removeAll(): Promise<void>;
+    /**
+     * @see {@link https://open.feishu.cn/document/docs/docs/document-block/create-2}
+     */
+    insert(markUpDown: string, index?: number, rootBlockId?: string, user_id_type?: UserIdType): Promise<DocumentBlockUpdateResult & {
+        children: Block<any, any, any>[];
+        block_id_relations: Record<`${"temporary_" | ""}block_id`, string>[];
+    }>;
 }

package/dist/module/Document/type/index.d.ts

@@ -11,3 +11,7 @@ export interface Document extends Record<'document_id' | 'title', string> {
     };
     display_setting: Record<`show_${'authors' | `${'comment' | 'like'}_count` | 'create_time' | 'pv' | 'uv'}`, boolean>;
 }
+export interface DocumentBlockUpdateResult {
+    document_revision_id: number;
+    client_token: string;
+}

package/dist/module/Wiki/index.d.ts

@@ -1,5 +1,5 @@
 import { Filter, ListModel } from 'mobx-restful';
-import { Wiki, WikiNode } from './type';
+import { Wiki, WikiNode, WikiTask } from './type';
 export * from './type';
 declare const WikiModel_base: (abstract new (...args: any[]) => {
     stream?: AsyncGenerator<Wiki, void, any> | undefined;
@@ -114,4 +114,12 @@ export declare abstract class WikiNodeModel extends WikiNodeModel_base {
      * @see {@link https://open.feishu.cn/document/server-docs/docs/wiki-v2/space-node/list}
      */
     traverseTree(parentNode?: WikiNode, onCount?: (total: number) => any): AsyncGenerator<WikiNode>;
+    /**
+     * @see {@link https://open.feishu.cn/document/server-docs/docs/wiki-v2/task/move_docs_to_wiki}
+     */
+    moveDocument(document: Pick<WikiNode, 'obj_type' | 'obj_token'>, parent_wiki_token?: string, apply?: boolean): Promise<WikiNode | undefined>;
+    /**
+     * @see {@link https://open.feishu.cn/document/server-docs/docs/wiki-v2/task/get}
+     */
+    getOneTask(taskId: string, task_type?: string): Promise<WikiTask>;
 }

package/dist/module/Wiki/type.d.ts

@@ -12,3 +12,11 @@ export interface WikiNode extends Record<'title' | 'creator' | 'owner' | `${'' |
      */
     title_path?: string;
 }
+export interface WikiTask {
+    task_id: string;
+    move_result: {
+        status: number;
+        status_msg: string;
+        node: WikiNode;
+    }[];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mobx-lark",
-    "version": "2.4.3",
+    "version": "2.5.0",
     "license": "LGPL-3.0",
     "author": "shiy2008@gmail.com",
     "description": "Unofficial TypeScript SDK for FeiShu/Lark API, which is based on MobX-RESTful.",
@@ -30,7 +30,7 @@
         "koajax": "^3.1.2",
         "lodash.memoize": "^4.1.2",
         "mobx": "^6.15.0",
-        "mobx-restful": "^2.1.3",
+        "mobx-restful": "^2.1.4",
         "regenerator-runtime": "^0.14.1",
         "web-utility": "^4.6.2"
     },
@@ -42,13 +42,13 @@
         "@parcel/transformer-typescript-tsc": "~2.16.0",
         "@types/fs-extra": "^11.0.4",
         "@types/lodash.memoize": "^4.1.9",
-        "@types/node": "^22.18.10",
+        "@types/node": "^22.18.12",
         "@types/react-dom": "^19.2.2",
         "@types/turndown": "^5.0.5",
         "dotenv": "^17.2.3",
         "fs-extra": "^11.3.2",
         "husky": "^9.1.7",
-        "lint-staged": "^16.2.4",
+        "lint-staged": "^16.2.5",
         "parcel": "~2.16.0",
         "prettier": "^3.6.2",
         "react": "^19.2.0",

package/src/Lark.ts

@@ -1,7 +1,7 @@
 import { Context, HTTPClient, makeFormData } from 'koajax';
 import { buildURLData, cache, sleep } from 'web-utility';
 
-import { WikiNodeModel } from './module';
+import { DocumentModel, WikiNodeModel } from './module';
 import {
     isLarkError,
     JSTicket,
@@ -209,22 +209,19 @@ export class LarkApp implements LarkAppOption {
     static documentPathPattern = /(wiki|docx)\/(\w+)/;
 
     /**
-     * @see {@link https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/docs-v1/content/get}
+     * @see {@link DocumentModel#getOneContent}
      */
     async downloadMarkdown(URI: string) {
         await this.getAccessToken();
 
         const [, type, id] = URI.match(LarkApp.documentPathPattern) || [];
 
-        const doc_token = type === 'wiki' ? await this.wiki2docx(id) : id;
+        const doc_token = type === 'wiki' ? await this.wiki2docx(id) : id,
+            { client } = this;
 
-        const { body } = await this.client.get<LarkData<{ content: string }>>(
-            `docs/v1/content?${new URLSearchParams({
-                doc_type: 'docx',
-                doc_token,
-                content_type: 'markdown'
-            })}`
-        );
-        return body!.data!.content;
+        class InternalDocumentModel extends DocumentModel {
+            client = client;
+        }
+        return new InternalDocumentModel('').getOneContent(doc_token, 'markdown');
     }
 }

package/src/module/BITable/index.ts

@@ -275,13 +275,12 @@ export function BiTable() {
         /**
          * @see {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table/list}
          */
-        async *openStream() {
-            for await (const item of createPageStream<BITable>(
+        openStream() {
+            return createPageStream<BITable>(
                 this.client,
                 this.baseURI,
                 total => (this.totalCount = total)
-            ))
-                yield item;
+            );
         }
     }
     return BiTableModel;

package/src/module/Document/component/Block.tsx

@@ -1,5 +1,5 @@
 import { FC } from 'react';
-import { uniqueID } from 'web-utility';
+import { clone, uniqueID } from 'web-utility';
 
 import { Block, BlockType } from '../type';
 import { ListBlockComponent, TextBlockComponent } from './Text';
@@ -55,7 +55,7 @@ export const blockComponentMap: Partial<Record<BlockType, FC<any>>> = {
 export const blockMap: Record<string, Block<any, any, any>> = {};
 
 export function registerBlocks<T extends Block<any, any, any>>(blocks: T[]) {
-    blocks = globalThis.structuredClone?.(blocks) || JSON.parse(JSON.stringify(blocks));
+    blocks = clone(blocks);
 
     let root: T | undefined;
 

package/src/module/Document/index.ts

@@ -1,23 +1,25 @@
 import { HTTPError } from 'koajax';
 import memoize from 'lodash.memoize';
-import { BaseListModel } from 'mobx-restful';
-import { formatDate, uniqueID } from 'web-utility';
+import { BaseListModel, IDType, ListModel, NewData, Stream, toggle } from 'mobx-restful';
+import { buildURLData, formatDate, uniqueID } from 'web-utility';
 
 import { isLarkError, LarkData } from '../../type';
 import { createPageStream } from '../base';
 import { TaskModel } from '../Task';
-import { User } from '../User/type';
+import { User, UserIdType } from '../User/type';
 import { WikiNode, WikiNodeModel } from '../Wiki';
 import {
     BiTableBlock,
     Block,
     BlockType,
     Document,
+    DocumentBlockUpdateResult,
     FileBlock,
     IframeBlock,
     IframeComponentType,
     ImageBlock,
     OrderedBlock,
+    PageBlock,
     QuoteContainerBlock,
     SheetBlock,
     SubPageList,
@@ -40,6 +42,91 @@ export abstract class DocumentModel extends BaseListModel<Document> {
         super();
     }
 
+    /**
+     * @see {@link https://open.feishu.cn/document/server-docs/docs/docs/docx-v1/document/get}
+     */
+    @toggle('downloading')
+    async getOne(id: IDType) {
+        const { body } = await this.client.get<LarkData<{ document: Document }>>(
+            `${this.baseURI}/${id}`
+        );
+        return (this.currentOne = body!.data!.document);
+    }
+
+    /**
+     * @see {@link https://open.feishu.cn/document/server-docs/docs/docs/docx-v1/document/create}
+     */
+    @toggle('uploading')
+    async updateOne(data: Partial<NewData<Document>>, id?: IDType) {
+        const { body } = await this.client.post<LarkData<{ document: Document }>>(
+            this.baseURI,
+            data
+        );
+        return (this.currentOne = body!.data!.document);
+    }
+
+    /**
+     * @see {@link https://open.feishu.cn/document/server-docs/docs/docs/docx-v1/document/raw_content}
+     * @see {@link https://open.feishu.cn/document/docs/docs-v1/get}
+     */
+    @toggle('downloading')
+    async getOneContent(
+        doc_token: string,
+        content_type: 'text' | 'markdown' = 'markdown',
+        lang: 'zh' | 'en' | 'ja' = 'zh'
+    ) {
+        const { body } = await (content_type === 'text'
+            ? this.client.get<LarkData<{ content: string }>>(
+                  `${this.baseURI}/${doc_token}/raw_content?${buildURLData({ lang: ['zh', 'en', 'ja'].indexOf(lang) })}`
+              )
+            : this.client.get<LarkData<{ content: string }>>(
+                  `docs/v1/content?${buildURLData({ doc_type: 'docx', doc_token, content_type, lang })}`
+              ));
+        return body!.data!.content;
+    }
+
+    @toggle('downloading')
+    async getOneBlocks(id: string, resolveFileURL?: FileURLResolver) {
+        const { client, domain } = this;
+
+        class MyDocumentBlockModel extends DocumentBlockModel {
+            client = client;
+        }
+        return new MyDocumentBlockModel(domain, id).getRenderableAll(resolveFileURL);
+    }
+
+    @toggle('uploading')
+    async updateOneBlocks(id: string, markUpDown: string, user_id_type: UserIdType = 'open_id') {
+        const { client, domain } = this;
+
+        class MyDocumentBlockModel extends DocumentBlockModel {
+            client = client;
+        }
+        const blockStore = new MyDocumentBlockModel(domain, id);
+
+        await blockStore.removeAll();
+
+        return blockStore.insert(markUpDown, 0, undefined, user_id_type);
+    }
+}
+
+export abstract class DocumentBlockModel extends Stream<Block<any, any, any>>(ListModel) {
+    constructor(
+        public domain: string,
+        public documentId: string
+    ) {
+        super();
+        this.baseURI = `docx/v1/documents/${documentId}/blocks`;
+    }
+
+    openStream() {
+        return createPageStream<Block<any, any, any>>(
+            this.client,
+            this.baseURI,
+            total => (this.totalCount = total)
+        );
+    }
+
     #createLinkElement = (
         url: string,
         content = url,
@@ -229,12 +316,72 @@ export abstract class DocumentModel extends BaseListModel<Document> {
     /**
      * @see {@link https://open.feishu.cn/document/server-docs/docs/docs/docx-v1/document/list}
      */
-    async getOneBlocks(id: string, resolveFileURL?: FileURLResolver) {
-        const stream = createPageStream<Block<any, any, any>>(
-            this.client,
-            `docx/v1/documents/${id}/blocks`,
-            total => void total
+    @toggle('downloading')
+    getRenderableAll(resolveFileURL?: FileURLResolver) {
+        return Array.fromAsync<Block<any, any, any>>(this.#resolveBlocks(this, resolveFileURL));
+    }
+
+    /**
+     * @see {@link https://open.feishu.cn/document/ukTMukTMukTM/uUDN04SN0QjL1QDN/document-docx/docx-v1/document/convert}
+     */
+    @toggle('downloading')
+    async convertFrom(markUpDown: string, user_id_type: UserIdType = 'open_id') {
+        type ConvertResult = {
+            first_level_block_ids: string[];
+            blocks: Block<any, any>[];
+            block_id_to_image_urls: Record<'block_id' | 'image_url', string>[];
+        };
+        const { body } = await this.client.post<LarkData<ConvertResult>>(
+            `docx/v1/documents/blocks/convert?${buildURLData({ user_id_type })}`,
+            { content_type: 'markdown', content: markUpDown }
+        );
+        return body!.data!;
+    }
+
+    @toggle('downloading')
+    async getRoot() {
+        for await (const block of this)
+            if (block.block_type === BlockType.page) return block as PageBlock;
+    }
+
+    /**
+     * @see {@link https://open.feishu.cn/document/server-docs/docs/docs/docx-v1/document-block/batch_delete}
+     */
+    @toggle('uploading')
+    async removeAll() {
+        const rootBlock = await this.getRoot();
+
+        if (rootBlock?.children?.[0])
+            await this.client.delete<LarkData<DocumentBlockUpdateResult>>(
+                `${this.baseURI}/${rootBlock.block_id}/children/batch_delete`,
+                { start_index: 0, end_index: rootBlock.children.length }
+            );
+    }
+
+    /**
+     * @see {@link https://open.feishu.cn/document/docs/docs/document-block/create-2}
+     */
+    @toggle('uploading')
+    async insert(
+        markUpDown: string,
+        index = -1,
+        rootBlockId?: string,
+        user_id_type: UserIdType = 'open_id'
+    ) {
+        const { first_level_block_ids: children_id, blocks } = await this.convertFrom(
+            markUpDown,
+            user_id_type
+        );
+        rootBlockId ||= (await this.getRoot())?.block_id;
+
+        type DescendantResult = DocumentBlockUpdateResult & {
+            children: Block<any, any, any>[];
+            block_id_relations: Record<`${'temporary_' | ''}block_id`, string>[];
+        };
+        const { body } = await this.client.post<LarkData<DescendantResult>>(
+            `${this.baseURI}/${rootBlockId}/descendant?${buildURLData({ user_id_type })}`,
+            { index, children_id, descendants: blocks }
         );
-        return Array.fromAsync(this.#resolveBlocks(stream, resolveFileURL));
+        return body!.data!;
     }
 }

package/src/module/Document/type/index.ts

@@ -13,3 +13,8 @@ export interface Document extends Record<'document_id' | 'title', string> {
         boolean
     >;
 }
+
+export interface DocumentBlockUpdateResult {
+    document_revision_id: number;
+    client_token: string;
+}

package/src/module/InstantMessenger/index.ts

@@ -13,13 +13,12 @@ export abstract class ChatListModel extends Stream<ChatMeta>(ListModel) {
     /**
      * @see {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/chat/list}
      */
-    async *openStream() {
-        for await (const item of createPageStream<ChatMeta>(
+    openStream() {
+        return createPageStream<ChatMeta>(
             this.client,
             this.baseURI,
             total => (this.totalCount = total)
-        ))
-            yield item;
+        );
     }
 
     /**
@@ -28,9 +27,7 @@ export abstract class ChatListModel extends Stream<ChatMeta>(ListModel) {
     @toggle('uploading')
     async updateOne({ chat_id }: NewData<ChatMeta>) {
         const { body } = await (chat_id
-            ? this.client.put<LarkData<ChatMeta>>(
-                  `${this.baseURI}/chats/${chat_id}`
-              )
+            ? this.client.put<LarkData<ChatMeta>>(`${this.baseURI}/chats/${chat_id}`)
             : this.client.post<LarkData<ChatMeta>>(
                   `${this.baseURI}/chats?${buildURLData({
                       set_bot_manager: true
@@ -50,23 +47,19 @@ export abstract class MessageListModel extends Stream<ChatMessage>(ListModel) {
     /**
      * @see {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/list}
      */
-    async *openStream() {
-        for await (const item of createPageStream<ChatMessage>(
+    openStream() {
+        return createPageStream<ChatMessage>(
             this.client,
             this.baseURI,
             total => (this.totalCount = total)
-        ))
-            yield item;
+        );
     }
 
     /**
      * @see https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create
      */
     @toggle('uploading')
-    async createOne({
-        msg_type,
-        content
-    }: Omit<SendChatMessage, 'receive_id'>) {
+    async createOne({ msg_type, content }: Omit<SendChatMessage, 'receive_id'>) {
         const { body } = await this.client.post<LarkData<ChatMessage>>(
             `${this.baseURI}?${buildURLData({
                 receive_id_type: 'chat_id'

package/src/module/Task/index.ts

@@ -33,15 +33,14 @@ export abstract class TaskModel extends Stream<Task, TaskFilter>(ListModel) {
         user_id_type = 'union_id',
         ...rest
     }: TaskFilter) {
-        if (resource_type === 'my_tasks') {
-            const stream = createPageStream<Task>(
+        if (resource_type === 'my_tasks')
+            yield* createPageStream<Task>(
                 this.client,
                 this.baseURI,
                 total => (this.totalCount = total),
                 { type: resource_type, user_id_type, ...rest }
             );
-            for await (const item of stream) yield item;
-        } else {
+        else {
             const stream = createPageStream<TaskSummary>(
                 this.client,
                 `task/v2/tasklists/${resource_id}/tasks`,
@@ -89,14 +88,13 @@ export abstract class TaskListModel extends Stream<TaskList, TaskListFilter>(Lis
     /**
      * @see {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/tasklist/list}
      */
-    async *openStream({ user_id_type = 'union_id' }: TaskListFilter) {
-        for await (const item of createPageStream<TaskList>(
+    openStream({ user_id_type = 'union_id' }: TaskListFilter) {
+        return createPageStream<TaskList>(
             this.client,
             this.baseURI,
             total => (this.totalCount = total),
             { user_id_type }
-        ))
-            yield item;
+        );
     }
 
     /**
@@ -128,6 +126,7 @@ export abstract class TaskListModel extends Stream<TaskList, TaskListFilter>(Lis
                   update_fields: Object.keys(tasklist)
               })
             : await this.client.post<LarkData<{ tasklist: TaskList }>>(path, tasklist);
+
         return body!.data!.tasklist;
     }
 }
@@ -157,7 +156,6 @@ export abstract class TaskListSectionModel extends Stream<TaskListSection, TaskL
                 user_id_type
             }
         );
-
         for await (const { guid } of stream) yield await this.getOne(guid);
     }
 
@@ -206,18 +204,17 @@ export abstract class TaskFieldModel extends Stream<TaskField, TaskFieldFilter>(
     /**
      * @see {@link https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/task-v2/custom_field/list}
      */
-    async *openStream({
+    openStream({
         resource_type = 'tasklist',
         resource_id,
         user_id_type = 'union_id'
     }: TaskFieldFilter) {
-        for await (const item of createPageStream<TaskField>(
+        return createPageStream<TaskField>(
             this.client,
             this.baseURI,
             total => (this.totalCount = total),
             { resource_type, resource_id, user_id_type }
-        ))
-            yield item;
+        );
     }
 
     /**
@@ -246,6 +243,7 @@ export abstract class TaskFieldModel extends Stream<TaskField, TaskFieldFilter>(
 
         for (const body of targets)
             await this.client.post(`${this.baseURI}/${custom_field.guid}/add`, body);
+
         return custom_field;
     }
 }