@fiado/type-kit 3.552.0 → 3.554.0

package/bin/retailCatalog/constants/SkuPattern.js

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SKU_PATTERN = void 0;
-/** Charset permitido para el SKU: alfanumérico + guion, 1-64 chars. */
-exports.SKU_PATTERN = /^[A-Za-z0-9-]+$/;
+exports.SKU_MESSAGE = exports.SKU_PATTERN = void 0;
+/** Charset del SKU: letras, dígitos, guiones y espacios entre palabras; el tope de 64 va con `@Length`. */
+var InputPatterns_1 = require("../../common/constants/InputPatterns");
+Object.defineProperty(exports, "SKU_PATTERN", { enumerable: true, get: function () { return InputPatterns_1.SKU_PATTERN; } });
+Object.defineProperty(exports, "SKU_MESSAGE", { enumerable: true, get: function () { return InputPatterns_1.SKU_MESSAGE; } });

package/bin/retailCatalog/dtos/ProductComponent.js

@@ -17,7 +17,7 @@ class ProductComponent {
 }
 exports.ProductComponent = ProductComponent;
 __decorate([
-    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' }),
+    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: SkuPattern_1.SKU_MESSAGE }),
     (0, class_validator_1.Length)(1, 64),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)

package/bin/retailCatalog/dtos/requests/BackofficeCreateKitRequest.js

@@ -19,7 +19,7 @@ class BackofficeCreateKitRequest {
 }
 exports.BackofficeCreateKitRequest = BackofficeCreateKitRequest;
 __decorate([
-    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' }),
+    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: SkuPattern_1.SKU_MESSAGE }),
     (0, class_validator_1.Length)(1, 64),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)

package/bin/retailCatalog/dtos/requests/BackofficeCreateProductRequest.js

@@ -25,7 +25,7 @@ class BackofficeCreateProductRequest {
 }
 exports.BackofficeCreateProductRequest = BackofficeCreateProductRequest;
 __decorate([
-    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' }),
+    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: SkuPattern_1.SKU_MESSAGE }),
     (0, class_validator_1.Length)(1, 64),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)

package/bin/retailCatalog/dtos/requests/BackofficeCreateServiceRequest.js

@@ -17,7 +17,7 @@ class BackofficeCreateServiceRequest {
 }
 exports.BackofficeCreateServiceRequest = BackofficeCreateServiceRequest;
 __decorate([
-    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' }),
+    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: SkuPattern_1.SKU_MESSAGE }),
     (0, class_validator_1.Length)(1, 64),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)

package/bin/retailCatalog/dtos/requests/BackofficeCreateTransferRequest.js

@@ -27,7 +27,7 @@ __decorate([
     __metadata("design:type", String)
 ], BackofficeCreateTransferRequest.prototype, "toStoreId", void 0);
 __decorate([
-    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' }),
+    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: SkuPattern_1.SKU_MESSAGE }),
     (0, class_validator_1.Length)(1, 64),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)

package/bin/retailCatalog/dtos/requests/BackofficeRegisterAdjustmentRequest.js

@@ -24,7 +24,7 @@ __decorate([
     __metadata("design:type", String)
 ], BackofficeRegisterAdjustmentRequest.prototype, "storeId", void 0);
 __decorate([
-    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' }),
+    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: SkuPattern_1.SKU_MESSAGE }),
     (0, class_validator_1.Length)(1, 64),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)

package/bin/retailCatalog/dtos/requests/BackofficeRegisterEntryRequest.js

@@ -23,7 +23,7 @@ __decorate([
     __metadata("design:type", String)
 ], BackofficeRegisterEntryRequest.prototype, "storeId", void 0);
 __decorate([
-    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' }),
+    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: SkuPattern_1.SKU_MESSAGE }),
     (0, class_validator_1.Length)(1, 64),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)

package/bin/retailCatalog/dtos/requests/CreateProductRequest.js

@@ -24,7 +24,7 @@ class CreateProductRequest {
 }
 exports.CreateProductRequest = CreateProductRequest;
 __decorate([
-    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' }),
+    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: SkuPattern_1.SKU_MESSAGE }),
     (0, class_validator_1.Length)(1, 64),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)

package/bin/retailCatalog/dtos/requests/ReturnPieceCondition.js

@@ -24,7 +24,7 @@ class ReturnPieceCondition {
 exports.ReturnPieceCondition = ReturnPieceCondition;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' }),
+    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: SkuPattern_1.SKU_MESSAGE }),
     (0, class_validator_1.Length)(1, 64),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)

