[add] Document Block model & updating methods (#14)

Author: TechQuery

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",

pnpm-lock.yaml

@@ -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');
     }
 }

src/Lark.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;

src/module/BITable/index.ts

@@ -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;