@zhin.js/adapter-wechat-mp 1.0.1 → 1.1.0

package/adapters/wechat-mp.ts

@@ -0,0 +1,38 @@
+/**
+ * Convention entry: discover `adapters/wechat-mp.ts` → defineAdapter.
+ */
+import { defineAdapter } from 'zhin.js/adapter';
+import { httpHostToken } from '@zhin.js/host-http';
+import { WeChatMpEndpoint } from '../src/endpoint.js';
+import {
+  resolveWeChatMpConfig,
+  type WeChatMpAdapterConfig,
+} from '../src/protocol.js';
+import { wechatMpRuntimeStateToken } from '../src/wechat-mp-runtime-state.js';
+
+export { WeChatMpEndpoint } from '../src/endpoint.js';
+export type { WeChatMpEndpointOptions } from '../src/endpoint.js';
+export type { WeChatMpFetch } from '../src/client.js';
+
+export default defineAdapter<WeChatMpAdapterConfig>({
+  capabilities: ['inbound', 'outbound'],
+  // 客服消息媒体统一经 /cgi-bin/media/upload 物化为 media_id（url 下载后上传，
+  // kind=file 的 MediaRef 视为既有 media_id 直传）；公众号无卡片交互面，交互段降级纯文本。
+  segments: {
+    outboundMedia: ['upload'],
+    interactive: 'text',
+  },
+  create(context) {
+    const config = resolveWeChatMpConfig(context.config);
+    // 注册到插件运行时状态（wechat-mp.endpoint list 的"运行中"数据源）
+    context.use(wechatMpRuntimeStateToken).endpoints.set(config.id, {
+      id: config.id,
+      mode: 'webhook',
+    });
+    return new WeChatMpEndpoint({
+      id: context.id,
+      http: context.use(httpHostToken),
+      config,
+    });
+  },
+});

package/commands/endpoint/add/[id].js

@@ -0,0 +1,3 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { wechatMpEndpointCommands } from "../../../lib/wechat-mp-endpoint-commands.js";
+export default wechatMpEndpointCommands.add;

package/commands/endpoint/add/[id].ts

@@ -0,0 +1,3 @@
+import { wechatMpEndpointCommands } from '../../../src/wechat-mp-endpoint-commands.js';
+
+export default wechatMpEndpointCommands.add;

package/commands/endpoint/list.js

@@ -0,0 +1,3 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { wechatMpEndpointCommands } from "../../lib/wechat-mp-endpoint-commands.js";
+export default wechatMpEndpointCommands.list;

package/commands/endpoint/list.ts

@@ -0,0 +1,3 @@
+import { wechatMpEndpointCommands } from '../../src/wechat-mp-endpoint-commands.js';
+
+export default wechatMpEndpointCommands.list;

package/commands/endpoint/remove/[id].js

@@ -0,0 +1,3 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { wechatMpEndpointCommands } from "../../../lib/wechat-mp-endpoint-commands.js";
+export default wechatMpEndpointCommands.remove;

package/commands/endpoint/remove/[id].ts

@@ -0,0 +1,3 @@
+import { wechatMpEndpointCommands } from '../../../src/wechat-mp-endpoint-commands.js';
+
+export default wechatMpEndpointCommands.remove;

package/lib/client.d.ts

@@ -0,0 +1,32 @@
+import type { ResolvedWeChatMpConfig, WeChatAPIResponse } from './protocol.js';
+export type WeChatMpFetch = (url: string, init?: {
+    readonly method?: string;
+    readonly body?: unknown;
+    readonly headers?: Record<string, string>;
+}) => Promise<{
+    readonly data: unknown;
+}>;
+/** Direct WeChat Official Account API client exposed to plugins. */
+export declare class WeChatMpClient {
+    #private;
+    readonly config: ResolvedWeChatMpConfig;
+    readonly fetch: WeChatMpFetch;
+    constructor(config: ResolvedWeChatMpConfig, fetch: WeChatMpFetch);
+    get accessToken(): string | null;
+    get tokenExpired(): boolean;
+    refreshAccessToken(): Promise<string>;
+    request<T = unknown>(path: string, init?: Parameters<WeChatMpFetch>[1]): Promise<T>;
+    sendCustomerService(messageData: unknown): Promise<WeChatAPIResponse>;
+    uploadMedia(type: 'image' | 'voice' | 'video', body: unknown): Promise<string>;
+    getFollowerIds(): Promise<readonly string[]>;
+}
+export type WeChatMpClientEventMap = Record<string, unknown>;
+declare module '@zhin.js/feature-kit' {
+    interface AdapterClientRegistry {
+        readonly 'wechat-mp': {
+            readonly client: WeChatMpClient;
+            readonly events: WeChatMpClientEventMap;
+        };
+    }
+}
+export declare const wechatMpClient: import("@zhin.js/adapter").EndpointClientToken<WeChatMpClient, WeChatMpClientEventMap>;

