@fiado/type-kit 3.472.0 → 3.474.0

package/src/retailCatalog/events/InventorySaleAppliedMessage.ts

@@ -0,0 +1,26 @@
+import { Equals, IsISO8601, IsNotEmpty, IsString } from 'class-validator';
+import { InventoryInboundMessageTypeEnum } from '../enums/InventoryInboundMessageTypeEnum';
+import { SellStockRequest } from '../dtos/requests/SellStockRequest';
+
+/** Aviso de venta de la saga en la cola de inventario; el catálogo pasa las piezas HELD a SOLD. */
+export class InventorySaleAppliedMessage extends SellStockRequest {
+    @Equals(InventoryInboundMessageTypeEnum.SALE_APPLIED)
+    type!: InventoryInboundMessageTypeEnum.SALE_APPLIED;
+
+    /** La cola es compartida entre silos; el tenant elige las tablas. */
+    @IsString()
+    @IsNotEmpty()
+    tenantId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    storeId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    saleId!: string;
+
+    /** Fecha de la venta; fecha el DAY# y el MOV#. */
+    @IsISO8601()
+    soldAt!: string;
+}

package/src/retailCatalog/index.ts

@@ -45,6 +45,7 @@ export * from './dtos/validation/ValidateInventoryResponse';
 
 // Inventario multi-item (ciclo 1)
 export * from './enums/ProductCategoryEnum';
+export * from './enums/AccessorySubcategoryEnum';
 export * from './enums/TrackingModeEnum';
 export * from './enums/InventoryMovementTypeEnum';
 export * from './enums/InventorySyncResultStatusEnum';
@@ -92,3 +93,12 @@ export * from './dtos/requests/BackofficeCreateTransferRequest';
 export * from './dtos/requests/BackofficeListTransfersQuery';
 export * from './dtos/responses/TransferResponse';
 export * from './dtos/responses/ListTransfersResponse';
+
+// Saga de venta: hold y avisos de la cola
+export * from './enums/ReservePurposeEnum';
+export * from './enums/InventoryInboundMessageTypeEnum';
+export * from './dtos/requests/HoldStockRequest';
+export * from './dtos/responses/HoldStockResponse';
+export * from './events/InventorySaleAppliedMessage';
+export * from './events/InventoryReturnMessage';
+export * from './events/InventoryInboundMessage';

package/src/retailPromotions/constants/bonusPreMoney.ts

@@ -0,0 +1,19 @@
+/** HTTP con los que el request no llegó al handler del processor: los contesta la infraestructura. */
+export const PRE_HANDLER_HTTP_STATUSES: ReadonlySet<number> = new Set([401, 403, 404, 405]);
+
+/**
+ * Codes de transaction-processor que prueban que el bono NO movió saldo.
+ * Es whitelist: cualquier otro code se trata como ambiguo (`UNVERIFIED`).
+ */
+export const BONUS_PRE_MONEY_CODES: ReadonlySet<string> = new Set<string>([
+    'USER_NOT_ACTIVE',
+    'ACCOUNT_NOT_FOUND',
+    'ACCOUNT_BLOCKED',
+    'DOCUMENT_ID_NOT_FOUND',
+    'PRODUCT_NOT_FOUND',
+    'ACCOUNT_LEVEL_MAX_MONTHLY_AMOUNT_EXCEEDED',
+    'ACCOUNT_LEVEL_MAX_AVAILABLE_BALANCE_EXCEEDED',
+    'INVALID_REQUEST',
+    // Literal del decorador de idempotencia, no del enum del processor: por eso el Set es de string.
+    'IDEMPOTENCY_KEY_REQUIRED',
+]);

package/src/retailPromotions/constants/retailPromotionsErrorHttpStatus.ts

