@fiado/type-kit 3.535.0 → 3.536.0

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

@@ -0,0 +1,54 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+  CancelOtherStoreSaleRequest,
+  SystemCancelReasonEnum,
+  type ActiveSessionByPhoneResponse,
+  type CancelOtherStoreSaleResponse,
+  type WizardSession,
+} from '../../../src/retailWizard';
+
+async function errorsOf(body: Record<string, unknown>): Promise<string[]> {
+  const errors = await validate(plainToInstance(CancelOtherStoreSaleRequest, body));
+  return errors.map((e) => e.property);
+}
+
+describe('SystemCancelReasonEnum', () => {
+  it('names the cancel when another store takes the customer over', () => {
+    expect(SystemCancelReasonEnum.TAKEN_OVER_BY_OTHER_STORE).toBe('TAKEN_OVER_BY_OTHER_STORE');
+  });
+});
+
+describe('CancelOtherStoreSaleRequest', () => {
+  it('accepts a phone and a reason of at least 10 characters', async () => {
+    expect(await errorsOf({ phone: '5512345678', reason: 'El cliente compra aquí' })).toEqual([]);
+  });
+
+  it('the reason is mandatory and meaningful', async () => {
+    expect(await errorsOf({ phone: '5512345678' })).toContain('reason');
+    expect(await errorsOf({ phone: '5512345678', reason: 'corto' })).toContain('reason');
+  });
+
+  it('the phone is mandatory', async () => {
+    expect(await errorsOf({ reason: 'El cliente compra aquí' })).toContain('phone');
+  });
+});
+
+describe('cash-only sale', () => {
+  it('WizardSession and the sale by phone carry the cash-only mark', () => {
+    const session: Pick<WizardSession, 'cashOnly'> = { cashOnly: true };
+    const byPhone: Pick<ActiveSessionByPhoneResponse, 'cashOnly'> = { cashOnly: true };
+    const cancelled: CancelOtherStoreSaleResponse = { sessionId: 'S1', refundPendingCents: null };
+    expect([session.cashOnly, byPhone.cashOnly, cancelled.sessionId]).toEqual([true, true, 'S1']);
+  });
+});
+
+describe('MoneyAtStakeKindEnum', () => {
+  it('distinguishes a charged or closed sale from a quoted credit', async () => {
+    const { MoneyAtStakeKindEnum } = await import('../../../src/retailWizard');
+    expect(Object.values(MoneyAtStakeKindEnum)).toEqual(['SALE', 'CREDIT_QUOTED']);
+    const byPhone: Pick<ActiveSessionByPhoneResponse, 'moneyAtStakeKind'> = { moneyAtStakeKind: MoneyAtStakeKindEnum.CREDIT_QUOTED };
+    expect(byPhone.moneyAtStakeKind).toBe('CREDIT_QUOTED');
+  });
+});

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

@@ -151,6 +151,11 @@ export interface WizardSession {
     /** Prospecto vinculado (si la sesión se reanudó desde un prospecto): se cierra al cerrar la venta (D-prospecto). */
     prospectId: string | null;
     cancelReason: string | null;
+    /**
+     * Venta solo de contado: el cliente tiene una venta con dinero en juego en otra sucursal.
+     * Crédito y derivación se rechazan con `CREDIT_IN_PROGRESS_OTHER_STORE`. Ausente = venta completa.
+     */
+    cashOnly?: boolean;
     /** TTL DDB ~24h de inactividad (D14). */
     ttlEpoch: number;
     createdBy: string;

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

@@ -0,0 +1,9 @@
+/**
+ * POST /wizard/phone-holder/cancel y /backoffice/phone-holder/cancel — el encargado de tienda o el
+ * Admin VL cancela la venta viva de otra sucursal que retiene al cliente. SureKeep — pista Retail.
+ */
+export declare class CancelOtherStoreSaleRequest {
+    /** Teléfono del cliente: la venta ajena no se expone, así que es la única llave. */
+    phone: string;
+    reason: string;
+}

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

@@ -0,0 +1,34 @@
+"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.CancelOtherStoreSaleRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * POST /wizard/phone-holder/cancel y /backoffice/phone-holder/cancel — el encargado de tienda o el
+ * Admin VL cancela la venta viva de otra sucursal que retiene al cliente. SureKeep — pista Retail.
+ */
+class CancelOtherStoreSaleRequest {
+}
+exports.CancelOtherStoreSaleRequest = CancelOtherStoreSaleRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(20),
+    __metadata("design:type", String)
+], CancelOtherStoreSaleRequest.prototype, "phone", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(10),
+    (0, class_validator_1.MaxLength)(200),
+    __metadata("design:type", String)
+], CancelOtherStoreSaleRequest.prototype, "reason", void 0);

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

