polyv-live-api-sdk 1.0.17 → 1.0.19

package/dist/index.d.cts

@@ -1422,18 +1422,54 @@ interface ClipRecordFileResponse {
     fileId: string;
 }
 /**
- * Record Convert Request
+ * Record Convert Request (synchronous)
+ *
+ * Backed by `POST /live/v2/channel/recordFile/{channelId}/convert`. Either
+ * `sessionId` or `fileUrl` must be provided; when only `sessionId` is given the
+ * backend converts that session's recording to VOD.
  */
 interface RecordConvertRequest {
-    fileId: string;
+    /** Account user ID (required, included in signature) */
+    userId: string;
+    /** Converted VOD video name (required) */
+    fileName: string;
+    /** Live session ID (one of sessionId/fileUrl is required) */
+    sessionId?: string;
+    /** Recording file URL (one of sessionId/fileUrl is required) */
+    fileUrl?: string;
+    /** Catalog ID */
+    cataid?: string;
+    /** Catalog name */
+    cataname?: string;
+    /** Add to playback list (Y/N) */
+    toPlayList?: 'Y' | 'N';
+    /** Set as default playback video (Y/N) */
+    setAsDefault?: 'Y' | 'N';
+}
+/**
+ * Record Convert Async Request
+ *
+ * Backed by `POST /live/v3/channel/record/convert`. Requires `fileIds`
+ * (comma-separated), obtained from the "查询频道录制视频信息" endpoint.
+ */
+interface RecordConvertAsyncRequest {
+    /** Recording file IDs, comma-separated (required) */
+    fileIds: string;
+    /** Converted file name */
     fileName?: string;
+    /** VOD catalog ID */
+    cataId?: string;
+    /** Callback URL invoked on completion */
     callbackUrl?: string;
+    /** Whether to return success when the VOD already exists (1=yes, 0=no) */
+    canRepeat?: number;
 }
 /**
  * Record Convert Response
  */
 interface RecordConvertResponse {
-    fileId: string;
+    /** Converted VOD video ID (vid) */
+    vid: string;
 }
 /**
  * Record Merge Request (for array input)
@@ -3855,7 +3891,8 @@ interface UpdateCategoryNameResponse {
 }
 interface UpdateCategoryRankParams {
     categoryId: number;
-    rank: number;
+    /** Move the category to AFTER this category ID (PolyV update-rank contract). */
+    afterCategoryId: number;
 }
 interface UpdateCategoryRankResponse {
     success: boolean;
@@ -9730,7 +9767,7 @@ interface DeleteLabelParams {
  * Parameters for adding channel label refs
  */
 interface AddChannelLabelRefsParams {
-    /** Label IDs */
+    /** Account label IDs from listLabels */
     labelIds: string[];
     /** Channel IDs */
     channelIds: Array<string | number>;
@@ -13955,6 +13992,8 @@ declare class ChannelService {
     private validateChannelViewerScope;
     private buildLiveBgConfig;
     private validateRequiredValue;
+    private buildSignedFormBody;
+    private buildSignedFormConfig;
     private validateRequiredText;
     private validateOptionalText;
     private validateOptionalYn;
@@ -14941,7 +14980,9 @@ declare class ChannelService {
      * @example
      * ```typescript
      * const result = await channelService.recordConvert('ch123456', {
-     *   fileId: 'file123',
+     *   userId: 'user123',
+     *   fileName: 'my-vod',
+     *   sessionId: 'fvlyin8qz3',
      * });
      * ```
      */
@@ -14949,21 +14990,21 @@ declare class ChannelService {
     /**
      * Record convert async
      *
-     * Converts a recording file to VOD asynchronously.
+     * Converts recording files to VOD asynchronously.
      *
      * @param channelId - The channel ID
-     * @param options - Convert options
+     * @param options - Convert options (requires comma-separated fileIds)
      * @returns true if submitted successfully
      * @throws PolyVValidationError if required parameters are empty
      *
      * @example
      * ```typescript
      * const result = await channelService.recordConvertAsync('ch123456', {
-     *   fileId: 'file123',
+     *   fileIds: 'file1,file2',
      * });
      * ```
      */
-    recordConvertAsync(channelId: string, options: RecordConvertRequest): Promise<boolean>;
+    recordConvertAsync(channelId: string, options: RecordConvertAsyncRequest): Promise<boolean>;
     /**
      * Record file merge (synchronous)
      *
@@ -17446,10 +17487,10 @@ declare class AccountService {
      *
      * @example
      * ```typescript
-     * const result = await client.account.updateCategoryRank({
-     *   categoryId: 12345,
-     *   rank: 1,
-     * });
+   * const result = await client.account.updateCategoryRank({
+   *   categoryId: 12345,
+   *   afterCategoryId: 67890,
+   * });
      * console.log(result.success);
      * ```
      */
@@ -22384,14 +22425,14 @@ declare class V4UserService {
      */
     deleteLabel(params: DeleteLabelParams): Promise<void>;
     /**
-     * Add channel label refs
+     * Add account label refs to channels
      *
      * @param params - Add parameters
      *
      * @example
      * ```typescript
      * await client.v4User.addChannelLabelRefs({
-     *   labelIds: ['label_001'],
+     *   labelIds: ['zylw8zzi3p7mrqr4'],
      *   channelIds: ['123456', '789012'],
      * });
      * ```

package/dist/index.js

@@ -576,6 +576,32 @@ var ChannelService = class {
       throw PolyVValidationError.required(field);
     }
   }
+  buildSignedFormBody(params) {
+    const timestamp = Date.now();
+    const signatureParams = {
+      appId: this.client.config.appId,
+      timestamp,
+      ...params
+    };
+    const { sign } = generateSignature(signatureParams, {
+      appSecret: this.client.config.appSecret
+    });
+    const form = new URLSearchParams();
+    for (const [key, value] of Object.entries({ ...signatureParams, sign })) {
+      if (value !== void 0 && value !== null) {
+        form.append(key, String(value));
+      }
+    }
+    return form;
+  }
+  buildSignedFormConfig() {
+    return {
+      headers: {
+        "Content-Type": "application/x-www-form-urlencoded",
+        "X-Skip-Auth": "true"
+      }
+    };
+  }
   validateRequiredText(value, field, maxLength) {
     if (!value || value.trim() === "") {
       throw PolyVValidationError.required(field);
@@ -2073,8 +2099,8 @@ var ChannelService = class {
     }
     const response = await this.client.httpClient.post(
       `/live/v2/channel/recordFile/${params.channelId}/convert`,
-      null,
-      { params: query }
+      this.buildSignedFormBody(query),
+      this.buildSignedFormConfig()
     );
     return response;
   }
@@ -2713,7 +2739,9 @@ var ChannelService = class {
    * @example
    * ```typescript
    * const result = await channelService.recordConvert('ch123456', {
-   *   fileId: 'file123',
+   *   userId: 'user123',
+   *   fileName: 'my-vod',
+   *   sessionId: 'fvlyin8qz3',
    * });
    * ```
    */
@@ -2721,37 +2749,62 @@ var ChannelService = class {
     if (!channelId || channelId.trim() === "") {
       throw PolyVValidationError.required("channelId");
     }
-    if (!options.fileId || options.fileId.trim() === "") {
-      throw PolyVValidationError.required("fileId");
+    if (!options.userId || options.userId.trim() === "") {
+      throw PolyVValidationError.required("userId");
     }
-    const params = { channelId, fileId: options.fileId };
-    if (options.fileName !== void 0) {
-      params.fileName = options.fileName;
+    if (!options.fileName || options.fileName.trim() === "") {
+      throw PolyVValidationError.required("fileName");
     }
-    if (options.callbackUrl !== void 0) {
-      params.callbackUrl = options.callbackUrl;
+    const hasSessionId = options.sessionId && options.sessionId.trim() !== "";
+    const hasFileUrl = options.fileUrl && options.fileUrl.trim() !== "";
+    if (!hasSessionId && !hasFileUrl) {
+      throw PolyVValidationError.required("sessionId or fileUrl");
+    }
+    const params = {
+      userId: options.userId,
+      fileName: options.fileName
+    };
+    if (options.sessionId) {
+      params.sessionId = options.sessionId;
+    }
+    if (options.fileUrl) {
+      params.fileUrl = options.fileUrl;
+    }
+    if (options.cataid !== void 0) {
+      params.cataid = options.cataid;
+    }
+    if (options.cataname !== void 0) {
+      params.cataname = options.cataname;
+    }
+    if (options.toPlayList !== void 0) {
+      params.toPlayList = options.toPlayList;
+    }
+    if (options.setAsDefault !== void 0) {
+      params.setAsDefault = options.setAsDefault;
     }
     const response = await this.client.httpClient.post(
-      "/live/v3/channel/record/convert",
-      null,
-      { params }
+      `/live/v2/channel/recordFile/${channelId}/convert`,
+      this.buildSignedFormBody(params),
+      this.buildSignedFormConfig()
     );
-    return response;
+    const obj = typeof response === "object" && response !== null ? response : void 0;
+    const vid = typeof response === "string" ? response : String(obj?.["vid"] ?? obj?.["fileId"] ?? "");
+    return { vid };
   }
   /**
    * Record convert async
    *
-   * Converts a recording file to VOD asynchronously.
+   * Converts recording files to VOD asynchronously.
    *
    * @param channelId - The channel ID
-   * @param options - Convert options
+   * @param options - Convert options (requires comma-separated fileIds)
    * @returns true if submitted successfully
    * @throws PolyVValidationError if required parameters are empty
    *
    * @example
    * ```typescript
    * const result = await channelService.recordConvertAsync('ch123456', {
-   *   fileId: 'file123',
+   *   fileIds: 'file1,file2',
    * });
    * ```
    */
@@ -2759,20 +2812,24 @@ var ChannelService = class {
     if (!channelId || channelId.trim() === "") {
       throw PolyVValidationError.required("channelId");
     }
-    if (!options.fileId || options.fileId.trim() === "") {
-      throw PolyVValidationError.required("fileId");
+    if (!options.fileIds || options.fileIds.trim() === "") {
+      throw PolyVValidationError.required("fileIds");
     }
-    const params = { channelId, fileId: options.fileId };
+    const params = { channelId, fileIds: options.fileIds };
     if (options.fileName !== void 0) {
       params.fileName = options.fileName;
     }
+    if (options.cataId !== void 0) {
+      params.cataId = options.cataId;
+    }
     if (options.callbackUrl !== void 0) {
       params.callbackUrl = options.callbackUrl;
     }
+    params.canRepeat = options.canRepeat ?? 1;
     await this.client.httpClient.post(
-      "/live/v3/channel/record/convert-async",
-      null,
-      { params }
+      "/live/v3/channel/record/convert",
+      this.buildSignedFormBody(params),
+      this.buildSignedFormConfig()
     );
     return true;
   }
@@ -7586,26 +7643,26 @@ var AccountService = class {
     return { success: response };
   }
   /**
-   * Update category rank (sort order)
-   *
-   * @param params - Update parameters
-   * @returns Update result
-   *
-   * @example
-   * ```typescript
-   * const result = await client.account.updateCategoryRank({
-   *   categoryId: 12345,
-   *   rank: 1,
-   * });
-   * console.log(result.success);
-   * ```
-   */
+    * Update category rank (sort order)
+    *
+    * @param params - Update parameters
+    * @returns Update result
+    *
+    * @example
+    * ```typescript
+  * const result = await client.account.updateCategoryRank({
+  *   categoryId: 12345,
+  *   afterCategoryId: 67890,
+  * });
+    * console.log(result.success);
+    * ```
+    */
   async updateCategoryRank(params) {
     if (!params.categoryId || params.categoryId <= 0) {
       throw new PolyVValidationError("categoryId must be a positive number");
     }
-    if (params.rank === void 0 || params.rank === null) {
-      throw new PolyVValidationError("rank is required");
+    if (params.afterCategoryId === void 0 || params.afterCategoryId === null) {
+      throw new PolyVValidationError("afterCategoryId is required");
     }
     const response = await this.client.httpClient.post(
       "/live/v3/user/category/update-rank",
@@ -10848,31 +10905,32 @@ var PlayerService = class {
     if (params.autoZoomEnabled !== void 0) {
       this.validateYNValue(params.autoZoomEnabled, "autoZoomEnabled");
     }
-    const body = {
+    const requestParams = {
+      channelId,
       antiRecordType: params.antiRecordType,
       modelType: params.modelType,
       content: params.content,
       fontSize: params.fontSize
     };
     if (params.opacity !== void 0) {
-      body.opacity = params.opacity;
+      requestParams.opacity = params.opacity;
     }
     if (params.fontColor !== void 0) {
-      body.fontColor = params.fontColor;
+      requestParams.fontColor = params.fontColor;
     }
     if (params.showMode !== void 0) {
-      body.showMode = params.showMode;
+      requestParams.showMode = params.showMode;
     }
     if (params.doubleEnabled !== void 0) {
-      body.doubleEnabled = params.doubleEnabled;
+      requestParams.doubleEnabled = params.doubleEnabled;
     }
     if (params.autoZoomEnabled !== void 0) {
-      body.autoZoomEnabled = params.autoZoomEnabled;
+      requestParams.autoZoomEnabled = params.autoZoomEnabled;
     }
     const response = await this.client.httpClient.post(
       "/live/v3/channel/anti/record/setting",
-      body,
-      { params: { channelId } }
+      null,
+      { params: requestParams }
     );
     return response;
   }
@@ -11893,7 +11951,7 @@ var V4AiService = class {
     }
     await this.client.httpClient.post(
       "/live/v4/ai/digital-human/set-organizations",
-      params
+      { setOrganizations: params.items }
     );
   }
   // ============================================
@@ -13936,7 +13994,8 @@ var V4ChannelService = class {
     this.validateChannelId(params.channelId);
     await this.client.httpClient.post(
       "/live/v4/channel/role-config/update-by-role",
-      params
+      params.config,
+      { params: { channelId: params.channelId, role: params.role } }
     );
   }
   /**
@@ -16698,14 +16757,14 @@ var V4UserService = class {
     );
   }
   /**
-   * Add channel label refs
+   * Add account label refs to channels
    *
    * @param params - Add parameters
    *
    * @example
    * ```typescript
    * await client.v4User.addChannelLabelRefs({
-   *   labelIds: ['label_001'],
+   *   labelIds: ['zylw8zzi3p7mrqr4'],
    *   channelIds: ['123456', '789012'],
    * });
    * ```
@@ -19115,31 +19174,37 @@ var StatisticsService = class {
       "/live/v3/channel/session/stats/export",
       { params }
     );
-    if (response && typeof response === "object" && "data" in response) {
-      const responseData = response;
-      if (responseData.data && typeof responseData.data === "object") {
-        const innerData = responseData.data;
-        if (innerData.code && innerData.code !== 200) {
-          throw new Error(innerData.message || "API Error");
-        }
-        if ("downloadUrl" in innerData) {
-          return innerData;
-        }
-        if (typeof innerData.data === "string" && innerData.data) {
-          return { downloadUrl: innerData.data };
-        }
+    if (typeof response === "string") {
+      if (response.trim() === "") {
+        throw new Error("\u573A\u6B21\u62A5\u8868\u5BFC\u51FA\u5931\u8D25\uFF1A\u62A5\u8868\u5C1A\u672A\u751F\u6210\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5");
       }
+      return { downloadUrl: response };
     }
-    if (response && typeof response === "object" && "code" in response) {
-      const apiResponse = response;
-      if (apiResponse.code && apiResponse.code !== 200) {
-        throw new Error(String(apiResponse.message || "API Error"));
+    if (response && typeof response === "object") {
+      const obj = response;
+      if (typeof obj["downloadUrl"] === "string" && obj["downloadUrl"]) {
+        return { downloadUrl: obj["downloadUrl"] };
+      }
+      if (obj["code"] !== void 0 && obj["code"] !== 200) {
+        throw new Error(String(obj["message"] || "\u573A\u6B21\u62A5\u8868\u5BFC\u51FA\u5931\u8D25"));
       }
-      if (typeof apiResponse.data === "string" && apiResponse.data) {
-        return { downloadUrl: apiResponse.data };
+      if (typeof obj["data"] === "string" && obj["data"]) {
+        return { downloadUrl: obj["data"] };
+      }
+      const inner = obj["data"];
+      if (inner && typeof inner === "object") {
+        if (inner["code"] !== void 0 && inner["code"] !== 200) {
+          throw new Error(String(inner["message"] || "\u573A\u6B21\u62A5\u8868\u5BFC\u51FA\u5931\u8D25"));
+        }
+        if (typeof inner["downloadUrl"] === "string" && inner["downloadUrl"]) {
+          return { downloadUrl: inner["downloadUrl"] };
+        }
+        if (typeof inner["data"] === "string" && inner["data"]) {
+          return { downloadUrl: inner["data"] };
+        }
       }
     }
-    return response;
+    throw new Error("\u573A\u6B21\u62A5\u8868\u5BFC\u51FA\u5931\u8D25\uFF1A\u63A5\u53E3\u672A\u8FD4\u56DE\u4E0B\u8F7D\u94FE\u63A5\uFF0C\u62A5\u8868\u53EF\u80FD\u5C1A\u672A\u751F\u6210\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5");
   }
   /**
    * Validate parameters for exportSessionStats