@fiado/type-kit 3.509.0 → 3.510.0

package/bin/rewardsEligibility/dtos/RunCounts.d.ts

@@ -0,0 +1,12 @@
+/** Conteos de una corrida (mismos nombres que las métricas, spec B 5.7). */
+export declare class RunCounts {
+    evaluated: number;
+    match: number;
+    noMatch: number;
+    error: number;
+    alreadyGranted: number;
+    quotaExhausted: number;
+    excluded: number;
+    requested: number;
+    requestFailed: number;
+}

package/bin/rewardsEligibility/dtos/RunCounts.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunCounts = void 0;
+/** Conteos de una corrida (mismos nombres que las métricas, spec B 5.7). */
+class RunCounts {
+}
+exports.RunCounts = RunCounts;

package/bin/rewardsEligibility/dtos/RunResultItem.d.ts

@@ -0,0 +1,16 @@
+import { EvaluationOutcomeEnum } from '../enums/EvaluationOutcomeEnum';
+import { GrantRequestStatusEnum } from '../enums/GrantRequestStatusEnum';
+/** Un resultado por sujeto, SIN traza (la traza es del backoffice). Asumido hasta cerrar P-7. */
+export declare class RunResultItem {
+    subjectKey: string;
+    beneficiaryDirectoryId: string;
+    campaignId: string;
+    evaluationId: string;
+    packageId: string;
+    outcome: EvaluationOutcomeEnum;
+    grantStatus: GrantRequestStatusEnum;
+    /** `grantIdFor("rewards-eligibility", idempotencyKey)`; cruza con `GET /grants/{id}` de rewards. */
+    grantId?: string;
+    /** Solo si `outcome` es ERROR. */
+    errorMessage?: string;
+}

package/bin/rewardsEligibility/dtos/RunResultItem.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunResultItem = void 0;
+/** Un resultado por sujeto, SIN traza (la traza es del backoffice). Asumido hasta cerrar P-7. */
+class RunResultItem {
+}
+exports.RunResultItem = RunResultItem;

package/bin/rewardsEligibility/enums/EvaluationOutcomeEnum.d.ts

@@ -0,0 +1,11 @@
+export declare enum EvaluationOutcomeEnum {
+    MATCH = "MATCH",
+    NO_MATCH = "NO_MATCH",
+    ERROR = "ERROR",
+    /** La política de frecuencia lo bloqueó. */
+    ALREADY_GRANTED = "ALREADY_GRANTED",
+    /** Calificó, pero la campaña no tenía cupo. */
+    QUOTA_EXHAUSTED = "QUOTA_EXHAUSTED",
+    /** El operador lo sacó al aprobar. */
+    EXCLUDED = "EXCLUDED"
+}

package/bin/rewardsEligibility/enums/EvaluationOutcomeEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvaluationOutcomeEnum = void 0;
+var EvaluationOutcomeEnum;
+(function (EvaluationOutcomeEnum) {
+    EvaluationOutcomeEnum["MATCH"] = "MATCH";
+    EvaluationOutcomeEnum["NO_MATCH"] = "NO_MATCH";
+    EvaluationOutcomeEnum["ERROR"] = "ERROR";
+    /** La política de frecuencia lo bloqueó. */
+    EvaluationOutcomeEnum["ALREADY_GRANTED"] = "ALREADY_GRANTED";
+    /** Calificó, pero la campaña no tenía cupo. */
+    EvaluationOutcomeEnum["QUOTA_EXHAUSTED"] = "QUOTA_EXHAUSTED";
+    /** El operador lo sacó al aprobar. */
+    EvaluationOutcomeEnum["EXCLUDED"] = "EXCLUDED";
+})(EvaluationOutcomeEnum || (exports.EvaluationOutcomeEnum = EvaluationOutcomeEnum = {}));

package/bin/rewardsEligibility/enums/GrantRequestStatusEnum.d.ts

@@ -0,0 +1,11 @@
+export declare enum GrantRequestStatusEnum {
+    NOT_APPLICABLE = "NOT_APPLICABLE",
+    PENDING_APPROVAL = "PENDING_APPROVAL",
+    /** Reservado, esperando su tramo de publicación. */
+    QUEUED = "QUEUED",
+    /** Publicado en RewardsGrantQueue al instante (en línea). */
+    REQUESTED = "REQUESTED",
+    /** La publicación falló o llegó GRANT_FAILED. */
+    REQUEST_FAILED = "REQUEST_FAILED",
+    CANCELLED = "CANCELLED"
+}

