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

package/dist/index.d.cts

@@ -21,7 +21,7 @@ declare const LANGUAGES: {
 /**
  * Default application version code.
  */
-declare const DEFAULT_APP_VERSION = "193";
+declare const DEFAULT_APP_VERSION = "200";
 //#endregion
 //#region src/common/types.d.ts
 /**
@@ -43,6 +43,10 @@ interface TeezClientConfig {
    * @default "https://b2c-api.teez.kz"
    */
   baseUrl?: string;
+  /**
+   * JWT bearer token for authenticated requests.
+   */
+  token?: string;
   /**
    * Application version string.
    * @default "193"
@@ -71,6 +75,10 @@ interface ResolvedTeezClientConfig {
    * Base URL for the API.
    */
   readonly baseUrl: string;
+  /**
+   * JWT bearer token for authenticated requests.
+   */
+  readonly token?: string;
   /**
    * Application version string.
    */
@@ -140,6 +148,53 @@ interface HttpGetOptions<T extends z.ZodMiniType> extends Omit<HttpRequestOption
    */
   schema: T;
 }
+/**
+ * Options for making a POST request.
+ */
+interface HttpPostOptions extends Omit<HttpRequestOptions, "url" | "method" | "body"> {
+  /**
+   * Relative path to the resource.
+   */
+  path: string;
+  /**
+   * Request body to send (will be JSON-serialized).
+   */
+  body?: unknown;
+  /**
+   * Query parameters to append to the URL.
+   */
+  params?: QueryParams;
+}
+/**
+ * Options for making a PATCH request.
+ */
+interface HttpPatchOptions extends Omit<HttpRequestOptions, "url" | "method" | "body"> {
+  /**
+   * Relative path to the resource.
+   */
+  path: string;
+  /**
+   * Request body to send (will be JSON-serialized).
+   */
+  body?: unknown;
+  /**
+   * Query parameters to append to the URL.
+   */
+  params?: QueryParams;
+}
+/**
+ * Options for making a DELETE request.
+ */
+interface HttpDeleteOptions extends Omit<HttpRequestOptions, "url" | "method" | "body"> {
+  /**
+   * Relative path to the resource.
+   */
+  path: string;
+  /**
+   * Query parameters to append to the URL.
+   */
+  params?: QueryParams;
+}
 //#endregion
 //#region src/http/client.d.ts
 /**
@@ -147,17 +202,13 @@ interface HttpGetOptions<T extends z.ZodMiniType> extends Omit<HttpRequestOption
  */
 declare class HttpClient {
   /**
-   * Base URL for all requests.
+   * Client configuration.
    */
-  private readonly baseUrl;
+  private readonly config;
   /**
    * Headers to include in all requests.
    */
   private readonly headers;
-  /**
-   * Request timeout in milliseconds.
-   */
-  private readonly timeout;
   /**
    * Initializes a new instance of the HttpClient.
    *
@@ -174,6 +225,171 @@ declare class HttpClient {
    * Performs a GET request and validates the response.
    */
   get<T extends z.ZodMiniType>(options: HttpGetOptions<T>): Promise<z.output<T>>;
+  /**
+   * Performs a POST request.
+   */
+  post(options: HttpPostOptions): Promise<unknown>;
+  /**
+   * Performs a PATCH request.
+   */
+  patch(options: HttpPatchOptions): Promise<unknown>;
+  /**
+   * Performs a DELETE request.
+   */
+  delete(options: HttpDeleteOptions): Promise<unknown>;
+}
+//#endregion
+//#region src/api/auth/schema-types.d.ts
+/**
+ * ⚠️ This file is auto-generated. Do not edit manually.
+ * Run `npm run generate:schema-types` to regenerate.
+ * Generated from: schemas.ts
+ */
+/**
+ * Response schema for login.
+ */
+type AuthApiLoginResponse = void | undefined;
+/**
+ * Response schema for OTP verification.
+ */
+interface AuthApiVerifyResponse {
+  /**
+   * Unique user identifier
+   */
+  userId: string;
+  /**
+   * JWT access token for authenticated requests
+   */
+  accessToken: string;
+  /**
+   * Refresh token for obtaining new access tokens
+   */
+  refreshToken: string;
+  /**
+   * User's phone number
+   */
+  phone: string;
+  /**
+   * User's default pickup point
+   */
+  pickupPoint?: (unknown | null) | undefined;
+  /**
+   * User's default delivery address
+   */
+  address?: (unknown | null) | undefined;
+  /**
+   * User's default recipient information
+   */
+  recipient?: (unknown | null) | undefined;
+  /**
+   * User's default payment method ID
+   */
+  paymentId?: (number | null) | undefined;
+}
+/**
+ * Response schema for token validation.
+ */
+interface AuthApiCheckTokenResponse {
+  /**
+   * Unique user identifier
+   */
+  userId: string;
+  /**
+   * User's phone number
+   */
+  phoneNumber: string;
+  /**
+   * User's full name
+   */
+  fullName: string;
+  /**
+   * User's email address
+   */
+  email: string;
+  /**
+   * Token expiration date (ISO 8601 format)
+   */
+  expiredTokenDate: string;
+  /**
+   * User's language preference (ru or kk)
+   */
+  language: "ru" | "kk";
+  /**
+   * Whether user has any orders in the system
+   */
+  hasOrders: boolean;
+  /**
+   * Whether user has any orders (alternative field)
+   */
+  hasAnyOrders: boolean;
+}
+//#endregion
+//#region src/api/auth/types.d.ts
+/**
+ * Parameters for initiating phone login (sends OTP).
+ */
+interface AuthApiLoginParams extends BaseParams {
+  /**
+   * Phone number with country code (e.g., "+77071234567")
+   */
+  phone: string;
+}
+/**
+ * Parameters for verifying OTP code and obtaining JWT token.
+ */
+interface AuthApiVerifyParams extends BaseParams {
+  /**
+   * Phone number with country code (e.g., "+77071234567")
+   */
+  phone: string;
+  /**
+   * OTP code received via SMS
+   */
+  otpCode: string;
+}
+/**
+ * Parameters for checking token validity.
+ */
+type AuthApiCheckTokenParams = BaseParams;
+//#endregion
+//#region src/api/auth/api.d.ts
+/**
+ * API for authentication operations.
+ */
+declare class AuthApi {
+  private http;
+  /**
+   * Initializes a new instance of the AuthApi.
+   *
+   * @param http HTTP client instance.
+   */
+  constructor(http: HttpClient);
+  /**
+   * Initiates phone login by sending an OTP code to the specified phone number.
+   *
+   * @example
+   * await client.auth.login({
+   *   phone: "+77071234567"
+   * });
+   */
+  login(params: AuthApiLoginParams): Promise<AuthApiLoginResponse>;
+  /**
+   * Verifies OTP code and obtains JWT access and refresh tokens.
+   *
+   * @example
+   * const response = await client.auth.verify({
+   *   phone: "+77071234567",
+   *   otpCode: "2610"
+   * });
+   */
+  verify(params: AuthApiVerifyParams): Promise<AuthApiVerifyResponse>;
+  /**
+   * Validates the current JWT token and retrieves user information.
+   *
+   * @example
+   * const response = await client.auth.checkToken();
+   */
+  checkToken(params?: AuthApiCheckTokenParams): Promise<AuthApiCheckTokenResponse>;
 }
 //#endregion
 //#region src/api/banners/schema-types.d.ts
