@pisell/pisellos 3.0.55 → 3.0.57

package/lib/plugins/app-types/request/config.d.ts

@@ -0,0 +1,3 @@
+import { RequestConfig } from './type';
+export declare const setConfig: (newConfig: Partial<RequestConfig>) => void;
+export declare const getConfig: () => RequestConfig;

package/lib/plugins/app-types/request/constants.d.ts

@@ -0,0 +1,2 @@
+import { CreateAxiosDefaults } from "axios";
+export declare const axiosConfig: CreateAxiosDefaults;

package/lib/plugins/app-types/request/index.d.ts

@@ -0,0 +1,24 @@
+import { RequestWrapperProps, RequestConfig } from "./type";
+export declare const createRequest: (props: RequestWrapperProps) => Promise<unknown>;
+/**
+ * 请求
+ * @param props
+ * @returns
+ */
+export declare const request: (props: RequestWrapperProps) => Promise<any>;
+export declare const get: (url: RequestWrapperProps["url"], data: RequestWrapperProps["data"], config: RequestWrapperProps["config"]) => Promise<any>;
+export declare const post: (url: RequestWrapperProps["url"], data: RequestWrapperProps["data"], config: RequestWrapperProps["config"]) => Promise<any>;
+export declare const put: (url: RequestWrapperProps["url"], data: RequestWrapperProps["data"], config: RequestWrapperProps["config"]) => Promise<any>;
+export declare const remove: (url: RequestWrapperProps["url"], data: RequestWrapperProps["data"], config: RequestWrapperProps["config"]) => Promise<any>;
+export declare const custom: (url: RequestWrapperProps["url"], config: RequestWrapperProps["config"]) => Promise<any>;
+export * from "./type";
+declare const _default: {
+    get: (url: RequestWrapperProps["url"], data: RequestWrapperProps["data"], config: RequestWrapperProps["config"]) => Promise<any>;
+    post: (url: RequestWrapperProps["url"], data: RequestWrapperProps["data"], config: RequestWrapperProps["config"]) => Promise<any>;
+    put: (url: RequestWrapperProps["url"], data: RequestWrapperProps["data"], config: RequestWrapperProps["config"]) => Promise<any>;
+    remove: (url: RequestWrapperProps["url"], data: RequestWrapperProps["data"], config: RequestWrapperProps["config"]) => Promise<any>;
+    custom: (url: RequestWrapperProps["url"], config: RequestWrapperProps["config"]) => Promise<any>;
+    setConfig: (newConfig: Partial<RequestConfig>) => void;
+    getConfig: () => RequestConfig;
+};
+export default _default;

package/lib/plugins/app-types/request/pisell2Request.d.ts

@@ -0,0 +1,6 @@
+type RequestMethod = any;
+declare const pisell2Get: RequestMethod;
+declare const pisell2Post: RequestMethod;
+declare const pisell2Put: RequestMethod;
+declare const pisell2Remove: RequestMethod;
+export { pisell2Get as get, pisell2Post as post, pisell2Put as put, pisell2Remove as remove, };

package/lib/plugins/app-types/request/type.d.ts

@@ -0,0 +1,41 @@
+import { CreateAxiosDefaults } from "axios";
+import { CacheType } from './cache';
+export interface RequestConfig {
+    interceptorsRequest?: ((value: any) => any | Promise<any>) | null;
+    interceptorsRequestError?: ((error: any) => any) | null;
+    interceptorsResponse?: any;
+    interceptorsResponseError?: ((error: any) => any) | null;
+    axiosConfig?: CreateAxiosDefaults;
+    storage?: any;
+    getToken?: () => string | null;
+    setToken?: (token: string) => void;
+    getLocale?: () => string | null;
+    getUrl?: (config: any) => string;
+    requestCallbacks?: {
+        200?: (data: any) => void;
+        401?: (data: any) => void;
+        403?: (data: any) => void;
+        other?: (data: any) => void;
+        [key: string]: any;
+    };
+}
+export interface CacheProps {
+    key?: string;
+    type?: CacheType;
+    updateCache?: boolean;
+    cacheUpdateChange?: (data: any) => void;
+}
+export interface RequestSetting {
+    abort?: boolean;
+    headers?: any;
+    cache?: CacheProps;
+    signal?: any;
+    token?: string;
+    [key: string]: any;
+}
+export interface RequestWrapperProps {
+    url: string;
+    method: 'get' | 'post' | 'remove' | 'put';
+    data?: any;
+    config?: RequestSetting;
+}

