@fiado/type-kit 3.4.0 → 3.6.0

package/bin/collector/enums/CollectorErrorCodeEnum.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Códigos estandarizados de errores del Collector API.
+ * Spec: PROCESO_05_COBRANZA.md §13.1
+ */
+export declare enum CollectorErrorCodeEnum {
+    INSUFFICIENT_BALANCE = "INSUFFICIENT_BALANCE",
+    WALLET_FROZEN = "WALLET_FROZEN",
+    INVALID_DIRECTORY = "INVALID_DIRECTORY",
+    RATE_LIMIT = "RATE_LIMIT",
+    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
+    TIMEOUT = "TIMEOUT",
+    CONTRACT_FAILED = "CONTRACT_FAILED",
+    CONVERSION_ERROR = "CONVERSION_ERROR",
+    PARTIAL_FREEZE = "PARTIAL_FREEZE"
+}
+export declare enum CollectorErrorSeverityEnum {
+    CRITICAL = "CRITICAL",
+    HIGH = "HIGH",
+    MEDIUM = "MEDIUM",
+    LOW = "LOW"
+}
+export declare const DEFAULT_SEVERITY_BY_CODE: Record<CollectorErrorCodeEnum, CollectorErrorSeverityEnum>;

package/bin/collector/enums/CollectorErrorCodeEnum.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SEVERITY_BY_CODE = exports.CollectorErrorSeverityEnum = exports.CollectorErrorCodeEnum = void 0;
+/**
+ * Códigos estandarizados de errores del Collector API.
+ * Spec: PROCESO_05_COBRANZA.md §13.1
+ */
+var CollectorErrorCodeEnum;
+(function (CollectorErrorCodeEnum) {
+    CollectorErrorCodeEnum["INSUFFICIENT_BALANCE"] = "INSUFFICIENT_BALANCE";
+    CollectorErrorCodeEnum["WALLET_FROZEN"] = "WALLET_FROZEN";
+    CollectorErrorCodeEnum["INVALID_DIRECTORY"] = "INVALID_DIRECTORY";
+    CollectorErrorCodeEnum["RATE_LIMIT"] = "RATE_LIMIT";
+    CollectorErrorCodeEnum["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
+    CollectorErrorCodeEnum["TIMEOUT"] = "TIMEOUT";
+    CollectorErrorCodeEnum["CONTRACT_FAILED"] = "CONTRACT_FAILED";
+    CollectorErrorCodeEnum["CONVERSION_ERROR"] = "CONVERSION_ERROR";
+    CollectorErrorCodeEnum["PARTIAL_FREEZE"] = "PARTIAL_FREEZE";
+})(CollectorErrorCodeEnum || (exports.CollectorErrorCodeEnum = CollectorErrorCodeEnum = {}));
+var CollectorErrorSeverityEnum;
+(function (CollectorErrorSeverityEnum) {
+    CollectorErrorSeverityEnum["CRITICAL"] = "CRITICAL";
+    CollectorErrorSeverityEnum["HIGH"] = "HIGH";
+    CollectorErrorSeverityEnum["MEDIUM"] = "MEDIUM";
+    CollectorErrorSeverityEnum["LOW"] = "LOW";
+})(CollectorErrorSeverityEnum || (exports.CollectorErrorSeverityEnum = CollectorErrorSeverityEnum = {}));
+exports.DEFAULT_SEVERITY_BY_CODE = {
+    [CollectorErrorCodeEnum.INSUFFICIENT_BALANCE]: CollectorErrorSeverityEnum.LOW,
+    [CollectorErrorCodeEnum.WALLET_FROZEN]: CollectorErrorSeverityEnum.HIGH,
+    [CollectorErrorCodeEnum.INVALID_DIRECTORY]: CollectorErrorSeverityEnum.HIGH,
+    [CollectorErrorCodeEnum.RATE_LIMIT]: CollectorErrorSeverityEnum.MEDIUM,
+    [CollectorErrorCodeEnum.SERVICE_UNAVAILABLE]: CollectorErrorSeverityEnum.MEDIUM,
+    [CollectorErrorCodeEnum.TIMEOUT]: CollectorErrorSeverityEnum.MEDIUM,
+    [CollectorErrorCodeEnum.CONTRACT_FAILED]: CollectorErrorSeverityEnum.HIGH,
+    [CollectorErrorCodeEnum.CONVERSION_ERROR]: CollectorErrorSeverityEnum.HIGH,
+    [CollectorErrorCodeEnum.PARTIAL_FREEZE]: CollectorErrorSeverityEnum.LOW,
+};

package/bin/collector/index.d.ts

@@ -8,3 +8,4 @@ export * from './dtos/CreditContractResponse';
 export * from './dtos/CollectorTransactionUpdateRequest';
 export * from './dtos/CollectionOrderExecution';
 export * from './dtos/GetLastExchangeRateOutput';
+export * from './enums/CollectorErrorCodeEnum';

package/bin/collector/index.js

@@ -24,3 +24,4 @@ __exportStar(require("./dtos/CreditContractResponse"), exports);
 __exportStar(require("./dtos/CollectorTransactionUpdateRequest"), exports);
 __exportStar(require("./dtos/CollectionOrderExecution"), exports);
 __exportStar(require("./dtos/GetLastExchangeRateOutput"), exports);
+__exportStar(require("./enums/CollectorErrorCodeEnum"), exports);

package/bin/credit-statements/dtos/CreditStatementDownloadResponse.d.ts

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

package/bin/credit-statements/dtos/CreditStatementDownloadResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/credit-statements/dtos/CreditStatementListItem.d.ts

@@ -0,0 +1,13 @@
+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;
+    periodYear: number;
+    periodMonth: number;
+    status: CreditStatementStatusEnum;
+    generatedAt: string | null;
+}

