fmode-ng 0.0.231 → 0.0.233

package/lib/core/agent/chat/fmode-chat.d.ts

@@ -3,6 +3,7 @@ import { FmodeTTS } from "../../voice/tts";
 import { NovaCloudService } from "../../../nova-cloud";
 import { NovaUploadService } from "../../../storage/service-upload/nova-upload.service";
 import { ChatImageContentItem, FmodeChatEventMap, FmodeChatMessage, FmodeChatMessageVoice, FmodeChatVoiceConfig } from "./interface";
+import { MessageScene } from "./message";
 export declare function getMessageContentText(content: any | string | Array<ChatImageContentItem>): string;
 export declare function getMessageImageUrl(content: any | string | Array<ChatImageContentItem>): any;
 /**
@@ -15,7 +16,8 @@ export declare class FmodeChat {
     ChatSession: new () => FmodeObject;
     chatSession: FmodeObject;
     role: any;
-    messageList: FmodeChatMessage[];
+    private messageManager;
+    private company;
     latestAIResponse: string | undefined;
     chatServ: any;
     userInput: string;
@@ -87,6 +89,38 @@ export declare class FmodeChat {
     uploadServ: NovaUploadService;
     constructor(sessionId: string, role?: FmodeObject, chatSession?: FmodeObject, chatServ?: any, navCtrl?: any, //NavController,
     ncloud?: NovaCloudService, uploadServ?: NovaUploadService);
+    /**
+     * 获取消息列表（兼容老版本）
+     */
+    getMessageList(): Promise<FmodeChatMessage[]>;
+    /**
+     * 获取消息列表（同步版本，用于兼容）
+     */
+    get messageList(): FmodeChatMessage[];
+    /**
+     * 设置消息列表（主要用于兼容老版本）
+     */
+    set messageList(messages: FmodeChatMessage[]);
+    /**
+     * 初始化消息管理器
+     */
+    private initMessageManager;
+    /**
+     * 初始化企业信息
+     */
+    initCompany(): Promise<void>;
+    /**
+     * 添加消息
+     */
+    addMessage(content: FmodeChatMessage, scene?: MessageScene): Promise<void>;
+    /**
+     * 更新消息
+     */
+    updateMessage(index: number, content: FmodeChatMessage): Promise<void>;
+    /**
+     * 重新加载消息
+     */
+    reloadMessages(): Promise<void>;
     /**
      * 会话Avatar控制
      */

package/lib/core/agent/chat/interface.d.ts

@@ -33,6 +33,8 @@ export interface FmodeChatMessage {
     createdAt?: Date;
     complete?: boolean;
     voice?: FmodeChatMessageVoice;
+    source?: string;
+    id?: string;
     /**AI回复消息字段 */
     cid?: string;
 }

package/lib/core/agent/chat/message/index.d.ts

@@ -0,0 +1,2 @@
+export * from './message';
+export * from './message-manager';

package/lib/core/agent/chat/message/message-manager.d.ts

