@congminh1254/shopee-sdk 0.9.0 → 1.0.0

package/lib/managers/media-space.manager.d.ts

@@ -0,0 +1,179 @@
+import { ShopeeConfig } from "../sdk.js";
+import { UploadImageParams, UploadImageResponse, InitVideoUploadParams, InitVideoUploadResponse, UploadVideoPartParams, UploadVideoPartResponse, CompleteVideoUploadParams, CompleteVideoUploadResponse, CancelVideoUploadParams, CancelVideoUploadResponse, GetVideoUploadResultParams, GetVideoUploadResultResponse } from "../schemas/media-space.js";
+import { BaseManager } from "./base.manager.js";
+/**
+ * MediaSpaceManager handles media file uploads (images and videos) to Shopee's media space.
+ *
+ * This manager provides functionality for:
+ * - Uploading images with different scenes and aspect ratios
+ * - Multi-part video upload with session management
+ * - Video transcoding status tracking
+ * - Video upload cancellation
+ */
+export declare class MediaSpaceManager extends BaseManager {
+    constructor(config: ShopeeConfig);
+    /**
+     * Upload multiple image files to MediaSpace (less than 9 images).
+     *
+     * @param params - Parameters for image upload
+     * @param params.scene - The scene where the picture is used ('normal' for item images, 'desc' for descriptions)
+     * @param params.ratio - Image aspect ratio ('1:1' or '3:4', only for whitelisted sellers)
+     * @param params.image - Image files (Max 10.0 MB each, formats: JPG, JPEG, PNG)
+     * @returns Promise with uploaded image information including image IDs and URLs
+     *
+     * @remarks
+     * This API requires multipart/form-data content type.
+     * - normal scene: Images will be processed as square images (recommended for item images)
+     * - desc scene: Images will not be processed (recommended for extend_description)
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - error_tier_img_partial: Internal error, please contact openapi team
+     * - error_tier_img_old_app: Internal error, please contact openapi team
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.mediaSpace.uploadImage({
+     *   scene: 'normal',
+     *   ratio: '1:1',
+     *   image: imageFile
+     * });
+     * console.log('Uploaded image ID:', result.response.image_info_list[0].image_info.image_id);
+     * ```
+     */
+    uploadImage(params: UploadImageParams): Promise<UploadImageResponse>;
+    /**
+     * Initiate video upload session.
+     *
+     * @param params - Parameters for initializing video upload
+     * @param params.file_md5 - MD5 hash of the video file
+     * @param params.file_size - Size of video file in bytes (maximum 30MB)
+     * @returns Promise with video_upload_id for subsequent upload operations
+     *
+     * @remarks
+     * Video duration should be between 10s and 60s (inclusive).
+     * Use the returned video_upload_id for uploading video parts and completing the upload.
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - error_file_size: File size is too large. Video size should be less than 30M
+     * - error_param: Invalid parameter
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.mediaSpace.initVideoUpload({
+     *   file_md5: '2abf0b6e5ff90ff24437a0808f171a93',
+     *   file_size: 1261876
+     * });
+     * const uploadId = result.response.video_upload_id;
+     * ```
+     */
+    initVideoUpload(params: InitVideoUploadParams): Promise<InitVideoUploadResponse>;
+    /**
+     * Upload video file by part using the upload_id from initVideoUpload.
+     *
+     * @param params - Parameters for uploading video part
+     * @param params.video_upload_id - The video_upload_id from init_video_upload response
+     * @param params.part_seq - Sequence of the current part, starts from 0
+     * @param params.content_md5 - MD5 hash of this part
+     * @param params.part_content - The content of this part of file
+     * @returns Promise indicating success or failure of the part upload
+     *
+     * @remarks
+     * The request Content-Type should be multipart/form-data.
+     * Part size should be exactly 4MB, except for the last part of file.
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - error_invalid_upload_id: Invalid upload_id
+     * - error_invalid_part_seq: Invalid part_seq
+     * - error_invalid_part_size: Invalid part_size
+     *
+     * @example
+     * ```typescript
+     * await sdk.mediaSpace.uploadVideoPart({
+     *   video_upload_id: 'sg_90ce045e-fd92-4f0b-97a4-eda40546cd9f_000000',
+     *   part_seq: 0,
+     *   content_md5: '3bb08579fffbfc13ed9d23cda8bbb46d',
+     *   part_content: videoPart
+     * });
+     * ```
+     */
+    uploadVideoPart(params: UploadVideoPartParams): Promise<UploadVideoPartResponse>;
+    /**
+     * Complete the video upload and start the transcoding process when all parts are uploaded successfully.
+     *
+     * @param params - Parameters for completing video upload
+     * @param params.video_upload_id - The ID of this upload session from init_video_upload
+     * @param params.part_seq_list - All uploaded sequence numbers
+     * @param params.report_data - Upload performance tracking data
+     * @returns Promise indicating completion status
+     *
+     * @remarks
+     * Call this API after all video parts have been successfully uploaded.
+     * The video will be transcoded and ready for use in item operations once transcoding completes.
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - error_invalid_upload_id: Invalid upload_id
+     * - error_already_completed: Upload already completed
+     *
+     * @example
+     * ```typescript
+     * await sdk.mediaSpace.completeVideoUpload({
+     *   video_upload_id: 'sg_90ce045e-fd92-4f0b-97a4-eda40546cd9f_000000',
+     *   part_seq_list: [0, 1, 2, 3],
+     *   report_data: { upload_cost: 11832 }
+     * });
+     * ```
+     */
+    completeVideoUpload(params: CompleteVideoUploadParams): Promise<CompleteVideoUploadResponse>;
+    /**
+     * Query the upload status and result of video upload.
+     *
+     * @param params - Parameters for getting video upload result
+     * @param params.video_upload_id - The video_upload_id from init_video_upload response
+     * @returns Promise with upload status and video information (if transcoding is complete)
+     *
+     * @remarks
+     * Possible status values:
+     * - INITIATED: Waiting for part uploading and/or complete_video_upload call
+     * - TRANSCODING: Transcoding the video file
+     * - SUCCEEDED: Transcoding completed, ready for use
+     * - FAILED: Upload failed, check message field for details
+     * - CANCELLED: Upload was cancelled
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - error_invalid_upload_id: Invalid upload_id
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.mediaSpace.getVideoUploadResult({
+     *   video_upload_id: 'sg_90ce045e-fd92-4f0b-97a4-eda40546cd9f_000000'
+     * });
+     * if (result.response.status === 'SUCCEEDED') {
+     *   console.log('Video URL:', result.response.video_info.video_url_list[0].video_url);
+     * }
+     * ```
+     */
+    getVideoUploadResult(params: GetVideoUploadResultParams): Promise<GetVideoUploadResultResponse>;
+    /**
+     * Cancel a video upload session.
+     *
+     * @param params - Parameters for canceling video upload
+     * @param params.video_upload_id - The ID of this upload session from init_video_upload
+     * @returns Promise indicating cancellation status
+     *
+     * @remarks
+     * Use this API to cancel an ongoing video upload session if needed.
+     * After cancellation, the video_upload_id cannot be used for further operations.
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - error_invalid_upload_id: Invalid upload_id
+     * - error_already_completed: Upload already completed
+     *
+     * @example
+     * ```typescript
+     * await sdk.mediaSpace.cancelVideoUpload({
+     *   video_upload_id: 'sg_90ce045e-fd92-4f0b-97a4-eda40546cd9f_000000'
+     * });
+     * ```
+     */
+    cancelVideoUpload(params: CancelVideoUploadParams): Promise<CancelVideoUploadResponse>;
+}