@@ -658,7 +874,7 @@ interface CollectionsApiGetResponse {
 /**
  * Type union for product sort keys
  */
-type ProductSortKey = "popularity" | "highestRated" | "new" | "price" | "priceDesc";
+type ProductSortKey = "byRelevance" | "popularity" | "highestRated" | "new" | "price" | "priceDesc";
 /**
  * Schema for a sort option.
  */
@@ -2163,6 +2379,10 @@ declare class TeezClient {
    * HTTP client for making requests.
    */
   private readonly http;
+  /**
+   * API for authentication operations (login, verify OTP, check token).
+   */
+  readonly auth: AuthApi;
   /**
    * API for retrieving banners.
    */
@@ -2389,6 +2609,89 @@ declare class TeezValidationError extends TeezError {
   }: TeezValidationErrorOptions);
 }
 //#endregion
+//#region src/api/auth/schemas.d.ts
+/**
+ * Response schema for login.
+ */
+declare const AuthApiLoginResponseSchema: z.ZodMiniVoid;
+/**
+ * Response schema for OTP verification.
+ */
+declare const AuthApiVerifyResponseSchema: z.ZodMiniObject<{
+  /**
+   * Unique user identifier
+   */
+  userId: z.ZodMiniString<string>;
+  /**
+   * JWT access token for authenticated requests
+   */
+  accessToken: z.ZodMiniString<string>;
+  /**
+   * Refresh token for obtaining new access tokens
+   */
+  refreshToken: z.ZodMiniString<string>;
+  /**
+   * User's phone number
+   */
+  phone: z.ZodMiniString<string>;
+  /**
+   * User's default pickup point
+   */
+  pickupPoint: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniUnknown>>;
+  /**
+   * User's default delivery address
+   */
+  address: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniUnknown>>;
+  /**
+   * User's default recipient information
+   */
+  recipient: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniUnknown>>;
+  /**
+   * User's default payment method ID
+   */
+  paymentId: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumber<number>>>;
+}, z.core.$strip>;
+/**
+ * Response schema for token validation.
+ */
+declare const AuthApiCheckTokenResponseSchema: z.ZodMiniObject<{
+  /**
+   * Unique user identifier
+   */
+  userId: z.ZodMiniString<string>;
+  /**
+   * User's phone number
+   */
+  phoneNumber: z.ZodMiniString<string>;
+  /**
+   * User's full name
+   */
+  fullName: z.ZodMiniString<string>;
+  /**
+   * User's email address
+   */
+  email: z.ZodMiniString<string>;
+  /**
+   * Token expiration date (ISO 8601 format)
+   */
+  expiredTokenDate: z.ZodMiniString<string>;
+  /**
+   * User's language preference (ru or kk)
+   */
+  language: z.ZodMiniEnum<{
+    ru: "ru";
+    kk: "kk";
+  }>;
+  /**
+   * Whether user has any orders in the system
+   */
+  hasOrders: z.ZodMiniBoolean<boolean>;
+  /**
+   * Whether user has any orders (alternative field)
+   */
+  hasAnyOrders: z.ZodMiniBoolean<boolean>;
+}, z.core.$strip>;
+//#endregion
 //#region src/api/banners/schemas.d.ts
 /**
  * Type literal for banner image resource type
@@ -2969,7 +3272,7 @@ declare const CollectionsApiGetResponseSchema: z.ZodMiniObject<{
 /**
  * Type union for product sort keys
  */
