wsp-ms-core 1.0.2 → 1.0.4

package/src/domain/value-objects/Language.ts

@@ -1,94 +0,0 @@
-import { ValueObject } from '@domain/contracts/ValueObject';
-
-export class Language extends ValueObject<string> {
-
-    public static readonly SUPPORTED: readonly string[] = [
-        'es',
-        'en',
-        'en-us',
-        'en-gb',
-        'en-au',
-        'en-ca',
-        'en-nz',
-        'en-ie',
-        'en-za',
-        'en-jm',
-        'en-bz',
-        'en-tt',
-        'pt-br',
-        'pt',
-        'es',
-        'es-ar',
-        'es-gt',
-        'es-cr',
-        'es-pa',
-        'es-do',
-        'es-mx',
-        'es-ve',
-        'es-co',
-        'es-pe',
-        'es-ec',
-        'es-cl',
-        'es-uy',
-        'es-py',
-        'es-bo',
-        'es-sv',
-        'es-hn',
-        'es-ni',
-        'es-pr',
-    ] as const;
-
-    public static readonly DEFAULT: Language                 = new Language('es');
-    public static readonly ENGLISH: Language                 = new Language('en');
-    public static readonly ENGLISH_UNITED_STATES: Language   = new Language('en-us');
-    public static readonly ENGLISH_UNITED_KINGDOM: Language  = new Language('en-gb');
-    public static readonly ENGLISH_AUSTRALIA: Language       = new Language('en-au');
-    public static readonly ENGLISH_CANADA: Language           = new Language('en-ca');
-    public static readonly ENGLISH_NEW_ZEALAND: Language     = new Language('en-nz');
-    public static readonly ENGLISH_IRELAND: Language         = new Language('en-ie');
-    public static readonly ENGLISH_SOUTH_AFRICA: Language    = new Language('en-za');
-    public static readonly ENGLISH_JAMAICA: Language         = new Language('en-jm');
-    public static readonly ENGLISH_BELIZE: Language          = new Language('en-bz');
-    public static readonly ENGLISH_TRINIDAD: Language        = new Language('en-tt');
-    public static readonly PORTUGUESE_BRAZIL: Language       = new Language('pt-br');
-    public static readonly PORTUGUESE_PORTUGAL: Language     = new Language('pt');
-    public static readonly SPANISH: Language                 = new Language('es');
-    public static readonly SPANISH_ARGENTINA: Language       = new Language('es-ar');
-    public static readonly SPANISH_GUATEMALA: Language       = new Language('es-gt');
-    public static readonly SPANISH_COSTA_RICA: Language      = new Language('es-cr');
-    public static readonly SPANISH_PANAMA: Language          = new Language('es-pa');
-    public static readonly SPANISH_REPUBLICA_DOMINICANA: Language = new Language('es-do');
-    public static readonly SPANISH_MEXICO: Language          = new Language('es-mx');
-    public static readonly SPANISH_VENEZUELA: Language       = new Language('es-ve');
-    public static readonly SPANISH_COLOMBIA: Language        = new Language('es-co');
-    public static readonly SPANISH_PERU: Language            = new Language('es-pe');
-    public static readonly SPANISH_ECUADOR: Language         = new Language('es-ec');
-    public static readonly SPANISH_CHILE: Language           = new Language('es-cl');
-    public static readonly SPANISH_URUGUAY: Language         = new Language('es-uy');
-    public static readonly SPANISH_PARAGUAY: Language        = new Language('es-py');
-    public static readonly SPANISH_BOLIVIA: Language         = new Language('es-bo');
-    public static readonly SPANISH_EL_SALVADOR: Language     = new Language('es-sv');
-    public static readonly SPANISH_HONDURAS: Language        = new Language('es-hn');
-    public static readonly SPANISH_NICARAGUA: Language       = new Language('es-ni');
-    public static readonly SPANISH_PUERTO_RICO: Language     = new Language('es-pr');
-
-    private constructor(code: string) {
-        super(code.trim().toLowerCase());
-    }
-
-    protected validate(value: string): void {
-        if (!Language.SUPPORTED.includes(value)) {
-            throw new Error(`Language <${value}> is not supported`);
-        }
-    }
-
-    public base(): string {
-        return this.value.split('-')[0];
-    }
-
-    public static create(raw: string): Language {
-        const normalized = raw.trim().toLowerCase().replace('_', '-');
-        return new Language(normalized);
-    }
-
-}

