@fiado/type-kit 3.513.0 → 3.514.0

package/_test_/unit/rewards/backoffice.test.ts

@@ -0,0 +1,96 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { JsonValue } from '../../../src/common';
+import { CatalogItemRequest, PackageRequest, REWARD_ITEM_KEY_MAX_LENGTH, REWARD_PACKAGE_MAX_ITEMS } from '../../../src/rewards';
+
+const catalog = {
+  id: 'example-reward-a',
+  name: 'Recompensa A',
+  description: 'Recompensa de ejemplo',
+  type: 'ExampleType',
+  config: { amount: 50, nested: { list: [1, 2] } },
+  cost: { amount: 50, currency: 'MXN' },
+  chargeTo: { partnerId: 'ALIADO-001', partnerName: 'Aliado de ejemplo' },
+  status: 'ACTIVE',
+};
+const pkg = { id: 'paquete-1', name: 'Paquete 1', status: 'ACTIVE', items: [{ itemKey: 'itemA', catalogItemId: 'example-reward-a' }] };
+
+const asCatalog = (o: Record<string, JsonValue> = {}): CatalogItemRequest =>
+  plainToInstance(CatalogItemRequest, { ...catalog, ...o }, { excludeExtraneousValues: true });
+const asPackage = (o: Record<string, JsonValue> = {}): PackageRequest =>
+  plainToInstance(PackageRequest, { ...pkg, ...o }, { excludeExtraneousValues: true });
+const props = async (dto: object): Promise<string[]> => (await validate(dto)).map((e) => e.property);
+
+describe('CatalogItemRequest', () => {
+  it('valida una recompensa correcta y conserva el config anidado completo', async () => {
+    const dto = asCatalog();
+    expect(await validate(dto)).toHaveLength(0);
+    expect(dto.config).toEqual({ amount: 50, nested: { list: [1, 2] } });
+  });
+
+  it.each<[string, Record<string, JsonValue>, string]>([
+    ['id con espacios', { id: 'con espacio' }, 'id'],
+    ['id vacío', { id: '' }, 'id'],
+    ['name vacío', { name: '' }, 'name'],
+    ['name > 120', { name: 'x'.repeat(121) }, 'name'],
+    ['type vacío', { type: '' }, 'type'],
+    ['config que no es objeto', { config: 'texto' }, 'config'],
+    ['status desconocido', { status: 'BORRADO' }, 'status'],
+    ['costo negativo', { cost: { amount: -1, currency: 'MXN' } }, 'cost'],
+    ['costo con 3 decimales', { cost: { amount: 1.234, currency: 'MXN' } }, 'cost'],
+    ['moneda desconocida', { cost: { amount: 5, currency: 'XXX' } }, 'cost'],
+    ['chargeTo sin partnerId', { chargeTo: { partnerId: '', partnerName: 'A' } }, 'chargeTo'],
+  ])('rechaza %s', async (_nombre, override, property) => {
+    expect(await props(asCatalog(override))).toContain(property);
+  });
+
+  it('acepta costo 0 (recompensa gratuita para el aliado)', async () => {
+    expect(await validate(asCatalog({ cost: { amount: 0, currency: 'MXN' } }))).toHaveLength(0);
+  });
+
+  it('descarta campos extra (version, dependencies, updatedBy no se aceptan del cliente)', () => {
+    const dto = asCatalog({ version: 99, dependencies: [], updatedBy: 'hacker' });
+    expect('version' in dto).toBe(false);
+    expect('dependencies' in dto).toBe(false);
+    expect('updatedBy' in dto).toBe(false);
+  });
+});
+
+describe('PackageRequest', () => {
+  it('valida un paquete correcto', async () => {
+    expect(await validate(asPackage())).toHaveLength(0);
+  });
+
+  it('exige al menos un ítem', async () => {
+    expect(await props(asPackage({ items: [] }))).toContain('items');
+  });
+
+  it(`itemKey de ${REWARD_ITEM_KEY_MAX_LENGTH} caracteres entra; de ${REWARD_ITEM_KEY_MAX_LENGTH + 1} no (RW-{grantId}-{itemKey} ≤ 64)`, async () => {
+    const ok = asPackage({ items: [{ itemKey: 'k'.repeat(REWARD_ITEM_KEY_MAX_LENGTH), catalogItemId: 'r1' }] });
+    const tooLong = asPackage({ items: [{ itemKey: 'k'.repeat(REWARD_ITEM_KEY_MAX_LENGTH + 1), catalogItemId: 'r1' }] });
+    expect(await validate(ok)).toHaveLength(0);
+    expect(await props(tooLong)).toContain('items');
+  });
+
+  it.each(['con espacio', 'con#almohadilla', 'acentó'])('rechaza el itemKey %s (caracteres fuera de [A-Za-z0-9_-])', async (itemKey) => {
+    expect(await props(asPackage({ items: [{ itemKey, catalogItemId: 'r1' }] }))).toContain('items');
+  });
+
+  it('REWARD_ITEM_KEY_MAX_LENGTH es 28 (igual que REWARDS_MAX_ITEM_KEY_LENGTH de api-invoker)', () => {
+    expect(REWARD_ITEM_KEY_MAX_LENGTH).toBe(28);
+  });
+
+  it('REWARD_PACKAGE_MAX_ITEMS es 4 (igual que MAX_ITEMS_PER_PACKAGE del worker, B-12): 4 ítems entran, 5 no', async () => {
+    expect(REWARD_PACKAGE_MAX_ITEMS).toBe(4);
+    const itemsOf = (n: number): JsonValue[] =>
+      Array.from({ length: n }, (_, i) => ({ itemKey: `item${i}`, catalogItemId: 'example-reward-a' }));
+    expect(await validate(asPackage({ items: itemsOf(REWARD_PACKAGE_MAX_ITEMS) }))).toHaveLength(0);
+    expect(await props(asPackage({ items: itemsOf(REWARD_PACKAGE_MAX_ITEMS + 1) }))).toContain('items');
+  });
+
+  it('acepta el MISMO catalogItemId en dos itemKey distintos (decisión de la Parte 2: cada ítem tiene su transactionNumber)', async () => {
+    const items = [{ itemKey: 'itemA', catalogItemId: 'example-reward-a' }, { itemKey: 'itemB', catalogItemId: 'example-reward-a' }];
+    expect(await validate(asPackage({ items }))).toHaveLength(0);
+  });
+});

