@fiado/type-kit 3.271.0 → 3.273.0

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

@@ -0,0 +1,14 @@
+import { CollectionResultStatus } from '../enums/CollectionResultStatus';
+import { MechanismType } from '../enums/MechanismType';
+export declare class ApplyCollectionResultRequest {
+    attemptId: string;
+    intentId: string;
+    chargeId: string;
+    domain: string;
+    tenantId: string;
+    result: CollectionResultStatus;
+    amountCollected: number;
+    amountReserved: number;
+    mechanism: MechanismType;
+    holdTxId?: string;
+}

package/bin/collection/dtos/ApplyCollectionResultRequest.js

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

package/bin/collection/index.d.ts

@@ -13,3 +13,4 @@ export * from './dtos/RetryPolicyDto';
 export * from './dtos/CollectionSourceDto';
 export * from './dtos/CollectionProductConfigDto';
 export * from './dtos/UpsertProductConfigRequest';
+export * from './dtos/ApplyCollectionResultRequest';

package/bin/collection/index.js

@@ -31,3 +31,4 @@ __exportStar(require("./dtos/RetryPolicyDto"), exports);
 __exportStar(require("./dtos/CollectionSourceDto"), exports);
 __exportStar(require("./dtos/CollectionProductConfigDto"), exports);
 __exportStar(require("./dtos/UpsertProductConfigRequest"), exports);
+__exportStar(require("./dtos/ApplyCollectionResultRequest"), exports);

package/bin/datalakeQuery/dtos/AggregateRequestDto.d.ts

@@ -0,0 +1,29 @@
+import { ReportRequestDto } from './ReportRequestDto';
+import { PermissionScope } from '../../platformRbac/enums/PermissionScope';
+/**
+ * El cuerpo del privado M2M `POST /private/analytics/aggregate` de `datalake-query-business`.
+ *
+ * ## El tenant y el alcance van en campos PROPIOS, separados del reporte
+ *
+ * Un privado no lleva token de usuario, así que el caller —que ya validó el suyo— declara el
+ * `tenantId`. Es el patrón de la casa: `@fiado/tenant-context` tiene `withContextByTenantId` hecho
+ * para esto, con las mismas garantías que el camino por issuer.
+ *
+ * Lo que se cuida es que **ese dato no se mezcle con la consulta**: viaja aparte, el destino lo
+ * resuelve contra el registry —un tenant desconocido es error, nunca un default— y **jamás se usa
+ * como valor dentro del SQL**. El predicado lo pone el compilador desde el contexto ya resuelto.
+ *
+ * ⚠️ **Si no mandas `scope`, el destino asume `LEVEL_1`, nunca `TENANT`.** Heredar el alcance más
+ * amplio por omisión lo ampliaría en silencio, que es exactamente el descuido que no queremos.
+ */
+export interface AggregateRequestDto {
+    /** Tenant del actor original. Obligatorio: sin él el destino no sabe qué silo consultar. */
+    tenantId: string;
+    /** Quién llama (`retail-org-business`, `retail-wizard-business`…). Queda auditado en el job. */
+    callerService: string;
+    /** Alcance del actor original. Omitirlo asume `LEVEL_1`. */
+    scope?: PermissionScope;
+    /** Obligatorio para `LEVEL_1`, `LEVEL_2` y `LEVEL_3`. */
+    scopeRef?: string;
+    report: ReportRequestDto;
+}

package/bin/datalakeQuery/dtos/AggregateRequestDto.js

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

package/bin/datalakeQuery/dtos/ReportRequestDto.d.ts

