@fiado/type-kit 3.264.0 → 3.266.0

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

@@ -0,0 +1,13 @@
+import { MechanismType } from '../enums/MechanismType';
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+export declare class AuthorizeCollectionMovementRequest {
+    executionId: string;
+    directoryId: string;
+    provider: string;
+    mechanism: MechanismType;
+    amount: number;
+    currencyId: CurrencyId;
+    intentId?: string;
+    chargeId?: string;
+    holdTxId?: string;
+}

package/bin/collection/dtos/AuthorizeCollectionMovementRequest.js

@@ -0,0 +1,57 @@
+"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.AuthorizeCollectionMovementRequest = void 0;
+const class_validator_1 = require("class-validator");
+const MechanismType_1 = require("../enums/MechanismType");
+const CurrencyId_1 = require("../../currency/enums/CurrencyId");
+class AuthorizeCollectionMovementRequest {
+}
+exports.AuthorizeCollectionMovementRequest = AuthorizeCollectionMovementRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementRequest.prototype, "executionId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementRequest.prototype, "provider", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(MechanismType_1.MechanismType),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementRequest.prototype, "mechanism", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], AuthorizeCollectionMovementRequest.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(CurrencyId_1.CurrencyId),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementRequest.prototype, "currencyId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementRequest.prototype, "intentId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementRequest.prototype, "chargeId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementRequest.prototype, "holdTxId", void 0);

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

@@ -0,0 +1,7 @@
+import { CollectionResultStatus } from '../enums/CollectionResultStatus';
+export declare class AuthorizeCollectionMovementResponse {
+    status: CollectionResultStatus;
+    amount: number;
+    holdTxId?: string;
+    transactionId?: string;
+}

package/bin/collection/dtos/AuthorizeCollectionMovementResponse.js

@@ -0,0 +1,35 @@
+"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.AuthorizeCollectionMovementResponse = void 0;
+const class_validator_1 = require("class-validator");
+const CollectionResultStatus_1 = require("../enums/CollectionResultStatus");
+class AuthorizeCollectionMovementResponse {
+}
+exports.AuthorizeCollectionMovementResponse = AuthorizeCollectionMovementResponse;
+__decorate([
+    (0, class_validator_1.IsEnum)(CollectionResultStatus_1.CollectionResultStatus),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementResponse.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], AuthorizeCollectionMovementResponse.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementResponse.prototype, "holdTxId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementResponse.prototype, "transactionId", void 0);

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

@@ -0,0 +1,8 @@
+export declare class CollectRequest {
+    ownerRef: string;
+    tenantId: string;
+    domain: string;
+    productId: string;
+    chargeId: string;
+    amount: number;
+}

package/bin/collection/dtos/CollectRequest.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.CollectRequest = void 0;
+const class_validator_1 = require("class-validator");
+class CollectRequest {
+}
+exports.CollectRequest = CollectRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectRequest.prototype, "ownerRef", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectRequest.prototype, "domain", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectRequest.prototype, "productId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectRequest.prototype, "chargeId", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectRequest.prototype, "amount", void 0);

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

@@ -0,0 +1,7 @@
+import { CollectionResultStatus } from '../enums/CollectionResultStatus';
+export declare class CollectResponse {
+    intentId: string;
+    status: CollectionResultStatus;
+    amountReserved: number;
+    amountCollected: number;
+}

package/bin/collection/dtos/CollectResponse.js

@@ -0,0 +1,33 @@
+"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.CollectResponse = void 0;
+const class_validator_1 = require("class-validator");
+const CollectionResultStatus_1 = require("../enums/CollectionResultStatus");
+class CollectResponse {
+}
+exports.CollectResponse = CollectResponse;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectResponse.prototype, "intentId", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(CollectionResultStatus_1.CollectionResultStatus),
+    __metadata("design:type", String)
+], CollectResponse.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectResponse.prototype, "amountReserved", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectResponse.prototype, "amountCollected", void 0);

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

@@ -0,0 +1,12 @@
+import { CollectionResultStatus } from '../enums/CollectionResultStatus';
+import { MechanismType } from '../enums/MechanismType';
+export declare class CollectionResultEvent {
+    attemptId: string;
+    intentId: string;
+    domain: string;
+    tenantId: string;
+    chargeId: string;
+    status: CollectionResultStatus;
+    mechanism: MechanismType;
+    amount: number;
+}

package/bin/collection/dtos/CollectionResultEvent.js

