@fiado/type-kit 3.551.0 → 3.552.0

package/_test_/unit/retailCatalog/singlePriceFields.test.ts

@@ -0,0 +1,48 @@
+import 'reflect-metadata';
+import * as RetailCatalog from '../../../src/retailCatalog';
+
+// ts-jest compila con type-check: si un campo sigue obligatorio o no existe, la suite no compila.
+describe('retailCatalog — un solo precio y valor del regalo', () => {
+  const reservation: RetailCatalog.ReserveStockResponse = {
+    expiresAt: '2026-10-20T20:30:00.000Z',
+    basePriceCents: 0,
+    priceSk: '2026-10-01T00:00:00.000Z',
+    eligibleFinanciers: [],
+    sellItemCost: 1,
+    mdmEnabled: false,
+    mdmProvider: null,
+  };
+
+  it('ReserveStockResponse es válida sin listPriceCents ni giftValueCents', () => {
+    expect(reservation.giftValueCents).toBeUndefined();
+    expect(reservation.listPriceCents).toBeUndefined();
+  });
+
+  it('la reserva de regalo trae giftValueCents', () => {
+    const gift: RetailCatalog.ReserveStockResponse = { ...reservation, giftValueCents: 35000 };
+    expect(gift.giftValueCents).toBe(35000);
+  });
+
+  it('acepta los dos nombres con el mismo valor mientras dure la transición', () => {
+    const gift: RetailCatalog.ReserveStockResponse = { ...reservation, giftValueCents: 35000, listPriceCents: 35000 };
+    expect(gift.listPriceCents).toBe(gift.giftValueCents);
+  });
+
+  it('Product es válido sin listPriceCents', () => {
+    const product: Pick<RetailCatalog.Product, 'sku' | 'basePriceCents' | 'listPriceCents'> = {
+      sku: 'SKU-1',
+      basePriceCents: 129900,
+    };
+    expect(product.listPriceCents).toBeUndefined();
+  });
+
+  it('SkuPriceEntry es válido sin listPriceCents', () => {
+    const entry: RetailCatalog.SkuPriceEntry = {
+      effectiveFrom: '2026-10-20T00:00:00.000Z',
+      basePriceCents: 129900,
+      source: RetailCatalog.PriceSourceEnum.BACKOFFICE,
+      createdBy: 'backoffice-user-1',
+    };
+    expect(entry.listPriceCents).toBeUndefined();
+  });
+});

package/_test_/unit/retailIntegration/eventPayloads.test.ts

@@ -94,6 +94,7 @@ describe('ProductEventPayload', () => {
         ['price.effectiveFrom', { price: { ...product.price, effectiveFrom: '2026-08-17T20:32:05' } }],
         ['eligibleFinanciers', { eligibleFinanciers: ['NADIE'] }],
         ['tier', { tier: undefined }],
+        ['price.listPrice', { price: { basePrice: '4299.00', effectiveFrom: '2026-08-17T20:32:05Z' } }],
     ])('rechaza %s', async (path, over) => {
         expect(await errorsOf(ProductEventPayload, { ...product, ...over })).toContain(path);
     });

package/_test_/unit/retailPromotions/giftOptionValue.test.ts

@@ -0,0 +1,20 @@
+import 'reflect-metadata';
+import type { GiftOption } from '../../../src/retailPromotions/index';
+
+describe('GiftOption.valueCents', () => {
+  it('trae el valor del regalo sin listPriceCents', () => {
+    const option: GiftOption = { sku: 'CASE-1', name: 'Funda', valueCents: 35000, inStock: true };
+    expect(option.valueCents).toBe(35000);
+    expect(option.listPriceCents).toBeUndefined();
+  });
+
+  it('acepta los dos nombres con el mismo valor mientras dure la transición', () => {
+    const option: GiftOption = { sku: 'CASE-1', name: 'Funda', valueCents: 35000, listPriceCents: 35000, inStock: true };
+    expect(option.listPriceCents).toBe(option.valueCents);
+  });
+
+  it('sigue aceptando solo el nombre viejo, para no romper a promotions develop', () => {
+    const legacy: GiftOption = { sku: 'CASE-1', name: 'Funda', listPriceCents: 35000, inStock: true };
+    expect(legacy.valueCents).toBeUndefined();
+  });
+});

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