@@ -0,0 +1,86 @@
+import { FmodeObject } from "../../../../core/parse";
+import { FmodeChatMessage } from "../interface";
+import { MessageScene } from "./message";
+/**
+ * MessageManagerOptions - 消息管理器配置
+ */
+export interface MessageManagerOptions {
+    chatSession?: FmodeObject;
+    role?: FmodeObject;
+    company: FmodeObject;
+    group?: FmodeObject;
+    userFrom?: FmodeObject;
+    userTo?: FmodeObject;
+    contact?: FmodeObject;
+    scene?: MessageScene;
+}
+/**
+ * MessageManager - 通用消息管理器
+ * 职责：管理不同场景的消息获取、缓存、合并
+ */
+export declare class MessageManager {
+    private options;
+    private _newMessages;
+    private _legacyMessages;
+    private _mergedMessages;
+    private _isDirty;
+    constructor(options: MessageManagerOptions);
+    /**
+     * 获取合并后的消息列表
+     */
+    getMessages(): Promise<FmodeChatMessage[]>;
+    /**
+     * 添加新消息（通用方法）
+     */
+    addMessage(message: FmodeChatMessage, scene?: MessageScene): Promise<void>;
+    /**
+     * 更新消息
+     */
+    updateMessage(index: number, message: FmodeChatMessage): Promise<void>;
+    /**
+     * 重新加载消息
+     */
+    reloadMessages(): Promise<void>;
+    /**
+     * 加载并合并消息
+     */
+    private loadAndMergeMessages;
+    /**
+     * 获取消息统计
+     */
+    getStats(): {
+        total: number;
+        legacy: number;
+        new: number;
+        user: number;
+        assistant: number;
+    };
+    /**
+     * 搜索消息
+     */
+    searchMessages(keyword: string): Promise<FmodeChatMessage[]>;
+    /**
+     * 清空缓存
+     */
+    clearCache(): void;
+    /**
+     * 创建智能体对话消息管理器
+     */
+    static createForRole(chatSession: FmodeObject, role: FmodeObject, company: FmodeObject): MessageManager;
+    /**
+     * 创建群聊消息管理器
+     */
+    static createForGroup(group: FmodeObject, company: FmodeObject): MessageManager;
+    /**
+     * 创建用户私聊消息管理器
+     */
+    static createForUser(userFrom: FmodeObject, userTo: FmodeObject, company: FmodeObject): MessageManager;
+    /**
+     * 创建客服消息管理器
+     */
+    static createForService(contact: FmodeObject, company: FmodeObject): MessageManager;
+    /**
+     * 创建通用消息管理器
+     */
+    static create(options: MessageManagerOptions): MessageManager;
+}

package/lib/core/agent/chat/message/message.d.ts

@@ -0,0 +1,175 @@
+import { FmodeObject, FmodeQuery } from "../../../../core/parse";
+import { FmodeChatMessage, ChatImageContentItem, FmodeChatMessageVoice } from "../interface";
+/**
+ * 消息场景枚举
+ */
+export declare enum MessageScene {
+    ROLE = "role",// 智能体角色对话
+    USER = "user",// 用户私聊
+    GROUP = "group",// 群聊消息
+    SERVICE = "service"
+}
+/**
+ * 消息类型枚举
+ */
+export declare enum MessageType {
+    TEXT = "text",
+    IMAGE = "image",
+    VOICE = "voice",
+    AGENT_TASK = "agent_task",
+    SYSTEM = "system",
+    EXTERNAL = "external"
+}
+/**
+ * 消息角色枚举
+ */
+export declare enum MessageRole {
+    USER = "user",
+    ASSISTANT = "assistant",
+    SYSTEM = "system",
+    AGENT = "agent",
+    EXTERNAL = "external"
+}
+/**
+ * 消息状态枚举
+ */
+export declare enum MessageStatus {
+    SENDING = "sending",
+    SENT = "sent",
+    DELIVERED = "delivered",
+    READ = "read",
+    FAILED = "failed"
+}
+/**
+ * 发送消息参数接口
+ */
+export interface SendMessageParams {
+    content: {
+        type: string;
+        role: string;
+        content: string | Array<ChatImageContentItem>;
+        json?: any;
+        hidden?: boolean;
+        complete?: boolean;
+        voice?: FmodeChatMessageVoice;
+        cid?: string;
+        createdAt?: Date;
+    };
+    scene: MessageScene;
+    company: FmodeObject;
+    session?: FmodeObject;
+    group?: FmodeObject;
+    userFrom?: FmodeObject;
+    userTo?: FmodeObject;
+    role?: FmodeObject;
+    external?: {
+        source: string;
+        id: string;
+        [key: string]: any;
+    };
+    contact?: FmodeObject;
+    attachments?: Array<any>;
+    metadata?: any;
+}
+/**
+ * Message 类 - 纯粹的CRUD操作类
+ * 职责单一：只负责Message表的数据操作
+ */
+export declare class Message {
+    private parseObject;
+    constructor(parseObject?: FmodeObject);
+    /**
+     * 创建新消息
+     */
+    static create(params: SendMessageParams): Message;
+    /**
+     * 保存消息
+     */
+    save(options?: {
+        useMasterKey?: boolean;
+    }): Promise<Message>;
+    /**
+     * 更新消息内容
+     */
+    updateContent(content: any): Message;
+    /**
+     * 更新消息状态
+     */
+    updateStatus(status: MessageStatus): Message;
+    /**
+     * 获取消息ID
+     */
+    get id(): string | undefined;
+    /**
+     * 获取消息内容
+     */
+    get(key: string): any;
+    /**
+     * 设置消息内容
+     */
+    set(key: string, value: any): Message;
+    /**
+     * 转换为 FmodeChatMessage 格式
+     */
+    toFmodeChatMessage(): FmodeChatMessage;
+    /**
+     * 获取Parse对象
+     */
+    getParseObject(): FmodeObject;
+    /**
+     * 静态方法：从Parse对象创建
+     */
+    static fromParseObject(parseObject: FmodeObject): Message;
+    /**
+     * 静态方法：创建查询
+     */
+    static query(): FmodeQuery;
+    /**
+     * 静态方法：根据场景查询
+     */
+    static queryByScene(scene: MessageScene): FmodeQuery;
+    /**
+     * 静态方法：查询角色对话消息
+     */
+    static findRoleMessages(session: FmodeObject, options?: {
+        limit?: number;
+        skip?: number;
+        ascending?: boolean;
+    }): Promise<Message[]>;
+    /**
+     * 静态方法：查询群聊消息
+     */
+    static findGroupMessages(group: FmodeObject, options?: {
+        limit?: number;
+        skip?: number;
+        ascending?: boolean;
+    }): Promise<Message[]>;
+    /**
+     * 静态方法：查询用户私聊消息
+     */
+    static findUserMessages(userFrom: FmodeObject, userTo: FmodeObject, options?: {
+        limit?: number;
+        skip?: number;
+        ascending?: boolean;
+    }): Promise<Message[]>;
+    /**
+     * 静态方法：查询客服消息
+     */
+    static findServiceMessages(contact: FmodeObject, options?: {
+        limit?: number;
+        skip?: number;
+        ascending?: boolean;
+    }): Promise<Message[]>;
+    /**
+     * 静态方法：根据外部消息ID查询
+     */
+    static findByExternalId(source: string, externalId: string): Promise<Message | null>;
+    /**
+     * 根据 FmodeChatMessage 判断消息类型
+     */
+    static getMessageType(fmodeMessage: FmodeChatMessage): string;
+    /**
+     * 从 FmodeChatMessage 创建 Message 对象
+     */
+    static fromFmodeChatMessage(fmodeMessage: FmodeChatMessage, params: Omit<SendMessageParams, 'content'>): Message;
+}

