@fiado/type-kit 3.140.0 → 3.142.0

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

@@ -36,3 +36,5 @@ export * from "./RemittanceBackofficeTxListResponse";
 export * from "./RemittanceBackofficeStats";
 export * from "./RemittanceUserLimits";
 export * from "./RemittanceKyc";
+export * from "./RemittanceCohort";
+export * from "./RemittanceAuditLog";

package/bin/remittance/dtos/index.js

@@ -52,3 +52,5 @@ __exportStar(require("./RemittanceBackofficeTxListResponse"), exports);
 __exportStar(require("./RemittanceBackofficeStats"), exports);
 __exportStar(require("./RemittanceUserLimits"), exports);
 __exportStar(require("./RemittanceKyc"), exports);
+__exportStar(require("./RemittanceCohort"), exports);
+__exportStar(require("./RemittanceAuditLog"), exports);

package/bin/remittance/dtos/internal/RemittanceCohortCount.d.ts

@@ -0,0 +1,16 @@
+import { CohortCondition } from "../RemittanceCohort";
+/**
+ * Contrato interno del puente de recálculo de Cohorts (Opción A):
+ * remittance-business pide al uniteller-connector (dueño de RemittanceUsers_GT /
+ * RemittanceTransactions_GT) cuántos usuarios cumplen las condiciones, vía
+ * api-invoker → POST /backoffice/config/cohorts/count (privado).
+ */
+export declare class CohortCountRequest {
+    conditions: CohortCondition[];
+}
+export declare class CohortCountResponse {
+    /** Usuarios que cumplen TODAS las condiciones (AND). */
+    count: number;
+    /** Universo total de RemittanceUsers (denominador del % — todos, no solo ACTIVE). */
+    total: number;
+}

package/bin/remittance/dtos/internal/RemittanceCohortCount.js

@@ -0,0 +1,34 @@
+"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.CohortCountResponse = exports.CohortCountRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const RemittanceCohort_1 = require("../RemittanceCohort");
+/**
+ * Contrato interno del puente de recálculo de Cohorts (Opción A):
+ * remittance-business pide al uniteller-connector (dueño de RemittanceUsers_GT /
+ * RemittanceTransactions_GT) cuántos usuarios cumplen las condiciones, vía
+ * api-invoker → POST /backoffice/config/cohorts/count (privado).
+ */
+class CohortCountRequest {
+}
+exports.CohortCountRequest = CohortCountRequest;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => RemittanceCohort_1.CohortCondition),
+    __metadata("design:type", Array)
+], CohortCountRequest.prototype, "conditions", void 0);
+class CohortCountResponse {
+}
+exports.CohortCountResponse = CohortCountResponse;

package/bin/remittance/enums/AuditAction.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Acción registrada en el audit trail del backoffice de remesas (RemittanceAuditLog_GT).
+ * SUSPEND/REACTIVATE quedan listos para el flujo futuro de Operación (EP-02/03).
+ */
+export declare enum AuditAction {
+    CREATE = "CREATE",
+    UPDATE = "UPDATE",
+    DELETE = "DELETE",
+    RECALCULATE = "RECALCULATE",
+    SUSPEND = "SUSPEND",
+    REACTIVATE = "REACTIVATE"
+}

package/bin/remittance/enums/AuditAction.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditAction = void 0;
+/**
+ * Acción registrada en el audit trail del backoffice de remesas (RemittanceAuditLog_GT).
+ * SUSPEND/REACTIVATE quedan listos para el flujo futuro de Operación (EP-02/03).
+ */
+var AuditAction;
+(function (AuditAction) {
+    AuditAction["CREATE"] = "CREATE";
+    AuditAction["UPDATE"] = "UPDATE";
+    AuditAction["DELETE"] = "DELETE";
+    AuditAction["RECALCULATE"] = "RECALCULATE";
+    AuditAction["SUSPEND"] = "SUSPEND";
+    AuditAction["REACTIVATE"] = "REACTIVATE";
+})(AuditAction || (exports.AuditAction = AuditAction = {}));

package/bin/remittance/enums/AuditEntityType.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Módulo/dominio afectado por una entrada del audit trail (PK de RemittanceAuditLog_GT).
+ */
+export declare enum AuditEntityType {
+    COHORT = "COHORT",
+    COMMITTEE = "COMMITTEE",
+    SEGMENT = "SEGMENT",
+    PRICING = "PRICING",
+    PROMOTION = "PROMOTION",
+    RULE = "RULE",
+    USER = "USER"
+}

