@fiado/type-kit 3.513.0 → 3.515.0

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

@@ -0,0 +1,6 @@
+import { RewardInputRef } from '../types/RewardInputRef';
+/** Que se pide a rewards-business al calificar: el paquete y sus inputs `itemKey -> inputKey -> valor`. */
+export declare class EvaluationReward {
+    packageId: string;
+    inputs: Record<string, Record<string, RewardInputRef>>;
+}

package/bin/rewardsEligibility/dtos/EvaluationReward.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvaluationReward = void 0;
+/** Que se pide a rewards-business al calificar: el paquete y sus inputs `itemKey -> inputKey -> valor`. */
+class EvaluationReward {
+}
+exports.EvaluationReward = EvaluationReward;

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

@@ -0,0 +1,14 @@
+import { ApprovalModeEnum } from '../enums/ApprovalModeEnum';
+import { TriggerTypeEnum } from '../enums/TriggerTypeEnum';
+import { PopulationRef } from './PopulationRef';
+/** Disparador de una evaluacion (spec B 5.1). Una evaluacion tiene a lo sumo UN disparador `EVENT`. */
+export declare class EvaluationTrigger {
+    type: TriggerTypeEnum;
+    approval: ApprovalModeEnum;
+    /** Solo `EVENT`. */
+    eventKey?: string;
+    /** Solo `CRON`: cron de 5 campos, granularidad de 15 minutos (fase 4). */
+    schedule?: string;
+    /** Solo `CRON` (fase 4). */
+    population?: PopulationRef;
+}

package/bin/rewardsEligibility/dtos/EvaluationTrigger.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvaluationTrigger = void 0;
+/** Disparador de una evaluacion (spec B 5.1). Una evaluacion tiene a lo sumo UN disparador `EVENT`. */
+class EvaluationTrigger {
+}
+exports.EvaluationTrigger = EvaluationTrigger;

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

@@ -0,0 +1,12 @@
+import { GrantPeriodEnum } from '../enums/GrantPeriodEnum';
+import { GrantPolicyModeEnum } from '../enums/GrantPolicyModeEnum';
+/** Politica de frecuencia de una evaluacion (spec B 5.1). Cada modo exige su campo (lo valida el backoffice). */
+export declare class GrantPolicy {
+    mode: GrantPolicyModeEnum;
+    /** Solo `PER_PERIOD`. */
+    period?: GrantPeriodEnum;
+    /** Solo `PER_REFERENCE`: la `key` de un input del contrato (ej. `saleId`). */
+    referenceInput?: string;
+    /** Solo `MAX_N`: tope de premios en total (>= 1). */
+    max?: number;
+}

package/bin/rewardsEligibility/dtos/GrantPolicy.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrantPolicy = void 0;
+/** Politica de frecuencia de una evaluacion (spec B 5.1). Cada modo exige su campo (lo valida el backoffice). */
+class GrantPolicy {
+}
+exports.GrantPolicy = GrantPolicy;

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

@@ -0,0 +1,6 @@
+import { DynamicFormValue } from '../../dynamicForm/types/DynamicFormValue';
+/** Fuente de poblacion de un disparador `CRON` (fase 4) con sus params. */
+export declare class PopulationRef {
+    source: string;
+    params: Record<string, DynamicFormValue>;
+}

package/bin/rewardsEligibility/dtos/PopulationRef.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PopulationRef = void 0;
+/** Fuente de poblacion de un disparador `CRON` (fase 4) con sus params. */
+class PopulationRef {
+}
+exports.PopulationRef = PopulationRef;

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

@@ -0,0 +1,4 @@
+export declare enum ApprovalModeEnum {
+    AUTO = "AUTO",
+    REQUIRED = "REQUIRED"
+}

package/bin/rewardsEligibility/enums/ApprovalModeEnum.js

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

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