package/lib/client.js

@@ -0,0 +1,70 @@
+import { defineEndpointClient } from 'zhin.js/adapter';
+const TOKEN_INVALID_ERRCODES = new Set([40001, 40014, 42001]);
+/** Direct WeChat Official Account API client exposed to plugins. */
+export class WeChatMpClient {
+    config;
+    fetch;
+    #accessToken = null;
+    #tokenExpireTime = 0;
+    constructor(config, fetch) {
+        this.config = config;
+        this.fetch = fetch;
+    }
+    get accessToken() {
+        return this.#accessToken;
+    }
+    get tokenExpired() {
+        return !this.#accessToken || Date.now() >= this.#tokenExpireTime;
+    }
+    async refreshAccessToken() {
+        const { appId, appSecret } = this.config;
+        const url = `https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=${appId}&secret=${appSecret}`;
+        const response = await this.fetch(url);
+        const data = response.data;
+        if (!data.access_token) {
+            throw new Error(data.errmsg
+                ? `Failed to get access token: ${data.errcode} ${data.errmsg}`
+                : 'Failed to get access token');
+        }
+        this.#accessToken = data.access_token;
+        this.#tokenExpireTime = Date.now() + (data.expires_in - 300) * 1000;
+        return data.access_token;
+    }
+    async request(path, init) {
+        if (this.tokenExpired)
+            await this.refreshAccessToken();
+        const separator = path.includes('?') ? '&' : '?';
+        const response = await this.fetch(`https://api.weixin.qq.com${path}${separator}access_token=${this.#accessToken}`, init);
+        return response.data;
+    }
+    async sendCustomerService(messageData) {
+        let result = await this.request('/cgi-bin/message/custom/send', { method: 'POST', body: messageData });
+        if (result.errcode && TOKEN_INVALID_ERRCODES.has(Number(result.errcode))) {
+            await this.refreshAccessToken();
+            result = await this.request('/cgi-bin/message/custom/send', { method: 'POST', body: messageData });
+        }
+        return result;
+    }
+    async uploadMedia(type, body) {
+        const data = await this.request(`/cgi-bin/media/upload?type=${type}`, { method: 'POST', body });
+        if (data.media_id)
+            return data.media_id;
+        throw new Error(`WeChat media upload failed: ${data.errcode ?? 'unknown'} ${data.errmsg ?? ''}`.trim());
+    }
+    async getFollowerIds() {
+        const followers = [];
+        let nextOpenid = '';
+        do {
+            const data = await this.request(`/cgi-bin/user/get?next_openid=${encodeURIComponent(nextOpenid)}`);
+            if (data.errcode && data.errcode !== 0) {
+                throw new Error(`WeChat API error: ${data.errcode} - ${data.errmsg}`);
+            }
+            followers.push(...(data.data?.openid ?? []).filter(Boolean));
+            if (Number(data.count ?? 0) < 10_000)
+                break;
+            nextOpenid = data.next_openid ?? '';
+        } while (nextOpenid);
+        return Object.freeze(followers);
+    }
+}
+export const wechatMpClient = defineEndpointClient('wechat-mp');

package/lib/endpoint.d.ts