package/src/domain/value-objects/Price.ts

@@ -1,54 +0,0 @@
-import { ValueObject } from '@domain/contracts/ValueObject';
-import { Currency }   from '@domain/value-objects/Currency';
-
-export class Price extends ValueObject<{ amount: number; currency: Currency }> {
-
-    public static readonly MIN_AMOUNT: number = -1000000;
-
-    public readonly amount: number;
-    public readonly currency: Currency;
-
-    private constructor(amount: number, currency: Currency) {
-        super({ amount, currency });
-        this.amount   = amount;
-        this.currency = currency;
-    }
-
-    protected validate(props: { amount: number; currency: Currency }): void {
-        const { amount, currency } = props;
-
-        if (typeof amount !== 'number' || Number.isNaN(amount) || !Number.isFinite(amount)) {
-            throw new Error(`Price amount <${amount}> is not a valid number`);
-        }
-        if (amount < Price.MIN_AMOUNT) {
-            throw new Error(`Price amount <${amount}> must be ≥ ${Price.MIN_AMOUNT}`);
-        }
-    }
-
-    public equals(other?: Price | null): boolean {
-        if (!other) return false;
-        return this.amount === other.amount && this.currency.equals(other.currency);
-    }
-
-    private assertSameCurrency(other: Price): void {
-        if (!this.currency.equals(other.currency)) {
-            throw new Error('Cannot operate on Price objects with different currencies');
-        }
-    }
-
-    public add(other: Price): Price {
-        this.assertSameCurrency(other);
-        return Price.create(this.amount + other.amount, this.currency);
-    }
-
-    public subtract(other: Price): Price {
-        this.assertSameCurrency(other);
-        return Price.create(this.amount - other.amount, this.currency);
-    }
-
-    public static create(amount: number, currency: Currency | string | number): Price {
-        const cur = currency instanceof Currency ? currency : Currency.create(currency);
-        return new Price(amount, cur);
-    }
-
-}

package/src/domain/value-objects/UUID.ts

@@ -1,23 +0,0 @@
-import {ValueObject} from "@domain/contracts/ValueObject";
-
-export class UUID extends ValueObject<string> {
-
-    private constructor(value: string) {
-        super(value);
-    }
-
-    protected validate(uuid: string) {
-        if (!UUID.isValid(uuid)) {
-            throw new Error(`Invalid uuid ${uuid}`);
-        }
-    }
-
-    public static create(uuid?: string): UUID {
-        return new UUID(uuid ?? crypto.randomUUID());
-    }
-
-    public static isValid(uuid: string): boolean {
-        return /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(uuid);
-    }
-
-}

package/src/index.ts

@@ -1,43 +0,0 @@
-/* ──────────────────────────────────────────────── *
- * DOMAIN                                           *
- * ──────────────────────────────────────────────── */
-// Contracts
-export {DomainEntity} from './domain/contracts/DomainEntity';
-export {DomainError} from './domain/contracts/DomainError';
-export {DomainEvent} from './domain/contracts/DomainEvent';
-export {ValueObject} from './domain/contracts/ValueObject';
-// Errors
-export {FatalError} from './domain/errors/FatalError';
-export {InternalError} from './domain/errors/InternalError';
-export {UsageError} from './domain/errors/UsageError';
-// Value objects
-export {Currency} from './domain/value-objects/Currency';
-export {DateTime} from './domain/value-objects/DateTime';
-export {Email} from './domain/value-objects/Email';
-export {Language} from './domain/value-objects/Language';
-export {Price} from './domain/value-objects/Price';
-export {UUID} from './domain/value-objects/UUID';
-
-
-/* ──────────────────────────────────────────────── *
- * APPLICATION                                      *
- * ──────────────────────────────────────────────── */
-// Contracts
-export {EventBus} from './application/contracts/EventBus';
-export {EventBusRepository} from './application/contracts/EventBusRepository';
-
-
-/* ──────────────────────────────────────────────── *
- * INFRASTRUCTURE                                   *
- * ──────────────────────────────────────────────── */
-// Contracts
-export {DatabaseConnector} from './infrastructure/contracts/DatabaseConnector';
-export {DatabaseConnection} from './infrastructure/contracts/DatabaseConnection';
-export {Logger} from './infrastructure/contracts/Logger';
-// Errors
-export {ErrorManager, ErrorManagerHandleResult, ErrorTemplate} from './infrastructure/errors/ErrorManager';
-// Mysql
-export {MysqlConnector} from './infrastructure/mysql/MysqlConnector';
-export {MysqlConnection} from './infrastructure/mysql/MysqlConnection';
-
-

