@fiado/type-kit 3.195.0 → 3.198.0

package/src/loanScoring/enums/ScoringDecisionEnum.ts

@@ -0,0 +1,14 @@
+/**
+ * Decisión agnóstica del scoring (contrato `ScoringDecision`): el motor de crédito NO sabe qué
+ * proveedor la produjo (regla spec 12).
+ * - `APPROVED`: SCI dentro de un nivel elegible (o ACEPTADO directo de Modelias).
+ * - `REJECTED`: gate anti-fraude no pasó (M7 §2) o RECHAZADO directo del proveedor.
+ * - `NO_ELIGIBLE`: pasó el gate pero el SCI quedó bajo el piso (`SCORING/sci_min_eligible`,
+ *   rango 0-20 de M7 §5) — no se ofrece crédito SureKeep (se puede derivar a financiera externa).
+ * @enum {string}
+ */
+export enum ScoringDecisionEnum {
+    APPROVED = 'APPROVED',
+    REJECTED = 'REJECTED',
+    NO_ELIGIBLE = 'NO_ELIGIBLE',
+}

package/src/loanScoring/enums/ScoringProviderEnum.ts

@@ -0,0 +1,12 @@
+/**
+ * Proveedor de scoring soportado por el `ScoringProviderRouter` de loan-scoring-business
+ * (diagramas F2 §credito · patrón spec 12): la selección es configurable per-tenant y SOLO el
+ * router conoce el proveedor. Extensible: un proveedor nuevo = un valor nuevo + su adapter.
+ * @enum {string}
+ */
+export enum ScoringProviderEnum {
+    /** modelias-connector — devuelve la decisión COMPLETA (score, decisión, línea, enganche, plazos, tasas). */
+    MODELIAS = 'MODELIAS',
+    /** Connector de CONSULTA a Círculo de Crédito — devuelve insumos crudos; el SCI (M7) se calcula local. */
+    CIRCULO = 'CIRCULO',
+}

package/src/loanScoring/index.ts

@@ -0,0 +1,18 @@
+// Enums
+export * from './enums/ScoringProviderEnum';
+export * from './enums/ClientLevelEnum';
+export * from './enums/ScoringDecisionEnum';
+export * from './enums/SciLayer2SourceEnum';
+
+// Contrato agnóstico + shapes compartidos
+export * from './dtos/ScoringDecision';
+export * from './dtos/ScoringOffer';
+export * from './dtos/SciBreakdown';
+
+// Request DTOs
+export * from './dtos/requests/EvaluateSciRequest';
+export * from './dtos/requests/SciInternalHistoryInput';
+
+// Response DTOs
+export * from './dtos/responses/EvaluateSciResponse';
+export * from './dtos/responses/SciEvaluationResponse';

package/src/places/dtos/AddressCandidate.ts

@@ -0,0 +1,23 @@
+/**
+ * Candidato de dirección normalizado, común a búsqueda por texto y reverse geocoding.
+ * Mapea el `Place` de Amazon Location a un shape estable propio de Fiado.
+ * Response DTO — sin decoradores de validación.
+ */
+export class AddressCandidate {
+    /** Etiqueta completa legible (equivalente a Place.Label). */
+    label: string;
+    street?: string;
+    /** Número exterior (Place.AddressNumber). */
+    addressNumber?: string;
+    neighborhood?: string;
+    municipality?: string;
+    /** Estado/provincia (Place.Region). */
+    region?: string;
+    postalCode?: string;
+    /** ISO3 del país (Place.Country). */
+    country?: string;
+    latitude?: number;
+    longitude?: number;
+    /** Relevancia 0..1 (solo búsqueda por texto; ausente en reverse). */
+    relevance?: number;
+}

package/src/places/dtos/ReverseGeocodeRequest.ts

@@ -0,0 +1,23 @@
+import { IsInt, IsNumber, IsOptional, Max, Min } from 'class-validator';
+
+/**
+ * Entrada del reverse geocoding (coordenadas → candidatos de dirección) vía Amazon Location.
+ * Consumido por el endpoint privado de places-business (api-invoker).
+ */
+export class ReverseGeocodeRequest {
+    @IsNumber()
+    @Min(-90)
+    @Max(90)
+    latitude: number;
+
+    @IsNumber()
+    @Min(-180)
+    @Max(180)
+    longitude: number;
+
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    @Max(15)
+    maxResults?: number;
+}

package/src/places/dtos/ReverseGeocodeResponse.ts

@@ -0,0 +1,6 @@
+import { AddressCandidate } from './AddressCandidate';
+
+/** Respuesta del reverse geocoding — candidatos de dirección normalizados. */
+export class ReverseGeocodeResponse {
+    results: AddressCandidate[];
+}

package/src/places/dtos/SearchAddressRequest.ts

@@ -0,0 +1,23 @@
+import { IsArray, IsInt, IsNotEmpty, IsOptional, IsString, Max, Min } from 'class-validator';
+
+/**
+ * Entrada del geocoding por texto (texto libre → candidatos de dirección) vía Amazon Location.
+ * Consumido por el endpoint privado de places-business (api-invoker).
+ */
+export class SearchAddressRequest {
+    @IsString()
+    @IsNotEmpty()
+    text: string;
+
+    /** ISO3 de países a los que acotar la búsqueda (default en el lambda: ['MEX']). */
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    countries?: string[];
+
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    @Max(15)
+    maxResults?: number;
+}

