@fiado/type-kit 3.131.0 → 3.133.0

package/_test_/unit/platformRbac/enums/PrincipalIdentifierEnum.test.ts

@@ -0,0 +1,10 @@
+import { describe, it, expect } from '@jest/globals';
+import { PrincipalIdentifierEnum } from '../../../../src/platformRbac/enums/PrincipalIdentifierEnum';
+
+describe('PrincipalIdentifierEnum', () => {
+    it('tiene EMAIL y PHONE con esos valores', () => {
+        expect(PrincipalIdentifierEnum.EMAIL).toBe('EMAIL');
+        expect(PrincipalIdentifierEnum.PHONE).toBe('PHONE');
+        expect(Object.values(PrincipalIdentifierEnum)).toEqual(['EMAIL', 'PHONE']);
+    });
+});

package/bin/cognitoBackofficeConnector/dtos/CreatePoolRequest.d.ts

@@ -19,4 +19,9 @@ export declare class CreatePoolRequest {
     passwordPolicy: PasswordPolicyConfig;
     customAttributes: CustomAttributeSpec[];
     appClientConfig: AppClientConfig;
+    /**
+     * DEC-RBAC-079: atributos de sign-in del pool (Cognito UsernameAttributes). Ausente → el connector
+     * default-ea a ['email'] (backward-compatible con los pools ya creados).
+     */
+    usernameAttributes?: Array<'email' | 'phone_number'>;
 }

package/bin/cognitoBackofficeConnector/dtos/CreatePoolRequest.js

@@ -59,3 +59,10 @@ __decorate([
     (0, class_transformer_1.Type)(() => AppClientConfig_1.AppClientConfig),
     __metadata("design:type", AppClientConfig_1.AppClientConfig)
 ], CreatePoolRequest.prototype, "appClientConfig", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsIn)(['email', 'phone_number'], { each: true }),
+    __metadata("design:type", Array)
+], CreatePoolRequest.prototype, "usernameAttributes", void 0);

package/bin/platformRbac/application/Application.d.ts

@@ -1,4 +1,5 @@
 import { PermissionScope } from '../enums/PermissionScope';
+import { PrincipalIdentifierEnum } from '../enums/PrincipalIdentifierEnum';
 import { ApplicationStatus } from '../enums/ApplicationStatus';
 import type { UserFieldDef } from '../dtos/UserFieldDef';
 import type { TokenValidationMode } from '../enums/TokenValidationMode';
