@fiado/type-kit 3.551.0 → 3.553.0

package/_test_/unit/common/InputPatternValidators.test.ts

@@ -0,0 +1,64 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { IsOptional, validateSync } from 'class-validator';
+import { IsMxPhone, IsMxZipCode, IsRfc, IsSku, UpperCase } from '../../../src/common';
+
+class Sample {
+    @IsOptional()
+    @IsMxPhone()
+    phone?: string;
+
+    @IsOptional()
+    @IsMxZipCode()
+    zipCode?: string;
+
+    @IsOptional()
+    @UpperCase()
+    @IsRfc()
+    rfc?: string;
+
+    @IsOptional()
+    @IsSku()
+    sku?: string;
+
+    @IsOptional()
+    @IsSku({ each: true })
+    skus?: string[];
+}
+
+const errorsOf = (plain: Record<string, unknown>): string[] =>
+    validateSync(plainToInstance(Sample, plain)).map((e) => e.property);
+
+describe('Decoradores de InputPatterns', () => {
+    it('acepta un objeto vacío: los campos opcionales solo se validan si vienen', () => {
+        expect(errorsOf({})).toEqual([]);
+    });
+
+    it('acepta valores válidos', () => {
+        expect(
+            errorsOf({ phone: '+525512345678', zipCode: '01000', rfc: 'GODE561231GR8', sku: 'SAMSUNG A15', skus: ['A', 'B C'] }),
+        ).toEqual([]);
+        expect(errorsOf({ phone: '5512345678' })).toEqual([]);
+    });
+
+    it('rechaza cada campo inválido', () => {
+        expect(errorsOf({ phone: '55123' })).toEqual(['phone']);
+        expect(errorsOf({ zipCode: '6400' })).toEqual(['zipCode']);
+        expect(errorsOf({ rfc: 'XYZ' })).toEqual(['rfc']);
+        expect(errorsOf({ sku: ' A' })).toEqual(['sku']);
+        expect(errorsOf({ sku: 'A'.repeat(65) })).toEqual(['sku']);
+        expect(errorsOf({ skus: ['A', 'B '] })).toEqual(['skus']);
+        expect(errorsOf({ phone: 5512345678 })).toEqual(['phone']);
+    });
+
+    it('UpperCase normaliza el RFC antes de validarlo', () => {
+        const dto = plainToInstance(Sample, { rfc: 'gode561231gr8' });
+        expect(dto.rfc).toBe('GODE561231GR8');
+        expect(validateSync(dto)).toEqual([]);
+    });
+
+    it('mensajes en español', () => {
+        const [error] = validateSync(plainToInstance(Sample, { phone: '1' }));
+        expect(Object.values(error.constraints ?? {})[0]).toMatch(/10 dígitos/);
+    });
+});

package/_test_/unit/common/InputPatterns.test.ts