package/lib/plugins/app-types/request/utils.d.ts

@@ -0,0 +1,46 @@
+import { InternalAxiosRequestConfig } from "axios";
+import { RequestSetting, RequestConfig, RequestWrapperProps } from "./type";
+export declare const getRequestHeaders: (config: InternalAxiosRequestConfig<RequestSetting> & Record<string, any>) => Record<string, string | null>;
+/**
+ * @title: 请求前拦截
+ * @description:
+ * @param {any} config
+ * @return {*}
+ * @Author: zhiwei.Wang
+ * @Date: 2024-07-04 10:51
+ */
+export declare const interceptorsRequest: (config: InternalAxiosRequestConfig<RequestSetting> & Record<string, any>) => Promise<InternalAxiosRequestConfig<RequestSetting> & Record<string, any>>;
+/**
+ * @title: 请求前error
+ * @description:
+ * @param {any} err
+ * @return {*}
+ * @Author: zhiwei.Wang
+ * @Date: 2024-07-04 10:51
+ */
+export declare const interceptorsRequestError: (err: RequestConfig["interceptorsRequestError"]) => any;
+/**
+ * @title: 请求后拦截
+ * @description:
+ * @param {any} response
+ * @return {*}
+ * @Author: zhiwei.Wang
+ * @Date: 2024-07-04 10:51
+ */
+export declare const interceptorsResponse: (response: RequestConfig["interceptorsResponse"]) => any;
+/**
+ * @title: 请求后错误拦截
+ * @description:
+ * @param {any} response
+ * @return {*}
+ * @Author: zhiwei.Wang
+ * @Date: 2024-07-04 10:51
+ */
+export declare const interceptorsResponseError: (response: RequestConfig["interceptorsResponseError"]) => any;
+export declare const requestCallback: (resData: {
+    res?: any;
+    props: RequestWrapperProps;
+    resolve: (value: unknown) => void;
+    reject: () => void;
+    err?: any;
+}) => void;

package/lib/plugins/app-types/routes/config.d.ts

@@ -0,0 +1,7 @@
+export interface RouteItem {
+    path: string;
+    component: any;
+    exact?: boolean;
+    routes?: RouteItem[];
+}
+export declare const routes: RouteItem[];

package/lib/plugins/app-types/routes/index.d.ts

@@ -0,0 +1,28 @@
+import App from '../app';
+import React from 'react';
+import type { ApplicationInterface } from '../applicationManager/application';
+export interface RouterOptions {
+    routes?: Record<string, RouteType>;
+    basename?: string;
+}
+export interface RouteType extends ApplicationInterface {
+}
+export declare class RouterManager {
+    routes: Record<string, RouteType>;
+    options: RouterOptions;
+    app: App;
+    constructor(options: RouterOptions | undefined, app: App);
+    init(): void;
+    getRoutes(): Record<string, RouteType>;
+    getBasename(): string | undefined;
+    setBasename(basename: string): void;
+    add(name: string, route: any): void;
+    get(name: string): RouteType;
+    has(name: string): boolean;
+    remove(name: string): void;
+    renderComponent(item: RouteType, children?: React.ReactNode): string | number | boolean | Iterable<React.ReactNode> | React.JSX.Element | null | undefined;
+    getPageByRoute(route: string): ApplicationInterface | undefined;
+    getRouterComponent({ fallback }: {
+        fallback?: React.ReactNode;
+    }): React.JSX.Element[];
+}

package/lib/plugins/app-types/socket/components/SocketMonitorPage.d.ts

@@ -0,0 +1,6 @@
+import React from "react";
+/**
+ * Socket监控页面组件
+ */
+declare const SocketMonitorPage: React.FC;
+export default SocketMonitorPage;

package/lib/plugins/app-types/socket/components/index.d.ts

@@ -0,0 +1,2 @@
+import SocketMonitorPage from './SocketMonitorPage';
+export { SocketMonitorPage };

