@fiado/type-kit 3.518.0 → 3.520.0

package/_test_/unit/retailWizard/fixtures/saleWithoutPhone.strict.ts

@@ -0,0 +1,57 @@
+import { SaleTypeEnum } from '../../../../src/retailWizard/enums/SaleTypeEnum';
+import { SaleFinancierEnum } from '../../../../src/retailWizard/enums/SaleFinancierEnum';
+import type { Sale } from '../../../../src/retailWizard/dtos/Sale';
+import type { SaleCompletedV1 } from '../../../../src/retailWizard/events/SaleCompletedV1';
+import type { SaleCompletedV2 } from '../../../../src/retailWizard/events/SaleCompletedV2';
+import type { CommissionSaleInput } from '../../../../src/retailCommission/dtos/CommissionAccrual';
+
+// Venta de contado sin teléfono; el test lo compila con strict, como los consumidores.
+export const saleSku: Sale['sku'] = null;
+
+export const completedV1: SaleCompletedV1 = {
+  saleId: 's-1',
+  folio: 'LG-T001-VTA-abcde-2026W40',
+  retailerId: 'r-1',
+  storeId: 'st-1',
+  retailCustomerId: 'c-1',
+  sku: null,
+  imei: null,
+  amountCents: 35000,
+  type: SaleTypeEnum.CASH,
+  soldAt: '2026-10-08T12:00:00.000Z',
+  occurredAt: '2026-10-08T12:00:00.000Z',
+};
+
+export const completedV2: SaleCompletedV2 = {
+  saleId: 's-1',
+  folio: 'LG-T001-VTA-abcde-2026W40',
+  retailerId: 'r-1',
+  storeId: 'st-1',
+  sellerRetailUserId: 'u-1',
+  retailCustomerId: 'c-1',
+  sku: null,
+  brand: null,
+  imei: null,
+  amountCents: 35000,
+  equipmentPriceCents: null,
+  downPaymentCents: null,
+  creditId: null,
+  type: SaleTypeEnum.CASH,
+  externalProvider: null,
+  soldAt: '2026-10-08T12:00:00.000Z',
+  occurredAt: '2026-10-08T12:00:00.000Z',
+};
+
+export const commissionInput: CommissionSaleInput = {
+  saleId: 's-1',
+  sellerId: 'u-1',
+  retailerId: 'r-1',
+  storeId: 'st-1',
+  sku: null,
+  brand: null,
+  equipmentPriceCents: null,
+  amountCents: 35000,
+  financier: Object.values(SaleFinancierEnum)[0],
+  paymentType: 'CASH',
+  soldAt: '2026-10-08T12:00:00.000Z',
+};

package/_test_/unit/retailWizard/saleWithoutPhone.test.ts

@@ -0,0 +1,46 @@
+import 'reflect-metadata';
+import * as path from 'path';
+import * as ts from 'typescript';
+import {
+  commissionInput,
+  completedV1,
+  completedV2,
+  saleSku,
+} from './fixtures/saleWithoutPhone.strict';
+
+const FIXTURE = path.join(__dirname, 'fixtures', 'saleWithoutPhone.strict.ts');
+
+// Los consumidores compilan con strict; sin strictNullChecks null cabe en string y no prueba nada.
+function strictDiagnostics(): string[] {
+  const program = ts.createProgram([FIXTURE], {
+    strict: true,
+    noEmit: true,
+    skipLibCheck: true,
+    experimentalDecorators: true,
+    emitDecoratorMetadata: true,
+    target: ts.ScriptTarget.ES2020,
+    module: ts.ModuleKind.CommonJS,
+    moduleResolution: ts.ModuleResolutionKind.Node10,
+  });
+  return ts
+    .getPreEmitDiagnostics(program)
+    .filter((d) => d.file?.fileName === FIXTURE)
+    .map((d) => ts.flattenDiagnosticMessageText(d.messageText, '\n'));
+}
+
+describe('venta sin teléfono — sku nullable', () => {
+  it('Sale, SaleCompletedV1/V2 y CommissionSaleInput aceptan sku null en strict', () => {
+    expect(strictDiagnostics()).toEqual([]);
+  });
+
+  it('el payload viaja con sku null', () => {
+    expect(saleSku).toBeNull();
+    expect(completedV2.sku).toBeNull();
+    expect(commissionInput.sku).toBeNull();
+  });
+
+  it('SaleCompletedV1 omite equipmentPriceCents sin equipo', () => {
+    expect(completedV1.sku).toBeNull();
+    expect(completedV1).not.toHaveProperty('equipmentPriceCents');
+  });
+});

package/_test_/unit/retailWizard/saleWithoutPhoneLines.test.ts