@@ -0,0 +1,66 @@
+import { FilterOpEnum } from '../enums/FilterOpEnum';
+import { JoinTypeEnum } from '../enums/JoinTypeEnum';
+import { MetricFnEnum } from '../enums/MetricFnEnum';
+/**
+ * El contrato declarativo del motor de reportes sobre el data lake.
+ *
+ * 🔴 **El cliente NUNCA manda SQL.** Manda esta estructura y el backend la compila. Esa es la
+ * diferencia entre "escapamos bien las comillas" y "no hay superficie de inyección": la tabla y
+ * cada columna se validan contra el schema VIVO de Glue antes de tocar el compilador.
+ *
+ * ## Por qué el nombre va calificado y las columnas llevan alias
+ *
+ * Hay DOS bases en el lake — `fiado_analytics` (Iceberg) y `fiado-datalake-op` (Hive) — y el caso
+ * de negocio es cruzarlas: una venta retail con la persona del core, con su cuenta PagoConFiado.
+ * Un nombre a secas sería ambiguo, y un error de tipeo apuntaría a la base equivocada en silencio.
+ *
+ * Y **cada** tabla del `FROM` y de cada `JOIN` recibe su propio predicado de alcance. Aplicarlo
+ * solo a la tabla base dejaría la unida sin restringir: bastaría una columna en común para salir
+ * por ese lado.
+ */
+/** Referencia a una columna, calificada por el alias de su tabla. */
+export interface ColumnRefDto {
+    /** Alias de la tabla. **Obligatorio en cuanto hay un join** — si no, la columna es ambigua. */
+    table?: string;
+    column: string;
+}
+export interface JoinSpecDto {
+    /** Nombre calificado `basedatos.tabla`. */
+    table: string;
+    /** Alias obligatorio: califica sus columnas y su predicado impuesto. */
+    alias: string;
+    type: JoinTypeEnum;
+    left: ColumnRefDto;
+    right: ColumnRefDto;
+}
+export interface MetricSpecDto {
+    /** Con `COUNT` se acepta `{ column: '*' }`. */
+    column: ColumnRefDto;
+    fn: MetricFnEnum;
+    /** Alias de salida. Si no viene, se deriva de la función y la columna. */
+    alias?: string;
+}
+export interface FilterSpecDto {
+    column: ColumnRefDto;
+    op: FilterOpEnum;
+    /** Un arreglo solo es válido con `IN`. */
+    value: string | number | boolean | (string | number)[];
+}
+export interface OrderSpecDto {
+    /** Debe ser un alias YA presente en el SELECT, no una columna arbitraria. */
+    alias: string;
+    desc?: boolean;
+}
+export interface ReportRequestDto {
+    /** Nombre calificado `basedatos.tabla`. */
+    table: string;
+    /** Alias de la tabla base. Si no viene, el backend usa `t0`. */
+    alias?: string;
+    joins?: JoinSpecDto[];
+    dimensions?: ColumnRefDto[];
+    metrics?: MetricSpecDto[];
+    filters?: FilterSpecDto[];
+    orderBy?: OrderSpecDto;
+    /** El backend lo castea a entero y lo recorta a su tope duro. */
+    limit?: number;
+}

package/bin/datalakeQuery/dtos/ReportRequestDto.js

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

package/bin/datalakeQuery/dtos/ReportResultDto.d.ts

@@ -0,0 +1,27 @@
+import { ReportJobStatusEnum } from '../enums/ReportJobStatusEnum';
+/**
+ * La respuesta de arrancar un reporte.
+ *
+ * 🔴 **El contrato es un `if`:** si viene `rows`, ya está — pinta. Si viene solo `jobId`, la
+ * consulta sigue corriendo y hay que pollear.
+ *
+ * Es ejecución **híbrida**, no asíncrona pura: el backend espera ~20 s en línea (API Gateway corta
+ * a los 29) y solo degrada a polling la cola. La mayoría de las consultas se resuelven en una sola
+ * llamada.
+ *
+ * ⚠️ El `queryExecutionId` de Athena **nunca** viaja acá. El `jobId` es un ULID propio del destino,
+ * atado a su tenant: pedir el de otro no da 403, da 404 — sin diferencia observable no se pueden
+ * enumerar los ajenos.
+ */
+export interface ReportResultDto {
+    jobId: string;
+    status: ReportJobStatusEnum;
+    /** Presentes solo si terminó dentro de la espera en línea. Athena devuelve todo como texto. */
+    rows?: Record<string, string | null>[];
+    /** Para pedir la siguiente página del resultado. */
+    nextToken?: string;
+    /** `true` si Athena la tiene EN FILA, no procesando. Cambia lo que se le dice al usuario. */
+    queued?: boolean;
+    bytesScanned?: number;
+    failureReason?: string;
+}

package/bin/datalakeQuery/dtos/ReportResultDto.js

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

package/bin/datalakeQuery/enums/FilterOpEnum.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Operadores de filtro permitidos. Lista CERRADA, y **sin `OR`**.
+ *
+ * Los filtros se combinan siempre con `AND` y el bloque entero se envuelve en paréntesis antes de
+ * pegarle los predicados que impone el backend. Con `OR` disponible y sin parentizar, `AND` liga
+ * más fuerte y `a OR b AND scope` se evalúa como `a OR (b AND scope)`: el primer disyunto gana y
+ * el filtro de alcance queda decorativo.
+ */
+export declare enum FilterOpEnum {
+    EQ = "=",
+    NEQ = "!=",
+    GT = ">",
+    GTE = ">=",
+    LT = "<",
+    LTE = "<=",
+    IN = "IN",
+    LIKE = "LIKE"
+}