@@ -0,0 +1,104 @@
+import 'reflect-metadata';
+import {
+    EMAIL_MAX_LENGTH,
+    EMAIL_PATTERN,
+    HTTPS_URL_PATTERN,
+    IMEI_PATTERN,
+    PHONE_MX_ACCEPTED_PATTERN,
+    PHONE_MX_PATTERN,
+    RFC_PATTERN,
+    SKU_MAX_LENGTH,
+    SKU_PATTERN,
+    ZIP_CODE_MX_PATTERN,
+    isValidImei,
+} from '../../../src/common';
+import { SKU_PATTERN as CATALOG_SKU_PATTERN } from '../../../src/retailCatalog/constants/SkuPattern';
+import { RETAIL_SKU_PATTERN } from '../../../src/retailIntegration/constants/retailIntegrationLimits';
+import { regexPhoneMx } from '../../../src/helpers/constans/regex';
+
+describe('InputPatterns', () => {
+    describe('PHONE_MX_PATTERN (UI, 10 dígitos)', () => {
+        it.each(['5512345678', '0000000000'])('acepta %s', (v) => expect(PHONE_MX_PATTERN.test(v)).toBe(true));
+        it.each(['+525512345678', '551234567', '55123456789', '55-1234-5678', '55 1234 5678', 'abcdefghij', ''])(
+            'rechaza %s',
+            (v) => expect(PHONE_MX_PATTERN.test(v)).toBe(false),
+        );
+        it('helpers/regex reexporta el mismo patrón', () => expect(regexPhoneMx).toBe(PHONE_MX_PATTERN));
+    });
+
+    describe('PHONE_MX_ACCEPTED_PATTERN (backend, admite +52)', () => {
+        it.each(['5512345678', '+525512345678'])('acepta %s', (v) => expect(PHONE_MX_ACCEPTED_PATTERN.test(v)).toBe(true));
+        it.each(['525512345678', '+15512345678', '+52551234567', '+52 5512345678', '+5255123456789', ''])(
+            'rechaza %s',
+            (v) => expect(PHONE_MX_ACCEPTED_PATTERN.test(v)).toBe(false),
+        );
+    });
+
+    describe('EMAIL_PATTERN', () => {
+        it.each(['ana@somosfiado.com', 'a.b+tag@sub.dominio.mx'])('acepta %s', (v) => expect(EMAIL_PATTERN.test(v)).toBe(true));
+        it.each(['ana', 'ana@', '@fiado.com', 'ana@fiado', 'ana @fiado.com', 'ana@@fiado.com', ''])(
+            'rechaza %s',
+            (v) => expect(EMAIL_PATTERN.test(v)).toBe(false),
+        );
+        it('el tope es 254', () => expect(EMAIL_MAX_LENGTH).toBe(254));
+    });
+
+    describe('RFC_PATTERN', () => {
+        it.each(['ABC010203XY1', 'Ñ&A010203AB9', 'GODE561231GR8', 'ÑAAB800101A12'])('acepta %s', (v) =>
+            expect(RFC_PATTERN.test(v)).toBe(true),
+        );
+        it.each(['abc010203xy1', 'AB010203XY1', 'ABCDE010203XY1', 'ABC01020XY1', 'ABC010203XY', 'GODE561231GR8X', 'GODE 561231GR8', ''])(
+            'rechaza %s',
+            (v) => expect(RFC_PATTERN.test(v)).toBe(false),
+        );
+        it('12 caracteres es persona moral y 13 persona física', () => {
+            expect('ABC010203XY1').toHaveLength(12);
+            expect('GODE561231GR8').toHaveLength(13);
+        });
+    });
+
+    describe('ZIP_CODE_MX_PATTERN', () => {
+        it.each(['01000', '64000'])('acepta %s', (v) => expect(ZIP_CODE_MX_PATTERN.test(v)).toBe(true));
+        it.each(['1000', '640000', '6400A', '64 000', ''])('rechaza %s', (v) => expect(ZIP_CODE_MX_PATTERN.test(v)).toBe(false));
+    });
+
+    describe('SKU_PATTERN', () => {
+        it.each(['IPH15-128-NEG', 'abc123', 'SAMSUNG A15 128GB', 'KIT-1 FUNDA 2', 'A  B'])('acepta %p', (v) =>
+            expect(SKU_PATTERN.test(v)).toBe(true),
+        );
+        it.each([' SKU', 'SKU ', ' ', '', 'SKU_1', 'SKU#1', 'SKU\t1', 'SKU\n1', 'SKÚ'])('rechaza %p', (v) =>
+            expect(SKU_PATTERN.test(v)).toBe(false),
+        );
+        it('el tope es 64', () => expect(SKU_MAX_LENGTH).toBe(64));
+        it('retailCatalog reexporta el mismo patrón', () => expect(CATALOG_SKU_PATTERN).toBe(SKU_PATTERN));
+    });
+
+    describe('RETAIL_SKU_PATTERN (webhook, 1 a 64)', () => {
+        it.each(['SAMSUNG A15 128GB', 'A'.repeat(64), 'A B'])('acepta %p', (v) => expect(RETAIL_SKU_PATTERN.test(v)).toBe(true));
+        it.each(['A'.repeat(65), ' A', 'A ', '', 'A_B'])('rechaza %p', (v) => expect(RETAIL_SKU_PATTERN.test(v)).toBe(false));
+    });
+
+    describe('IMEI', () => {
+        it('IMEI_PATTERN exige 15 dígitos', () => {
+            expect(IMEI_PATTERN.test('490154203237518')).toBe(true);
+            expect(IMEI_PATTERN.test('49015420323751')).toBe(false);
+            expect(IMEI_PATTERN.test('4901542032375180')).toBe(false);
+            expect(IMEI_PATTERN.test('49015420323751A')).toBe(false);
+        });
+        it('isValidImei aplica Luhn', () => {
+            expect(isValidImei('490154203237518')).toBe(true);
+            expect(isValidImei('490154203237519')).toBe(false);
+            expect(isValidImei('49015420323751')).toBe(false);
+        });
+    });
+
+    describe('HTTPS_URL_PATTERN', () => {
+        it.each(['https://cdn.fiado.com/img/1.png', 'https://fiado.com', 'https://a.b/c?d=1#e'])('acepta %s', (v) =>
+            expect(HTTPS_URL_PATTERN.test(v)).toBe(true),
+        );
+        it.each(['http://fiado.com', 'ftp://fiado.com', 'https://', 'https://fiado com', 'fiado.com', 'javascript:alert(1)', ''])(
+            'rechaza %s',
+            (v) => expect(HTTPS_URL_PATTERN.test(v)).toBe(false),
+        );
+    });
+});

