@makebelieve21213-packages/nest-common 1.0.0

package/dist/utils/compression.utils.js

@@ -0,0 +1,25 @@
+// Создает опции compression для NestJS приложения
+export default function createCompressionOptions(config = {}) {
+    const { filter = (req, res) => {
+        // Фильтр по умолчанию: сжимаем только текстовые типы контента
+        if (req.headers && "accept-encoding" in req.headers) {
+            const contentType = res.getHeader("content-type");
+            return /text|json|javascript|css|xml|html/i.test((typeof contentType === "string" ? contentType : "") || "");
+        }
+        return false;
+    }, level = 6, // Уровень сжатия от 0 до 9
+    threshold = 1024, // Минимальный размер ответа для сжатия (в байтах)
+    chunkSize = 16 * 1024, // Размер чанка
+    windowBits = 15, memLevel = 8, strategy, dictionary, } = config;
+    return {
+        filter,
+        level,
+        threshold,
+        chunkSize,
+        windowBits,
+        memLevel,
+        ...(strategy !== undefined && { strategy }),
+        ...(dictionary !== undefined && { dictionary }),
+    };
+}
+//# sourceMappingURL=compression.utils.js.map

package/dist/utils/compression.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.utils.js","sourceRoot":"","sources":["../../src/utils/compression.utils.ts"],"names":[],"mappings":"AAMA,kDAAkD;AAClD,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAC/C,SAAmC,EAAE;IAErC,MAAM,EACL,MAAM,GAAG,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QACxC,8DAA8D;QAC9D,IAAI,GAAG,CAAC,OAAO,IAAI,iBAAiB,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YACrD,MAAM,WAAW,GAAG,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;YAClD,OAAO,oCAAoC,CAAC,IAAI,CAC/C,CAAC,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAC1D,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC,EACD,KAAK,GAAG,CAAC,EAAE,2BAA2B;IACtC,SAAS,GAAG,IAAI,EAAE,kDAAkD;IACpE,SAAS,GAAG,EAAE,GAAG,IAAI,EAAE,eAAe;IACtC,UAAU,GAAG,EAAE,EACf,QAAQ,GAAG,CAAC,EACZ,QAAQ,EACR,UAAU,GACV,GAAG,MAAM,CAAC;IAEX,OAAO;QACN,MAAM;QACN,KAAK;QACL,SAAS;QACT,SAAS;QACT,UAAU;QACV,QAAQ;QACR,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC3C,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,CAAC;KAC/C,CAAC;AACH,CAAC"}

package/dist/utils/context.utils.d.ts

@@ -0,0 +1,7 @@
+import type { ExecutionContext } from "@nestjs/common";
+import type { UserFromContext } from "../types/context-types.js";
+export declare function getUserFromContext(context: ExecutionContext): UserFromContext | undefined;
+export declare function getIpFromContext(context: ExecutionContext): string;
+export declare function getUserAgentFromContext(context: ExecutionContext): string;
+export declare function getRequestIdFromContext(context: ExecutionContext): string;
+//# sourceMappingURL=context.utils.d.ts.map

package/dist/utils/context.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.utils.d.ts","sourceRoot":"","sources":["../../src/utils/context.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAmB,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGhF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,GAAG,SAAS,CAGzF;AAGD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAQlE;AAGD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAGzE;AAGD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAGzE"}

package/dist/utils/context.utils.js

@@ -0,0 +1,24 @@
+// Извлекает пользователя из контекста запроса
+export function getUserFromContext(context) {
+    const request = context.switchToHttp().getRequest();
+    return request.user;
+}
+// Извлекает IP адрес из контекста запроса
+export function getIpFromContext(context) {
+    const request = context.switchToHttp().getRequest();
+    return (request.headers["x-forwarded-for"]?.split(",")[0] ||
+        request.ip ||
+        request.socket.remoteAddress ||
+        "unknown");
+}
+// Извлекает User-Agent из контекста запроса
+export function getUserAgentFromContext(context) {
+    const request = context.switchToHttp().getRequest();
+    return request.headers["user-agent"] || "unknown";
+}
+// Извлекает Request ID из контекста запроса
+export function getRequestIdFromContext(context) {
+    const request = context.switchToHttp().getRequest();
+    return request.headers["x-request-id"] || request.id || "unknown";
+}
+//# sourceMappingURL=context.utils.js.map

