@gigapay-dev/contracts 1.8.2 → 1.8.4

package/build/commands/products/read.js

@@ -0,0 +1,176 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeysCountResponseSchema = exports.ProductDetailResponseSchema = exports.ProductCatalogResponseSchema = exports.DlcBriefSchema = exports.SystemRequirementsResponseSchema = exports.MediaResponseSchema = exports.VariantDetailSchema = exports.VariantCatalogSchema = exports.RegionResponseSchema = exports.RegionBriefSchema = exports.TagBriefSchema = exports.GenreResponseSchema = exports.GenreBriefSchema = exports.CategoryResponseSchema = exports.CategoryBriefSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+// === Вложенные схемы ===
+/** Категория (краткая) */
+exports.CategoryBriefSchema = zod_1.default.object({
+    slug: zod_1.default.string(),
+    name: zod_1.default.string(),
+});
+/** Категория (полная, для списка категорий) */
+exports.CategoryResponseSchema = zod_1.default.object({
+    id: zod_1.default.number(),
+    slug: zod_1.default.string(),
+    name: zod_1.default.string(),
+    description: zod_1.default.string().nullable(),
+    iconUrl: zod_1.default.string().nullable(),
+    _count: zod_1.default.object({
+        products: zod_1.default.number(),
+    }),
+});
+/** Жанр (краткий, без ID) */
+exports.GenreBriefSchema = zod_1.default.object({
+    slug: zod_1.default.string(),
+    name: zod_1.default.string(),
+});
+/** Жанр (полный, для списка жанров) */
+exports.GenreResponseSchema = zod_1.default.object({
+    id: zod_1.default.number(),
+    slug: zod_1.default.string(),
+    name: zod_1.default.string(),
+    _count: zod_1.default.object({
+        products: zod_1.default.number(),
+    }),
+});
+/** Тег */
+exports.TagBriefSchema = zod_1.default.object({
+    id: zod_1.default.number(),
+    slug: zod_1.default.string(),
+    name: zod_1.default.string(),
+});
+/** Регион (краткий, без ID) */
+exports.RegionBriefSchema = zod_1.default.object({
+    code: zod_1.default.string(),
+    name: zod_1.default.string(),
+});
+/** Регион (полный, для списка регионов) */
+exports.RegionResponseSchema = zod_1.default.object({
+    id: zod_1.default.number(),
+    code: zod_1.default.string(),
+    name: zod_1.default.string(),
+    _count: zod_1.default.object({
+        products: zod_1.default.number(),
+    }),
+});
+/** Вариант в каталоге (краткий) */
+exports.VariantCatalogSchema = zod_1.default.object({
+    id: zod_1.default.number(),
+    name: zod_1.default.string(),
+    price: zod_1.default.string(),
+    originalPrice: zod_1.default.string().nullable(),
+    platform: zod_1.default.string().nullable(),
+    regionCode: zod_1.default.string().nullable(),
+});
+/** Вариант в детальной карточке */
+exports.VariantDetailSchema = zod_1.default.object({
+    id: zod_1.default.number(),
+    name: zod_1.default.string(),
+    sku: zod_1.default.string(),
+    price: zod_1.default.string(),
+    originalPrice: zod_1.default.string().nullable(),
+    topupAmount: zod_1.default.string().nullable(),
+    currency: zod_1.default.string().nullable(),
+    durationDays: zod_1.default.number().nullable(),
+    platform: zod_1.default.string().nullable(),
+    regionCode: zod_1.default.string().nullable(),
+    deliveryType: zod_1.default.string(),
+    inStock: zod_1.default.boolean(),
+});
+/** Медиа */
+exports.MediaResponseSchema = zod_1.default.object({
+    id: zod_1.default.number(),
+    type: zod_1.default.string(),
+    url: zod_1.default.string(),
+    alt: zod_1.default.string().nullable(),
+});
+/** Системные требования */
+exports.SystemRequirementsResponseSchema = zod_1.default.object({
+    type: zod_1.default.string(),
+    os: zod_1.default.string().nullable(),
+    processor: zod_1.default.string().nullable(),
+    memory: zod_1.default.string().nullable(),
+    graphics: zod_1.default.string().nullable(),
+    storage: zod_1.default.string().nullable(),
+    directx: zod_1.default.string().nullable(),
+    network: zod_1.default.string().nullable(),
+    additional: zod_1.default.string().nullable(),
+});
+/** DLC в детальной карточке */
+exports.DlcBriefSchema = zod_1.default.object({
+    id: zod_1.default.number(),
+    slug: zod_1.default.string(),
+    title: zod_1.default.string(),
+    coverImageUrl: zod_1.default.string().nullable(),
+    variants: zod_1.default.array(zod_1.default.object({
+        price: zod_1.default.any(),
+        originalPrice: zod_1.default.any(),
+    })),
+});
+// === Основные схемы ответов ===
+/** Продукт в каталоге (карточка) */
+exports.ProductCatalogResponseSchema = zod_1.default.object({
+    id: zod_1.default.number(),
+    slug: zod_1.default.string(),
+    title: zod_1.default.string(),
+    type: zod_1.default.string(),
+    shortDescription: zod_1.default.string().nullable(),
+    coverImageUrl: zod_1.default.string().nullable(),
+    steamRating: zod_1.default.number().nullable(),
+    hasMultiplayer: zod_1.default.boolean(),
+    hasCoop: zod_1.default.boolean(),
+    salesCount: zod_1.default.number(),
+    publisher: zod_1.default.string().nullable(),
+    releaseDate: zod_1.default.coerce.date().nullable(),
+    category: exports.CategoryBriefSchema,
+    genres: zod_1.default.array(exports.GenreBriefSchema),
+    regions: zod_1.default.array(exports.RegionBriefSchema),
+    variants: zod_1.default.array(exports.VariantCatalogSchema),
+    minPrice: zod_1.default.string().nullable(),
+    hasDiscount: zod_1.default.boolean(),
+});
+/** Продукт (полная детальная карточка) */
+exports.ProductDetailResponseSchema = zod_1.default.object({
+    id: zod_1.default.number(),
+    slug: zod_1.default.string(),
+    title: zod_1.default.string(),
+    originalTitle: zod_1.default.string().nullable(),
+    type: zod_1.default.string(),
+    status: zod_1.default.string(),
+    description: zod_1.default.string().nullable(),
+    customDescription: zod_1.default.string().nullable(),
+    shortDescription: zod_1.default.string().nullable(),
+    coverImageUrl: zod_1.default.string().nullable(),
+    developer: zod_1.default.string().nullable(),
+    publisher: zod_1.default.string().nullable(),
+    releaseDate: zod_1.default.coerce.date().nullable(),
+    steamAppId: zod_1.default.number().nullable(),
+    steamRating: zod_1.default.number().nullable(),
+    hasMultiplayer: zod_1.default.boolean(),
+    hasCoop: zod_1.default.boolean(),
+    hasSinglePlayer: zod_1.default.boolean(),
+    metaTitle: zod_1.default.string().nullable(),
+    metaDescription: zod_1.default.string().nullable(),
+    salesCount: zod_1.default.number(),
+    viewsCount: zod_1.default.number(),
+    category: exports.CategoryBriefSchema.extend({ id: zod_1.default.number() }),
+    variants: zod_1.default.array(exports.VariantDetailSchema),
+    media: zod_1.default.array(exports.MediaResponseSchema),
+    genres: zod_1.default.array(exports.TagBriefSchema),
+    tags: zod_1.default.array(exports.TagBriefSchema),
+    regions: zod_1.default.array(exports.RegionResponseSchema.omit({ _count: true })),
+    systemRequirements: zod_1.default.array(exports.SystemRequirementsResponseSchema),
+    dlcs: zod_1.default.array(exports.DlcBriefSchema),
+    createdAt: zod_1.default.coerce.date(),
+    updatedAt: zod_1.default.coerce.date(),
+});
+/** Статистика ключей по варианту */
+exports.KeysCountResponseSchema = zod_1.default.object({
+    available: zod_1.default.number(),
+    sold: zod_1.default.number(),
+    reserved: zod_1.default.number(),
+    total: zod_1.default.number(),
+});

