@fiado/type-kit 3.459.0 → 3.461.0

package/_test_/unit/retailCatalog/catalogEnums.test.ts

@@ -0,0 +1,34 @@
+import 'reflect-metadata';
+import * as RetailCatalog from '../../../src/retailCatalog';
+
+describe('retailCatalog — enums del inventario multi-item', () => {
+  it('expone las categorías de producto', () => {
+    expect(Object.values(RetailCatalog.ProductCategoryEnum)).toEqual(['PHONE', 'SIM', 'MODEM', 'ACCESSORY', 'BUNDLE']);
+  });
+
+  it('expone los modos de rastreo', () => {
+    expect(Object.values(RetailCatalog.TrackingModeEnum)).toEqual(['IMEI', 'SERIAL', 'QUANTITY']);
+  });
+
+  it('expone los tipos de movimiento', () => {
+    expect(Object.values(RetailCatalog.InventoryMovementTypeEnum)).toEqual([
+      'ENTRY', 'RESERVATION', 'RELEASE', 'SALE', 'RETURN', 'ADJUSTMENT',
+    ]);
+  });
+
+  it('expone el resultado por ítem de la puerta de entrada y sus códigos de rechazo', () => {
+    expect(Object.values(RetailCatalog.InventorySyncResultStatusEnum)).toEqual(['APPLIED', 'NOOP', 'REJECTED']);
+    expect(Object.values(RetailCatalog.InventorySyncRejectionCodeEnum)).toEqual([
+      'DUPLICATE_IDENTIFIER', 'ADJUSTMENT_EXCEEDS_AVAILABLE', 'FUTURE_PRICE_NOT_SUPPORTED',
+    ]);
+  });
+
+  it('expone el origen del precio y los periodos del lente', () => {
+    expect(Object.values(RetailCatalog.PriceSourceEnum)).toEqual(['ZENTRAL_SYNC']);
+    expect(Object.values(RetailCatalog.InventoryLensPeriodEnum)).toEqual(['7d', '30d', '90d', 'all']);
+  });
+
+  it('agrega el modo lista al filtro del lente sin quitar los existentes', () => {
+    expect(Object.values(RetailCatalog.InventoryLensFilterEnum)).toEqual(['critical', 'stale', 'gap', 'transfers', 'list']);
+  });
+});

package/_test_/unit/retailCatalog/stockRequests.test.ts

