@fiado/type-kit 3.518.0 → 3.520.0

package/bin/rewards/dtos/backoffice/DeliveryTopEntry.d.ts

@@ -0,0 +1,16 @@
+import { ItemErrorCategoryEnum } from '../../enums/ItemErrorCategoryEnum';
+import { RewardCost } from '../RewardCost';
+/** Una fila del top de métricas. `errors` solo viene en la dimensión `CATALOG_ITEM`. */
+export declare class DeliveryTopEntry {
+    value: string;
+    label: string;
+    granted: number;
+    failed: number;
+    skipped: number;
+    /** Un costo por moneda; las monedas no se suman entre sí. */
+    cost: RewardCost[];
+    errors?: {
+        category: ItemErrorCategoryEnum;
+        count: number;
+    }[];
+}

package/bin/rewards/dtos/backoffice/DeliveryTopEntry.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveryTopEntry = void 0;
+/** Una fila del top de métricas. `errors` solo viene en la dimensión `CATALOG_ITEM`. */
+class DeliveryTopEntry {
+}
+exports.DeliveryTopEntry = DeliveryTopEntry;

package/bin/rewards/dtos/backoffice/DeliveryTopQuery.d.ts

@@ -0,0 +1,11 @@
+import { CurrencyId } from '../../../currency';
+import { DeliveryTopByEnum } from '../../enums/DeliveryTopByEnum';
+import { DeliveryTopDimensionEnum } from '../../enums/DeliveryTopDimensionEnum';
+/** Query params ya validados de `GET /metrics/deliveries/top`. `from`/`to` = `AAAA-MM-DD` UTC. */
+export declare class DeliveryTopQuery {
+    dimension: DeliveryTopDimensionEnum;
+    from: string;
+    to: string;
+    by: DeliveryTopByEnum;
+    currency?: CurrencyId;
+}

package/bin/rewards/dtos/backoffice/DeliveryTopQuery.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveryTopQuery = void 0;
+/** Query params ya validados de `GET /metrics/deliveries/top`. `from`/`to` = `AAAA-MM-DD` UTC. */
+class DeliveryTopQuery {
+}
+exports.DeliveryTopQuery = DeliveryTopQuery;

package/bin/rewards/dtos/backoffice/GrantListQuery.d.ts

@@ -0,0 +1,22 @@
+import { ItemErrorCategoryEnum } from '../../enums/ItemErrorCategoryEnum';
+/** Query params ya validados de `GET /grants` y `GET /grants/export` (el lambda los valida; ver `GrantListQueryHelper`). */
+export declare class GrantListQuery {
+    limit?: number;
+    cursor?: string;
+    /** Uno o varios `GrantStatusEnum` separados por coma. */
+    status?: string;
+    packageId?: string;
+    campaignId?: string;
+    service?: string;
+    partnerId?: string;
+    directoryId?: string;
+    /** Coincide con un `id` de entrega; si no, se trata como `directoryId`. Sin búsqueda por nombre. */
+    search?: string;
+    /** `AAAA-MM-DD` UTC, inclusivos. Default: `to` = hoy, `from` = `to − 6`. Máximo 92 días. */
+    from?: string;
+    to?: string;
+    /** Entregas que contienen esta recompensa del catálogo (D-F1). */
+    catalogItemId?: string;
+    /** Entregas con al menos un ítem FAILED cuyo último intento falló con esta categoría (D-F1). */
+    errorCategory?: ItemErrorCategoryEnum;
+}

package/bin/rewards/dtos/backoffice/GrantListQuery.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrantListQuery = void 0;
+/** Query params ya validados de `GET /grants` y `GET /grants/export` (el lambda los valida; ver `GrantListQueryHelper`). */
+class GrantListQuery {
+}
+exports.GrantListQuery = GrantListQuery;

package/bin/rewards/dtos/backoffice/GrantListResponse.d.ts

@@ -0,0 +1,5 @@
+import { BackofficeGrantResponse } from './BackofficeGrantResponse';
+export declare class GrantListResponse {
+    items: BackofficeGrantResponse[];
+    nextCursor?: string;
+}

package/bin/rewards/dtos/backoffice/GrantListResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrantListResponse = void 0;
+class GrantListResponse {
+}
+exports.GrantListResponse = GrantListResponse;

