@krischoichoi/channel-lark 0.6.0

package/lib/openapi-outbound.d.ts

@@ -0,0 +1,216 @@
+import type { OutboundActionRow } from '@krischoichoi/channel-core';
+import type { LarkFileRef, LarkMediaRef, LarkOutbound } from './upstream.js';
+/** The SDK `receive_id_type` union (matches the real `Client` type). */
+export type LarkReceiveIdType = 'open_id' | 'user_id' | 'union_id' | 'email' | 'chat_id';
+/** SDK `file_type` union for im.v1.file.create (matches the SDK type). */
+export type LarkFileType = 'opus' | 'mp4' | 'pdf' | 'doc' | 'xls' | 'ppt' | 'stream';
+/** Minimal `im.v1.message.create` payload/result shapes consumed here. */
+export interface LarkCreateMessagePayload {
+    params: {
+        receive_id_type: LarkReceiveIdType;
+        uuid?: string;
+    };
+    data: {
+        receive_id: string;
+        msg_type: string;
+        content: string;
+        uuid?: string;
+    };
+}
+export interface LarkCreateMessageResult {
+    message_id?: string;
+}
+/** Minimal `im.v1.message.patch` payload shape (update card content). */
+export interface LarkPatchMessagePayload {
+    path: {
+        message_id: string;
+    };
+    data: {
+        content: string;
+    };
+}
+/** Minimal `im.v1.image.create` payload/result shapes consumed here. */
+export interface LarkCreateImagePayload {
+    data: {
+        image_type: 'message' | 'avatar';
+        image: Buffer;
+    };
+}
+export interface LarkCreateImageResult {
+    image_key?: string;
+}
+/** Minimal im.v1.file.create payload/result shapes consumed here. */
+export interface LarkCreateFilePayload {
+    data: {
+        file_type: 'opus' | 'mp4' | 'pdf' | 'doc' | 'xls' | 'ppt' | 'stream';
+        file_name: string;
+        duration?: number;
+        file: Buffer;
+    };
+}
+export interface LarkCreateFileResult {
+    file_key?: string;
+}
+/** Common OpenAPI envelope: `code` 0 means success. */
+export interface LarkApiResponse<T = Record<string, unknown>> {
+    code?: number;
+    msg?: string;
+    data?: T;
+}
+/** Minimal cardkit.v1.card.create payload/result shapes. */
+export interface LarkCardkitCardCreatePayload {
+    data: {
+        type: 'card_json';
+        data: string;
+    };
+}
+export interface LarkCardkitCardCreateResult {
+    card_id?: string;
+}
+/** Minimal cardkit.v1.cardElement.content payload (streaming element replace). */
+export interface LarkCardElementContentPayload {
+    path: {
+        card_id: string;
+        element_id: string;
+    };
+    data: {
+        uuid?: string;
+        content: string;
+        sequence: number;
+    };
+}
+/** Minimal cardkit.v1.card.settings payload (streaming close + summary). */
+export interface LarkCardSettingsPayload {
+    path: {
+        card_id: string;
+    };
+    data: {
+        settings: string;
+        sequence: number;
+        uuid?: string;
+    };
+}
+/**
+ * Structural subset of the real SDK `Client` used for outbound. The real
+ * `Client` (from `@larksuiteoapi/node-sdk` at 1.73.1) satisfies this shape;
+ * tests inject a fake.
+ */
+export interface LarkOpenApiClient {
+    im: {
+        v1: {
+            message: {
+                create(payload: LarkCreateMessagePayload): Promise<LarkApiResponse<LarkCreateMessageResult>>;
+                patch(payload: LarkPatchMessagePayload): Promise<LarkApiResponse>;
+            };
+            image: {
+                create(payload: LarkCreateImagePayload): Promise<LarkCreateImageResult | null>;
+            };
+            file: {
+                create(payload: LarkCreateFilePayload): Promise<LarkCreateFileResult | null>;
+            };
+            chat?: {
+                get(payload: {
+                    path: {
+                        chat_id: string;
+                    };
+                }): Promise<unknown>;
+            };
+        };
+        messageReaction?: unknown;
+    };
+    cardkit: {
+        v1: {
+            card: {
+                create(payload: LarkCardkitCardCreatePayload): Promise<LarkApiResponse<LarkCardkitCardCreateResult>>;
+                settings(payload: LarkCardSettingsPayload): Promise<LarkApiResponse>;
+            };
+            cardElement: {
+                content(payload: LarkCardElementContentPayload): Promise<LarkApiResponse>;
+            };
+        };
+    };
+    addReaction?(messageId: string, emojiType: string): Promise<string>;
+    removeReaction?(messageId: string, reactionId: string): Promise<void>;
+}
+/** The stable id of the single streaming markdown element inside a CardKit card. */
+export declare const STREAM_MARKDOWN_ELEMENT_ID = "stream_md";
+/**
+ * The summary shown while a streaming card is still generating (Feishu
+ * previews this in chat lists until streaming is closed and a real summary is
+ * written).
+ */
+export declare const STREAM_GENERATING_SUMMARY = "[Generating...]";
+/**
+ * Build the Card JSON 2.0 payload of a native-streaming card entity. The
+ * element carries a stable `element_id` and the card opens `streaming_mode`
+ * with Feishu's typewriter `streaming_config`, matching the official "流式更新
+ * 卡片" flow (cardkit.v1.card.create → cardElement.content → card.settings).
+ */
+export declare function streamingCardJson(initialText: string, summary?: string): string;
+export interface LarkOpenApiOutboundOptions {
+    /** Official OpenAPI client (real `Client` or injected fake). */
+    client: LarkOpenApiClient;
+    /** Injectable image-byte fetch for `sendMedia` URLs (tests); defaults to `fetch`. */
+    fetchImage?: (url: string) => Promise<Buffer>;
+}
+/**
+ * Official-OpenAPI implementation of the outbound surface (plain messages,
+ * media, Card JSON 2.0 interactive cards and CardKit 2.0 entities + native
+ * streaming). No `receive` here: in SDK mode the inbound leg stays on the WS
+ * long-connection, and this driver is composed as the `outbound` half of
+ * `LarkSdkUpstream`.
+ */
+export declare class LarkOpenApiOutbound implements LarkOutbound {
+    private readonly options;
+    private readonly fetchImage;
+    private readonly typingReactions;
+    private readonly typingOperations;
+    constructor(options: LarkOpenApiOutboundOptions);
+    sendText(to: string, text: string): Promise<unknown>;
+    sendInteractive(to: string, text: string, actions: OutboundActionRow[]): Promise<unknown>;
+    sendMedia(to: string, media: LarkMediaRef): Promise<unknown>;
+    sendFile(to: string, file: LarkFileRef): Promise<unknown>;
+    createCardEntity(cardJson: string): Promise<{
+        cardId: string;
+    }>;
+    sendCardEntity(conversationId: string, cardId: string): Promise<{
+        messageId: string;
+    }>;
+    updateCardElementContent(cardId: string, elementId: string, content: string, sequence: number, uuid: string): Promise<unknown>;
+    finishStreamingCard(cardId: string, sequence: number, summary: string): Promise<unknown>;
+    updateInteractive(cardId: string, text: string, actions: OutboundActionRow[]): Promise<unknown>;
+    getChatType(conversationId: string): Promise<'p2p' | 'group' | undefined>;
+    startTyping(messageId: string): Promise<void>;
+    stopTyping(messageId: string): Promise<void>;
+    private serializeTyping;
+    private callEnvelope;
+    private reactionClient;
+    private resolveImageBytes;
+    private resolveFileBytes;
+}
+/**
+ * Resolve the SDK `receive_id_type` from a Lark conversation id: group chats
+ * carry an `oc_` prefix (`chat_id`), p2p chats carry the peer's `ou_` open id
+ * (`open_id`).
+ */
+export declare function receiveIdType(to: string): LarkReceiveIdType;
+/**
+ * Derive the SDK `file_type` from a filename extension, defaulting to
+ * 'stream' for anything unrecognised. Matches the SDK union for im.v1.file.create.
+ */
+export declare function fileTypeFromName(name: string): LarkFileType;
+/**
+ * Card JSON 2.0 content for a single markdown element (used by the interactive
+ * card rewrite path that patches an already-sent message). The 2.0 `markdown`
+ * element renders the full Lark-flavoured Markdown (headings, lists, code
+ * blocks, tables, links).
+ */
+export declare function cardContent(text: string): string;
+/**
+ * Official Card JSON 2.0 button layout. V2 removed the legacy `action`
+ * container: buttons are direct body elements and callback values belong to
+ * `behaviors[].value`. No `tag: "action"` container and no `lark_md` are ever
+ * emitted.
+ */
+export declare function interactiveCardContent(text: string, rows: OutboundActionRow[]): string;
+//# sourceMappingURL=openapi-outbound.d.ts.map

