@congminh1254/shopee-sdk 0.9.0 → 1.0.0

package/lib/managers/media.manager.js

@@ -0,0 +1,274 @@
+import { BaseManager } from "./base.manager.js";
+import { ShopeeFetch } from "../fetch.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 class MediaManager extends BaseManager {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * 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
+     */
+    async uploadMediaImage(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/media/upload_image", {
+            method: "POST",
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * 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
+     */
+    async uploadImage(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/media_space/upload_image", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * 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)
+     */
+    async initVideoUpload(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/media_space/init_video_upload", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * 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
+     */
+    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 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
+     */
+    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 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
+     */
+    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 {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)
+     */
+    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.manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media.manager.js","sourceRoot":"","sources":["../../src/managers/media.manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAiBhD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C,YAAY,MAAoB;QAC9B,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,gBAAgB,CAAC,MAA8B;QACnD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,qBAAqB,EACrB;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,MAAM;SACb,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;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,IAAI;YACV,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;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;;;;;;;;;;;;;;;;;;;;;;;OAuBG;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/merchant.manager.d.ts

@@ -0,0 +1,100 @@
+import { ShopeeConfig } from "../sdk.js";
+import { BaseManager } from "./base.manager.js";
+import { GetMerchantInfoParams, GetMerchantInfoResponse, GetMerchantPrepaidAccountListParams, GetMerchantPrepaidAccountListResponse, GetMerchantWarehouseListParams, GetMerchantWarehouseListResponse, GetMerchantWarehouseLocationListParams, GetMerchantWarehouseLocationListResponse, GetShopListByMerchantParams, GetShopListByMerchantResponse, GetWarehouseEligibleShopListParams, GetWarehouseEligibleShopListResponse } from "../schemas/merchant.js";
+export declare class MerchantManager extends BaseManager {
+    constructor(config: ShopeeConfig);
+    /**
+     * Get information of merchant
+     * @returns {Promise<GetMerchantInfoResponse>} The response containing merchant information including name, authorization time, currency, region, and CBSC status
+     *
+     * This endpoint retrieves comprehensive information about the merchant including:
+     * - Merchant name and region
+     * - Authorization and expiration times
+     * - Supported currency
+     * - CNSC/CBSC upgrade status
+     */
+    getMerchantInfo(params?: GetMerchantInfoParams): Promise<GetMerchantInfoResponse>;
+    /**
+     * Get seller's courier prepaid account list
+     * @param {GetMerchantPrepaidAccountListParams} params - Pagination parameters
+     * @param {number} params.page_no - Page number starting from 1
+     * @param {number} params.page_size - Number of items per page (max 100)
+     * @returns {Promise<GetMerchantPrepaidAccountListResponse>} The response containing list of prepaid accounts with courier details
+     *
+     * This endpoint retrieves the merchant's prepaid courier accounts including:
+     * - Account IDs and default status
+     * - Courier information (name, key)
+     * - Partner credentials (may be masked for security)
+     * - Account configuration details
+     */
+    getMerchantPrepaidAccountList(params: GetMerchantPrepaidAccountListParams): Promise<GetMerchantPrepaidAccountListResponse>;
+    /**
+     * Get merchant warehouse list with pagination
+     * @param {GetMerchantWarehouseListParams} params - Parameters with cursor for pagination
+     * @param {DoubleSidedCursor} params.cursor - Cursor for pagination (next_id, prev_id, page_size)
+     * @returns {Promise<GetMerchantWarehouseListResponse>} The response containing list of warehouses with full address details
+     *
+     * This endpoint retrieves the merchant's warehouse list including:
+     * - Warehouse IDs, names, and types (pickup/return)
+     * - Complete address information (street, city, state, region, zip code)
+     * - Location identifiers
+     * - Enterprise information (for applicable regions like Brazil)
+     * - Support for double-sided cursor pagination (next/prev)
+     *
+     * Pagination guide:
+     * - First page: Set next_id = 0 or null
+     * - Next page: Use next_id from previous response, set prev_id = null
+     * - Previous page: Use prev_id from previous response, set next_id = null
+     * - No more next data: next_id in response is null
+     * - No more prev data: prev_id in response is null
+     */
+    getMerchantWarehouseList(params: GetMerchantWarehouseListParams): Promise<GetMerchantWarehouseListResponse>;
+    /**
+     * Get merchant warehouse location list
+     * @returns {Promise<GetMerchantWarehouseLocationListResponse>} The response containing list of warehouse locations with location IDs and names
+     *
+     * This endpoint retrieves a simplified list of warehouse locations including:
+     * - Location IDs
+     * - Warehouse names
+     *
+     * This is useful for getting a quick overview of available warehouse locations
+     * without the full address details provided by getMerchantWarehouseList.
+     */
+    getMerchantWarehouseLocationList(params?: GetMerchantWarehouseLocationListParams): Promise<GetMerchantWarehouseLocationListResponse>;
+    /**
+     * Get shop list bound to merchant
+     * @param {GetShopListByMerchantParams} params - Pagination parameters
+     * @param {number} params.page_no - Page number starting from 1
+     * @param {number} params.page_size - Number of items per page (max 500)
+     * @returns {Promise<GetShopListByMerchantResponse>} The response containing list of shops with SIP affiliate information
+     *
+     * This endpoint retrieves all shops that are authorized to the partner and bound to the merchant including:
+     * - Shop IDs
+     * - SIP affiliate shops (only returned for primary shops)
+     * - CNSC status indicator
+     * - Pagination support with more flag
+     */
+    getShopListByMerchant(params: GetShopListByMerchantParams): Promise<GetShopListByMerchantResponse>;
+    /**
+     * Get eligible shop list by warehouse id
+     * @param {GetWarehouseEligibleShopListParams} params - Parameters with warehouse ID, type, and cursor
+     * @param {number} params.warehouse_id - Warehouse address identifier
+     * @param {number} params.warehouse_type - 1 = pickup warehouse, 2 = return warehouse
+     * @param {DoubleSidedCursor} params.cursor - Cursor for pagination
+     * @returns {Promise<GetWarehouseEligibleShopListResponse>} The response containing list of eligible shops with names
+     *
+     * This endpoint retrieves shops that are eligible for a specific warehouse including:
+     * - Shop IDs and names
+     * - Support for double-sided cursor pagination
+     *
+     * Useful for determining which shops can use a particular warehouse for
+     * pickups (warehouse_type = 1) or returns (warehouse_type = 2).
+     *
+     * Pagination guide:
+     * - First page: Set next_id = 0 or null, specify page_size
+     * - Next page: Use next_id from previous response, set prev_id = null
+     * - Previous page: Use prev_id from previous response, set next_id = null
+     * - Page size limit: [1, 30]
+     */
+    getWarehouseEligibleShopList(params: GetWarehouseEligibleShopListParams): Promise<GetWarehouseEligibleShopListResponse>;
+}

package/lib/managers/merchant.manager.js

@@ -0,0 +1,144 @@
+import { BaseManager } from "./base.manager.js";
+import { ShopeeFetch } from "../fetch.js";
+export class MerchantManager extends BaseManager {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Get information of merchant
+     * @returns {Promise<GetMerchantInfoResponse>} The response containing merchant information including name, authorization time, currency, region, and CBSC status
+     *
+     * This endpoint retrieves comprehensive information about the merchant including:
+     * - Merchant name and region
+     * - Authorization and expiration times
+     * - Supported currency
+     * - CNSC/CBSC upgrade status
+     */
+    async getMerchantInfo(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/merchant/get_merchant_info", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Get seller's courier prepaid account list
+     * @param {GetMerchantPrepaidAccountListParams} params - Pagination parameters
+     * @param {number} params.page_no - Page number starting from 1
+     * @param {number} params.page_size - Number of items per page (max 100)
+     * @returns {Promise<GetMerchantPrepaidAccountListResponse>} The response containing list of prepaid accounts with courier details
+     *
+     * This endpoint retrieves the merchant's prepaid courier accounts including:
+     * - Account IDs and default status
+     * - Courier information (name, key)
+     * - Partner credentials (may be masked for security)
+     * - Account configuration details
+     */
+    async getMerchantPrepaidAccountList(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/merchant/get_merchant_prepaid_account_list", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Get merchant warehouse list with pagination
+     * @param {GetMerchantWarehouseListParams} params - Parameters with cursor for pagination
+     * @param {DoubleSidedCursor} params.cursor - Cursor for pagination (next_id, prev_id, page_size)
+     * @returns {Promise<GetMerchantWarehouseListResponse>} The response containing list of warehouses with full address details
+     *
+     * This endpoint retrieves the merchant's warehouse list including:
+     * - Warehouse IDs, names, and types (pickup/return)
+     * - Complete address information (street, city, state, region, zip code)
+     * - Location identifiers
+     * - Enterprise information (for applicable regions like Brazil)
+     * - Support for double-sided cursor pagination (next/prev)
+     *
+     * Pagination guide:
+     * - First page: Set next_id = 0 or null
+     * - Next page: Use next_id from previous response, set prev_id = null
+     * - Previous page: Use prev_id from previous response, set next_id = null
+     * - No more next data: next_id in response is null
+     * - No more prev data: prev_id in response is null
+     */
+    async getMerchantWarehouseList(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/merchant/get_merchant_warehouse_list", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Get merchant warehouse location list
+     * @returns {Promise<GetMerchantWarehouseLocationListResponse>} The response containing list of warehouse locations with location IDs and names
+     *
+     * This endpoint retrieves a simplified list of warehouse locations including:
+     * - Location IDs
+     * - Warehouse names
+     *
+     * This is useful for getting a quick overview of available warehouse locations
+     * without the full address details provided by getMerchantWarehouseList.
+     */
+    async getMerchantWarehouseLocationList(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/merchant/get_merchant_warehouse_location_list", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Get shop list bound to merchant
+     * @param {GetShopListByMerchantParams} params - Pagination parameters
+     * @param {number} params.page_no - Page number starting from 1
+     * @param {number} params.page_size - Number of items per page (max 500)
+     * @returns {Promise<GetShopListByMerchantResponse>} The response containing list of shops with SIP affiliate information
+     *
+     * This endpoint retrieves all shops that are authorized to the partner and bound to the merchant including:
+     * - Shop IDs
+     * - SIP affiliate shops (only returned for primary shops)
+     * - CNSC status indicator
+     * - Pagination support with more flag
+     */
+    async getShopListByMerchant(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/merchant/get_shop_list_by_merchant", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Get eligible shop list by warehouse id
+     * @param {GetWarehouseEligibleShopListParams} params - Parameters with warehouse ID, type, and cursor
+     * @param {number} params.warehouse_id - Warehouse address identifier
+     * @param {number} params.warehouse_type - 1 = pickup warehouse, 2 = return warehouse
+     * @param {DoubleSidedCursor} params.cursor - Cursor for pagination
+     * @returns {Promise<GetWarehouseEligibleShopListResponse>} The response containing list of eligible shops with names
+     *
+     * This endpoint retrieves shops that are eligible for a specific warehouse including:
+     * - Shop IDs and names
+     * - Support for double-sided cursor pagination
+     *
+     * Useful for determining which shops can use a particular warehouse for
+     * pickups (warehouse_type = 1) or returns (warehouse_type = 2).
+     *
+     * Pagination guide:
+     * - First page: Set next_id = 0 or null, specify page_size
+     * - Next page: Use next_id from previous response, set prev_id = null
+     * - Previous page: Use prev_id from previous response, set next_id = null
+     * - Page size limit: [1, 30]
+     */
+    async getWarehouseEligibleShopList(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/merchant/get_warehouse_eligible_shop_list", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+}
+//# sourceMappingURL=merchant.manager.js.map

package/lib/managers/merchant.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merchant.manager.js","sourceRoot":"","sources":["../../src/managers/merchant.manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAehD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YAAY,MAAoB;QAC9B,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,eAAe,CAAC,MAA8B;QAClD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,6BAA6B,EAC7B;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI;YACV,MAAM;SACP,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,6BAA6B,CACjC,MAA2C;QAE3C,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,6CAA6C,EAC7C;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM;SACb,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,wBAAwB,CAC5B,MAAsC;QAEtC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,uCAAuC,EACvC;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM;SACb,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,gCAAgC,CACpC,MAA+C;QAE/C,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,gDAAgD,EAChD;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI;YACV,MAAM;SACP,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,qBAAqB,CACzB,MAAmC;QAEnC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,qCAAqC,EACrC;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI;YACV,MAAM;SACP,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAK,CAAC,4BAA4B,CAChC,MAA0C;QAE1C,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,4CAA4C,EAC5C;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM;SACb,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}