@fiado/type-kit 3.71.0 → 3.73.0

package/bin/credit/enums/CreditOperationEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditOperationEnum = void 0;
+var CreditOperationEnum;
+(function (CreditOperationEnum) {
+    CreditOperationEnum["DISBURSEMENT"] = "DISBURSEMENT";
+    CreditOperationEnum["COLLECTION"] = "COLLECTION";
+    CreditOperationEnum["COLLECTION_PARTIAL"] = "COLLECTION_PARTIAL";
+    CreditOperationEnum["COLLECTION_LIEN"] = "COLLECTION_LIEN";
+    CreditOperationEnum["EARLY_PAYMENT"] = "EARLY_PAYMENT";
+    CreditOperationEnum["TRANSFER_LOANCO"] = "TRANSFER_LOANCO";
+    CreditOperationEnum["REVERSAL"] = "REVERSAL";
+    CreditOperationEnum["INTEREST_ACCRUAL"] = "INTEREST_ACCRUAL";
+    CreditOperationEnum["FEE_CHARGE"] = "FEE_CHARGE";
+})(CreditOperationEnum || (exports.CreditOperationEnum = CreditOperationEnum = {}));

package/bin/credit/enums/CreditStatusEnum.d.ts

@@ -0,0 +1,12 @@
+export declare enum CreditStatusEnum {
+    PENDING_APPROVAL = "PENDING_APPROVAL",
+    APPROVED = "APPROVED",
+    ACTIVE = "ACTIVE",
+    CURRENT = "CURRENT",
+    DELINQUENT = "DELINQUENT",
+    DEFAULTED = "DEFAULTED",
+    PAID_OFF = "PAID_OFF",
+    CANCELLED = "CANCELLED",
+    RETURNED_TO_LOANCO = "RETURNED_TO_LOANCO",
+    WRITTEN_OFF = "WRITTEN_OFF"
+}

package/bin/credit/enums/CreditStatusEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditStatusEnum = void 0;
+var CreditStatusEnum;
+(function (CreditStatusEnum) {
+    CreditStatusEnum["PENDING_APPROVAL"] = "PENDING_APPROVAL";
+    CreditStatusEnum["APPROVED"] = "APPROVED";
+    CreditStatusEnum["ACTIVE"] = "ACTIVE";
+    CreditStatusEnum["CURRENT"] = "CURRENT";
+    CreditStatusEnum["DELINQUENT"] = "DELINQUENT";
+    CreditStatusEnum["DEFAULTED"] = "DEFAULTED";
+    CreditStatusEnum["PAID_OFF"] = "PAID_OFF";
+    CreditStatusEnum["CANCELLED"] = "CANCELLED";
+    CreditStatusEnum["RETURNED_TO_LOANCO"] = "RETURNED_TO_LOANCO";
+    CreditStatusEnum["WRITTEN_OFF"] = "WRITTEN_OFF";
+})(CreditStatusEnum || (exports.CreditStatusEnum = CreditStatusEnum = {}));

package/bin/credit/enums/DelinquencyLevelEnum.d.ts

@@ -0,0 +1,9 @@
+export declare enum DelinquencyLevelEnum {
+    CURRENT = "CURRENT",
+    EARLY_1_7 = "EARLY_1_7",
+    EARLY_8_14 = "EARLY_8_14",
+    LATE_15_30 = "LATE_15_30",
+    LATE_31_60 = "LATE_31_60",
+    SEVERE_61_90 = "SEVERE_61_90",
+    DEFAULT_90_PLUS = "DEFAULT_90_PLUS"
+}

package/bin/credit/enums/DelinquencyLevelEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DelinquencyLevelEnum = void 0;
+var DelinquencyLevelEnum;
+(function (DelinquencyLevelEnum) {
+    DelinquencyLevelEnum["CURRENT"] = "CURRENT";
+    DelinquencyLevelEnum["EARLY_1_7"] = "EARLY_1_7";
+    DelinquencyLevelEnum["EARLY_8_14"] = "EARLY_8_14";
+    DelinquencyLevelEnum["LATE_15_30"] = "LATE_15_30";
+    DelinquencyLevelEnum["LATE_31_60"] = "LATE_31_60";
+    DelinquencyLevelEnum["SEVERE_61_90"] = "SEVERE_61_90";
+    DelinquencyLevelEnum["DEFAULT_90_PLUS"] = "DEFAULT_90_PLUS";
+})(DelinquencyLevelEnum || (exports.DelinquencyLevelEnum = DelinquencyLevelEnum = {}));