@@ -0,0 +1,50 @@
+"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.CollectionResultEvent = void 0;
+const class_validator_1 = require("class-validator");
+const CollectionResultStatus_1 = require("../enums/CollectionResultStatus");
+const MechanismType_1 = require("../enums/MechanismType");
+class CollectionResultEvent {
+}
+exports.CollectionResultEvent = CollectionResultEvent;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionResultEvent.prototype, "attemptId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionResultEvent.prototype, "intentId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionResultEvent.prototype, "domain", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionResultEvent.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionResultEvent.prototype, "chargeId", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(CollectionResultStatus_1.CollectionResultStatus),
+    __metadata("design:type", String)
+], CollectionResultEvent.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(MechanismType_1.MechanismType),
+    __metadata("design:type", String)
+], CollectionResultEvent.prototype, "mechanism", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionResultEvent.prototype, "amount", void 0);

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

@@ -0,0 +1,19 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+export declare class PendingChargeDto {
+    chargeId: string;
+    ownerRef: string;
+    tenantId: string;
+    domain: string;
+    parentDebtId: string;
+    installmentNumber: number;
+    amount: number;
+    currency: CurrencyId;
+    dueDate: string;
+    status: string;
+    principalAmount?: number;
+    interestAmount?: number;
+    taxAmount?: number;
+    outstandingBalance?: number;
+    amountCollected?: number;
+    metadata?: Record<string, unknown>;
+}

package/bin/collection/dtos/PendingChargeDto.js

@@ -0,0 +1,87 @@
+"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.PendingChargeDto = void 0;
+const class_validator_1 = require("class-validator");
+const CurrencyId_1 = require("../../currency/enums/CurrencyId");
+class PendingChargeDto {
+}
+exports.PendingChargeDto = PendingChargeDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], PendingChargeDto.prototype, "chargeId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], PendingChargeDto.prototype, "ownerRef", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], PendingChargeDto.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], PendingChargeDto.prototype, "domain", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], PendingChargeDto.prototype, "parentDebtId", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], PendingChargeDto.prototype, "installmentNumber", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], PendingChargeDto.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(CurrencyId_1.CurrencyId),
+    __metadata("design:type", String)
+], PendingChargeDto.prototype, "currency", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], PendingChargeDto.prototype, "dueDate", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], PendingChargeDto.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], PendingChargeDto.prototype, "principalAmount", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], PendingChargeDto.prototype, "interestAmount", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], PendingChargeDto.prototype, "taxAmount", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], PendingChargeDto.prototype, "outstandingBalance", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], PendingChargeDto.prototype, "amountCollected", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], PendingChargeDto.prototype, "metadata", void 0);

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

@@ -0,0 +1,7 @@
+export declare class RegisterCollectibleRequest {
+    ownerRef: string;
+    tenantId: string;
+    domain: string;
+    productId: string;
+    chargeId: string;
+}

package/bin/collection/dtos/RegisterCollectibleRequest.js

@@ -0,0 +1,36 @@
+"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.RegisterCollectibleRequest = void 0;
+const class_validator_1 = require("class-validator");
+class RegisterCollectibleRequest {
+}
+exports.RegisterCollectibleRequest = RegisterCollectibleRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RegisterCollectibleRequest.prototype, "ownerRef", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RegisterCollectibleRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RegisterCollectibleRequest.prototype, "domain", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RegisterCollectibleRequest.prototype, "productId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RegisterCollectibleRequest.prototype, "chargeId", void 0);

package/bin/collection/enums/CollectionResultStatus.d.ts

@@ -0,0 +1,5 @@
+export declare enum CollectionResultStatus {
+    FULL = "FULL",
+    PARTIAL = "PARTIAL",
+    NONE = "NONE"
+}

package/bin/collection/enums/CollectionResultStatus.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectionResultStatus = void 0;
+var CollectionResultStatus;
+(function (CollectionResultStatus) {
+    CollectionResultStatus["FULL"] = "FULL";
+    CollectionResultStatus["PARTIAL"] = "PARTIAL";
+    CollectionResultStatus["NONE"] = "NONE";
+})(CollectionResultStatus || (exports.CollectionResultStatus = CollectionResultStatus = {}));

package/bin/collection/enums/CollectionState.d.ts

@@ -0,0 +1,8 @@
+export declare enum CollectionState {
+    PENDING = "PENDING",
+    ATTEMPT = "ATTEMPT",
+    RESERVED = "RESERVED",
+    COLLECTED = "COLLECTED",
+    AWAITING_FUNDS = "AWAITING_FUNDS",
+    CANCELLED = "CANCELLED"
+}

package/bin/collection/enums/CollectionState.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectionState = void 0;
+var CollectionState;
+(function (CollectionState) {
+    CollectionState["PENDING"] = "PENDING";
+    CollectionState["ATTEMPT"] = "ATTEMPT";
+    CollectionState["RESERVED"] = "RESERVED";
+    CollectionState["COLLECTED"] = "COLLECTED";
+    CollectionState["AWAITING_FUNDS"] = "AWAITING_FUNDS";
+    CollectionState["CANCELLED"] = "CANCELLED";
+})(CollectionState || (exports.CollectionState = CollectionState = {}));

