@congminh1254/shopee-sdk 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Minh Nguyen Cong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# Shopee SDK
+
+A TypeScript SDK for interacting with the Shopee Open API, maintained by the community.
+
+## Installation
+
+```bash
+npm install shopee-sdk
+```
+
+## Usage
+
+```typescript
+import { ShopeeClient } from 'shopee-sdk';
+
+// Initialize the client
+const client = new ShopeeClient({
+  partner_id: 123456,
+  partner_key: 'your-partner-key',
+  base_url: 'https://partner.test-stable.shopeemobile.com', // For sandbox
+  // base_url: 'https://partner.shopeemobile.com', // For production
+});
+
+// Authenticate (if working with shop-level APIs)
+await client.auth.getToken({
+  code: 'authorization-code',
+  shop_id: 123456,
+});
+
+// Example: Get product list
+const products = await client.product.getItemList({
+  offset: 0,
+  page_size: 10,
+});
+
+// Example: Add a voucher
+const voucher = await client.voucher.addVoucher({
+  voucher_name: "Special Discount",
+  voucher_code: "SAVE10",
+  start_time: Math.floor(Date.now() / 1000),
+  end_time: Math.floor(Date.now() / 1000) + 7 * 24 * 60 * 60, // 7 days
+  voucher_type: 1, // shop voucher
+  reward_type: 1, // fixed amount
+  usage_quantity: 100,
+  min_basket_price: 20,
+  discount_amount: 10
+});
+
+// Example: Get lost push messages (partner-level API, no auth required)
+const lostMessages = await client.push.getLostPushMessage();
+```
+
+## Features
+
+- TypeScript support with full type definitions
+- Support for all Shopee Open API endpoints
+- Authentication flow helpers
+- Automatic token refresh
+
+## Contributing
+
+We use [Conventional Commits](https://www.conventionalcommits.org/) for commit messages to automate versioning and release notes.
+
+Examples of commit messages:
+
+- `feat: add support for logistics API` - Minor version bump
+- `fix: correct error handling in order API` - Patch version bump
+- `docs: update API documentation` - No version bump
+- `feat!: rename parameters in product API` or `feat: rename parameters in product API BREAKING CHANGE: ...` - Major version bump
+
+## Release Process
+
+This project uses [Release Please](https://github.com/googleapis/release-please) to automate version management and releases.
+
+The release process follows these steps:
+1. Commits to the main branch are automatically analyzed
+2. When conventional commit messages are detected, Release Please creates or updates a release PR
+3. When the release PR is merged:
+   - A new GitHub tag and release is created
+   - The package is automatically published to npm
+   - The CHANGELOG.md is updated with the release notes
+
+## License
+
+MIT

package/lib/errors.d.ts

@@ -0,0 +1,8 @@
+export declare class ShopeeSdkError extends Error {
+    constructor(message: string);
+}
+export declare class ShopeeApiError extends Error {
+    readonly status: number;
+    readonly data: unknown;
+    constructor(status: number, data: unknown);
+}

package/lib/errors.js

@@ -0,0 +1,15 @@
+export class ShopeeSdkError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ShopeeSdkError';
+    }
+}
+export class ShopeeApiError extends Error {
+    constructor(status, data) {
+        super(`API Error: ${status} - ${JSON.stringify(data)}`);
+        this.name = 'ShopeeApiError';
+        this.status = status;
+        this.data = data;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IAIvC,YAAY,MAAc,EAAE,IAAa;QACvC,KAAK,CAAC,cAAc,MAAM,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/lib/fetch.d.ts

@@ -0,0 +1,5 @@
+import { ShopeeConfig } from './sdk.js';
+import { FetchOptions } from './schemas/fetch.js';
+export declare class ShopeeFetch {
+    static fetch<T>(config: ShopeeConfig, path: string, options?: FetchOptions): Promise<T>;
+}

package/lib/fetch.js

@@ -0,0 +1,105 @@
+import fetch, { Headers } from 'node-fetch';
+import { ShopeeApiError, ShopeeSdkError } from './errors.js';
+import { generateSignature } from './utils/signature.js';
+export class ShopeeFetch {
+    static async fetch(config, path, options = {}) {
+        const { method = 'GET', params = {}, body, ...restOptions } = options;
+        const url = new URL(`${config.base_url}${path}`);
+        // Add required parameters
+        const timestamp = Math.floor(Date.now() / 1000);
+        let signature = generateSignature(config.partner_key, [
+            config.partner_id.toString(),
+            url.pathname,
+            timestamp.toString(),
+        ]);
+        // Add query parameters
+        Object.keys(params).forEach((key) => (params[key] === undefined ? delete params[key] : {}));
+        const allParams = {
+            partner_id: config.partner_id,
+            timestamp,
+            ...params,
+        };
+        let authParams = {};
+        if (options.auth) {
+            const token = await config.sdk?.getAuthToken();
+            if (!token) {
+                throw new ShopeeSdkError('No access token found');
+            }
+            authParams = {
+                access_token: token?.access_token,
+                shop_id: token?.shop_id,
+            };
+            signature = generateSignature(config.partner_key, [
+                config.partner_id.toString(),
+                url.pathname,
+                timestamp.toString(),
+                token?.access_token,
+                token?.shop_id.toString(),
+            ]);
+        }
+        Object.entries({ ...allParams, ...authParams, sign: signature }).forEach(([key, value]) => {
+            if (Array.isArray(value)) {
+                value.forEach(item => {
+                    url.searchParams.append(key, String(item));
+                });
+            }
+            else {
+                url.searchParams.append(key, String(value));
+            }
+        });
+        // Prepare headers
+        const headers = new Headers();
+        headers.set('Content-Type', 'application/json');
+        if (options.headers) {
+            Object.entries(options.headers).forEach(([key, value]) => {
+                headers.set(key, value);
+            });
+        }
+        // Prepare fetch options
+        const requestOptions = {
+            method,
+            headers: headers,
+            body: body ? JSON.stringify(body) : undefined,
+        };
+        try {
+            const response = await fetch(url.toString(), requestOptions);
+            const responseType = response.headers.get('Content-Type');
+            const responseData = responseType?.indexOf('application/json') !== -1
+                ? await response.json()
+                : await response.text();
+            if (responseType?.indexOf('application/json') !== -1) {
+                if (responseData.error) {
+                    // Handle invalid access token error
+                    if (responseData.error === 'invalid_acceess_token' && options.auth) {
+                        try {
+                            // Attempt to refresh the access token
+                            await config.sdk?.refreshToken();
+                            // Retry the request with the new token
+                            return this.fetch(config, path, options);
+                        }
+                        catch (refreshError) {
+                            // If refresh fails, throw the original error
+                            throw new ShopeeApiError(response.status, responseData);
+                        }
+                    }
+                    throw new ShopeeApiError(response.status, responseData);
+                }
+                const data = responseData;
+                return data;
+            }
+            throw new ShopeeSdkError(`Unknown response type: ${responseType}\n${responseData}`);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.name === 'FetchError') {
+                    // Network error
+                    throw new ShopeeSdkError(`Network error: ${error.message}`);
+                }
+                // Other errors
+                throw new ShopeeSdkError(`Unexpected error: ${error.message}`);
+            }
+            throw new ShopeeSdkError('Unknown error occurred');
+        }
+    }
+}
+//# sourceMappingURL=fetch.js.map