package/bin/rewards/dtos/backoffice/PartnerListResponse.d.ts

@@ -0,0 +1,6 @@
+import { PartnerResponse } from './PartnerResponse';
+export declare class PartnerListResponse {
+    items: PartnerResponse[];
+    /** Cursor opaco de la página siguiente; ausente en la última página. */
+    nextCursor?: string;
+}

package/bin/rewards/dtos/backoffice/PartnerListResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PartnerListResponse = void 0;
+class PartnerListResponse {
+}
+exports.PartnerListResponse = PartnerListResponse;

package/bin/rewards/dtos/backoffice/PartnerRequest.d.ts

@@ -0,0 +1,7 @@
+import { RewardStatusEnum } from '../../enums/RewardStatusEnum';
+/** Crear (POST) o reemplazar (PUT) un aliado. `version` y `updatedBy` los pone el servidor. El `id` lo genera el front del nombre. */
+export declare class PartnerRequest {
+    id: string;
+    name: string;
+    status: RewardStatusEnum;
+}

package/bin/rewards/dtos/backoffice/PartnerRequest.js

@@ -0,0 +1,38 @@
+"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.PartnerRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const BackofficeLimits_1 = require("../../constants/BackofficeLimits");
+const RewardStatusEnum_1 = require("../../enums/RewardStatusEnum");
+/** Crear (POST) o reemplazar (PUT) un aliado. `version` y `updatedBy` los pone el servidor. El `id` lo genera el front del nombre. */
+class PartnerRequest {
+}
+exports.PartnerRequest = PartnerRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(BackofficeLimits_1.REWARD_ID_PATTERN),
+    __metadata("design:type", String)
+], PartnerRequest.prototype, "id", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(120),
+    __metadata("design:type", String)
+], PartnerRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(RewardStatusEnum_1.RewardStatusEnum),
+    __metadata("design:type", String)
+], PartnerRequest.prototype, "status", void 0);

package/bin/rewards/dtos/backoffice/PartnerResponse.d.ts

@@ -0,0 +1,11 @@
+import { RewardStatusEnum } from '../../enums/RewardStatusEnum';
+export declare class PartnerResponse {
+    id: string;
+    name: string;
+    status: RewardStatusEnum;
+    version: number;
+    /** Epoch en milisegundos. */
+    createdAt: number;
+    updatedAt: number;
+    updatedBy: string;
+}

package/bin/rewards/dtos/backoffice/PartnerResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PartnerResponse = void 0;
+class PartnerResponse {
+}
+exports.PartnerResponse = PartnerResponse;

package/bin/rewards/dtos/backoffice/PartnerSummary.d.ts

@@ -0,0 +1,12 @@
+import { RewardCost } from '../RewardCost';
+import { RewardStatusEnum } from '../../enums/RewardStatusEnum';
+/** Un aliado con sus recompensas cobradas y el valor entregado en el rango (`GET /partners/summary`). */
+export declare class PartnerSummary {
+    partnerId: string;
+    partnerName: string;
+    status: RewardStatusEnum;
+    /** Recompensas del catálogo que se le cobran a este aliado. */
+    catalogItemIds: string[];
+    /** Valor entregado en el rango, POR MONEDA (nunca se mezclan). Vacío si no hubo entregas. */
+    delivered: RewardCost[];
+}

package/bin/rewards/dtos/backoffice/PartnerSummary.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PartnerSummary = void 0;
+/** Un aliado con sus recompensas cobradas y el valor entregado en el rango (`GET /partners/summary`). */
+class PartnerSummary {
+}
+exports.PartnerSummary = PartnerSummary;

package/bin/rewards/dtos/backoffice/PartnersSummaryQuery.d.ts

@@ -0,0 +1,5 @@
+/** Query params ya validados de `GET /partners/summary` (`AAAA-MM-DD`, UTC, inclusivos; default últimos 30 días). */
+export declare class PartnersSummaryQuery {
+    from?: string;
+    to?: string;
+}

package/bin/rewards/dtos/backoffice/PartnersSummaryQuery.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PartnersSummaryQuery = void 0;
+/** Query params ya validados de `GET /partners/summary` (`AAAA-MM-DD`, UTC, inclusivos; default últimos 30 días). */
+class PartnersSummaryQuery {
+}
+exports.PartnersSummaryQuery = PartnersSummaryQuery;

