@gigapay-dev/contracts 1.8.1 → 1.8.3

package/build/commands/index.js

@@ -25,4 +25,4 @@ __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);

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/settings/endpoints.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettingsEndpoints = void 0;
+const zod_1 = require("zod");
+const read_1 = require("./read");
+const update_1 = require("./update");
+exports.SettingsEndpoints = {
+    getAll: {
+        method: "GET",
+        path: "/settings",
+        request: zod_1.z.object({}),
+        response: read_1.SettingsReadResponseSchema,
+    },
+    getOne: {
+        method: "GET",
+        path: "/settings/:key",
+        request: zod_1.z.object({
+            key: zod_1.z.string(),
+        }),
+        response: zod_1.z.object({
+            key: zod_1.z.string(),
+            value: zod_1.z.union([zod_1.z.string(), zod_1.z.boolean()]),
+        }),
+    },
+    updateAll: {
+        method: "PUT",
+        path: "/settings",
+        request: update_1.SettingsUpdateRequestSchema,
+        response: read_1.SettingsReadResponseSchema,
+    },
+    updateOne: {
+        method: "PUT",
+        path: "/settings/:key",
+        request: zod_1.z.object({
+            key: zod_1.z.string(),
+            value: zod_1.z.union([zod_1.z.string(), zod_1.z.boolean()]),
+        }),
+        response: zod_1.z.object({
+            key: zod_1.z.string(),
+            value: zod_1.z.union([zod_1.z.string(), zod_1.z.boolean()]),
+        }),
+    },
+};

package/build/commands/settings/index.js

@@ -0,0 +1,19 @@
+"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("./read"), exports);
+__exportStar(require("./update"), exports);
+__exportStar(require("./endpoints"), exports);

package/build/commands/settings/read.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettingsReadResponseSchema = void 0;
+const zod_1 = require("zod");
+exports.SettingsReadResponseSchema = zod_1.z.object({
+    desslyDiscount: zod_1.z.string(),
+    serviceEnabled: zod_1.z.boolean(),
+    worksEnabled: zod_1.z.boolean(),
+    paymentsEnabled: zod_1.z.boolean(),
+});

package/build/commands/settings/update.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettingsUpdateRequestSchema = void 0;
+const zod_1 = require("zod");
+exports.SettingsUpdateRequestSchema = zod_1.z.object({
+    desslyDiscount: zod_1.z.string().optional(),
+    serviceEnabled: zod_1.z.boolean().optional(),
+    worksEnabled: zod_1.z.boolean().optional(),
+    paymentsEnabled: zod_1.z.boolean().optional(),
+});

package/commands/index.ts

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

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>;

package/commands/settings/endpoints.ts

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { EndpointContract } from "../../types";
+import { SettingsReadResponseSchema } from "./read";
+import { SettingsUpdateRequestSchema } from "./update";
+
+export const SettingsEndpoints = {
+    getAll: {
+        method: "GET",
+        path: "/settings",
+        request: z.object({}),
+        response: SettingsReadResponseSchema,
+    },
+    getOne: {
+        method: "GET",
+        path: "/settings/:key",
+        request: z.object({
+            key: z.string(),
+        }),
+        response: z.object({
+            key: z.string(),
+            value: z.union([z.string(), z.boolean()]),
+        }),
+    },
+    updateAll: {
+        method: "PUT",
+        path: "/settings",
+        request: SettingsUpdateRequestSchema,
+        response: SettingsReadResponseSchema,
+    },
+    updateOne: {
+        method: "PUT",
+        path: "/settings/:key",
+        request: z.object({
+            key: z.string(),
+            value: z.union([z.string(), z.boolean()]),
+        }),
+        response: z.object({
+            key: z.string(),
+            value: z.union([z.string(), z.boolean()]),
+        }),
+    },
+} satisfies Record<string, EndpointContract>;
+
+export type SettingsEndpointKey = keyof typeof SettingsEndpoints;
+
+export type GetSettingsRequest<K extends SettingsEndpointKey> = z.infer<
+    typeof SettingsEndpoints[K]["request"]
+>;
+
+export type GetSettingsResponse<K extends SettingsEndpointKey> = z.infer<
+    typeof SettingsEndpoints[K]["response"]
+>;

package/commands/settings/index.ts

@@ -0,0 +1,3 @@
+export * from "./read";
+export * from "./update";
+export * from "./endpoints";

package/commands/settings/read.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+
+export const SettingsReadResponseSchema = z.object({
+    desslyDiscount: z.string(),
+    serviceEnabled: z.boolean(),
+    worksEnabled: z.boolean(),
+    paymentsEnabled: z.boolean(),
+});
+
+export type SettingsReadResponse = z.infer<typeof SettingsReadResponseSchema>;

package/commands/settings/update.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+
+export const SettingsUpdateRequestSchema = z.object({
+    desslyDiscount: z.string().optional(),
+    serviceEnabled: z.boolean().optional(),
+    worksEnabled: z.boolean().optional(),
+    paymentsEnabled: z.boolean().optional(),
+});
+
+export type SettingsUpdateRequest = z.infer<typeof SettingsUpdateRequestSchema>;

package/commands/stats/endpoints.ts

