@fiado/type-kit 3.508.0 → 3.510.0

package/src/dynamicForm/dtos/InputField.ts

@@ -0,0 +1,16 @@
+import { InputFieldTypeEnum } from "../enums/InputFieldTypeEnum";
+import { SelectOption } from "./SelectOption";
+
+export class InputField {
+    key: string;
+    type: InputFieldTypeEnum;
+    label: string;
+    required: boolean;
+    placeholder?: string;
+    helpImage?: string;
+    showHelp?: boolean;
+    options?: SelectOption[];
+    dependsOn?: string;
+    /** Endpoint del que salen las opciones (SELECT ampliado y ENTITY_REF). */
+    optionsSource?: string;
+}

package/src/dynamicForm/dtos/InputSchema.ts

@@ -0,0 +1,7 @@
+import { InputField } from "./InputField";
+import { InputValidation } from "./InputValidation";
+
+export class InputSchema {
+    fields: InputField[];
+    validations?: Record<string, InputValidation>;
+}

package/src/dynamicForm/dtos/InputValidation.ts

@@ -0,0 +1,8 @@
+export class InputValidation {
+    pattern?: string;
+    maxLength?: number;
+    minLength?: number;
+    min?: number;
+    max?: number;
+    hasCheckDigit?: boolean;
+}

package/src/dynamicForm/dtos/SelectOption.ts

@@ -0,0 +1,4 @@
+export class SelectOption {
+    value: string;
+    label: string;
+}

package/src/dynamicForm/enums/InputFieldTypeEnum.ts

@@ -0,0 +1,18 @@
+export enum InputFieldTypeEnum {
+    PHONE = "PHONE",
+    BARCODE = "BARCODE",
+    ACCOUNT_NUMBER = "ACCOUNT_NUMBER",
+    TEXT = "TEXT",
+    NUMBER = "NUMBER",
+    MONEY = "MONEY",
+    SELECT = "SELECT",
+    DATE = "DATE",
+    /** Buscador de usuario (nombre, teléfono, correo). Valor: `directoryId`. */
+    DIRECTORY = "DIRECTORY",
+    /** Buscador contra `optionsSource` (ej. ventas). Valor: id de la entidad. */
+    ENTITY_REF = "ENTITY_REF",
+    /** Rango de fechas. Valor: `{from, to}`; cada extremo es fecha ISO o ventana relativa (`7d`, `1M`; spec B §9). */
+    DATE_RANGE = "DATE_RANGE",
+    /** Interruptor. Valor: `true`/`false`. */
+    BOOLEAN = "BOOLEAN",
+}

package/src/dynamicForm/helpers/isDynamicFormValue.ts

@@ -0,0 +1,16 @@
+import { JsonValue } from '../../common/types/JsonValue';
+import { DateRangeValue, DynamicFormValue } from '../types/DynamicFormValue';
+
+export const isPlainObject = (value: JsonValue): value is { [key: string]: JsonValue } =>
+    typeof value === 'object' && value !== null && !Array.isArray(value);
+
+export const isDateRangeValue = (value: JsonValue): value is DateRangeValue => {
+    if (!isPlainObject(value)) return false;
+    return Object.keys(value).length === 2 && typeof value.from === 'string' && typeof value.to === 'string';
+};
+
+export const isDynamicFormValue = (value: JsonValue): value is DynamicFormValue => {
+    if (typeof value === 'string' || typeof value === 'boolean') return true;
+    if (typeof value === 'number') return Number.isFinite(value);
+    return isDateRangeValue(value);
+};

package/src/dynamicForm/index.ts

@@ -0,0 +1,17 @@
+//Enums
+export * from './enums/InputFieldTypeEnum';
+
+//DTOs
+export * from './dtos/SelectOption';
+export * from './dtos/InputValidation';
+export * from './dtos/InputField';
+export * from './dtos/InputSchema';
+
+//Types
+export * from './types/DynamicFormValue';
+
+//Helpers
+export * from './helpers/isDynamicFormValue';
+
+//Validators
+export * from './validators/IsDynamicFormValues';

