@fiado/type-kit 3.186.0 → 3.187.0

package/bin/index.d.ts

@@ -91,5 +91,6 @@ export * as EmailVerification from './emailVerification';
 export * as RetailOrg from './retailOrg';
 export * as LoanConfig from './loanConfig';
 export * as LoanOfferings from './loanOfferings';
+export * as LoanCollectorAssignment from './loanCollectorAssignment';
 export * from './messaging';
 export * from './complaint';

package/bin/index.js

@@ -37,7 +37,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 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.AppContent = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Account = exports.Crypto = void 0;
-exports.LoanOfferings = exports.LoanConfig = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = 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 = exports.AppSelectionData = void 0;
+exports.LoanCollectorAssignment = exports.LoanOfferings = exports.LoanConfig = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = 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 = exports.AppSelectionData = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.Activity = __importStar(require("./activity"));
@@ -148,5 +148,8 @@ exports.LoanConfig = __importStar(require("./loanConfig"));
 // LoanOfferings: DTOs/enums del lambda loan-offerings-business (comp 07 — planes de crédito,
 // financieras, M:N retailer↔plan y simulador de cuota; SureKeep Fase 1 — pista Loan).
 exports.LoanOfferings = __importStar(require("./loanOfferings"));
+// LoanCollectorAssignment: DTOs/enums del lambda loan-collector-assignment-business (comp 08 — reglas de
+// asignación de cartera de cobranza + asignaciones crédito↔cobrador; SureKeep Fase 1 — pista Loan).
+exports.LoanCollectorAssignment = __importStar(require("./loanCollectorAssignment"));
 __exportStar(require("./messaging"), exports);
 __exportStar(require("./complaint"), exports);

package/bin/loanCollectorAssignment/dtos/PriorityWeights.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Pesos del ranking ponderado del algoritmo (modelo-datos §7.1). Cada peso es 0..100; la regla
+ * cross-campo `storeMatch + loadAvailable + seniority === 100` la valida el manager del lambda
+ * (WeightsSumInvalidError) — class-validator no cubre validaciones entre campos.
+ */
+export declare class PriorityWeights {
+    storeMatch: number;
+    loadAvailable: number;
+    seniority: number;
+}

package/bin/loanCollectorAssignment/dtos/PriorityWeights.js

@@ -0,0 +1,43 @@
+"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.PriorityWeights = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Pesos del ranking ponderado del algoritmo (modelo-datos §7.1). Cada peso es 0..100; la regla
+ * cross-campo `storeMatch + loadAvailable + seniority === 100` la valida el manager del lambda
+ * (WeightsSumInvalidError) — class-validator no cubre validaciones entre campos.
+ */
+class PriorityWeights {
+}
+exports.PriorityWeights = PriorityWeights;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], PriorityWeights.prototype, "storeMatch", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], PriorityWeights.prototype, "loadAvailable", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], PriorityWeights.prototype, "seniority", void 0);

package/bin/loanCollectorAssignment/dtos/requests/AutoAssignRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Body de POST /private/collector-assignments/auto-assign (hot path). Lo invoca loan-credit-business
+ * al crearse un crédito (F3+); en F1 se prueba con `creditId` dummy. Elige cobrador y persiste ACTIVE.
+ */
+export declare class AutoAssignRequest {
+    retailerId: string;
+    creditId: string;
+    storeId: string;
+}

package/bin/loanCollectorAssignment/dtos/requests/AutoAssignRequest.js

@@ -0,0 +1,39 @@
+"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.AutoAssignRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body de POST /private/collector-assignments/auto-assign (hot path). Lo invoca loan-credit-business
+ * al crearse un crédito (F3+); en F1 se prueba con `creditId` dummy. Elige cobrador y persiste ACTIVE.
+ */
+class AutoAssignRequest {
+}
+exports.AutoAssignRequest = AutoAssignRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AutoAssignRequest.prototype, "retailerId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AutoAssignRequest.prototype, "creditId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AutoAssignRequest.prototype, "storeId", void 0);