@@ -0,0 +1,40 @@
+import 'reflect-metadata';
+import {
+  LinePaymentTypeEnum,
+  WizardLineStatusEnum,
+  type SaleLine,
+  type WizardReservedLine,
+} from '../../../src/retailWizard';
+
+describe('retailWizard — líneas sin precio de lista', () => {
+  it('WizardReservedLine es válida sin listPriceCents', () => {
+    const line: WizardReservedLine = {
+      lineId: 'L1',
+      sku: 'PHONE-1',
+      qty: 1,
+      status: WizardLineStatusEnum.RESERVED,
+      reservationId: 'r-1',
+      expiresAt: '2026-10-20T20:30:00.000Z',
+      basePriceCents: 349900,
+      priceSk: 'p',
+      eligibleFinanciers: ['SUREKEEP'],
+      financeable: true,
+      paymentType: LinePaymentTypeEnum.CREDIT,
+      sellItemCost: 1,
+    };
+    expect(line.listPriceCents).toBeUndefined();
+  });
+
+  it('SaleLine es válida sin listPriceCents', () => {
+    const line: SaleLine = {
+      lineId: 'L1',
+      sku: 'PHONE-1',
+      qty: 1,
+      basePriceCents: 349900,
+      priceSk: 'p',
+      paymentType: LinePaymentTypeEnum.CREDIT,
+      components: [{ sku: 'PHONE-1', qty: 1, identifiers: ['356938035643809'] }],
+    };
+    expect(line.listPriceCents).toBeUndefined();
+  });
+});

package/bin/retailCatalog/dtos/Product.d.ts

