@fiado/type-kit 3.519.0 → 3.520.0

package/_test_/unit/rewards/backoffice.test.ts

@@ -11,7 +11,7 @@ const catalog = {
   type: 'ExampleType',
   config: { amount: 50, nested: { list: [1, 2] } },
   cost: { amount: 50, currency: 'MXN' },
-  chargeTo: { partnerId: 'ALIADO-001', partnerName: 'Aliado de ejemplo' },
+  chargeTo: { partnerId: 'ALIADO-001' },
   status: 'ACTIVE',
 };
 const pkg = { id: 'paquete-1', name: 'Paquete 1', status: 'ACTIVE', items: [{ itemKey: 'itemA', catalogItemId: 'example-reward-a' }] };

package/_test_/unit/rewards/chargeDtos.test.ts

@@ -0,0 +1,21 @@
+import 'reflect-metadata';
+import { CurrencyId } from '../../../src/currency';
+import { CHARGES_EXPORT_MAX_ROWS, CHARGES_MONTH_PATTERN } from '../../../src/rewards';
+import type { ChargeListResponse, ChargeRecord, ChargesExportQuery, ChargesQuery } from '../../../src/rewards';
+
+describe('contrato de cargos (D-C1)', () => {
+  it.each(['2026-01', '2026-12'])('acepta el mes %s', (m) => expect(CHARGES_MONTH_PATTERN.test(m)).toBe(true));
+  it.each(['2026-13', '2026-00', '26-10', '2026-1', '2026-10-01'])('rechaza el mes %s', (m) => expect(CHARGES_MONTH_PATTERN.test(m)).toBe(false));
+
+  it('tope del export y forma de ChargeRecord (con packageId, sin source)', () => {
+    const record: ChargeRecord = {
+      grantId: 'g', itemKey: 'a', grantedAt: 1, directoryId: 'd', catalogItemId: 'c', catalogItemName: 'Recarga', packageId: 'p',
+      cost: { amount: 10, currency: CurrencyId.MXN }, chargeTo: { partnerId: 'FIADO', partnerName: 'Fiado' },
+    };
+    const list: ChargeListResponse = { items: [record] };
+    const q: ChargesQuery = { partnerId: 'FIADO', month: '2026-10', limit: 10 };
+    const e: ChargesExportQuery = { partnerId: 'FIADO', month: '2026-10' };
+    expect([CHARGES_EXPORT_MAX_ROWS, list.items.length, q.month, e.partnerId]).toEqual([10000, 1, '2026-10', 'FIADO']);
+    expect('source' in record).toBe(false);
+  });
+});

package/_test_/unit/rewards/deliveryMetricsDtos.test.ts

@@ -0,0 +1,25 @@
+import 'reflect-metadata';
+import {
+  DeliveryDimensionEnum, DeliveryTopByEnum, DeliveryTopDimensionEnum, METRICS_TAG_ALLOWLIST, METRICS_TAG_DIMENSION_PATTERN,
+  METRICS_TOP_LIMIT, METRICS_TOP_MAX_VALUES,
+} from '../../../src/rewards';
+import type { DeliveryMetricsPoint, DeliveryTopEntry } from '../../../src/rewards';
+import { CurrencyId } from '../../../src/currency';
+
+describe('contrato de métricas de entregas (D-D3)', () => {
+  it('constantes y enums del spec §4.3/§5.5', () => {
+    expect([METRICS_TOP_LIMIT, METRICS_TOP_MAX_VALUES]).toEqual([10, 200]);
+    expect(METRICS_TAG_ALLOWLIST).toEqual(['campaignId', 'evaluationId']);
+    expect(Object.values(DeliveryDimensionEnum)).toEqual(['ALL', 'PACKAGE', 'CATALOG_ITEM', 'PARTNER', 'SOURCE']);
+    expect(Object.values(DeliveryTopDimensionEnum)).toEqual(['PACKAGE', 'CATALOG_ITEM', 'PARTNER', 'SOURCE']);
+    expect(Object.values(DeliveryTopByEnum)).toEqual(['cost', 'count']);
+  });
+  it.each(['TAG#campaignId', 'TAG#evaluationId'])('acepta %s', (d) => expect(METRICS_TAG_DIMENSION_PATTERN.test(d)).toBe(true));
+  it.each(['TAG#userId', 'TAG#', 'tag#campaignId', 'TAG#campaignId#x'])('rechaza %s', (d) => expect(METRICS_TAG_DIMENSION_PATTERN.test(d)).toBe(false));
+
+  it('formas de punto y top', () => {
+    const p: DeliveryMetricsPoint = { date: '2026-10-08', currency: CurrencyId.MXN, granted: 1, failed: 0, skipped: 0, grantsCompleted: 1, grantsPartial: 0, grantsFailed: 0, costGranted: 10.5 };
+    const t: DeliveryTopEntry = { value: 'FIADO', label: 'Fiado', granted: 1, failed: 0, skipped: 0, cost: [{ amount: 10.5, currency: CurrencyId.MXN }] };
+    expect([p.costGranted, t.cost[0].amount]).toEqual([10.5, 10.5]);
+  });
+});

