@fiado/type-kit 3.551.0 → 3.553.0

package/src/common/constants/InputPatterns.ts

@@ -0,0 +1,32 @@
+/** Teléfono MX tal como se teclea en la UI: exactamente 10 dígitos. */
+export const PHONE_MX_PATTERN = /^\d{10}$/;
+
+/** Teléfono MX en el backend: 10 dígitos, opcionalmente con `+52` para clientes que ya lo mandan. */
+export const PHONE_MX_ACCEPTED_PATTERN = /^(?:\+52)?\d{10}$/;
+export const PHONE_MX_MESSAGE = 'El teléfono debe tener 10 dígitos';
+
+/** Correo pragmático: algo@dominio.tld, sin espacios. */
+export const EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+export const EMAIL_MAX_LENGTH = 254;
+export const EMAIL_MESSAGE = 'Ingresa un correo válido';
+
+/** RFC en mayúsculas: 12 caracteres persona moral, 13 persona física. */
+export const RFC_PATTERN = /^[A-ZÑ&]{3,4}\d{6}[A-Z\d]{3}$/;
+export const RFC_MESSAGE = 'El RFC debe tener 12 o 13 caracteres con el formato del SAT';
+
+/** Código postal MX: 5 dígitos. */
+export const ZIP_CODE_MX_PATTERN = /^\d{5}$/;
+export const ZIP_CODE_MX_MESSAGE = 'El código postal debe tener 5 dígitos';
+
+/** SKU: letras, dígitos y guiones, con espacios solo entre palabras. */
+export const SKU_PATTERN = /^[A-Za-z0-9-]+(?: +[A-Za-z0-9-]+)*$/;
+export const SKU_MAX_LENGTH = 64;
+export const 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`. */
+export const IMEI_PATTERN = /^\d{15}$/;
+export const 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 })`. */
+export const HTTPS_URL_PATTERN = /^https:\/\/[^\s/$.?#][^\s]*$/i;
+export const HTTPS_URL_MESSAGE = 'Ingresa una URL que empiece con https://';

package/src/common/decorators/UpperCase.ts

@@ -0,0 +1,5 @@
+import { Transform } from 'class-transformer';
+
+/** Pasa un string a mayúsculas antes de validarlo; deja pasar cualquier otro tipo sin tocarlo. */
+export const UpperCase = (): PropertyDecorator =>
+    Transform(({ value }) => (typeof value === 'string' ? value.toUpperCase() : value));

package/src/common/helpers/imeiChecksum.ts

@@ -0,0 +1,16 @@
+import { IMEI_PATTERN } from '../constants/InputPatterns';
+
+/** Valida un IMEI: 15 dígitos y checksum Luhn. */
+export function isValidImei(imei: string): boolean {
+    if (!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/src/common/index.ts

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

package/src/common/validators/IsMxPhone.ts

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

package/src/common/validators/IsMxZipCode.ts

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

package/src/common/validators/IsRfc.ts

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

package/src/common/validators/IsSku.ts

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

package/src/common/validators/matchesInputPattern.ts

@@ -0,0 +1,24 @@
+import { ValidateBy, ValidationOptions } from 'class-validator';
+
+/** Arma un decorador que exige un string que cumpla `pattern` y, si se da, `maxLength`. */
+export function matchesInputPattern(
+    name: string,
+    pattern: RegExp,
+    message: string,
+    validationOptions?: ValidationOptions,
+    maxLength?: number,
+): PropertyDecorator {
+    return ValidateBy(
+        {
+            name,
+            validator: {
+                validate: (value: unknown): boolean =>
+                    typeof value === 'string' &&
+                    (maxLength === undefined || value.length <= maxLength) &&
+                    pattern.test(value),
+                defaultMessage: (): string => message,
+            },
+        },
+        validationOptions,
+    );
+}

package/src/helpers/constans/regex.ts

@@ -1,3 +1,4 @@
+import { PHONE_MX_PATTERN } from '../../common/constants/InputPatterns';
 
 
 // Expresión regular para validar UUID v4
@@ -21,7 +22,7 @@ export const regexCurp =
 
 // Teléfono MX: exactamente 10 dígitos (se normalizan espacios/guiones antes de validar).
 // Usado por retailCustomer y retailWizard. SureKeep Fase 2 — pista Retail.
-export const regexPhoneMx = /^\d{10}$/;
+export const regexPhoneMx = PHONE_MX_PATTERN;
 
 
 

package/src/loanCredit/dtos/LoanContractDetails.ts

@@ -6,7 +6,7 @@ const SHORT_TEXT = 120;
 /** Largo máximo de un texto largo del contrato (nombre, domicilio, razón social). */
 const LONG_TEXT = 300;
 /** IMEI: exactamente 15 dígitos. */
-const IMEI_PATTERN = /^\d{15}$/;
+import { IMEI_PATTERN } from '../../common/constants/InputPatterns';
 
 /** Datos del acreditado tal como se imprimen en el contrato (Sección II.1). */
 export class LoanContractBorrowerDetails {

package/src/loanCredit/dtos/LoanDeviceEnrollItem.ts

@@ -1,10 +1,10 @@
 import { Expose } from 'class-transformer';
 import { IsISO8601, IsInt, IsNotEmpty, IsOptional, IsPositive, IsString, Matches, Max, MaxLength } from 'class-validator';
-import { SKU_PATTERN } from '../../retailCatalog/constants/SkuPattern';
+import { SKU_MESSAGE, SKU_PATTERN } from '../../retailCatalog/constants/SkuPattern';
 import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from '../constants/CreditIdPattern';
 
 /** Charset y largo del IMEI: exactamente 15 dígitos. */
-const IMEI_PATTERN = /^\d{15}$/;
+import { IMEI_PATTERN } from '../../common/constants/InputPatterns';
 
 /** Plazo máximo del crédito en meses. */
 const MAX_TERM_MONTHS = 60;
@@ -32,7 +32,7 @@ export class LoanDeviceEnrollItem {
     @IsString()
     @IsNotEmpty()
     @MaxLength(64)
-    @Matches(SKU_PATTERN, { message: 'productSku admite solo [A-Za-z0-9-]' })
+    @Matches(SKU_PATTERN, { message: SKU_MESSAGE })
     productSku: string;
 
     @Expose()

package/src/retailCatalog/constants/SkuPattern.ts

@@ -1,2 +1,2 @@
-/** Charset permitido para el SKU: alfanumérico + guion, 1-64 chars. */
-export const SKU_PATTERN = /^[A-Za-z0-9-]+$/;
+/** Charset del SKU: letras, dígitos, guiones y espacios entre palabras; el tope de 64 va con `@Length`. */
+export { SKU_PATTERN, SKU_MESSAGE } from '../../common/constants/InputPatterns';

package/src/retailCatalog/dtos/Product.ts

@@ -28,7 +28,8 @@ export class Product {
     /** `null` = Sin gama. */
     tier!: ProductTierEnum | null;
     basePriceCents!: number;
-    listPriceCents!: number | null;
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
+    listPriceCents?: number | null;
     eligibleFinanciers!: string[];
     mdmEnabled!: boolean;
     mdmProvider!: MdmProviderEnum | null;

package/src/retailCatalog/dtos/ProductComponent.ts

@@ -1,9 +1,9 @@
 import { IsInt, IsString, Length, Matches, Min } from 'class-validator';
-import { SKU_PATTERN } from '../constants/SkuPattern';
+import { SKU_MESSAGE, SKU_PATTERN } from '../constants/SkuPattern';
 
 /** Componente de un kit (BUNDLE): qué SKU consume y cuántas piezas por kit. */
 export class ProductComponent {
-    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Matches(SKU_PATTERN, { message: SKU_MESSAGE })
     @Length(1, 64)
     @IsString()
     sku!: string;

package/src/retailCatalog/dtos/requests/BackofficeCreateKitRequest.ts

@@ -1,11 +1,11 @@
 import { Type } from 'class-transformer';
 import { ArrayMinSize, IsArray, IsBoolean, IsOptional, IsString, Length, Matches, ValidateNested } from 'class-validator';
-import { SKU_PATTERN } from '../../constants/SkuPattern';
+import { SKU_MESSAGE, SKU_PATTERN } from '../../constants/SkuPattern';
 import { ProductComponent } from '../ProductComponent';
 
 /** Body de POST /backoffice/catalog/kits (backofficeCreateKit); category BUNDLE y origen BACKOFFICE los fija el servidor. */
 export class BackofficeCreateKitRequest {
-    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Matches(SKU_PATTERN, { message: SKU_MESSAGE })
     @Length(1, 64)
     @IsString()
     sku!: string;

package/src/retailCatalog/dtos/requests/BackofficeCreateProductRequest.ts

@@ -1,5 +1,5 @@
 import { IsArray, IsBoolean, IsEnum, IsIn, IsInt, IsISO8601, IsObject, IsOptional, IsString, Length, Matches, Max, Min, Validate, ValidateIf } from 'class-validator';
-import { SKU_PATTERN } from '../../constants/SkuPattern';
+import { SKU_MESSAGE, SKU_PATTERN } from '../../constants/SkuPattern';
 import { NON_BUNDLE_CATEGORIES } from '../../constants/NonBundleCategories';
 import { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
 import { AccessorySubcategoryEnum } from '../../enums/AccessorySubcategoryEnum';
@@ -11,7 +11,7 @@ import { IsMdmCoherentConstraint } from '../../validators/IsMdmCoherentConstrain
 
 /** Body de POST /backoffice/catalog/products (backofficeCreateProduct); itemType PRODUCT y origen BACKOFFICE los fija el servidor. */
 export class BackofficeCreateProductRequest {
-    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Matches(SKU_PATTERN, { message: SKU_MESSAGE })
     @Length(1, 64)
     @IsString()
     sku!: string;

package/src/retailCatalog/dtos/requests/BackofficeCreateServiceRequest.ts

@@ -1,9 +1,9 @@
 import { IsBoolean, IsOptional, IsString, Length, Matches } from 'class-validator';
-import { SKU_PATTERN } from '../../constants/SkuPattern';
+import { SKU_MESSAGE, SKU_PATTERN } from '../../constants/SkuPattern';
 
 /** Body de POST /backoffice/catalog/services (backofficeCreateService); itemType SERVICE y trackingMode QUANTITY los fija el servidor. */
 export class BackofficeCreateServiceRequest {
-    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Matches(SKU_PATTERN, { message: SKU_MESSAGE })
     @Length(1, 64)
     @IsString()
     sku!: string;

package/src/retailCatalog/dtos/requests/BackofficeCreateSkuPriceRequest.ts

@@ -6,6 +6,7 @@ export class BackofficeCreateSkuPriceRequest {
     @Min(0)
     basePriceCents!: number;
 
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
     @IsOptional()
     @IsInt()
     @Min(0)

package/src/retailCatalog/dtos/requests/BackofficeCreateTransferRequest.ts

@@ -1,5 +1,5 @@
 import { ArrayMinSize, ArrayUnique, IsArray, IsInt, IsOptional, IsString, Length, Matches, Min } from 'class-validator';
-import { SKU_PATTERN } from '../../constants/SkuPattern';
+import { SKU_MESSAGE, SKU_PATTERN } from '../../constants/SkuPattern';
 
 /** Body de POST /backoffice/inventory/transfers (backofficeCreateTransfer); origen = destino lo rechaza el dominio. */
 export class BackofficeCreateTransferRequest {
@@ -11,7 +11,7 @@ export class BackofficeCreateTransferRequest {
     @IsString()
     toStoreId!: string;
 
-    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Matches(SKU_PATTERN, { message: SKU_MESSAGE })
     @Length(1, 64)
     @IsString()
     sku!: string;

package/src/retailCatalog/dtos/requests/BackofficeRegisterAdjustmentRequest.ts

@@ -1,6 +1,6 @@
 import { ArrayMinSize, ArrayUnique, IsArray, IsIn, IsInt, IsOptional, IsString, Length, Matches, Min } from 'class-validator';
 import { ADJUSTMENT_REASONS } from '../../constants/AdjustmentReasons';
-import { SKU_PATTERN } from '../../constants/SkuPattern';
+import { SKU_MESSAGE, SKU_PATTERN } from '../../constants/SkuPattern';
 import { InventoryMovementReasonEnum } from '../../enums/InventoryMovementReasonEnum';
 
 /** Body de POST /backoffice/inventory/adjustments (backofficeRegisterAdjustment); resta del disponible con motivo. */
@@ -10,7 +10,7 @@ export class BackofficeRegisterAdjustmentRequest {
     @IsString()
     storeId!: string;
 
-    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Matches(SKU_PATTERN, { message: SKU_MESSAGE })
     @Length(1, 64)
     @IsString()
     sku!: string;

package/src/retailCatalog/dtos/requests/BackofficeRegisterEntryRequest.ts

@@ -1,5 +1,5 @@
 import { ArrayMinSize, ArrayUnique, IsArray, IsEnum, IsInt, IsOptional, IsString, Length, Matches, Min } from 'class-validator';
-import { SKU_PATTERN } from '../../constants/SkuPattern';
+import { SKU_MESSAGE, SKU_PATTERN } from '../../constants/SkuPattern';
 import { InventoryMovementReasonEnum } from '../../enums/InventoryMovementReasonEnum';
 
 /** Body de POST /backoffice/inventory/entries (backofficeRegisterEntry); suma al saldo de la tienda con un MOV# ENTRY. */
@@ -9,7 +9,7 @@ export class BackofficeRegisterEntryRequest {
     @IsString()
     storeId!: string;
 
-    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Matches(SKU_PATTERN, { message: SKU_MESSAGE })
     @Length(1, 64)
     @IsString()
     sku!: string;

package/src/retailCatalog/dtos/requests/CreateProductRequest.ts

@@ -11,7 +11,7 @@ import {
     Min,
     Validate,
 } from 'class-validator';
-import { SKU_PATTERN } from '../../constants/SkuPattern';
+import { SKU_MESSAGE, SKU_PATTERN } from '../../constants/SkuPattern';
 import { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
 import { MdmProviderEnum } from '../../enums/MdmProviderEnum';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
@@ -22,7 +22,7 @@ import { IsMdmCoherentConstraint } from '../../validators/IsMdmCoherentConstrain
  * @deprecated Modelo viejo por IMEI; usar BackofficeCreateProductRequest. Se conserva porque otras ramas lo importan.
  */
 export class CreateProductRequest {
-    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Matches(SKU_PATTERN, { message: SKU_MESSAGE })
     @Length(1, 64)
     @IsString()
     sku!: string;
@@ -61,6 +61,7 @@ export class CreateProductRequest {
     @Min(0)
     basePriceCents!: number;
 
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
     @IsOptional()
     @IsInt()
     @Min(0)

package/src/retailCatalog/dtos/requests/ReturnPieceCondition.ts

@@ -10,14 +10,14 @@ import {
     Validate,
     ValidateIf,
 } from 'class-validator';
-import { SKU_PATTERN } from '../../constants/SkuPattern';
+import { SKU_MESSAGE, SKU_PATTERN } from '../../constants/SkuPattern';
 import { ReturnConditionEnum } from '../../enums/ReturnConditionEnum';
 import { IsPieceRefConstraint } from '../../validators/IsPieceRefConstraint';
 
 /** Condición de una pieza devuelta; ausente = GOOD. Un accesorio por cantidad se declara con sku + qty. */
 export class ReturnPieceCondition {
     @Expose()
-    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Matches(SKU_PATTERN, { message: SKU_MESSAGE })
     @Length(1, 64)
     @IsString()
     sku!: string;

package/src/retailCatalog/dtos/requests/SyncInventoryRequest.ts

@@ -12,7 +12,7 @@ import {
     Min,
     ValidateNested,
 } from 'class-validator';
-import { SKU_PATTERN } from '../../constants/SkuPattern';
+import { SKU_MESSAGE, SKU_PATTERN } from '../../constants/SkuPattern';
 import { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
 import { MdmProviderEnum } from '../../enums/MdmProviderEnum';
 import { ProductCategoryEnum } from '../../enums/ProductCategoryEnum';
@@ -22,6 +22,7 @@ import { ProductComponent } from '../ProductComponent';
 
 /** Precio de un producto en la puerta de entrada; crea PRICE# solo si cambió el monto. */
 export class SyncPrice {
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
     @IsOptional()
     @IsInt()
     @Min(0)
@@ -37,7 +38,7 @@ export class SyncPrice {
 
 /** Producto tal como llega de Zentral. */
 export class SyncProduct {
-    @Matches(SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' })
+    @Matches(SKU_PATTERN, { message: SKU_MESSAGE })
     @Length(1, 64)
     @IsString()
     sku!: string;

package/src/retailCatalog/dtos/requests/UpdateProductRequest.ts

@@ -60,6 +60,7 @@ export class UpdateProductRequest {
     @Min(0)
     basePriceCents?: number;
 
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
     @IsOptional()
     @IsInt()
     @Min(0)

package/src/retailCatalog/dtos/responses/InventoryLensResponse.ts

@@ -69,7 +69,7 @@ export interface InventoryLensSkuItem {
     /** Unidades de este SKU vendidas hoy en esta tienda, **financiadas por SureKeep**. */
     soldTodayUnits: number;
 
-    /** Precio de contado en centavos (`listPriceCents`, o `basePriceCents` si no hay lista). */
+    /** Precio de contado en centavos (`basePriceCents`). */
     cashPriceCents: number;
 }
 

package/src/retailCatalog/dtos/responses/ReserveStockResponse.ts

@@ -16,7 +16,10 @@ export interface ReservedComponent {
 export interface ReserveStockResponse {
     expiresAt: string;
     basePriceCents: number;
-    listPriceCents: number | null;
+    /** @deprecated Usa `giftValueCents`; en reservas GIFT trae el mismo valor, en las demás `null`. */
+    listPriceCents?: number | null;
+    /** Solo en reservas `purpose: GIFT`: valor del regalo, su precio de venta. */
+    giftValueCents?: number;
     /** Llave del registro PRICE# del que salió el precio fijado. */
     priceSk: string;
     eligibleFinanciers: string[];

package/src/retailCatalog/dtos/responses/SkuPriceEntry.ts

@@ -3,7 +3,8 @@ import type { PriceSourceEnum } from '../../enums/PriceSourceEnum';
 /** Un registro del historial de precios PRICE# de un SKU. */
 export interface SkuPriceEntry {
     effectiveFrom: string;
-    listPriceCents: number | null;
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
+    listPriceCents?: number | null;
     basePriceCents: number;
     source: PriceSourceEnum;
     createdBy: string;

package/src/retailCatalog/dtos/responses/StoreCatalogItem.ts

@@ -38,7 +38,7 @@ export interface StoreCatalogItem {
     itemType?: ItemTypeEnum;
     /** Nombre visible para kits y servicios, que no tienen marca/modelo. */
     description?: string;
-    /** Precio de lista de respaldo para un regalo: el precio vigente o, si no hay, product.basePriceCents. */
+    /** @deprecated Ya no se usa; el valor de un regalo es `basePriceCents`. */
     listPriceCents?: number;
     /** Prioridad de venta de 0 a 100; «Recomendados» ordena por ella. */
     salePriority?: number;

package/src/retailIntegration/constants/retailIntegrationLimits.ts

@@ -21,8 +21,8 @@ export const RETAIL_STORE_CODE_MAX_LENGTH = 10;
 export const RETAIL_ZIP_CODE_MIN_LENGTH = 4;
 export const RETAIL_ZIP_CODE_MAX_LENGTH = 10;
 
-/** SKU del catálogo del retailer. */
-export const RETAIL_SKU_PATTERN = /^[A-Za-z0-9-]{1,64}$/;
+/** SKU del catálogo del retailer: el charset de `SKU_PATTERN` con tope de 64. */
+export const RETAIL_SKU_PATTERN = /^(?=.{1,64}$)[A-Za-z0-9-]+(?: +[A-Za-z0-9-]+)*$/;
 
 /** Decimal del contrato: string con dos decimales, nunca negativo. */
 export const RETAIL_DECIMAL_PATTERN = /^\d+\.\d{2}$/;

package/src/retailOrg/dtos/requests/CreateRetailUserRequest.ts

@@ -2,6 +2,7 @@ import { Expose } from 'class-transformer';
 import { IsArray, IsEnum, IsOptional, IsString } from 'class-validator';
 import { CollectorSeniorityEnum } from '../../enums/CollectorSeniorityEnum';
 import { EmploymentTypeEnum } from '../../enums/EmploymentTypeEnum';
+import { IsMxPhone } from '../../../common/validators/IsMxPhone';
 
 /**
  * Body de POST /retailers/:retailerId/users — alta de usuario retail (el `retailerId` sale del path;
@@ -42,7 +43,7 @@ export class CreateRetailUserRequest {
     /** Teléfono de contacto del usuario retail; opcional. */
     @Expose()
     @IsOptional()
-    @IsString()
+    @IsMxPhone()
     phone?: string;
 
     /** Seniority del cobrador; solo aplica a usuarios retail con rol de cobrador. */

package/src/retailOrg/dtos/requests/CreateRetailerRequest.ts

@@ -1,7 +1,10 @@
 import { Expose, Type } from 'class-transformer';
-import { IsDefined, IsEmail, IsEnum, IsString, Length, ValidateNested } from 'class-validator';
+import { IsDefined, IsEmail, IsEnum, IsString, ValidateNested } from 'class-validator';
 import { RetailerTypeEnum } from '../../enums/RetailerTypeEnum';
 import { RetailAddressInput } from './RetailAddressInput';
+import { IsMxPhone } from '../../../common/validators/IsMxPhone';
+import { IsRfc } from '../../../common/validators/IsRfc';
+import { UpperCase } from '../../../common/decorators/UpperCase';
 
 /**
  * Body de POST /retailers — alta de un retailer raíz (SureKeep Fase 1 — pista Retail).
@@ -21,10 +24,11 @@ export class CreateRetailerRequest {
     @IsString()
     legalName!: string;
 
-    /** RFC mexicano — 12 (persona moral / empresa) o 13 (persona física). */
+    /** RFC — 12 (persona moral) o 13 (persona física); se pasa a mayúsculas antes de validar. */
     @Expose()
     @IsString()
-    @Length(12, 13)
+    @UpperCase()
+    @IsRfc()
     rfc!: string;
 
     @Expose()
@@ -32,7 +36,7 @@ export class CreateRetailerRequest {
     contactEmail!: string;
 
     @Expose()
-    @IsString()
+    @IsMxPhone()
     contactPhone!: string;
 
     @Expose()

package/src/retailOrg/dtos/requests/CreateStoreRequest.ts

@@ -9,6 +9,7 @@ import {
 } from 'class-validator';
 import { GeoLocation } from '../GeoLocation';
 import { RetailAddressInput } from './RetailAddressInput';
+import { IsMxPhone } from '../../../common/validators/IsMxPhone';
 
 /**
  * Body de POST /retailers/:retailerId/stores — alta de tienda física (el `retailerId` sale del path).
@@ -44,7 +45,7 @@ export class CreateStoreRequest {
     location!: GeoLocation;
 
     @Expose()
-    @IsString()
+    @IsMxPhone()
     phone!: string;
 
     /** Usuario retail responsable; `null` si no hay gerente asignado. */

package/src/retailOrg/dtos/requests/CreateSubdistributorRequest.ts

@@ -1,7 +1,10 @@
 import { Expose, Type } from 'class-transformer';
-import { IsDefined, IsEmail, IsIn, IsString, Length, ValidateNested } from 'class-validator';
+import { IsDefined, IsEmail, IsIn, IsString, ValidateNested } from 'class-validator';
 import { RetailerTypeEnum } from '../../enums/RetailerTypeEnum';
 import { RetailAddressInput } from './RetailAddressInput';
+import { IsMxPhone } from '../../../common/validators/IsMxPhone';
+import { IsRfc } from '../../../common/validators/IsRfc';
+import { UpperCase } from '../../../common/decorators/UpperCase';
 
 /**
  * Body de POST /retailers/:retailerId/subdistributors — alta de un retailer hijo colgando de
@@ -23,10 +26,11 @@ export class CreateSubdistributorRequest {
     @IsString()
     legalName!: string;
 
-    /** RFC mexicano — 12 (persona moral / empresa) o 13 (persona física). */
+    /** RFC — 12 (persona moral) o 13 (persona física); se pasa a mayúsculas antes de validar. */
     @Expose()
     @IsString()
-    @Length(12, 13)
+    @UpperCase()
+    @IsRfc()
     rfc!: string;
 
     @Expose()
@@ -34,7 +38,7 @@ export class CreateSubdistributorRequest {
     contactEmail!: string;
 
     @Expose()
-    @IsString()
+    @IsMxPhone()
     contactPhone!: string;
 
     @Expose()

package/src/retailOrg/dtos/requests/ProvisionRetailUserRequest.ts

@@ -3,6 +3,7 @@ import { IsArray, IsEmail, IsEnum, IsOptional, IsString } from 'class-validator'
 import { CollectorSeniorityEnum } from '../../enums/CollectorSeniorityEnum';
 import { EmploymentTypeEnum } from '../../enums/EmploymentTypeEnum';
 import { PermissionScope } from '../../../platformRbac/enums/PermissionScope';
+import { IsMxPhone } from '../../../common/validators/IsMxPhone';
 
 /**
  * Body de POST /retailers/:retailerId/users/provision — alta de usuario retail ORQUESTADA (SureKeep F1,
@@ -64,7 +65,7 @@ export class ProvisionRetailUserRequest {
     /** Teléfono de contacto del usuario retail; opcional. */
     @Expose()
     @IsOptional()
-    @IsString()
+    @IsMxPhone()
     phone?: string;
 
     /** Seniority del cobrador; solo aplica a usuarios retail con rol de cobrador. */

package/src/retailOrg/dtos/requests/RetailAddressInput.ts

@@ -1,5 +1,6 @@
 import { Expose } from 'class-transformer';
 import { IsOptional, IsString, Length } from 'class-validator';
+import { IsMxZipCode } from '../../../common/validators/IsMxZipCode';
 
 /**
  * Dirección comercial de entrada (input validado) para los requests de creación/edición del dominio
@@ -53,10 +54,9 @@ export class RetailAddressInput {
     @Length(1, 150)
     state!: string;
 
-    /** Código postal (espejo de `LocationAddress.zipCode`). */
+    /** Código postal MX de 5 dígitos (espejo de `LocationAddress.zipCode`). */
     @Expose()
-    @IsString()
-    @Length(4, 10)
+    @IsMxZipCode()
     zipCode!: string;
 
     /** País ISO. OPCIONAL — sin slot en `LocationAddress` (TD-SKF1-007). */

package/src/retailOrg/dtos/requests/UpdateRetailUserRequest.ts

@@ -2,6 +2,7 @@ import { Expose } from 'class-transformer';
 import { IsArray, IsEnum, IsOptional, IsString } from 'class-validator';
 import { CollectorSeniorityEnum } from '../../enums/CollectorSeniorityEnum';
 import { EmploymentTypeEnum } from '../../enums/EmploymentTypeEnum';
+import { IsMxPhone } from '../../../common/validators/IsMxPhone';
 
 /**
  * Body de PUT /users/:retailUserId — edición de usuario retail (campos editables opcionales).
@@ -33,7 +34,7 @@ export class UpdateRetailUserRequest {
     /** Teléfono de contacto del usuario retail; opcional. */
     @Expose()
     @IsOptional()
-    @IsString()
+    @IsMxPhone()
     phone?: string;
 
     /** Seniority del cobrador; solo aplica a usuarios retail con rol de cobrador. */