@fiado/type-kit 3.1.28 → 3.2.0

package/src/creditBackoffice/dtos/BackofficeApplicationDetail.ts

@@ -0,0 +1,33 @@
+/**
+ * Row de aplicación de crédito (schema espejo de `CreditApplications_GT`).
+ * Inline aquí porque los DTOs son contratos públicos y no deben depender de
+ * tipos de infra en el repo de cada lambda.
+ */
+export class BackofficeCreditApplicationRow {
+    pk!: string;
+    sk!: string;
+    application_id?: string;
+    directory_id?: string;
+    partner_id?: string;
+    offer_id?: string;
+    status?: string;
+    amount_mxn?: number;
+    term_weeks?: number;
+    annual_rate?: number;
+    weekly_payment_mxn?: number;
+    cat?: number;
+    first_payment_date?: string;
+    contract_view_url?: string;
+    expires_at?: string;
+    signed_at?: string;
+    created_at?: string;
+    updated_at?: string;
+    /** Runtime fields set by managers but not declared in the Dynamoose schema. */
+    credit_level?: string;
+    config_version?: number;
+}
+
+export class BackofficeApplicationDetail {
+    application!: BackofficeCreditApplicationRow;
+    user!: { directory_id: string; phone_number: string; people_id: string };
+}

package/src/creditBackoffice/dtos/BackofficeApplicationsListItem.ts

@@ -0,0 +1,11 @@
+export class BackofficeApplicationsListItem {
+    application_id!: string;
+    directory_id!: string;
+    partner_id!: string;
+    phone_number!: string;
+    amount_mxn!: number;
+    term_weeks!: number;
+    status!: string;
+    signed_at!: string;
+    created_at!: string;
+}

package/src/creditBackoffice/dtos/BackofficeCreditDetail.ts

@@ -0,0 +1,78 @@
+/**
+ * Row de crédito (schema espejo de `Credits_GT`).
+ * Inline aquí porque los DTOs son contratos públicos y no deben depender de
+ * tipos de infra en el repo de cada lambda.
+ */
+export class BackofficeCreditRow {
+    pk!: string;
+    sk!: string;
+    credit_id!: string;
+    application_id?: string;
+    directory_id?: string;
+    partner_id?: string;
+    status?: string;
+    amount_mxn?: number;
+    term_weeks?: number;
+    annual_rate?: number;
+    weekly_payment_mxn?: number;
+    cat?: number;
+    total_interest_mxn?: number;
+    total_payable_mxn?: number;
+    total_iva_mxn?: number;
+    iva_rate?: number;
+    fiado_rate_points?: number;
+    loanco_rate_points?: number;
+    fiado_interest_mxn?: number;
+    loanco_interest_mxn?: number;
+    credit_level?: string;
+    disbursed_at?: string;
+    first_payment_date?: string;
+    total_collected_mxn?: number;
+    outstanding_balance_mxn?: number;
+    last_payment_date?: string;
+    created_at?: string;
+    updated_at?: string;
+    /** Runtime fields set by managers but not declared in the Dynamoose schema. */
+    config_version?: number;
+    signed_at?: string;
+}
+
+/**
+ * Row del calendario de pagos (schema espejo de `CreditPaymentSchedule_GT`).
+ * Inline aquí porque los DTOs son contratos públicos.
+ */
+export class BackofficeCreditPaymentScheduleRow {
+    pk!: string;
+    sk!: string;
+    credit_id?: string;
+    coupon_number!: number;
+    due_date?: string;
+    principal_mxn?: number;
+    interest_mxn?: number;
+    iva_mxn?: number;
+    total_mxn?: number;
+    fiado_interest_mxn?: number;
+    loanco_interest_mxn?: number;
+    remaining_balance_mxn?: number;
+    status?: string;
+    paid_amount_mxn?: number;
+    principal_collected_mxn?: number;
+    interest_collected_mxn?: number;
+    iva_collected_mxn?: number;
+    fiado_interest_collected_mxn?: number;
+    loanco_interest_collected_mxn?: number;
+    anticipated_reduction_mxn?: number;
+    collection_attempts?: number;
+    last_collection_date?: string;
+    paid_at?: string;
+    created_at?: string;
+    updated_at?: string;
+    /** Runtime field used during settlement. */
+    settlement_adjustment_mxn?: number;
+}
+
+export class BackofficeCreditDetail {
+    credit!: BackofficeCreditRow;
+    user!: { directory_id: string; phone_number: string; people_id: string };
+    schedule!: BackofficeCreditPaymentScheduleRow[];
+}