@@ -0,0 +1,7 @@
+/** Estado de publicacion del registro de reserva de un lote (spec B 5.8). */
+export declare enum BatchPublishStateEnum {
+    PENDING_APPROVAL = "PENDING_APPROVAL",
+    PENDING = "PENDING",
+    PUBLISHED = "PUBLISHED",
+    CANCELLED = "CANCELLED"
+}

package/bin/rewardsEligibility/enums/BatchPublishStateEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchPublishStateEnum = void 0;
+/** Estado de publicacion del registro de reserva de un lote (spec B 5.8). */
+var BatchPublishStateEnum;
+(function (BatchPublishStateEnum) {
+    BatchPublishStateEnum["PENDING_APPROVAL"] = "PENDING_APPROVAL";
+    BatchPublishStateEnum["PENDING"] = "PENDING";
+    BatchPublishStateEnum["PUBLISHED"] = "PUBLISHED";
+    BatchPublishStateEnum["CANCELLED"] = "CANCELLED";
+})(BatchPublishStateEnum || (exports.BatchPublishStateEnum = BatchPublishStateEnum = {}));

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

@@ -0,0 +1,7 @@
+/** Por que esta pausada una campania: decide si se siguen soltando sus lotes reservados (spec B 7.6). */
+export declare enum CampaignPausedReasonEnum {
+    /** Lo pauso un operador: no se sueltan lotes. */
+    MANUAL = "MANUAL",
+    /** Se agoto un cupo con `PAUSE_CAMPAIGN`: lo reservado igual se suelta. */
+    QUOTA_EXHAUSTED = "QUOTA_EXHAUSTED"
+}

package/bin/rewardsEligibility/enums/CampaignPausedReasonEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CampaignPausedReasonEnum = void 0;
+/** Por que esta pausada una campania: decide si se siguen soltando sus lotes reservados (spec B 7.6). */
+var CampaignPausedReasonEnum;
+(function (CampaignPausedReasonEnum) {
+    /** Lo pauso un operador: no se sueltan lotes. */
+    CampaignPausedReasonEnum["MANUAL"] = "MANUAL";
+    /** Se agoto un cupo con `PAUSE_CAMPAIGN`: lo reservado igual se suelta. */
+    CampaignPausedReasonEnum["QUOTA_EXHAUSTED"] = "QUOTA_EXHAUSTED";
+})(CampaignPausedReasonEnum || (exports.CampaignPausedReasonEnum = CampaignPausedReasonEnum = {}));

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

@@ -0,0 +1,8 @@
+export declare enum CampaignStatusEnum {
+    DRAFT = "DRAFT",
+    ACTIVE = "ACTIVE",
+    PAUSED = "PAUSED",
+    /** Llego a `endsAt` (lo marca el tick, spec B 5.6). */
+    ENDED = "ENDED",
+    ARCHIVED = "ARCHIVED"
+}

package/bin/rewardsEligibility/enums/CampaignStatusEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CampaignStatusEnum = void 0;
+var CampaignStatusEnum;
+(function (CampaignStatusEnum) {
+    CampaignStatusEnum["DRAFT"] = "DRAFT";
+    CampaignStatusEnum["ACTIVE"] = "ACTIVE";
+    CampaignStatusEnum["PAUSED"] = "PAUSED";
+    /** Llego a `endsAt` (lo marca el tick, spec B 5.6). */
+    CampaignStatusEnum["ENDED"] = "ENDED";
+    CampaignStatusEnum["ARCHIVED"] = "ARCHIVED";
+})(CampaignStatusEnum || (exports.CampaignStatusEnum = CampaignStatusEnum = {}));

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

@@ -0,0 +1,6 @@
+export declare enum EvaluationStatusEnum {
+    DRAFT = "DRAFT",
+    ACTIVE = "ACTIVE",
+    PAUSED = "PAUSED",
+    ARCHIVED = "ARCHIVED"
+}