@@ -0,0 +1,156 @@
+import 'reflect-metadata';
+import { plainToInstance, type ClassConstructor } from 'class-transformer';
+import { validateSync, type ValidationError } from 'class-validator';
+import {
+  GetInventorySkuQuery,
+  InventoryLensFilterEnum,
+  InventoryLensQuery,
+  MdmLockModeEnum,
+  MdmProviderEnum,
+  ProductCategoryEnum,
+  ReleaseStockRequest,
+  RenewReservationsRequest,
+  ReserveStockRequest,
+  ReturnStockRequest,
+  SellStockRequest,
+  SuggestPiecesQuery,
+  SyncInventoryRequest,
+  TrackingModeEnum,
+} from '../../../src/retailCatalog';
+
+function paths(errors: ValidationError[], prefix = ''): string[] {
+  return errors.flatMap((e) => {
+    const p = prefix ? `${prefix}.${e.property}` : e.property;
+    return e.children && e.children.length > 0 ? paths(e.children, p) : [p];
+  });
+}
+
+function errorsOf<T extends object>(cls: ClassConstructor<T>, payload: object): string[] {
+  return paths(validateSync(plainToInstance(cls, payload) as object));
+}
+
+const saleLine = { lineId: 'L1', sku: 'KIT-1', qty: 1, components: [{ sku: 'SIM-1', qty: 1, identifiers: ['8952'] }] };
+
+describe('ReserveStockRequest', () => {
+  const ok = { sessionId: 's', lineId: 'L1', reservationId: 'r', retailerId: 'ret', sku: 'SKU-1', qty: 2 };
+  it('acepta un request completo', () => expect(errorsOf(ReserveStockRequest, ok)).toEqual([]));
+  it('rechaza qty menor a 1', () => expect(errorsOf(ReserveStockRequest, { ...ok, qty: 0 })).toContain('qty'));
+  it('rechaza sin reservationId', () => {
+    const { reservationId: _omit, ...rest } = ok;
+    expect(errorsOf(ReserveStockRequest, rest)).toContain('reservationId');
+  });
+});
+
+describe('RenewReservationsRequest y ReleaseStockRequest', () => {
+  it('acepta líneas con lineId y reservationId', () => {
+    expect(errorsOf(RenewReservationsRequest, { sessionId: 's', lines: [{ lineId: 'L1', reservationId: 'r' }] })).toEqual([]);
+  });
+  it('valida cada línea anidada', () => {
+    expect(errorsOf(RenewReservationsRequest, { sessionId: 's', lines: [{ lineId: 'L1' }] })).toContain('lines.0.reservationId');
+  });
+  it('release exige onlyExpired booleano', () => {
+    const base = { sessionId: 's', lines: [{ lineId: 'L1', reservationId: 'r' }] };
+    expect(errorsOf(ReleaseStockRequest, { ...base, onlyExpired: false })).toEqual([]);
+    expect(errorsOf(ReleaseStockRequest, base)).toContain('onlyExpired');
+  });
+});
+
+describe('SuggestPiecesQuery', () => {
+  it('acepta un prefijo de 4 caracteres', () => expect(errorsOf(SuggestPiecesQuery, { sku: 'SKU-1', prefix: '3569' })).toEqual([]));
+  it('rechaza un prefijo corto', () => expect(errorsOf(SuggestPiecesQuery, { sku: 'SKU-1', prefix: '356' })).toContain('prefix'));
+});
+
+describe('SellStockRequest y ReturnStockRequest', () => {
+  it('acepta una venta con componentes e identificadores', () => {
+    expect(errorsOf(SellStockRequest, { sessionId: 's', retailerId: 'ret', lines: [saleLine] })).toEqual([]);
+  });
+  it('valida los identificadores del componente', () => {
+    const bad = { ...saleLine, components: [{ sku: 'SIM-1', qty: 1, identifiers: [123] }] };
+    expect(errorsOf(SellStockRequest, { sessionId: 's', retailerId: 'ret', lines: [bad] })).toContain('lines.0.components.0.identifiers');
+  });
+  it('devolución exige saleId y soldAt ISO', () => {
+    const ok = { saleId: 'sale', retailerId: 'ret', soldAt: '2026-09-23T10:00:00.000Z', lines: [saleLine] };
+    expect(errorsOf(ReturnStockRequest, ok)).toEqual([]);
+    expect(errorsOf(ReturnStockRequest, { ...ok, soldAt: 'ayer' })).toContain('soldAt');
+  });
+});
+
+describe('SyncInventoryRequest', () => {
+  const product = {
+    sku: 'KIT-1',
+    category: ProductCategoryEnum.BUNDLE,
+    trackingMode: TrackingModeEnum.QUANTITY,
+    sellable: true,
+    showInSalesFlow: true,
+    eligibleFinanciers: ['SUREKEEP'],
+    components: [{ sku: 'SIM-1', qty: 1 }],
+    tier: null,
+    price: { listPriceCents: 100000, basePriceCents: 90000, effectiveFrom: '2026-09-23T00:00:00.000Z' },
+  };
+  it('acepta productos y stock por cantidad o por identificadores', () => {
+    const stock = [{ storeId: 'st', sku: 'SIM-1', qty: 5 }, { storeId: 'st', sku: 'PH-1', identifiers: ['356938035643809'] }];
+    expect(errorsOf(SyncInventoryRequest, { products: [product], stock })).toEqual([]);
+  });
+  it('rechaza categoría desconocida y precio sin vigencia', () => {
+    const bad = { ...product, category: 'TABLET', price: { basePriceCents: 1 } };
+    const errors = errorsOf(SyncInventoryRequest, { products: [bad], stock: [] });
+    expect(errors).toEqual(expect.arrayContaining(['products.0.category', 'products.0.price.effectiveFrom']));
+  });
+  it('valida los componentes del kit', () => {
+    const bad = { ...product, components: [{ sku: 'SIM-1', qty: 0 }] };
+    expect(errorsOf(SyncInventoryRequest, { products: [bad], stock: [] })).toContain('products.0.components.0.qty');
+  });
+  it('acepta los datos descriptivos y MDM del producto nuevo', () => {
+    const full = {
+      ...product,
+      brand: 'Samsung',
+      model: 'A15',
+      capacity: '128GB',
+      color: 'Negro',
+      description: 'Equipo de gama media',
+      imageUrl: 'https://cdn.example.com/a15.png',
+      mdmEnabled: true,
+      mdmProvider: MdmProviderEnum.TRUSTONIC,
+      mdmLockMode: MdmLockModeEnum.ONDEMAND,
+    };
+    expect(errorsOf(SyncInventoryRequest, { products: [full], stock: [] })).toEqual([]);
+  });
+  it('acepta mdmProvider y mdmLockMode en null', () => {
+    const noMdm = { ...product, mdmEnabled: false, mdmProvider: null, mdmLockMode: null };
+    expect(errorsOf(SyncInventoryRequest, { products: [noMdm], stock: [] })).toEqual([]);
+  });
+  it('rechaza tipos incorrectos en los datos descriptivos y MDM', () => {
+    const bad = {
+      ...product,
+      brand: 1,
+      model: 2,
+      capacity: 3,
+      color: 4,
+      description: 5,
+      imageUrl: 6,
+      mdmEnabled: 'yes',
+      mdmProvider: 'ACME',
+      mdmLockMode: 'NEVER',
+    };
+    const errors = errorsOf(SyncInventoryRequest, { products: [bad], stock: [] });
+    const fields = ['brand', 'model', 'capacity', 'color', 'description', 'imageUrl', 'mdmEnabled', 'mdmProvider', 'mdmLockMode'];
+    expect(errors).toEqual(expect.arrayContaining(fields.map((f) => `products.0.${f}`)));
+  });
+});
+
+describe('InventoryLensQuery en modo lista', () => {
+  it('acepta filter=list con period y storeId', () => {
+    expect(errorsOf(InventoryLensQuery, { filter: InventoryLensFilterEnum.LIST, period: '30d', storeId: 'st' })).toEqual([]);
+  });
+  it('sigue aceptando filter solo', () => expect(errorsOf(InventoryLensQuery, { filter: 'critical' })).toEqual([]));
+  it('rechaza un periodo desconocido', () => expect(errorsOf(InventoryLensQuery, { filter: 'list', period: '15d' })).toContain('period'));
+});
+
+describe('GetInventorySkuQuery', () => {
+  it('convierte limit del query string a número', () => {
+    const dto = plainToInstance(GetInventorySkuQuery, { limit: '20', period: '7d' });
+    expect(dto.limit).toBe(20);
+    expect(validateSync(dto)).toEqual([]);
+  });
+  it('rechaza limit fuera de rango', () => expect(errorsOf(GetInventorySkuQuery, { limit: '0' })).toContain('limit'));
+});

