@fiado/type-kit 3.127.0 → 3.128.0

package/_test_/unit/platformRbac/dtos/CreateTenantRequest.test.ts

@@ -60,6 +60,48 @@ describe('CreateTenantRequest', () => {
         expect(errors.some(e => e.property === 'tenantType')).toBe(true);
     });
 
+    it('valida con securityPolicy omitido (opcional — hereda app.defaults)', async () => {
+        const dto = plainToInstance(CreateTenantRequest, valid);
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+        expect(dto.securityPolicy).toBeUndefined();
+    });
+
+    it('valida securityPolicy con métodos válidos y mfaEnabled', async () => {
+        const dto = plainToInstance(CreateTenantRequest, {
+            ...valid,
+            securityPolicy: { methodsAllowed: ['EMAIL', 'TOTP'], mfaEnabled: true },
+        });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+        expect(dto.securityPolicy?.methodsAllowed).toEqual(['EMAIL', 'TOTP']);
+        expect(dto.securityPolicy?.mfaEnabled).toBe(true);
+    });
+
+    it('valida securityPolicy con ambos campos opcionales ausentes (objeto vacío)', async () => {
+        const dto = plainToInstance(CreateTenantRequest, { ...valid, securityPolicy: {} });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it('falla si securityPolicy.methodsAllowed tiene un método fuera del value-set', async () => {
+        const dto = plainToInstance(CreateTenantRequest, {
+            ...valid,
+            securityPolicy: { methodsAllowed: ['SMS'] },
+        });
+        const errors = await validate(dto);
+        expect(errors.some(e => e.property === 'securityPolicy')).toBe(true);
+    });
+
+    it('falla si securityPolicy.mfaEnabled no es boolean', async () => {
+        const dto = plainToInstance(CreateTenantRequest, {
+            ...valid,
+            securityPolicy: { mfaEnabled: 'si' },
+        });
+        const errors = await validate(dto);
+        expect(errors.some(e => e.property === 'securityPolicy')).toBe(true);
+    });
+
     it('NO expone temporaryPassword en el request (campo del response, no del body)', () => {
         // El request NO debe llevar temporaryPassword (es solo del response, fallback out-of-band F-11).
         // Con excludeExtraneousValues solo sobreviven las props @Expose() del DTO → el contrato lo excluye.

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

@@ -1,5 +1,18 @@
 import { TokenValidationMode } from '../enums/TokenValidationMode';
 import { TenantType } from '../tenantTypes';
+/**
+ * Punto inicial de la política 2FA elegido en el alta del tenant (DEC-RBAC-064). Para el CREATE
+ * ambos campos son OPCIONALES: es un override del punto de partida — si se omite, el onboarding
+ * hereda de `app.defaults.securityPolicy`.
+ *
+ * TD-RBAC-071: `methodsAllowed` usa el value-set 'EMAIL'|'TOTP' (string), espejo del que usa
+ * `UpdateTenantSecurityPolicyRequest`. NO se reusa ese DTO porque allí `methodsAllowed` es REQUERIDO
+ * (@ArrayNotEmpty); en el create es opcional.
+ */
+export declare class CreateTenantSecurityPolicy {
+    methodsAllowed?: ('EMAIL' | 'TOTP')[];
+    mfaEnabled?: boolean;
+}
 /**
  * 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,
@@ -28,4 +41,9 @@ export declare class CreateTenantRequest {
     tenantType?: TenantType;
     /** DEC-RBAC-034: aplicación (plantilla) de la que se crea el tenant; opcional, fallback a tenantType (back-compat). */
     applicationId?: string;
+    /**
+     * DEC-RBAC-064: punto inicial de métodos 2FA elegido en el alta. Opcional: si se omite, el
+     * onboarding hereda `app.defaults.securityPolicy`. Aditivo, no rompe altas existentes.
+     */
+    securityPolicy?: CreateTenantSecurityPolicy;
 }

package/bin/platformRbac/dtos/CreateTenantRequest.js

@@ -9,11 +9,36 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateTenantRequest = void 0;
+exports.CreateTenantRequest = exports.CreateTenantSecurityPolicy = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const TokenValidationMode_1 = require("../enums/TokenValidationMode");
 const tenantTypes_1 = require("../tenantTypes");
+/**
+ * Punto inicial de la política 2FA elegido en el alta del tenant (DEC-RBAC-064). Para el CREATE
+ * ambos campos son OPCIONALES: es un override del punto de partida — si se omite, el onboarding
+ * hereda de `app.defaults.securityPolicy`.
+ *
+ * TD-RBAC-071: `methodsAllowed` usa el value-set 'EMAIL'|'TOTP' (string), espejo del que usa
+ * `UpdateTenantSecurityPolicyRequest`. NO se reusa ese DTO porque allí `methodsAllowed` es REQUERIDO
+ * (@ArrayNotEmpty); en el create es opcional.
+ */
+class CreateTenantSecurityPolicy {
+}
+exports.CreateTenantSecurityPolicy = CreateTenantSecurityPolicy;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsIn)(['EMAIL', 'TOTP'], { each: true }),
+    __metadata("design:type", Array)
+], CreateTenantSecurityPolicy.prototype, "methodsAllowed", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], CreateTenantSecurityPolicy.prototype, "mfaEnabled", void 0);
 /**
  * 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,
@@ -75,3 +100,10 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], CreateTenantRequest.prototype, "applicationId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => CreateTenantSecurityPolicy),
+    __metadata("design:type", CreateTenantSecurityPolicy)
+], CreateTenantRequest.prototype, "securityPolicy", void 0);

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

@@ -0,0 +1,22 @@
+import { MfaMethodEnum } from '../enums/MfaMethodEnum';
+/**
+ * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
+ * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
+ * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
+ * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
+ */
+export declare class ResendOtpRequest {
+    email: string;
+    tenantId: string;
+}
+/**
+ * Respuesta del resend-otp. `session`/`mfaMethod` frescos del nuevo challenge CUSTOM_AUTH.
+ * Plain sin validators (no validamos lo que mandamos al cliente — fiado-validation-and-dtos § 7).
+ * Ambos opcionales: en los caminos de rechazo silencioso (anti-enumeración) o ramas sin CUSTOM_AUTH
+ * el server responde 200 genérico sin session ni método.
+ */
+export interface ResendOtpResponse {
+    session?: string;
+    mfaMethod?: MfaMethodEnum;
+}

