fockeror 0.2.1 → 0.3.0

package/dist/constants.d.ts

@@ -6,6 +6,11 @@
  * // Найдёт: ${{ username }}
  */
 export declare const PLACEHOLDER_PATTERN: RegExp;
+export declare const OFFSETS: {
+    readonly START: number;
+    /** negative (`-length`) */
+    readonly END: number;
+};
 /** Статус HTTP по умолчанию (500 Internal Server Error). */
 export declare const DEFAULT_HTTP_STATUS: 500;
 /** Регулярное выражение для экранирования специальных символов при создании RegExp из ключа. */

package/dist/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CLEAN_REGEX_REPLACER = exports.CLEAN_SEARCH_REGEX = exports.DEFAULT_HTTP_STATUS = exports.PLACEHOLDER_PATTERN = void 0;
+exports.CLEAN_REGEX_REPLACER = exports.CLEAN_SEARCH_REGEX = exports.DEFAULT_HTTP_STATUS = exports.OFFSETS = exports.PLACEHOLDER_PATTERN = void 0;
 /**
  * Регулярное выражение для поиска плейсхолдеров вида `${{ key }}`.
  * Допускает только один пробел внутри скобок.
@@ -9,6 +9,11 @@ exports.CLEAN_REGEX_REPLACER = exports.CLEAN_SEARCH_REGEX = exports.DEFAULT_HTTP
  * // Найдёт: ${{ username }}
  */
 exports.PLACEHOLDER_PATTERN = /\$\{\{\s{1}([^}\s]+)\s{1}\}\}/g;
+exports.OFFSETS = {
+    START: "${{ ".length,
+    /** negative (`-length`) */
+    END: -" }}".length,
+};
 /** Статус HTTP по умолчанию (500 Internal Server Error). */
 exports.DEFAULT_HTTP_STATUS = 500;
 /** Регулярное выражение для экранирования специальных символов при создании RegExp из ключа. */

package/dist/factory.d.ts

