@fiado/type-kit 3.519.0 → 3.521.0

package/_test_/unit/mdm/dtos/mdmDeviceContract.test.ts

@@ -62,6 +62,28 @@ describe('DeviceEnrollRequest.lockMode', () => {
     });
 });
 
+describe('DeviceEnrollRequest.firstLockAt', () => {
+    it('valida sin firstLockAt: el consumidor de hoy no se rompe', async () => {
+        const dto = plainToInstance(DeviceEnrollRequest, validEnroll);
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+        expect(dto.firstLockAt).toBeUndefined();
+    });
+
+    it('valida con firstLockAt en ISO-8601', async () => {
+        const dto = plainToInstance(DeviceEnrollRequest, { ...validEnroll, firstLockAt: '2026-11-08T06:00:00.000Z' });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+        expect(dto.firstLockAt).toBe('2026-11-08T06:00:00.000Z');
+    });
+
+    it('falla si firstLockAt no es ISO-8601', async () => {
+        const dto = plainToInstance(DeviceEnrollRequest, { ...validEnroll, firstLockAt: '08/11/2026' });
+        const errors = await validate(dto);
+        expect(hasConstraint(errors, 'firstLockAt', 'isIso8601')).toBe(true);
+    });
+});
+
 describe('DeviceUnlockRequest.unlockUntil', () => {
     it('valida sin unlockUntil: el consumidor de hoy no se rompe', async () => {
         const dto = plainToInstance(DeviceUnlockRequest, validUnlock);

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/_test_/unit/rewardsEligibility/metricsDtos.test.ts

@@ -1,5 +1,5 @@
 import { MetricsDimensionEnum } from '../../../src/rewardsEligibility/enums/MetricsDimensionEnum';
-import type { FailedConditionStatResponse } from '../../../src/rewardsEligibility/dtos/backoffice/FailedConditionStatResponse';
+import type { FailedConditionEvaluationResponse, FailedConditionStatResponse } from '../../../src/rewardsEligibility';
 import type { MetricsPointResponse } from '../../../src/rewardsEligibility/dtos/backoffice/MetricsPointResponse';
 import type { MetricsQuery } from '../../../src/rewardsEligibility/dtos/backoffice/MetricsQuery';
 
@@ -9,9 +9,15 @@ describe('DTOs de métricas (forma)', () => {
         expect(Object.keys(point)).toHaveLength(10);
     });
     it('ranking y query', () => {
-        const stat: FailedConditionStatResponse = { key: 'directory.accountAgeDays', label: 'Antigüedad de la cuenta', count: 7 };
+        const stat: FailedConditionStatResponse = { key: 'directory.accountAgeDays', label: 'Antigüedad de la cuenta', count: 7, evaluations: [] };
         const query: MetricsQuery = { dimension: MetricsDimensionEnum.CAMPAIGN, value: 'referidos-q4', from: '2026-10-01', to: '2026-10-08' };
         expect(stat.count).toBe(7);
         expect(query.dimension).toBe('CAMPAIGN');
     });
+
+    it('FailedConditionStatResponse trae evaluations ordenables por count (D-E1)', () => {
+        const evaluation: FailedConditionEvaluationResponse = { evaluationId: 'ev-1', evaluationName: 'Referidos', count: 7 };
+        const stat: FailedConditionStatResponse = { key: 'payments.amount', label: 'Monto', count: 9, evaluations: [evaluation] };
+        expect(stat.evaluations[0]).toEqual({ evaluationId: 'ev-1', evaluationName: 'Referidos', count: 7 });
+    });
 });

package/bin/mdm/dtos/DeviceEnrollRequest.d.ts

@@ -8,5 +8,7 @@ export declare class DeviceEnrollRequest {
     termMonths: number;
     /** Cuándo se dispara el bloqueo del equipo; si se omite es ONDEMAND, que es el modo de hoy. */
     lockMode?: MdmLockModeEnum;
+    /** ISO-8601 del primer bloqueo programado (primer vencimiento); lo usan proveedores que agendan el bloqueo al enrolar. */
+    firstLockAt?: string;
     operationReference: string;
 }

package/bin/mdm/dtos/DeviceEnrollRequest.js

@@ -58,6 +58,12 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", String)
 ], DeviceEnrollRequest.prototype, "lockMode", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsISO8601)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], DeviceEnrollRequest.prototype, "firstLockAt", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

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