package/bin/datalakeQuery/enums/FilterOpEnum.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilterOpEnum = void 0;
+/**
+ * Operadores de filtro permitidos. Lista CERRADA, y **sin `OR`**.
+ *
+ * Los filtros se combinan siempre con `AND` y el bloque entero se envuelve en paréntesis antes de
+ * pegarle los predicados que impone el backend. Con `OR` disponible y sin parentizar, `AND` liga
+ * más fuerte y `a OR b AND scope` se evalúa como `a OR (b AND scope)`: el primer disyunto gana y
+ * el filtro de alcance queda decorativo.
+ */
+var FilterOpEnum;
+(function (FilterOpEnum) {
+    FilterOpEnum["EQ"] = "=";
+    FilterOpEnum["NEQ"] = "!=";
+    FilterOpEnum["GT"] = ">";
+    FilterOpEnum["GTE"] = ">=";
+    FilterOpEnum["LT"] = "<";
+    FilterOpEnum["LTE"] = "<=";
+    FilterOpEnum["IN"] = "IN";
+    FilterOpEnum["LIKE"] = "LIKE";
+})(FilterOpEnum || (exports.FilterOpEnum = FilterOpEnum = {}));

package/bin/datalakeQuery/enums/JoinTypeEnum.d.ts

@@ -0,0 +1,4 @@
+export declare enum JoinTypeEnum {
+    INNER = "INNER",
+    LEFT = "LEFT"
+}

package/bin/datalakeQuery/enums/JoinTypeEnum.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JoinTypeEnum = void 0;
+var JoinTypeEnum;
+(function (JoinTypeEnum) {
+    JoinTypeEnum["INNER"] = "INNER";
+    JoinTypeEnum["LEFT"] = "LEFT";
+})(JoinTypeEnum || (exports.JoinTypeEnum = JoinTypeEnum = {}));

package/bin/datalakeQuery/enums/MetricFnEnum.d.ts

@@ -0,0 +1,8 @@
+/** Funciones de agregación permitidas. Lista CERRADA: el cliente no manda el nombre de la función. */
+export declare enum MetricFnEnum {
+    COUNT = "COUNT",
+    SUM = "SUM",
+    AVG = "AVG",
+    MIN = "MIN",
+    MAX = "MAX"
+}

package/bin/datalakeQuery/enums/MetricFnEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricFnEnum = void 0;
+/** Funciones de agregación permitidas. Lista CERRADA: el cliente no manda el nombre de la función. */
+var MetricFnEnum;
+(function (MetricFnEnum) {
+    MetricFnEnum["COUNT"] = "COUNT";
+    MetricFnEnum["SUM"] = "SUM";
+    MetricFnEnum["AVG"] = "AVG";
+    MetricFnEnum["MIN"] = "MIN";
+    MetricFnEnum["MAX"] = "MAX";
+})(MetricFnEnum || (exports.MetricFnEnum = MetricFnEnum = {}));

package/bin/datalakeQuery/enums/ReportJobStatusEnum.d.ts

@@ -0,0 +1,6 @@
+/** Estado de un trabajo de reporte, tal como lo ve el consumidor. */
+export declare enum ReportJobStatusEnum {
+    RUNNING = "RUNNING",
+    DONE = "DONE",
+    FAILED = "FAILED"
+}

package/bin/datalakeQuery/enums/ReportJobStatusEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportJobStatusEnum = void 0;
+/** Estado de un trabajo de reporte, tal como lo ve el consumidor. */
+var ReportJobStatusEnum;
+(function (ReportJobStatusEnum) {
+    ReportJobStatusEnum["RUNNING"] = "RUNNING";
+    ReportJobStatusEnum["DONE"] = "DONE";
+    ReportJobStatusEnum["FAILED"] = "FAILED";
+})(ReportJobStatusEnum || (exports.ReportJobStatusEnum = ReportJobStatusEnum = {}));

package/bin/datalakeQuery/index.d.ts

