@fiado/type-kit 3.144.0 → 3.146.0

package/bin/group/dtos/GroupCountsResponse.d.ts

@@ -0,0 +1,11 @@
+/** Grupo con su # de miembros (relaciones DIRECTORY en GroupDirectoryRelations_GT). */
+export declare class GroupCountItem {
+    id: string;
+    name: string;
+    status: string;
+    memberCount: number;
+}
+/** Response de GET groups/counts (privado, fiado-group-business). */
+export declare class GroupCountsResponse {
+    items: GroupCountItem[];
+}

package/bin/group/dtos/GroupCountsResponse.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroupCountsResponse = exports.GroupCountItem = void 0;
+/** Grupo con su # de miembros (relaciones DIRECTORY en GroupDirectoryRelations_GT). */
+class GroupCountItem {
+}
+exports.GroupCountItem = GroupCountItem;
+/** Response de GET groups/counts (privado, fiado-group-business). */
+class GroupCountsResponse {
+}
+exports.GroupCountsResponse = GroupCountsResponse;

package/bin/group/index.d.ts

@@ -8,3 +8,4 @@ export * from './enums/GroupStatus';
 export * from './enums/RelationType';
 export * from './enums/RelationStatus';
 export * from './enums/GroupAction';
+export * from './dtos/GroupCountsResponse';

package/bin/group/index.js

@@ -26,3 +26,5 @@ __exportStar(require("./enums/GroupStatus"), exports);
 __exportStar(require("./enums/RelationType"), exports);
 __exportStar(require("./enums/RelationStatus"), exports);
 __exportStar(require("./enums/GroupAction"), exports);
+//dtos
+__exportStar(require("./dtos/GroupCountsResponse"), exports);

package/bin/index.d.ts

@@ -14,6 +14,7 @@ export * as Directory from './directory';
 export * as ExchangeRate from './exchangeRate';
 export * as File from './identity';
 export * as Group from './group';
+export * as UserTags from './userTags';
 export * as Identity from './provider';
 export * as Header from './header';
 export * as ServicePayment from './servicePayment';

package/bin/index.js

@@ -36,8 +36,8 @@ 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.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = exports.Blacklist = exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Account = exports.Crypto = void 0;
-exports.EmailVerification = exports.NetworkConnector = exports.TotpSecurity = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = void 0;
+exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = exports.Blacklist = exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.UserTags = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Account = exports.Crypto = void 0;
+exports.EmailVerification = exports.NetworkConnector = exports.TotpSecurity = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.Activity = __importStar(require("./activity"));
@@ -54,6 +54,7 @@ exports.Directory = __importStar(require("./directory"));
 exports.ExchangeRate = __importStar(require("./exchangeRate"));
 exports.File = __importStar(require("./identity"));
 exports.Group = __importStar(require("./group"));
+exports.UserTags = __importStar(require("./userTags"));
 exports.Identity = __importStar(require("./provider"));
 exports.Header = __importStar(require("./header"));
 exports.ServicePayment = __importStar(require("./servicePayment"));

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

@@ -7,13 +7,20 @@
  * (RETAILER/STORE/GROUP, atados a tenant-types concretos), una aplicación define
  * su jerarquía DEBAJO de TENANT con niveles genéricos LEVEL_1 > LEVEL_2 > LEVEL_3,
  * cuyo `displayName` lo decide cada aplicación (ver LevelDef en application/Application).