package/_test_/unit/retailCatalog/backofficeRequests.test.ts

@@ -74,7 +74,7 @@ describe('BackofficeCreateKitRequest (backofficeCreateKit)', () => {
   });
   it('rechaza un kit sin componentes', () => expect(errorsOf(BackofficeCreateKitRequest, { ...ok, components: [] })).toContain('components'));
   it('valida cada componente', () => {
-    const errors = errorsOf(BackofficeCreateKitRequest, { ...ok, components: [{ sku: 'SIM 1', qty: 0 }] });
+    const errors = errorsOf(BackofficeCreateKitRequest, { ...ok, components: [{ sku: 'SIM 1 ', qty: 0 }] });
     expect(errors).toEqual(expect.arrayContaining(['components.0.sku', 'components.0.qty']));
   });
   it('rechaza descripción en blanco', () => expect(errorsOf(BackofficeCreateKitRequest, { ...ok, description: ' ' })).toContain('description'));

package/_test_/unit/retailCatalog/singlePriceFields.test.ts

@@ -0,0 +1,48 @@
+import 'reflect-metadata';
+import * as RetailCatalog from '../../../src/retailCatalog';
+
+// ts-jest compila con type-check: si un campo sigue obligatorio o no existe, la suite no compila.
+describe('retailCatalog — un solo precio y valor del regalo', () => {
+  const reservation: RetailCatalog.ReserveStockResponse = {
+    expiresAt: '2026-10-20T20:30:00.000Z',
+    basePriceCents: 0,
+    priceSk: '2026-10-01T00:00:00.000Z',
+    eligibleFinanciers: [],
+    sellItemCost: 1,
+    mdmEnabled: false,
+    mdmProvider: null,
+  };
+
+  it('ReserveStockResponse es válida sin listPriceCents ni giftValueCents', () => {
+    expect(reservation.giftValueCents).toBeUndefined();
+    expect(reservation.listPriceCents).toBeUndefined();
+  });
+
+  it('la reserva de regalo trae giftValueCents', () => {
+    const gift: RetailCatalog.ReserveStockResponse = { ...reservation, giftValueCents: 35000 };
+    expect(gift.giftValueCents).toBe(35000);
+  });
+
+  it('acepta los dos nombres con el mismo valor mientras dure la transición', () => {
+    const gift: RetailCatalog.ReserveStockResponse = { ...reservation, giftValueCents: 35000, listPriceCents: 35000 };
+    expect(gift.listPriceCents).toBe(gift.giftValueCents);
+  });
+
+  it('Product es válido sin listPriceCents', () => {
+    const product: Pick<RetailCatalog.Product, 'sku' | 'basePriceCents' | 'listPriceCents'> = {
+      sku: 'SKU-1',
+      basePriceCents: 129900,
+    };
+    expect(product.listPriceCents).toBeUndefined();
+  });
+
+  it('SkuPriceEntry es válido sin listPriceCents', () => {
+    const entry: RetailCatalog.SkuPriceEntry = {
+      effectiveFrom: '2026-10-20T00:00:00.000Z',
+      basePriceCents: 129900,
+      source: RetailCatalog.PriceSourceEnum.BACKOFFICE,
+      createdBy: 'backoffice-user-1',
+    };
+    expect(entry.listPriceCents).toBeUndefined();
+  });
+});

package/_test_/unit/retailIntegration/eventPayloads.test.ts

@@ -94,6 +94,7 @@ describe('ProductEventPayload', () => {
         ['price.effectiveFrom', { price: { ...product.price, effectiveFrom: '2026-08-17T20:32:05' } }],
         ['eligibleFinanciers', { eligibleFinanciers: ['NADIE'] }],
         ['tier', { tier: undefined }],
+        ['price.listPrice', { price: { basePrice: '4299.00', effectiveFrom: '2026-08-17T20:32:05Z' } }],
     ])('rechaza %s', async (path, over) => {
         expect(await errorsOf(ProductEventPayload, { ...product, ...over })).toContain(path);
     });

package/_test_/unit/retailOrg/dtos/requests/inputPatternRequests.test.ts