@@ -28,13 +28,13 @@ import type { ErrorTemplateInput, ExceptionFormatterClass, Ferors, Logger } from
  * throw errors.USER_NOT_FOUND.execute({ userId: '123' });
  */
 export declare class FockerorFactory<FormatterClass> {
-    private readonly logger;
     private readonly formatterClass;
+    private readonly logger?;
     /**
      * @param logger - Экземпляр логгера (должен соответствовать интерфейсу Logger).
      * @param formatterClass - Класс для форматирования исключения (должен иметь конструктор, совместимый с Exception).
      */
-    constructor(logger: Logger, formatterClass: ExceptionFormatterClass<FormatterClass>);
+    constructor(formatterClass: ExceptionFormatterClass<FormatterClass>, logger?: Logger | undefined);
     /**
      * Генерирует набор ошибок для указанного префикса и шаблонов.
      * Для каждого шаблона создаётся экземпляр `Fockeror` с автоматически вычисленными плейсхолдерами.

package/dist/factory.js

@@ -32,15 +32,15 @@ const fockeror_1 = require("./fockeror");
  * throw errors.USER_NOT_FOUND.execute({ userId: '123' });
  */
 class FockerorFactory {
-    logger;
     formatterClass;
+    logger;
     /**
      * @param logger - Экземпляр логгера (должен соответствовать интерфейсу Logger).
      * @param formatterClass - Класс для форматирования исключения (должен иметь конструктор, совместимый с Exception).
      */
-    constructor(logger, formatterClass) {
-        this.logger = logger;
+    constructor(formatterClass, logger) {
         this.formatterClass = formatterClass;
+        this.logger = logger;
     }
     /**
      * Генерирует набор ошибок для указанного префикса и шаблонов.
@@ -58,12 +58,12 @@ class FockerorFactory {
             const input = templates[key];
             const errorTemplate = this.defineError(input);
             const code = this.generateCode(prefix, key, index);
-            this.logger.execute(`Загрузка ошибки ${prefix} ${code} : ${errorTemplate.message}`);
+            this.logger?.execute?.(`Загрузка ошибки ${prefix} ${code} : ${errorTemplate.message}`);
             const prefixed = {
                 ...errorTemplate,
                 message: `${code} : ${errorTemplate.message}`,
             };
-            const fockeror = new fockeror_1.Fockeror(prefixed, this.logger, this.formatterClass);
+            const fockeror = new fockeror_1.Fockeror(prefixed, this.formatterClass, this.logger);
             return [key, fockeror];
         });
         return Object.fromEntries(entries);
@@ -76,7 +76,7 @@ class FockerorFactory {
     defineError(error) {
         const combined = `${error.message} ${error.description}`;
         const matches = combined.match(constants_1.PLACEHOLDER_PATTERN);
-        const allKeys = matches?.map((m) => m.slice(1, -1)) ?? [];
+        const allKeys = matches?.map((m) => m.slice(constants_1.OFFSETS.START, constants_1.OFFSETS.END)) ?? [];
         const uniqueKeys = Array.from(new Set(allKeys));
         return { ...error, placeholders: uniqueKeys };
     }

package/dist/fockeror.d.ts

@@ -19,8 +19,8 @@ import type { ErrorTemplate, ExceptionFormatterClass, Logger, PlaceholderObject
  */
 export declare class Fockeror<const Placeholders extends string[], FormatterClass> {
     readonly template: ErrorTemplate<Placeholders>;
-    private readonly logger;
     private readonly formatterClass;
+    private readonly logger?;
     private readonly placeholderRegexes;
     /**
      * Создаёт экземпляр Fockeror.
@@ -29,7 +29,7 @@ export declare class Fockeror<const Placeholders extends string[], FormatterClas
      * @param formatterClass - Класс для форматирования исключения в специфичный для фреймворка тип.
      * @throws {Error} Если объявленные в `placeholders` ключи не соответствуют реально найденным в тексте.
      */
-    constructor(template: ErrorTemplate<Placeholders>, logger: Logger, formatterClass: ExceptionFormatterClass<FormatterClass>);
+    constructor(template: ErrorTemplate<Placeholders>, formatterClass: ExceptionFormatterClass<FormatterClass>, logger?: Logger | undefined);
     execute(placeholders: PlaceholderObject<Placeholders>, cause?: Error): FormatterClass;
     execute(cause?: Error): FormatterClass;
     throw(placeholders: PlaceholderObject<Placeholders>, cause?: Error): never;

package/dist/fockeror.js

@@ -23,8 +23,8 @@ const exception_1 = require("./exception");
  */
 class Fockeror {
     template;
-    logger;
     formatterClass;
+    logger;
     placeholderRegexes;
     /**
      * Создаёт экземпляр Fockeror.
@@ -33,10 +33,10 @@ class Fockeror {
      * @param formatterClass - Класс для форматирования исключения в специфичный для фреймворка тип.
      * @throws {Error} Если объявленные в `placeholders` ключи не соответствуют реально найденным в тексте.
      */
-    constructor(template, logger, formatterClass) {
+    constructor(template, formatterClass, logger) {
         this.template = template;
-        this.logger = logger;
         this.formatterClass = formatterClass;
+        this.logger = logger;
         this.placeholderRegexes = this.extractPlaceholders(template);
     }
     /**
@@ -99,7 +99,7 @@ class Fockeror {
         for (const [key, regex] of this.placeholderRegexes.entries()) {
             const value = placeholders[key];
             if (value === undefined) {
-                this.logger.error(new Error(`Placeholder \${{ ${key} }} not provided in data`));
+                this.logger?.error?.(new Error(`Placeholder \${{ ${key} }} not provided in data`));
                 continue;
             }
             message = message.replace(regex, value);
@@ -146,7 +146,7 @@ class Fockeror {
             errors.push(new Error(`Placeholder from text "${placeholder}" not found in placeholders list`));
         }
         if (errors.length !== 0) {
-            errors.forEach((e) => this.logger.error(e));
+            errors.forEach((e) => this.logger?.error?.(e));
             throw new Error("Placeholder validation failed.");
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fockeror",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",