@@ -0,0 +1,25 @@
+import { RetailPromotionsErrorCodeEnum as C } from '../enums/RetailPromotionsErrorCodeEnum';
+
+/** Status HTTP de cada code: 403 sesión sin alcance · 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
+export const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 403 | 404 | 409 | 422>> = {
+    [C.INVALID_PROMOTION_TRANSITION]: 409,
+    [C.CODE_TEXT_TAKEN]: 409,
+    [C.PROMOTION_NOT_ACTIVE]: 409,
+    [C.PROMOTION_NOT_APPLICABLE]: 422,
+    [C.CUSTOMER_NOT_IDENTIFIED]: 422,
+    [C.GIFT_NOT_ALLOWED]: 422,
+    [C.INSUFFICIENT_STOCK]: 409,
+    [C.CODE_NOT_FOUND]: 404,
+    [C.CODE_NOT_APPLICABLE]: 422,
+    [C.CODE_NOT_OWNED]: 422,
+    [C.CODE_NOT_ACTIVE]: 409,
+    [C.CODE_EXHAUSTED]: 409,
+    [C.CODE_ALREADY_APPLIED]: 409,
+    [C.DISCOUNT_AFTER_QUOTE]: 409,
+    [C.INVALID_SALE_PROMOTION]: 422,
+    [C.INVALID_DISCOUNT_CODE]: 422,
+    [C.SALE_PROMOTION_NOT_FOUND]: 404,
+    [C.SALE_COUPON_NOT_FOUND]: 404,
+    [C.MISSING_RETAILER_SCOPE]: 403,
+    [C.MISSING_STORE_SCOPE]: 403,
+};

package/src/retailPromotions/constants/salePromotionTransitions.ts

@@ -0,0 +1,11 @@
+import { SalePromotionStatusEnum as S } from '../enums/SalePromotionStatusEnum';
+import { SalePromotionTransitionEnum as T } from '../enums/SalePromotionTransitionEnum';
+
+/** Por cada transición: desde qué estados se permite y a cuál lleva. */
+export const SALE_PROMOTION_TRANSITIONS: Readonly<Record<T, { from: readonly S[]; to: S }>> = {
+    [T.PUBLISH]: { from: [S.DRAFT], to: S.ACTIVE },
+    [T.PAUSE]: { from: [S.ACTIVE], to: S.PAUSED },
+    [T.RESUME]: { from: [S.PAUSED], to: S.ACTIVE },
+    [T.EXPIRE]: { from: [S.ACTIVE, S.PAUSED], to: S.EXPIRED },
+    [T.ARCHIVE]: { from: [S.DRAFT, S.ACTIVE, S.PAUSED, S.EXPIRED], to: S.ARCHIVED },
+};

package/src/retailPromotions/dtos/DiscountCode.ts

