@fiado/type-kit 3.351.0 → 3.353.0

package/bin/productCatalog/enums/ProductSubtypeEnum.d.ts

@@ -48,5 +48,6 @@ export declare enum ProductSubtypeEnum {
     CP_ACH_IN = "ACH_IN",
     CP_MC_SEND = "MC_SEND",
     CREDIT_DISBURSEMENT = "DISBURSEMENT",
-    EQ_CASH_SA_CASH_IN = "CASH_IN"
+    EQ_CASH_SA_CASH_IN = "CASH_IN",
+    SKBONUS_WELCOME = "WELCOME"
 }

package/bin/productCatalog/enums/ProductSubtypeEnum.js

@@ -64,4 +64,6 @@ var ProductSubtypeEnum;
     ProductSubtypeEnum["CREDIT_DISBURSEMENT"] = "DISBURSEMENT";
     // EQ_CASH_SA (Equality/Passport — depósito en efectivo en tiendas afiliadas)
     ProductSubtypeEnum["EQ_CASH_SA_CASH_IN"] = "CASH_IN";
+    //SK_BONUS
+    ProductSubtypeEnum["SKBONUS_WELCOME"] = "WELCOME";
 })(ProductSubtypeEnum || (exports.ProductSubtypeEnum = ProductSubtypeEnum = {}));

package/bin/productCatalog/enums/ProductTypeEnum.d.ts

@@ -17,5 +17,11 @@ export declare enum ProductTypeEnum {
      * + `relatedProductId=<equalityTransactionNumber>` (FK lógica a
      * EqualityFundingPayment_GT).
      */
-    EQ_CASH_SA = "EQ_CASH_SA"
+    EQ_CASH_SA = "EQ_CASH_SA",
+    /**
+     * Bonos que Fiado le acredita a un cliente de SureKeep. La familia agrupa; el motivo va en el
+     * subtipo. Deliberadamente FUERA del switch de `CreateTransactionManager`: el camino por
+     * defecto es el que escribe el par de asientos FiadoTx + PagoConFiadoTx.
+     */
+    SK_BONUS = "SK_BONUS"
 }

package/bin/productCatalog/enums/ProductTypeEnum.js

@@ -22,4 +22,10 @@ var ProductTypeEnum;
      * EqualityFundingPayment_GT).
      */
     ProductTypeEnum["EQ_CASH_SA"] = "EQ_CASH_SA";
+    /**
+     * Bonos que Fiado le acredita a un cliente de SureKeep. La familia agrupa; el motivo va en el
+     * subtipo. Deliberadamente FUERA del switch de `CreateTransactionManager`: el camino por
+     * defecto es el que escribe el par de asientos FiadoTx + PagoConFiadoTx.
+     */
+    ProductTypeEnum["SK_BONUS"] = "SK_BONUS";
 })(ProductTypeEnum || (exports.ProductTypeEnum = ProductTypeEnum = {}));

package/bin/remittance/dtos/RemittanceSendPreviewRequest.d.ts

@@ -1,3 +1,9 @@
+export declare class RemittanceTransactionAdditionalFieldDTO {
+    /** Nombre del campo tal cual lo expone el payer (ej. "purposeOfRemittance"). */
+    name: string;
+    /** Valor (debe ser una key válida de fieldOptions del payer cuando aplique). */
+    value: string;
+}
 /**
  * Preview formal antes del confirm. Bajo API Lite no incluye fundingMethod —
  * el connector usa unirWlpWalletId de RemittanceUsers_GT (capturado en F2).
@@ -8,4 +14,10 @@ export declare class RemittanceSendPreviewRequest {
     amountCurrency: string;
     /** Fase B: código de promo tecleado en la app (habilita SOLO esa promo). Inerte hasta que la app lo mande. */
     promoCode?: string;
+    /**
+     * Additional fields de la transacción requeridos por ciertos payers (ej. destinos que
+     * piden purpose/identification en la transacción). Se pasan tal cual a UNIR como
+     * `additionalFieldInfo`. Opcional: la mayoría de las transacciones no los necesitan.
+     */
+    additionalFields?: RemittanceTransactionAdditionalFieldDTO[];
 }

