@iflyrpa/actions 4.0.9 → 4.1.0-beta.0

package/dist/utils/errorMessages.d.ts

@@ -0,0 +1,41 @@
+import type { ResponseData } from "@iflyrpa/share";
+/**
+ * 用户可见的错误文案。
+ *
+ * 约定：凡是会进入 ResponseData.message（前端直接展示）的文案都从这里取，
+ * 不要把 err.message / error.code / 文件路径等技术细节拼进去 —— 那些信息
+ * 放 logger 与飞书告警里，用户侧只保留「看得懂 + 知道下一步做什么」的文案。
+ */
+export declare const USER_MESSAGE: {
+    readonly PROXY_UNAVAILABLE: "代理暂时不可用，请稍后重试或使用本地IP";
+    readonly NETWORK_ERROR: "网络异常，请稍后重试";
+    readonly SYSTEM_ERROR: "系统异常，请稍后重试或联系客服";
+    readonly PUBLISH_NETWORK: "发布失败，网络不稳定，请稍后重试";
+    readonly DOUYIN_ACCOUNT_FETCH_FAILED: "抖音数据获取失败，请稍后重试";
+    readonly SHIPINHAO_ACCOUNT_FETCH_FAILED: "视频号数据获取失败，请稍后重试";
+    readonly DOUYIN_POST_FETCH_FAILED: "抖音作品数据获取失败，请稍后重试";
+    readonly SHIPINHAO_POST_FETCH_FAILED: "视频号作品数据获取失败，请稍后重试";
+    readonly BJH_POST_FETCH_FAILED: "百家号作品数据获取失败，请稍后重试";
+    readonly TT_POST_FETCH_FAILED: "头条号作品数据获取失败，请稍后重试";
+    readonly QRCODE_FETCH_FAILED: "认证二维码获取失败，请稍后重试";
+    readonly IMAGE_UPLOAD_FAILED: "图片上传失败，请稍后重试或联系客服";
+};
+/** 发布错误分类：category 只用于日志辨识，userMessage 才是用户可见文案 */
+export interface PublishErrorClassification {
+    category: "代理错误" | "网络错误";
+    userMessage: string;
+}
+/**
+ * 对发布接口抛出的错误做分类，决定是「直接返回用户文案并终止」还是「交回 RPA 兜底」。
+ *
+ * 只拦代理/网络类错误 —— 这类错误重试耗尽后 RPA 兜底同样连不上，直接返回更快。
+ * 返回 null 表示交回调用方 `throw error`，由上层 executeAction 走 RPA 兜底。
+ *
+ * 刻意不拦风控（403/461/471）与参数（400/422）错误：executeAction（utils/index.ts:257）
+ * 只在 code 为 0 或 414 时终止，抛异常则继续执行下一个 action，
+ * 因此这两类错误抛出后能进 RPA 兜底 —— 走浏览器自动化，用户完成验证后仍有机会发布成功。
+ * 拦下来会掉掉这条补救路径，所以维持抛出。
+ *
+ * 注意 401 无需单列：http.ts 的响应拦截器已把 401 归一为 414（避免触发绘文平台鉴权逻辑）。
+ */
+export declare function classifyPublishError(handledError: ResponseData): PublishErrorClassification | null;

package/dist/utils/feishuAlarm.d.ts

@@ -0,0 +1,27 @@
+export type FeishuAlarmLevel = "warning" | "alarm";
+export type FeishuAlarmSource = "http" | "proxy";
+export interface FeishuAlarmReport {
+    /** alarm 会额外 @所有人，warning 只发消息 */
+    level: FeishuAlarmLevel;
+    /** 业务标识：xiaohongshu / douyin / weixin ... */
+    platform: string;
+    /** 告警来源模块 */
+    source: FeishuAlarmSource;
+    /** 出错阶段，如 "POST /api/sns/web/v1/feed" */
+    stage: string;
+    /** 错误类型，如 HTTP_403 / ECONNRESET / PROXY_UNAVAILABLE */
+    errorType: string;
+    /** 接口错误码 */
+    code?: string | number;
+    /** 错误信息 */
+    msg?: string;
+    /** 请求地址 */
+    url?: string;
+    /** 消息标题，默认「RPA异常」 */
+    title?: string;
+}
+/**
+ * 上报错误到飞书群，失败静默：告警链路不能影响主流程。
+ * 同一 platform + source + errorType + code 组合在 60s 内只发一条。
+ */
+export declare const reportFeishuAlarm: (report: FeishuAlarmReport) => void;