@@ -0,0 +1,36 @@
+import { CouponScopeEnum } from '../enums/CouponScopeEnum';
+import { CouponStatusEnum } from '../enums/CouponStatusEnum';
+import { DiscountCodeOriginEnum } from '../enums/DiscountCodeOriginEnum';
+import { DiscountCodeStatusEnum } from '../enums/DiscountCodeStatusEnum';
+import { PromotionAppliesToEnum } from '../enums/PromotionAppliesToEnum';
+import { DiscountValue } from './DiscountValue';
+
+/**
+ * Código de descuento de Admin VL o cupón emitido por una venta (según `origin`).
+ * Los campos de cupón (`ownerCustomerId`, `issuedBySaleId`, `couponScope`) son `null` en los de Admin.
+ */
+export interface DiscountCode {
+    codeId: string;
+    codeText: string;
+    origin: DiscountCodeOriginEnum;
+    status: DiscountCodeStatusEnum | CouponStatusEnum;
+    discount: DiscountValue;
+    validFrom: string | null;
+    validUntil: string | null;
+    /** `null` = sin tope de usos. */
+    maxUses: number | null;
+    uses: number;
+    skus: string[] | null;
+    storeIds: string[] | null;
+    announceInStore: boolean;
+    appliesTo: PromotionAppliesToEnum;
+    ownerCustomerId: string | null;
+    issuedBySaleId: string | null;
+    issuingStoreId: string | null;
+    couponScope: CouponScopeEnum | null;
+    redeemedBySaleId: string | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/src/retailPromotions/dtos/DiscountValue.ts

@@ -0,0 +1,8 @@
+import { DiscountTypeEnum } from '../enums/DiscountTypeEnum';
+
+/** Descuento en $ o %: `amountCents` si es `AMOUNT`, `percentBps` (1000 = 10%) si es `PERCENTAGE`. */
+export interface DiscountValue {
+    type: DiscountTypeEnum;
+    amountCents: number | null;
+    percentBps: number | null;
+}

package/src/retailPromotions/dtos/LinePromotionDiscount.ts

@@ -0,0 +1,10 @@
+/** Desglose por línea de la sesión: qué promo o código la tocó y cuánto bajó. */
+export interface LinePromotionDiscount {
+    lineId: string;
+    promotionId: string | null;
+    promotionVersion: number | null;
+    discountCode: string | null;
+    originalPriceCents: number;
+    discountCents: number;
+    finalPriceCents: number;
+}

package/src/retailPromotions/dtos/SalePromotion.ts

@@ -0,0 +1,36 @@
+import { PromotionAppliesToEnum } from '../enums/PromotionAppliesToEnum';
+import { SalePromotionPhaseEnum } from '../enums/SalePromotionPhaseEnum';
+import { SalePromotionStatusEnum } from '../enums/SalePromotionStatusEnum';
+import { SalePromotionLevers, SalePromotionScope, SalePromotionSegmentation } from './SalePromotionLevers';
+
+/** Promo de venta tal como la devuelve el CRUD. Dinero en centavos, fechas ISO. */
+export interface SalePromotion {
+    promotionId: string;
+    retailerId: string;
+    name: string;
+    /** Texto que ve el cliente en el wizard. */
+    customerText: string;
+    levers: SalePromotionLevers;
+    scope: SalePromotionScope;
+    segmentation: SalePromotionSegmentation;
+    appliesTo: PromotionAppliesToEnum;
+    /** `null` = sin tope. */
+    budgetMaxCents: number | null;
+    budgetConsumedCents: number;
+    redemptionCount: number;
+    validFrom: string | null;
+    /** `null` = permanente. */
+    validUntil: string | null;
+    oncePerCustomer: boolean;
+    status: SalePromotionStatusEnum;
+    /** Derivada; `null` cuando el estado no es `ACTIVE`. */
+    phase: SalePromotionPhaseEnum | null;
+    version: number;
+    pausedAt: string | null;
+    pauseReason: string | null;
+    publishedAt: string | null;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+}

package/src/retailPromotions/dtos/SalePromotionLevers.ts

@@ -0,0 +1,68 @@
+import { AccessorySubcategoryEnum } from '../../retailCatalog/enums/AccessorySubcategoryEnum';
+import { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
+import { ProductTierEnum } from '../../retailCatalog/enums/ProductTierEnum';
+import { CouponScopeEnum } from '../enums/CouponScopeEnum';
+import { GiftModeEnum } from '../enums/GiftModeEnum';
+import { DiscountValue } from './DiscountValue';
+
+/** Descuento en accesorios: % sobre los accesorios de la venta, con tope opcional en centavos. */
+export interface AccessoryDiscountLever {
+    percentBps: number;
+    maxAmountCents: number | null;
+}
+
+/** Regalo por lista (`skus`) o por gama (`accessorySubcategory` + `maxPriceCents`); el cliente elige `chooseCount`. */
+export interface GiftLever {
+    mode: GiftModeEnum;
+    skus: string[] | null;
+    accessorySubcategory: AccessorySubcategoryEnum | null;
+    maxPriceCents: number | null;
+    chooseCount: number;
+}
+
+/** Cupón que emite la venta: su descuento, días de vida y dónde vale. */
+export interface CouponLever extends DiscountValue {
+    validityDays: number;
+    scope: CouponScopeEnum;
+}
+
+/** Tiempo aire: `rechargeCount` recargas de `rechargeAmountCents`. */
+export interface AirtimeLever {
+    rechargeCount: number;
+    rechargeAmountCents: number;
+}
+
+/** Garantía extendida: meses extra sobre la de fábrica y su costo para el presupuesto. */
+export interface ExtendedWarrantyLever {
+    extraMonths: number;
+    costCents: number;
+}
+
+export interface WalletBonusLever {
+    amountCents: number;
+}
+
+/** Las 7 palancas; una palanca ausente o `null` no se usa. */
+export interface SalePromotionLevers {
+    deviceDiscount: DiscountValue | null;
+    accessoryDiscount: AccessoryDiscountLever | null;
+    gift: GiftLever | null;
+    coupon: CouponLever | null;
+    airtime: AirtimeLever | null;
+    extendedWarranty: ExtendedWarrantyLever | null;
+    walletBonus: WalletBonusLever | null;
+}
+
+/** Qué compra dispara la promo; cada lista `null` = sin restricción en esa dimensión. */
+export interface SalePromotionScope {
+    productCategories: ProductCategoryEnum[] | null;
+    tiers: ProductTierEnum[] | null;
+    skus: string[] | null;
+    storeIds: string[] | null;
+}
+
+/** A quién va la promo: segmentos de loan-offerings y, aparte, si exige crédito SK activo. */
+export interface SalePromotionSegmentation {
+    segmentIds: string[] | null;
+    requiresActiveSurekeepCredit: boolean;
+}

package/src/retailPromotions/dtos/SalePromotionLogEntry.ts

@@ -0,0 +1,19 @@
+import { SalePromotionLogEventEnum } from '../enums/SalePromotionLogEventEnum';
+import { SalePromotionStatusEnum } from '../enums/SalePromotionStatusEnum';
+
+/** Evento del historial de una promo. */
+export interface SalePromotionLogEntry {
+    logId: string;
+    promotionId: string;
+    promotionName: string;
+    version: number;
+    event: SalePromotionLogEventEnum;
+    fromStatus: SalePromotionStatusEnum | null;
+    toStatus: SalePromotionStatusEnum | null;
+    /** `null` = evento automático del sistema. */
+    performedByUserId: string | null;
+    /** Nombre visible del actor; «Sistema» en los automáticos. */
+    performedByName: string;
+    occurredAt: string;
+    reason: string | null;
+}

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

@@ -0,0 +1,15 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional, IsString } from 'class-validator';
+import { DiscountCodeTransitionEnum } from '../../enums/DiscountCodeTransitionEnum';
+
+/** Body de publicChangeDiscountCodeStatus (anular un código o cupón). */
+export class ChangeDiscountCodeStatusRequest {
+    @Expose()
+    @IsEnum(DiscountCodeTransitionEnum)
+    transition!: DiscountCodeTransitionEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    reason?: string | null;
+}

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

@@ -0,0 +1,15 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional, IsString } from 'class-validator';
+import { SalePromotionTransitionEnum } from '../../enums/SalePromotionTransitionEnum';
+
+/** Body de publicChangeSalePromotionStatus; `reason` queda en el historial. */
+export class ChangeSalePromotionStatusRequest {
+    @Expose()
+    @IsEnum(SalePromotionTransitionEnum)
+    transition!: SalePromotionTransitionEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    reason?: string | null;
+}

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

