@pisell/pisellos 3.0.55 → 3.0.57

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

@@ -0,0 +1,178 @@
+import App from "../app";
+/**
+ * IndexDB 管理器模块
+ *
+ * 这个模块提供了对浏览器 IndexedDB 的简单封装，并在不支持 IndexedDB 的环境中
+ * 自动降级使用 localStorage 作为备选存储方案。
+ */
+/**
+ * 数据库配置选项接口
+ * @interface DBOptions
+ * @property {string} dbName - 数据库名称
+ * @property {number} version - 数据库版本号
+ * @property {Array} stores - 存储对象配置数组
+ * @property {string} stores[].name - 存储对象名称
+ * @property {string} stores[].keyPath - 主键路径
+ * @property {Array} [stores[].indexes] - 索引配置数组（可选）
+ * @property {string} stores[].indexes[].name - 索引名称
+ * @property {string} stores[].indexes[].keyPath - 索引键路径
+ * @property {IDBIndexParameters} [stores[].indexes[].options] - 索引选项（可选）
+ */
+export interface DBOptions {
+    dbName: string;
+    version: number;
+    stores: {
+        name: string;
+        keyPath: string;
+        indexes?: {
+            name: string;
+            keyPath: string;
+            options?: IDBIndexParameters;
+        }[];
+    }[];
+}
+/**
+ * IndexDB 管理器类
+ * 提供对 IndexedDB 的简单封装，支持自动降级到 localStorage
+ * @class IndexDBManager
+ */
+declare class IndexDBManager {
+    /**
+     * 检查环境是否支持 IndexedDB
+     * @returns {boolean} 是否支持 IndexedDB
+     * @private
+     */
+    private static isSupported;
+    private db;
+    private dbName;
+    private version;
+    private stores;
+    private useIndexDB;
+    private app;
+    /**
+     * 创建 IndexDBManager 实例
+     * @param {DBOptions} options - 数据库配置选项
+     */
+    constructor(app: App, options: DBOptions);
+    /**
+     * 初始化数据库连接
+     * 如果环境不支持 IndexedDB，将自动使用 localStorage
+     * @returns {Promise<boolean>} 连接是否成功
+     */
+    connect(): Promise<boolean>;
+    /**
+     * 生成用于 localStorage 的存储键
+     * @param {string} storeName - 存储对象名称
+     * @param {string|number} [key] - 可选的键值
+     * @returns {string} 格式化的存储键
+     * @private
+     */
+    private getStorageKey;
+    /**
+     * 添加数据到指定的存储对象
+     * @param {string} storeName - 存储对象名称
+     * @param {T} data - 要添加的数据
+     * @returns {Promise<T>} 添加的数据
+     * @template T
+     */
+    add<T>(storeName: string, data: T): Promise<T>;
+    /**
+     * 获取指定存储对象中的数据
+     * @param {string} storeName - 存储对象名称
+     * @param {string|number} key - 数据主键
+     * @returns {Promise<T|null>} 获取的数据，不存在则返回 null
+     * @template T
+     */
+    get<T>(storeName: string, key: string | number): Promise<T | null>;
+    /**
+     * 更新指定存储对象中的数据
+     * @param {string} storeName - 存储对象名称
+     * @param {T} data - 要更新的数据
+     * @returns {Promise<T>} 更新后的数据
+     * @template T
+     */
+    update<T>(storeName: string, data: T): Promise<T>;
+    /**
+     * 删除指定存储对象中的数据
+     * @param {string} storeName - 存储对象名称
+     * @param {string|number} key - 数据主键
+     * @returns {Promise<boolean>} 删除是否成功
+     */
+    delete(storeName: string, key: string | number): Promise<boolean>;
+    /**
+     * 获取指定存储对象中的所有数据
+     * @param {string} storeName - 存储对象名称
+     * @returns {Promise<T[]>} 数据数组
+     * @template T
+     */
+    getAll<T>(storeName: string): Promise<T[]>;
+    /**
+     * 清空指定存储对象中的所有数据
+     * @param {string} storeName - 存储对象名称
+     * @returns {Promise<boolean>} 清空是否成功
+     */
+    clear(storeName: string): Promise<boolean>;
+    /**
+     * 关闭数据库连接
+     * 在不再需要使用数据库时调用，释放资源
+     */
+    close(): void;
+    /**
+     * 获取当前使用的存储方式
+     * @returns {'indexDB'|'localStorage'} 当前使用的存储方式
+     */
+    getCurrentStorage(): 'indexDB' | 'localStorage';
+}
+/**
+ * 使用示例:
+ *
+ * // 1. 创建数据库配置
+ * const dbOptions: DBOptions = {
+ *   dbName: 'myApp',
+ *   version: 1,
+ *   stores: [
+ *     {
+ *       name: 'users',
+ *       keyPath: 'id',
+ *       indexes: [
+ *         { name: 'email', keyPath: 'email', options: { unique: true } }
+ *       ]
+ *     },
+ *     {
+ *       name: 'products',
+ *       keyPath: 'id'
+ *     }
+ *   ]
+ * };
+ *
+ * // 2. 创建并连接数据库
+ * const db = new IndexDBManager(dbOptions);
+ * await db.connect();
+ *
+ * // 3. 添加数据
+ * const user = { id: '1', name: '张三', email: 'zhangsan@example.com' };
+ * await db.add('users', user);
+ *
+ * // 4. 获取数据
+ * const retrievedUser = await db.get('users', '1');
+ *
+ * // 5. 更新数据
+ * user.name = '张三 (已更新)';
+ * await db.update('users', user);
+ *
+ * // 6. 获取所有数据
+ * const allUsers = await db.getAll('users');
+ *
+ * // 7. 删除数据
+ * await db.delete('users', '1');
+ *
+ * // 8. 清空存储对象
+ * await db.clear('users');
+ *
+ * // 9. 关闭数据库连接
+ * db.close();
+ *
+ * // 10. 检查当前使用的存储方式
+ * const storageType = db.getCurrentStorage(); // 'indexDB' 或 'localStorage'
+ */
+export default IndexDBManager;