package/lib/plugins/app-types/socket/constants.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Socket模块常量
+ */
+/** 默认配置选项 */
+export declare const DEFAULT_SOCKET_OPTIONS: {
+    autoConnect: boolean;
+    reconnection: boolean;
+    reconnectionAttempts: number;
+    reconnectionDelay: number;
+    reconnectionDelayMax: number;
+    heartbeat: boolean;
+    heartbeatInterval: number;
+    heartbeatTimeout: number;
+    timeout: number;
+};
+/** 默认心跳消息 */
+export declare const DEFAULT_HEARTBEAT_MESSAGE: {
+    type: string;
+};
+/** 默认心跳响应事件 */
+export declare const DEFAULT_HEARTBEAT_RESPONSE = "pong";
+/** 最小心跳间隔（毫秒） */
+export declare const MIN_HEARTBEAT_INTERVAL = 1000;
+/** 最小重连延迟（毫秒） */
+export declare const MIN_RECONNECTION_DELAY = 500;
+/** 连接状态码映射 */
+export declare const WS_STATUS_MAP: {
+    0: string;
+    1: string;
+    2: string;
+    3: string;
+    4: string;
+};

package/lib/plugins/app-types/socket/events.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Socket标准事件类型
+ */
+export declare enum SocketEvents {
+    /** 连接成功事件 */
+    CONNECT = "connect",
+    /** 连接断开事件 */
+    DISCONNECT = "disconnect",
+    /** 连接错误事件 */
+    ERROR = "error",
+    /** 接收消息事件 */
+    MESSAGE = "message",
+    /** 发送消息事件 */
+    SEND = "send",
+    /** 重连中事件 */
+    RECONNECTING = "reconnecting",
+    /** 重连尝试事件 */
+    RECONNECT_ATTEMPT = "reconnect_attempt",
+    /** 重连成功事件 */
+    RECONNECT = "reconnect",
+    /** 重连失败事件 */
+    RECONNECT_ERROR = "reconnect_error",
+    /** 重连次数超限 */
+    RECONNECT_FAILED = "reconnect_failed",
+    /** 心跳发送事件 */
+    HEARTBEAT = "heartbeat",
+    /** 心跳响应事件 */
+    HEARTBEAT_RESPONSE = "heartbeat_response",
+    /** 心跳超时事件 */
+    HEARTBEAT_TIMEOUT = "heartbeat_timeout"
+}

package/lib/plugins/app-types/socket/heartbeat.d.ts

@@ -0,0 +1,66 @@
+import { HeartbeatOptions, SocketMessage } from "./types";
+/**
+ * Socket心跳管理器
+ * 处理WebSocket连接的心跳检测
+ */
+export declare class HeartbeatManager {
+    private options;
+    private intervalTimer;
+    private timeoutTimer;
+    private lastHeartbeatTime;
+    private lastHeartbeatResponse;
+    private active;
+    private sendHeartbeat;
+    private onTimeout;
+    private onResponse;
+    /**
+     * 创建心跳管理器
+     * @param options 心跳配置选项
+     * @param sendHeartbeat 发送心跳的回调函数
+     * @param callbacks 回调函数集合
+     */
+    constructor(options: HeartbeatOptions, sendHeartbeat: (msg: SocketMessage) => void, callbacks?: {
+        onTimeout?: () => void;
+        onResponse?: () => void;
+    });
+    /**
+     * 启动心跳检测
+     */
+    start(): void;
+    /**
+     * 停止心跳检测
+     */
+    stop(): void;
+    /**
+     * 重启心跳检测
+     */
+    restart(): void;
+    /**
+     * 接收到心跳响应
+     */
+    receiveHeartbeatResponse(): void;
+    /**
+     * 获取上次心跳时间
+     */
+    getLastHeartbeatTime(): number;
+    /**
+     * 获取上次心跳响应时间
+     */
+    getLastHeartbeatResponseTime(): number;
+    /**
+     * 获取心跳是否活跃
+     */
+    isActive(): boolean;
+    /**
+     * 安排下一次心跳
+     */
+    private scheduleHeartbeat;
+    /**
+     * 发送心跳消息
+     */
+    private sendHeartbeatMessage;
+    /**
+     * 清除所有计时器
+     */
+    private clearTimers;
+}

package/lib/plugins/app-types/socket/index.d.ts