@@ -0,0 +1,7 @@
+export * from './enums/MetricFnEnum';
+export * from './enums/FilterOpEnum';
+export * from './enums/JoinTypeEnum';
+export * from './enums/ReportJobStatusEnum';
+export * from './dtos/ReportRequestDto';
+export * from './dtos/AggregateRequestDto';
+export * from './dtos/ReportResultDto';

package/bin/datalakeQuery/index.js

@@ -0,0 +1,25 @@
+"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/MetricFnEnum"), exports);
+__exportStar(require("./enums/FilterOpEnum"), exports);
+__exportStar(require("./enums/JoinTypeEnum"), exports);
+__exportStar(require("./enums/ReportJobStatusEnum"), exports);
+// DTOs
+__exportStar(require("./dtos/ReportRequestDto"), exports);
+__exportStar(require("./dtos/AggregateRequestDto"), exports);
+__exportStar(require("./dtos/ReportResultDto"), exports);

package/bin/index.d.ts

@@ -95,6 +95,7 @@ export * as RetailCatalog from './retailCatalog';
 export * as RetailCards from './retailCards';
 export * as RetailCustomer from './retailCustomer';
 export * as RetailWizard from './retailWizard';
+export * as DatalakeQuery from './datalakeQuery';
 export * as LoanConfig from './loanConfig';
 export * as Shortlink from './shortlink';
 export * as LoanOfferings from './loanOfferings';

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.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.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = 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.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -158,6 +158,7 @@ exports.RetailCustomer = __importStar(require("./retailCustomer"));
 // RetailWizard: DTOs/enums del lambda retail-wizard-business (comp 04 — wizard de venta de contado:
 // saga de sesión, OTP, KYC, venta y prospectos; SureKeep Fase 2 — pista Retail).
 exports.RetailWizard = __importStar(require("./retailWizard"));
+exports.DatalakeQuery = __importStar(require("./datalakeQuery"));
 // LoanConfig: DTOs/enums del lambda loan-config-business (comp 09 — parámetros operativos del SOFOM).
 exports.LoanConfig = __importStar(require("./loanConfig"));
 // Shortlink: DTOs del lambda shortlink-business (acortador de URLs). Se consume M2M por su endpoint

package/package.json

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

package/src/collection/dtos/ApplyCollectionResultRequest.ts

@@ -0,0 +1,16 @@
+import { IsString, IsInt, IsEnum, IsOptional } from 'class-validator';
+import { CollectionResultStatus } from '../enums/CollectionResultStatus';
+import { MechanismType } from '../enums/MechanismType';
+
+export class ApplyCollectionResultRequest {
+  @IsString() attemptId!: string;      // dedupe idempotente en el dominio
+  @IsString() intentId!: string;
+  @IsString() chargeId!: string;
+  @IsString() domain!: string;
+  @IsString() tenantId!: string;
+  @IsEnum(CollectionResultStatus) result!: CollectionResultStatus;
+  @IsInt() amountCollected!: number;
+  @IsInt() amountReserved!: number;
+  @IsEnum(MechanismType) mechanism!: MechanismType;
+  @IsOptional() @IsString() holdTxId?: string;
+}

package/src/collection/index.ts

@@ -16,3 +16,4 @@ export * from './dtos/RetryPolicyDto';
 export * from './dtos/CollectionSourceDto';
 export * from './dtos/CollectionProductConfigDto';
 export * from './dtos/UpsertProductConfigRequest';
+export * from './dtos/ApplyCollectionResultRequest';

package/src/datalakeQuery/dtos/AggregateRequestDto.ts