package/lib/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAyB,OAAO,EAAe,MAAM,YAAY,CAAC;AAGhF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,OAAO,WAAW;IACf,MAAM,CAAC,KAAK,CAAC,KAAK,CACvB,MAAoB,EACpB,IAAY,EACZ,UAAwB,EAAE;QAE1B,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,MAAM,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;QACtE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC,CAAC;QACjD,0BAA0B;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,IAAI,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE;YACpD,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE;YAC5B,GAAG,CAAC,QAAQ;YACZ,SAAS,CAAC,QAAQ,EAAE;SACrB,CAAC,CAAC;QAEH,uBAAuB;QACvB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5F,MAAM,SAAS,GAAG;YAChB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS;YACT,GAAG,MAAM;SACV,CAAC;QAEF,IAAI,UAAU,GAAG,EAAE,CAAC;QAEpB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE,CAAC;YAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,cAAc,CAAC,uBAAuB,CAAC,CAAC;YACpD,CAAC;YACD,UAAU,GAAG;gBACX,YAAY,EAAE,KAAK,EAAE,YAAY;gBACjC,OAAO,EAAE,KAAK,EAAE,OAAO;aACxB,CAAC;YACF,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,WAAW,EAAE;gBAChD,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE;gBAC5B,GAAG,CAAC,QAAQ;gBACZ,SAAS,CAAC,QAAQ,EAAE;gBACpB,KAAK,EAAE,YAAY;gBACnB,KAAK,EAAE,OAAQ,CAAC,QAAQ,EAAE;aAC3B,CAAC,CAAC;QACL,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,SAAS,EAAE,GAAG,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACxF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;oBACnB,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC7C,CAAC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,kBAAkB;QAClB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAChD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;gBACvD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAe,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,wBAAwB;QACxB,MAAM,cAAc,GAAgB;YAClC,MAAM;YACN,OAAO,EAAE,OAAiC;YAC1C,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAa,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,cAAc,CAAC,CAAC;YACvE,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC1D,MAAM,YAAY,GAChB,YAAY,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;gBAC9C,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE;gBACvB,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAE5B,IAAI,YAAY,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACrD,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;oBACvB,oCAAoC;oBACpC,IAAI,YAAY,CAAC,KAAK,KAAK,uBAAuB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;wBACnE,IAAI,CAAC;4BACH,sCAAsC;4BACtC,MAAM,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE,CAAC;4BACjC,uCAAuC;4BACvC,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;wBAC3C,CAAC;wBAAC,OAAO,YAAY,EAAE,CAAC;4BACtB,6CAA6C;4BAC7C,MAAM,IAAI,cAAc,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;wBAC1D,CAAC;oBACH,CAAC;oBACD,MAAM,IAAI,cAAc,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;gBAC1D,CAAC;gBAED,MAAM,IAAI,GAAG,YAAiB,CAAC;gBAC/B,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,IAAI,cAAc,CAAC,0BAA0B,YAAY,KAAK,YAAY,EAAE,CAAC,CAAC;QACtF,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBAChC,gBAAgB;oBAChB,MAAM,IAAI,cAAc,CAAC,kBAAkB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC9D,CAAC;gBACD,eAAe;gBACf,MAAM,IAAI,cAAc,CAAC,qBAAqB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,MAAM,IAAI,cAAc,CAAC,wBAAwB,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,53 @@
+import { ShopeeConfig } from "../sdk.js";
+import { BaseManager } from "./base.manager.js";
+import { GetTotalBalanceResponse, GetShopToggleInfoResponse, GetRecommendedKeywordListParams, GetRecommendedKeywordListResponse } from "../schemas/ads.js";
+export declare class AdsManager extends BaseManager {
+    constructor(config: ShopeeConfig);
+    /**
+     * Get seller's real-time total balance of ads credit
+     * @returns {Promise<GetTotalBalanceResponse>} Response containing the total balance and timestamp
+     *
+     * This API returns the seller's real-time total balance of their ads credit,
+     * including both paid credits and free credits.
+     *
+     * The response includes:
+     * - data_timestamp: The time when the balance snapshot was taken
+     * - total_balance: The total ads credit balance
+     *
+     * Note: This balance is real-time and represents the current available credit
+     * that can be used for advertising campaigns.
+     */
+    getTotalBalance(): Promise<GetTotalBalanceResponse>;
+    /**
+     * Get seller's toggle status information at the shop level
+     * @returns {Promise<GetShopToggleInfoResponse>} Response containing toggle statuses
+     *
+     * This API returns the seller's toggle status information indicating whether
+     * certain features are enabled or disabled at the shop level.
+     *
+     * The response includes:
+     * - data_timestamp: The time when the information was retrieved
+     * - auto_top_up: Whether automatic top-up is enabled (true) or disabled (false)
+     * - campaign_surge: Whether campaign surge is enabled (true) or disabled (false)
+     *
+     * These settings affect how ads campaigns are managed and funded.
+     */
+    getShopToggleInfo(): Promise<GetShopToggleInfoResponse>;
+    /**
+     * Get the list of recommended keywords for an item
+     * @param {GetRecommendedKeywordListParams} params Request parameters
+     * @param {number} params.item_id Shopee's unique identifier for an item
+     * @param {string} [params.input_keyword] The keyword seller typed in the manually add keyword window
+     * @returns {Promise<GetRecommendedKeywordListResponse>} Response containing recommended keywords
+     *
+     * This API is used to get the list of recommended keywords by item and optionally a search keyword.
+     *
+     * The response includes:
+     * - item_id: The item ID for which keywords are recommended
+     * - input_keyword: The keyword provided in the request (if any)
+     * - suggested_keywords: List of suggested keywords with quality score, search volume, and suggested bid
+     *
+     * Use this API to get keyword suggestions to improve item discoverability in search results.
+     */
+    getRecommendedKeywordList(params: GetRecommendedKeywordListParams): Promise<GetRecommendedKeywordListResponse>;
+}