@@ -3,6 +3,8 @@ import { EndpointContract } from "../../types";
 import { StatsReadResponseSchema } from "./read";
 import { StatsReadRequestSchema } from "./query";
 
+
+
 export const StatsEndpoints = {
     list: {
         method: "GET",
@@ -15,7 +17,7 @@ export const StatsEndpoints = {
 export type StatsEndpointKey = keyof typeof StatsEndpoints;
 
 export type GetStatsRequest<K extends StatsEndpointKey> =
-  z.infer<typeof StatsEndpoints[K]["request"]>;
+    z.infer<typeof StatsEndpoints[K]["request"]>;
 
 export type GetStatsResponse<K extends StatsEndpointKey> =
-  z.infer<typeof StatsEndpoints[K]["response"]>;
+    z.infer<typeof StatsEndpoints[K]["response"]>;

package/commands/stats/query.ts

@@ -1,18 +1,18 @@
 import z from "zod";
 
 export const StatsReadRequestSchema = z
-  .object({
-    period: z.enum(["day", "week", "month", "year", "custom"]).default("day"),
-    start: z.string().datetime().optional(),
-    end: z.string().datetime().optional(),
-  })
-  .refine(
-    v => v.period !== "custom" || (v.start && v.end),
-    { message: "from/to обязательны при period=custom" }
-  )
-  .refine(
-    v => v.period !== "custom" || (new Date(v.start!) < new Date(v.end!)),
-    { message: "from должен быть раньше to" }
-  );
+    .object({
+        period: z.enum(["day", "week", "month", "year", "custom"]).default("day"),
+        start: z.string().datetime().optional(),
+        end: z.string().datetime().optional(),
+    })
+    .refine(
+        v => v.period !== "custom" || (v.start && v.end),
+        { message: "from/to обязательны при period=custom" }
+    )
+    .refine(
+        v => v.period !== "custom" || (new Date(v.start!) < new Date(v.end!)),
+        { message: "from должен быть раньше to" }
+    );
 
-export type StatsReadRequest = z.infer<typeof StatsReadRequestSchema>;
+export type StatsReadRequest = z.infer<typeof StatsReadRequestSchema>;

package/commands/stats/read.ts

@@ -1,14 +1,14 @@
 import z from "zod";
 
 export const StatsReadResponseSchema = z.object({
-	usersCount: z.coerce.number().nonnegative(),
-	ordersCount: z.coerce.number().nonnegative(),
-	totalAmount: z.coerce.number().nonnegative(),
-	acquiringCommission: z.coerce.number().nonnegative(),
-	serviceCommission: z.coerce.number().nonnegative(),
-	totalAmountWithCommission: z.coerce.number().nonnegative(),
-	periodStart: z.string().datetime().optional(),
-	periodEnd: z.string().datetime().optional(),
+    usersCount: z.coerce.number().nonnegative(),
+    ordersCount: z.coerce.number().nonnegative(),
+    totalAmount: z.coerce.number().nonnegative(),
+    acquiringCommission: z.coerce.number().nonnegative(),
+    serviceCommission: z.coerce.number().nonnegative(),
+    totalAmountWithCommission: z.coerce.number().nonnegative(),
+    periodStart: z.string().datetime().optional(),
+    periodEnd: z.string().datetime().optional(),
 });
 
 export type StatsReadResponse = z.infer<typeof StatsReadResponseSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gigapay-dev/contracts",
-  "version": "1.8.1",
+  "version": "1.8.3",
   "main": "./build/index.js",
   "scripts": {  
     "test": "echo \"Error: no test specified\" && exit 1",

package/commands/status/endpoints.ts

@@ -1,40 +0,0 @@
-import { z } from "zod";
-import { EndpointContract } from "../../types";
-import { StatusReadResponseSchema } from "./read";
-
-export const StatusEndpoints = {
-    list: {
-        method: "GET",
-        path: "/status",
-        request: z.object({}),
-        response: StatusReadResponseSchema,
-    },
-    get: {
-        method: "GET",
-        path: "/status/:key",
-        request: z.object({
-            key: z.string(),
-        }),
-        response: z.object({
-            key: z.string(),
-            value: z.boolean(),
-        }),
-    },
-    set: {
-        method: "POST",
-        path: "/status/:key",
-        request: z.object({
-            key: z.string(),
-            value: z.boolean(),
-        }),
-        response: StatusReadResponseSchema,
-    },
-} satisfies Record<string, EndpointContract>;
-
-export type StatusEndpointKey = keyof typeof StatusEndpoints;
-
-export type GetStatusRequest<K extends StatusEndpointKey> =
-  z.infer<typeof StatusEndpoints[K]["request"]>;
-
-export type GetStatusResponse<K extends StatusEndpointKey> =
-  z.infer<typeof StatusEndpoints[K]["response"]>;

package/commands/status/index.ts

@@ -1,2 +0,0 @@
-export * from "./read";
-export * from "./endpoints";

package/commands/status/read.ts

@@ -1,9 +0,0 @@
-import z from "zod";
-
-export const StatusReadResponseSchema = z.object({
-    service: z.boolean(),
-	works: z.boolean(),
-	payments: z.boolean(),
-});
-
-export type StatusReadResponse = z.infer<typeof StatusReadResponseSchema>;