@@ -0,0 +1,93 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import { CreateRetailerRequest } from '../../../../../src/retailOrg/dtos/requests/CreateRetailerRequest';
+import { CreateSubdistributorRequest } from '../../../../../src/retailOrg/dtos/requests/CreateSubdistributorRequest';
+import { UpdateRetailerRequest } from '../../../../../src/retailOrg/dtos/requests/UpdateRetailerRequest';
+import { CreateStoreRequest } from '../../../../../src/retailOrg/dtos/requests/CreateStoreRequest';
+import { UpdateStoreRequest } from '../../../../../src/retailOrg/dtos/requests/UpdateStoreRequest';
+import { CreateRetailUserRequest } from '../../../../../src/retailOrg/dtos/requests/CreateRetailUserRequest';
+import { ProvisionRetailUserRequest } from '../../../../../src/retailOrg/dtos/requests/ProvisionRetailUserRequest';
+import { UpdateRetailUserRequest } from '../../../../../src/retailOrg/dtos/requests/UpdateRetailUserRequest';
+import { RetailAddressInput } from '../../../../../src/retailOrg/dtos/requests/RetailAddressInput';
+import { RetailerTypeEnum } from '../../../../../src/retailOrg/enums/RetailerTypeEnum';
+import { EmploymentTypeEnum } from '../../../../../src/retailOrg/enums/EmploymentTypeEnum';
+import { PermissionScope } from '../../../../../src/platformRbac/enums/PermissionScope';
+
+type Ctor = new () => object;
+const invalidProps = (cls: Ctor, plain: object): string[] =>
+    validateSync(plainToInstance(cls, plain)).map((e) => e.property);
+
+const address = { address1: 'Av. Reforma', city: 'CDMX', state: 'CDMX', zipCode: '01000' };
+const retailer = {
+    name: 'Tienda',
+    legalName: 'Tienda SA',
+    rfc: 'VEN123456ABC',
+    contactEmail: 'a@b.mx',
+    contactPhone: '5512345678',
+    address,
+};
+const store = { zoneId: null, code: 'T1', name: 'Centro', address, location: { lat: 19.4, lng: -99.1 }, phone: '5512345678' };
+const user = { cognitoSub: 'sub', homeStoreId: 's1', employmentType: Object.values(EmploymentTypeEnum)[0], commissionTier: 't', zoneId: null };
+const provision = { ...user, cognitoSub: undefined, email: 'a@b.mx', roleId: 'r', scope: Object.values(PermissionScope)[0], scopeRef: 'x' };
+
+describe('retailOrg: patrones de entrada', () => {
+    describe.each([
+        ['CreateRetailerRequest', CreateRetailerRequest, { ...retailer, type: RetailerTypeEnum.CHAIN }],
+        ['CreateSubdistributorRequest', CreateSubdistributorRequest, { ...retailer, type: RetailerTypeEnum.SUBDISTRIBUTOR }],
+    ])('%s', (_name, cls, valid) => {
+        it('acepta teléfono de 10 dígitos y con +52', () => {
+            expect(invalidProps(cls, valid)).toEqual([]);
+            expect(invalidProps(cls, { ...valid, contactPhone: '+525512345678' })).toEqual([]);
+        });
+        it('rechaza teléfono que no es MX de 10 dígitos', () => {
+            expect(invalidProps(cls, { ...valid, contactPhone: '55-1234-5678' })).toEqual(['contactPhone']);
+            expect(invalidProps(cls, { ...valid, contactPhone: '+15512345678' })).toEqual(['contactPhone']);
+        });
+        it('acepta RFC de 12 y 13 y normaliza minúsculas', () => {
+            expect(invalidProps(cls, { ...valid, rfc: 'GODE561231GR8' })).toEqual([]);
+            const dto = plainToInstance(cls, { ...valid, rfc: 'gode561231gr8' }) as { rfc: string };
+            expect(dto.rfc).toBe('GODE561231GR8');
+            expect(validateSync(dto)).toEqual([]);
+        });
+        it('rechaza RFC con forma inválida', () => {
+            expect(invalidProps(cls, { ...valid, rfc: '123456789012' })).toEqual(['rfc']);
+        });
+    });
+
+    it('UpdateRetailerRequest valida contactPhone solo si viene', () => {
+        expect(invalidProps(UpdateRetailerRequest, {})).toEqual([]);
+        expect(invalidProps(UpdateRetailerRequest, { contactPhone: '+525512345678' })).toEqual([]);
+        expect(invalidProps(UpdateRetailerRequest, { contactPhone: '12345' })).toEqual(['contactPhone']);
+    });
+
+    it('CreateStoreRequest exige teléfono MX', () => {
+        expect(invalidProps(CreateStoreRequest, store)).toEqual([]);
+        expect(invalidProps(CreateStoreRequest, { ...store, phone: '123' })).toEqual(['phone']);
+    });
+
+    it('UpdateStoreRequest valida phone solo si viene', () => {
+        expect(invalidProps(UpdateStoreRequest, {})).toEqual([]);
+        expect(invalidProps(UpdateStoreRequest, { phone: '+525512345678' })).toEqual([]);
+        expect(invalidProps(UpdateStoreRequest, { phone: '55 1234 5678' })).toEqual(['phone']);
+    });
+
+    describe.each([
+        ['CreateRetailUserRequest', CreateRetailUserRequest, user],
+        ['ProvisionRetailUserRequest', ProvisionRetailUserRequest, provision],
+        ['UpdateRetailUserRequest', UpdateRetailUserRequest, {}],
+    ])('%s', (_name, cls, valid) => {
+        it('phone opcional, MX cuando viene', () => {
+            expect(invalidProps(cls, valid)).toEqual([]);
+            expect(invalidProps(cls, { ...valid, phone: '5512345678' })).toEqual([]);
+            expect(invalidProps(cls, { ...valid, phone: '+525512345678' })).toEqual([]);
+            expect(invalidProps(cls, { ...valid, phone: '555123456789' })).toEqual(['phone']);
+        });
+    });
+
+    it('RetailAddressInput exige código postal de 5 dígitos', () => {
+        expect(invalidProps(RetailAddressInput, address)).toEqual([]);
+        expect(invalidProps(RetailAddressInput, { ...address, zipCode: '1000' })).toEqual(['zipCode']);
+        expect(invalidProps(RetailAddressInput, { ...address, zipCode: '0100A' })).toEqual(['zipCode']);
+    });
+});

