@xpert-ai/plugin-community-wechat 0.1.0

package/dist/lib/conversation.service.d.ts

@@ -0,0 +1,215 @@
+import { TChatEventContext, type PluginContext } from '@xpert-ai/plugin-sdk';
+import { type Cache } from 'cache-manager';
+import { Repository } from 'typeorm';
+import { TIntegrationWechatPersonalOptions, WechatPersonalInboundEvent } from './types.js';
+import { WechatPersonalChannelStrategy } from './wechat-personal-channel.strategy.js';
+import { WechatPersonalAccountEntity, WechatPersonalConversationBindingEntity, WechatPersonalMessageDirection, WechatPersonalMessageLogEntity, WechatPersonalMessageLogStatus } from './entities/index.js';
+import { WechatPersonalTriggerStrategy } from './workflow/wechat-personal-trigger.strategy.js';
+import { WechatPersonalChatCallbackContext } from './handoff/wechat-personal-chat.types.js';
+type WechatPersonalTenantScope = {
+    tenantId?: string | null;
+    organizationId?: string | null;
+};
+type WechatPersonalConversationState = {
+    conversationId: string;
+    lastActiveAt?: Date;
+};
+export type WechatPersonalConversationListItem = {
+    id: string;
+    integrationId: string;
+    uuid: string;
+    contactId: string;
+    senderId: string;
+    chatType: 'private' | 'group';
+    xpertId: string;
+    conversationId: string;
+    updatedAt: Date | null;
+};
+export type WechatPersonalIntegrationWorkbenchItem = {
+    id: string;
+    name?: string;
+    description?: string;
+    slug?: string;
+    callbackConfig: ReturnType<WechatPersonalConversationService['buildCallbackConfig']>;
+    accountCount: number;
+    conversationCount: number;
+    recentMessageCount: number;
+    errorCount: number;
+    config: Partial<TIntegrationWechatPersonalOptions>;
+};
+export type WechatPersonalWorkbenchData = {
+    scope?: 'integration' | 'organization';
+    integrationId?: string | null;
+    integrations?: WechatPersonalIntegrationWorkbenchItem[];
+    callbackConfig: {
+        webhookUrl: string;
+        globalWebhookUrl: string;
+        setCallbackUrlTemplate: string;
+        setCallbackCurlTemplate: string;
+    };
+    summary: {
+        integrationCount?: number;
+        accountCount: number;
+        conversationCount: number;
+        recentMessageCount: number;
+        errorCount: number;
+    };
+    accounts: WechatPersonalAccountEntity[];
+    conversations: WechatPersonalConversationListItem[];
+    messages: WechatPersonalMessageLogEntity[];
+    logs: WechatPersonalMessageLogEntity[];
+    tables?: Partial<Record<WechatPersonalWorkbenchTableKey, WechatPersonalWorkbenchTableResult>>;
+    config: Partial<TIntegrationWechatPersonalOptions>;
+};
+export type WechatPersonalPagedResult<T> = {
+    items: T[];
+    total: number;
+    page: number;
+    pageSize: number;
+};
+export type WechatPersonalWorkbenchTableKey = 'accounts' | 'conversations' | 'messages' | 'logs';
+export type WechatPersonalWorkbenchTableQuery = {
+    search?: string;
+    page?: number;
+    pageSize?: number;
+    filters?: Record<string, unknown> | null;
+};
+export type WechatPersonalWorkbenchTableResult = (WechatPersonalPagedResult<WechatPersonalAccountEntity> & {
+    key: 'accounts';
+}) | (WechatPersonalPagedResult<WechatPersonalConversationListItem> & {
+    key: 'conversations';
+}) | (WechatPersonalPagedResult<WechatPersonalMessageLogEntity> & {
+    key: 'messages' | 'logs';
+});
+export type WechatPersonalRuntimeStatus = {
+    callbackConfig: WechatPersonalWorkbenchData['callbackConfig'];
+    summary: WechatPersonalWorkbenchData['summary'];
+    triggerBinding: {
+        integrationId: string;
+        xpertId: string;
+        sessionTimeoutSeconds: number;
+        summaryWindowSeconds: number;
+        groupTriggerMode: string;
+        groupKeywords: string[];
+        updatedAt: Date | null;
+    } | null;
+    accounts: WechatPersonalAccountEntity[];
+    recentErrors: WechatPersonalMessageLogEntity[];
+    config: Partial<TIntegrationWechatPersonalOptions>;
+    integrations?: WechatPersonalIntegrationWorkbenchItem[];
+    scope?: 'integration' | 'organization';
+};
+export declare class WechatPersonalConversationService {
+    private readonly wechatChannel;
+    private readonly triggerStrategy;
+    private readonly cacheManager;
+    private readonly conversationBindingRepository;
+    private readonly accountRepository;
+    private readonly messageLogRepository;
+    private readonly pluginContext;
+    private readonly logger;
+    private _integrationPermissionService;
+    constructor(wechatChannel: WechatPersonalChannelStrategy, triggerStrategy: WechatPersonalTriggerStrategy, cacheManager: Cache, conversationBindingRepository: Repository<WechatPersonalConversationBindingEntity>, accountRepository: Repository<WechatPersonalAccountEntity>, messageLogRepository: Repository<WechatPersonalMessageLogEntity>, pluginContext: PluginContext);
+    private get integrationPermissionService();
+    getConversationState(conversationUserKey: string, xpertId: string, scopeOverride?: WechatPersonalTenantScope | null): Promise<WechatPersonalConversationState | undefined>;
+    setConversation(conversationUserKey: string, xpertId: string, conversationId: string, lastActiveAt?: Date | undefined, scopeOverride?: WechatPersonalTenantScope | null): Promise<void>;
+    touchConversation(conversationUserKey: string, xpertId: string, lastActiveAt?: Date, scopeOverride?: WechatPersonalTenantScope | null): Promise<void>;
+    clearConversation(conversationUserKey: string, xpertId: string, scopeOverride?: WechatPersonalTenantScope | null): Promise<void>;
+    restartConversationBinding(integrationId: string, bindingId: string): Promise<void>;
+    handleInboundEvent(event: WechatPersonalInboundEvent, ctx: TChatEventContext<TIntegrationWechatPersonalOptions>): Promise<{
+        handled: boolean;
+        reason?: string;
+    }>;
+    logOutbound(params: {
+        context: WechatPersonalChatCallbackContext;
+        content: string;
+        status: WechatPersonalMessageLogStatus;
+        messageId?: string;
+        error?: string;
+    }): Promise<void>;
+    setAccountEnabled(integrationId: string, uuid: string, enabled: boolean): Promise<void>;
+    resendOutboundMessage(integrationId: string, logId?: string): Promise<{
+        success: boolean;
+        messageId?: string;
+        error?: string;
+    }>;
+    getWorkbenchData(integrationId: string, query?: {
+        search?: string;
+        page?: number;
+        pageSize?: number;
+    }): Promise<WechatPersonalWorkbenchData>;
+    getOrganizationWorkbenchData(query?: {
+        search?: string;
+        page?: number;
+        pageSize?: number;
+    }): Promise<WechatPersonalWorkbenchData>;
+    getRuntimeStatus(integrationId: string): Promise<WechatPersonalRuntimeStatus>;
+    getOrganizationRuntimeStatus(): Promise<WechatPersonalRuntimeStatus>;
+    getBoundIntegrationIdForXpert(xpertId: string): Promise<string | null>;
+    getWorkbenchTableData(integrationId: string, table: WechatPersonalWorkbenchTableKey, query?: WechatPersonalWorkbenchTableQuery): Promise<WechatPersonalWorkbenchTableResult>;
+    getOrganizationWorkbenchTableData(table: WechatPersonalWorkbenchTableKey, query?: WechatPersonalWorkbenchTableQuery): Promise<WechatPersonalWorkbenchTableResult>;
+    listAccounts(integrationId: string, query?: WechatPersonalWorkbenchTableQuery): Promise<WechatPersonalPagedResult<WechatPersonalAccountEntity>>;
+    listOrganizationAccounts(query?: WechatPersonalWorkbenchTableQuery): Promise<WechatPersonalPagedResult<WechatPersonalAccountEntity>>;
+    listConversations(integrationId: string, query?: WechatPersonalWorkbenchTableQuery): Promise<WechatPersonalPagedResult<WechatPersonalConversationListItem>>;
+    listOrganizationConversations(query?: WechatPersonalWorkbenchTableQuery): Promise<WechatPersonalPagedResult<WechatPersonalConversationListItem>>;
+    searchMessageLogs(integrationId: string, query?: {
+        direction?: WechatPersonalMessageDirection;
+        status?: WechatPersonalMessageLogStatus;
+        search?: string;
+        page?: number;
+        pageSize?: number;
+        filters?: Record<string, unknown> | null;
+    }): Promise<WechatPersonalPagedResult<WechatPersonalMessageLogEntity>>;
+    searchOrganizationMessageLogs(query?: {
+        direction?: WechatPersonalMessageDirection;
+        status?: WechatPersonalMessageLogStatus;
+        search?: string;
+        page?: number;
+        pageSize?: number;
+        filters?: Record<string, unknown> | null;
+    }): Promise<WechatPersonalPagedResult<WechatPersonalMessageLogEntity>>;
+    buildCallbackConfig(integrationId: string, callbackSecret?: string): {
+        webhookUrl: string;
+        globalWebhookUrl: string;
+        setCallbackUrlTemplate: string;
+        setCallbackCurlTemplate: string;
+    };
+    private upsertAccount;
+    private isDuplicateInbound;
+    private logInbound;
+    private updateLog;
+    private getConversationCacheKey;
+    private cacheConversation;
+    private resolveTenantScope;
+    private readIntegrationTenantScope;
+    private scopedWhere;
+    private resolveBindingContext;
+    private resolveExecutionUserId;
+    private listWechatPersonalIntegrations;
+    private toIntegrationWorkbenchItem;
+    private sanitizeIntegrationConfig;
+    private emptyCallbackConfig;
+    private matchesAccountFilters;
+    private matchesConversationFilters;
+    private matchesLogFilters;
+    private normalizeFilters;
+    private matchesFilter;
+    private normalizeBooleanFilter;
+    private normalizeDirection;
+    private normalizeLogStatus;
+    private normalizeChatType;
+    private matchesConversationSearch;
+    private matchesLogSearch;
+    private toConversationListItem;
+    private normalizePositiveInt;
+    private normalizePage;
+    private normalizePageSize;
+    private paginateItems;
+    private normalizeListSearch;
+    private normalizeDate;
+    private resolveSessionTimeoutMs;
+    private isConversationExpired;
+    private parseNewSessionCommand;
+    private getNewConversationStartedText;
+}
+export {};