package/bin/remittance/dtos/RemittanceSendPreviewRequest.js

@@ -9,8 +9,22 @@ 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.RemittanceSendPreviewRequest = void 0;
+exports.RemittanceSendPreviewRequest = exports.RemittanceTransactionAdditionalFieldDTO = void 0;
 const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+class RemittanceTransactionAdditionalFieldDTO {
+}
+exports.RemittanceTransactionAdditionalFieldDTO = RemittanceTransactionAdditionalFieldDTO;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RemittanceTransactionAdditionalFieldDTO.prototype, "name", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RemittanceTransactionAdditionalFieldDTO.prototype, "value", void 0);
 /**
  * Preview formal antes del confirm. Bajo API Lite no incluye fundingMethod —
  * el connector usa unirWlpWalletId de RemittanceUsers_GT (capturado en F2).
@@ -38,3 +52,9 @@ __decorate([
     (0, class_validator_1.Length)(3, 30),
     __metadata("design:type", String)
 ], RemittanceSendPreviewRequest.prototype, "promoCode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => RemittanceTransactionAdditionalFieldDTO),
+    __metadata("design:type", Array)
+], RemittanceSendPreviewRequest.prototype, "additionalFields", void 0);

package/bin/transactionProcessor/dtos/AuthorizeWelcomeBonusRequest.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Acreditación de un bono de SureKeep a la wallet PagoConfiado del comprador.
+ *
+ * NO lleva `operation`: un bono solo suma, y el servicio hardcodea `ADD`. Con el campo en el
+ * request, un caller equivocado debitaría la wallet con el producto del bono.
+ *
+ * NO lleva `peopleId`: `initialize()` lo resuelve desde el directorio y pisa cualquier valor.
+ */
+export declare class AuthorizeWelcomeBonusRequest {
+    /** Es el `bonusId` del asiento: única por intento, para que un reintento real vuelva a ejecutar. */
+    idempotencyKey: string;
+    productCatalogId: string;
+    /** En PESOS, no centavos. El caller convierte. */
+    amount: number;
+    directoryId: string;
+    /** Lo que el cliente ve como descripción de su movimiento. */
+    concept: string;
+}
+export default AuthorizeWelcomeBonusRequest;

package/bin/transactionProcessor/dtos/AuthorizeWelcomeBonusRequest.js

@@ -0,0 +1,50 @@
+"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.AuthorizeWelcomeBonusRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Acreditación de un bono de SureKeep a la wallet PagoConfiado del comprador.
+ *
+ * NO lleva `operation`: un bono solo suma, y el servicio hardcodea `ADD`. Con el campo en el
+ * request, un caller equivocado debitaría la wallet con el producto del bono.
+ *
+ * NO lleva `peopleId`: `initialize()` lo resuelve desde el directorio y pisa cualquier valor.
+ */
+class AuthorizeWelcomeBonusRequest {
+}
+exports.AuthorizeWelcomeBonusRequest = AuthorizeWelcomeBonusRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AuthorizeWelcomeBonusRequest.prototype, "idempotencyKey", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AuthorizeWelcomeBonusRequest.prototype, "productCatalogId", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], AuthorizeWelcomeBonusRequest.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AuthorizeWelcomeBonusRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(120),
+    __metadata("design:type", String)
+], AuthorizeWelcomeBonusRequest.prototype, "concept", void 0);
+exports.default = AuthorizeWelcomeBonusRequest;

package/bin/transactionProcessor/enums/TransactionProcessorCodesEnum.d.ts