package/bin/loanCollectorAssignment/dtos/requests/CreateAssignmentRuleRequest.d.ts

@@ -0,0 +1,12 @@
+import { AssignmentStrategyEnum } from '../../enums/AssignmentStrategyEnum';
+import { PriorityWeights } from '../PriorityWeights';
+/**
+ * Body de POST /retailers/:retailerId/assignment-rules. Crea una regla de asignación.
+ * Los pesos deben sumar 100 (lo valida el manager). `active: true` desactiva la regla activa anterior.
+ */
+export declare class CreateAssignmentRuleRequest {
+    strategy: AssignmentStrategyEnum;
+    maxLoadPerCollector?: number | null;
+    priorityWeights: PriorityWeights;
+    active: boolean;
+}

package/bin/loanCollectorAssignment/dtos/requests/CreateAssignmentRuleRequest.js

@@ -0,0 +1,46 @@
+"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.CreateAssignmentRuleRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const AssignmentStrategyEnum_1 = require("../../enums/AssignmentStrategyEnum");
+const PriorityWeights_1 = require("../PriorityWeights");
+/**
+ * Body de POST /retailers/:retailerId/assignment-rules. Crea una regla de asignación.
+ * Los pesos deben sumar 100 (lo valida el manager). `active: true` desactiva la regla activa anterior.
+ */
+class CreateAssignmentRuleRequest {
+}
+exports.CreateAssignmentRuleRequest = CreateAssignmentRuleRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(AssignmentStrategyEnum_1.AssignmentStrategyEnum),
+    __metadata("design:type", String)
+], CreateAssignmentRuleRequest.prototype, "strategy", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], CreateAssignmentRuleRequest.prototype, "maxLoadPerCollector", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => PriorityWeights_1.PriorityWeights),
+    __metadata("design:type", PriorityWeights_1.PriorityWeights)
+], CreateAssignmentRuleRequest.prototype, "priorityWeights", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], CreateAssignmentRuleRequest.prototype, "active", void 0);

package/bin/loanCollectorAssignment/dtos/requests/ReassignRequest.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Body de POST /retailers/:retailerId/collector-assignments/:assignmentId/reassign (reasignación manual).
+ * `reason` obligatorio (auditoría de acción crítica — modelo-datos §10).
+ */
+export declare class ReassignRequest {
+    reason: string;
+}

package/bin/loanCollectorAssignment/dtos/requests/ReassignRequest.js

@@ -0,0 +1,27 @@
+"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.ReassignRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body de POST /retailers/:retailerId/collector-assignments/:assignmentId/reassign (reasignación manual).
+ * `reason` obligatorio (auditoría de acción crítica — modelo-datos §10).
+ */
+class ReassignRequest {
+}
+exports.ReassignRequest = ReassignRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ReassignRequest.prototype, "reason", void 0);

package/bin/loanCollectorAssignment/dtos/requests/RedistributeRequest.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Body de POST /retailers/:retailerId/collectors/:userId/redistribute. Redistribuye la cartera activa de
+ * un cobrador (ej. al desactivarlo). `reason` obligatorio (ej. `USER_INACTIVATED`) — auditoría §10.
+ */
+export declare class RedistributeRequest {
+    reason: string;
+}

package/bin/loanCollectorAssignment/dtos/requests/RedistributeRequest.js

@@ -0,0 +1,27 @@
+"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.RedistributeRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body de POST /retailers/:retailerId/collectors/:userId/redistribute. Redistribuye la cartera activa de
+ * un cobrador (ej. al desactivarlo). `reason` obligatorio (ej. `USER_INACTIVATED`) — auditoría §10.
+ */
+class RedistributeRequest {
+}
+exports.RedistributeRequest = RedistributeRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RedistributeRequest.prototype, "reason", void 0);

package/bin/loanCollectorAssignment/dtos/requests/UpdateAssignmentRuleRequest.d.ts

