@mediacubeco/base 0.0.1

package/dist/helpers/index.cjs

@@ -0,0 +1 @@
+"use strict";const t=t=>t instanceof Error,e=(t,...e)=>{if(t instanceof Function)return t(...e)};class s{isDefaultPrevented=!1;constructor(){this.preventDefault=this.preventDefault.bind(this),this.overrideDefault=this.overrideDefault.bind(this)}preventDefault(){this.isDefaultPrevented=!0}overrideDefault(){this.isDefaultPrevented=!1}}class r{subscriptions={};constructor(){this.emit=this.emit.bind(this),this.on=this.on.bind(this),this.off=this.off.bind(this),this.clear=this.clear.bind(this)}emit(t,s,r){const i=this.subscriptions[t];if(i){const{event:t,listenerList:n}=i;n.forEach(r=>e(r,Object.assign(t,s))),t.isDefaultPrevented||e(r)}else e(r)}on(t,e){const r=this.subscriptions[t];return r?r.listenerList.push(e):this.subscriptions[t]={event:new s,listenerList:[e]},()=>this.off(t,e)}off(t,e){const s=this.subscriptions[t];if(s){const{event:r,listenerList:i}=s;this.subscriptions[t]={event:r,listenerList:i.filter(t=>t!==e)},r.overrideDefault()}}clear(t){delete this.subscriptions[t]}}const i=(t="?",...e)=>{const s=(t&&(r=t,"string"==typeof r)?t:"?").toUpperCase();var r;const i=e.reduce((t,e,s,{length:r})=>{const i=s===r-1?[]:["|"];return t.push(e,...i),t},e.length?["-"]:[]);return[`[${s}]`,...i]};var n,a,o;!function(t){t.StartGroup="group",t.EndGroup="groupEnd",t.Default="log"}(n||(n={})),function(t){t.Info="%s",t.Success="%s",t.Warning="%s",t.Danger="%s"}(a||(a={}));class c{static formatted={info:(...t)=>c.info(...i(...t)),success:(...t)=>c.success(...i(...t)),warning:(...t)=>c.warning(...i(...t)),danger:(...t)=>c.danger(...i(...t))};static#t(t,...e){console[t](...e)}static startGroup(t,e,...s){c.#t(n.StartGroup,...((t,...e)=>["%c%s",t,...e])(`font-size: 16px;${e}`,...i(t,...s)))}static endGroup(){c.#t(n.EndGroup)}static info(...t){c.#t(n.Default,a.Info,...t)}static success(...t){c.#t(n.Default,a.Success,...t)}static warning(...t){c.#t(n.Default,a.Warning,...t)}static danger(...t){c.#t(n.Default,a.Danger,...t)}}exports.ErrorHandlerEventName=void 0,(o=exports.ErrorHandlerEventName||(exports.ErrorHandlerEventName={})).Capture="capture",o.Forward="forward";class u{static eventEmitter=new r;static caseList=[];static log(e,s){const{signal:r,message:i,payload:n,stack:a}=s,o=[i,t(e)?e.message:void 0].filter(Boolean);c.formatted.danger(r,...o,{error:e,payload:n,stack:a})}static get on(){return u.eventEmitter.on}static get off(){return u.eventEmitter.off}static get clear(){return u.eventEmitter.clear}static create(t,e){return new Error(t,{cause:e})}static throw(t,e){throw u.create(t,e)}static capture(t,e){u.log(t,e),u.eventEmitter.emit(exports.ErrorHandlerEventName.Capture,{error:t,config:e})}static forward(t,e){throw u.log(t,e),u.eventEmitter.emit(exports.ErrorHandlerEventName.Capture,{error:t,config:e}),t}static case(t){u.caseList.push(t)}static parse(e){const s={message:"Error!",status:0,errors:{},isExternal:!0};for(const{check:t,parse:r}of u.caseList)if(t(e,s))return r(e,s);return!0===t(e)?{message:e.message,status:s.status,errors:s.errors,isExternal:s.isExternal}:{message:s.message,status:s.status,errors:s.errors,isExternal:s.isExternal}}}exports.ErrorHandler=u,exports.EventEmitter=r,exports.Log=c;

package/dist/helpers/index.d.ts

@@ -0,0 +1,513 @@
+/**
+ * @packageDocumentation
+ * @description
+ * Общие утилитарные типы для проектов на TypeScript.
+ * Содержит типы для примитивов (Nullable, NotNullable), структур данных
+ * (BaseRecord, Entry, List), функций (Callback, AsyncCallback) и вспомогательные
+ * утилиты (KeyOf, ValueOf, Decrement, Increment и др.).
+ * Модуль не содержит рантайм-кода — только типы.
+ *
+ * @example
+ * ```typescript
+ * type User = { id: number; name?: string | null }
+ *
+ * type UserId = ValueOf<Pick<User, 'id'>>
+ * type SafeName = NotNullable<User['name']>
+ * ```
+ */
+type NullablePrimitive = undefined | null;
+/**
+ * Тип, допускающий null или undefined (например для опциональных полей).
+ *
+ * @example
+ * ```typescript
+ * type MaybeName = Nullable<string> // string | null | undefined
+ * ```
+ */
+type Nullable<Data = undefined> = Data | NullablePrimitive;
+/**
+ * Допустимые ключи объекта (как в Record).
+ *
+ * @example
+ * ```typescript
+ * type Key = BaseKey // string | number | symbol
+ * ```
+ */
+type BaseKey = string | number | symbol;
+/**
+ * Массив элементов (базовый тип для списков).
+ *
+ * @example
+ * ```typescript
+ * type IdList = BaseList<number> // number[]
+ * ```
+ */
+type BaseList<Item = unknown> = Item[];
+/**
+ * Объект с ключами Key и значениями Value (обобщение Record).
+ *
+ * @example
+ * ```typescript
+ * type UserMap = BaseRecord<string, 'name' | 'role'>
+ * ```
+ */
+type BaseRecord<Value = unknown, Key extends BaseKey = BaseKey> = Record<Key, Value>;
+/**
+ * Функция без аргументов и возвращаемого значения.
+ *
+ * @example
+ * ```typescript
+ * const noop: Noop = () => {}
+ * ```
+ */
+type Noop = () => void;
+/**
+ * Синхронная функция с заданным списком параметров и результатом.
+ * @template ParamList - кортеж типов аргументов
+ * @template Result - тип возвращаемого значения
+ *
+ * @example
+ * ```typescript
+ * type Sum = Callback<[number, number], number>
+ * ```
+ */
+type Callback<ParamList extends BaseList = BaseList, Result = void> = (...paramList: ParamList) => Result;
+
+declare class Event {
+    isDefaultPrevented: boolean;
+    constructor();
+    preventDefault(): void;
+    overrideDefault(): void;
+}
+
+type EventEmitterDefaultAction = Noop;
+type EventEmitterListener<Params> = Callback<[Event & Params]>;
+
+/**
+ * Имена событий, которые генерирует `ErrorHandler`.
+ */
+declare enum ErrorHandlerEventName {
+    /** Ошибка была залогирована и передана подписчикам без выбрасывания. */
+    Capture = "capture",
+    /** Зарезервированное имя события для проброса ошибки дальше по цепочке. */
+    Forward = "forward"
+}
+
+/**
+ * Сообщение об ошибке для пользователя или лога.
+ *
+ * @example
+ * ```typescript
+ * const message: ErrorHandlerMessage = 'Request failed'
+ * ```
+ */
+type ErrorHandlerMessage = string;
+/**
+ * Любое значение, которое может быть перехвачено как ошибка (Error или unknown).
+ *
+ * @example
+ * ```typescript
+ * const error: ErrorHandlerError = new Error('Timeout')
+ * ```
+ */
+type ErrorHandlerError = unknown;
+/**
+ * Словарь ошибок валидации (например поле → сообщение или список сообщений).
+ *
+ * @example
+ * ```typescript
+ * const errors: ErrorHandlerErrors<'email'> = { email: 'Invalid email' }
+ * ```
+ */
+type ErrorHandlerErrors<Key extends BaseKey = BaseKey, Value = Nullable<string | string[]>> = BaseRecord<Value, Key>;
+/**
+ * Результат разбора ошибки через ErrorHandler.parse.
+ * Используется для единообразного представления ошибок API (message, status, errors, isExternal).
+ *
+ * @example
+ * ```typescript
+ * const result: ErrorHandlerParseResult<'email'> = {
+ *   message: 'Validation failed',
+ *   status: 422,
+ *   errors: { email: 'Invalid email' },
+ *   isExternal: true
+ * }
+ * ```
+ */
+type ErrorHandlerParseResult<Key extends BaseKey> = {
+    message: string;
+    status: number;
+    errors: ErrorHandlerErrors<Key>;
+    isExternal: boolean;
+};
+/**
+ * Конфиг одного «кейса» для ErrorHandler.parse: проверка типа ошибки и функция разбора.
+ * Регистрируется через ErrorHandler.case().
+ *
+ * @example
+ * ```typescript
+ * const config: ErrorHandlerCaseConfig<Response> = {
+ *   check: (error): error is Response => error instanceof Response,
+ *   parse: (error, defaultResult) => ({ ...defaultResult, status: error.status })
+ * }
+ * ```
+ */
+type ErrorHandlerCaseConfig<ErrorHandlerCaseError = any> = {
+    check: <Key extends BaseKey>(error: ErrorHandlerError, defaultResult: ErrorHandlerParseResult<Key>) => error is ErrorHandlerCaseError;
+    parse: <Key extends BaseKey>(error: ErrorHandlerCaseError, defaultResult: ErrorHandlerParseResult<Key>) => ErrorHandlerParseResult<Key>;
+};
+/**
+ * Конфигурация при логировании/пробросе ошибки (signal, опциональные message, payload, stack).
+ *
+ * @example
+ * ```typescript
+ * const config: ErrorHandlerConfig = {
+ *   signal: 'api',
+ *   message: 'Cannot load profile'
+ * }
+ * ```
+ */
+type ErrorHandlerConfig = {
+    signal: string;
+    message?: ErrorHandlerMessage;
+    payload?: BaseRecord<unknown>;
+    stack?: string[];
+};
+/**
+ * Параметры события capture/forward: ошибка и конфиг.
+ *
+ * @example
+ * ```typescript
+ * const params: ErrorHandlerEventParams = {
+ *   error: new Error('Timeout'),
+ *   config: { signal: 'api' }
+ * }
+ * ```
+ */
+type ErrorHandlerEventParams = {
+    error: ErrorHandlerError;
+    config: ErrorHandlerConfig;
+};
+
+/**
+ * Централизованная обработка ошибок: логирование, подписка на события, разбор ошибок по кейсам.
+ * Статический класс; подписка через on('capture', …), регистрация кейсов через case().
+ * capture — залогировать и вызвать событие, не бросать; forward — залогировать, вызвать событие и пробросить.
+ *
+ * @example
+ * ```typescript
+ * ErrorHandler.on(ErrorHandlerEventName.Capture, ({ error }) => {
+ *   console.error(error)
+ * })
+ *
+ * ErrorHandler.capture(new Error('Request failed'), { signal: 'api' })
+ * ```
+ */
+declare class ErrorHandler {
+    private static eventEmitter;
+    private static caseList;
+    private static log;
+    /**
+     * Доступ к подписке на события обработчика ошибок.
+     * Обычно используется как `ErrorHandler.on(ErrorHandlerEventName.Capture, listener)`.
+     *
+     * @returns Метод подписки `EventEmitter.on`
+     *
+     * @example
+     * ```typescript
+     * ErrorHandler.on(ErrorHandlerEventName.Capture, ({ config }) => {
+     *   console.log(config.signal)
+     * })
+     * ```
+     */
+    static get on(): (name: ErrorHandlerEventName, listener: EventEmitterListener<ErrorHandlerEventParams>) => () => void;
+    /**
+     * Доступ к удалению конкретного подписчика обработчика ошибок.
+     *
+     * @returns Метод отписки `EventEmitter.off`
+     *
+     * @example
+     * ```typescript
+     * ErrorHandler.off(ErrorHandlerEventName.Capture, listener)
+     * ```
+     */
+    static get off(): (name: ErrorHandlerEventName, listener: EventEmitterListener<ErrorHandlerEventParams>) => void;
+    /**
+     * Доступ к очистке подписок по имени события.
+     *
+     * @returns Метод очистки `EventEmitter.clear`
+     *
+     * @example
+     * ```typescript
+     * ErrorHandler.clear(ErrorHandlerEventName.Capture)
+     * ```
+     */
+    static get clear(): (name: ErrorHandlerEventName) => void;
+    /**
+     * Создаёт экземпляр Error с сообщением и опциональной причиной (cause).
+     *
+     * @param message - Текст ошибки
+     * @param error - Исходная ошибка или причина
+     * @returns Новый объект Error (не бросается)
+     *
+     * @example
+     * ```typescript
+     * const error = ErrorHandler.create('Request failed', new Error('Timeout'))
+     * ```
+     */
+    static create(message: ErrorHandlerMessage, error?: ErrorHandlerError): Error;
+    /**
+     * Создаёт ошибку и немедленно бросает её (never).
+     * Используется для заглушек (например «Not implemented»).
+     *
+     * @param message - Текст ошибки
+     * @param error - Исходная ошибка или причина
+     * @returns Управление не возвращается, так как метод выбрасывает исключение
+     *
+     * @example
+     * ```typescript
+     * ErrorHandler.throw('Not implemented')
+     * ```
+     */
+    static throw(message: ErrorHandlerMessage, error?: ErrorHandlerError): never;
+    /**
+     * Логирует ошибку и эмитит событие 'capture'. Ошибку не бросает.
+     * Подписчики могут отправить данные в мониторинг и т.д.
+     *
+     * @param error - Ошибка или любое перехваченное значение
+     * @param config - Конфигурация логирования и сопровождающих данных
+     *
+     * @example
+     * ```typescript
+     * ErrorHandler.capture(new Error('Request failed'), {
+     *   signal: 'api',
+     *   message: 'Cannot load profile'
+     * })
+     * ```
+     */
+    static capture(error: ErrorHandlerError, config: ErrorHandlerConfig): void;
+    /**
+     * Логирует ошибку, эмитит 'capture' и пробрасывает ошибку дальше (never).
+     *
+     * @param error - Ошибка или любое перехваченное значение
+     * @param config - Конфигурация логирования и сопровождающих данных
+     * @returns Управление не возвращается, так как метод выбрасывает ошибку дальше
+     *
+     * @example
+     * ```typescript
+     * ErrorHandler.forward(new Error('Forbidden'), {
+     *   signal: 'auth'
+     * })
+     * ```
+     */
+    static forward(error: ErrorHandlerError, config: ErrorHandlerConfig): never;
+    /**
+     * Регистрирует кейс для parse: при совпадении check() будет вызван parse().
+     * Порядок регистрации важен — используется первый подходящий кейс.
+     *
+     * @param config - Пара функций `check` и `parse` для пользовательского разбора ошибок
+     *
+     * @example
+     * ```typescript
+     * ErrorHandler.case({
+     *   check: (error): error is Response => error instanceof Response,
+     *   parse: (error, defaultResult) => ({
+     *     ...defaultResult,
+     *     status: error.status
+     *   })
+     * })
+     * ```
+     */
+    static case<ErrorHandlerCaseError>(config: ErrorHandlerCaseConfig<ErrorHandlerCaseError>): void;
+    /**
+     * Разбирает ошибку в единый формат (message, status, errors, isExternal).
+     * Сначала проверяются зарегистрированные кейсы; если ни один не подошёл — базовый разбор (Error.message или default).
+     *
+     * @param error - Ошибка или любое неизвестное значение
+     * @returns Унифицированный результат разбора ошибки
+     *
+     * @example
+     * ```typescript
+     * const parsed = ErrorHandler.parse(new Error('Request failed'))
+     * console.log(parsed.message)
+     * ```
+     */
+    static parse<Key extends BaseKey>(error: ErrorHandlerError): ErrorHandlerParseResult<Key>;
+}
+
+/**
+ * Лёгкий EventEmitter с поддержкой подписок, отписок и `defaultAction`.
+ * Слушатель получает объект события, объединённый с переданными параметрами emit.
+ *
+ * @example
+ * ```typescript
+ * const emitter = new EventEmitter<'save', { id: number }>()
+ *
+ * emitter.on('save', (event) => {
+ *   console.log(event.id)
+ * })
+ *
+ * emitter.emit('save', { id: 1 })
+ * ```
+ */
+declare class EventEmitter<EventName extends string = string, EventParams extends Nullable<object> = undefined> {
+    private subscriptions;
+    constructor();
+    /**
+     * Вызывает событие и передаёт параметры всем подписчикам.
+     * Если ни один слушатель не отменил стандартное действие, дополнительно вызывается `defaultAction`.
+     *
+     * @param name - Имя события
+     * @param params - Дополнительные параметры события
+     * @param defaultAction - Функция, которая выполнится после слушателей, если действие не отменено
+     *
+     * @example
+     * ```typescript
+     * emitter.emit('save', { id: 1 }, () => {
+     *   console.log('saved')
+     * })
+     * ```
+     */
+    emit(name: EventName, params?: EventParams, defaultAction?: EventEmitterDefaultAction): void;
+    /**
+     * Подписывает слушатель на событие.
+     *
+     * @param name - Имя события
+     * @param listener - Обработчик события
+     * @returns Функция для отписки от события
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = emitter.on('save', (event) => {
+     *   console.log(event.id)
+     * })
+     *
+     * unsubscribe()
+     * ```
+     */
+    on(name: EventName, listener: EventEmitterListener<EventParams>): () => void;
+    /**
+     * Удаляет конкретный слушатель из подписки на событие.
+     *
+     * @param name - Имя события
+     * @param listener - Слушатель, которого нужно удалить
+     *
+     * @example
+     * ```typescript
+     * emitter.off('save', listener)
+     * ```
+     */
+    off(name: EventName, listener: EventEmitterListener<EventParams>): void;
+    /**
+     * Полностью очищает подписку на указанное событие.
+     *
+     * @param name - Имя события
+     *
+     * @example
+     * ```typescript
+     * emitter.clear('save')
+     * ```
+     */
+    clear(name: EventName): void;
+}
+
+type LogSignal = string;
+type LogParamList = any[];
+type LogStyles = string;
+
+/**
+ * Статический helper для форматированного вывода сообщений в консоль.
+ * Поддерживает обычные сообщения, стилизованные группы и набор `formatted`-методов с signal.
+ *
+ * @example
+ * ```typescript
+ * Log.info('App started')
+ * Log.formatted.success('auth', 'Signed in')
+ * ```
+ */
+declare class Log {
+    #private;
+    /**
+     * Набор методов для логирования с предварительным форматированием по signal.
+     *
+     * @example
+     * ```typescript
+     * Log.formatted.warning('api', 'Slow response')
+     * ```
+     */
+    static readonly formatted: {
+        info: (paramList_0: string, ...paramList: any[]) => void;
+        success: (paramList_0: string, ...paramList: any[]) => void;
+        warning: (paramList_0: string, ...paramList: any[]) => void;
+        danger: (paramList_0: string, ...paramList: any[]) => void;
+    };
+    /**
+     * Открывает группу логов в консоли и выводит её заголовок.
+     *
+     * @param signal - Короткий идентификатор группы
+     * @param styles - Дополнительные CSS-стили для заголовка
+     * @param paramList - Дополнительные данные, которые будут выведены вместе с signal
+     *
+     * @example
+     * ```typescript
+     * Log.startGroup('profile', 'color: purple;', { id: 1 })
+     * ```
+     */
+    static startGroup(signal: LogSignal, styles?: LogStyles, ...paramList: LogParamList): void;
+    /**
+     * Закрывает текущую группу логов в консоли.
+     *
+     * @example
+     * ```typescript
+     * Log.endGroup()
+     * ```
+     */
+    static endGroup(): void;
+    /**
+     * Выводит информационное сообщение.
+     *
+     * @param paramList - Параметры для вывода в консоль
+     *
+     * @example
+     * ```typescript
+     * Log.info('Profile loaded', user)
+     * ```
+     */
+    static info(...paramList: LogParamList): void;
+    /**
+     * Выводит сообщение об успешном результате.
+     *
+     * @param paramList - Параметры для вывода в консоль
+     *
+     * @example
+     * ```typescript
+     * Log.success('Profile saved')
+     * ```
+     */
+    static success(...paramList: LogParamList): void;
+    /**
+     * Выводит предупреждение.
+     *
+     * @param paramList - Параметры для вывода в консоль
+     *
+     * @example
+     * ```typescript
+     * Log.warning('Retry in progress')
+     * ```
+     */
+    static warning(...paramList: LogParamList): void;
+    /**
+     * Выводит сообщение об ошибке.
+     *
+     * @param paramList - Параметры для вывода в консоль
+     *
+     * @example
+     * ```typescript
+     * Log.danger('Request failed', error)
+     * ```
+     */
+    static danger(...paramList: LogParamList): void;
+}
+
+export { ErrorHandler, ErrorHandlerEventName, EventEmitter, Log };
+export type { ErrorHandlerCaseConfig, ErrorHandlerConfig, ErrorHandlerError, ErrorHandlerErrors, ErrorHandlerEventParams, ErrorHandlerMessage, ErrorHandlerParseResult };

package/dist/helpers/index.mjs

@@ -0,0 +1 @@
+const t=t=>t instanceof Error,e=(t,...e)=>{if(t instanceof Function)return t(...e)};class s{isDefaultPrevented=!1;constructor(){this.preventDefault=this.preventDefault.bind(this),this.overrideDefault=this.overrideDefault.bind(this)}preventDefault(){this.isDefaultPrevented=!0}overrideDefault(){this.isDefaultPrevented=!1}}class r{subscriptions={};constructor(){this.emit=this.emit.bind(this),this.on=this.on.bind(this),this.off=this.off.bind(this),this.clear=this.clear.bind(this)}emit(t,s,r){const i=this.subscriptions[t];if(i){const{event:t,listenerList:n}=i;n.forEach(r=>e(r,Object.assign(t,s))),t.isDefaultPrevented||e(r)}else e(r)}on(t,e){const r=this.subscriptions[t];return r?r.listenerList.push(e):this.subscriptions[t]={event:new s,listenerList:[e]},()=>this.off(t,e)}off(t,e){const s=this.subscriptions[t];if(s){const{event:r,listenerList:i}=s;this.subscriptions[t]={event:r,listenerList:i.filter(t=>t!==e)},r.overrideDefault()}}clear(t){delete this.subscriptions[t]}}const i=(t="?",...e)=>{const s=(t&&(r=t,"string"==typeof r)?t:"?").toUpperCase();var r;const i=e.reduce((t,e,s,{length:r})=>{const i=s===r-1?[]:["|"];return t.push(e,...i),t},e.length?["-"]:[]);return[`[${s}]`,...i]};var n,a,o;!function(t){t.StartGroup="group",t.EndGroup="groupEnd",t.Default="log"}(n||(n={})),function(t){t.Info="%s",t.Success="%s",t.Warning="%s",t.Danger="%s"}(a||(a={}));class c{static formatted={info:(...t)=>c.info(...i(...t)),success:(...t)=>c.success(...i(...t)),warning:(...t)=>c.warning(...i(...t)),danger:(...t)=>c.danger(...i(...t))};static#t(t,...e){console[t](...e)}static startGroup(t,e,...s){c.#t(n.StartGroup,...((t,...e)=>["%c%s",t,...e])(`font-size: 16px;${e}`,...i(t,...s)))}static endGroup(){c.#t(n.EndGroup)}static info(...t){c.#t(n.Default,a.Info,...t)}static success(...t){c.#t(n.Default,a.Success,...t)}static warning(...t){c.#t(n.Default,a.Warning,...t)}static danger(...t){c.#t(n.Default,a.Danger,...t)}}!function(t){t.Capture="capture",t.Forward="forward"}(o||(o={}));class u{static eventEmitter=new r;static caseList=[];static log(e,s){const{signal:r,message:i,payload:n,stack:a}=s,o=[i,t(e)?e.message:void 0].filter(Boolean);c.formatted.danger(r,...o,{error:e,payload:n,stack:a})}static get on(){return u.eventEmitter.on}static get off(){return u.eventEmitter.off}static get clear(){return u.eventEmitter.clear}static create(t,e){return new Error(t,{cause:e})}static throw(t,e){throw u.create(t,e)}static capture(t,e){u.log(t,e),u.eventEmitter.emit(o.Capture,{error:t,config:e})}static forward(t,e){throw u.log(t,e),u.eventEmitter.emit(o.Capture,{error:t,config:e}),t}static case(t){u.caseList.push(t)}static parse(e){const s={message:"Error!",status:0,errors:{},isExternal:!0};for(const{check:t,parse:r}of u.caseList)if(t(e,s))return r(e,s);return!0===t(e)?{message:e.message,status:s.status,errors:s.errors,isExternal:s.isExternal}:{message:s.message,status:s.status,errors:s.errors,isExternal:s.isExternal}}}export{u as ErrorHandler,o as ErrorHandlerEventName,r as EventEmitter,c as Log};

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";const t=t=>void 0===t,e=t=>null===t,s=s=>t(s)||e(s),r=t=>"string"==typeof t,i=t=>"object"==typeof t,o=t=>{const e=[n,a,c,u,l,f,p,h,g,m,d].some(e=>e(t));return!!t&&"object"==typeof t&&!e},n=t=>Array.isArray(t),a=t=>t instanceof ArrayBuffer,c=t=>t instanceof Map,u=t=>t instanceof Set,l=t=>t instanceof Map,f=t=>t instanceof Set,p=t=>t instanceof Date,h=t=>t instanceof Error,g=t=>t instanceof RegExp,m=t=>t instanceof Promise,d=t=>t instanceof Function;const x=(t,...e)=>{if(d(t))return t(...e)};function y(t,e){return!(!i(e)||!(t in e))}function b(t,e){return t.filter(t=>e.includes(t))}class E{isDefaultPrevented=!1;constructor(){this.preventDefault=this.preventDefault.bind(this),this.overrideDefault=this.overrideDefault.bind(this)}preventDefault(){this.isDefaultPrevented=!0}overrideDefault(){this.isDefaultPrevented=!1}}class v{subscriptions={};constructor(){this.emit=this.emit.bind(this),this.on=this.on.bind(this),this.off=this.off.bind(this),this.clear=this.clear.bind(this)}emit(t,e,s){const r=this.subscriptions[t];if(r){const{event:t,listenerList:i}=r;i.forEach(s=>x(s,Object.assign(t,e))),t.isDefaultPrevented||x(s)}else x(s)}on(t,e){const s=this.subscriptions[t];return s?s.listenerList.push(e):this.subscriptions[t]={event:new E,listenerList:[e]},()=>this.off(t,e)}off(t,e){const s=this.subscriptions[t];if(s){const{event:r,listenerList:i}=s;this.subscriptions[t]={event:r,listenerList:i.filter(t=>t!==e)},r.overrideDefault()}}clear(t){delete this.subscriptions[t]}}const w=(t="?",...e)=>[`[${(t&&r(t)?t:"?").toUpperCase()}]`,...e.reduce((t,e,s,{length:r})=>{const i=s===r-1?[]:["|"];return t.push(e,...i),t},e.length?["-"]:[])];var D,N,k;!function(t){t.StartGroup="group",t.EndGroup="groupEnd",t.Default="log"}(D||(D={})),function(t){t.Info="%s",t.Success="%s",t.Warning="%s",t.Danger="%s"}(N||(N={}));class S{static formatted={info:(...t)=>S.info(...w(...t)),success:(...t)=>S.success(...w(...t)),warning:(...t)=>S.warning(...w(...t)),danger:(...t)=>S.danger(...w(...t))};static#t(t,...e){console[t](...e)}static startGroup(t,e,...s){S.#t(D.StartGroup,...((t,...e)=>["%c%s",t,...e])(`font-size: 16px;${e}`,...w(t,...s)))}static endGroup(){S.#t(D.EndGroup)}static info(...t){S.#t(D.Default,N.Info,...t)}static success(...t){S.#t(D.Default,N.Success,...t)}static warning(...t){S.#t(D.Default,N.Warning,...t)}static danger(...t){S.#t(D.Default,N.Danger,...t)}}exports.ErrorHandlerEventName=void 0,(k=exports.ErrorHandlerEventName||(exports.ErrorHandlerEventName={})).Capture="capture",k.Forward="forward";class L{static eventEmitter=new v;static caseList=[];static log(t,e){const{signal:s,message:r,payload:i,stack:o}=e,n=[r,h(t)?t.message:void 0].filter(Boolean);S.formatted.danger(s,...n,{error:t,payload:i,stack:o})}static get on(){return L.eventEmitter.on}static get off(){return L.eventEmitter.off}static get clear(){return L.eventEmitter.clear}static create(t,e){return new Error(t,{cause:e})}static throw(t,e){throw L.create(t,e)}static capture(t,e){L.log(t,e),L.eventEmitter.emit(exports.ErrorHandlerEventName.Capture,{error:t,config:e})}static forward(t,e){throw L.log(t,e),L.eventEmitter.emit(exports.ErrorHandlerEventName.Capture,{error:t,config:e}),t}static case(t){L.caseList.push(t)}static parse(t){const e={message:"Error!",status:0,errors:{},isExternal:!0};for(const{check:s,parse:r}of L.caseList)if(s(t,e))return r(t,e);return!0===h(t)?{message:t.message,status:e.status,errors:e.errors,isExternal:e.isExternal}:{message:e.message,status:e.status,errors:e.errors,isExternal:e.isExternal}}}class j{key;model;config;constructor(t,e,s){this.key=t,this.model=e,this.config=s}async get(t){const{defaultValue:e,withDebug:s}={...this.config,...t},r=await this.model.get(this.key),i=r&&JSON.parse(r)||e;return s&&S.formatted.info("get",this.key,i),i}async set(t,e){const{withDebug:s}={...this.config,...e};await this.model.set(this.key,JSON.stringify(t)),s&&S.formatted.info("set",this.key,t)}async delete(t){const{withDebug:e}={...this.config,...t},s=await this.get({...t,withDebug:!1});await this.model.delete(this.key),e&&S.formatted.info("delete",this.key,s)}async has(t){const{withDebug:e}={...this.config,...t},s=await this.get({...t,withDebug:!1});return e&&S.formatted.info("has",this.key,s),!!s}}exports.ErrorHandler=L,exports.EventEmitter=v,exports.Log=S,exports.Storage=class{model;config;constructor(t,e){this.model=t,this.config=e}async all(){L.throw("Not implemented")}async clear(){L.throw("Not implemented")}create(t){const e={[t]:new j(t,this.model,this.config)};return Object.assign(this,e)}},exports.chunkList=function(t,e){const s=[];for(let r=0;r<t.length;r+=e)s.push(t.slice(r,r+e));return s},exports.compose=function(t,e,r){const i=!o(t);return!s(r)&&{...e,...i?{[r]:t}:t}||!s(e)&&{...e,...t}||{...t}},exports.debounce=(t,e)=>{let s;return(...r)=>{s&&clearTimeout(s),s=setTimeout(()=>x(t,...r),e)}},exports.filterByKey=function(t,e="isVisible"){return t.filter(t=>!y(e,t)||t[e])},exports.filterDuplicateByKey=function(t,e){return t.reduce((t,s)=>t.some(t=>t[e]===s[e])?t:[...t,s],[])},exports.filterEqualValues=b,exports.filterNullableValues=function(t){return t.filter(t=>!s(t))},exports.forceList=function(t){return n(t)?t:[t]},exports.getValueByKey=function(t,e,r){return s(t)?r:2===arguments.length?e[t]:e[t]??r},exports.hasEqualValues=function(t,e){return!!b(t,e).length},exports.hasKey=y,exports.isAnyObject=i,exports.isArray=n,exports.isArrayBuffer=a,exports.isArrayEmpty=function(t){return 0===t.length},exports.isBigint=t=>"bigint"==typeof t,exports.isBoolean=t=>"boolean"==typeof t,exports.isDate=p,exports.isError=h,exports.isFunction=d,exports.isMap=c,exports.isNaN=t=>Number.isNaN(t),exports.isNull=e,exports.isNullable=s,exports.isNumber=t=>"number"==typeof t,exports.isObject=o,exports.isObjectEmpty=function(t){for(const e in t)return!1;return!0},exports.isPromise=m,exports.isProxy=t=>t instanceof Proxy,exports.isRegExp=g,exports.isSet=u,exports.isString=r,exports.isSymbol=t=>"symbol"==typeof t,exports.isUndefined=t,exports.isWeakMap=l,exports.isWeakSet=f,exports.mapRecord=(t,e)=>{const s=Object.entries(t);return Object.fromEntries(s.map(([t,s],r,i)=>[t,e(t,s,r,i)]))},exports.runCallback=x,exports.throttle=(t,e)=>{let s=!0;return(...r)=>{s&&(x(t,...r),s=!1),setTimeout(()=>s=!0,e)}},exports.wait=t=>new Promise(e=>setTimeout(e,t));