package/_test_/unit/retailPromotions/giftOptionValue.test.ts

@@ -0,0 +1,20 @@
+import 'reflect-metadata';
+import type { GiftOption } from '../../../src/retailPromotions/index';
+
+describe('GiftOption.valueCents', () => {
+  it('trae el valor del regalo sin listPriceCents', () => {
+    const option: GiftOption = { sku: 'CASE-1', name: 'Funda', valueCents: 35000, inStock: true };
+    expect(option.valueCents).toBe(35000);
+    expect(option.listPriceCents).toBeUndefined();
+  });
+
+  it('acepta los dos nombres con el mismo valor mientras dure la transición', () => {
+    const option: GiftOption = { sku: 'CASE-1', name: 'Funda', valueCents: 35000, listPriceCents: 35000, inStock: true };
+    expect(option.listPriceCents).toBe(option.valueCents);
+  });
+
+  it('sigue aceptando solo el nombre viejo, para no romper a promotions develop', () => {
+    const legacy: GiftOption = { sku: 'CASE-1', name: 'Funda', listPriceCents: 35000, inStock: true };
+    expect(legacy.valueCents).toBeUndefined();
+  });
+});

package/_test_/unit/retailWizard/linesWithoutListPrice.test.ts

@@ -0,0 +1,40 @@
+import 'reflect-metadata';
+import {
+  LinePaymentTypeEnum,
+  WizardLineStatusEnum,
+  type SaleLine,
+  type WizardReservedLine,
+} from '../../../src/retailWizard';
+
+describe('retailWizard — líneas sin precio de lista', () => {
+  it('WizardReservedLine es válida sin listPriceCents', () => {
+    const line: WizardReservedLine = {
+      lineId: 'L1',
+      sku: 'PHONE-1',
+      qty: 1,
+      status: WizardLineStatusEnum.RESERVED,
+      reservationId: 'r-1',
+      expiresAt: '2026-10-20T20:30:00.000Z',
+      basePriceCents: 349900,
+      priceSk: 'p',
+      eligibleFinanciers: ['SUREKEEP'],
+      financeable: true,
+      paymentType: LinePaymentTypeEnum.CREDIT,
+      sellItemCost: 1,
+    };
+    expect(line.listPriceCents).toBeUndefined();
+  });
+
+  it('SaleLine es válida sin listPriceCents', () => {
+    const line: SaleLine = {
+      lineId: 'L1',
+      sku: 'PHONE-1',
+      qty: 1,
+      basePriceCents: 349900,
+      priceSk: 'p',
+      paymentType: LinePaymentTypeEnum.CREDIT,
+      components: [{ sku: 'PHONE-1', qty: 1, identifiers: ['356938035643809'] }],
+    };
+    expect(line.listPriceCents).toBeUndefined();
+  });
+});

package/bin/common/constants/InputPatterns.d.ts