@@ -0,0 +1,12 @@
+import { AssignmentStrategyEnum } from '../../enums/AssignmentStrategyEnum';
+import { PriorityWeights } from '../PriorityWeights';
+/**
+ * Body de PUT /retailers/:retailerId/assignment-rules/:ruleId. Update parcial: todos los campos opcionales.
+ * Si se envían `priorityWeights`, deben sumar 100 (lo valida el manager).
+ */
+export declare class UpdateAssignmentRuleRequest {
+    strategy?: AssignmentStrategyEnum;
+    maxLoadPerCollector?: number | null;
+    priorityWeights?: PriorityWeights;
+    active?: boolean;
+}

package/bin/loanCollectorAssignment/dtos/requests/UpdateAssignmentRuleRequest.js

@@ -0,0 +1,49 @@
+"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.UpdateAssignmentRuleRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const AssignmentStrategyEnum_1 = require("../../enums/AssignmentStrategyEnum");
+const PriorityWeights_1 = require("../PriorityWeights");
+/**
+ * Body de PUT /retailers/:retailerId/assignment-rules/:ruleId. Update parcial: todos los campos opcionales.
+ * Si se envían `priorityWeights`, deben sumar 100 (lo valida el manager).
+ */
+class UpdateAssignmentRuleRequest {
+}
+exports.UpdateAssignmentRuleRequest = UpdateAssignmentRuleRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(AssignmentStrategyEnum_1.AssignmentStrategyEnum),
+    __metadata("design:type", String)
+], UpdateAssignmentRuleRequest.prototype, "strategy", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], UpdateAssignmentRuleRequest.prototype, "maxLoadPerCollector", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => PriorityWeights_1.PriorityWeights),
+    __metadata("design:type", PriorityWeights_1.PriorityWeights)
+], UpdateAssignmentRuleRequest.prototype, "priorityWeights", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateAssignmentRuleRequest.prototype, "active", void 0);

package/bin/loanCollectorAssignment/dtos/responses/AssignmentRuleResponse.d.ts