package/lib/core/ecom/index.d.ts

@@ -0,0 +1 @@
+export * from "./shopee/index";

package/lib/core/ecom/shopee/index.d.ts

@@ -0,0 +1 @@
+export * from "./src/index";

package/lib/core/ecom/shopee/src/client.d.ts

@@ -0,0 +1,51 @@
+import { ShopeeSDKConfig, RequestOptions, ApiResponse } from './types';
+/**
+ * Base Shopee SDK Client
+ * Provides the core functionality for making API requests to Shopee via the forwarding endpoint
+ */
+export declare class ShopeeClient {
+    private serverUrl;
+    private timeout;
+    private headers;
+    environment: string;
+    constructor(config: ShopeeSDKConfig);
+    /**
+     * Make an API request to the forwarding endpoint
+     * @param shopId Shop ID
+     * @param options Request options
+     * @returns Promise resolving to the API response
+     */
+    request<T = any>(shopId: number, options: RequestOptions): Promise<ApiResponse<T>>;
+    /**
+     * Convenience method for GET requests
+     */
+    get<T = any>(shopId: number, path: string, query?: Record<string, any>): Promise<ApiResponse<T>>;
+    /**
+     * Convenience method for POST requests
+     */
+    post<T = any>(shopId: number, path: string, body?: any, query?: Record<string, any>): Promise<ApiResponse<T>>;
+    /**
+     * Convenience method for PUT requests
+     */
+    put<T = any>(shopId: number, path: string, body?: any, query?: Record<string, any>): Promise<ApiResponse<T>>;
+    /**
+     * Convenience method for DELETE requests
+     */
+    delete<T = any>(shopId: number, path: string, query?: Record<string, any>): Promise<ApiResponse<T>>;
+    /**
+     * Get the server URL
+     */
+    getServerUrl(): string;
+    /**
+     * Get the timeout setting
+     */
+    getTimeout(): number;
+    /**
+     * Update headers
+     */
+    setHeaders(headers: Record<string, string>): void;
+    /**
+     * Get current headers
+     */
+    getHeaders(): Record<string, string>;
+}