package/bin/credit-statements/dtos/CreditStatementListItem.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/credit-statements/dtos/CreditStatementMessage.d.ts

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

package/bin/credit-statements/dtos/CreditStatementMessage.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/credit-statements/enums/CreditStatementStatusEnum.d.ts

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

package/bin/credit-statements/enums/CreditStatementStatusEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditStatementStatusEnum = void 0;
+/**
+ * Estados de un estado de cuenta mensual.
+ * Spec: docs/1_modelo-credito/PROCESO_07_ESTADOS_CUENTA.md §3
+ */
+var CreditStatementStatusEnum;
+(function (CreditStatementStatusEnum) {
+    CreditStatementStatusEnum["PENDING"] = "PENDING";
+    CreditStatementStatusEnum["GENERATED"] = "GENERATED";
+    CreditStatementStatusEnum["ERROR"] = "ERROR";
+})(CreditStatementStatusEnum || (exports.CreditStatementStatusEnum = CreditStatementStatusEnum = {}));

package/bin/credit-statements/index.d.ts

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

package/bin/credit-statements/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./enums/CreditStatementStatusEnum"), exports);
+__exportStar(require("./dtos/CreditStatementMessage"), exports);
+__exportStar(require("./dtos/CreditStatementListItem"), exports);
+__exportStar(require("./dtos/CreditStatementDownloadResponse"), exports);

package/bin/index.d.ts

@@ -68,3 +68,4 @@ export * as TeamsConnector from './teamsConnector';
 export * as Funnel from './funnel';
 export * as AiEngine from './aiEngine';
 export * as Sentry from './sentry';
+export * as CreditStatements from './credit-statements';

package/bin/index.js

@@ -34,7 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = exports.Blacklist = exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.App = exports.Address = exports.Beneficiary = exports.Activity = exports.Account = exports.Crypto = void 0;
-exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = void 0;
+exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.Activity = __importStar(require("./activity"));
@@ -105,3 +105,4 @@ exports.TeamsConnector = __importStar(require("./teamsConnector"));
 exports.Funnel = __importStar(require("./funnel"));
 exports.AiEngine = __importStar(require("./aiEngine"));
 exports.Sentry = __importStar(require("./sentry"));
