@iflyrpa/playwright 4.0.8-beta.0 → 4.0.9-beta.0

package/dist/index.d.ts

@@ -10,6 +10,34 @@ 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;
+
 declare class Logger extends SentryInstance implements LoggerImplement {
     private stream;
     constructor(taskParams: TaskParams);
@@ -27,14 +55,64 @@ 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;
+    /**
+     * 脚本包版本状态快照（同步，不发起网络请求）
+     *
+     * 第三方可用它与自己记录的版本比对，决定是否提示重启。
+     * 注意：applied 为 true 时更新已在内存中生效，无需重启。
+     */
+    getActionVersionInfo(): ActionVersionInfo;
+    /**
+     * 当前用户是否走灰度渠道
+     *
+     * 取决于 GrowthBook 的 HuiwenCanary 开关，未初始化时返回 false（走正式渠道）。
+     * 注意 GrowthBook 依赖 setUser 才会初始化，未调用 setUser 的场景恒为正式渠道。
+     */
+    private useBetaChannel;
+    /**
+     * 只查询远端最新版本号，不下载、不替换
+     *
+     * 适合"启动时静默检查有没有新版本"的场景。
+     */
+    checkActionUpdate(): Promise<ActionVersionInfo>;
+    /**
+     * 等待构造函数触发的更新流程结束，返回最终版本状态
+     *
+     * forceUpdate 为 false 时会主动执行一次更新。
+     * 多次调用复用同一个任务，不会重复下载。
+     */
+    waitForActionUpdate(): Promise<ActionVersionInfo>;
     private update;
 }
 

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]="e917807d-cf3e-5e05-acac-c2c1de740544")}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]="5aee042a-271f-593f-94b2-737064f7b3b3")}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,7 +2552,7 @@ function __webpack_require__(moduleId) {
         });
     };
 })();
-var package_namespaceObject = JSON.parse('{"i8":"4.0.8-beta.0"}');
+var package_namespaceObject = JSON.parse('{"i8":"4.0.9-beta.0"}');
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -5361,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) {
@@ -5395,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;
@@ -5626,25 +5677,73 @@ 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);
     }
+    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();
     }
     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, src_version as version };
 
 //# sourceMappingURL=index.js.map
-//# debugId=e917807d-cf3e-5e05-acac-c2c1de740544
+//# debugId=5aee042a-271f-593f-94b2-737064f7b3b3