@fiado/type-kit 3.278.0 → 3.280.0

package/bin/collection/dtos/CollectionAttemptDto.d.ts

@@ -0,0 +1,15 @@
+import { MechanismType } from '../enums/MechanismType';
+import { CollectionResultStatus } from '../enums/CollectionResultStatus';
+/** Un intento de cobro ejecutado sobre un intent, para el backoffice de monitoreo. */
+export declare class CollectionAttemptDto {
+    attemptId: string;
+    intentId: string;
+    source: string;
+    mechanism: MechanismType;
+    amount: number;
+    holdTxId?: string;
+    result?: CollectionResultStatus;
+    errorCode?: string;
+    errorDetail?: string;
+    createdAt: number;
+}

package/bin/collection/dtos/CollectionAttemptDto.js

@@ -0,0 +1,63 @@
+"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.CollectionAttemptDto = void 0;
+const class_validator_1 = require("class-validator");
+const MechanismType_1 = require("../enums/MechanismType");
+const CollectionResultStatus_1 = require("../enums/CollectionResultStatus");
+/** Un intento de cobro ejecutado sobre un intent, para el backoffice de monitoreo. */
+class CollectionAttemptDto {
+}
+exports.CollectionAttemptDto = CollectionAttemptDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionAttemptDto.prototype, "attemptId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionAttemptDto.prototype, "intentId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionAttemptDto.prototype, "source", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(MechanismType_1.MechanismType),
+    __metadata("design:type", String)
+], CollectionAttemptDto.prototype, "mechanism", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionAttemptDto.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionAttemptDto.prototype, "holdTxId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(CollectionResultStatus_1.CollectionResultStatus),
+    __metadata("design:type", String)
+], CollectionAttemptDto.prototype, "result", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionAttemptDto.prototype, "errorCode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionAttemptDto.prototype, "errorDetail", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionAttemptDto.prototype, "createdAt", void 0);

package/bin/collection/dtos/CollectionErrorLogDto.d.ts

@@ -0,0 +1,12 @@
+import { SagaStep } from '../enums/SagaStep';
+/** Entrada del log estructurado de errores del motor de cobro, para el backoffice de monitoreo. */
+export declare class CollectionErrorLogDto {
+    errorId: string;
+    intentId?: string;
+    attemptId?: string;
+    sagaStep?: SagaStep;
+    errorCode: string;
+    errorDetail?: string;
+    tenantId: string;
+    createdAt: number;
+}

package/bin/collection/dtos/CollectionErrorLogDto.js

@@ -0,0 +1,54 @@
+"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.CollectionErrorLogDto = void 0;
+const class_validator_1 = require("class-validator");
+const SagaStep_1 = require("../enums/SagaStep");
+/** Entrada del log estructurado de errores del motor de cobro, para el backoffice de monitoreo. */
+class CollectionErrorLogDto {
+}
+exports.CollectionErrorLogDto = CollectionErrorLogDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionErrorLogDto.prototype, "errorId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionErrorLogDto.prototype, "intentId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionErrorLogDto.prototype, "attemptId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(SagaStep_1.SagaStep),
+    __metadata("design:type", String)
+], CollectionErrorLogDto.prototype, "sagaStep", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionErrorLogDto.prototype, "errorCode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionErrorLogDto.prototype, "errorDetail", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionErrorLogDto.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionErrorLogDto.prototype, "createdAt", void 0);

package/bin/collection/dtos/CollectionIntentDetailDto.d.ts

@@ -0,0 +1,10 @@
+import { CollectionIntentSummaryDto } from './CollectionIntentSummaryDto';
+import { CollectionAttemptDto } from './CollectionAttemptDto';
+import { CollectionOutboxEventDto } from './CollectionOutboxEventDto';
+import { CollectionErrorLogDto } from './CollectionErrorLogDto';
+/** Detalle de un intent para el backoffice de monitoreo: el resumen más su historial completo. */
+export declare class CollectionIntentDetailDto extends CollectionIntentSummaryDto {
+    attempts: CollectionAttemptDto[];
+    outbox: CollectionOutboxEventDto[];
+    errors: CollectionErrorLogDto[];
+}

package/bin/collection/dtos/CollectionIntentDetailDto.js

