@krischoichoi/channel-weixin 0.6.0

package/lib/messaging/quote.js

@@ -0,0 +1,35 @@
+/**
+ * Preserve a Weixin reference as explicit model-visible context. iLink does
+ * not expose a stable referenced Channel message id, so this must not create a
+ * synthetic replyTo relationship.
+ */
+export function formatQuotedContext(ref) {
+    if (!ref)
+        return [];
+    const item = ref.message_item;
+    const summary = quotedItemSummary(item);
+    const title = cleanText(ref.title);
+    if (!title && !summary)
+        return [];
+    const body = [title, summary].filter(Boolean).join(' | ');
+    return [{ type: 'text', text: `[quoted: ${body}]` }];
+}
+function quotedItemSummary(item) {
+    if (!item)
+        return undefined;
+    const text = cleanText(item.text_item?.text ?? item.voice_item?.text);
+    if (text)
+        return text;
+    switch (item.type) {
+        case 2: return '[image]';
+        case 3: return '[voice]';
+        case 4: return item.file_item?.file_name ? `[file: ${item.file_item.file_name}]` : '[file]';
+        case 5: return '[video]';
+        default: return undefined;
+    }
+}
+function cleanText(value) {
+    const trimmed = value?.trim();
+    return trimmed || undefined;
+}
+//# sourceMappingURL=quote.js.map

package/lib/messaging/quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.js","sourceRoot":"","sources":["../../src/messaging/quote.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAgC;IAClE,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC;IAC9B,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1D,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,IAAI,GAAG,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAkC;IAC3D,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACtE,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,CAAC,CAAC,CAAC,OAAO,SAAS,CAAC;QACzB,KAAK,CAAC,CAAC,CAAC,OAAO,SAAS,CAAC;QACzB,KAAK,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC5F,KAAK,CAAC,CAAC,CAAC,OAAO,SAAS,CAAC;QACzB,OAAO,CAAC,CAAC,OAAO,SAAS,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAyB;IAC1C,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9B,OAAO,OAAO,IAAI,SAAS,CAAC;AAC9B,CAAC"}

package/lib/messaging/send.d.ts

@@ -0,0 +1,54 @@
+import type { ChannelTarget, OutboundMessage, SendResult } from '@krischoichoi/channel-core';
+import type { ILinkClient } from '../ilink/client.js';
+import type { ContextTokenStore } from '../storage/context-token.js';
+export interface OutboundSenderOptions {
+    client: ILinkClient;
+    contextTokens: ContextTokenStore;
+    /** Optional default run id scope; defaults to a fresh UUID per send. */
+    runId?: string;
+    /** CDN base URL for outbound image upload. */
+    cdnBaseUrl?: string;
+    /** API base URL for the getuploadurl CGI. */
+    apiBaseUrl?: string;
+    /** Injectable getuploadurl resolver (tests). */
+    getUploadUrl?: (request: Record<string, unknown>) => Promise<{
+        upload_full_url?: string;
+        upload_param?: string;
+        thumb_upload_param?: string;
+    }>;
+    /** Injectable raw upload POST (tests). */
+    upload?: (url: string, form: FormData) => Promise<Response>;
+}
+export interface SendTextParams {
+    to: string;
+    text: string;
+    contextToken?: string;
+    /** Per-send correlation; defaults to a fresh UUID. */
+    runId?: string;
+}
+/**
+ * Build one iLink sendmessage payload for a text message.
+ */
+export declare function buildSendTextPayload(params: SendTextParams): Record<string, unknown>;
+export declare class OutboundSender {
+    private readonly client;
+    private readonly contextTokens;
+    private readonly defaultRunId;
+    private readonly cdnBaseUrl?;
+    private readonly apiBaseUrl?;
+    private readonly getUploadUrl?;
+    private readonly uploadFn?;
+    constructor(options: OutboundSenderOptions);
+    /**
+     * Send an outbound Channel message to a target. Reads the context token for
+     * the target peer, then dispatches text (default) or an image upload+send
+     * when the message carries image bytes. Failures become ChannelError (token
+     * redacted).
+     */
+    send(target: ChannelTarget, message: OutboundMessage): Promise<SendResult>;
+    private sendImage;
+    private sendFile;
+    private sendVideo;
+    private uploadAndSend;
+}
+//# sourceMappingURL=send.d.ts.map