package/_test_/unit/retailWizard/multiItemRequests.test.ts

@@ -0,0 +1,114 @@
+import 'reflect-metadata';
+import { plainToInstance, type ClassConstructor } from 'class-transformer';
+import { validateSync, type ValidationError } from 'class-validator';
+import {
+  AddProductRequest,
+  CompleteSaleRequest,
+  DeleteProductRequest,
+  QuoteRequest,
+  SuggestIdentifiersQuery,
+} from '../../../src/retailWizard';
+
+function paths(errors: ValidationError[], prefix = ''): string[] {
+  return errors.flatMap((e) => {
+    const p = prefix ? `${prefix}.${e.property}` : e.property;
+    return e.children && e.children.length > 0 ? paths(e.children, p) : [p];
+  });
+}
+
+function toDto<T extends object>(cls: ClassConstructor<T>, payload: object): T {
+  return plainToInstance(cls, payload, { excludeExtraneousValues: true });
+}
+
+function errorsOf<T extends object>(cls: ClassConstructor<T>, payload: object): string[] {
+  return paths(validateSync(toDto(cls, payload) as object));
+}
+
+describe('AddProductRequest — qty por línea', () => {
+  it('acepta solo el sku (qty ausente = 1 lo resuelve el silo)', () => {
+    expect(errorsOf(AddProductRequest, { sku: 'SKU-1' })).toEqual([]);
+  });
+  it('acepta qty explícita', () => {
+    expect(errorsOf(AddProductRequest, { sku: 'SKU-1', qty: 3 })).toEqual([]);
+    expect(toDto(AddProductRequest, { sku: 'SKU-1', qty: 3 }).qty).toBe(3);
+  });
+  it('rechaza qty menor a 1', () => {
+    expect(errorsOf(AddProductRequest, { sku: 'SKU-1', qty: 0 })).toContain('qty');
+  });
+  it('rechaza qty no entera', () => {
+    expect(errorsOf(AddProductRequest, { sku: 'SKU-1', qty: 1.5 })).toContain('qty');
+  });
+});
+
+describe('DeleteProductRequest — quitar por lineId', () => {
+  it('acepta lineId', () => {
+    expect(errorsOf(DeleteProductRequest, { lineId: 'L1' })).toEqual([]);
+    expect(toDto(DeleteProductRequest, { lineId: 'L1' }).lineId).toBe('L1');
+  });
+  it('sigue aceptando el request vacío', () => {
+    expect(errorsOf(DeleteProductRequest, {})).toEqual([]);
+  });
+  it('rechaza lineId que no es string', () => {
+    expect(errorsOf(DeleteProductRequest, { lineId: 7 })).toContain('lineId');
+  });
+});
+
+describe('QuoteRequest — financedLineId', () => {
+  const base = { downPaymentCents: 1000, termWeeks: 12 };
+  it('acepta sin financedLineId (compat)', () => {
+    expect(errorsOf(QuoteRequest, base)).toEqual([]);
+  });
+  it('acepta financedLineId', () => {
+    expect(errorsOf(QuoteRequest, { ...base, financedLineId: 'L2' })).toEqual([]);
+    expect(toDto(QuoteRequest, { ...base, financedLineId: 'L2' }).financedLineId).toBe('L2');
+  });
+  it('rechaza financedLineId vacío', () => {
+    expect(errorsOf(QuoteRequest, { ...base, financedLineId: '' })).toContain('financedLineId');
+  });
+});
+
+describe('CompleteSaleRequest — líneas con identificadores por componente', () => {
+  const ok = {
+    lines: [
+      { lineId: 'L1', components: [{ sku: 'PHONE-1', identifiers: ['356938035643809'] }] },
+      { lineId: 'L2', components: [{ sku: 'SIM-1', identifiers: ['8952140'] }, { sku: 'CASE-1', identifiers: [] }] },
+    ],
+  };
+  it('acepta un request completo', () => {
+    expect(errorsOf(CompleteSaleRequest, ok)).toEqual([]);
+    const dto = toDto(CompleteSaleRequest, ok);
+    expect(dto.lines[1].components[0].identifiers).toEqual(['8952140']);
+  });
+  it('acepta lista de líneas vacía (venta solo por cantidad)', () => {
+    expect(errorsOf(CompleteSaleRequest, { lines: [] })).toEqual([]);
+  });
+  it('acepta sin lines (front sin body)', () => {
+    expect(errorsOf(CompleteSaleRequest, {})).toEqual([]);
+  });
+  it('rechaza lines que no es arreglo', () => {
+    expect(errorsOf(CompleteSaleRequest, { lines: 'L1' })).toContain('lines');
+  });
+  it('rechaza una línea sin lineId', () => {
+    expect(errorsOf(CompleteSaleRequest, { lines: [{ components: [] }] })).toContain('lines.0.lineId');
+  });
+  it('rechaza un identificador que no es string', () => {
+    const bad = { lines: [{ lineId: 'L1', components: [{ sku: 'SIM-1', identifiers: [123] }] }] };
+    expect(errorsOf(CompleteSaleRequest, bad)).toContain('lines.0.components.0.identifiers');
+  });
+  it('rechaza un componente sin sku', () => {
+    const bad = { lines: [{ lineId: 'L1', components: [{ identifiers: ['x'] }] }] };
+    expect(errorsOf(CompleteSaleRequest, bad)).toContain('lines.0.components.0.sku');
+  });
+});
+
+describe('SuggestIdentifiersQuery — prefijo mínimo 4', () => {
+  it('acepta sku y prefijo de 4', () => {
+    expect(errorsOf(SuggestIdentifiersQuery, { sku: 'SIM-1', prefix: '8952' })).toEqual([]);
+  });
+  it('rechaza prefijo corto', () => {
+    expect(errorsOf(SuggestIdentifiersQuery, { sku: 'SIM-1', prefix: '895' })).toContain('prefix');
+  });
+  it('rechaza sin sku', () => {
+    expect(errorsOf(SuggestIdentifiersQuery, { prefix: '8952' })).toContain('sku');
+  });
+});

