@fiado/type-kit 3.339.0 → 3.341.0

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

@@ -0,0 +1,8 @@
+/**
+ * Formato del identificador de crédito: ULID canónico de 26 chars en Crockford base32.
+ * `loan-credit-business` lo genera con `ulid()`, no con UUID — validar UUID rechaza todos los
+ * créditos reales. Vive en `common` porque lo comparten el contrato de `loanCredit` y el de `mdm`.
+ */
+export declare const CREDIT_ID_PATTERN: RegExp;
+/** Mensaje único, para que el caller no tenga que adivinar el formato. */
+export declare const CREDIT_ID_MESSAGE = "creditId debe ser un ULID de 26 caracteres";

package/bin/common/constants/CreditIdPattern.js

@@ -0,0 +1,11 @@
+"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.
+ * `loan-credit-business` lo genera con `ulid()`, no con UUID — validar UUID rechaza todos los
+ * créditos reales. Vive en `common` porque lo comparten el contrato de `loanCredit` y el de `mdm`.
+ */
+exports.CREDIT_ID_PATTERN = /^[0-7][0-9A-HJKMNP-TV-Z]{25}$/;
+/** Mensaje único, para que el caller no tenga que adivinar el formato. */
+exports.CREDIT_ID_MESSAGE = 'creditId debe ser un ULID de 26 caracteres';

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

@@ -1,7 +1,5 @@
 /**
- * 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.
+ * El formato del `creditId` vive en `common`: lo comparten este contrato y el de `mdm`.
+ * Se re-exporta acá para no romper a quien ya lo importaba desde `loanCredit`.
  */
-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";
+export { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from '../../common/constants/CreditIdPattern';

package/bin/loanCredit/constants/CreditIdPattern.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CREDIT_ID_MESSAGE = exports.CREDIT_ID_PATTERN = void 0;
+exports.CREDIT_ID_PATTERN = exports.CREDIT_ID_MESSAGE = 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.
+ * El formato del `creditId` vive en `common`: lo comparten este contrato y el de `mdm`.
+ * Se re-exporta acá para no romper a quien ya lo importaba desde `loanCredit`.
  */
-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';
+var CreditIdPattern_1 = require("../../common/constants/CreditIdPattern");
+Object.defineProperty(exports, "CREDIT_ID_MESSAGE", { enumerable: true, get: function () { return CreditIdPattern_1.CREDIT_ID_MESSAGE; } });
+Object.defineProperty(exports, "CREDIT_ID_PATTERN", { enumerable: true, get: function () { return CreditIdPattern_1.CREDIT_ID_PATTERN; } });

package/bin/mdm/dtos/DeviceEnrollRequest.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeviceEnrollRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const CreditIdPattern_1 = require("../../common/constants/CreditIdPattern");
 class DeviceEnrollRequest {
 }
 exports.DeviceEnrollRequest = DeviceEnrollRequest;
@@ -41,7 +42,7 @@ __decorate([
 ], DeviceEnrollRequest.prototype, "model", void 0);
 __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)
 ], DeviceEnrollRequest.prototype, "creditId", void 0);
 __decorate([

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.341.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/common/constants/CreditIdPattern.ts

@@ -0,0 +1,9 @@
+/**
+ * Formato del identificador de crédito: ULID canónico de 26 chars en Crockford base32.
+ * `loan-credit-business` lo genera con `ulid()`, no con UUID — validar UUID rechaza todos los
+ * créditos reales. Vive en `common` porque lo comparten el contrato de `loanCredit` y el de `mdm`.
+ */
+export const CREDIT_ID_PATTERN = /^[0-7][0-9A-HJKMNP-TV-Z]{25}$/;
+
+/** Mensaje único, para que el caller no tenga que adivinar el formato. */
+export const CREDIT_ID_MESSAGE = 'creditId debe ser un ULID de 26 caracteres';

package/src/loanCredit/constants/CreditIdPattern.ts

@@ -1,8 +1,5 @@
 /**
- * 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.
+ * El formato del `creditId` vive en `common`: lo comparten este contrato y el de `mdm`.
+ * Se re-exporta acá para no romper a quien ya lo importaba desde `loanCredit`.
  */
-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';
+export { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from '../../common/constants/CreditIdPattern';

package/src/mdm/dtos/DeviceEnrollRequest.ts

@@ -1,5 +1,6 @@
 import { Expose } from "class-transformer";
-import { IsString, IsNotEmpty, IsOptional, IsNumber, IsPositive, IsUUID } from "class-validator";
+import { IsString, IsNotEmpty, IsOptional, IsNumber, IsPositive, Matches } from "class-validator";
+import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from "../../common/constants/CreditIdPattern";
 
 export class DeviceEnrollRequest {
     @Expose()
@@ -23,7 +24,7 @@ export class DeviceEnrollRequest {
     model?: string;
 
     @Expose()
-    @IsUUID()
+    @Matches(CREDIT_ID_PATTERN, { message: CREDIT_ID_MESSAGE })
     creditId: string;
 
     @Expose()

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