@@ -0,0 +1,30 @@
+import { ReportRequestDto } from './ReportRequestDto';
+import { PermissionScope } from '../../platformRbac/enums/PermissionScope';
+
+/**
+ * El cuerpo del privado M2M `POST /private/analytics/aggregate` de `datalake-query-business`.
+ *
+ * ## El tenant y el alcance van en campos PROPIOS, separados del reporte
+ *
+ * Un privado no lleva token de usuario, así que el caller —que ya validó el suyo— declara el
+ * `tenantId`. Es el patrón de la casa: `@fiado/tenant-context` tiene `withContextByTenantId` hecho
+ * para esto, con las mismas garantías que el camino por issuer.
+ *
+ * Lo que se cuida es que **ese dato no se mezcle con la consulta**: viaja aparte, el destino lo
+ * resuelve contra el registry —un tenant desconocido es error, nunca un default— y **jamás se usa
+ * como valor dentro del SQL**. El predicado lo pone el compilador desde el contexto ya resuelto.
+ *
+ * ⚠️ **Si no mandas `scope`, el destino asume `LEVEL_1`, nunca `TENANT`.** Heredar el alcance más
+ * amplio por omisión lo ampliaría en silencio, que es exactamente el descuido que no queremos.
+ */
+export interface AggregateRequestDto {
+    /** Tenant del actor original. Obligatorio: sin él el destino no sabe qué silo consultar. */
+    tenantId: string;
+    /** Quién llama (`retail-org-business`, `retail-wizard-business`…). Queda auditado en el job. */
+    callerService: string;
+    /** Alcance del actor original. Omitirlo asume `LEVEL_1`. */
+    scope?: PermissionScope;
+    /** Obligatorio para `LEVEL_1`, `LEVEL_2` y `LEVEL_3`. */
+    scopeRef?: string;
+    report: ReportRequestDto;
+}

package/src/datalakeQuery/dtos/ReportRequestDto.ts

@@ -0,0 +1,73 @@
+import { FilterOpEnum } from '../enums/FilterOpEnum';
+import { JoinTypeEnum } from '../enums/JoinTypeEnum';
+import { MetricFnEnum } from '../enums/MetricFnEnum';
+
+/**
+ * El contrato declarativo del motor de reportes sobre el data lake.
+ *
+ * 🔴 **El cliente NUNCA manda SQL.** Manda esta estructura y el backend la compila. Esa es la
+ * diferencia entre "escapamos bien las comillas" y "no hay superficie de inyección": la tabla y
+ * cada columna se validan contra el schema VIVO de Glue antes de tocar el compilador.
+ *
+ * ## Por qué el nombre va calificado y las columnas llevan alias
+ *
+ * Hay DOS bases en el lake — `fiado_analytics` (Iceberg) y `fiado-datalake-op` (Hive) — y el caso
+ * de negocio es cruzarlas: una venta retail con la persona del core, con su cuenta PagoConFiado.
+ * Un nombre a secas sería ambiguo, y un error de tipeo apuntaría a la base equivocada en silencio.
+ *
+ * Y **cada** tabla del `FROM` y de cada `JOIN` recibe su propio predicado de alcance. Aplicarlo
+ * solo a la tabla base dejaría la unida sin restringir: bastaría una columna en común para salir
+ * por ese lado.
+ */
+
+/** Referencia a una columna, calificada por el alias de su tabla. */
+export interface ColumnRefDto {
+    /** Alias de la tabla. **Obligatorio en cuanto hay un join** — si no, la columna es ambigua. */
+    table?: string;
+    column: string;
+}
+
+export interface JoinSpecDto {
+    /** Nombre calificado `basedatos.tabla`. */
+    table: string;
+    /** Alias obligatorio: califica sus columnas y su predicado impuesto. */
+    alias: string;
+    type: JoinTypeEnum;
+    left: ColumnRefDto;
+    right: ColumnRefDto;
+}
+
+export interface MetricSpecDto {
+    /** Con `COUNT` se acepta `{ column: '*' }`. */
+    column: ColumnRefDto;
+    fn: MetricFnEnum;
+    /** Alias de salida. Si no viene, se deriva de la función y la columna. */
+    alias?: string;
+}
+
+export interface FilterSpecDto {
+    column: ColumnRefDto;
+    op: FilterOpEnum;
+    /** Un arreglo solo es válido con `IN`. */
+    value: string | number | boolean | (string | number)[];
+}
+
+export interface OrderSpecDto {
+    /** Debe ser un alias YA presente en el SELECT, no una columna arbitraria. */
+    alias: string;
+    desc?: boolean;
+}
+
+export interface ReportRequestDto {
+    /** Nombre calificado `basedatos.tabla`. */
+    table: string;
+    /** Alias de la tabla base. Si no viene, el backend usa `t0`. */
+    alias?: string;
+    joins?: JoinSpecDto[];
+    dimensions?: ColumnRefDto[];
+    metrics?: MetricSpecDto[];
+    filters?: FilterSpecDto[];
+    orderBy?: OrderSpecDto;
+    /** El backend lo castea a entero y lo recorta a su tope duro. */
+    limit?: number;
+}

package/src/datalakeQuery/dtos/ReportResultDto.ts