package/src/creditBackoffice/dtos/BackofficeCreditsListItem.ts

@@ -0,0 +1,14 @@
+export class BackofficeCreditsListItem {
+    credit_id!: string;
+    directory_id!: string;
+    partner_id!: string;
+    phone_number!: string;
+    amount_mxn!: number;
+    term_weeks!: number;
+    annual_rate!: number;
+    weekly_payment_mxn!: number;
+    status!: string;
+    credit_level!: string;
+    disbursed_at!: string;
+    created_at!: string;
+}

package/src/creditBackoffice/dtos/BackofficeIncomeSourceItem.ts

@@ -0,0 +1,13 @@
+export class BackofficeIncomeSourceItem {
+    normalized_memo!: string;
+    classification!: string;
+    detected_frequency!: string;
+    total_deposits_90d!: number;
+    total_amount_90d_usd!: number;
+    average_amount_usd!: number;
+    reliable_amount_usd!: number;
+    income_share_pct!: number;
+    avg_days_between_deposits!: number;
+    first_detection!: string;
+    last_detection!: string;
+}

package/src/creditBackoffice/dtos/BackofficeOfferDetail.ts

@@ -0,0 +1,29 @@
+/**
+ * Row de oferta de crédito (schema espejo de `CreditOffers_GT`).
+ * Inline aquí porque los DTOs son contratos públicos y no deben depender de
+ * tipos de infra en el repo de cada lambda.
+ */
+export class BackofficeCreditOfferRow {
+    pk!: string;
+    sk!: string;
+    offer_id?: string;
+    directory_id?: string;
+    partner_id?: string;
+    status?: string;
+    credit_level?: string;
+    max_amount_mxn?: number;
+    selected_amount_mxn?: number;
+    offer_expires_at?: string;
+    options?: Record<string, unknown>[];
+    created_at?: string;
+    updated_at?: string;
+    /** Runtime fields set by managers but not declared in the Dynamoose schema. */
+    min_amount_mxn?: number;
+    available_rates?: { term_weeks: number; annual_rate: number }[];
+    config_version?: number;
+}
+
+export class BackofficeOfferDetail {
+    offer!: BackofficeCreditOfferRow;
+    user!: { directory_id: string; phone_number: string; people_id: string };
+}

package/src/creditBackoffice/dtos/BackofficeOffersListItem.ts

@@ -0,0 +1,13 @@
+export class BackofficeOffersListItem {
+    offer_id!: string;
+    directory_id!: string;
+    partner_id!: string;
+    phone_number!: string;
+    credit_level!: string;
+    max_amount_mxn!: number;
+    min_amount_mxn!: number;
+    available_rates!: { term_weeks: number; annual_rate: number }[];
+    status!: string;
+    offer_expires_at!: string;
+    created_at!: string;
+}

package/src/creditBackoffice/dtos/BackofficePagination.ts

@@ -0,0 +1,6 @@
+export class BackofficePagination {
+    page!: number;
+    page_size!: number;
+    total_items!: number;
+    total_pages!: number;
+}

package/src/creditBackoffice/dtos/BackofficePipeline.ts

@@ -0,0 +1,9 @@
+import { BackofficePipelineByLevel } from "./BackofficePipelineByLevel";
+
+export class BackofficePipeline {
+    eligible_count!: number;
+    total_potential_mxn!: number;
+    avg_potential_mxn!: number;
+    by_level!: BackofficePipelineByLevel[];
+    by_banner_state!: { state: string; count: number }[];
+}

package/src/creditBackoffice/dtos/BackofficePipelineByLevel.ts