- * Los niveles legacy se conservan para no romper retail/agents existentes.
+ *
+ * DEC-RBAC-091 (Fase 1): RETAILER/STORE/GROUP quedan `@deprecated` — el modelo correcto es
+ * LEVEL_N (DEC-RBAC-090, funcionando E2E). Se conservan por ahora para no romper a los consumidores
+ * (platform-rbac-business, gateway-adapter, jwt-inyector-trigger, referral-business, webapps) que se
+ * migran por fases; se REMUEVEN en Fase 5 (bump MAJOR) cuando ninguno los use.
  */
 export declare enum PermissionScope {
     PLATFORM = "PLATFORM",
     TENANT = "TENANT",
+    /** @deprecated DEC-RBAC-091: usar LEVEL_N. Se remueve en Fase 5 (MAJOR). */
     RETAILER = "RETAILER",
+    /** @deprecated DEC-RBAC-091: usar LEVEL_N. Se remueve en Fase 5 (MAJOR). */
     STORE = "STORE",
+    /** @deprecated DEC-RBAC-091: usar LEVEL_N. Se remueve en Fase 5 (MAJOR). */
     GROUP = "GROUP",
     LEVEL_1 = "LEVEL_1",
     LEVEL_2 = "LEVEL_2",

package/bin/platformRbac/enums/PermissionScope.js

@@ -10,14 +10,21 @@ exports.PermissionScope = void 0;
  * (RETAILER/STORE/GROUP, atados a tenant-types concretos), una aplicación define
  * su jerarquía DEBAJO de TENANT con niveles genéricos LEVEL_1 > LEVEL_2 > LEVEL_3,
  * cuyo `displayName` lo decide cada aplicación (ver LevelDef en application/Application).
- * Los niveles legacy se conservan para no romper retail/agents existentes.
+ *
+ * DEC-RBAC-091 (Fase 1): RETAILER/STORE/GROUP quedan `@deprecated` — el modelo correcto es
+ * LEVEL_N (DEC-RBAC-090, funcionando E2E). Se conservan por ahora para no romper a los consumidores
+ * (platform-rbac-business, gateway-adapter, jwt-inyector-trigger, referral-business, webapps) que se
+ * migran por fases; se REMUEVEN en Fase 5 (bump MAJOR) cuando ninguno los use.
  */
 var PermissionScope;
 (function (PermissionScope) {
     PermissionScope["PLATFORM"] = "PLATFORM";
     PermissionScope["TENANT"] = "TENANT";
+    /** @deprecated DEC-RBAC-091: usar LEVEL_N. Se remueve en Fase 5 (MAJOR). */
     PermissionScope["RETAILER"] = "RETAILER";
+    /** @deprecated DEC-RBAC-091: usar LEVEL_N. Se remueve en Fase 5 (MAJOR). */
     PermissionScope["STORE"] = "STORE";
+    /** @deprecated DEC-RBAC-091: usar LEVEL_N. Se remueve en Fase 5 (MAJOR). */
     PermissionScope["GROUP"] = "GROUP";
     PermissionScope["LEVEL_1"] = "LEVEL_1";
     PermissionScope["LEVEL_2"] = "LEVEL_2";

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

@@ -0,0 +1,80 @@
+import { SegmentMemberType } from "../enums/SegmentMemberType";
+/**
+ * DTOs de Segmentos (Dashboard Ops · Configuración §2, EP-22..25 + catalog + search).
+ *
+ * Un segmento es una colección EXPLÍCITA de clientes: referencias a grupos
+ * (Group_GT) y tags (UserTags_GT) por id + individuos (override por cliente).
+ * Dueño de la tabla: remittance-business (RemittanceSegments_GT).
+ *
+ * "Clientes" del segmento = intersección con RemittanceUsers_GT (usuarios de
+ * remesas que caen en el segmento), NO la membresía Fiado-wide del picker.
+ */
+/** Referencia de composición: un grupo (Group_GT.id) o un tag (UserTags_GT.tag). */
+export declare class SegmentMember {
+    type: SegmentMemberType;
+    /** Group_GT.id (p. ej. "CELULARES") o el tag (p. ej. "VIPS"). */
+    id: string;
+}
+/** Individuo agregado explícitamente (la llave es directoryId; peopleId informativo). */
+export declare class SegmentIndividual {
+    directoryId: string;
+    peopleId?: string;
+    /** Snapshot de display (se pinta sin lookup). */
+    name: string;
+}
+/** Body de EP-23 POST /backoffice/config/segments. */
+export declare class CreateSegmentRequest {
+    name: string;
+    members: SegmentMember[];
+    individuals: SegmentIndividual[];
+}
+/** Body de EP-24 PUT /backoffice/config/segments/{id} (reemplazo completo). */
+export declare class UpdateSegmentRequest {
+    name: string;
+    members: SegmentMember[];
+    individuals: SegmentIndividual[];
+}
+/** Segmento completo (response). Métricas null = nunca calculadas. */
+export declare class Segment {
+    id: string;
+    name: string;
+    /** true solo en ESTANDAR (catch-all: composición bloqueada, no eliminable). */
+    isDefault: boolean;
+    members: SegmentMember[];
+    individuals: SegmentIndividual[];
+    /** # de RemittanceUsers en el segmento (intersección con remesas). */
+    clientCount: number | null;
+    /** Σ amountUSD del mes calendario de esos users (sin CANCELLED/REFUND). */
+    volMonthUSD: number | null;
+    lastCalculatedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    updatedBy: string;
+}
+/** Response de EP-22 GET /backoffice/config/segments. */
+export declare class SegmentListResponse {
+    items: Segment[];
+}
+/** Response de POST /backoffice/config/segments/{id}/recalcular. */
+export declare class RecalculateSegmentResponse {
+    id: string;
+    clientCount: number;
+    volMonthUSD: number;
+    lastCalculatedAt: string;
+}
+/** Item del picker DISPONIBLES (EP-32 catalog). `count` = membresía Fiado-wide. */
+export declare class SegmentCatalogItem {
+    type: SegmentMemberType;
+    id: string;
+    name: string;
+    count: number;
+}
+/** Response de GET /backoffice/config/segments/catalog. */
+export declare class SegmentCatalogResponse {
+    items: SegmentCatalogItem[];
+}
+/** Response de GET /backoffice/config/segments/search-individual?q= (cap 20). */
+export declare class SearchIndividualResponse {
+    items: SegmentIndividual[];
+}

package/bin/remittance/dtos/RemittanceSegment.js

@@ -0,0 +1,122 @@
+"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.SearchIndividualResponse = exports.SegmentCatalogResponse = exports.SegmentCatalogItem = exports.RecalculateSegmentResponse = exports.SegmentListResponse = exports.Segment = exports.UpdateSegmentRequest = exports.CreateSegmentRequest = exports.SegmentIndividual = exports.SegmentMember = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const SegmentMemberType_1 = require("../enums/SegmentMemberType");
+/**
+ * DTOs de Segmentos (Dashboard Ops · Configuración §2, EP-22..25 + catalog + search).
+ *
+ * Un segmento es una colección EXPLÍCITA de clientes: referencias a grupos
+ * (Group_GT) y tags (UserTags_GT) por id + individuos (override por cliente).
+ * Dueño de la tabla: remittance-business (RemittanceSegments_GT).
+ *
+ * "Clientes" del segmento = intersección con RemittanceUsers_GT (usuarios de
+ * remesas que caen en el segmento), NO la membresía Fiado-wide del picker.
+ */
+/** Referencia de composición: un grupo (Group_GT.id) o un tag (UserTags_GT.tag). */
+class SegmentMember {
+}
+exports.SegmentMember = SegmentMember;
+__decorate([
+    (0, class_validator_1.IsEnum)(SegmentMemberType_1.SegmentMemberType),
+    __metadata("design:type", String)
+], SegmentMember.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(1, 100),
+    __metadata("design:type", String)
+], SegmentMember.prototype, "id", void 0);
+/** Individuo agregado explícitamente (la llave es directoryId; peopleId informativo). */
+class SegmentIndividual {
+}
+exports.SegmentIndividual = SegmentIndividual;
+__decorate([
+    (0, class_validator_1.IsUUID)("4"),
+    __metadata("design:type", String)
+], SegmentIndividual.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)("4"),
+    __metadata("design:type", String)
+], SegmentIndividual.prototype, "peopleId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(1, 200),
+    __metadata("design:type", String)
+], SegmentIndividual.prototype, "name", void 0);
+/** Body de EP-23 POST /backoffice/config/segments. */
+class CreateSegmentRequest {
+}
+exports.CreateSegmentRequest = CreateSegmentRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 100),
+    __metadata("design:type", String)
+], CreateSegmentRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => SegmentMember),
+    __metadata("design:type", Array)
+], CreateSegmentRequest.prototype, "members", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => SegmentIndividual),
+    __metadata("design:type", Array)
+], CreateSegmentRequest.prototype, "individuals", void 0);
+/** Body de EP-24 PUT /backoffice/config/segments/{id} (reemplazo completo). */
+class UpdateSegmentRequest {
+}
+exports.UpdateSegmentRequest = UpdateSegmentRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 100),
+    __metadata("design:type", String)
+], UpdateSegmentRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => SegmentMember),
+    __metadata("design:type", Array)
+], UpdateSegmentRequest.prototype, "members", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => SegmentIndividual),
+    __metadata("design:type", Array)
+], UpdateSegmentRequest.prototype, "individuals", void 0);
+/** Segmento completo (response). Métricas null = nunca calculadas. */
+class Segment {
+}
+exports.Segment = Segment;
+/** Response de EP-22 GET /backoffice/config/segments. */
+class SegmentListResponse {
+}
+exports.SegmentListResponse = SegmentListResponse;
+/** Response de POST /backoffice/config/segments/{id}/recalcular. */
+class RecalculateSegmentResponse {
+}
+exports.RecalculateSegmentResponse = RecalculateSegmentResponse;
+/** Item del picker DISPONIBLES (EP-32 catalog). `count` = membresía Fiado-wide. */
+class SegmentCatalogItem {
+}
+exports.SegmentCatalogItem = SegmentCatalogItem;
+/** Response de GET /backoffice/config/segments/catalog. */
+class SegmentCatalogResponse {
+}
+exports.SegmentCatalogResponse = SegmentCatalogResponse;
+/** Response de GET /backoffice/config/segments/search-individual?q= (cap 20). */
+class SearchIndividualResponse {
+}
+exports.SearchIndividualResponse = SearchIndividualResponse;

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