package/bin/rewardsEligibility/enums/EvaluationStatusEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EvaluationStatusEnum = void 0;
+var EvaluationStatusEnum;
+(function (EvaluationStatusEnum) {
+    EvaluationStatusEnum["DRAFT"] = "DRAFT";
+    EvaluationStatusEnum["ACTIVE"] = "ACTIVE";
+    EvaluationStatusEnum["PAUSED"] = "PAUSED";
+    EvaluationStatusEnum["ARCHIVED"] = "ARCHIVED";
+})(EvaluationStatusEnum || (exports.EvaluationStatusEnum = EvaluationStatusEnum = {}));

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

@@ -0,0 +1,5 @@
+/** Periodos validos de `GrantPolicy.period` (modo `PER_PERIOD`). */
+export declare enum GrantPeriodEnum {
+    WEEK = "WEEK",
+    MONTH = "MONTH"
+}

package/bin/rewardsEligibility/enums/GrantPeriodEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrantPeriodEnum = void 0;
+/** Periodos validos de `GrantPolicy.period` (modo `PER_PERIOD`). */
+var GrantPeriodEnum;
+(function (GrantPeriodEnum) {
+    GrantPeriodEnum["WEEK"] = "WEEK";
+    GrantPeriodEnum["MONTH"] = "MONTH";
+})(GrantPeriodEnum || (exports.GrantPeriodEnum = GrantPeriodEnum = {}));

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

@@ -0,0 +1,11 @@
+/** Politica de frecuencia de una evaluacion (spec B E5 y 5.5). */
+export declare enum GrantPolicyModeEnum {
+    /** Una vez en la vida por evaluacion. */
+    ONCE = "ONCE",
+    /** Una por periodo (`GrantPeriodEnum`). */
+    PER_PERIOD = "PER_PERIOD",
+    /** Una por valor del `referenceInput` (ej. `saleId`). */
+    PER_REFERENCE = "PER_REFERENCE",
+    /** Hasta N en total (`max`), con un contador. */
+    MAX_N = "MAX_N"
+}

package/bin/rewardsEligibility/enums/GrantPolicyModeEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrantPolicyModeEnum = void 0;
+/** Politica de frecuencia de una evaluacion (spec B E5 y 5.5). */
+var GrantPolicyModeEnum;
+(function (GrantPolicyModeEnum) {
+    /** Una vez en la vida por evaluacion. */
+    GrantPolicyModeEnum["ONCE"] = "ONCE";
+    /** Una por periodo (`GrantPeriodEnum`). */
+    GrantPolicyModeEnum["PER_PERIOD"] = "PER_PERIOD";
+    /** Una por valor del `referenceInput` (ej. `saleId`). */
+    GrantPolicyModeEnum["PER_REFERENCE"] = "PER_REFERENCE";
+    /** Hasta N en total (`max`), con un contador. */
+    GrantPolicyModeEnum["MAX_N"] = "MAX_N";
+})(GrantPolicyModeEnum || (exports.GrantPolicyModeEnum = GrantPolicyModeEnum = {}));

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

@@ -0,0 +1,5 @@
+/** Estado de una reserva del ledger de frecuencia (spec B 5.5). */
+export declare enum LedgerStatusEnum {
+    RESERVED = "RESERVED",
+    RELEASED = "RELEASED"
+}

package/bin/rewardsEligibility/enums/LedgerStatusEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LedgerStatusEnum = void 0;
+/** Estado de una reserva del ledger de frecuencia (spec B 5.5). */
+var LedgerStatusEnum;
+(function (LedgerStatusEnum) {
+    LedgerStatusEnum["RESERVED"] = "RESERVED";
+    LedgerStatusEnum["RELEASED"] = "RELEASED";
+})(LedgerStatusEnum || (exports.LedgerStatusEnum = LedgerStatusEnum = {}));

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