-declare const ProductSortKeySchema: z.ZodMiniUnion<readonly [z.ZodMiniLiteral<"popularity">, z.ZodMiniLiteral<"highestRated">, z.ZodMiniLiteral<"new">, z.ZodMiniLiteral<"price">, z.ZodMiniLiteral<"priceDesc">]>;
+declare const ProductSortKeySchema: z.ZodMiniUnion<readonly [z.ZodMiniLiteral<"byRelevance">, z.ZodMiniLiteral<"popularity">, z.ZodMiniLiteral<"highestRated">, z.ZodMiniLiteral<"new">, z.ZodMiniLiteral<"price">, z.ZodMiniLiteral<"priceDesc">]>;
 /**
  * Schema for a sort option.
  */
@@ -2977,7 +3280,7 @@ declare const ProductsApiSortOptionSchema: z.ZodMiniObject<{
   /**
    * Sort key - "popularity", "highestRated", "new", "price", or "priceDesc"
    */
-  key: z.ZodMiniUnion<readonly [z.ZodMiniLiteral<"popularity">, z.ZodMiniLiteral<"highestRated">, z.ZodMiniLiteral<"new">, z.ZodMiniLiteral<"price">, z.ZodMiniLiteral<"priceDesc">]>;
+  key: z.ZodMiniUnion<readonly [z.ZodMiniLiteral<"byRelevance">, z.ZodMiniLiteral<"popularity">, z.ZodMiniLiteral<"highestRated">, z.ZodMiniLiteral<"new">, z.ZodMiniLiteral<"price">, z.ZodMiniLiteral<"priceDesc">]>;
   /**
    * Localized display name of the sort option
    */
@@ -2990,7 +3293,7 @@ declare const ProductsApiGetSortOptionsResponseSchema: z.ZodMiniArray<z.ZodMiniO
   /**
    * Sort key - "popularity", "highestRated", "new", "price", or "priceDesc"
    */
-  key: z.ZodMiniUnion<readonly [z.ZodMiniLiteral<"popularity">, z.ZodMiniLiteral<"highestRated">, z.ZodMiniLiteral<"new">, z.ZodMiniLiteral<"price">, z.ZodMiniLiteral<"priceDesc">]>;
+  key: z.ZodMiniUnion<readonly [z.ZodMiniLiteral<"byRelevance">, z.ZodMiniLiteral<"popularity">, z.ZodMiniLiteral<"highestRated">, z.ZodMiniLiteral<"new">, z.ZodMiniLiteral<"price">, z.ZodMiniLiteral<"priceDesc">]>;
   /**
    * Localized display name of the sort option
    */
@@ -4599,5 +4902,5 @@ declare const FeatureFlagsApiListResponseSchema: z.ZodMiniArray<z.ZodMiniObject<
   isActive: z.ZodMiniBoolean<boolean>;
 }, z.core.$strip>>;
 //#endregion