@@ -38,3 +38,4 @@ export * from "./RemittanceUserLimits";
 export * from "./RemittanceKyc";
 export * from "./RemittanceCohort";
 export * from "./RemittanceAuditLog";
+export * from "./RemittanceSegment";

package/bin/remittance/dtos/index.js

@@ -54,3 +54,4 @@ __exportStar(require("./RemittanceUserLimits"), exports);
 __exportStar(require("./RemittanceKyc"), exports);
 __exportStar(require("./RemittanceCohort"), exports);
 __exportStar(require("./RemittanceAuditLog"), exports);
+__exportStar(require("./RemittanceSegment"), exports);

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

@@ -0,0 +1,17 @@
+/**
+ * Contrato interno de métricas de un segmento (puente Opción A):
+ * remittance-business resuelve la membresía (subconjunto de RemittanceUsers que
+ * caen en el segmento) y el uniteller-connector (dueño de las tx) devuelve el
+ * conteo validado + volumen del mes. Vía api-invoker →
+ * POST /backoffice/config/segments/metrics (privado).
+ */
+export declare class SegmentMetricsRequest {
+    /** Subconjunto ya resuelto por rb. `[]` → { clientCount: 0, volMonthUSD: 0 }. */
+    directoryIds: string[];
+}
+export declare class SegmentMetricsResponse {
+    /** ids del request que SÍ existen en RemittanceUsers_GT. */
+    clientCount: number;
+    /** Σ amountUSD del mes calendario corriente (UTC) de esos users, sin CANCELLED/REFUND. */
+    volMonthUSD: number;
+}

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