@@ -0,0 +1,40 @@
+"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.CollectionIntentDetailDto = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const CollectionIntentSummaryDto_1 = require("./CollectionIntentSummaryDto");
+const CollectionAttemptDto_1 = require("./CollectionAttemptDto");
+const CollectionOutboxEventDto_1 = require("./CollectionOutboxEventDto");
+const CollectionErrorLogDto_1 = require("./CollectionErrorLogDto");
+/** Detalle de un intent para el backoffice de monitoreo: el resumen más su historial completo. */
+class CollectionIntentDetailDto extends CollectionIntentSummaryDto_1.CollectionIntentSummaryDto {
+}
+exports.CollectionIntentDetailDto = CollectionIntentDetailDto;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => CollectionAttemptDto_1.CollectionAttemptDto),
+    __metadata("design:type", Array)
+], CollectionIntentDetailDto.prototype, "attempts", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => CollectionOutboxEventDto_1.CollectionOutboxEventDto),
+    __metadata("design:type", Array)
+], CollectionIntentDetailDto.prototype, "outbox", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => CollectionErrorLogDto_1.CollectionErrorLogDto),
+    __metadata("design:type", Array)
+], CollectionIntentDetailDto.prototype, "errors", void 0);

package/bin/collection/dtos/CollectionIntentSummaryDto.d.ts

@@ -0,0 +1,22 @@
+import { CollectionState } from '../enums/CollectionState';
+import { SagaStep } from '../enums/SagaStep';
+/** Fila de listado de intents para el backoffice de monitoreo del motor de cobro. */
+export declare class CollectionIntentSummaryDto {
+    intentId: string;
+    ownerRef: string;
+    tenantId: string;
+    domain: string;
+    chargeId: string;
+    amount: number;
+    reserved?: number;
+    state: CollectionState;
+    sagaStep: SagaStep;
+    attention?: boolean;
+    failureCount?: number;
+    retryCount?: number;
+    nextRetryAt?: number;
+    lastErrorCode?: string;
+    lastErrorMsg?: string;
+    createdAt: number;
+    updatedAt: number;
+}

package/bin/collection/dtos/CollectionIntentSummaryDto.js

@@ -0,0 +1,94 @@
+"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.CollectionIntentSummaryDto = void 0;
+const class_validator_1 = require("class-validator");
+const CollectionState_1 = require("../enums/CollectionState");
+const SagaStep_1 = require("../enums/SagaStep");
+/** Fila de listado de intents para el backoffice de monitoreo del motor de cobro. */
+class CollectionIntentSummaryDto {
+}
+exports.CollectionIntentSummaryDto = CollectionIntentSummaryDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionIntentSummaryDto.prototype, "intentId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionIntentSummaryDto.prototype, "ownerRef", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionIntentSummaryDto.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionIntentSummaryDto.prototype, "domain", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionIntentSummaryDto.prototype, "chargeId", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionIntentSummaryDto.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionIntentSummaryDto.prototype, "reserved", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(CollectionState_1.CollectionState),
+    __metadata("design:type", String)
+], CollectionIntentSummaryDto.prototype, "state", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(SagaStep_1.SagaStep),
+    __metadata("design:type", String)
+], CollectionIntentSummaryDto.prototype, "sagaStep", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], CollectionIntentSummaryDto.prototype, "attention", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionIntentSummaryDto.prototype, "failureCount", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionIntentSummaryDto.prototype, "retryCount", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionIntentSummaryDto.prototype, "nextRetryAt", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionIntentSummaryDto.prototype, "lastErrorCode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionIntentSummaryDto.prototype, "lastErrorMsg", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionIntentSummaryDto.prototype, "createdAt", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionIntentSummaryDto.prototype, "updatedAt", void 0);

package/bin/collection/dtos/CollectionMetricsDto.d.ts

@@ -0,0 +1,9 @@
+/** Métricas agregadas del motor de cobro, para el dashboard del backoffice de monitoreo. */
+export declare class CollectionMetricsDto {
+    countsByState: Record<string, number>;
+    successRate: number;
+    amountReserved: number;
+    amountCollected: number;
+    backlogAwaitingFunds: number;
+    dlqCount: number;
+}

package/bin/collection/dtos/CollectionMetricsDto.js

@@ -0,0 +1,41 @@
+"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.CollectionMetricsDto = void 0;
+const class_validator_1 = require("class-validator");
+/** Métricas agregadas del motor de cobro, para el dashboard del backoffice de monitoreo. */
+class CollectionMetricsDto {
+}
+exports.CollectionMetricsDto = CollectionMetricsDto;
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], CollectionMetricsDto.prototype, "countsByState", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], CollectionMetricsDto.prototype, "successRate", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionMetricsDto.prototype, "amountReserved", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionMetricsDto.prototype, "amountCollected", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionMetricsDto.prototype, "backlogAwaitingFunds", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionMetricsDto.prototype, "dlqCount", void 0);