@@ -0,0 +1,7 @@
+/** Que pasa al agotarse un cupo (`onExhausted`, spec B 5.6). */
+export declare enum QuotaExhaustedActionEnum {
+    /** Pausa la campania; sus evaluaciones dejan de correr. */
+    PAUSE_CAMPAIGN = "PAUSE_CAMPAIGN",
+    /** Siguen corriendo y registrando, sin entregar (`QUOTA_EXHAUSTED`). */
+    RECORD_ONLY = "RECORD_ONLY"
+}

package/bin/rewardsEligibility/enums/QuotaExhaustedActionEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuotaExhaustedActionEnum = void 0;
+/** Que pasa al agotarse un cupo (`onExhausted`, spec B 5.6). */
+var QuotaExhaustedActionEnum;
+(function (QuotaExhaustedActionEnum) {
+    /** Pausa la campania; sus evaluaciones dejan de correr. */
+    QuotaExhaustedActionEnum["PAUSE_CAMPAIGN"] = "PAUSE_CAMPAIGN";
+    /** Siguen corriendo y registrando, sin entregar (`QUOTA_EXHAUSTED`). */
+    QuotaExhaustedActionEnum["RECORD_ONLY"] = "RECORD_ONLY";
+})(QuotaExhaustedActionEnum || (exports.QuotaExhaustedActionEnum = QuotaExhaustedActionEnum = {}));

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

@@ -0,0 +1,7 @@
+/** Periodo de un cupo de campania (spec B 5.6). `TOTAL` no se reinicia nunca. */
+export declare enum QuotaPeriodEnum {
+    TOTAL = "TOTAL",
+    DAY = "DAY",
+    WEEK = "WEEK",
+    MONTH = "MONTH"
+}

package/bin/rewardsEligibility/enums/QuotaPeriodEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuotaPeriodEnum = void 0;
+/** Periodo de un cupo de campania (spec B 5.6). `TOTAL` no se reinicia nunca. */
+var QuotaPeriodEnum;
+(function (QuotaPeriodEnum) {
+    QuotaPeriodEnum["TOTAL"] = "TOTAL";
+    QuotaPeriodEnum["DAY"] = "DAY";
+    QuotaPeriodEnum["WEEK"] = "WEEK";
+    QuotaPeriodEnum["MONTH"] = "MONTH";
+})(QuotaPeriodEnum || (exports.QuotaPeriodEnum = QuotaPeriodEnum = {}));

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

@@ -0,0 +1,5 @@
+/** De donde salio el dato con el que se decidio una condicion (spec B 7.4.1). */
+export declare enum TraceOriginEnum {
+    PREFETCHED = "PREFETCHED",
+    RESOLVED = "RESOLVED"
+}

package/bin/rewardsEligibility/enums/TraceOriginEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TraceOriginEnum = void 0;
+/** De donde salio el dato con el que se decidio una condicion (spec B 7.4.1). */
+var TraceOriginEnum;
+(function (TraceOriginEnum) {
+    TraceOriginEnum["PREFETCHED"] = "PREFETCHED";
+    TraceOriginEnum["RESOLVED"] = "RESOLVED";
+})(TraceOriginEnum || (exports.TraceOriginEnum = TraceOriginEnum = {}));

package/bin/rewardsEligibility/index.d.ts

@@ -11,3 +11,21 @@ export * from './dtos/PostEventResponse';
 export * from './dtos/RunCounts';
 export * from './dtos/RunResultItem';
 export * from './dtos/GetRunResponse';
+export * from './enums/CampaignStatusEnum';
+export * from './enums/CampaignPausedReasonEnum';
+export * from './enums/EvaluationStatusEnum';
+export * from './enums/GrantPolicyModeEnum';
+export * from './enums/GrantPeriodEnum';
+export * from './enums/QuotaPeriodEnum';
+export * from './enums/QuotaExhaustedActionEnum';
+export * from './enums/ApprovalModeEnum';
+export * from './enums/LedgerStatusEnum';
+export * from './enums/BatchPublishStateEnum';
+export * from './enums/TraceOriginEnum';
+export * from './types/RewardInputRef';
+export * from './dtos/GrantPolicy';
+export * from './dtos/CampaignQuota';
+export * from './dtos/CampaignAlerts';
+export * from './dtos/PopulationRef';
+export * from './dtos/EvaluationReward';
+export * from './dtos/EvaluationTrigger';