package/dist/utils/context.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.utils.js","sourceRoot":"","sources":["../../src/utils/context.utils.ts"],"names":[],"mappings":"AAGA,8CAA8C;AAC9C,MAAM,UAAU,kBAAkB,CAAC,OAAyB;IAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAmB,CAAC;IACrE,OAAO,OAAO,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,gBAAgB,CAAC,OAAyB;IACzD,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAmB,CAAC;IACrE,OAAO,CACL,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7D,OAAO,CAAC,EAAE;QACV,OAAO,CAAC,MAAM,CAAC,aAAa;QAC5B,SAAS,CACT,CAAC;AACH,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,uBAAuB,CAAC,OAAyB;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAmB,CAAC;IACrE,OAAQ,OAAO,CAAC,OAAO,CAAC,YAAY,CAAY,IAAI,SAAS,CAAC;AAC/D,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,uBAAuB,CAAC,OAAyB;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAmB,CAAC;IACrE,OAAQ,OAAO,CAAC,OAAO,CAAC,cAAc,CAAY,IAAI,OAAO,CAAC,EAAE,IAAI,SAAS,CAAC;AAC/E,CAAC"}

package/dist/utils/cors.utils.d.ts

@@ -0,0 +1,4 @@
+import type { CorsOptions } from "@nestjs/common/interfaces/external/cors-options.interface.js";
+import type { CorsOptionsConfig } from "../types/cors-types.js";
+export default function createCorsOptions(config?: CorsOptionsConfig): CorsOptions;
+//# sourceMappingURL=cors.utils.d.ts.map

package/dist/utils/cors.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors.utils.d.ts","sourceRoot":"","sources":["../../src/utils/cors.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2DAA2D,CAAC;AAC7F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,MAAM,GAAE,iBAAsB,GAAG,WAAW,CA4BrF"}

package/dist/utils/cors.utils.js

@@ -0,0 +1,23 @@
+// Создает опции CORS для NestJS приложения
+export default function createCorsOptions(config = {}) {
+    const { origin = true, // Разрешаем все источники по умолчанию
+    methods = ["GET", "POST", "PUT", "DELETE", "PATCH", "OPTIONS"], allowedHeaders = [
+        "Content-Type",
+        "Authorization",
+        "X-Requested-With",
+        "X-Request-ID",
+        "X-API-Key",
+    ], exposedHeaders = ["X-Request-ID"], credentials = true, maxAge = 86400, // 24 часа
+    preflightContinue = false, optionsSuccessStatus = 204, } = config;
+    return {
+        origin,
+        methods,
+        allowedHeaders,
+        exposedHeaders,
+        credentials,
+        maxAge,
+        preflightContinue,
+        optionsSuccessStatus,
+    };
+}
+//# sourceMappingURL=cors.utils.js.map

package/dist/utils/cors.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors.utils.js","sourceRoot":"","sources":["../../src/utils/cors.utils.ts"],"names":[],"mappings":"AAGA,2CAA2C;AAC3C,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,SAA4B,EAAE;IACvE,MAAM,EACL,MAAM,GAAG,IAAI,EAAE,uCAAuC;IACtD,OAAO,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,EAC9D,cAAc,GAAG;QAChB,cAAc;QACd,eAAe;QACf,kBAAkB;QAClB,cAAc;QACd,WAAW;KACX,EACD,cAAc,GAAG,CAAC,cAAc,CAAC,EACjC,WAAW,GAAG,IAAI,EAClB,MAAM,GAAG,KAAK,EAAE,UAAU;IAC1B,iBAAiB,GAAG,KAAK,EACzB,oBAAoB,GAAG,GAAG,GAC1B,GAAG,MAAM,CAAC;IAEX,OAAO;QACN,MAAM;QACN,OAAO;QACP,cAAc;QACd,cAAc;QACd,WAAW;QACX,MAAM;QACN,iBAAiB;QACjB,oBAAoB;KACpB,CAAC;AACH,CAAC"}