package/bin/collection/dtos/CollectionOutboxEventDto.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Mensaje del outbox transaccional (publicación de `CollectionResult` hacia el dominio), para el
+ * backoffice de monitoreo. `status` viaja como texto (p.ej. `PENDING`, `SENT`, `FAILED`, `DLQ`) — su
+ * enum de origen es interno a la mecánica de entrega del motor.
+ */
+export declare class CollectionOutboxEventDto {
+    eventId: string;
+    attemptId: string;
+    domain: string;
+    status: string;
+    deliveryAttempts?: number;
+    lastError?: string;
+    movedToDlqAt?: number;
+    createdAt: number;
+}

package/bin/collection/dtos/CollectionOutboxEventDto.js

@@ -0,0 +1,56 @@
+"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.CollectionOutboxEventDto = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Mensaje del outbox transaccional (publicación de `CollectionResult` hacia el dominio), para el
+ * backoffice de monitoreo. `status` viaja como texto (p.ej. `PENDING`, `SENT`, `FAILED`, `DLQ`) — su
+ * enum de origen es interno a la mecánica de entrega del motor.
+ */
+class CollectionOutboxEventDto {
+}
+exports.CollectionOutboxEventDto = CollectionOutboxEventDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionOutboxEventDto.prototype, "eventId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionOutboxEventDto.prototype, "attemptId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionOutboxEventDto.prototype, "domain", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionOutboxEventDto.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionOutboxEventDto.prototype, "deliveryAttempts", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionOutboxEventDto.prototype, "lastError", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionOutboxEventDto.prototype, "movedToDlqAt", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionOutboxEventDto.prototype, "createdAt", void 0);

package/bin/collection/index.d.ts

@@ -14,3 +14,9 @@ export * from './dtos/CollectionSourceDto';
 export * from './dtos/CollectionProductConfigDto';
 export * from './dtos/UpsertProductConfigRequest';
 export * from './dtos/ApplyCollectionResultRequest';
+export * from './dtos/CollectionIntentSummaryDto';
+export * from './dtos/CollectionAttemptDto';
+export * from './dtos/CollectionOutboxEventDto';
+export * from './dtos/CollectionErrorLogDto';
+export * from './dtos/CollectionIntentDetailDto';
+export * from './dtos/CollectionMetricsDto';

package/bin/collection/index.js

@@ -32,3 +32,10 @@ __exportStar(require("./dtos/CollectionSourceDto"), exports);
 __exportStar(require("./dtos/CollectionProductConfigDto"), exports);
 __exportStar(require("./dtos/UpsertProductConfigRequest"), exports);
 __exportStar(require("./dtos/ApplyCollectionResultRequest"), exports);
+// DTOs — backoffice de monitoreo
+__exportStar(require("./dtos/CollectionIntentSummaryDto"), exports);
+__exportStar(require("./dtos/CollectionAttemptDto"), exports);
+__exportStar(require("./dtos/CollectionOutboxEventDto"), exports);
+__exportStar(require("./dtos/CollectionErrorLogDto"), exports);
+__exportStar(require("./dtos/CollectionIntentDetailDto"), exports);
+__exportStar(require("./dtos/CollectionMetricsDto"), exports);

package/bin/index.d.ts

@@ -91,6 +91,7 @@ export * as Modelias from './modelias';
 export * as NetworkConnector from './networkConnector';
 export * as EmailVerification from './emailVerification';
 export * as RetailOrg from './retailOrg';
+export * as RetailCommission from './retailCommission';
 export * as RetailCatalog from './retailCatalog';
 export * as RetailCards from './retailCards';
 export * as RetailCustomer from './retailCustomer';

package/bin/index.js

@@ -37,8 +37,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 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.Biometrics = exports.MetamapConnector = exports.Account = exports.Crypto = void 0;
-exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailWizard = exports.RetailCustomer = exports.RetailCards = exports.RetailCatalog = 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 = exports.Device = exports.Observations = void 0;
-exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = void 0;
+exports.LoanConfig = exports.DatalakeQuery = exports.RetailWizard = exports.RetailCustomer = exports.RetailCards = exports.RetailCatalog = exports.RetailCommission = 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 = exports.Device = exports.Observations = void 0;
+exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -146,6 +146,10 @@ exports.EmailVerification = __importStar(require("./emailVerification"));
 // RetailOrg: DTOs/enums del lambda retail-org-business (SureKeep Fase 1 — pista Retail).
 // Dominio de retailers → zonas → tiendas → usuarios retail.
 exports.RetailOrg = __importStar(require("./retailOrg"));