package/src/infrastructure/contracts/DatabaseConnection.ts

@@ -1,11 +0,0 @@
-
-export interface DatabaseConnection<Q = string, Params = unknown[], Row = Record<string, unknown>> {
-
-    query<T = Row>(statement: Q, params?: Params): Promise<T[]>;
-    begin(): Promise<void>;
-    commit(): Promise<void>;
-    rollback(toSavepoint?: string): Promise<void>;
-    transaction<T>(fn: (conn: this) => Promise<T>): Promise<T>;
-    close(): Promise<void>;
-
-}

package/src/infrastructure/contracts/DatabaseConnector.ts

@@ -1,8 +0,0 @@
-import {DatabaseConnection} from "@infrastructure/contracts/DatabaseConnection";
-
-export interface DatabaseConnector<C extends DatabaseConnection = DatabaseConnection> {
-
-    getConnection(options?: { readonly?: boolean }): Promise<C>;
-    closePool(): Promise<void>;
-
-}

package/src/infrastructure/contracts/Logger.ts

@@ -1,9 +0,0 @@
-export interface Logger {
-
-    debug(type: string, message: string, meta?: Record<string, any>): void;
-    info(type: string, message: string, meta?: Record<string, any>): void;
-    warn(type: string, message: string, meta?: Record<string, any>): void;
-    error(type: string, message: string, meta?: Record<string, any>): void;
-    fatal(type: string, message: string, meta?: Record<string, any>): void;
-
-}

package/src/infrastructure/errors/ErrorManager.ts

@@ -1,93 +0,0 @@
-import {Language} from "@domain/value-objects/Language";
-import {FatalError} from "@domain/errors/FatalError";
-import {InternalError} from "@domain/errors/InternalError";
-import {UsageError} from "@domain/errors/UsageError";
-import {StringVars} from "@utils/StringVars";
-import {Logger} from "@infrastructure/contracts/Logger";
-
-export interface ErrorTemplate {
-    type: string;
-    languages: Record<string, string>;
-}
-
-export type ErrorManagerHandleResult = {
-    status: number | string;
-    message: string;
-};
-
-export class ErrorManager {
-
-    private static readonly DEFAULT_MESSAGES: Record<string, string> = {
-        'es': 'Ups, hemos encontrado un error. Nuestro equipo ya está trabajando para solucionarlo',
-        'en': 'Ups, we found an error. Our team is working on it.',
-        'pt': 'Ops, encontramos um bug. Nossa equipe já está trabalhando para resolver isso.',
-    };
-
-    public static readonly APP_ERRORS = {
-        UNDEFINED: 'UNDEFINED_ERROR',
-        PROCESS: 'PROCESS_ERROR',
-        DATABASE: 'DATABASE_ERROR'
-    } as const;
-
-    private static readonly TEMPLATES = new Map<string, ErrorTemplate>();
-
-    public constructor(private readonly logger: Logger | null = null) {}
-
-    private getDefaultMessage(lang: Language): string {
-        return (ErrorManager.DEFAULT_MESSAGES[lang.value] || ErrorManager.DEFAULT_MESSAGES[lang.base()] || 'error');
-    }
-
-    private onFatal(err: FatalError, lang: Language): ErrorManagerHandleResult {
-        this.logger?.fatal(err.type, err.message);
-        return { status: 'ERROR', message: this.getDefaultMessage(lang) };
-    }
-
-    private onInternal(err: InternalError, lang: Language): ErrorManagerHandleResult {
-        this.logger?.error(err.type, err.message);
-        return { status: 'ERROR', message: this.getDefaultMessage(lang) };
-    }
-
-    private onUsage(err: UsageError, lang: Language): ErrorManagerHandleResult {
-        const tmpl = ErrorManager.TEMPLATES.get(err.type);
-        if (!tmpl) {
-            this.logger?.error('TEMPLATE_NOT_FOUND', `${err.type}`);
-            return { status: 'ERROR', message: this.getDefaultMessage(lang) };
-        }
-        const code = lang.value;
-        const base = lang.base();
-        const rawMsg =
-            tmpl.languages[code] ??
-            tmpl.languages[base] ??
-            this.getDefaultMessage(lang);
-        return {
-            status: 'ERROR',
-            message: StringVars.parse(rawMsg, err.vars),
-        };
-    }
-
-    private onUnknown(err: Error, lang: Language): ErrorManagerHandleResult {
-        this.logger?.error('UNKNOWN_ERROR', err.message);
-        return { status: 'ERROR', message: this.getDefaultMessage(lang) };
-    }
-
-    public handle(err: Error, lang: Language): ErrorManagerHandleResult {
-        if (['local','dev'].includes(process.env.ENVIRONMENT ?? '')) {
-            console.log(err);
-        }
-        if (err instanceof FatalError) {
-            return this.onFatal(err, lang);
-        }
-        if (err instanceof InternalError) {
-            return this.onInternal(err, lang);
-        }
-        if (err instanceof UsageError) {
-            return this.onUsage(err, lang);
-        }
-        return this.onUnknown(err, lang);
-    }
-
-    public static addTemplate(template: ErrorTemplate): void {
-        ErrorManager.TEMPLATES.set(template.type, template);
-    }
-
-}