package/_test_/unit/retailWizard/multiItemShapes.test.ts

@@ -0,0 +1,126 @@
+import 'reflect-metadata';
+import {
+  LinePaymentTypeEnum,
+  WizardLineStatusEnum,
+  type Sale,
+  type SaleLine,
+  type WizardProduct,
+  type WizardReservedLine,
+  type WizardSession,
+} from '../../../src/retailWizard';
+import { MdmProviderEnum, ProductCategoryEnum, TrackingModeEnum } from '../../../src/retailCatalog';
+
+describe('enums del inventario multi-item', () => {
+  it('WizardLineStatusEnum tiene los 3 estados de la línea', () => {
+    expect(Object.values(WizardLineStatusEnum)).toEqual(['PENDING', 'RESERVED', 'RELEASING']);
+  });
+  it('LinePaymentTypeEnum distingue crédito y contado', () => {
+    expect(Object.values(LinePaymentTypeEnum)).toEqual(['CREDIT', 'CASH']);
+  });
+});
+
+describe('formas de sesión, línea y venta', () => {
+  const kitLine: WizardReservedLine = {
+    lineId: 'L1',
+    sku: 'KIT-1',
+    qty: 1,
+    status: WizardLineStatusEnum.RESERVED,
+    reservationId: 'r-1',
+    expiresAt: '2026-09-23T20:30:00.000Z',
+    basePriceCents: 500000,
+    listPriceCents: 550000,
+    priceSk: '2026-09-01T00:00:00.000Z',
+    eligibleFinanciers: ['SUREKEEP'],
+    financeable: true,
+    paymentType: LinePaymentTypeEnum.CREDIT,
+    sellItemCost: 2,
+    mdmEnabled: true,
+    mdmProvider: MdmProviderEnum.TRUSTONIC,
+    components: [
+      { sku: 'PHONE-1', qty: 1, category: ProductCategoryEnum.PHONE, trackingMode: TrackingModeEnum.IMEI },
+      { sku: 'SIM-1', qty: 1, category: ProductCategoryEnum.SIM, trackingMode: TrackingModeEnum.SERIAL },
+    ],
+    identifiers: [
+      { sku: 'PHONE-1', identifiers: ['356938035643809'] },
+      { sku: 'SIM-1', identifiers: ['8952140'] },
+    ],
+    product: {
+      brand: 'Moto',
+      model: 'G',
+      capacity: '128GB',
+      color: 'Negro',
+      imageUrl: null,
+      tier: null,
+      category: ProductCategoryEnum.BUNDLE,
+      trackingMode: TrackingModeEnum.QUANTITY,
+    },
+  };
+
+  const pendingLine: WizardReservedLine = {
+    lineId: 'L2',
+    sku: 'CASE-1',
+    qty: 2,
+    status: WizardLineStatusEnum.PENDING,
+    reservationId: 'r-2',
+    expiresAt: '2026-09-23T20:30:00.000Z',
+    basePriceCents: null,
+    listPriceCents: null,
+    priceSk: null,
+    eligibleFinanciers: [],
+    financeable: false,
+    paymentType: null,
+    sellItemCost: null,
+  };
+
+  it('la sesión acepta reservedLines y financedLineId sin tocar los campos espejo', () => {
+    const session: Pick<WizardSession, 'reservedLines' | 'financedLineId' | 'reservedSku' | 'reservedImei'> = {
+      reservedLines: [kitLine, pendingLine],
+      financedLineId: 'L1',
+      reservedSku: 'PHONE-1',
+      reservedImei: '356938035643809',
+    };
+    expect(session.reservedLines).toHaveLength(2);
+  });
+
+  it('WizardProduct acepta lineId, categoría y rastreo como espejo', () => {
+    const product: WizardProduct = {
+      sku: 'PHONE-1',
+      imei: '356938035643809',
+      cashPriceCents: 500000,
+      brand: 'Moto',
+      model: 'G',
+      capacity: '128GB',
+      color: 'Negro',
+      imageUrl: null,
+      tier: 'MID',
+      eligibleFinanciers: ['SUREKEEP'],
+      lineId: 'L1',
+      category: ProductCategoryEnum.PHONE,
+      trackingMode: TrackingModeEnum.IMEI,
+    };
+    expect(product.lineId).toBe('L1');
+  });
+
+  it('la venta acepta lines, skus e inventoryReturnPending', () => {
+    const line: SaleLine = {
+      lineId: 'L1',
+      sku: 'KIT-1',
+      qty: 1,
+      basePriceCents: 500000,
+      listPriceCents: 550000,
+      priceSk: '2026-09-01T00:00:00.000Z',
+      paymentType: LinePaymentTypeEnum.CREDIT,
+      components: [
+        { sku: 'PHONE-1', qty: 1, identifiers: ['356938035643809'] },
+        { sku: 'SIM-1', qty: 1, identifiers: ['8952140'] },
+      ],
+    };
+    const sale: Pick<Sale, 'lines' | 'skus' | 'inventoryReturnPending' | 'sku'> = {
+      lines: [line],
+      skus: ['KIT-1', 'PHONE-1', 'SIM-1'],
+      inventoryReturnPending: false,
+      sku: 'PHONE-1',
+    };
+    expect(sale.lines?.[0].components).toHaveLength(2);
+  });
+});