package/lib/messaging/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../src/messaging/send.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,UAAU,EAIX,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAWrE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,EAAE,iBAAiB,CAAC;IACjC,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/I,0CAA0C;IAC1C,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAepF;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAwC;IACtE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAkC;gBAEhD,OAAO,EAAE,qBAAqB;IAU1C;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;YA2ClE,SAAS;YAST,QAAQ;YASR,SAAS;YAST,aAAa;CA2C5B"}

package/lib/messaging/send.js

@@ -0,0 +1,173 @@
+/**
+ * Classification: C — duplicate send payload + orchestration [@deprecated upstream-gap].
+ *
+ * Outbound text/image send payload building + CDN upload routing. The official
+ * messaging/send.js (sendMessageWeixin / sendImageMessageWeixin) is OpenClaw
+ * coupled (imports api/api + util/logger). The text payload builders here
+ * mirror the official shapes; kept behind the facade as an upstream-gap. The
+ * local type/shape enums mirror the Tencent source reference.
+ */
+/**
+ * OutboundSender — builds the real iLink sendmessage payload and calls the
+ * client. The ReplyRouter never generates Weixin protocol fields; they live
+ * here.
+ *
+ * Text is the default path. When the outbound message carries an image part
+ * with local bytes (or a data URI), the sender uploads it to the CDN
+ * (uploadMedia) and sends an image sendmessage (sendMedia) through the same
+ * target + context token + run id, so a media turn correlates identically to a
+ * text turn.
+ */
+import { randomUUID } from 'node:crypto';
+import { collectText } from '@krischoichoi/channel-core';
+import { ChannelError } from '@krischoichoi/channel-core';
+import { MESSAGE_ITEM_TYPE_TEXT, MESSAGE_STATE_FINISH, MESSAGE_TYPE_BOT, } from '../ilink/types.js';
+import { redactMessage } from '../ilink/errors.js';
+import { uploadMedia } from '../media/upload.js';
+import { WX5_MEDIA_TYPE_FILE, WX5_MEDIA_TYPE_IMAGE, WX5_MEDIA_TYPE_VIDEO } from '../media/upload.js';
+import { sendMedia } from '../media/send-media.js';
+/**
+ * Build one iLink sendmessage payload for a text message.
+ */
+export function buildSendTextPayload(params) {
+    return {
+        msg: {
+            from_user_id: '',
+            to_user_id: params.to,
+            client_id: randomUUID(),
+            message_type: MESSAGE_TYPE_BOT,
+            message_state: MESSAGE_STATE_FINISH,
+            item_list: params.text
+                ? [{ type: MESSAGE_ITEM_TYPE_TEXT, text_item: { text: params.text } }]
+                : [],
+            context_token: params.contextToken ?? undefined,
+            run_id: params.runId ?? undefined,
+        },
+    };
+}
+export class OutboundSender {
+    client;
+    contextTokens;
+    defaultRunId;
+    cdnBaseUrl;
+    apiBaseUrl;
+    getUploadUrl;
+    uploadFn;
+    constructor(options) {
+        this.client = options.client;
+        this.contextTokens = options.contextTokens;
+        this.defaultRunId = options.runId;
+        this.cdnBaseUrl = options.cdnBaseUrl;
+        this.apiBaseUrl = options.apiBaseUrl;
+        this.getUploadUrl = options.getUploadUrl;
+        this.uploadFn = options.upload;
+    }
+    /**
+     * Send an outbound Channel message to a target. Reads the context token for
+     * the target peer, then dispatches text (default) or an image upload+send
+     * when the message carries image bytes. Failures become ChannelError (token
+     * redacted).
+     */
+    async send(target, message) {
+        const to = target.conversationId;
+        const runId = target.runId ?? this.defaultRunId ?? randomUUID();
+        const contextToken = await this.contextTokens.get(to);
+        const media = outboundMediaParts(message.parts);
+        const text = message.text ?? collectText(message.parts ?? []);
+        try {
+            // Validate the complete request before sending a caption, otherwise a
+            // rejected media part would leave a misleading partial delivery.
+            if (hasUnsupportedMediaPart(message.parts)) {
+                throw new ChannelError('CHANNEL_UNSUPPORTED', 'weixin outbound media requires local bytes; voice is not supported');
+            }
+            // Tencent 2.4.6 sends an optional caption as its own TEXT request before
+            // the media request; each item_list contains exactly one item.
+            let messageId;
+            if (media.length > 0 && text) {
+                const caption = buildSendTextPayload({ to, text, contextToken, runId });
+                await this.client.sendMessage(caption);
+                messageId = caption.msg.client_id;
+            }
+            for (const part of media) {
+                messageId = part.type === 'image'
+                    ? await this.sendImage(to, part, contextToken, runId)
+                    : part.type === 'file'
+                        ? await this.sendFile(to, part, contextToken, runId)
+                        : await this.sendVideo(to, part, contextToken, runId);
+            }
+            if (media.length > 0) {
+                return { delivered: true, ...(messageId ? { messageId } : {}) };
+            }
+            // Voice has no established Tencent 2.4.6 outbound path. File/video need
+            // local bytes for the encrypted CDN upload, so reject URL-only parts.
+            const payload = buildSendTextPayload({ to, text, contextToken, runId });
+            await this.client.sendMessage(payload);
+            return { delivered: true, messageId: payload.msg.client_id };
+        }
+        catch (error) {
+            const messageText = error instanceof Error ? error.message : String(error);
+            throw new ChannelError('CHANNEL_SEND_FAILED', redactMessage(messageText), { cause: error });
+        }
+    }
+    async sendImage(to, image, contextToken, runId) {
+        return this.uploadAndSend(to, image, contextToken, runId, 'image');
+    }
+    async sendFile(to, file, contextToken, runId) {
+        return this.uploadAndSend(to, file, contextToken, runId, 'file');
+    }
+    async sendVideo(to, video, contextToken, runId) {
+        return this.uploadAndSend(to, video, contextToken, runId, 'video');
+    }
+    async uploadAndSend(to, part, contextToken, runId, kind) {
+        if (!this.client.cdnUrl && !this.cdnBaseUrl) {
+            throw new ChannelError('CHANNEL_UNSUPPORTED', 'outbound media upload requires a CDN base URL');
+        }
+        const cdnBaseUrl = this.cdnBaseUrl ?? this.client.cdnUrl;
+        const apiBaseUrl = this.apiBaseUrl ?? this.client.baseUrl;
+        const mediaType = kind === 'image'
+            ? WX5_MEDIA_TYPE_IMAGE
+            : kind === 'file'
+                ? WX5_MEDIA_TYPE_FILE
+                : WX5_MEDIA_TYPE_VIDEO;
+        const uploaded = await uploadMedia(Buffer.from(part.localData), {
+            cdnBaseUrl,
+            apiBaseUrl,
+            toUserId: to,
+            token: this.client.token,
+            mediaType,
+            getUploadUrl: this.getUploadUrl ?? ((request) => this.client.getUploadUrl(request)),
+            upload: this.uploadFn,
+        });
+        // Tencent 2.4.6 base64-encodes the 32-character ASCII hex key, not the
+        // decoded 16 raw key bytes.
+        const sent = await sendMedia(this.client, {
+            to,
+            kind,
+            media: {
+                encrypt_query_param: uploaded.downloadEncryptedQueryParam,
+                aes_key: uploaded.aeskey ? Buffer.from(uploaded.aeskey, 'ascii').toString('base64') : undefined,
+            },
+            fileSize: uploaded.fileSize,
+            fileSizeCiphertext: uploaded.fileSizeCiphertext,
+            fileName: kind === 'file' ? part.name : undefined,
+            contextToken,
+            runId,
+        });
+        return sent.messageId;
+    }
+}
+function outboundMediaParts(parts) {
+    if (!parts)
+        return [];
+    return parts.filter((part) => (part.type === 'image' || part.type === 'file' || part.type === 'video') &&
+        part.localData !== undefined &&
+        part.localData.byteLength > 0);
+}
+/** True when the message carries an unsupported or non-uploadable media part. */
+function hasUnsupportedMediaPart(parts) {
+    if (!parts)
+        return false;
+    return parts.some((p) => p.type === 'audio' ||
+        ((p.type === 'image' || p.type === 'file' || p.type === 'video') && (!p.localData || p.localData.byteLength === 0)));
+}
+//# sourceMappingURL=send.js.map