package/dist/utils/http.d.ts

@@ -14,5 +14,12 @@ export declare class Http {
         retries?: number;
         retryDelay?: number;
         timeout?: number;
+        onUploadProgress?: (progressEvent: any) => void;
+        /**
+         * 外部取消信号（用于用户主动取消上传等场景）。
+         * 注意：不能直接用 config.signal —— 下面会用内部 AbortController 覆盖它做超时兜底，
+         * 所以外部信号必须在这里传入，由内部 controller 代理转发。
+         */
+        signal?: AbortSignal;
     }): Promise<T>;
 }

package/dist/utils/imageValidator.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 图片验证选项
+ */
+export interface ImageValidationOptions {
+    /** 最大文件大小（字节），默认不限制 */
+    maxSize?: number;
+    /** 允许的文件扩展名（小写，包含点号），如 ['.jpg', '.png'] */
+    allowedFormats?: readonly string[];
+    /** 最小宽度（像素） */
+    minWidth?: number;
+    /** 最大宽度（像素） */
+    maxWidth?: number;
+    /** 最小高度（像素） */
+    minHeight?: number;
+    /** 最大高度（像素） */
+    maxHeight?: number;
+}
+/**
+ * 图片验证错误
+ */
+export declare class ImageValidationError extends Error {
+    code: number;
+    data: string;
+    constructor(message: string, code?: number, data?: string);
+}
+/**
+ * 验证图片文件
+ * @param filePath 图片文件路径
+ * @param options 验证选项
+ * @param platformName 平台名称，用于错误提示
+ * @throws {ImageValidationError} 当验证失败时抛出错误
+ */
+export declare function validateImageFile(filePath: string, options: ImageValidationOptions, platformName: string): void;
+/**
+ * 各平台图片限制预设配置
+ */
+export declare const PlatformImageLimits: {
+    /** 百家号：5MB，仅支持 jpg、png */
+    readonly baijiahao: {
+        readonly maxSize: number;
+        readonly allowedFormats: readonly [".jpg", ".jpeg", ".png"];
+    };
+    /** 视频号：20MB */
+    readonly shipinhao: {
+        readonly maxSize: number;
+    };
+    /** 头条号：20MB，推荐 jpg、png 格式 */
+    readonly toutiao: {
+        readonly maxSize: number;
+        readonly allowedFormats: readonly [".jpg", ".jpeg", ".png"];
+    };
+    /** 抖音：50MB */
+    readonly douyin: {
+        readonly maxSize: number;
+    };
+    /** 小红书：32MB，支持多种格式 */
+    readonly xiaohongshu: {
+        readonly maxSize: number;
+        readonly allowedFormats: readonly [".jpg", ".jpeg", ".png", ".gif"];
+    };
+};
+/**
+ * 使用预设配置验证图片
+ * @param filePath 图片文件路径
+ * @param platform 平台名称
+ */
+export declare function validateImageByPlatform(filePath: string, platform: keyof typeof PlatformImageLimits): void;

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

@@ -0,0 +1,31 @@
+import { Http } from "../http";
+/**
+ * 视频号上传认证信息
+ *
+ * 说明：本文件的两个接口调用逻辑从 actions/shipinhaoPublish/mock.ts 抽取而来，
+ * 该流程已在图文发布链路中实测可用，视频上传复用同一套认证。
+ */
+export interface ShipinhaoUploadAuth {
+    /** 微信号数字 uin，上传接口 X-Arguments 中的 weixinnum */
+    uin: number;
+    /** 上传接口 Authorization 头 */
+    authKey: string;
+    /** finderUsername，发布接口 _log_finder_id 使用 */
+    finderUsername: string;
+    /** 视频 filetype（服务端下发，实测 20302） */
+    videoFileType: number;
+    /** 图片/封面 filetype（服务端下发，实测 20304） */
+    pictureFileType: number;
+}
+/** 认证失败时抛出，携带平台错误码便于上层归类 */
+export declare class ShipinhaoAuthError extends Error {
+    readonly errCode: number;
+    constructor(message: string, errCode: number);
+}
+/**
+ * 获取视频号上传所需的认证信息
+ *
+ * @param cookies cookie 字符串（`name=value; name=value` 形式）
+ * @param http Http 实例（不走代理即可，认证接口对代理无要求）
+ */
+export declare function getShipinhaoUploadAuth(cookies: string, http: Http): Promise<ShipinhaoUploadAuth>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iflyrpa/actions",
-  "version": "4.0.9",
+  "version": "4.1.0-beta.0",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",