@fiado/type-kit 3.33.0 → 3.36.0

package/src/credit/enums/ExpedienteAccessActionEnum.ts

@@ -1,20 +1,20 @@
-/**
- * Acciones auditables sobre el expediente regulatorio (P10).
- * Cada endpoint de /credit/backoffice/expedientes/* registra una entrada en
- * CreditExpedienteAccessLog_GT con uno de estos valores.
- *
- * @enum {string}
- */
-export enum ExpedienteAccessActionEnum {
-    VIEW_SEARCH_RESULT = 'VIEW_SEARCH_RESULT',
-    VIEW_RESUMEN = 'VIEW_RESUMEN',
-    VIEW_IDENTITY = 'VIEW_IDENTITY',
-    VIEW_CONTRACTS = 'VIEW_CONTRACTS',
-    VIEW_CONTRACT_DETAIL = 'VIEW_CONTRACT_DETAIL',
-    VIEW_DOCUMENT = 'VIEW_DOCUMENT',
-    VIEW_PROFILE = 'VIEW_PROFILE',
-    VIEW_OFFERS = 'VIEW_OFFERS',
-    VIEW_APPLICATIONS = 'VIEW_APPLICATIONS',
-    VIEW_PAYMENTS = 'VIEW_PAYMENTS',
-    VIEW_AUDIT_LOG = 'VIEW_AUDIT_LOG',
-}
+/**
+ * Acciones auditables sobre el expediente regulatorio (P10).
+ * Cada endpoint de /credit/backoffice/expedientes/* registra una entrada en
+ * CreditExpedienteAccessLog_GT con uno de estos valores.
+ *
+ * @enum {string}
+ */
+export enum ExpedienteAccessActionEnum {
+    VIEW_SEARCH_RESULT = 'VIEW_SEARCH_RESULT',
+    VIEW_RESUMEN = 'VIEW_RESUMEN',
+    VIEW_IDENTITY = 'VIEW_IDENTITY',
+    VIEW_CONTRACTS = 'VIEW_CONTRACTS',
+    VIEW_CONTRACT_DETAIL = 'VIEW_CONTRACT_DETAIL',
+    VIEW_DOCUMENT = 'VIEW_DOCUMENT',
+    VIEW_PROFILE = 'VIEW_PROFILE',
+    VIEW_OFFERS = 'VIEW_OFFERS',
+    VIEW_APPLICATIONS = 'VIEW_APPLICATIONS',
+    VIEW_PAYMENTS = 'VIEW_PAYMENTS',
+    VIEW_AUDIT_LOG = 'VIEW_AUDIT_LOG',
+}

package/src/credit/enums/IncomeClassificationEnum.ts

@@ -1,15 +1,15 @@
-/**
- * Clasificacion de fuentes de ingreso detectadas
- * @enum {string}
- *
- * @property {string} PRIMARY - Fuente principal de ingreso
- * @property {string} SECONDARY - Fuente secundaria de ingreso
- * @property {string} SPORADIC - Ingreso esporadico
- * @property {string} UNIDENTIFIED - Fuente no identificada
- */
-export enum IncomeClassificationEnum {
-    PRIMARY = 'PRIMARY',
-    SECONDARY = 'SECONDARY',
-    SPORADIC = 'SPORADIC',
-    UNIDENTIFIED = 'UNIDENTIFIED',
-}
+/**
+ * Clasificacion de fuentes de ingreso detectadas
+ * @enum {string}
+ *
+ * @property {string} PRIMARY - Fuente principal de ingreso
+ * @property {string} SECONDARY - Fuente secundaria de ingreso
+ * @property {string} SPORADIC - Ingreso esporadico
+ * @property {string} UNIDENTIFIED - Fuente no identificada
+ */
+export enum IncomeClassificationEnum {
+    PRIMARY = 'PRIMARY',
+    SECONDARY = 'SECONDARY',
+    SPORADIC = 'SPORADIC',
+    UNIDENTIFIED = 'UNIDENTIFIED',
+}