package/bin/collection/enums/MechanismType.d.ts

@@ -0,0 +1,5 @@
+export declare enum MechanismType {
+    USD_PREAUTH = "USD_PREAUTH",
+    USD_DIRECT = "USD_DIRECT",
+    MXN_DIRECT = "MXN_DIRECT"
+}

package/bin/collection/enums/MechanismType.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MechanismType = void 0;
+var MechanismType;
+(function (MechanismType) {
+    MechanismType["USD_PREAUTH"] = "USD_PREAUTH";
+    MechanismType["USD_DIRECT"] = "USD_DIRECT";
+    MechanismType["MXN_DIRECT"] = "MXN_DIRECT";
+})(MechanismType || (exports.MechanismType = MechanismType = {}));

package/bin/collection/enums/SagaStep.d.ts

@@ -0,0 +1,7 @@
+export declare enum SagaStep {
+    RESOLVE = "RESOLVE",
+    PICK_SOURCE = "PICK_SOURCE",
+    EXECUTE = "EXECUTE",
+    PERSIST = "PERSIST",
+    DISPATCH = "DISPATCH"
+}

package/bin/collection/enums/SagaStep.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SagaStep = void 0;
+var SagaStep;
+(function (SagaStep) {
+    SagaStep["RESOLVE"] = "RESOLVE";
+    SagaStep["PICK_SOURCE"] = "PICK_SOURCE";
+    SagaStep["EXECUTE"] = "EXECUTE";
+    SagaStep["PERSIST"] = "PERSIST";
+    SagaStep["DISPATCH"] = "DISPATCH";
+})(SagaStep || (exports.SagaStep = SagaStep = {}));

package/bin/collection/index.d.ts

@@ -0,0 +1,11 @@
+export * from './enums/MechanismType';
+export * from './enums/CollectionState';
+export * from './enums/SagaStep';
+export * from './enums/CollectionResultStatus';
+export * from './dtos/PendingChargeDto';
+export * from './dtos/CollectRequest';
+export * from './dtos/CollectResponse';
+export * from './dtos/RegisterCollectibleRequest';
+export * from './dtos/CollectionResultEvent';
+export * from './dtos/AuthorizeCollectionMovementRequest';
+export * from './dtos/AuthorizeCollectionMovementResponse';

package/bin/collection/index.js

@@ -0,0 +1,29 @@
+"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/MechanismType"), exports);
+__exportStar(require("./enums/CollectionState"), exports);
+__exportStar(require("./enums/SagaStep"), exports);
+__exportStar(require("./enums/CollectionResultStatus"), exports);
+// DTOs
+__exportStar(require("./dtos/PendingChargeDto"), exports);
+__exportStar(require("./dtos/CollectRequest"), exports);
+__exportStar(require("./dtos/CollectResponse"), exports);
+__exportStar(require("./dtos/RegisterCollectibleRequest"), exports);
+__exportStar(require("./dtos/CollectionResultEvent"), exports);
+__exportStar(require("./dtos/AuthorizeCollectionMovementRequest"), exports);
+__exportStar(require("./dtos/AuthorizeCollectionMovementResponse"), exports);

package/bin/index.d.ts

@@ -107,3 +107,4 @@ export * from './messaging';
 export * from './complaint';
 export * as PhoneSales from './phoneSales';
 export * as Shipping from './shipping';
+export * as Collection from './collection';

package/bin/index.js

@@ -38,7 +38,7 @@ 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.LoanOfferings = exports.Shortlink = exports.LoanConfig = 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.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = void 0;
+exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -194,3 +194,8 @@ exports.PhoneSales = __importStar(require("./phoneSales"));
 // (tarjetas, teléfonos, …). ExternalShippingStatus se reexporta acá desde `card/` sin moverlo,
 // para no romper a los consumidores actuales del namespace Card.
 exports.Shipping = __importStar(require("./shipping"));
+// Collection: contrato del motor de cobro central (collection-engine-business) — dominio
+// agnóstico de proveedores/cuentas. PendingChargeDto es la deuda genérica; CollectRequest/
+// CollectResponse el contrato dominio↔motor; AuthorizeCollectionMovementRequest/Response el
+// contrato motor↔processor. Ver spec 2026-07-29-motor-cobro-central-design.
+exports.Collection = __importStar(require("./collection"));

