@congminh1254/shopee-sdk 0.10.0 → 1.0.0

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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"}

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

@@ -0,0 +1,115 @@
+import { ShopeeConfig } from "../sdk.js";
+import { BaseManager } from "./base.manager.js";
+import { QueryBrShopEnrollmentStatusParams, QueryBrShopEnrollmentStatusResponse, QueryBrShopBlockStatusParams, QueryBrShopBlockStatusResponse, QueryBrShopInvoiceErrorParams, QueryBrShopInvoiceErrorResponse, QueryBrSkuBlockStatusParams, QueryBrSkuBlockStatusResponse } from "../schemas/fbs.js";
+export declare class FbsManager extends BaseManager {
+    constructor(config: ShopeeConfig);
+    /**
+     * Check whether a given shop_id is eligible to enroll in the Brazil Fulfilled-by-Shopee (FBS) service.
+     * This API is for Brazil region only.
+     *
+     * @param params - Parameters for querying enrollment status (empty object)
+     *
+     * @returns A promise that resolves to the enrollment status response containing:
+     * - shop_id: Shopee's unique identifier for the shop
+     * - enrollment_status: 1=enable enrollment, 2=disable enrollment, 3=already enrollment
+     * - enable_enrollment_time: The time when the shop can enroll in FBS
+     *
+     * @throws {Error} When the API request fails or returns an error
+     *
+     * @example
+     * ```typescript
+     * const status = await sdk.fbs.queryBrShopEnrollmentStatus({});
+     * if (status.response.enrollment_status === 1) {
+     *   console.log('Shop can enroll in FBS');
+     * }
+     * ```
+     */
+    queryBrShopEnrollmentStatus(params?: QueryBrShopEnrollmentStatusParams): Promise<QueryBrShopEnrollmentStatusResponse>;
+    /**
+     * Check whether an FBS shop is blocked due to invoice-related issues.
+     * When blocked, the shop cannot create new Inbound Requests, and its warehouse
+     * inventory is restricted from being sold. This API is for Brazil region only.
+     *
+     * @param params - Parameters for querying shop block status (empty object)
+     *
+     * @returns A promise that resolves to the block status response containing:
+     * - shop_id: Shopee's unique identifier for the shop
+     * - is_block: Whether the shop is blocked
+     *
+     * @throws {Error} When the API request fails or returns an error
+     *
+     * @example
+     * ```typescript
+     * const status = await sdk.fbs.queryBrShopBlockStatus({});
+     * if (status.response.is_block) {
+     *   console.log('Shop is blocked due to invoice issues');
+     * }
+     * ```
+     */
+    queryBrShopBlockStatus(params?: QueryBrShopBlockStatusParams): Promise<QueryBrShopBlockStatusResponse>;
+    /**
+     * Get failed invoice issuance information for FBS-related processes.
+     * This covers Inbound Requests, RTS Requests, Sales Orders, and Move Transfer Orders.
+     * This API is for Brazil region only.
+     *
+     * @param params - Parameters for querying invoice errors
+     * @param params.page_no - Page number (default: 1)
+     * @param params.page_size - Page size, max: 100 (default: 10)
+     *
+     * @returns A promise that resolves to the invoice error response containing:
+     * - total: Total number of invoice errors
+     * - list: List of invoice errors with details including:
+     *   - biz_request_type: Type of business request (1=Inbound, 2=RTS, 3=Sales, 4=Move Transfer, 5=IA)
+     *   - biz_request_id: Business request ID
+     *   - fail_reason: Reason for invoice failure
+     *   - fail_type: 1=SKU tax info error, 2=seller tax info error
+     *   - invoice_deadline_time: Deadline to fix the issue
+     *   - shop_sku_list: List of SKUs with errors
+     *
+     * @throws {Error} When the API request fails or returns an error
+     *
+     * @example
+     * ```typescript
+     * const errors = await sdk.fbs.queryBrShopInvoiceError({
+     *   page_no: 1,
+     *   page_size: 20,
+     * });
+     *
+     * errors.response.list.forEach(error => {
+     *   console.log(`Request ID: ${error.biz_request_id}`);
+     *   console.log(`Failed reason: ${error.fail_reason}`);
+     * });
+     * ```
+     */
+    queryBrShopInvoiceError(params?: QueryBrShopInvoiceErrorParams): Promise<QueryBrShopInvoiceErrorResponse>;
+    /**
+     * Check whether an FBS product is blocked due to invoice-related issues.
+     * When blocked, the product cannot be included in new Inbound Requests, and its
+     * warehouse inventory is restricted from being sold. This API is for Brazil region only.
+     *
+     * @param params - Parameters for querying SKU block status
+     * @param params.shop_sku_id - Shop SKU ID in format "itemID_modelID"
+     *
+     * @returns A promise that resolves to the SKU block status response containing:
+     * - shop_sku_id: The queried SKU ID
+     * - is_block: Whether the SKU is blocked
+     * - shop_item_id: Item ID
+     * - shop_model_id: Model ID
+     * - shop_item_name: Item name
+     * - shop_model_name: Model name
+     *
+     * @throws {Error} When the API request fails or returns an error
+     *
+     * @example
+     * ```typescript
+     * const status = await sdk.fbs.queryBrSkuBlockStatus({
+     *   shop_sku_id: '123456_789012',
+     * });
+     *
+     * if (status.response.is_block) {
+     *   console.log(`SKU ${status.response.shop_item_name} is blocked`);
+     * }
+     * ```
+     */
+    queryBrSkuBlockStatus(params: QueryBrSkuBlockStatusParams): Promise<QueryBrSkuBlockStatusResponse>;
+}