package/bin/remittance/enums/AuditEntityType.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditEntityType = void 0;
+/**
+ * Módulo/dominio afectado por una entrada del audit trail (PK de RemittanceAuditLog_GT).
+ */
+var AuditEntityType;
+(function (AuditEntityType) {
+    AuditEntityType["COHORT"] = "COHORT";
+    AuditEntityType["COMMITTEE"] = "COMMITTEE";
+    AuditEntityType["SEGMENT"] = "SEGMENT";
+    AuditEntityType["PRICING"] = "PRICING";
+    AuditEntityType["PROMOTION"] = "PROMOTION";
+    AuditEntityType["RULE"] = "RULE";
+    AuditEntityType["USER"] = "USER";
+})(AuditEntityType || (exports.AuditEntityType = AuditEntityType = {}));

package/bin/remittance/enums/CohortField.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Campos conductuales del rule builder de Cohorts (Dashboard Ops · Configuración §3).
+ * Los valores son los del mockup (snake_case) para que el front no traduzca.
+ *
+ * MVP soporta 6 campos; TX_POST_REACTIVACION está DIFERIDO (el backend lo rechaza
+ * hasta que exista el contador denormalizado `txSinceReactivation` en el connector).
+ */
+export declare enum CohortField {
+    /** # de tx totales (RemittanceUsers_GT.txCount). */
+    TX_TOTALES = "tx_totales",
+    /** Días desde el signup (now − (unirSignupDate ?? createdAt)). */
+    DIAS_DESDE_SIGNUP = "dias_desde_signup",
+    /** Días desde la última tx (now − lastTxAt). */
+    DIAS_DESDE_ULTIMA_TX = "dias_desde_ultima_tx",
+    /** Días sin actividad — sinónimo de DIAS_DESDE_ULTIMA_TX. */
+    DIAS_SIN_TX = "dias_sin_tx",
+    /** Monto total histórico en USD (RemittanceUsers_GT.totalSentUSD). */
+    MONTO_TOTAL_HISTORICO = "monto_total_historico",
+    /** Tx en los últimos 30 días (query nivel-tx por usuario). */
+    TX_ULTIMOS_30_DIAS = "tx_ultimos_30_dias",
+    /** # de tx tras reactivación — DIFERIDO (no-MVP, el backend lo rechaza). */
+    TX_POST_REACTIVACION = "tx_post_reactivacion"
+}

package/bin/remittance/enums/CohortField.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CohortField = void 0;
+/**
+ * Campos conductuales del rule builder de Cohorts (Dashboard Ops · Configuración §3).
+ * Los valores son los del mockup (snake_case) para que el front no traduzca.
+ *
+ * MVP soporta 6 campos; TX_POST_REACTIVACION está DIFERIDO (el backend lo rechaza
+ * hasta que exista el contador denormalizado `txSinceReactivation` en el connector).
+ */
+var CohortField;
+(function (CohortField) {
+    /** # de tx totales (RemittanceUsers_GT.txCount). */
+    CohortField["TX_TOTALES"] = "tx_totales";
+    /** Días desde el signup (now − (unirSignupDate ?? createdAt)). */
+    CohortField["DIAS_DESDE_SIGNUP"] = "dias_desde_signup";
+    /** Días desde la última tx (now − lastTxAt). */
+    CohortField["DIAS_DESDE_ULTIMA_TX"] = "dias_desde_ultima_tx";
+    /** Días sin actividad — sinónimo de DIAS_DESDE_ULTIMA_TX. */
+    CohortField["DIAS_SIN_TX"] = "dias_sin_tx";
+    /** Monto total histórico en USD (RemittanceUsers_GT.totalSentUSD). */
+    CohortField["MONTO_TOTAL_HISTORICO"] = "monto_total_historico";
+    /** Tx en los últimos 30 días (query nivel-tx por usuario). */
+    CohortField["TX_ULTIMOS_30_DIAS"] = "tx_ultimos_30_dias";
+    /** # de tx tras reactivación — DIFERIDO (no-MVP, el backend lo rechaza). */
+    CohortField["TX_POST_REACTIVACION"] = "tx_post_reactivacion";
+})(CohortField || (exports.CohortField = CohortField = {}));

package/bin/remittance/enums/CohortOperator.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Operadores de comparación del rule builder de Cohorts. Los valores son los
+ * símbolos que renderiza el mockup; todas las condiciones se evalúan en AND.
+ */
+export declare enum CohortOperator {
+    LT = "<",
+    LTE = "<=",
+    EQ = "==",
+    GTE = ">=",
+    GT = ">"
+}