package/lib/messaging/send.js.map

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

package/lib/messaging/typing.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Classification: A — DSH glue [keep].
+ *
+ * Best-effort typing indicator over client.sendTyping. Pure DSH wrapper; no
+ * duplicated platform algorithm. Keep; driven by upstream startTyping().
+ */
+/**
+ * TypingController — best-effort typing indicator (WX6-grade).
+ *
+ * Calls `client.sendTyping` when enabled; failures NEVER fail the main
+ * message. Tracks active/stopped so a turn that ends cancels the indicator.
+ */
+import type { ILinkClient } from '../ilink/client.js';
+export interface TypingControllerOptions {
+    client: ILinkClient;
+    /** Whether typing is enabled (from config). */
+    enabled?: boolean;
+    /** Optional typing ticket for the conversation. */
+    typingTicket?: string | (() => Promise<string | undefined> | string | undefined);
+}
+export declare class TypingController {
+    private readonly client;
+    private readonly enabled;
+    private readonly typingTicket?;
+    private active;
+    constructor(options: TypingControllerOptions);
+    get isActive(): boolean;
+    private resolveTicket;
+    /** Start the typing indicator for a user. */
+    start(to: string): Promise<void>;
+    /** Cancel the typing indicator for a user. */
+    stop(to: string): Promise<void>;
+}
+//# sourceMappingURL=typing.d.ts.map

