@pisell/core 0.0.2

package/es/pubsub/example.js

@@ -0,0 +1,92 @@
+/**
+ * 发布订阅模块使用示例
+ * 此文件仅用于演示，不会被实际引入项目
+ */
+
+import pubsub from "./index";
+
+// ============= 示例1：基本使用 =============
+
+// 定义事件类型（可选，但推荐）
+
+// 订阅事件
+var handleUserLogin = function handleUserLogin(userData) {
+  console.log("\u7528\u6237 ".concat(userData.username, " \u767B\u5F55\u6210\u529F"));
+  // 执行登录后的业务逻辑
+};
+
+// 保存订阅引用，方便后续取消订阅
+var subscription = pubsub.subscribe('user:login', handleUserLogin);
+
+// 模拟在其他组件中触发事件
+setTimeout(function () {
+  pubsub.publish('user:login', {
+    userId: 'user_123',
+    username: '张三',
+    timestamp: Date.now()
+  });
+}, 1000);
+
+// 取消订阅（例如在组件销毁时）
+// subscription.unsubscribe();
+
+// ============= 示例2：一次性订阅 =============
+
+pubsub.once('notification:welcome', function (message) {
+  console.log("\u6B22\u8FCE\u901A\u77E5: ".concat(message));
+  // 这个回调只会执行一次
+});
+
+// 连续触发两次事件，但回调只会执行一次
+pubsub.publish('notification:welcome', '欢迎来到我们的平台！');
+pubsub.publish('notification:welcome', '这条消息不会被处理'); // 这条不会触发回调
+
+// ============= 示例3：多个参数 =============
+
+pubsub.subscribe('cart:update', function (itemId, quantity, price) {
+  console.log("\u8D2D\u7269\u8F66\u66F4\u65B0: \u5546\u54C1ID=".concat(itemId, ", \u6570\u91CF=").concat(quantity, ", \u4EF7\u683C=").concat(price));
+  var subtotal = quantity * price;
+  console.log("\u5C0F\u8BA1: \xA5".concat(subtotal.toFixed(2)));
+});
+
+// 发布带有多个参数的事件
+pubsub.publish('cart:update', 'product_456', 2, 99.5);
+
+// ============= 示例4：错误处理 =============
+
+// 订阅事件但包含可能出错的回调
+pubsub.subscribe('data:process', function (data) {
+  console.log('处理数据...');
+  // 假设这里有一个错误
+  throw new Error('数据处理失败');
+  // 即使抛出错误，其他订阅者的回调仍会执行
+});
+
+// 另一个订阅同一事件的回调
+pubsub.subscribe('data:process', function (data) {
+  console.log('第二个处理器仍然会执行');
+});
+
+// 触发事件，即使第一个回调出错，第二个回调仍会执行
+pubsub.publish('data:process', {
+  id: 789
+});
+
+// ============= 示例5：检查订阅状态 =============
+
+// 检查是否有订阅者
+var hasLoginSubscribers = pubsub.hasSubscribers('user:login');
+console.log("\u7528\u6237\u767B\u5F55\u4E8B\u4EF6\u662F\u5426\u6709\u8BA2\u9605\u8005: ".concat(hasLoginSubscribers));
+
+// 获取订阅者数量
+var loginSubscriberCount = pubsub.getSubscriberCount('user:login');
+console.log("\u7528\u6237\u767B\u5F55\u4E8B\u4EF6\u7684\u8BA2\u9605\u8005\u6570\u91CF: ".concat(loginSubscriberCount));
+
+// ============= 示例6：清除事件 =============
+
+// 清除特定事件的所有订阅
+pubsub.clearEvent('user:login');
+console.log('已清除所有用户登录事件的订阅');
+
+// 全局清除（慎用）
+// pubsub.clearAllEvents();

