@gigapay-dev/contracts 1.8.2 → 1.8.4

package/build/commands/index.js

@@ -25,5 +25,5 @@ __exportStar(require("./payment-methods"), exports);
 __exportStar(require("./api-response"), exports);
 __exportStar(require("./users"), exports);
 __exportStar(require("./stats"), exports);
-__exportStar(require("./status"), exports);
 __exportStar(require("./settings"), exports);
+__exportStar(require("./products"), exports);

package/build/commands/orders/create.js

@@ -3,21 +3,38 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OrderCreateResponseSchema = exports.OrderCreateRequestSchema = void 0;
+exports.OrderCreateResponseSchema = exports.OrderCreateRequestSchema = exports.OrderItemInputSchema = void 0;
 const zod_1 = __importDefault(require("zod"));
 const enums_1 = require("./enums");
+exports.OrderItemInputSchema = zod_1.default.object({
+    variantId: zod_1.default.coerce.number().int().positive(),
+    quantity: zod_1.default.coerce.number().int().min(1).default(1),
+    gameUsername: zod_1.default.string().max(255).optional(),
+    gameUsernameType: zod_1.default.string().max(64).optional(),
+});
+/** Запрос на создание заказа */
 exports.OrderCreateRequestSchema = zod_1.default.object({
+    /** Email покупателя */
     email: zod_1.default.string().email(),
-    steamUsername: zod_1.default.string(),
-    amount: zod_1.default.coerce.number().nonnegative(),
-    userId: zod_1.default.coerce.number().positive().optional(),
+    /** ID способа оплаты */
     paymentMethodId: zod_1.default.coerce.number().positive(),
+    /** Список товаров в заказе (минимум 1) */
+    items: zod_1.default.array(exports.OrderItemInputSchema).min(1),
+    /** ID промокода (опционально) */
     promocodeId: zod_1.default.coerce.number().positive().optional(),
-    type: enums_1.OrderType.optional().default('MAIN'),
+    /** ID существующего пользователя (опционально) */
+    userId: zod_1.default.coerce.number().positive().optional(),
+    /** Telegram ID покупателя (опционально) */
+    telegramId: zod_1.default.string().optional(),
+    /** UTM-метка источника трафика */
     utmSource: zod_1.default.string().optional(),
+    /** Тип дизайна формы оплаты */
     designType: zod_1.default.string().optional(),
-    telegramId: zod_1.default.string().optional(),
+    /** Тип заказа: MAIN (сайт) или WEBAPP (Telegram Mini App) */
+    type: enums_1.OrderType.optional().default("MAIN"),
 });
+/** Ответ на создание заказа — ссылка для оплаты */
 exports.OrderCreateResponseSchema = zod_1.default.object({
+    /** URL для редиректа на платёжную страницу */
     redirectUrl: zod_1.default.string(),
 });

package/build/commands/orders/enums.js

@@ -3,6 +3,23 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OrderType = void 0;
+exports.OrderItemStatus = exports.OrderStatus = exports.OrderType = void 0;
 const zod_1 = __importDefault(require("zod"));
 exports.OrderType = zod_1.default.enum(["MAIN", "WEBAPP"]);
+exports.OrderStatus = zod_1.default.enum([
+    "PENDING",
+    "AWAITING_PAYMENT",
+    "PAID",
+    "PROCESSING",
+    "SUCCESS",
+    "FAILED",
+    "REFUNDED",
+    "CANCELLED",
+]);
+exports.OrderItemStatus = zod_1.default.enum([
+    "PENDING",
+    "PROCESSING",
+    "DELIVERED",
+    "FAILED",
+    "REFUNDED",
+]);

package/build/commands/orders/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./enums"), exports);
 __exportStar(require("./create"), exports);
 __exportStar(require("./update"), exports);
 __exportStar(require("./read"), exports);

package/build/commands/orders/query.js

@@ -6,11 +6,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OrdersListQuerySchema = exports.OrdersSortSchema = exports.OrdersFiltersSchema = exports.OrdersPeriodSchema = void 0;
 const zod_1 = __importDefault(require("zod"));
 const pagination_1 = require("../pagination");
