@fiado/type-kit 3.519.0 → 3.521.0

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/bin/rewardsEligibility/dtos/backoffice/FailedConditionEvaluationResponse.d.ts

@@ -0,0 +1,6 @@
+/** En qué evaluación falló una condición y cuántas veces (máximo 5 por condición, de mayor a menor). */
+export declare class FailedConditionEvaluationResponse {
+    evaluationId: string;
+    evaluationName: string;
+    count: number;
+}

package/bin/rewardsEligibility/dtos/backoffice/FailedConditionEvaluationResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FailedConditionEvaluationResponse = void 0;
+/** En qué evaluación falló una condición y cuántas veces (máximo 5 por condición, de mayor a menor). */
+class FailedConditionEvaluationResponse {
+}
+exports.FailedConditionEvaluationResponse = FailedConditionEvaluationResponse;

package/bin/rewardsEligibility/dtos/backoffice/FailedConditionStatResponse.d.ts

@@ -1,3 +1,4 @@
+import { FailedConditionEvaluationResponse } from './FailedConditionEvaluationResponse';
 /** Condición que más hace fallar la regla (`GET /metrics/failed-conditions`). */
 export declare class FailedConditionStatResponse {
     /** `{source}.{field}`. */
@@ -5,4 +6,6 @@ export declare class FailedConditionStatResponse {
     /** Etiqueta legible (del catálogo de reglas; si no está, la propia `key`). */
     label: string;
     count: number;
+    /** Evaluaciones donde falla esta condición, ordenadas por `count` descendente (máx. 5). */
+    evaluations: FailedConditionEvaluationResponse[];
 }

package/bin/rewardsEligibility/index.d.ts

@@ -66,4 +66,5 @@ export * from './dtos/backoffice/RunResultListResponse';
 export * from './dtos/backoffice/CreateRunResponse';
 export * from './dtos/backoffice/MetricsPointResponse';
 export * from './dtos/backoffice/FailedConditionStatResponse';
+export * from './dtos/backoffice/FailedConditionEvaluationResponse';
 export * from './dtos/backoffice/MetricsQuery';

package/bin/rewardsEligibility/index.js

@@ -88,4 +88,5 @@ __exportStar(require("./dtos/backoffice/RunResultListResponse"), exports);
 __exportStar(require("./dtos/backoffice/CreateRunResponse"), exports);
 __exportStar(require("./dtos/backoffice/MetricsPointResponse"), exports);
 __exportStar(require("./dtos/backoffice/FailedConditionStatResponse"), exports);
+__exportStar(require("./dtos/backoffice/FailedConditionEvaluationResponse"), exports);
 __exportStar(require("./dtos/backoffice/MetricsQuery"), exports);

package/package.json

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

package/src/mdm/dtos/DeviceEnrollRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from "class-transformer";
-import { IsString, IsNotEmpty, IsOptional, IsNumber, IsPositive, Matches, IsEnum } from "class-validator";
+import { IsString, IsNotEmpty, IsOptional, IsNumber, IsPositive, Matches, IsEnum, IsISO8601 } from "class-validator";
 import { CREDIT_ID_MESSAGE, CREDIT_ID_PATTERN } from "../../common/constants/CreditIdPattern";
 import { MdmLockModeEnum } from "../../retailCatalog/enums/MdmLockModeEnum";
 
@@ -39,6 +39,12 @@ export class DeviceEnrollRequest {
     @IsOptional()
     lockMode?: MdmLockModeEnum;
 
+    /** ISO-8601 del primer bloqueo programado (primer vencimiento); lo usan proveedores que agendan el bloqueo al enrolar. */
+    @Expose()
+    @IsISO8601()
+    @IsOptional()
+    firstLockAt?: string;
+
     @Expose()
     @IsString()
     @IsNotEmpty()

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;
+}

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

@@ -0,0 +1,23 @@
+import { ItemErrorCategoryEnum } from '../../enums/ItemErrorCategoryEnum';
+
+/** Query params ya validados de `GET /grants` y `GET /grants/export` (el lambda los valida; ver `GrantListQueryHelper`). */
+export 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/src/rewards/dtos/backoffice/GrantListResponse.ts

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

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

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

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

@@ -0,0 +1,22 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsNotEmpty, IsString, Matches, MaxLength } from 'class-validator';
+import { REWARD_ID_PATTERN } from '../../constants/BackofficeLimits';
+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 class PartnerRequest {
+    @Expose()
+    @IsString()
+    @Matches(REWARD_ID_PATTERN)
+    id: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(120)
+    name: string;
+
+    @Expose()
+    @IsEnum(RewardStatusEnum)
+    status: RewardStatusEnum;
+}

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

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

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

@@ -0,0 +1,13 @@
+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 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/src/rewards/dtos/backoffice/PartnersSummaryQuery.ts

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

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

@@ -1,16 +1,11 @@
 import { Expose } from 'class-transformer';
 import { IsNotEmpty, IsString, MaxLength } from 'class-validator';
 
+/** A quién se le cobra. `partnerName` ya no se escribe a mano: el servidor lo copia de `RewardPartner_GT` (D-A2). */
 export class RewardChargeToInput {
     @Expose()
     @IsString()
     @IsNotEmpty()
     @MaxLength(64)
     partnerId: string;
-
-    @Expose()
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(120)
-    partnerName: string;
 }

package/src/rewards/enums/DeliveryDimensionEnum.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 enum DeliveryDimensionEnum {
+    ALL = 'ALL',
+    PACKAGE = 'PACKAGE',
+    CATALOG_ITEM = 'CATALOG_ITEM',
+    PARTNER = 'PARTNER',
+    SOURCE = 'SOURCE',
+}

package/src/rewards/enums/DeliveryTopByEnum.ts

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

package/src/rewards/enums/DeliveryTopDimensionEnum.ts

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

package/src/rewards/index.ts

@@ -8,6 +8,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';
 
 //Types
 export * from './types/RewardInputs';
@@ -50,3 +53,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/src/rewardsEligibility/dtos/backoffice/FailedConditionEvaluationResponse.ts

@@ -0,0 +1,6 @@
+/** En qué evaluación falló una condición y cuántas veces (máximo 5 por condición, de mayor a menor). */
+export class FailedConditionEvaluationResponse {
+    evaluationId: string;
+    evaluationName: string;
+    count: number;
+}

package/src/rewardsEligibility/dtos/backoffice/FailedConditionStatResponse.ts

@@ -1,3 +1,5 @@
+import { FailedConditionEvaluationResponse } from './FailedConditionEvaluationResponse';
+
 /** Condición que más hace fallar la regla (`GET /metrics/failed-conditions`). */
 export class FailedConditionStatResponse {
     /** `{source}.{field}`. */
@@ -5,4 +7,6 @@ export class FailedConditionStatResponse {
     /** Etiqueta legible (del catálogo de reglas; si no está, la propia `key`). */
     label: string;
     count: number;
+    /** Evaluaciones donde falla esta condición, ordenadas por `count` descendente (máx. 5). */
+    evaluations: FailedConditionEvaluationResponse[];
 }

package/src/rewardsEligibility/index.ts

@@ -77,4 +77,5 @@ export * from './dtos/backoffice/RunResultListResponse';
 export * from './dtos/backoffice/CreateRunResponse';
 export * from './dtos/backoffice/MetricsPointResponse';
 export * from './dtos/backoffice/FailedConditionStatResponse';
+export * from './dtos/backoffice/FailedConditionEvaluationResponse';
 export * from './dtos/backoffice/MetricsQuery';