package/bin/card/enums/Status.d.ts

@@ -3,5 +3,10 @@ export declare enum Status {
     PENDING = "PENDING",
     PAUSED = "PAUSED",
     CANCELLED = "CANCELLED",
-    PIN_BLOCKED = "PIN_BLOCKED"
+    PIN_BLOCKED = "PIN_BLOCKED",
+    /**
+     * Bloqueo por fraude decidido por el emisor (CP: `card.status.fraud_blocked`,
+     * `card.status = FRAUD_BLOCK`). No lo puede quitar el usuario desde la app.
+     */
+    FRAUD_BLOCK = "FRAUD_BLOCK"
 }

package/bin/card/enums/Status.js

@@ -8,4 +8,9 @@ var Status;
     Status["PAUSED"] = "PAUSED";
     Status["CANCELLED"] = "CANCELLED";
     Status["PIN_BLOCKED"] = "PIN_BLOCKED";
+    /**
+     * Bloqueo por fraude decidido por el emisor (CP: `card.status.fraud_blocked`,
+     * `card.status = FRAUD_BLOCK`). No lo puede quitar el usuario desde la app.
+     */
+    Status["FRAUD_BLOCK"] = "FRAUD_BLOCK";
 })(Status || (exports.Status = Status = {}));

package/bin/retailCatalog/dtos/Product.d.ts