package/es/pubsub/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 发布订阅模块
+ * 用于组件/服务间的事件通信
+ */
+declare 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;
+    /**
+     * @title: 异步发布,  某些事件需要延迟发布
+     * @description:
+     * @param {string} event
+     * @param {number} timeout
+     * @param {array} args
+     * @return {*}
+     * @Author: zhiwei.Wang
+     */
+    publishDelay(event: string, delay?: number, ...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/es/pubsub/index.js

@@ -0,0 +1,166 @@
+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 _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * 发布订阅模块
+ * 用于组件/服务间的事件通信
+ */
+var PubSub = /*#__PURE__*/function () {
+  function PubSub() {
+    _classCallCheck(this, PubSub);
+    _defineProperty(this, "events", new Map());
+  }
+  _createClass(PubSub, [{
+    key: "subscribe",
+    value:
+    /**
+     * 订阅事件
+     * @param event 事件名称
+     * @param callback 回调函数
+     * @returns 订阅对象，可用于取消订阅
+     */
+    function subscribe(event, callback) {
+      var _this = this;
+      if (!this.events.has(event)) {
+        this.events.set(event, new Set());
+      }
+      var callbacks = this.events.get(event);
+      callbacks.add(callback);
+      return {
+        unsubscribe: function unsubscribe() {
+          _this.unsubscribe(event, callback);
+        }
+      };
+    }
+
+    /**
+     * 取消订阅事件
+     * @param event 事件名称
+     * @param callback 回调函数
+     * @returns 是否成功取消订阅
+     */
+  }, {
+    key: "unsubscribe",
+    value: function unsubscribe(event, callback) {
+      var callbacks = this.events.get(event);
+      if (!callbacks) {
+        return false;
+      }
+      return callbacks.delete(callback);
+    }
+
+    /**
+     * 发布事件
+     * @param event 事件名称
+     * @param args 事件参数
+     */
+  }, {
+    key: "publish",
+    value: function publish(event) {
+      for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+        args[_key - 1] = arguments[_key];
+      }
+      var callbacks = this.events.get(event);
+      if (!callbacks) {
+        return;
+      }
+      callbacks.forEach(function (callback) {
+        try {
+          callback.apply(void 0, args);
+        } catch (error) {
+          console.error("\u6267\u884C\u4E8B\u4EF6\"".concat(event, "\"\u7684\u56DE\u8C03\u65F6\u51FA\u9519:"), error);
+        }
+      });
+    }
+
+    /**
+     * @title: 异步发布,  某些事件需要延迟发布
+     * @description: 
+     * @param {string} event
+     * @param {number} timeout
+     * @param {array} args
+     * @return {*}
+     * @Author: zhiwei.Wang
+     */
+  }, {
+    key: "publishDelay",
+    value: function publishDelay(event) {
+      var _this2 = this;
+      var delay = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+      for (var _len2 = arguments.length, args = new Array(_len2 > 2 ? _len2 - 2 : 0), _key2 = 2; _key2 < _len2; _key2++) {
+        args[_key2 - 2] = arguments[_key2];
+      }
+      setTimeout(function () {
+        _this2.publish.apply(_this2, [event].concat(args));
+      }, delay);
+    }
+
+    /**
+     * 移除某个事件的所有订阅
+     * @param event 事件名称
+     * @returns 是否成功移除
+     */
+  }, {
+    key: "clearEvent",
+    value: function clearEvent(event) {
+      return this.events.delete(event);
+    }
+
+    /**
+     * 移除所有事件订阅
+     */
+  }, {
+    key: "clearAllEvents",
+    value: function clearAllEvents() {
+      this.events.clear();
+    }
+
+    /**
+     * 获取事件的订阅数量
+     * @param event 事件名称
+     * @returns 订阅数量
+     */
+  }, {
+    key: "getSubscriberCount",
+    value: function getSubscriberCount(event) {
+      var callbacks = this.events.get(event);
+      return callbacks ? callbacks.size : 0;
+    }
+
+    /**
+     * 检查事件是否有订阅者
+     * @param event 事件名称
+     * @returns 是否有订阅者
+     */
+  }, {
+    key: "hasSubscribers",
+    value: function hasSubscribers(event) {
+      return this.getSubscriberCount(event) > 0;
+    }
+
+    /**
+     * 一次性订阅事件，事件触发后自动取消订阅
+     * @param event 事件名称
+     * @param callback 回调函数
+     * @returns 订阅对象，可用于取消订阅
+     */
+  }, {
+    key: "once",
+    value: function once(event, callback) {
+      var _this3 = this;
+      var wrappedCallback = function wrappedCallback() {
+        _this3.unsubscribe(event, wrappedCallback);
+        callback.apply(void 0, arguments);
+      };
+      return this.subscribe(event, wrappedCallback);
+    }
+  }]);
+  return PubSub;
+}(); // 创建单例实例
+var pubsub = new PubSub();
+export default pubsub;
+export { PubSub };

package/es/request/cache.d.ts

@@ -0,0 +1,46 @@
+import { CacheProps } from './type';
+export declare 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>;