package/lib/managers/fbs.manager.js

@@ -0,0 +1,145 @@
+import { BaseManager } from "./base.manager.js";
+import { ShopeeFetch } from "../fetch.js";
+export class FbsManager extends BaseManager {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Check whether a given shop_id is eligible to enroll in the Brazil Fulfilled-by-Shopee (FBS) service.
+     * This API is for Brazil region only.
+     *
+     * @param params - Parameters for querying enrollment status (empty object)
+     *
+     * @returns A promise that resolves to the enrollment status response containing:
+     * - shop_id: Shopee's unique identifier for the shop
+     * - enrollment_status: 1=enable enrollment, 2=disable enrollment, 3=already enrollment
+     * - enable_enrollment_time: The time when the shop can enroll in FBS
+     *
+     * @throws {Error} When the API request fails or returns an error
+     *
+     * @example
+     * ```typescript
+     * const status = await sdk.fbs.queryBrShopEnrollmentStatus({});
+     * if (status.response.enrollment_status === 1) {
+     *   console.log('Shop can enroll in FBS');
+     * }
+     * ```
+     */
+    async queryBrShopEnrollmentStatus(params = {}) {
+        const response = await ShopeeFetch.fetch(this.config, "/fbs/query_br_shop_enrollment_status", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Check whether an FBS shop is blocked due to invoice-related issues.
+     * When blocked, the shop cannot create new Inbound Requests, and its warehouse
+     * inventory is restricted from being sold. This API is for Brazil region only.
+     *
+     * @param params - Parameters for querying shop block status (empty object)
+     *
+     * @returns A promise that resolves to the block status response containing:
+     * - shop_id: Shopee's unique identifier for the shop
+     * - is_block: Whether the shop is blocked
+     *
+     * @throws {Error} When the API request fails or returns an error
+     *
+     * @example
+     * ```typescript
+     * const status = await sdk.fbs.queryBrShopBlockStatus({});
+     * if (status.response.is_block) {
+     *   console.log('Shop is blocked due to invoice issues');
+     * }
+     * ```
+     */
+    async queryBrShopBlockStatus(params = {}) {
+        const response = await ShopeeFetch.fetch(this.config, "/fbs/query_br_shop_block_status", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Get failed invoice issuance information for FBS-related processes.
+     * This covers Inbound Requests, RTS Requests, Sales Orders, and Move Transfer Orders.
+     * This API is for Brazil region only.
+     *
+     * @param params - Parameters for querying invoice errors
+     * @param params.page_no - Page number (default: 1)
+     * @param params.page_size - Page size, max: 100 (default: 10)
+     *
+     * @returns A promise that resolves to the invoice error response containing:
+     * - total: Total number of invoice errors
+     * - list: List of invoice errors with details including:
+     *   - biz_request_type: Type of business request (1=Inbound, 2=RTS, 3=Sales, 4=Move Transfer, 5=IA)
+     *   - biz_request_id: Business request ID
+     *   - fail_reason: Reason for invoice failure
+     *   - fail_type: 1=SKU tax info error, 2=seller tax info error
+     *   - invoice_deadline_time: Deadline to fix the issue
+     *   - shop_sku_list: List of SKUs with errors
+     *
+     * @throws {Error} When the API request fails or returns an error
+     *
+     * @example
+     * ```typescript
+     * const errors = await sdk.fbs.queryBrShopInvoiceError({
+     *   page_no: 1,
+     *   page_size: 20,
+     * });
+     *
+     * errors.response.list.forEach(error => {
+     *   console.log(`Request ID: ${error.biz_request_id}`);
+     *   console.log(`Failed reason: ${error.fail_reason}`);
+     * });
+     * ```
+     */
+    async queryBrShopInvoiceError(params = {}) {
+        const response = await ShopeeFetch.fetch(this.config, "/fbs/query_br_shop_invoice_error", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+    /**
+     * Check whether an FBS product is blocked due to invoice-related issues.
+     * When blocked, the product cannot be included in new Inbound Requests, and its
+     * warehouse inventory is restricted from being sold. This API is for Brazil region only.
+     *
+     * @param params - Parameters for querying SKU block status
+     * @param params.shop_sku_id - Shop SKU ID in format "itemID_modelID"
+     *
+     * @returns A promise that resolves to the SKU block status response containing:
+     * - shop_sku_id: The queried SKU ID
+     * - is_block: Whether the SKU is blocked
+     * - shop_item_id: Item ID
+     * - shop_model_id: Model ID
+     * - shop_item_name: Item name
+     * - shop_model_name: Model name
+     *
+     * @throws {Error} When the API request fails or returns an error
+     *
+     * @example
+     * ```typescript
+     * const status = await sdk.fbs.queryBrSkuBlockStatus({
+     *   shop_sku_id: '123456_789012',
+     * });
+     *
+     * if (status.response.is_block) {
+     *   console.log(`SKU ${status.response.shop_item_name} is blocked`);
+     * }
+     * ```
+     */
+    async queryBrSkuBlockStatus(params) {
+        const response = await ShopeeFetch.fetch(this.config, "/fbs/query_br_sku_block_status", {
+            method: "POST",
+            auth: true,
+            body: params,
+        });
+        return response;
+    }
+}
+//# sourceMappingURL=fbs.manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fbs.manager.js","sourceRoot":"","sources":["../../src/managers/fbs.manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAWhD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,UAAW,SAAQ,WAAW;IACzC,YAAY,MAAoB;QAC9B,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAK,CAAC,2BAA2B,CAC/B,SAA4C,EAAE;QAE9C,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,sCAAsC,EACtC;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM;SACb,CACF,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,KAAK,CAAC,sBAAsB,CAC1B,SAAuC,EAAE;QAEzC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,iCAAiC,EACjC;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM;SACb,CACF,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,KAAK,CAAC,uBAAuB,CAC3B,SAAwC,EAAE;QAE1C,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;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,KAAK,CAAC,qBAAqB,CACzB,MAAmC;QAEnC,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;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}