package/lib/plugins/app-types/locales/en.d.ts

@@ -0,0 +1,3 @@
+import { LibraryItem } from './type';
+declare const _default: LibraryItem;
+export default _default;

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

@@ -0,0 +1,37 @@
+import { Locale, LibraryItem, LoadLibraryByUrlParams } from "./type";
+import App from "../app";
+export interface LocalesOptions {
+    locale?: Locale;
+    library?: {
+        [key in Locale]: LibraryItem;
+    };
+}
+export declare class Locales {
+    private app;
+    locale: string;
+    library: {
+        [key in Locale]: LibraryItem;
+    };
+    constructor(app: App, options?: LocalesOptions);
+    getLocale: () => string;
+    getCurrentTexts: (locale?: Locale) => {
+        [key: string]: string;
+    };
+    setLocale: (locale: Locale, reload?: boolean) => void;
+    getText: (id: string, locale?: Locale) => string;
+    isCN: () => boolean;
+    loadLibraryByUrl: (urls: LoadLibraryByUrlParams) => Promise<{
+        [x: string]: LibraryItem;
+    }>;
+    loadLibraryByItems(libraryList: LibraryItem[]): void;
+    loadLibrary: (urls: LoadLibraryByUrlParams) => Promise<{
+        [x: string]: LibraryItem;
+    }>;
+    translation: (text: string | {
+        [key: Locale]: string;
+    }, locale?: Locale) => string | number;
+    getLibraryByData: (data: LibraryItem[]) => LibraryItem;
+    createTextsByLibrary: (id: string, library?: { [key in Locale]: LibraryItem; }) => {
+        [x: string]: string;
+    };
+}

package/lib/plugins/app-types/locales/original.d.ts

@@ -0,0 +1,3 @@
+import { LibraryItem } from './type';
+declare const _default: LibraryItem;
+export default _default;

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

@@ -0,0 +1,19 @@
+export type Locale = 'original' | 'en' | 'zh-CN' | 'zh-HK' | string;
+export type MultiLanguage = {
+    [key in Locale]: string;
+};
+export interface LibraryItem {
+    locale: Locale;
+    name: string;
+    translations: {
+        [key: string]: string;
+    };
+    [key: string]: any;
+}
+export interface LocaleConfig {
+    locale: Locale;
+    library: {
+        [key in Locale]: LibraryItem;
+    };
+}
+export type LoadLibraryByUrlParams = (string | Promise<LibraryItem> | (() => Promise<LibraryItem>) | LibraryItem)[];

package/lib/plugins/app-types/locales/zh-CN.d.ts

@@ -0,0 +1,3 @@
+import { LibraryItem } from './type';
+declare const _default: LibraryItem;
+export default _default;

package/lib/plugins/app-types/locales/zh-HK.d.ts