package/src/dynamicForm/types/DynamicFormValue.ts

@@ -0,0 +1,8 @@
+/**
+ * Valor de un campo `DATE_RANGE`: `{from, to}`. `from`/`to` son fechas ISO o una ventana relativa
+ * (`7d`, `1M`; spec B §9) que el consumidor resuelve contra «ahora».
+ */
+export type DateRangeValue = { from: string; to: string };
+
+/** Lo que puede valer una entrada de un formulario dinámico. */
+export type DynamicFormValue = string | number | boolean | DateRangeValue;

package/src/dynamicForm/validators/IsDynamicFormValues.ts

@@ -0,0 +1,16 @@
+import { ValidationArguments, ValidatorConstraint, ValidatorConstraintInterface } from 'class-validator';
+import { JsonValue } from '../../common/types/JsonValue';
+import { isDynamicFormValue, isPlainObject } from '../helpers/isDynamicFormValue';
+
+/** Valida un mapa `clave → DynamicFormValue` (string | number | boolean | {from, to}). */
+@ValidatorConstraint({ name: 'IsDynamicFormValues', async: false })
+export class IsDynamicFormValues implements ValidatorConstraintInterface {
+    validate(value: JsonValue, _args: ValidationArguments): boolean {
+        if (!isPlainObject(value)) return false;
+        return Object.values(value).every(isDynamicFormValue);
+    }
+
+    defaultMessage(_args: ValidationArguments): string {
+        return 'inputs debe ser un mapa clave → string | number | boolean | {from, to}';
+    }
+}

package/src/index.ts

@@ -193,3 +193,17 @@ export * as RetailLoan from './retailLoan';
 export * as MoneyTransfer from './moneyTransfer';
 // FileStorage: contrato de fiado-s3-lambda (documentos de usuario en S3). Consumido por api-invoker (IFileStorageApi).
 export * as FileStorage from './fileStorage';
+
+// DynamicForm: formulario dinámico compartido (InputField, InputFieldTypeEnum, SelectOption,
+// InputValidation, InputSchema). Antes vivía en `benefitCenter`, que lo reexporta como alias.
+// Lo usan rewards (dependencies de las recompensas) y rewardsEligibility (inputs, fields, params).
+export * as DynamicForm from './dynamicForm';
+
+// Rewards: contrato entre rewards-business (entrega paquetes de recompensas) y sus llamadores
+// (rewards-eligibility-business): mensajes GRANT_REQUESTED / GRANT_FAILED de las colas compartidas
+// y respuestas de las lecturas privadas GET /packages/{id} y GET /grants/{id}.
+export * as Rewards from './rewards';
+
+// RewardsEligibility: contrato del validador de elegibilidad (rewards-eligibility-business) hacia los
+// servicios emisores: POST /events (request/response) y GET /runs/{id}.
+export * as RewardsEligibility from './rewardsEligibility';

package/src/platformRbac/dtos/RoleAssignmentsByScopeRefsRequest.ts

@@ -0,0 +1,12 @@
+import { ArrayMaxSize, IsArray, IsString } from "class-validator";
+
+// Tope de scopeRefs por request del endpoint batch de asignaciones por destino.
+export const ROLE_ASSIGNMENTS_BY_SCOPE_REFS_MAX_BATCH = 100;
+
+// Body de POST /internal/tenants/{tenantId}/role-assignments/by-scope-refs; la lista vacía responde sin items.
+export class RoleAssignmentsByScopeRefsRequest {
+    @IsArray()
+    @ArrayMaxSize(ROLE_ASSIGNMENTS_BY_SCOPE_REFS_MAX_BATCH)
+    @IsString({ each: true })
+    scopeRefs!: string[];
+}