@@ -0,0 +1,31 @@
+"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.SegmentMetricsResponse = exports.SegmentMetricsRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Contrato interno de métricas de un segmento (puente Opción A):
+ * remittance-business resuelve la membresía (subconjunto de RemittanceUsers que
+ * caen en el segmento) y el uniteller-connector (dueño de las tx) devuelve el
+ * conteo validado + volumen del mes. Vía api-invoker →
+ * POST /backoffice/config/segments/metrics (privado).
+ */
+class SegmentMetricsRequest {
+}
+exports.SegmentMetricsRequest = SegmentMetricsRequest;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsUUID)("4", { each: true }),
+    __metadata("design:type", Array)
+], SegmentMetricsRequest.prototype, "directoryIds", void 0);
+class SegmentMetricsResponse {
+}
+exports.SegmentMetricsResponse = SegmentMetricsResponse;

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

@@ -0,0 +1,8 @@
+/**
+ * Tipo de miembro de la composición de un segmento (Dashboard Ops · Configuración §2).
+ * Los valores son los del mockup (pills GRUPO/TAG del dual-list).
+ */
+export declare enum SegmentMemberType {
+    GROUP = "group",
+    TAG = "tag"
+}

package/bin/remittance/enums/SegmentMemberType.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SegmentMemberType = void 0;
+/**
+ * Tipo de miembro de la composición de un segmento (Dashboard Ops · Configuración §2).
+ * Los valores son los del mockup (pills GRUPO/TAG del dual-list).
+ */
+var SegmentMemberType;
+(function (SegmentMemberType) {
+    SegmentMemberType["GROUP"] = "group";
+    SegmentMemberType["TAG"] = "tag";
+})(SegmentMemberType || (exports.SegmentMemberType = SegmentMemberType = {}));

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