@@ -35,6 +36,14 @@ export interface ApplicationDefaults {
     brandingConfig?: ApplicationBrandingDefault;
     tokenValidationMode?: TokenValidationMode;
     autoregister?: AutoregisterConfig;
+    /** DEC-RBAC-079: identificador principal de login que heredan los tenants de esta app. Default EMAIL. */
+    principalIdentifier?: PrincipalIdentifierEnum;
+    /**
+     * DEC-RBAC-081: si la app permite un identificador secundario (el otro método) que el usuario/admin
+     * agrega y verifica después, habilitando login dual. Default false. INMUTABLE (define el
+     * UsernameAttributes del pool): true ⇒ pool con ['email','phone_number']. Heredado al tenant.
+     */
+    allowSecondary?: boolean;
 }
 export interface SeedRole {
     roleId: string;

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

@@ -0,0 +1,8 @@
+/**
+ * DEC-RBAC-079: identificador principal de login de una aplicación. Lo hereda cada tenant (inmutable)
+ * y determina el UsernameAttributes del pool, el campo obligatorio del alta y el canal de mensajes.
+ */
+export declare enum PrincipalIdentifierEnum {
+    EMAIL = "EMAIL",
+    PHONE = "PHONE"
+}

package/bin/platformRbac/enums/PrincipalIdentifierEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrincipalIdentifierEnum = void 0;
+/**
+ * DEC-RBAC-079: identificador principal de login de una aplicación. Lo hereda cada tenant (inmutable)
+ * y determina el UsernameAttributes del pool, el campo obligatorio del alta y el canal de mensajes.
+ */
+var PrincipalIdentifierEnum;
+(function (PrincipalIdentifierEnum) {
+    PrincipalIdentifierEnum["EMAIL"] = "EMAIL";
+    PrincipalIdentifierEnum["PHONE"] = "PHONE";
+})(PrincipalIdentifierEnum || (exports.PrincipalIdentifierEnum = PrincipalIdentifierEnum = {}));

package/bin/platformRbac/index.d.ts

@@ -1,6 +1,7 @@
 export { Permission, PERMISSION_BIT_ORDER, PERMS_VERSION, permissionsToBits, bitsToPermissions, } from './enums/Permission';
 export { PermissionScope } from './enums/PermissionScope';
 export { PermissionCategory } from './enums/PermissionCategory';
+export { PrincipalIdentifierEnum } from './enums/PrincipalIdentifierEnum';
 export type { AuthContext } from './dtos/AuthContext';
 export type { RoleAssignmentInfo } from './dtos/RoleAssignmentInfo';
 export type { PermissionMeta } from './dtos/PermissionMeta';

package/bin/platformRbac/index.js

@@ -23,7 +23,7 @@ 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 });
-exports.UserFieldType = exports.scopeRankOrder = exports.tableSuffixForLevel = exports.levelsOf = exports.TENANT_TYPES = exports.TenantType = exports.AuthorizeDenyReason = exports.PermissionCategory = exports.PermissionScope = exports.bitsToPermissions = exports.permissionsToBits = exports.PERMS_VERSION = exports.PERMISSION_BIT_ORDER = exports.Permission = void 0;
+exports.UserFieldType = exports.scopeRankOrder = exports.tableSuffixForLevel = exports.levelsOf = exports.TENANT_TYPES = exports.TenantType = exports.AuthorizeDenyReason = exports.PrincipalIdentifierEnum = exports.PermissionCategory = exports.PermissionScope = exports.bitsToPermissions = exports.permissionsToBits = exports.PERMS_VERSION = exports.PERMISSION_BIT_ORDER = exports.Permission = void 0;
 var Permission_1 = require("./enums/Permission");
 Object.defineProperty(exports, "Permission", { enumerable: true, get: function () { return Permission_1.Permission; } });
 Object.defineProperty(exports, "PERMISSION_BIT_ORDER", { enumerable: true, get: function () { return Permission_1.PERMISSION_BIT_ORDER; } });
@@ -34,6 +34,9 @@ var PermissionScope_1 = require("./enums/PermissionScope");
 Object.defineProperty(exports, "PermissionScope", { enumerable: true, get: function () { return PermissionScope_1.PermissionScope; } });
 var PermissionCategory_1 = require("./enums/PermissionCategory");
 Object.defineProperty(exports, "PermissionCategory", { enumerable: true, get: function () { return PermissionCategory_1.PermissionCategory; } });
+// DEC-RBAC-079: identificador principal de login por aplicación (heredado por tenant).
+var PrincipalIdentifierEnum_1 = require("./enums/PrincipalIdentifierEnum");
+Object.defineProperty(exports, "PrincipalIdentifierEnum", { enumerable: true, get: function () { return PrincipalIdentifierEnum_1.PrincipalIdentifierEnum; } });
 // 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);

package/bin/remittance/dtos/RemittanceUserLimits.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Límites por usuario para el backoffice de Operación (pantalla Límites, read-only).
+ *
+ * Los LÍMITES los define el provider (UNIR): `UserCreditLimit` (Wlp Wallet daily/weekly
+ * + levelName) + `UserComplianceLimit` (ventanas 4/14/30/60/90 d). El **usage** NO lo
+ * expone UNIR (txAggregate da 403) → lo calcula el connector sumando las tx no-canceladas
+ * por ventana móvil. `limitUSD` es null cuando el provider no envía ese límite (d180, B3).
+ */
+export declare class RemittanceLimitWindow {
+    /** Ventana en días: 1 | 4 | 7 | 14 | 30 | 60 | 90 | 180. */
+    windowDays: number;
+    /** Límite USD del provider; null si UNIR no lo da (p.ej. d180). */
+    limitUSD: number | null;
+    /** Consumo USD calculado desde nuestras tx (rolling window, no-canceladas). */
+    usedUSD: number;
+    /** Procedencia del límite: d1/d7 de UserCreditLimit; el resto de UserComplianceLimit. */
+    source: "credit" | "compliance";
+}
+export declare class RemittanceUserLimits {
+    directoryId: string;
+    /** Nivel de UserProfileInfo.remitterLevel (display). null si no se pudo leer. */
+    profileLevel: string | null;
+    /** Nivel de UserCreditLimit.levelName (el efectivo que enforza el provider). */
+    creditLevel: string | null;
+    /** profileLevel !== creditLevel (ambos no-null). Bug real del provider; se marca, no se corrige. */
+    discrepancy: boolean;
+    /** Ventanas con límite (provider) + consumo (calculado). */
+    windows: RemittanceLimitWindow[];
+    /** ISO — cuándo se trajeron los límites del provider (para el FreshnessBadge). */
+    lastSyncedAt: string;
+}
+export declare class RemittanceUserLimitsBatchResponse {
+    items: RemittanceUserLimits[];
+}