@@ -0,0 +1,28 @@
+import { ReportJobStatusEnum } from '../enums/ReportJobStatusEnum';
+
+/**
+ * La respuesta de arrancar un reporte.
+ *
+ * 🔴 **El contrato es un `if`:** si viene `rows`, ya está — pinta. Si viene solo `jobId`, la
+ * consulta sigue corriendo y hay que pollear.
+ *
+ * Es ejecución **híbrida**, no asíncrona pura: el backend espera ~20 s en línea (API Gateway corta
+ * a los 29) y solo degrada a polling la cola. La mayoría de las consultas se resuelven en una sola
+ * llamada.
+ *
+ * ⚠️ El `queryExecutionId` de Athena **nunca** viaja acá. El `jobId` es un ULID propio del destino,
+ * atado a su tenant: pedir el de otro no da 403, da 404 — sin diferencia observable no se pueden
+ * enumerar los ajenos.
+ */
+export interface ReportResultDto {
+    jobId: string;
+    status: ReportJobStatusEnum;
+    /** Presentes solo si terminó dentro de la espera en línea. Athena devuelve todo como texto. */
+    rows?: Record<string, string | null>[];
+    /** Para pedir la siguiente página del resultado. */
+    nextToken?: string;
+    /** `true` si Athena la tiene EN FILA, no procesando. Cambia lo que se le dice al usuario. */
+    queued?: boolean;
+    bytesScanned?: number;
+    failureReason?: string;
+}

package/src/datalakeQuery/enums/FilterOpEnum.ts

@@ -0,0 +1,18 @@
+/**
+ * Operadores de filtro permitidos. Lista CERRADA, y **sin `OR`**.
+ *
+ * Los filtros se combinan siempre con `AND` y el bloque entero se envuelve en paréntesis antes de
+ * pegarle los predicados que impone el backend. Con `OR` disponible y sin parentizar, `AND` liga
+ * más fuerte y `a OR b AND scope` se evalúa como `a OR (b AND scope)`: el primer disyunto gana y
+ * el filtro de alcance queda decorativo.
+ */
+export enum FilterOpEnum {
+    EQ = '=',
+    NEQ = '!=',
+    GT = '>',
+    GTE = '>=',
+    LT = '<',
+    LTE = '<=',
+    IN = 'IN',
+    LIKE = 'LIKE',
+}

package/src/datalakeQuery/enums/JoinTypeEnum.ts

@@ -0,0 +1,4 @@
+export enum JoinTypeEnum {
+    INNER = 'INNER',
+    LEFT = 'LEFT',
+}

package/src/datalakeQuery/enums/MetricFnEnum.ts

@@ -0,0 +1,8 @@
+/** Funciones de agregación permitidas. Lista CERRADA: el cliente no manda el nombre de la función. */
+export enum MetricFnEnum {
+    COUNT = 'COUNT',
+    SUM = 'SUM',
+    AVG = 'AVG',
+    MIN = 'MIN',
+    MAX = 'MAX',
+}

package/src/datalakeQuery/enums/ReportJobStatusEnum.ts

@@ -0,0 +1,6 @@
+/** Estado de un trabajo de reporte, tal como lo ve el consumidor. */
+export enum ReportJobStatusEnum {
+    RUNNING = 'RUNNING',
+    DONE = 'DONE',
+    FAILED = 'FAILED',
+}

package/src/datalakeQuery/index.ts

@@ -0,0 +1,10 @@
+// Enums
+export * from './enums/MetricFnEnum';
+export * from './enums/FilterOpEnum';
+export * from './enums/JoinTypeEnum';
+export * from './enums/ReportJobStatusEnum';
+
+// DTOs
+export * from './dtos/ReportRequestDto';
+export * from './dtos/AggregateRequestDto';
+export * from './dtos/ReportResultDto';

package/src/index.ts

@@ -117,6 +117,7 @@ export * as RetailCustomer from './retailCustomer';
 // RetailWizard: DTOs/enums del lambda retail-wizard-business (comp 04 — wizard de venta de contado:
 // saga de sesión, OTP, KYC, venta y prospectos; SureKeep Fase 2 — pista Retail).
 export * as RetailWizard from './retailWizard';
+export * as DatalakeQuery from './datalakeQuery';
 // LoanConfig: DTOs/enums del lambda loan-config-business (comp 09 — parámetros operativos del SOFOM).
 export * as LoanConfig from './loanConfig';
 // Shortlink: DTOs del lambda shortlink-business (acortador de URLs). Se consume M2M por su endpoint