@@ -0,0 +1,61 @@
+import { Socket } from './socket';
+import { SocketOptions, SocketStatus, SocketMessage } from './types';
+import { SocketEvents } from './events';
+import { SocketMonitor, SocketMonitorOptions, SocketHistoryItem, SocketStatusItem, SocketStats } from './monitor';
+import * as components from './components';
+/**
+ * 创建Socket实例
+ * @param url WebSocket连接URL
+ * @param options Socket配置选项
+ */
+export declare function createSocket(url: string, options?: Partial<Omit<SocketOptions, 'url'>>): Socket;
+declare const _default: {
+    /**
+     * 创建新的Socket实例
+     */
+    create: (url: string, options?: Partial<Omit<SocketOptions, "url">>, key?: string) => Socket;
+    /**
+     * 获取指定键的Socket实例
+     */
+    get: (key: string) => Socket | undefined;
+    /**
+     * 移除Socket实例
+     */
+    remove: (key: string) => boolean;
+    /**
+     * 关闭并移除所有Socket实例
+     */
+    closeAll: () => void;
+    /**
+     * 检查指定键的Socket是否存在
+     */
+    has: (key: string) => boolean;
+    /**
+     * 获取所有Socket标识键
+     */
+    getKeys: () => string[];
+    /**
+     * 获取所有Socket实例
+     */
+    getAllSockets: () => Socket[];
+    /**
+     * 为指定的Socket启用监控
+     */
+    enableMonitoring: (key: string, options?: SocketMonitorOptions) => SocketMonitor | null;
+    /**
+     * 获取指定Socket的监控器
+     */
+    getMonitor: (key: string) => SocketMonitor | null;
+    /**
+     * 获取所有Socket的监控信息
+     */
+    getAllMonitors: () => Map<string, SocketMonitor | null>;
+    /**
+     * 监控组件
+     */
+    components: typeof components;
+};
+export default _default;
+export { Socket, SocketMonitor };
+export type { SocketOptions, SocketMessage, SocketMonitorOptions, SocketHistoryItem, SocketStatusItem, SocketStats };
+export { SocketStatus, SocketEvents };

package/lib/plugins/app-types/socket/monitor.d.ts