@@ -10,3 +10,4 @@ export * from "./CohortOperator";
 export * from "./CohortRefresh";
 export * from "./AuditAction";
 export * from "./AuditEntityType";
+export * from "./SegmentMemberType";

package/bin/remittance/enums/index.js

@@ -26,3 +26,4 @@ __exportStar(require("./CohortOperator"), exports);
 __exportStar(require("./CohortRefresh"), exports);
 __exportStar(require("./AuditAction"), exports);
 __exportStar(require("./AuditEntityType"), exports);
+__exportStar(require("./SegmentMemberType"), exports);

package/bin/remittance/index.d.ts

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

package/bin/remittance/index.js

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

package/bin/userTags/dtos/TagsByDirectoriesRequest.d.ts

@@ -0,0 +1,4 @@
+/** Request de POST tags/by-directories (privado, onboarding-business). */
+export declare class TagsByDirectoriesRequest {
+    directoryIds: string[];
+}

package/bin/userTags/dtos/TagsByDirectoriesRequest.js

@@ -0,0 +1,22 @@
+"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.TagsByDirectoriesRequest = void 0;
+const class_validator_1 = require("class-validator");
+/** Request de POST tags/by-directories (privado, onboarding-business). */
+class TagsByDirectoriesRequest {
+}
+exports.TagsByDirectoriesRequest = TagsByDirectoriesRequest;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsUUID)("4", { each: true }),
+    __metadata("design:type", Array)
+], TagsByDirectoriesRequest.prototype, "directoryIds", void 0);

package/bin/userTags/dtos/TagsByDirectoriesResponse.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tags por usuario para un batch de directoryIds. Ids sin tags → `[]`
+ * (siempre presentes en el mapa, para que el consumidor no distinga ausencia).
+ */
+export declare class TagsByDirectoriesResponse {
+    tagsByDirectory: Record<string, string[]>;
+}

package/bin/userTags/dtos/TagsByDirectoriesResponse.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TagsByDirectoriesResponse = void 0;
+/**
+ * Tags por usuario para un batch de directoryIds. Ids sin tags → `[]`
+ * (siempre presentes en el mapa, para que el consumidor no distinga ausencia).
+ */
+class TagsByDirectoriesResponse {
+}
+exports.TagsByDirectoriesResponse = TagsByDirectoriesResponse;

package/bin/userTags/dtos/TagsSummaryResponse.d.ts

