@fiado/type-kit 3.512.0 → 3.514.0

package/bin/rewards/dtos/backoffice/PackageItemRequest.js

@@ -0,0 +1,30 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageItemRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const BackofficeLimits_1 = require("../../constants/BackofficeLimits");
+class PackageItemRequest {
+}
+exports.PackageItemRequest = PackageItemRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(BackofficeLimits_1.REWARD_ITEM_KEY_PATTERN),
+    __metadata("design:type", String)
+], PackageItemRequest.prototype, "itemKey", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(BackofficeLimits_1.REWARD_ID_PATTERN),
+    __metadata("design:type", String)
+], PackageItemRequest.prototype, "catalogItemId", void 0);

package/bin/rewards/dtos/backoffice/PackageListResponse.d.ts

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

package/bin/rewards/dtos/backoffice/PackageListResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageListResponse = void 0;
+class PackageListResponse {
+}
+exports.PackageListResponse = PackageListResponse;

package/bin/rewards/dtos/backoffice/PackageRequest.d.ts

@@ -0,0 +1,9 @@
+import { RewardStatusEnum } from '../../enums/RewardStatusEnum';
+import { PackageItemRequest } from './PackageItemRequest';
+export declare class PackageRequest {
+    id: string;
+    name: string;
+    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). */
+    items: PackageItemRequest[];
+}

package/bin/rewards/dtos/backoffice/PackageRequest.js

@@ -0,0 +1,47 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const BackofficeLimits_1 = require("../../constants/BackofficeLimits");
+const RewardStatusEnum_1 = require("../../enums/RewardStatusEnum");
+const PackageItemRequest_1 = require("./PackageItemRequest");
+class PackageRequest {
+}
+exports.PackageRequest = PackageRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(BackofficeLimits_1.REWARD_ID_PATTERN),
+    __metadata("design:type", String)
+], PackageRequest.prototype, "id", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(120),
+    __metadata("design:type", String)
+], PackageRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(RewardStatusEnum_1.RewardStatusEnum),
+    __metadata("design:type", String)
+], PackageRequest.prototype, "status", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(BackofficeLimits_1.REWARD_PACKAGE_MAX_ITEMS),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => PackageItemRequest_1.PackageItemRequest),
+    __metadata("design:type", Array)
+], PackageRequest.prototype, "items", void 0);

package/bin/rewards/dtos/backoffice/PackageResponse.d.ts

@@ -0,0 +1,18 @@
+import { RewardStatusEnum } from '../../enums/RewardStatusEnum';
+import { RewardCost } from '../RewardCost';
+export declare class PackageItemResponse {
+    itemKey: string;
+    catalogItemId: string;
+}
+export declare 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/bin/rewards/dtos/backoffice/PackageResponse.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageResponse = exports.PackageItemResponse = void 0;
+class PackageItemResponse {
+}
+exports.PackageItemResponse = PackageItemResponse;
+class PackageResponse {
+}
+exports.PackageResponse = PackageResponse;

package/bin/rewards/dtos/backoffice/RewardChargeToInput.d.ts

@@ -0,0 +1,4 @@
+export declare class RewardChargeToInput {
+    partnerId: string;
+    partnerName: string;
+}

package/bin/rewards/dtos/backoffice/RewardChargeToInput.js

@@ -0,0 +1,31 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RewardChargeToInput = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+class RewardChargeToInput {
+}
+exports.RewardChargeToInput = RewardChargeToInput;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], RewardChargeToInput.prototype, "partnerId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(120),
+    __metadata("design:type", String)
+], RewardChargeToInput.prototype, "partnerName", void 0);

package/bin/rewards/dtos/backoffice/RewardCostInput.d.ts

@@ -0,0 +1,5 @@
+import { CurrencyId } from '../../../currency';
+export declare class RewardCostInput {
+    amount: number;
+    currency: CurrencyId;
+}

package/bin/rewards/dtos/backoffice/RewardCostInput.js