package/build/commands/products/update.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductUpdateRequestSchema = void 0;
+const create_1 = require("./create");
+const enums_1 = require("./enums");
+/** Запрос на обновление продукта (частичное) */
+exports.ProductUpdateRequestSchema = create_1.ProductCreateRequestSchema.partial().extend({
+    /** Статус продукта */
+    status: enums_1.ProductStatus.optional(),
+});

package/commands/index.ts

@@ -9,5 +9,5 @@ export * from './payment-methods';
 export * from './api-response';
 export * from './users';
 export * from './stats';
-export * from './status';
-export * from './settings';
+export * from './settings';
+export * from './products';

package/commands/orders/create.ts

@@ -1,22 +1,41 @@
 import z from "zod";
 import { OrderType } from "./enums";
 
+export const OrderItemInputSchema = z.object({
+	variantId: z.coerce.number().int().positive(),
+	quantity: z.coerce.number().int().min(1).default(1),
+	gameUsername: z.string().max(255).optional(),
+	gameUsernameType: z.string().max(64).optional(),
+});
+
+/** Запрос на создание заказа */
 export const OrderCreateRequestSchema = z.object({
-    email: z.string().email(),
-    steamUsername: z.string(),
-    amount: z.coerce.number().nonnegative(),
-    userId: z.coerce.number().positive().optional(),
-    paymentMethodId: z.coerce.number().positive(),
-    promocodeId: z.coerce.number().positive().optional(),
-    type: OrderType.optional().default('MAIN'),
-    utmSource: z.string().optional(),
+	/** Email покупателя */
+	email: z.string().email(),
+	/** ID способа оплаты */
+	paymentMethodId: z.coerce.number().positive(),
+	/** Список товаров в заказе (минимум 1) */
+	items: z.array(OrderItemInputSchema).min(1),
+	/** ID промокода (опционально) */
+	promocodeId: z.coerce.number().positive().optional(),
+	/** ID существующего пользователя (опционально) */
+	userId: z.coerce.number().positive().optional(),
+	/** Telegram ID покупателя (опционально) */
+	telegramId: z.string().optional(),
+	/** UTM-метка источника трафика */
+	utmSource: z.string().optional(),
+	/** Тип дизайна формы оплаты */
 	designType: z.string().optional(),
-    telegramId: z.string().optional(),
+	/** Тип заказа: MAIN (сайт) или WEBAPP (Telegram Mini App) */
+	type: OrderType.optional().default("MAIN"),
 });
 