package/bin/rewardsEligibility/enums/GrantRequestStatusEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrantRequestStatusEnum = void 0;
+var GrantRequestStatusEnum;
+(function (GrantRequestStatusEnum) {
+    GrantRequestStatusEnum["NOT_APPLICABLE"] = "NOT_APPLICABLE";
+    GrantRequestStatusEnum["PENDING_APPROVAL"] = "PENDING_APPROVAL";
+    /** Reservado, esperando su tramo de publicación. */
+    GrantRequestStatusEnum["QUEUED"] = "QUEUED";
+    /** Publicado en RewardsGrantQueue al instante (en línea). */
+    GrantRequestStatusEnum["REQUESTED"] = "REQUESTED";
+    /** La publicación falló o llegó GRANT_FAILED. */
+    GrantRequestStatusEnum["REQUEST_FAILED"] = "REQUEST_FAILED";
+    GrantRequestStatusEnum["CANCELLED"] = "CANCELLED";
+})(GrantRequestStatusEnum || (exports.GrantRequestStatusEnum = GrantRequestStatusEnum = {}));

package/bin/rewardsEligibility/enums/RewardsEligibilityErrorCodeEnum.d.ts

@@ -0,0 +1,8 @@
+export declare enum RewardsEligibilityErrorCodeEnum {
+    /** 400: faltan campos obligatorios del evento o tienen tipo inválido. */
+    INPUT_INVALID = "INPUT_INVALID",
+    /** 404: el eventKey no existe o está inactivo. */
+    EVENT_TYPE_NOT_FOUND = "EVENT_TYPE_NOT_FOUND",
+    /** 404: GET /runs/{id} sin corrida. */
+    RUN_NOT_FOUND = "RUN_NOT_FOUND"
+}

package/bin/rewardsEligibility/enums/RewardsEligibilityErrorCodeEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RewardsEligibilityErrorCodeEnum = void 0;
+var RewardsEligibilityErrorCodeEnum;
+(function (RewardsEligibilityErrorCodeEnum) {
+    /** 400: faltan campos obligatorios del evento o tienen tipo inválido. */
+    RewardsEligibilityErrorCodeEnum["INPUT_INVALID"] = "INPUT_INVALID";
+    /** 404: el eventKey no existe o está inactivo. */
+    RewardsEligibilityErrorCodeEnum["EVENT_TYPE_NOT_FOUND"] = "EVENT_TYPE_NOT_FOUND";
+    /** 404: GET /runs/{id} sin corrida. */
+    RewardsEligibilityErrorCodeEnum["RUN_NOT_FOUND"] = "RUN_NOT_FOUND";
+})(RewardsEligibilityErrorCodeEnum || (exports.RewardsEligibilityErrorCodeEnum = RewardsEligibilityErrorCodeEnum = {}));

package/bin/rewardsEligibility/enums/RunModeEnum.d.ts

@@ -0,0 +1,4 @@
+export declare enum RunModeEnum {
+    LIVE = "LIVE",
+    SIMULATION = "SIMULATION"
+}

package/bin/rewardsEligibility/enums/RunModeEnum.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunModeEnum = void 0;
+var RunModeEnum;
+(function (RunModeEnum) {
+    RunModeEnum["LIVE"] = "LIVE";
+    RunModeEnum["SIMULATION"] = "SIMULATION";
+})(RunModeEnum || (exports.RunModeEnum = RunModeEnum = {}));

package/bin/rewardsEligibility/enums/RunStatusEnum.d.ts

@@ -0,0 +1,9 @@
+export declare enum RunStatusEnum {
+    RUNNING = "RUNNING",
+    AWAITING_APPROVAL = "AWAITING_APPROVAL",
+    PUBLISHING = "PUBLISHING",
+    COMPLETED = "COMPLETED",
+    PARTIAL = "PARTIAL",
+    FAILED = "FAILED",
+    REJECTED = "REJECTED"
+}

package/bin/rewardsEligibility/enums/RunStatusEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunStatusEnum = void 0;
+var RunStatusEnum;
+(function (RunStatusEnum) {
+    RunStatusEnum["RUNNING"] = "RUNNING";
+    RunStatusEnum["AWAITING_APPROVAL"] = "AWAITING_APPROVAL";
+    RunStatusEnum["PUBLISHING"] = "PUBLISHING";
+    RunStatusEnum["COMPLETED"] = "COMPLETED";
+    RunStatusEnum["PARTIAL"] = "PARTIAL";
+    RunStatusEnum["FAILED"] = "FAILED";
+    RunStatusEnum["REJECTED"] = "REJECTED";
+})(RunStatusEnum || (exports.RunStatusEnum = RunStatusEnum = {}));

package/bin/rewardsEligibility/enums/TriggerTypeEnum.d.ts

@@ -0,0 +1,5 @@
+export declare enum TriggerTypeEnum {
+    EVENT = "EVENT",
+    MANUAL = "MANUAL",
+    CRON = "CRON"
+}

package/bin/rewardsEligibility/enums/TriggerTypeEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TriggerTypeEnum = void 0;
+var TriggerTypeEnum;
+(function (TriggerTypeEnum) {
+    TriggerTypeEnum["EVENT"] = "EVENT";
+    TriggerTypeEnum["MANUAL"] = "MANUAL";
+    TriggerTypeEnum["CRON"] = "CRON";
+})(TriggerTypeEnum || (exports.TriggerTypeEnum = TriggerTypeEnum = {}));

