@congminh1254/shopee-sdk 0.4.0

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

@@ -0,0 +1,105 @@
+import { BaseManager } from './base.manager.js';
+import { ShopeeConfig } from '../sdk.js';
+import { GetOrderListParams, GetOrderListResponse, GetOrdersDetailParams, GetOrdersDetailResponse, GetShipmentListParams, GetShipmentListResponse, SplitOrderParams, SplitOrderResponse, UnsplitOrderParams, UnsplitOrderResponse, CancelOrderParams, CancelOrderResponse, GetBuyerInvoiceInfoParams, GetBuyerInvoiceInfoResponse } from '../schemas/order.js';
+export declare class OrderManager extends BaseManager {
+    constructor(config: ShopeeConfig);
+    /**
+     * Use this api to search orders. You may also filter them by status, if needed.
+     *
+     * @param params - The parameters for getting order list
+     * @param params.time_range_field - The kind of time_from and time_to. Available value: create_time, update_time
+     * @param params.time_from - The starting date range for retrieving orders. The maximum date range is 15 days
+     * @param params.time_to - The ending date range for retrieving orders. The maximum date range is 15 days
+     * @param params.page_size - The maximum number of entries to return in a single page (between 1 and 100)
+     * @param params.cursor - Specifies the starting entry of data to return in the current call
+     * @param params.order_status - The order status filter for retrieving orders. Available value: UNPAID/READY_TO_SHIP/PROCESSED/SHIPPED/COMPLETED/IN_CANCEL/CANCELLED/INVOICE_PENDING
+     * @param params.response_optional_fields - Optional fields in response. Available value: order_status
+     * @param params.request_order_status_pending - Compatible parameter during migration period, send True will let API support PENDING status
+     * @param params.logistics_channel_id - The identity of logistic channel. Valid only for BR
+     * @returns Promise<GetOrderListResponse> - The response containing order list and pagination information
+     */
+    getOrderList(params: GetOrderListParams): Promise<GetOrderListResponse>;
+    /**
+     * Use this api to get order detail.
+     *
+     * @param params - The parameters for getting order details
+     * @param params.order_sn_list - The set of order_sn. If there are multiple order_sn, you need to use English comma to connect them. limit [1,50]
+     * @param params.request_order_status_pending - Compatible parameter during migration period, send True will let API support PENDING status and return pending_terms, send False or don't send will fallback to old logic
+     * @param params.response_optional_fields - A response fields you want to get. Please select from the below response parameters. If you input an object field, all the params under it will be included automatically in the response. If there are multiple response fields you want to get, you need to use English comma to connect them.
+     * @returns Promise<GetOrdersDetailResponse> - The response containing detailed order information
+     */
+    getOrdersDetail(params: GetOrdersDetailParams): Promise<GetOrdersDetailResponse>;
+    /**
+     * Use this api to get order list which order_status is READY_TO_SHIP to start process the whole shipping progress.
+     *
+     * @param params - The parameters for getting shipment list
+     * @param params.cursor - Specifies the starting entry of data to return in the current call
+     * @param params.page_size - The maximum number of entries to return in a single page (between 1 and 100)
+     * @returns Promise<GetShipmentListResponse> - The response containing shipment list and pagination information
+     */
+    getShipmentList(params: GetShipmentListParams): Promise<GetShipmentListResponse>;
+    /**
+     * Split an order into multiple packages
+     * @param params - Parameters for splitting the order
+     * @param params.order_sn - Shopee's unique identifier for an order
+     * @param params.package_list - The list of packages that you want to split
+     * @returns Promise resolving to the split order response
+     */
+    splitOrder(params: SplitOrderParams): Promise<SplitOrderResponse>;
+    /**
+     * Use this api to unsplit an order that has been split into multiple packages.
+     *
+     * @param params - Parameters for unsplitting the order
+     * @param params.order_sn - Shopee's unique identifier for an order
+     * @returns Promise<UnsplitOrderResponse> - Response containing the unsplit order details
+     * @throws {ShopeeApiError} - Throws error if:
+     * - Wrong parameters are provided
+     * - No permission to unsplit order
+     * - Order has not been split
+     * - Unsplit order failed
+     * - Cannot unsplit order with invalid items
+     * - Cannot unsplit order with missing items
+     */
+    unsplitOrder(params: UnsplitOrderParams): Promise<UnsplitOrderResponse>;
+    /**
+     * Use this api to cancel an order. This action can only be performed before an order has been shipped.
+     *
+     * @param params - Parameters for canceling the order
+     * @param params.order_sn - Shopee's unique identifier for an order
+     * @param params.cancel_reason - The reason seller want to cancel this order. Applicable values: OUT_OF_STOCK, UNDELIVERABLE_AREA(only apply for TW and MY)
+     * @param params.item_list - Required when cancel_reason is OUT_OF_STOCK. List of items to cancel
+     * @param params.item_list[].item_id - Shopee's unique identifier for an item
+     * @param params.item_list[].model_id - Shopee's unique identifier for a model of an item
+     * @returns Promise<CancelOrderResponse> - Response containing the update time of the canceled order
+     * @throws {ShopeeApiError} - Throws error if:
+     * - Wrong parameters are provided
+     * - No permission to cancel order
+     * - Cannot cancel warehouse order
+     * - Shop and partner are not linked on seller center
+     * - Order has already been shipped
+     */
+    cancelOrder(params: CancelOrderParams): Promise<CancelOrderResponse>;
+    /**
+     * Get buyer invoice information for orders
+     *
+     * Use this API to obtain buyer submitted invoice info for VN, TH and PH local sellers only.
+     *
+     * @param params - The parameters for getting buyer invoice info
+     * @param params.queries - List of order queries
+     * @param params.queries[].order_sn - Shopee's unique identifier for an order
+     *
+     * @returns A promise that resolves to the invoice info response containing:
+     * - invoice_info_list: List of invoice information for each order
+     *   - order_sn: Order identifier
+     *   - invoice_type: Type of invoice (personal/company)
+     *   - invoice_detail: Detailed invoice information
+     *   - error: Error message if any
+     *   - is_requested: Whether buyer requested invoice
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - error_param: Missing or invalid parameters
+     * - error_auth: Authentication or permission errors
+     * - error_server: Internal server errors
+     */
+    getBuyerInvoiceInfo(params: GetBuyerInvoiceInfoParams): Promise<GetBuyerInvoiceInfoResponse>;
+}