+/** Ответ на создание заказа — ссылка для оплаты */
 export const OrderCreateResponseSchema = z.object({
-    redirectUrl: z.string(),
+	/** URL для редиректа на платёжную страницу */
+	redirectUrl: z.string(),
 });
 
+export type OrderItemInput = z.infer<typeof OrderItemInputSchema>;
 export type OrderCreateRequest = z.infer<typeof OrderCreateRequestSchema>;
-export type OrderCreateResponse = z.infer<typeof OrderCreateResponseSchema>;
+export type OrderCreateResponse = z.infer<typeof OrderCreateResponseSchema>;

package/commands/orders/endpoints.ts

@@ -1,55 +1,51 @@
 import z from "zod";
-
-import {
-  OrderReadResponseSchema,
-} from "./read";
-
+import { OrderReadResponseSchema } from "./read";
 import { EndpointContract } from "../../types";
 import { OrderCreateRequestSchema, OrderCreateResponseSchema } from "./create";
 import { OrdersListQuerySchema } from "./query";
 
 export const OrderEndpoints = {
-    create: {
-        method: "POST",
-        path: "/orders",
-        request: OrderCreateRequestSchema,
-        response: OrderCreateResponseSchema,
-    },
-    list: {
-        method: "GET",
-        path: "/orders",
-        request: OrdersListQuerySchema,
-        response: z.array(OrderReadResponseSchema),
-    },
-    getById: {
-        method: "GET",
-        path: "/orders/:id",
-        request: z.object({
-            id: z.coerce.number().positive(),
-        }),
-        response: OrderReadResponseSchema,
-    },
-    getUserOrders: {
-        method: "GET",
-        path: "/orders/user",
-        request: OrdersListQuerySchema,
-        response: z.array(OrderReadResponseSchema),
-    },
-    getUserOrderById: {
-        method: "GET",
-        path: "/orders/user/:userId/:orderId",
-        request: z.object({
-            userId: z.coerce.number().positive(),
-            orderId: z.coerce.number().positive(),
-        }),
-        response: OrderReadResponseSchema,
-    },
+	create: {
+		method: "POST",
+		path: "/orders",
+		request: OrderCreateRequestSchema,
+		response: OrderCreateResponseSchema,
+	},
+	list: {
+		method: "GET",
+		path: "/orders",
+		request: OrdersListQuerySchema,
+		response: z.array(OrderReadResponseSchema),
+	},
+	getById: {
+		method: "GET",
+		path: "/orders/:id",
+		request: z.object({
+			id: z.coerce.number().positive(),
+		}),
+		response: OrderReadResponseSchema,
+	},
+	getUserOrders: {
+		method: "GET",
+		path: "/orders/user",
+		request: OrdersListQuerySchema,
+		response: z.array(OrderReadResponseSchema),
+	},
+	getUserOrderById: {
+		method: "GET",
+		path: "/orders/user/:userId/:orderId",
+		request: z.object({
+			userId: z.coerce.number().positive(),
+			orderId: z.coerce.number().positive(),
+		}),
+		response: OrderReadResponseSchema,
+	},
 } satisfies Record<string, EndpointContract>;
 
 export type OrderEndpointKey = keyof typeof OrderEndpoints;
 
 export type GetOrderRequest<K extends OrderEndpointKey> =
