@pisell/core 1.0.68 → 1.0.70

package/es/app/app.d.ts

@@ -0,0 +1,107 @@
+import { RouterManager } from '../routes';
+import { ApplicationManager } from '../applicationManager';
+import { History, HistoryOptions } from '../history';
+import { Data } from '../data';
+import { Locales, LocalesOptions } from '../locales';
+import { Storage, StorageOptions } from '../storage';
+import { MenuManager } from '../menuManager';
+import LoggerManager, { LoggerOptions } from '../logger';
+import { TasksManager } from '../tasks';
+import IndexDBManager, { DBOptions } from '../indexDB';
+import CMD, { CMDOptions } from "../cmd";
+import AWS, { AWSOptions } from "../aws";
+import CommunicationManager from '../communicationManager';
+declare global {
+    interface Window {
+        app: App;
+    }
+}
+export interface Bootstrap {
+    hooks: {
+        [key: string]: () => Promise<void>;
+    };
+}
+export interface AppOptions {
+    logger?: LoggerOptions;
+    db?: DBOptions;
+    constants?: any;
+    history?: HistoryOptions;
+    storage?: StorageOptions;
+    locales?: LocalesOptions;
+    cmd?: CMDOptions;
+    aws?: AWSOptions;
+    getPisellos?: () => any;
+    sqlite?: () => any;
+}
+declare class App {
+    private static instance;
+    private plugins;
+    globalData: any;
+    router: RouterManager;
+    applicationManager: ApplicationManager;
+    history: History;
+    data: Data;
+    hooks: import("../hooks").HooksExport;
+    locales: Locales;
+    models: {
+        getStore: () => import("../models").Store;
+        StoreProvider: typeof import("react-redux").Provider;
+        setConfig: (models: any[]) => void;
+    };
+    request: {
+        get: (url: string, data: any, config: import("../request").RequestSetting | undefined) => Promise<any>;
+        post: (url: string, data: any, config: import("../request").RequestSetting | undefined) => Promise<any>;
+        put: (url: string, data: any, config: import("../request").RequestSetting | undefined) => Promise<any>;
+        remove: (url: string, data: any, config: import("../request").RequestSetting | undefined) => Promise<any>;
+        custom: (url: string, config: import("../request").RequestSetting | undefined) => any;
+        sse: <TMeta = import("../request/sse").SSEMetaData, TData = import("../request/sse").SSEDataPayload<any>, TComplete = import("../request/sse").SSECompletePayload>(url: string, data: Record<string, any> | undefined, config: import("../request").RequestSetting & {
+            method?: "GET" | "POST" | undefined;
+            actions?: import("../request/sse").SSEActions<TMeta, TData, TComplete> | undefined;
+        }) => Promise<() => void>;
+        setConfig: (newConfig: Partial<import("../request").RequestConfig>) => void;
+        getConfig: () => import("../request").RequestConfig;
+    };
+    storage: Storage;
+    menuManager: MenuManager;
+    cookie: {
+        setCookie: (name: string, value: string, domain?: string | undefined) => void;
+        getCookie: (name: string) => string | null;
+        deleteCookie: (name: string, domain?: string | undefined) => void;
+        checkCookie: (name: string) => boolean;
+        updateCookie: (name: string, value: string, domain?: string | undefined) => void;
+    };
+    website: {
+        setTitle: (title: string) => void;
+        setIcon: (paramsIcon: string) => void;
+        setAppleWebAppTitle: (title: string) => void;
+    };
+    logger: LoggerManager;
+    pubsub: import("../pubsub").PubSub;
+    cmd: CMD;
+    aws: AWS;
+    tasksManager: TasksManager;
+    getPisellos: any;
+    sqlite: any;
+    bootstrap?: Bootstrap;
+    dbManager: IndexDBManager | null;
+    constants: {
+        channel: string;
+        [key: string]: string;
+    };
+    comm: CommunicationManager;
+    private constructor();
+    static getInstance(options?: AppOptions): App;
+    setGlobalData(globalData: any): void;
+    usePlugin(name: string, plugin: any): void;
+    usePlugins(plugins: {
+        name: string;
+        plugin: any;
+    }[]): void;
+    getPlugin(name: string): any;
+    getGlobalData(): any;
+    install(): void;
+    unInstall(): void;
+    setBootstrap(bootstrap: Bootstrap): void;
+    getBootstrap(): Bootstrap | undefined;
+}
+export default App;

package/es/app/app.js