@@ -0,0 +1,3 @@
+import { LibraryItem } from './type';
+declare const _default: LibraryItem;
+export default _default;

package/lib/plugins/app-types/logger/feishu.d.ts

@@ -0,0 +1,11 @@
+interface contentItem {
+    key: string;
+    value: string;
+}
+interface sendWebhookProps {
+    title: string;
+    content: contentItem[];
+    webhook: string;
+}
+export declare const sendWarningLog: ({ title, content, webhook }: sendWebhookProps) => Promise<any>;
+export {};

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

@@ -0,0 +1,122 @@
+import App from "../app";
+export type LogConsoleType = "info" | "warning" | "error" | "debug";
+/**
+ * 日志项接口
+ */
+interface LogItem {
+    type: LogConsoleType;
+    title: string;
+    date?: string;
+    metadata?: any;
+}
+interface LogFile {
+    fileName: string;
+    date: string;
+    fileContent: LogFileContent;
+}
+interface LogFileContent {
+    metadata: any;
+    logs: LogItem[];
+}
+export interface LoggerOptions {
+    prefix?: string;
+    checkInterval?: number;
+    feishuConfig?: any;
+    retentionDays?: number;
+}
+/**
+ * 日志管理器类
+ */
+declare class LoggerManager {
+    private logBuffer;
+    private timer;
+    private checkInterval;
+    private prefix;
+    private metadata;
+    private db;
+    private app;
+    private feishuConfig;
+    private retentionDays;
+    private metadataFunction;
+    /**
+     * 构造函数
+     * @param prefix 日志前缀
+     * @param checkInterval 检查间隔时间，默认5分钟
+     */
+    constructor(app: App, options?: LoggerOptions);
+    init(): void;
+    /**
+     * 初始化 IndexDB
+     */
+    private initDB;
+    /**
+     * 设置元数据
+     * @param metadata 元数据
+     */
+    setMetadata(metadata: any): void;
+    setMetadataFunction(metadataFunction: () => any): void;
+    /**
+     * 初始化定时器
+     */
+    initTimer(): void;
+    /**
+     * 添加日志
+     * @param log 日志项
+     */
+    addLog(log: LogItem): void;
+    /**
+     * 发送飞书通知
+     * @param log 日志项
+     */
+    private sendFeishuNotification;
+    /**
+     * 创建日志文件名
+     * @returns 日志文件名
+     */
+    private createFileName;
+    /**
+     * 创建日志文件
+     * @param _fileName 文件名
+     * @returns 日志文件对象
+     */
+    private createFile;
+    /**
+     * 存储日志到持久化存储
+     */
+    private storeLog;
+    /**
+     * 清理旧日志，只保留最近指定天数的日志
+     */
+    private cleanupOldLogs;
+    /**
+     * 获取日志文件列表
+     * @returns 日志文件列表
+     */
+    getLogFiles(): Promise<LogFile[]>;
+    /**
+     * 获取指定日志文件的内容
+     * @param fileName 日志文件名
+     * @returns 日志文件内容
+     */
+    getLogFile(fileName: string): Promise<LogFile | null>;
+    /**
+     * 清空指定日志文件
+     * @param fileName 日志文件名，不指定则清空所有日志
+     * @returns 是否成功
+     */
+    clearLogs(fileName?: string): Promise<boolean>;
+    /**
+     * 设置日志保留天数
+     * @param days 保留天数
+     */
+    setRetentionDays(days: number): void;
+    /**
+     * 手动触发清理旧日志
+     */
+    manualCleanup(): Promise<void>;
+    /**
+     * 销毁实例
+     */
+    destroy(): void;
+}
+export default LoggerManager;

package/lib/plugins/app-types/menuManager/hooks.d.ts

@@ -0,0 +1,17 @@
+import React from "react";
+import { MenuItem } from "./index";
+export declare const isHttp: (url: string) => boolean;
+export interface MenuContextType {
+    selectedKeys: string[];
+    openKeys: string[];
+    setOpenKeys: (keys: string[]) => void;
+    handleClick: (key: string) => void;
+    menuItems: MenuItem[];
+    getShowChildren: (children: MenuItem[]) => MenuItem[];
+    setMenuItems: (items: MenuItem[]) => void;
+}
+export declare const MenuProvider: React.FC<{
+    children: React.ReactNode;
+    menus: MenuItem[];
+}>;
+export declare const useMenu: () => MenuContextType;

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

