@congminh1254/shopee-sdk 0.10.0 → 1.1.0

package/lib/managers/bundle-deal.manager.d.ts

@@ -0,0 +1,106 @@
+import { ShopeeConfig } from "../sdk.js";
+import { BaseManager } from "./base.manager.js";
+import { AddBundleDealParams, AddBundleDealResponse, AddBundleDealItemParams, AddBundleDealItemResponse, DeleteBundleDealParams, DeleteBundleDealResponse, DeleteBundleDealItemParams, DeleteBundleDealItemResponse, EndBundleDealParams, EndBundleDealResponse, GetBundleDealParams, GetBundleDealResponse, GetBundleDealItemParams, GetBundleDealItemResponse, GetBundleDealListParams, GetBundleDealListResponse, UpdateBundleDealParams, UpdateBundleDealResponse, UpdateBundleDealItemParams, UpdateBundleDealItemResponse } from "../schemas/bundle-deal.js";
+export declare class BundleDealManager extends BaseManager {
+    constructor(config: ShopeeConfig);
+    /**
+     * Create a new bundle deal activity
+     * @param {AddBundleDealParams} params - Parameters for creating a new bundle deal
+     * @returns {Promise<AddBundleDealResponse>} The response containing the created bundle deal ID
+     *
+     * Note: A maximum of 1000 bundle deals can be created.
+     * The bundle deal must follow the pricing rules based on rule_type.
+     */
+    addBundleDeal(params: AddBundleDealParams): Promise<AddBundleDealResponse>;
+    /**
+     * Add items to an existing bundle deal activity
+     * @param {AddBundleDealItemParams} params - Parameters for adding items to a bundle deal
+     * @returns {Promise<AddBundleDealItemResponse>} The response containing lists of successful and failed items
+     *
+     * The response includes:
+     * - success_list: Array of item IDs that were successfully added
+     * - failed_list: Array of items that failed to be added with error details
+     */
+    addBundleDealItem(params: AddBundleDealItemParams): Promise<AddBundleDealItemResponse>;
+    /**
+     * Delete an existing bundle deal activity
+     * @param {DeleteBundleDealParams} params - Parameters for deleting a bundle deal
+     * @returns {Promise<DeleteBundleDealResponse>} The response containing the deleted bundle deal ID
+     *
+     * Note: Can only delete upcoming bundle deals that haven't started yet.
+     * Will return an error if attempting to delete a bundle deal that has already started.
+     */
+    deleteBundleDeal(params: DeleteBundleDealParams): Promise<DeleteBundleDealResponse>;
+    /**
+     * Delete items from an existing bundle deal activity
+     * @param {DeleteBundleDealItemParams} params - Parameters for deleting items from a bundle deal
+     * @returns {Promise<DeleteBundleDealItemResponse>} The response containing lists of successful and failed deletions
+     *
+     * The response includes:
+     * - success_list: Array of item IDs that were successfully deleted
+     * - failed_list: Array of items that failed to be deleted with error details
+     */
+    deleteBundleDealItem(params: DeleteBundleDealItemParams): Promise<DeleteBundleDealItemResponse>;
+    /**
+     * End an ongoing bundle deal activity immediately
+     * @param {EndBundleDealParams} params - Parameters for ending a bundle deal
+     * @returns {Promise<EndBundleDealResponse>} The response containing the ended bundle deal ID
+     *
+     * Note: Can only end bundle deals that are currently ongoing/active.
+     * Will return an error if attempting to end an upcoming or expired bundle deal.
+     */
+    endBundleDeal(params: EndBundleDealParams): Promise<EndBundleDealResponse>;
+    /**
+     * Get detailed information about a bundle deal activity
+     * @param {GetBundleDealParams} params - Parameters for getting bundle deal details
+     * @returns {Promise<GetBundleDealResponse>} The response containing comprehensive bundle deal information
+     *
+     * The response includes:
+     * - Basic bundle deal details (ID, name, timing, etc.)
+     * - Bundle deal rule configuration (type, pricing, min amount, etc.)
+     * - Purchase limits
+     * - Additional tiers if configured
+     */
+    getBundleDeal(params: GetBundleDealParams): Promise<GetBundleDealResponse>;
+    /**
+     * Get the list of items in a bundle deal
+     * @param {GetBundleDealItemParams} params - Parameters for getting bundle deal items
+     * @returns {Promise<GetBundleDealItemResponse>} The response containing the list of item IDs
+     *
+     * The response includes:
+     * - item_list: Array of item IDs that are part of the bundle deal
+     */
+    getBundleDealItem(params: GetBundleDealItemParams): Promise<GetBundleDealItemResponse>;
+    /**
+     * Get a list of bundle deal activities with pagination
+     * @param {GetBundleDealListParams} params - Parameters for retrieving bundle deal list
+     * @param {BundleDealTimeStatus} [params.time_status] - Filter by bundle deal status (default: ALL)
+     * @param {number} [params.page_no] - Page number to retrieve (default: 1)
+     * @param {number} [params.page_size] - Number of items per page (default: 20, max: 1000)
+     * @returns {Promise<GetBundleDealListResponse>} The response containing a paginated list of bundle deals
+     *
+     * The response includes:
+     * - bundle_deal_list: List of bundle deals with full details
+     * - more: Boolean indicating if there are more pages
+     */
+    getBundleDealList(params?: GetBundleDealListParams): Promise<GetBundleDealListResponse>;
+    /**
+     * Update an existing bundle deal activity
+     * @param {UpdateBundleDealParams} params - Parameters for updating a bundle deal
+     * @returns {Promise<UpdateBundleDealResponse>} The response containing the updated bundle deal information
+     *
+     * Note: For ongoing bundle deals, update capabilities may be limited.
+     * Only certain fields can be modified depending on the bundle deal status.
+     */
+    updateBundleDeal(params: UpdateBundleDealParams): Promise<UpdateBundleDealResponse>;
+    /**
+     * Update items in an existing bundle deal activity
+     * @param {UpdateBundleDealItemParams} params - Parameters for updating bundle deal items
+     * @returns {Promise<UpdateBundleDealItemResponse>} The response containing lists of successful and failed updates
+     *
+     * The response includes:
+     * - success_list: Array of item IDs that were successfully updated
+     * - failed_list: Array of items that failed to be updated with error details
+     */
+    updateBundleDealItem(params: UpdateBundleDealItemParams): Promise<UpdateBundleDealItemResponse>;
+}