@@ -27,7 +27,8 @@ export declare class Product {
     /** `null` = Sin gama. */
     tier: ProductTierEnum | null;
     basePriceCents: number;
-    listPriceCents: number | null;
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
+    listPriceCents?: number | null;
     eligibleFinanciers: string[];
     mdmEnabled: boolean;
     mdmProvider: MdmProviderEnum | null;

package/bin/retailCatalog/dtos/requests/BackofficeCreateSkuPriceRequest.d.ts

@@ -1,5 +1,6 @@
 /** Body de POST /backoffice/inventory/skus/{sku}/prices (backofficeCreateSkuPrice); crea un PRICE# nuevo con origen BACKOFFICE. */
 export declare class BackofficeCreateSkuPriceRequest {
     basePriceCents: number;
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
     listPriceCents?: number | null;
 }

package/bin/retailCatalog/dtos/requests/CreateProductRequest.d.ts

@@ -17,6 +17,7 @@ export declare class CreateProductRequest {
     imageUrl?: string | null;
     tier: ProductTierEnum;
     basePriceCents: number;
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
     listPriceCents?: number | null;
     eligibleFinanciers: string[];
     mdmEnabled: boolean;

package/bin/retailCatalog/dtos/requests/SyncInventoryRequest.d.ts

@@ -6,6 +6,7 @@ import { TrackingModeEnum } from '../../enums/TrackingModeEnum';
 import { ProductComponent } from '../ProductComponent';
 /** Precio de un producto en la puerta de entrada; crea PRICE# solo si cambió el monto. */
 export declare class SyncPrice {
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
     listPriceCents?: number | null;
     basePriceCents: number;
     effectiveFrom: string;

package/bin/retailCatalog/dtos/requests/UpdateProductRequest.d.ts

@@ -16,6 +16,7 @@ export declare class UpdateProductRequest {
     imageUrl?: string | null;
     tier?: ProductTierEnum;
     basePriceCents?: number;
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
     listPriceCents?: number | null;
     eligibleFinanciers?: string[];
     mdmEnabled?: boolean;

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

@@ -61,7 +61,7 @@ export interface InventoryLensSkuItem {
     criticalStock: boolean;
     /** Unidades de este SKU vendidas hoy en esta tienda, **financiadas por SureKeep**. */
     soldTodayUnits: number;
-    /** Precio de contado en centavos (`listPriceCents`, o `basePriceCents` si no hay lista). */
+    /** Precio de contado en centavos (`basePriceCents`). */
     cashPriceCents: number;
 }
 /** Una fila del tab `transfers`: mover unidades de un SKU de una tienda con excedente a una en crítico. */

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

@@ -14,7 +14,10 @@ export interface ReservedComponent {
 export interface ReserveStockResponse {
     expiresAt: string;
     basePriceCents: number;
-    listPriceCents: number | null;
+    /** @deprecated Usa `giftValueCents`; en reservas GIFT trae el mismo valor, en las demás `null`. */
+    listPriceCents?: number | null;
+    /** Solo en reservas `purpose: GIFT`: valor del regalo, su precio de venta. */
+    giftValueCents?: number;
     /** Llave del registro PRICE# del que salió el precio fijado. */
     priceSk: string;
     eligibleFinanciers: string[];

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

@@ -2,7 +2,8 @@ import type { PriceSourceEnum } from '../../enums/PriceSourceEnum';
 /** Un registro del historial de precios PRICE# de un SKU. */
 export interface SkuPriceEntry {
     effectiveFrom: string;
-    listPriceCents: number | null;
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
+    listPriceCents?: number | null;
     basePriceCents: number;
     source: PriceSourceEnum;
     createdBy: string;

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

@@ -36,7 +36,7 @@ export interface StoreCatalogItem {
     itemType?: ItemTypeEnum;
     /** Nombre visible para kits y servicios, que no tienen marca/modelo. */
     description?: string;
-    /** Precio de lista de respaldo para un regalo: el precio vigente o, si no hay, product.basePriceCents. */
+    /** @deprecated Ya no se usa; el valor de un regalo es `basePriceCents`. */
     listPriceCents?: number;
     /** Prioridad de venta de 0 a 100; «Recomendados» ordena por ella. */
     salePriority?: number;

package/bin/retailPromotions/dtos/responses/WizardSalePromotionResponses.d.ts

@@ -42,7 +42,10 @@ export interface ListStoreSalePromotionsResponse {
 export interface GiftOption {
     sku: string;
     name: string;
-    listPriceCents: number;
+    /** Valor del regalo: su precio de venta. */
+    valueCents?: number;
+    /** @deprecated Usa `valueCents`; trae el mismo valor. */
+    listPriceCents?: number;
     inStock: boolean;
 }
 /** Lo que se entrega al cerrar («Después en la venta»). `quantity`: recargas o meses de garantía. */

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

@@ -8,7 +8,8 @@ export interface SaleLine extends WizardLinePromotionFields {
     sku: string;
     qty: number;
     basePriceCents: number;
-    listPriceCents: number | null;
+    /** @deprecated Ya no se escribe; el valor de un regalo vive en `originalPriceCents`. */
+    listPriceCents?: number | null;
     /** Llave del registro PRICE# del que salió el precio. */
     priceSk: string;
     paymentType: LinePaymentTypeEnum;

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

@@ -1,6 +1,6 @@
 import type { WizardLineRoleEnum } from '../enums/WizardLineRoleEnum';
 import type { WizardReservedLine } from './WizardReservedLine';
-/** Línea GIFT: ligada a un ancla, con su promo y el precio de lista que se regala. */
+/** Línea GIFT: ligada a un ancla, con su promo y el valor del regalo (su precio de venta). */
 export type WizardGiftLine = WizardReservedLine & {
     role: WizardLineRoleEnum.GIFT;
     linkedLineId: string;

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

@@ -11,7 +11,7 @@ export interface WizardLinePromotionFields {
     discountCode?: string;
     /** Descuento total de la línea; neto = basePriceCents × qty − discountCents. */
     discountCents?: number;
-    /** Precio antes del descuento; en un regalo, el valor de lista con la línea a $0. */
+    /** Precio antes del descuento; en un regalo, su precio de venta con la línea a $0. */
     originalPriceCents?: number;
     /** Descuento de cada promo en la línea; sin el campo, la de `promotionId` lleva todo menos el código. */
     promotionDiscounts?: LinePromotionAmount[];

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

@@ -17,7 +17,8 @@ export interface WizardReservedLine extends WizardLinePromotionFields {
     expiresAt: string;
     /** Precio fijado de la línea (el del kit si es kit). */
     basePriceCents: number | null;
-    listPriceCents: number | null;
+    /** @deprecated Ya no se escribe; el valor de un regalo vive en `originalPriceCents`. */
+    listPriceCents?: number | null;
     /** Llave del registro PRICE# del que salió el precio. */
     priceSk: string | null;
     eligibleFinanciers: string[];

package/bin/retailWizard/events/SaleCompletedV1.d.ts

@@ -23,7 +23,7 @@ export interface SaleCompletedV1 {
      * sin `type` un crédito con $1,300 de enganche era indistinguible de un contado de $1,300.
      */
     type?: SaleTypeEnum;
-    /** Precio de lista del equipo; en contado coincide con `amountCents`. Sin equipo se omite. */
+    /** Precio neto del equipo: su precio de venta menos su descuento. Sin equipo se omite. */
     equipmentPriceCents?: number;
     /** Enganche cobrado (solo `type=CREDIT`). */
     downPaymentCents?: number;

package/bin/retailWizard/events/SaleCompletedV2.d.ts

@@ -30,7 +30,7 @@ export interface SaleCompletedV2 {
     imei: string | null;
     /** Lo COBRADO en caja. En contado == precio del equipo; en CREDIT es SOLO el enganche. */
     amountCents: number;
-    /** Precio de lista del equipo — la base de comisión. `null` en ventas sin el dato. */
+    /** Precio neto del equipo (venta menos descuento), la base de comisión. `null` sin el dato. */
     equipmentPriceCents: number | null;
     downPaymentCents: number | null;
     creditId: string | null;

package/package.json

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

package/src/retailCatalog/dtos/Product.ts

@@ -28,7 +28,8 @@ export class Product {
     /** `null` = Sin gama. */
     tier!: ProductTierEnum | null;
     basePriceCents!: number;
-    listPriceCents!: number | null;
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
+    listPriceCents?: number | null;
     eligibleFinanciers!: string[];
     mdmEnabled!: boolean;
     mdmProvider!: MdmProviderEnum | null;

package/src/retailCatalog/dtos/requests/BackofficeCreateSkuPriceRequest.ts

@@ -6,6 +6,7 @@ export class BackofficeCreateSkuPriceRequest {
     @Min(0)
     basePriceCents!: number;
 
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
     @IsOptional()
     @IsInt()
     @Min(0)

package/src/retailCatalog/dtos/requests/CreateProductRequest.ts

@@ -61,6 +61,7 @@ export class CreateProductRequest {
     @Min(0)
     basePriceCents!: number;
 
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
     @IsOptional()
     @IsInt()
     @Min(0)

package/src/retailCatalog/dtos/requests/SyncInventoryRequest.ts

@@ -22,6 +22,7 @@ import { ProductComponent } from '../ProductComponent';
 
 /** Precio de un producto en la puerta de entrada; crea PRICE# solo si cambió el monto. */
 export class SyncPrice {
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
     @IsOptional()
     @IsInt()
     @Min(0)

package/src/retailCatalog/dtos/requests/UpdateProductRequest.ts

@@ -60,6 +60,7 @@ export class UpdateProductRequest {
     @Min(0)
     basePriceCents?: number;
 
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
     @IsOptional()
     @IsInt()
     @Min(0)

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

@@ -69,7 +69,7 @@ export interface InventoryLensSkuItem {
     /** Unidades de este SKU vendidas hoy en esta tienda, **financiadas por SureKeep**. */
     soldTodayUnits: number;
 
-    /** Precio de contado en centavos (`listPriceCents`, o `basePriceCents` si no hay lista). */
+    /** Precio de contado en centavos (`basePriceCents`). */
     cashPriceCents: number;
 }
 

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

@@ -16,7 +16,10 @@ export interface ReservedComponent {
 export interface ReserveStockResponse {
     expiresAt: string;
     basePriceCents: number;
-    listPriceCents: number | null;
+    /** @deprecated Usa `giftValueCents`; en reservas GIFT trae el mismo valor, en las demás `null`. */
+    listPriceCents?: number | null;
+    /** Solo en reservas `purpose: GIFT`: valor del regalo, su precio de venta. */
+    giftValueCents?: number;
     /** Llave del registro PRICE# del que salió el precio fijado. */
     priceSk: string;
     eligibleFinanciers: string[];

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

@@ -3,7 +3,8 @@ import type { PriceSourceEnum } from '../../enums/PriceSourceEnum';
 /** Un registro del historial de precios PRICE# de un SKU. */
 export interface SkuPriceEntry {
     effectiveFrom: string;
-    listPriceCents: number | null;
+    /** @deprecated Ya no se usa; el único precio es `basePriceCents`. */
+    listPriceCents?: number | null;
     basePriceCents: number;
     source: PriceSourceEnum;
     createdBy: string;

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

@@ -38,7 +38,7 @@ export interface StoreCatalogItem {
     itemType?: ItemTypeEnum;
     /** Nombre visible para kits y servicios, que no tienen marca/modelo. */
     description?: string;
-    /** Precio de lista de respaldo para un regalo: el precio vigente o, si no hay, product.basePriceCents. */
+    /** @deprecated Ya no se usa; el valor de un regalo es `basePriceCents`. */
     listPriceCents?: number;
     /** Prioridad de venta de 0 a 100; «Recomendados» ordena por ella. */
     salePriority?: number;

package/src/retailPromotions/dtos/responses/WizardSalePromotionResponses.ts

@@ -46,7 +46,10 @@ export interface ListStoreSalePromotionsResponse {
 export interface GiftOption {
     sku: string;
     name: string;
-    listPriceCents: number;
+    /** Valor del regalo: su precio de venta. */
+    valueCents?: number;
+    /** @deprecated Usa `valueCents`; trae el mismo valor. */
+    listPriceCents?: number;
     inStock: boolean;
 }
 

package/src/retailWizard/dtos/SaleLine.ts

@@ -9,7 +9,8 @@ export interface SaleLine extends WizardLinePromotionFields {
     sku: string;
     qty: number;
     basePriceCents: number;
-    listPriceCents: number | null;
+    /** @deprecated Ya no se escribe; el valor de un regalo vive en `originalPriceCents`. */
+    listPriceCents?: number | null;
     /** Llave del registro PRICE# del que salió el precio. */
     priceSk: string;
     paymentType: LinePaymentTypeEnum;

package/src/retailWizard/dtos/WizardGiftLine.ts

@@ -1,7 +1,7 @@
 import type { WizardLineRoleEnum } from '../enums/WizardLineRoleEnum';
 import type { WizardReservedLine } from './WizardReservedLine';
 
-/** Línea GIFT: ligada a un ancla, con su promo y el precio de lista que se regala. */
+/** Línea GIFT: ligada a un ancla, con su promo y el valor del regalo (su precio de venta). */
 export type WizardGiftLine = WizardReservedLine & {
     role: WizardLineRoleEnum.GIFT;
     linkedLineId: string;

package/src/retailWizard/dtos/WizardLinePromotionFields.ts

@@ -12,7 +12,7 @@ export interface WizardLinePromotionFields {
     discountCode?: string;
     /** Descuento total de la línea; neto = basePriceCents × qty − discountCents. */
     discountCents?: number;
-    /** Precio antes del descuento; en un regalo, el valor de lista con la línea a $0. */
+    /** Precio antes del descuento; en un regalo, su precio de venta con la línea a $0. */
     originalPriceCents?: number;
     /** Descuento de cada promo en la línea; sin el campo, la de `promotionId` lleva todo menos el código. */
     promotionDiscounts?: LinePromotionAmount[];

package/src/retailWizard/dtos/WizardReservedLine.ts

@@ -18,7 +18,8 @@ export interface WizardReservedLine extends WizardLinePromotionFields {
     expiresAt: string;
     /** Precio fijado de la línea (el del kit si es kit). */
     basePriceCents: number | null;
-    listPriceCents: number | null;
+    /** @deprecated Ya no se escribe; el valor de un regalo vive en `originalPriceCents`. */
+    listPriceCents?: number | null;
     /** Llave del registro PRICE# del que salió el precio. */
     priceSk: string | null;
     eligibleFinanciers: string[];

package/src/retailWizard/events/SaleCompletedV1.ts

@@ -24,7 +24,7 @@ export interface SaleCompletedV1 {
    * sin `type` un crédito con $1,300 de enganche era indistinguible de un contado de $1,300.
    */
   type?: SaleTypeEnum;
-  /** Precio de lista del equipo; en contado coincide con `amountCents`. Sin equipo se omite. */
+  /** Precio neto del equipo: su precio de venta menos su descuento. Sin equipo se omite. */
   equipmentPriceCents?: number;
   /** Enganche cobrado (solo `type=CREDIT`). */
   downPaymentCents?: number;

package/src/retailWizard/events/SaleCompletedV2.ts

@@ -31,7 +31,7 @@ export interface SaleCompletedV2 {
     imei: string | null;
     /** Lo COBRADO en caja. En contado == precio del equipo; en CREDIT es SOLO el enganche. */
     amountCents: number;
-    /** Precio de lista del equipo — la base de comisión. `null` en ventas sin el dato. */
+    /** Precio neto del equipo (venta menos descuento), la base de comisión. `null` sin el dato. */
     equipmentPriceCents: number | null;
     downPaymentCents: number | null;
     creditId: string | null;