@fiado/type-kit 3.266.0 → 3.268.0

package/bin/phoneSales/DeviceVariantImageUploadUrlResponseDto.d.ts

@@ -2,4 +2,10 @@ export interface DeviceVariantImageUploadUrlResponseDto {
     uploadUrl: string;
     imageUrl: string;
     expiresIn: number;
+    /**
+     * Tamaño máximo permitido para la imagen, en bytes. Fuente de verdad del límite de producto
+     * (hoy 5MB, ver MAX_IMAGE_SIZE_BYTES en DeviceVariantImageService del lambda fiado-phone-sales) —
+     * antes solo vivía hardcodeado en el front.
+     */
+    maxSizeBytes: number;
 }

package/bin/phoneSales/SaleResponseDto.d.ts

@@ -8,4 +8,12 @@ export declare class SaleResponseDto {
     trackingCode: string | null;
     providerStatus: string | null;
     status: string;
+    /**
+     * Modelo de la variante (resuelto server-side por `variantId`, incluyendo variantes con
+     * stock=0). `null` si la resolución falló (variante borrada o error de infraestructura) — ver
+     * GET /sales (backoffice) en cell-phone-sales-business.
+     */
+    variantModel: string | null;
+    /** Color de la variante — mismo criterio de resolución/degradación que `variantModel`. */
+    variantColor: string | null;
 }

package/bin/phoneSales/UpdateDeviceVariantRequestDto.d.ts

@@ -0,0 +1,6 @@
+export declare class UpdateDeviceVariantRequestDto {
+    model?: string;
+    color?: string;
+    storage?: string;
+    price?: number;
+}

package/bin/phoneSales/UpdateDeviceVariantRequestDto.js

@@ -0,0 +1,37 @@
+"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.UpdateDeviceVariantRequestDto = void 0;
+const class_validator_1 = require("class-validator");
+class UpdateDeviceVariantRequestDto {
+}
+exports.UpdateDeviceVariantRequestDto = UpdateDeviceVariantRequestDto;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateDeviceVariantRequestDto.prototype, "model", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateDeviceVariantRequestDto.prototype, "color", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateDeviceVariantRequestDto.prototype, "storage", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], UpdateDeviceVariantRequestDto.prototype, "price", void 0);

package/bin/phoneSales/index.d.ts

@@ -1,5 +1,6 @@
 export * from './DeviceVariantResponseDto';
 export * from './CreateDeviceVariantRequestDto';
+export * from './UpdateDeviceVariantRequestDto';
 export * from './CreateSaleRequestDto';
 export * from './SaleResponseDto';
 export * from './RedeemSaleCodeRequestDto';

package/bin/phoneSales/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./DeviceVariantResponseDto"), exports);
 __exportStar(require("./CreateDeviceVariantRequestDto"), exports);
+__exportStar(require("./UpdateDeviceVariantRequestDto"), exports);
 __exportStar(require("./CreateSaleRequestDto"), exports);
 __exportStar(require("./SaleResponseDto"), exports);
 __exportStar(require("./RedeemSaleCodeRequestDto"), exports);

package/bin/retailWizard/dtos/responses/RunSalesReportResponse.d.ts

@@ -0,0 +1,25 @@
+import type { SalesReportRun } from '../SalesReportRun';
+/**
+ * POST /backoffice/reports/{reportId}/run — el reporte generado, SÍNCRONO.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * El archivo viaja **en la respuesta**, no por una URL de descarga: el más grande del catálogo son
+ * ~96 KB, muy por debajo del límite de 6 MB de payload de Lambda. Eso evita bucket, URL prefirmada y
+ * endpoint de descarga para algo que se arma en milisegundos.
+ *
+ * ⚠️ El contenido puede traer **PII** (nombre del cliente en el reporte por período). Su lectura queda
+ * registrada en `PiiAccessLog` igual que las demás pantallas del BO. **Nunca loguear `content`.**
+ *
+ * Si algún reporte creciera hasta no entrar en la respuesta, el camino es S3 + `downloadUrl` (que ya
+ * está en `SalesReportRun`) + estado `QUEUED`: el contrato NO hay que romperlo, ya lo contempla.
+ */
+export interface RunSalesReportResponse {
+    /** La corrida registrada en el log, con su estado final y el conteo de filas. */
+    run: SalesReportRun;
+    /** Nombre sugerido del archivo, ej. `RVL-01_2026-08-03.csv`. */
+    filename: string;
+    /** Tipo MIME, ej. `text/csv`. */
+    contentType: string;
+    /** El archivo completo. El front lo baja con un `Blob`. */
+    content: string;
+}