package/lib/managers/ads.manager.js

@@ -0,0 +1,74 @@
+import { BaseManager } from "./base.manager.js";
+import { ShopeeFetch } from "../fetch.js";
+export class AdsManager extends BaseManager {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Get seller's real-time total balance of ads credit
+     * @returns {Promise<GetTotalBalanceResponse>} Response containing the total balance and timestamp
+     *
+     * This API returns the seller's real-time total balance of their ads credit,
+     * including both paid credits and free credits.
+     *
+     * The response includes:
+     * - data_timestamp: The time when the balance snapshot was taken
+     * - total_balance: The total ads credit balance
+     *
+     * Note: This balance is real-time and represents the current available credit
+     * that can be used for advertising campaigns.
+     */
+    async getTotalBalance() {
+        const response = await ShopeeFetch.fetch(this.config, '/ads/get_total_balance', {
+            method: 'GET',
+            auth: true,
+        });
+        return response;
+    }
+    /**
+     * Get seller's toggle status information at the shop level
+     * @returns {Promise<GetShopToggleInfoResponse>} Response containing toggle statuses
+     *
+     * This API returns the seller's toggle status information indicating whether
+     * certain features are enabled or disabled at the shop level.
+     *
+     * The response includes:
+     * - data_timestamp: The time when the information was retrieved
+     * - auto_top_up: Whether automatic top-up is enabled (true) or disabled (false)
+     * - campaign_surge: Whether campaign surge is enabled (true) or disabled (false)
+     *
+     * These settings affect how ads campaigns are managed and funded.
+     */
+    async getShopToggleInfo() {
+        const response = await ShopeeFetch.fetch(this.config, '/ads/get_shop_toggle_info', {
+            method: 'GET',
+            auth: true,
+        });
+        return response;
+    }
+    /**
+     * Get the list of recommended keywords for an item
+     * @param {GetRecommendedKeywordListParams} params Request parameters
+     * @param {number} params.item_id Shopee's unique identifier for an item
+     * @param {string} [params.input_keyword] The keyword seller typed in the manually add keyword window
+     * @returns {Promise<GetRecommendedKeywordListResponse>} Response containing recommended keywords
+     *
+     * This API is used to get the list of recommended keywords by item and optionally a search keyword.
+     *
+     * The response includes:
+     * - item_id: The item ID for which keywords are recommended
+     * - input_keyword: The keyword provided in the request (if any)
+     * - suggested_keywords: List of suggested keywords with quality score, search volume, and suggested bid
+     *
+     * Use this API to get keyword suggestions to improve item discoverability in search results.
+     */
+    async getRecommendedKeywordList(params) {
+        const response = await ShopeeFetch.fetch(this.config, '/ads/get_recommended_keyword_list', {
+            method: 'GET',
+            auth: true,
+            params,
+        });
+        return response;
+    }
+}
+//# sourceMappingURL=ads.manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ads.manager.js","sourceRoot":"","sources":["../../src/managers/ads.manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,UAAW,SAAQ,WAAW;IACvC,YAAY,MAAoB;QAC9B,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,eAAe;QACnB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,wBAAwB,EACxB;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI;SACX,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,iBAAiB;QACrB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,2BAA2B,EAC3B;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI;SACX,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,yBAAyB,CAAC,MAAuC;QACrE,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACtC,IAAI,CAAC,MAAM,EACX,mCAAmC,EACnC;YACE,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI;YACV,MAAM;SACP,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC;IAClB,CAAC;CACJ"}

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