package/bin/remittance/dtos/RemittanceUserLimits.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemittanceUserLimitsBatchResponse = exports.RemittanceUserLimits = exports.RemittanceLimitWindow = void 0;
+/**
+ * Límites por usuario para el backoffice de Operación (pantalla Límites, read-only).
+ *
+ * Los LÍMITES los define el provider (UNIR): `UserCreditLimit` (Wlp Wallet daily/weekly
+ * + levelName) + `UserComplianceLimit` (ventanas 4/14/30/60/90 d). El **usage** NO lo
+ * expone UNIR (txAggregate da 403) → lo calcula el connector sumando las tx no-canceladas
+ * por ventana móvil. `limitUSD` es null cuando el provider no envía ese límite (d180, B3).
+ */
+class RemittanceLimitWindow {
+}
+exports.RemittanceLimitWindow = RemittanceLimitWindow;
+class RemittanceUserLimits {
+}
+exports.RemittanceUserLimits = RemittanceUserLimits;
+class RemittanceUserLimitsBatchResponse {
+}
+exports.RemittanceUserLimitsBatchResponse = RemittanceUserLimitsBatchResponse;

package/bin/remittance/dtos/index.d.ts

@@ -34,3 +34,4 @@ export * from "./RemittanceBackofficeUserDetail";
 export * from "./RemittanceBackofficeUserListResponse";
 export * from "./RemittanceBackofficeTxListResponse";
 export * from "./RemittanceBackofficeStats";
+export * from "./RemittanceUserLimits";

package/bin/remittance/dtos/index.js

@@ -50,3 +50,4 @@ __exportStar(require("./RemittanceBackofficeUserDetail"), exports);
 __exportStar(require("./RemittanceBackofficeUserListResponse"), exports);
 __exportStar(require("./RemittanceBackofficeTxListResponse"), exports);
 __exportStar(require("./RemittanceBackofficeStats"), exports);
+__exportStar(require("./RemittanceUserLimits"), exports);

package/package.json

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

package/src/cognitoBackofficeConnector/dtos/CreatePoolRequest.ts

@@ -1,5 +1,5 @@
 import { Expose, Type } from 'class-transformer';
-import { IsArray, IsString, ValidateNested } from 'class-validator';
+import { IsArray, IsIn, IsOptional, IsString, ValidateNested } from 'class-validator';
 import { PasswordPolicyConfig } from './PasswordPolicyConfig';
 import { CustomAttributeSpec } from './CustomAttributeSpec';
 import { AppClientConfig } from './AppClientConfig';
@@ -28,4 +28,14 @@ export class CreatePoolRequest {
 
     @Expose() @ValidateNested() @Type(() => AppClientConfig)
     appClientConfig!: AppClientConfig;
+
+    /**
+     * DEC-RBAC-079: atributos de sign-in del pool (Cognito UsernameAttributes). Ausente → el connector
+     * default-ea a ['email'] (backward-compatible con los pools ya creados).
+     */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsIn(['email', 'phone_number'], { each: true })
+    usernameAttributes?: Array<'email' | 'phone_number'>;
 }

package/src/platformRbac/application/Application.ts

@@ -1,4 +1,5 @@
 import { PermissionScope } from '../enums/PermissionScope';
+import { PrincipalIdentifierEnum } from '../enums/PrincipalIdentifierEnum';
 import { ApplicationStatus } from '../enums/ApplicationStatus';
 import type { UserFieldDef } from '../dtos/UserFieldDef';
 import type { TokenValidationMode } from '../enums/TokenValidationMode';