@@ -0,0 +1,6 @@
+export class BackofficePipelineByLevel {
+    level!: string;
+    count!: number;
+    total_potential_mxn!: number;
+    avg_potential_mxn!: number;
+}

package/src/creditBackoffice/dtos/BackofficeProfileDetail.ts

@@ -0,0 +1,79 @@
+/**
+ * Detalle de perfil enriquecido con información de directorio.
+ *
+ * Nota: en el lambda este tipo es una intersección de `CreditFinancialProfileRow` con
+ * `{ people_id, phone_number }`. Aquí se inlinea todo el shape del profile para no
+ * depender de tipos de infra.
+ */
+export class BackofficeProfileDetail {
+    pk?: string;
+    sk?: string;
+    directory_id?: string;
+    partner_id?: string;
+    calculation_date?: string;
+    // Income
+    total_income_sources?: number;
+    primary_sources?: number;
+    secondary_sources?: number;
+    has_regular_income?: string;
+    total_income_90d_usd?: number;
+    monthly_income_usd?: number;
+    primary_income_usd?: number;
+    secondary_income_usd?: number;
+    dominant_frequency?: string;
+    days_since_last_deposit?: number;
+    primary_amount_variation_pct?: number;
+    // Expenses
+    total_expenses_90d_usd?: number;
+    monthly_expenses_usd?: number;
+    expense_income_ratio?: number;
+    // Wallet loads
+    sends_to_mexico_wallet?: string;
+    total_wallet_loads_90d_usd?: number;
+    monthly_wallet_loads_usd?: number;
+    wallet_load_count_90d?: number;
+    avg_wallet_load_usd?: number;
+    wallet_load_income_ratio?: number;
+    days_since_last_wallet_load?: number;
+    wallet_load_frequency?: string;
+    // Balance
+    current_balance_usd?: number;
+    average_balance_90d_usd?: number;
+    balance_income_ratio?: number;
+    // Seniority
+    registration_date?: string;
+    months_in_platform?: number;
+    // Exchange rate
+    exchange_rate_usd_mxn?: number;
+    monthly_income_mxn?: number;
+    // Scores
+    score_income_stability?: number;
+    score_payment_capacity?: number;
+    score_mexico_transfers?: number;
+    score_seniority?: number;
+    score_income_level?: number;
+    score_total?: number;
+    // Level & Credit
+    credit_level?: string;
+    max_credit_amount_mxn?: number;
+    has_active_credit?: string;
+    is_eligible?: string;
+    ineligibility_reason?: string;
+    // Gamification
+    score_to_next_level?: number;
+    next_level?: string;
+    next_level_max_credit_mxn?: number;
+    progress_pct?: number;
+    recommendation_1?: string;
+    recommendation_1_points?: number;
+    recommendation_2?: string;
+    recommendation_2_points?: number;
+    last_level_change_date?: string;
+    level_change_direction?: string;
+    // Audit
+    created_at?: string;
+    updated_at?: string;
+    // Directory enrichment
+    people_id!: string | null;
+    phone_number!: string | null;
+}

package/src/creditBackoffice/dtos/BackofficeProfilesListItem.ts

@@ -0,0 +1,17 @@
+export class BackofficeProfilesListItem {
+    directory_id!: string;
+    partner_id!: string;
+    phone_number!: string;
+    credit_level!: string;
+    score_total!: number;
+    is_eligible!: string;
+    ineligibility_reason!: string | null;
+    max_credit_amount_mxn!: number;
+    monthly_income_mxn!: number;
+    has_regular_income!: string;
+    dominant_frequency!: string;
+    total_income_sources!: number;
+    days_since_last_deposit!: number;
+    calculation_date!: string;
+    banner_state!: string;
+}

package/src/creditBackoffice/dtos/BackofficeProfilesListResponse.ts

@@ -0,0 +1,7 @@
+import { BackofficeProfilesListItem } from "./BackofficeProfilesListItem";
+import { BackofficePagination } from "./BackofficePagination";
+
+export class BackofficeProfilesListResponse {
+    items!: BackofficeProfilesListItem[];
+    pagination!: BackofficePagination;
+}

package/src/creditBackoffice/dtos/BackofficeProfilesSummary.ts