@@ -2,6 +2,9 @@ import { MdmLockModeEnum } from '../enums/MdmLockModeEnum';
 import { MdmProviderEnum } from '../enums/MdmProviderEnum';
 import { ProductStatusEnum } from '../enums/ProductStatusEnum';
 import { ProductTierEnum } from '../enums/ProductTierEnum';
+import { ProductCategoryEnum } from '../enums/ProductCategoryEnum';
+import { TrackingModeEnum } from '../enums/TrackingModeEnum';
+import { ProductComponent } from './ProductComponent';
 /**
  * Product — aggregate root del catálogo del dominio `retailCatalog`
  * (lambda retail-catalog-business, SureKeep Fase 1 — pista Retail).
@@ -19,7 +22,8 @@ export declare class Product {
     description: string;
     specs: Record<string, unknown> | null;
     imageUrl: string | null;
-    tier: ProductTierEnum;
+    /** `null` = Sin gama. */
+    tier: ProductTierEnum | null;
     basePriceCents: number;
     listPriceCents: number | null;
     eligibleFinanciers: string[];
@@ -31,4 +35,14 @@ export declare class Product {
     updatedBy: string;
     createdAt: string;
     updatedAt: string;
+    category?: ProductCategoryEnum;
+    trackingMode?: TrackingModeEnum;
+    /** Se puede vender suelto (fuera de un kit). */
+    sellable?: boolean;
+    /** Aparece en el catálogo del flujo de venta. */
+    showInSalesFlow?: boolean;
+    /** Solo en BUNDLE. */
+    components?: ProductComponent[] | null;
+    /** Llave del registro PRICE# del que salen basePriceCents y listPriceCents. */
+    currentPriceSk?: string | null;
 }