+// RetailCommission: DTOs/enums del lambda retail-commission-business (SureKeep Fase 3 — pista
+// Retail). El motor de comisiones de VentasLuga: el plan versionado por snapshot, el devengo por
+// venta y el corte semanal.
+exports.RetailCommission = __importStar(require("./retailCommission"));
 // RetailCatalog: DTOs/enums del lambda retail-catalog-business (comp 05 — catálogo de productos
 // por SKU + inventario por IMEI; SureKeep Fase 1 — pista Retail).
 exports.RetailCatalog = __importStar(require("./retailCatalog"));

package/bin/retailCommission/dtos/CommissionAccrual.d.ts

@@ -0,0 +1,78 @@
+import type { CommissionAccrualStatusEnum } from '../enums/CommissionAccrualStatusEnum';
+import type { CommissionPayeeTypeEnum } from '../enums/CommissionPayeeTypeEnum';
+import type { SaleFinancierEnum } from '../../retailWizard/enums/SaleFinancierEnum';
+import type { CommissionCalcTrace } from './CommissionCalcTrace';
+/**
+ * El devengo: lo que se le debe a un vendedor por UNA venta.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * **Se comisiona la venta, no la línea.** Una `RetailSale` es de un solo producto: no hay `lines[]`
+ * que repartir.
+ *
+ * ⚠️ **Append-only solo hasta el cierre.** Al devengar se escriben el monto base y la traza; al
+ * cerrar el corte se escriben `quotaMet`, `quotaFactorBps`, `settledAmountCents`, `payoutId` y el
+ * `status`. Es un mutable con historia, no un log inmutable.
+ */
+export interface CommissionAccrual {
+    sellerId: string;
+    periodId: string;
+    saleId: string;
+    /** Denormalizados: son lo que hace posible aislar por retailer sin un GSI. */
+    retailerId: string;
+    storeId: string;
+    payeeType: CommissionPayeeTypeEnum;
+    status: CommissionAccrualStatusEnum;
+    /** Con qué versión del plan se calculó. Apunta a un `SNAPSHOT#<ulid>` consultable. */
+    planSnapshotId: string;
+    /**
+     * Versión del motor que lo calculó.
+     *
+     * El snapshot congela el PLAN, no el CÓDIGO. Sin este campo, un cambio en el evaluador vuelve
+     * imposible reproducir un monto viejo aunque el plan esté intacto.
+     */
+    calcEngineVersion: string;
+    categoryId: string | null;
+    mechanicType: string | null;
+    /** Resultado de mecánica + excepciones + add-ons. **Sin cuota ni acelerador.** */
+    baseAmountCents: number;
+    /** Derivada de `type` + `externalProvider` con `financierOfSale` del type-kit. */
+    financier: SaleFinancierEnum;
+    /** Al CERRAR: si el vendedor alcanzó la cuota de su categoría. */
+    quotaMet: boolean | null;
+    /** Al CERRAR: factor del acelerador. 10000 = 1.0×. */
+    quotaFactorBps: number | null;
+    /**
+     * Al CERRAR: el total liquidado.
+     *
+     * Se llama así —y no `amountCents`— para que nadie lo lea como definitivo antes del cierre.
+     */
+    settledAmountCents: number | null;
+    payoutId: string | null;
+    reversalReason: string | null;
+    calcTrace: CommissionCalcTrace;
+}
+/**
+ * Lo mínimo de una venta para devengarla. Es lo que llega por la cola y lo que se reconstruye
+ * desde el data lake al simular — por eso vive en el type-kit y no dentro del motor.
+ */
+export interface CommissionSaleInput {
+    saleId: string;
+    sellerId: string;
+    retailerId: string;
+    storeId: string;
+    sku: string;
+    brand: string | null;
+    /**
+     * 🔴 **La base de comisión es el PRECIO DEL EQUIPO, no lo cobrado en caja.**
+     *
+     * En una venta a crédito `amountCents` es SOLO el enganche: comisionar sobre él pagaría una
+     * fracción de lo que corresponde. Se usa `equipmentPriceCents` y se cae a `amountCents` solo
+     * cuando no está (ventas viejas sin el dato).
+     */
+    equipmentPriceCents: number | null;
+    amountCents: number;
+    financier: SaleFinancierEnum;
+    /** `CASH` | `CREDIT`, para `PERCENT_BY_PAYMENT`. */
+    paymentType: string;
+    soldAt: string;
+}

package/bin/retailCommission/dtos/CommissionAccrual.js

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