+exports.CreditStatements = __importStar(require("./credit-statements"));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fiado/type-kit",
-	"version": "3.4.0",
+	"version": "3.6.0",
 	"description": "",
 	"main": "bin/index.js",
 	"types": "bin/index.d.ts",

package/src/collector/enums/CollectorErrorCodeEnum.ts

@@ -0,0 +1,34 @@
+/**
+ * Códigos estandarizados de errores del Collector API.
+ * Spec: PROCESO_05_COBRANZA.md §13.1
+ */
+export enum CollectorErrorCodeEnum {
+    INSUFFICIENT_BALANCE = 'INSUFFICIENT_BALANCE',
+    WALLET_FROZEN        = 'WALLET_FROZEN',
+    INVALID_DIRECTORY    = 'INVALID_DIRECTORY',
+    RATE_LIMIT           = 'RATE_LIMIT',
+    SERVICE_UNAVAILABLE  = 'SERVICE_UNAVAILABLE',
+    TIMEOUT              = 'TIMEOUT',
+    CONTRACT_FAILED      = 'CONTRACT_FAILED',
+    CONVERSION_ERROR     = 'CONVERSION_ERROR',
+    PARTIAL_FREEZE       = 'PARTIAL_FREEZE',
+}
+
+export enum CollectorErrorSeverityEnum {
+    CRITICAL = 'CRITICAL',
+    HIGH     = 'HIGH',
+    MEDIUM   = 'MEDIUM',
+    LOW      = 'LOW',
+}
+
+export const DEFAULT_SEVERITY_BY_CODE: Record<CollectorErrorCodeEnum, CollectorErrorSeverityEnum> = {
+    [CollectorErrorCodeEnum.INSUFFICIENT_BALANCE]: CollectorErrorSeverityEnum.LOW,
+    [CollectorErrorCodeEnum.WALLET_FROZEN]:        CollectorErrorSeverityEnum.HIGH,
+    [CollectorErrorCodeEnum.INVALID_DIRECTORY]:    CollectorErrorSeverityEnum.HIGH,
+    [CollectorErrorCodeEnum.RATE_LIMIT]:           CollectorErrorSeverityEnum.MEDIUM,
+    [CollectorErrorCodeEnum.SERVICE_UNAVAILABLE]:  CollectorErrorSeverityEnum.MEDIUM,
+    [CollectorErrorCodeEnum.TIMEOUT]:              CollectorErrorSeverityEnum.MEDIUM,
+    [CollectorErrorCodeEnum.CONTRACT_FAILED]:      CollectorErrorSeverityEnum.HIGH,
+    [CollectorErrorCodeEnum.CONVERSION_ERROR]:     CollectorErrorSeverityEnum.HIGH,
+    [CollectorErrorCodeEnum.PARTIAL_FREEZE]:       CollectorErrorSeverityEnum.LOW,
+};

package/src/collector/index.ts

@@ -10,3 +10,4 @@ export * from './dtos/CreditContractResponse';
 export * from './dtos/CollectorTransactionUpdateRequest';
 export * from './dtos/CollectionOrderExecution';
 export * from './dtos/GetLastExchangeRateOutput';
+export * from './enums/CollectorErrorCodeEnum';

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

@@ -0,0 +1,8 @@
+/**
+ * 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

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

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

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

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

@@ -0,0 +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',
+}

package/src/credit-statements/index.ts

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

package/src/index.ts

@@ -68,3 +68,4 @@ export * as TeamsConnector from './teamsConnector';
 export * as Funnel from './funnel';
 export * as AiEngine from './aiEngine';
 export * as Sentry from './sentry';
+export * as CreditStatements from './credit-statements';