package/bin/retailWizard/dtos/RetailCustomerListItem.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Una fila de la lista **Clientes VL** del Portal Admin VentasLuga (A1).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Sale del ítem de estadísticas de por vida (`RETAILER#<retailerId>` / `CUSTSTATS#<customerId>`
+ * dentro de `RetailSale_GT`), no de barrer ventas: por eso los totales son **de por vida** y no del
+ * periodo filtrado. Ver D19 / DEC-040.
+ *
+ * ⚠️ `customerName` y `customerPhone` son PII. Nunca loguear. La lectura queda registrada en
+ * `PiiAccessLog` igual que el listado de ventas.
+ */
+export interface RetailCustomerListItem {
+    retailCustomerId: string;
+    /** Congelado en la venta. `null` si nunca se pudo resolver. */
+    customerName: string | null;
+    customerPhone: string | null;
+    /** Compras DE POR VIDA. Puede venir negativo si hubo cancelaciones antes del backfill. */
+    salesCount: number;
+    /** Gastado DE POR VIDA, en centavos. Mide volumen COLOCADO (precio del equipo), no lo cobrado. */
+    totalSpentCents: number;
+    /** ISO-8601 de la primera compra. `null` mientras el backfill no lo haya sembrado. */
+    firstSaleAt: string | null;
+    /** ISO-8601 de la última compra. Es el campo por el que filtra la pantalla. */
+    lastSaleAt: string | null;
+    /**
+     * Tienda y vendedor de la ÚLTIMA compra.
+     *
+     * ⚠️ El mockup los llama «tienda favorita» y «vendedor recurrente», que serían la MODA. Acá es el
+     * ÚLTIMO: la moda exigiría un contador por (cliente × tienda), que multiplica el ítem por cada
+     * tienda donde el cliente compró. Se sirve el último y se declara. Ver `TD-F3-WIZ-MODA`.
+     */
+    lastStoreId: string | null;
+    lastStoreName: string | null;
+    lastSellerId: string | null;
+    lastSellerName: string | null;
+}

package/bin/retailWizard/dtos/RetailCustomerListItem.js

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

package/bin/retailWizard/dtos/responses/BackofficeCustomerPurchasesResponse.d.ts

@@ -0,0 +1,20 @@
+import type { Sale } from '../Sale';
+/**
+ * GET /backoffice/customers/{id}/purchases — el historial de compras de un cliente (A2).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Lee `RetailSale_GT` por `customerId-soldAt-index`, así que viene ordenado por fecha y pagina por
+ * cursor: un cliente puede tener muchas compras y la ficha las muestra de a poco.
+ *
+ * `compras30` / `compras90` se cuentan sobre la MISMA lectura cuando la ventana entra en la página;
+ * son los contadores que la pantalla muestra como sublínea del total de por vida.
+ */
+export interface BackofficeCustomerPurchasesResponse {
+    items: Sale[];
+    count: number;
+    nextToken?: string;
+    /** Compras en los últimos 30 días. */
+    last30Count: number;
+    /** Compras en los últimos 90 días — el que define el segmento `inactivo` (=== 0). */
+    last90Count: number;
+}

package/bin/retailWizard/dtos/responses/BackofficeCustomerPurchasesResponse.js

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

package/bin/retailWizard/dtos/responses/BackofficeCustomersResponse.d.ts

@@ -0,0 +1,14 @@
+import type { RetailCustomerListItem } from '../RetailCustomerListItem';
+/**
+ * GET /backoffice/customers — la lista de Clientes VL (A1). SureKeep Fase 3 — pista Retail.
+ *
+ * NO pagina por cursor: una Query trae todos los clientes de la cadena (una fila por CLIENTE, ~200 B,
+ * no una por venta) y la pantalla ordena y filtra sobre el conjunto. `truncated` avisa cuando la
+ * cadena excede el tope de lectura — un listado recortado servido en silencio se lee como completo.
+ */
+export interface BackofficeCustomersResponse {
+    items: RetailCustomerListItem[];
+    count: number;
+    /** `true` si se alcanzó el tope de lectura y la lista NO está completa. */
+    truncated: boolean;
+}

package/bin/retailWizard/dtos/responses/BackofficeCustomersResponse.js

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

package/bin/retailWizard/dtos/responses/BackofficeSellerKpisResponse.d.ts

@@ -0,0 +1,27 @@
+/** KPIs de un vendedor en la ventana consultada. */
+export interface SellerKpiRow {
+    sellerRetailUserId: string;
+    /** Congelado en la venta; `null` si nunca se resolvió. */
+    sellerName: string | null;
+    storeId: string | null;
+    storeName: string | null;
+    salesCount: number;
+    /** Volumen COLOCADO (precio del equipo), no lo cobrado en caja. */
+    placedCents: number;
+    averageTicketCents: number;
+    lastSaleAt: string | null;
+}
+/**
+ * GET /backoffice/sellers/kpis — la pantalla Vendedores del Admin VL (A4).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Mismo criterio que A3: el eje es la venta, así que solo aparecen los vendedores que vendieron en
+ * la ventana. El roster completo vive en `retail-org-business`.
+ */
+export interface BackofficeSellerKpisResponse {
+    items: SellerKpiRow[];
+    count: number;
+    from: string;
+    to: string | null;
+    truncated: boolean;
+}