package/src/places/dtos/SearchAddressResponse.ts

@@ -0,0 +1,6 @@
+import { AddressCandidate } from './AddressCandidate';
+
+/** Respuesta del geocoding por texto — candidatos de dirección normalizados. */
+export class SearchAddressResponse {
+    results: AddressCandidate[];
+}

package/src/places/index.ts

@@ -5,6 +5,11 @@ export * from './dtos/GetNearbyPlacesResponse';
 export * from './dtos/ReportPlaceRequest';
 export * from './dtos/ReportedPlaceDto';
 export * from './dtos/ResolveReportedPlaceRequest';
+export * from './dtos/AddressCandidate';
+export * from './dtos/SearchAddressRequest';
+export * from './dtos/SearchAddressResponse';
+export * from './dtos/ReverseGeocodeRequest';
+export * from './dtos/ReverseGeocodeResponse';
 
 //enums
 export * from './enums/CashInNetworkEnum';

package/bin/loanConfig/enums/ModifiableByRoleEnum.d.ts

@@ -1,11 +0,0 @@
-/**
- * Rol RBAC mínimo que puede modificar un parámetro (RBAC a nivel de parámetro, modelo-datos §8).
- * `retailer_admin` = "Admin VentasLuga" de M6 §8. Valores = identificadores de rol de RBAC F0.
- * TD-004: confirmar mapeo super_admin ↔ platform_super_admin con el naming real de F0.
- * @enum {string}
- */
-export declare enum ModifiableByRoleEnum {
-    SUPER_ADMIN = "super_admin",
-    SOFOM_ADMIN = "sofom_admin",
-    RETAILER_ADMIN = "retailer_admin"
-}

package/bin/loanConfig/enums/ModifiableByRoleEnum.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ModifiableByRoleEnum = void 0;
-/**
- * Rol RBAC mínimo que puede modificar un parámetro (RBAC a nivel de parámetro, modelo-datos §8).
- * `retailer_admin` = "Admin VentasLuga" de M6 §8. Valores = identificadores de rol de RBAC F0.
- * TD-004: confirmar mapeo super_admin ↔ platform_super_admin con el naming real de F0.
- * @enum {string}
- */
-var ModifiableByRoleEnum;
-(function (ModifiableByRoleEnum) {
-    ModifiableByRoleEnum["SUPER_ADMIN"] = "super_admin";
-    ModifiableByRoleEnum["SOFOM_ADMIN"] = "sofom_admin";
-    ModifiableByRoleEnum["RETAILER_ADMIN"] = "retailer_admin";
-})(ModifiableByRoleEnum || (exports.ModifiableByRoleEnum = ModifiableByRoleEnum = {}));

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

@@ -1,17 +0,0 @@
-import { CurrencyId } from '../../currency/enums/CurrencyId';
-/**
- * Comisión que cobra un punto de cash-in (lo que el lambda MUESTRA, no cobra).
- * - GreenDot (US): representativo por cadena → `fixed` + `cap` (cada tienda cobra hasta el tope).
- * - Passport (MX): por red → `fixed` + `percentage`.
- * Response DTO — sin decoradores de validación.
- */
-export declare class CashInFeeDto {
-    /** Comisión fija, en la moneda del país. */
-    fixed?: number;
-    /** Porcentaje del monto depositado (0–100). */
-    percentage?: number;
-    /** Tope máximo de comisión (GreenDot: el asociado cobra hasta este cap). */
-    cap?: number;
-    /** Moneda del fee: USD (GreenDot) | MXN (Passport). */
-    currency: CurrencyId;
-}

package/bin/places/dtos/CashInFeeDto.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CashInFeeDto = void 0;
-/**
- * Comisión que cobra un punto de cash-in (lo que el lambda MUESTRA, no cobra).
- * - GreenDot (US): representativo por cadena → `fixed` + `cap` (cada tienda cobra hasta el tope).
- * - Passport (MX): por red → `fixed` + `percentage`.
- * Response DTO — sin decoradores de validación.
- */
-class CashInFeeDto {
-}
-exports.CashInFeeDto = CashInFeeDto;

package/bin/platformRbac/dtos/ResendOtpRequest.d.ts

@@ -1,22 +0,0 @@
-import { MfaMethodEnum } from '../enums/MfaMethodEnum';
-/**
- * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
- * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
- * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
- * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
- * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
- */
-export declare class ResendOtpRequest {
-    email: string;
-    tenantId: string;
-}
-/**
- * Respuesta del resend-otp. `session`/`mfaMethod` frescos del nuevo challenge CUSTOM_AUTH.
- * Plain sin validators (no validamos lo que mandamos al cliente — fiado-validation-and-dtos § 7).
- * Ambos opcionales: en los caminos de rechazo silencioso (anti-enumeración) o ramas sin CUSTOM_AUTH
- * el server responde 200 genérico sin session ni método.
- */
-export interface ResendOtpResponse {
-    session?: string;
-    mfaMethod?: MfaMethodEnum;
-}

package/bin/platformRbac/dtos/ResendSelfRegisterOtpRequest.d.ts

@@ -1,11 +0,0 @@
-/**
- * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
- * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
- * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
- * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
- * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
- */
-export declare class ResendSelfRegisterOtpRequest {
-    tenantId: string;
-    email: string;
-}