@@ -0,0 +1,29 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RewardCostInput = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const currency_1 = require("../../../currency");
+class RewardCostInput {
+}
+exports.RewardCostInput = RewardCostInput;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 2 }),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], RewardCostInput.prototype, "amount", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(currency_1.CurrencyId),
+    __metadata("design:type", String)
+], RewardCostInput.prototype, "currency", void 0);

package/bin/rewards/dtos/backoffice/RewardTypeResponse.d.ts

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

package/bin/rewards/dtos/backoffice/RewardTypeResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RewardTypeResponse = void 0;
+/** `GET /reward-types`: un tipo registrado y el formulario dinámico de su `config`. */
+class RewardTypeResponse {
+}
+exports.RewardTypeResponse = RewardTypeResponse;

package/bin/rewards/index.d.ts

@@ -22,3 +22,14 @@ export * from './dtos/responses/PackageContractResponse';
 export * from './dtos/responses/GrantAttemptResponse';
 export * from './dtos/responses/GrantItemResponse';
 export * from './dtos/responses/GrantResponse';
+export * from './constants/BackofficeLimits';
+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/bin/rewards/index.js

@@ -45,3 +45,16 @@ __exportStar(require("./dtos/responses/PackageContractResponse"), exports);
 __exportStar(require("./dtos/responses/GrantAttemptResponse"), exports);
 __exportStar(require("./dtos/responses/GrantItemResponse"), exports);
 __exportStar(require("./dtos/responses/GrantResponse"), exports);
+//Constants backoffice
+__exportStar(require("./constants/BackofficeLimits"), exports);
+//DTOs backoffice
+__exportStar(require("./dtos/backoffice/RewardCostInput"), exports);
+__exportStar(require("./dtos/backoffice/RewardChargeToInput"), exports);
+__exportStar(require("./dtos/backoffice/CatalogItemRequest"), exports);
+__exportStar(require("./dtos/backoffice/CatalogItemResponse"), exports);
+__exportStar(require("./dtos/backoffice/PackageItemRequest"), exports);
+__exportStar(require("./dtos/backoffice/PackageRequest"), exports);
+__exportStar(require("./dtos/backoffice/PackageResponse"), exports);
+__exportStar(require("./dtos/backoffice/RewardTypeResponse"), exports);
+__exportStar(require("./dtos/backoffice/CatalogItemListResponse"), exports);
+__exportStar(require("./dtos/backoffice/PackageListResponse"), exports);

package/package.json

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

package/src/retailCatalog/dtos/responses/GetInventorySkuResponse.ts

@@ -2,6 +2,8 @@ import type { InventoryItemStatusEnum } from '../../enums/InventoryItemStatusEnu
 import type { InventoryMovementTypeEnum } from '../../enums/InventoryMovementTypeEnum';
 import type { InventoryMovementReasonEnum } from '../../enums/InventoryMovementReasonEnum';
 import type { SkuPriceEntry } from './SkuPriceEntry';
+import type { CatalogSourceStatusEnum } from '../../enums/CatalogSourceStatusEnum';
+import type { ActiveSalePromotionSummary } from '../../../retailPromotions/dtos/responses/ActiveSalePromotionsBySkusResponse';
 
 /** Un movimiento del libro de inventario. */
 export interface InventoryMovementEntry {
@@ -40,4 +42,12 @@ export interface GetInventorySkuResponse {
     /** Vacío si el SKU se rastrea por cantidad. */
     piecesByStore: InventoryStorePieces[];
     currentPrice: SkuPriceEntry | null;
+    /** Promos de venta vigentes del SKU; `null` si retail-promotions no respondió. */
+    promotions?: ActiveSalePromotionSummary[] | null;
+    sources?: InventorySkuSources;
+}
+
+/** Estado de las fuentes externas de la ficha. */
+export interface InventorySkuSources {
+    promotions: CatalogSourceStatusEnum;
 }

package/src/retailCatalog/dtos/responses/InventoryLensResponse.ts

@@ -5,6 +5,7 @@ import type { ProductTierEnum } from '../../enums/ProductTierEnum';
 import type { InventoryLensUnavailableReasonEnum } from '../../enums/InventoryLensUnavailableReasonEnum';
 import type { InventoryTransferReasonEnum } from '../../enums/InventoryTransferReasonEnum';
 import type { ItemTypeEnum } from '../../enums/ItemTypeEnum';
+import type { CatalogSourceStatusEnum } from '../../enums/CatalogSourceStatusEnum';
 
 /**
  * Los contadores que la pantalla «Inventario» del Admin VL pinta arriba, siempre — los cuatro viajan
@@ -130,6 +131,10 @@ export interface InventoryLensListItem {
     sold30d: number;
     /** Producto físico o servicio. Ausente = PRODUCT. */
     itemType?: ItemTypeEnum;
+    /** Tiene al menos una promo de venta vigente; `null` si retail-promotions no respondió. */
+    hasPromotion?: boolean | null;
+    /** Nombres de sus promos de venta vigentes; `null` si retail-promotions no respondió. */
+    promotionNames?: string[] | null;
 }
 
 /** Fila del lente — el tipo depende del tab pedido. */