@@ -0,0 +1,9 @@
+/** Un tag operativo con su # de asignaciones en UserTags_GT (membresía Fiado-wide). */
+export declare class TagSummaryItem {
+    tag: string;
+    count: number;
+}
+/** Response de GET tags/summary (privado, onboarding-business). Orden: count desc. */
+export declare class TagsSummaryResponse {
+    items: TagSummaryItem[];
+}

package/bin/userTags/dtos/TagsSummaryResponse.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TagsSummaryResponse = exports.TagSummaryItem = void 0;
+/** Un tag operativo con su # de asignaciones en UserTags_GT (membresía Fiado-wide). */
+class TagSummaryItem {
+}
+exports.TagSummaryItem = TagSummaryItem;
+/** Response de GET tags/summary (privado, onboarding-business). Orden: count desc. */
+class TagsSummaryResponse {
+}
+exports.TagsSummaryResponse = TagsSummaryResponse;

package/bin/userTags/index.d.ts

@@ -0,0 +1,3 @@
+export * from './dtos/TagsSummaryResponse';
+export * from './dtos/TagsByDirectoriesRequest';
+export * from './dtos/TagsByDirectoriesResponse';

package/bin/userTags/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+//dtos
+__exportStar(require("./dtos/TagsSummaryResponse"), exports);
+__exportStar(require("./dtos/TagsByDirectoriesRequest"), exports);
+__exportStar(require("./dtos/TagsByDirectoriesResponse"), exports);

package/package.json

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

package/src/group/dtos/GroupCountsResponse.ts

@@ -0,0 +1,12 @@
+/** Grupo con su # de miembros (relaciones DIRECTORY en GroupDirectoryRelations_GT). */
+export class GroupCountItem {
+    id!: string;
+    name!: string;
+    status!: string;
+    memberCount!: number;
+}
+
+/** Response de GET groups/counts (privado, fiado-group-business). */
+export class GroupCountsResponse {
+    items!: GroupCountItem[];
+}

package/src/group/index.ts

@@ -16,3 +16,6 @@ export * from './enums/RelationStatus';
 export * from './enums/GroupAction';
 
 
+
+//dtos
+export * from './dtos/GroupCountsResponse';

package/src/index.ts

@@ -14,6 +14,7 @@ export * as Directory from './directory';
 export * as ExchangeRate from './exchangeRate';
 export * as File from './identity';
 export * as Group from './group';
+export * as UserTags from './userTags';
 export * as Identity from './provider';
 export * as Header from './header';
 export * as ServicePayment from './servicePayment';

package/src/platformRbac/enums/PermissionScope.ts

@@ -7,13 +7,20 @@
  * (RETAILER/STORE/GROUP, atados a tenant-types concretos), una aplicación define
  * su jerarquía DEBAJO de TENANT con niveles genéricos LEVEL_1 > LEVEL_2 > LEVEL_3,
  * cuyo `displayName` lo decide cada aplicación (ver LevelDef en application/Application).