package/src/credit/enums/IncomeFrequencyEnum.ts

@@ -1,17 +1,17 @@
-/**
- * Frecuencias detectadas de depositos de ingreso
- * @enum {string}
- *
- * @property {string} DAILY - Diario (0-4 dias entre depositos)
- * @property {string} WEEKLY - Semanal (5-11 dias)
- * @property {string} BIWEEKLY - Quincenal (12-24 dias)
- * @property {string} MONTHLY - Mensual (25-35 dias)
- * @property {string} IRREGULAR - Irregular (36+ dias)
- */
-export enum IncomeFrequencyEnum {
-    DAILY = 'DAILY',
-    WEEKLY = 'WEEKLY',
-    BIWEEKLY = 'BIWEEKLY',
-    MONTHLY = 'MONTHLY',
-    IRREGULAR = 'IRREGULAR',
-}
+/**
+ * Frecuencias detectadas de depositos de ingreso
+ * @enum {string}
+ *
+ * @property {string} DAILY - Diario (0-4 dias entre depositos)
+ * @property {string} WEEKLY - Semanal (5-11 dias)
+ * @property {string} BIWEEKLY - Quincenal (12-24 dias)
+ * @property {string} MONTHLY - Mensual (25-35 dias)
+ * @property {string} IRREGULAR - Irregular (36+ dias)
+ */
+export enum IncomeFrequencyEnum {
+    DAILY = 'DAILY',
+    WEEKLY = 'WEEKLY',
+    BIWEEKLY = 'BIWEEKLY',
+    MONTHLY = 'MONTHLY',
+    IRREGULAR = 'IRREGULAR',
+}

package/src/credit/index.ts

@@ -1,32 +1,32 @@
-// Enums
-export * from './enums/CreditLevelEnum';
-export * from './enums/BannerStateEnum';
-export * from './enums/IncomeFrequencyEnum';
-export * from './enums/IncomeClassificationEnum';
-export * from './enums/CreditOfferStatusEnum';
-export * from './enums/ExpedienteAccessActionEnum';
-
-// DTOs
-export * from './dtos/BannerStateResponse';
-export * from './dtos/EligibilityResponse';
-export * from './dtos/CreditOfferConfigureRequest';
-export * from './dtos/CreditOfferConfigureResponse';
-export * from './dtos/CreditOfferOptionItem';
-export * from './dtos/FinancialProfileResponse';
-export * from './dtos/ExpedienteSearchItem';
-export * from './dtos/ExpedienteResumenResponse';
-export * from './dtos/ExpedienteIdentityResponse';
-export * from './dtos/ExpedienteAuditLogResponse';
-
-// DTOs internos (inter-service)
-export * from './dtos/internal/CreditProfileResponse';
-export * from './dtos/internal/CreditBalanceResponse';
-export * from './dtos/internal/LienStatusResponse';
-export * from './dtos/internal/CreditQueueMessage';
-export * from './dtos/internal/DocumentGenerateRequest';
-export * from './dtos/internal/DocumentGenerateResponse';
-
-// Interfaces (SQS Messages)
-export * from './interfaces/IIncomeDetectionMessage';
-export * from './interfaces/IScoringMessage';
-export * from './interfaces/IOfferGenerationMessage';
+// Enums
+export * from './enums/CreditLevelEnum';
+export * from './enums/BannerStateEnum';
+export * from './enums/IncomeFrequencyEnum';
+export * from './enums/IncomeClassificationEnum';
+export * from './enums/CreditOfferStatusEnum';
+export * from './enums/ExpedienteAccessActionEnum';
+
+// DTOs
+export * from './dtos/BannerStateResponse';
+export * from './dtos/EligibilityResponse';
+export * from './dtos/CreditOfferConfigureRequest';
+export * from './dtos/CreditOfferConfigureResponse';
+export * from './dtos/CreditOfferOptionItem';
+export * from './dtos/FinancialProfileResponse';
+export * from './dtos/ExpedienteSearchItem';
+export * from './dtos/ExpedienteResumenResponse';
+export * from './dtos/ExpedienteIdentityResponse';
+export * from './dtos/ExpedienteAuditLogResponse';
+
+// DTOs internos (inter-service)
+export * from './dtos/internal/CreditProfileResponse';
+export * from './dtos/internal/CreditBalanceResponse';
+export * from './dtos/internal/LienStatusResponse';
+export * from './dtos/internal/CreditQueueMessage';
+export * from './dtos/internal/DocumentGenerateRequest';
+export * from './dtos/internal/DocumentGenerateResponse';
+
+// Interfaces (SQS Messages)
+export * from './interfaces/IIncomeDetectionMessage';
+export * from './interfaces/IScoringMessage';
+export * from './interfaces/IOfferGenerationMessage';