@@ -0,0 +1,15 @@
+import { AssignmentStrategyEnum } from '../../enums/AssignmentStrategyEnum';
+import { PriorityWeights } from '../PriorityWeights';
+/** Shape de salida de una regla de asignación (modelo-datos §7.1). */
+export interface AssignmentRuleResponse {
+    ruleId: string;
+    retailerId: string;
+    strategy: AssignmentStrategyEnum;
+    maxLoadPerCollector: number | null;
+    priorityWeights: PriorityWeights;
+    active: boolean;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/bin/loanCollectorAssignment/dtos/responses/AssignmentRuleResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanCollectorAssignment/dtos/responses/CollectorAssignmentResponse.d.ts

@@ -0,0 +1,16 @@
+import { AssignmentStatusEnum } from '../../enums/AssignmentStatusEnum';
+/** Shape de salida de una asignación crédito↔cobrador (modelo-datos §7.2). */
+export interface CollectorAssignmentResponse {
+    assignmentId: string;
+    retailerId: string;
+    creditId: string;
+    storeId: string;
+    collectorUserId: string;
+    assignedAt: string;
+    status: AssignmentStatusEnum;
+    reassignedFromUserId: string | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/bin/loanCollectorAssignment/dtos/responses/CollectorAssignmentResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanCollectorAssignment/dtos/responses/CollectorLoadResponse.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Carga actual de un cobrador (flow 07.2 / GET /retailers/:retailerId/collector-loads).
+ * `activeAssignments` = COUNT de asignaciones ACTIVE (GSI collectorUserId-assignedAt-index).
+ * `threshold` = maxLoadPerCollector de la regla activa (null si no hay tope).
+ */
+export interface CollectorLoadResponse {
+    collectorUserId: string;
+    activeAssignments: number;
+    threshold: number | null;
+    storeIds: string[];
+}

package/bin/loanCollectorAssignment/dtos/responses/CollectorLoadResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanCollectorAssignment/dtos/responses/RedistributeSummaryResponse.d.ts

@@ -0,0 +1,9 @@
+/** Resultado de redistribuir la cartera activa de un cobrador (flow 07.4). */
+export interface RedistributeSummaryResponse {
+    reassignedCount: number;
+    errors: RedistributeError[];
+}
+export interface RedistributeError {
+    creditId: string;
+    reason: string;
+}

package/bin/loanCollectorAssignment/dtos/responses/RedistributeSummaryResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanCollectorAssignment/enums/AssignmentStatusEnum.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Estado de una asignación crédito↔cobrador (modelo-datos §7.2). Historial append-only:
+ * 1 crédito = 1 `ACTIVE`; reasignación → row vieja `REASSIGNED`; release/liquidado → `INACTIVE`.
+ * @enum {string}
+ */
+export declare enum AssignmentStatusEnum {
+    ACTIVE = "ACTIVE",
+    INACTIVE = "INACTIVE",
+    REASSIGNED = "REASSIGNED"
+}

package/bin/loanCollectorAssignment/enums/AssignmentStatusEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssignmentStatusEnum = void 0;
+/**
+ * Estado de una asignación crédito↔cobrador (modelo-datos §7.2). Historial append-only:
+ * 1 crédito = 1 `ACTIVE`; reasignación → row vieja `REASSIGNED`; release/liquidado → `INACTIVE`.
+ * @enum {string}
+ */
+var AssignmentStatusEnum;
+(function (AssignmentStatusEnum) {
+    AssignmentStatusEnum["ACTIVE"] = "ACTIVE";
+    AssignmentStatusEnum["INACTIVE"] = "INACTIVE";
+    AssignmentStatusEnum["REASSIGNED"] = "REASSIGNED";
+})(AssignmentStatusEnum || (exports.AssignmentStatusEnum = AssignmentStatusEnum = {}));

package/bin/loanCollectorAssignment/enums/AssignmentStrategyEnum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Estrategia de asignación de cartera de cobranza (modelo-datos §7.1 / M6 §7.5).
+ * DEC-008 (loan-collector-assignment): se soportan las 4 + ranking híbrido (strategy + priorityWeights).
+ * A RATIFICAR con Jaime/senior: M6 §7.5 solo respalda 3 — `ROUND_ROBIN` es adición del spec 08.
+ * @enum {string}
+ */
+export declare enum AssignmentStrategyEnum {
+    BY_STORE = "BY_STORE",
+    BY_LOAD = "BY_LOAD",
+    BY_SENIORITY = "BY_SENIORITY",
+    ROUND_ROBIN = "ROUND_ROBIN"
+}

package/bin/loanCollectorAssignment/enums/AssignmentStrategyEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssignmentStrategyEnum = void 0;
+/**
+ * Estrategia de asignación de cartera de cobranza (modelo-datos §7.1 / M6 §7.5).
+ * DEC-008 (loan-collector-assignment): se soportan las 4 + ranking híbrido (strategy + priorityWeights).
+ * A RATIFICAR con Jaime/senior: M6 §7.5 solo respalda 3 — `ROUND_ROBIN` es adición del spec 08.
+ * @enum {string}
+ */
+var AssignmentStrategyEnum;
+(function (AssignmentStrategyEnum) {
+    AssignmentStrategyEnum["BY_STORE"] = "BY_STORE";
+    AssignmentStrategyEnum["BY_LOAD"] = "BY_LOAD";
+    AssignmentStrategyEnum["BY_SENIORITY"] = "BY_SENIORITY";
+    AssignmentStrategyEnum["ROUND_ROBIN"] = "ROUND_ROBIN";
+})(AssignmentStrategyEnum || (exports.AssignmentStrategyEnum = AssignmentStrategyEnum = {}));

package/bin/loanCollectorAssignment/index.d.ts

@@ -0,0 +1,12 @@
+export * from './enums/AssignmentStrategyEnum';
+export * from './enums/AssignmentStatusEnum';
+export * from './dtos/PriorityWeights';
+export * from './dtos/requests/CreateAssignmentRuleRequest';
+export * from './dtos/requests/UpdateAssignmentRuleRequest';
+export * from './dtos/requests/AutoAssignRequest';
+export * from './dtos/requests/ReassignRequest';
+export * from './dtos/requests/RedistributeRequest';
+export * from './dtos/responses/AssignmentRuleResponse';
+export * from './dtos/responses/CollectorAssignmentResponse';
+export * from './dtos/responses/CollectorLoadResponse';
+export * from './dtos/responses/RedistributeSummaryResponse';

package/bin/loanCollectorAssignment/index.js

@@ -0,0 +1,32 @@
+"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 });
+// Enums
+__exportStar(require("./enums/AssignmentStrategyEnum"), exports);
+__exportStar(require("./enums/AssignmentStatusEnum"), exports);
+// Shared DTOs
+__exportStar(require("./dtos/PriorityWeights"), exports);
+// Request DTOs
+__exportStar(require("./dtos/requests/CreateAssignmentRuleRequest"), exports);
+__exportStar(require("./dtos/requests/UpdateAssignmentRuleRequest"), exports);
+__exportStar(require("./dtos/requests/AutoAssignRequest"), exports);
+__exportStar(require("./dtos/requests/ReassignRequest"), exports);
+__exportStar(require("./dtos/requests/RedistributeRequest"), exports);
+// Response DTOs
+__exportStar(require("./dtos/responses/AssignmentRuleResponse"), exports);
+__exportStar(require("./dtos/responses/CollectorAssignmentResponse"), exports);
+__exportStar(require("./dtos/responses/CollectorLoadResponse"), exports);
+__exportStar(require("./dtos/responses/RedistributeSummaryResponse"), exports);

package/package.json

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

package/src/index.ts

@@ -108,5 +108,8 @@ export * as LoanConfig from './loanConfig';
 // LoanOfferings: DTOs/enums del lambda loan-offerings-business (comp 07 — planes de crédito,
 // financieras, M:N retailer↔plan y simulador de cuota; SureKeep Fase 1 — pista Loan).
 export * as LoanOfferings from './loanOfferings';
+// LoanCollectorAssignment: DTOs/enums del lambda loan-collector-assignment-business (comp 08 — reglas de
+// asignación de cartera de cobranza + asignaciones crédito↔cobrador; SureKeep Fase 1 — pista Loan).
+export * as LoanCollectorAssignment from './loanCollectorAssignment';
 export * from './messaging';
 export * from './complaint';

package/src/loanCollectorAssignment/dtos/PriorityWeights.ts

@@ -0,0 +1,27 @@
+import { Expose } from 'class-transformer';
+import { IsInt, Max, Min } from 'class-validator';
+
+/**
+ * Pesos del ranking ponderado del algoritmo (modelo-datos §7.1). Cada peso es 0..100; la regla
+ * cross-campo `storeMatch + loadAvailable + seniority === 100` la valida el manager del lambda
+ * (WeightsSumInvalidError) — class-validator no cubre validaciones entre campos.
+ */
+export class PriorityWeights {
+    @Expose()
+    @IsInt()
+    @Min(0)
+    @Max(100)
+    storeMatch!: number;
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    @Max(100)
+    loadAvailable!: number;
+
+    @Expose()
+    @IsInt()
+    @Min(0)
+    @Max(100)
+    seniority!: number;
+}

package/src/loanCollectorAssignment/dtos/requests/AutoAssignRequest.ts

@@ -0,0 +1,23 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsString } from 'class-validator';
+
+/**
+ * Body de POST /private/collector-assignments/auto-assign (hot path). Lo invoca loan-credit-business
+ * al crearse un crédito (F3+); en F1 se prueba con `creditId` dummy. Elige cobrador y persiste ACTIVE.
+ */
+export class AutoAssignRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    retailerId!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    creditId!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    storeId!: string;
+}

