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

package/dist/actions/shipinhaoPublishVideo/index.d.ts

@@ -0,0 +1,51 @@
+import type { CommonAction } from "@iflyrpa/share";
+import { z } from "zod";
+export declare const ShipinhaoPublishVideoParamsSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    userAgent: z.ZodOptional<z.ZodString>;
+    viewport: z.ZodNullable<z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>>;
+    url: z.ZodOptional<z.ZodString>;
+    cookies: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+        domain: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+        expires: z.ZodOptional<z.ZodNumber>;
+        httpOnly: z.ZodOptional<z.ZodBoolean>;
+        secure: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+    localStorage: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$catchall<z.ZodUnknown>>>>;
+    extraParam: z.ZodOptional<z.ZodAny>;
+    actionType: z.ZodOptional<z.ZodEnum<{
+        mockApi: "mockApi";
+        rpa: "rpa";
+        server: "server";
+    }>>;
+    accountId: z.ZodOptional<z.ZodNumber>;
+    proxyLoc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    localIP: z.ZodOptional<z.ZodString>;
+    huiwenToken: z.ZodOptional<z.ZodString>;
+    articleId: z.ZodOptional<z.ZodString>;
+    saveType: z.ZodOptional<z.ZodString>;
+    uid: z.ZodOptional<z.ZodString>;
+    videoPath: z.ZodString;
+    coverPath: z.ZodString;
+    description: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    scheduleTime: z.ZodOptional<z.ZodNumber>;
+    location: z.ZodOptional<z.ZodObject<{
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        city: z.ZodString;
+        poiClassifyId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ShipinhaoPublishVideoParams = z.infer<typeof ShipinhaoPublishVideoParamsSchema>;
+export type PublishVideoAction = CommonAction<ShipinhaoPublishVideoParams, string>;
+export declare const shipinhaoPublishVideo: PublishVideoAction;

package/dist/actions/shipinhaoPublishVideo/mock.d.ts

@@ -0,0 +1,4 @@
+import type { CommonAction } from "@iflyrpa/share";
+import type { ShipinhaoPublishVideoParams } from "./index";
+export type PublishVideoAction = CommonAction<ShipinhaoPublishVideoParams, string>;
+export declare const mockAction: PublishVideoAction;

package/dist/actions/shipinhaoPublishVideo/rpa.d.ts

@@ -0,0 +1,6 @@
+import type { PublishVideoAction } from "./mock";
+/**
+ * 视频号视频发布 - RPA 方式
+ * 通过浏览器自动化实现视频号视频发布
+ */
+export declare const rpaAction: PublishVideoAction;

package/dist/actions/shipinhaoPublishVideo/uploader.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 视频号 CDN 上传器（视频 20302 / 封面 20304）
+ *
+ * 三阶段：applyupload → uploadpart×N → completepart
+ * 分片大小 8MB，ETag 用本地 MD5 拼装（服务端 ETag == 分片 MD5 已实测确认）
+ * 支持秒传/续传：同 taskid 已传分片服务端保留，不必重传
+ *
+ * 数据来源：network-logs.json (8/20) + network-logs1.json (8/19)
+ */
+import type { Http } from "../../utils/http";
+export interface UploadOptions {
+    filePath: string;
+    /** filetype: 20302=视频, 20304=封面 */
+    fileType: number;
+    uin: number;
+    authKey: string;
+    http: Http;
+    logger?: {
+        info: (msg: string) => void;
+        error: (msg: string, ...args: any[]) => void;
+    };
+}
+export interface UploadResult {
+    /** completepart 返回的 DownloadURL */
+    downloadUrl: string;
+    /** 文件 MD5 */
+    md5: string;
+    fileSize: number;
+}
+/**
+ * 上传单个文件到视频号 CDN
+ *
+ * @param opts.filePath 本地文件路径
+ * @param opts.fileType 20302=视频 / 20304=封面
+ * @param opts.uin weixinnum
+ * @param opts.authKey Authorization 头
+ */
+export declare function uploadFile(opts: UploadOptions): Promise<UploadResult>;

package/dist/actions/shipinhaoPublishVideo/videoMeta.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 从 MP4 文件解析视频元数据（宽高、时长）
+ *
+ * 算法来源：scripts/api-explorer/shipinhao-video-upload/mp4-parse-poc.mjs
+ * 已通过合成样本 8/8 + 真实 Chrome 编码视频交叉验证（见该 PoC）。
+ *
+ * 只读 ISO BMFF box 头部做跳转，不解码帧数据，内存占用与文件大小无关。
+ * 支持 MP4（ISO base media file format），不支持 AVI/MKV/FLV。
+ *
+ * @param filePath 本地视频文件路径
+ * @returns {width, height, duration, rotation, fileSize} 或 null（解析失败）
+ */
+export interface VideoMeta {
+    width: number;
+    height: number;
+    /** 时长（秒，浮点数） */
+    duration: number;
+    /** 旋转角度（0/90/180/270），手机竖屏视频常为 90 */
+    rotation: number;
+    fileSize: number;
+    /**
+     * 视频轨编码格式（stsd 里的 sample entry fourcc，小写）
+     * H.264 为 avc1/avc3，H.265 为 hvc1/hev1，解析不到时为 null
+     */
+    codec: string | null;
+}
+export declare function parseVideoMeta(filePath: string): VideoMeta | null;

package/dist/actions/shipinhaoPublishVideo/videoValidator.d.ts

@@ -0,0 +1,35 @@
+import type { VideoMeta } from "./videoMeta";
+/**
+ * 视频号视频发布前的本地校验
+ *
+ * 平台限制：时长 8 小时内、大小不超过 20GB、格式为 MP4/H.264。
+ * 在上传前拦截，避免把超限文件传完才被服务端拒绝。
+ */
+/** 时长上限：8 小时 */
+export declare const MAX_DURATION_SECONDS: number;
+/** 大小上限：20GB */
+export declare const MAX_FILE_SIZE: number;
+/** 容器格式白名单 */
+export declare const ALLOWED_EXTENSIONS: readonly [".mp4"];
+/** 视频轨编码白名单（ISO BMFF sample entry fourcc）：H.264 */
+export declare const ALLOWED_CODECS: readonly ["avc1", "avc3"];
+/** 标题最少字符数 */
+export declare const MIN_TITLE_LENGTH = 6;
+/**
+ * 校验视频是否满足视频号限制
+ *
+ * @param filePath 视频文件路径（用于取扩展名和文件名做提示）
+ * @param meta parseVideoMeta 的解析结果
+ * @returns 不满足时返回中文错误提示，满足时返回 null
+ */
+export declare function validateShipinhaoVideo(filePath: string, meta: VideoMeta): string | null;
+/**
+ * 校验标题是否满足视频号限制
+ *
+ * 标题为可选参数：未传时不校验；传了就必须满足最少字符数。
+ * 按 Unicode 码点计数，避免 emoji 等字符被算成多个。
+ *
+ * @param title 标题，可为空
+ * @returns 不满足时返回中文错误提示，满足时返回 null
+ */
+export declare function validateShipinhaoTitle(title?: string): string | null;