package/bin/retailWizard/dtos/responses/BackofficeSellerKpisResponse.js

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

package/bin/retailWizard/dtos/responses/BackofficeStoreKpisResponse.d.ts

@@ -0,0 +1,29 @@
+/** KPIs de una tienda en la ventana consultada. */
+export interface StoreKpiRow {
+    storeId: string;
+    /** Congelado en la venta; `null` si nunca se resolvió. */
+    storeName: string | null;
+    zoneName: string | null;
+    salesCount: number;
+    /** Volumen COLOCADO (precio del equipo), no lo cobrado en caja. */
+    placedCents: number;
+    averageTicketCents: number;
+    /** ISO-8601 de la venta más reciente de la tienda en la ventana. `null` si no vendió. */
+    lastSaleAt: string | null;
+}
+/**
+ * GET /backoffice/stores/kpis — la pantalla Tiendas del Admin VL (A3).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * El eje es la VENTA: solo aparecen las tiendas que vendieron en la ventana. El roster completo
+ * (incluidas las que no vendieron) lo tiene `retail-org-business`; la pantalla los cruza.
+ */
+export interface BackofficeStoreKpisResponse {
+    items: StoreKpiRow[];
+    count: number;
+    /** ISO-8601 de la ventana efectivamente agregada. */
+    from: string;
+    to: string | null;
+    /** `true` si se alcanzó el tope de agregación y los números están TRUNCADOS. */
+    truncated: boolean;
+}

package/bin/retailWizard/dtos/responses/BackofficeStoreKpisResponse.js

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

package/bin/retailWizard/index.d.ts

@@ -90,6 +90,11 @@ export * from './dtos/requests/BackofficeCancelSaleRequest';
 export * from './dtos/responses/BackofficeSalesStatsResponse';
 export * from './dtos/responses/BackofficeSalesKpisResponse';
 export * from './dtos/responses/BackofficeReportsResponse';
+export * from './dtos/RetailCustomerListItem';
+export * from './dtos/responses/BackofficeCustomersResponse';
+export * from './dtos/responses/BackofficeCustomerPurchasesResponse';
+export * from './dtos/responses/BackofficeStoreKpisResponse';
+export * from './dtos/responses/BackofficeSellerKpisResponse';
 export * from './events/SaleCompletedV1';
 export * from './events/SaleCancelledV1';
 export * from './events/SaleCompletedV2';

package/bin/retailWizard/index.js

@@ -118,6 +118,12 @@ __exportStar(require("./dtos/requests/BackofficeCancelSaleRequest"), exports);
 __exportStar(require("./dtos/responses/BackofficeSalesStatsResponse"), exports);
 __exportStar(require("./dtos/responses/BackofficeSalesKpisResponse"), exports);
 __exportStar(require("./dtos/responses/BackofficeReportsResponse"), exports);
+// A1-A4 · agregados del portal (D17)
+__exportStar(require("./dtos/RetailCustomerListItem"), exports);
+__exportStar(require("./dtos/responses/BackofficeCustomersResponse"), exports);
+__exportStar(require("./dtos/responses/BackofficeCustomerPurchasesResponse"), exports);
+__exportStar(require("./dtos/responses/BackofficeStoreKpisResponse"), exports);
+__exportStar(require("./dtos/responses/BackofficeSellerKpisResponse"), exports);
 // Contratos de eventos (PascalCase + sufijo V1)
 __exportStar(require("./events/SaleCompletedV1"), exports);
 __exportStar(require("./events/SaleCancelledV1"), exports);

package/package.json

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

package/src/collection/dtos/AuthorizeCollectionMovementRequest.ts

@@ -0,0 +1,15 @@
+import { IsString, IsInt, IsEnum, IsOptional } from 'class-validator';
+import { MechanismType } from '../enums/MechanismType';
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+
+export class AuthorizeCollectionMovementRequest {
+  @IsString() executionId!: string;    // idempotencia (@IdempotencyController)
+  @IsString() directoryId!: string;
+  @IsString() provider!: string;       // lo pone el motor desde la config
+  @IsEnum(MechanismType) mechanism!: MechanismType;
+  @IsInt() amount!: number;            // ya convertido por el motor (FX previo)
+  @IsEnum(CurrencyId) currencyId!: CurrencyId;
+  @IsOptional() @IsString() intentId?: string;
+  @IsOptional() @IsString() chargeId?: string;
+  @IsOptional() @IsString() holdTxId?: string;
+}