@@ -0,0 +1,28 @@
+import React from 'react';
+import App from '../app';
+export interface MenuItem {
+    key: string;
+    label: string;
+    path: string;
+    children?: MenuItem[];
+    icon?: string | React.ReactNode;
+    hide?: boolean;
+}
+export declare class MenuManager {
+    private menuItems;
+    private menuMaps;
+    private app;
+    useMenu: () => import("./hooks").MenuContextType;
+    MenuProvider: React.FC<{
+        children: React.ReactNode;
+        menus: MenuItem[];
+    }>;
+    constructor(items: MenuItem[], app: App);
+    set(items: MenuItem[]): void;
+    getMenus(): MenuItem[];
+    getMenuMaps(): void;
+    findMenuItemByPath(items: MenuItem[], path: string): MenuItem | null;
+    findParent(items: MenuItem[], key: string, parent?: MenuItem | null): MenuItem | null;
+    getShowChildren(items: MenuItem[]): MenuItem[];
+    findMenuItemByKey(items: MenuItem[], key: string): MenuItem | null;
+}

package/lib/plugins/app-types/models/global.d.ts

@@ -0,0 +1,32 @@
+import { Effect, Subscription } from 'dva';
+import { Reducer } from 'redux';
+export interface GlobalModal {
+    namespace: 'global';
+    state: {
+        isLogin: boolean;
+        account: any;
+        core: any;
+        isInstallAPP: boolean;
+        app: {
+            status: {
+                login: boolean;
+                storage: boolean;
+                network: boolean;
+                materials: boolean;
+                pisell2: boolean;
+            };
+        };
+    };
+    effects: {
+        init: Effect;
+    };
+    reducers: {
+        saveGlobalState: Reducer<any>;
+        setInit: Reducer<any>;
+    };
+    subscriptions: {
+        _init: Subscription;
+    };
+}
+declare const modal: GlobalModal;
+export default modal;

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

@@ -0,0 +1,45 @@
+import hooks from '../hooks';
+import { Provider as StoreProvider } from "react-redux";
+declare const models: import("./global").GlobalModal[];
+type ModalsType = (typeof models[number]);
+export interface Store {
+    getDataByModel: typeof getDataByModel;
+    useStore: typeof hooks.useStore;
+    useDispatch: typeof hooks.useDispatch;
+    setDataByModel: typeof setDataByModel;
+    dispatch: any;
+    getState: any;
+}
+export type ModelsNames = ModalsType['namespace'];
+export type ModelsState = {
+    [K in (ModalsType['namespace'])]: Extract<ModalsType, {
+        namespace: K;
+    }>['state'];
+};
+/**
+ * @title: 从store内获取数据
+ * @description:
+ * @param {string} model
+ * @param {string} key
+ * @return {*}
+ * @Author: zhiwei.Wang
+ * @Date: 2024-09-03 11:07
+ */
+declare const getDataByModel: <T extends keyof ModelsState, D extends keyof ModelsState[T]>(model: string, key?: D) => D extends undefined ? ModelsState[T] : ModelsState[T][D];
+/**
+ * @title: 设置数据到store
+ * @description:
+ * @param {string} model
+ * @param {string} key
+ * @param {string} value
+ * @return {*}
+ * @Author: zhiwei.Wang
+ * @Date: 2024-09-08 15:17
+ */
+declare const setDataByModel: <T extends keyof ModelsState, D extends keyof ModelsState[T]>(model: string, key: any, value: any) => void;
+declare const _default: {
+    getStore: () => Store;
+    StoreProvider: typeof StoreProvider;
+    setConfig: (models: any[]) => void;
+};
+export default _default;

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

@@ -0,0 +1,2 @@
+export interface ModelsConfig {
+}

package/lib/plugins/app-types/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@pisell/core-types",
+  "version": "1.0.1",
+  "description": "TypeScript type definitions for @pisell/core",
+  "main": "index.d.ts",
+  "types": "index.d.ts",
+  "typings": "index.d.ts",
+  "peerDependencies": {
+    "react": "^16.8.0 || ^17.0.0 || ^18.0.0"
+  },
+  "files": ["**/*.d.ts"],
+  "publishConfig": {
+    "access": "public"
+  }
+} 

package/lib/plugins/app-types/pubsub/example.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 发布订阅模块使用示例
+ * 此文件仅用于演示，不会被实际引入项目
+ */
+export {};

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