@@ -1,3 +1,4 @@
+import type { MoneyAtStakeKindEnum } from '../../enums/MoneyAtStakeKindEnum';
 import type { WizardStateEnum } from '../../enums/WizardStateEnum';
 import type { WizardStepEnum } from '../../enums/WizardStepEnum';
 import type { WizardBlockedSummary } from '../WizardBlocked';
@@ -32,4 +33,8 @@ export interface ActiveSessionByPhoneResponse {
     exactUntil?: string | null;
     /** La venta movió dinero u originó crédito: siempre se retoma la misma. */
     moneyAtStake?: boolean;
+    /** Qué dinero retiene: SALE (folio, cobro o venta) o CREDIT_QUOTED (solo crédito cotizado); `null` = ninguno. */
+    moneyAtStakeKind?: MoneyAtStakeKindEnum | null;
+    /** Venta solo de contado (el cliente tiene una venta con dinero en otra sucursal). */
+    cashOnly?: boolean;
 }

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

@@ -0,0 +1,7 @@
+/** Resultado de cancelar la venta de otra sucursal que retenía al cliente. SureKeep — pista Retail. */
+export interface CancelOtherStoreSaleResponse {
+    /** Venta cancelada. */
+    sessionId: string;
+    /** Enganche cobrado que queda por reembolsar; `null` si no hubo cobro. */
+    refundPendingCents: number | null;
+}

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

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

package/bin/retailWizard/enums/MoneyAtStakeKindEnum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Qué dinero retiene la venta, para el texto de la ficha.
+ * SALE: hay folio, cobro o venta cerrada.
+ * CREDIT_QUOTED: solo hay un crédito cotizado (sin cobro).
+ */
+export declare enum MoneyAtStakeKindEnum {
+    SALE = "SALE",
+    CREDIT_QUOTED = "CREDIT_QUOTED"
+}

package/bin/retailWizard/enums/MoneyAtStakeKindEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MoneyAtStakeKindEnum = void 0;
+/**
+ * Qué dinero retiene la venta, para el texto de la ficha.
+ * SALE: hay folio, cobro o venta cerrada.
+ * CREDIT_QUOTED: solo hay un crédito cotizado (sin cobro).
+ */
+var MoneyAtStakeKindEnum;
+(function (MoneyAtStakeKindEnum) {
+    MoneyAtStakeKindEnum["SALE"] = "SALE";
+    MoneyAtStakeKindEnum["CREDIT_QUOTED"] = "CREDIT_QUOTED";
+})(MoneyAtStakeKindEnum || (exports.MoneyAtStakeKindEnum = MoneyAtStakeKindEnum = {}));

package/bin/retailWizard/enums/SystemCancelReasonEnum.d.ts

@@ -1,4 +1,9 @@
-/** `cancelReason` que escribe el sistema (no el vendedor). La saga cierra la venta cuyo crédito se descartó. */
+/**
+ * `cancelReason` que escribe el sistema (no el vendedor).
+ * SWEEP_CREDIT_DISCARDED: la saga cierra la venta cuyo crédito se descartó.
+ * TAKEN_OVER_BY_OTHER_STORE: otra tienda tomó al cliente y la venta no tenía dinero en juego.
+ */
 export declare enum SystemCancelReasonEnum {
-    SWEEP_CREDIT_DISCARDED = "SWEEP_CREDIT_DISCARDED"
+    SWEEP_CREDIT_DISCARDED = "SWEEP_CREDIT_DISCARDED",
+    TAKEN_OVER_BY_OTHER_STORE = "TAKEN_OVER_BY_OTHER_STORE"
 }

package/bin/retailWizard/enums/SystemCancelReasonEnum.js

