@fiado/type-kit 3.453.0 → 3.455.0

package/src/platformRbac/dtos/TenantUserResponse.ts

@@ -0,0 +1,30 @@
+/** Estados posibles de un usuario del tenant en el RBAC. */
+export type TenantUserStatusValue = 'INVITED' | 'ACTIVE' | 'SUSPENDED' | 'LOCKED' | 'OFFBOARDED' | 'DELETED';
+
+/** Origen del alta del usuario en el RBAC. */
+export type TenantUserSourceValue = 'cognito_trigger' | 'admin_create' | 'self_register';
+
+/**
+ * Proyección pública de un usuario del tenant (SharedUser del RBAC), con sus campos personalizados
+ * y las marcas de su última sesión y su último sync desde Cognito.
+ */
+export interface TenantUserResponse {
+    cognitoSub: string;
+    // DEC-RBAC-079: ausente en un tenant phone-primary sin identificador secundario.
+    email?: string;
+    displayName: string;
+    phone?: string;
+    tenantId: string;
+    status: TenantUserStatusValue;
+    userPoolId?: string;
+    retailerId?: string;
+    storeIds?: string[];
+    source?: TenantUserSourceValue;
+    createdAt: number;
+    updatedAt: number;
+    createdBy?: string;
+    updatedBy?: string;
+    lastLoginAt?: number;
+    lastSyncedFromCognito?: number;
+    customFields?: { [key: string]: string };
+}

package/src/platformRbac/dtos/UpdateLevelEntityRequest.ts

@@ -0,0 +1,11 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
+
+/**
+ * Body del PUT que renombra un grupo. `tenantId`, `level` y el id del grupo viajan en el path.
+ * `actedBy` es el cognitoSub de quien accionó en el backoffice — es lo único que queda en la auditoría.
+ */
+export class UpdateLevelEntityRequest {
+    @Expose() @IsOptional() @IsString() @IsNotEmpty() @MaxLength(120) displayName?: string;
+    @Expose() @IsString() @IsNotEmpty() actedBy!: string;
+}

package/src/platformRbac/dtos/UpdateTenantUserRequest.ts

@@ -0,0 +1,11 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
+
+/**
+ * Body del PUT que renombra a un usuario. El correo es inmutable en el rbac y el grupo se mueve
+ * reasignando el rol, así que aquí no viaja ninguno de los dos.
+ */
+export class UpdateTenantUserRequest {
+    @Expose() @IsOptional() @IsString() @IsNotEmpty() @MaxLength(120) displayName?: string;
+    @Expose() @IsString() @IsNotEmpty() actedBy!: string;
+}

package/src/platformRbac/index.ts

@@ -5,7 +5,7 @@
 // (Permission, PermissionScope, AuthContext, RoleAssignmentInfo) de aquí a `rbac/`.
 //
 // Los DTOs propios del rbac-business se van agregando a medida que los flujos los necesitan.
-// EffectivePermissionsResponse ya vive acá (lo consume jwt-inyector vía /internal/effective-permissions).
+// EffectivePermissionsResponse ya vive aquí (lo consume jwt-inyector vía /internal/effective-permissions).
 // Otros DTOs aún pendientes se sumarán cuando los managers que los consumen se implementen.
 
 export {
@@ -137,7 +137,7 @@ export * from './dtos/SelfRegisterCompleteRequest';
 export * from './dtos/CreateLevelEntityRequest';
 export type { CreateLevelEntityResponse } from './dtos/CreateLevelEntityResponse';
 export * from './dtos/CreateTenantUserRequest';
-export type { CreateTenantUserResponse } from './dtos/CreateTenantUserResponse';
+export type { CreateTenantUserResponse, TenantUserOutcomeValue } from './dtos/CreateTenantUserResponse';
 
 // DEC-RBAC-120/121/126: integraciones M2M con socios externos (API keys como principal del RBAC).
 // Los requests van como clase (class-validator); las responses como tipo.
@@ -150,3 +150,31 @@ export type {
     IssueIntegrationKeyResponse,
 } from './dtos/IntegrationKeyResponse';
 export type { IntegrationWhoamiResponse } from './dtos/IntegrationWhoamiResponse';
+
+// Endpoints privados de administración de RBAC para el hub de agentes — grupos, usuarios y roles.
+// `tenantId` viaja siempre en el path, nunca en el cuerpo.
+// Usan `actedBy`; CreateLevelEntityRequest/CreateTenantUserRequest conservan `createdBy` (contrato publicado que consume retail-org-business).
+export type { LevelEntityResponse } from './dtos/LevelEntityResponse';
+export type { TenantUserResponse, TenantUserStatusValue, TenantUserSourceValue } from './dtos/TenantUserResponse';
+export type { TenantUserAssignmentResponse } from './dtos/TenantUserAssignmentResponse';
+export type { TenantRoleResponse } from './dtos/TenantRoleResponse';
+export type { ListLevelEntitiesResponse } from './dtos/ListLevelEntitiesResponse';
+export * from './dtos/UpdateLevelEntityRequest';
+export * from './dtos/DeleteLevelEntityRequest';
+export type { DeleteLevelEntityResponse } from './dtos/DeleteLevelEntityResponse';
+export type { ListTenantUsersResponse } from './dtos/ListTenantUsersResponse';
+export type { TenantUserListItemResponse } from './dtos/TenantUserListItemResponse';
+export type { GetTenantUserResponse } from './dtos/GetTenantUserResponse';
+export * from './dtos/UpdateTenantUserRequest';
+export * from './dtos/DeleteTenantUserRequest';
+export * from './dtos/DisableTenantUserRequest';
+export * from './dtos/EnableTenantUserRequest';
+export * from './dtos/ResetTenantUserPasswordRequest';
+export type { ResetTenantUserPasswordResponse } from './dtos/ResetTenantUserPasswordResponse';
+export * from './dtos/ResetTenantUserMfaRequest';
+export type { TenantUserAckResponse } from './dtos/TenantUserAckResponse';
+export type { ListTenantRolesResponse } from './dtos/ListTenantRolesResponse';
+export * from './dtos/AssignTenantRoleRequest';
+export type { AssignTenantRoleResponse } from './dtos/AssignTenantRoleResponse';
+export * from './dtos/RevokeTenantRoleRequest';
+export type { RevokeTenantRoleResponse } from './dtos/RevokeTenantRoleResponse';

package/src/transaction/dtos/TransactionCreateRequest.ts

@@ -93,6 +93,21 @@ export class TransactionCreateRequest {
     @IsOptional()
     disputeOrFraudId?: string;
 
+    /**
+     * UUID del `DisputeOrFraudLog` que originó esta transacción (típicamente un
+     * reintegro PCF). Se persiste en `PagoConfiadoTx_GT.disputeOrFraudLogId`, que
+     * indexa el GSI `disputeOrFraudLogId-createdAt-index` usado por el Dashboard
+     * y por el reporte R27 CNBV para conectar el ledger con el folio.
+     *
+     * Antes del rediseño refund/eventos R27 este campo no viajaba en el
+     * `TransactionCreateRequest` y quedaba en "ND" en el ledger — el join
+     * folio↔tx sólo era posible por `disputeOrFraudFolio` (el folio humano), que
+     * no basta cuando un mismo folio genera dos movimientos (REFUND + REVERSAL).
+     */
+    @IsString()
+    @IsOptional()
+    disputeOrFraudLogId?: string;
+
     @IsNotEmpty()
     @IsEnum(CountryId)
     currencyId: CountryId;