@fiado/type-kit 3.552.0 → 3.554.0

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

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';
@@ -38,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/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. */

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

@@ -1,6 +1,7 @@
 import { Expose, Type } from 'class-transformer';
 import { IsEmail, IsOptional, IsString, ValidateNested } from 'class-validator';
 import { RetailAddressInput } from './RetailAddressInput';
+import { IsMxPhone } from '../../../common/validators/IsMxPhone';
 
 /**
  * Body de PUT /retailers/:retailerId — edición de campos comerciales del retailer.
@@ -25,7 +26,7 @@ export class UpdateRetailerRequest {
 
     @Expose()
     @IsOptional()
-    @IsString()
+    @IsMxPhone()
     contactPhone?: string;
 
     @Expose()

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

@@ -2,6 +2,7 @@ import { Expose, Type } from 'class-transformer';
 import { IsNumber, IsOptional, IsString, Length, ValidateNested } from 'class-validator';
 import { GeoLocation } from '../GeoLocation';
 import { RetailAddressInput } from './RetailAddressInput';
+import { IsMxPhone } from '../../../common/validators/IsMxPhone';
 
 /**
  * Body de PUT /stores/:storeId — edición de tienda (campos editables opcionales). El status se
@@ -39,7 +40,7 @@ export class UpdateStoreRequest {
 
     @Expose()
     @IsOptional()
-    @IsString()
+    @IsMxPhone()
     phone?: string;
 
     @Expose()

package/src/retailWizard/dtos/Sale.ts

@@ -19,7 +19,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/src/retailWizard/dtos/requests/CreateAccessorySaleRequest.ts

@@ -18,15 +18,10 @@ 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 class CreateAccessorySaleRequest {
-  @Expose()
-  @IsString()
-  @MinLength(1)
-  otpChallengeId!: string;
-
   @Expose()
   @IsArray()
   @ArrayMinSize(1)