package/lib/managers/order.manager.js

@@ -0,0 +1,173 @@
+import { BaseManager } from './base.manager.js';
+import { ShopeeFetch } from '../fetch.js';
+export class OrderManager extends BaseManager {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Use this api to search orders. You may also filter them by status, if needed.
+     *
+     * @param params - The parameters for getting order list
+     * @param params.time_range_field - The kind of time_from and time_to. Available value: create_time, update_time
+     * @param params.time_from - The starting date range for retrieving orders. The maximum date range is 15 days
+     * @param params.time_to - The ending date range for retrieving orders. The maximum date range is 15 days
+     * @param params.page_size - The maximum number of entries to return in a single page (between 1 and 100)
+     * @param params.cursor - Specifies the starting entry of data to return in the current call
+     * @param params.order_status - The order status filter for retrieving orders. Available value: UNPAID/READY_TO_SHIP/PROCESSED/SHIPPED/COMPLETED/IN_CANCEL/CANCELLED/INVOICE_PENDING
+     * @param params.response_optional_fields - Optional fields in response. Available value: order_status
+     * @param params.request_order_status_pending - Compatible parameter during migration period, send True will let API support PENDING status
+     * @param params.logistics_channel_id - The identity of logistic channel. Valid only for BR
+     * @returns Promise<GetOrderListResponse> - The response containing order list and pagination information
+     */
+    async getOrderList(params) {
+        const response = await ShopeeFetch.fetch(this.config, '/order/get_order_list', {
+            method: 'GET',
+            params,
+            auth: true,
+        });
+        return response;
+    }
+    /**
+     * Use this api to get order detail.
+     *
+     * @param params - The parameters for getting order details
+     * @param params.order_sn_list - The set of order_sn. If there are multiple order_sn, you need to use English comma to connect them. limit [1,50]
+     * @param params.request_order_status_pending - Compatible parameter during migration period, send True will let API support PENDING status and return pending_terms, send False or don't send will fallback to old logic
+     * @param params.response_optional_fields - A response fields you want to get. Please select from the below response parameters. If you input an object field, all the params under it will be included automatically in the response. If there are multiple response fields you want to get, you need to use English comma to connect them.
+     * @returns Promise<GetOrdersDetailResponse> - The response containing detailed order information
+     */
+    async getOrdersDetail(params) {
+        const response = await ShopeeFetch.fetch(this.config, `/order/get_order_detail`, {
+            method: 'GET',
+            auth: true,
+            params: {
+                ...params,
+                order_sn_list: params.order_sn_list.join(','),
+            },
+        });
+        return response;
+    }
+    /**
+     * Use this api to get order list which order_status is READY_TO_SHIP to start process the whole shipping progress.
+     *
+     * @param params - The parameters for getting shipment list
+     * @param params.cursor - Specifies the starting entry of data to return in the current call
+     * @param params.page_size - The maximum number of entries to return in a single page (between 1 and 100)
+     * @returns Promise<GetShipmentListResponse> - The response containing shipment list and pagination information
+     */
+    async getShipmentList(params) {
+        const response = await ShopeeFetch.fetch(this.config, '/order/get_shipment_list', {
+            method: 'GET',
+            params,
+            auth: true,
+        });
+        return response;
+    }
+    /**
+     * Split an order into multiple packages
+     * @param params - Parameters for splitting the order
+     * @param params.order_sn - Shopee's unique identifier for an order
+     * @param params.package_list - The list of packages that you want to split
+     * @returns Promise resolving to the split order response
+     */
+    async splitOrder(params) {
+        return ShopeeFetch.fetch(this.config, '/order/split_order', {
+            method: 'POST',
+            body: {
+                order_sn: params.order_sn,
+                package_list: params.package_list.map(pkg => ({
+                    item_list: pkg.item_list.map(item => ({
+                        item_id: item.item_id,
+                        model_id: item.model_id,
+                        order_item_id: item.order_item_id,
+                        promotion_group_id: item.promotion_group_id,
+                        model_quantity: item.model_quantity
+                    }))
+                }))
+            },
+            auth: true
+        });
+    }
+    /**
+     * Use this api to unsplit an order that has been split into multiple packages.
+     *
+     * @param params - Parameters for unsplitting the order
+     * @param params.order_sn - Shopee's unique identifier for an order
+     * @returns Promise<UnsplitOrderResponse> - Response containing the unsplit order details
+     * @throws {ShopeeApiError} - Throws error if:
+     * - Wrong parameters are provided
+     * - No permission to unsplit order
+     * - Order has not been split
+     * - Unsplit order failed
+     * - Cannot unsplit order with invalid items
+     * - Cannot unsplit order with missing items
+     */
+    async unsplitOrder(params) {
+        return ShopeeFetch.fetch(this.config, '/order/unsplit_order', {
+            method: 'POST',
+            body: {
+                order_sn: params.order_sn
+            },
+            auth: true
+        });
+    }
+    /**
+     * Use this api to cancel an order. This action can only be performed before an order has been shipped.
+     *
+     * @param params - Parameters for canceling the order
+     * @param params.order_sn - Shopee's unique identifier for an order
+     * @param params.cancel_reason - The reason seller want to cancel this order. Applicable values: OUT_OF_STOCK, UNDELIVERABLE_AREA(only apply for TW and MY)
+     * @param params.item_list - Required when cancel_reason is OUT_OF_STOCK. List of items to cancel
+     * @param params.item_list[].item_id - Shopee's unique identifier for an item
+     * @param params.item_list[].model_id - Shopee's unique identifier for a model of an item
+     * @returns Promise<CancelOrderResponse> - Response containing the update time of the canceled order
+     * @throws {ShopeeApiError} - Throws error if:
+     * - Wrong parameters are provided
+     * - No permission to cancel order
+     * - Cannot cancel warehouse order
+     * - Shop and partner are not linked on seller center
+     * - Order has already been shipped
+     */
+    async cancelOrder(params) {
+        return ShopeeFetch.fetch(this.config, '/order/cancel_order', {
+            method: 'POST',
+            body: {
+                order_sn: params.order_sn,
+                cancel_reason: params.cancel_reason,
+                item_list: params.item_list
+            },
+            auth: true
+        });
+    }
+    /**
+     * Get buyer invoice information for orders
+     *
+     * Use this API to obtain buyer submitted invoice info for VN, TH and PH local sellers only.
+     *
+     * @param params - The parameters for getting buyer invoice info
+     * @param params.queries - List of order queries
+     * @param params.queries[].order_sn - Shopee's unique identifier for an order
+     *
+     * @returns A promise that resolves to the invoice info response containing:
+     * - invoice_info_list: List of invoice information for each order
+     *   - order_sn: Order identifier
+     *   - invoice_type: Type of invoice (personal/company)
+     *   - invoice_detail: Detailed invoice information
+     *   - error: Error message if any
+     *   - is_requested: Whether buyer requested invoice
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - error_param: Missing or invalid parameters
+     * - error_auth: Authentication or permission errors
+     * - error_server: Internal server errors
+     */
+    async getBuyerInvoiceInfo(params) {
+        const response = await ShopeeFetch.fetch(this.config, `/order/get_buyer_invoice_info`, {
+            method: 'POST',
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+}
+//# sourceMappingURL=order.manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"order.manager.js","sourceRoot":"","sources":["../../src/managers/order.manager.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,30 @@
+import { ShopeeConfig } from "../sdk.js";
+import { BaseManager } from "./base.manager.js";
+import { GetEscrowDetailParams, GetEscrowDetailResponse } from "../schemas/payment.js";
+export declare class PaymentManager extends BaseManager {
+    constructor(config: ShopeeConfig);
+    /**
+     * Use this API to fetch the accounting detail of order.
+     *
+     * @param params - Parameters for getting escrow detail
+     * @param params.order_sn - Shopee's unique identifier for an order
+     *
+     * @returns A promise that resolves to the escrow detail response containing:
+     * - order_sn: Order identifier
+     * - buyer_user_name: Username of buyer
+     * - return_order_sn_list: List of return order numbers
+     * - order_income: Detailed breakdown of order income including:
+     *   - escrow_amount: Expected amount seller will receive
+     *   - buyer_total_amount: Total amount paid by buyer
+     *   - items: List of items with pricing details
+     *   - fees and adjustments: Various fees, taxes and adjustments
+     * - buyer_payment_info: Payment details from buyer's perspective
+     *
+     * @throws {Error} When the API request fails or returns an error:
+     * - error_param: Missing or invalid parameters
+     * - error_auth: Authentication or permission errors
+     * - error_server: Internal server errors
+     * - error_not_found: Order income details not found
+     */
+    getEscrowDetail(params: GetEscrowDetailParams): Promise<GetEscrowDetailResponse>;
+}

package/lib/managers/payment.manager.js

@@ -0,0 +1,39 @@
+import { BaseManager } from "./base.manager.js";
+import { ShopeeFetch } from "../fetch.js";
+export class PaymentManager extends BaseManager {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Use this API to fetch the accounting detail of order.
+     *
+     * @param params - Parameters for getting escrow detail
+     * @param params.order_sn - Shopee's unique identifier for an order
+     *
+     * @returns A promise that resolves to the escrow detail response containing:
+     * - order_sn: Order identifier
+     * - buyer_user_name: Username of buyer
+     * - return_order_sn_list: List of return order numbers
+     * - order_income: Detailed breakdown of order income including:
+     *   - escrow_amount: Expected amount seller will receive
+     *   - buyer_total_amount: Total amount paid by buyer
+     *   - items: List of items with pricing details
+     *   - fees and adjustments: Various fees, taxes and adjustments
+     * - buyer_payment_info: Payment details from buyer's perspective
+     *
+     * @throws {Error} When the API request fails or returns an error:
+     * - error_param: Missing or invalid parameters
+     * - error_auth: Authentication or permission errors
+     * - error_server: Internal server errors
+     * - error_not_found: Order income details not found
+     */
+    async getEscrowDetail(params) {
+        const response = await ShopeeFetch.fetch(this.config, '/payment/get_escrow_detail', {
+            method: 'GET',
+            auth: true,
+            params,
+        });
+        return response;
+    }
+}
+//# sourceMappingURL=payment.manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payment.manager.js","sourceRoot":"","sources":["../../src/managers/payment.manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC3C,YAAY,MAAoB;QAC9B,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,eAAe,CAAC,MAA6B;QAC/C,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACpC,IAAI,CAAC,MAAM,EACX,4BAA4B,EAC5B;YACI,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI;YACV,MAAM;SACT,CACJ,CAAC;QACF,OAAO,QAAQ,CAAC;IACpB,CAAC;CACJ"}

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

@@ -0,0 +1,114 @@
+import { BaseManager } from './base.manager.js';
+import { ShopeeConfig } from '../sdk.js';
+import { GetCommentParams, GetCommentResponse, ReplyCommentParams, ReplyCommentResponse, GetItemListParams, GetItemListResponse, GetItemBaseInfoParams, GetItemBaseInfoResponse } from '../schemas/product.js';
+export declare class ProductManager extends BaseManager {
+    constructor(config: ShopeeConfig);
+    /**
+     * Get comments for products
+     *
+     * Use this API to get comments by shop_id, item_id, or comment_id. Can retrieve up to 1000 comments.
+     *
+     * @param params - The parameters for getting comments
+     * @param params.item_id - The identity of product item
+     * @param params.comment_id - The identity of comment
+     * @param params.cursor - Specifies the starting entry of data to return. Default is empty string
+     * @param params.page_size - Maximum number of entries to return per page (between 1 and 100)
+     *
+     * @returns A promise that resolves to the comment response containing:
+     * - request_id: The identifier for API request tracking
+     * - error: Error type if any error occurred
+     * - message: Error details if any error occurred
+     * - response: The response data containing comment list, pagination info
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    getComment(params: GetCommentParams): Promise<GetCommentResponse>;
+    /**
+     * Reply to buyer comments in batch
+     *
+     * Use this API to reply to comments from buyers in batch. You can reply to multiple comments at once.
+     *
+     * @param params - The parameters for replying to comments
+     * @param params.comment_list - List of comments to reply to (between 1 and 100 items)
+     * @param params.comment_list[].comment_id - The identity of comment to reply to
+     * @param params.comment_list[].comment - The content of the reply (between 1 and 500 characters)
+     *
+     * @returns A promise that resolves to the reply response containing:
+     * - request_id: The identifier for API request tracking
+     * - error: Error type if any error occurred
+     * - message: Error details if any error occurred
+     * - response: The response data containing result list and warnings
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - product.duplicate_request: You have already replied to this comment
+     * - product.comment_length_invalid: Comment length should be between 1 and 500
+     * - product.error_permission: Reply comment failed due to invalid shop token
+     * - product.error_not_exist: The comment you replied to does not exist
+     * - product.duplicate_comment_id: Duplicate comment id in the request
+     */
+    replyComment(params: ReplyCommentParams): Promise<ReplyCommentResponse>;
+    /**
+     * Use this call to get a list of items.
+     *
+     * @param params - Parameters for getting item list
+     * @param params.offset - Specifies the starting entry of data to return. Default is 0.
+     * @param params.page_size - The size of one page (1-100).
+     * @param params.update_time_from - Start of date range for item update time.
+     * @param params.update_time_to - End of date range for item update time.
+     * @param params.item_status - Array of item statuses to filter by.
+     *
+     * @returns A promise that resolves to the item list response containing:
+     * - item: List of item details (item_id, item_status, update_time, tag)
+     * - total_count: Total number of items matching the filter
+     * - has_next_page: Boolean indicating if there are more items
+     * - next_offset: Offset for the next page if has_next_page is true
+     * - warning: Optional warning message
+     *
+     * @throws {Error} When the API request fails or returns an error:
+     * - error_update_time_range: update_time_to before update_time_from
+     * - error_param_item_status: Invalid item status
+     * - error_param_shop_id_not_found: Shop ID not found
+     * - error_param: Offset over limit
+     * - error_item_not_found: Product not found
+     */
+    getItemList(params: GetItemListParams): Promise<GetItemListResponse>;
+    /**
+     * Use this API to get basic info of items by a list of item_ids.
+     *
+     * @param params - Parameters for getting item base info
+     * @param params.item_id_list - List of Shopee's unique identifiers for items. Max 50.
+     * @param params.need_tax_info - If true, tax_info will be included in the response.
+     * @param params.need_complaint_policy - If true, complaint_policy will be included in the response (PL region only).
+     *
+     * @returns A promise that resolves to the item base info response containing:
+     * - item_list: List of detailed item base information including:
+     *   - item_id, category_id, item_name, description, item_sku, create_time, update_time
+     *   - attribute_list: Item attributes
+     *   - price_info: Pricing details (if no models)
+     *   - image: Image URLs and IDs
+     *   - weight, dimension: Physical characteristics
+     *   - logistic_info: Enabled logistics channels and fees
+     *   - pre_order: Pre-order status and days to ship
+     *   - wholesales: Wholesale pricing tiers
+     *   - condition, size_chart, item_status, deboost, has_model, promotion_id
+     *   - video_info: Video URLs, thumbnails, and duration
+     *   - brand: Brand ID and name
+     *   - item_dangerous: Dangerous goods status
+     *   - gtin_code, size_chart_id, promotion_image, compatibility_info, scheduled_publish_time
+     *   - authorised_brand_id, ssp_id, is_fulfillment_by_shopee
+     *   - complaint_policy: (If requested and applicable)
+     *   - tax_info: (If requested)
+     *   - description_info, description_type: Normal or extended description details
+     *   - stock_info_v2: Detailed stock information (summary, seller, Shopee, advance)
+     *   - certification_info: Product certifications
+     * - warning: Optional warning message
+     * - Note: The top-level complaint_policy and tax_info in the response object seem redundant as they are also part of each item in item_list if requested.
+     *
+     * @throws {Error} When the API request fails or returns an error:
+     * - error_item_not_found: Item ID not found
+     * - error_param_shop_id_not_found: Shop ID not found
+     * - error_invalid_language: Invalid language
+     * - error_query_over_itemid_size: Too many item_ids in list
+     */
+    getItemBaseInfo(params: GetItemBaseInfoParams): Promise<GetItemBaseInfoResponse>;
+}

package/lib/managers/product.manager.js

@@ -0,0 +1,147 @@
+import { BaseManager } from './base.manager.js';
+import { ShopeeFetch } from '../fetch.js';
+export class ProductManager extends BaseManager {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Get comments for products
+     *
+     * Use this API to get comments by shop_id, item_id, or comment_id. Can retrieve up to 1000 comments.
+     *
+     * @param params - The parameters for getting comments
+     * @param params.item_id - The identity of product item
+     * @param params.comment_id - The identity of comment
+     * @param params.cursor - Specifies the starting entry of data to return. Default is empty string
+     * @param params.page_size - Maximum number of entries to return per page (between 1 and 100)
+     *
+     * @returns A promise that resolves to the comment response containing:
+     * - request_id: The identifier for API request tracking
+     * - error: Error type if any error occurred
+     * - message: Error details if any error occurred
+     * - response: The response data containing comment list, pagination info
+     *
+     * @throws {Error} When the API request fails or returns an error
+     */
+    async getComment(params) {
+        const response = await ShopeeFetch.fetch(this.config, `/product/get_comment`, {
+            method: 'GET',
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Reply to buyer comments in batch
+     *
+     * Use this API to reply to comments from buyers in batch. You can reply to multiple comments at once.
+     *
+     * @param params - The parameters for replying to comments
+     * @param params.comment_list - List of comments to reply to (between 1 and 100 items)
+     * @param params.comment_list[].comment_id - The identity of comment to reply to
+     * @param params.comment_list[].comment - The content of the reply (between 1 and 500 characters)
+     *
+     * @returns A promise that resolves to the reply response containing:
+     * - request_id: The identifier for API request tracking
+     * - error: Error type if any error occurred
+     * - message: Error details if any error occurred
+     * - response: The response data containing result list and warnings
+     *
+     * @throws {Error} When the API request fails or returns an error
+     * - product.duplicate_request: You have already replied to this comment
+     * - product.comment_length_invalid: Comment length should be between 1 and 500
+     * - product.error_permission: Reply comment failed due to invalid shop token
+     * - product.error_not_exist: The comment you replied to does not exist
+     * - product.duplicate_comment_id: Duplicate comment id in the request
+     */
+    async replyComment(params) {
+        const response = await ShopeeFetch.fetch(this.config, `/product/reply_comment`, {
+            method: 'POST',
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Use this call to get a list of items.
+     *
+     * @param params - Parameters for getting item list
+     * @param params.offset - Specifies the starting entry of data to return. Default is 0.
+     * @param params.page_size - The size of one page (1-100).
+     * @param params.update_time_from - Start of date range for item update time.
+     * @param params.update_time_to - End of date range for item update time.
+     * @param params.item_status - Array of item statuses to filter by.
+     *
+     * @returns A promise that resolves to the item list response containing:
+     * - item: List of item details (item_id, item_status, update_time, tag)
+     * - total_count: Total number of items matching the filter
+     * - has_next_page: Boolean indicating if there are more items
+     * - next_offset: Offset for the next page if has_next_page is true
+     * - warning: Optional warning message
+     *
+     * @throws {Error} When the API request fails or returns an error:
+     * - error_update_time_range: update_time_to before update_time_from
+     * - error_param_item_status: Invalid item status
+     * - error_param_shop_id_not_found: Shop ID not found
+     * - error_param: Offset over limit
+     * - error_item_not_found: Product not found
+     */
+    async getItemList(params) {
+        const response = await ShopeeFetch.fetch(this.config, '/product/get_item_list', {
+            method: 'GET',
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Use this API to get basic info of items by a list of item_ids.
+     *
+     * @param params - Parameters for getting item base info
+     * @param params.item_id_list - List of Shopee's unique identifiers for items. Max 50.
+     * @param params.need_tax_info - If true, tax_info will be included in the response.
+     * @param params.need_complaint_policy - If true, complaint_policy will be included in the response (PL region only).
+     *
+     * @returns A promise that resolves to the item base info response containing:
+     * - item_list: List of detailed item base information including:
+     *   - item_id, category_id, item_name, description, item_sku, create_time, update_time
+     *   - attribute_list: Item attributes
+     *   - price_info: Pricing details (if no models)
+     *   - image: Image URLs and IDs
+     *   - weight, dimension: Physical characteristics
+     *   - logistic_info: Enabled logistics channels and fees
+     *   - pre_order: Pre-order status and days to ship
+     *   - wholesales: Wholesale pricing tiers
+     *   - condition, size_chart, item_status, deboost, has_model, promotion_id
+     *   - video_info: Video URLs, thumbnails, and duration
+     *   - brand: Brand ID and name
+     *   - item_dangerous: Dangerous goods status
+     *   - gtin_code, size_chart_id, promotion_image, compatibility_info, scheduled_publish_time
+     *   - authorised_brand_id, ssp_id, is_fulfillment_by_shopee
+     *   - complaint_policy: (If requested and applicable)
+     *   - tax_info: (If requested)
+     *   - description_info, description_type: Normal or extended description details
+     *   - stock_info_v2: Detailed stock information (summary, seller, Shopee, advance)
+     *   - certification_info: Product certifications
+     * - warning: Optional warning message
+     * - Note: The top-level complaint_policy and tax_info in the response object seem redundant as they are also part of each item in item_list if requested.
+     *
+     * @throws {Error} When the API request fails or returns an error:
+     * - error_item_not_found: Item ID not found
+     * - error_param_shop_id_not_found: Shop ID not found
+     * - error_invalid_language: Invalid language
+     * - error_query_over_itemid_size: Too many item_ids in list
+     */
+    async getItemBaseInfo(params) {
+        const response = await ShopeeFetch.fetch(this.config, '/product/get_item_base_info', {
+            method: 'GET',
+            auth: true,
+            params: {
+                ...params,
+                item_id_list: params.item_id_list.join(',')
+            }
+        });
+        return response;
+    }
+}
+//# sourceMappingURL=product.manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"product.manager.js","sourceRoot":"","sources":["../../src/managers/product.manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC7C,YAAY,MAAoB;QAC9B,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,UAAU,CAAC,MAAwB;QACvC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,sBAAsB,EACtB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI;YACV,MAAM;SACP,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,wBAAwB,EACxB;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM;SACb,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,WAAW,CAAC,MAAyB;QACzC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,wBAAwB,EACxB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI;YACV,MAAM;SACP,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,KAAK,CAAC,eAAe,CAAC,MAA6B;QACjD,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,6BAA6B,EAC7B;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI;YACV,MAAM,EAAE;gBACN,GAAG,MAAM;gBACT,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC;aAC5C;SACF,CACF,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

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

@@ -0,0 +1,9 @@
+import { ShopeeConfig } from '../sdk.js';
+import { GetShopsByPartnerParams, GetMerchantsByPartnerParams, GetShopsByPartnerResponse, GetMerchantsByPartnerResponse, GetShopeeIpRangeResponse } from '../schemas/public.js';
+import { BaseManager } from './base.manager.js';
+export declare class PublicManager extends BaseManager {
+    constructor(config: ShopeeConfig);
+    getShopsByPartner(params?: GetShopsByPartnerParams): Promise<GetShopsByPartnerResponse>;
+    getMerchantsByPartner(params?: GetMerchantsByPartnerParams): Promise<GetMerchantsByPartnerResponse>;
+    getShopeeIpRange(): Promise<GetShopeeIpRangeResponse>;
+}