@@ -17,5 +17,7 @@ export declare enum TransactionProcessorCodesEnum {
     OTP_REQUIRED = "OTP_REQUIRED",
     INVALID_SECRET_NUMBER = "INVALID_SECRET_NUMBER",
     BLOCKED_SECRET_NUMBER = "BLOCKED_SECRET_NUMBER",
-    PROVIDER_NOT_FOUND = "PROVIDER_NOT_FOUND"
+    PROVIDER_NOT_FOUND = "PROVIDER_NOT_FOUND",
+    /** El request no cumple el contrato del DTO. Nada tocó saldo. */
+    INVALID_REQUEST = "INVALID_REQUEST"
 }

package/bin/transactionProcessor/enums/TransactionProcessorCodesEnum.js

@@ -22,4 +22,6 @@ var TransactionProcessorCodesEnum;
     TransactionProcessorCodesEnum["INVALID_SECRET_NUMBER"] = "INVALID_SECRET_NUMBER";
     TransactionProcessorCodesEnum["BLOCKED_SECRET_NUMBER"] = "BLOCKED_SECRET_NUMBER";
     TransactionProcessorCodesEnum["PROVIDER_NOT_FOUND"] = "PROVIDER_NOT_FOUND";
+    /** El request no cumple el contrato del DTO. Nada tocó saldo. */
+    TransactionProcessorCodesEnum["INVALID_REQUEST"] = "INVALID_REQUEST";
 })(TransactionProcessorCodesEnum || (exports.TransactionProcessorCodesEnum = TransactionProcessorCodesEnum = {}));

package/bin/transactionProcessor/index.d.ts

@@ -10,6 +10,7 @@ export * from './dtos/AuthorizeSpeiMexBankTransferInRequest';
 export * from './dtos/AuthorizeSpeiBankTransferNcRequest';
 export * from './dtos/AuthorizeCollectorTransactionRequest';
 export * from './dtos/AuthorizeDisputeTransactionRequest';
+export * from './dtos/AuthorizeWelcomeBonusRequest';
 export * from './dtos/CardInfo';
 export * from './dtos/InstallmentsInfo';
 export * from './dtos/MerchantInfo';

package/bin/transactionProcessor/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./dtos/AuthorizeSpeiMexBankTransferInRequest"), exports);
 __exportStar(require("./dtos/AuthorizeSpeiBankTransferNcRequest"), exports);
 __exportStar(require("./dtos/AuthorizeCollectorTransactionRequest"), exports);
 __exportStar(require("./dtos/AuthorizeDisputeTransactionRequest"), exports);
+__exportStar(require("./dtos/AuthorizeWelcomeBonusRequest"), exports);
 __exportStar(require("./dtos/CardInfo"), exports);
 __exportStar(require("./dtos/InstallmentsInfo"), exports);
 __exportStar(require("./dtos/MerchantInfo"), exports);

package/package.json

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

package/src/productCatalog/enums/ProductSubtypeEnum.ts

@@ -71,4 +71,7 @@ export enum ProductSubtypeEnum {
 
     // EQ_CASH_SA (Equality/Passport — depósito en efectivo en tiendas afiliadas)
     EQ_CASH_SA_CASH_IN = "CASH_IN",
+
+    //SK_BONUS
+    SKBONUS_WELCOME = "WELCOME",
 }

package/src/productCatalog/enums/ProductTypeEnum.ts

@@ -17,5 +17,11 @@ export enum ProductTypeEnum {
      * + `relatedProductId=<equalityTransactionNumber>` (FK lógica a
      * EqualityFundingPayment_GT).
      */
-    EQ_CASH_SA = "EQ_CASH_SA"
+    EQ_CASH_SA = "EQ_CASH_SA",
+    /**
+     * Bonos que Fiado le acredita a un cliente de SureKeep. La familia agrupa; el motivo va en el
+     * subtipo. Deliberadamente FUERA del switch de `CreateTransactionManager`: el camino por
+     * defecto es el que escribe el par de asientos FiadoTx + PagoConFiadoTx.
+     */
+    SK_BONUS = "SK_BONUS"
 }

package/src/remittance/dtos/RemittanceSendPreviewRequest.ts