package/src/loanCollectorAssignment/dtos/requests/CreateAssignmentRuleRequest.ts

@@ -0,0 +1,29 @@
+import { Expose, Type } from 'class-transformer';
+import { IsBoolean, IsEnum, IsInt, IsOptional, Min, ValidateNested } from 'class-validator';
+import { AssignmentStrategyEnum } from '../../enums/AssignmentStrategyEnum';
+import { PriorityWeights } from '../PriorityWeights';
+
+/**
+ * Body de POST /retailers/:retailerId/assignment-rules. Crea una regla de asignación.
+ * Los pesos deben sumar 100 (lo valida el manager). `active: true` desactiva la regla activa anterior.
+ */
+export class CreateAssignmentRuleRequest {
+    @Expose()
+    @IsEnum(AssignmentStrategyEnum)
+    strategy!: AssignmentStrategyEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    maxLoadPerCollector?: number | null;
+
+    @Expose()
+    @ValidateNested()
+    @Type(() => PriorityWeights)
+    priorityWeights!: PriorityWeights;
+
+    @Expose()
+    @IsBoolean()
+    active!: boolean;
+}

package/src/loanCollectorAssignment/dtos/requests/ReassignRequest.ts

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsString } from 'class-validator';
+
+/**
+ * Body de POST /retailers/:retailerId/collector-assignments/:assignmentId/reassign (reasignación manual).
+ * `reason` obligatorio (auditoría de acción crítica — modelo-datos §10).
+ */
+export class ReassignRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    reason!: string;
+}