package/_test_/unit/rewards/grantBackofficeDtos.test.ts

@@ -0,0 +1,30 @@
+import 'reflect-metadata';
+import { GRANTS_DEFAULT_RANGE_DAYS, GRANTS_EXPORT_MAX_ROWS, GRANTS_MAX_RANGE_DAYS } from '../../../src/rewards';
+import { CurrencyId } from '../../../src/currency';
+import type { BackofficeGrantResponse, GrantListQuery, GrantListResponse } from '../../../src/rewards';
+import { GrantItemStatusEnum, GrantStatusEnum, ItemErrorCategoryEnum, RewardStatusEnum } from '../../../src/rewards';
+
+describe('contrato de entregas de backoffice (Fase 4)', () => {
+  it('expone los límites del spec §6', () => {
+    expect([GRANTS_MAX_RANGE_DAYS, GRANTS_DEFAULT_RANGE_DAYS, GRANTS_EXPORT_MAX_ROWS]).toEqual([92, 7, 5000]);
+  });
+
+  it('BackofficeGrantResponse extiende GrantResponse con name por ítem y message por intento', () => {
+    const grant: BackofficeGrantResponse = {
+      id: 'g1', directoryId: 'd1', packageId: 'p1', packageVersion: 1, packageName: 'Paquete',
+      source: { service: 'rewards-eligibility', reference: 'run-1' }, status: GrantStatusEnum.PARTIAL, createdAt: 1, updatedAt: 2,
+      items: [{
+        itemKey: 'a', catalogItemId: 'c', name: 'Recarga', status: GrantItemStatusEnum.FAILED,
+        chargeTo: { partnerId: 'FIADO', partnerName: 'Fiado' }, cost: { amount: 10, currency: CurrencyId.MXN }, attemptCount: 1,
+        attempts: [{ attempt: 1, startedAt: 1, finishedAt: 2, errorCategory: ItemErrorCategoryEnum.PROVIDER_REJECTED, message: 'El proveedor rechazó la operación' }],
+      }],
+    };
+    expect(grant.items[0].attempts[0].message).toContain('proveedor');
+  });
+
+  it('GrantListQuery admite los filtros nuevos D-F1', () => {
+    const q: GrantListQuery = { status: 'PARTIAL,FAILED', catalogItemId: 'reward-a', errorCategory: ItemErrorCategoryEnum.INTERNAL_ERROR, search: 'abc', limit: 20 };
+    const res: GrantListResponse = { items: [] };
+    expect([q.catalogItemId, res.items.length, RewardStatusEnum.ACTIVE]).toEqual(['reward-a', 0, 'ACTIVE']);
+  });
+});

package/_test_/unit/rewards/partnerDtos.test.ts