@@ -169,4 +174,11 @@ export interface InventoryLensResponse {
 
     /** Por qué no se pudo. Presente solo junto a `unavailable: true`. */
     reason?: InventoryLensUnavailableReasonEnum;
+
+    /** Estado de las fuentes externas; solo en el modo `list`. */
+    sources?: InventoryLensSources;
+}
+
+export interface InventoryLensSources {
+    promotions: CatalogSourceStatusEnum;
 }

package/src/retailCatalog/enums/CatalogSourceStatusEnum.ts

@@ -0,0 +1,5 @@
+/** Si una fuente externa de una respuesta del catálogo contestó (`OK`) o falló (`UNAVAILABLE`). */
+export enum CatalogSourceStatusEnum {
+    OK = 'OK',
+    UNAVAILABLE = 'UNAVAILABLE',
+}

package/src/retailCatalog/index.ts

@@ -52,6 +52,7 @@ export * from './enums/InventorySyncResultStatusEnum';
 export * from './enums/InventorySyncRejectionCodeEnum';
 export * from './enums/PriceSourceEnum';
 export * from './enums/InventoryLensPeriodEnum';
+export * from './enums/CatalogSourceStatusEnum';
 export * from './dtos/ProductComponent';
 export * from './dtos/requests/ReservationLineRef';
 export * from './dtos/requests/StockLine';

package/src/retailPromotions/constants/activeSalePromotionsBySkus.ts

@@ -0,0 +1,2 @@
+/** Tope de SKUs por llamada a `POST /private/sale-promotions/active-by-skus`; el caller parte en bloques. */
+export const ACTIVE_SALE_PROMOTIONS_MAX_SKUS = 100;

package/src/retailPromotions/dtos/requests/ActiveSalePromotionsBySkusRequest.ts

