@iflyrpa/playwright 4.0.9 → 4.1.0-beta.0

package/dist/index.d.ts

@@ -10,6 +10,90 @@ import { User } from '@sentry/node';
 
 export { ActionMethodParams }
 
+/**
+ * 脚本包（@iflyrpa/actions）的版本状态
+ */
+export declare interface ActionVersionInfo {
+    /** 当前内存中实际生效的版本 */
+    current: string;
+    /** 随 @iflyrpa/playwright 一起打包的内置版本 */
+    bundled: string;
+    /** 远端 registry 上对应渠道的最新版本，未查询成功时为 null */
+    latest: string | null;
+    /** 远端存在更新且尚未生效（current !== latest） */
+    hasUpdate: boolean;
+    /** 更新已下载并热替换成功，无需重启 */
+    applied: boolean;
+    /** 本次查询使用的渠道：beta 由 GrowthBook 灰度开关决定 */
+    channel: "latest" | "beta";
+    /** 更新流程失败时的原因 */
+    error?: string;
+}
+
+/**
+ * 比较两个 semver 版本，a 比 b 新返回正数
+ *
+ * 只覆盖本仓库用到的 `x.y.z` 和 `x.y.z-beta.n` 两种形态，
+ * 按 semver 规则 prerelease 小于同版本号的正式版。
+ */
+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);
@@ -27,15 +111,89 @@ declare class PackageManager {
     private extract;
     require(module: string): any;
     install(name: string, version: string): Promise<void>;
-    update(name: string): Promise<string>;
+    /**
+     * 查询远端指定 dist-tag 的版本号（只读，不下载）
+     *
+     * distTag 缺失时（比如从未发过 beta）回退到 latest，不阻断更新。
+     */
+    getVersionByTag(name: string, distTag?: string): Promise<string>;
+    /**
+     * 查询远端应当使用的版本号（只读，不下载）
+     *
+     * beta 渠道取 beta 与 latest 的较大值：beta tag 可能落后于正式版
+     * （正式版发布后 beta tag 不会自动前移），此时不应让灰度用户降级。
+     */
+    getLatestVersion(name: string, useBeta?: boolean): Promise<string>;
+    update(name: string, useBeta?: boolean): Promise<string>;
 }
 
 export declare class RpaTask extends Task {
     actions: RpaAction.Action;
     private actionName;
+    /** 内置版本，热更新失败时的回退基线 */
+    private readonly bundledActionVersion;
+    /** 内存中实际生效的版本 */
+    private currentActionVersion;
+    private latestActionVersion;
+    private appliedUpdate;
+    private updateChannel;
+    private updateError?;
+    /** 构造函数触发的更新任务，供 waitForUpdate 复用，避免重复请求 */
+    private updateTask;
     constructor(params: TaskParams);
     private registerActions;
+    /**
+     * 获取当前运行的脚本包（@iflyrpa/actions）版本号
+     *
+     * 返回内存中实际生效的版本，热更新后会自动切换到新版本。
+     * 适用于在脚本执行过程中记录或上报实际使用的脚本版本。
+     */
+    getActionVersion(): string;
+    /**
+     * 脚本包版本状态快照（同步，不发起网络请求）
+     *
+     * 第三方可用它与自己记录的版本比对，决定是否提示重启。
+     * 注意：applied 为 true 时更新已在内存中生效，无需重启。
+     */
+    getActionVersionInfo(): ActionVersionInfo;
+    /**
+     * 当前用户是否走灰度渠道
+     *
+     * 取决于 GrowthBook 的 HuiwenCanary 开关，未初始化时返回 false（走正式渠道）。
+     * 注意 GrowthBook 依赖 setUser 才会初始化，未调用 setUser 的场景恒为正式渠道。
+     */
+    private useBetaChannel;
+    /**
+     * 只查询远端最新版本号，不下载、不替换
+     *
+     * 适合"启动时静默检查有没有新版本"的场景。
+     */
+    checkActionUpdate(): Promise<ActionVersionInfo>;
+    /**
+     * 等待构造函数触发的更新流程结束，返回最终版本状态
+     *
+     * forceUpdate 为 false 时会主动执行一次更新。
+     * 多次调用复用同一个任务，不会重复下载。
+     */
+    waitForActionUpdate(): Promise<ActionVersionInfo>;
     private update;
+    /**
+     * 【测试专用】验证脚本是否真的在内存中更新了
+     *
+     * 通过调用 actions 实例的版本标识方法，验证热更新后内存中的代码是否真的被替换。
+     * 如果版本标识变化，说明热更新成功；如果标识不变，说明仍在使用旧版本。
+     *
+     * @returns 当前内存中 Action 实例的版本标识
+     */
+    verifyActionMemoryUpdate(): {
+        version: string;
+        shareVersion: string;
+        marker: string;
+        timestamp: string;
+    } | {
+        error: string;
+        currentVersion: string;
+    };
 }
 
 declare class SentryInstance {
@@ -127,6 +285,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

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7135424a-8b43-5186-b3bf-add32278e972")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="92f20852-4bf4-5fbf-bdb2-412040c14232")}catch(e){}}();
 import * as __WEBPACK_EXTERNAL_MODULE_punycode__ from "punycode";
 import * as __WEBPACK_EXTERNAL_MODULE_stream__ from "stream";
 import * as __WEBPACK_EXTERNAL_MODULE_http__ from "http";
@@ -2552,9 +2552,7 @@ function __webpack_require__(moduleId) {
         });
     };
 })();