package/src/platformRbac/dtos/RoleAssignmentsByScopeRefsResponse.ts

@@ -0,0 +1,22 @@
+import type { PermissionScope } from '../enums/PermissionScope';
+import type { ScopeRefLookupStatusEnum } from '../enums/ScopeRefLookupStatusEnum';
+
+// Asignación vigente de un usuario en el destino; `roleId` es la clave del rol y `roleName` su displayName.
+export interface ScopeRefRoleAssignment {
+    cognitoSub: string;
+    roleId: string;
+    roleName: string | null;
+    scope: PermissionScope;
+}
+
+// Asignaciones de un destino; con `UNAVAILABLE` la lista viene vacía y no significa «sin roles».
+export interface ScopeRefRoleAssignments {
+    scopeRef: string;
+    status: ScopeRefLookupStatusEnum;
+    assignments: ScopeRefRoleAssignment[];
+}
+
+// Respuesta de POST /internal/tenants/{tenantId}/role-assignments/by-scope-refs; un item por scopeRef pedido.
+export interface RoleAssignmentsByScopeRefsResponse {
+    items: ScopeRefRoleAssignments[];
+}

package/src/platformRbac/enums/ScopeRefLookupStatusEnum.ts

@@ -0,0 +1,5 @@
+/** Si la lectura de asignaciones de un destino contestó (`OK`) o falló (`UNAVAILABLE`). */
+export enum ScopeRefLookupStatusEnum {
+    OK = 'OK',
+    UNAVAILABLE = 'UNAVAILABLE',
+}

package/src/platformRbac/index.ts

@@ -184,6 +184,15 @@ export type { RevokeTenantRoleResponse } from './dtos/RevokeTenantRoleResponse';
 export * from './dtos/TenantUsersBySubsRequest';
 export type { TenantUserBySubItem, TenantUsersBySubsResponse } from './dtos/TenantUsersBySubsResponse';
 
+// Batch privado de asignaciones de rol por destino (scopeRef), para la tabla de Vendedores.
+export * from './dtos/RoleAssignmentsByScopeRefsRequest';
+export * from './enums/ScopeRefLookupStatusEnum';
+export type {
+    ScopeRefRoleAssignment,
+    ScopeRefRoleAssignments,
+    RoleAssignmentsByScopeRefsResponse,
+} from './dtos/RoleAssignmentsByScopeRefsResponse';
+
 // Usuarios de API: login por Bearer, alta, rotación de secreto y diagnóstico del W5.
 export * from './apiUser/ApiLoginRequest';
 export * from './apiUser/ApiLoginResponse';

package/src/retailOrg/dtos/validation/PrivateSellerListResponse.ts

@@ -4,7 +4,7 @@ import type { RetailUserStatusEnum } from '../../enums/RetailUserStatusEnum';
  * Shape mínimo de un vendedor para el motor de comisiones (F3b): a quién pagarle, de qué tienda es y
  * en qué tier va.
  *
- * **Sin PII** — nada de teléfono ni `cognitoSub`. `displayName` es el rótulo de conveniencia con el
+ * **Sin PII** — el teléfono solo viaja a pedido. `displayName` es el rótulo de conveniencia con el
  * que el motor arma su reporte de devengo; no es identidad (la identidad vive en RBAC).
  *
  * `commissionTier` no es adorno: es lo que el motor usa para resolver CUÁNTO le toca a cada vendedor
