@fiado/type-kit 3.188.0 → 3.190.0

package/src/retailCatalog/dtos/requests/UpdateProductRequest.ts

@@ -0,0 +1,82 @@
+import {
+    IsArray,
+    IsBoolean,
+    IsEnum,
+    IsInt,
+    IsObject,
+    IsOptional,
+    IsString,
+    Min,
+    Validate,
+} from 'class-validator';
+import { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
+import { MdmProviderEnum } from '../../enums/MdmProviderEnum';
+import { ProductTierEnum } from '../../enums/ProductTierEnum';
+import { IsMdmCoherentConstraint } from '../../validators/IsMdmCoherentConstraint';
+
+/** Body de PUT /retailers/:retailerId/products/:sku — actualización parcial (sku y status son inmutables acá). */
+export class UpdateProductRequest {
+    @IsOptional()
+    @IsString()
+    externalId?: string | null;
+
+    @IsOptional()
+    @IsString()
+    brand?: string;
+
+    @IsOptional()
+    @IsString()
+    model?: string;
+
+    @IsOptional()
+    @IsString()
+    capacity?: string;
+
+    @IsOptional()
+    @IsString()
+    color?: string;
+
+    @IsOptional()
+    @IsString()
+    description?: string;
+
+    @IsOptional()
+    @IsObject()
+    specs?: Record<string, unknown> | null;
+
+    @IsOptional()
+    @IsString()
+    imageUrl?: string | null;
+
+    @IsOptional()
+    @IsEnum(ProductTierEnum)
+    tier?: ProductTierEnum;
+
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    basePriceCents?: number;
+
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    listPriceCents?: number | null;
+
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    eligibleFinanciers?: string[];
+
+    @Validate(IsMdmCoherentConstraint)
+    @IsOptional()
+    @IsBoolean()
+    mdmEnabled?: boolean;
+
+    @IsOptional()
+    @IsEnum(MdmProviderEnum)
+    mdmProvider?: MdmProviderEnum | null;
+
+    @IsOptional()
+    @IsEnum(MdmLockModeEnum)
+    mdmLockMode?: MdmLockModeEnum | null;
+}

package/src/retailCatalog/dtos/requests/UpdateProductStatusRequest.ts

@@ -0,0 +1,8 @@
+import { IsEnum } from 'class-validator';
+import { ProductStatusEnum } from '../../enums/ProductStatusEnum';
+
+/** Body de PUT /retailers/:retailerId/products/:sku/status — ACTIVE | DISCONTINUED. */
+export class UpdateProductStatusRequest {
+    @IsEnum(ProductStatusEnum)
+    status!: ProductStatusEnum;
+}

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

@@ -0,0 +1,5 @@
+/** Detalle de una fila rechazada en la carga CSV de productos. */
+export class ImportCsvFailure {
+    fila!: number;
+    motivo!: string;
+}

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

@@ -0,0 +1,7 @@
+import { ImportCsvFailure } from './ImportCsvFailure';
+
+/** Response de POST /retailers/:retailerId/products/import-csv — resultado de la carga masiva. */
+export class ImportCsvResult {
+    committed!: string[];
+    failed!: ImportCsvFailure[];
+}

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

@@ -0,0 +1,4 @@
+import { InventoryItem } from '../InventoryItem';
+
+/** Response de los endpoints de inventario (= entidad InventoryItem). */
+export type InventoryItemResponse = InventoryItem;

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

@@ -0,0 +1,4 @@
+import { Product } from '../Product';
+
+/** Response de los endpoints de producto (= entidad Product). */
+export type ProductResponse = Product;

package/src/retailCatalog/dtos/validation/ValidateInventoryResponse.ts

@@ -0,0 +1,12 @@
+import { InventoryItemStatusEnum } from '../../enums/InventoryItemStatusEnum';
+
+/**
+ * Response de GET /private/inventory/:imei — validar IMEI + status + store + producto.
+ * Shape de salida → sin class-validator.
+ */
+export class ValidateInventoryResponse {
+    imei!: string;
+    status!: InventoryItemStatusEnum;
+    storeId!: string;
+    productId!: string;
+}

package/src/retailCatalog/dtos/validation/ValidateProductResponse.ts

@@ -0,0 +1,21 @@
+import { MdmLockModeEnum } from '../../enums/MdmLockModeEnum';
+import { MdmProviderEnum } from '../../enums/MdmProviderEnum';
+import { ProductStatusEnum } from '../../enums/ProductStatusEnum';
+import { ProductTierEnum } from '../../enums/ProductTierEnum';
+
+/**
+ * Response de GET /private/products/:retailerId/:sku — validar que el producto existe + status.
+ * Incluye los campos que los downstream consumen: `eligibleFinanciers` (wizard F2 paso 4)
+ * y la config MDM (device router F4+). Shape de salida → sin class-validator.
+ */
+export class ValidateProductResponse {
+    productId!: string;
+    retailerId!: string;
+    sku!: string;
+    status!: ProductStatusEnum;
+    tier!: ProductTierEnum;
+    eligibleFinanciers!: string[];
+    mdmEnabled!: boolean;
+    mdmProvider!: MdmProviderEnum | null;
+    mdmLockMode!: MdmLockModeEnum | null;
+}

package/src/retailCatalog/enums/InventoryItemStatusEnum.ts

@@ -0,0 +1,18 @@
+/**
+ * Estado de una unidad física (IMEI) en inventario.
+ * Transiciones: AVAILABLE → RESERVED → SOLD/AVAILABLE (release); RETURNED desde SOLD; DAMAGED.
+ * @enum {string}
+ *
+ * @property {string} AVAILABLE - Disponible en stock.
+ * @property {string} RESERVED - Reservada para una venta en curso.
+ * @property {string} SOLD - Vendida.
+ * @property {string} RETURNED - Devuelta por el cliente.
+ * @property {string} DAMAGED - Dañada, fuera de stock vendible.
+ */
+export enum InventoryItemStatusEnum {
+    AVAILABLE = 'AVAILABLE',
+    RESERVED = 'RESERVED',
+    SOLD = 'SOLD',
+    RETURNED = 'RETURNED',
+    DAMAGED = 'DAMAGED',
+}

package/src/retailCatalog/enums/MdmLockModeEnum.ts

@@ -0,0 +1,17 @@
+/**
+ * Modo de bloqueo MDM. Valores del flow 04 de F1 (ONDEMAND/SCHEDULED).
+ *
+ * TD-007: el `DeviceLockModeEnum` del dominio `mdm` hoy tiene TEMPORARY/FIRM (semántica
+ * distinta: qué tan firme es el lock, no cuándo se dispara). Reconciliación pendiente con
+ * el dueño del dominio `mdm` (decidir reuso vs enum nuevo). En F1 el campo es pasivo
+ * (se guarda, no se ejerce) → no bloqueante.
+ *
+ * @enum {string}
+ *
+ * @property {string} ONDEMAND - El bloqueo se dispara bajo demanda.
+ * @property {string} SCHEDULED - El bloqueo se dispara de forma programada.
+ */
+export enum MdmLockModeEnum {
+    ONDEMAND = 'ONDEMAND',
+    SCHEDULED = 'SCHEDULED',
+}

package/src/retailCatalog/enums/MdmProviderEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * Proveedor MDM (Mobile Device Management) para el enrolamiento de dispositivos (F4+).
+ * @enum {string}
+ *
+ * @property {string} TRUSTONIC - Proveedor Trustonic.
+ * @property {string} DATACULTR - Proveedor Datacultr.
+ */
+export enum MdmProviderEnum {
+    TRUSTONIC = 'TRUSTONIC',
+    DATACULTR = 'DATACULTR',
+}

package/src/retailCatalog/enums/ProductStatusEnum.ts

@@ -0,0 +1,13 @@
+/**
+ * Estado del producto en el catálogo.
+ * @enum {string}
+ *
+ * @property {string} ACTIVE - Producto activo y vendible.
+ * @property {string} INACTIVE - Producto inactivo temporalmente.
+ * @property {string} DISCONTINUED - Producto descontinuado.
+ */
+export enum ProductStatusEnum {
+    ACTIVE = 'ACTIVE',
+    INACTIVE = 'INACTIVE',
+    DISCONTINUED = 'DISCONTINUED',
+}

package/src/retailCatalog/enums/ProductTierEnum.ts

@@ -0,0 +1,15 @@
+/**
+ * Tier comercial del producto (segmenta catálogo por rango de precio/posicionamiento).
+ * @enum {string}
+ *
+ * @property {string} LOW - Gama de entrada.
+ * @property {string} MID - Gama media.
+ * @property {string} HIGH - Gama alta.
+ * @property {string} PREMIUM - Gama premium.
+ */
+export enum ProductTierEnum {
+    LOW = 'LOW',
+    MID = 'MID',
+    HIGH = 'HIGH',
+    PREMIUM = 'PREMIUM',
+}

package/src/retailCatalog/index.ts

@@ -0,0 +1,34 @@
+export * from './enums/ProductTierEnum';
+export * from './enums/ProductStatusEnum';
+export * from './enums/InventoryItemStatusEnum';
+export * from './enums/MdmProviderEnum';
+export * from './enums/MdmLockModeEnum';
+
+// Constantes del dominio
+export * from './constants/SkuPattern';
+
+// Validators custom
+export * from './validators/IsMdmCoherentConstraint';
+
+// Entity DTOs
+export * from './dtos/Product';
+export * from './dtos/InventoryItem';
+
+// Request DTOs (input validado por endpoint)
+export * from './dtos/requests/CreateProductRequest';
+export * from './dtos/requests/UpdateProductRequest';
+export * from './dtos/requests/UpdateProductStatusRequest';
+export * from './dtos/requests/ListProductsQuery';
+export * from './dtos/requests/RegisterInventoryRequest';
+export * from './dtos/requests/TransferInventoryRequest';
+export * from './dtos/requests/ChangeInventoryStatusRequest';
+
+// Response DTOs
+export * from './dtos/responses/ProductResponse';
+export * from './dtos/responses/InventoryItemResponse';
+export * from './dtos/responses/ImportCsvFailure';
+export * from './dtos/responses/ImportCsvResult';
+
+// Validation DTOs (shapes de endpoints privados)
+export * from './dtos/validation/ValidateProductResponse';
+export * from './dtos/validation/ValidateInventoryResponse';

package/src/retailCatalog/validators/IsMdmCoherentConstraint.ts

@@ -0,0 +1,25 @@
+import {
+    ValidatorConstraint,
+    type ValidationArguments,
+    type ValidatorConstraintInterface,
+} from 'class-validator';
+
+/**
+ * Coherencia de la config MDM del producto:
+ * - mdmEnabled === true  → mdmProvider y mdmLockMode obligatorios.
+ * - mdmEnabled !== true   → mdmProvider y mdmLockMode deben omitirse (null/undefined).
+ */
+@ValidatorConstraint({ name: 'isMdmCoherent', async: false })
+export class IsMdmCoherentConstraint implements ValidatorConstraintInterface {
+    validate(_value: unknown, args: ValidationArguments): boolean {
+        const o = args.object as { mdmEnabled?: boolean; mdmProvider?: unknown; mdmLockMode?: unknown };
+        if (o.mdmEnabled === true) {
+            return o.mdmProvider != null && o.mdmLockMode != null;
+        }
+        return o.mdmProvider == null && o.mdmLockMode == null;
+    }
+
+    defaultMessage(): string {
+        return 'Configuración MDM incoherente: con mdmEnabled=true se requieren mdmProvider y mdmLockMode; con mdmEnabled=false deben omitirse';
+    }
+}

package/src/loanConfig/enums/ModifiableByRoleEnum.ts

@@ -1,11 +0,0 @@
-/**
- * Rol RBAC mínimo que puede modificar un parámetro (RBAC a nivel de parámetro, modelo-datos §8).
- * `retailer_admin` = "Admin VentasLuga" de M6 §8. Valores = identificadores de rol de RBAC F0.
- * TD-004: confirmar mapeo super_admin ↔ platform_super_admin con el naming real de F0.
- * @enum {string}
- */
-export enum ModifiableByRoleEnum {
-    SUPER_ADMIN = 'super_admin',
-    SOFOM_ADMIN = 'sofom_admin',
-    RETAILER_ADMIN = 'retailer_admin',
-}