@@ -0,0 +1,63 @@
+/**
+ * 发布订阅模块
+ * 用于组件/服务间的事件通信
+ */
+type EventCallback = (...args: any[]) => void;
+interface EventSubscription {
+    unsubscribe: () => void;
+}
+declare class PubSub {
+    private events;
+    /**
+     * 订阅事件
+     * @param event 事件名称
+     * @param callback 回调函数
+     * @returns 订阅对象，可用于取消订阅
+     */
+    subscribe(event: string, callback: EventCallback): EventSubscription;
+    /**
+     * 取消订阅事件
+     * @param event 事件名称
+     * @param callback 回调函数
+     * @returns 是否成功取消订阅
+     */
+    unsubscribe(event: string, callback: EventCallback): boolean;
+    /**
+     * 发布事件
+     * @param event 事件名称
+     * @param args 事件参数
+     */
+    publish(event: string, ...args: any[]): void;
+    /**
+     * 移除某个事件的所有订阅
+     * @param event 事件名称
+     * @returns 是否成功移除
+     */
+    clearEvent(event: string): boolean;
+    /**
+     * 移除所有事件订阅
+     */
+    clearAllEvents(): void;
+    /**
+     * 获取事件的订阅数量
+     * @param event 事件名称
+     * @returns 订阅数量
+     */
+    getSubscriberCount(event: string): number;
+    /**
+     * 检查事件是否有订阅者
+     * @param event 事件名称
+     * @returns 是否有订阅者
+     */
+    hasSubscribers(event: string): boolean;
+    /**
+     * 一次性订阅事件，事件触发后自动取消订阅
+     * @param event 事件名称
+     * @param callback 回调函数
+     * @returns 订阅对象，可用于取消订阅
+     */
+    once(event: string, callback: EventCallback): EventSubscription;
+}
+declare const pubsub: PubSub;
+export default pubsub;
+export { PubSub, type EventCallback, type EventSubscription };

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

@@ -0,0 +1,46 @@
+import { CacheProps } from './type';
+export type CacheType = 'memory' | 'storage' | 'indexDB';
+/**
+ * @title: 设置缓存
+ * @description:
+ * @return {*}
+ * @Author: zhiwei.Wang
+ */
+export declare const setCache: (key: string, data: any, cache: CacheProps) => Promise<void>;
+/**
+ * @title: 删除缓存数据
+ * @description:
+ * @return {*}
+ * @Author: zhiwei.Wang
+ */
+export declare const removeCache: (key: string, cache: CacheProps) => void;
+/**
+ * @title: 获取数据
+ * @description:
+ * @param {any} url
+ * @param {any} data
+ * @return {*}
+ * @Author: zhiwei.Wang
+ */
+export declare const getCacheData: (url: string, data: any, cache: CacheProps) => Promise<any>;
+/**
+ * @title: 设置缓存
+ * @description:
+ * @param {any} url 路径
+ * @param {any} data 参数
+ * @param {any} res 数据
+ * @return {*}
+ * @Author: zhiwei.Wang
+ */
+export declare const setCacheData: (url: string, data: any, res: any, cache: CacheProps) => any | null;
+/**
+ * @title: 缓存函数包装器
+ * @description:
+ * @param {any} url
+ * @param {any} data
+ * @param {any} config
+ * @param {any} fn
+ * @return {*}
+ * @Author: zhiwei.Wang
+ */
+export declare const cacheFn: (props: any, fn: any) => Promise<any>;

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

@@ -0,0 +1,38 @@
+/**
+ * @Title: 请求列表
+ * @Describe:
+ * @Author: Wzw
+ */
+export declare let requestList: {
+    [key: string]: AbortController;
+};
+/**
+ * @Title: 创建一个控制器
+ * @Describe:
+ * @Author: Wzw
+ * @param {string} key
+ */
+export declare const createController: (key: string) => AbortController;
+/**
+ * @Title: 储存请求
+ * @Describe:
+ * @Author: Wzw
+ * @param {AbortController} controller
+ * @param {string} key
+ */
+export declare const setRequestList: (controller: AbortController, key: string) => void;
+/**
+ * @Title: 取消请求
+ * @Describe:
+ * @Author: Wzw
+ * @param {string} key
+ */
+export declare const abortRequest: (key: string) => void;
+/**
+ * @Title: 创建signal
+ * @Describe:
+ * @Author: Wzw
+ * @param {string} isAbort
+ * @param {string} url
+ */
+export declare const createSignal: (isAbort: boolean, url: string) => AbortSignal | null;