package/bin/remittance/enums/CohortOperator.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CohortOperator = void 0;
+/**
+ * Operadores de comparación del rule builder de Cohorts. Los valores son los
+ * símbolos que renderiza el mockup; todas las condiciones se evalúan en AND.
+ */
+var CohortOperator;
+(function (CohortOperator) {
+    CohortOperator["LT"] = "<";
+    CohortOperator["LTE"] = "<=";
+    CohortOperator["EQ"] = "==";
+    CohortOperator["GTE"] = ">=";
+    CohortOperator["GT"] = ">";
+})(CohortOperator || (exports.CohortOperator = CohortOperator = {}));

package/bin/remittance/enums/CohortRefresh.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Frecuencia de recálculo de un cohort. Un solo cron horario en remittance-business
+ * honra las 3 frecuencias respetando `nextCalculationAt` (+1h / +1d / +7d).
+ */
+export declare enum CohortRefresh {
+    HORARIO = "horario",
+    DIARIO = "diario",
+    SEMANAL = "semanal"
+}

package/bin/remittance/enums/CohortRefresh.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CohortRefresh = void 0;
+/**
+ * Frecuencia de recálculo de un cohort. Un solo cron horario en remittance-business
+ * honra las 3 frecuencias respetando `nextCalculationAt` (+1h / +1d / +7d).
+ */
+var CohortRefresh;
+(function (CohortRefresh) {
+    CohortRefresh["HORARIO"] = "horario";
+    CohortRefresh["DIARIO"] = "diario";
+    CohortRefresh["SEMANAL"] = "semanal";
+})(CohortRefresh || (exports.CohortRefresh = CohortRefresh = {}));

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

@@ -5,3 +5,8 @@ export * from "./RemittanceUserState";
 export * from "./RemittanceCancelledByEnum";
 export * from "./RemittanceCancelOutcomeEnum";
 export * from "./FeeAbsorbedByEnum";
+export * from "./CohortField";
+export * from "./CohortOperator";
+export * from "./CohortRefresh";
+export * from "./AuditAction";
+export * from "./AuditEntityType";

package/bin/remittance/enums/index.js

@@ -21,3 +21,8 @@ __exportStar(require("./RemittanceUserState"), exports);
 __exportStar(require("./RemittanceCancelledByEnum"), exports);
 __exportStar(require("./RemittanceCancelOutcomeEnum"), exports);
 __exportStar(require("./FeeAbsorbedByEnum"), exports);
+__exportStar(require("./CohortField"), exports);
+__exportStar(require("./CohortOperator"), exports);
+__exportStar(require("./CohortRefresh"), exports);
+__exportStar(require("./AuditAction"), exports);
+__exportStar(require("./AuditEntityType"), exports);

package/bin/remittance/index.d.ts

@@ -2,3 +2,4 @@ export * from "./enums";
 export * from "./dtos";
 export * from "./dtos/internal/RemittanceCreditBackRequest";
 export * from "./dtos/internal/RemittanceCreditBackResponse";
+export * from "./dtos/internal/RemittanceCohortCount";

package/bin/remittance/index.js

@@ -20,3 +20,4 @@ __exportStar(require("./enums"), exports);
 __exportStar(require("./dtos"), exports);
 __exportStar(require("./dtos/internal/RemittanceCreditBackRequest"), exports);
 __exportStar(require("./dtos/internal/RemittanceCreditBackResponse"), exports);
+__exportStar(require("./dtos/internal/RemittanceCohortCount"), exports);

package/package.json

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

package/src/platformRbac/dtos/CreateTenantRequest.ts