package/src/collection/dtos/AuthorizeCollectionMovementResponse.ts

@@ -0,0 +1,9 @@
+import { IsString, IsInt, IsEnum, IsOptional } from 'class-validator';
+import { CollectionResultStatus } from '../enums/CollectionResultStatus';
+
+export class AuthorizeCollectionMovementResponse {
+  @IsEnum(CollectionResultStatus) status!: CollectionResultStatus;
+  @IsInt() amount!: number;            // reservado o cobrado
+  @IsOptional() @IsString() holdTxId?: string;
+  @IsOptional() @IsString() transactionId?: string;
+}

package/src/collection/dtos/CollectRequest.ts

@@ -0,0 +1,10 @@
+import { IsString, IsInt } from 'class-validator';
+
+export class CollectRequest {
+  @IsString() ownerRef!: string;
+  @IsString() tenantId!: string;
+  @IsString() domain!: string;
+  @IsString() productId!: string;
+  @IsString() chargeId!: string;
+  @IsInt() amount!: number;
+}

package/src/collection/dtos/CollectResponse.ts

@@ -0,0 +1,9 @@
+import { IsString, IsInt, IsEnum } from 'class-validator';
+import { CollectionResultStatus } from '../enums/CollectionResultStatus';
+
+export class CollectResponse {
+  @IsString() intentId!: string;
+  @IsEnum(CollectionResultStatus) status!: CollectionResultStatus;
+  @IsInt() amountReserved!: number;
+  @IsInt() amountCollected!: number;
+}

package/src/collection/dtos/CollectionResultEvent.ts

@@ -0,0 +1,14 @@
+import { IsString, IsInt, IsEnum } from 'class-validator';
+import { CollectionResultStatus } from '../enums/CollectionResultStatus';
+import { MechanismType } from '../enums/MechanismType';
+
+export class CollectionResultEvent {
+  @IsString() attemptId!: string;      // dedupe en el consumidor
+  @IsString() intentId!: string;
+  @IsString() domain!: string;         // routing (filter policy)
+  @IsString() tenantId!: string;
+  @IsString() chargeId!: string;
+  @IsEnum(CollectionResultStatus) status!: CollectionResultStatus;
+  @IsEnum(MechanismType) mechanism!: MechanismType;
+  @IsInt() amount!: number;            // reservado o cobrado según mecanismo
+}

package/src/collection/dtos/PendingChargeDto.ts

@@ -0,0 +1,21 @@
+import { IsString, IsInt, IsOptional, IsEnum, IsObject } from 'class-validator';
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+
+export class PendingChargeDto {
+  @IsString() chargeId!: string;          // record_id / INSTALLMENT#n
+  @IsString() ownerRef!: string;          // directoryId
+  @IsString() tenantId!: string;          // FIADO | surekeep
+  @IsString() domain!: string;            // une-credit | surekeep-retail
+  @IsString() parentDebtId!: string;      // credit_id / CREDIT#id
+  @IsInt() installmentNumber!: number;    // coupon_number / installment_number
+  @IsInt() amount!: number;               // centavos
+  @IsEnum(CurrencyId) currency!: CurrencyId;
+  @IsString() dueDate!: string;           // ISO date
+  @IsString() status!: string;            // estado del cargo en el dominio (normalizado por el motor)
+  @IsOptional() @IsInt() principalAmount?: number;
+  @IsOptional() @IsInt() interestAmount?: number;
+  @IsOptional() @IsInt() taxAmount?: number;
+  @IsOptional() @IsInt() outstandingBalance?: number;
+  @IsOptional() @IsInt() amountCollected?: number;
+  @IsOptional() @IsObject() metadata?: Record<string, unknown>; // por-dominio (fiado_/loanco_interest, imei…)
+}

package/src/collection/dtos/RegisterCollectibleRequest.ts

@@ -0,0 +1,9 @@
+import { IsString } from 'class-validator';
+
+export class RegisterCollectibleRequest {
+  @IsString() ownerRef!: string;
+  @IsString() tenantId!: string;
+  @IsString() domain!: string;
+  @IsString() productId!: string;
+  @IsString() chargeId!: string;
+}

package/src/collection/enums/CollectionResultStatus.ts

@@ -0,0 +1,5 @@
+export enum CollectionResultStatus {
+  FULL = 'FULL',
+  PARTIAL = 'PARTIAL',
+  NONE = 'NONE',
+}

package/src/collection/enums/CollectionState.ts

@@ -0,0 +1,8 @@
+export enum CollectionState {
+  PENDING = 'PENDING',
+  ATTEMPT = 'ATTEMPT',
+  RESERVED = 'RESERVED',
+  COLLECTED = 'COLLECTED',
+  AWAITING_FUNDS = 'AWAITING_FUNDS',
+  CANCELLED = 'CANCELLED',
+}