package/bin/retailCatalog/dtos/requests/SyncInventoryRequest.js

@@ -43,7 +43,7 @@ class SyncProduct {
 }
 exports.SyncProduct = SyncProduct;
 __decorate([
-    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' }),
+    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: SkuPattern_1.SKU_MESSAGE }),
     (0, class_validator_1.Length)(1, 64),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)

package/bin/retailIntegration/constants/retailIntegrationLimits.d.ts

@@ -14,7 +14,7 @@ export declare const RETAIL_STORE_CODE_MAX_LENGTH = 10;
 /** Código postal: de 4 a 10 caracteres. */
 export declare const RETAIL_ZIP_CODE_MIN_LENGTH = 4;
 export declare const RETAIL_ZIP_CODE_MAX_LENGTH = 10;
-/** SKU del catálogo del retailer. */
+/** SKU del catálogo del retailer: el charset de `SKU_PATTERN` con tope de 64. */
 export declare const RETAIL_SKU_PATTERN: RegExp;
 /** Decimal del contrato: string con dos decimales, nunca negativo. */
 export declare const RETAIL_DECIMAL_PATTERN: RegExp;

package/bin/retailIntegration/constants/retailIntegrationLimits.js

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

package/bin/retailOrg/dtos/requests/CreateRetailUserRequest.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const CollectorSeniorityEnum_1 = require("../../enums/CollectorSeniorityEnum");
 const EmploymentTypeEnum_1 = require("../../enums/EmploymentTypeEnum");
+const IsMxPhone_1 = require("../../../common/validators/IsMxPhone");
 /**
  * Body de POST /retailers/:retailerId/users — alta de usuario retail (el `retailerId` sale del path;
  * `cognitoSub` enlaza con la identidad Cognito validada vía platform-rbac por api-invoker).
@@ -56,7 +57,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsString)(),
+    (0, IsMxPhone_1.IsMxPhone)(),
     __metadata("design:type", String)
 ], CreateRetailUserRequest.prototype, "phone", void 0);
 __decorate([

package/bin/retailOrg/dtos/requests/CreateRetailerRequest.d.ts

@@ -9,7 +9,7 @@ export declare class CreateRetailerRequest {
     type: RetailerTypeEnum;
     name: string;
     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. */
     rfc: string;
     contactEmail: string;
     contactPhone: string;

package/bin/retailOrg/dtos/requests/CreateRetailerRequest.js

@@ -14,6 +14,9 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const RetailerTypeEnum_1 = require("../../enums/RetailerTypeEnum");
 const RetailAddressInput_1 = require("./RetailAddressInput");
+const IsMxPhone_1 = require("../../../common/validators/IsMxPhone");
+const IsRfc_1 = require("../../../common/validators/IsRfc");
+const UpperCase_1 = require("../../../common/decorators/UpperCase");
 /**
  * Body de POST /retailers — alta de un retailer raíz (SureKeep Fase 1 — pista Retail).
  * Los campos server-assigned (`retailerId`, `parentId`, `status`, `createdAt/By`, `updatedAt/By`)
@@ -40,7 +43,8 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.Length)(12, 13),
+    (0, UpperCase_1.UpperCase)(),
+    (0, IsRfc_1.IsRfc)(),
     __metadata("design:type", String)
 ], CreateRetailerRequest.prototype, "rfc", void 0);
 __decorate([
@@ -50,7 +54,7 @@ __decorate([
 ], CreateRetailerRequest.prototype, "contactEmail", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsString)(),
+    (0, IsMxPhone_1.IsMxPhone)(),
     __metadata("design:type", String)
 ], CreateRetailerRequest.prototype, "contactPhone", void 0);
 __decorate([

package/bin/retailOrg/dtos/requests/CreateStoreRequest.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const GeoLocation_1 = require("../GeoLocation");
 const RetailAddressInput_1 = require("./RetailAddressInput");
+const IsMxPhone_1 = require("../../../common/validators/IsMxPhone");
 /**
  * Body de POST /retailers/:retailerId/stores — alta de tienda física (el `retailerId` sale del path).
  * `location` (coordenada {lat,lng}) es OBLIGATORIA; los campos nullable van presentes-pero-nulos.
@@ -54,7 +55,7 @@ __decorate([
 ], CreateStoreRequest.prototype, "location", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsString)(),
+    (0, IsMxPhone_1.IsMxPhone)(),
     __metadata("design:type", String)
 ], CreateStoreRequest.prototype, "phone", void 0);
 __decorate([

package/bin/retailOrg/dtos/requests/CreateSubdistributorRequest.d.ts

@@ -11,7 +11,7 @@ export declare class CreateSubdistributorRequest {
     type: RetailerTypeEnum.SUBDISTRIBUTOR | RetailerTypeEnum.FRANCHISE;
     name: string;
     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. */
     rfc: string;
     contactEmail: string;
     contactPhone: string;