package/bin/platformRbac/dtos/{CompleteMyProfileRequest.js → ResendOtpRequest.js}

@@ -9,26 +9,28 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CompleteMyProfileRequest = void 0;
+exports.ResendOtpRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 /**
- * Body del PUT /me/profile/complete (autenticado, gate post-MFA del autoregistro). DEC-RBAC-034.
- * Opera sobre el propio usuario (cognitoSub del token). Valida nombre + los `userFieldDefs` requeridos
- * del tenant (422 MISSING_REQUIRED_FIELDS si faltan) y flipea `profileComplete=true`.
+ * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
+ * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
+ * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
+ * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
  */
-class CompleteMyProfileRequest {
+class ResendOtpRequest {
 }
-exports.CompleteMyProfileRequest = CompleteMyProfileRequest;
+exports.ResendOtpRequest = ResendOtpRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsEmail)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
-], CompleteMyProfileRequest.prototype, "displayName", void 0);
+], ResendOtpRequest.prototype, "email", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsObject)(),
-    __metadata("design:type", Object)
-], CompleteMyProfileRequest.prototype, "customFields", void 0);
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendOtpRequest.prototype, "tenantId", void 0);

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

@@ -0,0 +1,11 @@
+/**
+ * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
+ * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
+ * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
+ * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
+ */
+export declare class ResendSelfRegisterOtpRequest {
+    tenantId: string;
+    email: string;
+}

package/bin/platformRbac/dtos/ResendSelfRegisterOtpRequest.js

