[refactor] simplify Lark BI Table API with Koa router (fix #6)

[optimize] update Upstream packages

Author: TechQuery

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idea2app/lark-next-bootstrap-ts",
-  "version": "2.1.0",
+  "version": "2.4.0",
   "description": "Lark project scaffold based on TypeScript, React, Next.js, Bootstrap & Workbox.",
   "private": true,
   "engines": {
@@ -24,9 +24,10 @@
     "copy-webpack-plugin": "^13.0.0",
     "core-js": "^3.41.0",
     "editorjs-html": "^4.0.5",
-    "file-type": "^20.4.1",
+    "file-type": "^20.5.0",
     "formidable": "^3.5.4",
     "idea-react": "^2.0.0-rc.10",
+    "jsonwebtoken": "^9.0.2",
     "koa": "^2.16.1",
     "koajax": "^3.1.2",
     "less": "^4.3.0",
@@ -63,7 +64,7 @@
     "@babel/plugin-proposal-decorators": "^7.25.9",
     "@babel/plugin-transform-typescript": "^7.27.0",
     "@babel/preset-react": "^7.26.3",
-    "@cspell/eslint-plugin": "^8.19.2",
+    "@cspell/eslint-plugin": "^8.19.3",
     "@eslint/compat": "^1.2.8",
     "@eslint/eslintrc": "^3.3.1",
     "@eslint/js": "^9.25.1",
@@ -76,7 +77,7 @@
     "@types/koa__router": "^12.0.4",
     "@types/lodash": "^4.17.16",
     "@types/next-pwa": "^5.6.9",
-    "@types/node": "^22.15.2",
+    "@types/node": "^22.15.3",
     "@types/react": "^19.1.2",
     "eslint": "^9.25.1",
     "eslint-config-next": "^15.3.1",
@@ -90,7 +91,7 @@
     "prettier": "^3.5.3",
     "prettier-plugin-css-order": "^2.1.2",
     "typescript": "~5.8.3",
-    "typescript-eslint": "^8.31.0"
+    "typescript-eslint": "^8.31.1"
   },
   "resolutions": {
     "next": "$next"

pages/api/Lark/authen/v1/[...slug].ts

@@ -1,6 +1,6 @@
 import { withSafeKoa } from '../../../core';
-import { proxyLark } from '../../core';
+import { proxyLarkAll } from '../../core';
 
 export const config = { api: { bodyParser: false } };
 
-export default withSafeKoa(proxyLark());
+export default withSafeKoa(proxyLarkAll);

pages/api/Lark/bitable/v1/[...slug].ts

@@ -1,31 +1,43 @@
 import { LarkPageData, TableRecord, TableRecordData } from 'mobx-lark';
 import { DataObject } from 'mobx-restful';
+import { createKoaRouter } from 'next-ssr-middleware';
 
-import { withSafeKoa } from '../../../core';
-import { proxyLark } from '../../core';
+import { withSafeKoaRouter } from '../../../core';
+import { proxyLark, proxyLarkAll } from '../../core';
 
 export const config = { api: { bodyParser: false } };
 
+const router = createKoaRouter(import.meta.url);
+
 function filterData(fields: DataObject) {
   for (const key of Object.keys(fields))
     if (!/^\w+$/.test(key)) delete fields[key];
 }
 
-const middleware = proxyLark((URI, data) => {
-  const [path] = URI.split('?');
+router.get('/apps/:app/tables/:table/records/:record', async context => {
+  const { status, body } =
+    await proxyLark<TableRecordData<DataObject>>(context);
+
+  const { fields } = body!.data!.record;
+
+  filterData(fields);
 
-  if (path.endsWith('/records')) {
-    const list =
-      (data as LarkPageData<TableRecord<DataObject>>).data!.items || [];
+  context.status = status;
+  context.body = body;
+});
+
+router.get('/apps/:app/tables/:table/records', async context => {
+  const { status, body } =
+    await proxyLark<LarkPageData<TableRecord<DataObject>>>(context);
 
-    for (const { fields } of list) filterData(fields);
-  } else if (path.split('/').at(-2) === 'records') {
-    const { record } = (data as TableRecordData<DataObject>).data!;
+  const list = body!.data!.items || [];
 
-    filterData(record.fields);
-  }
+  for (const { fields } of list) filterData(fields);
 
-  return data;
+  context.status = status;
+  context.body = body;
 });
 
-export default withSafeKoa(middleware);
+router.all('/(.*)', proxyLarkAll);
+
+export default withSafeKoaRouter(router);

pages/api/Lark/core.ts

@@ -1,4 +1,4 @@
-import { Middleware } from 'koa';
+import { Context, Middleware } from 'koa';
 import { marked } from 'marked';
 import {
   LarkApp,
@@ -18,30 +18,27 @@ export const lark = new LarkApp(larkAppMeta);
 export const normalizeMarkdownArray = (list: TableCellText[]) =>
   normalizeTextArray(list).map(text => marked(text) as string);
 
-export const proxyLark =
-  <T extends LarkData>(dataFilter?: (path: string, data: T) => T): Middleware =>
-  async context => {
-    const { method, url, headers, request } = context;
+export const proxyLark = async <T extends LarkData>({
+  method,
+  url,
+  headers: { host, authorization, ...headers },
+  request,
+}: Context) => {
+  await lark.getAccessToken();
 
-    if (!headers.authorization) await lark.getAccessToken();
+  const path = url!.slice(`/api/Lark/`.length),
+    body = Reflect.get(request, 'body');
 
-    delete headers.host;
-
-    const path = url!.slice(`/api/Lark/`.length);
-
-    const { status, body } = await lark.client.request<T>({
-      // @ts-expect-error Type compatibility issue
-      method,
-      path,
-      // @ts-expect-error Type compatibility issue
-      headers,
-      body: Reflect.get(request, 'body'),
-    });
+  // @ts-expect-error Type compatibility issue
+  return lark.client.request<T>({ method, path, headers, body });
+};
 
-    context.status = status;
+export const proxyLarkAll: Middleware = async context => {
+  const { status, body } = await proxyLark(context);
 
-    context.body = dataFilter?.(path, body!) || body;
-  };
+  context.status = status;
+  context.body = body;
+};
 
 export const larkOauth2 = oauth2Signer({
   signInURL: URI => new LarkApp(larkAppMeta).getWebSignInURL(URI),