@mingto/version-polling 1.0.31

package/dist/polling-worker.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 版本轮询 Worker 主函数
+ * - 支持两种检测模式：
+ *   1）VERSION：基于 {version: X.Y.Z} 版本号比较
+ *   2）IDENTIFIER：基于 ETag/Last-Modified 变化
+ */
+declare function pollingWorker(): void;
+export default pollingWorker;

package/dist/types/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 轮询检测方式
+ */
+declare enum DetectionMode {
+    IDENTIFIER = "identifier",
+    VERSION = "version"
+}
+/**
+ * 轮询配置项
+ */
+interface VersionPollingOptions {
+    readonly pollingInterval: number;
+    readonly fileUrl: string;
+    readonly detectionMode: DetectionMode;
+}
+/**
+ * 发送消息给worker
+ */
+interface SendWorkerMessage<T = any> {
+    readonly type: 'init' | 'start' | 'resume' | 'pause';
+    readonly data?: T;
+}
+/**
+ * 接收来自worker的消息
+ */
+type ReplyWorkerMessage<T = any> = {
+    readonly type: 'update';
+    readonly data: T;
+} | {
+    readonly type: 'check';
+    readonly data: T;
+};
+/**
+ * 对外暴露的事件名称
+ */
+type PublicCustomEventName = 'update';
+export { DetectionMode };
+export type { PublicCustomEventName, ReplyWorkerMessage, SendWorkerMessage, VersionPollingOptions };

package/dist/utils/event-bus.d.ts

@@ -0,0 +1,10 @@
+interface EventCallback {
+    (...args: any[]): any;
+}
+declare class EventBus<E = any> {
+    private listeners;
+    on(eventName: E, callback: EventCallback): void;
+    emit<T = any>(eventName: E, data?: T): void;
+}
+declare function createEventBus<E>(): EventBus<E>;
+export { createEventBus };

package/dist/utils/index.d.ts

@@ -0,0 +1 @@
+export * from './event-bus';

package/dist/version-polling.d.ts

@@ -0,0 +1,61 @@
+import { PublicCustomEventName, VersionPollingOptions } from './types';
+/**
+ * 版本轮询类
+ * 用于定期检查服务器上的文件版本（HTML 或 JSON），并在检测到更新时通知客户端
+ */
+declare class VersionPolling {
+    private worker;
+    private options;
+    private lastIdentifier;
+    private lastVersion;
+    constructor(options: Partial<VersionPollingOptions>);
+    /**
+     * 初始化配置项
+     * @param options - 用户传入的配置部分
+     */
+    private initializeOptions;
+    /**
+     * 初始化 Worker 并设置消息监听
+     */
+    private initializeWorker;
+    /**
+     * 处理检查消息
+     * @param data - Worker 返回的数据
+     */
+    private handleCheckMessage;
+    /**
+     * 设置页面可见性监听器
+     * 当页面不可见时暂停轮询，可见时恢复轮询
+     */
+    private setupVisibilityListener;
+    /**
+     * 处理页面可见性变化事件
+     */
+    private onVisibilityChange;
+    /**
+     * 当检测到版本更新时触发
+     */
+    private onVersionUpdate;
+    /**
+     * 开始轮询
+     */
+    private startPolling;
+    /**
+     * 停止轮询并清理资源
+     */
+    private stopPolling;
+    /**
+     * 触发事件
+     * @param eventName - 事件名称
+     * @param data - 事件数据
+     */
+    private emit;
+    /**
+     * 监听事件
+     * @param eventName - 事件名称
+     * @param callback - 回调函数
+     * @returns 当前实例，支持链式调用
+     */
+    on(eventName: PublicCustomEventName, callback: (data?: any) => void): VersionPolling;
+}
+export default VersionPolling;

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@mingto/version-polling",
+  "type": "module",
+  "version": "1.0.31",
+  "description": "实时检测是否发布新版本",
+  "author": "hcc",
+  "license": "ISC",
+  "keywords": [
+    "检测",
+    "线上环境版本"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build"
+  },
+  "dependencies": {
+    "@mingto/tools": "1.0.670",
+    "@types/semver": "^7.7.0",
+    "semver": "^7.7.2"
+  }
+}