@@ -18,6 +18,10 @@ export interface PrivateSellerDto {
     status: RetailUserStatusEnum;
     /** Teléfono del vendedor. Solo viaja si se pidió `includePhone=true`; `null` si no lo tiene. */
     phone?: string | null;
+    /** Cuenta del vendedor en RBAC; `null` si todavía no tiene usuario. */
+    cognitoSub?: string | null;
+    /** Alta del vendedor en el padrón (ISO); `null` si la fila no la trae. */
+    createdAt?: string | null;
 }
 
 /**

package/src/retailWizard/dtos/responses/BackofficeSellerTableResponse.ts

@@ -1,6 +1,12 @@
 import type { RetailUserStatusEnum } from '../../../retailOrg/enums/RetailUserStatusEnum';
 import type { SellerTableSourceStatusEnum } from '../../enums/SellerTableSourceStatusEnum';
 
+/** Rol del vendedor en RBAC: `key` es el `roleId` y `name` su nombre legible. */
+export interface SellerTableRole {
+    key: string;
+    name: string;
+}
+
 /** Una fila de la tabla de Vendedores: padrón + ventas de la ventana + meta + comisión. */
 export interface SellerTableRow {
     retailUserId: string;
@@ -12,15 +18,25 @@ export interface SellerTableRow {
     storeId: string | null;
     storeName: string | null;
     zoneName: string | null;
-    /** Es el encargado (`managerRetailUserId`) de su tienda. */
+    /** Tiene el rol `store_manager`; si RBAC cae, es el encargado (`managerRetailUserId`) de su tienda. */
     isStoreAdmin: boolean;
+    /** Roles de RBAC en la cadena, sus zonas y tiendas; `null` si RBAC no contestó, `[]` sin cuenta o sin roles. */
+    roles: SellerTableRole[] | null;
+    /** Correo de su cuenta de RBAC; `null` sin cuenta, sin correo o con RBAC caído. */
+    email: string | null;
     /** Sin ventas en la ventana viaja `0`: el barrido es exhaustivo. */
     salesCount: number;
     placedCents: number;
     averageTicketCents: number | null;
     lastSaleAt: string | null;
-    /** Δ % contra la misma ventana 7 días antes; `null` si la ventana pasa de 7 días o no hubo base. */
+    /** Clientes distintos de la ventana, sin canceladas; `null` si los totales vinieron del lake. */
+    customersServed: number | null;
+    /** Alta del vendedor en el padrón (ISO); `null` si no está en el padrón. */
+    memberSince: string | null;
+    /** Δ % de los últimos 7 días (al cierre de la ventana) contra los 7 anteriores; `null` si la semana base vendió 0. */
     weekOverWeekChangePct: number | null;
+    /** Colocación de las últimas 8 semanas, de la más vieja a la actual; `null` sin lake. */
+    weeklyPlacedCents: number[] | null;
     /**
      * Meta mensual (`monthCents` del mes de `to`, hora de CDMX) escalada a los días de la ventana:
      * `round(monthCents * días / 30)`. `null` sin meta, con metas caídas o con ventana > 90 días.
@@ -37,6 +53,10 @@ export interface SellerTableSources {
     roster: SellerTableSourceStatusEnum;
     goals: SellerTableSourceStatusEnum;
     commission: SellerTableSourceStatusEnum;
+    /** Roles y correo. */
+    rbac: SellerTableSourceStatusEnum;
+    /** «Todo» y la tendencia de 8 semanas; `DISABLED` con el flag del lake apagado. */
+    lake: SellerTableSourceStatusEnum;
 }
 
 /** Corte semanal del que sale `commissionCents`; días locales `YYYY-MM-DD`, ambos incluidos. */

package/src/retailWizard/enums/SellerTableSourceStatusEnum.ts

@@ -1,5 +1,6 @@
-/** Si una fuente de la tabla de Vendedores contestó (`OK`) o falló (`UNAVAILABLE`). */
+/** Si una fuente de la tabla contestó (`OK`), falló (`UNAVAILABLE`) o está apagada por flag (`DISABLED`). */
 export enum SellerTableSourceStatusEnum {
     OK = 'OK',
     UNAVAILABLE = 'UNAVAILABLE',
+    DISABLED = 'DISABLED',
 }

package/src/rewards/constants/RewardsLimits.ts

@@ -0,0 +1,2 @@
+/** Máximo de llaves en `source.tags` (spec A 5.3). */
+export const REWARD_TAGS_MAX_KEYS = 10;

package/src/rewards/dtos/GrantFailedMessage.ts

@@ -0,0 +1,29 @@
+import { Expose } from 'class-transformer';
+import { Equals, IsEnum, IsNotEmpty, IsString } from 'class-validator';
+import { GrantFailedReasonEnum } from '../enums/GrantFailedReasonEnum';
+import { RewardsMessageTypeEnum } from '../enums/RewardsMessageTypeEnum';
+
+/**
+ * Aviso de que una entrega terminó SIN ningún ítem entregado (`FAILED` o `REJECTED`). Lo publica
+ * rewards-business en la cola registrada para `source.service` (spec A 6.5) para que el llamador
+ * libere lo que reservó. Una entrega `PARTIAL` no avisa. Es idempotente en el destino.
+ */
+export class GrantFailedMessage {
+    @Expose()
+    @Equals(RewardsMessageTypeEnum.GRANT_FAILED)
+    messageType!: RewardsMessageTypeEnum.GRANT_FAILED;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    idempotencyKey!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    grantId!: string;
+
+    @Expose()
+    @IsEnum(GrantFailedReasonEnum)
+    reason!: GrantFailedReasonEnum;
+}

package/src/rewards/dtos/GrantRequestedMessage.ts

@@ -0,0 +1,46 @@
+import { Expose, Type } from 'class-transformer';
+import { Equals, IsNotEmpty, IsString, Validate, ValidateNested } from 'class-validator';
+import { RewardsMessageTypeEnum } from '../enums/RewardsMessageTypeEnum';
+import { RewardInputs } from '../types/RewardInputs';
+import { IsRewardInputs } from '../validators/IsRewardInputs';
+import { RewardSource } from './RewardSource';
+
+/**
+ * Pedido de entrega de un paquete, publicado en `RewardsGrantQueue` (spec A 6.1). Que la
+ * publicación funcione es la aceptación del pedido. El `grantId` NO viaja: el llamador lo calcula
+ * con `grantIdFor(source.service, idempotencyKey)` de `@fiado/api-invoker`.
+ *
+ * Parseo en el consumidor: `plainToInstance(GrantRequestedMessage, raw, { excludeExtraneousValues: true })`.
+ */
+export class GrantRequestedMessage {
+    @Expose()
+    @Equals(RewardsMessageTypeEnum.GRANT_REQUESTED)
+    messageType!: RewardsMessageTypeEnum.GRANT_REQUESTED;
+
+    /** Beneficiario de la recompensa. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    directoryId!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    packageId!: string;
+
+    @Expose()
+    @ValidateNested()
+    @Type(() => RewardSource)
+    source!: RewardSource;
+
+    /** Ej. `elig:{evaluationId}:{beneficiaryDirectoryId}:{grantKey}:r{n}`. Con `source.service` da el `grantId`. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    idempotencyKey!: string;
+
+    /** `itemKey → inputKey → valor`. */
+    @Expose()
+    @Validate(IsRewardInputs)
+    inputs!: RewardInputs;
+}

package/src/rewards/dtos/RewardChargeTo.ts

@@ -0,0 +1,5 @@
+/** A quién se le cobra la recompensa (spec A D8). */
+export class RewardChargeTo {
+    partnerId: string;
+    partnerName: string;
+}

package/src/rewards/dtos/RewardCost.ts

@@ -0,0 +1,7 @@
+import { CurrencyId } from '../../currency';
+
+/** Costo declarado de una recompensa (spec A 5.1). Un paquete puede mezclar monedas: se reporta por moneda. */
+export class RewardCost {
+    amount: number;
+    currency: CurrencyId;
+}

package/src/rewards/dtos/RewardDependency.ts

@@ -0,0 +1,18 @@
+import { InputField } from '../../dynamicForm/dtos/InputField';
+import { DependencyIfMissingEnum } from '../enums/DependencyIfMissingEnum';
+
+/**
+ * Una dependencia de una recompensa: lo que quien consume debe enviar para poder entregarla.
+ * Adopta la forma de `InputField` (formulario dinámico compartido) y suma los campos propios
+ * de rewards (spec A 5.1).
+ */
+export class RewardDependency extends InputField {
+    /** Condición que la vuelve necesaria (sobre otras dependencias), si aplica. */
+    requiredWhen?: string;
+    /** Qué pasa si falta cuando se necesitaba. Por defecto, REJECT. */
+    ifMissing?: DependencyIfMissingEnum;
+    /** De dónde la saca el lambda solo cuando no se envía. */
+    resolvedFrom?: string;
+    /** Texto corto para quien consume. */
+    description?: string;
+}

package/src/rewards/dtos/RewardSource.ts

@@ -0,0 +1,27 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString, Validate } from 'class-validator';
+import { IsRewardTags } from '../validators/IsRewardTags';
+
+/**
+ * Quién pide la entrega. El lambda no interpreta `reference` ni `tags`: los guarda y los usa como
+ * filtro/auditoría (spec A D1, D10).
+ */
+export class RewardSource {
+    /** Servicio llamador (ej. `rewards-eligibility`). Entra en el `grantId`. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    service!: string;
+
+    /** Referencia opaca del llamador (ej. `runId`). */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    reference!: string;
+
+    /** Etiquetas opacas (ej. `campaignId`, `evaluationId`). Máx. 10 llaves. */
+    @Expose()
+    @IsOptional()
+    @Validate(IsRewardTags)
+    tags?: Record<string, string>;
+}