package/bin/rewards/dtos/backoffice/RewardChargeToInput.d.ts

@@ -1,4 +1,4 @@
+/** A quién se le cobra. `partnerName` ya no se escribe a mano: el servidor lo copia de `RewardPartner_GT` (D-A2). */
 export declare class RewardChargeToInput {
     partnerId: string;
-    partnerName: string;
 }

package/bin/rewards/dtos/backoffice/RewardChargeToInput.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RewardChargeToInput = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+/** A quién se le cobra. `partnerName` ya no se escribe a mano: el servidor lo copia de `RewardPartner_GT` (D-A2). */
 class RewardChargeToInput {
 }
 exports.RewardChargeToInput = RewardChargeToInput;
@@ -22,10 +23,3 @@ __decorate([
     (0, class_validator_1.MaxLength)(64),
     __metadata("design:type", String)
 ], RewardChargeToInput.prototype, "partnerId", void 0);
-__decorate([
-    (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    (0, class_validator_1.MaxLength)(120),
-    __metadata("design:type", String)
-], RewardChargeToInput.prototype, "partnerName", void 0);

package/bin/rewards/enums/DeliveryDimensionEnum.d.ts

@@ -0,0 +1,8 @@
+/** Dimensión de la serie diaria de métricas. Las etiquetas (`TAG#campaignId`, `TAG#evaluationId`) se validan con `METRICS_TAG_DIMENSION_PATTERN`. */
+export declare enum DeliveryDimensionEnum {
+    ALL = "ALL",
+    PACKAGE = "PACKAGE",
+    CATALOG_ITEM = "CATALOG_ITEM",
+    PARTNER = "PARTNER",
+    SOURCE = "SOURCE"
+}

package/bin/rewards/enums/DeliveryDimensionEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveryDimensionEnum = void 0;
+/** Dimensión de la serie diaria de métricas. Las etiquetas (`TAG#campaignId`, `TAG#evaluationId`) se validan con `METRICS_TAG_DIMENSION_PATTERN`. */
+var DeliveryDimensionEnum;
+(function (DeliveryDimensionEnum) {
+    DeliveryDimensionEnum["ALL"] = "ALL";
+    DeliveryDimensionEnum["PACKAGE"] = "PACKAGE";
+    DeliveryDimensionEnum["CATALOG_ITEM"] = "CATALOG_ITEM";
+    DeliveryDimensionEnum["PARTNER"] = "PARTNER";
+    DeliveryDimensionEnum["SOURCE"] = "SOURCE";
+})(DeliveryDimensionEnum || (exports.DeliveryDimensionEnum = DeliveryDimensionEnum = {}));

package/bin/rewards/enums/DeliveryTopByEnum.d.ts

@@ -0,0 +1,5 @@
+/** Criterio de ordenamiento del top de métricas. */
+export declare enum DeliveryTopByEnum {
+    cost = "cost",
+    count = "count"
+}

package/bin/rewards/enums/DeliveryTopByEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveryTopByEnum = void 0;
+/** Criterio de ordenamiento del top de métricas. */
+var DeliveryTopByEnum;
+(function (DeliveryTopByEnum) {
+    DeliveryTopByEnum["cost"] = "cost";
+    DeliveryTopByEnum["count"] = "count";
+})(DeliveryTopByEnum || (exports.DeliveryTopByEnum = DeliveryTopByEnum = {}));

package/bin/rewards/enums/DeliveryTopDimensionEnum.d.ts

@@ -0,0 +1,7 @@
+/** Dimensiones sobre las que se calcula el top de métricas. */
+export declare enum DeliveryTopDimensionEnum {
+    PACKAGE = "PACKAGE",
+    CATALOG_ITEM = "CATALOG_ITEM",
+    PARTNER = "PARTNER",
+    SOURCE = "SOURCE"
+}

package/bin/rewards/enums/DeliveryTopDimensionEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveryTopDimensionEnum = void 0;
+/** Dimensiones sobre las que se calcula el top de métricas. */
+var DeliveryTopDimensionEnum;
+(function (DeliveryTopDimensionEnum) {
+    DeliveryTopDimensionEnum["PACKAGE"] = "PACKAGE";
+    DeliveryTopDimensionEnum["CATALOG_ITEM"] = "CATALOG_ITEM";
+    DeliveryTopDimensionEnum["PARTNER"] = "PARTNER";
+    DeliveryTopDimensionEnum["SOURCE"] = "SOURCE";
+})(DeliveryTopDimensionEnum || (exports.DeliveryTopDimensionEnum = DeliveryTopDimensionEnum = {}));

package/bin/rewards/index.d.ts

@@ -7,6 +7,9 @@ export * from './enums/ItemErrorCategoryEnum';
 export * from './enums/RewardStatusEnum';
 export * from './enums/DependencyIfMissingEnum';
 export * from './enums/RewardsErrorCodeEnum';
+export * from './enums/DeliveryDimensionEnum';
+export * from './enums/DeliveryTopDimensionEnum';
+export * from './enums/DeliveryTopByEnum';
 export * from './types/RewardInputs';
 export * from './dtos/RewardCost';
 export * from './dtos/RewardChargeTo';
@@ -33,3 +36,21 @@ export * from './dtos/backoffice/PackageResponse';
 export * from './dtos/backoffice/RewardTypeResponse';
 export * from './dtos/backoffice/CatalogItemListResponse';
 export * from './dtos/backoffice/PackageListResponse';
+export * from './dtos/backoffice/PartnerRequest';
+export * from './dtos/backoffice/PartnerResponse';
+export * from './dtos/backoffice/PartnerListResponse';
+export * from './dtos/backoffice/PartnerSummary';
+export * from './dtos/backoffice/PartnersSummaryQuery';
+export * from './dtos/backoffice/GrantListQuery';
+export * from './dtos/backoffice/BackofficeGrantAttemptResponse';
+export * from './dtos/backoffice/BackofficeGrantItemResponse';
+export * from './dtos/backoffice/BackofficeGrantResponse';
+export * from './dtos/backoffice/GrantListResponse';
+export * from './dtos/backoffice/ChargeRecord';
+export * from './dtos/backoffice/ChargeListResponse';
+export * from './dtos/backoffice/ChargesQuery';
+export * from './dtos/backoffice/ChargesExportQuery';
+export * from './dtos/backoffice/DeliveryMetricsQuery';
+export * from './dtos/backoffice/DeliveryTopQuery';
+export * from './dtos/backoffice/DeliveryMetricsPoint';
+export * from './dtos/backoffice/DeliveryTopEntry';

package/bin/rewards/index.js

@@ -24,6 +24,9 @@ __exportStar(require("./enums/ItemErrorCategoryEnum"), exports);
 __exportStar(require("./enums/RewardStatusEnum"), exports);
 __exportStar(require("./enums/DependencyIfMissingEnum"), exports);
 __exportStar(require("./enums/RewardsErrorCodeEnum"), exports);
+__exportStar(require("./enums/DeliveryDimensionEnum"), exports);
+__exportStar(require("./enums/DeliveryTopDimensionEnum"), exports);
+__exportStar(require("./enums/DeliveryTopByEnum"), exports);
 //Types
 __exportStar(require("./types/RewardInputs"), exports);
 //DTOs
@@ -58,3 +61,21 @@ __exportStar(require("./dtos/backoffice/PackageResponse"), exports);
 __exportStar(require("./dtos/backoffice/RewardTypeResponse"), exports);
 __exportStar(require("./dtos/backoffice/CatalogItemListResponse"), exports);
 __exportStar(require("./dtos/backoffice/PackageListResponse"), exports);
+__exportStar(require("./dtos/backoffice/PartnerRequest"), exports);
+__exportStar(require("./dtos/backoffice/PartnerResponse"), exports);
+__exportStar(require("./dtos/backoffice/PartnerListResponse"), exports);
+__exportStar(require("./dtos/backoffice/PartnerSummary"), exports);
+__exportStar(require("./dtos/backoffice/PartnersSummaryQuery"), exports);
+__exportStar(require("./dtos/backoffice/GrantListQuery"), exports);
+__exportStar(require("./dtos/backoffice/BackofficeGrantAttemptResponse"), exports);
+__exportStar(require("./dtos/backoffice/BackofficeGrantItemResponse"), exports);
+__exportStar(require("./dtos/backoffice/BackofficeGrantResponse"), exports);
+__exportStar(require("./dtos/backoffice/GrantListResponse"), exports);
+__exportStar(require("./dtos/backoffice/ChargeRecord"), exports);
+__exportStar(require("./dtos/backoffice/ChargeListResponse"), exports);
+__exportStar(require("./dtos/backoffice/ChargesQuery"), exports);
+__exportStar(require("./dtos/backoffice/ChargesExportQuery"), exports);
+__exportStar(require("./dtos/backoffice/DeliveryMetricsQuery"), exports);
+__exportStar(require("./dtos/backoffice/DeliveryTopQuery"), exports);
+__exportStar(require("./dtos/backoffice/DeliveryMetricsPoint"), exports);
+__exportStar(require("./dtos/backoffice/DeliveryTopEntry"), exports);

package/package.json

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

package/src/retailCommission/dtos/CommissionAccrual.ts

@@ -72,7 +72,8 @@ export interface CommissionSaleInput {
     sellerId: string;
     retailerId: string;
     storeId: string;
-    sku: string;
+    /** `null` en la venta sin teléfono: se comisiona solo por accesorios. */
+    sku: string | null;
     brand: string | null;
     /**
      * 🔴 **La base de comisión es el PRECIO DEL EQUIPO, no lo cobrado en caja.**

package/src/retailWizard/dtos/Sale.ts

@@ -21,8 +21,9 @@ export interface Sale {
   wizardSessionId: string;
   type: SaleTypeEnum;
   externalProvider: ExternalProviderEnum | null;
-  sku: string;
-  /** Líneas vendidas; `sku` e `imei` siguen siendo los del teléfono financiado o de la línea principal. */
+  /** SKU del teléfono de la venta; `null` en la venta sin teléfono (en DDB se omite). */
+  sku: string | null;
+  /** Líneas vendidas; `sku` e `imei` son los del teléfono, o `null` si la venta no lleva teléfono. */
   lines?: SaleLine[];
   /** SKUs de líneas y componentes, para filtrar ventas por SKU. */
   skus?: string[];

package/src/retailWizard/dtos/WizardLineProduct.ts

@@ -1,3 +1,4 @@
+import type { ItemTypeEnum } from '../../retailCatalog/enums/ItemTypeEnum';
 import type { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
 import type { ProductTierEnum } from '../../retailCatalog/enums/ProductTierEnum';
 import type { TrackingModeEnum } from '../../retailCatalog/enums/TrackingModeEnum';
@@ -13,4 +14,6 @@ export interface WizardLineProduct {
     tier: ProductTierEnum | null;
     category: ProductCategoryEnum;
     trackingMode: TrackingModeEnum;
+    /** Producto físico o servicio; ausente en líneas viejas (el consumidor lo toma como PRODUCT). */
+    itemType?: ItemTypeEnum;
 }

package/src/retailWizard/events/RetailCommissionInboundMessage.ts

@@ -62,6 +62,12 @@ export class RetailCommissionInboundLine {
     @IsOptional()
     @IsEnum(WizardLineRoleEnum)
     role?: WizardLineRoleEnum;
+
+    /** Teléfonos que trae la línea (kit), congelados al cerrar; ausente en mensajes viejos. */
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    phoneCount?: number;
 }
 
 /** Venta cerrada o cancelada que el wizard publica en RetailCommissionInboundQueue. */

package/src/retailWizard/events/SaleCompletedV1.ts

@@ -11,7 +11,8 @@ export interface SaleCompletedV1 {
   retailerId: string;
   storeId: string;
   retailCustomerId: string;
-  sku: string;
+  /** `null` en la venta sin teléfono. */
+  sku: string | null;
   imei: string | null;
   /**
    * Lo cobrado en caja al cerrar: enganche + lo no financiado (en contado, el total).
@@ -23,7 +24,7 @@ export interface SaleCompletedV1 {
    * sin `type` un crédito con $1,300 de enganche era indistinguible de un contado de $1,300.
    */
   type?: SaleTypeEnum;
-  /** Precio de lista del equipo; en contado coincide con `amountCents`. */
+  /** Precio de lista del equipo; en contado coincide con `amountCents`. Sin equipo se omite. */
   equipmentPriceCents?: number;
   /** Enganche cobrado (solo `type=CREDIT`). */
   downPaymentCents?: number;

package/src/retailWizard/events/SaleCompletedV2.ts

@@ -24,7 +24,8 @@ export interface SaleCompletedV2 {
     /** Quién vendió — el eje del cálculo de comisión. Es lo que más falta en la V1. */
     sellerRetailUserId: string;
     retailCustomerId: string;
-    sku: string;
+    /** `null` en la venta sin teléfono. */
+    sku: string | null;
     /** Marca del equipo, del snapshot congelado al cerrar. `null` si no se pudo resolver. */
     brand: string | null;
     imei: string | null;

package/src/rewards/constants/BackofficeLimits.ts

@@ -4,3 +4,19 @@ export const REWARD_ITEM_KEY_PATTERN = new RegExp(`^[A-Za-z0-9_-]{1,${REWARD_ITE
 export const REWARD_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
 /** Máximo de ítems de un paquete (B-12 de rewards-business: presupuesto de tiempo del worker). Igual a `MAX_ITEMS_PER_PACKAGE` del lambda. */
 export const REWARD_PACKAGE_MAX_ITEMS = 4;
+
+/** Entregas de backoffice (Fase 4): ventana máxima del listado, default y tope del CSV. */
+export const GRANTS_MAX_RANGE_DAYS = 92;
+export const GRANTS_DEFAULT_RANGE_DAYS = 7;
+export const GRANTS_EXPORT_MAX_ROWS = 5000;
+
+/** Cierre mensual por aliado (D-C1): tope del CSV y formato de `month` (UTC). */
+export const CHARGES_EXPORT_MAX_ROWS = 10000;
+export const CHARGES_MONTH_PATTERN = /^\d{4}-(0[1-9]|1[0-2])$/;
+
+/** Métricas de entregas (D-D3): top de 10, máximo 200 valores por dimensión, y etiquetas permitidas. */
+export const METRICS_TOP_LIMIT = 10;
+export const METRICS_TOP_MAX_VALUES = 200;
+/** Etiquetas permitidas en métricas (D-D3b): una llave libre tendría cardinalidad ilimitada. */
+export const METRICS_TAG_ALLOWLIST: readonly string[] = ['campaignId', 'evaluationId'];
+export const METRICS_TAG_DIMENSION_PATTERN = /^TAG#(campaignId|evaluationId)$/;

package/src/rewards/dtos/backoffice/BackofficeGrantAttemptResponse.ts

@@ -0,0 +1,6 @@
+import { GrantAttemptResponse } from '../responses/GrantAttemptResponse';
+
+export class BackofficeGrantAttemptResponse extends GrantAttemptResponse {
+    /** Texto corto sin PII, mapeado desde `errorCategory`. */
+    message?: string;
+}

package/src/rewards/dtos/backoffice/BackofficeGrantItemResponse.ts

@@ -0,0 +1,8 @@
+import { GrantItemResponse } from '../responses/GrantItemResponse';
+import { BackofficeGrantAttemptResponse } from './BackofficeGrantAttemptResponse';
+
+export class BackofficeGrantItemResponse extends GrantItemResponse {
+    /** Nombre de la recompensa congelada en la entrega. */
+    name: string;
+    attempts: BackofficeGrantAttemptResponse[];
+}

package/src/rewards/dtos/backoffice/BackofficeGrantResponse.ts

@@ -0,0 +1,8 @@
+import { GrantResponse } from '../responses/GrantResponse';
+import { BackofficeGrantItemResponse } from './BackofficeGrantItemResponse';
+
+/** Sin `directoryName`: Directory no trae un campo de nombre confiable (Q2). Sin `requestSnapshot`/`providerResponse` (R2). */
+export class BackofficeGrantResponse extends GrantResponse {
+    packageName?: string;
+    items: BackofficeGrantItemResponse[];
+}

package/src/rewards/dtos/backoffice/ChargeListResponse.ts

@@ -0,0 +1,7 @@
+import { ChargeRecord } from './ChargeRecord';
+
+export class ChargeListResponse {
+    items: ChargeRecord[];
+    /** Cursor opaco de la página siguiente; ausente en la última página. */
+    nextCursor?: string;
+}

package/src/rewards/dtos/backoffice/ChargeRecord.ts

@@ -0,0 +1,18 @@
+import { RewardChargeTo } from '../RewardChargeTo';
+import { RewardCost } from '../RewardCost';
+
+/** Un cargo = un ítem que quedó GRANTED, con el costo CONGELADO en la entrega (no el actual del catálogo). Sin `source` (R4 lo guarda, no se expone). */
+export class ChargeRecord {
+    grantId: string;
+    itemKey: string;
+    /** Epoch en milisegundos (UTC). */
+    grantedAt: number;
+    directoryId: string;
+    catalogItemId: string;
+    catalogItemName: string;
+    campaignId?: string;
+    packageId: string;
+    cost: RewardCost;
+    chargeTo: RewardChargeTo;
+    externalRef?: Record<string, string>;
+}

package/src/rewards/dtos/backoffice/ChargesExportQuery.ts

@@ -0,0 +1,5 @@
+/** Query params ya validados de `GET /charges/export`. `month` = `AAAA-MM` UTC. */
+export class ChargesExportQuery {
+    partnerId: string;
+    month: string;
+}

package/src/rewards/dtos/backoffice/ChargesQuery.ts

@@ -0,0 +1,7 @@
+/** Query params ya validados de `GET /charges`. `month` = `AAAA-MM` UTC. */
+export class ChargesQuery {
+    partnerId: string;
+    month: string;
+    limit?: number;
+    cursor?: string;
+}

package/src/rewards/dtos/backoffice/DeliveryMetricsPoint.ts

@@ -0,0 +1,14 @@
+import { CurrencyId } from '../../../currency';
+
+/** Un punto de la serie diaria. `date` = `AAAA-MM-DD` UTC. `costGranted` = `costGrantedMinor / 100` (nunca se suman monedas distintas). */
+export class DeliveryMetricsPoint {
+    date: string;
+    currency: CurrencyId;
+    granted: number;
+    failed: number;
+    skipped: number;
+    grantsCompleted: number;
+    grantsPartial: number;
+    grantsFailed: number;
+    costGranted: number;
+}

package/src/rewards/dtos/backoffice/DeliveryMetricsQuery.ts

@@ -0,0 +1,10 @@
+import { CurrencyId } from '../../../currency';
+
+/** Query params ya validados de `GET /metrics/deliveries`. `dimension` es un `DeliveryDimensionEnum` o `TAG#campaignId|TAG#evaluationId`. `from`/`to` = `AAAA-MM-DD` UTC. */
+export class DeliveryMetricsQuery {
+    dimension: string;
+    value?: string;
+    from: string;
+    to: string;
+    currency?: CurrencyId;
+}

package/src/rewards/dtos/backoffice/DeliveryTopEntry.ts

@@ -0,0 +1,14 @@
+import { ItemErrorCategoryEnum } from '../../enums/ItemErrorCategoryEnum';
+import { RewardCost } from '../RewardCost';
+
+/** Una fila del top de métricas. `errors` solo viene en la dimensión `CATALOG_ITEM`. */
+export class DeliveryTopEntry {
+    value: string;
+    label: string;
+    granted: number;
+    failed: number;
+    skipped: number;
+    /** Un costo por moneda; las monedas no se suman entre sí. */
+    cost: RewardCost[];
+    errors?: { category: ItemErrorCategoryEnum; count: number }[];
+}

package/src/rewards/dtos/backoffice/DeliveryTopQuery.ts

@@ -0,0 +1,12 @@
+import { CurrencyId } from '../../../currency';
+import { DeliveryTopByEnum } from '../../enums/DeliveryTopByEnum';
+import { DeliveryTopDimensionEnum } from '../../enums/DeliveryTopDimensionEnum';
+
+/** Query params ya validados de `GET /metrics/deliveries/top`. `from`/`to` = `AAAA-MM-DD` UTC. */
+export class DeliveryTopQuery {
+    dimension: DeliveryTopDimensionEnum;
+    from: string;
+    to: string;
+    by: DeliveryTopByEnum;
+    currency?: CurrencyId;
+}