package/lib/messaging/typing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing.d.ts","sourceRoot":"","sources":["../../src/messaging/typing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,WAAW,CAAC;IACpB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;CAClF;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAA0C;IACxE,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,uBAAuB;IAM5C,IAAI,QAAQ,IAAI,OAAO,CAEtB;YAEa,aAAa;IAK3B,6CAA6C;IACvC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBtC,8CAA8C;IACxC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CActC"}

package/lib/messaging/typing.js

@@ -0,0 +1,56 @@
+import { TYPING_STATUS_CANCEL, TYPING_STATUS_TYPING } from '../ilink/types.js';
+export class TypingController {
+    client;
+    enabled;
+    typingTicket;
+    active = false;
+    constructor(options) {
+        this.client = options.client;
+        this.enabled = options.enabled ?? false;
+        this.typingTicket = options.typingTicket;
+    }
+    get isActive() {
+        return this.active;
+    }
+    async resolveTicket() {
+        if (this.typingTicket === undefined)
+            return undefined;
+        return typeof this.typingTicket === 'function' ? this.typingTicket() : this.typingTicket;
+    }
+    /** Start the typing indicator for a user. */
+    async start(to) {
+        if (!this.enabled)
+            return;
+        this.active = true;
+        try {
+            const ticket = await this.resolveTicket();
+            await this.client.sendTyping({
+                ilink_user_id: to,
+                typing_ticket: ticket,
+                status: TYPING_STATUS_TYPING,
+            });
+        }
+        catch {
+            // best effort — typing must never break the main flow.
+            this.active = false;
+        }
+    }
+    /** Cancel the typing indicator for a user. */
+    async stop(to) {
+        if (!this.enabled)
+            return;
+        this.active = false;
+        try {
+            const ticket = await this.resolveTicket();
+            await this.client.sendTyping({
+                ilink_user_id: to,
+                typing_ticket: ticket,
+                status: TYPING_STATUS_CANCEL,
+            });
+        }
+        catch {
+            // best effort
+        }
+    }
+}
+//# sourceMappingURL=typing.js.map