package/bin/credit/enums/DocumentTypeEnum.d.ts

@@ -0,0 +1,8 @@
+export declare enum DocumentTypeEnum {
+    CREDIT_CONTRACT = "CREDIT_CONTRACT",
+    CREDIT_STATEMENT = "CREDIT_STATEMENT",
+    CREDIT_AMORTIZATION = "CREDIT_AMORTIZATION",
+    CREDIT_COVER_SHEET = "CREDIT_COVER_SHEET",
+    ONBOARDING_CONTRACT = "ONBOARDING_CONTRACT",
+    ONBOARDING_IFPE = "ONBOARDING_IFPE"
+}

package/bin/credit/enums/DocumentTypeEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentTypeEnum = void 0;
+var DocumentTypeEnum;
+(function (DocumentTypeEnum) {
+    DocumentTypeEnum["CREDIT_CONTRACT"] = "CREDIT_CONTRACT";
+    DocumentTypeEnum["CREDIT_STATEMENT"] = "CREDIT_STATEMENT";
+    DocumentTypeEnum["CREDIT_AMORTIZATION"] = "CREDIT_AMORTIZATION";
+    DocumentTypeEnum["CREDIT_COVER_SHEET"] = "CREDIT_COVER_SHEET";
+    DocumentTypeEnum["ONBOARDING_CONTRACT"] = "ONBOARDING_CONTRACT";
+    DocumentTypeEnum["ONBOARDING_IFPE"] = "ONBOARDING_IFPE";
+})(DocumentTypeEnum || (exports.DocumentTypeEnum = DocumentTypeEnum = {}));

package/bin/credit/enums/OfferStatusEnum.d.ts

@@ -0,0 +1,8 @@
+export declare enum OfferStatusEnum {
+    NOT_ELIGIBLE = "NOT_ELIGIBLE",
+    PRE_QUALIFIED = "PRE_QUALIFIED",
+    OFFER_AVAILABLE = "OFFER_AVAILABLE",
+    OFFER_CONFIGURED = "OFFER_CONFIGURED",
+    OFFER_ACCEPTED = "OFFER_ACCEPTED",
+    OFFER_EXPIRED = "OFFER_EXPIRED"
+}

package/bin/credit/enums/OfferStatusEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OfferStatusEnum = void 0;
+var OfferStatusEnum;
+(function (OfferStatusEnum) {
+    OfferStatusEnum["NOT_ELIGIBLE"] = "NOT_ELIGIBLE";
+    OfferStatusEnum["PRE_QUALIFIED"] = "PRE_QUALIFIED";
+    OfferStatusEnum["OFFER_AVAILABLE"] = "OFFER_AVAILABLE";
+    OfferStatusEnum["OFFER_CONFIGURED"] = "OFFER_CONFIGURED";
+    OfferStatusEnum["OFFER_ACCEPTED"] = "OFFER_ACCEPTED";
+    OfferStatusEnum["OFFER_EXPIRED"] = "OFFER_EXPIRED";
+})(OfferStatusEnum || (exports.OfferStatusEnum = OfferStatusEnum = {}));

package/bin/credit/enums/PaymentTypeEnum.d.ts

@@ -0,0 +1,9 @@
+export declare enum PaymentTypeEnum {
+    REGULAR = "REGULAR",
+    PARTIAL = "PARTIAL",
+    EARLY_ANTICIPATED = "EARLY_ANTICIPATED",
+    EARLY_ADVANCED = "EARLY_ADVANCED",
+    EARLY_SETTLEMENT = "EARLY_SETTLEMENT",
+    LIEN = "LIEN",
+    REVERSAL = "REVERSAL"
+}

package/bin/credit/enums/PaymentTypeEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentTypeEnum = void 0;
+var PaymentTypeEnum;
+(function (PaymentTypeEnum) {
+    PaymentTypeEnum["REGULAR"] = "REGULAR";
+    PaymentTypeEnum["PARTIAL"] = "PARTIAL";
+    PaymentTypeEnum["EARLY_ANTICIPATED"] = "EARLY_ANTICIPATED";
+    PaymentTypeEnum["EARLY_ADVANCED"] = "EARLY_ADVANCED";
+    PaymentTypeEnum["EARLY_SETTLEMENT"] = "EARLY_SETTLEMENT";
+    PaymentTypeEnum["LIEN"] = "LIEN";
+    PaymentTypeEnum["REVERSAL"] = "REVERSAL";
+})(PaymentTypeEnum || (exports.PaymentTypeEnum = PaymentTypeEnum = {}));