package/lib/openapi-outbound.d.ts.map

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

package/lib/openapi-outbound.js

@@ -0,0 +1,384 @@
+/**
+ * Lark outbound over the official `@larksuiteoapi/node-sdk` OpenAPI `Client`.
+ *
+ * This driver is the ONLY outbound implementation: plain text, media and file
+ * messages, Card JSON 2.0 interactive cards, and CardKit 2.0 card entities with
+ * native streaming (`cardElement.content`) are all routed through the official
+ * client. There is no self-hosted gateway and no legacy `/message/*` or
+ * `/card/*` endpoint anywhere.
+ *
+ * - `sendText`      → `im.v1.message.create` (`msg_type: 'text'`)
+ * - `sendMedia`     → `im.v1.image.create` (upload → `image_key`) + `im.v1.message.create` (`msg_type: 'image'`)
+ * - `sendFile`      → `im.v1.file.create` (upload → `file_key`) + `im.v1.message.create` (`msg_type: 'file'`)
+ * - `sendInteractive` → `im.v1.message.create` (`msg_type: 'interactive'`) with Card JSON 2.0 buttons
+ * - `updateInteractive` → `im.v1.message.patch` (rewrite an already-sent interactive card)
+ * - `createCardEntity` → `cardkit.v1.card.create` (Card JSON 2.0 only)
+ * - `sendCardEntity` → `im.v1.message.create` with content `{ type: "card", data: { card_id } }`
+ * - `updateCardElementContent` → `cardkit.v1.cardElement.content` (native typewriter)
+ * - `finishStreamingCard` → `cardkit.v1.card.settings` (`streaming_mode: false` + summary)
+ *
+ * Only a minimal structural client surface is consumed so offline tests can
+ * inject a fake; the real `Client` satisfies it structurally. Credentials are
+ * never referenced here — the `Client` is built elsewhere from config.
+ *
+ * Official responses are trust-boundary validated with zod `safeParse` before
+ * their fields are read; invalid envelopes surface as `ChannelError`s.
+ */
+import { ChannelError } from '@krischoichoi/channel-core';
+import { z } from 'zod';
+const reactionIdSchema = z.string().trim().min(1);
+const chatModeResponseSchema = z.object({
+    code: z.number().optional(),
+    data: z.object({
+        chat_mode: z.enum(['p2p', 'group', 'topic']).optional(),
+    }).optional(),
+});
+/** Trust-boundary envelope: any unknown extra keys are allowed, but the read fields are validated. */
+const envelopeSchema = z.object({
+    code: z.number().optional(),
+    msg: z.string().optional(),
+    data: z.unknown().optional(),
+}).passthrough();
+const cardIdResultSchema = z.object({
+    card_id: z.string().trim().min(1),
+});
+const messageIdResultSchema = z.object({
+    message_id: z.string().trim().min(1),
+});
+/** The stable id of the single streaming markdown element inside a CardKit card. */
+export const STREAM_MARKDOWN_ELEMENT_ID = 'stream_md';
+/**
+ * The summary shown while a streaming card is still generating (Feishu
+ * previews this in chat lists until streaming is closed and a real summary is
+ * written).
+ */
+export const STREAM_GENERATING_SUMMARY = '[Generating...]';
+/**
+ * Build the Card JSON 2.0 payload of a native-streaming card entity. The
+ * element carries a stable `element_id` and the card opens `streaming_mode`
+ * with Feishu's typewriter `streaming_config`, matching the official "流式更新
+ * 卡片" flow (cardkit.v1.card.create → cardElement.content → card.settings).
+ */
+export function streamingCardJson(initialText, summary = STREAM_GENERATING_SUMMARY) {
+    return JSON.stringify({
+        schema: '2.0',
+        config: {
+            streaming_mode: true,
+            summary: { content: summary },
+            streaming_config: {
+                print_frequency_ms: { default: 70 },
+                print_step: { default: 1 },
+                print_strategy: 'fast',
+            },
+        },
+        body: {
+            elements: [
+                {
+                    tag: 'markdown',
+                    element_id: STREAM_MARKDOWN_ELEMENT_ID,
+                    content: initialText,
+                },
+            ],
+        },
+    });
+}
+/**
+ * Official-OpenAPI implementation of the outbound surface (plain messages,
+ * media, Card JSON 2.0 interactive cards and CardKit 2.0 entities + native
+ * streaming). No `receive` here: in SDK mode the inbound leg stays on the WS
+ * long-connection, and this driver is composed as the `outbound` half of
+ * `LarkSdkUpstream`.
+ */
+export class LarkOpenApiOutbound {
+    options;
+    fetchImage;
+    typingReactions = new Map();
+    typingOperations = new Map();
+    constructor(options) {
+        this.options = options;
+        this.fetchImage = options.fetchImage ?? defaultFetchImage;
+    }
+    sendText(to, text) {
+        return this.callEnvelope(() => this.options.client.im.v1.message.create({
+            params: { receive_id_type: receiveIdType(to) },
+            data: { receive_id: to, msg_type: 'text', content: JSON.stringify({ text }) },
+        }));
+    }
+    sendInteractive(to, text, actions) {
+        return this.callEnvelope(() => this.options.client.im.v1.message.create({
+            params: { receive_id_type: receiveIdType(to) },
+            data: {
+                receive_id: to,
+                msg_type: 'interactive',
+                content: interactiveCardContent(text, actions),
+            },
+        }));
+    }
+    async sendMedia(to, media) {
+        const bytes = await this.resolveImageBytes(media);
+        const uploaded = await this.options.client.im.v1.image.create({
+            data: { image_type: 'message', image: bytes },
+        });
+        const imageKey = uploaded?.image_key;
+        if (!imageKey) {
+            throw new ChannelError('CHANNEL_ERROR', 'lark image upload returned no image_key');
+        }
+        return this.callEnvelope(() => this.options.client.im.v1.message.create({
+            params: { receive_id_type: receiveIdType(to) },
+            data: {
+                receive_id: to,
+                msg_type: 'image',
+                content: JSON.stringify({ image_key: imageKey }),
+            },
+        }));
+    }
+    async sendFile(to, file) {
+        const bytes = await this.resolveFileBytes(file);
+        const name = file.name ?? 'file';
+        const uploaded = await this.options.client.im.v1.file.create({
+            data: {
+                file_type: fileTypeFromName(name),
+                file_name: name,
+                file: bytes,
+            },
+        });
+        const fileKey = uploaded?.file_key;
+        if (!fileKey) {
+            throw new ChannelError('CHANNEL_ERROR', 'lark file upload returned no file_key');
+        }
+        return this.callEnvelope(() => this.options.client.im.v1.message.create({
+            params: { receive_id_type: receiveIdType(to) },
+            data: {
+                receive_id: to,
+                msg_type: 'file',
+                content: JSON.stringify({ file_key: fileKey }),
+            },
+        }));
+    }
+    async createCardEntity(cardJson) {
+        const response = await this.options.client.cardkit.v1.card.create({
+            data: { type: 'card_json', data: cardJson },
+        });
+        const envelope = parseEnvelope(response);
+        const parsed = cardIdResultSchema.safeParse(envelope.data);
+        if (!parsed.success) {
+            throw new ChannelError('CHANNEL_ERROR', 'lark cardkit.card.create returned no card_id');
+        }
+        return { cardId: parsed.data.card_id };
+    }
+    async sendCardEntity(conversationId, cardId) {
+        const response = await this.options.client.im.v1.message.create({
+            params: { receive_id_type: receiveIdType(conversationId) },
+            data: {
+                receive_id: conversationId,
+                msg_type: 'interactive',
+                content: JSON.stringify({ type: 'card', data: { card_id: cardId } }),
+            },
+        });
+        const envelope = parseEnvelope(response);
+        const parsed = messageIdResultSchema.safeParse(envelope.data);
+        if (!parsed.success) {
+            throw new ChannelError('CHANNEL_ERROR', 'lark card reference send returned no message_id');
+        }
+        return { messageId: parsed.data.message_id };
+    }
+    async updateCardElementContent(cardId, elementId, content, sequence, uuid) {
+        return this.callEnvelope(() => this.options.client.cardkit.v1.cardElement.content({
+            path: { card_id: cardId, element_id: elementId },
+            data: { uuid, content, sequence },
+        }));
+    }
+    async finishStreamingCard(cardId, sequence, summary) {
+        return this.callEnvelope(() => this.options.client.cardkit.v1.card.settings({
+            path: { card_id: cardId },
+            data: {
+                settings: JSON.stringify({ config: { streaming_mode: false, summary: { content: summary } } }),
+                sequence,
+                uuid: `s_${cardId}_${sequence}`,
+            },
+        }));
+    }
+    updateInteractive(cardId, text, actions) {
+        return this.callEnvelope(() => this.options.client.im.v1.message.patch({
+            path: { message_id: cardId },
+            data: { content: interactiveCardContent(text, actions) },
+        }));
+    }
+    async getChatType(conversationId) {
+        const chat = this.options.client.im.v1.chat;
+        if (!chat)
+            return undefined;
+        const parsed = chatModeResponseSchema.safeParse(await chat.get({ path: { chat_id: conversationId } }));
+        if (!parsed.success || parsed.data.code !== undefined && parsed.data.code !== 0)
+            return undefined;
+        const mode = parsed.data.data?.chat_mode;
+        return mode === 'p2p' ? 'p2p' : mode === 'group' || mode === 'topic' ? 'group' : undefined;
+    }
+    async startTyping(messageId) {
+        if (!messageId || this.typingReactions.has(messageId))
+            return;
+        await this.serializeTyping(messageId, async () => {
+            if (this.typingReactions.has(messageId))
+                return;
+            const reaction = this.reactionClient();
+            if (!reaction)
+                return;
+            const result = reactionIdSchema.safeParse(await reaction.addReaction(messageId, 'Typing'));
+            if (!result.success) {
+                throw new ChannelError('CHANNEL_ERROR', 'lark typing reaction returned an invalid reaction id');
+            }
+            this.typingReactions.set(messageId, result.data);
+        });
+    }
+    async stopTyping(messageId) {
+        await this.serializeTyping(messageId, async () => {
+            const reactionId = this.typingReactions.get(messageId);
+            if (!reactionId)
+                return;
+            const reaction = this.reactionClient();
+            if (reaction)
+                await reaction.removeReaction(messageId, reactionId);
+            this.typingReactions.delete(messageId);
+        });
+    }
+    async serializeTyping(messageId, operation) {
+        const previous = this.typingOperations.get(messageId) ?? Promise.resolve();
+        const current = previous.then(operation, operation);
+        this.typingOperations.set(messageId, current);
+        try {
+            await current;
+        }
+        finally {
+            if (this.typingOperations.get(messageId) === current)
+                this.typingOperations.delete(messageId);
+        }
+    }
+    async callEnvelope(request) {
+        return parseEnvelope(await request());
+    }
+    reactionClient() {
+        if (this.options.client.addReaction && this.options.client.removeReaction) {
+            return {
+                addReaction: this.options.client.addReaction.bind(this.options.client),
+                removeReaction: this.options.client.removeReaction.bind(this.options.client),
+            };
+        }
+        const nested = this.options.client.im.messageReaction;
+        return nested && typeof nested.addReaction === 'function' && typeof nested.removeReaction === 'function'
+            ? nested
+            : undefined;
+    }
+    async resolveImageBytes(media) {
+        if (media.dataUri)
+            return dataUriToBuffer(media.dataUri);
+        if (media.url)
+            return this.fetchImage(media.url);
+        throw new ChannelError('CHANNEL_ERROR', 'lark sendMedia requires an image url or dataUri');
+    }
+    async resolveFileBytes(file) {
+        if (file.localData) {
+            return Buffer.isBuffer(file.localData) ? file.localData : Buffer.from(file.localData);
+        }
+        if (file.dataUri)
+            return dataUriToBuffer(file.dataUri);
+        if (file.url)
+            return this.fetchImage(file.url);
+        throw new ChannelError('CHANNEL_ERROR', 'lark sendFile requires localData, url, or dataUri');
+    }
+}
+/** Validate an SDK envelope and return the raw parsed object. */
+function parseEnvelope(response) {
+    const parsed = envelopeSchema.safeParse(response);
+    if (!parsed.success) {
+        throw new ChannelError('CHANNEL_ERROR', 'lark openapi returned an invalid envelope');
+    }
+    if (parsed.data.code !== undefined && parsed.data.code !== 0) {
+        throw new ChannelError('CHANNEL_ERROR', `lark openapi request failed (${parsed.data.code}): ${parsed.data.msg ?? 'unknown error'}`);
+    }
+    return parsed.data;
+}
+/**
+ * Resolve the SDK `receive_id_type` from a Lark conversation id: group chats
+ * carry an `oc_` prefix (`chat_id`), p2p chats carry the peer's `ou_` open id
+ * (`open_id`).
+ */
+export function receiveIdType(to) {
+    return to.startsWith('oc_') ? 'chat_id' : 'open_id';
+}
+/**
+ * Derive the SDK `file_type` from a filename extension, defaulting to
+ * 'stream' for anything unrecognised. Matches the SDK union for im.v1.file.create.
+ */
+export function fileTypeFromName(name) {
+    const ext = (name.split('.').pop() ?? '').toLowerCase();
+    switch (ext) {
+        case 'opus': return 'opus';
+        case 'mp4': return 'mp4';
+        case 'pdf': return 'pdf';
+        case 'doc':
+        case 'docx': return 'doc';
+        case 'xls':
+        case 'xlsx': return 'xls';
+        case 'ppt':
+        case 'pptx': return 'ppt';
+        default: return 'stream';
+    }
+}
+/**
+ * Card JSON 2.0 content for a single markdown element (used by the interactive
+ * card rewrite path that patches an already-sent message). The 2.0 `markdown`
+ * element renders the full Lark-flavoured Markdown (headings, lists, code
+ * blocks, tables, links).
+ */
+export function cardContent(text) {
+    return JSON.stringify({
+        schema: '2.0',
+        config: { wide_screen_mode: true },
+        body: {
+            elements: [{ tag: 'markdown', content: text }],
+        },
+    });
+}
+/**
+ * Official Card JSON 2.0 button layout. V2 removed the legacy `action`
+ * container: buttons are direct body elements and callback values belong to
+ * `behaviors[].value`. No `tag: "action"` container and no `lark_md` are ever
+ * emitted.
+ */
+export function interactiveCardContent(text, rows) {
+    const elements = [{ tag: 'markdown', content: text }];
+    for (const row of rows) {
+        for (const action of row.actions) {
+            elements.push({
+                tag: 'button',
+                text: { tag: 'plain_text', content: action.label },
+                ...(buttonType(action.style) ? { type: buttonType(action.style) } : {}),
+                behaviors: [{ type: 'callback', value: { actionId: action.id } }],
+            });
+        }
+    }
+    return JSON.stringify({
+        schema: '2.0',
+        config: { wide_screen_mode: true },
+        body: { elements },
+    });
+}
+function buttonType(style) {
+    if (style === 'primary' || style === 'success')
+        return 'primary';
+    return style === 'danger' ? 'danger' : undefined;
+}
+function dataUriToBuffer(dataUri) {
+    const comma = dataUri.indexOf(',');
+    const payload = comma >= 0 ? dataUri.slice(comma + 1) : dataUri;
+    return Buffer.from(payload, 'base64');
+}
+async function defaultFetchImage(url) {
+    const response = await globalThis.fetch(url);
+    if (!response.ok) {
+        throw new ChannelError('CHANNEL_ERROR', `lark image fetch failed with ${response.status}`);
+    }
+    const arrayBuffer = await response.arrayBuffer();
+    return Buffer.from(arrayBuffer);
+}
+//# sourceMappingURL=openapi-outbound.js.map

