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

package/README.md

@@ -62,7 +62,7 @@ interface TeezClientConfig {
 	appVersion?: string;
 
 	/** Language for API responses. Default: "ru" */
-	language?: "ru" | "kk" | "uz";
+	language?: "ru" | "kk";
 
 	/** Request timeout in milliseconds. Default: 30000 */
 	timeout?: number;

package/dist/index.cjs

@@ -28,6 +28,164 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 let zod_mini = require("zod/mini");
 zod_mini = __toESM(zod_mini);
 
+//#region src/errors/teez-error.ts
+/**
+* Base error class for all SDK-related errors.
+*/
+var TeezError = class extends Error {
+	name = "TeezError";
+};
+
+//#endregion
+//#region src/errors/teez-validation-error.ts
+/**
+* Error thrown when validation fails.
+*/
+var TeezValidationError = class extends TeezError {
+	name = "TeezValidationError";
+	/**
+	* List of standardized validation issues.
+	*/
+	issues;
+	/**
+	* The raw data that failed validation.
+	*/
+	data;
+	constructor(message, { issues, data, ...errorOptions }) {
+		super(message, errorOptions);
+		this.issues = issues;
+		this.data = data;
+	}
+};
+
+//#endregion
+//#region src/http/helpers.ts
+/**
+* Constructs a full URL with query parameters.
+*/
+function buildUrl(path, baseUrl, queryParams) {
+	const url = new URL(path, baseUrl);
+	if (queryParams != void 0) for (const [key, value] of Object.entries(queryParams)) {
+		if (value == void 0) continue;
+		if (Array.isArray(value)) for (const item of value) url.searchParams.append(key, String(item));
+		else url.searchParams.set(key, String(value));
+	}
+	return String(url);
+}
+/**
+* Converts Zod ZodError to abstract ValidationIssue[].
+*/
+function toValidationIssues(error) {
+	return error.issues.map((issue) => ({
+		code: issue.code,
+		path: issue.path,
+		message: issue.message
+	}));
+}
+/**
+* Validates and parses the API response data against a schema.
+*/
+function parseResponse(schema, data) {
+	const result = zod_mini.safeParse(schema, data);
+	if (!result.success) throw new TeezValidationError("Response validation failed", {
+		issues: toValidationIssues(result.error),
+		data
+	});
+	return result.data;
+}
+
+//#endregion
+//#region src/api/auth/schemas.ts
+/**
+* Response schema for initiating phone login.
+*/
+const AuthApiLoginResponseSchema = zod_mini.void();
+/**
+* Response schema for OTP verification.
+*/
+const AuthApiVerifyResponseSchema = zod_mini.object({
+	userId: zod_mini.string(),
+	phone: zod_mini.string(),
+	accessToken: zod_mini.string(),
+	refreshToken: zod_mini.string(),
+	paymentId: zod_mini.nullish(zod_mini.number()),
+	pickupPoint: zod_mini.nullish(zod_mini.unknown()),
+	address: zod_mini.nullish(zod_mini.unknown()),
+	recipient: zod_mini.nullish(zod_mini.unknown())
+});
+/**
+* Response schema for token validation.
+*/
+const AuthApiCheckTokenResponseSchema = zod_mini.object({
+	userId: zod_mini.string(),
+	phoneNumber: zod_mini.string(),
+	fullName: zod_mini.string(),
+	email: zod_mini.string(),
+	expiredTokenDate: zod_mini.string(),
+	language: zod_mini.enum(["ru", "kk"]),
+	hasOrders: zod_mini.boolean(),
+	hasAnyOrders: zod_mini.boolean()
+});
+
+//#endregion
+//#region src/api/auth/api.ts
+/**
+* API for authentication operations.
+*/
+var AuthApi = class {
+	/**
+	* Initializes a new instance of the AuthApi.
+	*
+	* @param http HTTP client instance.
+	*/
+	constructor(http) {
+		this.http = http;
+	}
+	/**
+	* Initiates phone login by sending an OTP code to the specified phone number.
+	*
+	* @example
+	* await client.auth.login({
+	*   phone: "+77071234567"
+	* });
+	*/
+	async login(params) {
+		return parseResponse(AuthApiLoginResponseSchema, await this.http.post({
+			path: "/auth/login",
+			body: params
+		}));
+	}
+	/**
+	* Verifies OTP code and obtains JWT access and refresh tokens.
+	*
+	* @example
+	* const response = await client.auth.verify({
+	*   phone: "+77071234567",
+	*   otpCode: "2610"
+	* });
+	*/
+	async verify(params) {
+		return parseResponse(AuthApiVerifyResponseSchema, await this.http.post({
+			path: "/auth/verify",
+			body: params
+		}));
+	}
+	/**
+	* Validates the current JWT token and retrieves user information.
+	*
+	* @example
+	* const response = await client.auth.checkToken();
+	*/
+	async checkToken(params = {}) {
+		return await this.http.get({
+			path: "/auth/check-token",
+			params,
+			schema: AuthApiCheckTokenResponseSchema
+		});
+	}
+};
+
+//#endregion
 //#region src/api/banners/schemas.ts
 /**
 * Type literal for banner image resource type
@@ -442,6 +600,7 @@ var FeatureFlagsApi = class {
 * Type union for product sort keys
 */
 const ProductSortKeySchema = zod_mini.union([
+	zod_mini.literal("byRelevance"),
 	zod_mini.literal("popularity"),
 	zod_mini.literal("highestRated"),
 	zod_mini.literal("new"),
@@ -1053,6 +1212,76 @@ var SkuApi = class {
 	}
 };
 
+//#endregion
+//#region src/api/users/schemas.ts
+/**
+* Supported language enum for user preference
+*/
+const UsersApiLanguageEnumSchema = zod_mini.enum(["ru", "kk"]);
+/**
+* Response schema for language update
+*/
+const UsersApiUpdateLanguageResponseSchema = zod_mini.object({
+	language: UsersApiLanguageEnumSchema,
+	title: zod_mini.string(),
+	message: zod_mini.string()
+});
+/**
+* Response schema for device registration
+*/
+const UsersApiRegisterDeviceResponseSchema = zod_mini.nullish(zod_mini.null());
+
+//#endregion
+//#region src/api/users/api.ts
+/**
+* API for user management operations.
+*/
+var UsersApi = class {
+	/**
+	* Initializes a new instance of the UsersApi.
+	*
+	* @param http HTTP client instance.
+	*/
+	constructor(http) {
+		this.http = http;
+	}
+	/**
+	* Updates the user's preferred language.
+	*
+	* @example
+	* await client.users.updateLanguage({
+	*   language: "ru"
+	* });
+	*/
+	async updateLanguage(params) {
+		return parseResponse(UsersApiUpdateLanguageResponseSchema, await this.http.patch({
+			path: "/api/v1/users/me/language",
+			body: params
+		}));
+	}
+	/**
+	* Registers device identity for analytics tracking.
+	*
+	* @example
+	* await client.users.registerDevice({
+	*   deviceIdentity: {
+	*     sdkInformation: [
+	*       {
+	*         type: "Appsflyer",
+	*         deviceId: "1765694307025-6267413661002574019"
+	*       }
+	*     ]
+	*   }
+	* });
+	*/
+	async registerDevice(params) {
+		return parseResponse(UsersApiRegisterDeviceResponseSchema, await this.http.post({
+			path: "/api/v1/device-identities",
+			body: params
+		}));
+	}
+};
+
 //#endregion
 //#region src/common/constants.ts
 /**
@@ -1069,7 +1298,7 @@ const LANGUAGES = {
 /**
 * Default application version code.
 */
-const DEFAULT_APP_VERSION = "193";
+const DEFAULT_APP_VERSION = "200";
 
 //#endregion
 //#region src/config.ts
@@ -1089,6 +1318,7 @@ const DEFAULT_CONFIG = {
 function resolveConfig(config) {
 	return {
 		baseUrl: config?.baseUrl ?? DEFAULT_CONFIG.baseUrl,
+		token: config?.token,
 		appVersion: config?.appVersion ?? DEFAULT_CONFIG.appVersion,
 		language: config?.language ?? DEFAULT_CONFIG.language,
 		timeout: config?.timeout ?? DEFAULT_CONFIG.timeout,
@@ -1108,23 +1338,16 @@ function buildUserAgent(appVersion) {
 * Builds the headers object for API requests based on configuration.
 */
 function buildHeaders(config) {
-	return {
+	const headers = {
 		"accept-language": config.language,
 		"user-agent": buildUserAgent(config.appVersion),
 		"x-app-version": config.appVersion,
 		...config.headers
 	};
+	if (config.token !== void 0 && config.token !== null) headers["authorization"] = `Bearer ${config.token}`;
+	return headers;
 }
 
-//#endregion
-//#region src/errors/teez-error.ts
-/**
-* Base error class for all SDK-related errors.
-*/
-var TeezError = class extends Error {
-	name = "TeezError";
-};
-
 //#endregion
 //#region src/errors/teez-api-error.ts
 /**
@@ -1214,64 +1437,6 @@ var TeezTimeoutError = class extends TeezError {
 	}
 };
 
-//#endregion
-//#region src/errors/teez-validation-error.ts
-/**
-* Error thrown when validation fails.
-*/
-var TeezValidationError = class extends TeezError {
-	name = "TeezValidationError";
-	/**
-	* List of standardized validation issues.
-	*/
-	issues;
-	/**
-	* The raw data that failed validation.
-	*/
-	data;
-	constructor(message, { issues, data, ...errorOptions }) {
-		super(message, errorOptions);
-		this.issues = issues;
-		this.data = data;
-	}
-};
-
-//#endregion
-//#region src/http/helpers.ts
-/**
-* Constructs a full URL with query parameters.
-*/
-function buildUrl(path, baseUrl, queryParams) {
-	const url = new URL(path, baseUrl);
-	if (queryParams != void 0) for (const [key, value] of Object.entries(queryParams)) {
-		if (value == void 0) continue;
-		if (Array.isArray(value)) for (const item of value) url.searchParams.append(key, String(item));
-		else url.searchParams.set(key, String(value));
-	}
-	return String(url);
-}
-/**
-* Converts Zod ZodError to abstract ValidationIssue[].
-*/
-function toValidationIssues(error) {
-	return error.issues.map((issue) => ({
-		code: issue.code,
-		path: issue.path,
-		message: issue.message
-	}));
-}
-/**
-* Validates and parses the API response data against a schema.
-*/
-function parseResponse(schema, data) {
-	const result = zod_mini.safeParse(schema, data);
-	if (!result.success) throw new TeezValidationError("Response validation failed", {
-		issues: toValidationIssues(result.error),
-		data
-	});
-	return result.data;
-}
-
 //#endregion
 //#region src/http/client.ts
 /**
@@ -1279,26 +1444,21 @@ function parseResponse(schema, data) {
 */
 var HttpClient = class {
 	/**
-	* Base URL for all requests.
+	* Client configuration.
 	*/
-	baseUrl;
+	config;
 	/**
 	* Headers to include in all requests.
 	*/
 	headers;
 	/**
-	* Request timeout in milliseconds.
-	*/
-	timeout;
-	/**
 	* Initializes a new instance of the HttpClient.
 	*
 	* @param config Resolved client configuration.
 	*/
 	constructor(config) {
-		this.baseUrl = config.baseUrl;
+		this.config = config;
 		this.headers = buildHeaders(config);
-		this.timeout = config.timeout;
 	}
 	/**
 	* Performs a low-level HTTP request.
@@ -1310,7 +1470,7 @@ var HttpClient = class {
 		const controller = new AbortController();
 		const timeoutId = setTimeout(() => {
 			controller.abort();
-		}, this.timeout);
+		}, this.config.timeout);
 		try {
 			const response = await fetch(url, {
 				...fetchOptions,
@@ -1334,12 +1494,13 @@ var HttpClient = class {
 					body
 				});
 			}
+			if (response.status === 204) return;
 			return await response.json();
 		} catch (error) {
 			if (error instanceof TeezApiError) throw error;
-			if (error instanceof DOMException && error.name === "AbortError") throw new TeezTimeoutError(`Request timed out after ${this.timeout}ms`, {
+			if (error instanceof DOMException && error.name === "AbortError") throw new TeezTimeoutError(`Request timed out after ${this.config.timeout}ms`, {
 				url,
-				timeout: this.timeout,
+				timeout: this.config.timeout,
 				cause: error
 			});
 			throw new TeezNetworkError(`Network request failed`, {
@@ -1355,13 +1516,53 @@ var HttpClient = class {
 	*/
 	async get(options) {
 		const { path, params, schema, ...rest } = options;
-		const url = buildUrl(path, this.baseUrl, params);
+		const url = buildUrl(path, this.config.baseUrl, params);
 		return parseResponse(schema, await this.request({
 			url,
 			method: "GET",
 			...rest
 		}));
 	}
+	/**
+	* Performs a POST request.
+	*/
+	post(options) {
+		const { path, params, body, ...rest } = options;
+		const url = buildUrl(path, this.config.baseUrl, params);
+		return this.request({
+			url,
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: body != void 0 ? JSON.stringify(body) : void 0,
+			...rest
+		});
+	}
+	/**
+	* Performs a PATCH request.
+	*/
+	patch(options) {
+		const { path, params, body, ...rest } = options;
+		const url = buildUrl(path, this.config.baseUrl, params);
+		return this.request({
+			url,
+			method: "PATCH",
+			headers: { "Content-Type": "application/json" },
+			body: body != void 0 ? JSON.stringify(body) : void 0,
+			...rest
+		});
+	}
+	/**
+	* Performs a DELETE request.
+	*/
+	delete(options) {
+		const { path, params, ...rest } = options;
+		const url = buildUrl(path, this.config.baseUrl, params);
+		return this.request({
+			url,
+			method: "DELETE",
+			...rest
+		});
+	}
 };
 
 //#endregion
@@ -1385,6 +1586,10 @@ var TeezClient = class {
 	*/
 	http;
 	/**
+	* API for authentication operations.
+	*/
+	auth;
+	/**
 	* API for retrieving banners.
 	*/
 	banners;
@@ -1417,6 +1622,10 @@ var TeezClient = class {
 	*/
 	sku;
 	/**
+	* API for user management operations.
+	*/
+	users;
+	/**
 	* Initializes a new instance of the TeezClient.
 	*
 	* @param config Optional client configuration.
@@ -1424,6 +1633,7 @@ var TeezClient = class {
 	constructor(config) {
 		this.config = resolveConfig(config);
 		this.http = new HttpClient(this.config);
+		this.auth = new AuthApi(this.http);
 		this.banners = new BannersApi(this.http);
 		this.categories = new CategoriesApi(this.http);
 		this.collections = new CollectionsApi(this.http);
@@ -1432,6 +1642,7 @@ var TeezClient = class {
 		this.promo = new PromoApi(this.http);
 		this.shops = new ShopsApi(this.http);
 		this.sku = new SkuApi(this.http);
+		this.users = new UsersApi(this.http);
 	}
 	/**
 	* Returns the current client configuration.
@@ -1442,6 +1653,10 @@ var TeezClient = class {
 };
 
 //#endregion
+exports.AuthApi = AuthApi;
+exports.AuthApiCheckTokenResponseSchema = AuthApiCheckTokenResponseSchema;
+exports.AuthApiLoginResponseSchema = AuthApiLoginResponseSchema;
+exports.AuthApiVerifyResponseSchema = AuthApiVerifyResponseSchema;
 exports.BASE_URL = BASE_URL;
 exports.BannerActionTypesSchema = BannerActionTypesSchema;
 exports.BannerImageTypeSchema = BannerImageTypeSchema;
@@ -1518,6 +1733,10 @@ exports.TeezError = TeezError;
 exports.TeezNetworkError = TeezNetworkError;
 exports.TeezTimeoutError = TeezTimeoutError;
 exports.TeezValidationError = TeezValidationError;
+exports.UsersApi = UsersApi;
+exports.UsersApiLanguageEnumSchema = UsersApiLanguageEnumSchema;
+exports.UsersApiRegisterDeviceResponseSchema = UsersApiRegisterDeviceResponseSchema;
+exports.UsersApiUpdateLanguageResponseSchema = UsersApiUpdateLanguageResponseSchema;
 exports.buildHeaders = buildHeaders;
 exports.buildUserAgent = buildUserAgent;
 exports.resolveConfig = resolveConfig;