+const enums_1 = require("./enums");
+/** Фильтр по периоду (базовая схема без refinements для merge) */
 const OrdersPeriodBase = zod_1.default.object({
+    /** Предустановленный период: day, week, month, year, custom */
     period: zod_1.default.enum(["day", "week", "month", "year", "custom"]).optional(),
+    /** Начало периода (ISO datetime, обязателен при period=custom) */
     start: zod_1.default.string().datetime().optional(),
+    /** Конец периода (ISO datetime, обязателен при period=custom) */
     end: zod_1.default.string().datetime().optional(),
 });
+/** Фильтр по периоду с валидацией custom-диапазона */
 exports.OrdersPeriodSchema = OrdersPeriodBase
     .refine(v => v.period !== "custom" || (v.start && v.end), {
     message: "start/end обязательны при period=custom",
@@ -18,15 +24,21 @@ exports.OrdersPeriodSchema = OrdersPeriodBase
     .refine(v => v.period !== "custom" || new Date(v.start) < new Date(v.end), {
     message: "start должен быть раньше end",
 });
+/** Фильтры списка заказов */
 exports.OrdersFiltersSchema = zod_1.default.object({
-    email: zod_1.default.string().email().optional(),
-    steamUsername: zod_1.default.string().min(1).optional(),
-    status: zod_1.default.enum(["PENDING", "SUCCESS", "FAILED", "CANCELED"]).optional(),
+    /** Фильтр по email покупателя (частичное совпадение) */
+    email: zod_1.default.string().optional(),
+    /** Фильтр по статусу заказа */
+    status: enums_1.OrderStatus.optional(),
 });
+/** Сортировка списка заказов */
 exports.OrdersSortSchema = zod_1.default.object({
-    sortBy: zod_1.default.string().default("createdAt"),
+    /** Поле для сортировки: createdAt, updatedAt, total, subtotal */
+    sortBy: zod_1.default.enum(["createdAt", "updatedAt", "total", "subtotal"]).default("createdAt"),
+    /** Направление сортировки */
     sortDir: zod_1.default.enum(["asc", "desc"]).default("desc"),
 });
+/** Объединённая схема запроса списка заказов */
 exports.OrdersListQuerySchema = pagination_1.PaginationQuery
     .merge(exports.OrdersFiltersSchema)
     .merge(exports.OrdersSortSchema)

package/build/commands/orders/read.js

@@ -1,26 +1,81 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OrderReadResponseSchema = void 0;
+exports.OrderReadResponseSchema = exports.OrderItemResponseSchema = void 0;
 const zod_1 = require("zod");
 const enums_1 = require("./enums");
+/** Элемент заказа в ответе */
+exports.OrderItemResponseSchema = zod_1.z.object({
+    /** ID элемента заказа */
+    id: zod_1.z.number(),
+    /** ID товара */
+    productId: zod_1.z.number(),
+    /** ID варианта товара */
+    variantId: zod_1.z.number(),
+    /** Количество */
+    quantity: zod_1.z.number(),
+    /** Цена на момент покупки (строка, Decimal) */
+    price: zod_1.z.string(),
+    /** Игровой логин для доставки */
+    gameUsername: zod_1.z.string().nullable(),
+    /** Тип игрового логина */
+    gameUsernameType: zod_1.z.string().nullable(),
+    /** Выданный ключ (если автоматическая доставка) */
+    deliveredKey: zod_1.z.string().nullable(),
+    /** Дата доставки */
+    deliveredAt: zod_1.z.coerce.date().nullable(),
+    /** Статус элемента заказа */
+    status: enums_1.OrderItemStatus,
+    /** Название товара */
+    productTitle: zod_1.z.string().optional(),
+    /** Название варианта */
+    variantName: zod_1.z.string().optional(),
+});
+/** Полная информация о заказе */
 exports.OrderReadResponseSchema = zod_1.z.object({
+    /** ID заказа */
     id: zod_1.z.coerce.number().positive(),
-    userId: zod_1.z.coerce.number().positive().optional(),
-    promocodeId: zod_1.z.coerce.number().nonnegative().optional(),
+    /** ID пользователя (null для гостевых заказов) */
+    userId: zod_1.z.coerce.number().positive().nullable().optional(),
+    /** ID промокода */
+    promocodeId: zod_1.z.coerce.number().nonnegative().nullable().optional(),
+    /** ID способа оплаты */
+    paymentMethodId: zod_1.z.coerce.number().nonnegative().nullable().optional(),
+    /** Email покупателя */
     email: zod_1.z.string(),
-    status: zod_1.z.string(),
-    steamUsername: zod_1.z.string(),
-    paymentId: zod_1.z.coerce.number().nonnegative(),
-    paymentMethodId: zod_1.z.coerce.number().nonnegative().optional(),
-    paymentMethodName: zod_1.z.string(),
-    promocodeValue: zod_1.z.string().nullable(),
-    promocodeDiscount: zod_1.z.string().nullable(),
-    amount: zod_1.z.coerce.number().nonnegative(),
+    /** Статус заказа */
+    status: enums_1.OrderStatus,
+    /** Тип заказа */
     type: enums_1.OrderType,
-    designType: zod_1.z.string().nullable(),
+    /** Сумма товаров до скидки и комиссий (строка, Decimal) */
+    subtotal: zod_1.z.string(),
+    /** Сумма скидки (строка, Decimal) */
+    discount: zod_1.z.string(),
+    /** Комиссия эквайринга (строка, Decimal) */
+    commission: zod_1.z.string(),
+    /** Комиссия сервиса (строка, Decimal) */
+    serviceCommission: zod_1.z.string(),
+    /** Итого к оплате (строка, Decimal) */
+    total: zod_1.z.string(),
+    /** IP-адрес покупателя */
+    ipAddress: zod_1.z.string().nullable().optional(),
+    /** UTM-метка источника трафика */
     utmSource: zod_1.z.string().nullable(),
+    /** Тип дизайна формы оплаты */
+    designType: zod_1.z.string().nullable(),
+    /** Название способа оплаты */
+    paymentMethodName: zod_1.z.string().nullable(),
+    /** Значение промокода */
+    promocodeValue: zod_1.z.string().nullable(),
+    /** Скидка промокода в процентах (строка, Decimal) */
+    promocodeDiscount: zod_1.z.string().nullable(),
+    /** Процент комиссии сервиса (serviceComission + secretComission) */
     serviceCommissionPercent: zod_1.z.coerce.number().nonnegative().optional(),
+    /** Процент комиссии эквайринга */
     acquiringCommissionPercent: zod_1.z.coerce.number().nonnegative().optional(),
+    /** Элементы заказа */
+    items: zod_1.z.array(exports.OrderItemResponseSchema).optional(),
+    /** Дата создания */
     createdAt: zod_1.z.coerce.date().default(() => new Date()),
+    /** Дата обновления */
     updatedAt: zod_1.z.coerce.date().default(() => new Date()),
 });

package/build/commands/orders/update.js

@@ -2,13 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OrderUpdateRequestSchema = void 0;
 const zod_1 = require("zod");
+const enums_1 = require("./enums");
+/** Запрос на обновление заказа (администратором) */
 exports.OrderUpdateRequestSchema = zod_1.z.object({
+    /** Новый статус заказа */
+    status: enums_1.OrderStatus.optional(),
+    /** Email покупателя */
     email: zod_1.z.string().email().optional(),
-    amount: zod_1.z.coerce.number().nonnegative().optional(),
-    steamUsername: zod_1.z.string().optional(),
-    userId: zod_1.z.coerce.number().positive().optional(),
+    /** ID способа оплаты */
     paymentMethodId: zod_1.z.coerce.number().positive().optional(),
-    paymentId: zod_1.z.coerce.number().positive().optional(),
+    /** ID промокода */
     promocodeId: zod_1.z.coerce.number().positive().optional(),
-    comission: zod_1.z.coerce.number().nonnegative().optional(),
 });

package/build/commands/products/create.js

@@ -0,0 +1,122 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SystemRequirementsRequestSchema = exports.MediaCreateRequestSchema = exports.KeysImportResponseSchema = exports.KeysImportRequestSchema = exports.VariantCreateRequestSchema = exports.ProductCreateRequestSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+const enums_1 = require("./enums");
+/** Запрос на создание продукта */
+exports.ProductCreateRequestSchema = zod_1.default.object({
+    /** URL-friendly идентификатор */
+    slug: zod_1.default.string().min(1),
+    /** Название продукта */
+    title: zod_1.default.string().min(1),
+    /** Оригинальное название (на языке оригинала) */
+    originalTitle: zod_1.default.string().optional(),
+    /** Тип продукта */
+    type: enums_1.ProductType,
+    /** ID категории */
+    categoryId: zod_1.default.number().int().positive(),
+    /** ID родительского продукта (для DLC) */
+    parentProductId: zod_1.default.number().int().positive().optional(),
+    /** Полное описание */
+    description: zod_1.default.string().optional(),
+    /** Кастомное описание */
+    customDescription: zod_1.default.string().optional(),
+    /** Краткое описание */
+    shortDescription: zod_1.default.string().optional(),
+    /** URL обложки */
+    coverImageUrl: zod_1.default.string().url().optional(),
+    /** Разработчик */
+    developer: zod_1.default.string().optional(),
+    /** Издатель */
+    publisher: zod_1.default.string().optional(),
+    /** Дата выхода (ISO datetime) */
+    releaseDate: zod_1.default.string().datetime().optional(),
+    /** Steam App ID */
+    steamAppId: zod_1.default.number().int().optional(),
+    /** Мультиплеер */
+    hasMultiplayer: zod_1.default.boolean().default(false),
+    /** Кооператив */
+    hasCoop: zod_1.default.boolean().default(false),
+    /** Одиночная игра */
+    hasSinglePlayer: zod_1.default.boolean().default(true),
+    /** SEO: заголовок */
+    metaTitle: zod_1.default.string().optional(),
+    /** SEO: описание */
+    metaDescription: zod_1.default.string().optional(),
+    /** ID жанров для привязки */
+    genreIds: zod_1.default.array(zod_1.default.number().int().positive()).optional(),
+    /** ID тегов для привязки */
+    tagIds: zod_1.default.array(zod_1.default.number().int().positive()).optional(),
+    /** ID регионов для привязки */
+    regionIds: zod_1.default.array(zod_1.default.number().int().positive()).optional(),
+});
+/** Запрос на создание варианта продукта */
+exports.VariantCreateRequestSchema = zod_1.default.object({
+    /** Название варианта */
+    name: zod_1.default.string().min(1),
+    /** Артикул */
+    sku: zod_1.default.string().min(1),
+    /** Цена */
+    price: zod_1.default.number().positive(),
+    /** Цена до скидки */
+    originalPrice: zod_1.default.number().positive().optional(),
+    /** Себестоимость */
+    costPrice: zod_1.default.number().positive().optional(),
+    /** Сумма пополнения (для TOPUP) */
+    topupAmount: zod_1.default.number().positive().optional(),
+    /** Валюта */
+    currency: zod_1.default.string().optional(),
+    /** Длительность подписки (дни) */
+    durationDays: zod_1.default.number().int().positive().optional(),
+    /** Платформа (Steam, Epic Games, ...) */
+    platform: zod_1.default.string().optional(),
+    /** Код региона */
+    regionCode: zod_1.default.string().optional(),
+    /** Тип доставки */
+    deliveryType: enums_1.DeliveryType.default("AUTOMATIC"),
+});
+/** Запрос на импорт ключей */
+exports.KeysImportRequestSchema = zod_1.default.object({
+    /** Массив ключей для импорта */
+    keys: zod_1.default.array(zod_1.default.string().min(1)).min(1),
+});
+/** Ответ на импорт ключей */
+exports.KeysImportResponseSchema = zod_1.default.object({
+    /** Количество импортированных ключей */
+    imported: zod_1.default.number(),
+});
+/** Запрос на добавление медиа */
+exports.MediaCreateRequestSchema = zod_1.default.object({
+    /** Тип медиа */
+    type: enums_1.MediaType,
+    /** URL медиа */
+    url: zod_1.default.string().url(),
+    /** Alt-текст */
+    alt: zod_1.default.string().optional(),
+    /** Порядок сортировки */
+    sortOrder: zod_1.default.number().int().default(0),
+});
+/** Запрос на upsert системных требований */
+exports.SystemRequirementsRequestSchema = zod_1.default.object({
+    /** Тип: минимальные / рекомендуемые */
+    type: enums_1.SystemRequirementType,
+    /** Операционная система */
+    os: zod_1.default.string().optional(),
+    /** Процессор */
+    processor: zod_1.default.string().optional(),
+    /** Оперативная память */
+    memory: zod_1.default.string().optional(),
+    /** Видеокарта */
+    graphics: zod_1.default.string().optional(),
+    /** Место на диске */
+    storage: zod_1.default.string().optional(),
+    /** DirectX */
+    directx: zod_1.default.string().optional(),
+    /** Сеть */
+    network: zod_1.default.string().optional(),
+    /** Дополнительно */
+    additional: zod_1.default.string().optional(),
+});

package/build/commands/products/endpoints.js

@@ -0,0 +1,99 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductEndpoints = void 0;
+const zod_1 = __importDefault(require("zod"));
+const query_1 = require("./query");
+const create_1 = require("./create");
+const update_1 = require("./update");
+const read_1 = require("./read");
+exports.ProductEndpoints = {
+    // === Публичные ===
+    catalog: {
+        method: "GET",
+        path: "/products",
+        request: query_1.ProductFilterSchema,
+        response: zod_1.default.object({
+            items: zod_1.default.array(read_1.ProductCatalogResponseSchema),
+            total: zod_1.default.number(),
+            skip: zod_1.default.number(),
+            take: zod_1.default.number(),
+        }),
+    },
+    categories: {
+        method: "GET",
+        path: "/products/categories",
+        response: zod_1.default.array(read_1.CategoryResponseSchema),
+    },
+    genres: {
+        method: "GET",
+        path: "/products/genres",
+        response: zod_1.default.array(read_1.GenreResponseSchema),
+    },
+    regions: {
+        method: "GET",
+        path: "/products/regions",
+        response: zod_1.default.array(read_1.RegionResponseSchema),
+    },
+    getBySlug: {
+        method: "GET",
+        path: "/products/:slug",
+        request: zod_1.default.object({ slug: zod_1.default.string() }),
+        response: read_1.ProductDetailResponseSchema,
+    },
+    // === Администрирование ===
+    create: {
+        method: "POST",
+        path: "/products/admin",
+        request: create_1.ProductCreateRequestSchema,
+        response: read_1.ProductDetailResponseSchema,
+    },
+    update: {
+        method: "PUT",
+        path: "/products/admin/:id",
+        request: update_1.ProductUpdateRequestSchema,
+        response: read_1.ProductDetailResponseSchema,
+    },
+    archive: {
+        method: "DELETE",
+        path: "/products/admin/:id",
+        response: zod_1.default.object({ status: zod_1.default.string() }),
+    },
+    createVariant: {
+        method: "POST",
+        path: "/products/admin/:productId/variants",
+        request: create_1.VariantCreateRequestSchema,
+    },
+    updateVariant: {
+        method: "PUT",
+        path: "/products/admin/variants/:variantId",
+        request: create_1.VariantCreateRequestSchema,
+    },
+    importKeys: {
+        method: "POST",
+        path: "/products/admin/variants/:variantId/keys",
+        request: create_1.KeysImportRequestSchema,
+        response: create_1.KeysImportResponseSchema,
+    },
+    getKeysCount: {
+        method: "GET",
+        path: "/products/admin/variants/:variantId/keys/count",
+        response: read_1.KeysCountResponseSchema,
+    },
+    addMedia: {
+        method: "POST",
+        path: "/products/admin/:productId/media",
+        request: create_1.MediaCreateRequestSchema,
+    },
+    removeMedia: {
+        method: "DELETE",
+        path: "/products/admin/media/:mediaId",
+    },
+    upsertSystemRequirements: {
+        method: "POST",
+        path: "/products/admin/:productId/system-requirements",
+        request: create_1.SystemRequirementsRequestSchema,
+    },
+};

package/build/commands/products/enums.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SystemRequirementType = exports.KeyStatus = exports.MediaType = exports.DeliveryType = exports.ProductStatus = exports.ProductType = void 0;
+const zod_1 = __importDefault(require("zod"));
+/** Тип продукта */
+exports.ProductType = zod_1.default.enum([
+    "GAME_KEY",
+    "GAME_GIFT",
+    "TOPUP",
+    "SUBSCRIPTION",
+    "IN_GAME_ITEM",
+    "DLC",
+    "CURRENCY",
+]);
+/** Статус продукта */
+exports.ProductStatus = zod_1.default.enum(["DRAFT", "ACTIVE", "OUT_OF_STOCK", "ARCHIVED"]);
+/** Тип доставки варианта */
+exports.DeliveryType = zod_1.default.enum(["AUTOMATIC", "MANUAL", "BOT"]);
+/** Тип медиа-контента */
+exports.MediaType = zod_1.default.enum(["SCREENSHOT", "SLIDER", "VIDEO", "TRAILER"]);
+/** Статус ключа */
+exports.KeyStatus = zod_1.default.enum(["AVAILABLE", "RESERVED", "SOLD"]);
+/** Тип системных требований */
+exports.SystemRequirementType = zod_1.default.enum(["minimum", "recommended"]);

package/build/commands/products/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./enums"), exports);
+__exportStar(require("./create"), exports);
+__exportStar(require("./update"), exports);
+__exportStar(require("./read"), exports);
+__exportStar(require("./query"), exports);
+__exportStar(require("./endpoints"), exports);

package/build/commands/products/query.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductFilterSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+/** Фильтры каталога продуктов */
+exports.ProductFilterSchema = zod_1.default.object({
+    /** Slug категории */
+    category: zod_1.default.string().optional(),
+    /** Тип продукта (GAME_KEY, TOPUP, ...) */
+    type: zod_1.default.string().optional(),
+    /** Slugs жанров через запятую */
+    genre: zod_1.default.string().optional(),
+    /** Slugs тегов через запятую */
+    tag: zod_1.default.string().optional(),
+    /** Код региона (RU, TR, KZ, GLOBAL) */
+    region: zod_1.default.string().optional(),
+    /** Платформа (Steam, Epic Games, ...) */
+    platform: zod_1.default.string().optional(),
+    /** Минимальная цена */
+    minPrice: zod_1.default.coerce.number().optional(),
+    /** Максимальная цена */
+    maxPrice: zod_1.default.coerce.number().optional(),
+    /** Фильтр: мультиплеер */
+    hasMultiplayer: zod_1.default
+        .enum(["true", "false"])
+        .transform(v => v === "true")
+        .optional(),
+    /** Фильтр: кооператив */
+    hasCoop: zod_1.default
+        .enum(["true", "false"])
+        .transform(v => v === "true")
+        .optional(),
+    /** Фильтр: издатель (частичное совпадение) */
+    publisher: zod_1.default.string().optional(),
+    /** Минимальный рейтинг */
+    minRating: zod_1.default.coerce.number().optional(),
+    /** Фильтр: наличие скидки */
+    hasDiscount: zod_1.default
+        .enum(["true", "false"])
+        .transform(v => v === "true")
+        .optional(),
+    /** Поиск по названию */
+    search: zod_1.default.string().optional(),
+    /** Поле сортировки */
+    sortBy: zod_1.default.enum(["price", "popularity", "rating", "releaseDate", "title"]).default("popularity"),
+    /** Направление сортировки */
+    sortDir: zod_1.default.enum(["asc", "desc"]).default("desc"),
+    /** Смещение для пагинации */
+    skip: zod_1.default.coerce.number().default(0),
+    /** Количество записей */
+    take: zod_1.default.coerce.number().default(20),
+});