package/lib/managers/bundle-deal.manager.js

@@ -0,0 +1,178 @@
+import { BaseManager } from "./base.manager.js";
+import { ShopeeFetch } from "../fetch.js";
+export class BundleDealManager extends BaseManager {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Create a new bundle deal activity
+     * @param {AddBundleDealParams} params - Parameters for creating a new bundle deal
+     * @returns {Promise<AddBundleDealResponse>} The response containing the created bundle deal ID
+     *
+     * Note: A maximum of 1000 bundle deals can be created.
+     * The bundle deal must follow the pricing rules based on rule_type.
+     */
+    async addBundleDeal(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/bundle_deal/add_bundle_deal", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Add items to an existing bundle deal activity
+     * @param {AddBundleDealItemParams} params - Parameters for adding items to a bundle deal
+     * @returns {Promise<AddBundleDealItemResponse>} The response containing lists of successful and failed items
+     *
+     * The response includes:
+     * - success_list: Array of item IDs that were successfully added
+     * - failed_list: Array of items that failed to be added with error details
+     */
+    async addBundleDealItem(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/bundle_deal/add_bundle_deal_item", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Delete an existing bundle deal activity
+     * @param {DeleteBundleDealParams} params - Parameters for deleting a bundle deal
+     * @returns {Promise<DeleteBundleDealResponse>} The response containing the deleted bundle deal ID
+     *
+     * Note: Can only delete upcoming bundle deals that haven't started yet.
+     * Will return an error if attempting to delete a bundle deal that has already started.
+     */
+    async deleteBundleDeal(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/bundle_deal/delete_bundle_deal", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Delete items from an existing bundle deal activity
+     * @param {DeleteBundleDealItemParams} params - Parameters for deleting items from a bundle deal
+     * @returns {Promise<DeleteBundleDealItemResponse>} The response containing lists of successful and failed deletions
+     *
+     * The response includes:
+     * - success_list: Array of item IDs that were successfully deleted
+     * - failed_list: Array of items that failed to be deleted with error details
+     */
+    async deleteBundleDealItem(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/bundle_deal/delete_bundle_deal_item", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * End an ongoing bundle deal activity immediately
+     * @param {EndBundleDealParams} params - Parameters for ending a bundle deal
+     * @returns {Promise<EndBundleDealResponse>} The response containing the ended bundle deal ID
+     *
+     * Note: Can only end bundle deals that are currently ongoing/active.
+     * Will return an error if attempting to end an upcoming or expired bundle deal.
+     */
+    async endBundleDeal(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/bundle_deal/end_bundle_deal", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Get detailed information about a bundle deal activity
+     * @param {GetBundleDealParams} params - Parameters for getting bundle deal details
+     * @returns {Promise<GetBundleDealResponse>} The response containing comprehensive bundle deal information
+     *
+     * The response includes:
+     * - Basic bundle deal details (ID, name, timing, etc.)
+     * - Bundle deal rule configuration (type, pricing, min amount, etc.)
+     * - Purchase limits
+     * - Additional tiers if configured
+     */
+    async getBundleDeal(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/bundle_deal/get_bundle_deal", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Get the list of items in a bundle deal
+     * @param {GetBundleDealItemParams} params - Parameters for getting bundle deal items
+     * @returns {Promise<GetBundleDealItemResponse>} The response containing the list of item IDs
+     *
+     * The response includes:
+     * - item_list: Array of item IDs that are part of the bundle deal
+     */
+    async getBundleDealItem(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/bundle_deal/get_bundle_deal_item", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Get a list of bundle deal activities with pagination
+     * @param {GetBundleDealListParams} params - Parameters for retrieving bundle deal list
+     * @param {BundleDealTimeStatus} [params.time_status] - Filter by bundle deal status (default: ALL)
+     * @param {number} [params.page_no] - Page number to retrieve (default: 1)
+     * @param {number} [params.page_size] - Number of items per page (default: 20, max: 1000)
+     * @returns {Promise<GetBundleDealListResponse>} The response containing a paginated list of bundle deals
+     *
+     * The response includes:
+     * - bundle_deal_list: List of bundle deals with full details
+     * - more: Boolean indicating if there are more pages
+     */
+    async getBundleDealList(params = {}) {
+        const response = await ShopeeFetch.fetch(this.config, "/bundle_deal/get_bundle_deal_list", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Update an existing bundle deal activity
+     * @param {UpdateBundleDealParams} params - Parameters for updating a bundle deal
+     * @returns {Promise<UpdateBundleDealResponse>} The response containing the updated bundle deal information
+     *
+     * Note: For ongoing bundle deals, update capabilities may be limited.
+     * Only certain fields can be modified depending on the bundle deal status.
+     */
+    async updateBundleDeal(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/bundle_deal/update_bundle_deal", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Update items in an existing bundle deal activity
+     * @param {UpdateBundleDealItemParams} params - Parameters for updating bundle deal items
+     * @returns {Promise<UpdateBundleDealItemResponse>} The response containing lists of successful and failed updates
+     *
+     * The response includes:
+     * - success_list: Array of item IDs that were successfully updated
+     * - failed_list: Array of items that failed to be updated with error details
+     */
+    async updateBundleDealItem(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/bundle_deal/update_bundle_deal_item", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+}
+//# sourceMappingURL=bundle-deal.manager.js.map

package/lib/managers/bundle-deal.manager.js.map

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

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

@@ -0,0 +1,102 @@
+import { ShopeeConfig } from "../sdk.js";
+import { BaseManager } from "./base.manager.js";
+import { AddDiscountParams, AddDiscountResponse, AddDiscountItemParams, AddDiscountItemResponse, DeleteDiscountParams, DeleteDiscountResponse, DeleteDiscountItemParams, DeleteDiscountItemResponse, EndDiscountParams, EndDiscountResponse, GetDiscountParams, GetDiscountResponse, GetDiscountListParams, GetDiscountListResponse, UpdateDiscountParams, UpdateDiscountResponse, UpdateDiscountItemParams, UpdateDiscountItemResponse } from "../schemas/discount.js";
+export declare class DiscountManager extends BaseManager {
+    constructor(config: ShopeeConfig);
+    /**
+     * Add a new shop discount activity
+     * @param {AddDiscountParams} params - Parameters for creating a new discount
+     * @returns {Promise<AddDiscountResponse>} The response containing the created discount ID
+     *
+     * Note: The start time must be 1 hour later than current time.
+     * The end time must be 1 hour later than start time, and the discount period must be less than 180 days.
+     */
+    addDiscount(params: AddDiscountParams): Promise<AddDiscountResponse>;
+    /**
+     * Add items to an existing discount activity
+     * @param {AddDiscountItemParams} params - Parameters for adding items to a discount
+     * @returns {Promise<AddDiscountItemResponse>} The response containing the count of added items and any errors
+     *
+     * The response includes:
+     * - discount_id: The ID of the discount activity
+     * - count: Number of items successfully added
+     * - error_list: List of items that failed to be added with error details
+     * - warning: Warning message if any
+     */
+    addDiscountItem(params: AddDiscountItemParams): Promise<AddDiscountItemResponse>;
+    /**
+     * Delete an existing discount activity
+     * @param {DeleteDiscountParams} params - Parameters for deleting a discount
+     * @returns {Promise<DeleteDiscountResponse>} The response containing the deleted discount ID and modification time
+     *
+     * Note: Can only delete upcoming discounts that haven't started yet.
+     * Will return an error if attempting to delete a discount that has already started.
+     */
+    deleteDiscount(params: DeleteDiscountParams): Promise<DeleteDiscountResponse>;
+    /**
+     * Delete items from an existing discount activity
+     * @param {DeleteDiscountItemParams} params - Parameters for deleting items from a discount
+     * @returns {Promise<DeleteDiscountItemResponse>} The response containing the discount ID and any errors
+     *
+     * The response includes:
+     * - discount_id: The ID of the discount activity
+     * - error_list: List of items that failed to be deleted with error details
+     */
+    deleteDiscountItem(params: DeleteDiscountItemParams): Promise<DeleteDiscountItemResponse>;
+    /**
+     * End an ongoing discount activity immediately
+     * @param {EndDiscountParams} params - Parameters for ending a discount
+     * @returns {Promise<EndDiscountResponse>} The response containing the ended discount ID and modification time
+     *
+     * Note: Can only end discounts that are currently ongoing/active.
+     * Will return an error if attempting to end an upcoming or expired discount.
+     */
+    endDiscount(params: EndDiscountParams): Promise<EndDiscountResponse>;
+    /**
+     * Get detailed information about a discount activity
+     * @param {GetDiscountParams} params - Parameters for getting discount details
+     * @returns {Promise<GetDiscountResponse>} The response containing comprehensive discount information
+     *
+     * The response includes:
+     * - Basic discount details (ID, name, status, timing, etc.)
+     * - Item list with detailed pricing information (original price, promotion price, stock, etc.)
+     * - For items with variations: detailed model information
+     * - Purchase limits for each item
+     * - Pagination info (more: boolean indicating if there are more pages)
+     */
+    getDiscount(params: GetDiscountParams): Promise<GetDiscountResponse>;
+    /**
+     * Get a list of discount activities with pagination
+     * @param {GetDiscountListParams} params - Parameters for retrieving discount list
+     * @param {DiscountStatus} params.discount_status - Filter by discount status (UPCOMING, ONGOING, EXPIRED, or ALL)
+     * @param {number} [params.page_no] - Page number to retrieve (default: 1)
+     * @param {number} [params.page_size] - Number of items per page (default: 100, max: 100)
+     * @returns {Promise<GetDiscountListResponse>} The response containing a paginated list of discounts
+     *
+     * The response includes:
+     * - Pagination information (more: boolean indicating if there are more pages)
+     * - A list of discounts with basic details such as ID, name, status, start/end time, and source
+     */
+    getDiscountList(params: GetDiscountListParams): Promise<GetDiscountListResponse>;
+    /**
+     * Update an existing discount activity
+     * @param {UpdateDiscountParams} params - Parameters for updating a discount
+     * @returns {Promise<UpdateDiscountResponse>} The response containing the updated discount ID and modification time
+     *
+     * Note: For ongoing discounts, update capabilities may be limited.
+     * Only certain fields can be modified depending on the discount status.
+     */
+    updateDiscount(params: UpdateDiscountParams): Promise<UpdateDiscountResponse>;
+    /**
+     * Update items in an existing discount activity
+     * @param {UpdateDiscountItemParams} params - Parameters for updating discount items
+     * @returns {Promise<UpdateDiscountItemResponse>} The response containing the count of updated items and any errors
+     *
+     * The response includes:
+     * - discount_id: The ID of the discount activity
+     * - count: Number of items successfully updated
+     * - error_list: List of items that failed to be updated with error details
+     * - warning: Warning message if any
+     */
+    updateDiscountItem(params: UpdateDiscountItemParams): Promise<UpdateDiscountItemResponse>;
+}

package/lib/managers/discount.manager.js

@@ -0,0 +1,167 @@
+import { BaseManager } from "./base.manager.js";
+import { ShopeeFetch } from "../fetch.js";
+export class DiscountManager extends BaseManager {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Add a new shop discount activity
+     * @param {AddDiscountParams} params - Parameters for creating a new discount
+     * @returns {Promise<AddDiscountResponse>} The response containing the created discount ID
+     *
+     * Note: The start time must be 1 hour later than current time.
+     * The end time must be 1 hour later than start time, and the discount period must be less than 180 days.
+     */
+    async addDiscount(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/discount/add_discount", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Add items to an existing discount activity
+     * @param {AddDiscountItemParams} params - Parameters for adding items to a discount
+     * @returns {Promise<AddDiscountItemResponse>} The response containing the count of added items and any errors
+     *
+     * The response includes:
+     * - discount_id: The ID of the discount activity
+     * - count: Number of items successfully added
+     * - error_list: List of items that failed to be added with error details
+     * - warning: Warning message if any
+     */
+    async addDiscountItem(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/discount/add_discount_item", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Delete an existing discount activity
+     * @param {DeleteDiscountParams} params - Parameters for deleting a discount
+     * @returns {Promise<DeleteDiscountResponse>} The response containing the deleted discount ID and modification time
+     *
+     * Note: Can only delete upcoming discounts that haven't started yet.
+     * Will return an error if attempting to delete a discount that has already started.
+     */
+    async deleteDiscount(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/discount/delete_discount", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Delete items from an existing discount activity
+     * @param {DeleteDiscountItemParams} params - Parameters for deleting items from a discount
+     * @returns {Promise<DeleteDiscountItemResponse>} The response containing the discount ID and any errors
+     *
+     * The response includes:
+     * - discount_id: The ID of the discount activity
+     * - error_list: List of items that failed to be deleted with error details
+     */
+    async deleteDiscountItem(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/discount/delete_discount_item", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * End an ongoing discount activity immediately
+     * @param {EndDiscountParams} params - Parameters for ending a discount
+     * @returns {Promise<EndDiscountResponse>} The response containing the ended discount ID and modification time
+     *
+     * Note: Can only end discounts that are currently ongoing/active.
+     * Will return an error if attempting to end an upcoming or expired discount.
+     */
+    async endDiscount(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/discount/end_discount", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Get detailed information about a discount activity
+     * @param {GetDiscountParams} params - Parameters for getting discount details
+     * @returns {Promise<GetDiscountResponse>} The response containing comprehensive discount information
+     *
+     * The response includes:
+     * - Basic discount details (ID, name, status, timing, etc.)
+     * - Item list with detailed pricing information (original price, promotion price, stock, etc.)
+     * - For items with variations: detailed model information
+     * - Purchase limits for each item
+     * - Pagination info (more: boolean indicating if there are more pages)
+     */
+    async getDiscount(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/discount/get_discount", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Get a list of discount activities with pagination
+     * @param {GetDiscountListParams} params - Parameters for retrieving discount list
+     * @param {DiscountStatus} params.discount_status - Filter by discount status (UPCOMING, ONGOING, EXPIRED, or ALL)
+     * @param {number} [params.page_no] - Page number to retrieve (default: 1)
+     * @param {number} [params.page_size] - Number of items per page (default: 100, max: 100)
+     * @returns {Promise<GetDiscountListResponse>} The response containing a paginated list of discounts
+     *
+     * The response includes:
+     * - Pagination information (more: boolean indicating if there are more pages)
+     * - A list of discounts with basic details such as ID, name, status, start/end time, and source
+     */
+    async getDiscountList(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/discount/get_discount_list", {
+            method: "GET",
+            auth: true,
+            params,
+        });
+        return response;
+    }
+    /**
+     * Update an existing discount activity
+     * @param {UpdateDiscountParams} params - Parameters for updating a discount
+     * @returns {Promise<UpdateDiscountResponse>} The response containing the updated discount ID and modification time
+     *
+     * Note: For ongoing discounts, update capabilities may be limited.
+     * Only certain fields can be modified depending on the discount status.
+     */
+    async updateDiscount(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/discount/update_discount", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Update items in an existing discount activity
+     * @param {UpdateDiscountItemParams} params - Parameters for updating discount items
+     * @returns {Promise<UpdateDiscountItemResponse>} The response containing the count of updated items and any errors
+     *
+     * The response includes:
+     * - discount_id: The ID of the discount activity
+     * - count: Number of items successfully updated
+     * - error_list: List of items that failed to be updated with error details
+     * - warning: Warning message if any
+     */
+    async updateDiscountItem(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/discount/update_discount_item", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+}
+//# sourceMappingURL=discount.manager.js.map

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

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