package/bin/rewards/constants/BackofficeLimits.d.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 declare const REWARD_ITEM_KEY_MAX_LENGTH = 28;
+export declare const REWARD_ITEM_KEY_PATTERN: RegExp;
+export declare const REWARD_ID_PATTERN: RegExp;
+/** Máximo de ítems de un paquete (B-12 de rewards-business: presupuesto de tiempo del worker). Igual a `MAX_ITEMS_PER_PACKAGE` del lambda. */
+export declare const REWARD_PACKAGE_MAX_ITEMS = 4;

package/bin/rewards/constants/BackofficeLimits.js

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

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

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

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

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

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

@@ -0,0 +1,19 @@
+import { JsonValue } from '../../../common';
+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 declare class CatalogItemRequest {
+    id: string;
+    name: string;
+    description: string;
+    /** `type` del adaptador (IRewardType.type). Inmutable una vez creada la recompensa. */
+    type: string;
+    /** Forma definida por cada tipo; el lambda la valida con `IRewardType.validateConfig`. */
+    config: {
+        [key: string]: JsonValue;
+    };
+    cost: RewardCostInput;
+    chargeTo: RewardChargeToInput;
+    status: RewardStatusEnum;
+}

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

@@ -0,0 +1,70 @@
+"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.CatalogItemRequest = 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 RewardChargeToInput_1 = require("./RewardChargeToInput");
+const RewardCostInput_1 = require("./RewardCostInput");
+/** Crear (POST) o reemplazar (PUT) una recompensa del catálogo. `version`, `dependencies` y `updatedBy` los pone el servidor. */
+class CatalogItemRequest {
+}
+exports.CatalogItemRequest = CatalogItemRequest;
+__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)
+], CatalogItemRequest.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)
+], CatalogItemRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], CatalogItemRequest.prototype, "description", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(60),
+    __metadata("design:type", String)
+], CatalogItemRequest.prototype, "type", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], CatalogItemRequest.prototype, "config", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => RewardCostInput_1.RewardCostInput),
+    __metadata("design:type", RewardCostInput_1.RewardCostInput)
+], CatalogItemRequest.prototype, "cost", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => RewardChargeToInput_1.RewardChargeToInput),
+    __metadata("design:type", RewardChargeToInput_1.RewardChargeToInput)
+], CatalogItemRequest.prototype, "chargeTo", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(RewardStatusEnum_1.RewardStatusEnum),
+    __metadata("design:type", String)
+], CatalogItemRequest.prototype, "status", void 0);

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

@@ -0,0 +1,23 @@
+import { JsonValue } from '../../../common';
+import { RewardStatusEnum } from '../../enums/RewardStatusEnum';
+import { RewardChargeTo } from '../RewardChargeTo';
+import { RewardCost } from '../RewardCost';
+import { RewardDependency } from '../RewardDependency';
+export declare 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/bin/rewards/dtos/backoffice/CatalogItemResponse.js

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

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

@@ -0,0 +1,4 @@
+export declare class PackageItemRequest {
+    itemKey: string;
+    catalogItemId: string;
+}

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.513.0",
+  "version": "3.514.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';