@@ -0,0 +1,9 @@
+import { ShopeeConfig } from '../sdk.js';
+import { AccessToken } from '../schemas/access-token.js';
+import { BaseManager } from './base.manager.js';
+export declare class AuthManager extends BaseManager {
+    constructor(config: ShopeeConfig);
+    getAccessToken(code: string, shopId?: number, mainAccountId?: number): Promise<AccessToken>;
+    getAccessTokenByResendCode(code: string): Promise<AccessToken>;
+    getRefreshToken(refreshToken: string, shopId?: number, merchantId?: number): Promise<AccessToken>;
+}

package/lib/managers/auth.manager.js

@@ -0,0 +1,58 @@
+import { ShopeeFetch } from '../fetch.js';
+import { BaseManager } from './base.manager.js';
+export class AuthManager extends BaseManager {
+    constructor(config) {
+        super(config);
+    }
+    async getAccessToken(code, shopId, mainAccountId) {
+        const body = {
+            code,
+            partner_id: this.config.partner_id,
+        };
+        if (shopId) {
+            body.shop_id = shopId;
+        }
+        if (mainAccountId) {
+            body.main_account_id = mainAccountId;
+        }
+        const response = await ShopeeFetch.fetch(this.config, '/auth/token/get', {
+            method: 'POST',
+            body,
+        });
+        return {
+            ...response,
+            shop_id: shopId
+        };
+    }
+    async getAccessTokenByResendCode(code) {
+        const body = {
+            resend_code: code,
+        };
+        const response = await ShopeeFetch.fetch(this.config, '/public/get_token_by_resend_code', {
+            method: 'POST',
+            body
+        });
+        return response;
+    }
+    async getRefreshToken(refreshToken, shopId, merchantId) {
+        const body = {
+            partner_id: this.config.partner_id,
+            refresh_token: refreshToken,
+        };
+        if (shopId) {
+            body.shop_id = shopId;
+        }
+        if (merchantId) {
+            body.merchant_id = merchantId;
+        }
+        const response = await ShopeeFetch.fetch(this.config, '/auth/access_token/get', {
+            method: 'POST',
+            body
+        });
+        return {
+            ...response,
+            shop_id: shopId
+        };
+    }
+}
+//# sourceMappingURL=auth.manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.manager.js","sourceRoot":"","sources":["../../src/managers/auth.manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C,YAAY,MAAoB;QAC9B,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAEM,KAAK,CAAC,cAAc,CACzB,IAAY,EACZ,MAAe,EACf,aAAsB;QAEtB,MAAM,IAAI,GAA8C;YACtD,IAAI;YACJ,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;SACnC,CAAC;QAEF,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACxB,CAAC;QAED,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC,eAAe,GAAG,aAAa,CAAC;QACvC,CAAC;QAED,MAAM,QAAQ,GAAgB,MAAM,WAAW,CAAC,KAAK,CAAc,IAAI,CAAC,MAAM,EAAE,iBAAiB,EAAE;YACjG,MAAM,EAAE,MAAM;YACd,IAAI;SACL,CAAC,CAAC;QAEH,OAAO;YACL,GAAG,QAAQ;YACX,OAAO,EAAE,MAAM;SAChB,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,0BAA0B,CAAC,IAAY;QAClD,MAAM,IAAI,GAA8C;YACtD,WAAW,EAAE,IAAI;SAClB,CAAC;QAEF,MAAM,QAAQ,GAAgB,MAAM,WAAW,CAAC,KAAK,CAAc,IAAI,CAAC,MAAM,EAAE,kCAAkC,EAAE;YAClH,MAAM,EAAE,MAAM;YACd,IAAI;SACL,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEM,KAAK,CAAC,eAAe,CAAC,YAAoB,EAAE,MAAe,EAAE,UAAmB;QACrF,MAAM,IAAI,GAA8C;YACtD,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;YAClC,aAAa,EAAE,YAAY;SAC5B,CAAC;QAEF,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACxB,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAChC,CAAC;QAED,MAAM,QAAQ,GAAgB,MAAM,WAAW,CAAC,KAAK,CAAc,IAAI,CAAC,MAAM,EAAE,wBAAwB,EAAE;YACxG,MAAM,EAAE,MAAM;YACd,IAAI;SACL,CAAC,CAAC;QAGH,OAAO;YACL,GAAG,QAAQ;YACX,OAAO,EAAE,MAAM;SAChB,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,5 @@
+import { ShopeeConfig } from '../sdk.js';
+export declare abstract class BaseManager {
+    protected config: ShopeeConfig;
+    constructor(config: ShopeeConfig);
+}