package/lib/openapi-outbound.js.map

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

package/lib/outbound.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Outbound sending: channel message → lark text/media/file payload → upstream.
+ *
+ * Streaming replies go through `LarkCardReply` (CardKit native streaming);
+ * this sender is the plain send path (`adapter.send`) used for one-shot
+ * messages. Text messages use `sendText`; a pure image message (no text) uses
+ * `sendMedia`; a pure file message carrying `localData` uses `sendFile`
+ * (official im.file.create → im.message.create) so media/file capability is
+ * real rather than a placeholder.
+ */
+import type { ChannelLogger, ChannelTarget, OutboundMessage, SendResult } from '@krischoichoi/channel-core';
+import type { LarkUpstream } from './upstream.js';
+export declare class OutboundSender {
+    private readonly upstream;
+    private readonly logger;
+    private readonly interactiveCards;
+    constructor(upstream: LarkUpstream, logger: ChannelLogger);
+    send(target: ChannelTarget, message: OutboundMessage): Promise<SendResult>;
+    edit(target: ChannelTarget, messageId: string, message: OutboundMessage): Promise<SendResult>;
+}
+//# sourceMappingURL=outbound.d.ts.map

package/lib/outbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound.d.ts","sourceRoot":"","sources":["../src/outbound.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAIb,eAAe,EACf,UAAU,EACX,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,eAAe,CAAC;AAE/D,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuC;gBAGrD,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,aAAa;IAGlC,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAiC1E,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;CAsBpG"}