@@ -0,0 +1,25 @@
+/** Teléfono MX tal como se teclea en la UI: exactamente 10 dígitos. */
+export declare const PHONE_MX_PATTERN: RegExp;
+/** Teléfono MX en el backend: 10 dígitos, opcionalmente con `+52` para clientes que ya lo mandan. */
+export declare const PHONE_MX_ACCEPTED_PATTERN: RegExp;
+export declare const PHONE_MX_MESSAGE = "El tel\u00E9fono debe tener 10 d\u00EDgitos";
+/** Correo pragmático: algo@dominio.tld, sin espacios. */
+export declare const EMAIL_PATTERN: RegExp;
+export declare const EMAIL_MAX_LENGTH = 254;
+export declare const EMAIL_MESSAGE = "Ingresa un correo v\u00E1lido";
+/** RFC en mayúsculas: 12 caracteres persona moral, 13 persona física. */
+export declare const RFC_PATTERN: RegExp;
+export declare const RFC_MESSAGE = "El RFC debe tener 12 o 13 caracteres con el formato del SAT";
+/** Código postal MX: 5 dígitos. */
+export declare const ZIP_CODE_MX_PATTERN: RegExp;
+export declare const ZIP_CODE_MX_MESSAGE = "El c\u00F3digo postal debe tener 5 d\u00EDgitos";
+/** SKU: letras, dígitos y guiones, con espacios solo entre palabras. */
+export declare const SKU_PATTERN: RegExp;
+export declare const SKU_MAX_LENGTH = 64;
+export declare const SKU_MESSAGE = "El SKU admite letras, n\u00FAmeros, guiones y espacios entre palabras (m\u00E1ximo 64)";
+/** IMEI: 15 dígitos; el checksum se valida con `isValidImei`. */
+export declare const IMEI_PATTERN: RegExp;
+export declare const IMEI_MESSAGE = "El IMEI debe tener 15 d\u00EDgitos";
+/** URL https sin espacios; en DTOs de backend también sirve `@IsUrl({ protocols: ['https'], require_protocol: true })`. */
+export declare const HTTPS_URL_PATTERN: RegExp;
+export declare const HTTPS_URL_MESSAGE = "Ingresa una URL que empiece con https://";

package/bin/common/constants/InputPatterns.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HTTPS_URL_MESSAGE = exports.HTTPS_URL_PATTERN = exports.IMEI_MESSAGE = exports.IMEI_PATTERN = exports.SKU_MESSAGE = exports.SKU_MAX_LENGTH = exports.SKU_PATTERN = exports.ZIP_CODE_MX_MESSAGE = exports.ZIP_CODE_MX_PATTERN = exports.RFC_MESSAGE = exports.RFC_PATTERN = exports.EMAIL_MESSAGE = exports.EMAIL_MAX_LENGTH = exports.EMAIL_PATTERN = exports.PHONE_MX_MESSAGE = exports.PHONE_MX_ACCEPTED_PATTERN = exports.PHONE_MX_PATTERN = void 0;
+/** Teléfono MX tal como se teclea en la UI: exactamente 10 dígitos. */
+exports.PHONE_MX_PATTERN = /^\d{10}$/;
+/** Teléfono MX en el backend: 10 dígitos, opcionalmente con `+52` para clientes que ya lo mandan. */
+exports.PHONE_MX_ACCEPTED_PATTERN = /^(?:\+52)?\d{10}$/;
+exports.PHONE_MX_MESSAGE = 'El teléfono debe tener 10 dígitos';
+/** Correo pragmático: algo@dominio.tld, sin espacios. */
+exports.EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+exports.EMAIL_MAX_LENGTH = 254;
+exports.EMAIL_MESSAGE = 'Ingresa un correo válido';
+/** RFC en mayúsculas: 12 caracteres persona moral, 13 persona física. */
+exports.RFC_PATTERN = /^[A-ZÑ&]{3,4}\d{6}[A-Z\d]{3}$/;
+exports.RFC_MESSAGE = 'El RFC debe tener 12 o 13 caracteres con el formato del SAT';
+/** Código postal MX: 5 dígitos. */
+exports.ZIP_CODE_MX_PATTERN = /^\d{5}$/;
+exports.ZIP_CODE_MX_MESSAGE = 'El código postal debe tener 5 dígitos';
+/** SKU: letras, dígitos y guiones, con espacios solo entre palabras. */
+exports.SKU_PATTERN = /^[A-Za-z0-9-]+(?: +[A-Za-z0-9-]+)*$/;
+exports.SKU_MAX_LENGTH = 64;
+exports.SKU_MESSAGE = 'El SKU admite letras, números, guiones y espacios entre palabras (máximo 64)';
+/** IMEI: 15 dígitos; el checksum se valida con `isValidImei`. */
+exports.IMEI_PATTERN = /^\d{15}$/;
+exports.IMEI_MESSAGE = 'El IMEI debe tener 15 dígitos';
+/** URL https sin espacios; en DTOs de backend también sirve `@IsUrl({ protocols: ['https'], require_protocol: true })`. */
+exports.HTTPS_URL_PATTERN = /^https:\/\/[^\s/$.?#][^\s]*$/i;
+exports.HTTPS_URL_MESSAGE = 'Ingresa una URL que empiece con https://';

package/bin/common/decorators/UpperCase.d.ts

@@ -0,0 +1,2 @@
+/** Pasa un string a mayúsculas antes de validarlo; deja pasar cualquier otro tipo sin tocarlo. */
+export declare const UpperCase: () => PropertyDecorator;

package/bin/common/decorators/UpperCase.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpperCase = void 0;
+const class_transformer_1 = require("class-transformer");
+/** Pasa un string a mayúsculas antes de validarlo; deja pasar cualquier otro tipo sin tocarlo. */
+const UpperCase = () => (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.toUpperCase() : value));
+exports.UpperCase = UpperCase;

