@jingyi0605/codingns 0.6.1 → 0.7.0

package/dist/server/modules/channels/channel-polling-service.js

@@ -0,0 +1,176 @@
+import { AppError } from "../../shared/errors/app-error.js";
+import { nowIso } from "../../shared/utils/time.js";
+import { HOST_TASK_TYPES } from "../tasks/task-types.js";
+import { createWechatClawRuntimeRequiredError } from "./wechat-claw-runtime-boundary.js";
+export class ChannelPollingService {
+    channelAccountRepository;
+    adapterRegistry;
+    channelBridgeService;
+    channelDeliveryService;
+    taskManager;
+    logger;
+    wechatClawRuntimeClient;
+    constructor(channelAccountRepository, adapterRegistry, channelBridgeService, channelDeliveryService, taskManager, options = {}) {
+        this.channelAccountRepository = channelAccountRepository;
+        this.adapterRegistry = adapterRegistry;
+        this.channelBridgeService = channelBridgeService;
+        this.channelDeliveryService = channelDeliveryService;
+        this.taskManager = taskManager;
+        this.logger = options.logger ?? console;
+        this.wechatClawRuntimeClient = options.wechatClawRuntimeClient ?? null;
+        this.registerBackgroundTasks();
+    }
+    requestPoll(accountId, source = "channel.manual_poll") {
+        const account = this.requirePollingAccount(accountId);
+        const requestedAt = nowIso();
+        this.channelAccountRepository.update({
+            ...account,
+            runtimeState: {
+                ...account.runtimeState,
+                lastManualPollRequestedAt: requestedAt,
+                lastManualPollSource: source
+            },
+            updatedAt: requestedAt
+        });
+        const handle = this.taskManager.enqueue(HOST_TASK_TYPES.channelAccountPoll, {
+            key: account.id,
+            source,
+            input: {
+                accountId: account.id,
+                requestedAt
+            }
+        });
+        this.observeBackgroundTask(handle, source);
+        return handle;
+    }
+    async runDuePolls(referenceAt) {
+        const accounts = this.channelAccountRepository
+            .listActiveByConnectionModes(["polling"])
+            .filter((account) => account.platformCode !== "wechat-claw" || this.wechatClawRuntimeClient);
+        for (const account of accounts) {
+            const handle = this.taskManager.enqueue(HOST_TASK_TYPES.channelAccountPoll, {
+                key: account.id,
+                source: "channel.polling_scheduler",
+                input: {
+                    accountId: account.id,
+                    requestedAt: referenceAt
+                }
+            });
+            this.observeBackgroundTask(handle, "channel.polling_scheduler");
+        }
+        return {
+            idle: accounts.length === 0,
+            dueAccountCount: accounts.length
+        };
+    }
+    registerBackgroundTasks() {
+        if (this.taskManager.has(HOST_TASK_TYPES.channelAccountPoll)) {
+            return;
+        }
+        this.taskManager.register({
+            taskType: HOST_TASK_TYPES.channelAccountPoll,
+            executionLane: "host_background",
+            timeoutMs: 70_000,
+            run: async (input) => this.runPollTask(input.accountId, input.requestedAt)
+        });
+    }
+    async runPollTask(accountId, requestedAt) {
+        const account = this.requirePollingAccount(accountId);
+        const adapter = this.adapterRegistry.require(account.platformCode);
+        let pollResult;
+        try {
+            pollResult = await adapter.poll(account);
+        }
+        catch (error) {
+            const failedAt = nowIso();
+            const detail = error instanceof AppError
+                ? error.message
+                : error instanceof Error
+                    ? error.message
+                    : "通讯平台轮询失败";
+            this.channelAccountRepository.update({
+                ...account,
+                status: account.status === "disabled" ? "disabled" : "degraded",
+                runtimeState: {
+                    ...account.runtimeState,
+                    lastPollAt: failedAt,
+                    lastPollFailedAt: failedAt,
+                    lastPollDetail: detail
+                },
+                lastError: detail,
+                updatedAt: failedAt
+            });
+            throw error;
+        }
+        const refreshedAt = nowIso();
+        const updatedAccount = this.channelAccountRepository.update({
+            ...account,
+            status: account.status === "disabled" ? "disabled" : "active",
+            runtimeState: pollResult.runtimeStatePatch
+                ? {
+                    ...account.runtimeState,
+                    ...pollResult.runtimeStatePatch,
+                    lastPollAt: refreshedAt,
+                    lastPollDetail: pollResult.detail ?? null
+                }
+                : {
+                    ...account.runtimeState,
+                    lastPollAt: refreshedAt,
+                    lastPollDetail: pollResult.detail ?? null
+                },
+            lastError: null,
+            updatedAt: refreshedAt
+        });
+        let dispatchedCount = 0;
+        let duplicateCount = 0;
+        for (const message of pollResult.inboundMessages) {
+            const dispatch = await this.channelBridgeService.dispatchInboundText(updatedAccount.id, message);
+            if (dispatch.dispatch.mode === "duplicate") {
+                duplicateCount += 1;
+                continue;
+            }
+            dispatchedCount += 1;
+            void this.channelDeliveryService.deliverAssistantReply(dispatch).catch(() => {
+                return;
+            });
+        }
+        return {
+            accountId: updatedAccount.id,
+            inboundCount: pollResult.inboundMessages.length,
+            dispatchedCount,
+            duplicateCount,
+            requestedAt
+        };
+    }
+    observeBackgroundTask(handle, source) {
+        void handle.promise.catch((error) => {
+            this.logger.error("[channel-polling-service] background poll failed", {
+                accountId: handle.key,
+                source,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        });
+    }
+    requirePollingAccount(accountId) {
+        const account = this.channelAccountRepository.findById(accountId.trim());
+        if (!account) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "CHANNEL_ACCOUNT_NOT_FOUND",
+                detail: "目标通讯平台账号不存在"
+            });
+        }
+        if (account.connectionMode !== "polling") {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "CHANNEL_POLL_UNSUPPORTED",
+                detail: "当前账号不是 polling 模式"
+            });
+        }
+        if (account.platformCode === "wechat-claw" && !this.wechatClawRuntimeClient) {
+            throw createWechatClawRuntimeRequiredError();
+        }
+        return account;
+    }
+}
+//# sourceMappingURL=channel-polling-service.js.map