-var package_namespaceObject = {
-    i8: "4.0.9"
-};
+var package_namespaceObject = JSON.parse('{"i8":"4.1.0-beta.0"}');
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -5363,10 +5361,45 @@ function packageManager_define_property(obj, key, value) {
     return obj;
 }
 const NPM_REGISTRY = "https://registry.npmmirror.com/";
+const LATEST_TAG = "latest";
+const BETA_TAG = "beta";
+function compareVersion(a, b) {
+    const parse = (v)=>{
+        const [core, pre] = v.split("-");
+        const nums = core.split(".").map(Number);
+        return {
+            nums,
+            pre
+        };
+    };
+    const va = parse(a);
+    const vb = parse(b);
+    for(let i = 0; i < 3; i++){
+        const diff = (va.nums[i] ?? 0) - (vb.nums[i] ?? 0);
+        if (0 !== diff) return diff;
+    }
+    if (!va.pre && !vb.pre) return 0;
+    if (!va.pre) return 1;
+    if (!vb.pre) return -1;
+    const pa = va.pre.split(".");
+    const pb = vb.pre.split(".");
+    for(let i = 0; i < Math.max(pa.length, pb.length); i++){
+        const sa = pa[i];
+        const sb = pb[i];
+        if (void 0 === sa) return -1;
+        if (void 0 === sb) return 1;
+        const na = Number(sa);
+        const nb = Number(sb);
+        const bothNumeric = !Number.isNaN(na) && !Number.isNaN(nb);
+        const diff = bothNumeric ? na - nb : sa.localeCompare(sb);
+        if (0 !== diff) return diff;
+    }
+    return 0;
+}
 class PackageManager {
     async getManifest(module) {
         try {
-            return __WEBPACK_EXTERNAL_MODULE__iflyrpa_pacote_56da1cff__["default"].manifest(module, {
+            return await __WEBPACK_EXTERNAL_MODULE__iflyrpa_pacote_56da1cff__["default"].manifest(module, {
                 registry: NPM_REGISTRY
             });
         } catch (error) {
@@ -5397,9 +5430,25 @@ class PackageManager {
         const plugin = this.require(packageName);
         if (!plugin) await this.extract(name, version);
     }
-    async update(name) {
-        const manifest = await this.getManifest(`${name}@latest`);
-        const version = manifest.version;
+    async getVersionByTag(name, distTag = LATEST_TAG) {
+        try {
+            const manifest = await this.getManifest(`${name}@${distTag}`);
+            return manifest.version;
+        } catch (error) {
+            if (distTag === LATEST_TAG) throw error;
+            this.task.logger.warn(`${name}@${distTag} 不存在，回退到 ${LATEST_TAG}`);
+            const manifest = await this.getManifest(`${name}@${LATEST_TAG}`);
+            return manifest.version;
+        }
+    }
+    async getLatestVersion(name, useBeta = false) {
+        const latest = await this.getVersionByTag(name, LATEST_TAG);
+        if (!useBeta) return latest;
+        const beta = await this.getVersionByTag(name, BETA_TAG);
+        return compareVersion(beta, latest) > 0 ? beta : latest;
+    }
+    async update(name, useBeta = false) {
+        const version = await this.getLatestVersion(name, useBeta);
         const plugin = this.require(`${name}@${version}/package.json`);
         if (!plugin) await this.extract(name, version);
         return version;
@@ -5615,6 +5664,25 @@ class Task {
         this.electronPackage = this.installElectron();
     }
 }
+var version_history_namespaceObject = JSON.parse('{"name":"@iflyrpa/playwright","currentVersion":"4.0.9","lastUpdate":"2026-08-14","maxVersions":10,"versions":[{"version":"4.0.9","releaseDate":"2026-08-14","releaseNote":["1"],"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,
@@ -5628,25 +5696,84 @@ function src_define_property(obj, key, value) {
 class RpaTask extends Task {
     registerActions(rpaAction) {
         this.actions = new rpaAction.Action(this);
+        this.currentActionVersion = rpaAction.version;
         this.setActionVersion(rpaAction.version);
     }
+    getActionVersion() {
+        return this.currentActionVersion;
+    }
+    getActionVersionInfo() {
+        return {
+            current: this.currentActionVersion,
+            bundled: this.bundledActionVersion,
+            latest: this.latestActionVersion,
+            hasUpdate: !!this.latestActionVersion && this.latestActionVersion !== this.currentActionVersion,
+            applied: this.appliedUpdate,
+            channel: this.updateChannel,
+            error: this.updateError
+        };
+    }
+    useBetaChannel() {
+        const useBeta = this.isFeatOn(__WEBPACK_EXTERNAL_MODULE__iflyrpa_actions_bd801d6f__.BetaFlag);
+        this.updateChannel = useBeta ? "beta" : "latest";
+        return useBeta;
+    }
+    async checkActionUpdate() {
+        try {
+            this.latestActionVersion = await this.packageManager.getLatestVersion(this.actionName, this.useBetaChannel());
+            this.updateError = void 0;
+        } catch (error) {
+            this.updateError = error instanceof Error ? error.message : String(error);
+            this.logger.error("检查脚本版本失败", error);
+        }
+        return this.getActionVersionInfo();
+    }
+    waitForActionUpdate() {
+        if (!this.updateTask) this.updateTask = this.update();
+        return this.updateTask;
+    }
     async update() {
         try {
-            const version = await this.packageManager.update(this.actionName);
+            const version = await this.packageManager.update(this.actionName, this.useBetaChannel());
+            this.latestActionVersion = version;
+            if (version === this.currentActionVersion) {
+                this.appliedUpdate = false;
+                return this.getActionVersionInfo();
+            }
             const rpaPackage = this.packageManager.require(`${this.actionName}@${version}/dist/bundle.js`);
-            (null == rpaPackage ? void 0 : rpaPackage.Action) && this.registerActions(rpaPackage);
+            if (null == rpaPackage ? void 0 : rpaPackage.Action) {
+                this.registerActions(rpaPackage);
+                this.appliedUpdate = true;
+                this.updateError = void 0;
+                this.logger.info(`脚本已热更新至 ${version}`);
+            } else {
+                this.appliedUpdate = false;
+                this.updateError = `加载 ${this.actionName}@${version} 失败`;
+                this.logger.warn(this.updateError);
+            }
         } catch (error) {
+            this.appliedUpdate = false;
+            this.updateError = error instanceof Error ? error.message : String(error);
             this.logger.error("更新依赖失败", error);
         }
+        return this.getActionVersionInfo();
+    }
+    verifyActionMemoryUpdate() {
+        var _this_actions;
+        if (!(null === (_this_actions = this.actions) || void 0 === _this_actions ? void 0 : _this_actions.getActionVersionMarker)) return {
+            error: "getActionVersionMarker 方法不存在，可能是旧版本的 @iflyrpa/actions",
+            currentVersion: this.currentActionVersion
+        };
+        return this.actions.getActionVersionMarker();
     }
     constructor(params){
-        super(params), src_define_property(this, "actions", void 0), src_define_property(this, "actionName", "@iflyrpa/actions");
+        super(params), src_define_property(this, "actions", void 0), src_define_property(this, "actionName", "@iflyrpa/actions"), src_define_property(this, "bundledActionVersion", __WEBPACK_EXTERNAL_MODULE__iflyrpa_actions_bd801d6f__.version), src_define_property(this, "currentActionVersion", __WEBPACK_EXTERNAL_MODULE__iflyrpa_actions_bd801d6f__.version), src_define_property(this, "latestActionVersion", null), src_define_property(this, "appliedUpdate", false), src_define_property(this, "updateChannel", "latest"), src_define_property(this, "updateError", void 0), src_define_property(this, "updateTask", null);
         this.registerActions(__WEBPACK_EXTERNAL_MODULE__iflyrpa_actions_bd801d6f__);
-        params.forceUpdate && this.update();
+        if (params.forceUpdate) this.updateTask = this.update();
     }
 }
 const src_version = package_namespaceObject.i8;
-export { RpaTask, src_version as version };
+export { RpaTask, compareVersion, getLatestVersionRecord, getMaxUpdateLevel, getVersionHistory, getVersionRecord, getVersionRecordsSince, src_version as version };
 
 //# sourceMappingURL=index.js.map
-//# debugId=7135424a-8b43-5186-b3bf-add32278e972
+//# debugId=92f20852-4bf4-5fbf-bdb2-412040c14232