@teez-sdk/teez-b2c-api 3.0.0 → 4.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026
+
+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

@@ -1,187 +1,301 @@
 # @teez-sdk/teez-b2c-api
 
-A typed TypeScript client for the Teez B2C API.
+Typed SDK for the Teez B2C API built around operation definitions, `valibot` schemas, runtime validation, and an operation catalog that can be reused for SDK, MCP, and documentation generation.
 
-## Features
-
-- **Fully Typed:** Written in TypeScript with complete type definitions.
-- **Runtime Validation:** Uses [Zod](https://zod.dev) to validate API responses.
-- **Modular:** API endpoints are organized into logical modules (Products, Banners, etc.).
-- **Error Handling:** Custom error classes for fine-grained control over API, network, and validation errors.
+Use `createTeezClient()` for the full client, or `createTeezClientFromOperations(...)` to assemble a smaller client from selected operation groups for better tree-shaking.
 
 ## Installation
 
 ```bash
 npm install @teez-sdk/teez-b2c-api
-# or
-yarn add @teez-sdk/teez-b2c-api
-# or
-pnpm add @teez-sdk/teez-b2c-api
-
 ```
 
-## Getting Started
+Runtime requirements:
 
-Initialize the client and make your first request:
+- Node.js 20.9+ when relying on the built-in global `fetch`
+- or any runtime where `fetch`, `Request`, `Response`, and `Headers` are available
+- or a custom `fetch` implementation passed via `createTeezClient({ fetch })`
 
-```typescript
-import { TeezClient } from "@teez-sdk/teez-b2c-api";
+## Quick Start
 
-// Initialize with default configuration
-const client = new TeezClient();
+```ts
+import { createTeezClient } from "@teez-sdk/teez-b2c-api";
 
-// Or with custom configuration
-const customClient = new TeezClient({
-	timeout: 5000,
-	language: "kk", // Request responses in Kazakh
+const client = createTeezClient({
+	language: "kz",
+	timeout: 5_000,
 });
 
-try {
-	// Fetch products
-	const products = await client.products.list({
-		pageSize: 10,
-		pageNumber: 1,
-	});
+const featureFlags = await client.featureFlags.list();
 
-	console.log(products);
-} catch (error) {
-	console.error("Failed to fetch products:", error);
-}
+const suggestions = await client.products.autocomplete({
+	search: "sam",
+});
+
+const searchResults = await client.products.list({
+	query: suggestions[0]?.name ?? "samsung",
+	pageNumber: 1,
+	pageSize: 10,
+});
 ```
 
-## Configuration
+Operations without an `input` section can be called without arguments:
 
-The `TeezClient` accepts an optional configuration object:
+```ts
+await client.categories.list();
+await client.promo.list();
+await client.featureFlags.list();
+```
 
-```typescript
-interface TeezClientConfig {
-	/** Base URL for the API. Default: "[https://b2c-api.teez.kz](https://b2c-api.teez.kz)" */
-	baseUrl?: string;
+Operations with input schemas always require an object, even when all fields are optional:
 
-	/** Application version. Default: "193" */
-	appVersion?: string;
+```ts
+await client.products.getSortOptions({});
+await client.banners.list({});
+```
 
-	/** Language for API responses. Default: "ru" */
-	language?: "ru" | "kk";
+Operations whose successful response uses `emptyResponse()` resolve with `undefined`:
 
-	/** Request timeout in milliseconds. Default: 30000 */
-	timeout?: number;
+```ts
+await client.auth.login({
+	phone: "+77071234567",
+});
 
-	/** Custom headers to include in all requests. */
-	headers?: Record<string, string>;
-}
+await client.favorites.add.request({
+	body: [12345],
+});
 ```
 
-### Examples
+## Auth Flow
+
+Use `auth.login` to send the OTP code, `auth.verify` to exchange it for tokens, then create an authenticated client with the returned `accessToken`:
+
+```ts
+import { createTeezClient } from "@teez-sdk/teez-b2c-api";
 
-**Set a custom app version:**
+const publicClient = createTeezClient();
 
-```typescript
-const client = new TeezClient({
-	appVersion: "200", // User-agent will be "android;kz.teez.customer;200"
+await publicClient.auth.login({
+	phone: "+77071234567",
 });
-```
 
-**Use a custom user-agent:**
+const { accessToken, refreshToken } = await publicClient.auth.verify({
+	phone: "+77071234567",
+	otpCode: "1234",
+});
 
-```typescript
-const client = new TeezClient({
-	headers: {
-		"user-agent": "my-custom-client/1.0",
-	},
+const authClient = createTeezClient({
+	token: accessToken,
 });
+
+const profile = await authClient.auth.checkToken();
 ```
 
-## Usage Examples
+`refreshToken` is returned by the API, but this SDK does not currently provide a refresh-token operation. Persist it only if your application uses it outside the SDK.
 
-### Categories
+## Client Shapes and Tree-Shaking
 
-```typescript
-import { TeezClient } from "@teez-sdk/teez-b2c-api";
+`createTeezClient()` gives you the complete SDK with every operation group attached.
 
-const client = new TeezClient();
+Create the full client:
 
-// Get all categories
-const categories = await client.categories.list();
+```ts
+import { createTeezClient } from "@teez-sdk/teez-b2c-api";
 
-console.log(`Found ${categories.length} categories`);
+const client = createTeezClient();
+```
 
-// Get a specific category
-const electronics = await client.categories.get({
-	categoryId: 3472,
-});
+If your application only needs part of the API, prefer `createTeezClientFromOperations(...)`. It lets bundlers drop unused operation groups instead of pulling in the full operation catalog:
 
-console.log(`Category: ${electronics.name} (level ${electronics.level})`);
+```ts
+import {
+	authOperations,
+	createTeezClientFromOperations,
+} from "@teez-sdk/teez-b2c-api";
 
-// Get parent hierarchies for multiple categories
-const parents = await client.categories.getParents({
-	categoryId: [3472, 7665, 3431],
-	level: 1, // Optional: filter by hierarchy level
+const authClient = createTeezClientFromOperations({
+	auth: authOperations,
 });
 
-console.log(`Found ${parents.length} parent hierarchies`);
+await authClient.auth.login({
+	phone: "+77071234567",
+});
 ```
 
-### Products
+This is the recommended entry point when bundle size matters, for example in browser apps that only use a few Teez domains.
 
-```typescript
-// List products with pagination
-const products = await client.products.list({
-	pageSize: 20,
-	pageNumber: 1,
-});
+## Configuration
 
-// Get product reviews
-const reviews = await client.products.getReviews({
-	productId: 12345,
-	pageSize: 10,
-});
+```ts
+interface TeezClientConfig {
+	baseUrl?: string;
+	token?: string;
+	appVersion?: string;
+	language?: "ru" | "kz";
+	timeout?: number;
+	headers?: HeadersInit;
+	fetch?: typeof globalThis.fetch;
+}
+```
+
+Defaults:
+
+- `baseUrl`: `https://b2c-api.teez.kz`
+- `appVersion`: `"200"`
+- `language`: `"ru"`
+- `timeout`: `30_000`
 
-// Get similar products
-const similar = await client.sku.getSimilar({
-	skuId: 12345,
-	pageSize: 5,
+Notes:
+
+- `token` becomes an `Authorization: Bearer ...` header.
+- `appVersion` is used for both `User-Agent` and `X-App-Version`.
+- `headers` are merged on top of the SDK defaults.
+- `fetch` defaults to `globalThis.fetch`; pass your own implementation when the runtime does not provide one.
+- Kazakh is standardized as `"kz"` in request config and typed responses.
+
+If you need the fully separated request shape instead of the flattened convenience call, use `.request(...)`:
+
+```ts
+await client.products.list.request({
+	query: {
+		pageNumber: 1,
+		pageSize: 10,
+	},
 });
 ```
 
-## Available APIs
+## Runtime Validation
+
+Every operation validates:
+
+- input before the request is sent
+- success payloads after the response is received
+- error response bodies before they are attached to `TeezApiError.parsedBody`
+
+The package keeps its `valibot` schemas as internal validation details. Public type exports stay at the operation level:
+
+```ts
+import {
+	productsListOperation,
+	type ProductsListRequest,
+	type ProductsListRequestParts,
+	type ProductsListSuccessResponse,
+} from "@teez-sdk/teez-b2c-api";
+```
+
+`FooRequest` follows the preferred client call shape, so flattenable operations use the top-level object passed to `client.foo.bar(...)`. `FooRequestParts` matches `client.foo.bar.request(...)`.
+
+Generated schema-derived model types are intentionally not part of the package contract. If an application needs its own domain models, define them locally.
+
+## Operation Catalog
+
+The SDK exposes the grouped operation catalog, a flat list, and name lookup helpers:
 
-The client exposes the following API modules:
+```ts
+import {
+	getTeezOperation,
+	teezOperationList,
+	teezOperations,
+} from "@teez-sdk/teez-b2c-api";
 
-- `client.banners` - Retrieve banners.
-- `client.categories` - Browse product categories.
-- `client.collections` - access curated collections.
-- `client.featureFlags` - Check feature availability.
-- `client.products` - Search and filter products, get reviews.
-- `client.promo` - Access promotions.
-- `client.shops` - Information about shops.
-- `client.sku` - Detailed SKU information.
+const operation = getTeezOperation("products.list");
+
+console.log(operation.auth);
+console.log(operation.safety);
+console.log(operation.summary);
+console.log(operation.description);
+console.log(teezOperationList.length);
+console.log(teezOperations.products.list === operation);
+```
+
+Operations are the main source of truth for:
+
+- HTTP method and request mapping
+- input and output schemas
+- auth requirements
+- read/write safety metadata
+- MCP and doc-generation metadata
 
 ## Error Handling
 
-The SDK throws specific error types to help you handle failures gracefully:
+The SDK throws dedicated error classes:
+
+- `TeezApiError` for non-2xx responses
+- `TeezNetworkError` for transport failures
+- `TeezTimeoutError` for aborted requests due to timeout
+- `TeezValidationError` for input, output, or error-body schema mismatches
 
-- `TeezApiError`: The server returned a non-2xx status code. Contains status, status text, and response body.
-- `TeezNetworkError`: Network failure (e.g., DNS resolution, offline).
-- `TeezTimeoutError`: The request exceeded the configured timeout.
-- `TeezValidationError`: The API response did not match the expected schema (Zod validation failed).
+`TeezApiError` keeps transport metadata and may also include a typed `parsedBody` when the matching error response in `responses` defines a schema.
 
-```typescript
-import { TeezApiError, TeezTimeoutError } from "@teez-sdk/teez-b2c-api";
+```ts
+import {
+	getOperationApiError,
+	skuGetReviewAvailableOperation,
+	TeezApiError,
+	TeezTimeoutError,
+} from "@teez-sdk/teez-b2c-api";
 
 try {
-	await client.products.list();
+	await client.sku.getReviewAvailable({
+		skuId: 12345,
+	});
 } catch (error) {
 	if (error instanceof TeezTimeoutError) {
 		console.error("Request timed out");
 	} else if (error instanceof TeezApiError) {
-		console.error(`API Error: ${error.status} - ${error.message}`);
-	} else {
-		console.error("Unknown error:", error);
+		console.error(error.status, error.message);
+
+		const apiError = getOperationApiError(
+			error,
+			skuGetReviewAvailableOperation,
+		);
+
+		if (apiError != undefined) {
+			console.error(apiError.parsedBody.message);
+		}
 	}
 }
 ```
 
+## Auth Notes
+
+Live probes without a token confirmed these operations require authentication:
+
+- `auth.checkToken`
+- `favorites.add`
+- `favorites.getIds`
+- `favorites.remove`
+- `promocodes.validate`
+- `sku.getReviewAvailable`
+- `users.registerDevice`
+- `users.updateLanguage`
+
+Public read-only operations such as `banners.list`, `categories.*`, `collections.*`, `featureFlags.list`, `products.*`, `promo.list`, `shops.*`, `sku.get`, `sku.getCollections`, and `sku.getSimilar` were successfully exercised without a token.
+
+## Package Exports
+
+The package exports:
+
+- `createTeezClient`, `createTeezClientFromOperations`, `createRuntime`
+- `teezOperations`, `teezOperationList`, `teezOperationsByName`, `getTeezOperation`
+- operation definitions for every endpoint
+- type aliases from `types.ts`
+- shared contracts and filter schemas such as `apiErrorResponseSchema`, `filterSchema`, `rangeFilterSchema`, and `categoryFilterSchema`
+
+## Development
+
+Run these commands from `packages/teez-b2c-api`. From the repository root, append `-w @teez-sdk/teez-b2c-api`.
+
+```bash
+npm run generate:types
+npm run typecheck
+npm run typecheck:test
+npm run test
+npm run lint
+npm run test:coverage
+npm run build
+```
+
 ## License
 
 MIT

package/dist/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1,23 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+exports.__toESM = __toESM;

package/dist/api/auth/check-token/index.d.cts

@@ -0,0 +1,2 @@
+import { authCheckTokenOperation } from "./operation.cjs";
+import { AuthCheckTokenApiError, AuthCheckTokenErrorResponseBody, AuthCheckTokenErrorStatus, AuthCheckTokenOperation, AuthCheckTokenRequest, AuthCheckTokenRequestParts, AuthCheckTokenResponseByStatus, AuthCheckTokenResponseStatus, AuthCheckTokenSuccessResponse } from "./types.cjs";

package/dist/api/auth/check-token/index.d.mts

@@ -0,0 +1,2 @@
+import { authCheckTokenOperation } from "./operation.mjs";
+import { AuthCheckTokenApiError, AuthCheckTokenErrorResponseBody, AuthCheckTokenErrorStatus, AuthCheckTokenOperation, AuthCheckTokenRequest, AuthCheckTokenRequestParts, AuthCheckTokenResponseByStatus, AuthCheckTokenResponseStatus, AuthCheckTokenSuccessResponse } from "./types.mjs";

package/dist/api/auth/check-token/operation.cjs

@@ -0,0 +1,25 @@
+const require_api_error_response = require("../../../contracts/api-error-response.cjs");
+const require_define = require("../../../http-operation/define.cjs");
+const require_response_helpers = require("../../../http-operation/response-helpers.cjs");
+const require_responses = require("./responses.cjs");
+//#region src/api/auth/check-token/operation.ts
+const authCheckTokenOperation = require_define.defineHttpOperation({
+	domain: "auth",
+	action: "checkToken",
+	auth: "required",
+	safety: "read",
+	summary: "Validate the current JWT token.",
+	description: "Returns the authenticated user's profile summary, preferred language, and order history flags for the current access token.",
+	request: {
+		method: "GET",
+		path: "/auth/check-token"
+	},
+	responses: {
+		200: require_response_helpers.response({ schema: require_responses.authCheckTokenResponse200Schema }),
+		401: require_response_helpers.response({ schema: require_api_error_response.apiErrorResponseSchema })
+	}
+});
+//#endregion
+exports.authCheckTokenOperation = authCheckTokenOperation;
+
+//# sourceMappingURL=operation.cjs.map

package/dist/api/auth/check-token/operation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.cjs","names":["defineHttpOperation","response","authCheckTokenResponse200Schema","apiErrorResponseSchema"],"sources":["../../../../src/api/auth/check-token/operation.ts"],"sourcesContent":["import { apiErrorResponseSchema } from \"../../../contracts/api-error-response\";\nimport { defineHttpOperation } from \"../../../http-operation/define\";\nimport { response } from \"../../../http-operation/response-helpers\";\nimport { authCheckTokenResponse200Schema } from \"./responses\";\n\nexport const authCheckTokenOperation = defineHttpOperation({\n\tdomain: \"auth\",\n\taction: \"checkToken\",\n\tauth: \"required\",\n\tsafety: \"read\",\n\tsummary: \"Validate the current JWT token.\",\n\tdescription:\n\t\t\"Returns the authenticated user's profile summary, preferred language, and order history flags for the current access token.\",\n\trequest: {\n\t\tmethod: \"GET\",\n\t\tpath: \"/auth/check-token\",\n\t},\n\tresponses: {\n\t\t200: response({\n\t\t\tschema: authCheckTokenResponse200Schema,\n\t\t}),\n\t\t401: response({\n\t\t\tschema: apiErrorResponseSchema,\n\t\t}),\n\t},\n});\n"],"mappings":";;;;;AAKA,MAAa,0BAA0BA,eAAAA,oBAAoB;CAC1D,QAAQ;CACR,QAAQ;CACR,MAAM;CACN,QAAQ;CACR,SAAS;CACT,aACC;CACD,SAAS;EACR,QAAQ;EACR,MAAM;EACN;CACD,WAAW;EACV,KAAKC,yBAAAA,SAAS,EACb,QAAQC,kBAAAA,iCACR,CAAC;EACF,KAAKD,yBAAAA,SAAS,EACb,QAAQE,2BAAAA,wBACR,CAAC;EACF;CACD,CAAC"}

package/dist/api/auth/check-token/operation.d.cts

@@ -0,0 +1,44 @@
+import { Simplify } from "../../../type-utils/simplify.cjs";
+import { HttpOperationDef, HttpOperationJsonResponse } from "../../../http-operation/types.cjs";
+import * as _$valibot from "valibot";
+
+//#region src/api/auth/check-token/operation.d.ts
+declare const authCheckTokenOperation: HttpOperationDef<"auth", "checkToken", Simplify<Omit<{
+  readonly method: "GET";
+  readonly path: "/auth/check-token";
+}, "path"> & {
+  readonly path: {
+    readonly template: "/auth/check-token";
+    readonly schema?: undefined;
+  };
+}>, {
+  readonly 200: HttpOperationJsonResponse<_$valibot.SchemaWithPipe<readonly [_$valibot.ObjectSchema<{
+    readonly userId: _$valibot.SchemaWithPipe<readonly [_$valibot.StringSchema<undefined>, _$valibot.DescriptionAction<string, "Unique user identifier">]>;
+    readonly phoneNumber: _$valibot.SchemaWithPipe<readonly [_$valibot.StringSchema<undefined>, _$valibot.DescriptionAction<string, "User's phone number in E.164 format">]>;
+    readonly fullName: _$valibot.SchemaWithPipe<readonly [_$valibot.StringSchema<undefined>, _$valibot.DescriptionAction<string, "User's full name">]>;
+    readonly email: _$valibot.SchemaWithPipe<readonly [_$valibot.StringSchema<undefined>, _$valibot.DescriptionAction<string, "User's email address">]>;
+    readonly expiredTokenDate: _$valibot.SchemaWithPipe<readonly [_$valibot.StringSchema<undefined>, _$valibot.DescriptionAction<string, "Token expiration datetime in ISO 8601 format (e.g., \"2025-12-30T13:08:44+00:00\")">]>;
+    readonly language: _$valibot.SchemaWithPipe<readonly [_$valibot.SchemaWithPipe<readonly [_$valibot.UnionSchema<[_$valibot.LiteralSchema<"ru", undefined>, _$valibot.LiteralSchema<"kz", undefined>], undefined>, _$valibot.DescriptionAction<"ru" | "kz", "Language code returned for the authenticated user: \"ru\" or \"kz\".">]>, _$valibot.DescriptionAction<"ru" | "kz", "User's preferred language: \"ru\" or \"kz\".">]>;
+    readonly hasOrders: _$valibot.SchemaWithPipe<readonly [_$valibot.BooleanSchema<undefined>, _$valibot.DescriptionAction<boolean, "Whether user has active orders in progress">]>;
+    readonly hasAnyOrders: _$valibot.SchemaWithPipe<readonly [_$valibot.BooleanSchema<undefined>, _$valibot.DescriptionAction<boolean, "Whether user has any order history (including completed orders)">]>;
+  }, undefined>, _$valibot.DescriptionAction<{
+    userId: string;
+    phoneNumber: string;
+    fullName: string;
+    email: string;
+    expiredTokenDate: string;
+    language: "ru" | "kz";
+    hasOrders: boolean;
+    hasAnyOrders: boolean;
+  }, "Authenticated user profile returned by the token validation endpoint.">]>>;
+  readonly 401: HttpOperationJsonResponse<_$valibot.SchemaWithPipe<readonly [_$valibot.ObjectSchema<{
+    readonly description: _$valibot.SchemaWithPipe<readonly [_$valibot.StringSchema<undefined>, _$valibot.DescriptionAction<string, "Short backend error description or machine-readable reason.">]>;
+    readonly message: _$valibot.SchemaWithPipe<readonly [_$valibot.StringSchema<undefined>, _$valibot.DescriptionAction<string, "Localized human-readable error message.">]>;
+  }, undefined>, _$valibot.DescriptionAction<{
+    description: string;
+    message: string;
+  }, "Default API error body returned by many non-2xx responses, including unauthorized and validation errors.">]>>;
+}>;
+//#endregion
+export { authCheckTokenOperation };
+//# sourceMappingURL=operation.d.cts.map

package/dist/api/auth/check-token/operation.d.mts

@@ -0,0 +1,44 @@
+import { Simplify } from "../../../type-utils/simplify.mjs";
+import { HttpOperationDef, HttpOperationJsonResponse } from "../../../http-operation/types.mjs";
+import * as _$valibot from "valibot";
+
+//#region src/api/auth/check-token/operation.d.ts
+declare const authCheckTokenOperation: HttpOperationDef<"auth", "checkToken", Simplify<Omit<{
+  readonly method: "GET";
+  readonly path: "/auth/check-token";
+}, "path"> & {
+  readonly path: {
+    readonly template: "/auth/check-token";
+    readonly schema?: undefined;
+  };
+}>, {
+  readonly 200: HttpOperationJsonResponse<_$valibot.SchemaWithPipe<readonly [_$valibot.ObjectSchema<{
+    readonly userId: _$valibot.SchemaWithPipe<readonly [_$valibot.StringSchema<undefined>, _$valibot.DescriptionAction<string, "Unique user identifier">]>;
+    readonly phoneNumber: _$valibot.SchemaWithPipe<readonly [_$valibot.StringSchema<undefined>, _$valibot.DescriptionAction<string, "User's phone number in E.164 format">]>;
+    readonly fullName: _$valibot.SchemaWithPipe<readonly [_$valibot.StringSchema<undefined>, _$valibot.DescriptionAction<string, "User's full name">]>;
+    readonly email: _$valibot.SchemaWithPipe<readonly [_$valibot.StringSchema<undefined>, _$valibot.DescriptionAction<string, "User's email address">]>;
+    readonly expiredTokenDate: _$valibot.SchemaWithPipe<readonly [_$valibot.StringSchema<undefined>, _$valibot.DescriptionAction<string, "Token expiration datetime in ISO 8601 format (e.g., \"2025-12-30T13:08:44+00:00\")">]>;
+    readonly language: _$valibot.SchemaWithPipe<readonly [_$valibot.SchemaWithPipe<readonly [_$valibot.UnionSchema<[_$valibot.LiteralSchema<"ru", undefined>, _$valibot.LiteralSchema<"kz", undefined>], undefined>, _$valibot.DescriptionAction<"ru" | "kz", "Language code returned for the authenticated user: \"ru\" or \"kz\".">]>, _$valibot.DescriptionAction<"ru" | "kz", "User's preferred language: \"ru\" or \"kz\".">]>;
+    readonly hasOrders: _$valibot.SchemaWithPipe<readonly [_$valibot.BooleanSchema<undefined>, _$valibot.DescriptionAction<boolean, "Whether user has active orders in progress">]>;
+    readonly hasAnyOrders: _$valibot.SchemaWithPipe<readonly [_$valibot.BooleanSchema<undefined>, _$valibot.DescriptionAction<boolean, "Whether user has any order history (including completed orders)">]>;
+  }, undefined>, _$valibot.DescriptionAction<{
+    userId: string;
+    phoneNumber: string;
+    fullName: string;
+    email: string;
+    expiredTokenDate: string;
+    language: "ru" | "kz";
+    hasOrders: boolean;
+    hasAnyOrders: boolean;
+  }, "Authenticated user profile returned by the token validation endpoint.">]>>;
+  readonly 401: HttpOperationJsonResponse<_$valibot.SchemaWithPipe<readonly [_$valibot.ObjectSchema<{
+    readonly description: _$valibot.SchemaWithPipe<readonly [_$valibot.StringSchema<undefined>, _$valibot.DescriptionAction<string, "Short backend error description or machine-readable reason.">]>;
+    readonly message: _$valibot.SchemaWithPipe<readonly [_$valibot.StringSchema<undefined>, _$valibot.DescriptionAction<string, "Localized human-readable error message.">]>;
+  }, undefined>, _$valibot.DescriptionAction<{
+    description: string;
+    message: string;
+  }, "Default API error body returned by many non-2xx responses, including unauthorized and validation errors.">]>>;
+}>;
+//#endregion
+export { authCheckTokenOperation };
+//# sourceMappingURL=operation.d.mts.map

package/dist/api/auth/check-token/operation.mjs

@@ -0,0 +1,25 @@
+import { apiErrorResponseSchema } from "../../../contracts/api-error-response.mjs";
+import { defineHttpOperation } from "../../../http-operation/define.mjs";
+import { response } from "../../../http-operation/response-helpers.mjs";
+import { authCheckTokenResponse200Schema } from "./responses.mjs";
+//#region src/api/auth/check-token/operation.ts
+const authCheckTokenOperation = defineHttpOperation({
+	domain: "auth",
+	action: "checkToken",
+	auth: "required",
+	safety: "read",
+	summary: "Validate the current JWT token.",
+	description: "Returns the authenticated user's profile summary, preferred language, and order history flags for the current access token.",
+	request: {
+		method: "GET",
+		path: "/auth/check-token"
+	},
+	responses: {
+		200: response({ schema: authCheckTokenResponse200Schema }),
+		401: response({ schema: apiErrorResponseSchema })
+	}
+});
+//#endregion
+export { authCheckTokenOperation };
+
+//# sourceMappingURL=operation.mjs.map

package/dist/api/auth/check-token/operation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.mjs","names":[],"sources":["../../../../src/api/auth/check-token/operation.ts"],"sourcesContent":["import { apiErrorResponseSchema } from \"../../../contracts/api-error-response\";\nimport { defineHttpOperation } from \"../../../http-operation/define\";\nimport { response } from \"../../../http-operation/response-helpers\";\nimport { authCheckTokenResponse200Schema } from \"./responses\";\n\nexport const authCheckTokenOperation = defineHttpOperation({\n\tdomain: \"auth\",\n\taction: \"checkToken\",\n\tauth: \"required\",\n\tsafety: \"read\",\n\tsummary: \"Validate the current JWT token.\",\n\tdescription:\n\t\t\"Returns the authenticated user's profile summary, preferred language, and order history flags for the current access token.\",\n\trequest: {\n\t\tmethod: \"GET\",\n\t\tpath: \"/auth/check-token\",\n\t},\n\tresponses: {\n\t\t200: response({\n\t\t\tschema: authCheckTokenResponse200Schema,\n\t\t}),\n\t\t401: response({\n\t\t\tschema: apiErrorResponseSchema,\n\t\t}),\n\t},\n});\n"],"mappings":";;;;;AAKA,MAAa,0BAA0B,oBAAoB;CAC1D,QAAQ;CACR,QAAQ;CACR,MAAM;CACN,QAAQ;CACR,SAAS;CACT,aACC;CACD,SAAS;EACR,QAAQ;EACR,MAAM;EACN;CACD,WAAW;EACV,KAAK,SAAS,EACb,QAAQ,iCACR,CAAC;EACF,KAAK,SAAS,EACb,QAAQ,wBACR,CAAC;EACF;CACD,CAAC"}

package/dist/api/auth/check-token/responses.cjs

@@ -0,0 +1,19 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+let valibot = require("valibot");
+valibot = require_runtime.__toESM(valibot);
+//#region src/api/auth/check-token/responses.ts
+const authCheckTokenLanguageSchema = valibot.pipe(valibot.union([valibot.literal("ru"), valibot.literal("kz")]), valibot.description("Language code returned for the authenticated user: \"ru\" or \"kz\"."));
+const authCheckTokenResponse200Schema = valibot.pipe(valibot.object({
+	userId: valibot.pipe(valibot.string(), valibot.description("Unique user identifier")),
+	phoneNumber: valibot.pipe(valibot.string(), valibot.description("User's phone number in E.164 format")),
+	fullName: valibot.pipe(valibot.string(), valibot.description("User's full name")),
+	email: valibot.pipe(valibot.string(), valibot.description("User's email address")),
+	expiredTokenDate: valibot.pipe(valibot.string(), valibot.description("Token expiration datetime in ISO 8601 format (e.g., \"2025-12-30T13:08:44+00:00\")")),
+	language: valibot.pipe(authCheckTokenLanguageSchema, valibot.description("User's preferred language: \"ru\" or \"kz\".")),
+	hasOrders: valibot.pipe(valibot.boolean(), valibot.description("Whether user has active orders in progress")),
+	hasAnyOrders: valibot.pipe(valibot.boolean(), valibot.description("Whether user has any order history (including completed orders)"))
+}), valibot.description("Authenticated user profile returned by the token validation endpoint."));
+//#endregion
+exports.authCheckTokenResponse200Schema = authCheckTokenResponse200Schema;
+
+//# sourceMappingURL=responses.cjs.map

package/dist/api/auth/check-token/responses.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.cjs","names":["v"],"sources":["../../../../src/api/auth/check-token/responses.ts"],"sourcesContent":["import * as v from \"valibot\";\n\nexport const authCheckTokenLanguageSchema = v.pipe(\n\tv.union([v.literal(\"ru\"), v.literal(\"kz\")]),\n\tv.description(\n\t\t'Language code returned for the authenticated user: \"ru\" or \"kz\".',\n\t),\n);\nexport const authCheckTokenResponse200Schema = v.pipe(\n\tv.object({\n\t\tuserId: v.pipe(v.string(), v.description(\"Unique user identifier\")),\n\t\tphoneNumber: v.pipe(\n\t\t\tv.string(),\n\t\t\tv.description(\"User's phone number in E.164 format\"),\n\t\t),\n\t\tfullName: v.pipe(v.string(), v.description(\"User's full name\")),\n\t\temail: v.pipe(v.string(), v.description(\"User's email address\")),\n\t\texpiredTokenDate: v.pipe(\n\t\t\tv.string(),\n\t\t\tv.description(\n\t\t\t\t'Token expiration datetime in ISO 8601 format (e.g., \"2025-12-30T13:08:44+00:00\")',\n\t\t\t),\n\t\t),\n\t\tlanguage: v.pipe(\n\t\t\tauthCheckTokenLanguageSchema,\n\t\t\tv.description('User\\'s preferred language: \"ru\" or \"kz\".'),\n\t\t),\n\t\thasOrders: v.pipe(\n\t\t\tv.boolean(),\n\t\t\tv.description(\"Whether user has active orders in progress\"),\n\t\t),\n\t\thasAnyOrders: v.pipe(\n\t\t\tv.boolean(),\n\t\t\tv.description(\n\t\t\t\t\"Whether user has any order history (including completed orders)\",\n\t\t\t),\n\t\t),\n\t}),\n\tv.description(\n\t\t\"Authenticated user profile returned by the token validation endpoint.\",\n\t),\n);\n"],"mappings":";;;;AAEA,MAAa,+BAA+BA,QAAE,KAC7CA,QAAE,MAAM,CAACA,QAAE,QAAQ,KAAK,EAAEA,QAAE,QAAQ,KAAK,CAAC,CAAC,EAC3CA,QAAE,YACD,uEACA,CACD;AACD,MAAa,kCAAkCA,QAAE,KAChDA,QAAE,OAAO;CACR,QAAQA,QAAE,KAAKA,QAAE,QAAQ,EAAEA,QAAE,YAAY,yBAAyB,CAAC;CACnE,aAAaA,QAAE,KACdA,QAAE,QAAQ,EACVA,QAAE,YAAY,sCAAsC,CACpD;CACD,UAAUA,QAAE,KAAKA,QAAE,QAAQ,EAAEA,QAAE,YAAY,mBAAmB,CAAC;CAC/D,OAAOA,QAAE,KAAKA,QAAE,QAAQ,EAAEA,QAAE,YAAY,uBAAuB,CAAC;CAChE,kBAAkBA,QAAE,KACnBA,QAAE,QAAQ,EACVA,QAAE,YACD,qFACA,CACD;CACD,UAAUA,QAAE,KACX,8BACAA,QAAE,YAAY,+CAA4C,CAC1D;CACD,WAAWA,QAAE,KACZA,QAAE,SAAS,EACXA,QAAE,YAAY,6CAA6C,CAC3D;CACD,cAAcA,QAAE,KACfA,QAAE,SAAS,EACXA,QAAE,YACD,kEACA,CACD;CACD,CAAC,EACFA,QAAE,YACD,wEACA,CACD"}