package/src/collection/enums/MechanismType.ts

@@ -0,0 +1,5 @@
+export enum MechanismType {
+  USD_PREAUTH = 'USD_PREAUTH',
+  USD_DIRECT = 'USD_DIRECT',
+  MXN_DIRECT = 'MXN_DIRECT',
+}

package/src/collection/enums/SagaStep.ts

@@ -0,0 +1,7 @@
+export enum SagaStep {
+  RESOLVE = 'RESOLVE',
+  PICK_SOURCE = 'PICK_SOURCE',
+  EXECUTE = 'EXECUTE',
+  PERSIST = 'PERSIST',
+  DISPATCH = 'DISPATCH',
+}

package/src/collection/index.ts

@@ -0,0 +1,14 @@
+// Enums
+export * from './enums/MechanismType';
+export * from './enums/CollectionState';
+export * from './enums/SagaStep';
+export * from './enums/CollectionResultStatus';
+
+// DTOs
+export * from './dtos/PendingChargeDto';
+export * from './dtos/CollectRequest';
+export * from './dtos/CollectResponse';
+export * from './dtos/RegisterCollectibleRequest';
+export * from './dtos/CollectionResultEvent';
+export * from './dtos/AuthorizeCollectionMovementRequest';
+export * from './dtos/AuthorizeCollectionMovementResponse';

package/src/index.ts

@@ -153,3 +153,8 @@ export * as PhoneSales from './phoneSales';
 // (tarjetas, teléfonos, …). ExternalShippingStatus se reexporta acá desde `card/` sin moverlo,
 // para no romper a los consumidores actuales del namespace Card.
 export * as Shipping from './shipping';
+// Collection: contrato del motor de cobro central (collection-engine-business) — dominio
+// agnóstico de proveedores/cuentas. PendingChargeDto es la deuda genérica; CollectRequest/
+// CollectResponse el contrato dominio↔motor; AuthorizeCollectionMovementRequest/Response el
+// contrato motor↔processor. Ver spec 2026-07-29-motor-cobro-central-design.
+export * as Collection from './collection';

package/src/retailWizard/dtos/RetailCustomerListItem.ts

@@ -0,0 +1,36 @@
+/**
+ * Una fila de la lista **Clientes VL** del Portal Admin VentasLuga (A1).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Sale del ítem de estadísticas de por vida (`RETAILER#<retailerId>` / `CUSTSTATS#<customerId>`
+ * dentro de `RetailSale_GT`), no de barrer ventas: por eso los totales son **de por vida** y no del
+ * periodo filtrado. Ver D19 / DEC-040.
+ *
+ * ⚠️ `customerName` y `customerPhone` son PII. Nunca loguear. La lectura queda registrada en
+ * `PiiAccessLog` igual que el listado de ventas.
+ */
+export interface RetailCustomerListItem {
+    retailCustomerId: string;
+    /** Congelado en la venta. `null` si nunca se pudo resolver. */
+    customerName: string | null;
+    customerPhone: string | null;
+    /** Compras DE POR VIDA. Puede venir negativo si hubo cancelaciones antes del backfill. */
+    salesCount: number;
+    /** Gastado DE POR VIDA, en centavos. Mide volumen COLOCADO (precio del equipo), no lo cobrado. */
+    totalSpentCents: number;
+    /** ISO-8601 de la primera compra. `null` mientras el backfill no lo haya sembrado. */
+    firstSaleAt: string | null;
+    /** ISO-8601 de la última compra. Es el campo por el que filtra la pantalla. */
+    lastSaleAt: string | null;
+    /**
+     * Tienda y vendedor de la ÚLTIMA compra.
+     *
+     * ⚠️ El mockup los llama «tienda favorita» y «vendedor recurrente», que serían la MODA. Acá es el
+     * ÚLTIMO: la moda exigiría un contador por (cliente × tienda), que multiplica el ítem por cada
+     * tienda donde el cliente compró. Se sirve el último y se declara. Ver `TD-F3-WIZ-MODA`.
+     */
+    lastStoreId: string | null;
+    lastStoreName: string | null;
+    lastSellerId: string | null;
+    lastSellerName: string | null;
+}

package/src/retailWizard/dtos/responses/BackofficeCustomerPurchasesResponse.ts