package/bin/retailWizard/dtos/responses/RunSalesReportResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/retailWizard/enums/ReportRunStatusEnum.d.ts

@@ -1,14 +1,21 @@
 /**
- * Estado de una corrida de reporte. La generación es ASÍNCRONA: el `POST .../run` devuelve `QUEUED` y
- * el front poletea el listado. SureKeep Fase 3 — pista Retail.
+ * Estado de una corrida de reporte. SureKeep Fase 3 — pista Retail.
  *
- * Es async desde el día uno por el límite de 29 s de API Gateway: un reporte de red completa no entra
- * en una respuesta síncrona. Mismo error que ya se corrigió en el cierre de corte de comisiones.
+ * El ciclo real es **`RUNNING → READY | FAILED`, todo dentro de la MISMA llamada**: la generación es
+ * SÍNCRONA. Es el mismo patrón del reporte SIC de `credit-worker-business`, que abre la fila en
+ * `RUNNING` antes de procesar (`createMetadata`) y la cierra al terminar (`finalizeMetadata`).
  *
- * QUEUED - Encolada, sin arrancar.
- * RUNNING - Generándose.
- * READY - Lista para descargar (`downloadUrl` presente).
+ * Es síncrono porque los volúmenes lo permiten: el reporte más grande del catálogo son **320 filas
+ * (~96 KB)** — el propio mockup lo declara. Encolarlo sería infraestructura (worker + cola + bucket)
+ * para un archivo que se arma en milisegundos.
+ *
+ * RUNNING - Generándose. La fila se escribe ANTES de procesar, para que una corrida que muera a
+ *           mitad deje rastro en vez de desaparecer.
+ * READY - Terminó bien. `rowCount` trae las filas generadas.
  * FAILED - Falló; `failureReason` explica por qué.
+ * QUEUED - **RESERVADO, hoy no se emite.** Existe para poder volver a asíncrono si algún reporte
+ *          crece de verdad, **sin romper el contrato del front**: la pantalla ya sabe que un estado
+ *          intermedio es posible. Sacarlo del enum ahora obligaría a versionar el DTO después.
  */
 export declare enum ReportRunStatusEnum {
     QUEUED = "QUEUED",

package/bin/retailWizard/enums/ReportRunStatusEnum.js

@@ -2,16 +2,23 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReportRunStatusEnum = void 0;
 /**
- * Estado de una corrida de reporte. La generación es ASÍNCRONA: el `POST .../run` devuelve `QUEUED` y
- * el front poletea el listado. SureKeep Fase 3 — pista Retail.
+ * Estado de una corrida de reporte. SureKeep Fase 3 — pista Retail.
  *
- * Es async desde el día uno por el límite de 29 s de API Gateway: un reporte de red completa no entra
- * en una respuesta síncrona. Mismo error que ya se corrigió en el cierre de corte de comisiones.
+ * El ciclo real es **`RUNNING → READY | FAILED`, todo dentro de la MISMA llamada**: la generación es
+ * SÍNCRONA. Es el mismo patrón del reporte SIC de `credit-worker-business`, que abre la fila en
+ * `RUNNING` antes de procesar (`createMetadata`) y la cierra al terminar (`finalizeMetadata`).
  *
- * QUEUED - Encolada, sin arrancar.
- * RUNNING - Generándose.
- * READY - Lista para descargar (`downloadUrl` presente).
+ * Es síncrono porque los volúmenes lo permiten: el reporte más grande del catálogo son **320 filas
+ * (~96 KB)** — el propio mockup lo declara. Encolarlo sería infraestructura (worker + cola + bucket)
+ * para un archivo que se arma en milisegundos.
+ *
+ * RUNNING - Generándose. La fila se escribe ANTES de procesar, para que una corrida que muera a
+ *           mitad deje rastro en vez de desaparecer.
+ * READY - Terminó bien. `rowCount` trae las filas generadas.
  * FAILED - Falló; `failureReason` explica por qué.
+ * QUEUED - **RESERVADO, hoy no se emite.** Existe para poder volver a asíncrono si algún reporte
+ *          crece de verdad, **sin romper el contrato del front**: la pantalla ya sabe que un estado
+ *          intermedio es posible. Sacarlo del enum ahora obligaría a versionar el DTO después.
  */
 var ReportRunStatusEnum;
 (function (ReportRunStatusEnum) {

package/bin/retailWizard/index.d.ts

@@ -90,6 +90,7 @@ export * from './dtos/requests/BackofficeCancelSaleRequest';
 export * from './dtos/responses/BackofficeSalesStatsResponse';
 export * from './dtos/responses/BackofficeSalesKpisResponse';
 export * from './dtos/responses/BackofficeReportsResponse';
+export * from './dtos/responses/RunSalesReportResponse';
 export * from './dtos/RetailCustomerListItem';
 export * from './dtos/responses/BackofficeCustomersResponse';
 export * from './dtos/responses/BackofficeCustomerPurchasesResponse';

package/bin/retailWizard/index.js

@@ -118,6 +118,7 @@ __exportStar(require("./dtos/requests/BackofficeCancelSaleRequest"), exports);
 __exportStar(require("./dtos/responses/BackofficeSalesStatsResponse"), exports);
 __exportStar(require("./dtos/responses/BackofficeSalesKpisResponse"), exports);
 __exportStar(require("./dtos/responses/BackofficeReportsResponse"), exports);
+__exportStar(require("./dtos/responses/RunSalesReportResponse"), exports);
 // A1-A4 · agregados del portal (D17)
 __exportStar(require("./dtos/RetailCustomerListItem"), exports);
 __exportStar(require("./dtos/responses/BackofficeCustomersResponse"), exports);

package/package.json

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

package/src/phoneSales/DeviceVariantImageUploadUrlResponseDto.ts

@@ -2,4 +2,10 @@ export interface DeviceVariantImageUploadUrlResponseDto {
   uploadUrl: string;
   imageUrl: string;
   expiresIn: number;
+  /**
+   * Tamaño máximo permitido para la imagen, en bytes. Fuente de verdad del límite de producto
+   * (hoy 5MB, ver MAX_IMAGE_SIZE_BYTES en DeviceVariantImageService del lambda fiado-phone-sales) —
+   * antes solo vivía hardcodeado en el front.
+   */
+  maxSizeBytes: number;
 }

package/src/phoneSales/SaleResponseDto.ts

@@ -8,4 +8,17 @@ export class SaleResponseDto {
   trackingCode!: string | null;
   providerStatus!: string | null;
   status!: string;
+  /**
+   * Modelo de la variante (resuelto server-side por `variantId`, incluyendo variantes con
+   * stock=0). `null` si la resolución falló (variante borrada o error de infraestructura) — ver
+   * GET /sales (backoffice) en cell-phone-sales-business.
+   */
+  variantModel!: string | null;
+  /** Color de la variante — mismo criterio de resolución/degradación que `variantModel`. */
+  variantColor!: string | null;
+  // Nota (v1, 2026-08-03): `buyerDirectorId` (arriba) sigue siendo el ID crudo del comprador a
+  // propósito. Se evaluó agregar `buyerName` resuelto server-side (vía servicio de directorios,
+  // @fiado/api-invoker IDirectoriesApi) pero requería wiring de infra pendiente
+  // (DIRECTORIES_LAMBDA_URL) — el líder de producto confirmó que para v1 alcanza con el ID
+  // crudo. Pospuesto a v2.
 }

package/src/phoneSales/UpdateDeviceVariantRequestDto.ts

@@ -0,0 +1,20 @@
+import { IsString, IsNumber, IsOptional, Min } from 'class-validator';
+
+export class UpdateDeviceVariantRequestDto {
+  @IsOptional()
+  @IsString()
+  model?: string;
+
+  @IsOptional()
+  @IsString()
+  color?: string;
+
+  @IsOptional()
+  @IsString()
+  storage?: string;
+
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  price?: number;
+}

package/src/phoneSales/index.ts

@@ -1,5 +1,6 @@
 export * from './DeviceVariantResponseDto';
 export * from './CreateDeviceVariantRequestDto';
+export * from './UpdateDeviceVariantRequestDto';
 export * from './CreateSaleRequestDto';
 export * from './SaleResponseDto';
 export * from './RedeemSaleCodeRequestDto';

package/src/retailWizard/dtos/responses/RunSalesReportResponse.ts

@@ -0,0 +1,26 @@
+import type { SalesReportRun } from '../SalesReportRun';
+
+/**
+ * POST /backoffice/reports/{reportId}/run — el reporte generado, SÍNCRONO.
+ * SureKeep Fase 3 — pista Retail.
+ *
+ * El archivo viaja **en la respuesta**, no por una URL de descarga: el más grande del catálogo son
+ * ~96 KB, muy por debajo del límite de 6 MB de payload de Lambda. Eso evita bucket, URL prefirmada y
+ * endpoint de descarga para algo que se arma en milisegundos.
+ *
+ * ⚠️ El contenido puede traer **PII** (nombre del cliente en el reporte por período). Su lectura queda
+ * registrada en `PiiAccessLog` igual que las demás pantallas del BO. **Nunca loguear `content`.**
+ *
+ * Si algún reporte creciera hasta no entrar en la respuesta, el camino es S3 + `downloadUrl` (que ya
+ * está en `SalesReportRun`) + estado `QUEUED`: el contrato NO hay que romperlo, ya lo contempla.
+ */
+export interface RunSalesReportResponse {
+    /** La corrida registrada en el log, con su estado final y el conteo de filas. */
+    run: SalesReportRun;
+    /** Nombre sugerido del archivo, ej. `RVL-01_2026-08-03.csv`. */
+    filename: string;
+    /** Tipo MIME, ej. `text/csv`. */
+    contentType: string;
+    /** El archivo completo. El front lo baja con un `Blob`. */
+    content: string;
+}

package/src/retailWizard/enums/ReportRunStatusEnum.ts

@@ -1,14 +1,21 @@
 /**
- * Estado de una corrida de reporte. La generación es ASÍNCRONA: el `POST .../run` devuelve `QUEUED` y
- * el front poletea el listado. SureKeep Fase 3 — pista Retail.
+ * Estado de una corrida de reporte. SureKeep Fase 3 — pista Retail.
  *
- * Es async desde el día uno por el límite de 29 s de API Gateway: un reporte de red completa no entra
- * en una respuesta síncrona. Mismo error que ya se corrigió en el cierre de corte de comisiones.
+ * El ciclo real es **`RUNNING → READY | FAILED`, todo dentro de la MISMA llamada**: la generación es
+ * SÍNCRONA. Es el mismo patrón del reporte SIC de `credit-worker-business`, que abre la fila en
+ * `RUNNING` antes de procesar (`createMetadata`) y la cierra al terminar (`finalizeMetadata`).
  *
- * QUEUED - Encolada, sin arrancar.
- * RUNNING - Generándose.
- * READY - Lista para descargar (`downloadUrl` presente).
+ * Es síncrono porque los volúmenes lo permiten: el reporte más grande del catálogo son **320 filas
+ * (~96 KB)** — el propio mockup lo declara. Encolarlo sería infraestructura (worker + cola + bucket)
+ * para un archivo que se arma en milisegundos.
+ *
+ * RUNNING - Generándose. La fila se escribe ANTES de procesar, para que una corrida que muera a
+ *           mitad deje rastro en vez de desaparecer.
+ * READY - Terminó bien. `rowCount` trae las filas generadas.
  * FAILED - Falló; `failureReason` explica por qué.
+ * QUEUED - **RESERVADO, hoy no se emite.** Existe para poder volver a asíncrono si algún reporte
+ *          crece de verdad, **sin romper el contrato del front**: la pantalla ya sabe que un estado
+ *          intermedio es posible. Sacarlo del enum ahora obligaría a versionar el DTO después.
  */
 export enum ReportRunStatusEnum {
     QUEUED = 'QUEUED',

package/src/retailWizard/index.ts

@@ -112,6 +112,7 @@ export * from './dtos/requests/BackofficeCancelSaleRequest';
 export * from './dtos/responses/BackofficeSalesStatsResponse';
 export * from './dtos/responses/BackofficeSalesKpisResponse';
 export * from './dtos/responses/BackofficeReportsResponse';
+export * from './dtos/responses/RunSalesReportResponse';
 // A1-A4 · agregados del portal (D17)
 export * from './dtos/RetailCustomerListItem';
 export * from './dtos/responses/BackofficeCustomersResponse';