-  z.infer<typeof OrderEndpoints[K]["request"]>;
+	z.infer<typeof OrderEndpoints[K]["request"]>;
 
 export type GetOrderResponse<K extends OrderEndpointKey> =
-  z.infer<typeof OrderEndpoints[K]["response"]>;
+	z.infer<typeof OrderEndpoints[K]["response"]>;

package/commands/orders/enums.ts

@@ -1,7 +1,25 @@
 import z from "zod";
 
 export const OrderType = z.enum(["MAIN", "WEBAPP"]);
-
 export type OrderType = z.infer<typeof OrderType>;
-  
 
+export const OrderStatus = z.enum([
+	"PENDING",
+	"AWAITING_PAYMENT",
+	"PAID",
+	"PROCESSING",
+	"SUCCESS",
+	"FAILED",
+	"REFUNDED",
+	"CANCELLED",
+]);
+export type OrderStatus = z.infer<typeof OrderStatus>;
+
+export const OrderItemStatus = z.enum([
+	"PENDING",
+	"PROCESSING",
+	"DELIVERED",
+	"FAILED",
+	"REFUNDED",
+]);
+export type OrderItemStatus = z.infer<typeof OrderItemStatus>;

package/commands/orders/index.ts

@@ -1,5 +1,6 @@
-export * from './create'
-export * from './update'
-export * from './read'
-export * from './query'
-export * from './endpoints'
+export * from "./enums";
+export * from "./create";
+export * from "./update";
+export * from "./read";
+export * from "./query";
+export * from "./endpoints";

package/commands/orders/query.ts

@@ -1,33 +1,46 @@
 import z from "zod";
 import { PaginationQuery } from "../pagination";
+import { OrderStatus } from "./enums";
 
