@iflyrpa/actions 4.0.9-beta.4 → 4.1.0-beta.6

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-beta.4",
+  "version": "4.1.0-beta.6",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",