package/bin/retailOrg/dtos/requests/CreateSubdistributorRequest.js

@@ -14,6 +14,9 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const RetailerTypeEnum_1 = require("../../enums/RetailerTypeEnum");
 const RetailAddressInput_1 = require("./RetailAddressInput");
+const IsMxPhone_1 = require("../../../common/validators/IsMxPhone");
+const IsRfc_1 = require("../../../common/validators/IsRfc");
+const UpperCase_1 = require("../../../common/decorators/UpperCase");
 /**
  * Body de POST /retailers/:retailerId/subdistributors — alta de un retailer hijo colgando de
  * `:retailerId` (el `parentId` sale del path param, NO del body).
@@ -42,7 +45,8 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.Length)(12, 13),
+    (0, UpperCase_1.UpperCase)(),
+    (0, IsRfc_1.IsRfc)(),
     __metadata("design:type", String)
 ], CreateSubdistributorRequest.prototype, "rfc", void 0);
 __decorate([
@@ -52,7 +56,7 @@ __decorate([
 ], CreateSubdistributorRequest.prototype, "contactEmail", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsString)(),
+    (0, IsMxPhone_1.IsMxPhone)(),
     __metadata("design:type", String)
 ], CreateSubdistributorRequest.prototype, "contactPhone", void 0);
 __decorate([

package/bin/retailOrg/dtos/requests/ProvisionRetailUserRequest.js

@@ -15,6 +15,7 @@ const class_validator_1 = require("class-validator");
 const CollectorSeniorityEnum_1 = require("../../enums/CollectorSeniorityEnum");
 const EmploymentTypeEnum_1 = require("../../enums/EmploymentTypeEnum");
 const PermissionScope_1 = require("../../../platformRbac/enums/PermissionScope");
+const IsMxPhone_1 = require("../../../common/validators/IsMxPhone");
 /**
  * Body de POST /retailers/:retailerId/users/provision — alta de usuario retail ORQUESTADA (SureKeep F1,
  * scope mirror). Invierte el orden del alta clásica: en vez de recibir un `cognitoSub` ya existente,
@@ -77,7 +78,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsString)(),
+    (0, IsMxPhone_1.IsMxPhone)(),
     __metadata("design:type", String)
 ], ProvisionRetailUserRequest.prototype, "phone", void 0);
 __decorate([

package/bin/retailOrg/dtos/requests/RetailAddressInput.d.ts

@@ -23,7 +23,7 @@ export declare class RetailAddressInput {
     neighborhood?: string;
     city: string;
     state: string;
-    /** Código postal (espejo de `LocationAddress.zipCode`). */
+    /** Código postal MX de 5 dígitos (espejo de `LocationAddress.zipCode`). */
     zipCode: string;
     /** País ISO. OPCIONAL — sin slot en `LocationAddress` (TD-SKF1-007). */
     country?: string;