@@ -0,0 +1,36 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResendSelfRegisterOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
+ * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
+ * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
+ * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
+ */
+class ResendSelfRegisterOtpRequest {
+}
+exports.ResendSelfRegisterOtpRequest = ResendSelfRegisterOtpRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendSelfRegisterOtpRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendSelfRegisterOtpRequest.prototype, "email", void 0);

package/package.json

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

package/src/platformRbac/dtos/CreateTenantRequest.ts

@@ -1,8 +1,35 @@
-import { Expose } from 'class-transformer';
-import { IsEmail, IsEnum, IsOptional, IsString, Matches } from 'class-validator';
+import { Expose, Type } from 'class-transformer';
+import {
+    IsArray,
+    IsBoolean,
+    IsEmail,
+    IsEnum,
+    IsIn,
+    IsOptional,
+    IsString,
+    Matches,
+    ValidateNested,
+} from 'class-validator';
 import { TokenValidationMode } from '../enums/TokenValidationMode';
 import { TenantType } from '../tenantTypes';
 
+/**
+ * Punto inicial de la política 2FA elegido en el alta del tenant (DEC-RBAC-064). Para el CREATE
+ * ambos campos son OPCIONALES: es un override del punto de partida — si se omite, el onboarding
+ * hereda de `app.defaults.securityPolicy`.
+ *
+ * TD-RBAC-071: `methodsAllowed` usa el value-set 'EMAIL'|'TOTP' (string), espejo del que usa
+ * `UpdateTenantSecurityPolicyRequest`. NO se reusa ese DTO porque allí `methodsAllowed` es REQUERIDO
+ * (@ArrayNotEmpty); en el create es opcional.
+ */
+export class CreateTenantSecurityPolicy {
+    @Expose() @IsOptional() @IsArray() @IsIn(['EMAIL', 'TOTP'], { each: true })
+    methodsAllowed?: ('EMAIL' | 'TOTP')[];
+
+    @Expose() @IsOptional() @IsBoolean()
+    mfaEnabled?: boolean;
+}
+
 /**
  * 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,
@@ -34,4 +61,10 @@ export class CreateTenantRequest {
     @Expose() @IsOptional() @IsEnum(TenantType) tenantType?: TenantType;
     /** DEC-RBAC-034: aplicación (plantilla) de la que se crea el tenant; opcional, fallback a tenantType (back-compat). */
     @Expose() @IsOptional() @IsString() applicationId?: string;
+    /**
+     * DEC-RBAC-064: punto inicial de métodos 2FA elegido en el alta. Opcional: si se omite, el
+     * onboarding hereda `app.defaults.securityPolicy`. Aditivo, no rompe altas existentes.
+     */
+    @Expose() @IsOptional() @ValidateNested() @Type(() => CreateTenantSecurityPolicy)
+    securityPolicy?: CreateTenantSecurityPolicy;
 }

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

@@ -1,9 +0,0 @@
-/**
- * Body del PUT /me/profile/complete (autenticado, gate post-MFA del autoregistro). DEC-RBAC-034.
- * Opera sobre el propio usuario (cognitoSub del token). Valida nombre + los `userFieldDefs` requeridos
- * del tenant (422 MISSING_REQUIRED_FIELDS si faltan) y flipea `profileComplete=true`.
- */
-export declare class CompleteMyProfileRequest {
-    displayName: string;
-    customFields?: Record<string, string>;
-}

package/bin/walletFunding/dtos/CancelFundingReferenceRequest.d.ts

@@ -1,14 +0,0 @@
-/**
- * Body para cancelar una referencia de funding ya creada. La referencia/fundingId
- * viaja en la URL (`/funding/{moduleName}/{fundingId}/cancel`); este body aporta
- * el contexto del solicitante + idempotencia.
- *
- * NOTA: shape inferido desde el uso en `@fiado/api-invoker`
- * (benefits-marketplace / equality-connector) — confirmar con el dueño del
- * módulo walletFunding / el lambda equality-connector que implementa el cancel.
- */
-export declare class CancelFundingReferenceRequest {
-    directoryId: string;
-    reason?: string;
-    idempotencyKey: string;
-}

