@jingyi0605/codingns 0.6.1 → 0.7.0

package/dist/server/helpers/wechat-claw-runtime/modules/login-service.js

@@ -0,0 +1,209 @@
+import { nowIso } from "../../../shared/utils/time.js";
+import { DEFAULT_WECHAT_CLAW_BOT_TYPE, DEFAULT_WECHAT_CLAW_API_BASE_URL } from "./types.js";
+import { invalidWechatClawInput, wechatClawUpstreamError } from "./errors.js";
+export class WechatClawLoginService {
+    store;
+    apiClient;
+    constructor(store, apiClient) {
+        this.store = store;
+        this.apiClient = apiClient;
+    }
+    async startLogin(accountId, config) {
+        const normalizedAccountId = accountId.trim();
+        if (!normalizedAccountId) {
+            throw invalidWechatClawInput("accountId 不能为空", "accountId");
+        }
+        const current = this.store.getAccountSession(normalizedAccountId);
+        if (current
+            && (current.status === "waiting_scan" || current.status === "scan_confirmed")
+            && current.qrCodeUrl
+            && isRenderableQrCodeDataUrl(current.qrCodeUrl)
+            && !isExpired(current.expiresAt)) {
+            return {
+                accountId: normalizedAccountId,
+                actedAt: nowIso(),
+                detail: "二维码仍然有效，可以继续扫码。",
+                session: this.store.toSessionView(current)
+            };
+        }
+        const qr = await this.apiClient.getBotQrCode({
+            apiBaseUrl: config.loginBaseUrl ?? DEFAULT_WECHAT_CLAW_API_BASE_URL,
+            botType: normalizeBotType(config.botType),
+            routeTag: config.routeTag
+        });
+        if (!qr.qrcode || !qr.qrcode_img_content) {
+            throw wechatClawUpstreamError("微信登录二维码响应缺少 qrcode 或二维码地址");
+        }
+        const qrCodeImageDataUrl = await this.apiClient.renderQrCodeDataUrl({
+            text: qr.qrcode_img_content
+        });
+        const session = this.store.saveAccountSession(normalizedAccountId, {
+            status: "waiting_scan",
+            loginSessionKey: current?.loginSessionKey ?? `${normalizedAccountId}:${Date.now()}`,
+            loginQrcode: qr.qrcode,
+            qrCodeUrl: qrCodeImageDataUrl,
+            qrCodeSourceUrl: qr.qrcode_img_content,
+            apiBaseUrl: normalizeApiBaseUrl(config.apiBaseUrl),
+            token: null,
+            providerAccountId: null,
+            userId: null,
+            lastErrorCode: null,
+            lastErrorMessage: null,
+            loginStartedAt: nowIso(),
+            expiresAt: new Date(Date.now() + 5 * 60_000).toISOString()
+        });
+        return {
+            accountId: normalizedAccountId,
+            actedAt: nowIso(),
+            detail: "二维码已生成，请用微信扫码确认。",
+            session: this.store.toSessionView(session)
+        };
+    }
+    async refreshLoginStatus(accountId) {
+        const normalizedAccountId = accountId.trim();
+        const current = this.store.getAccountSession(normalizedAccountId);
+        if (!current) {
+            const session = this.store.saveAccountSession(normalizedAccountId, {
+                status: "not_logged_in",
+                lastErrorCode: null,
+                lastErrorMessage: null
+            });
+            return {
+                accountId: normalizedAccountId,
+                checkedAt: nowIso(),
+                detail: "当前还没有登录会话，请先生成二维码。",
+                session: this.store.toSessionView(session)
+            };
+        }
+        if (current.status === "active") {
+            const activeSession = current.qrCodeUrl || current.qrCodeSourceUrl || current.loginQrcode
+                ? this.store.saveAccountSession(normalizedAccountId, {
+                    status: "active",
+                    loginQrcode: null,
+                    qrCodeUrl: null,
+                    qrCodeSourceUrl: null,
+                    expiresAt: null,
+                    lastErrorCode: null,
+                    lastErrorMessage: null
+                })
+                : current;
+            return {
+                accountId: normalizedAccountId,
+                checkedAt: nowIso(),
+                detail: "微信账号已登录。",
+                session: this.store.toSessionView(activeSession)
+            };
+        }
+        if (!current.loginQrcode) {
+            const next = this.store.saveAccountSession(normalizedAccountId, {
+                status: "not_logged_in",
+                lastErrorCode: null,
+                lastErrorMessage: "当前没有可刷新的二维码，请重新开始登录。"
+            });
+            return {
+                accountId: normalizedAccountId,
+                checkedAt: nowIso(),
+                detail: "当前没有可刷新的二维码，请重新开始登录。",
+                session: this.store.toSessionView(next)
+            };
+        }
+        const status = await this.apiClient.getQrCodeStatus({
+            apiBaseUrl: current.apiBaseUrl ?? DEFAULT_WECHAT_CLAW_API_BASE_URL,
+            qrcode: current.loginQrcode
+        });
+        const checkedAt = nowIso();
+        const redirectBaseUrl = normalizeRedirectBaseUrl(status.redirect_host);
+        if (status.status === "confirmed" && status.bot_token) {
+            const next = this.store.saveAccountSession(normalizedAccountId, {
+                status: "active",
+                loginQrcode: null,
+                qrCodeUrl: null,
+                qrCodeSourceUrl: null,
+                providerAccountId: status.ilink_bot_id ?? current.providerAccountId,
+                apiBaseUrl: status.baseurl ?? redirectBaseUrl ?? current.apiBaseUrl,
+                token: status.bot_token,
+                userId: status.ilink_user_id ?? current.userId,
+                lastErrorCode: null,
+                lastErrorMessage: null,
+                expiresAt: null
+            });
+            return {
+                accountId: normalizedAccountId,
+                checkedAt,
+                detail: "扫码确认成功，微信账号已进入可用状态。",
+                session: this.store.toSessionView(next)
+            };
+        }
+        if (status.status === "expired") {
+            const next = this.store.saveAccountSession(normalizedAccountId, {
+                status: "expired",
+                token: null,
+                lastErrorCode: "QR_EXPIRED",
+                lastErrorMessage: "二维码已过期，请重新开始登录。"
+            });
+            return {
+                accountId: normalizedAccountId,
+                checkedAt,
+                detail: "二维码已过期，请重新生成。",
+                session: this.store.toSessionView(next)
+            };
+        }
+        const next = this.store.saveAccountSession(normalizedAccountId, {
+            status: status.status === "scaned" || status.status === "scaned_but_redirect"
+                ? "scan_confirmed"
+                : "waiting_scan",
+            apiBaseUrl: status.baseurl ?? redirectBaseUrl ?? current.apiBaseUrl,
+            lastErrorCode: null,
+            lastErrorMessage: null
+        });
+        return {
+            accountId: normalizedAccountId,
+            checkedAt,
+            detail: next.status === "scan_confirmed" ? "已扫码，请在手机上继续确认。" : "等待扫码。",
+            session: this.store.toSessionView(next)
+        };
+    }
+    logout(accountId) {
+        this.store.clearAccountRuntimeState(accountId.trim());
+        return {
+            accountId: accountId.trim(),
+            actedAt: nowIso(),
+            detail: "微信 helper 私有运行态已清理。",
+            session: null
+        };
+    }
+}
+function normalizeBotType(value) {
+    const normalized = value?.trim();
+    return normalized && normalized.length > 0 ? normalized : DEFAULT_WECHAT_CLAW_BOT_TYPE;
+}
+function normalizeApiBaseUrl(value) {
+    const normalized = value?.trim();
+    return normalized && normalized.length > 0 ? normalized : DEFAULT_WECHAT_CLAW_API_BASE_URL;
+}
+function normalizeRedirectBaseUrl(host) {
+    const normalized = host?.trim();
+    return normalized ? `https://${normalized}` : null;
+}
+function isExpired(expiresAt) {
+    if (!expiresAt) {
+        return false;
+    }
+    const timestamp = Date.parse(expiresAt);
+    return Number.isFinite(timestamp) && timestamp <= Date.now();
+}
+function isRenderableQrCodeDataUrl(value) {
+    const normalized = value.trim();
+    const prefix = "data:image/svg+xml;base64,";
+    if (!normalized.startsWith(prefix)) {
+        return false;
+    }
+    try {
+        const decoded = Buffer.from(normalized.slice(prefix.length), "base64").toString("utf8");
+        return decoded.includes("<svg");
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=login-service.js.map

package/dist/server/helpers/wechat-claw-runtime/modules/login-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login-service.js","sourceRoot":"","sources":["../../../../../src/helpers/wechat-claw-runtime/modules/login-service.ts"],"names":[],"mappings":"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"}

package/dist/server/helpers/wechat-claw-runtime/modules/poll-service.d.ts

@@ -0,0 +1,18 @@
+import type { WechatClawRuntimeAccountConfig, WechatClawRuntimePollResult } from "./types.js";
+import { WechatClawRuntimeStateStore } from "./runtime-state-store.js";
+import { WechatClawApiClient } from "./wechat-api-client.js";
+export declare class WechatClawPollService {
+    private readonly store;
+    private readonly apiClient;
+    constructor(store: WechatClawRuntimeStateStore, apiClient: WechatClawApiClient);
+    probe(accountId: string, config: WechatClawRuntimeAccountConfig): Promise<{
+        accountId: string;
+        checkedAt: string;
+        ok: boolean;
+        detail: string;
+        warnings: string[];
+        session: ReturnType<WechatClawRuntimeStateStore["toSessionView"]>;
+    }>;
+    poll(accountId: string, config: WechatClawRuntimeAccountConfig): Promise<WechatClawRuntimePollResult>;
+    private normalizeInboundMessage;
+}

package/dist/server/helpers/wechat-claw-runtime/modules/poll-service.js

@@ -0,0 +1,135 @@
+import { nowIso } from "../../../shared/utils/time.js";
+import { wechatClawStateError, wechatClawUpstreamError } from "./errors.js";
+export class WechatClawPollService {
+    store;
+    apiClient;
+    constructor(store, apiClient) {
+        this.store = store;
+        this.apiClient = apiClient;
+    }
+    async probe(accountId, config) {
+        const session = this.store.getAccountSession(accountId.trim());
+        const checkedAt = nowIso();
+        if (!session || session.status !== "active" || !session.token) {
+            return {
+                accountId: accountId.trim(),
+                checkedAt,
+                ok: false,
+                detail: "微信账号还没有完成扫码登录。",
+                warnings: [],
+                session: this.store.toSessionView(session)
+            };
+        }
+        if (!session.userId) {
+            return {
+                accountId: accountId.trim(),
+                checkedAt,
+                ok: true,
+                detail: "微信账号已登录，但当前还没有最近会话上下文。",
+                warnings: ["用户 ID 还没有回填，后续收到第一条微信消息后会自动补齐。"],
+                session: this.store.toSessionView(session)
+            };
+        }
+        const response = await this.apiClient.getConfig({
+            apiBaseUrl: session.apiBaseUrl ?? config.apiBaseUrl,
+            token: session.token,
+            userId: session.userId
+        });
+        if (response.ret && response.ret !== 0) {
+            throw wechatClawUpstreamError(`微信 getconfig 返回异常：ret=${response.ret} ${response.errmsg ?? ""}`.trim());
+        }
+        return {
+            accountId: accountId.trim(),
+            checkedAt,
+            ok: true,
+            detail: "微信 helper 已完成上游探活。",
+            warnings: response.typing_ticket ? [] : ["上游没有返回 typing_ticket，当前先只使用文本收发。"],
+            session: this.store.toSessionView(session)
+        };
+    }
+    async poll(accountId, config) {
+        const normalizedAccountId = accountId.trim();
+        const session = this.store.getAccountSession(normalizedAccountId);
+        if (!session || session.status !== "active" || !session.token) {
+            throw wechatClawStateError("微信账号还没有完成扫码登录，不能开始 poll。");
+        }
+        const checkpoint = this.store.getPollCheckpoint(normalizedAccountId);
+        const response = await this.apiClient.getUpdates({
+            apiBaseUrl: session.apiBaseUrl ?? config.apiBaseUrl,
+            token: session.token,
+            cursor: checkpoint?.cursor ?? null
+        });
+        if ((response.ret ?? 0) !== 0) {
+            if (response.errcode === -14) {
+                this.store.saveAccountSession(normalizedAccountId, {
+                    status: "expired",
+                    token: null,
+                    lastErrorCode: String(response.errcode),
+                    lastErrorMessage: response.errmsg ?? "微信登录态已失效，请重新扫码。"
+                });
+            }
+            throw wechatClawUpstreamError(`微信 getupdates 返回异常：ret=${response.ret ?? "unknown"} errcode=${response.errcode ?? "unknown"} ${response.errmsg ?? ""}`.trim());
+        }
+        const inboundMessages = (response.msgs ?? [])
+            .map((message) => this.normalizeInboundMessage(normalizedAccountId, message))
+            .filter((message) => Boolean(message));
+        const latestExternalEventId = inboundMessages.length > 0
+            ? inboundMessages[inboundMessages.length - 1].externalEventId
+            : checkpoint?.latestExternalEventId ?? null;
+        this.store.setPollCheckpoint(normalizedAccountId, {
+            cursor: response.get_updates_buf ?? checkpoint?.cursor ?? null,
+            latestExternalEventId
+        });
+        return {
+            accountId: normalizedAccountId,
+            checkedAt: nowIso(),
+            detail: `本次轮询拿到 ${inboundMessages.length} 条文本消息。`,
+            inboundMessages
+        };
+    }
+    normalizeInboundMessage(accountId, message) {
+        if (message.message_type === 2) {
+            return null;
+        }
+        const text = (message.item_list ?? [])
+            .filter((item) => item.type === 1)
+            .map((item) => item.text_item?.text?.trim() ?? "")
+            .filter((item) => item.length > 0)
+            .join("\n");
+        if (!text) {
+            return null;
+        }
+        const externalUserId = message.from_user_id?.trim() ?? null;
+        const externalConversationKey = externalUserId
+            ?? message.session_id?.trim()
+            ?? message.to_user_id?.trim()
+            ?? null;
+        if (!externalConversationKey) {
+            return null;
+        }
+        if (message.context_token && externalUserId) {
+            this.store.upsertContextToken(accountId, {
+                conversationKey: externalConversationKey,
+                externalUserId,
+                token: message.context_token,
+                status: "active"
+            });
+        }
+        return {
+            externalEventId: String(message.message_id ?? message.seq ?? `${externalConversationKey}:${message.create_time_ms ?? Date.now()}`),
+            externalConversationKey,
+            externalUserId,
+            externalThreadKey: null,
+            text,
+            senderDisplayName: externalUserId,
+            rawPayload: message,
+            transportContext: {
+                contextToken: message.context_token ?? null,
+                fromUserId: message.from_user_id ?? null,
+                toUserId: message.to_user_id ?? null,
+                sessionId: message.session_id ?? null
+            }
+        };
+    }
+}
+//# sourceMappingURL=poll-service.js.map

package/dist/server/helpers/wechat-claw-runtime/modules/poll-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll-service.js","sourceRoot":"","sources":["../../../../../src/helpers/wechat-claw-runtime/modules/poll-service.ts"],"names":[],"mappings":"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"}

package/dist/server/helpers/wechat-claw-runtime/modules/runtime-state-store.d.ts

@@ -0,0 +1,34 @@
+import type { WechatClawAccountSessionRecord, WechatClawContextTokenRecord, WechatClawDeliveryReceiptRecord, WechatClawPollCheckpointRecord, WechatClawRuntimeLoginStatus, WechatClawRuntimeSessionView } from "./types.js";
+export declare class WechatClawRuntimeStateStore {
+    private readonly db;
+    constructor(runtimeRootDir: string);
+    dispose(): void;
+    getAccountSession(channelAccountId: string): WechatClawAccountSessionRecord | null;
+    saveAccountSession(channelAccountId: string, patch: Partial<WechatClawAccountSessionRecord> & {
+        status: WechatClawRuntimeLoginStatus;
+    }): WechatClawAccountSessionRecord;
+    clearAccountRuntimeState(channelAccountId: string): void;
+    getPollCheckpoint(channelAccountId: string): WechatClawPollCheckpointRecord | null;
+    setPollCheckpoint(channelAccountId: string, input: {
+        cursor: string | null;
+        latestExternalEventId: string | null;
+    }): WechatClawPollCheckpointRecord;
+    getContextToken(channelAccountId: string, conversationKey: string, externalUserId: string): WechatClawContextTokenRecord | null;
+    listContextTokensByUser(channelAccountId: string, externalUserId: string): WechatClawContextTokenRecord[];
+    upsertContextToken(channelAccountId: string, input: {
+        conversationKey: string;
+        externalUserId: string;
+        token: string;
+        status?: string;
+        expiresAt?: string | null;
+    }): WechatClawContextTokenRecord;
+    saveDeliveryReceipt(channelAccountId: string, input: {
+        providerMessageRef: string;
+        status: string;
+        errorCode?: string | null;
+        errorMessage?: string | null;
+    }): WechatClawDeliveryReceiptRecord;
+    toSessionView(session: WechatClawAccountSessionRecord | null): WechatClawRuntimeSessionView | null;
+    private initializeSchema;
+    private ensureColumn;
+}