package/bin/credit/enums/ReconciliationStatusEnum.d.ts

@@ -0,0 +1,6 @@
+export declare enum ReconciliationStatusEnum {
+    PENDING = "PENDING",
+    MATCHED = "MATCHED",
+    DISCREPANCY = "DISCREPANCY",
+    RESOLVED = "RESOLVED"
+}

package/bin/credit/enums/ReconciliationStatusEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReconciliationStatusEnum = void 0;
+var ReconciliationStatusEnum;
+(function (ReconciliationStatusEnum) {
+    ReconciliationStatusEnum["PENDING"] = "PENDING";
+    ReconciliationStatusEnum["MATCHED"] = "MATCHED";
+    ReconciliationStatusEnum["DISCREPANCY"] = "DISCREPANCY";
+    ReconciliationStatusEnum["RESOLVED"] = "RESOLVED";
+})(ReconciliationStatusEnum || (exports.ReconciliationStatusEnum = ReconciliationStatusEnum = {}));

package/bin/credit/enums/TransferStatusEnum.d.ts

@@ -0,0 +1,8 @@
+export declare enum TransferStatusEnum {
+    PENDING = "PENDING",
+    APPROVED = "APPROVED",
+    IN_PROGRESS = "IN_PROGRESS",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    REJECTED = "REJECTED"
+}

package/bin/credit/enums/TransferStatusEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferStatusEnum = void 0;
+var TransferStatusEnum;
+(function (TransferStatusEnum) {
+    TransferStatusEnum["PENDING"] = "PENDING";
+    TransferStatusEnum["APPROVED"] = "APPROVED";
+    TransferStatusEnum["IN_PROGRESS"] = "IN_PROGRESS";
+    TransferStatusEnum["COMPLETED"] = "COMPLETED";
+    TransferStatusEnum["FAILED"] = "FAILED";
+    TransferStatusEnum["REJECTED"] = "REJECTED";
+})(TransferStatusEnum || (exports.TransferStatusEnum = TransferStatusEnum = {}));

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

@@ -1,3 +1,4 @@
+import { TokenValidationMode } from '../enums/TokenValidationMode';
 /**
  * Input del POST backoffice de creación de tenant (F-11 — onboarding de tenant en SureKeep).
  * Consumido por el controller `backofficeCreateTenant` del platform-rbac-business y, a futuro,
@@ -14,4 +15,5 @@ export declare class CreateTenantRequest {
     region: string;
     mfaRequired?: boolean;
     passwordMinLength?: number;
+    tokenValidationMode?: TokenValidationMode;
 }

package/bin/platformRbac/dtos/CreateTenantRequest.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateTenantRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const TokenValidationMode_1 = require("../enums/TokenValidationMode");
 /**
  * Input del POST backoffice de creación de tenant (F-11 — onboarding de tenant en SureKeep).
  * Consumido por el controller `backofficeCreateTenant` del platform-rbac-business y, a futuro,
@@ -66,3 +67,9 @@ __decorate([
     (0, class_validator_1.Min)(8),
     __metadata("design:type", Number)
 ], CreateTenantRequest.prototype, "passwordMinLength", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(TokenValidationMode_1.TokenValidationMode),
+    __metadata("design:type", String)
+], CreateTenantRequest.prototype, "tokenValidationMode", void 0);

package/bin/platformRbac/enums/Permission.d.ts

@@ -6,7 +6,25 @@
  *
  * Copy-paste literal de los valores del spec (DEC-003).
  * Convención: `<category>.<resource>.<action>` (snake_case en action si multi-palabra).
- * Cualquier cambio aquí requiere PR + bump minor + redeploy de consumers.
+ *
+ * ⚠️ ESTE ES EL CATÁLOGO GLOBAL Y ÚNICO. Todo permiso del sistema vive acá. Los tenants
+ * NO inventan permisos: cada `tenantType` arma su lista (techo) ELIGIENDO de este catálogo
+ * (`TenantTypePermissionCatalog_GT` en platform-rbac-business, DEC-062), y cada tenant arma
+ * sus roles combinando esos permisos. El vocabulario es global; lo que varía por tenant es
+ * QUÉ permisos usa, no CUÁLES existen.
+ *
+ * ⚠️⚠️ AL AGREGAR / QUITAR / RENOMBRAR UN PERMISO — PROCEDIMIENTO OBLIGATORIO:
+ *   1. Agregar el valor a ESTE enum.
+ *   2. Agregarlo TAMBIÉN al FINAL de `PERMISSION_BIT_ORDER` (abajo) — append-only, NUNCA en
+ *      el medio ni reordenando: ese array define el bit de cada permiso en el token (bitset).
+ *      Reordenar/insertar en medio desalinea TODOS los tokens ya emitidos (escalada/pérdida
+ *      de permisos silenciosa). Un permiso deprecado CONSERVA su posición (no se borra del array).
+ *   3. Recién entonces un `tenantType` puede incluirlo en su lista. Un permiso que NO esté en
+ *      este enum + bit-order NO tiene bit → no viaja en el token (el gateway-adapter no lo ve).
+ *   4. `PERMS_VERSION` (hash del orden) cambia solo → bump minor del type-kit + redeploy de
+ *      consumers (jwt-inyector-trigger, gateway-adapter, platform-rbac-business). Tokens viejos
+ *      caen al fallback (resolver DDB) hasta refrescar — by-design, no rompe.
+ *   El test `permissionBits.test.ts` falla si el enum y `PERMISSION_BIT_ORDER` se desincronizan.
  *
  * Coexiste con módulo `rbac/` oficial cuando yhonhansen publique componente 01 — TD-RBAC-002.
  */