package/src/rewards/dtos/responses/GrantAttemptResponse.ts

@@ -0,0 +1,16 @@
+import { ItemErrorCategoryEnum } from '../../enums/ItemErrorCategoryEnum';
+
+/**
+ * Un intento de ejecutar un ítem. Sin `providerResponse`, `requestSnapshot` ni `correlationIds`:
+ * contienen PII y solo se leen en el backoffice (spec A R2).
+ */
+export class GrantAttemptResponse {
+    attempt: number;
+    /** Epoch en milisegundos. */
+    startedAt: number;
+    /** Epoch en milisegundos. */
+    finishedAt: number;
+    errorCategory?: ItemErrorCategoryEnum;
+    errorCode?: string;
+    httpStatus?: number;
+}

package/src/rewards/dtos/responses/GrantItemResponse.ts

@@ -0,0 +1,21 @@
+import { GrantItemStatusEnum } from '../../enums/GrantItemStatusEnum';
+import { RewardChargeTo } from '../RewardChargeTo';
+import { RewardCost } from '../RewardCost';
+import { GrantAttemptResponse } from './GrantAttemptResponse';
+
+export class GrantItemResponse {
+    itemKey: string;
+    catalogItemId: string;
+    status: GrantItemStatusEnum;
+    /** Solo si `status` es SKIPPED (ej. `DEPENDENCY_MISSING`, `ITEM_NOT_APPLICABLE`). */
+    skipReason?: string;
+    chargeTo: RewardChargeTo;
+    cost: RewardCost;
+    attemptCount: number;
+    /** Epoch en milisegundos; solo si `status` es GRANTED. */
+    grantedAt?: number;
+    /** Referencias del proveedor (ej. `{ transactionNumber }`). */
+    externalRef?: Record<string, string>;
+    /** Últimos intentos (máx. 5). */
+    attempts: GrantAttemptResponse[];
+}