package/bin/retailCatalog/dtos/ProductComponent.d.ts

@@ -0,0 +1,5 @@
+/** Componente de un kit (BUNDLE): qué SKU consume y cuántas piezas por kit. */
+export declare class ProductComponent {
+    sku: string;
+    qty: number;
+}

package/bin/retailCatalog/dtos/ProductComponent.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.ProductComponent = void 0;
+const class_validator_1 = require("class-validator");
+const SkuPattern_1 = require("../constants/SkuPattern");
+/** Componente de un kit (BUNDLE): qué SKU consume y cuántas piezas por kit. */
+class ProductComponent {
+}
+exports.ProductComponent = ProductComponent;
+__decorate([
+    (0, class_validator_1.Matches)(SkuPattern_1.SKU_PATTERN, { message: 'sku admite solo [A-Za-z0-9-]' }),
+    (0, class_validator_1.Length)(1, 64),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ProductComponent.prototype, "sku", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], ProductComponent.prototype, "qty", void 0);

package/bin/retailCatalog/dtos/requests/GetInventorySkuQuery.d.ts

@@ -0,0 +1,10 @@
+import { InventoryLensPeriodEnum } from '../../enums/InventoryLensPeriodEnum';
+/** Query de GET /backoffice/inventory/skus/{sku} (backofficeGetInventorySku); el retailer sale del token. */
+export declare class GetInventorySkuQuery {
+    period?: InventoryLensPeriodEnum;
+    /** Debe pertenecer al retailer del token. */
+    storeId?: string;
+    /** Tamaño de página del libro de movimientos. */
+    limit?: number;
+    nextToken?: string;
+}

package/bin/retailCatalog/dtos/requests/GetInventorySkuQuery.js