package/dist/utils/env-validator.d.ts

@@ -0,0 +1,2 @@
+export default function validateEnv(env: Record<string, string>, requiredKeys: string[]): Record<string, string>;
+//# sourceMappingURL=env-validator.d.ts.map

package/dist/utils/env-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-validator.d.ts","sourceRoot":"","sources":["../../src/utils/env-validator.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,OAAO,UAAU,WAAW,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,YAAY,EAAE,MAAM,EAAE,GACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBxB"}

package/dist/utils/env-validator.js

@@ -0,0 +1,22 @@
+import Joi from "joi";
+import NestCommonError from "../errors/nest-common.error.js";
+// Валидация переменных окружения с использованием Joi
+export default function validateEnv(env, requiredKeys) {
+    // Создаем схему для валидации на основе списка обязательных ключей
+    const schemaFields = requiredKeys.reduce((acc, key) => {
+        acc[key] = Joi.string().required();
+        return acc;
+    }, {});
+    const schema = Joi.object(schemaFields).unknown(true);
+    const { error, value } = schema.validate(env, {
+        abortEarly: false,
+    });
+    if (error) {
+        const missingKeys = error.details
+            .map((detail) => detail.context?.key)
+            .filter((key) => Boolean(key));
+        throw new NestCommonError(`Missing env vars: ${missingKeys.join(", ")}`);
+    }
+    return value;
+}
+//# sourceMappingURL=env-validator.js.map

package/dist/utils/env-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-validator.js","sourceRoot":"","sources":["../../src/utils/env-validator.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,eAAe,MAAM,8BAA8B,CAAC;AAE3D,sDAAsD;AACtD,MAAM,CAAC,OAAO,UAAU,WAAW,CAClC,GAA2B,EAC3B,YAAsB;IAEtB,mEAAmE;IACnE,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CACvC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACZ,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;QACnC,OAAO,GAAG,CAAC;IACZ,CAAC,EACD,EAAsC,CACtC,CAAC;IAEF,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE;QAC7C,UAAU,EAAE,KAAK;KACjB,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACX,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO;aAC/B,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC;aACpC,MAAM,CAAC,CAAC,GAAG,EAAiB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAE/C,MAAM,IAAI,eAAe,CAAC,qBAAqB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/utils/file.utils.d.ts

@@ -0,0 +1,6 @@
+import type { MulterFile } from "../types/file-types.js";
+import type { FileValidationOptions, FileValidationResult } from "../types/file-validation-types.js";
+export declare function validateFile(file: MulterFile, options?: FileValidationOptions): FileValidationResult;
+export declare function getFileExtension(filename: string): string;
+export declare function formatFileSize(bytes: number): string;
+//# sourceMappingURL=file.utils.d.ts.map

package/dist/utils/file.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.utils.d.ts","sourceRoot":"","sources":["../../src/utils/file.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EACX,qBAAqB,EACrB,oBAAoB,EACpB,MAAM,iCAAiC,CAAC;AAGzC,wBAAgB,YAAY,CAC3B,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,qBAA0B,GACjC,oBAAoB,CAoCtB;AAGD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzD;AAGD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQpD"}

package/dist/utils/file.utils.js

@@ -0,0 +1,42 @@
+// Валидирует файл по заданным опциям
+export function validateFile(file, options = {}) {
+    const errors = [];
+    const { maxSize = 10 * 1024 * 1024, // 10MB по умолчанию
+    allowedMimeTypes, allowedExtensions, } = options;
+    // Проверка размера файла
+    if (file.size > maxSize) {
+        errors.push(`File size exceeds maximum allowed size of ${maxSize} bytes`);
+    }
+    // Проверка MIME типа
+    if (allowedMimeTypes && allowedMimeTypes.length > 0) {
+        if (!allowedMimeTypes.includes(file.mimetype)) {
+            errors.push(`File type ${file.mimetype} is not allowed. Allowed types: ${allowedMimeTypes.join(", ")}`);
+        }
+    }
+    // Проверка расширения файла
+    if (allowedExtensions && allowedExtensions.length) {
+        const fileExtension = file.originalname.split(".").pop()?.toLowerCase();
+        if (!fileExtension || !allowedExtensions.includes(fileExtension)) {
+            errors.push(`File extension ${fileExtension || "unknown"} is not allowed. Allowed extensions: ${allowedExtensions.join(", ")}`);
+        }
+    }
+    return {
+        isValid: !errors.length,
+        errors,
+    };
+}
+// Получает расширение файла из имени
+export function getFileExtension(filename) {
+    const parts = filename.split(".");
+    return parts.length > 1 ? parts[parts.length - 1].toLowerCase() : "";
+}
+// Форматирует размер файла в читаемый формат
+export function formatFileSize(bytes) {
+    if (!bytes)
+        return "0 Bytes";
+    const k = 1024;
+    const sizes = ["Bytes", "KB", "MB", "GB", "TB"];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return Math.round((bytes / Math.pow(k, i)) * 100) / 100 + " " + sizes[i];
+}
+//# sourceMappingURL=file.utils.js.map