@@ -1,73 +1,32 @@
-import { EventEmitter } from "events";
-import { Endpoint, Message, MessageSegment, SendOptions } from 'zhin.js';
-import { type Router } from "@zhin.js/host-router/router";
-import type { WeChatMPConfig, WeChatMessage } from "./types.js";
-import type { WeChatMPAdapter } from "./adapter.js";
-export declare class WeChatMPEndpoint extends EventEmitter implements Endpoint<WeChatMPConfig, WeChatMessage> {
-    adapter: WeChatMPAdapter;
-    $config: WeChatMPConfig;
-    $connected: boolean;
-    router: Router;
-    private accessToken;
-    private tokenExpireTime;
-    get logger(): import("zhin.js").Logger;
-    get $id(): string;
-    constructor(adapter: WeChatMPAdapter, router: Router, config: WeChatMPConfig);
-    private setupRoutes;
-    $connect(): Promise<void>;
-    $disconnect(): Promise<void>;
-    private handleVerification;
-    private handleMessage;
-    private computeSignatureHash;
-    private verifySignature;
-    private parseXMLMessage;
-    $formatMessage(wechatMsg: WeChatMessage): Message<WeChatMessage>;
-    static parseMessageContent(wechatMsg: WeChatMessage): MessageSegment[];
-    $sendMessage(options: SendOptions): Promise<string>;
-    $recallMessage(id: string): Promise<void>;
-    private sendCustomerServiceMessage;
-    private formatSendContent;
-    private getReplyMode;
-    private getEncryptMode;
-    private usesPassiveReply;
-    private extractSendText;
-    private collectPassiveReplyXml;
-    private handlePassiveReply;
-    private buildTextReply;
-    private refreshAccessToken;
-    private tokenRefreshTimer?;
-    private startTokenRefreshTimer;
-    getUserInfo(openid: string): Promise<any>;
-    /**
-     * 上传多媒体文件到微信服务器
-     * @param type 媒体类型：image(图片)、voice(语音)、video(视频)、thumb(缩略图)
-     * @param buffer 文件 Buffer
-     * @param filename 文件名（可选，用于确定文件类型）
-     * @returns 微信服务器返回的 media_id
-     */
-    uploadMedia(type: 'image' | 'voice' | 'video' | 'thumb', buffer: Buffer, filename?: string): Promise<string>;
-    /**
-     * 获取文件扩展名
-     */
-    private getFileExtension;
-    /**
-     * 获取 Content-Type
-     */
-    private getContentType;
-    private getAESKey;
-    /** 微信安全模式加密 echostr 为较长 Base64；明文/兼容模式多为短字符串 */
-    private isEncryptedEchostr;
-    /**
-     * 解密安全模式 URL 验证中的 echostr
-     */
-    private decryptEchostr;
-    /**
-     * 解密微信推送的加密消息
-     */
-    private decryptMessage;
-    /**
-     * 加密被动回复消息
-     */
-    private encryptMessage;
+import { Endpoint } from 'zhin.js/adapter';
+import type { EndpointManagement, EndpointSendRequest } from 'zhin.js/adapter';
+import type { HttpHost } from '@zhin.js/host-http';
+import type { CapabilityId } from 'zhin.js';
+import { type ResolvedWeChatMpConfig, type WeChatMessage } from './protocol.js';
+import { WeChatMpClient, type WeChatMpFetch } from './client.js';
+export interface WeChatMpEndpointOptions {
+    readonly id: CapabilityId;
+    readonly http: HttpHost;
+    readonly config: ResolvedWeChatMpConfig;
+    readonly fetch?: WeChatMpFetch;
+}
+export declare class WeChatMpEndpoint extends Endpoint<WeChatMpClient> {
+    #private;
+    readonly client: WeChatMpClient;
+    readonly management: EndpointManagement;
+    constructor(options: WeChatMpEndpointOptions);
+    /** Used by webhook handler. */
+    get isOpen(): boolean;
+    get config(): ResolvedWeChatMpConfig;
+    get id(): CapabilityId;
+    /** 微信 5s 重推去重：见过该 MsgId 时返回首次回复 XML（含空串=success）。 */
+    getCachedReply(msgId: string): string | undefined;
+    cacheReply(msgId: string, replyXML: string): void;
+    start(): Promise<void>;
+    open(): void;
+    close(): void;
+    stop(): Promise<void>;
+    send({ conversation, payload }: EndpointSendRequest): Promise<string>;
+    /** Test / internal: admit a parsed message when open (non-webhook path). */
+    admit(msg: WeChatMessage): void | Promise<unknown>;
 }
-//# sourceMappingURL=endpoint.d.ts.map