@fiado/type-kit 3.9.0 → 3.11.0

package/bin/benefitCenter/dtos/AuthorizeBenefitsMarketplaceTransactionRequest.d.ts

@@ -17,8 +17,17 @@ export declare class AuthorizeBenefitsMarketplaceTransactionRequest {
      * en Fase 2 (ver doc §10).
      */
     productCatalogId: string;
-    /** Idempotency key — viaja end-to-end (procesador → marketplace → conector). */
-    transactionNumber: string;
+    /**
+     * Idempotency key generada por la **app** (UUID por intento).
+     * Lo consume el decorador `@IdempotencyController` del procesador para
+     * deduplicar reintentos del cliente.
+     *
+     * Distinto de `BenefitPaymentRequest.transactionNumber` que el procesador
+     * genera internamente al crear la transacción y envía al marketplace y
+     * al conector como idempotency key del lado del proveedor. La app NO
+     * debe generar `transactionNumber` — por eso este DTO no lo expone.
+     */
+    idempotencyKey: string;
     amount: number;
     /** ISO numeric (3 chars). Ej: "484" (MXN), "840" (USD). */
     currencyId: string;

package/bin/benefitCenter/dtos/AuthorizeBenefitsMarketplaceTransactionRequest.js

@@ -37,7 +37,7 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.MaxLength)(64),
     __metadata("design:type", String)
-], AuthorizeBenefitsMarketplaceTransactionRequest.prototype, "transactionNumber", void 0);
+], AuthorizeBenefitsMarketplaceTransactionRequest.prototype, "idempotencyKey", void 0);
 __decorate([
     (0, class_validator_1.IsNumber)(),
     (0, class_validator_1.IsPositive)(),

package/package.json

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

package/src/benefitCenter/dtos/AuthorizeBenefitsMarketplaceTransactionRequest.ts

@@ -34,11 +34,20 @@ export class AuthorizeBenefitsMarketplaceTransactionRequest {
     @MaxLength(64)
     productCatalogId!: string;
 
-    /** Idempotency key — viaja end-to-end (procesador → marketplace → conector). */
+    /**
+     * Idempotency key generada por la **app** (UUID por intento).
+     * Lo consume el decorador `@IdempotencyController` del procesador para
+     * deduplicar reintentos del cliente.
+     *
+     * Distinto de `BenefitPaymentRequest.transactionNumber` que el procesador
+     * genera internamente al crear la transacción y envía al marketplace y
+     * al conector como idempotency key del lado del proveedor. La app NO
+     * debe generar `transactionNumber` — por eso este DTO no lo expone.
+     */
     @IsString()
     @IsNotEmpty()
     @MaxLength(64)
-    transactionNumber!: string;
+    idempotencyKey!: string;
 
     @IsNumber()
     @IsPositive()