@fiado/type-kit 3.566.0 → 3.567.0

package/_test_/unit/retailCustomer/customerReferralContract.test.ts

@@ -61,6 +61,7 @@ describe('enums de referidos', () => {
 
 const SALE_BATCH = {
     source: 'SALE',
+    retailerId: 'r-1',
     storeId: 'st-1',
     wizardSessionId: 'ws-1',
     capturedBy: 'seller-1',
@@ -98,6 +99,13 @@ describe('CreateCustomerReferralsRequest', () => {
         expect(errorsOf(CreateCustomerReferralsRequest, { ...SALE_BATCH, capturedBy: ' ' })).toContain('capturedBy');
     });
 
+    it('exige la cadena de captura, también desde el cajón', () => {
+        const { retailerId: _retailerId, ...noRetailer } = SALE_BATCH;
+        expect(errorsOf(CreateCustomerReferralsRequest, noRetailer)).toEqual(['retailerId']);
+        expect(errorsOf(CreateCustomerReferralsRequest, { ...noRetailer, source: 'BACKOFFICE' })).toEqual(['retailerId']);
+        expect(errorsOf(CreateCustomerReferralsRequest, { ...SALE_BATCH, retailerId: '  ' })).toEqual(['retailerId']);
+    });
+
     it('rechaza un origen fuera del catálogo', () => {
         expect(errorsOf(CreateCustomerReferralsRequest, { ...SALE_BATCH, source: 'WEB' })).toContain('source');
     });

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

@@ -45,6 +45,19 @@ describe('BackofficeCustomerReferralsResponse', () => {
         expect(response.referrals[0].capture.source).toBe('SALE');
     });
 
+    it('acepta el nombre visible de quien capturó, opcional y nullable', () => {
+        const named: BackofficeCustomerReferral = {
+            ...referral,
+            capture: { ...referral.capture, capturedByName: 'Laura Méndez (Admin SK)' },
+        };
+        const unresolved: BackofficeCustomerReferral = { ...referral, capture: { ...referral.capture, capturedByName: null } };
+        expect([named.capture.capturedByName, unresolved.capture.capturedByName, referral.capture.capturedByName]).toEqual([
+            'Laura Méndez (Admin SK)',
+            null,
+            undefined,
+        ]);
+    });
+
     it('suma premios por referido y el bloque «llegó recomendado por» en la tanda B', () => {
         const response: BackofficeCustomerReferralsResponse = {
             referrals: [{ ...referral, rewards: [{ ...reward, role: ReferralRoleEnum.REFERRER }] }],

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

@@ -256,5 +256,15 @@ describe('respuestas de los M2M de Promociones', () => {
       undefined,
     ]);
     expect(asString).toBeDefined();
+
+    const referred: PrivateWizardSessionResponse = { ...base, customerPhone: '5512345678', customerPurchaseNumber: 2 };
+    // @ts-expect-error el número de compra es numérico
+    const purchaseAsString: PrivateWizardSessionResponse = { ...base, customerPurchaseNumber: '2' };
+    expect([referred.customerPhone, referred.customerPurchaseNumber, base.customerPurchaseNumber]).toEqual([
+      '5512345678',
+      2,
+      undefined,
+    ]);
+    expect(purchaseAsString).toBeDefined();
   });
 });

package/bin/retailCustomer/dtos/requests/CreateCustomerReferralsRequest.d.ts

@@ -8,6 +8,8 @@ export declare class CustomerReferralInput {
 /** Body de `privateCreateCustomerReferrals`: lote de referidos de un cliente. */
 export declare class CreateCustomerReferralsRequest {
     source: ReferralSourceEnum;
+    /** Cadena donde se captura el referido; «gana el primero» busca por cadena + teléfono. */
+    retailerId: string;
     /** Tienda de captura; obligatoria en venta y apertura. */
     storeId?: string;
     wizardSessionId?: string;

package/bin/retailCustomer/dtos/requests/CreateCustomerReferralsRequest.js

@@ -52,6 +52,13 @@ __decorate([
     (0, class_validator_1.IsEnum)(ReferralSourceEnum_1.ReferralSourceEnum),
     __metadata("design:type", String)
 ], CreateCustomerReferralsRequest.prototype, "source", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, Trim_1.Trim)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateCustomerReferralsRequest.prototype, "retailerId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.ValidateIf)((o) => o.source !== ReferralSourceEnum_1.ReferralSourceEnum.BACKOFFICE || o.storeId !== undefined),

package/bin/retailWizard/dtos/responses/BackofficeCustomerReferralsResponse.d.ts

@@ -26,6 +26,8 @@ export interface BackofficeReferralCapture {
     /** Solo en `OPENING`. */
     accountOpeningSessionId: string | null;
     capturedBy: string;
+    /** Nombre visible de quien capturó; `null` si no se resolvió. */
+    capturedByName?: string | null;
     capturedAt: string;
 }
 /** Referido del cliente en el cajón. */

package/bin/retailWizard/dtos/responses/PrivateWizardSessionResponse.d.ts

@@ -34,4 +34,8 @@ export interface PrivateWizardSessionResponse {
     payment?: WizardPayment | null;
     /** Valor efectivo del flag SPLIT_FINANCING_ENABLED del wizard. */
     splitFinancingEnabled?: boolean;
+    /** Teléfono del cliente de la sesión, 10 dígitos. */
+    customerPhone?: string;
+    /** Número de compra que sería esta venta en la cadena: 1 + ventas previas no canceladas. */
+    customerPurchaseNumber?: number;
 }

package/package.json

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

package/src/retailCustomer/dtos/requests/CreateCustomerReferralsRequest.ts

@@ -46,6 +46,13 @@ export class CreateCustomerReferralsRequest {
     @IsEnum(ReferralSourceEnum)
     source!: ReferralSourceEnum;
 
+    /** Cadena donde se captura el referido; «gana el primero» busca por cadena + teléfono. */
+    @Expose()
+    @Trim()
+    @IsString()
+    @IsNotEmpty()
+    retailerId!: string;
+
     /** Tienda de captura; obligatoria en venta y apertura. */
     @Expose()
     @ValidateIf((o: CreateCustomerReferralsRequest) => o.source !== ReferralSourceEnum.BACKOFFICE || o.storeId !== undefined)

package/src/retailWizard/dtos/responses/BackofficeCustomerReferralsResponse.ts

@@ -28,6 +28,8 @@ export interface BackofficeReferralCapture {
     /** Solo en `OPENING`. */
     accountOpeningSessionId: string | null;
     capturedBy: string;
+    /** Nombre visible de quien capturó; `null` si no se resolvió. */
+    capturedByName?: string | null;
     capturedAt: string;
 }
 

package/src/retailWizard/dtos/responses/PrivateWizardSessionResponse.ts

@@ -35,4 +35,8 @@ export interface PrivateWizardSessionResponse {
   payment?: WizardPayment | null;
   /** Valor efectivo del flag SPLIT_FINANCING_ENABLED del wizard. */
   splitFinancingEnabled?: boolean;
+  /** Teléfono del cliente de la sesión, 10 dígitos. */
+  customerPhone?: string;
+  /** Número de compra que sería esta venta en la cadena: 1 + ventas previas no canceladas. */
+  customerPurchaseNumber?: number;
 }