@@ -1,8 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SystemCancelReasonEnum = void 0;
-/** `cancelReason` que escribe el sistema (no el vendedor). La saga cierra la venta cuyo crédito se descartó. */
+/**
+ * `cancelReason` que escribe el sistema (no el vendedor).
+ * SWEEP_CREDIT_DISCARDED: la saga cierra la venta cuyo crédito se descartó.
+ * TAKEN_OVER_BY_OTHER_STORE: otra tienda tomó al cliente y la venta no tenía dinero en juego.
+ */
 var SystemCancelReasonEnum;
 (function (SystemCancelReasonEnum) {
     SystemCancelReasonEnum["SWEEP_CREDIT_DISCARDED"] = "SWEEP_CREDIT_DISCARDED";
+    SystemCancelReasonEnum["TAKEN_OVER_BY_OTHER_STORE"] = "TAKEN_OVER_BY_OTHER_STORE";
 })(SystemCancelReasonEnum || (exports.SystemCancelReasonEnum = SystemCancelReasonEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -19,6 +19,7 @@ export * from './enums/AccountStepStatusEnum';
 export * from './enums/ResumeReasonEnum';
 export * from './enums/ProspectResumeModeEnum';
 export * from './enums/SystemCancelReasonEnum';
+export * from './enums/MoneyAtStakeKindEnum';
 export * from './enums/AppOnboardingStepEnum';
 export * from './enums/AppOnboardingStepStatusEnum';
 export * from './enums/BlockedReasonEnum';
@@ -58,6 +59,7 @@ export * from './dtos/Prospect';
 export * from './dtos/PaginatedResult';
 export * from './dtos/requests/StartSessionRequest';
 export * from './dtos/requests/CancelSessionRequest';
+export * from './dtos/requests/CancelOtherStoreSaleRequest';
 export * from './dtos/requests/VerifyOtpRequest';
 export * from './dtos/requests/ResendOtpRequest';
 export * from './dtos/requests/SkipOtpRequest';
@@ -109,6 +111,7 @@ export * from './dtos/responses/RegisterDeviceResponse';
 export * from './dtos/responses/AccountStatusResponse';
 export * from './dtos/responses/ActiveSessionByPhoneResponse';
 export * from './dtos/responses/ProspectResumeResponse';
+export * from './dtos/responses/CancelOtherStoreSaleResponse';
 export * from './dtos/responses/ProspectByPhoneResponse';
 export * from './dtos/responses/AppOnboardingResponse';
 export * from './enums/SaleFinancierEnum';

package/bin/retailWizard/index.js

@@ -38,6 +38,7 @@ __exportStar(require("./enums/AccountStepStatusEnum"), exports);
 __exportStar(require("./enums/ResumeReasonEnum"), exports);
 __exportStar(require("./enums/ProspectResumeModeEnum"), exports);
 __exportStar(require("./enums/SystemCancelReasonEnum"), exports);
+__exportStar(require("./enums/MoneyAtStakeKindEnum"), exports);
 __exportStar(require("./enums/AppOnboardingStepEnum"), exports);
 __exportStar(require("./enums/AppOnboardingStepStatusEnum"), exports);
 __exportStar(require("./enums/BlockedReasonEnum"), exports);
@@ -83,6 +84,7 @@ __exportStar(require("./dtos/PaginatedResult"), exports);
 // Request DTOs (input validado por endpoint)
 __exportStar(require("./dtos/requests/StartSessionRequest"), exports);
 __exportStar(require("./dtos/requests/CancelSessionRequest"), exports);
+__exportStar(require("./dtos/requests/CancelOtherStoreSaleRequest"), exports);
 __exportStar(require("./dtos/requests/VerifyOtpRequest"), exports);
 __exportStar(require("./dtos/requests/ResendOtpRequest"), exports);
 __exportStar(require("./dtos/requests/SkipOtpRequest"), exports);
@@ -135,6 +137,7 @@ __exportStar(require("./dtos/responses/RegisterDeviceResponse"), exports);
 __exportStar(require("./dtos/responses/AccountStatusResponse"), exports);
 __exportStar(require("./dtos/responses/ActiveSessionByPhoneResponse"), exports);
 __exportStar(require("./dtos/responses/ProspectResumeResponse"), exports);
+__exportStar(require("./dtos/responses/CancelOtherStoreSaleResponse"), exports);
 __exportStar(require("./dtos/responses/ProspectByPhoneResponse"), exports);
 __exportStar(require("./dtos/responses/AppOnboardingResponse"), exports);
 // ── F3 · Backoffice VentasLuga ────────────────────────────────────────────────

package/package.json

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

package/src/retailWizard/dtos/WizardSession.ts

@@ -155,6 +155,11 @@ export interface WizardSession {
   /** Prospecto vinculado (si la sesión se reanudó desde un prospecto): se cierra al cerrar la venta (D-prospecto). */
   prospectId: string | null;
   cancelReason: string | null;
+  /**
+   * Venta solo de contado: el cliente tiene una venta con dinero en juego en otra sucursal.
+   * Crédito y derivación se rechazan con `CREDIT_IN_PROGRESS_OTHER_STORE`. Ausente = venta completa.
+   */
+  cashOnly?: boolean;
   /** TTL DDB ~24h de inactividad (D14). */
   ttlEpoch: number;
   createdBy: string;

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

@@ -0,0 +1,20 @@
+import { Expose } from 'class-transformer';
+import { IsString, MaxLength, MinLength } from 'class-validator';
+
+/**
+ * POST /wizard/phone-holder/cancel y /backoffice/phone-holder/cancel — el encargado de tienda o el
+ * Admin VL cancela la venta viva de otra sucursal que retiene al cliente. SureKeep — pista Retail.
+ */
+export class CancelOtherStoreSaleRequest {
+    /** Teléfono del cliente: la venta ajena no se expone, así que es la única llave. */
+    @Expose()
+    @IsString()
+    @MaxLength(20)
+    phone!: string;
+
+    @Expose()
+    @IsString()
+    @MinLength(10)
+    @MaxLength(200)
+    reason!: string;
+}

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

@@ -1,3 +1,4 @@
+import type { MoneyAtStakeKindEnum } from '../../enums/MoneyAtStakeKindEnum';
 import type { WizardStateEnum } from '../../enums/WizardStateEnum';
 import type { WizardStepEnum } from '../../enums/WizardStepEnum';
 import type { WizardBlockedSummary } from '../WizardBlocked';
@@ -33,4 +34,8 @@ export interface ActiveSessionByPhoneResponse {
     exactUntil?: string | null;
     /** La venta movió dinero u originó crédito: siempre se retoma la misma. */
     moneyAtStake?: boolean;
+    /** Qué dinero retiene: SALE (folio, cobro o venta) o CREDIT_QUOTED (solo crédito cotizado); `null` = ninguno. */
+    moneyAtStakeKind?: MoneyAtStakeKindEnum | null;
+    /** Venta solo de contado (el cliente tiene una venta con dinero en otra sucursal). */
+    cashOnly?: boolean;
 }

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

@@ -0,0 +1,7 @@
+/** Resultado de cancelar la venta de otra sucursal que retenía al cliente. SureKeep — pista Retail. */
+export interface CancelOtherStoreSaleResponse {
+    /** Venta cancelada. */
+    sessionId: string;
+    /** Enganche cobrado que queda por reembolsar; `null` si no hubo cobro. */
+    refundPendingCents: number | null;
+}

package/src/retailWizard/enums/MoneyAtStakeKindEnum.ts

@@ -0,0 +1,9 @@
+/**
+ * Qué dinero retiene la venta, para el texto de la ficha.
+ * SALE: hay folio, cobro o venta cerrada.
+ * CREDIT_QUOTED: solo hay un crédito cotizado (sin cobro).
+ */
+export enum MoneyAtStakeKindEnum {
+    SALE = 'SALE',
+    CREDIT_QUOTED = 'CREDIT_QUOTED',
+}

package/src/retailWizard/enums/SystemCancelReasonEnum.ts

@@ -1,4 +1,9 @@
-/** `cancelReason` que escribe el sistema (no el vendedor). La saga cierra la venta cuyo crédito se descartó. */
+/**
+ * `cancelReason` que escribe el sistema (no el vendedor).
+ * SWEEP_CREDIT_DISCARDED: la saga cierra la venta cuyo crédito se descartó.
+ * TAKEN_OVER_BY_OTHER_STORE: otra tienda tomó al cliente y la venta no tenía dinero en juego.
+ */
 export enum SystemCancelReasonEnum {
     SWEEP_CREDIT_DISCARDED = 'SWEEP_CREDIT_DISCARDED',
+    TAKEN_OVER_BY_OTHER_STORE = 'TAKEN_OVER_BY_OTHER_STORE',
 }

package/src/retailWizard/index.ts

@@ -22,6 +22,7 @@ export * from './enums/AccountStepStatusEnum';
 export * from './enums/ResumeReasonEnum';
 export * from './enums/ProspectResumeModeEnum';
 export * from './enums/SystemCancelReasonEnum';
+export * from './enums/MoneyAtStakeKindEnum';
 export * from './enums/AppOnboardingStepEnum';
 export * from './enums/AppOnboardingStepStatusEnum';
 export * from './enums/BlockedReasonEnum';
@@ -69,6 +70,7 @@ export * from './dtos/PaginatedResult';
 // Request DTOs (input validado por endpoint)
 export * from './dtos/requests/StartSessionRequest';
 export * from './dtos/requests/CancelSessionRequest';
+export * from './dtos/requests/CancelOtherStoreSaleRequest';
 export * from './dtos/requests/VerifyOtpRequest';
 export * from './dtos/requests/ResendOtpRequest';
 export * from './dtos/requests/SkipOtpRequest';
@@ -122,6 +124,7 @@ export * from './dtos/responses/RegisterDeviceResponse';
 export * from './dtos/responses/AccountStatusResponse';
 export * from './dtos/responses/ActiveSessionByPhoneResponse';
 export * from './dtos/responses/ProspectResumeResponse';
+export * from './dtos/responses/CancelOtherStoreSaleResponse';
 export * from './dtos/responses/ProspectByPhoneResponse';
 export * from './dtos/responses/AppOnboardingResponse';