@@ -70,6 +70,8 @@ var App = /*#__PURE__*/function () {
     _defineProperty(this, "tasksManager", void 0);
     //  getPisellos
     _defineProperty(this, "getPisellos", void 0);
+    // sqlLite
+    _defineProperty(this, "sqlite", void 0);
     _defineProperty(this, "bootstrap", void 0);
     _defineProperty(this, "dbManager", null);
     _defineProperty(this, "constants", {
@@ -94,6 +96,7 @@ var App = /*#__PURE__*/function () {
     this.cmd = new CMD(this, options === null || options === void 0 ? void 0 : options.cmd);
     this.aws = new AWS(this, options === null || options === void 0 ? void 0 : options.aws);
     this.getPisellos = options === null || options === void 0 ? void 0 : options.getPisellos;
+    this.sqlite = options === null || options === void 0 ? void 0 : options.sqlite;
     if (options !== null && options !== void 0 && options.constants) {
       this.constants = options.constants || {};
     }

package/es/communicationManager/index.d.ts

@@ -0,0 +1,59 @@
+import App from '../app';
+/**
+ * 插件基础类型，通信插件（如 socket、ably）需符合此结构
+ * 具体插件可扩展自有方法以支持链式调用
+ */
+export interface CommunicationPlugin {
+    destroy?: () => Promise<void>;
+    [key: string]: any;
+}
+/**
+ * 插件注册选项
+ */
+export interface RegisterOptions {
+    /**
+     * 是否强制覆盖已存在的同名插件
+     * @default false
+     */
+    force?: boolean;
+}
+/**
+ * 通信管理器：支持注入、获取、移除多种通信插件（如 socket、ably 等）
+ * 管理器自身方法支持链式调用
+ */
+export default class CommunicationManager {
+    private app;
+    private plugins;
+    constructor(app: App);
+    /**
+     * 注入插件
+     * @param name 插件名称，如 'socket'、'ably'
+     * @param plugin 插件实例
+     * @param options 注册选项，可通过 force 强制覆盖已存在的插件
+     * @throws 当插件已存在且未设置 force 时抛出错误
+     */
+    register<T extends CommunicationPlugin>(name: string, plugin: T, options?: RegisterOptions): void;
+    /**
+     * 根据名称获取插件，可对返回值进行链式调用（由插件自身实现）
+     * @param name 插件名称
+     * @returns 插件实例，未注册时返回 undefined
+     */
+    getPlugin<T extends CommunicationPlugin = CommunicationPlugin>(name: string): T | undefined;
+    /**
+     * 移除指定插件
+     * @param name 插件名称
+     */
+    remove(name: string): Promise<void>;
+    /**
+     * 移除所有插件
+     */
+    removeAll(): Promise<void>;
+    /**
+     * 检查是否已注册指定插件
+     */
+    has(name: string): boolean;
+    /**
+     * 获取已注册的插件名称列表
+     */
+    getPluginNames(): string[];
+}

package/es/index.d.ts

@@ -0,0 +1,8 @@
+export { default as request } from './request';
+export { default as hooks } from './hooks';
+export { default as models } from './models';
+export { default as pubsub } from './pubsub';
+export { default as socket } from './socket';
+export * from './applicationManager';
+export * from './app';
+export * from './communicationManager';

package/es/locales/index.d.ts

@@ -0,0 +1,39 @@
+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: string]: string;
+    }, locale?: Locale) => string | number;
+    getLibraryByData: (data: LibraryItem[]) => LibraryItem;
+    createTextsByLibrary: (id: string, library?: {
+        [x: string]: LibraryItem;
+    } | undefined) => {
+        [x: string]: string;
+    };
+}

package/es/locales/ja.d.ts

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

package/es/locales/pt.d.ts

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

package/es/logger/index.d.ts