@@ -0,0 +1,12 @@
+import { BackofficePipeline } from "./BackofficePipeline";
+
+export class BackofficeProfilesSummary {
+    total_profiles!: number;
+    eligible_count!: number;
+    ineligible_count!: number;
+    by_level!: { level: string; count: number; eligible: number; ineligible: number }[];
+    score_distribution!: { range: string; count: number }[];
+    avg_score!: number;
+    avg_max_credit_mxn!: number;
+    pipeline!: BackofficePipeline;
+}

package/src/creditBackoffice/dtos/ConfigSnapshotListItem.ts

@@ -0,0 +1,10 @@
+/**
+ * Item de lista de snapshots de configuración.
+ */
+export class ConfigSnapshotListItem {
+    version?: number;
+    created_at?: string;
+    created_by?: string;
+    description?: string;
+    config_type_changed?: string;
+}

package/src/creditBackoffice/dtos/SimulateImpactRequest.ts

@@ -0,0 +1,18 @@
+import { IsArray, IsNotEmpty, IsString } from "class-validator";
+
+/**
+ * Request para simular el impacto de un cambio de configuración contra el universo de clientes.
+ * Endpoint: POST /backoffice/config/simulate-impact
+ */
+export class SimulateImpactRequest {
+    @IsString()
+    @IsNotEmpty()
+    partnerId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    configType!: string;
+
+    @IsArray()
+    proposedConfig!: Array<Record<string, unknown>>;
+}

package/src/creditBackoffice/dtos/SimulateImpactResult.ts

@@ -0,0 +1,41 @@
+/**
+ * Resultado de simulación de impacto de un cambio de configuración.
+ */
+export class SimulateImpactStateSnapshot {
+    total_profiles!: number;
+    eligible_count!: number;
+    eligible_pct!: number;
+    by_level!: Record<string, number>;
+    potential_portfolio_mxn!: number;
+    avg_score!: number;
+    avg_ticket_mxn!: number;
+}
+
+export class SimulateImpactMigration {
+    directory_id?: string;
+    score_before!: number;
+    score_after!: number;
+    level_before!: string;
+    level_after!: string;
+    eligible_before!: boolean;
+    eligible_after!: boolean;
+}
+
+export class SimulateImpactResult {
+    before!: SimulateImpactStateSnapshot;
+    after!: SimulateImpactStateSnapshot;
+    delta!: {
+        eligible_count: number;
+        eligible_pct: number;
+        potential_portfolio_mxn: number;
+        avg_score: number;
+        level_migrations: { upgrades: number; downgrades: number; unchanged: number };
+        eligibility_changes: { became_eligible: number; lost_eligibility: number; unchanged: number };
+    };
+    migrations!: SimulateImpactMigration[];
+}
+
+export class SimulateImpactError {
+    error!: string;
+    total_profiles!: number;
+}

package/src/creditBackoffice/dtos/SimulateInterestRequest.ts

@@ -0,0 +1,15 @@
+import { IsNotEmpty, IsNumber, IsString, Min } from "class-validator";
+
+/**
+ * Request para simular el cálculo de intereses con la configuración actual.
+ * Endpoint: POST /backoffice/config/simulate
+ */
+export class SimulateInterestRequest {
+    @IsString()
+    @IsNotEmpty()
+    partnerId!: string;
+
+    @IsNumber()
+    @Min(1)
+    amount_mxn!: number;
+}

package/src/creditBackoffice/dtos/SimulateInterestResult.ts

@@ -0,0 +1,11 @@
+import { CreditOfferOptionItem } from "../../credit/dtos/CreditOfferOptionItem";
+
+/**
+ * Resultado de simulación de interés para un monto dado.
+ */
+export class SimulateInterestResult {
+    amount_mxn!: number;
+    partner_id!: string;
+    simulated_at!: string;
+    options!: CreditOfferOptionItem[];
+}

package/src/creditBackoffice/dtos/UpdateConfigRequest.ts