- * Los niveles legacy se conservan para no romper retail/agents existentes.
+ *
+ * DEC-RBAC-091 (Fase 1): RETAILER/STORE/GROUP quedan `@deprecated` — el modelo correcto es
+ * LEVEL_N (DEC-RBAC-090, funcionando E2E). Se conservan por ahora para no romper a los consumidores
+ * (platform-rbac-business, gateway-adapter, jwt-inyector-trigger, referral-business, webapps) que se
+ * migran por fases; se REMUEVEN en Fase 5 (bump MAJOR) cuando ninguno los use.
  */
 export enum PermissionScope {
     PLATFORM = 'PLATFORM',
     TENANT = 'TENANT',
+    /** @deprecated DEC-RBAC-091: usar LEVEL_N. Se remueve en Fase 5 (MAJOR). */
     RETAILER = 'RETAILER',
+    /** @deprecated DEC-RBAC-091: usar LEVEL_N. Se remueve en Fase 5 (MAJOR). */
     STORE = 'STORE',
+    /** @deprecated DEC-RBAC-091: usar LEVEL_N. Se remueve en Fase 5 (MAJOR). */
     GROUP = 'GROUP',
     LEVEL_1 = 'LEVEL_1',
     LEVEL_2 = 'LEVEL_2',

package/src/remittance/dtos/RemittanceSegment.ts

@@ -0,0 +1,132 @@
+import { Type } from "class-transformer";
+import {
+    IsArray,
+    IsEnum,
+    IsOptional,
+    IsString,
+    IsUUID,
+    Length,
+    ValidateNested,
+} from "class-validator";
+import { SegmentMemberType } from "../enums/SegmentMemberType";
+
+/**
+ * DTOs de Segmentos (Dashboard Ops · Configuración §2, EP-22..25 + catalog + search).
+ *
+ * Un segmento es una colección EXPLÍCITA de clientes: referencias a grupos
+ * (Group_GT) y tags (UserTags_GT) por id + individuos (override por cliente).
+ * Dueño de la tabla: remittance-business (RemittanceSegments_GT).
+ *
+ * "Clientes" del segmento = intersección con RemittanceUsers_GT (usuarios de
+ * remesas que caen en el segmento), NO la membresía Fiado-wide del picker.
+ */
+
+/** Referencia de composición: un grupo (Group_GT.id) o un tag (UserTags_GT.tag). */
+export class SegmentMember {
+    @IsEnum(SegmentMemberType)
+    type!: SegmentMemberType;
+
+    /** Group_GT.id (p. ej. "CELULARES") o el tag (p. ej. "VIPS"). */
+    @IsString()
+    @Length(1, 100)
+    id!: string;
+}
+
+/** Individuo agregado explícitamente (la llave es directoryId; peopleId informativo). */
+export class SegmentIndividual {
+    @IsUUID("4")
+    directoryId!: string;
+
+    @IsOptional()
+    @IsUUID("4")
+    peopleId?: string;
+
+    /** Snapshot de display (se pinta sin lookup). */
+    @IsString()
+    @Length(1, 200)
+    name!: string;
+}
+
+/** Body de EP-23 POST /backoffice/config/segments. */
+export class CreateSegmentRequest {
+    @IsString()
+    @Length(3, 100)
+    name!: string;
+
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => SegmentMember)
+    members!: SegmentMember[];
+
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => SegmentIndividual)
+    individuals!: SegmentIndividual[];
+}
+
+/** Body de EP-24 PUT /backoffice/config/segments/{id} (reemplazo completo). */
+export class UpdateSegmentRequest {
+    @IsString()
+    @Length(3, 100)
+    name!: string;
+
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => SegmentMember)
+    members!: SegmentMember[];
+
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => SegmentIndividual)
+    individuals!: SegmentIndividual[];
+}
+
+/** Segmento completo (response). Métricas null = nunca calculadas. */
+export class Segment {
+    id!: string;
+    name!: string;
+    /** true solo en ESTANDAR (catch-all: composición bloqueada, no eliminable). */
+    isDefault!: boolean;
+    members!: SegmentMember[];
+    individuals!: SegmentIndividual[];
+    /** # de RemittanceUsers en el segmento (intersección con remesas). */
+    clientCount!: number | null;
+    /** Σ amountUSD del mes calendario de esos users (sin CANCELLED/REFUND). */
+    volMonthUSD!: number | null;
+    lastCalculatedAt!: string | null;
+    createdAt!: string;
+    updatedAt!: string;
+    createdBy!: string;
+    updatedBy!: string;
+}
+
+/** Response de EP-22 GET /backoffice/config/segments. */
+export class SegmentListResponse {
+    items!: Segment[];
+}
+
+/** Response de POST /backoffice/config/segments/{id}/recalcular. */
+export class RecalculateSegmentResponse {
+    id!: string;
+    clientCount!: number;
+    volMonthUSD!: number;
+    lastCalculatedAt!: string;
+}
+
+/** Item del picker DISPONIBLES (EP-32 catalog). `count` = membresía Fiado-wide. */
+export class SegmentCatalogItem {
+    type!: SegmentMemberType;
+    id!: string;
+    name!: string;
+    count!: number;
+}
+
+/** Response de GET /backoffice/config/segments/catalog. */
+export class SegmentCatalogResponse {
+    items!: SegmentCatalogItem[];
+}
+
+/** Response de GET /backoffice/config/segments/search-individual?q= (cap 20). */
+export class SearchIndividualResponse {
+    items!: SegmentIndividual[];
+}