@@ -0,0 +1,71 @@
+import { Expose, Type } from 'class-transformer';
+import {
+    IsArray,
+    IsBoolean,
+    IsDefined,
+    IsEnum,
+    IsInt,
+    IsISO8601,
+    IsNotEmpty,
+    IsOptional,
+    IsString,
+    MaxLength,
+    ValidateNested,
+} from 'class-validator';
+import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
+import { DiscountValueInput } from './DiscountValueInput';
+
+/** Body de publicCreateDiscountCode. Que el texto sea único entre los vigentes es `CODE_TEXT_TAKEN`. */
+export class CreateDiscountCodeRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(32)
+    codeText!: string;
+
+    @Expose()
+    @IsDefined()
+    @ValidateNested()
+    @Type(() => DiscountValueInput)
+    discount!: DiscountValueInput;
+
+    @Expose()
+    @IsOptional()
+    @IsISO8601()
+    validFrom?: string | null;
+
+    @Expose()
+    @IsOptional()
+    @IsISO8601()
+    validUntil?: string | null;
+
+    /** `null` = sin tope de usos. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    maxUses?: number | null;
+
+    /** Equipos donde vale; `null` = todos. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    skus?: string[] | null;
+
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    storeIds?: string[] | null;
+
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    announceInStore?: boolean;
+
+    /** Ausente = `SUREKEEP_ONLY`. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(PromotionAppliesToEnum)
+    appliesTo?: PromotionAppliesToEnum;
+}

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

@@ -0,0 +1,73 @@
+import { Expose, Type } from 'class-transformer';
+import {
+    IsBoolean,
+    IsDefined,
+    IsEnum,
+    IsInt,
+    IsISO8601,
+    IsNotEmpty,
+    IsOptional,
+    IsString,
+    ValidateNested,
+} from 'class-validator';
+import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
+import { SalePromotionLeversInput } from './SalePromotionLeversInput';
+import { SalePromotionScopeInput, SalePromotionSegmentationInput } from './SalePromotionScopeInput';
+
+/** Body de publicCreateSalePromotion. Nace en `DRAFT`; el retailer sale del token. */
+export class CreateSalePromotionRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    name!: string;
+
+    @Expose()
+    @IsString()
+    customerText!: string;
+
+    @Expose()
+    @IsDefined()
+    @ValidateNested()
+    @Type(() => SalePromotionLeversInput)
+    levers!: SalePromotionLeversInput;
+
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => SalePromotionScopeInput)
+    scope?: SalePromotionScopeInput | null;
+
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => SalePromotionSegmentationInput)
+    segmentation?: SalePromotionSegmentationInput | null;
+
+    /** Ausente = `SUREKEEP_ONLY`. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(PromotionAppliesToEnum)
+    appliesTo?: PromotionAppliesToEnum;
+
+    /** `null` = sin tope. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    budgetMaxCents?: number | null;
+
+    @Expose()
+    @IsOptional()
+    @IsISO8601()
+    validFrom?: string | null;
+
+    /** `null` = permanente. */
+    @Expose()
+    @IsOptional()
+    @IsISO8601()
+    validUntil?: string | null;
+
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    oncePerCustomer?: boolean;
+}

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