@@ -0,0 +1,135 @@
+import App from "../app";
+export declare type LogConsoleType = "info" | "warning" | "error" | "debug";
+/**
+ * 日志项接口
+ */
+interface LogItem {
+    logId?: string | number;
+    type: LogConsoleType;
+    title: string;
+    date?: string;
+    metadata?: any;
+    feishu?: 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;
+    private status;
+    /**
+     * 构造函数
+     * @param prefix 日志前缀
+     * @param checkInterval 检查间隔时间，默认5分钟
+     */
+    constructor(app: App, options?: LoggerOptions);
+    init(): Promise<void>;
+    /**
+     * 初始化 IndexDB
+     */
+    private initDB;
+    /**
+     * 设置元数据
+     * @param metadata 元数据
+     */
+    setMetadata(metadata: any): void;
+    setMetadataFunction(metadataFunction: () => any): void;
+    /**
+     * 初始化定时器
+     */
+    initTimer(): void;
+    private setStatus;
+    stop(): void;
+    /**
+     * 添加日志
+     * @param log 日志项
+     */
+    addLog(log: LogItem): void;
+    /**
+     * 发送飞书通知
+     * @param log 日志项
+     */
+    private sendFeishuNotification;
+    /**
+     * 创建日志文件名
+     * @returns 日志文件名
+     */
+    private createFileName;
+    /**
+     * 创建AWS日志文件名
+     * @param isManual 紧急上传
+     * @returns 日志文件名
+     */
+    createAWSFileName(urgent?: boolean): Promise<any>;
+    /**
+     * 创建日志文件
+     * @param _fileName 文件名
+     * @returns 日志文件对象
+     */
+    private createFile;
+    /**
+     * 存储日志到持久化存储
+     */
+    storeLog(urgent?: boolean): Promise<void>;
+    uploadIndexDBLog(): Promise<void>;
+    private storeLogToIndexDB;
+    /**
+     * 清理旧日志，只保留最近指定天数的日志
+     */
+    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/es/request/index.d.ts

@@ -1,4 +1,5 @@
-import { RequestWrapperProps, RequestConfig } from "./type";
+import { RequestWrapperProps, RequestConfig, RequestSetting } from "./type";
+import { SSEConfig, SSEActions, SSEMetaData, SSEDataPayload, SSECompletePayload } from "./sse";
 export declare const createRequest: (props: RequestWrapperProps) => Promise<unknown>;
 /**
  * 请求
@@ -11,13 +12,21 @@ export declare const post: (url: RequestWrapperProps["url"], data: RequestWrappe
 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"]) => any;
+export declare const sse: <TMeta = SSEMetaData, TData = SSEDataPayload<any>, TComplete = SSECompletePayload>(url: SSEConfig["url"], data: Record<string, any> | undefined, config: RequestSetting & {
+    method?: SSEConfig["method"];
+    actions?: SSEActions<TMeta, TData, TComplete> | undefined;
+}) => Promise<() => void>;
 export * from "./type";
 declare const _default: {
-    get: (url: string, data: any, config: import("./type").RequestSetting | undefined) => Promise<any>;
-    post: (url: string, data: any, config: import("./type").RequestSetting | undefined) => Promise<any>;
-    put: (url: string, data: any, config: import("./type").RequestSetting | undefined) => Promise<any>;
-    remove: (url: string, data: any, config: import("./type").RequestSetting | undefined) => Promise<any>;
-    custom: (url: string, config: import("./type").RequestSetting | undefined) => any;
+    get: (url: string, data: any, config: RequestSetting | undefined) => Promise<any>;
+    post: (url: string, data: any, config: RequestSetting | undefined) => Promise<any>;
+    put: (url: string, data: any, config: RequestSetting | undefined) => Promise<any>;
+    remove: (url: string, data: any, config: RequestSetting | undefined) => Promise<any>;
+    custom: (url: string, config: RequestSetting | undefined) => any;
+    sse: <TMeta = SSEMetaData, TData = SSEDataPayload<any>, TComplete = SSECompletePayload>(url: string, data: Record<string, any> | undefined, config: RequestSetting & {
+        method?: "GET" | "POST" | undefined;
+        actions?: SSEActions<TMeta, TData, TComplete> | undefined;
+    }) => Promise<() => void>;
     setConfig: (newConfig: Partial<RequestConfig>) => void;
     getConfig: () => RequestConfig;
 };

package/es/request/index.js

@@ -1,4 +1,7 @@
+var _excluded = ["actions", "method", "headers"];
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
 function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
@@ -16,6 +19,7 @@ import { getUniqueId } from "@pisell/utils";
 import axios from "axios";
 import { getConfig, setConfig } from "./config";
 import { getApp } from "../app";
+import { createSSE } from "./sse";
 // 实例
 var axiosInstance = axios.create(axiosConfig);
 
@@ -55,12 +59,19 @@ function reportSlowRequestByObserver(entry) {
     logger = _getConfig2.logger;
   var maxRequestTime = (logger === null || logger === void 0 ? void 0 : logger.maxRequestTime) || 5000;
   var requestUrl = entry.name || "";
+  // DNS 查询耗时：域名解析开始到结束
   var dnsLookupDuration = getSafeDuration(entry.domainLookupStart, entry.domainLookupEnd);
+  // TCP 建连耗时：开始建立连接到连接建立完成（可能包含 TLS）
   var tcpHandshakeDuration = getSafeDuration(entry.connectStart, entry.connectEnd);
+  // 重定向耗时：重定向开始到重定向结束
   var redirectDuration = getSafeDuration(entry.redirectStart, entry.redirectEnd);
+  // 请求排队/阻塞耗时：fetch 开始到真正发起请求
   var stalledDuration = getSafeDuration(entry.fetchStart, entry.requestStart);
+  // TTFB（首包时间）：请求发起到收到首字节响应
   var ttfbDuration = getSafeDuration(entry.requestStart, entry.responseStart);
+  // 请求总耗时（网络视角）：请求发起到响应体接收完成
   var requestDuration = getSafeDuration(entry.requestStart, entry.responseEnd);
+  // TLS 协商耗时：TLS 开始到连接建立完成（仅 HTTPS 场景）
   var tlsHandshakeDuration = entry.secureConnectionStart > 0 ? getSafeDuration(entry.secureConnectionStart, entry.connectEnd) : 0;
   if (!requestUrl) return;
   if (isObserverIgnoredUrl(requestUrl)) return;
@@ -332,6 +343,39 @@ export var custom = function custom(url, config) {
     config: config
   });
 };
+export var sse = /*#__PURE__*/function () {
+  var _ref5 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee5(url, data, config) {
+    var actions, _config$method, method, _config$headers, customHeaders, restConfig, builtConfig, isPost;
+    return _regeneratorRuntime().wrap(function _callee5$(_context5) {
+      while (1) switch (_context5.prev = _context5.next) {
+        case 0:
+          actions = config.actions, _config$method = config.method, method = _config$method === void 0 ? "GET" : _config$method, _config$headers = config.headers, customHeaders = _config$headers === void 0 ? {} : _config$headers, restConfig = _objectWithoutProperties(config, _excluded); // 复用 interceptorsRequest 统一处理 URL 转换和认证 headers 注入
+          _context5.next = 3;
+          return interceptorsRequest(_objectSpread({
+            url: url,
+            method: method,
+            headers: _objectSpread({}, customHeaders)
+          }, restConfig || {}));
+        case 3:
+          builtConfig = _context5.sent;
+          isPost = method === "POST";
+          return _context5.abrupt("return", createSSE({
+            url: builtConfig.url,
+            method: method,
+            headers: builtConfig.headers,
+            params: isPost ? undefined : data,
+            body: isPost ? data : undefined
+          }, actions !== null && actions !== void 0 ? actions : {}));
+        case 6:
+        case "end":
+          return _context5.stop();
+      }
+    }, _callee5);
+  }));
+  return function sse(_x13, _x14, _x15) {
+    return _ref5.apply(this, arguments);
+  };
+}();
 export * from "./type";
 export default {
   get: get,
@@ -339,6 +383,7 @@ export default {
   put: put,
   remove: remove,
   custom: custom,
+  sse: sse,
   setConfig: setConfig,
   getConfig: getConfig
 };

package/es/request/sse.d.ts

@@ -0,0 +1,45 @@
+export interface SSEMetaData {
+    total: number;
+    store_id?: string;
+}
+export interface SSEProgress {
+    current: number;
+    total: number;
+    last_version: number;
+    since_version: number;
+}
+export interface SSEDataPayload<TItem = any> {
+    items: TItem[];
+    progress?: SSEProgress;
+}
+export interface SSECompletePayload {
+    count: number;
+    last_version: number;
+}
+export interface SSEErrorPayload {
+    message: string;
+    code?: number;
+}
+export interface SSEActions<TMeta = SSEMetaData, TData = SSEDataPayload, TComplete = SSECompletePayload> {
+    onOpen?: () => void;
+    onMeta?: (data: TMeta) => void;
+    onProgress?: (data: SSEProgress) => void;
+    onData?: (data: TData) => void;
+    onTypeDone?: (data: TComplete) => void;
+    onDone?: (data: TComplete) => void;
+    onError?: (err: SSEErrorPayload | Error) => void;
+}
+export interface SSEConfig {
+    url: string;
+    params?: Record<string, any>;
+    method?: 'GET' | 'POST';
+    body?: Record<string, any>;
+    headers?: Record<string, string>;
+}
+/**
+ * 底层 SSE 请求封装，基于 @microsoft/fetch-event-source
+ * 支持自定义 headers（解决原生 EventSource 无法携带 Authorization 的问题）
+ *
+ * @returns abort 函数，组件卸载时调用以关闭连接
+ */
+export declare function createSSE<TMeta = SSEMetaData, TData = SSEDataPayload, TComplete = SSECompletePayload>(config: SSEConfig, actions: SSEActions<TMeta, TData, TComplete>): () => void;