package/src/loanCollectorAssignment/dtos/requests/RedistributeRequest.ts

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsString } from 'class-validator';
+
+/**
+ * Body de POST /retailers/:retailerId/collectors/:userId/redistribute. Redistribuye la cartera activa de
+ * un cobrador (ej. al desactivarlo). `reason` obligatorio (ej. `USER_INACTIVATED`) — auditoría §10.
+ */
+export class RedistributeRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    reason!: string;
+}

package/src/loanCollectorAssignment/dtos/requests/UpdateAssignmentRuleRequest.ts

@@ -0,0 +1,32 @@
+import { Expose, Type } from 'class-transformer';
+import { IsBoolean, IsEnum, IsInt, IsOptional, Min, ValidateNested } from 'class-validator';
+import { AssignmentStrategyEnum } from '../../enums/AssignmentStrategyEnum';
+import { PriorityWeights } from '../PriorityWeights';
+
+/**
+ * Body de PUT /retailers/:retailerId/assignment-rules/:ruleId. Update parcial: todos los campos opcionales.
+ * Si se envían `priorityWeights`, deben sumar 100 (lo valida el manager).
+ */
+export class UpdateAssignmentRuleRequest {
+    @Expose()
+    @IsOptional()
+    @IsEnum(AssignmentStrategyEnum)
+    strategy?: AssignmentStrategyEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    maxLoadPerCollector?: number | null;
+
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => PriorityWeights)
+    priorityWeights?: PriorityWeights;
+
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    active?: boolean;
+}

package/src/loanCollectorAssignment/dtos/responses/AssignmentRuleResponse.ts