package/dist/utils/file.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.utils.js","sourceRoot":"","sources":["../../src/utils/file.utils.ts"],"names":[],"mappings":"AAMA,qCAAqC;AACrC,MAAM,UAAU,YAAY,CAC3B,IAAgB,EAChB,UAAiC,EAAE;IAEnC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,EACL,OAAO,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,oBAAoB;IAChD,gBAAgB,EAChB,iBAAiB,GACjB,GAAG,OAAO,CAAC;IAEZ,yBAAyB;IACzB,IAAI,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,6CAA6C,OAAO,QAAQ,CAAC,CAAC;IAC3E,CAAC;IAED,qBAAqB;IACrB,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CACV,aAAa,IAAI,CAAC,QAAQ,mCAAmC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1F,CAAC;QACH,CAAC;IACF,CAAC;IAED,4BAA4B;IAC5B,IAAI,iBAAiB,IAAI,iBAAiB,CAAC,MAAM,EAAE,CAAC;QACnD,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC;QACxE,IAAI,CAAC,aAAa,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YAClE,MAAM,CAAC,IAAI,CACV,kBAAkB,aAAa,IAAI,SAAS,wCAAwC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClH,CAAC;QACH,CAAC;IACF,CAAC;IAED,OAAO;QACN,OAAO,EAAE,CAAC,MAAM,CAAC,MAAM;QACvB,MAAM;KACN,CAAC;AACH,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,cAAc,CAAC,KAAa;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,MAAM,CAAC,GAAG,IAAI,CAAC;IACf,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/utils/get-service-path.d.ts

@@ -0,0 +1,9 @@
+import type { GetServicePathOptions } from "../types/get-service-path-types.js";
+/**
+ * Универсальная функция для определения пути в сервисе
+ * независимо от точки запуска и режима (dev/production)
+ * Работает одинаково в dev (src) и production (dist) режимах,
+ * всегда используя пути относительно src/
+ */
+export default function getServicePath(options: GetServicePathOptions): string;
+//# sourceMappingURL=get-service-path.d.ts.map

package/dist/utils/get-service-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-service-path.d.ts","sourceRoot":"","sources":["../../src/utils/get-service-path.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAgE7E"}

package/dist/utils/get-service-path.js