package/bin/rewardsEligibility/index.js

@@ -29,3 +29,24 @@ __exportStar(require("./dtos/PostEventResponse"), exports);
 __exportStar(require("./dtos/RunCounts"), exports);
 __exportStar(require("./dtos/RunResultItem"), exports);
 __exportStar(require("./dtos/GetRunResponse"), exports);
+//Enums del dominio (campanias, evaluaciones, ledger)
+__exportStar(require("./enums/CampaignStatusEnum"), exports);
+__exportStar(require("./enums/CampaignPausedReasonEnum"), exports);
+__exportStar(require("./enums/EvaluationStatusEnum"), exports);
+__exportStar(require("./enums/GrantPolicyModeEnum"), exports);
+__exportStar(require("./enums/GrantPeriodEnum"), exports);
+__exportStar(require("./enums/QuotaPeriodEnum"), exports);
+__exportStar(require("./enums/QuotaExhaustedActionEnum"), exports);
+__exportStar(require("./enums/ApprovalModeEnum"), exports);
+__exportStar(require("./enums/LedgerStatusEnum"), exports);
+__exportStar(require("./enums/BatchPublishStateEnum"), exports);
+__exportStar(require("./enums/TraceOriginEnum"), exports);
+//Types
+__exportStar(require("./types/RewardInputRef"), exports);
+//DTOs de configuracion (forma guardada de campanias y evaluaciones)
+__exportStar(require("./dtos/GrantPolicy"), exports);
+__exportStar(require("./dtos/CampaignQuota"), exports);
+__exportStar(require("./dtos/CampaignAlerts"), exports);
+__exportStar(require("./dtos/PopulationRef"), exports);
+__exportStar(require("./dtos/EvaluationReward"), exports);
+__exportStar(require("./dtos/EvaluationTrigger"), exports);

package/bin/rewardsEligibility/types/RewardInputRef.d.ts

@@ -0,0 +1,7 @@
+import { DynamicFormValue } from '../../dynamicForm/types/DynamicFormValue';
+/** Valor de un input de `reward.inputs`: constante o tomado de un input de la evaluacion (spec B 5.1). */
+export type RewardInputRef = {
+    const: DynamicFormValue;
+} | {
+    input: string;
+};

package/bin/rewardsEligibility/types/RewardInputRef.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

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

package/src/rewards/constants/BackofficeLimits.ts

@@ -0,0 +1,6 @@
+/** Máximo del `itemKey` de un paquete: `RW-{grantId(32)}-{itemKey}` ≤ 64 (igual que REWARDS_MAX_ITEM_KEY_LENGTH de api-invoker). */
+export const REWARD_ITEM_KEY_MAX_LENGTH = 28;
+export const REWARD_ITEM_KEY_PATTERN = new RegExp(`^[A-Za-z0-9_-]{1,${REWARD_ITEM_KEY_MAX_LENGTH}}$`);
+export const REWARD_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+/** Máximo de ítems de un paquete (B-12 de rewards-business: presupuesto de tiempo del worker). Igual a `MAX_ITEMS_PER_PACKAGE` del lambda. */
+export const REWARD_PACKAGE_MAX_ITEMS = 4;

package/src/rewards/dtos/backoffice/CatalogItemListResponse.ts

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

package/src/rewards/dtos/backoffice/CatalogItemRequest.ts