@@ -0,0 +1,82 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync, type ValidationError } from 'class-validator';
+import {
+  LinePaymentTypeEnum,
+  RetailCommissionInboundMessage,
+  RetailCommissionInboundMessageTypeEnum,
+  SaleTypeEnum,
+  type WizardLineProduct,
+} from '../../../src/retailWizard';
+import { ItemTypeEnum, ProductCategoryEnum, TrackingModeEnum } from '../../../src/retailCatalog';
+
+function paths(errors: ValidationError[], prefix = ''): string[] {
+  return errors.flatMap((e) => {
+    const p = prefix ? `${prefix}.${e.property}` : e.property;
+    return e.children && e.children.length > 0 ? paths(e.children, p) : [p];
+  });
+}
+
+function errorsOf(payload: object): string[] {
+  return paths(validateSync(plainToInstance(RetailCommissionInboundMessage, payload) as object));
+}
+
+describe('venta sin teléfono — phoneCount en el mensaje a comisiones', () => {
+  const kit = {
+    lineId: 'L1',
+    sku: 'KIT-1',
+    qty: 1,
+    netCents: 349900,
+    itemType: ItemTypeEnum.PRODUCT,
+    category: ProductCategoryEnum.ACCESSORY,
+    tier: null,
+    brand: null,
+    paymentType: LinePaymentTypeEnum.CASH,
+  };
+  const message = (line: object) => ({
+    type: RetailCommissionInboundMessageTypeEnum.SALE_COMPLETED,
+    tenantId: 't',
+    retailerId: 'ret',
+    storeId: 'st',
+    saleId: 'sale-1',
+    sessionId: 'ses-1',
+    sellerRetailUserId: 'seller-1',
+    saleType: SaleTypeEnum.CASH,
+    externalProvider: null,
+    creditId: null,
+    soldAt: '2026-10-08T20:00:00.000Z',
+    occurredAt: '2026-10-08T20:00:00.000Z',
+    lines: [line],
+  });
+
+  it('un mensaje viejo sin phoneCount sigue validando', () => expect(errorsOf(message(kit))).toEqual([]));
+
+  it('acepta phoneCount en 0 y positivo', () => {
+    expect(errorsOf(message({ ...kit, phoneCount: 0 }))).toEqual([]);
+    expect(errorsOf(message({ ...kit, phoneCount: 2 }))).toEqual([]);
+  });
+
+  it('rechaza phoneCount negativo o no entero', () => {
+    expect(errorsOf(message({ ...kit, phoneCount: -1 }))).toEqual(['lines.0.phoneCount']);
+    expect(errorsOf(message({ ...kit, phoneCount: 1.5 }))).toEqual(['lines.0.phoneCount']);
+  });
+});
+
+describe('venta sin teléfono — itemType en la ficha de la línea de sesión', () => {
+  const base: WizardLineProduct = {
+    brand: 'Genérico',
+    model: 'Funda',
+    capacity: null,
+    color: null,
+    imageUrl: null,
+    tier: null,
+    category: ProductCategoryEnum.ACCESSORY,
+    trackingMode: TrackingModeEnum.QUANTITY,
+  };
+
+  it('acepta itemType y también su ausencia', () => {
+    const service: WizardLineProduct = { ...base, itemType: ItemTypeEnum.SERVICE };
+    expect(service.itemType).toBe(ItemTypeEnum.SERVICE);
+    expect(base.itemType).toBeUndefined();
+  });
+});

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/retailCommission/dtos/CommissionAccrual.d.ts

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

package/bin/retailWizard/dtos/Sale.d.ts

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

package/bin/retailWizard/dtos/WizardLineProduct.d.ts

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

package/bin/retailWizard/events/RetailCommissionInboundMessage.d.ts

@@ -21,6 +21,8 @@ export declare class RetailCommissionInboundLine {
     brand: string | null;
     paymentType: LinePaymentTypeEnum;
     role?: WizardLineRoleEnum;
+    /** Teléfonos que trae la línea (kit), congelados al cerrar; ausente en mensajes viejos. */
+    phoneCount?: number;
 }
 /** Venta cerrada o cancelada que el wizard publica en RetailCommissionInboundQueue. */
 export declare class RetailCommissionInboundMessage {

package/bin/retailWizard/events/RetailCommissionInboundMessage.js

@@ -72,6 +72,12 @@ __decorate([
     (0, class_validator_1.IsEnum)(WizardLineRoleEnum_1.WizardLineRoleEnum),
     __metadata("design:type", String)
 ], RetailCommissionInboundLine.prototype, "role", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], RetailCommissionInboundLine.prototype, "phoneCount", void 0);
 /** Venta cerrada o cancelada que el wizard publica en RetailCommissionInboundQueue. */
 class RetailCommissionInboundMessage {
 }

package/bin/retailWizard/events/SaleCompletedV1.d.ts

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

package/bin/retailWizard/events/SaleCompletedV2.d.ts

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

package/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;