@@ -0,0 +1,21 @@
+import type { Sale } from '../Sale';
+
+/**
+ * GET /backoffice/customers/{id}/purchases — el historial de compras de un cliente (A2).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Lee `RetailSale_GT` por `customerId-soldAt-index`, así que viene ordenado por fecha y pagina por
+ * cursor: un cliente puede tener muchas compras y la ficha las muestra de a poco.
+ *
+ * `compras30` / `compras90` se cuentan sobre la MISMA lectura cuando la ventana entra en la página;
+ * son los contadores que la pantalla muestra como sublínea del total de por vida.
+ */
+export interface BackofficeCustomerPurchasesResponse {
+    items: Sale[];
+    count: number;
+    nextToken?: string;
+    /** Compras en los últimos 30 días. */
+    last30Count: number;
+    /** Compras en los últimos 90 días — el que define el segmento `inactivo` (=== 0). */
+    last90Count: number;
+}

package/src/retailWizard/dtos/responses/BackofficeCustomersResponse.ts

@@ -0,0 +1,15 @@
+import type { RetailCustomerListItem } from '../RetailCustomerListItem';
+
+/**
+ * GET /backoffice/customers — la lista de Clientes VL (A1). SureKeep Fase 3 — pista Retail.
+ *
+ * NO pagina por cursor: una Query trae todos los clientes de la cadena (una fila por CLIENTE, ~200 B,
+ * no una por venta) y la pantalla ordena y filtra sobre el conjunto. `truncated` avisa cuando la
+ * cadena excede el tope de lectura — un listado recortado servido en silencio se lee como completo.
+ */
+export interface BackofficeCustomersResponse {
+    items: RetailCustomerListItem[];
+    count: number;
+    /** `true` si se alcanzó el tope de lectura y la lista NO está completa. */
+    truncated: boolean;
+}

package/src/retailWizard/dtos/responses/BackofficeSellerKpisResponse.ts

@@ -0,0 +1,28 @@
+/** KPIs de un vendedor en la ventana consultada. */
+export interface SellerKpiRow {
+    sellerRetailUserId: string;
+    /** Congelado en la venta; `null` si nunca se resolvió. */
+    sellerName: string | null;
+    storeId: string | null;
+    storeName: string | null;
+    salesCount: number;
+    /** Volumen COLOCADO (precio del equipo), no lo cobrado en caja. */
+    placedCents: number;
+    averageTicketCents: number;
+    lastSaleAt: string | null;
+}
+
+/**
+ * GET /backoffice/sellers/kpis — la pantalla Vendedores del Admin VL (A4).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * Mismo criterio que A3: el eje es la venta, así que solo aparecen los vendedores que vendieron en
+ * la ventana. El roster completo vive en `retail-org-business`.
+ */
+export interface BackofficeSellerKpisResponse {
+    items: SellerKpiRow[];
+    count: number;
+    from: string;
+    to: string | null;
+    truncated: boolean;
+}

package/src/retailWizard/dtos/responses/BackofficeStoreKpisResponse.ts

@@ -0,0 +1,30 @@
+/** KPIs de una tienda en la ventana consultada. */
+export interface StoreKpiRow {
+    storeId: string;
+    /** Congelado en la venta; `null` si nunca se resolvió. */
+    storeName: string | null;
+    zoneName: string | null;
+    salesCount: number;
+    /** Volumen COLOCADO (precio del equipo), no lo cobrado en caja. */
+    placedCents: number;
+    averageTicketCents: number;
+    /** ISO-8601 de la venta más reciente de la tienda en la ventana. `null` si no vendió. */
+    lastSaleAt: string | null;
+}
+
+/**
+ * GET /backoffice/stores/kpis — la pantalla Tiendas del Admin VL (A3).
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * El eje es la VENTA: solo aparecen las tiendas que vendieron en la ventana. El roster completo
+ * (incluidas las que no vendieron) lo tiene `retail-org-business`; la pantalla los cruza.
+ */
+export interface BackofficeStoreKpisResponse {
+    items: StoreKpiRow[];
+    count: number;
+    /** ISO-8601 de la ventana efectivamente agregada. */
+    from: string;
+    to: string | null;
+    /** `true` si se alcanzó el tope de agregación y los números están TRUNCADOS. */
+    truncated: boolean;
+}

package/src/retailWizard/index.ts

@@ -112,6 +112,12 @@ export * from './dtos/requests/BackofficeCancelSaleRequest';
 export * from './dtos/responses/BackofficeSalesStatsResponse';
 export * from './dtos/responses/BackofficeSalesKpisResponse';
 export * from './dtos/responses/BackofficeReportsResponse';
+// A1-A4 · agregados del portal (D17)
+export * from './dtos/RetailCustomerListItem';
+export * from './dtos/responses/BackofficeCustomersResponse';
+export * from './dtos/responses/BackofficeCustomerPurchasesResponse';
+export * from './dtos/responses/BackofficeStoreKpisResponse';
+export * from './dtos/responses/BackofficeSellerKpisResponse';
 
 // Contratos de eventos (PascalCase + sufijo V1)
 export * from './events/SaleCompletedV1';