package/src/rewards/dtos/responses/GrantResponse.ts

@@ -0,0 +1,24 @@
+import { GrantRejectReasonEnum } from '../../enums/GrantRejectReasonEnum';
+import { GrantStatusEnum } from '../../enums/GrantStatusEnum';
+import { RewardSource } from '../RewardSource';
+import { GrantItemResponse } from './GrantItemResponse';
+
+/** Respuesta de `GET /grants/{id}`: estado de la entrega y de cada ítem (spec A 6.4). */
+export class GrantResponse {
+    id: string;
+    directoryId: string;
+    packageId: string;
+    /** Versión del paquete congelada al crear la entrega. */
+    packageVersion: number;
+    source: RewardSource;
+    status: GrantStatusEnum;
+    /** Solo si `status` es REJECTED. */
+    rejectReason?: GrantRejectReasonEnum;
+    /** Solo si `rejectReason` es `INPUT_INVALID`: claves de los campos inválidos, `itemKey.inputKey` (spec A §6.2). */
+    invalidFields?: string[];
+    items: GrantItemResponse[];
+    /** Epoch en milisegundos. */
+    createdAt: number;
+    /** Epoch en milisegundos. */
+    updatedAt: number;
+}

package/src/rewards/dtos/responses/PackageContractItem.ts

