@excitedjs/feishu-transport 0.0.1

package/dist/transport/feishu.js

@@ -0,0 +1,431 @@
+/**
+ * The Feishu platform boundary — the only module in the workspace that imports
+ * the Feishu SDK.
+ *
+ * Everything that talks to Feishu — the inbound long-lived WebSocket and the
+ * outbound message API — sits behind the `FeishuTransport` interface. A host
+ * depends only on that interface, so its wiring can be exercised against an
+ * injected fake with no live connection.
+ *
+ * The transport is event-type agnostic. `start` is handed a route table mapping
+ * each Feishu event_type to a callback and registers every entry with the SDK's
+ * event dispatcher; decoding a specific event's payload is the job of that
+ * event's handler (see `../parse`), not this module. Adding a new event type to
+ * a host therefore never touches this file.
+ *
+ * Cross-process single-instance election is intentionally **not** here. dreamux
+ * gives each dispatcher its own bot identity (election is moot), and claudemux
+ * wraps this transport with its own elected-transport layer. Core opens the
+ * inbound WebSocket directly; whether exactly one process may do so is the
+ * host's concern, layered on top. (claudemux#155 §二 / dreamux#25 §7.2.)
+ *
+ * Ported from claudemux's `feishu-channel/src/feishu.ts` (the source of truth),
+ * with the instance-lock removed, `sendText` upgraded to the structured
+ * `send(OutboundTarget, …)` contract, and `botOpenId` renamed to `selfId`.
+ */
+import * as lark from '@larksuiteoapi/node-sdk';
+import { cardToContent, renderMarkdownToCards, FEISHU_CARD_REQUEST_LIMIT_BYTES, } from '../render/render.js';
+import { connectionErrorLogLine, reconnectedLogLine, reconnectingLogLine, startupTimeoutLogLine, } from './connection.js';
+/** Cap on a single WebSocket handshake before it is aborted into a retry. */
+const WS_HANDSHAKE_TIMEOUT_MS = 15_000;
+/**
+ * How long the initial connection is given to come up before the channel
+ * stops it. Long enough to absorb a brief blip and the SDK's own early
+ * retries; past it, an unreachable Feishu would otherwise retry in a tight
+ * loop, so the transport cuts the attempt off.
+ */
+const WS_STARTUP_GRACE_MS = 30_000;
+/**
+ * A Lark-SDK logger that writes every line to stderr.
+ *
+ * Hosts that run over an MCP stdio transport reserve stdout for the JSON-RPC
+ * stream; the SDK's default logger writes to stdout, which corrupts it. Routing
+ * the SDK's logger to stderr keeps stdout clean while the SDK's diagnostics
+ * stay visible in the host's log. (Harmless for dreamux, which does not use
+ * stdout for a protocol stream.)
+ */
+const sdkLogger = {
+    error: (...msg) => console.error('[feishu-sdk]', ...msg),
+    warn: (...msg) => console.error('[feishu-sdk]', ...msg),
+    info: (...msg) => console.error('[feishu-sdk]', ...msg),
+    debug: (...msg) => console.error('[feishu-sdk]', ...msg),
+    trace: (...msg) => console.error('[feishu-sdk]', ...msg),
+};
+/**
+ * Build the `content` string for a Feishu plain-text message — the legacy
+ * `msg_type: 'text'` payload, used by `editText`'s fallback path so an edit
+ * on a message that was sent before this channel switched to interactive
+ * cards still works.
+ */
+export function textMessageContent(text) {
+    return JSON.stringify({ text });
+}
+/**
+ * Safe ceiling for the serialised card `content` string. Stays a few hundred
+ * bytes below the documented 30 KB request-body limit so HTTP headers and the
+ * `{ params, data: { receive_id, msg_type, content } }` envelope still fit.
+ */
+export const FEISHU_CARD_CONTENT_SAFE_BYTES = 28 * 1024;
+/**
+ * Throw a clear, model-actionable error when a single card's content would
+ * exceed Feishu's request-body limit, before the SDK round-trips and returns a
+ * low-level Feishu code with no fix path. The renderer normally keeps each card
+ * under the cap by splitting at element boundaries; this guards the residual
+ * case where a card cannot be split smaller (an un-splittable oversized token).
+ * Used by both `send` (preserving dreamux's prior per-card guard) and `editText`
+ * (which additionally cannot fan out a multi-card body).
+ */
+function assertCardContentFits(content) {
+    const bytes = Buffer.byteLength(content, 'utf8');
+    if (bytes > FEISHU_CARD_CONTENT_SAFE_BYTES) {
+        throw new Error(`card content is ${bytes} bytes; Feishu rejects a card-message body over ${FEISHU_CARD_REQUEST_LIMIT_BYTES} bytes. ` +
+            'Shorten the message, or break up an oversized table or code block the renderer could not split smaller.');
+    }
+}
+/**
+ * Render `text` as a single v2 card, throwing when the body exceeds what
+ * one card can hold. Used by `editText` — an edit patches one message_id
+ * in place and cannot fan out, so a multi-card body has no destination.
+ */
+function renderSingleCard(text) {
+    const cards = renderMarkdownToCards(text);
+    if (cards.length !== 1) {
+        throw new Error(`edit body produced ${cards.length} cards, but an edit can only update one ` +
+            'card in place. Reduce the body length, drop oversized tables, or send a ' +
+            'fresh reply (which the channel splits automatically) instead of editing.');
+    }
+    // The renderer always returns a non-empty array, but TypeScript can't
+    // narrow that — pull the element out with the assertion that we just
+    // verified there is exactly one.
+    return cards[0];
+}
+/** Document types the drive file-comment API serves; others have no comment API. */
+const COMMENT_FILE_TYPES = ['doc', 'docx', 'sheet', 'file'];
+/** Narrow an event's file_type to one the file-comment API accepts, or `undefined`. */
+function asCommentFileType(fileType) {
+    return COMMENT_FILE_TYPES.includes(fileType)
+        ? fileType
+        : undefined;
+}
+/**
+ * Pick the comment with `commentId` out of a `fileComment.batchQuery` response
+ * and shape it into a `FeishuDocComment`. Returns `null` when the response
+ * carried no such comment. Pure: no I/O, never throws — exported so the decode
+ * is unit-tested without a live Feishu connection.
+ */
+export function commentFromBatchQuery(items, commentId) {
+    const item = items.find((c) => c.comment_id === commentId);
+    if (!item)
+        return null;
+    const replies = (item.reply_list?.replies ?? []).map((reply) => ({
+        replyId: reply.reply_id ?? '',
+        authorId: reply.user_id ?? '',
+        elements: reply.content?.elements ?? [],
+    }));
+    return { isWhole: item.is_whole ?? true, quote: item.quote ?? '', replies };
+}
+/** Document types the drive metadata API serves. */
+const META_DOC_TYPES = [
+    'doc',
+    'docx',
+    'sheet',
+    'bitable',
+    'mindnote',
+    'file',
+    'wiki',
+    'folder',
+    'synced_block',
+    'slides',
+];
+/** Narrow an event's file_type to one the metadata API accepts, or `undefined`. */
+function asMetaDocType(fileType) {
+    return META_DOC_TYPES.includes(fileType)
+        ? fileType
+        : undefined;
+}
+/**
+ * The real Feishu transport, wrapping the official SDK.
+ *
+ * Inbound: a `WSClient` opens a long-lived WebSocket and an `EventDispatcher`
+ * routes every subscribed event_type to its callback. Outbound: a `Client`
+ * calls the `im` message API; it manages the `tenant_access_token` internally.
+ * The outbound paths are unit-tested through the `client` seam in
+ * `FeishuTransportOptions`; inbound still needs a live Feishu connection.
+ */
+export function createFeishuTransport(creds, options = {}) {
+    const client = options.client ??
+        new lark.Client({
+            appId: creds.appId,
+            appSecret: creds.appSecret,
+            logger: sdkLogger,
+        });
+    let wsClient;
+    let resolvedSelfId;
+    /**
+     * Open the inbound WebSocket and dispatch events through `routes`. Core opens
+     * the connection directly; a host that needs single-instance election wraps
+     * this transport rather than threading a lock through here.
+     */
+    async function openInbound(routes) {
+        resolvedSelfId = await resolveBotOpenId(client);
+        const dispatcher = new lark.EventDispatcher({ logger: sdkLogger }).register(routes);
+        // Resolves the first time the connection reaches `ready`; the startup
+        // watchdog below races against it.
+        let markReady = () => { };
+        const ready = new Promise((resolve) => {
+            markReady = resolve;
+        });
+        const ws = new lark.WSClient({
+            appId: creds.appId,
+            appSecret: creds.appSecret,
+            // Route the SDK's own logging to stderr — see `sdkLogger`.
+            logger: sdkLogger,
+            // Bound a stuck WebSocket handshake so it fails into a retry rather
+            // than holding a stuck DNS / NAT path open indefinitely.
+            handshakeTimeoutMs: WS_HANDSHAKE_TIMEOUT_MS,
+            // autoReconnect stays on: an established connection that drops should
+            // self-heal. The callbacks make every step of that loop visible, so a
+            // failing connection is observable instead of a silent retry loop.
+            autoReconnect: true,
+            onReady: () => {
+                logConnection('Feishu WebSocket connection is ready');
+                markReady();
+            },
+            onReconnecting: () => logConnection(reconnectingLogLine()),
+            onReconnected: () => logConnection(reconnectedLogLine()),
+            onError: (err) => logConnection(connectionErrorLogLine(err)),
+        });
+        wsClient = ws;
+        void ws.start({ eventDispatcher: dispatcher }).catch((err) => {
+            logConnection(connectionErrorLogLine(err));
+        });
+        // The SDK retries pullConnectConfig with no delay until it first
+        // succeeds — it has no server-provided reconnect interval yet — so a
+        // Feishu that is unreachable at startup spins a tight retry loop.
+        // Give the initial connection a grace window; if it is still not up,
+        // stop it so the loop does not run unbounded and unobserved.
+        const cameUp = await raceConnectionReady(ready);
+        if (!cameUp) {
+            const gaveUp = ws.getConnectionStatus().state === 'failed';
+            logConnection(startupTimeoutLogLine(WS_STARTUP_GRACE_MS, gaveUp));
+            ws.close();
+            // Fail loud rather than leave a dispatcher whose bot is silently dark:
+            // the host (dreamux's server) cleans up and surfaces the failure. A host
+            // that prefers to stand by on failure catches this in its own wrapper.
+            throw new Error(`Feishu inbound WebSocket for app ${creds.appId} did not connect within ${WS_STARTUP_GRACE_MS}ms`);
+        }
+    }
+    return {
+        get appId() {
+            return creds.appId;
+        },
+        get selfId() {
+            return resolvedSelfId;
+        },
+        async start(routes) {
+            await openInbound(routes);
+        },
+        async send(target, text) {
+            // Render the markdown source into one or more v2 cards. Routing per
+            // block type — headings to `header.title`, tables to `tag: table`,
+            // everything else to `tag: markdown` (lark_md) — keeps GFM tables and
+            // ATX headings from leaking through as literal `|` and `#`. A body
+            // too large for one card produces several cards, each sent as its own
+            // message_id so the recipient sees a threaded continuation.
+            //
+            // PR1: addressed by `chatId` only — behavior-identical to the old
+            // `sendText`. `replyToMessageId` / `mentionUserIds` are wired in PR2.
+            const cards = renderMarkdownToCards(text);
+            const messageIds = [];
+            for (const card of cards) {
+                const content = cardToContent(card);
+                // Fail fast on a card that could not be split under Feishu's hard cap,
+                // preserving dreamux's prior per-card send guard (see assertCardContentFits).
+                assertCardContentFits(content);
+                const res = await client.im.message.create({
+                    params: { receive_id_type: 'chat_id' },
+                    data: {
+                        receive_id: target.chatId,
+                        msg_type: 'interactive',
+                        content,
+                    },
+                });
+                const id = res.data?.message_id;
+                if (id)
+                    messageIds.push(id);
+            }
+            return { messageIds };
+        },
+        async addReaction(messageId, emoji) {
+            const res = await client.im.messageReaction.create({
+                path: { message_id: messageId },
+                data: { reaction_type: { emoji_type: emoji } },
+            });
+            return res.data?.reaction_id ?? '';
+        },
+        async removeReaction(messageId, reactionId) {
+            await client.im.messageReaction.delete({
+                path: { message_id: messageId, reaction_id: reactionId },
+            });
+        },
+        async editText(messageId, text) {
+            // An edit patches one message_id in place and cannot fan out, so
+            // `renderSingleCard` rejects a body the renderer would otherwise split
+            // across several cards. `assertCardContentFits` then catches the
+            // residual case of a single-card body that still serialises past the
+            // 30 KB request cap — both checks surface as actionable errors before
+            // any SDK round-trip.
+            const card = renderSingleCard(text);
+            const cardContent = cardToContent(card);
+            assertCardContentFits(cardContent);
+            try {
+                // The send path produces an interactive card, so the matching edit
+                // is `im.message.patch` (card-content update). The original card was
+                // sent with `update_multi: true`, which Feishu requires for a later
+                // patch on the same message_id to be accepted.
+                await client.im.message.patch({
+                    path: { message_id: messageId },
+                    data: { content: cardContent },
+                });
+            }
+            catch (patchErr) {
+                // Legacy compatibility: a message_id a host is still holding may
+                // belong to a `msg_type: 'text'` message that this channel sent
+                // before the upgrade to interactive cards. Feishu rejects `patch`
+                // on a non-card target, so fall back to `im.message.update` with
+                // the legacy text payload. If the update also fails — auth, rate
+                // limit, deleted message — surface the original patch error, which
+                // describes the path the channel actually intends to use.
+                try {
+                    await client.im.message.update({
+                        path: { message_id: messageId },
+                        data: { msg_type: 'text', content: textMessageContent(text) },
+                    });
+                }
+                catch {
+                    throw patchErr;
+                }
+            }
+        },
+        async fetchDocComment(fileToken, fileType, commentId) {
+            // The file-comment API only serves a subset of document types; for any
+            // other type there is no comment to fetch, so skip the call outright.
+            const ct = asCommentFileType(fileType);
+            if (!ct)
+                return null;
+            try {
+                // `batchQuery` resolves a comment by id and serves both
+                // whole-document and local-selection comments. The single-comment
+                // `get` endpoint serves only whole-document comments — it returns
+                // "not exist" for a comment anchored to a text selection, which is
+                // most document comments.
+                const res = await client.drive.fileComment.batchQuery({
+                    path: { file_token: fileToken },
+                    // Resolve reply authors to open_id, so they match the open_id the
+                    // event carries and the sender_id of chat messages.
+                    params: { file_type: ct, user_id_type: 'open_id' },
+                    data: { comment_ids: [commentId] },
+                });
+                return commentFromBatchQuery(res.data?.items ?? [], commentId);
+            }
+            catch (err) {
+                console.error(`[feishu-transport] could not fetch comment ${commentId} on ${fileToken}:`, err);
+                return null;
+            }
+        },
+        async fetchDocMeta(fileToken, fileType) {
+            const dt = asMetaDocType(fileType);
+            if (!dt)
+                return null;
+            try {
+                const res = await client.drive.meta.batchQuery({
+                    data: { request_docs: [{ doc_token: fileToken, doc_type: dt }], with_url: true },
+                });
+                const meta = res.data?.metas?.[0];
+                if (!meta)
+                    return null;
+                return { title: meta.title ?? '', url: meta.url ?? '' };
+            }
+            catch (err) {
+                console.error(`[feishu-transport] could not fetch metadata for ${fileToken}:`, err);
+                return null;
+            }
+        },
+        async close() {
+            try {
+                wsClient?.close();
+            }
+            catch (err) {
+                // A close on an already-closed socket is expected; anything else
+                // (e.g. the SDK's close surface changed) is worth a diagnostic line.
+                console.error('[feishu-transport] error while closing the Feishu WebSocket:', err);
+            }
+            wsClient = undefined;
+        },
+    };
+}
+/** How many times to try resolving the bot's open_id before giving up. */
+const BOT_INFO_ATTEMPTS = 3;
+/**
+ * Resolve the bot's own open_id, needed for group mention-gating. The SDK does
+ * not expose a bot-info method, so this calls the raw endpoint through the
+ * client (which still attaches the token).
+ *
+ * Best-effort: a failure leaves the open_id unknown rather than blocking
+ * startup — but it is not silent. An unknown open_id makes `isBotMentioned`
+ * never match, so every mention-gated group would drop every message; each
+ * failure is logged with that consequence spelled out, and a transient error
+ * is retried a few times before the transport gives up.
+ */
+async function resolveBotOpenId(client) {
+    for (let attempt = 1; attempt <= BOT_INFO_ATTEMPTS; attempt++) {
+        try {
+            const res = await client.request({
+                method: 'GET',
+                url: '/open-apis/bot/v3/info',
+            });
+            const openId = res.bot?.open_id;
+            if (openId)
+                return openId;
+            // A well-formed response that simply lacks the field will not improve
+            // on retry — stop here rather than spend the remaining attempts.
+            console.error('[feishu-transport] bot info response carried no open_id — groups that ' +
+                'require an @-mention will drop every message until the channel restarts');
+            return undefined;
+        }
+        catch (err) {
+            if (attempt < BOT_INFO_ATTEMPTS) {
+                await delay(attempt * 500);
+                continue;
+            }
+            console.error(`[feishu-transport] could not resolve the bot open_id after ${BOT_INFO_ATTEMPTS} ` +
+                'attempts — groups that require an @-mention will drop every message ' +
+                'until the channel restarts:', err);
+            return undefined;
+        }
+    }
+    return undefined;
+}
+/** Resolve after `ms` milliseconds — the backoff between bot-info attempts. */
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Write a timestamped connection-lifecycle line to the host's stderr log. */
+function logConnection(line) {
+    console.error(`[feishu-transport] ${new Date().toISOString()} ${line}`);
+}
+/**
+ * Resolve `true` if `ready` settles within the startup grace window, `false`
+ * if the window elapses first. The timer is cleared on the winning path so it
+ * does not keep the process alive after the race is decided.
+ */
+function raceConnectionReady(ready) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => resolve(false), WS_STARTUP_GRACE_MS);
+        void ready.then(() => {
+            clearTimeout(timer);
+            resolve(true);
+        });
+    });
+}
+//# sourceMappingURL=feishu.js.map

package/dist/transport/feishu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feishu.js","sourceRoot":"","sources":["../../src/transport/feishu.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@excitedjs/feishu-transport",
+  "version": "0.0.1",
+  "description": "Shared Feishu platform-I/O core for dreamux and claudemux: connect / receive / send / auth / render / parse + stateless policy (issue excitedjs/dreamux#25).",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=22.7"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@larksuiteoapi/node-sdk": "^1.64.0",
+    "marked": "^15.0.12"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}