@@ -45,6 +46,14 @@ export interface ApplicationDefaults {
     brandingConfig?: ApplicationBrandingDefault;
     tokenValidationMode?: TokenValidationMode;
     autoregister?: AutoregisterConfig;
+    /** DEC-RBAC-079: identificador principal de login que heredan los tenants de esta app. Default EMAIL. */
+    principalIdentifier?: PrincipalIdentifierEnum;
+    /**
+     * DEC-RBAC-081: si la app permite un identificador secundario (el otro método) que el usuario/admin
+     * agrega y verifica después, habilitando login dual. Default false. INMUTABLE (define el
+     * UsernameAttributes del pool): true ⇒ pool con ['email','phone_number']. Heredado al tenant.
+     */
+    allowSecondary?: boolean;
 }
 
 export interface SeedRole {

package/src/platformRbac/enums/PrincipalIdentifierEnum.ts

@@ -0,0 +1,8 @@
+/**
+ * DEC-RBAC-079: identificador principal de login de una aplicación. Lo hereda cada tenant (inmutable)
+ * y determina el UsernameAttributes del pool, el campo obligatorio del alta y el canal de mensajes.
+ */
+export enum PrincipalIdentifierEnum {
+    EMAIL = 'EMAIL',
+    PHONE = 'PHONE',
+}

package/src/platformRbac/index.ts

@@ -17,6 +17,8 @@ export {
 } from './enums/Permission';
 export { PermissionScope } from './enums/PermissionScope';
 export { PermissionCategory } from './enums/PermissionCategory';
+// DEC-RBAC-079: identificador principal de login por aplicación (heredado por tenant).
+export { PrincipalIdentifierEnum } from './enums/PrincipalIdentifierEnum';
 
 export type { AuthContext } from './dtos/AuthContext';
 export type { RoleAssignmentInfo } from './dtos/RoleAssignmentInfo';

package/src/remittance/dtos/RemittanceUserLimits.ts

@@ -0,0 +1,36 @@
+/**
+ * Límites por usuario para el backoffice de Operación (pantalla Límites, read-only).
+ *
+ * Los LÍMITES los define el provider (UNIR): `UserCreditLimit` (Wlp Wallet daily/weekly
+ * + levelName) + `UserComplianceLimit` (ventanas 4/14/30/60/90 d). El **usage** NO lo
+ * expone UNIR (txAggregate da 403) → lo calcula el connector sumando las tx no-canceladas
+ * por ventana móvil. `limitUSD` es null cuando el provider no envía ese límite (d180, B3).
+ */
+export class RemittanceLimitWindow {
+    /** Ventana en días: 1 | 4 | 7 | 14 | 30 | 60 | 90 | 180. */
+    windowDays!: number;
+    /** Límite USD del provider; null si UNIR no lo da (p.ej. d180). */
+    limitUSD!: number | null;
+    /** Consumo USD calculado desde nuestras tx (rolling window, no-canceladas). */
+    usedUSD!: number;
+    /** Procedencia del límite: d1/d7 de UserCreditLimit; el resto de UserComplianceLimit. */
+    source!: "credit" | "compliance";
+}
+
+export class RemittanceUserLimits {
+    directoryId!: string;
+    /** Nivel de UserProfileInfo.remitterLevel (display). null si no se pudo leer. */
+    profileLevel!: string | null;
+    /** Nivel de UserCreditLimit.levelName (el efectivo que enforza el provider). */
+    creditLevel!: string | null;
+    /** profileLevel !== creditLevel (ambos no-null). Bug real del provider; se marca, no se corrige. */
+    discrepancy!: boolean;
+    /** Ventanas con límite (provider) + consumo (calculado). */
+    windows!: RemittanceLimitWindow[];
+    /** ISO — cuándo se trajeron los límites del provider (para el FreshnessBadge). */
+    lastSyncedAt!: string;
+}
+
+export class RemittanceUserLimitsBatchResponse {
+    items!: RemittanceUserLimits[];
+}

package/src/remittance/dtos/index.ts

@@ -34,3 +34,4 @@ export * from "./RemittanceBackofficeUserDetail";
 export * from "./RemittanceBackofficeUserListResponse";
 export * from "./RemittanceBackofficeTxListResponse";
 export * from "./RemittanceBackofficeStats";
+export * from "./RemittanceUserLimits";