@fiado/type-kit 3.339.0 → 3.340.0

package/bin/places/dtos/EstablishmentDto.d.ts

@@ -3,7 +3,13 @@ import { CashInNetworkEnum } from '../enums/CashInNetworkEnum';
 import { CashInProviderEnum } from '../enums/CashInProviderEnum';
 import { EstablishmentBrandEnum } from '../enums/EstablishmentBrandEnum';
 /**
- * Establecimiento (punto de cash-in) servido desde el cache de HERE.
+ * Establecimiento (punto de cash-in).
+ *
+ * Es la forma ÚNICA con la que la app ve un punto de cash-in, sin importar de dónde salió:
+ * del cache de HERE (búsqueda por marca) o del directorio en vivo de un proveedor de fondeo.
+ * Quien decide la fuente es la config del lambda, y el cliente no se enfrenta a dos shapes:
+ * los campos que una fuente no puede llenar simplemente vienen ausentes.
+ *
  * Response DTO — sin decoradores de validación.
  */
 export declare class EstablishmentDto {
@@ -25,4 +31,22 @@ export declare class EstablishmentDto {
     country?: CountryId;
     /** Red Passport (OXXO/SUPERMERCADO/TIENDITA). En US no aplica. */
     network?: CashInNetworkEnum;
+    /**
+     * Comisión que el CLIENTE paga EN LA CAJA, encima de su depósito. No es la de Fiado.
+     *
+     * Va en la respuesta para que la app la muestre en el pin ANTES de mandar al cliente a
+     * la tienda: enterarse en el mostrador es la peor forma de enterarse.
+     */
+    cashInFrontFee?: number | null;
+    /** Tope por operación que acepta esa caja. Junto con la comisión, decide si el punto sirve. */
+    maxDepositAmount?: number | null;
+    /** Horario de atención en formato HH:mm, tal como lo informa el proveedor. */
+    openingTime?: string | null;
+    closingTime?: string | null;
+    /** Teléfono del punto. Muchos proveedores no lo informan. */
+    phone?: string | null;
+    /** Logo del comercio, para el pin o el carrusel. */
+    imageUrl?: string | null;
+    /** Imagen de ejemplo del código que el cajero escanea. */
+    sampleQr?: string | null;
 }

package/bin/places/dtos/EstablishmentDto.js

@@ -2,7 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EstablishmentDto = void 0;
 /**
- * Establecimiento (punto de cash-in) servido desde el cache de HERE.
+ * Establecimiento (punto de cash-in).
+ *
+ * Es la forma ÚNICA con la que la app ve un punto de cash-in, sin importar de dónde salió:
+ * del cache de HERE (búsqueda por marca) o del directorio en vivo de un proveedor de fondeo.
+ * Quien decide la fuente es la config del lambda, y el cliente no se enfrenta a dos shapes:
+ * los campos que una fuente no puede llenar simplemente vienen ausentes.
+ *
  * Response DTO — sin decoradores de validación.
  */
 class EstablishmentDto {

package/bin/places/dtos/GetNearbyPlacesResponse.d.ts

@@ -1,13 +1,16 @@
 import { EstablishmentDto } from './EstablishmentDto';
 import { OfficeDto } from '../../offices/dtos/OfficeDto';
-import { FundingStoreItem } from '../../walletFunding/dtos/FundingStoreItem';
 /**
  * Respuesta de la búsqueda unificada. Solo se incluyen los tipos pedidos en `types`.
+ *
+ * Un campo por tipo de lugar, y el campo NO cambia según de dónde salió el dato: si
+ * `cashInMx` se resuelve contra el cache de HERE o contra el directorio en vivo de un
+ * proveedor de fondeo, la app lee el mismo campo con el mismo shape. El ruteo es una
+ * decisión del lambda, no algo que el cliente tenga que interpretar.
  */
 export declare class GetNearbyPlacesResponse {
     cashInUs?: EstablishmentDto[];
     cashInMx?: EstablishmentDto[];
-    cashInMxStores?: FundingStoreItem[];
     officeFiado?: OfficeDto[];
     storeFiado?: OfficeDto[];
 }

package/bin/places/dtos/GetNearbyPlacesResponse.js

@@ -3,6 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetNearbyPlacesResponse = void 0;
 /**
  * Respuesta de la búsqueda unificada. Solo se incluyen los tipos pedidos en `types`.
+ *
+ * Un campo por tipo de lugar, y el campo NO cambia según de dónde salió el dato: si
+ * `cashInMx` se resuelve contra el cache de HERE o contra el directorio en vivo de un
+ * proveedor de fondeo, la app lee el mismo campo con el mismo shape. El ruteo es una
+ * decisión del lambda, no algo que el cliente tenga que interpretar.
  */
 class GetNearbyPlacesResponse {
 }

package/package.json

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

package/src/places/dtos/EstablishmentDto.ts

@@ -4,7 +4,13 @@ import { CashInProviderEnum } from '../enums/CashInProviderEnum';
 import { EstablishmentBrandEnum } from '../enums/EstablishmentBrandEnum';
 
 /**
- * Establecimiento (punto de cash-in) servido desde el cache de HERE.
+ * Establecimiento (punto de cash-in).
+ *
+ * Es la forma ÚNICA con la que la app ve un punto de cash-in, sin importar de dónde salió:
+ * del cache de HERE (búsqueda por marca) o del directorio en vivo de un proveedor de fondeo.
+ * Quien decide la fuente es la config del lambda, y el cliente no se enfrenta a dos shapes:
+ * los campos que una fuente no puede llenar simplemente vienen ausentes.
+ *
  * Response DTO — sin decoradores de validación.
  */
 export class EstablishmentDto {
@@ -27,4 +33,29 @@ export class EstablishmentDto {
     country?: CountryId;
     /** Red Passport (OXXO/SUPERMERCADO/TIENDITA). En US no aplica. */
     network?: CashInNetworkEnum;
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // Datos que sólo informa un directorio en vivo del proveedor (aditivos, opcionales).
+    // El cache de HERE no los tiene: HERE sabe dónde está una tienda, no qué cobra.
+    // `null` = el proveedor los expone pero no informó valor; ausente = la fuente ni los maneja.
+    // ─────────────────────────────────────────────────────────────────────────
+
+    /**
+     * Comisión que el CLIENTE paga EN LA CAJA, encima de su depósito. No es la de Fiado.
+     *
+     * Va en la respuesta para que la app la muestre en el pin ANTES de mandar al cliente a
+     * la tienda: enterarse en el mostrador es la peor forma de enterarse.
+     */
+    cashInFrontFee?: number | null;
+    /** Tope por operación que acepta esa caja. Junto con la comisión, decide si el punto sirve. */
+    maxDepositAmount?: number | null;
+    /** Horario de atención en formato HH:mm, tal como lo informa el proveedor. */
+    openingTime?: string | null;
+    closingTime?: string | null;
+    /** Teléfono del punto. Muchos proveedores no lo informan. */
+    phone?: string | null;
+    /** Logo del comercio, para el pin o el carrusel. */
+    imageUrl?: string | null;
+    /** Imagen de ejemplo del código que el cajero escanea. */
+    sampleQr?: string | null;
 }

package/src/places/dtos/GetNearbyPlacesResponse.ts

@@ -1,14 +1,17 @@
 import { EstablishmentDto } from './EstablishmentDto';
 import { OfficeDto } from '../../offices/dtos/OfficeDto';
-import { FundingStoreItem } from '../../walletFunding/dtos/FundingStoreItem';
 
 /**
  * Respuesta de la búsqueda unificada. Solo se incluyen los tipos pedidos en `types`.
+ *
+ * Un campo por tipo de lugar, y el campo NO cambia según de dónde salió el dato: si
+ * `cashInMx` se resuelve contra el cache de HERE o contra el directorio en vivo de un
+ * proveedor de fondeo, la app lee el mismo campo con el mismo shape. El ruteo es una
+ * decisión del lambda, no algo que el cliente tenga que interpretar.
  */
 export class GetNearbyPlacesResponse {
     cashInUs?: EstablishmentDto[];
     cashInMx?: EstablishmentDto[];
-    cashInMxStores?: FundingStoreItem[];
     officeFiado?: OfficeDto[];
     storeFiado?: OfficeDto[];
 }