package/bin/walletFunding/dtos/CancelFundingReferenceRequest.js

@@ -1,41 +0,0 @@
-"use strict";
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CancelFundingReferenceRequest = void 0;
-const class_validator_1 = require("class-validator");
-/**
- * Body para cancelar una referencia de funding ya creada. La referencia/fundingId
- * viaja en la URL (`/funding/{moduleName}/{fundingId}/cancel`); este body aporta
- * el contexto del solicitante + idempotencia.
- *
- * NOTA: shape inferido desde el uso en `@fiado/api-invoker`
- * (benefits-marketplace / equality-connector) — confirmar con el dueño del
- * módulo walletFunding / el lambda equality-connector que implementa el cancel.
- */
-class CancelFundingReferenceRequest {
-}
-exports.CancelFundingReferenceRequest = CancelFundingReferenceRequest;
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(64),
-    __metadata("design:type", String)
-], CancelFundingReferenceRequest.prototype, "directoryId", void 0);
-__decorate([
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(256),
-    __metadata("design:type", String)
-], CancelFundingReferenceRequest.prototype, "reason", void 0);
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(64),
-    __metadata("design:type", String)
-], CancelFundingReferenceRequest.prototype, "idempotencyKey", void 0);

package/bin/walletFunding/dtos/CancelFundingReferenceResponse.d.ts

@@ -1,15 +0,0 @@
-import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
-import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
-/**
- * Respuesta de la cancelación de una referencia de funding. Mismo estilo que
- * CreateFundingReferenceResponse.
- *
- * NOTA: shape inferido desde el uso en `@fiado/api-invoker` — confirmar con el
- * dueño del módulo walletFunding / el lambda equality-connector.
- */
-export declare class CancelFundingReferenceResponse {
-    /** Referencia cancelada (misma PK que se creó). */
-    reference: string;
-    status: BenefitPaymentStatusEnum;
-    errorCode?: WalletFundingErrorCodeEnum;
-}

package/bin/walletFunding/dtos/CancelFundingReferenceResponse.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CancelFundingReferenceResponse = void 0;
-/**
- * Respuesta de la cancelación de una referencia de funding. Mismo estilo que
- * CreateFundingReferenceResponse.
- *
- * NOTA: shape inferido desde el uso en `@fiado/api-invoker` — confirmar con el
- * dueño del módulo walletFunding / el lambda equality-connector.
- */
-class CancelFundingReferenceResponse {
-}
-exports.CancelFundingReferenceResponse = CancelFundingReferenceResponse;

package/bin/walletFunding/dtos/CancelWalletFundingRequest.d.ts

@@ -1,3 +0,0 @@
-export declare class CancelWalletFundingRequest {
-    idempotencyKey: string;
-}

package/bin/walletFunding/dtos/CancelWalletFundingRequest.js

@@ -1,21 +0,0 @@
-"use strict";
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CancelWalletFundingRequest = void 0;
-const class_validator_1 = require("class-validator");
-class CancelWalletFundingRequest {
-}
-exports.CancelWalletFundingRequest = CancelWalletFundingRequest;
-__decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(64),
-    __metadata("design:type", String)
-], CancelWalletFundingRequest.prototype, "idempotencyKey", void 0);

package/bin/walletFunding/dtos/CancelWalletFundingResponse.d.ts

@@ -1,7 +0,0 @@
-import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
-import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
-export declare class CancelWalletFundingResponse {
-    status: BenefitPaymentStatusEnum;
-    errorCode?: WalletFundingErrorCodeEnum;
-    fundingId?: string;
-}

package/bin/walletFunding/dtos/CancelWalletFundingResponse.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CancelWalletFundingResponse = void 0;
-class CancelWalletFundingResponse {
-}
-exports.CancelWalletFundingResponse = CancelWalletFundingResponse;