@@ -0,0 +1,23 @@
+import { ArrayNotEmpty, IsArray, IsNotEmpty, IsOptional, IsString } from "class-validator";
+
+/**
+ * Request para actualizar una configuración de política de crédito.
+ * Endpoint: PUT /backoffice/config/{configType}
+ */
+export class UpdateConfigRequest {
+    @IsString()
+    @IsNotEmpty()
+    partnerId!: string;
+
+    @IsArray()
+    @ArrayNotEmpty()
+    items!: Array<Record<string, unknown>>;
+
+    @IsOptional()
+    @IsString()
+    updatedBy?: string;
+
+    @IsOptional()
+    @IsString()
+    description?: string;
+}

package/src/creditBackoffice/enums/ConfigType.ts

@@ -0,0 +1,17 @@
+/**
+ * Tipos de configuración de política de crédito que expone el backoffice.
+ * Los valores son los `sk` (sin el prefijo) de las tablas de config en DynamoDB.
+ *
+ * Se ubica en domain porque es contrato del API (path parameter público) y concepto
+ * de negocio — no un detalle de persistencia.
+ */
+export enum ConfigType {
+    ELIGIBILITY_RULES = "eligibility-rules",
+    CREDIT_LEVELS = "credit-levels",
+    INTEREST_RATES = "interest-rates",
+    SPLIT = "split",
+    EXPOSURE_LIMITS = "exposure-limits",
+    SCORES = "scores",
+    BANK_ACCOUNTS = "bank-accounts",
+    OPERATIONAL_PARAMS = "operational-params",
+}

package/src/creditBackoffice/index.ts

@@ -0,0 +1,24 @@
+// Enums
+export * from './enums/ConfigType';
+
+// DTOs
+export * from './dtos/BackofficeApplicationDetail';
+export * from './dtos/BackofficeApplicationsListItem';
+export * from './dtos/BackofficeCreditDetail';
+export * from './dtos/BackofficeCreditsListItem';
+export * from './dtos/BackofficeIncomeSourceItem';
+export * from './dtos/BackofficeOfferDetail';
+export * from './dtos/BackofficeOffersListItem';
+export * from './dtos/BackofficePagination';
+export * from './dtos/BackofficePipeline';
+export * from './dtos/BackofficePipelineByLevel';
+export * from './dtos/BackofficeProfileDetail';
+export * from './dtos/BackofficeProfilesListItem';
+export * from './dtos/BackofficeProfilesListResponse';
+export * from './dtos/BackofficeProfilesSummary';
+export * from './dtos/ConfigSnapshotListItem';
+export * from './dtos/SimulateImpactRequest';
+export * from './dtos/SimulateImpactResult';
+export * from './dtos/SimulateInterestRequest';
+export * from './dtos/SimulateInterestResult';
+export * from './dtos/UpdateConfigRequest';

package/src/creditDashboard/dtos/CohortQualityItem.ts

@@ -0,0 +1,8 @@
+export class CohortQualityItem {
+    cohort_month!: string;
+    total_credits!: number;
+    active_pct!: number;
+    delinquent_pct!: number;
+    paid_off_pct!: number;
+    default_pct!: number;
+}

package/src/creditDashboard/dtos/DashboardSummary.ts

@@ -0,0 +1,8 @@
+export class DashboardSummary {
+    total_active_credits!: number;
+    total_disbursed_mxn!: number;
+    total_applications_pending!: number;
+    total_active_offers!: number;
+    avg_credit_amount_mxn!: number;
+    avg_term_weeks!: number;
+}

package/src/creditDashboard/dtos/NurturingFunnelItem.ts

@@ -0,0 +1,5 @@
+export class NurturingFunnelItem {
+    stage!: string;
+    count!: number;
+    conversion_rate_pct!: number;
+}

package/src/creditDashboard/dtos/OriginationCompositionResult.ts

@@ -0,0 +1,5 @@
+export class OriginationCompositionResult {
+    by_level!: { level: string; count: number; pct: number }[];
+    by_term!: { term_weeks: number; count: number; pct: number }[];
+    avg_annual_rate!: number;
+}

package/src/creditDashboard/dtos/OriginationEfficiencyResult.ts

