@fiado/type-kit 3.338.0 → 3.340.0

package/_test_/unit/loanCredit/dtos/loanDeviceContract.test.ts

@@ -10,12 +10,25 @@ import { LoanDeviceManualUnlockRequest } from '../../../../src/loanCredit/dtos/r
 import { LoanDeviceLockReasonEnum } from '../../../../src/loanCredit/enums/LoanDeviceLockReasonEnum';
 import { LOAN_DEVICE_MAX_BATCH } from '../../../../src/loanCredit/constants/LoanDeviceBatchLimits';
 
-const CREDIT_ID = '5f7c8a90-1234-4abc-9def-0123456789ab';
-const OTHER_CREDIT_ID = '5f7c8a90-1234-4abc-9def-0123456789ac';
+/** ULIDs reales del motor: así es como `LoanCreditService` genera los creditId. */
+const CREDIT_ID = '01M0B5D7FQA3T06K4REEVPRM33';
+const OTHER_CREDIT_ID = '01M0AQFQ69DD6R9SBM9Q4Q6BXV';
+
+/** Un UUID bien formado: era lo que el contrato exigía y hoy tiene que ser rechazado. */
+const A_UUID = '5f7c8a90-1234-4abc-9def-0123456789ab';
+
+const ULID_ALPHABET = '0123456789ABCDEFGHJKMNPQRSTVWXYZ';
 
 /** Genera un creditId válido y distinto por índice, para armar lotes grandes. */
-const creditIdAt = (index: number): string =>
-    `5f7c8a90-1234-4abc-9def-${index.toString(16).padStart(12, '0')}`;
+const creditIdAt = (index: number): string => {
+    let suffix = '';
+    let rest = index;
+    for (let i = 0; i < 5; i++) {
+        suffix = ULID_ALPHABET[rest % 32] + suffix;
+        rest = Math.floor(rest / 32);
+    }
+    return `01M0B5D7FQA3T06K4REEV${suffix}`;
+};
 
 /** True si el error de `property` trae ese constraint puntual (no solo "algo falló"). */
 const hasConstraint = (errors: ValidationError[], property: string, constraint: string): boolean =>
@@ -206,10 +219,10 @@ describe('LoanDeviceManualUnlockRequest', () => {
         expect(errors).toEqual([]);
     });
 