package/bin/common/helpers/imeiChecksum.d.ts

@@ -0,0 +1,2 @@
+/** Valida un IMEI: 15 dígitos y checksum Luhn. */
+export declare function isValidImei(imei: string): boolean;

package/bin/common/helpers/imeiChecksum.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidImei = isValidImei;
+const InputPatterns_1 = require("../constants/InputPatterns");
+/** Valida un IMEI: 15 dígitos y checksum Luhn. */
+function isValidImei(imei) {
+    if (!InputPatterns_1.IMEI_PATTERN.test(imei))
+        return false;
+    let sum = 0;
+    for (let i = 0; i < 15; i++) {
+        let digit = Number(imei[i]);
+        if (i % 2 === 1) {
+            digit *= 2;
+            if (digit > 9)
+                digit -= 9;
+        }
+        sum += digit;
+    }
+    return sum % 10 === 0;
+}

package/bin/common/index.d.ts

@@ -1,5 +1,13 @@
+export * from './constants/InputPatterns';
+export * from './helpers/imeiChecksum';
 export * from './decorators/Trim';
+export * from './decorators/UpperCase';
 export * from './validators/IsStringValueRecord';
+export * from './validators/matchesInputPattern';
+export * from './validators/IsMxPhone';
+export * from './validators/IsMxZipCode';
+export * from './validators/IsRfc';
+export * from './validators/IsSku';
 export * from './dtos/ProcessValidationResultDto';
 export * from './enums/ProcessValidationEnum';
 export * from './enums/ProcessResultEnum';

package/bin/common/index.js

@@ -14,10 +14,20 @@ 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 });
+//constants
+__exportStar(require("./constants/InputPatterns"), exports);
+//helpers
+__exportStar(require("./helpers/imeiChecksum"), exports);
 //decorators
 __exportStar(require("./decorators/Trim"), exports);
+__exportStar(require("./decorators/UpperCase"), exports);
 //validators
 __exportStar(require("./validators/IsStringValueRecord"), exports);
+__exportStar(require("./validators/matchesInputPattern"), exports);
+__exportStar(require("./validators/IsMxPhone"), exports);
+__exportStar(require("./validators/IsMxZipCode"), exports);
+__exportStar(require("./validators/IsRfc"), exports);
+__exportStar(require("./validators/IsSku"), exports);
 //dtos
 __exportStar(require("./dtos/ProcessValidationResultDto"), exports);
 //Enums

package/bin/common/validators/IsMxPhone.d.ts

@@ -0,0 +1,3 @@
+import { ValidationOptions } from 'class-validator';
+/** Teléfono MX de 10 dígitos; admite el prefijo `+52`. */
+export declare const IsMxPhone: (validationOptions?: ValidationOptions) => PropertyDecorator;

package/bin/common/validators/IsMxPhone.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsMxPhone = void 0;
+const InputPatterns_1 = require("../constants/InputPatterns");
+const matchesInputPattern_1 = require("./matchesInputPattern");
+/** Teléfono MX de 10 dígitos; admite el prefijo `+52`. */
+const IsMxPhone = (validationOptions) => (0, matchesInputPattern_1.matchesInputPattern)('isMxPhone', InputPatterns_1.PHONE_MX_ACCEPTED_PATTERN, InputPatterns_1.PHONE_MX_MESSAGE, validationOptions);
+exports.IsMxPhone = IsMxPhone;

package/bin/common/validators/IsMxZipCode.d.ts

@@ -0,0 +1,3 @@
+import { ValidationOptions } from 'class-validator';
+/** Código postal MX de 5 dígitos. */
+export declare const IsMxZipCode: (validationOptions?: ValidationOptions) => PropertyDecorator;