package/src/infrastructure/mysql/MysqlConnection.ts

@@ -1,45 +0,0 @@
-import {FieldPacket, PoolConnection, RowDataPacket} from "mysql2/promise";
-import {DatabaseConnection} from "@infrastructure/contracts/DatabaseConnection";
-
-export class MysqlConnection implements DatabaseConnection<string, any[], RowDataPacket> {
-
-    private readonly _conn: PoolConnection;
-
-    public constructor(conn: PoolConnection) {
-        this._conn = conn;
-    }
-
-    public async query<R = RowDataPacket>(statement: string, params: any[] = [],): Promise<R[]> {
-        const [rows] = await this._conn.query<R[] & RowDataPacket[] & FieldPacket[]>(statement, params);
-        return rows as R[];
-    }
-
-    public async begin(): Promise<void> {
-        await this._conn.beginTransaction();
-    }
-
-    public async commit(): Promise<void> {
-        await this._conn.commit();
-    }
-
-    public async rollback(): Promise<void> {
-        await this._conn.rollback();
-    }
-
-    public async transaction<T>(fn: (conn: this) => Promise<T>): Promise<T> {
-        await this.begin();
-        try {
-            const result: T = await fn(this);
-            await this.commit();
-            return result;
-        } catch (err) {
-            await this.rollback();
-            throw err;
-        }
-    }
-
-    public async close(): Promise<void> {
-        this._conn.release();
-    }
-
-}

package/src/infrastructure/mysql/MysqlConnector.ts