package/src/remittance/dtos/index.ts

@@ -38,3 +38,4 @@ export * from "./RemittanceUserLimits";
 export * from "./RemittanceKyc";
 export * from "./RemittanceCohort";
 export * from "./RemittanceAuditLog";
+export * from "./RemittanceSegment";

package/src/remittance/dtos/internal/RemittanceSegmentMetrics.ts

@@ -0,0 +1,22 @@
+import { IsArray, IsUUID } from "class-validator";
+
+/**
+ * Contrato interno de métricas de un segmento (puente Opción A):
+ * remittance-business resuelve la membresía (subconjunto de RemittanceUsers que
+ * caen en el segmento) y el uniteller-connector (dueño de las tx) devuelve el
+ * conteo validado + volumen del mes. Vía api-invoker →
+ * POST /backoffice/config/segments/metrics (privado).
+ */
+export class SegmentMetricsRequest {
+    /** Subconjunto ya resuelto por rb. `[]` → { clientCount: 0, volMonthUSD: 0 }. */
+    @IsArray()
+    @IsUUID("4", { each: true })
+    directoryIds!: string[];
+}
+
+export class SegmentMetricsResponse {
+    /** ids del request que SÍ existen en RemittanceUsers_GT. */
+    clientCount!: number;
+    /** Σ amountUSD del mes calendario corriente (UTC) de esos users, sin CANCELLED/REFUND. */
+    volMonthUSD!: number;
+}

package/src/remittance/enums/SegmentMemberType.ts

@@ -0,0 +1,8 @@
+/**
+ * Tipo de miembro de la composición de un segmento (Dashboard Ops · Configuración §2).
+ * Los valores son los del mockup (pills GRUPO/TAG del dual-list).
+ */
+export enum SegmentMemberType {
+    GROUP = "group",
+    TAG = "tag",
+}

package/src/remittance/enums/index.ts

@@ -10,3 +10,4 @@ export * from "./CohortOperator";
 export * from "./CohortRefresh";
 export * from "./AuditAction";
 export * from "./AuditEntityType";
+export * from "./SegmentMemberType";

package/src/remittance/index.ts

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

package/src/userTags/dtos/TagsByDirectoriesRequest.ts

@@ -0,0 +1,8 @@
+import { IsArray, IsUUID } from "class-validator";
+
+/** Request de POST tags/by-directories (privado, onboarding-business). */
+export class TagsByDirectoriesRequest {
+    @IsArray()
+    @IsUUID("4", { each: true })
+    directoryIds!: string[];
+}

package/src/userTags/dtos/TagsByDirectoriesResponse.ts

@@ -0,0 +1,7 @@
+/**
+ * Tags por usuario para un batch de directoryIds. Ids sin tags → `[]`
+ * (siempre presentes en el mapa, para que el consumidor no distinga ausencia).
+ */
+export class TagsByDirectoriesResponse {
+    tagsByDirectory!: Record<string, string[]>;
+}

package/src/userTags/dtos/TagsSummaryResponse.ts

@@ -0,0 +1,10 @@
+/** Un tag operativo con su # de asignaciones en UserTags_GT (membresía Fiado-wide). */
+export class TagSummaryItem {
+    tag!: string;
+    count!: number;
+}
+
+/** Response de GET tags/summary (privado, onboarding-business). Orden: count desc. */
+export class TagsSummaryResponse {
+    items!: TagSummaryItem[];
+}

package/src/userTags/index.ts

@@ -0,0 +1,4 @@
+//dtos
+export * from './dtos/TagsSummaryResponse';
+export * from './dtos/TagsByDirectoriesRequest';
+export * from './dtos/TagsByDirectoriesResponse';