-export { BASE_URL, BannerActionTypes, BannerActionTypesSchema, BannerImageType, BannerImageTypeSchema, BannersApi, BannersApiAction, BannersApiActionSchema, BannersApiBannerItem, BannersApiBannerItemSchema, BannersApiImage, BannersApiImageSchema, BannersApiListParams, BannersApiListResponse, BannersApiListResponseSchema, BaseParams, CategoriesApi, CategoriesApiGetParams, CategoriesApiGetParentsParams, CategoriesApiGetParentsResponse, CategoriesApiGetParentsResponseItem, CategoriesApiGetParentsResponseItemSchema, CategoriesApiGetParentsResponseSchema, CategoriesApiGetResponse, CategoriesApiGetResponseSchema, CategoriesApiListParams, CategoriesApiListResponse, CategoriesApiListResponseItem, CategoriesApiListResponseItemSchema, CategoriesApiListResponseSchema, CollectionType, CollectionTypeSchema, CollectionsApi, CollectionsApiGetParams, CollectionsApiGetResponse, CollectionsApiGetResponseSchema, CollectionsApiGetSkusParams, CollectionsApiGetSkusResponse, CollectionsApiGetSkusResponseSchema, CollectionsApiListItem, CollectionsApiListItemSchema, CollectionsApiListParams, CollectionsApiListResponse, CollectionsApiListResponseSchema, CollectionsApiSkuItem, CollectionsApiSkuItemSchema, CollectionsApiStockAvailability, CollectionsApiStockAvailabilitySchema, CollectionsStockAvailabilityType, CollectionsStockAvailabilityTypeSchema, DEFAULT_APP_VERSION, DEFAULT_CONFIG, FeatureFlagsApi, FeatureFlagsApiItem, FeatureFlagsApiItemSchema, FeatureFlagsApiListParams, FeatureFlagsApiListResponse, FeatureFlagsApiListResponseSchema, LANGUAGES, Language, ProductSortKey, ProductSortKeySchema, ProductsApi, ProductsApiBadge, ProductsApiBadgeSchema, ProductsApiGetReviewsParams, ProductsApiGetReviewsResponse, ProductsApiGetReviewsResponseSchema, ProductsApiGetSortOptionsParams, ProductsApiGetSortOptionsResponse, ProductsApiGetSortOptionsResponseSchema, ProductsApiListParams, ProductsApiListResponse, ProductsApiListResponseSchema, ProductsApiProductItem, ProductsApiProductItemSchema, ProductsApiReviewItem, ProductsApiReviewItemSchema, ProductsApiSortOption, ProductsApiSortOptionSchema, ProductsApiStockAvailability, ProductsApiStockAvailabilitySchema, ProductsStockAvailabilityType, ProductsStockAvailabilityTypeSchema, PromoApi, PromoApiItem, PromoApiItemSchema, PromoApiListParams, PromoApiListResponse, PromoApiListResponseSchema, ResolvedTeezClientConfig, ShopsApi, ShopsApiContactInfo, ShopsApiContactInfoSchema, ShopsApiGetMonobrandParams, ShopsApiGetMonobrandResponse, ShopsApiGetMonobrandResponseSchema, ShopsApiGetParams, ShopsApiGetProductsParams, ShopsApiGetProductsResponse, ShopsApiGetProductsResponseSchema, ShopsApiGetResponse, ShopsApiGetResponseSchema, ShopsApiProductItem, ShopsApiProductItemSchema, ShopsApiShopItem, ShopsApiShopItemSchema, ShopsApiStockAvailability, ShopsApiStockAvailabilitySchema, ShopsApiTag, ShopsApiTagSchema, ShopsStockAvailabilityType, ShopsStockAvailabilityTypeSchema, SkuApi, SkuApiAttribute, SkuApiAttributeProperty, SkuApiAttributePropertySchema, SkuApiAttributePropertyValue, SkuApiAttributePropertyValueSchema, SkuApiAttributeSchema, SkuApiBrand, SkuApiBrandSchema, SkuApiCategory, SkuApiCategorySchema, SkuApiCollectionItem, SkuApiCollectionItemSchema, SkuApiGetCollectionsParams, SkuApiGetCollectionsResponse, SkuApiGetCollectionsResponseSchema, SkuApiGetParams, SkuApiGetResponse, SkuApiGetResponseSchema, SkuApiGetReviewAvailableParams, SkuApiGetReviewAvailableResponse, SkuApiGetReviewAvailableResponseSchema, SkuApiGetSimilarParams, SkuApiGetSimilarResponse, SkuApiGetSimilarResponseSchema, SkuApiInstallment, SkuApiInstallmentSchema, SkuApiShop, SkuApiShopSchema, SkuApiSimilarItem, SkuApiSimilarItemSchema, SkuApiStockAvailability, SkuApiStockAvailabilitySchema, SkuApiTag, SkuApiTagSchema, SkuStockAvailabilityType, SkuStockAvailabilityTypeSchema, TeezApiError, TeezApiErrorOptions, TeezClient, TeezClientConfig, TeezError, TeezNetworkError, TeezNetworkErrorOptions, TeezTimeoutError, TeezTimeoutErrorOptions, TeezValidationError, TeezValidationErrorOptions, TeezValidationIssue, buildHeaders, buildUserAgent, resolveConfig };
+export { AuthApi, AuthApiCheckTokenParams, AuthApiCheckTokenResponse, AuthApiCheckTokenResponseSchema, AuthApiLoginParams, AuthApiLoginResponse, AuthApiLoginResponseSchema, AuthApiVerifyParams, AuthApiVerifyResponse, AuthApiVerifyResponseSchema, BASE_URL, BannerActionTypes, BannerActionTypesSchema, BannerImageType, BannerImageTypeSchema, BannersApi, BannersApiAction, BannersApiActionSchema, BannersApiBannerItem, BannersApiBannerItemSchema, BannersApiImage, BannersApiImageSchema, BannersApiListParams, BannersApiListResponse, BannersApiListResponseSchema, BaseParams, CategoriesApi, CategoriesApiGetParams, CategoriesApiGetParentsParams, CategoriesApiGetParentsResponse, CategoriesApiGetParentsResponseItem, CategoriesApiGetParentsResponseItemSchema, CategoriesApiGetParentsResponseSchema, CategoriesApiGetResponse, CategoriesApiGetResponseSchema, CategoriesApiListParams, CategoriesApiListResponse, CategoriesApiListResponseItem, CategoriesApiListResponseItemSchema, CategoriesApiListResponseSchema, CollectionType, CollectionTypeSchema, CollectionsApi, CollectionsApiGetParams, CollectionsApiGetResponse, CollectionsApiGetResponseSchema, CollectionsApiGetSkusParams, CollectionsApiGetSkusResponse, CollectionsApiGetSkusResponseSchema, CollectionsApiListItem, CollectionsApiListItemSchema, CollectionsApiListParams, CollectionsApiListResponse, CollectionsApiListResponseSchema, CollectionsApiSkuItem, CollectionsApiSkuItemSchema, CollectionsApiStockAvailability, CollectionsApiStockAvailabilitySchema, CollectionsStockAvailabilityType, CollectionsStockAvailabilityTypeSchema, DEFAULT_APP_VERSION, DEFAULT_CONFIG, FeatureFlagsApi, FeatureFlagsApiItem, FeatureFlagsApiItemSchema, FeatureFlagsApiListParams, FeatureFlagsApiListResponse, FeatureFlagsApiListResponseSchema, LANGUAGES, Language, ProductSortKey, ProductSortKeySchema, ProductsApi, ProductsApiBadge, ProductsApiBadgeSchema, ProductsApiGetReviewsParams, ProductsApiGetReviewsResponse, ProductsApiGetReviewsResponseSchema, ProductsApiGetSortOptionsParams, ProductsApiGetSortOptionsResponse, ProductsApiGetSortOptionsResponseSchema, ProductsApiListParams, ProductsApiListResponse, ProductsApiListResponseSchema, ProductsApiProductItem, ProductsApiProductItemSchema, ProductsApiReviewItem, ProductsApiReviewItemSchema, ProductsApiSortOption, ProductsApiSortOptionSchema, ProductsApiStockAvailability, ProductsApiStockAvailabilitySchema, ProductsStockAvailabilityType, ProductsStockAvailabilityTypeSchema, PromoApi, PromoApiItem, PromoApiItemSchema, PromoApiListParams, PromoApiListResponse, PromoApiListResponseSchema, ResolvedTeezClientConfig, ShopsApi, ShopsApiContactInfo, ShopsApiContactInfoSchema, ShopsApiGetMonobrandParams, ShopsApiGetMonobrandResponse, ShopsApiGetMonobrandResponseSchema, ShopsApiGetParams, ShopsApiGetProductsParams, ShopsApiGetProductsResponse, ShopsApiGetProductsResponseSchema, ShopsApiGetResponse, ShopsApiGetResponseSchema, ShopsApiProductItem, ShopsApiProductItemSchema, ShopsApiShopItem, ShopsApiShopItemSchema, ShopsApiStockAvailability, ShopsApiStockAvailabilitySchema, ShopsApiTag, ShopsApiTagSchema, ShopsStockAvailabilityType, ShopsStockAvailabilityTypeSchema, SkuApi, SkuApiAttribute, SkuApiAttributeProperty, SkuApiAttributePropertySchema, SkuApiAttributePropertyValue, SkuApiAttributePropertyValueSchema, SkuApiAttributeSchema, SkuApiBrand, SkuApiBrandSchema, SkuApiCategory, SkuApiCategorySchema, SkuApiCollectionItem, SkuApiCollectionItemSchema, SkuApiGetCollectionsParams, SkuApiGetCollectionsResponse, SkuApiGetCollectionsResponseSchema, SkuApiGetParams, SkuApiGetResponse, SkuApiGetResponseSchema, SkuApiGetReviewAvailableParams, SkuApiGetReviewAvailableResponse, SkuApiGetReviewAvailableResponseSchema, SkuApiGetSimilarParams, SkuApiGetSimilarResponse, SkuApiGetSimilarResponseSchema, SkuApiInstallment, SkuApiInstallmentSchema, SkuApiShop, SkuApiShopSchema, SkuApiSimilarItem, SkuApiSimilarItemSchema, SkuApiStockAvailability, SkuApiStockAvailabilitySchema, SkuApiTag, SkuApiTagSchema, SkuStockAvailabilityType, SkuStockAvailabilityTypeSchema, TeezApiError, TeezApiErrorOptions, TeezClient, TeezClientConfig, TeezError, TeezNetworkError, TeezNetworkErrorOptions, TeezTimeoutError, TeezTimeoutErrorOptions, TeezValidationError, TeezValidationErrorOptions, TeezValidationIssue, buildHeaders, buildUserAgent, resolveConfig };
 //# sourceMappingURL=index.d.cts.map