@fiado/type-kit 3.444.0 → 3.446.0

package/bin/phoneSales/SaleDeliveryData.d.ts

@@ -0,0 +1,24 @@
+export type PickupLocationType = 'FIADO_STORE' | 'CARRIER_OFFICE';
+export interface FiadoStorePickupData {
+    pickupLocationType: 'FIADO_STORE';
+    storeId: string;
+}
+export interface CarrierOfficePickupData {
+    pickupLocationType: 'CARRIER_OFFICE';
+    carrierOfficeCode: string;
+    latitude: number;
+    longitude: number;
+    recipientName: string;
+    recipientPhone: string;
+}
+export type PickupDeliveryData = FiadoStorePickupData | CarrierOfficePickupData;
+export interface HomeDeliveryData {
+    street: string;
+    addressNumber: string;
+    neighborhood: string;
+    municipality: string;
+    region: string;
+    postalCode: string;
+    recipientName: string;
+    recipientPhone: string;
+}

package/bin/phoneSales/SaleDeliveryData.js

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

package/bin/phoneSales/SaleResponseDto.d.ts

@@ -1,4 +1,5 @@
 import { CurrencyId } from '../currency';
+import { PickupDeliveryData, HomeDeliveryData } from './SaleDeliveryData';
 export declare class SaleResponseDto {
     id: string;
     referenceCode: string;
@@ -6,9 +7,41 @@ export declare class SaleResponseDto {
     buyerDirectorId: string;
     newAccountDirectorId: string | null;
     deliveryType: 'PICKUP' | 'HOME';
+    /**
+     * Dónde había que entregar el dispositivo (retiro en tienda/oficina, u domicilio) —
+     * discriminado por `deliveryType`. Requerido porque `Sale_GT` lo requiere desde que existe la
+     * tabla; ventas con el objeto vacío son datos corruptos de un bug de persistencia ya corregido
+     * (ver memoria `patron-dynamoose-saveunknown-object-anidado`), no un estado válido del contrato.
+     */
+    deliveryData: PickupDeliveryData | HomeDeliveryData;
     trackingCode: string | null;
     providerStatus: string | null;
+    /**
+     * Detalle textual del status reportado por el proveedor de envío (ej. "en camino a sucursal
+     * destino") — DISTINTO de `providerStatus` (arriba), que es el código/estado corto. `null`
+     * porque el conector no siempre lo trae (eventos tempranos del envío).
+     */
+    providerStatusDetail: string | null;
+    /**
+     * Número de rastreo real que ve el comprador — DISTINTO de `trackingCode` (arriba, que es el ID
+     * de correlación interno asignado al CREAR el envío). Este es el que soporte le pasa al
+     * cliente cuando reclama. `null` porque el conector no siempre lo trae.
+     */
+    trackingNumber: string | null;
+    /** URL pública de rastreo del proveedor — mismo motivo de nullability que `trackingNumber`. */
+    trackingUrl: string | null;
+    /** Qué transportadora gestiona el envío — relevante para cuando haya más de un proveedor. */
+    shippingProviderId: string;
+    /**
+     * ID del cobro en transaction-processor-business — el puente para investigar una reclamación de
+     * pago sin buscar a mano en logs por `buyerDirectorId` + ventana de tiempo.
+     */
+    relatedTransaction: string;
     status: string;
+    /** Fecha de compra (epoch ms) — el dato base de cualquier investigación de reclamación. */
+    createdAt: number;
+    /** Última modificación de la venta (epoch ms). */
+    updatedAt: number;
     /**
      * Modelo de la variante (resuelto server-side por `variantId`, incluyendo variantes con
      * stock=0). `null` si la resolución falló (variante borrada o error de infraestructura) — ver

package/bin/phoneSales/index.d.ts

@@ -4,6 +4,7 @@ export * from './CreateDeviceVariantRequestDto';
 export * from './UpdateDeviceVariantRequestDto';
 export * from './CreateSaleRequestDto';
 export * from './SaleResponseDto';
+export * from './SaleDeliveryData';
 export * from './RedeemSaleCodeRequestDto';
 export * from './DeviceVariantImageUploadUrlRequestDto';
 export * from './DeviceVariantImageUploadUrlResponseDto';

package/bin/phoneSales/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./CreateDeviceVariantRequestDto"), exports);
 __exportStar(require("./UpdateDeviceVariantRequestDto"), exports);
 __exportStar(require("./CreateSaleRequestDto"), exports);
 __exportStar(require("./SaleResponseDto"), exports);
+__exportStar(require("./SaleDeliveryData"), exports);
 __exportStar(require("./RedeemSaleCodeRequestDto"), exports);
 __exportStar(require("./DeviceVariantImageUploadUrlRequestDto"), exports);
 __exportStar(require("./DeviceVariantImageUploadUrlResponseDto"), exports);

package/package.json

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

package/src/phoneSales/SaleDeliveryData.ts

@@ -0,0 +1,41 @@
+// Shape de `deliveryData` de una venta de celular. Portado 1:1 (mismos nombres y tipos) desde
+// `cell-phone-sales-business/src/infrastructure/entities/SaleRow.ts` (TD-011, shape CONFIRMADO
+// por el líder técnico, no inferido) — hasta ahora vivía SOLO como interfaces locales del lambda,
+// nunca se había publicado a `@fiado/type-kit`. Se publica acá porque `SaleResponseDto.deliveryData`
+// (agregado para que backoffice pueda investigar reclamaciones sin ir a logs) necesita un tipo real,
+// no `Record<string, unknown>` — y las DTOs de type-kit no pueden depender de tipos locales de un lambda.
+//
+// El retiro en tienda Fiado (`FIADO_STORE`) es un flujo INTERNO que nunca dispara un envío externo;
+// solo el retiro en oficina de transportadora (`CARRIER_OFFICE`) lo hace — por eso la unión
+// discriminada por `pickupLocationType` en vez de un objeto plano con campos opcionales.
+export type PickupLocationType = 'FIADO_STORE' | 'CARRIER_OFFICE';
+
+export interface FiadoStorePickupData {
+  pickupLocationType: 'FIADO_STORE';
+  storeId: string;
+}
+
+// Campos genéricos/agnósticos de proveedor a propósito (`carrierOfficeCode`, no el nombre real del
+// campo de Estafeta): la traducción a los nombres del contrato de cada transportadora vive en el
+// adaptador del lambda (`CreateShippingRequestMapper`), nunca en este tipo compartido.
+export interface CarrierOfficePickupData {
+  pickupLocationType: 'CARRIER_OFFICE';
+  carrierOfficeCode: string;
+  latitude: number;
+  longitude: number;
+  recipientName: string;
+  recipientPhone: string;
+}
+
+export type PickupDeliveryData = FiadoStorePickupData | CarrierOfficePickupData;
+
+export interface HomeDeliveryData {
+  street: string;
+  addressNumber: string;
+  neighborhood: string;
+  municipality: string;
+  region: string;
+  postalCode: string;
+  recipientName: string;
+  recipientPhone: string;
+}

package/src/phoneSales/SaleResponseDto.ts

@@ -1,4 +1,5 @@
 import { CurrencyId } from '../currency';
+import { PickupDeliveryData, HomeDeliveryData } from './SaleDeliveryData';
 
 export class SaleResponseDto {
   id!: string;
@@ -7,9 +8,41 @@ export class SaleResponseDto {
   buyerDirectorId!: string;
   newAccountDirectorId!: string | null;
   deliveryType!: 'PICKUP' | 'HOME';
+  /**
+   * Dónde había que entregar el dispositivo (retiro en tienda/oficina, u domicilio) —
+   * discriminado por `deliveryType`. Requerido porque `Sale_GT` lo requiere desde que existe la
+   * tabla; ventas con el objeto vacío son datos corruptos de un bug de persistencia ya corregido
+   * (ver memoria `patron-dynamoose-saveunknown-object-anidado`), no un estado válido del contrato.
+   */
+  deliveryData!: PickupDeliveryData | HomeDeliveryData;
   trackingCode!: string | null;
   providerStatus!: string | null;
+  /**
+   * Detalle textual del status reportado por el proveedor de envío (ej. "en camino a sucursal
+   * destino") — DISTINTO de `providerStatus` (arriba), que es el código/estado corto. `null`
+   * porque el conector no siempre lo trae (eventos tempranos del envío).
+   */
+  providerStatusDetail!: string | null;
+  /**
+   * Número de rastreo real que ve el comprador — DISTINTO de `trackingCode` (arriba, que es el ID
+   * de correlación interno asignado al CREAR el envío). Este es el que soporte le pasa al
+   * cliente cuando reclama. `null` porque el conector no siempre lo trae.
+   */
+  trackingNumber!: string | null;
+  /** URL pública de rastreo del proveedor — mismo motivo de nullability que `trackingNumber`. */
+  trackingUrl!: string | null;
+  /** Qué transportadora gestiona el envío — relevante para cuando haya más de un proveedor. */
+  shippingProviderId!: string;
+  /**
+   * ID del cobro en transaction-processor-business — el puente para investigar una reclamación de
+   * pago sin buscar a mano en logs por `buyerDirectorId` + ventana de tiempo.
+   */
+  relatedTransaction!: string;
   status!: string;
+  /** Fecha de compra (epoch ms) — el dato base de cualquier investigación de reclamación. */
+  createdAt!: number;
+  /** Última modificación de la venta (epoch ms). */
+  updatedAt!: number;
   /**
    * Modelo de la variante (resuelto server-side por `variantId`, incluyendo variantes con
    * stock=0). `null` si la resolución falló (variante borrada o error de infraestructura) — ver

package/src/phoneSales/index.ts

@@ -4,6 +4,7 @@ export * from './CreateDeviceVariantRequestDto';
 export * from './UpdateDeviceVariantRequestDto';
 export * from './CreateSaleRequestDto';
 export * from './SaleResponseDto';
+export * from './SaleDeliveryData';
 export * from './RedeemSaleCodeRequestDto';
 export * from './DeviceVariantImageUploadUrlRequestDto';
 export * from './DeviceVariantImageUploadUrlResponseDto';