@@ -0,0 +1,13 @@
+import { RewardCost } from '../RewardCost';
+import { RewardDependency } from '../RewardDependency';
+
+/** Una recompensa dentro del contrato de un paquete (spec A 6.3). */
+export class PackageContractItem {
+    itemKey: string;
+    catalogItemId: string;
+    name: string;
+    description: string;
+    cost: RewardCost;
+    /** Lo que el llamador debe enviar en `inputs[itemKey]`. */
+    dependencies: RewardDependency[];
+}

package/src/rewards/dtos/responses/PackageContractResponse.ts

@@ -0,0 +1,14 @@
+import { RewardStatusEnum } from '../../enums/RewardStatusEnum';
+import { RewardCost } from '../RewardCost';
+import { PackageContractItem } from './PackageContractItem';
+
+/** Respuesta de `GET /packages/{id}`: el contrato de entrada del paquete (spec A 6.3). */
+export class PackageContractResponse {
+    id: string;
+    name: string;
+    status: RewardStatusEnum;
+    version: number;
+    items: PackageContractItem[];
+    /** Costo total declarado del paquete, por moneda (sin conversión). */
+    totalCost: RewardCost[];
+}

package/src/rewards/enums/DependencyIfMissingEnum.ts

@@ -0,0 +1,5 @@
+/** Qué pasa si falta una dependencia que se necesitaba (spec A 5.1). */
+export enum DependencyIfMissingEnum {
+    REJECT = 'REJECT',
+    SKIP = 'SKIP',
+}

package/src/rewards/enums/GrantFailedReasonEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * `reason` de `GRANT_FAILED` (spec A 6.5). Las tres primeras son las de `GrantRejectReasonEnum`
+ * (entrega REJECTED); `ITEMS_FAILED` es una entrega FAILED: ningún ítem se entregó.
+ * Decisión P-2 aprobada.
+ */
+export enum GrantFailedReasonEnum {
+    INPUT_INVALID = 'INPUT_INVALID',
+    PACKAGE_NOT_FOUND = 'PACKAGE_NOT_FOUND',
+    PACKAGE_INACTIVE = 'PACKAGE_INACTIVE',
+    ITEMS_FAILED = 'ITEMS_FAILED',
+}

package/src/rewards/enums/GrantItemStatusEnum.ts

@@ -0,0 +1,6 @@
+export enum GrantItemStatusEnum {
+    PENDING = 'PENDING',
+    GRANTED = 'GRANTED',
+    FAILED = 'FAILED',
+    SKIPPED = 'SKIPPED',
+}

package/src/rewards/enums/GrantRejectReasonEnum.ts

@@ -0,0 +1,6 @@
+/** Por qué una solicitud quedó REJECTED (spec A 6.2). */
+export enum GrantRejectReasonEnum {
+    INPUT_INVALID = 'INPUT_INVALID',
+    PACKAGE_NOT_FOUND = 'PACKAGE_NOT_FOUND',
+    PACKAGE_INACTIVE = 'PACKAGE_INACTIVE',
+}