@@ -0,0 +1,16 @@
+import { AssignmentStrategyEnum } from '../../enums/AssignmentStrategyEnum';
+import { PriorityWeights } from '../PriorityWeights';
+
+/** Shape de salida de una regla de asignación (modelo-datos §7.1). */
+export interface AssignmentRuleResponse {
+    ruleId: string;
+    retailerId: string;
+    strategy: AssignmentStrategyEnum;
+    maxLoadPerCollector: number | null;
+    priorityWeights: PriorityWeights;
+    active: boolean;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/src/loanCollectorAssignment/dtos/responses/CollectorAssignmentResponse.ts

@@ -0,0 +1,17 @@
+import { AssignmentStatusEnum } from '../../enums/AssignmentStatusEnum';
+
+/** Shape de salida de una asignación crédito↔cobrador (modelo-datos §7.2). */
+export interface CollectorAssignmentResponse {
+    assignmentId: string;
+    retailerId: string;
+    creditId: string;
+    storeId: string;
+    collectorUserId: string;
+    assignedAt: string;
+    status: AssignmentStatusEnum;
+    reassignedFromUserId: string | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/src/loanCollectorAssignment/dtos/responses/CollectorLoadResponse.ts

@@ -0,0 +1,11 @@
+/**
+ * Carga actual de un cobrador (flow 07.2 / GET /retailers/:retailerId/collector-loads).
+ * `activeAssignments` = COUNT de asignaciones ACTIVE (GSI collectorUserId-assignedAt-index).
+ * `threshold` = maxLoadPerCollector de la regla activa (null si no hay tope).
+ */
+export interface CollectorLoadResponse {
+    collectorUserId: string;
+    activeAssignments: number;
+    threshold: number | null;
+    storeIds: string[];
+}

package/src/loanCollectorAssignment/dtos/responses/RedistributeSummaryResponse.ts

@@ -0,0 +1,10 @@
+/** Resultado de redistribuir la cartera activa de un cobrador (flow 07.4). */
+export interface RedistributeSummaryResponse {
+    reassignedCount: number;
+    errors: RedistributeError[];
+}
+
+export interface RedistributeError {
+    creditId: string;
+    reason: string;
+}

package/src/loanCollectorAssignment/enums/AssignmentStatusEnum.ts

@@ -0,0 +1,10 @@
+/**
+ * Estado de una asignación crédito↔cobrador (modelo-datos §7.2). Historial append-only:
+ * 1 crédito = 1 `ACTIVE`; reasignación → row vieja `REASSIGNED`; release/liquidado → `INACTIVE`.
+ * @enum {string}
+ */
+export enum AssignmentStatusEnum {
+    ACTIVE = 'ACTIVE',
+    INACTIVE = 'INACTIVE',
+    REASSIGNED = 'REASSIGNED',
+}

package/src/loanCollectorAssignment/enums/AssignmentStrategyEnum.ts

@@ -0,0 +1,12 @@
+/**
+ * Estrategia de asignación de cartera de cobranza (modelo-datos §7.1 / M6 §7.5).
+ * DEC-008 (loan-collector-assignment): se soportan las 4 + ranking híbrido (strategy + priorityWeights).
+ * A RATIFICAR con Jaime/senior: M6 §7.5 solo respalda 3 — `ROUND_ROBIN` es adición del spec 08.
+ * @enum {string}
+ */
+export enum AssignmentStrategyEnum {
+    BY_STORE = 'BY_STORE',
+    BY_LOAD = 'BY_LOAD',
+    BY_SENIORITY = 'BY_SENIORITY',
+    ROUND_ROBIN = 'ROUND_ROBIN',
+}

package/src/loanCollectorAssignment/index.ts

@@ -0,0 +1,19 @@
+// Enums
+export * from './enums/AssignmentStrategyEnum';
+export * from './enums/AssignmentStatusEnum';
+
+// Shared DTOs
+export * from './dtos/PriorityWeights';
+
+// Request DTOs
+export * from './dtos/requests/CreateAssignmentRuleRequest';
+export * from './dtos/requests/UpdateAssignmentRuleRequest';
+export * from './dtos/requests/AutoAssignRequest';
+export * from './dtos/requests/ReassignRequest';
+export * from './dtos/requests/RedistributeRequest';
+
+// Response DTOs
+export * from './dtos/responses/AssignmentRuleResponse';
+export * from './dtos/responses/CollectorAssignmentResponse';
+export * from './dtos/responses/CollectorLoadResponse';
+export * from './dtos/responses/RedistributeSummaryResponse';