@@ -0,0 +1,52 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsNotEmpty, IsObject, IsString, Matches, MaxLength, ValidateNested } from 'class-validator';
+import { JsonValue } from '../../../common';
+import { REWARD_ID_PATTERN } from '../../constants/BackofficeLimits';
+import { RewardStatusEnum } from '../../enums/RewardStatusEnum';
+import { RewardChargeToInput } from './RewardChargeToInput';
+import { RewardCostInput } from './RewardCostInput';
+
+/** Crear (POST) o reemplazar (PUT) una recompensa del catálogo. `version`, `dependencies` y `updatedBy` los pone el servidor. */
+export class CatalogItemRequest {
+    @Expose()
+    @IsString()
+    @Matches(REWARD_ID_PATTERN)
+    id: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(120)
+    name: string;
+
+    @Expose()
+    @IsString()
+    @MaxLength(500)
+    description: string;
+
+    /** `type` del adaptador (IRewardType.type). Inmutable una vez creada la recompensa. */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(60)
+    type: string;
+
+    /** Forma definida por cada tipo; el lambda la valida con `IRewardType.validateConfig`. */
+    @Expose()
+    @IsObject()
+    config: { [key: string]: JsonValue };
+
+    @Expose()
+    @ValidateNested()
+    @Type(() => RewardCostInput)
+    cost: RewardCostInput;
+
+    @Expose()
+    @ValidateNested()
+    @Type(() => RewardChargeToInput)
+    chargeTo: RewardChargeToInput;
+
+    @Expose()
+    @IsEnum(RewardStatusEnum)
+    status: RewardStatusEnum;
+}

package/src/rewards/dtos/backoffice/CatalogItemResponse.ts

@@ -0,0 +1,22 @@
+import { JsonValue } from '../../../common';
+import { RewardStatusEnum } from '../../enums/RewardStatusEnum';
+import { RewardChargeTo } from '../RewardChargeTo';
+import { RewardCost } from '../RewardCost';
+import { RewardDependency } from '../RewardDependency';
+
+export class CatalogItemResponse {
+    id: string;
+    name: string;
+    description: string;
+    type: string;
+    config: { [key: string]: JsonValue };
+    cost: RewardCost;
+    chargeTo: RewardChargeTo;
+    /** Solo lectura: las calcula el tipo a partir de `config`. */
+    dependencies: RewardDependency[];
+    status: RewardStatusEnum;
+    version: number;
+    updatedBy: string;
+    createdAt: number;
+    updatedAt: number;
+}

package/src/rewards/dtos/backoffice/PackageItemRequest.ts

@@ -0,0 +1,15 @@
+import { Expose } from 'class-transformer';
+import { IsString, Matches } from 'class-validator';
+import { REWARD_ID_PATTERN, REWARD_ITEM_KEY_PATTERN } from '../../constants/BackofficeLimits';
+
+export class PackageItemRequest {
+    @Expose()
+    @IsString()
+    @Matches(REWARD_ITEM_KEY_PATTERN)
+    itemKey: string;
+
+    @Expose()
+    @IsString()
+    @Matches(REWARD_ID_PATTERN)
+    catalogItemId: string;
+}

package/src/rewards/dtos/backoffice/PackageListResponse.ts

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

package/src/rewards/dtos/backoffice/PackageRequest.ts

@@ -0,0 +1,31 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayMinSize, IsArray, IsEnum, IsNotEmpty, IsString, Matches, MaxLength, ValidateNested } from 'class-validator';
+import { REWARD_ID_PATTERN, REWARD_PACKAGE_MAX_ITEMS } from '../../constants/BackofficeLimits';
+import { RewardStatusEnum } from '../../enums/RewardStatusEnum';
+import { PackageItemRequest } from './PackageItemRequest';
+
+export class PackageRequest {
+    @Expose()
+    @IsString()
+    @Matches(REWARD_ID_PATTERN)
+    id: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(120)
+    name: string;
+
+    @Expose()
+    @IsEnum(RewardStatusEnum)
+    status: RewardStatusEnum;
+
+    /** Ordenada: el orden es el de ejecución. De 1 a 4 ítems (el tope depende del presupuesto de tiempo del worker, B-12; el lambda lo valida otra vez). */
+    @Expose()
+    @IsArray()
+    @ArrayMinSize(1)
+    @ArrayMaxSize(REWARD_PACKAGE_MAX_ITEMS)
+    @ValidateNested({ each: true })
+    @Type(() => PackageItemRequest)
+    items: PackageItemRequest[];
+}