package/src/credit/interfaces/IIncomeDetectionMessage.ts

@@ -1,9 +1,9 @@
-/**
- * Mensaje SQS para la cola de deteccion de ingresos (P1)
- * No incluye partnerId porque P1 es agnostico al partner
- */
-export interface IIncomeDetectionMessage {
-    directoryId: string;
-    executionId: string;
-    windowDays: number;
-}
+/**
+ * Mensaje SQS para la cola de deteccion de ingresos (P1)
+ * No incluye partnerId porque P1 es agnostico al partner
+ */
+export interface IIncomeDetectionMessage {
+    directoryId: string;
+    executionId: string;
+    windowDays: number;
+}

package/src/credit/interfaces/IOfferGenerationMessage.ts

@@ -1,8 +1,8 @@
-/**
- * Mensaje SQS para la cola de generacion de ofertas (P3)
- */
-export interface IOfferGenerationMessage {
-    directoryId: string;
-    executionId: string;
-    partnerId: string;
-}
+/**
+ * Mensaje SQS para la cola de generacion de ofertas (P3)
+ */
+export interface IOfferGenerationMessage {
+    directoryId: string;
+    executionId: string;
+    partnerId: string;
+}

package/src/credit/interfaces/IScoringMessage.ts

@@ -1,8 +1,8 @@
-/**
- * Mensaje SQS para la cola de scoring (P2)
- */
-export interface IScoringMessage {
-    directoryId: string;
-    executionId: string;
-    partnerId: string;
-}
+/**
+ * Mensaje SQS para la cola de scoring (P2)
+ */
+export interface IScoringMessage {
+    directoryId: string;
+    executionId: string;
+    partnerId: string;
+}

package/src/credit-statements/dtos/CreditStatementDownloadResponse.ts

@@ -1,8 +1,8 @@
-/**
- * Response de GET /statements/{statementId}/download
- * Retorna URL prefirmada de S3 (15 minutos de validez).
- */
-export interface CreditStatementDownloadResponse {
-    url: string;
-    expiresAt: string;
-}
+/**
+ * Response de GET /statements/{statementId}/download
+ * Retorna URL prefirmada de S3 (15 minutos de validez).
+ */
+export interface CreditStatementDownloadResponse {
+    url: string;
+    expiresAt: string;
+}

package/src/credit-statements/dtos/CreditStatementListItem.ts

@@ -1,14 +1,14 @@
-import { CreditStatementStatusEnum } from '../enums/CreditStatementStatusEnum';
-
-/**
- * Item de la lista de estados de cuenta retornada por
- * GET /credit/{creditId}/statements
- */
-export interface CreditStatementListItem {
-    statementId: string;
-    period: string;          // "Abril 2026"
-    periodYear: number;
-    periodMonth: number;
-    status: CreditStatementStatusEnum;
-    generatedAt: string | null;
-}
+import { CreditStatementStatusEnum } from '../enums/CreditStatementStatusEnum';
+
+/**
+ * Item de la lista de estados de cuenta retornada por
+ * GET /credit/{creditId}/statements
+ */
+export interface CreditStatementListItem {
+    statementId: string;
+    period: string;          // "Abril 2026"
+    periodYear: number;
+    periodMonth: number;
+    status: CreditStatementStatusEnum;
+    generatedAt: string | null;
+}