@@ -0,0 +1,169 @@
+import { Socket } from './socket';
+import { SocketMessage, SocketStatus } from './types';
+/**
+ * Socket历史消息记录项
+ */
+export interface SocketHistoryItem {
+    /** 消息ID */
+    id: string;
+    /** 消息时间戳 */
+    timestamp: number;
+    /** 消息方向（发送/接收） */
+    direction: 'in' | 'out';
+    /** 消息内容 */
+    message: SocketMessage | Partial<SocketMessage>;
+    /** 消息大小（字节） */
+    size?: number;
+}
+/**
+ * Socket状态记录项
+ */
+export interface SocketStatusItem {
+    /** 状态变更时间戳 */
+    timestamp: number;
+    /** 变更前状态 */
+    from: SocketStatus;
+    /** 变更后状态 */
+    to: SocketStatus;
+    /** 相关事件（如果有） */
+    event?: string;
+    /** 附加信息 */
+    info?: any;
+}
+/**
+ * Socket监控配置选项
+ */
+export interface SocketMonitorOptions {
+    /** 最大历史消息记录数 */
+    maxHistoryItems?: number;
+    /** 最大状态变更记录数 */
+    maxStatusItems?: number;
+    /** 是否记录消息内容 */
+    recordMessageContent?: boolean;
+    /** 是否自动开始监控 */
+    autoStart?: boolean;
+    /** 过滤掉的消息类型（不记录） */
+    excludeEvents?: string[];
+}
+/**
+ * Socket监控统计信息
+ */
+export interface SocketStats {
+    /** 总发送消息数 */
+    totalSent: number;
+    /** 总接收消息数 */
+    totalReceived: number;
+    /** 总发送字节数 */
+    bytesSent: number;
+    /** 总接收字节数 */
+    bytesReceived: number;
+    /** 连接次数 */
+    connectionCount: number;
+    /** 重连次数 */
+    reconnectionCount: number;
+    /** 错误次数 */
+    errorCount: number;
+    /** 心跳发送次数 */
+    heartbeatCount: number;
+    /** 心跳超时次数 */
+    heartbeatTimeoutCount: number;
+    /** 首次连接时间 */
+    firstConnectTime: number | null;
+    /** 最后连接时间 */
+    lastConnectTime: number | null;
+    /** 当前连接持续时间（毫秒，连接状态下有效） */
+    currentConnectionDuration: number | null;
+    /** 平均消息大小（字节） */
+    averageMessageSize: number;
+}
+/**
+ * Socket监控器
+ * 用于监控Socket的连接状态和消息历史
+ */
+export declare class SocketMonitor {
+    private socket;
+    private options;
+    private isMonitoring;
+    private messageHistory;
+    private statusHistory;
+    private stats;
+    private connectStartTime;
+    private eventHandlers;
+    /**
+     * 创建Socket监控器
+     * @param socket 要监控的Socket实例
+     * @param options 监控配置选项
+     */
+    constructor(socket: Socket, options?: SocketMonitorOptions);
+    /**
+     * 开始监控
+     */
+    start(): void;
+    /**
+     * 停止监控
+     */
+    stop(): void;
+    /**
+     * 检查监控器是否处于活跃状态
+     */
+    isActive(): boolean;
+    /**
+     * 清除历史记录
+     */
+    clearHistory(): void;
+    /**
+     * 重置统计数据
+     */
+    resetStats(): void;
+    /**
+     * 获取消息历史记录
+     * @param limit 返回的最大记录数
+     * @param direction 消息方向过滤
+     */
+    getMessageHistory(limit?: number, direction?: 'in' | 'out'): SocketHistoryItem[];
+    /**
+     * 获取状态变更历史
+     * @param limit 返回的最大记录数
+     */
+    getStatusHistory(limit?: number): SocketStatusItem[];
+    /**
+     * 获取统计信息
+     */
+    getStats(): SocketStats;
+    /**
+     * 设置监控事件监听
+     */
+    private setupEventListeners;
+    /**
+     * 移除监控事件监听
+     */
+    private removeEventListeners;
+    /**
+     * 记录已发送的消息
+     */
+    private recordMessageSent;
+    /**
+     * 记录已接收的消息
+     */
+    private recordMessageReceived;
+    /**
+     * 记录状态变化
+     */
+    private recordStatusChange;
+    /**
+     * 添加消息到历史记录，并控制记录数量
+     */
+    private addToMessageHistory;
+    /**
+     * 添加状态到历史记录，并控制记录数量
+     */
+    private addToStatusHistory;
+    /**
+     * 更新平均消息大小
+     */
+    private updateAverageMessageSize;
+    /**
+     * 释放资源
+     */
+    destroy(): void;
+}

package/lib/plugins/app-types/socket/reconnect.d.ts

@@ -0,0 +1,61 @@
+import { ReconnectOptions } from './types';
+/**
+ * Socket重连管理器
+ * 处理断线重连逻辑
+ */
+export declare class ReconnectManager {
+    private options;
+    private attempts;
+    private timer;
+    private isReconnecting;
+    private reconnectCallback;
+    private onAttempt;
+    private onSuccess;
+    private onFail;
+    private onMaxAttemptsExceeded;
+    /**
+     * 创建重连管理器实例
+     * @param options 重连配置
+     * @param reconnectCallback 重连执行函数
+     * @param callbacks 回调函数集合
+     */
+    constructor(options: ReconnectOptions, reconnectCallback: () => Promise<boolean>, callbacks?: {
+        onAttempt?: (attempt: number) => void;
+        onSuccess?: () => void;
+        onFail?: (error: Error) => void;
+        onMaxAttemptsExceeded?: () => void;
+    });
+    /**
+     * 启动重连过程
+     */
+    startReconnect(): void;
+    /**
+     * 停止重连过程
+     */
+    stopReconnect(): void;
+    /**
+     * 获取当前重连尝试次数
+     */
+    getReconnectAttempts(): number;
+    /**
+     * 获取当前是否正在重连
+     */
+    isActive(): boolean;
+    /**
+     * 重置重连状态
+     */
+    reset(): void;
+    /**
+     * 安排下一次重连尝试
+     */
+    private scheduleReconnect;
+    /**
+     * 执行重连操作
+     */
+    private executeReconnect;
+    /**
+     * 计算重连延迟时间
+     * 支持指数退避算法，增加随机抖动
+     */
+    private getReconnectDelay;
+}