package/src/rewards/enums/GrantStatusEnum.ts

@@ -0,0 +1,8 @@
+export enum GrantStatusEnum {
+    PENDING = 'PENDING',
+    IN_PROGRESS = 'IN_PROGRESS',
+    COMPLETED = 'COMPLETED',
+    PARTIAL = 'PARTIAL',
+    FAILED = 'FAILED',
+    REJECTED = 'REJECTED',
+}

package/src/rewards/enums/ItemErrorCategoryEnum.ts

@@ -0,0 +1,7 @@
+export enum ItemErrorCategoryEnum {
+    PROVIDER_UNAVAILABLE = 'PROVIDER_UNAVAILABLE',
+    REQUEST_INVALID = 'REQUEST_INVALID',
+    PROVIDER_REJECTED = 'PROVIDER_REJECTED',
+    INPUT_UNRESOLVABLE = 'INPUT_UNRESOLVABLE',
+    INTERNAL_ERROR = 'INTERNAL_ERROR',
+}

package/src/rewards/enums/RewardStatusEnum.ts

@@ -0,0 +1,4 @@
+export enum RewardStatusEnum {
+    ACTIVE = 'ACTIVE',
+    INACTIVE = 'INACTIVE',
+}

package/src/rewards/enums/RewardsErrorCodeEnum.ts

@@ -0,0 +1,5 @@
+/** Códigos de error de las lecturas privadas de rewards-business. */
+export enum RewardsErrorCodeEnum {
+    PACKAGE_NOT_FOUND = 'PACKAGE_NOT_FOUND',
+    GRANT_NOT_FOUND = 'GRANT_NOT_FOUND',
+}

package/src/rewards/enums/RewardsMessageTypeEnum.ts

@@ -0,0 +1,4 @@
+export enum RewardsMessageTypeEnum {
+    GRANT_REQUESTED = 'GRANT_REQUESTED',
+    GRANT_FAILED = 'GRANT_FAILED',
+}

package/src/rewards/index.ts

@@ -0,0 +1,37 @@
+//Enums
+export * from './enums/RewardsMessageTypeEnum';
+export * from './enums/GrantStatusEnum';
+export * from './enums/GrantItemStatusEnum';
+export * from './enums/GrantRejectReasonEnum';
+export * from './enums/GrantFailedReasonEnum';
+export * from './enums/ItemErrorCategoryEnum';
+export * from './enums/RewardStatusEnum';
+export * from './enums/DependencyIfMissingEnum';
+export * from './enums/RewardsErrorCodeEnum';
+
+//Types
+export * from './types/RewardInputs';
+
+//DTOs
+export * from './dtos/RewardCost';
+export * from './dtos/RewardChargeTo';
+export * from './dtos/RewardDependency';
+
+//Constants
+export * from './constants/RewardsLimits';
+
+//Validators
+export * from './validators/IsRewardTags';
+export * from './validators/IsRewardInputs';
+
+//Messages (colas compartidas)
+export * from './dtos/RewardSource';
+export * from './dtos/GrantRequestedMessage';
+export * from './dtos/GrantFailedMessage';
+
+//Responses (lecturas privadas)
+export * from './dtos/responses/PackageContractItem';
+export * from './dtos/responses/PackageContractResponse';
+export * from './dtos/responses/GrantAttemptResponse';
+export * from './dtos/responses/GrantItemResponse';
+export * from './dtos/responses/GrantResponse';

package/src/rewards/types/RewardInputs.ts

@@ -0,0 +1,4 @@
+import { DynamicFormValue } from '../../dynamicForm/types/DynamicFormValue';
+
+/** `inputs` de un pedido de entrega: `itemKey → inputKey → valor` (spec A 6.1). */
+export type RewardInputs = Record<string, Record<string, DynamicFormValue>>;