@@ -0,0 +1,21 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsInt, ValidateIf } from 'class-validator';
+import { DiscountTypeEnum } from '../../enums/DiscountTypeEnum';
+
+/** Descuento en el body: exige el campo que corresponde al tipo. Rangos y signo los valida el lambda (422). */
+export class DiscountValueInput {
+    @Expose()
+    @IsEnum(DiscountTypeEnum)
+    type!: DiscountTypeEnum;
+
+    @Expose()
+    @ValidateIf((o: DiscountValueInput) => o.type === DiscountTypeEnum.AMOUNT)
+    @IsInt()
+    amountCents?: number | null;
+
+    /** Puntos base: 1000 = 10%. */
+    @Expose()
+    @ValidateIf((o: DiscountValueInput) => o.type === DiscountTypeEnum.PERCENTAGE)
+    @IsInt()
+    percentBps?: number | null;
+}

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

@@ -0,0 +1,16 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
+
+/** Body de publicEvaluateSalePromotions; precios, líneas y cliente salen de la sesión. */
+export class EvaluateSalePromotionsRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    sessionId!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    discountCode?: string | null;
+}

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

@@ -0,0 +1,11 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
+
+/** Query de publicGetSaleCoupon (`GET /public/sales/{saleId}/coupon`). */
+export class GetSaleCouponQuery {
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    sessionId?: string;
+}

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

@@ -0,0 +1,32 @@
+import { Expose } from 'class-transformer';
+import { IsArray, IsInt, IsNotEmpty, IsOptional, IsString, ValidateIf } from 'class-validator';
+
+/**
+ * Body de publicHoldSalePromotion (PUT, `sessionId` en el path). `promotionId: null` = «Ninguna»;
+ * un PUT distinto reemplaza el apartado anterior.
+ */
+export class HoldSalePromotionRequest {
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    promotionId?: string | null;
+
+    @Expose()
+    @ValidateIf((o: HoldSalePromotionRequest) => o.promotionId !== undefined && o.promotionId !== null)
+    @IsInt()
+    promotionVersion?: number | null;
+
+    /** Regalos elegidos por el cliente, si la promo trae regalo. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    giftSkus?: string[] | null;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    discountCode?: string | null;
+}

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

@@ -0,0 +1,33 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsIn, IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+import { CouponStatusEnum } from '../../enums/CouponStatusEnum';
+import { DiscountCodeOriginEnum } from '../../enums/DiscountCodeOriginEnum';
+import { DiscountCodeStatusEnum } from '../../enums/DiscountCodeStatusEnum';
+
+const LISTABLE_STATUSES = [...new Set<string>([...Object.values(DiscountCodeStatusEnum), ...Object.values(CouponStatusEnum)])];
+
+/** Query de publicListDiscountCodes: códigos y cupones, filtrables por origen y estado. */
+export class ListDiscountCodesQuery {
+    @Expose()
+    @IsOptional()
+    @IsEnum(DiscountCodeOriginEnum)
+    origin?: DiscountCodeOriginEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsIn(LISTABLE_STATUSES)
+    status?: DiscountCodeStatusEnum | CouponStatusEnum;
+
+    @Expose()
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @Min(1)
+    @Max(100)
+    limit?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    nextToken?: string;
+}

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

@@ -0,0 +1,29 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+import { SalePromotionLogFormatEnum } from '../../enums/SalePromotionLogFormatEnum';
+
+/** Query de publicListSalePromotionLog: global o de una promo; `CSV` exporta en vez de paginar. */
+export class ListSalePromotionLogQuery {
+    @Expose()
+    @IsOptional()
+    @IsString()
+    promotionId?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(SalePromotionLogFormatEnum)
+    format?: SalePromotionLogFormatEnum;
+
+    @Expose()
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @Min(1)
+    @Max(100)
+    limit?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    nextToken?: string;
+}

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

@@ -0,0 +1,24 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+import { SalePromotionStatusEnum } from '../../enums/SalePromotionStatusEnum';
+
+/** Query de publicListSalePromotions; sin `status` excluye las archivadas. */
+export class ListSalePromotionsQuery {
+    @Expose()
+    @IsOptional()
+    @IsEnum(SalePromotionStatusEnum)
+    status?: SalePromotionStatusEnum;
+
+    @Expose()
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @Min(1)
+    @Max(100)
+    limit?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    nextToken?: string;
+}

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

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsString } from 'class-validator';
+
+/** Query de publicListStoreSalePromotions; la tienda sale de la sesión, no del request. */
+export class ListStoreSalePromotionsQuery {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    sessionId!: string;
+}