polyv-live-api-sdk 1.0.9 → 1.0.10

package/dist/index.cjs

@@ -12436,6 +12436,44 @@ var V4ChannelService = class {
       throw new PolyVValidationError("channelId must be a string or number", "channelId");
     }
   }
+  // ============================================
+  // Channel Coupon Association
+  // ============================================
+  /**
+   * Add platform coupons to a channel
+   *
+   * Associates existing platform coupons with a specific channel.
+   * Invalid or already-added coupon IDs are silently ignored.
+   * If all coupon IDs are invalid, the request will fail.
+   *
+   * @param params - Parameters including channelId and couponIds
+   * @returns true if the operation was successful
+   * @throws PolyVValidationError if required parameters are missing
+   *
+   * @example
+   * ```typescript
+   * await v4Channel.addChannelCoupon({
+   *   channelId: '3151318',
+   *   couponIds: ['caqfi6rqutunvofor5jrqbinswh14p2g'],
+   * });
+   * ```
+   */
+  async addChannelCoupon(params) {
+    if (!params.channelId || String(params.channelId).trim() === "") {
+      throw PolyVValidationError.required("channelId");
+    }
+    if (!Array.isArray(params.couponIds) || params.couponIds.length === 0) {
+      throw new PolyVValidationError("couponIds must be a non-empty array", "couponIds");
+    }
+    if (params.couponIds.length > 30) {
+      throw new PolyVValidationError("couponIds must contain at most 30 items", "couponIds");
+    }
+    const response = await this.client.httpClient.post(
+      "/live/v4/channel/coupon/create",
+      params
+    );
+    return response;
+  }
   /**
    * Validate channel name
    */