@@ -1,51 +0,0 @@
-import { createPool, Pool, PoolConnection } from 'mysql2/promise';
-import {DatabaseConnector} from "@infrastructure/contracts/DatabaseConnector";
-import {MysqlConnection} from "@infrastructure/mysql/MysqlConnection";
-
-export class MysqlConnector implements DatabaseConnector<MysqlConnection> {
-    public static readonly DEFAULT_POOL_SIZE: number = 10;
-
-    private readonly _pool: Pool;
-
-    public constructor(pool?: Pool) {
-        this._pool =
-            pool ??
-            createPool({
-                host:     process.env.DB_HOST,
-                port:     Number(process.env.DB_PORT ?? 3306),
-                user:     process.env.DB_USER,
-                password: process.env.DB_PASSWORD,
-                database: process.env.DB_NAME,
-                connectionLimit:
-                    Number(process.env.DB_POOL_SIZE) || MysqlConnector.DEFAULT_POOL_SIZE,
-                decimalNumbers: true,
-            });
-    }
-
-    private async wrap(conn: PoolConnection): Promise<MysqlConnection> {
-        return new MysqlConnection(conn);
-    }
-
-    public async getConnection(): Promise<MysqlConnection> {
-        const conn: PoolConnection = await this._pool.getConnection();
-        return this.wrap(conn);
-    }
-
-    public async closePool(): Promise<void> {
-        await this._pool.end();
-    }
-
-    public static async ping(): Promise<boolean> {
-        const connector: MysqlConnector = new MysqlConnector();
-        try {
-            const conn = await connector._pool.getConnection();
-            await conn.ping();
-            conn.release();
-            return true;
-        } catch {
-            return false;
-        } finally {
-            await connector.closePool();
-        }
-    }
-}

package/src/utils/StringVars.ts

@@ -1,14 +0,0 @@
-export class StringVars {
-
-    public static parse(str: string, ob: { [key: string]: any }): string {
-        const regex = /{{(.*?)}}/g;
-        return str.replace(regex, (match, variable) => {
-            if (ob.hasOwnProperty(variable.trim())) {
-                return ob[variable.trim()];
-            } else {
-                return match;
-            }
-        });
-    }
-
-}

package/test/domain/value-objects/Currency.test.ts

@@ -1,48 +0,0 @@
-import { Currency } from '@domain/value-objects/Currency';
-
-describe('Currency ValueObject', () => {
-
-    it('creates from alpha code (case‑insensitive) and exposes numeric', () => {
-        const uyu = Currency.create('uyu');
-        expect(uyu.value).toBe('UYU');
-        expect(uyu.numeric).toBe(858);
-    });
-
-    it('creates from numeric code (number) and maps to alpha', () => {
-        const uyu = Currency.create(858);
-        expect(uyu.value).toBe('UYU');
-        expect(uyu.numeric).toBe(858);
-    });
-
-    it('creates from numeric code (string) and maps to alpha', () => {
-        const ars = Currency.create('032');
-        expect(ars.value).toBe('ARS');
-        expect(ars.numeric).toBe(32);
-    });
-
-    it('equals() returns true for different representations of same currency', () => {
-        const a = Currency.create('uyu');
-        const b = Currency.create(858);
-        expect(a.equals(b)).toBe(true);
-        expect(a.equals(Currency.UYU)).toBe(true);
-    });
-
-    it('isValid() returns true for valid inputs', () => {
-        expect(Currency.isValid('USD')).toBe(true);
-        expect(Currency.isValid(840)).toBe(true);
-    });
-
-    it('isValid() returns false for invalid inputs', () => {
-        expect(Currency.isValid('US')).toBe(false);
-        expect(Currency.isValid('USDX')).toBe(false);
-        expect(Currency.isValid(999)).toBe(false);
-    });
-
-    it('throws when alpha code is invalid', () => {
-        expect(() => Currency.create('ABC1')).toThrow(Error);
-    });
-
-    it('throws when numeric code is unknown', () => {
-        expect(() => Currency.create(999)).toThrow(Error);
-    });
-});

package/test/domain/value-objects/DateTime.test.ts

@@ -1,32 +0,0 @@
-import { DateTime } from '@domain/value-objects/DateTime';
-
-describe('DateTime ValueObject', () => {
-    const ISO = '2025-07-27T15:30:00Z';
-    const TS  = Date.parse(ISO);
-
-    it('creates from ISO string', () => {
-        const dt = DateTime.create(ISO);
-        expect(dt.value).toBe('2025-07-27 15:30:00');
-        expect(dt.year).toBe(2025);
-    });
-
-    it('creates from timestamp', () => {
-        const dt = DateTime.create(TS);
-        expect(dt.day).toBe(27);
-    });
-
-    it('plusDays() returns a new DateTime with expected day', () => {
-        const dt = DateTime.create(ISO).plusDays(3);
-        expect(dt.day).toBe(30);
-    });
-
-    it('minusHours() returns a new DateTime with expected hour', () => {
-        const dt = DateTime.create(ISO).minusHours(2);
-        expect(dt.hour).toBe(13);
-    });
-
-    it('getMonthName() obeys locale', () => {
-        const dt = DateTime.create(ISO);
-        expect(dt.getMonthName('es')).toBe('julio'); // Luxon locale
-    });
-});