package/bin/rewardsEligibility/index.d.ts

@@ -0,0 +1,13 @@
+export * from './enums/EvaluationOutcomeEnum';
+export * from './enums/GrantRequestStatusEnum';
+export * from './enums/RunStatusEnum';
+export * from './enums/RunModeEnum';
+export * from './enums/TriggerTypeEnum';
+export * from './enums/RewardsEligibilityErrorCodeEnum';
+export * from './dtos/EventSource';
+export * from './dtos/PostEventRequest';
+export * from './dtos/EventRunResult';
+export * from './dtos/PostEventResponse';
+export * from './dtos/RunCounts';
+export * from './dtos/RunResultItem';
+export * from './dtos/GetRunResponse';

package/bin/rewardsEligibility/index.js

@@ -0,0 +1,31 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+//Enums
+__exportStar(require("./enums/EvaluationOutcomeEnum"), exports);
+__exportStar(require("./enums/GrantRequestStatusEnum"), exports);
+__exportStar(require("./enums/RunStatusEnum"), exports);
+__exportStar(require("./enums/RunModeEnum"), exports);
+__exportStar(require("./enums/TriggerTypeEnum"), exports);
+__exportStar(require("./enums/RewardsEligibilityErrorCodeEnum"), exports);
+//DTOs
+__exportStar(require("./dtos/EventSource"), exports);
+__exportStar(require("./dtos/PostEventRequest"), exports);
+__exportStar(require("./dtos/EventRunResult"), exports);
+__exportStar(require("./dtos/PostEventResponse"), exports);
+__exportStar(require("./dtos/RunCounts"), exports);
+__exportStar(require("./dtos/RunResultItem"), exports);
+__exportStar(require("./dtos/GetRunResponse"), exports);

package/package.json

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

package/src/benefitCenter/dtos/InputField.ts

@@ -1,14 +1,2 @@
-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;
-}
+// Alias (D-E5): el origen vive en `dynamicForm`. No duplicar.
+export { InputField } from '../../dynamicForm/dtos/InputField';

package/src/benefitCenter/dtos/InputSchema.ts

@@ -1,7 +1,2 @@
-import { InputField } from "./InputField";
-import { InputValidation } from "./InputValidation";
-
-export class InputSchema {
-    fields: InputField[];
-    validations?: Record<string, InputValidation>;
-}
+// Alias (D-E5): el origen vive en `dynamicForm`. No duplicar.
+export { InputSchema } from '../../dynamicForm/dtos/InputSchema';

package/src/benefitCenter/dtos/InputValidation.ts

@@ -1,8 +1,2 @@
-export class InputValidation {
-    pattern?: string;
-    maxLength?: number;
-    minLength?: number;
-    min?: number;
-    max?: number;
-    hasCheckDigit?: boolean;
-}
+// Alias (D-E5): el origen vive en `dynamicForm`. No duplicar.
+export { InputValidation } from '../../dynamicForm/dtos/InputValidation';

package/src/benefitCenter/dtos/SelectOption.ts

@@ -1,4 +1,2 @@
-export class SelectOption {
-    value: string;
-    label: string;
-}
+// Alias (D-E5): el origen vive en `dynamicForm`. No duplicar.
+export { SelectOption } from '../../dynamicForm/dtos/SelectOption';

package/src/benefitCenter/enums/InputFieldTypeEnum.ts

@@ -1,10 +1,2 @@
-export enum InputFieldTypeEnum {
-    PHONE = "PHONE",
-    BARCODE = "BARCODE",
-    ACCOUNT_NUMBER = "ACCOUNT_NUMBER",
-    TEXT = "TEXT",
-    NUMBER = "NUMBER",
-    MONEY = "MONEY",
-    SELECT = "SELECT",
-    DATE = "DATE",
-}
+// Alias (D-E5): el origen vive en el dominio compartido `dynamicForm`. No duplicar.
+export { InputFieldTypeEnum } from '../../dynamicForm/enums/InputFieldTypeEnum';

package/src/common/index.ts

@@ -9,4 +9,7 @@ export * from './dtos/ProcessValidationResultDto';
 
 //Enums
 export * from './enums/ProcessValidationEnum';
-export * from './enums/ProcessResultEnum';
+export * from './enums/ProcessResultEnum';
+
+//types
+export * from './types/JsonValue';

package/src/common/types/JsonValue.ts

@@ -0,0 +1,5 @@
+/**
+ * Valor JSON arbitrario, sin `any` ni `unknown`. Tipo de entrada para los validadores de
+ * class-validator que reciben datos no confiables (mensajes de cola, cuerpos HTTP).
+ */
+export type JsonValue = string | number | boolean | null | JsonValue[] | { [key: string]: JsonValue };

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