@@ -0,0 +1,8 @@
+export class OriginationEfficiencyResult {
+    avg_days_to_disburse!: number;
+    offers_expired_pct!: number;
+    offers_abandoned_pct!: number;
+    total_offers!: number;
+    total_expired!: number;
+    total_abandoned!: number;
+}

package/src/creditDashboard/dtos/OriginationMonthlyItem.ts

@@ -0,0 +1,6 @@
+export class OriginationMonthlyItem {
+    month!: string;
+    credits_originated!: number;
+    total_amount_mxn!: number;
+    avg_amount_mxn!: number;
+}

package/src/creditDashboard/dtos/OriginationSummaryResult.ts

@@ -0,0 +1,6 @@
+export class OriginationSummaryResult {
+    credits_originated!: number;
+    total_amount_mxn!: number;
+    avg_amount_mxn!: number;
+    month!: string;
+}

package/src/creditDashboard/dtos/OriginationWeeklyItem.ts

@@ -0,0 +1,7 @@
+export class OriginationWeeklyItem {
+    week!: string;
+    credits_originated!: number;
+    total_amount_mxn!: number;
+    avg_amount_mxn!: number;
+    avg_term_weeks!: number;
+}

package/src/creditDashboard/dtos/PipelineLevelRow.ts

@@ -0,0 +1,10 @@
+export class PipelineLevelRow {
+    level!: string;
+    offers!: { count: number; amount_mxn: number; avg_mxn: number };
+    applications!: { count: number; amount_mxn: number; avg_mxn: number };
+    credits!: { count: number; amount_mxn: number; avg_mxn: number };
+    conversion_pct!: number;
+    credit_status!: { active_pct: number; paid_off_pct: number; delinquent_pct: number };
+    avg_term_weeks!: number;
+    avg_annual_rate!: number;
+}

package/src/creditDashboard/dtos/PipelineWeek.ts

@@ -0,0 +1,7 @@
+import { PipelineLevelRow } from "./PipelineLevelRow";
+
+export class PipelineWeek {
+    week!: string;
+    total!: PipelineLevelRow;
+    levels!: PipelineLevelRow[];
+}

package/src/creditDashboard/dtos/PortfolioActiveItem.ts

@@ -0,0 +1,12 @@
+export class PortfolioActiveItem {
+    credit_id!: string;
+    directory_id!: string;
+    partner_id!: string;
+    amount_mxn!: number;
+    term_weeks!: number;
+    annual_rate!: number;
+    weekly_payment_mxn!: number;
+    status!: string;
+    disbursed_at!: string;
+    credit_level!: string;
+}

package/src/creditDashboard/dtos/PortfolioBalance.ts

@@ -0,0 +1,5 @@
+export class PortfolioBalance {
+    alive_credits!: number;
+    total_outstanding_mxn!: number;
+    delinquency_rate_pct!: number;
+}

package/src/creditDashboard/dtos/PortfolioBalanceMonthlyItem.ts

@@ -0,0 +1,5 @@
+export class PortfolioBalanceMonthlyItem {
+    month!: string;
+    alive_credits!: number;
+    total_outstanding_mxn!: number;
+}

package/src/creditDashboard/dtos/PortfolioByLevelItem.ts

@@ -0,0 +1,7 @@
+export class PortfolioByLevelItem {
+    level!: string;
+    credits!: number;
+    balance_mxn!: number;
+    pct_of_portfolio!: number;
+    delinquency_rate_pct!: number;
+}

package/src/creditDashboard/dtos/PortfolioResolutionItem.ts

@@ -0,0 +1,8 @@
+export class PortfolioResolutionItem {
+    month!: string;
+    paid_off!: number;
+    defaulted!: number;
+    cancelled!: number;
+    total_resolved!: number;
+    recovery_rate_pct!: number;
+}

package/src/creditDashboard/dtos/PortfolioUpcomingWeek.ts

@@ -0,0 +1,7 @@
+export class PortfolioUpcomingWeek {
+    week!: string;
+    current_amount_mxn!: number;
+    current_count!: number;
+    delinquent_amount_mxn!: number;
+    delinquent_count!: number;
+}