package/lib/core/ecom/shopee/src/index.d.ts

@@ -0,0 +1,37 @@
+import { ShopeeClient } from './client';
+import { ShopeeShop } from './shop';
+import { ShopeeMerchant } from './merchant';
+import { ShopeePublic } from './public';
+import type { ShopeeSDKConfig, RequestOptions, ApiResponse, AuthRequiredResponse, ApiErrorResponse, ShopInfo, MerchantInfo, ProductItem } from './types';
+export { ShopeeClient };
+export { ShopeeShop };
+export { ShopeeMerchant };
+export { ShopeePublic };
+export type { ShopeeSDKConfig, RequestOptions, ApiResponse, AuthRequiredResponse, ApiErrorResponse, ShopInfo, MerchantInfo, ProductItem };
+/**
+ * Main SDK class that provides easy access to all Shopee APIs
+ */
+export declare class ShopeeSDK {
+    client: ShopeeClient;
+    public: ShopeePublic;
+    constructor(config: ShopeeSDKConfig);
+    /**
+     * Create a shop instance for shop-specific operations
+     * @param shopId Shop ID
+     */
+    shop(shopId: number, environment?: string): ShopeeShop;
+    /**
+     * Create a merchant instance for merchant-level operations
+     * @param mainAccountId Main Account ID
+     */
+    merchant(mainAccountId: number): ShopeeMerchant;
+    /**
+     * Get the underlying client instance
+     */
+    getClient(): ShopeeClient;
+    /**
+     * Update SDK configuration
+     */
+    updateConfig(config: Partial<ShopeeSDKConfig>): void;
+}
+export default ShopeeSDK;

package/lib/core/ecom/shopee/src/merchant.d.ts