@@ -107,6 +125,11 @@ export declare enum Permission {
  * Índice de cada permiso = su posición de bit. NUNCA reordenar ni borrar:
  * deprecados CONSERVAN su posición; los nuevos van SIEMPRE al final.
  * Derivado explícitamente (no Object.values, frágil ante edición del enum).
+ *
+ * ⚠️ Si agregás un permiso al enum `Permission` (arriba), agregalo TAMBIÉN acá, AL FINAL.
+ * Ver el procedimiento completo en el JSDoc del enum `Permission`. El test
+ * `permissionBits.test.ts` rompe si esto y el enum no coinciden, y el snapshot del orden
+ * completo rompe si reordenás (guard anti-desalineamiento de tokens emitidos).
  */
 export declare const PERMISSION_BIT_ORDER: readonly Permission[];
 /** Versión del catálogo = hash del orden. Cambia solo si el orden cambia. */

package/bin/platformRbac/enums/Permission.js

@@ -11,7 +11,25 @@ exports.bitsToPermissions = bitsToPermissions;
  *
  * Copy-paste literal de los valores del spec (DEC-003).
  * Convención: `<category>.<resource>.<action>` (snake_case en action si multi-palabra).
- * Cualquier cambio aquí requiere PR + bump minor + redeploy de consumers.
+ *
+ * ⚠️ ESTE ES EL CATÁLOGO GLOBAL Y ÚNICO. Todo permiso del sistema vive acá. Los tenants
+ * NO inventan permisos: cada `tenantType` arma su lista (techo) ELIGIENDO de este catálogo
+ * (`TenantTypePermissionCatalog_GT` en platform-rbac-business, DEC-062), y cada tenant arma
+ * sus roles combinando esos permisos. El vocabulario es global; lo que varía por tenant es
+ * QUÉ permisos usa, no CUÁLES existen.
+ *
+ * ⚠️⚠️ AL AGREGAR / QUITAR / RENOMBRAR UN PERMISO — PROCEDIMIENTO OBLIGATORIO:
+ *   1. Agregar el valor a ESTE enum.
+ *   2. Agregarlo TAMBIÉN al FINAL de `PERMISSION_BIT_ORDER` (abajo) — append-only, NUNCA en
+ *      el medio ni reordenando: ese array define el bit de cada permiso en el token (bitset).
+ *      Reordenar/insertar en medio desalinea TODOS los tokens ya emitidos (escalada/pérdida
+ *      de permisos silenciosa). Un permiso deprecado CONSERVA su posición (no se borra del array).
+ *   3. Recién entonces un `tenantType` puede incluirlo en su lista. Un permiso que NO esté en
+ *      este enum + bit-order NO tiene bit → no viaja en el token (el gateway-adapter no lo ve).
+ *   4. `PERMS_VERSION` (hash del orden) cambia solo → bump minor del type-kit + redeploy de
+ *      consumers (jwt-inyector-trigger, gateway-adapter, platform-rbac-business). Tokens viejos
+ *      caen al fallback (resolver DDB) hasta refrescar — by-design, no rompe.
+ *   El test `permissionBits.test.ts` falla si el enum y `PERMISSION_BIT_ORDER` se desincronizan.
  *
  * Coexiste con módulo `rbac/` oficial cuando yhonhansen publique componente 01 — TD-RBAC-002.
  */
@@ -142,6 +160,11 @@ var Permission;
  * Índice de cada permiso = su posición de bit. NUNCA reordenar ni borrar:
  * deprecados CONSERVAN su posición; los nuevos van SIEMPRE al final.
  * Derivado explícitamente (no Object.values, frágil ante edición del enum).
+ *
+ * ⚠️ Si agregás un permiso al enum `Permission` (arriba), agregalo TAMBIÉN acá, AL FINAL.
+ * Ver el procedimiento completo en el JSDoc del enum `Permission`. El test
+ * `permissionBits.test.ts` rompe si esto y el enum no coinciden, y el snapshot del orden
+ * completo rompe si reordenás (guard anti-desalineamiento de tokens emitidos).
  */
 exports.PERMISSION_BIT_ORDER = [
     Permission.RBAC_CATALOG_MANAGE,

package/bin/platformRbac/enums/TokenValidationMode.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Modo de validación de tokens por tenant (DEC-RBAC-002 del rbac-authorizer-trigger).
+ * Persistido como atributo no-key en PlatformTenantConfig_GT. Los valores string SON el
+ * contrato: el authorizer los espeja con un tipo local (no depende de type-kit, DT-7).
+ * - OFFLINE: solo firma (JWKS) + permsEpoch. Default. No pega a Cognito.
+ * - ONLINE_PREFERRED: AdminGetUser; negativo definitivo → Deny; fallo de infra → cae a offline.
+ * - ONLINE_STRICT: AdminGetUser; negativo definitivo O fallo de infra → Deny (fail-closed, regulado).
+ */
+export declare enum TokenValidationMode {
+    OFFLINE = "offline",
+    ONLINE_PREFERRED = "online_preferred",
+    ONLINE_STRICT = "online_strict"
+}

package/bin/platformRbac/enums/TokenValidationMode.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenValidationMode = void 0;
+/**
+ * Modo de validación de tokens por tenant (DEC-RBAC-002 del rbac-authorizer-trigger).
+ * Persistido como atributo no-key en PlatformTenantConfig_GT. Los valores string SON el
+ * contrato: el authorizer los espeja con un tipo local (no depende de type-kit, DT-7).
+ * - OFFLINE: solo firma (JWKS) + permsEpoch. Default. No pega a Cognito.
+ * - ONLINE_PREFERRED: AdminGetUser; negativo definitivo → Deny; fallo de infra → cae a offline.
+ * - ONLINE_STRICT: AdminGetUser; negativo definitivo O fallo de infra → Deny (fail-closed, regulado).
+ */
+var TokenValidationMode;
+(function (TokenValidationMode) {
+    TokenValidationMode["OFFLINE"] = "offline";
+    TokenValidationMode["ONLINE_PREFERRED"] = "online_preferred";
+    TokenValidationMode["ONLINE_STRICT"] = "online_strict";
+})(TokenValidationMode || (exports.TokenValidationMode = TokenValidationMode = {}));

package/bin/platformRbac/index.d.ts

@@ -6,6 +6,7 @@ export type { RoleAssignmentInfo } from './dtos/RoleAssignmentInfo';
 export type { PermissionMeta } from './dtos/PermissionMeta';
 export type { EffectivePermissionsResponse } from './dtos/EffectivePermissionsResponse';
 export * from './enums/MfaMethodEnum';
+export * from './enums/TokenValidationMode';
 export * from './enums/ChallengeNameEnum';
 export * from './auth/DefineNextChallengeRequest';
 export * from './auth/DefineNextChallengeResponse';

package/bin/platformRbac/index.js

@@ -37,6 +37,7 @@ Object.defineProperty(exports, "PermissionCategory", { enumerable: true, get: fu
 // Fase 1 — Custom Auth Challenge (Email OTP + TOTP) + MFA self-service.
 // Class values (no type-only) — los DTOs llevan decoradores class-validator y se hidratan con plainToInstance en runtime.
 __exportStar(require("./enums/MfaMethodEnum"), exports);
+__exportStar(require("./enums/TokenValidationMode"), exports);
 __exportStar(require("./enums/ChallengeNameEnum"), exports);
 __exportStar(require("./auth/DefineNextChallengeRequest"), exports);
 __exportStar(require("./auth/DefineNextChallengeResponse"), exports);

package/bin/riskProfile/dtos/TransactionAlarmQueueMessage.d.ts

@@ -1,4 +1,5 @@
 import { OperationEnum } from "../../transaction";
+import { ProductSubtypeEnum } from "../../productCatalog";
 export declare class TransactionAlarmQueueMessage {
     directoryId: string;
     peopleId: string;
@@ -8,6 +9,7 @@ export declare class TransactionAlarmQueueMessage {
     phoneNumber: string;
     transactionDate: string;
     transactionType: string;
+    subType?: ProductSubtypeEnum;
     id: string;
     operation: OperationEnum;
 }

package/bin/riskProfile/dtos/TransactionAlarmQueueMessage.js

@@ -11,6 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TransactionAlarmQueueMessage = void 0;
 const class_validator_1 = require("class-validator");
+const productCatalog_1 = require("../../productCatalog");
 class TransactionAlarmQueueMessage {
 }
 exports.TransactionAlarmQueueMessage = TransactionAlarmQueueMessage;
@@ -54,6 +55,11 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], TransactionAlarmQueueMessage.prototype, "transactionType", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], TransactionAlarmQueueMessage.prototype, "subType", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),

package/docs/superpowers/plans/2026-05-22-http-client-inversify-v8.md

@@ -0,0 +1,243 @@
+# http-client → inversify v8 (2.0.0) Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Migrar `@fiado/http-client` a inversify 8 (última) y dejarlo listo como major **2.0.0**, con la línea v6 (1.x) como rama de mantenimiento. **No se publica** hasta terminar los cambios y tener visto bueno.
+
+**Architecture:** http-client solo usa `@injectable()` sobre `AxiosHttpRequest` (sin inyección por constructor). El cambio es: (1) introducir un smoke test que prueba que la clase se resuelve desde un `Container`, como guardia de regresión; (2) subir inversify a 8 moviéndola a `peerDependency` + `devDependency`; (3) dejar 2.0.0 listo (publicación diferida). Es la lib hoja (sin deps `@fiado`), por eso va primero.
+
+**Tech Stack:** TypeScript 5.4, inversify 8.x (^8.1.0), reflect-metadata 0.2.2, axios 1.8, jest + ts-jest (nuevo).
+
+**Nota de versión:** se va de v6 directo a **v8** (la última); se salta v7. Confirmado contra las guías oficiales ([v6](https://inversify.io/docs/guides/migrating-from-v6/), [v7](https://inversify.io/docs/guides/migrating-from-v7/)): http-client solo usa `@injectable()`, que **no cambió**.
+
+**Constraint ESM:** inversify 8 es **ESM-only**; CommonJS lo consume vía `require(esm)` solo en **Node ≥20**. El build de la lib (tsconfig commonjs) no cambia, pero el harness de jest debe correr en Node 20+ y puede requerir ajuste si jest no resuelve el paquete ESM (ver Task 3 Step 3).
+
+**Repo:** `/Users/yhon/fsrc/fiado-http-client` (rama base: `develop`, hoy en 1.0.10, limpia tras pull).
+
+---
+
+## Estructura de archivos
+
+- `fiado-http-client/jest.config.js` — **crear**: config jest con preset ts-jest.
+- `fiado-http-client/test/AxiosHttpRequest.di.test.ts` — **crear**: smoke test de resolución por container.
+- `fiado-http-client/package.json` — **modificar**: scripts.test, devDependencies (jest, ts-jest, @types/jest, inversify, reflect-metadata), peerDependencies (inversify, reflect-metadata), quitar inversify de dependencies, bump version.
+- `fiado-http-client/src/AxiosHttpRequest.ts` — **modificar solo si v8 lo exige** (no se espera cambio: `@injectable()` sigue igual).
+- `fiado-http-client/tsconfig.json` — **modificar**: excluir `test/` del build de producción.
+
+---
+
+## Task 1: Montar harness de tests + smoke test (baseline en inversify 6)
+
+**Files:**
+- Modify: `fiado-http-client/package.json`
+- Create: `fiado-http-client/jest.config.js`
+- Create: `fiado-http-client/test/AxiosHttpRequest.di.test.ts`
+- Modify: `fiado-http-client/tsconfig.json`
+
+- [ ] **Step 1: Instalar dependencias de test**
+
+Run:
+```bash
+cd /Users/yhon/fsrc/fiado-http-client
+npm install -D jest@^29 ts-jest@^29 @types/jest@^29
+```
+Expected: se agregan a `devDependencies`, sin errores de peer deps.
+
+- [ ] **Step 2: Crear `jest.config.js`**
+
+```js
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  testMatch: ['**/test/**/*.test.ts'],
+  setupFiles: ['reflect-metadata'],
+};
+```
+
+- [ ] **Step 3: Actualizar el script de test en `package.json`**
+
+Reemplazar la línea `"test": "test",` por:
+```json
+"test": "jest",
+```
+
+- [ ] **Step 4: Excluir `test/` del build en `tsconfig.json`**
+
+Agregar a `exclude` (junto a `node_modules`):
+```json
+"exclude": [
+  "node_modules",
+  "test"
+]
+```
+
+- [ ] **Step 5: Escribir el smoke test (debe pasar con inversify 6 actual)**
+
+Create `test/AxiosHttpRequest.di.test.ts`:
+```ts
+import 'reflect-metadata';
+import { Container } from 'inversify';
+import { AxiosHttpRequest } from '../src/AxiosHttpRequest';
+import { IHttpRequest } from '../src/IHttpRequest';
+
+describe('AxiosHttpRequest DI', () => {
+  it('se resuelve como IHttpRequest desde un Container de inversify', () => {
+    const container = new Container();
+    container.bind<IHttpRequest>('IHttpRequest').to(AxiosHttpRequest);
+
+    const instance = container.get<IHttpRequest>('IHttpRequest');
+
+    expect(instance).toBeInstanceOf(AxiosHttpRequest);
+    expect(typeof instance.get).toBe('function');
+    expect(typeof instance.post).toBe('function');
+  });
+});
+```
+
+- [ ] **Step 6: Correr el test (baseline verde en inversify 6)**
+
+Run:
+```bash
+cd /Users/yhon/fsrc/fiado-http-client && npm test
+```
+Expected: PASS (1 test). Esto fija el baseline antes del bump.
+
+- [ ] **Step 7: Commit**
+
+```bash
+cd /Users/yhon/fsrc/fiado-http-client
+git add jest.config.js test/AxiosHttpRequest.di.test.ts package.json package-lock.json tsconfig.json
+git commit -m "test: add DI smoke test and jest harness for http-client"
+```
+
+---
+
+## Task 2: Crear rama de mantenimiento v6 antes de subir develop a v8
+
+**Files:** ninguno (operación de git/branch)
+
+- [ ] **Step 1: Cortar la rama de mantenimiento desde el develop actual (1.x)**
+
+Run:
+```bash
+cd /Users/yhon/fsrc/fiado-http-client
+git checkout -b release/1.x
+git push -u origin release/1.x
+git checkout develop
+```
+Expected: `release/1.x` creada en remoto desde 1.0.10. `develop` será la línea v8.
+
+---
+
+## Task 3: Subir inversify a v8 como peerDependency
+
+**Files:**
+- Modify: `fiado-http-client/package.json`
+- (posible) Modify: `fiado-http-client/src/AxiosHttpRequest.ts`
+
+- [ ] **Step 1: Quitar inversify de `dependencies` e instalar v8 como peer + dev**
+
+Editar `package.json`:
+- Quitar `"inversify": "^6.0.2"` de `dependencies` (dejar ahí solo `axios` y `typescript`).
+- Agregar bloque:
+```json
+"peerDependencies": {
+  "inversify": "^8.0.0",
+  "reflect-metadata": "^0.2.2"
+},
+```
+- Agregar a `devDependencies`: `"inversify": "^8.1.0"`, `"reflect-metadata": "^0.2.2"`.
+
+Luego instalar:
+```bash
+cd /Users/yhon/fsrc/fiado-http-client
+npm install
+```
+Expected: inversify 8.x en `node_modules`, sin errores.
+
+- [ ] **Step 2: Compilar contra v8**
+
+Run:
+```bash
+cd /Users/yhon/fsrc/fiado-http-client && npm run build
+```
+Expected: PASS. Si falla por la API de decoradores, ajustar el import de `@injectable` según la guía v8 (no se espera; `import { injectable } from 'inversify'` sigue válido).
+
+- [ ] **Step 3: Correr el smoke test contra v8 (debe seguir verde)**
+
+Run:
+```bash
+node --version   # debe ser >= 20 (inversify 8 es ESM-only)
+cd /Users/yhon/fsrc/fiado-http-client && npm test
+```
+Expected: PASS. Notas según la guía oficial:
+- `container.get()` **sigue síncrono** en v8 (convención sync-first), así que el test no debería requerir `getAsync`.
+- Si jest falla al cargar inversify 8 por ser **ESM-only** (error tipo `Cannot use import statement outside a module` o `ERR_REQUIRE_ESM`), habilitar ESM en jest: correr con `NODE_OPTIONS=--experimental-vm-modules`, `preset: 'ts-jest/presets/default-esm'` y `extensionsToTreatAsEsm: ['.ts']` en `jest.config.js`. Documentar el ajuste final para reutilizarlo en las demás libs.
+
+- [ ] **Step 4: Commit**
+
+```bash
+cd /Users/yhon/fsrc/fiado-http-client
+git add package.json package-lock.json src/
+git commit -m "feat!: bump inversify to v8 as peerDependency
+
+BREAKING CHANGE: requires inversify ^8 in the consumer. inversify ya no
+es dependency directa; ahora es peerDependency para compartir una sola
+instancia con el container del consumidor."
+```
+
+---
+
+## Task 4: Bump a 2.0.0 (sin publicar)
+
+**Files:**
+- Modify: `fiado-http-client/package.json`
+
+- [ ] **Step 1: Subir la versión a 2.0.0**
+
+Run:
+```bash
+cd /Users/yhon/fsrc/fiado-http-client
+npm version 2.0.0 --no-git-tag-version
+```
+Expected: `package.json` queda en `"version": "2.0.0"`.
+
+- [ ] **Step 2: Build limpio y verificación final**
+
+Run:
+```bash
+cd /Users/yhon/fsrc/fiado-http-client && npm run build && npm test
+```
+Expected: build OK + test PASS.
+
+- [ ] **Step 3: Commit y tag (sin publicar a npm)**
+
+```bash
+cd /Users/yhon/fsrc/fiado-http-client
+git add package.json
+git commit -m "2.0.0"
+git tag v2.0.0
+git push origin develop --tags
+```
+
+- [ ] **Step 4: Publicación — EN ESPERA**
+
+> **NO publicar todavía.** Por instrucción del usuario, ninguna lib se publica a
+> npm hasta terminar todos los cambios del set (http-client, gateway-adapter,
+> api-invoker) y tener visto bueno explícito. Cuando se autorice, el publish
+> será (resolviendo antes el token de npm del `.npmrc`, ver spec §Seguridad):
+>
+> ```bash
+> npm publish               # 2.0.0 como dist-tag "latest"
+> npm dist-tag add @fiado/http-client@1.0.10 legacy-v6
+> ```
+
+---
+
+## Self-Review
+
+- **Cobertura del spec:** http-client es la primera lib del §5 del spec; este plan cubre su migración (v8), la creación de la línea de mantenimiento (§6) y deja el publish documentado pero **en espera** (instrucción del usuario). gateway-adapter + api-invoker y las lambdas son planes aparte.
+- **peerDependency:** decisión añadida sobre el spec para garantizar una sola instancia de inversify a través de la frontera lib↔lambda. Coherente con la causa raíz del §2.
+- **Sin placeholders:** todos los pasos tienen comando o código concreto.
+- **Riesgo abierto:** si `container.get` resultara async en 8.x, el Step 3 de Task 3 lo detecta y obliga a actualizar el test; ese hallazgo se documenta para el codemod de las lambdas.