package/src/credit-statements/dtos/CreditStatementMessage.ts

@@ -1,13 +1,13 @@
-/**
- * Mensaje SQS publicado por el productor (cron mensual)
- * y consumido por el procesador de statements.
- */
-export interface CreditStatementMessage {
-    statementId: string;
-    creditId: string;
-    directoryId: string;
-    partnerId: string;
-    periodYear: number;
-    periodMonth: number;
-    timestamp: string;
-}
+/**
+ * Mensaje SQS publicado por el productor (cron mensual)
+ * y consumido por el procesador de statements.
+ */
+export interface CreditStatementMessage {
+    statementId: string;
+    creditId: string;
+    directoryId: string;
+    partnerId: string;
+    periodYear: number;
+    periodMonth: number;
+    timestamp: string;
+}

package/src/credit-statements/enums/CreditStatementStatusEnum.ts

@@ -1,9 +1,9 @@
-/**
- * Estados de un estado de cuenta mensual.
- * Spec: docs/1_modelo-credito/PROCESO_07_ESTADOS_CUENTA.md §3
- */
-export enum CreditStatementStatusEnum {
-    PENDING   = 'PENDING',
-    GENERATED = 'GENERATED',
-    ERROR     = 'ERROR',
-}
+/**
+ * Estados de un estado de cuenta mensual.
+ * Spec: docs/1_modelo-credito/PROCESO_07_ESTADOS_CUENTA.md §3
+ */
+export enum CreditStatementStatusEnum {
+    PENDING   = 'PENDING',
+    GENERATED = 'GENERATED',
+    ERROR     = 'ERROR',
+}

package/src/credit-statements/index.ts

@@ -1,4 +1,4 @@
-export * from './enums/CreditStatementStatusEnum';
-export * from './dtos/CreditStatementMessage';
-export * from './dtos/CreditStatementListItem';
-export * from './dtos/CreditStatementDownloadResponse';
+export * from './enums/CreditStatementStatusEnum';
+export * from './dtos/CreditStatementMessage';
+export * from './dtos/CreditStatementListItem';
+export * from './dtos/CreditStatementDownloadResponse';

package/src/creditBackoffice/dtos/BackofficeApplicationDetail.ts

@@ -1,33 +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; full_name: string };
-}
+/**
+ * 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; full_name: string };
+}

package/src/creditBackoffice/dtos/BackofficeApplicationsListItem.ts

@@ -1,15 +1,15 @@
-export class BackofficeApplicationsListItem {
-    application_id!: string;
-    directory_id!: string;
-    partner_id!: string;
-    phone_number!: string;
-    full_name!: string;
-    amount_mxn!: number;
-    term_weeks!: number;
-    annual_rate!: number;
-    weekly_payment_mxn!: number;
-    credit_level!: string;
-    status!: string;
-    signed_at!: string;
-    created_at!: string;
-}
+export class BackofficeApplicationsListItem {
+    application_id!: string;
+    directory_id!: string;
+    partner_id!: string;
+    phone_number!: string;
+    full_name!: string;
+    amount_mxn!: number;
+    term_weeks!: number;
+    annual_rate!: number;
+    weekly_payment_mxn!: number;
+    credit_level!: string;
+    status!: string;
+    signed_at!: string;
+    created_at!: string;
+}

package/src/creditBackoffice/dtos/BackofficeCreditDetail.ts

@@ -1,78 +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;
-    partner_rate_points?: number;
-    fiado_interest_mxn?: number;
-    partner_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;
-    partner_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;
-    partner_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[];
-}
+/**
+ * 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;
+    partner_rate_points?: number;
+    fiado_interest_mxn?: number;
+    partner_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;
+    partner_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;
+    partner_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

@@ -1,14 +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;
-}
+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

@@ -1,13 +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;
-}
+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;
+}