@fiado/type-kit 3.589.0 → 3.591.0

package/_test_/unit/messageMoments/MessageMomentCatalog.test.ts

@@ -8,20 +8,68 @@ import {
     MessageMomentBlockEnum,
     MessageMomentEnum,
     OTP_MOMENT_VARIABLES,
+    REFERRAL_BONUS_ALWAYS_VARIABLES,
+    REFERRAL_BONUS_CONDITIONAL_VARIABLES,
+    REFERRAL_COUPON_ALWAYS_VARIABLES,
+    REFERRAL_COUPON_CONDITIONAL_VARIABLES,
     RESTRUCTURE_MOMENT_VARIABLES,
     TEMPLATE_PLACEHOLDER_PATTERN,
     momentByMessageType,
     momentByTemplateId,
 } from '../../../src/messageMoments/index';
 
+const NON_CREDIT_MOMENTS = new Set<string>([
+    MessageMomentEnum.OTP_CODE,
+    MessageMomentEnum.REFERRAL_BONUS_CREDITED,
+    MessageMomentEnum.REFERRAL_COUPON_ISSUED,
+]);
+
 describe('MESSAGE_MOMENT_CATALOG', () => {
-    it('trae los 38 momentos del recorrido del crédito', () => {
-        expect(MESSAGE_MOMENT_CATALOG).toHaveLength(38);
+    it('trae los 38 momentos del crédito más los 2 de referidos', () => {
+        expect(MESSAGE_MOMENT_CATALOG).toHaveLength(40);
     });
 
     it('ni el templateId ni el messageType se repiten', () => {
-        expect(momentByTemplateId.size).toBe(38);
-        expect(momentByMessageType.size).toBe(38);
+        expect(momentByTemplateId.size).toBe(40);
+        expect(momentByMessageType.size).toBe(40);
+    });
+
+    it('los momentos de referidos cierran el catálogo, en su bloque', () => {
+        expect(MESSAGE_MOMENT_CATALOG.slice(-2).map((m) => [m.templateId, m.messageType, m.blockId])).toEqual([
+            ['PM-080', MessageMomentEnum.REFERRAL_BONUS_CREDITED, MessageMomentBlockEnum.REFERRALS],
+            ['PM-081', MessageMomentEnum.REFERRAL_COUPON_ISSUED, MessageMomentBlockEnum.REFERRALS],
+        ]);
+        expect(MessageMomentBlockEnum.REFERRALS).toBe('referrals');
+    });
+
+    it('el premio abonado ofrece cliente y monto, y el nombre del referido cuando se conoce', () => {
+        const bonus = momentByTemplateId.get('PM-080');
+        expect(REFERRAL_BONUS_ALWAYS_VARIABLES).toEqual(['cliente_nombre', 'monto']);
+        expect(REFERRAL_BONUS_CONDITIONAL_VARIABLES).toEqual(['referido_nombre']);
+        expect(bonus?.alwaysVariables).toEqual(REFERRAL_BONUS_ALWAYS_VARIABLES);
+        expect(bonus?.conditionalVariables).toEqual(REFERRAL_BONUS_CONDITIONAL_VARIABLES);
+    });
+
+    it('el cupón emitido ofrece código, descuento y vigencia, y la tienda cuando no aplica en todas', () => {
+        const coupon = momentByTemplateId.get('PM-081');
+        expect(REFERRAL_COUPON_ALWAYS_VARIABLES).toEqual(['cliente_nombre', 'codigo', 'descuento', 'vigencia']);
+        expect(REFERRAL_COUPON_CONDITIONAL_VARIABLES).toEqual(['tienda']);
+        expect(coupon?.alwaysVariables).toEqual(REFERRAL_COUPON_ALWAYS_VARIABLES);
+        expect(coupon?.conditionalVariables).toEqual(REFERRAL_COUPON_CONDITIONAL_VARIABLES);
+    });
+
+    it('los momentos de referidos no ofrecen variables del crédito', () => {
+        const credit = new Set([...CREDIT_MOMENT_ALWAYS_VARIABLES, ...CREDIT_MOMENT_CONDITIONAL_VARIABLES].filter((n) => n !== 'cliente_nombre' && n !== 'monto' && n !== 'tienda'));
+        for (const moment of MESSAGE_MOMENT_CATALOG.filter((m) => m.blockId === MessageMomentBlockEnum.REFERRALS)) {
+            expect([...moment.alwaysVariables, ...moment.conditionalVariables].filter((n) => credit.has(n))).toEqual([]);
+        }
+    });
+
+    it('en ningún momento una variable es siempre y condicional a la vez', () => {
+        for (const moment of MESSAGE_MOMENT_CATALOG) {
+            const always = new Set(moment.alwaysVariables);
+            expect(moment.conditionalVariables.filter((n) => always.has(n))).toEqual([]);
+        }
     });
 
     it('todo templateId tiene la forma PM-NNN', () => {
@@ -47,8 +95,8 @@ describe('MESSAGE_MOMENT_CATALOG', () => {
         expect(otp?.conditionalVariables).toEqual([]);
     });
 
-    it('los demás momentos ofrecen las variables del crédito más las propias del momento', () => {
-        for (const moment of MESSAGE_MOMENT_CATALOG.filter((m) => m.messageType !== MessageMomentEnum.OTP_CODE)) {
+    it('los momentos del crédito ofrecen sus variables más las propias del momento', () => {
+        for (const moment of MESSAGE_MOMENT_CATALOG.filter((m) => !NON_CREDIT_MOMENTS.has(m.messageType))) {
             const own = MOMENT_SPECIFIC_VARIABLES[moment.messageType] ?? [];
             expect(moment.alwaysVariables).toEqual([...CREDIT_MOMENT_ALWAYS_VARIABLES, ...own]);
             expect(moment.conditionalVariables).toEqual(CREDIT_MOMENT_CONDITIONAL_VARIABLES);
@@ -70,7 +118,7 @@ describe('MESSAGE_MOMENT_CATALOG', () => {
     it('una variable propia no se cuela en otro momento', () => {
         const own = new Set(Object.values(MOMENT_SPECIFIC_VARIABLES).flat());
         const owners = new Set(Object.keys(MOMENT_SPECIFIC_VARIABLES));
-        for (const moment of MESSAGE_MOMENT_CATALOG.filter((m) => !owners.has(m.messageType))) {
+        for (const moment of MESSAGE_MOMENT_CATALOG.filter((m) => !owners.has(m.messageType) && !NON_CREDIT_MOMENTS.has(m.messageType))) {
             expect(moment.alwaysVariables.filter((name) => own.has(name))).toEqual([]);
         }
     });

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

@@ -0,0 +1,67 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import * as RetailWizard from '../../../src/retailWizard';
+import * as RetailCatalog from '../../../src/retailCatalog';
+
+const { BackofficeSessionSummariesRequest, BACKOFFICE_SESSION_SUMMARIES_MAX_IDS } = RetailWizard;
+
+function errorsOf(payload: Record<string, unknown>): string[] {
+  const dto = plainToInstance(BackofficeSessionSummariesRequest, payload, { excludeExtraneousValues: true });
+  return validateSync(dto).map((e) => e.property);
+}
+
+describe('BackofficeSessionSummariesRequest', () => {
+  it('acepta una lista de ids válidos', () => {
+    expect(errorsOf({ sessionIds: ['01HXYZ', 'abc_def-1'] })).toEqual([]);
+  });
+
+  it('rechaza lista vacía, ausente o no-lista', () => {
+    expect(errorsOf({ sessionIds: [] })).toEqual(['sessionIds']);
+    expect(errorsOf({})).toEqual(['sessionIds']);
+    expect(errorsOf({ sessionIds: 'abc' })).toEqual(['sessionIds']);
+  });
+
+  it('rechaza más ids que el techo', () => {
+    const ids = Array.from({ length: BACKOFFICE_SESSION_SUMMARIES_MAX_IDS + 1 }, (_, i) => `s${i}`);
+    expect(errorsOf({ sessionIds: ids })).toEqual(['sessionIds']);
+  });
+
+  it('rechaza ids con forma inválida o que no son texto', () => {
+    expect(errorsOf({ sessionIds: ['ok', 'con espacio'] })).toEqual(['sessionIds']);
+    expect(errorsOf({ sessionIds: [123] })).toEqual(['sessionIds']);
+  });
+
+  it('el response tipa el resumen de sesión', () => {
+    const result: RetailWizard.BackofficeSessionSummariesResult = {
+      sessions: [
+        {
+          sessionId: 's1',
+          state: RetailWizard.WizardStateEnum.ACTIVE,
+          sellerName: null,
+          sellerRetailUserId: null,
+          storeId: 'st1',
+          paid: false,
+          saleId: null,
+          currentStep: null,
+        },
+      ],
+    };
+    expect(result.sessions).toHaveLength(1);
+  });
+});
+
+describe('retailCatalog — saldo por tienda y reservas vivas', () => {
+  it('InventoryStorePieces acepta el saldo opcional y GetInventorySkuResponse las reservas vivas', () => {
+    const store: RetailCatalog.InventoryStorePieces = { storeId: 'st1', pieces: [], available: 3, reserved: 1, availableToSell: 2 };
+    const reservation: RetailCatalog.InventoryLiveReservation = {
+      storeId: 'st1', sessionId: 's1', lineId: 'l1', reservationId: 'r1', quantity: 1,
+      expiresAt: '2026-10-26T00:00:00.000Z', reservedAt: null,
+    };
+    const detail: Pick<RetailCatalog.GetInventorySkuResponse, 'piecesByStore' | 'liveReservations'> = {
+      piecesByStore: [store],
+      liveReservations: [reservation],
+    };
+    expect(detail.liveReservations?.[0].reservationId).toBe('r1');
+  });
+});

package/bin/messageMoments/constants/MessageMomentCatalog.d.ts

@@ -10,7 +10,7 @@ export interface MessageMomentIdentity {
     alwaysVariables: readonly string[];
     conditionalVariables: readonly string[];
 }
-/** Los 38 momentos EN ORDEN de recorrido del crédito. `PM-071` apunta al OTP de plataforma. */
+/** Los 38 momentos del crédito EN ORDEN de recorrido y al final los de referidos. `PM-071` apunta al OTP de plataforma. */
 export declare const MESSAGE_MOMENT_CATALOG: readonly MessageMomentIdentity[];
 /** La identidad por id de ficha (`PM-030`). */
 export declare const momentByTemplateId: ReadonlyMap<string, MessageMomentIdentity>;

package/bin/messageMoments/constants/MessageMomentCatalog.js

@@ -14,9 +14,13 @@ function creditMoment(templateId, messageType, blockId) {
         conditionalVariables: MessageMomentVariables_1.CREDIT_MOMENT_CONDITIONAL_VARIABLES,
     };
 }
+/** Un momento fuera del crédito: solo las variables que su emisor manda. */
+function standaloneMoment(templateId, messageType, blockId, alwaysVariables, conditionalVariables = []) {
+    return { templateId, messageType, blockId, alwaysVariables, conditionalVariables };
+}
 const B = MessageMomentBlockEnum_1.MessageMomentBlockEnum;
 const M = MessageMomentEnum_1.MessageMomentEnum;
-/** Los 38 momentos EN ORDEN de recorrido del crédito. `PM-071` apunta al OTP de plataforma. */
+/** Los 38 momentos del crédito EN ORDEN de recorrido y al final los de referidos. `PM-071` apunta al OTP de plataforma. */
 exports.MESSAGE_MOMENT_CATALOG = [
     creditMoment('PM-001', M.APPLICATION_APPROVED, B.ORIGINATION),
     creditMoment('PM-002', M.APPLICATION_REJECTED, B.ORIGINATION),
@@ -50,18 +54,14 @@ exports.MESSAGE_MOMENT_CATALOG = [
     creditMoment('PM-062', M.SETTLEMENT_BUREAU_NOTICE, B.CLOSURE),
     creditMoment('PM-063', M.REENTRY_INVITATION, B.CLOSURE),
     creditMoment('PM-070', M.APP_WELCOME, B.SERVICE),
-    {
-        templateId: 'PM-071',
-        messageType: M.OTP_CODE,
-        blockId: B.SERVICE,
-        alwaysVariables: MessageMomentVariables_1.OTP_MOMENT_VARIABLES,
-        conditionalVariables: [],
-    },
+    standaloneMoment('PM-071', M.OTP_CODE, B.SERVICE, MessageMomentVariables_1.OTP_MOMENT_VARIABLES),
     creditMoment('PM-072', M.SECURITY_ALERT, B.SERVICE),
     creditMoment('PM-073', M.PROFILE_CHANGE_CONFIRMED, B.SERVICE),
     creditMoment('PM-074', M.MONTHLY_STATEMENT, B.SERVICE),
     creditMoment('PM-075', M.CAT_TERMS_NOTICE, B.SERVICE),
     creditMoment('PM-076', M.PRIVACY_ARCO_NOTICE, B.SERVICE),
+    standaloneMoment('PM-080', M.REFERRAL_BONUS_CREDITED, B.REFERRALS, MessageMomentVariables_1.REFERRAL_BONUS_ALWAYS_VARIABLES, MessageMomentVariables_1.REFERRAL_BONUS_CONDITIONAL_VARIABLES),
+    standaloneMoment('PM-081', M.REFERRAL_COUPON_ISSUED, B.REFERRALS, MessageMomentVariables_1.REFERRAL_COUPON_ALWAYS_VARIABLES, MessageMomentVariables_1.REFERRAL_COUPON_CONDITIONAL_VARIABLES),
 ];
 /** La identidad por id de ficha (`PM-030`). */
 exports.momentByTemplateId = new Map(exports.MESSAGE_MOMENT_CATALOG.map((moment) => [moment.templateId, moment]));

package/bin/messageMoments/constants/MessageMomentVariables.d.ts

@@ -5,6 +5,14 @@ export declare const CREDIT_MOMENT_ALWAYS_VARIABLES: readonly string[];
 export declare const CREDIT_MOMENT_CONDITIONAL_VARIABLES: readonly string[];
 /** El OTP lo arma messages-business: llena `code` y su alias posicional `var1`. */
 export declare const OTP_MOMENT_VARIABLES: readonly string[];
+/** Premio de referido abonado a la cuenta PCF: a quién y cuánto. */
+export declare const REFERRAL_BONUS_ALWAYS_VARIABLES: readonly string[];
+/** El referido solo se nombra cuando el premio es de quien recomendó. */
+export declare const REFERRAL_BONUS_CONDITIONAL_VARIABLES: readonly string[];
+/** Cupón de referido emitido: el código, su descuento ya formateado y hasta cuándo vale. */
+export declare const REFERRAL_COUPON_ALWAYS_VARIABLES: readonly string[];
+/** La tienda solo viaja cuando el cupón no vale en todas. */
+export declare const REFERRAL_COUPON_CONDITIONAL_VARIABLES: readonly string[];
 /** Lo que el plan nuevo de una reestructura le dice al cliente. */
 export declare const RESTRUCTURE_MOMENT_VARIABLES: readonly string[];
 /** Variables que solo emite su momento, siempre con valor. */

package/bin/messageMoments/constants/MessageMomentVariables.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MOMENT_SPECIFIC_VARIABLES = exports.RESTRUCTURE_MOMENT_VARIABLES = exports.OTP_MOMENT_VARIABLES = exports.CREDIT_MOMENT_CONDITIONAL_VARIABLES = exports.CREDIT_MOMENT_ALWAYS_VARIABLES = void 0;
+exports.MOMENT_SPECIFIC_VARIABLES = exports.RESTRUCTURE_MOMENT_VARIABLES = exports.REFERRAL_COUPON_CONDITIONAL_VARIABLES = exports.REFERRAL_COUPON_ALWAYS_VARIABLES = exports.REFERRAL_BONUS_CONDITIONAL_VARIABLES = exports.REFERRAL_BONUS_ALWAYS_VARIABLES = exports.OTP_MOMENT_VARIABLES = exports.CREDIT_MOMENT_CONDITIONAL_VARIABLES = exports.CREDIT_MOMENT_ALWAYS_VARIABLES = void 0;
 const MessageMomentEnum_1 = require("../enums/MessageMomentEnum");
 /** Variables del crédito que el emisor manda siempre con valor. */
 exports.CREDIT_MOMENT_ALWAYS_VARIABLES = [
@@ -29,6 +29,14 @@ exports.CREDIT_MOMENT_CONDITIONAL_VARIABLES = [
 ];
 /** El OTP lo arma messages-business: llena `code` y su alias posicional `var1`. */
 exports.OTP_MOMENT_VARIABLES = ['code', 'var1'];
+/** Premio de referido abonado a la cuenta PCF: a quién y cuánto. */
+exports.REFERRAL_BONUS_ALWAYS_VARIABLES = ['cliente_nombre', 'monto'];
+/** El referido solo se nombra cuando el premio es de quien recomendó. */
+exports.REFERRAL_BONUS_CONDITIONAL_VARIABLES = ['referido_nombre'];
+/** Cupón de referido emitido: el código, su descuento ya formateado y hasta cuándo vale. */
+exports.REFERRAL_COUPON_ALWAYS_VARIABLES = ['cliente_nombre', 'codigo', 'descuento', 'vigencia'];
+/** La tienda solo viaja cuando el cupón no vale en todas. */
+exports.REFERRAL_COUPON_CONDITIONAL_VARIABLES = ['tienda'];
 /** Lo que el plan nuevo de una reestructura le dice al cliente. */
 exports.RESTRUCTURE_MOMENT_VARIABLES = ['plazo_nuevo', 'cuota_nueva', 'saldo_nuevo'];
 /** Variables que solo emite su momento, siempre con valor. */

package/bin/messageMoments/enums/MessageMomentBlockEnum.d.ts

@@ -7,5 +7,6 @@ export declare enum MessageMomentBlockEnum {
     DEVICE_LOCK = "deviceLock",
     EXCEPTIONS = "exceptions",
     CLOSURE = "closure",
-    SERVICE = "service"
+    SERVICE = "service",
+    REFERRALS = "referrals"
 }

package/bin/messageMoments/enums/MessageMomentBlockEnum.js

@@ -12,4 +12,5 @@ var MessageMomentBlockEnum;
     MessageMomentBlockEnum["EXCEPTIONS"] = "exceptions";
     MessageMomentBlockEnum["CLOSURE"] = "closure";
     MessageMomentBlockEnum["SERVICE"] = "service";
+    MessageMomentBlockEnum["REFERRALS"] = "referrals";
 })(MessageMomentBlockEnum || (exports.MessageMomentBlockEnum = MessageMomentBlockEnum = {}));

package/bin/messageMoments/enums/MessageMomentEnum.d.ts

@@ -38,5 +38,7 @@ export declare enum MessageMomentEnum {
     PROFILE_CHANGE_CONFIRMED = "PROFILE_CHANGE_CONFIRMED",
     MONTHLY_STATEMENT = "MONTHLY_STATEMENT",
     CAT_TERMS_NOTICE = "CAT_TERMS_NOTICE",
-    PRIVACY_ARCO_NOTICE = "PRIVACY_ARCO_NOTICE"
+    PRIVACY_ARCO_NOTICE = "PRIVACY_ARCO_NOTICE",
+    REFERRAL_BONUS_CREDITED = "REFERRAL_BONUS_CREDITED",
+    REFERRAL_COUPON_ISSUED = "REFERRAL_COUPON_ISSUED"
 }

package/bin/messageMoments/enums/MessageMomentEnum.js

@@ -43,4 +43,6 @@ var MessageMomentEnum;
     MessageMomentEnum["MONTHLY_STATEMENT"] = "MONTHLY_STATEMENT";
     MessageMomentEnum["CAT_TERMS_NOTICE"] = "CAT_TERMS_NOTICE";
     MessageMomentEnum["PRIVACY_ARCO_NOTICE"] = "PRIVACY_ARCO_NOTICE";
+    MessageMomentEnum["REFERRAL_BONUS_CREDITED"] = "REFERRAL_BONUS_CREDITED";
+    MessageMomentEnum["REFERRAL_COUPON_ISSUED"] = "REFERRAL_COUPON_ISSUED";
 })(MessageMomentEnum || (exports.MessageMomentEnum = MessageMomentEnum = {}));

package/bin/retailCatalog/dtos/responses/GetInventorySkuResponse.d.ts

@@ -37,6 +37,24 @@ export interface InventoryPieceEntry {
 export interface InventoryStorePieces {
     storeId: string;
     pieces: InventoryPieceEntry[];
+    /** BALANCE#.available de la tienda; 0 sin BALANCE#. */
+    available?: number;
+    /** BALANCE#.reserved: apartadas por cantidad o con pieza HELD. */
+    reserved?: number;
+    /** Unidades que de verdad se pueden vender: min(available, piezas AVAILABLE). */
+    availableToSell?: number;
+}
+/** Reserva RES# viva de un SKU en una tienda, para la tarjeta "Apartados ahora" de la ficha. */
+export interface InventoryLiveReservation {
+    storeId: string;
+    sessionId: string;
+    lineId: string;
+    reservationId: string;
+    quantity: number;
+    /** ISO en que vence la reserva. */
+    expiresAt: string;
+    /** ISO en que se apartó; null si la fila no trae createdAt. */
+    reservedAt: string | null;
 }
 /** Response de backofficeGetInventorySku: solo lo que la fila de filter=list no trae. */
 export interface GetInventorySkuResponse {
@@ -51,6 +69,8 @@ export interface GetInventorySkuResponse {
     /** Promos de venta vigentes del SKU; `null` si retail-promotions no respondió. */
     promotions?: ActiveSalePromotionSummary[] | null;
     sources?: InventorySkuSources;
+    /** Reservas RES# vivas del SKU en todas las tiendas. */
+    liveReservations?: InventoryLiveReservation[];
 }
 /** Estado de las fuentes externas de la ficha. */
 export interface InventorySkuSources {

package/bin/retailWizard/catalog/backofficeSessionSummaries.d.ts

@@ -0,0 +1,4 @@
+/** Techo de ids por request de `POST /backoffice/wizard/sessions/summaries`. */
+export declare const BACKOFFICE_SESSION_SUMMARIES_MAX_IDS = 50;
+/** Forma aceptada de un `sessionId`; la misma que el lote privado de sesiones. */
+export declare const BACKOFFICE_SESSION_ID_PATTERN: RegExp;

package/bin/retailWizard/catalog/backofficeSessionSummaries.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BACKOFFICE_SESSION_ID_PATTERN = exports.BACKOFFICE_SESSION_SUMMARIES_MAX_IDS = void 0;
+/** Techo de ids por request de `POST /backoffice/wizard/sessions/summaries`. */
+exports.BACKOFFICE_SESSION_SUMMARIES_MAX_IDS = 50;
+/** Forma aceptada de un `sessionId`; la misma que el lote privado de sesiones. */
+exports.BACKOFFICE_SESSION_ID_PATTERN = /^[0-9A-Za-z_-]{1,64}$/;

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

@@ -0,0 +1,4 @@
+/** Body de `POST /backoffice/wizard/sessions/summaries`. */
+export declare class BackofficeSessionSummariesRequest {
+    sessionIds: string[];
+}

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

@@ -0,0 +1,30 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackofficeSessionSummariesRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const backofficeSessionSummaries_1 = require("../../catalog/backofficeSessionSummaries");
+/** Body de `POST /backoffice/wizard/sessions/summaries`. */
+class BackofficeSessionSummariesRequest {
+}
+exports.BackofficeSessionSummariesRequest = BackofficeSessionSummariesRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)({ message: 'sessionIds debe ser una lista' }),
+    (0, class_validator_1.ArrayMinSize)(1, { message: 'sessionIds debe traer al menos un id' }),
+    (0, class_validator_1.ArrayMaxSize)(backofficeSessionSummaries_1.BACKOFFICE_SESSION_SUMMARIES_MAX_IDS, {
+        message: `sessionIds no puede pasar de ${backofficeSessionSummaries_1.BACKOFFICE_SESSION_SUMMARIES_MAX_IDS} ids`,
+    }),
+    (0, class_validator_1.IsString)({ each: true, message: 'cada sessionId debe ser texto' }),
+    (0, class_validator_1.Matches)(backofficeSessionSummaries_1.BACKOFFICE_SESSION_ID_PATTERN, { each: true, message: 'cada sessionId debe tener forma de id' }),
+    __metadata("design:type", Array)
+], BackofficeSessionSummariesRequest.prototype, "sessionIds", void 0);

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

@@ -0,0 +1,18 @@
+import type { WizardStateEnum } from '../../enums/WizardStateEnum';
+import type { WizardStepEnum } from '../../enums/WizardStepEnum';
+/** Resumen de una sesión para el cajón de inventario del backoffice. */
+export interface BackofficeSessionSummary {
+    sessionId: string;
+    state: WizardStateEnum;
+    sellerName: string | null;
+    sellerRetailUserId: string | null;
+    storeId: string;
+    /** `true` si la sesión ya tiene cobro registrado. */
+    paid: boolean;
+    saleId: string | null;
+    currentStep: WizardStepEnum | null;
+}
+/** Respuesta de `POST /backoffice/wizard/sessions/summaries`; los ids desconocidos no aparecen. */
+export interface BackofficeSessionSummariesResult {
+    sessions: BackofficeSessionSummary[];
+}

package/bin/retailWizard/dtos/responses/BackofficeSessionSummariesResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/retailWizard/index.d.ts

@@ -188,3 +188,6 @@ export * from './dtos/WizardSessionLookupEntry';
 export * from './dtos/responses/WizardSessionLookupResponse';
 export * from './dtos/responses/PrivateWizardSessionResponse';
 export * from './dtos/responses/SetAnchorGiftsResponse';
+export * from './catalog/backofficeSessionSummaries';
+export * from './dtos/requests/BackofficeSessionSummariesRequest';
+export * from './dtos/responses/BackofficeSessionSummariesResponse';

package/bin/retailWizard/index.js

@@ -224,3 +224,7 @@ __exportStar(require("./dtos/responses/WizardSessionLookupResponse"), exports);
 // M2M de Promociones (lectura privada de la sesión y regalo)
 __exportStar(require("./dtos/responses/PrivateWizardSessionResponse"), exports);
 __exportStar(require("./dtos/responses/SetAnchorGiftsResponse"), exports);
+// Resúmenes de sesión para el cajón de inventario (POST /backoffice/wizard/sessions/summaries)
+__exportStar(require("./catalog/backofficeSessionSummaries"), exports);
+__exportStar(require("./dtos/requests/BackofficeSessionSummariesRequest"), exports);
+__exportStar(require("./dtos/responses/BackofficeSessionSummariesResponse"), exports);

package/package.json

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

package/src/messageMoments/constants/MessageMomentCatalog.ts

@@ -5,6 +5,10 @@ import {
     CREDIT_MOMENT_CONDITIONAL_VARIABLES,
     MOMENT_SPECIFIC_VARIABLES,
     OTP_MOMENT_VARIABLES,
+    REFERRAL_BONUS_ALWAYS_VARIABLES,
+    REFERRAL_BONUS_CONDITIONAL_VARIABLES,
+    REFERRAL_COUPON_ALWAYS_VARIABLES,
+    REFERRAL_COUPON_CONDITIONAL_VARIABLES,
 } from './MessageMomentVariables';
 
 /** Quién es un momento: su id de ficha, su plantilla, su bloque y las variables que emite. */
@@ -29,10 +33,21 @@ function creditMoment(templateId: string, messageType: MessageMomentEnum, blockI
     };
 }
 
+/** Un momento fuera del crédito: solo las variables que su emisor manda. */
+function standaloneMoment(
+    templateId: string,
+    messageType: MessageMomentEnum,
+    blockId: MessageMomentBlockEnum,
+    alwaysVariables: readonly string[],
+    conditionalVariables: readonly string[] = [],
+): MessageMomentIdentity {
+    return { templateId, messageType, blockId, alwaysVariables, conditionalVariables };
+}
+
 const B = MessageMomentBlockEnum;
 const M = MessageMomentEnum;
 
-/** Los 38 momentos EN ORDEN de recorrido del crédito. `PM-071` apunta al OTP de plataforma. */
+/** Los 38 momentos del crédito EN ORDEN de recorrido y al final los de referidos. `PM-071` apunta al OTP de plataforma. */
 export const MESSAGE_MOMENT_CATALOG: readonly MessageMomentIdentity[] = [
     creditMoment('PM-001', M.APPLICATION_APPROVED, B.ORIGINATION),
     creditMoment('PM-002', M.APPLICATION_REJECTED, B.ORIGINATION),
@@ -66,18 +81,14 @@ export const MESSAGE_MOMENT_CATALOG: readonly MessageMomentIdentity[] = [
     creditMoment('PM-062', M.SETTLEMENT_BUREAU_NOTICE, B.CLOSURE),
     creditMoment('PM-063', M.REENTRY_INVITATION, B.CLOSURE),
     creditMoment('PM-070', M.APP_WELCOME, B.SERVICE),
-    {
-        templateId: 'PM-071',
-        messageType: M.OTP_CODE,
-        blockId: B.SERVICE,
-        alwaysVariables: OTP_MOMENT_VARIABLES,
-        conditionalVariables: [],
-    },
+    standaloneMoment('PM-071', M.OTP_CODE, B.SERVICE, OTP_MOMENT_VARIABLES),
     creditMoment('PM-072', M.SECURITY_ALERT, B.SERVICE),
     creditMoment('PM-073', M.PROFILE_CHANGE_CONFIRMED, B.SERVICE),
     creditMoment('PM-074', M.MONTHLY_STATEMENT, B.SERVICE),
     creditMoment('PM-075', M.CAT_TERMS_NOTICE, B.SERVICE),
     creditMoment('PM-076', M.PRIVACY_ARCO_NOTICE, B.SERVICE),
+    standaloneMoment('PM-080', M.REFERRAL_BONUS_CREDITED, B.REFERRALS, REFERRAL_BONUS_ALWAYS_VARIABLES, REFERRAL_BONUS_CONDITIONAL_VARIABLES),
+    standaloneMoment('PM-081', M.REFERRAL_COUPON_ISSUED, B.REFERRALS, REFERRAL_COUPON_ALWAYS_VARIABLES, REFERRAL_COUPON_CONDITIONAL_VARIABLES),
 ];
 
 /** La identidad por id de ficha (`PM-030`). */

package/src/messageMoments/constants/MessageMomentVariables.ts

@@ -30,6 +30,18 @@ export const CREDIT_MOMENT_CONDITIONAL_VARIABLES: readonly string[] = [
 /** El OTP lo arma messages-business: llena `code` y su alias posicional `var1`. */
 export const OTP_MOMENT_VARIABLES: readonly string[] = ['code', 'var1'];
 
+/** Premio de referido abonado a la cuenta PCF: a quién y cuánto. */
+export const REFERRAL_BONUS_ALWAYS_VARIABLES: readonly string[] = ['cliente_nombre', 'monto'];
+
+/** El referido solo se nombra cuando el premio es de quien recomendó. */
+export const REFERRAL_BONUS_CONDITIONAL_VARIABLES: readonly string[] = ['referido_nombre'];
+
+/** Cupón de referido emitido: el código, su descuento ya formateado y hasta cuándo vale. */
+export const REFERRAL_COUPON_ALWAYS_VARIABLES: readonly string[] = ['cliente_nombre', 'codigo', 'descuento', 'vigencia'];
+
+/** La tienda solo viaja cuando el cupón no vale en todas. */
+export const REFERRAL_COUPON_CONDITIONAL_VARIABLES: readonly string[] = ['tienda'];
+
 /** Lo que el plan nuevo de una reestructura le dice al cliente. */
 export const RESTRUCTURE_MOMENT_VARIABLES: readonly string[] = ['plazo_nuevo', 'cuota_nueva', 'saldo_nuevo'];
 

package/src/messageMoments/enums/MessageMomentBlockEnum.ts

@@ -8,4 +8,5 @@ export enum MessageMomentBlockEnum {
     EXCEPTIONS = 'exceptions',
     CLOSURE = 'closure',
     SERVICE = 'service',
+    REFERRALS = 'referrals',
 }

package/src/messageMoments/enums/MessageMomentEnum.ts

@@ -47,4 +47,7 @@ export enum MessageMomentEnum {
     MONTHLY_STATEMENT = 'MONTHLY_STATEMENT',
     CAT_TERMS_NOTICE = 'CAT_TERMS_NOTICE',
     PRIVACY_ARCO_NOTICE = 'PRIVACY_ARCO_NOTICE',
+
+    REFERRAL_BONUS_CREDITED = 'REFERRAL_BONUS_CREDITED',
+    REFERRAL_COUPON_ISSUED = 'REFERRAL_COUPON_ISSUED',
 }

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

@@ -41,6 +41,25 @@ export interface InventoryPieceEntry {
 export interface InventoryStorePieces {
     storeId: string;
     pieces: InventoryPieceEntry[];
+    /** BALANCE#.available de la tienda; 0 sin BALANCE#. */
+    available?: number;
+    /** BALANCE#.reserved: apartadas por cantidad o con pieza HELD. */
+    reserved?: number;
+    /** Unidades que de verdad se pueden vender: min(available, piezas AVAILABLE). */
+    availableToSell?: number;
+}
+
+/** Reserva RES# viva de un SKU en una tienda, para la tarjeta "Apartados ahora" de la ficha. */
+export interface InventoryLiveReservation {
+    storeId: string;
+    sessionId: string;
+    lineId: string;
+    reservationId: string;
+    quantity: number;
+    /** ISO en que vence la reserva. */
+    expiresAt: string;
+    /** ISO en que se apartó; null si la fila no trae createdAt. */
+    reservedAt: string | null;
 }
 
 /** Response de backofficeGetInventorySku: solo lo que la fila de filter=list no trae. */
@@ -56,6 +75,8 @@ export interface GetInventorySkuResponse {
     /** Promos de venta vigentes del SKU; `null` si retail-promotions no respondió. */
     promotions?: ActiveSalePromotionSummary[] | null;
     sources?: InventorySkuSources;
+    /** Reservas RES# vivas del SKU en todas las tiendas. */
+    liveReservations?: InventoryLiveReservation[];
 }
 
 /** Estado de las fuentes externas de la ficha. */

package/src/retailWizard/catalog/backofficeSessionSummaries.ts

@@ -0,0 +1,5 @@
+/** Techo de ids por request de `POST /backoffice/wizard/sessions/summaries`. */
+export const BACKOFFICE_SESSION_SUMMARIES_MAX_IDS = 50;
+
+/** Forma aceptada de un `sessionId`; la misma que el lote privado de sesiones. */
+export const BACKOFFICE_SESSION_ID_PATTERN = /^[0-9A-Za-z_-]{1,64}$/;

package/src/retailWizard/dtos/requests/BackofficeSessionSummariesRequest.ts

@@ -0,0 +1,19 @@
+import { Expose } from 'class-transformer';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsString, Matches } from 'class-validator';
+import {
+  BACKOFFICE_SESSION_ID_PATTERN,
+  BACKOFFICE_SESSION_SUMMARIES_MAX_IDS,
+} from '../../catalog/backofficeSessionSummaries';
+
+/** Body de `POST /backoffice/wizard/sessions/summaries`. */
+export class BackofficeSessionSummariesRequest {
+  @Expose()
+  @IsArray({ message: 'sessionIds debe ser una lista' })
+  @ArrayMinSize(1, { message: 'sessionIds debe traer al menos un id' })
+  @ArrayMaxSize(BACKOFFICE_SESSION_SUMMARIES_MAX_IDS, {
+    message: `sessionIds no puede pasar de ${BACKOFFICE_SESSION_SUMMARIES_MAX_IDS} ids`,
+  })
+  @IsString({ each: true, message: 'cada sessionId debe ser texto' })
+  @Matches(BACKOFFICE_SESSION_ID_PATTERN, { each: true, message: 'cada sessionId debe tener forma de id' })
+  sessionIds!: string[];
+}

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

@@ -0,0 +1,20 @@
+import type { WizardStateEnum } from '../../enums/WizardStateEnum';
+import type { WizardStepEnum } from '../../enums/WizardStepEnum';
+
+/** Resumen de una sesión para el cajón de inventario del backoffice. */
+export interface BackofficeSessionSummary {
+  sessionId: string;
+  state: WizardStateEnum;
+  sellerName: string | null;
+  sellerRetailUserId: string | null;
+  storeId: string;
+  /** `true` si la sesión ya tiene cobro registrado. */
+  paid: boolean;
+  saleId: string | null;
+  currentStep: WizardStepEnum | null;
+}
+
+/** Respuesta de `POST /backoffice/wizard/sessions/summaries`; los ids desconocidos no aparecen. */
+export interface BackofficeSessionSummariesResult {
+  sessions: BackofficeSessionSummary[];
+}

package/src/retailWizard/index.ts

@@ -219,3 +219,8 @@ export * from './dtos/responses/WizardSessionLookupResponse';
 // M2M de Promociones (lectura privada de la sesión y regalo)
 export * from './dtos/responses/PrivateWizardSessionResponse';
 export * from './dtos/responses/SetAnchorGiftsResponse';
+
+// Resúmenes de sesión para el cajón de inventario (POST /backoffice/wizard/sessions/summaries)
+export * from './catalog/backofficeSessionSummaries';
+export * from './dtos/requests/BackofficeSessionSummariesRequest';
+export * from './dtos/responses/BackofficeSessionSummariesResponse';