@iflyrpa/playwright 4.0.9-beta.1 → 4.0.9-beta.2

package/dist/index.d.ts

@@ -38,6 +38,62 @@ export declare interface ActionVersionInfo {
  */
 export declare function compareVersion(a: string, b: string): number;
 
+/**
+ * 获取最新版本记录
+ *
+ * @returns 最新的版本记录，无历史记录时返回 null
+ */
+export declare function getLatestVersionRecord(): VersionRecord | null;
+
+/**
+ * 取一组版本记录中的最高价值等级
+ *
+ * 跨多个版本升级时，应按其中最严格的等级决定更新策略：
+ * 只要期间有过一个 LEVEL_2 版本，就必须强制更新重启。
+ *
+ * @returns 最高等级，records 为空时返回 null
+ */
+export declare function getMaxUpdateLevel(records: VersionRecord[]): UpdateLevel | null;
+
+/**
+ * 获取版本历史信息
+ *
+ * 数据来自随包发布的 version-history.json，同步返回，不发起网络请求。
+ *
+ * @example
+ * ```typescript
+ * import { getVersionHistory } from "@iflyrpa/playwright";
+ *
+ * const history = getVersionHistory();
+ * console.log("当前版本:", history.currentVersion);
+ * ```
+ */
+export declare function getVersionHistory(): VersionHistory;
+
+/**
+ * 获取指定版本的详细信息
+ *
+ * @param version - 版本号，如 "4.1.0"
+ * @returns 版本记录，版本不存在时返回 null
+ */
+export declare function getVersionRecord(version: string): VersionRecord | null;
+
+/**
+ * 获取从 fromVersion（不含）到最新版本（含）之间的所有版本记录
+ *
+ * 三方升级后可用它一次性展示期间累积的全部更新内容。
+ * fromVersion 不在历史记录中时（跨度超过保留的 10 个版本），返回全部记录。
+ *
+ * @param fromVersion - 用户当前所在版本
+ *
+ * @example
+ * ```typescript
+ * const notes = getVersionRecordsSince("4.0.8");
+ * // 展示 4.0.9 ~ 4.1.0 之间的所有更新说明
+ * ```
+ */
+export declare function getVersionRecordsSince(fromVersion: string): VersionRecord[];
+
 declare class Logger extends SentryInstance implements LoggerImplement {
     private stream;
     constructor(taskParams: TaskParams);
@@ -205,6 +261,49 @@ declare interface TaskParams {
 
 declare type TimeConsuming = Record<string, number>;
 
+/**
+ * 版本价值等级
+ *
+ * - 0 细微：修复小问题、文档更新、轻微优化，可选更新
+ * - 1 一般：新功能、常规优化、非关键修复，建议更新
+ * - 2 强烈：重大功能、安全修复、关键性能优化，强制更新并重启
+ */
+export declare type UpdateLevel = 0 | 1 | 2;
+
 export declare const version: string;
 
+/**
+ * 版本历史数据
+ */
+export declare interface VersionHistory {
+    /** 包名 */
+    name: string;
+    /** 当前版本 */
+    currentVersion: string;
+    /** 最后更新日期 */
+    lastUpdate: string;
+    /** 保留的最大版本数 */
+    maxVersions: number;
+    /** 版本记录列表（从新到旧） */
+    versions: VersionRecord[];
+}
+
+/**
+ * 单个版本记录
+ */
+export declare interface VersionRecord {
+    /** 版本号 */
+    version: string;
+    /** 发布日期 YYYY-MM-DD */
+    releaseDate: string;
+    /** 版本更新说明 */
+    releaseNote: string[];
+    /** 版本价值等级 0-细微 1-一般 2-强烈 */
+    updateLevel: UpdateLevel;
+    /** 更新策略建议 */
+    updateStrategy: string;
+    /** 变更类型 */
+    changeType: "patch" | "minor" | "major";
+}
+
 export { }

package/dist/index.js

@@ -2550,7 +2550,7 @@ function __webpack_require__(moduleId) {
         });
     };
 })();
-var package_namespaceObject = JSON.parse('{"i8":"4.0.9-beta.1"}');
+var package_namespaceObject = JSON.parse('{"i8":"4.0.9-beta.2"}');
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -5662,6 +5662,25 @@ class Task {
         this.electronPackage = this.installElectron();
     }
 }
+var version_history_namespaceObject = JSON.parse('{"name":"@iflyrpa/playwright","currentVersion":"4.0.9-beta.2","lastUpdate":"2026-08-13","maxVersions":10,"versions":[{"version":"4.0.9-beta.2","releaseDate":"2026-08-13","releaseNote":["1.增加版本更新记录","2.优化错误提示"],"updateLevel":1,"updateStrategy":"建议更新","changeType":"patch"},{"version":"4.0.9-beta.1","releaseDate":"2024-08-10","releaseNote":["改进多个 action 的用户错误提示信息"],"updateLevel":1,"updateStrategy":"建议更新","changeType":"patch"}]}');
+function getVersionHistory() {
+    return version_history_namespaceObject;
+}
+function getLatestVersionRecord() {
+    return getVersionHistory().versions[0] ?? null;
+}
+function getVersionRecord(version) {
+    return getVersionHistory().versions.find((v)=>v.version === version) ?? null;
+}
+function getVersionRecordsSince(fromVersion) {
+    const { versions } = getVersionHistory();
+    const index = versions.findIndex((v)=>v.version === fromVersion);
+    return -1 === index ? versions : versions.slice(0, index);
+}
+function getMaxUpdateLevel(records) {
+    if (0 === records.length) return null;
+    return records.reduce((max, r)=>r.updateLevel > max ? r.updateLevel : max, 0);
+}
 function src_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -5741,6 +5760,6 @@ class RpaTask extends Task {
     }
 }
 const src_version = package_namespaceObject.i8;
-export { RpaTask, compareVersion, src_version as version };
+export { RpaTask, compareVersion, getLatestVersionRecord, getMaxUpdateLevel, getVersionHistory, getVersionRecord, getVersionRecordsSince, src_version as version };
 
 //# sourceMappingURL=index.js.map