package/lib/managers/base.manager.js

@@ -0,0 +1,7 @@
+export class BaseManager {
+    constructor(config) {
+        this.config = config;
+        this.config = config;
+    }
+}
+//# sourceMappingURL=base.manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.manager.js","sourceRoot":"","sources":["../../src/managers/base.manager.ts"],"names":[],"mappings":"AAEA,MAAM,OAAgB,WAAW;IAC/B,YAAsB,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/lib/managers/index.d.ts

@@ -0,0 +1,10 @@
+export * from './auth.manager.js';
+export * from './base.manager.js';
+export * from './logistics.manager.js';
+export * from './order.manager.js';
+export * from './order.manager.js';
+export * from './product.manager.js';
+export * from './public.manager.js';
+export * from './push.manager.js';
+export * from './voucher.manager.js';
+export * from './ads.manager.js';

package/lib/managers/index.js

@@ -0,0 +1,11 @@
+export * from './auth.manager.js';
+export * from './base.manager.js';
+export * from './logistics.manager.js';
+export * from './order.manager.js';
+export * from './order.manager.js';
+export * from './product.manager.js';
+export * from './public.manager.js';
+export * from './push.manager.js';
+export * from './voucher.manager.js';
+export * from './ads.manager.js';
+//# sourceMappingURL=index.js.map

