@iflyrpa/actions 4.1.0-beta.6 → 4.1.0

package/dist/utils/feishuAlarm.d.ts

@@ -22,6 +22,9 @@ export interface FeishuAlarmReport {
 }
 /**
  * 上报错误到飞书群，失败静默：告警链路不能影响主流程。
- * 同一 platform + source + errorType + code 组合在 60s 内只发一条。
+ * 同一 platform + source + stage + errorType + code 组合在 60s 内只发一条。
+ *
+ * 节流 key 里必须带 stage：不同接口的同类错误（例如 unread_count 与 personal_info
+ * 同时 ECONNABORTED）是两个独立问题，混成一个 key 会让后来的那个被静默吞掉。
  */
 export declare const reportFeishuAlarm: (report: FeishuAlarmReport) => void;

package/dist/utils/http.d.ts

@@ -1,5 +1,13 @@
 import type { LoggerImplement, ResponseData } from "@iflyrpa/share";
 import { type AxiosRequestConfig, type AxiosResponse, type CreateAxiosDefaults } from "axios";
+/**
+ * 判断是否为本机地址（localhost / 回环 IP / .local 等）。
+ *
+ * 本机地址上的失败来自本地服务或单元测试，不是线上问题，不该进告警群。
+ * 用 URL 解析而非字符串包含匹配：`https://api.example.com/?cb=localhost` 这类
+ * 参数里带 localhost 的线上地址不能被误判成本机。
+ */
+export declare function isLocalAddress(url: string): boolean;
 export declare class Http {
     private readonly apiClient;
     logger?: LoggerImplement;
@@ -10,6 +18,14 @@ export declare class Http {
     constructor(config?: CreateAxiosDefaults, logger?: LoggerImplement, addr?: string | null, accountId?: number, platform?: string);
     clearResponseInterceptors(): void;
     addResponseInterceptor<T = any>(findError: (response: AxiosResponse<T>) => ResponseData | undefined): void;
+    /**
+     * 请求最终失败（重试耗尽或错误不可重试）后上报飞书告警。
+     * 告警所需的 status / axios error code 由响应拦截器写入 error.extra。
+     *
+     * 两类请求不上报：本机地址（localhost / 127.0.0.1 等）与拿不到 URL 的错误。
+     * 前者是本地服务或测试用例，后者没有目标地址无法定位，都属于告警噪音。
+     */
+    private reportRequestFailure;
     api<T = any>(config: AxiosRequestConfig, options?: {
         retries?: number;
         retryDelay?: number;

package/dist/utils/shipinhao/utils.d.ts

@@ -1,4 +1,14 @@
 export declare const contentLimitLength: (content: string) => boolean;
+/**
+ * 从上传接口（completepartuploaddfs）返回的 DownloadURL 中提取 encfilekey。
+ *
+ * 这个 key 是发布结果与作品列表之间唯一稳定的关联标识：图文与视频发布都返回它，
+ * 上层据此把发布记录对上作品。不要改用 clipKey —— clipKey 只是转码任务 id，
+ * 发布完成后在作品列表侧查不到对应记录。
+ *
+ * 取不到时返回空字符串（与图文侧原有行为一致），由调用方决定是否记日志。
+ */
+export declare const extractEncFileKey: (downloadUrl?: string) => string;
 export declare const rid: () => string;
 /**
  * UUID v4 生成器

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iflyrpa/actions",
-  "version": "4.1.0-beta.6",
+  "version": "4.1.0",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -23,7 +23,7 @@
     "playwright-core": "^1.46.1",
     "socks-proxy-agent": "^8.0.4",
     "ws": "^8.18.3",
-    "@iflyrpa/share": "0.1.2"
+    "@iflyrpa/share": "0.2.0"
   },
   "devDependencies": {
     "@rslib/core": "^0.4.1",