@@ -0,0 +1,47 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import type { JsonValue } from '../../../src/common';
+import { CatalogItemRequest, PartnerRequest, RewardChargeToInput } from '../../../src/rewards';
+
+const partner = { id: 'telcel-mx', name: 'Telcel México', status: 'ACTIVE' };
+const asPartner = (o: Record<string, JsonValue> = {}): PartnerRequest =>
+  plainToInstance(PartnerRequest, { ...partner, ...o }, { excludeExtraneousValues: true });
+const props = async (dto: object): Promise<string[]> => (await validate(dto)).map((e) => e.property);
+
+describe('PartnerRequest', () => {
+  it('valida un aliado correcto', async () => {
+    expect(await validate(asPartner())).toHaveLength(0);
+  });
+
+  it.each<[string, Record<string, JsonValue>, string]>([
+    ['id con espacios', { id: 'con espacio' }, 'id'],
+    ['id con #', { id: 'a#b' }, 'id'],
+    ['id vacío', { id: '' }, 'id'],
+    ['id de 65 caracteres', { id: 'x'.repeat(65) }, 'id'],
+    ['name vacío', { name: '' }, 'name'],
+    ['name > 120', { name: 'x'.repeat(121) }, 'name'],
+    ['status desconocido', { status: 'BORRADO' }, 'status'],
+  ])('rechaza %s', async (_label, override, property) => {
+    expect(await props(asPartner(override))).toContain(property);
+  });
+});
+
+describe('RewardChargeToInput (D-A2: el operador ya no escribe partnerName)', () => {
+  it('solo expone partnerId y descarta partnerName del cliente', () => {
+    const dto = plainToInstance(RewardChargeToInput, { partnerId: 'telcel-mx', partnerName: 'Falso' }, { excludeExtraneousValues: true });
+    expect(dto).toEqual({ partnerId: 'telcel-mx' });
+  });
+
+  it('CatalogItemRequest valida sin partnerName', async () => {
+    const dto = plainToInstance(
+      CatalogItemRequest,
+      {
+        id: 'r-a', name: 'A', description: 'd', type: 'T', config: {}, cost: { amount: 1, currency: 'MXN' },
+        chargeTo: { partnerId: 'FIADO' }, status: 'ACTIVE',
+      },
+      { excludeExtraneousValues: true },
+    );
+    expect(await validate(dto)).toHaveLength(0);
+  });
+});

package/bin/rewards/constants/BackofficeLimits.d.ts

@@ -4,3 +4,16 @@ export declare const REWARD_ITEM_KEY_PATTERN: RegExp;
 export declare const REWARD_ID_PATTERN: RegExp;
 /** 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 declare const REWARD_PACKAGE_MAX_ITEMS = 4;
+/** Entregas de backoffice (Fase 4): ventana máxima del listado, default y tope del CSV. */
+export declare const GRANTS_MAX_RANGE_DAYS = 92;
+export declare const GRANTS_DEFAULT_RANGE_DAYS = 7;
+export declare const GRANTS_EXPORT_MAX_ROWS = 5000;
+/** Cierre mensual por aliado (D-C1): tope del CSV y formato de `month` (UTC). */
+export declare const CHARGES_EXPORT_MAX_ROWS = 10000;
+export declare const CHARGES_MONTH_PATTERN: RegExp;
+/** Métricas de entregas (D-D3): top de 10, máximo 200 valores por dimensión, y etiquetas permitidas. */
+export declare const METRICS_TOP_LIMIT = 10;
+export declare const METRICS_TOP_MAX_VALUES = 200;
+/** Etiquetas permitidas en métricas (D-D3b): una llave libre tendría cardinalidad ilimitada. */
+export declare const METRICS_TAG_ALLOWLIST: readonly string[];
+export declare const METRICS_TAG_DIMENSION_PATTERN: RegExp;

package/bin/rewards/constants/BackofficeLimits.js

@@ -1,9 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.REWARD_PACKAGE_MAX_ITEMS = exports.REWARD_ID_PATTERN = exports.REWARD_ITEM_KEY_PATTERN = exports.REWARD_ITEM_KEY_MAX_LENGTH = void 0;
+exports.METRICS_TAG_DIMENSION_PATTERN = exports.METRICS_TAG_ALLOWLIST = exports.METRICS_TOP_MAX_VALUES = exports.METRICS_TOP_LIMIT = exports.CHARGES_MONTH_PATTERN = exports.CHARGES_EXPORT_MAX_ROWS = exports.GRANTS_EXPORT_MAX_ROWS = exports.GRANTS_DEFAULT_RANGE_DAYS = exports.GRANTS_MAX_RANGE_DAYS = exports.REWARD_PACKAGE_MAX_ITEMS = exports.REWARD_ID_PATTERN = exports.REWARD_ITEM_KEY_PATTERN = exports.REWARD_ITEM_KEY_MAX_LENGTH = void 0;
 /** Máximo del `itemKey` de un paquete: `RW-{grantId(32)}-{itemKey}` ≤ 64 (igual que REWARDS_MAX_ITEM_KEY_LENGTH de api-invoker). */
 exports.REWARD_ITEM_KEY_MAX_LENGTH = 28;
 exports.REWARD_ITEM_KEY_PATTERN = new RegExp(`^[A-Za-z0-9_-]{1,${exports.REWARD_ITEM_KEY_MAX_LENGTH}}$`);
 exports.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. */
 exports.REWARD_PACKAGE_MAX_ITEMS = 4;