@@ -0,0 +1,50 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayMaxSize, IsArray, IsEnum, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
+import { ACTIVE_SALE_PROMOTIONS_MAX_SKUS } from '../../constants/activeSalePromotionsBySkus';
+
+/** Un SKU con su tipo y gama; sin ellos no cumple un alcance por tipo o por gama. */
+export class ActiveSalePromotionsSkuInput {
+    /** Un SKU vacío no invalida el lote: sale como `INVALID_ID`. */
+    @Expose()
+    @IsString()
+    sku!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductCategoryEnum)
+    category?: ProductCategoryEnum | null;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(ProductTierEnum)
+    tier?: ProductTierEnum | null;
+}
+
+/** Body de `POST /private/sale-promotions/active-by-skus` (M2M): hasta 100 SKUs; los repetidos se cuentan una vez. */
+export class ActiveSalePromotionsBySkusRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    tenantId!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    retailerId!: string;
+
+    /** Con tienda, solo las promos cuyo alcance la incluye; sin ella, las de cualquier tienda. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    storeId?: string;
+
+    @Expose()
+    @IsArray()
+    @ArrayMaxSize(ACTIVE_SALE_PROMOTIONS_MAX_SKUS)
+    @ValidateNested({ each: true })
+    @Type(() => ActiveSalePromotionsSkuInput)
+    items!: ActiveSalePromotionsSkuInput[];
+}

package/src/retailPromotions/dtos/responses/ActiveSalePromotionsBySkusResponse.ts

@@ -0,0 +1,29 @@
+import type { SalePromotionLevers, SalePromotionScope, SalePromotionSegmentation } from '../SalePromotionLevers';
+import type { SkuSalePromotionLookupStatusEnum } from '../../enums/SkuSalePromotionLookupStatusEnum';
+
+/** Promo de venta vigente hoy que alcanza al SKU, con su contenido de la versión actual. */
+export interface ActiveSalePromotionSummary {
+    promotionId: string;
+    name: string;
+    /** Palancas en español: «$500 de descuento + 3× $50 de tiempo aire + $300 al Wallet Fiado». */
+    benefitSummary: string;
+    levers: SalePromotionLevers;
+    /** `null` = arrancó al publicarse. */
+    validFrom: string | null;
+    /** `null` = permanente. */
+    validUntil: string | null;
+    segmentation: SalePromotionSegmentation;
+    scope: SalePromotionScope;
+}
+
+export interface SkuActiveSalePromotions {
+    sku: string;
+    status: SkuSalePromotionLookupStatusEnum;
+    /** Vacío si no tiene ninguna o si el estado no es `OK`. */
+    promotions: ActiveSalePromotionSummary[];
+}
+
+/** Response de `POST /private/sale-promotions/active-by-skus`: una entrada por SKU, en el orden pedido. */
+export interface ActiveSalePromotionsBySkusResponse {
+    items: SkuActiveSalePromotions[];
+}

package/src/retailPromotions/enums/SkuSalePromotionLookupStatusEnum.ts

@@ -0,0 +1,9 @@
+/** Cómo se resolvió cada SKU del lote de promos vigentes; hay una entrada por SKU pedido. */
+export enum SkuSalePromotionLookupStatusEnum {
+    /** Se leyeron las promos; `promotions` vacío es un dato: no tiene ninguna vigente. */
+    OK = 'OK',
+    /** No se pudieron leer las promos; el caller lo pinta como fuente caída y reintenta. */
+    UNAVAILABLE = 'UNAVAILABLE',
+    /** El SKU no tiene forma de SKU; reintentarlo igual nunca sirve. */
+    INVALID_ID = 'INVALID_ID',
+}

package/src/retailPromotions/index.ts

@@ -18,11 +18,13 @@ export * from './enums/EntitlementKindEnum';
 export * from './enums/SaleCouponAvailabilityEnum';
 export * from './enums/RetailPromotionsErrorCodeEnum';
 export * from './enums/SalePromotionKindEnum';
+export * from './enums/SkuSalePromotionLookupStatusEnum';
 
 // Constantes y helpers puros
 export * from './constants/retailPromotionsErrorHttpStatus';
 export * from './constants/salePromotionTransitions';
 export * from './constants/bonusPreMoney';
+export * from './constants/activeSalePromotionsBySkus';
 export * from './helpers/resolveSalePromotionTransition';
 export * from './helpers/computeBudgetUsedBps';
 export * from './helpers/resolveSalePromotionKind';
@@ -59,6 +61,7 @@ export * from './dtos/requests/HoldPromotionInput';
 export * from './dtos/requests/HoldSalePromotionRequest';
 export * from './dtos/requests/GetSaleCouponQuery';
 export * from './dtos/requests/SkuSalePromotionsQuery';
+export * from './dtos/requests/ActiveSalePromotionsBySkusRequest';
 
 // Response DTOs
 export * from './dtos/responses/SalePromotionCrudResponses';
@@ -66,3 +69,4 @@ export * from './dtos/responses/DiscountCodeResponses';
 export * from './dtos/responses/WizardSalePromotionResponses';
 export * from './dtos/responses/SkuSalePromotionsResponse';
 export * from './dtos/responses/SalePromotionSegmentsResponse';
+export * from './dtos/responses/ActiveSalePromotionsBySkusResponse';

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