package/bin/common/validators/IsMxZipCode.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsMxZipCode = void 0;
+const InputPatterns_1 = require("../constants/InputPatterns");
+const matchesInputPattern_1 = require("./matchesInputPattern");
+/** Código postal MX de 5 dígitos. */
+const IsMxZipCode = (validationOptions) => (0, matchesInputPattern_1.matchesInputPattern)('isMxZipCode', InputPatterns_1.ZIP_CODE_MX_PATTERN, InputPatterns_1.ZIP_CODE_MX_MESSAGE, validationOptions);
+exports.IsMxZipCode = IsMxZipCode;

package/bin/common/validators/IsRfc.d.ts

@@ -0,0 +1,3 @@
+import { ValidationOptions } from 'class-validator';
+/** RFC en mayúsculas; combínalo con `@UpperCase()` para normalizar la entrada. */
+export declare const IsRfc: (validationOptions?: ValidationOptions) => PropertyDecorator;

package/bin/common/validators/IsRfc.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsRfc = void 0;
+const InputPatterns_1 = require("../constants/InputPatterns");
+const matchesInputPattern_1 = require("./matchesInputPattern");
+/** RFC en mayúsculas; combínalo con `@UpperCase()` para normalizar la entrada. */
+const IsRfc = (validationOptions) => (0, matchesInputPattern_1.matchesInputPattern)('isRfc', InputPatterns_1.RFC_PATTERN, InputPatterns_1.RFC_MESSAGE, validationOptions);
+exports.IsRfc = IsRfc;

package/bin/common/validators/IsSku.d.ts

@@ -0,0 +1,3 @@
+import { ValidationOptions } from 'class-validator';
+/** SKU de 1 a 64 caracteres: letras, dígitos, guiones y espacios entre palabras. */
+export declare const IsSku: (validationOptions?: ValidationOptions) => PropertyDecorator;

package/bin/common/validators/IsSku.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsSku = void 0;
+const InputPatterns_1 = require("../constants/InputPatterns");
+const matchesInputPattern_1 = require("./matchesInputPattern");
+/** SKU de 1 a 64 caracteres: letras, dígitos, guiones y espacios entre palabras. */
+const IsSku = (validationOptions) => (0, matchesInputPattern_1.matchesInputPattern)('isSku', InputPatterns_1.SKU_PATTERN, InputPatterns_1.SKU_MESSAGE, validationOptions, InputPatterns_1.SKU_MAX_LENGTH);
+exports.IsSku = IsSku;

package/bin/common/validators/matchesInputPattern.d.ts

@@ -0,0 +1,3 @@
+import { ValidationOptions } from 'class-validator';
+/** Arma un decorador que exige un string que cumpla `pattern` y, si se da, `maxLength`. */
+export declare function matchesInputPattern(name: string, pattern: RegExp, message: string, validationOptions?: ValidationOptions, maxLength?: number): PropertyDecorator;

package/bin/common/validators/matchesInputPattern.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchesInputPattern = matchesInputPattern;
+const class_validator_1 = require("class-validator");
+/** Arma un decorador que exige un string que cumpla `pattern` y, si se da, `maxLength`. */
+function matchesInputPattern(name, pattern, message, validationOptions, maxLength) {
+    return (0, class_validator_1.ValidateBy)({
+        name,
+        validator: {
+            validate: (value) => typeof value === 'string' &&
+                (maxLength === undefined || value.length <= maxLength) &&
+                pattern.test(value),
+            defaultMessage: () => message,
+        },
+    }, validationOptions);
+}

package/bin/helpers/constans/regex.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.regexPhoneMx = exports.regexCurp = exports.regexIso8601Date = exports.regexPhoneNumber = exports.regexIso8601 = exports.regexUuidV4 = void 0;
+const InputPatterns_1 = require("../../common/constants/InputPatterns");
 // Expresión regular para validar UUID v4
 exports.regexUuidV4 = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 // Expresión regular para validar fecha ISO 8601
@@ -17,4 +18,4 @@ exports.regexIso8601Date = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d{1,3})?(Z|
 exports.regexCurp = /^[A-Z][AEIOUX][A-Z]{2}\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\d|3[01])[HM][A-Z]{2}[B-DF-HJ-NP-TV-Z]{3}[A-Z\d]\d$/;
 // Teléfono MX: exactamente 10 dígitos (se normalizan espacios/guiones antes de validar).
 // Usado por retailCustomer y retailWizard. SureKeep Fase 2 — pista Retail.
-exports.regexPhoneMx = /^\d{10}$/;
+exports.regexPhoneMx = InputPatterns_1.PHONE_MX_PATTERN;