@@ -0,0 +1,65 @@
+import { existsSync } from "fs";
+import { join, resolve } from "path";
+/**
+ * Универсальная функция для определения пути в сервисе
+ * независимо от точки запуска и режима (dev/production)
+ * Работает одинаково в dev (src) и production (dist) режимах,
+ * всегда используя пути относительно src/
+ */
+export default function getServicePath(options) {
+    const { serviceName, dirname, pathType, relativePath } = options;
+    // Определяем, начинается ли relativePath с "src/"
+    const pathWithoutSrc = relativePath.startsWith("src/") ? relativePath.slice(4) : relativePath;
+    // Находим корень сервиса (где находится папка src)
+    // Идем вверх от dirname до тех пор, пока не найдем папку src
+    let currentPath = dirname;
+    let serviceRoot = null;
+    const maxDepth = 10; // Защита от бесконечного цикла
+    for (let i = 0; i < maxDepth; i++) {
+        const srcPath = join(currentPath, "src");
+        if (existsSync(srcPath)) {
+            serviceRoot = currentPath;
+            break;
+        }
+        const parentPath = resolve(currentPath, "..");
+        if (parentPath === currentPath) {
+            // Достигли корня файловой системы
+            break;
+        }
+        currentPath = parentPath;
+    }
+    // Если не нашли через dirname, пробуем через process.cwd()
+    if (!serviceRoot) {
+        const cwdSrcPath = join(process.cwd(), "src");
+        if (existsSync(cwdSrcPath)) {
+            serviceRoot = process.cwd();
+        }
+    }
+    // Если все еще не нашли, пробуем через корень репозитория
+    if (!serviceRoot) {
+        const repoRoot = resolve(process.cwd(), "services", serviceName);
+        const repoSrcPath = join(repoRoot, "src");
+        if (existsSync(repoSrcPath)) {
+            serviceRoot = repoRoot;
+        }
+    }
+    // Если не нашли корень сервиса, выбрасываем ошибку
+    if (!serviceRoot) {
+        throw new Error(`Не удалось найти корень сервиса "${serviceName}". Проверьте, что папка src существует в сервисе или запустите из корня сервиса.`);
+    }
+    // Формируем итоговый путь в зависимости от типа
+    switch (pathType) {
+        case "srcRoot": {
+            return serviceRoot;
+        }
+        case "locales": {
+            // Всегда используем src/locales
+            return join(serviceRoot, "src", "locales");
+        }
+        case "file": {
+            // Всегда используем src/ для файлов
+            return join(serviceRoot, "src", pathWithoutSrc);
+        }
+    }
+}
+//# sourceMappingURL=get-service-path.js.map

package/dist/utils/get-service-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-service-path.js","sourceRoot":"","sources":["../../src/utils/get-service-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAIrC;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,OAA8B;IACpE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAEjE,kDAAkD;IAClD,MAAM,cAAc,GAAG,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAE9F,mDAAmD;IACnD,6DAA6D;IAC7D,IAAI,WAAW,GAAG,OAAO,CAAC;IAC1B,IAAI,WAAW,GAAkB,IAAI,CAAC;IACtC,MAAM,QAAQ,GAAG,EAAE,CAAC,CAAC,+BAA+B;IAEpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACzC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,WAAW,GAAG,WAAW,CAAC;YAC1B,MAAM;QACP,CAAC;QACD,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;YAChC,kCAAkC;YAClC,MAAM;QACP,CAAC;QACD,WAAW,GAAG,UAAU,CAAC;IAC1B,CAAC;IAED,2DAA2D;IAC3D,IAAI,CAAC,WAAW,EAAE,CAAC;QAClB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;QAC9C,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC7B,CAAC;IACF,CAAC;IAED,0DAA0D;IAC1D,IAAI,CAAC,WAAW,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QACjE,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC1C,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,WAAW,GAAG,QAAQ,CAAC;QACxB,CAAC;IACF,CAAC;IAED,mDAAmD;IACnD,IAAI,CAAC,WAAW,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACd,oCAAoC,WAAW,kFAAkF,CACjI,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,QAAQ,QAAQ,EAAE,CAAC;QAClB,KAAK,SAAS,CAAC,CAAC,CAAC;YAChB,OAAO,WAAW,CAAC;QACpB,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YAChB,gCAAgC;YAChC,OAAO,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAC5C,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACb,oCAAoC;YACpC,OAAO,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;QACjD,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/utils/versioning.utils.d.ts

@@ -0,0 +1,4 @@
+import type { VersioningOptions } from "@nestjs/common/interfaces/version-options.interface.js";
+import type { VersioningOptionsConfig } from "../types/versioning-types.js";
+export default function createVersioningOptions(config: VersioningOptionsConfig): VersioningOptions;
+//# sourceMappingURL=versioning.utils.d.ts.map

package/dist/utils/versioning.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.utils.d.ts","sourceRoot":"","sources":["../../src/utils/versioning.utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qDAAqD,CAAC;AAC7F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAG1E,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC9C,MAAM,EAAE,uBAAuB,GAC7B,iBAAiB,CA8BnB"}

package/dist/utils/versioning.utils.js