package/lib/managers/media-space.manager.js

@@ -0,0 +1,220 @@
+import { ShopeeFetch } from "../fetch.js";
+import { BaseManager } from "./base.manager.js";
+/**
+ * MediaSpaceManager handles media file uploads (images and videos) to Shopee's media space.
+ *
+ * This manager provides functionality for:
+ * - Uploading images with different scenes and aspect ratios
+ * - Multi-part video upload with session management
+ * - Video transcoding status tracking
+ * - Video upload cancellation
+ */
+export class MediaSpaceManager extends BaseManager {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Upload multiple image files to MediaSpace (less than 9 images).
+     *
+     * @param params - Parameters for image upload
+     * @param params.scene - The scene where the picture is used ('normal' for item images, 'desc' for descriptions)
+     * @param params.ratio - Image aspect ratio ('1:1' or '3:4', only for whitelisted sellers)
+     * @param params.image - Image files (Max 10.0 MB each, formats: JPG, JPEG, PNG)
+     * @returns Promise with uploaded image information including image IDs and URLs
+     *
+     * @remarks
+     * This API requires multipart/form-data content type.
+     * - normal scene: Images will be processed as square images (recommended for item images)
+     * - desc scene: Images will not be processed (recommended for extend_description)
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - error_tier_img_partial: Internal error, please contact openapi team
+     * - error_tier_img_old_app: Internal error, please contact openapi team
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.mediaSpace.uploadImage({
+     *   scene: 'normal',
+     *   ratio: '1:1',
+     *   image: imageFile
+     * });
+     * console.log('Uploaded image ID:', result.response.image_info_list[0].image_info.image_id);
+     * ```
+     */
+    async uploadImage(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/media_space/upload_image", {
+            method: "POST",
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Initiate video upload session.
+     *
+     * @param params - Parameters for initializing video upload
+     * @param params.file_md5 - MD5 hash of the video file
+     * @param params.file_size - Size of video file in bytes (maximum 30MB)
+     * @returns Promise with video_upload_id for subsequent upload operations
+     *
+     * @remarks
+     * Video duration should be between 10s and 60s (inclusive).
+     * Use the returned video_upload_id for uploading video parts and completing the upload.
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - error_file_size: File size is too large. Video size should be less than 30M
+     * - error_param: Invalid parameter
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.mediaSpace.initVideoUpload({
+     *   file_md5: '2abf0b6e5ff90ff24437a0808f171a93',
+     *   file_size: 1261876
+     * });
+     * const uploadId = result.response.video_upload_id;
+     * ```
+     */
+    async initVideoUpload(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/media_space/init_video_upload", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Upload video file by part using the upload_id from initVideoUpload.
+     *
+     * @param params - Parameters for uploading video part
+     * @param params.video_upload_id - The video_upload_id from init_video_upload response
+     * @param params.part_seq - Sequence of the current part, starts from 0
+     * @param params.content_md5 - MD5 hash of this part
+     * @param params.part_content - The content of this part of file
+     * @returns Promise indicating success or failure of the part upload
+     *
+     * @remarks
+     * The request Content-Type should be multipart/form-data.
+     * Part size should be exactly 4MB, except for the last part of file.
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - error_invalid_upload_id: Invalid upload_id
+     * - error_invalid_part_seq: Invalid part_seq
+     * - error_invalid_part_size: Invalid part_size
+     *
+     * @example
+     * ```typescript
+     * await sdk.mediaSpace.uploadVideoPart({
+     *   video_upload_id: 'sg_90ce045e-fd92-4f0b-97a4-eda40546cd9f_000000',
+     *   part_seq: 0,
+     *   content_md5: '3bb08579fffbfc13ed9d23cda8bbb46d',
+     *   part_content: videoPart
+     * });
+     * ```
+     */
+    async uploadVideoPart(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/media_space/upload_video_part", {
+            method: "POST",
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Complete the video upload and start the transcoding process when all parts are uploaded successfully.
+     *
+     * @param params - Parameters for completing video upload
+     * @param params.video_upload_id - The ID of this upload session from init_video_upload
+     * @param params.part_seq_list - All uploaded sequence numbers
+     * @param params.report_data - Upload performance tracking data
+     * @returns Promise indicating completion status
+     *
+     * @remarks
+     * Call this API after all video parts have been successfully uploaded.
+     * The video will be transcoded and ready for use in item operations once transcoding completes.
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - error_invalid_upload_id: Invalid upload_id
+     * - error_already_completed: Upload already completed
+     *
+     * @example
+     * ```typescript
+     * await sdk.mediaSpace.completeVideoUpload({
+     *   video_upload_id: 'sg_90ce045e-fd92-4f0b-97a4-eda40546cd9f_000000',
+     *   part_seq_list: [0, 1, 2, 3],
+     *   report_data: { upload_cost: 11832 }
+     * });
+     * ```
+     */
+    async completeVideoUpload(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/media_space/complete_video_upload", {
+            method: "POST",
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Query the upload status and result of video upload.
+     *
+     * @param params - Parameters for getting video upload result
+     * @param params.video_upload_id - The video_upload_id from init_video_upload response
+     * @returns Promise with upload status and video information (if transcoding is complete)
+     *
+     * @remarks
+     * Possible status values:
+     * - INITIATED: Waiting for part uploading and/or complete_video_upload call
+     * - TRANSCODING: Transcoding the video file
+     * - SUCCEEDED: Transcoding completed, ready for use
+     * - FAILED: Upload failed, check message field for details
+     * - CANCELLED: Upload was cancelled
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - error_invalid_upload_id: Invalid upload_id
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.mediaSpace.getVideoUploadResult({
+     *   video_upload_id: 'sg_90ce045e-fd92-4f0b-97a4-eda40546cd9f_000000'
+     * });
+     * if (result.response.status === 'SUCCEEDED') {
+     *   console.log('Video URL:', result.response.video_info.video_url_list[0].video_url);
+     * }
+     * ```
+     */
+    async getVideoUploadResult(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/media_space/get_video_upload_result", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Cancel a video upload session.
+     *
+     * @param params - Parameters for canceling video upload
+     * @param params.video_upload_id - The ID of this upload session from init_video_upload
+     * @returns Promise indicating cancellation status
+     *
+     * @remarks
+     * Use this API to cancel an ongoing video upload session if needed.
+     * After cancellation, the video_upload_id cannot be used for further operations.
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - error_invalid_upload_id: Invalid upload_id
+     * - error_already_completed: Upload already completed
+     *
+     * @example
+     * ```typescript
+     * await sdk.mediaSpace.cancelVideoUpload({
+     *   video_upload_id: 'sg_90ce045e-fd92-4f0b-97a4-eda40546cd9f_000000'
+     * });
+     * ```
+     */
+    async cancelVideoUpload(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/media_space/cancel_video_upload", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+}
+//# sourceMappingURL=media-space.manager.js.map

package/lib/managers/media-space.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-space.manager.js","sourceRoot":"","sources":["../../src/managers/media-space.manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAe1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAChD,YAAY,MAAoB;QAC9B,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,WAAW,CAAC,MAAyB;QACzC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,2BAA2B,EAC3B;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,MAAM;SACb,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,KAAK,CAAC,eAAe,CAAC,MAA6B;QACjD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,gCAAgC,EAChC;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM;SACb,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,KAAK,CAAC,eAAe,CAAC,MAA6B;QACjD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,gCAAgC,EAChC;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,MAAM;SACb,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK,CAAC,mBAAmB,CACvB,MAAiC;QAEjC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,oCAAoC,EACpC;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,MAAM;SACb,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,oBAAoB,CACxB,MAAkC;QAElC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,sCAAsC,EACtC;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI;YACV,MAAM;SACP,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,iBAAiB,CAAC,MAA+B;QACrD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,kCAAkC,EAClC;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM;SACb,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/lib/managers/media.manager.d.ts

@@ -0,0 +1,226 @@
+import { ShopeeConfig } from "../sdk.js";
+import { BaseManager } from "./base.manager.js";
+import { UploadMediaImageParams, UploadMediaImageResponse, UploadImageParams, UploadImageResponse, InitVideoUploadParams, InitVideoUploadResponse, UploadVideoPartParams, UploadVideoPartResponse, CompleteVideoUploadParams, CompleteVideoUploadResponse, GetVideoUploadResultParams, GetVideoUploadResultResponse, CancelVideoUploadParams, CancelVideoUploadResponse } from "../schemas/media.js";
+/**
+ * MediaManager handles media upload operations for the Shopee API
+ *
+ * Provides methods for:
+ * - Image upload for various business scenarios
+ * - Video upload with multi-part upload support
+ * - Video upload status tracking
+ */
+export declare class MediaManager extends BaseManager {
+    constructor(config: ShopeeConfig);
+    /**
+     * Upload images for specific business scenarios (e.g., returns)
+     *
+     * @param {UploadMediaImageParams} params - Parameters for uploading images
+     * @param {number} params.business - Business type (2 = Returns)
+     * @param {number} params.scene - Scene type (1 = Return Seller Self Arrange Pickup Proof)
+     * @param {string | Buffer | Array<string | Buffer>} params.images - Image files to upload
+     * @returns {Promise<UploadMediaImageResponse>} Response containing uploaded image information
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.media.uploadMediaImage({
+     *   business: 2,
+     *   scene: 1,
+     *   images: '/path/to/image.jpg'
+     * });
+     * console.log('Uploaded images:', result.response.image_list);
+     * ```
+     *
+     * **Restrictions:**
+     * - business = 2, scene = 1: Up to 3 images, max 10MB each, formats: JPG, JPEG, PNG
+     *
+     * @throws {Error} When the API request fails
+     */
+    uploadMediaImage(params: UploadMediaImageParams): Promise<UploadMediaImageResponse>;
+    /**
+     * Upload multiple image files for general use
+     *
+     * @param {UploadImageParams} params - Parameters for uploading images
+     * @param {string | Buffer | Array<string | Buffer>} params.image - Image files (up to 9 images)
+     * @param {string} [params.scene] - Scene type ("normal" or "desc")
+     * @param {string} [params.ratio] - Image ratio ("1:1" or "3:4", whitelisted sellers only)
+     * @returns {Promise<UploadImageResponse>} Response containing uploaded image information
+     *
+     * @example
+     * ```typescript
+     * // Upload product images (square processing)
+     * const result = await sdk.media.uploadImage({
+     *   image: ['/path/to/image1.jpg', '/path/to/image2.jpg'],
+     *   scene: 'normal',
+     *   ratio: '1:1'
+     * });
+     *
+     * // Upload description images (no processing)
+     * const descResult = await sdk.media.uploadImage({
+     *   image: '/path/to/desc-image.jpg',
+     *   scene: 'desc'
+     * });
+     * ```
+     *
+     * **Image Requirements:**
+     * - Maximum: 9 images per request
+     * - Maximum size: 10MB per image
+     * - Formats: JPG, JPEG, PNG
+     * - Scene "normal": Image processed as square (recommended for item images)
+     * - Scene "desc": No processing (recommended for extended descriptions)
+     *
+     * @throws {Error} When the API request fails
+     */
+    uploadImage(params: UploadImageParams): Promise<UploadImageResponse>;
+    /**
+     * Initiate a video upload session
+     *
+     * @param {InitVideoUploadParams} params - Parameters for initiating video upload
+     * @param {string} params.file_md5 - MD5 hash of the video file
+     * @param {number} params.file_size - Size of video file in bytes (max 30MB)
+     * @returns {Promise<InitVideoUploadResponse>} Response containing video_upload_id
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.media.initVideoUpload({
+     *   file_md5: '2abf0b6e5ff90ff24437a0808f171a93',
+     *   file_size: 1261876
+     * });
+     * const videoUploadId = result.response.video_upload_id;
+     * ```
+     *
+     * **Video Requirements:**
+     * - Duration: 10-60 seconds (inclusive)
+     * - Maximum size: 30MB
+     * - Must upload by parts after initialization
+     *
+     * @throws {Error} When the API request fails
+     * - error_file_size: File size is too large (max 30MB)
+     */
+    initVideoUpload(params: InitVideoUploadParams): Promise<InitVideoUploadResponse>;
+    /**
+     * Upload a video file by parts
+     *
+     * @param {UploadVideoPartParams} params - Parameters for uploading video part
+     * @param {string} params.video_upload_id - Upload ID from initVideoUpload
+     * @param {number} params.part_seq - Sequence number starting from 0
+     * @param {string} params.content_md5 - MD5 hash of this part
+     * @param {string | Buffer} params.part_content - Content of this part
+     * @returns {Promise<UploadVideoPartResponse>} Response indicating upload success
+     *
+     * @example
+     * ```typescript
+     * // Upload video parts sequentially
+     * for (let i = 0; i < partCount; i++) {
+     *   await sdk.media.uploadVideoPart({
+     *     video_upload_id: videoUploadId,
+     *     part_seq: i,
+     *     content_md5: partMd5,
+     *     part_content: partBuffer
+     *   });
+     * }
+     * ```
+     *
+     * **Part Requirements:**
+     * - Part size: Exactly 4MB except for the last part
+     * - Must provide MD5 hash for each part
+     * - Upload parts sequentially starting from 0
+     *
+     * @throws {Error} When the API request fails
+     * - error_invalid_upload_id: Invalid upload_id
+     * - error_invalid_part_seq: Invalid part_seq
+     * - error_invalid_part_size: Invalid part_size
+     */
+    uploadVideoPart(params: UploadVideoPartParams): Promise<UploadVideoPartResponse>;
+    /**
+     * Complete the video upload and start transcoding
+     *
+     * @param {CompleteVideoUploadParams} params - Parameters for completing video upload
+     * @param {string} params.video_upload_id - Upload ID from initVideoUpload
+     * @param {number[]} params.part_seq_list - List of all uploaded part sequences
+     * @param {object} params.report_data - Upload performance tracking data
+     * @param {number} params.report_data.upload_cost - Upload time in milliseconds
+     * @returns {Promise<CompleteVideoUploadResponse>} Response indicating completion
+     *
+     * @example
+     * ```typescript
+     * const startTime = Date.now();
+     * // ... upload all parts ...
+     * const uploadCost = Date.now() - startTime;
+     *
+     * await sdk.media.completeVideoUpload({
+     *   video_upload_id: videoUploadId,
+     *   part_seq_list: [0, 1, 2, 3],
+     *   report_data: {
+     *     upload_cost: uploadCost
+     *   }
+     * });
+     * ```
+     *
+     * **Notes:**
+     * - Call this after all parts are uploaded successfully
+     * - Transcoding process begins after this call
+     * - Use getVideoUploadResult to check transcoding status
+     *
+     * @throws {Error} When the API request fails
+     * - error_invalid_upload_id: Invalid upload_id
+     * - error_already_completed: Upload already completed
+     */
+    completeVideoUpload(params: CompleteVideoUploadParams): Promise<CompleteVideoUploadResponse>;
+    /**
+     * Query the upload status and result of a video upload
+     *
+     * @param {GetVideoUploadResultParams} params - Parameters for querying video status
+     * @param {string} params.video_upload_id - Upload ID from initVideoUpload
+     * @returns {Promise<GetVideoUploadResultResponse>} Response containing upload status and video info
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.media.getVideoUploadResult({
+     *   video_upload_id: videoUploadId
+     * });
+     *
+     * if (result.response.status === 'SUCCEEDED') {
+     *   console.log('Video URL:', result.response.video_info.video_url_list);
+     *   console.log('Duration:', result.response.video_info.duration);
+     * } else if (result.response.status === 'FAILED') {
+     *   console.error('Upload failed:', result.response.message);
+     * }
+     * ```
+     *
+     * **Upload Status:**
+     * - INITIATED: Waiting for parts or complete_video_upload call
+     * - TRANSCODING: Transcoding the video file
+     * - SUCCEEDED: Transcoding completed, video ready to use
+     * - FAILED: Upload failed, check message for details
+     * - CANCELLED: Upload was cancelled
+     *
+     * @throws {Error} When the API request fails
+     * - error_invalid_upload_id: Invalid upload_id
+     */
+    getVideoUploadResult(params: GetVideoUploadResultParams): Promise<GetVideoUploadResultResponse>;
+    /**
+     * Cancel a video upload session
+     *
+     * @param {CancelVideoUploadParams} params - Parameters for cancelling video upload
+     * @param {string} params.video_upload_id - Upload ID from initVideoUpload
+     * @returns {Promise<CancelVideoUploadResponse>} Response indicating cancellation
+     *
+     * @example
+     * ```typescript
+     * await sdk.media.cancelVideoUpload({
+     *   video_upload_id: videoUploadId
+     * });
+     * console.log('Video upload cancelled');
+     * ```
+     *
+     * **Use Cases:**
+     * - Cancel upload on user request
+     * - Cancel failed upload to free resources
+     * - Cancel when upload takes too long
+     *
+     * @throws {Error} When the API request fails
+     * - error_invalid_upload_id: Invalid upload_id
+     * - error_already_completed: Upload already completed (cannot cancel)
+     */
+    cancelVideoUpload(params: CancelVideoUploadParams): Promise<CancelVideoUploadResponse>;
+}