package/lib/managers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/managers/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

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

@@ -0,0 +1,33 @@
+import { ShopeeConfig } from "../sdk.js";
+import { BaseManager } from "./base.manager.js";
+import { GetTrackingInfoParams, GetTrackingInfoResponse } from "../schemas/logistics.js";
+export declare class LogisticsManager extends BaseManager {
+    constructor(config: ShopeeConfig);
+    /**
+     * Use this API to get the logistics tracking information of an order.
+     *
+     * @param params - Parameters for getting tracking information
+     * @param params.order_sn - Shopee's unique identifier for an order
+     * @param params.package_number - Shopee's unique identifier for the package under an order
+     *
+     * @returns A promise that resolves to the tracking info response containing:
+     * - order_sn: Order identifier
+     * - package_number: Package identifier
+     * - logistics_status: Current logistics status
+     * - tracking_info: Array of tracking events with:
+     *   - update_time: Time of status update
+     *   - description: Description of the tracking event
+     *   - logistics_status: Status code for the event
+     *
+     * @throws {Error} When the API request fails or returns an error:
+     * - logistics.error_param: Order allocation in progress
+     * - error_not_found: Wrong parameters
+     * - error_permission: No permission
+     * - error_server: System error
+     * - logistics.invalid_error: Order does not exist
+     * - logistics.error_status_limit: Invalid order status
+     * - logistics.package_not_exist: Package does not exist
+     * - logistics.package_number_not_exist: Package number required for split order
+     */
+    getTrackingInfo(params: GetTrackingInfoParams): Promise<GetTrackingInfoResponse>;
+}

package/lib/managers/logistics.manager.js

@@ -0,0 +1,42 @@
+import { BaseManager } from "./base.manager.js";
+import { ShopeeFetch } from "../fetch.js";
+export class LogisticsManager extends BaseManager {
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Use this API to get the logistics tracking information of an order.
+     *
+     * @param params - Parameters for getting tracking information
+     * @param params.order_sn - Shopee's unique identifier for an order
+     * @param params.package_number - Shopee's unique identifier for the package under an order
+     *
+     * @returns A promise that resolves to the tracking info response containing:
+     * - order_sn: Order identifier
+     * - package_number: Package identifier
+     * - logistics_status: Current logistics status
+     * - tracking_info: Array of tracking events with:
+     *   - update_time: Time of status update
+     *   - description: Description of the tracking event
+     *   - logistics_status: Status code for the event
+     *
+     * @throws {Error} When the API request fails or returns an error:
+     * - logistics.error_param: Order allocation in progress
+     * - error_not_found: Wrong parameters
+     * - error_permission: No permission
+     * - error_server: System error
+     * - logistics.invalid_error: Order does not exist
+     * - logistics.error_status_limit: Invalid order status
+     * - logistics.package_not_exist: Package does not exist
+     * - logistics.package_number_not_exist: Package number required for split order
+     */
+    async getTrackingInfo(params) {
+        const response = await ShopeeFetch.fetch(this.config, '/logistics/get_tracking_info', {
+            method: 'GET',
+            auth: true,
+            params,
+        });
+        return response;
+    }
+}
+//# sourceMappingURL=logistics.manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logistics.manager.js","sourceRoot":"","sources":["../../src/managers/logistics.manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAC7C,YAAY,MAAoB;QAC9B,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK,CAAC,eAAe,CAAC,MAA6B;QAC/C,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,CACpC,IAAI,CAAC,MAAM,EACX,8BAA8B,EAC9B;YACI,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI;YACV,MAAM;SACT,CACJ,CAAC;QAEF,OAAO,QAAQ,CAAC;IACpB,CAAC;CACJ"}