@@ -0,0 +1,30 @@
+import { VersioningType } from "@nestjs/common";
+// Создает опции версионирования для NestJS приложения
+export default function createVersioningOptions(config) {
+    const { type, defaultVersion, header = "X-API-Version", key = "v" } = config;
+    if (type === "header") {
+        return {
+            type: VersioningType.HEADER,
+            header,
+            defaultVersion,
+        };
+    }
+    if (type === "uri") {
+        return {
+            type: VersioningType.URI,
+            defaultVersion,
+        };
+    }
+    if (type === "media-type") {
+        return {
+            type: VersioningType.MEDIA_TYPE,
+            key,
+            defaultVersion,
+        };
+    }
+    return {
+        type: VersioningType.URI,
+        defaultVersion,
+    };
+}
+//# sourceMappingURL=versioning.utils.js.map

package/dist/utils/versioning.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.utils.js","sourceRoot":"","sources":["../../src/utils/versioning.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKhD,sDAAsD;AACtD,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC9C,MAA+B;IAE/B,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,eAAe,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC;IAE7E,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO;YACN,IAAI,EAAE,cAAc,CAAC,MAAM;YAC3B,MAAM;YACN,cAAc;SACd,CAAC;IACH,CAAC;IAED,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO;YACN,IAAI,EAAE,cAAc,CAAC,GAAG;YACxB,cAAc;SACd,CAAC;IACH,CAAC;IAED,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;QAC3B,OAAO;YACN,IAAI,EAAE,cAAc,CAAC,UAAU;YAC/B,GAAG;YACH,cAAc;SACd,CAAC;IACH,CAAC;IAED,OAAO;QACN,IAAI,EAAE,cAAc,CAAC,GAAG;QACxB,cAAc;KACd,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@makebelieve21213-packages/nest-common",
+  "version": "1.0.0",
+  "description": "Common NestJS utilities, guards, interceptors, and shared modules for NakolenkeChain microservices",
+  "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js",
+      "default": "./dist/src/index.js"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/makebelieve21213-packages/nest-common.git"
+  },
+  "homepage": "https://github.com/makebelieve21213-packages/nest-common#readme",
+  "bugs": {
+    "url": "https://github.com/makebelieve21213-packages/nest-common/issues"
+  },
+  "keywords": [
+    "nestjs",
+    "utilities",
+    "guards",
+    "interceptors",
+    "shared-modules",
+    "microservices",
+    "typescript"
+  ],
+  "author": "Skryabin Aleksey",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.11.0",
+    "pnpm": ">=10.18.0"
+  },
+  "dependencies": {
+    "@makebelieve21213-packages/logger": "1.0.5",
+    "@nestjs/common": "^11.1.6",
+    "@nestjs/core": "^11.1.6",
+    "@nestjs/microservices": "^11.1.3",
+    "@nestjs/websockets": "^11.1.3",
+    "@types/express": "^5.0.3",
+    "axios": "^1.10.0",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.1",
+    "express": "^5.1.0",
+    "joi": "^17.13.3",
+    "rxjs": "^7.8.2"
+  },
+  "devDependencies": {
+    "@jest/globals": "^30.0.5",
+    "@nestjs/testing": "^11.1.3",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.2",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-prettier": "^5.5.4",
+    "husky": "^9.1.7",
+    "jest": "^29.7.0",
+    "jiti": "^2.4.0",
+    "prettier": "^3.3.0",
+    "rimraf": "^6.0.1",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "tsc-alias": "^1.8.10",
+    "tsc-esm-fix": "^3.1.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.7.2"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/microservices": "^11.0.0",
+    "@nestjs/websockets": "^11.0.0",
+    "rxjs": "^7.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "pnpm run clean && tsc --build && tsc-alias && tsc-esm-fix",
+    "clean": "rimraf dist tsconfig.tsbuildinfo",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "lint": "tsc --noEmit && eslint \"src/**/*.ts\"",
+    "lint:fix": "tsc --noEmit && eslint \"src/**/*.ts\" --fix",
+    "format": "prettier --check \"src/**/*.ts\"",
+    "format:fix": "prettier --write \"src/**/*.ts\""
+  }
+}