package/src/rewards/dtos/backoffice/PackageResponse.ts

@@ -0,0 +1,20 @@
+import { RewardStatusEnum } from '../../enums/RewardStatusEnum';
+import { RewardCost } from '../RewardCost';
+
+export class PackageItemResponse {
+    itemKey: string;
+    catalogItemId: string;
+}
+
+export class PackageResponse {
+    id: string;
+    name: string;
+    status: RewardStatusEnum;
+    version: number;
+    items: PackageItemResponse[];
+    /** Costo total declarado por moneda (spec 5.2). */
+    totalCost: RewardCost[];
+    updatedBy: string;
+    createdAt: number;
+    updatedAt: number;
+}

package/src/rewards/dtos/backoffice/RewardChargeToInput.ts

@@ -0,0 +1,16 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsString, MaxLength } from 'class-validator';
+
+export class RewardChargeToInput {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    partnerId: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(120)
+    partnerName: string;
+}

package/src/rewards/dtos/backoffice/RewardCostInput.ts

@@ -0,0 +1,14 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsNumber, Min } from 'class-validator';
+import { CurrencyId } from '../../../currency';
+
+export class RewardCostInput {
+    @Expose()
+    @IsNumber({ maxDecimalPlaces: 2 })
+    @Min(0)
+    amount: number;
+
+    @Expose()
+    @IsEnum(CurrencyId)
+    currency: CurrencyId;
+}

package/src/rewards/dtos/backoffice/RewardTypeResponse.ts

@@ -0,0 +1,7 @@
+import { InputField } from '../../../dynamicForm/dtos/InputField';
+
+/** `GET /reward-types`: un tipo registrado y el formulario dinámico de su `config`. */
+export class RewardTypeResponse {
+    type: string;
+    configFields: InputField[];
+}

package/src/rewards/index.ts

@@ -35,3 +35,18 @@ export * from './dtos/responses/PackageContractResponse';
 export * from './dtos/responses/GrantAttemptResponse';
 export * from './dtos/responses/GrantItemResponse';
 export * from './dtos/responses/GrantResponse';
+
+//Constants backoffice
+export * from './constants/BackofficeLimits';
+
+//DTOs backoffice
+export * from './dtos/backoffice/RewardCostInput';
+export * from './dtos/backoffice/RewardChargeToInput';
+export * from './dtos/backoffice/CatalogItemRequest';
+export * from './dtos/backoffice/CatalogItemResponse';
+export * from './dtos/backoffice/PackageItemRequest';
+export * from './dtos/backoffice/PackageRequest';
+export * from './dtos/backoffice/PackageResponse';
+export * from './dtos/backoffice/RewardTypeResponse';
+export * from './dtos/backoffice/CatalogItemListResponse';
+export * from './dtos/backoffice/PackageListResponse';

package/src/rewardsEligibility/dtos/CampaignAlerts.ts

@@ -0,0 +1,4 @@
+/** Umbrales de consumo (0 a 1) que avisan a los operadores (spec B 5.6). */
+export class CampaignAlerts {
+    thresholds: number[];
+}

package/src/rewardsEligibility/dtos/CampaignQuota.ts

@@ -0,0 +1,9 @@
+import { QuotaPeriodEnum } from '../enums/QuotaPeriodEnum';
+
+/** Un cupo de campania: cantidad maxima de premios (no dinero) en un periodo (spec B 5.6). */
+export class CampaignQuota {
+    /** Unico dentro de la campania (ej. `primeros-500`). Entra en la llave del consumo (`{id}#{periodo}`). */
+    id: string;
+    limit: number;
+    period: QuotaPeriodEnum;
+}