@@ -1,4 +1,17 @@
-import { IsIn, IsNotEmpty, IsNumber, IsOptional, IsString, Length, Min } from "class-validator";
+import { IsIn, IsNotEmpty, IsNumber, IsOptional, IsString, Length, Min, ValidateNested } from "class-validator";
+import { Type } from "class-transformer";
+
+export class RemittanceTransactionAdditionalFieldDTO {
+    /** Nombre del campo tal cual lo expone el payer (ej. "purposeOfRemittance"). */
+    @IsString()
+    @IsNotEmpty()
+    name!: string;
+
+    /** Valor (debe ser una key válida de fieldOptions del payer cuando aplique). */
+    @IsString()
+    @IsNotEmpty()
+    value!: string;
+}
 
 /**
  * Preview formal antes del confirm. Bajo API Lite no incluye fundingMethod —
@@ -21,4 +34,14 @@ export class RemittanceSendPreviewRequest {
     @IsString()
     @Length(3, 30)
     promoCode?: string;
+
+    /**
+     * Additional fields de la transacción requeridos por ciertos payers (ej. destinos que
+     * piden purpose/identification en la transacción). Se pasan tal cual a UNIR como
+     * `additionalFieldInfo`. Opcional: la mayoría de las transacciones no los necesitan.
+     */
+    @IsOptional()
+    @ValidateNested({ each: true })
+    @Type(() => RemittanceTransactionAdditionalFieldDTO)
+    additionalFields?: RemittanceTransactionAdditionalFieldDTO[];
 }

package/src/transactionProcessor/dtos/AuthorizeWelcomeBonusRequest.ts

@@ -0,0 +1,36 @@
+import { IsNotEmpty, IsNumber, IsPositive, IsString, MaxLength } from "class-validator";
+
+/**
+ * Acreditación de un bono de SureKeep a la wallet PagoConfiado del comprador.
+ *
+ * NO lleva `operation`: un bono solo suma, y el servicio hardcodea `ADD`. Con el campo en el
+ * request, un caller equivocado debitaría la wallet con el producto del bono.
+ *
+ * NO lleva `peopleId`: `initialize()` lo resuelve desde el directorio y pisa cualquier valor.
+ */
+export class AuthorizeWelcomeBonusRequest {
+    /** Es el `bonusId` del asiento: única por intento, para que un reintento real vuelva a ejecutar. */
+    @IsString()
+    @IsNotEmpty()
+    idempotencyKey: string;
+
+    @IsString()
+    @IsNotEmpty()
+    productCatalogId: string;
+
+    /** En PESOS, no centavos. El caller convierte. */
+    @IsNumber()
+    @IsPositive()
+    amount: number;
+
+    @IsString()
+    @IsNotEmpty()
+    directoryId: string;
+
+    /** Lo que el cliente ve como descripción de su movimiento. */
+    @IsString()
+    @MaxLength(120)
+    concept: string;
+}
+
+export default AuthorizeWelcomeBonusRequest;

package/src/transactionProcessor/enums/TransactionProcessorCodesEnum.ts

@@ -18,4 +18,6 @@ export enum TransactionProcessorCodesEnum {
     INVALID_SECRET_NUMBER = "INVALID_SECRET_NUMBER",
     BLOCKED_SECRET_NUMBER = "BLOCKED_SECRET_NUMBER",
     PROVIDER_NOT_FOUND = "PROVIDER_NOT_FOUND",
+    /** El request no cumple el contrato del DTO. Nada tocó saldo. */
+    INVALID_REQUEST = "INVALID_REQUEST",
 }

package/src/transactionProcessor/index.ts

@@ -10,6 +10,7 @@ export * from './dtos/AuthorizeSpeiMexBankTransferInRequest';
 export * from './dtos/AuthorizeSpeiBankTransferNcRequest';
 export * from './dtos/AuthorizeCollectorTransactionRequest';
 export * from './dtos/AuthorizeDisputeTransactionRequest';
+export * from './dtos/AuthorizeWelcomeBonusRequest';
 export * from './dtos/CardInfo';
 export * from './dtos/InstallmentsInfo';
 export * from './dtos/MerchantInfo';