@@ -11,7 +11,6 @@ import {
     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
@@ -55,10 +54,12 @@ export class CreateTenantRequest {
     // enforce Cognito (política nativa del pool), ya no es per-tenant en el create.
     @Expose() @IsOptional() @IsEnum(TokenValidationMode) tokenValidationMode?: TokenValidationMode;
     /**
-     * Tipo de tenant a crear. Si se omite, el onboarding aplica su default (hoy: retail).
-     * @deprecated DEC-RBAC-062/063: el alta se hace por `applicationId`; `tenantType` se elimina al consolidar niveles. Migración pendiente; no usar en código nuevo.
+     * Tipo de tenant a crear (legacy). El alta se hace por `applicationId`.
+     * @deprecated DEC-RBAC-062/063: los tenant-types de dominio fueron purgados (v4.0.0, BREAKING).
+     * El alta se hace por `applicationId`; `tenantType` queda como string libre solo por back-compat
+     * del shape del body. No usar en código nuevo.
      */
-    @Expose() @IsOptional() @IsEnum(TenantType) tenantType?: TenantType;
+    @Expose() @IsOptional() @IsString() tenantType?: string;
     /** DEC-RBAC-034: aplicación (plantilla) de la que se crea el tenant; opcional, fallback a tenantType (back-compat). */
     @Expose() @IsOptional() @IsString() applicationId?: string;
     /**

package/src/platformRbac/enums/Permission.ts

@@ -104,117 +104,11 @@ export enum Permission {
     TENANT_LEVEL_MANAGE = 'tenant.level.manage',
 
     // ====================================================
-    // RETAIL — catálogo + inventario + ventas
-    // ====================================================
-    // RETAIL user-management — espejo de tenant.user.* a nivel RETAILER. Los KEYS existen para que el
-    // catálogo + el picker los ofrezcan; sus endpoints/handlers los implementa el agente de retailer
-    // user-management (rbac TD-RBAC-049). create.lateral gobierna create + assign + update (igual que tenant).
-    RETAIL_USER_CREATE = 'retail.user.create',
-    RETAIL_USER_CREATE_LATERAL = 'retail.user.create.lateral',
-    RETAIL_USER_READ = 'retail.user.read',
-    RETAIL_USER_UPDATE = 'retail.user.update',
-    RETAIL_USER_STATUS = 'retail.user.status',
-    RETAIL_USER_DELETE = 'retail.user.delete',
-    RETAIL_USER_PASSWORD_RESET = 'retail.user.password.reset',
-    RETAIL_USER_MFA_RESET = 'retail.user.mfa.reset',
-    RETAIL_PRODUCT_CREATE = 'retail.product.create',
-    RETAIL_PRODUCT_LIST = 'retail.product.list',
-    RETAIL_PRODUCT_VIEW = 'retail.product.view',
-    RETAIL_PRODUCT_UPDATE = 'retail.product.update',
-    RETAIL_PRODUCT_DELETE = 'retail.product.delete',
-    /** @deprecated DEC-RBAC-061: se renombrará a 'retail.product.mdm.config' (naming con puntos). Migración de datos coordinada por backend pendiente; no usar en código nuevo. */
-    RETAIL_PRODUCT_MDM_CONFIG = 'retail.product.mdm_config',
-    RETAIL_INVENTORY_LIST = 'retail.inventory.list',
-    RETAIL_INVENTORY_VIEW = 'retail.inventory.view',
-    RETAIL_INVENTORY_UPDATE = 'retail.inventory.update',
-    RETAIL_SALE_CREATE = 'retail.sale.create',
-    RETAIL_SALE_LIST = 'retail.sale.list',
-    RETAIL_SALE_CANCEL = 'retail.sale.cancel',
-    RETAIL_STORE_MANAGE = 'retail.store.manage',
-    RETAIL_RETAILER_MANAGE = 'retail.retailer.manage',
-
-    // ====================================================
-    // LEND — créditos + cobranza
-    // ====================================================
-    LEND_CREDIT_CREATE = 'lend.credit.create',
-    LEND_CREDIT_LIST = 'lend.credit.list',
-    LEND_CREDIT_VIEW = 'lend.credit.view',
-    LEND_CREDIT_UPDATE = 'lend.credit.update',
-    LEND_CREDIT_LIQUIDATE = 'lend.credit.liquidate',
-    LEND_CREDIT_RESTRUCTURE = 'lend.credit.restructure',
-    LEND_PAYMENT_APPLY = 'lend.payment.apply',
-    LEND_PAYMENT_LIST = 'lend.payment.list',
-    LEND_PAYMENT_REVERSE = 'lend.payment.reverse',
-    LEND_INSTALLMENT_VIEW = 'lend.installment.view',
-
-    // ====================================================
-    // MDM — device management (subset especializado de LEND)
-    // ====================================================
-    MDM_DEVICE_ENROLL = 'mdm.device.enroll',
-    MDM_DEVICE_RELEASE = 'mdm.device.release',
-    MDM_DEVICE_ARCHIVE = 'mdm.device.archive',
-    MDM_DEVICE_DEACTIVATE = 'mdm.device.deactivate',
-    MDM_DEVICE_LOCK_MANUAL = 'mdm.device.lock.manual',
-    MDM_DEVICE_UNLOCK_MANUAL = 'mdm.device.unlock.manual',
-    /** @deprecated DEC-RBAC-061: se renombrará a 'mdm.device.pin.unlock' (naming con puntos). Migración de datos coordinada por backend pendiente; no usar en código nuevo. */
-    MDM_DEVICE_PIN_UNLOCK = 'mdm.device.pin_unlock',
-    /** @deprecated DEC-RBAC-061: se renombrará a 'mdm.device.extend.validity' (naming con puntos). Migración de datos coordinada por backend pendiente; no usar en código nuevo. */
-    MDM_DEVICE_EXTEND_VALIDITY = 'mdm.device.extend_validity',
-    MDM_DEVICE_NOTIFY = 'mdm.device.notify',
-    MDM_DEVICE_STATUS_VIEW = 'mdm.device.status.view',
-    /** @deprecated DEC-RBAC-061: se renombrará a 'mdm.operation.log.view' (naming con puntos). Migración de datos coordinada por backend pendiente; no usar en código nuevo. */
-    MDM_OPERATION_LOG_VIEW = 'mdm.operation_log.view',
-    MDM_TEST = 'mdm.test',
-
-    // ====================================================
-    // PAY — futuro FiadoPay (placeholder, no usado en MVP)
-    // ====================================================
-    PAY_TRANSACTION_VIEW = 'pay.transaction.view',
-
-    // ====================================================
-    // AGENTS — Fiado Agents (tenant type AGENTS, roles scope GROUP).
-    // Permisos de DOMINIO derivados de los endpoints/pantallas reales del webapp de agents
-    // (ver fiado-agents-webapp/docs/rbac/RBAC-agents.md §5.2). El aislamiento entre orgs lo da el
-    // scope GROUP del roleAssignment (scopeRef = Group_GT.id), no un permiso aparte.
-    // ====================================================
-    // Gate de ACCESO a la app web de Agents (gobernanza). Sin este permiso el usuario no
-    // entra a la app. Lo otorgan los 5 roles GROUP de agents (en su propio repo, no acá).
-    AGENTS_APP_ACCESS = 'agents.app.access',
-    AGENTS_AGENT_LIST = 'agents.agent.list',
-    AGENTS_AGENT_CREATE = 'agents.agent.create',
-    /** @deprecated DEC-RBAC-061: se renombrará a 'agents.agent.create.bulk' (naming con puntos). Migración de datos coordinada por backend pendiente; no usar en código nuevo. */
-    AGENTS_AGENT_CREATE_BULK = 'agents.agent.create_bulk',
-    AGENTS_AGENT_MOVE = 'agents.agent.move',
-    AGENTS_AGENT_DELETE = 'agents.agent.delete',
-    AGENTS_REFERRAL_VIEW = 'agents.referral.view',
-    AGENTS_RANKING_VIEW = 'agents.ranking.view',
-    AGENTS_PRODUCTION_VIEW = 'agents.production.view',
-    AGENTS_PERSON_SEARCH = 'agents.person.search',
-    AGENTS_PERSON_VIEW = 'agents.person.view',
-    AGENTS_PERSON_UPDATE = 'agents.person.update',
-    AGENTS_PERSON_CREATE = 'agents.person.create',
-    AGENTS_DOCUMENT_VIEW = 'agents.document.view',
-    AGENTS_DOCUMENT_UPLOAD = 'agents.document.upload',
-    AGENTS_ADDRESS_VIEW = 'agents.address.view',
-    AGENTS_ADDRESS_MANAGE = 'agents.address.manage',
-    AGENTS_BENEFICIARY_VIEW = 'agents.beneficiary.view',
-    AGENTS_BENEFICIARY_MANAGE = 'agents.beneficiary.manage',
-    AGENTS_CARD_ISSUE = 'agents.card.issue',
-    AGENTS_CHAT_VIEW = 'agents.chat.view',
-    AGENTS_CHAT_SEND = 'agents.chat.send',
-    AGENTS_NOTIFICATION_SEND = 'agents.notification.send',
-    AGENTS_EXPORT_RUN = 'agents.export.run',
-    AGENTS_CATALOG_VIEW = 'agents.catalog.view',
-    // Gestión de grupos del tenant AGENTS (scope TENANT — el operador). Espejo de retail.retailer.manage.
-    AGENTS_GROUP_MANAGE = 'agents.group.manage',
-    // Gestión de usuarios DENTRO de un grupo (scope GROUP — el group_owner/admin sobre su grupo; el
-    // operador la cubre por TENANT). Crea usuarios + asigna roles group_* acotado al groupId. DEC-102.
-    AGENTS_GROUP_USER_MANAGE = 'agents.group.user.manage',
-
-    // ====================================================
-    // LEVEL{1,2,3} — primitivas RBAC genéricas por nivel (DEC-RBAC-063, ADITIVO)
-    // Permisos básicos auto-sembrables por nivel genérico (data-driven). Coexisten con los
-    // legacy retail.*/agents.* (categorías @deprecated), NO los reemplazan en la línea 3.x.
+    // LEVEL{1,2,3} — primitivas RBAC genéricas por nivel (DEC-RBAC-063)
+    // Permisos básicos auto-sembrables por nivel genérico (data-driven). Los permisos de
+    // DOMINIO (retail.*/lend.*/mdm.*/pay.*/agents.*) fueron purgados del catálogo (v4.0.0,
+    // BREAKING): el type-kit contiene SOLO el vocabulario del sistema RBAC; los permisos de
+    // dominio viven como data (catálogo por aplicación), no hardcodeados acá.
     // ====================================================
     LEVEL1_USER_CREATE = 'level1.user.create',
     LEVEL1_USER_READ = 'level1.user.read',
@@ -311,87 +205,10 @@ export const PERMISSION_BIT_ORDER: readonly Permission[] = [
     Permission.TENANT_SECURITY_POLICY_MANAGE,
     Permission.TENANT_BRANDING_MANAGE,
     Permission.TENANT_AUDIT_VIEW,
-    Permission.RETAIL_USER_CREATE,
-    Permission.RETAIL_USER_CREATE_LATERAL,
-    Permission.RETAIL_USER_READ,
-    Permission.RETAIL_USER_UPDATE,
-    Permission.RETAIL_USER_STATUS,
-    Permission.RETAIL_USER_DELETE,
-    Permission.RETAIL_USER_PASSWORD_RESET,
-    Permission.RETAIL_USER_MFA_RESET,
-    Permission.RETAIL_PRODUCT_CREATE,
-    Permission.RETAIL_PRODUCT_LIST,
-    Permission.RETAIL_PRODUCT_VIEW,
-    Permission.RETAIL_PRODUCT_UPDATE,
-    Permission.RETAIL_PRODUCT_DELETE,
-    Permission.RETAIL_PRODUCT_MDM_CONFIG,
-    Permission.RETAIL_INVENTORY_LIST,
-    Permission.RETAIL_INVENTORY_VIEW,
-    Permission.RETAIL_INVENTORY_UPDATE,
-    Permission.RETAIL_SALE_CREATE,
-    Permission.RETAIL_SALE_LIST,
-    Permission.RETAIL_SALE_CANCEL,
-    Permission.RETAIL_STORE_MANAGE,
-    Permission.RETAIL_RETAILER_MANAGE,
-    Permission.LEND_CREDIT_CREATE,
-    Permission.LEND_CREDIT_LIST,
-    Permission.LEND_CREDIT_VIEW,
-    Permission.LEND_CREDIT_UPDATE,
-    Permission.LEND_CREDIT_LIQUIDATE,
-    Permission.LEND_CREDIT_RESTRUCTURE,
-    Permission.LEND_PAYMENT_APPLY,
-    Permission.LEND_PAYMENT_LIST,
-    Permission.LEND_PAYMENT_REVERSE,
-    Permission.LEND_INSTALLMENT_VIEW,
-    Permission.MDM_DEVICE_ENROLL,
-    Permission.MDM_DEVICE_RELEASE,
-    Permission.MDM_DEVICE_ARCHIVE,
-    Permission.MDM_DEVICE_DEACTIVATE,
-    Permission.MDM_DEVICE_LOCK_MANUAL,
-    Permission.MDM_DEVICE_UNLOCK_MANUAL,
-    Permission.MDM_DEVICE_PIN_UNLOCK,
-    Permission.MDM_DEVICE_EXTEND_VALIDITY,
-    Permission.MDM_DEVICE_NOTIFY,
-    Permission.MDM_DEVICE_STATUS_VIEW,
-    Permission.MDM_OPERATION_LOG_VIEW,
-    Permission.MDM_TEST,
-    Permission.PAY_TRANSACTION_VIEW,
-    // AGENTS (append-only) — Fiado Agents domain perms.
-    Permission.AGENTS_AGENT_LIST,
-    Permission.AGENTS_AGENT_CREATE,
-    Permission.AGENTS_AGENT_CREATE_BULK,
-    Permission.AGENTS_AGENT_MOVE,
-    Permission.AGENTS_AGENT_DELETE,
-    Permission.AGENTS_REFERRAL_VIEW,
-    Permission.AGENTS_RANKING_VIEW,
-    Permission.AGENTS_PRODUCTION_VIEW,
-    Permission.AGENTS_PERSON_SEARCH,
-    Permission.AGENTS_PERSON_VIEW,
-    Permission.AGENTS_PERSON_UPDATE,
-    Permission.AGENTS_DOCUMENT_VIEW,
-    Permission.AGENTS_DOCUMENT_UPLOAD,
-    Permission.AGENTS_ADDRESS_VIEW,
-    Permission.AGENTS_ADDRESS_MANAGE,
-    Permission.AGENTS_BENEFICIARY_VIEW,
-    Permission.AGENTS_BENEFICIARY_MANAGE,
-    Permission.AGENTS_CARD_ISSUE,
-    Permission.AGENTS_CHAT_VIEW,
-    Permission.AGENTS_CHAT_SEND,
-    Permission.AGENTS_NOTIFICATION_SEND,
-    Permission.AGENTS_EXPORT_RUN,
-    Permission.AGENTS_CATALOG_VIEW,
-    Permission.AGENTS_GROUP_MANAGE,
-    Permission.AGENTS_GROUP_USER_MANAGE,
-    // Append-only: nuevo permiso agregado 2026-06-18 (DEC-A2-02). Va al FINAL para no correr los bits
-    // existentes (PERMS_VERSION cambia, pero los índices previos se conservan).
-    Permission.AGENTS_PERSON_CREATE,
-    // Append-only 2026-06-18 (DEC-RBAC-017): catálogo de campos personalizados por tenant. Al FINAL para
-    // no correr bits existentes. (El bitset está deprecado por token-flaco, pero el orden se mantiene
-    // sincronizado con el enum para que el test de bits no rompa.)
+    // Append-only 2026-06-18 (DEC-RBAC-017): catálogo de campos personalizados por tenant.
+    // (El bitset está deprecado por token-flaco, pero el orden se mantiene sincronizado con el
+    // enum para que el test de bits no rompa.)
     Permission.PLATFORM_TENANT_USERFIELDS_MANAGE,
-    // Append-only 2026-06-21: gate de acceso a la app web de Agents (gobernanza). Al FINAL para no
-    // correr bits existentes (PERMS_VERSION cambia, pero los índices previos se conservan).
-    Permission.AGENTS_APP_ACCESS,
     // Append-only 2026-06-19: lateral platform (platform_super_admin asigna roles scope PLATFORM).
     // Al FINAL para no correr bits existentes (PERMS_VERSION cambia, índices previos se conservan).
     Permission.PLATFORM_USER_CREATE_LATERAL,

package/src/platformRbac/enums/PermissionCategory.ts

@@ -6,16 +6,11 @@ export enum PermissionCategory {
     RBAC = 'rbac',
     PLATFORM = 'platform',
     TENANT = 'tenant',
-    /** @deprecated DEC-RBAC-062/063: se consolida en niveles genéricos (LEVEL_n) data-driven. Migración de tenants pendiente; no usar en código nuevo. */
-    RETAIL = 'retail',
-    LEND = 'lend',
-    MDM = 'mdm',
     AUDIT = 'audit',
-    PAY = 'pay',
-    /** @deprecated DEC-RBAC-062/063: se consolida en niveles genéricos (LEVEL_n) data-driven. Migración de tenants pendiente; no usar en código nuevo. */
-    AGENTS = 'agents',
-    // DEC-RBAC-063 (aditivo): categorías de las primitivas RBAC por nivel genérico.
-    // Coexisten con RETAIL/AGENTS (@deprecated), no los reemplazan en la línea 3.x.
+    // DEC-RBAC-063: categorías de las primitivas RBAC por nivel genérico.
+    // Las categorías de DOMINIO (retail/lend/mdm/pay/agents) fueron purgadas del catálogo
+    // (v4.0.0, BREAKING): el type-kit contiene SOLO el vocabulario del sistema RBAC; el dominio
+    // vive como data (catálogo por aplicación), no hardcodeado acá.
     LEVEL1 = 'level1',
     LEVEL2 = 'level2',
     LEVEL3 = 'level3',

package/src/platformRbac/tenantTypes.ts

@@ -1,16 +1,19 @@
 import { PermissionScope } from './enums/PermissionScope';
 
 /**
- * Tipos de tenant soportados por el rbac-business. Cada tipo define su propia
- * jerarquía de niveles DEBAJO de TENANT (data-driven). Hoy solo existe `retail`.
+ * Tipos de tenant de DOMINIO (retail/agents) — PURGADOS (v4.0.0, BREAKING).
  *
- * @deprecated DEC-RBAC-062/063: el modelo de tipos de tenant se consolida en niveles genéricos
- * (LEVEL_1..n) data-driven. Migración de tenants pendiente; no usar en código nuevo.
+ * El modelo de tipos de tenant de dominio se consolidó en niveles genéricos (LEVEL_1..n)
+ * data-driven (DEC-RBAC-062/063). El type-kit contiene SOLO el vocabulario del sistema RBAC;
+ * la jerarquía de niveles de cada aplicación vive como data (catálogo por aplicación,
+ * ver `LevelDef` en `application/Application`), no hardcodeada acá.
+ *
+ * El enum queda SIN miembros de dominio a propósito. La maquinaria genérica
+ * (`TENANT_TYPES`, `levelsOf`, `tableSuffixForLevel`, `scopeRankOrder`) se conserva para no
+ * romper a los consumidores (ej. `ScopeValidationService._rank` vía `scopeRankOrder`), pero
+ * ya no aporta niveles legacy: el orden queda definido por los niveles genéricos.
  */
-export enum TenantType {
-    RETAIL = 'retail',
-    AGENTS = 'agents',
-}
+export enum TenantType {}
 
 interface TenantTypeDef {
     displayName: string;
@@ -20,46 +23,32 @@ interface TenantTypeDef {
     tableSuffix: Partial<Record<PermissionScope, string>>;
 }
 
-/** @deprecated DEC-RBAC-062/063: se consolida en niveles genéricos (LEVEL_n) data-driven. Migración de tenants pendiente; no usar en código nuevo. */
-export const TENANT_TYPES: Record<TenantType, TenantTypeDef> = {
-    [TenantType.RETAIL]: {
-        displayName: 'Retail',
-        levels: [PermissionScope.RETAILER, PermissionScope.STORE],
-        tableSuffix: {
-            [PermissionScope.RETAILER]: 'SharedRetailer',
-            [PermissionScope.STORE]: 'SharedStore',
-        },
-    },
-    // Fiado Agents — un único nivel GROUP debajo de TENANT.
-    [TenantType.AGENTS]: {
-        displayName: 'Agents',
-        levels: [PermissionScope.GROUP],
-        tableSuffix: { [PermissionScope.GROUP]: 'SharedGroup' },
-    },
-};
+/**
+ * Registro de tipos de tenant de dominio — VACÍO tras la purga (v4.0.0). Las jerarquías de
+ * niveles se definen como data por aplicación (LEVEL_n), no acá.
+ */
+export const TENANT_TYPES: Record<TenantType, TenantTypeDef> = {};
 
-/** @deprecated DEC-RBAC-062/063: se consolida en niveles genéricos (LEVEL_n) data-driven. Migración de tenants pendiente; no usar en código nuevo. */
 export function levelsOf(type: TenantType): PermissionScope[] {
     return TENANT_TYPES[type].levels;
 }
 
-/** @deprecated DEC-RBAC-062/063: se consolida en niveles genéricos (LEVEL_n) data-driven. Migración de tenants pendiente; no usar en código nuevo. */
 export function tableSuffixForLevel(type: TenantType, level: PermissionScope): string | undefined {
     return TENANT_TYPES[type].tableSuffix[level];
 }
 
 /**
- * Orden global de scopes para ORDENAR (ej. UI): PLATFORM, TENANT + niveles de cada tipo.
- * ⚠️ NO usar para COBERTURA de autorización: es un orden total que cruzaría ramas
- * (sugeriría falsamente que RETAILER cubre GROUP). La cobertura se decide con una relación
- * explícita por niveles — ver `canAccess`/`scopeCovers` en @fiado/gateway-adapter (DEC-RBAC-010).
+ * Orden global de scopes para ORDENAR (ej. UI): PLATFORM, TENANT + niveles genéricos.
+ * ⚠️ NO usar para COBERTURA de autorización: es un orden total que cruzaría ramas.
+ * La cobertura se decide con una relación explícita por niveles — ver `canAccess`/`scopeCovers`
+ * en @fiado/gateway-adapter (DEC-RBAC-010).
  */
 export function scopeRankOrder(): PermissionScope[] {
     const order: PermissionScope[] = [PermissionScope.PLATFORM, PermissionScope.TENANT];
     for (const def of Object.values(TENANT_TYPES)) {
         for (const lvl of def.levels) if (!order.includes(lvl)) order.push(lvl);
     }
-    // DEC-RBAC-032: niveles genéricos al final del orden total (UI/ranking). Append-only, después de los legacy.
+    // DEC-RBAC-032: niveles genéricos al final del orden total (UI/ranking). Append-only.
     for (const lvl of [PermissionScope.LEVEL_1, PermissionScope.LEVEL_2, PermissionScope.LEVEL_3]) {
         if (!order.includes(lvl)) order.push(lvl);
     }