@@ -0,0 +1,214 @@
+import { ShopeeClient } from './client';
+import { ApiResponse, MerchantInfo } from './types';
+/**
+ * Shopee Merchant API Class
+ * Handles merchant-level operations using a main_account_id
+ */
+export declare class ShopeeMerchant {
+    private client;
+    private mainAccountId;
+    constructor(client: ShopeeClient, mainAccountId: number);
+    /**
+     * Get merchant information
+     */
+    getMerchantInfo(): Promise<ApiResponse<MerchantInfo>>;
+    /**
+     * Get all shops under the merchant account
+     */
+    getShopList(): Promise<ApiResponse<{
+        shops?: Array<{
+            shop_id: number;
+            shop_name: string;
+            region: string;
+            status: string;
+            is_default: boolean;
+        }>;
+    }>>;
+    /**
+     * Get merchant profile information
+     */
+    getProfile(): Promise<ApiResponse<any>>;
+    /**
+     * Update merchant profile
+     * @param profileData Profile update data
+     */
+    updateProfile(profileData: {
+        username?: string;
+        phone?: string;
+        email?: string;
+        company_name?: string;
+        company_address?: string;
+        company_registration_number?: string;
+    }): Promise<ApiResponse<any>>;
+    /**
+     * Get merchant financial information
+     */
+    getFinancialInfo(): Promise<ApiResponse<any>>;
+    /**
+     * Get merchant wallet balance
+     */
+    getWalletBalance(): Promise<ApiResponse<{
+        available_balance: number;
+        frozen_balance: number;
+        pending_balance: number;
+        currency: string;
+    }>>;
+    /**
+     * Get transaction history
+     * @param options Query options for pagination and filtering
+     */
+    getTransactionHistory(options?: {
+        page_size?: number;
+        cursor?: string;
+        transaction_type?: 'ORDER_INCOME' | 'WITHDRAWAL' | 'REFUND' | 'PENALTY' | 'REWARD';
+        start_time?: number;
+        end_time?: number;
+    }): Promise<ApiResponse<{
+        transactions?: Array<{
+            transaction_id: string;
+            transaction_type: string;
+            amount: number;
+            currency: string;
+            description: string;
+            create_time: number;
+            status: string;
+        }>;
+        next_cursor?: string;
+        has_more_page?: boolean;
+    }>>;
+    /**
+     * Create withdrawal request
+     * @param withdrawalData Withdrawal information
+     */
+    createWithdrawal(withdrawalData: {
+        amount: number;
+        bank_account_id: number;
+        password?: string;
+    }): Promise<ApiResponse<{
+        withdrawal_id: string;
+        amount: number;
+        currency: string;
+        status: string;
+    }>>;
+    /**
+     * Get withdrawal history
+     * @param options Query options for pagination
+     */
+    getWithdrawalHistory(options?: {
+        page_size?: number;
+        cursor?: string;
+        start_time?: number;
+        end_time?: number;
+    }): Promise<ApiResponse<{
+        withdrawals?: Array<{
+            withdrawal_id: string;
+            amount: number;
+            currency: string;
+            status: string;
+            create_time: number;
+            complete_time?: number;
+        }>;
+        next_cursor?: string;
+        has_more_page?: boolean;
+    }>>;
+    /**
+     * Get merchant-level statistics
+     * @param options Query options for time range
+     */
+    getStatistics(options?: {
+        start_date?: string;
+        end_date?: string;
+        shop_ids?: number[];
+    }): Promise<ApiResponse<{
+        total_orders: number;
+        total_revenue: number;
+        total_products: number;
+        active_shops: number;
+        growth_rate?: number;
+    }>>;
+    /**
+     * Get merchant notifications
+     * @param options Query options for pagination
+     */
+    getNotifications(options?: {
+        page_size?: number;
+        cursor?: string;
+        notification_type?: 'SYSTEM' | 'ORDER' | 'PRODUCT' | 'FINANCIAL';
+        read_status?: 'READ' | 'UNREAD';
+    }): Promise<ApiResponse<{
+        notifications?: Array<{
+            notification_id: string;
+            type: string;
+            title: string;
+            content: string;
+            create_time: number;
+            read_status: string;
+        }>;
+        next_cursor?: string;
+        has_more_page?: boolean;
+        unread_count?: number;
+    }>>;
+    /**
+     * Mark notification as read
+     * @param notificationId Notification ID
+     */
+    markNotificationAsRead(notificationId: string): Promise<ApiResponse<any>>;
+    /**
+     * Get merchant settings
+     */
+    getSettings(): Promise<ApiResponse<any>>;
+    /**
+     * Update merchant settings
+     * @param settingsData Settings update data
+     */
+    updateSettings(settingsData: {
+        timezone?: string;
+        language?: string;
+        currency?: string;
+        notification_preferences?: Record<string, boolean>;
+    }): Promise<ApiResponse<any>>;
+    /**
+     * Get merchant permissions and access control
+     */
+    getPermissions(): Promise<ApiResponse<{
+        permissions?: Array<{
+            permission_id: string;
+            name: string;
+            description: string;
+            granted: boolean;
+        }>;
+    }>>;
+    /**
+     * Get merchant audit logs
+     * @param options Query options for pagination and filtering
+     */
+    getAuditLogs(options?: {
+        page_size?: number;
+        cursor?: string;
+        action?: 'CREATE' | 'UPDATE' | 'DELETE' | 'LOGIN';
+        user_id?: string;
+        start_time?: number;
+        end_time?: number;
+    }): Promise<ApiResponse<{
+        logs?: Array<{
+            log_id: string;
+            action: string;
+            user_id: string;
+            resource_type: string;
+            resource_id: string;
+            details: any;
+            ip_address: string;
+            create_time: number;
+        }>;
+        next_cursor?: string;
+        has_more_page?: boolean;
+    }>>;
+    /**
+     * Get the main account ID
+     */
+    getMainAccountId(): number;
+    /**
+     * Get the underlying client instance
+     */
+    getClient(): ShopeeClient;
+}