package/dist/server/modules/channels/channel-polling-service.js.map

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

package/dist/server/modules/channels/channel-service.d.ts

@@ -0,0 +1,108 @@
+import type { ChannelAccount, ChannelDelivery, ChannelInboundEvent, ChannelPlatformCapability, ChannelThread } from "../../types/domain.js";
+import type { ChannelPlatformAdapterRegistry } from "./channel-platform-adapters.js";
+import type { ChannelPollingService } from "./channel-polling-service.js";
+import type { WechatClawRuntimeClient } from "./wechat-claw-runtime-client.js";
+export interface CreateChannelAccountInput {
+    platformCode?: unknown;
+    displayName?: unknown;
+    providerId?: unknown;
+    connectionMode?: unknown;
+    status?: unknown;
+    config?: unknown;
+}
+export interface UpdateChannelAccountInput {
+    displayName?: unknown;
+    providerId?: unknown;
+    connectionMode?: unknown;
+    status?: unknown;
+    config?: unknown;
+}
+export interface ChannelAccountSummary extends ChannelAccount {
+    capability: ChannelPlatformCapability;
+    threadCount: number;
+    inboundEventCount: number;
+    deliveryCount: number;
+}
+export interface ProbeChannelAccountResult {
+    account: ChannelAccountSummary;
+    checkedAt: string;
+    ok: boolean;
+    detail: string;
+    warnings: string[];
+}
+export interface PollChannelAccountResult {
+    account: ChannelAccountSummary;
+    requestedAt: string;
+    accepted: boolean;
+    detail: string;
+}
+type WechatClawLoginStatus = "not_logged_in" | "waiting_scan" | "scan_confirmed" | "active" | "expired";
+export interface WechatClawLoginActionResult {
+    account: ChannelAccountSummary;
+    actedAt: string;
+    detail: string;
+    loginStatus: WechatClawLoginStatus;
+    qrcodeUrl: string | null;
+    qrcodeSourceUrl: string | null;
+    qrcodeText: string | null;
+}
+export interface RemoveChannelAccountResult {
+    accountId: string;
+    displayName: string;
+    removedAt: string;
+}
+interface ChannelAccountRepository {
+    listByUserId(userId: string): ChannelAccount[];
+    findById(id: string): ChannelAccount | null;
+    create(record: ChannelAccount): ChannelAccount;
+    update(record: ChannelAccount): ChannelAccount;
+    delete(id: string): boolean;
+}
+interface ChannelThreadRepository {
+    listByAccountId(channelAccountId: string, limit?: number): ChannelThread[];
+    countByAccountId(channelAccountId: string): number;
+}
+interface ChannelInboundEventRepository {
+    listByAccountId(channelAccountId: string, limit?: number): ChannelInboundEvent[];
+    countByAccountId(channelAccountId: string): number;
+}
+interface ChannelDeliveryRepository {
+    listByAccountId(channelAccountId: string, limit?: number): ChannelDelivery[];
+    countByAccountId(channelAccountId: string): number;
+}
+interface ProviderControlRepository {
+    get(providerId: string): {
+        enabled: boolean;
+    };
+}
+export declare class ChannelService {
+    private readonly channelAccountRepository;
+    private readonly channelThreadRepository;
+    private readonly channelInboundEventRepository;
+    private readonly channelDeliveryRepository;
+    private readonly providerControlRepository;
+    private readonly adapterRegistry;
+    private readonly channelPollingService;
+    private readonly wechatClawRuntimeClient;
+    constructor(channelAccountRepository: ChannelAccountRepository, channelThreadRepository: ChannelThreadRepository, channelInboundEventRepository: ChannelInboundEventRepository, channelDeliveryRepository: ChannelDeliveryRepository, providerControlRepository: ProviderControlRepository, adapterRegistry: ChannelPlatformAdapterRegistry, channelPollingService?: Pick<ChannelPollingService, "requestPoll"> | null, wechatClawRuntimeClient?: WechatClawRuntimeClient | null);
+    listPlatforms(): ChannelPlatformCapability[];
+    listAccounts(userId: string): ChannelAccountSummary[];
+    createAccount(userId: string, input: CreateChannelAccountInput): ChannelAccountSummary;
+    updateAccount(userId: string, accountId: string, input: UpdateChannelAccountInput): ChannelAccountSummary;
+    removeAccount(userId: string, accountId: string): Promise<RemoveChannelAccountResult>;
+    probeAccount(userId: string, accountId: string): Promise<ProbeChannelAccountResult>;
+    requestPoll(userId: string, accountId: string): PollChannelAccountResult;
+    listThreads(userId: string, accountId: string, limit?: number): ChannelThread[];
+    listInboundEvents(userId: string, accountId: string, limit?: number): ChannelInboundEvent[];
+    listDeliveries(userId: string, accountId: string, limit?: number): ChannelDelivery[];
+    startWechatClawLogin(userId: string, accountId: string): Promise<WechatClawLoginActionResult>;
+    refreshWechatClawLogin(userId: string, accountId: string): Promise<WechatClawLoginActionResult>;
+    logoutWechatClaw(userId: string, accountId: string): Promise<WechatClawLoginActionResult>;
+    private toAccountSummary;
+    private getOwnedAccountOrThrow;
+    private ensureProviderEnabled;
+    private requireWechatClawRuntimeClient;
+    private getOwnedWechatClawAccountOrThrow;
+    private syncWechatClawRuntimeState;
+}
+export {};