@@ -0,0 +1,42 @@
+"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.GetInventorySkuQuery = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const InventoryLensPeriodEnum_1 = require("../../enums/InventoryLensPeriodEnum");
+/** Query de GET /backoffice/inventory/skus/{sku} (backofficeGetInventorySku); el retailer sale del token. */
+class GetInventorySkuQuery {
+}
+exports.GetInventorySkuQuery = GetInventorySkuQuery;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(InventoryLensPeriodEnum_1.InventoryLensPeriodEnum),
+    __metadata("design:type", String)
+], GetInventorySkuQuery.prototype, "period", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], GetInventorySkuQuery.prototype, "storeId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], GetInventorySkuQuery.prototype, "limit", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], GetInventorySkuQuery.prototype, "nextToken", void 0);

package/bin/retailCatalog/dtos/requests/InventoryLensQuery.d.ts

@@ -1,4 +1,5 @@
 import { InventoryLensFilterEnum } from '../../enums/InventoryLensFilterEnum';
+import { InventoryLensPeriodEnum } from '../../enums/InventoryLensPeriodEnum';
 /**
  * Query string de `GET /backoffice/inventory/lens`. SureKeep Fase 3 — pista Retail.
  *
@@ -10,4 +11,8 @@ import { InventoryLensFilterEnum } from '../../enums/InventoryLensFilterEnum';
  */
 export declare class InventoryLensQuery {
     filter: InventoryLensFilterEnum;
+    /** Solo `filter=list`: periodo de ventas y cobertura. */
+    period?: InventoryLensPeriodEnum;
+    /** Solo `filter=list`: una tienda del retailer del token; ausente = consolidado. */
+    storeId?: string;
 }

package/bin/retailCatalog/dtos/requests/InventoryLensQuery.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.InventoryLensQuery = void 0;
 const class_validator_1 = require("class-validator");
 const InventoryLensFilterEnum_1 = require("../../enums/InventoryLensFilterEnum");
+const InventoryLensPeriodEnum_1 = require("../../enums/InventoryLensPeriodEnum");
 /**
  * Query string de `GET /backoffice/inventory/lens`. SureKeep Fase 3 — pista Retail.
  *
@@ -28,3 +29,13 @@ __decorate([
     (0, class_validator_1.IsEnum)(InventoryLensFilterEnum_1.InventoryLensFilterEnum),
     __metadata("design:type", String)
 ], InventoryLensQuery.prototype, "filter", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(InventoryLensPeriodEnum_1.InventoryLensPeriodEnum),
+    __metadata("design:type", String)
+], InventoryLensQuery.prototype, "period", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], InventoryLensQuery.prototype, "storeId", void 0);

package/bin/retailCatalog/dtos/requests/ReleaseStockRequest.d.ts

@@ -0,0 +1,8 @@
+import { ReservationLineRef } from './ReservationLineRef';
+/** Body de PUT /private/stores/{storeId}/reservations/release (privateReleaseStock). */
+export declare class ReleaseStockRequest {
+    sessionId: string;
+    lines: ReservationLineRef[];
+    /** `true` = solo libera las reservas ya vencidas (barrido). */
+    onlyExpired: boolean;
+}

package/bin/retailCatalog/dtos/requests/ReleaseStockRequest.js

@@ -0,0 +1,34 @@
+"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.ReleaseStockRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ReservationLineRef_1 = require("./ReservationLineRef");
+/** Body de PUT /private/stores/{storeId}/reservations/release (privateReleaseStock). */
+class ReleaseStockRequest {
+}
+exports.ReleaseStockRequest = ReleaseStockRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ReleaseStockRequest.prototype, "sessionId", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => ReservationLineRef_1.ReservationLineRef),
+    __metadata("design:type", Array)
+], ReleaseStockRequest.prototype, "lines", void 0);
+__decorate([
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], ReleaseStockRequest.prototype, "onlyExpired", void 0);