@teez-sdk/teez-b2c-api 1.0.0 → 2.0.0

package/README.md

@@ -1,7 +1,5 @@
 # @teez-sdk/teez-b2c-api
 
-[← Back to root](../../README.md)
-
 A typed TypeScript client for the Teez B2C API.
 
 ## Features

package/dist/index.cjs

@@ -74,14 +74,22 @@ const BannersApiListResponseSchema = zod_mini.array(BannersApiBannerItemSchema);
 * API for retrieving promotional and informational banners.
 */
 var BannersApi = class {
+	/**
+	* Initializes a new instance of the BannersApi.
+	*
+	* @param http HTTP client instance.
+	*/
 	constructor(http) {
 		this.http = http;
 	}
 	/**
 	* Retrieves a list of active banners.
+	*
+	* @example
+	* const banners = await client.banners.list();
 	*/
-	async list(params = {}) {
-		return await this.http.get({
+	list(params = {}) {
+		return this.http.get({
 			path: "/api/v3/banners",
 			params,
 			schema: BannersApiListResponseSchema
@@ -143,14 +151,22 @@ const CategoriesApiGetParentsResponseSchema = zod_mini.array(CategoriesApiGetPar
 * API for retrieving product category information.
 */
 var CategoriesApi = class {
+	/**
+	* Initializes a new instance of the CategoriesApi.
+	*
+	* @param http HTTP client instance.
+	*/
 	constructor(http) {
 		this.http = http;
 	}
 	/**
 	* Retrieves a list of all categories.
+	*
+	* @example
+	* const categories = await client.categories.list();
 	*/
-	async list(params = {}) {
-		return await this.http.get({
+	list(params = {}) {
+		return this.http.get({
 			path: "/categories",
 			params,
 			schema: CategoriesApiListResponseSchema
@@ -158,9 +174,14 @@ var CategoriesApi = class {
 	}
 	/**
 	* Retrieves detailed information about a specific category by its ID.
+	*
+	* @example
+	* const category = await client.categories.get({
+	*   categoryId: 1234
+	* });
 	*/
-	async get(params) {
-		return await this.http.get({
+	get(params) {
+		return this.http.get({
 			path: `/categories/${params.categoryId}`,
 			params,
 			schema: CategoriesApiGetResponseSchema
@@ -168,9 +189,14 @@ var CategoriesApi = class {
 	}
 	/**
 	* Retrieves parent categories for specific category IDs.
+	*
+	* @example
+	* const parents = await client.categories.getParents({
+	*   categoryId: [123, 456]
+	* });
 	*/
-	async getParents(params) {
-		return await this.http.get({
+	getParents(params) {
+		return this.http.get({
 			path: "/api/v1/categories/parents",
 			params,
 			schema: CategoriesApiGetParentsResponseSchema
@@ -313,14 +339,25 @@ const CollectionsApiGetResponseSchema = zod_mini.object({
 * API for retrieving curated collections of products.
 */
 var CollectionsApi = class {
+	/**
+	* Initializes a new instance of the CollectionsApi.
+	*
+	* @param http HTTP client instance.
+	*/
 	constructor(http) {
 		this.http = http;
 	}
 	/**
 	* Retrieves a list of SKUs belonging to a specific collection with pagination and sorting.
+	*
+	* @example
+	* const skus = await client.collections.getSkus({
+	*   collectionId: 123,
+	*   pageSize: 10
+	* });
 	*/
-	async getSkus(params) {
-		return await this.http.get({
+	getSkus(params) {
+		return this.http.get({
 			path: "/api/v2/collections/skus",
 			params,
 			schema: CollectionsApiGetSkusResponseSchema
@@ -328,9 +365,12 @@ var CollectionsApi = class {
 	}
 	/**
 	* Retrieves a list of all collections.
+	*
+	* @example
+	* const collections = await client.collections.list();
 	*/
-	async list(params = {}) {
-		return await this.http.get({
+	list(params = {}) {
+		return this.http.get({
 			path: "/collections",
 			params,
 			schema: CollectionsApiListResponseSchema
@@ -338,9 +378,14 @@ var CollectionsApi = class {
 	}
 	/**
 	* Retrieves detailed information about a specific collection by its ID.
+	*
+	* @example
+	* const collection = await client.collections.get({
+	*   collectionId: 123
+	* });
 	*/
-	async get(params) {
-		return await this.http.get({
+	get(params) {
+		return this.http.get({
 			path: `/collections/${params.collectionId}`,
 			params,
 			schema: CollectionsApiGetResponseSchema
@@ -368,14 +413,22 @@ const FeatureFlagsApiListResponseSchema = zod_mini.array(FeatureFlagsApiItemSche
 * API for retrieving feature flags configuration.
 */
 var FeatureFlagsApi = class {
+	/**
+	* Initializes a new instance of the FeatureFlagsApi.
+	*
+	* @param http HTTP client instance.
+	*/
 	constructor(http) {
 		this.http = http;
 	}
 	/**
 	* Retrieves all active feature flags.
+	*
+	* @example
+	* const flags = await client.featureFlags.list();
 	*/
-	async list(params = {}) {
-		return await this.http.get({
+	list(params = {}) {
+		return this.http.get({
 			path: "/api/v1/feature-flags",
 			params,
 			schema: FeatureFlagsApiListResponseSchema
@@ -491,14 +544,22 @@ const ProductsApiListResponseSchema = zod_mini.object({
 * API for retrieving product listings, details, and reviews.
 */
 var ProductsApi = class {
+	/**
+	* Initializes a new instance of the ProductsApi.
+	*
+	* @param http HTTP client instance.
+	*/
 	constructor(http) {
 		this.http = http;
 	}
 	/**
 	* Retrieves available sorting options for product lists.
+	*
+	* @example
+	* const sortOptions = await client.products.getSortOptions();
 	*/
-	async getSortOptions(params = {}) {
-		return await this.http.get({
+	getSortOptions(params = {}) {
+		return this.http.get({
 			path: "/api/product/sort-options",
 			params,
 			schema: ProductsApiGetSortOptionsResponseSchema
@@ -506,9 +567,15 @@ var ProductsApi = class {
 	}
 	/**
 	* Retrieves a list of products with optional filtering and pagination.
+	*
+	* @example
+	* const products = await client.products.list({
+	*   pageSize: 20,
+	*   pageNumber: 1
+	* });
 	*/
-	async list(params = {}) {
-		return await this.http.get({
+	list(params = {}) {
+		return this.http.get({
 			path: "/api/v2/product",
 			params,
 			schema: ProductsApiListResponseSchema
@@ -516,9 +583,14 @@ var ProductsApi = class {
 	}
 	/**
 	* Retrieves reviews for a specific product.
+	*
+	* @example
+	* const reviews = await client.products.getReviews({
+	*   productId: 12345
+	* });
 	*/
-	async getReviews(params) {
-		return await this.http.get({
+	getReviews(params) {
+		return this.http.get({
 			path: `/api/v1/product/${params.productId}/review`,
 			params,
 			schema: ProductsApiGetReviewsResponseSchema
@@ -550,14 +622,22 @@ const PromoApiListResponseSchema = zod_mini.array(PromoApiItemSchema);
 * API for retrieving active promotions.
 */
 var PromoApi = class {
+	/**
+	* Initializes a new instance of the PromoApi.
+	*
+	* @param http HTTP client instance.
+	*/
 	constructor(http) {
 		this.http = http;
 	}
 	/**
 	* Retrieves a list of all active promotions.
+	*
+	* @example
+	* const promos = await client.promo.list();
 	*/
-	async list(params = {}) {
-		return await this.http.get({
+	list(params = {}) {
+		return this.http.get({
 			path: "/api/promo",
 			params,
 			schema: PromoApiListResponseSchema
@@ -674,14 +754,24 @@ const ShopsApiGetProductsResponseSchema = zod_mini.object({
 * API for interacting with shop-related endpoints.
 */
 var ShopsApi = class {
+	/**
+	* Initializes a new instance of the ShopsApi.
+	*
+	* @param http HTTP client instance.
+	*/
 	constructor(http) {
 		this.http = http;
 	}
 	/**
 	* Retrieves details of a specific shop.
+	*
+	* @example
+	* const shop = await client.shops.get({
+	*   shopId: 123
+	* });
 	*/
-	async get(params) {
-		return await this.http.get({
+	get(params) {
+		return this.http.get({
 			path: `/api/v1/shops/${params.shopId}`,
 			params,
 			schema: ShopsApiGetResponseSchema
@@ -689,9 +779,12 @@ var ShopsApi = class {
 	}
 	/**
 	* Retrieves monobrand shop details.
+	*
+	* @example
+	* const monobrand = await client.shops.getMonobrand();
 	*/
-	async getMonobrand(params = {}) {
-		return await this.http.get({
+	getMonobrand(params = {}) {
+		return this.http.get({
 			path: "/api/v1/shops/monobrand",
 			params,
 			schema: ShopsApiGetMonobrandResponseSchema
@@ -699,9 +792,15 @@ var ShopsApi = class {
 	}
 	/**
 	* Retrieves products for a specific shop.
+	*
+	* @example
+	* const shopProducts = await client.shops.getProducts({
+	*   shopId: 123,
+	*   pageSize: 10
+	* });
 	*/
-	async getProducts(params) {
-		return await this.http.get({
+	getProducts(params) {
+		return this.http.get({
 			path: `/api/v2/shops/${params.shopId}/products`,
 			params,
 			schema: ShopsApiGetProductsResponseSchema
@@ -884,14 +983,24 @@ const SkuApiGetReviewAvailableResponseSchema = zod_mini.object({
 * API for interacting with SKU-related endpoints.
 */
 var SkuApi = class {
+	/**
+	* Initializes a new instance of the SkuApi.
+	*
+	* @param http HTTP client instance.
+	*/
 	constructor(http) {
 		this.http = http;
 	}
 	/**
 	* Retrieves details of a specific SKU.
+	*
+	* @example
+	* const sku = await client.sku.get({
+	*   skuId: 123
+	* });
 	*/
-	async get(params) {
-		return await this.http.get({
+	get(params) {
+		return this.http.get({
 			path: `/api/v2/sku/${params.skuId}`,
 			params,
 			schema: SkuApiGetResponseSchema
@@ -899,9 +1008,14 @@ var SkuApi = class {
 	}
 	/**
 	* Retrieves similar SKUs.
+	*
+	* @example
+	* const similar = await client.sku.getSimilar({
+	*   skuId: 123
+	* });
 	*/
-	async getSimilar(params) {
-		return await this.http.get({
+	getSimilar(params) {
+		return this.http.get({
 			path: "/api/v2/sku/similar-skus",
 			params,
 			schema: SkuApiGetSimilarResponseSchema
@@ -909,9 +1023,14 @@ var SkuApi = class {
 	}
 	/**
 	* Retrieves collections associated with a SKU.
+	*
+	* @example
+	* const collections = await client.sku.getCollections({
+	*   skuId: 123
+	* });
 	*/
-	async getCollections(params) {
-		return await this.http.get({
+	getCollections(params) {
+		return this.http.get({
 			path: `/sku/${params.skuId}/collections`,
 			params,
 			schema: SkuApiGetCollectionsResponseSchema
@@ -919,9 +1038,14 @@ var SkuApi = class {
 	}
 	/**
 	* Checks if a review is available for a SKU.
+	*
+	* @example
+	* const isAvailable = await client.sku.getReviewAvailable({
+	*   skuId: 123
+	* });
 	*/
-	async getReviewAvailable(params) {
-		return await this.http.get({
+	getReviewAvailable(params) {
+		return this.http.get({
 			path: `/sku/${params.skuId}/review-available`,
 			params,
 			schema: SkuApiGetReviewAvailableResponseSchema
@@ -943,17 +1067,6 @@ const LANGUAGES = {
 	KZ: "kz"
 };
 /**
-* Standard sort options for product and collection searches
-*/
-const SORT_OPTIONS = {
-	BY_RELEVANCE: "byRelevance",
-	POPULARITY: "popularity",
-	HIGHEST_RATED: "highestRated",
-	NEW: "new",
-	PRICE: "price",
-	PRICE_DESC: "priceDesc"
-};
-/**
 * Default application version code.
 */
 const DEFAULT_APP_VERSION = "193";
@@ -1177,6 +1290,11 @@ var HttpClient = class {
 	* Request timeout in milliseconds.
 	*/
 	timeout;
+	/**
+	* Initializes a new instance of the HttpClient.
+	*
+	* @param config Resolved client configuration.
+	*/
 	constructor(config) {
 		this.baseUrl = config.baseUrl;
 		this.headers = buildHeaders(config);
@@ -1184,6 +1302,8 @@ var HttpClient = class {
 	}
 	/**
 	* Performs a low-level HTTP request.
+	*
+	* @param options Request options.
 	*/
 	async request(options) {
 		const { url, headers, ...fetchOptions } = options;
@@ -1248,6 +1368,12 @@ var HttpClient = class {
 //#region src/client.ts
 /**
 * Main client for interacting with the Teez B2C API.
+*
+* @example
+* const client = new TeezClient({
+*   language: "ru",
+*   timeout: 10000
+* });
 */
 var TeezClient = class {
 	/**
@@ -1290,6 +1416,11 @@ var TeezClient = class {
 	* API for retrieving SKU details.
 	*/
 	sku;
+	/**
+	* Initializes a new instance of the TeezClient.
+	*
+	* @param config Optional client configuration.
+	*/
 	constructor(config) {
 		this.config = resolveConfig(config);
 		this.http = new HttpClient(this.config);
@@ -1354,7 +1485,6 @@ exports.ProductsStockAvailabilityTypeSchema = ProductsStockAvailabilityTypeSchem
 exports.PromoApi = PromoApi;
 exports.PromoApiItemSchema = PromoApiItemSchema;
 exports.PromoApiListResponseSchema = PromoApiListResponseSchema;
-exports.SORT_OPTIONS = SORT_OPTIONS;
 exports.ShopsApi = ShopsApi;
 exports.ShopsApiContactInfoSchema = ShopsApiContactInfoSchema;
 exports.ShopsApiGetMonobrandResponseSchema = ShopsApiGetMonobrandResponseSchema;