package/test/domain/value-objects/Email.test.ts

@@ -1,38 +0,0 @@
-import { Email } from '@domain/value-objects/Email';
-
-describe('Email ValueObject', () => {
-
-    it('creates from a valid e‑mail string', () => {
-        const mail = Email.create('user@example.com');
-        expect(mail.value).toBe('user@example.com');
-    });
-
-    it('trims whitespace before validation/storage', () => {
-        const mail = Email.create('  user@example.com \n');
-        expect(mail.value).toBe('user@example.com');
-    });
-
-    it('equals() returns true for the exact same address string', () => {
-        const a = Email.create('user@example.com');
-        const b = Email.create('user@example.com');
-        expect(a.equals(b)).toBe(true);
-    });
-
-    it('equals() is case‑sensitive (default behaviour)', () => {
-        const a = Email.create('User@Example.com');
-        const b = Email.create('user@example.com');
-        expect(a.equals(b)).toBe(false);
-    });
-
-    it('isValid() returns true for a correct address', () => {
-        expect(Email.isValid('user@example.com')).toBe(true);
-    });
-
-    it('isValid() returns false for an incorrect address', () => {
-        expect(Email.isValid('not‑an‑email')).toBe(false);
-    });
-
-    it('throws when the address is invalid', () => {
-        expect(() => Email.create('bad‑mail')).toThrow(Error);
-    });
-});

package/test/domain/value-objects/Language.test.ts

@@ -1,76 +0,0 @@
-import { Language } from '@domain/value-objects/Language';
-
-describe('Language ValueObject', () => {
-    describe('create()', () => {
-        it('creates from lowercase code and preserves value', () => {
-            const lang = Language.create('es');
-            expect(lang.value).toBe('es');
-        });
-
-        it('creates from uppercase code by normalizing to lowercase', () => {
-            const lang = Language.create('ES-AR');
-            expect(lang.value).toBe('es-ar');
-        });
-
-        it('replaces underscore with hyphen and normalizes', () => {
-            const lang = Language.create('EN_US');
-            expect(lang.value).toBe('en-us');
-        });
-
-        it('trims whitespace around the code', () => {
-            const lang = Language.create('  en-gb  ');
-            expect(lang.value).toBe('en-gb');
-        });
-    });
-
-    describe('supported constants', () => {
-        it('has a DEFAULT constant of "es"', () => {
-            expect(Language.DEFAULT.value).toBe('es');
-        });
-
-        it('has an ENGLISH_UNITED_STATES constant of "en-us"', () => {
-            expect(Language.ENGLISH_UNITED_STATES.value).toBe('en-us');
-        });
-    });
-
-    describe('base()', () => {
-        it('returns "es" for Spanish variants', () => {
-            const lang = Language.create('es-mx');
-            expect(lang.base()).toBe('es');
-        });
-
-        it('returns "en" for English variants', () => {
-            const lang = Language.create('en-za');
-            expect(lang.base()).toBe('en');
-        });
-
-        it('returns the same value if no region part', () => {
-            const lang = Language.create('pt');
-            expect(lang.base()).toBe('pt');
-        });
-    });
-
-    describe('equals()', () => {
-        it('returns true for two identical codes', () => {
-            const a = Language.create('es');
-            const b = Language.create('ES');
-            expect(a.equals(b)).toBe(true);
-        });
-
-        it('returns false for different codes', () => {
-            const a = Language.create('en');
-            const b = Language.create('es');
-            expect(a.equals(b)).toBe(false);
-        });
-    });
-
-    describe('validation errors', () => {
-        it('throws when creating an unsupported code', () => {
-            expect(() => Language.create('fr')).toThrow('Language <fr> is not supported');
-        });
-
-        it('throws when creating an empty string', () => {
-            expect(() => Language.create('')).toThrow('Language <> is not supported');
-        });
-    });
-});