-    it('falla si algún creditId no es UUID', async () => {
+    it('falla si algún creditId no es un ULID', async () => {
         const dto = plainToInstance(LoanDeviceManualUnlockRequest, {
             ...validUnlock,
-            items: [{ creditId: 'no-es-uuid' }],
+            items: [{ creditId: A_UUID }],
         });
         const errors = await validate(dto);
         const itemsError = errors.find(e => e.property === 'items');
@@ -256,8 +269,8 @@ describe.each([
         expect(errors).toEqual([]);
     });
 
-    it('falla si algún creditId no es UUID', async () => {
-        const dto = plainToInstance(RequestClass, { creditIds: [CREDIT_ID, 'no-es-uuid'] });
+    it('falla si algún creditId no es un ULID', async () => {
+        const dto = plainToInstance(RequestClass, { creditIds: [CREDIT_ID, A_UUID] });
         const errors = await validate(dto);
         expect(errors.some(e => e.property === 'creditIds')).toBe(true);
     });

package/bin/loanCredit/constants/CreditIdPattern.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Formato del identificador de crédito: ULID canónico de 26 chars en Crockford base32.
+ * El motor lo genera con `ulid()`, no con UUID — validar UUID rechaza todos los créditos reales.
+ */
+export declare const CREDIT_ID_PATTERN: RegExp;
+/** Mensaje único de los 6 endpoints de dispositivo, para que el caller no adivine el formato. */
+export declare const CREDIT_ID_MESSAGE = "creditId debe ser un ULID de 26 caracteres";

package/bin/loanCredit/constants/CreditIdPattern.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CREDIT_ID_MESSAGE = exports.CREDIT_ID_PATTERN = void 0;
+/**
+ * Formato del identificador de crédito: ULID canónico de 26 chars en Crockford base32.
+ * El motor lo genera con `ulid()`, no con UUID — validar UUID rechaza todos los créditos reales.
+ */
+exports.CREDIT_ID_PATTERN = /^[0-7][0-9A-HJKMNP-TV-Z]{25}$/;
+/** Mensaje único de los 6 endpoints de dispositivo, para que el caller no adivine el formato. */
+exports.CREDIT_ID_MESSAGE = 'creditId debe ser un ULID de 26 caracteres';

package/bin/loanCredit/dtos/LoanDeviceCreditRefItem.js

@@ -12,12 +12,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LoanDeviceCreditRefItem = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const CreditIdPattern_1 = require("../constants/CreditIdPattern");
 /** Ítem que solo referencia un crédito, para las mutaciones que no necesitan más datos. */
 class LoanDeviceCreditRefItem {
 }
 exports.LoanDeviceCreditRefItem = LoanDeviceCreditRefItem;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsUUID)(),
+    (0, class_validator_1.Matches)(CreditIdPattern_1.CREDIT_ID_PATTERN, { message: CreditIdPattern_1.CREDIT_ID_MESSAGE }),
     __metadata("design:type", String)
 ], LoanDeviceCreditRefItem.prototype, "creditId", void 0);

package/bin/loanCredit/dtos/LoanDeviceEnrollItem.js

@@ -13,6 +13,7 @@ exports.LoanDeviceEnrollItem = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const SkuPattern_1 = require("../../retailCatalog/constants/SkuPattern");
+const CreditIdPattern_1 = require("../constants/CreditIdPattern");
 /** Charset y largo del IMEI: exactamente 15 dígitos. */
 const IMEI_PATTERN = /^\d{15}$/;
 /** Plazo máximo del crédito en meses. */
@@ -23,7 +24,7 @@ class LoanDeviceEnrollItem {
 exports.LoanDeviceEnrollItem = LoanDeviceEnrollItem;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsUUID)(),
+    (0, class_validator_1.Matches)(CreditIdPattern_1.CREDIT_ID_PATTERN, { message: CreditIdPattern_1.CREDIT_ID_MESSAGE }),
     __metadata("design:type", String)
 ], LoanDeviceEnrollItem.prototype, "creditId", void 0);
 __decorate([

package/bin/loanCredit/dtos/LoanDeviceManualLockItem.js

@@ -14,13 +14,14 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const LoanDeviceLockReasonEnum_1 = require("../enums/LoanDeviceLockReasonEnum");
 const DeviceLockScreenMessage_1 = require("../../mdm/dtos/DeviceLockScreenMessage");
+const CreditIdPattern_1 = require("../constants/CreditIdPattern");
 /** Ítem de bloqueo manual: qué crédito se bloquea, por qué y con qué mensaje en pantalla. */
 class LoanDeviceManualLockItem {
 }
 exports.LoanDeviceManualLockItem = LoanDeviceManualLockItem;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsUUID)(),
+    (0, class_validator_1.Matches)(CreditIdPattern_1.CREDIT_ID_PATTERN, { message: CreditIdPattern_1.CREDIT_ID_MESSAGE }),
     __metadata("design:type", String)
 ], LoanDeviceManualLockItem.prototype, "creditId", void 0);
 __decorate([

package/bin/loanCredit/dtos/requests/LoanDeviceEnrollStatusRequest.js

@@ -13,6 +13,7 @@ exports.LoanDeviceEnrollStatusRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const LoanDeviceBatchLimits_1 = require("../../constants/LoanDeviceBatchLimits");
+const CreditIdPattern_1 = require("../../constants/CreditIdPattern");
 /** Body de `POST /private/devices/enroll-status` (loan-credit-business). Consulta en lote. */
 class LoanDeviceEnrollStatusRequest {
 }
@@ -23,6 +24,6 @@ __decorate([
     (0, class_validator_1.ArrayNotEmpty)(),
     (0, class_validator_1.ArrayMaxSize)(LoanDeviceBatchLimits_1.LOAN_DEVICE_MAX_BATCH),
     (0, class_validator_1.ArrayUnique)(),
-    (0, class_validator_1.IsUUID)(undefined, { each: true }),
+    (0, class_validator_1.Matches)(CreditIdPattern_1.CREDIT_ID_PATTERN, { each: true, message: CreditIdPattern_1.CREDIT_ID_MESSAGE }),
     __metadata("design:type", Array)
 ], LoanDeviceEnrollStatusRequest.prototype, "creditIds", void 0);

package/bin/loanCredit/dtos/requests/LoanDeviceLastSeenRequest.js

@@ -13,6 +13,7 @@ exports.LoanDeviceLastSeenRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const LoanDeviceBatchLimits_1 = require("../../constants/LoanDeviceBatchLimits");
+const CreditIdPattern_1 = require("../../constants/CreditIdPattern");
 /** Body de `POST /private/devices/last-seen` (loan-credit-business). Consulta en lote. */
 class LoanDeviceLastSeenRequest {
 }
@@ -23,6 +24,6 @@ __decorate([
     (0, class_validator_1.ArrayNotEmpty)(),
     (0, class_validator_1.ArrayMaxSize)(LoanDeviceBatchLimits_1.LOAN_DEVICE_MAX_BATCH),
     (0, class_validator_1.ArrayUnique)(),
-    (0, class_validator_1.IsUUID)(undefined, { each: true }),
+    (0, class_validator_1.Matches)(CreditIdPattern_1.CREDIT_ID_PATTERN, { each: true, message: CreditIdPattern_1.CREDIT_ID_MESSAGE }),
     __metadata("design:type", Array)
 ], LoanDeviceLastSeenRequest.prototype, "creditIds", void 0);

package/bin/loanCredit/dtos/requests/LoanDeviceStatusRequest.js

@@ -13,6 +13,7 @@ exports.LoanDeviceStatusRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const LoanDeviceBatchLimits_1 = require("../../constants/LoanDeviceBatchLimits");
+const CreditIdPattern_1 = require("../../constants/CreditIdPattern");
 /** Body de `POST /private/devices/status` (loan-credit-business). Consulta en lote. */
 class LoanDeviceStatusRequest {
 }
@@ -23,6 +24,6 @@ __decorate([
     (0, class_validator_1.ArrayNotEmpty)(),
     (0, class_validator_1.ArrayMaxSize)(LoanDeviceBatchLimits_1.LOAN_DEVICE_MAX_BATCH),
     (0, class_validator_1.ArrayUnique)(),
-    (0, class_validator_1.IsUUID)(undefined, { each: true }),
+    (0, class_validator_1.Matches)(CreditIdPattern_1.CREDIT_ID_PATTERN, { each: true, message: CreditIdPattern_1.CREDIT_ID_MESSAGE }),
     __metadata("design:type", Array)
 ], LoanDeviceStatusRequest.prototype, "creditIds", void 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.338.0",
+  "version": "3.340.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/loanCredit/constants/CreditIdPattern.ts

@@ -0,0 +1,8 @@
+/**
+ * Formato del identificador de crédito: ULID canónico de 26 chars en Crockford base32.
+ * El motor lo genera con `ulid()`, no con UUID — validar UUID rechaza todos los créditos reales.
+ */
+export const CREDIT_ID_PATTERN = /^[0-7][0-9A-HJKMNP-TV-Z]{25}$/;
+
+/** Mensaje único de los 6 endpoints de dispositivo, para que el caller no adivine el formato. */
+export const CREDIT_ID_MESSAGE = 'creditId debe ser un ULID de 26 caracteres';

package/src/loanCredit/dtos/LoanDeviceCreditRefItem.ts

@@ -1,9 +1,10 @@
 import { Expose } from 'class-transformer';
-import { IsUUID } from 'class-validator';
+import { Matches } from 'class-validator';
+import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from '../constants/CreditIdPattern';
 
 /** Ítem que solo referencia un crédito, para las mutaciones que no necesitan más datos. */
 export class LoanDeviceCreditRefItem {
     @Expose()
-    @IsUUID()
+    @Matches(CREDIT_ID_PATTERN, { message: CREDIT_ID_MESSAGE })
     creditId: string;
 }

package/src/loanCredit/dtos/LoanDeviceEnrollItem.ts

@@ -1,6 +1,7 @@
 import { Expose } from 'class-transformer';
-import { IsISO8601, IsInt, IsNotEmpty, IsOptional, IsPositive, IsString, IsUUID, Matches, Max, MaxLength } from 'class-validator';
+import { IsISO8601, IsInt, IsNotEmpty, IsOptional, IsPositive, IsString, Matches, Max, MaxLength } from 'class-validator';
 import { SKU_PATTERN } from '../../retailCatalog/constants/SkuPattern';
+import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from '../constants/CreditIdPattern';
 
 /** Charset y largo del IMEI: exactamente 15 dígitos. */
 const IMEI_PATTERN = /^\d{15}$/;
@@ -11,7 +12,7 @@ const MAX_TERM_MONTHS = 60;
 /** Ítem de enrolamiento: un crédito con el equipo que se va a enrolar en el MDM. */
 export class LoanDeviceEnrollItem {
     @Expose()
-    @IsUUID()
+    @Matches(CREDIT_ID_PATTERN, { message: CREDIT_ID_MESSAGE })
     creditId: string;
 
     @Expose()

package/src/loanCredit/dtos/LoanDeviceManualLockItem.ts

@@ -1,12 +1,13 @@
 import { Expose, Type } from 'class-transformer';
-import { IsEnum, IsOptional, IsUUID, ValidateNested } from 'class-validator';
+import { IsEnum, IsOptional, Matches, ValidateNested } from 'class-validator';
 import { LoanDeviceLockReasonEnum } from '../enums/LoanDeviceLockReasonEnum';
 import { DeviceLockScreenMessage } from '../../mdm/dtos/DeviceLockScreenMessage';
+import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from '../constants/CreditIdPattern';
 
 /** Ítem de bloqueo manual: qué crédito se bloquea, por qué y con qué mensaje en pantalla. */
 export class LoanDeviceManualLockItem {
     @Expose()
-    @IsUUID()
+    @Matches(CREDIT_ID_PATTERN, { message: CREDIT_ID_MESSAGE })
     creditId: string;
 
     @Expose()

package/src/loanCredit/dtos/requests/LoanDeviceEnrollStatusRequest.ts

@@ -1,6 +1,7 @@
 import { Expose } from 'class-transformer';
-import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, IsUUID } from 'class-validator';
+import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, Matches } from 'class-validator';
 import { LOAN_DEVICE_MAX_BATCH } from '../../constants/LoanDeviceBatchLimits';
+import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from '../../constants/CreditIdPattern';
 
 /** Body de `POST /private/devices/enroll-status` (loan-credit-business). Consulta en lote. */
 export class LoanDeviceEnrollStatusRequest {
@@ -9,6 +10,6 @@ export class LoanDeviceEnrollStatusRequest {
     @ArrayNotEmpty()
     @ArrayMaxSize(LOAN_DEVICE_MAX_BATCH)
     @ArrayUnique()
-    @IsUUID(undefined, { each: true })
+    @Matches(CREDIT_ID_PATTERN, { each: true, message: CREDIT_ID_MESSAGE })
     creditIds: string[];
 }

package/src/loanCredit/dtos/requests/LoanDeviceLastSeenRequest.ts

@@ -1,6 +1,7 @@
 import { Expose } from 'class-transformer';
-import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, IsUUID } from 'class-validator';
+import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, Matches } from 'class-validator';
 import { LOAN_DEVICE_MAX_BATCH } from '../../constants/LoanDeviceBatchLimits';
+import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from '../../constants/CreditIdPattern';
 
 /** Body de `POST /private/devices/last-seen` (loan-credit-business). Consulta en lote. */
 export class LoanDeviceLastSeenRequest {
@@ -9,6 +10,6 @@ export class LoanDeviceLastSeenRequest {
     @ArrayNotEmpty()
     @ArrayMaxSize(LOAN_DEVICE_MAX_BATCH)
     @ArrayUnique()
-    @IsUUID(undefined, { each: true })
+    @Matches(CREDIT_ID_PATTERN, { each: true, message: CREDIT_ID_MESSAGE })
     creditIds: string[];
 }

package/src/loanCredit/dtos/requests/LoanDeviceStatusRequest.ts

@@ -1,6 +1,7 @@
 import { Expose } from 'class-transformer';
-import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, IsUUID } from 'class-validator';
+import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, Matches } from 'class-validator';
 import { LOAN_DEVICE_MAX_BATCH } from '../../constants/LoanDeviceBatchLimits';
+import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from '../../constants/CreditIdPattern';
 
 /** Body de `POST /private/devices/status` (loan-credit-business). Consulta en lote. */
 export class LoanDeviceStatusRequest {
@@ -9,6 +10,6 @@ export class LoanDeviceStatusRequest {
     @ArrayNotEmpty()
     @ArrayMaxSize(LOAN_DEVICE_MAX_BATCH)
     @ArrayUnique()
-    @IsUUID(undefined, { each: true })
+    @Matches(CREDIT_ID_PATTERN, { each: true, message: CREDIT_ID_MESSAGE })
     creditIds: string[];
 }

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[];
 }