package/bin/retailOrg/dtos/requests/RetailAddressInput.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RetailAddressInput = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const IsMxZipCode_1 = require("../../../common/validators/IsMxZipCode");
 /**
  * Dirección comercial de entrada (input validado) para los requests de creación/edición del dominio
  * retail-org-business. A diferencia del DTO de entidad (que reutiliza `LocationAddress`, laxo a
@@ -71,8 +72,7 @@ __decorate([
 ], RetailAddressInput.prototype, "state", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.Length)(4, 10),
+    (0, IsMxZipCode_1.IsMxZipCode)(),
     __metadata("design:type", String)
 ], RetailAddressInput.prototype, "zipCode", void 0);
 __decorate([

package/bin/retailOrg/dtos/requests/UpdateRetailUserRequest.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const CollectorSeniorityEnum_1 = require("../../enums/CollectorSeniorityEnum");
 const EmploymentTypeEnum_1 = require("../../enums/EmploymentTypeEnum");
+const IsMxPhone_1 = require("../../../common/validators/IsMxPhone");
 /**
  * Body de PUT /users/:retailUserId — edición de usuario retail (campos editables opcionales).
  * NO edita `cognitoSub` (identidad) ni `homeStoreId` (para reubicar hay `TransferRetailUserRequest`);
@@ -49,7 +50,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsString)(),
+    (0, IsMxPhone_1.IsMxPhone)(),
     __metadata("design:type", String)
 ], UpdateRetailUserRequest.prototype, "phone", void 0);
 __decorate([

package/bin/retailOrg/dtos/requests/UpdateRetailerRequest.js

@@ -13,6 +13,7 @@ exports.UpdateRetailerRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const RetailAddressInput_1 = require("./RetailAddressInput");
+const IsMxPhone_1 = require("../../../common/validators/IsMxPhone");
 /**
  * Body de PUT /retailers/:retailerId — edición de campos comerciales del retailer.
  * Solo campos editables (todos opcionales). NO se puede editar `type`, `rfc` ni `status`
@@ -42,7 +43,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsString)(),
+    (0, IsMxPhone_1.IsMxPhone)(),
     __metadata("design:type", String)
 ], UpdateRetailerRequest.prototype, "contactPhone", void 0);
 __decorate([

package/bin/retailOrg/dtos/requests/UpdateStoreRequest.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const GeoLocation_1 = require("../GeoLocation");
 const RetailAddressInput_1 = require("./RetailAddressInput");
+const IsMxPhone_1 = require("../../../common/validators/IsMxPhone");
 /**
  * Body de PUT /stores/:storeId — edición de tienda (campos editables opcionales). El status se
  * cambia con el endpoint dedicado → `ChangeStoreStatusRequest`. Si se envía `location`/`address`,
@@ -58,7 +59,7 @@ __decorate([
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsString)(),
+    (0, IsMxPhone_1.IsMxPhone)(),
     __metadata("design:type", String)
 ], UpdateStoreRequest.prototype, "phone", void 0);
 __decorate([

package/bin/retailWizard/dtos/Sale.d.ts

@@ -18,7 +18,8 @@ export interface Sale {
     retailerId: string;
     storeId: string;
     sellerRetailUserId: string;
-    retailCustomerId: string;
+    /** `null` en la venta de mostrador sin cliente. */
+    retailCustomerId: string | null;
     /** Sesión del wizard que cerró la venta; ausente en la venta de mostrador. */
     wizardSessionId?: string;
     /** Canal de la venta; ausente = `WIZARD` (ventas anteriores al campo). */

package/bin/retailWizard/dtos/requests/CreateAccessorySaleRequest.d.ts

@@ -2,11 +2,10 @@ import { SalePaymentMethodEnum } from '../../enums/SalePaymentMethodEnum';
 import { SalePaymentDetail } from '../SalePaymentDetail';
 import { AccessorySaleLine } from '../AccessorySaleLine';
 /**
- * POST /wizard/accessory-sales — cierra la venta de mostrador con el celular ya verificado.
+ * POST /wizard/accessory-sales — cierra la venta de mostrador, sin cliente.
  * `amountCents` es lo cobrado en caja y debe igualar la suma del catálogo.
  */
 export declare class CreateAccessorySaleRequest {
-    otpChallengeId: string;
     lines: AccessorySaleLine[];
     paymentMethod: SalePaymentMethodEnum;
     amountCents: number;

package/bin/retailWizard/dtos/requests/CreateAccessorySaleRequest.js

@@ -16,18 +16,12 @@ const SalePaymentMethodEnum_1 = require("../../enums/SalePaymentMethodEnum");
 const SalePaymentDetail_1 = require("../SalePaymentDetail");
 const AccessorySaleLine_1 = require("../AccessorySaleLine");
 /**
- * POST /wizard/accessory-sales — cierra la venta de mostrador con el celular ya verificado.
+ * POST /wizard/accessory-sales — cierra la venta de mostrador, sin cliente.
  * `amountCents` es lo cobrado en caja y debe igualar la suma del catálogo.
  */
 class CreateAccessorySaleRequest {
 }
 exports.CreateAccessorySaleRequest = CreateAccessorySaleRequest;
-__decorate([
-    (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MinLength)(1),
-    __metadata("design:type", String)
-], CreateAccessorySaleRequest.prototype, "otpChallengeId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsArray)(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.552.0",
+  "version": "3.554.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

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/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;