+/** Entregas de backoffice (Fase 4): ventana máxima del listado, default y tope del CSV. */
+exports.GRANTS_MAX_RANGE_DAYS = 92;
+exports.GRANTS_DEFAULT_RANGE_DAYS = 7;
+exports.GRANTS_EXPORT_MAX_ROWS = 5000;
+/** Cierre mensual por aliado (D-C1): tope del CSV y formato de `month` (UTC). */
+exports.CHARGES_EXPORT_MAX_ROWS = 10000;
+exports.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. */
+exports.METRICS_TOP_LIMIT = 10;
+exports.METRICS_TOP_MAX_VALUES = 200;
+/** Etiquetas permitidas en métricas (D-D3b): una llave libre tendría cardinalidad ilimitada. */
+exports.METRICS_TAG_ALLOWLIST = ['campaignId', 'evaluationId'];
+exports.METRICS_TAG_DIMENSION_PATTERN = /^TAG#(campaignId|evaluationId)$/;

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

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

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackofficeGrantAttemptResponse = void 0;
+const GrantAttemptResponse_1 = require("../responses/GrantAttemptResponse");
+class BackofficeGrantAttemptResponse extends GrantAttemptResponse_1.GrantAttemptResponse {
+}
+exports.BackofficeGrantAttemptResponse = BackofficeGrantAttemptResponse;

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

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

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackofficeGrantItemResponse = void 0;
+const GrantItemResponse_1 = require("../responses/GrantItemResponse");
+class BackofficeGrantItemResponse extends GrantItemResponse_1.GrantItemResponse {
+}
+exports.BackofficeGrantItemResponse = BackofficeGrantItemResponse;

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

@@ -0,0 +1,7 @@
+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 declare class BackofficeGrantResponse extends GrantResponse {
+    packageName?: string;
+    items: BackofficeGrantItemResponse[];
+}

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

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackofficeGrantResponse = void 0;
+const GrantResponse_1 = require("../responses/GrantResponse");
+/** Sin `directoryName`: Directory no trae un campo de nombre confiable (Q2). Sin `requestSnapshot`/`providerResponse` (R2). */
+class BackofficeGrantResponse extends GrantResponse_1.GrantResponse {
+}
+exports.BackofficeGrantResponse = BackofficeGrantResponse;

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

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

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

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

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

@@ -0,0 +1,17 @@
+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 declare 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/bin/rewards/dtos/backoffice/ChargeRecord.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChargeRecord = void 0;
+/** 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). */
+class ChargeRecord {
+}
+exports.ChargeRecord = ChargeRecord;

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

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

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChargesExportQuery = void 0;
+/** Query params ya validados de `GET /charges/export`. `month` = `AAAA-MM` UTC. */
+class ChargesExportQuery {
+}
+exports.ChargesExportQuery = ChargesExportQuery;

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

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

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChargesQuery = void 0;
+/** Query params ya validados de `GET /charges`. `month` = `AAAA-MM` UTC. */
+class ChargesQuery {
+}
+exports.ChargesQuery = ChargesQuery;

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

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

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveryMetricsPoint = void 0;
+/** Un punto de la serie diaria. `date` = `AAAA-MM-DD` UTC. `costGranted` = `costGrantedMinor / 100` (nunca se suman monedas distintas). */
+class DeliveryMetricsPoint {
+}
+exports.DeliveryMetricsPoint = DeliveryMetricsPoint;

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

@@ -0,0 +1,9 @@
+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 declare class DeliveryMetricsQuery {
+    dimension: string;
+    value?: string;
+    from: string;
+    to: string;
+    currency?: CurrencyId;
+}

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveryMetricsQuery = void 0;
+/** Query params ya validados de `GET /metrics/deliveries`. `dimension` es un `DeliveryDimensionEnum` o `TAG#campaignId|TAG#evaluationId`. `from`/`to` = `AAAA-MM-DD` UTC. */
+class DeliveryMetricsQuery {
+}
+exports.DeliveryMetricsQuery = DeliveryMetricsQuery;

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.519.0",
+  "version": "3.520.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

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';