package/lib/messaging/typing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing.js","sourceRoot":"","sources":["../../src/messaging/typing.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAU/E,MAAM,OAAO,gBAAgB;IACV,MAAM,CAAc;IACpB,OAAO,CAAU;IACjB,YAAY,CAA2C;IAChE,MAAM,GAAG,KAAK,CAAC;IAEvB,YAAY,OAAgC;QAC1C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;QACxC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,aAAa;QACzB,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACtD,OAAO,OAAO,IAAI,CAAC,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;IAC3F,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,KAAK,CAAC,EAAU;QACpB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;gBAC3B,aAAa,EAAE,EAAE;gBACjB,aAAa,EAAE,MAAM;gBACrB,MAAM,EAAE,oBAAoB;aAC7B,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;YACvD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,IAAI,CAAC,EAAU;QACnB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1C,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;gBAC3B,aAAa,EAAE,EAAE;gBACjB,aAAa,EAAE,MAAM;gBACrB,MAAM,EAAE,oBAAoB;aAC7B,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;IACH,CAAC;CACF"}

package/lib/storage/context-token.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ContextTokenStore — keyed by `accountId + peerId` -> `context_token`.
+ *
+ * Set on receive (from the inbound message's `from_user_id` + `context_token`),
+ * read on send so the reply carries the correct context. `channel-harness`
+ * never sees the context token — it is entirely internal to this adapter.
+ */
+import type { ChannelStorage } from '@krischoichoi/channel-core';
+export interface ContextTokenStoreOptions {
+    storage: ChannelStorage;
+    /** Local DSH account alias. */
+    accountId?: string;
+}
+export declare class ContextTokenStore {
+    private readonly storage;
+    private readonly accountId;
+    constructor(options: ContextTokenStoreOptions);
+    private key;
+    /** Record the context token for a peer. */
+    set(peerId: string, contextToken: string): Promise<void>;
+    /** Look up the context token for a peer (undefined when none). */
+    get(peerId: string): Promise<string | undefined>;
+    /** Clear token(s) for a peer. */
+    clear(peerId: string): Promise<void>;
+}
+//# sourceMappingURL=context-token.d.ts.map

package/lib/storage/context-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-token.d.ts","sourceRoot":"","sources":["../../src/storage/context-token.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,cAAc,CAAC;IACxB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,wBAAwB;IAK7C,OAAO,CAAC,GAAG;IAIX,2CAA2C;IACrC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D,kEAAkE;IAC5D,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAItD,iCAAiC;IAC3B,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG3C"}

package/lib/storage/context-token.js

@@ -0,0 +1,26 @@
+export class ContextTokenStore {
+    storage;
+    accountId;
+    constructor(options) {
+        this.storage = options.storage;
+        this.accountId = options.accountId ?? 'main';
+    }
+    key(peerId) {
+        return `weixin:context-token:${this.accountId}:${peerId}`;
+    }
+    /** Record the context token for a peer. */
+    async set(peerId, contextToken) {
+        if (!contextToken)
+            return;
+        await this.storage.set(this.key(peerId), contextToken);
+    }
+    /** Look up the context token for a peer (undefined when none). */
+    async get(peerId) {
+        return this.storage.get(this.key(peerId));
+    }
+    /** Clear token(s) for a peer. */
+    async clear(peerId) {
+        await this.storage.delete(this.key(peerId));
+    }
+}
+//# sourceMappingURL=context-token.js.map

package/lib/storage/context-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-token.js","sourceRoot":"","sources":["../../src/storage/context-token.ts"],"names":[],"mappings":"AAeA,MAAM,OAAO,iBAAiB;IACX,OAAO,CAAiB;IACxB,SAAS,CAAS;IAEnC,YAAY,OAAiC;QAC3C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC/C,CAAC;IAEO,GAAG,CAAC,MAAc;QACxB,OAAO,wBAAwB,IAAI,CAAC,SAAS,IAAI,MAAM,EAAE,CAAC;IAC5D,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,YAAoB;QAC5C,IAAI,CAAC,YAAY;YAAE,OAAO;QAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,CAAC;IACzD,CAAC;IAED,kEAAkE;IAClE,KAAK,CAAC,GAAG,CAAC,MAAc;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,KAAK,CAAC,MAAc;QACxB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/lib/storage/sync-cursor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * SyncCursorStore — persists the `get_updates_buf` sync cursor.
+ *
+ * Per doc section 18: the cursor is persisted ONLY AFTER the messages of the
+ * round have entered the Channel inbound pipeline. If we crash before the
+ * commit, the same messages may be re-fetched — that is accepted and handled
+ * by the dedup layer.
+ */
+import type { ChannelStorage } from '@krischoichoi/channel-core';
+export interface SyncCursorStoreOptions {
+    storage: ChannelStorage;
+    /** Local DSH account alias. */
+    accountId?: string;
+}
+export declare class SyncCursorStore {
+    private readonly storage;
+    private readonly accountId;
+    constructor(options: SyncCursorStoreOptions);
+    private key;
+    /** Load the persisted cursor (empty string when none). */
+    load(): Promise<string>;
+    /** Atomically persist a new cursor. */
+    set(cursor: string): Promise<void>;
+    /** Clear the cursor (e.g. on re-auth). */
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=sync-cursor.d.ts.map

package/lib/storage/sync-cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-cursor.d.ts","sourceRoot":"","sources":["../../src/storage/sync-cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,cAAc,CAAC;IACxB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,sBAAsB;IAK3C,OAAO,CAAC,GAAG;IAIX,0DAA0D;IACpD,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAK7B,uCAAuC;IACjC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,0CAA0C;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/lib/storage/sync-cursor.js

@@ -0,0 +1,25 @@
+export class SyncCursorStore {
+    storage;
+    accountId;
+    constructor(options) {
+        this.storage = options.storage;
+        this.accountId = options.accountId ?? 'main';
+    }
+    key() {
+        return `weixin:sync-cursor:${this.accountId}`;
+    }
+    /** Load the persisted cursor (empty string when none). */
+    async load() {
+        const raw = await this.storage.get(this.key());
+        return raw ?? '';
+    }
+    /** Atomically persist a new cursor. */
+    async set(cursor) {
+        await this.storage.set(this.key(), cursor ?? '');
+    }
+    /** Clear the cursor (e.g. on re-auth). */
+    async clear() {
+        await this.storage.delete(this.key());
+    }
+}
+//# sourceMappingURL=sync-cursor.js.map

package/lib/storage/sync-cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-cursor.js","sourceRoot":"","sources":["../../src/storage/sync-cursor.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,eAAe;IACT,OAAO,CAAiB;IACxB,SAAS,CAAS;IAEnC,YAAY,OAA+B;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC/C,CAAC;IAEO,GAAG;QACT,OAAO,sBAAsB,IAAI,CAAC,SAAS,EAAE,CAAC;IAChD,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/C,OAAO,GAAG,IAAI,EAAE,CAAC;IACnB,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,GAAG,CAAC,MAAc;QACtB,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACxC,CAAC;CACF"}

package/lib/transport.d.ts

@@ -0,0 +1,38 @@
+export interface HttpRequestInit {
+    method?: string;
+    /** Optional custom headers; merged over the transport default. */
+    headers?: Record<string, string>;
+    /** JSON body (serialized by the transport). */
+    body?: unknown;
+    /** Per-request timeout override. */
+    timeoutMs?: number;
+}
+export interface HttpTransport {
+    /**
+     * Perform one HTTP request against a full URL.
+     *
+     * @param url  Absolute URL (origin + path + query) to request.
+     * @param init Request options.
+     * @param signal Optional external abort signal (combined with the timeout).
+     * @returns The parsed JSON response body.
+     */
+    request(url: string, init?: HttpRequestInit, signal?: AbortSignal): Promise<unknown>;
+}
+export interface FetchTransportOptions {
+    /** Default request timeout in ms; overridden by `init.timeoutMs`. */
+    timeoutMs: number;
+    /** Injectable fetch (tests). */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Default transport backed by the standard `fetch`. Timeout and external
+ * aborts are combined onto a single `AbortSignal`; HTTP non-2xx responses and
+ * network/timeout/abort failures are normalized to `ChannelError`.
+ */
+export declare class FetchTransport implements HttpTransport {
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(options: FetchTransportOptions);
+    request(url: string, init?: HttpRequestInit, signal?: AbortSignal): Promise<unknown>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/lib/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B;;;;;;;OAOG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtF;AAOD,MAAM,WAAW,qBAAqB;IACpC,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED;;;;GAIG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAE7B,OAAO,EAAE,qBAAqB;IAKpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;CA+B/F"}

package/lib/transport.js

@@ -0,0 +1,68 @@
+/**
+ * Base HTTP transport boundary — a clean `fetch` wrapper.
+ *
+ * This module knows NOTHING about Weixin endpoints or the iLink protocol. It
+ * only turns a URL + method + body into a `fetch` call with a timeout and an
+ * optional external abort signal, normalizing failures into `ChannelError`.
+ * The iLink client (`src/ilink/client.ts`) owns endpoint knowledge and builds
+ * the protocol headers on top of this transport.
+ */
+import { ChannelError } from '@krischoichoi/channel-core';
+/** Default headers attached to every request unless overridden. */
+const DEFAULT_HEADERS = {
+    'content-type': 'application/json',
+};
+/**
+ * Default transport backed by the standard `fetch`. Timeout and external
+ * aborts are combined onto a single `AbortSignal`; HTTP non-2xx responses and
+ * network/timeout/abort failures are normalized to `ChannelError`.
+ */
+export class FetchTransport {
+    timeoutMs;
+    fetchImpl;
+    constructor(options) {
+        this.timeoutMs = options.timeoutMs;
+        this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    }
+    async request(url, init = {}, signal) {
+        const controller = new AbortController();
+        const timeoutMs = init.timeoutMs ?? this.timeoutMs;
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        const onOuterAbort = () => controller.abort();
+        signal?.addEventListener('abort', onOuterAbort, { once: true });
+        try {
+            const response = await this.fetchImpl(url, {
+                method: init.method ?? 'GET',
+                headers: { ...DEFAULT_HEADERS, ...init.headers },
+                body: init.body !== undefined ? JSON.stringify(init.body) : undefined,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new ChannelError('CHANNEL_ERROR', `http ${response.status} on ${safeUrl(url)}`);
+            }
+            const text = await response.text();
+            return text ? JSON.parse(text) : undefined;
+        }
+        catch (error) {
+            if (error instanceof ChannelError)
+                throw error;
+            const aborted = controller.signal.aborted || error?.name === 'AbortError';
+            throw new ChannelError('CHANNEL_ERROR', aborted ? `http request aborted on ${safeUrl(url)}` : `http request failed on ${safeUrl(url)}`, { cause: error });
+        }
+        finally {
+            clearTimeout(timer);
+            signal?.removeEventListener('abort', onOuterAbort);
+        }
+    }
+}
+/** Strip query strings (which may carry signatures) from log output. */
+function safeUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.search ? `${parsed.origin}${parsed.pathname}?<redacted>` : url;
+    }
+    catch {
+        return url.length > 80 ? `${url.slice(0, 80)}…` : url;
+    }
+}
+//# sourceMappingURL=transport.js.map

package/lib/transport.js.map

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