+/** Фильтр по периоду (базовая схема без refinements для merge) */
 const OrdersPeriodBase = z.object({
-  period: z.enum(["day", "week", "month", "year", "custom"]).optional(),
-  start: z.string().datetime().optional(),
-  end: z.string().datetime().optional(),
+	/** Предустановленный период: day, week, month, year, custom */
+	period: z.enum(["day", "week", "month", "year", "custom"]).optional(),
+	/** Начало периода (ISO datetime, обязателен при period=custom) */
+	start: z.string().datetime().optional(),
+	/** Конец периода (ISO datetime, обязателен при period=custom) */
+	end: z.string().datetime().optional(),
 });
+
+/** Фильтр по периоду с валидацией custom-диапазона */
 export const OrdersPeriodSchema = OrdersPeriodBase
-  .refine(v => v.period !== "custom" || (v.start && v.end), {
-    message: "start/end обязательны при period=custom",
-  })
-  .refine(v => v.period !== "custom" || new Date(v.start!) < new Date(v.end!), {
-    message: "start должен быть раньше end",
-});
+	.refine(v => v.period !== "custom" || (v.start && v.end), {
+		message: "start/end обязательны при period=custom",
+	})
+	.refine(v => v.period !== "custom" || new Date(v.start!) < new Date(v.end!), {
+		message: "start должен быть раньше end",
+	});
 
+/** Фильтры списка заказов */
 export const OrdersFiltersSchema = z.object({
-  email: z.string().email().optional(),
-  steamUsername: z.string().min(1).optional(),
-  status: z.enum(["PENDING", "SUCCESS", "FAILED", "CANCELED"]).optional(),
+	/** Фильтр по email покупателя (частичное совпадение) */
+	email: z.string().optional(),
+	/** Фильтр по статусу заказа */
+	status: OrderStatus.optional(),
 });
 
+/** Сортировка списка заказов */
 export const OrdersSortSchema = z.object({
-  sortBy: z.string().default("createdAt"),
-  sortDir: z.enum(["asc", "desc"]).default("desc"),
+	/** Поле для сортировки: createdAt, updatedAt, total, subtotal */
+	sortBy: z.enum(["createdAt", "updatedAt", "total", "subtotal"]).default("createdAt"),
+	/** Направление сортировки */
+	sortDir: z.enum(["asc", "desc"]).default("desc"),
 });
 
+/** Объединённая схема запроса списка заказов */
 export const OrdersListQuerySchema = PaginationQuery
-  .merge(OrdersFiltersSchema)
-  .merge(OrdersSortSchema)
-  .merge(OrdersPeriodBase);
+	.merge(OrdersFiltersSchema)
+	.merge(OrdersSortSchema)
+	.merge(OrdersPeriodBase);
 
 export type OrdersListQuery = z.infer<typeof OrdersListQuerySchema>;

package/commands/orders/read.ts

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

package/commands/orders/update.ts

@@ -1,14 +1,16 @@
 import { z } from "zod";
+import { OrderStatus } from "./enums";
 
+/** Запрос на обновление заказа (администратором) */
 export const OrderUpdateRequestSchema = z.object({
-    email: z.string().email().optional(),
-    amount: z.coerce.number().nonnegative().optional(),
-    steamUsername: z.string().optional(),
-    userId: z.coerce.number().positive().optional(),
-    paymentMethodId: z.coerce.number().positive().optional(),
-    paymentId: z.coerce.number().positive().optional(),
-    promocodeId: z.coerce.number().positive().optional(),
-    comission: z.coerce.number().nonnegative().optional(),
-})
+	/** Новый статус заказа */
+	status: OrderStatus.optional(),
+	/** Email покупателя */
+	email: z.string().email().optional(),
+	/** ID способа оплаты */
+	paymentMethodId: z.coerce.number().positive().optional(),
+	/** ID промокода */
+	promocodeId: z.coerce.number().positive().optional(),
+});
 
-export type OrderUpdateRequest = z.infer<typeof OrderUpdateRequestSchema>
+export type OrderUpdateRequest = z.infer<typeof OrderUpdateRequestSchema>;