@fiado/type-kit 3.352.0 → 3.354.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/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/bin/walletFunding/dtos/CreateFundingReferenceRequest.d.ts

@@ -1,10 +1,17 @@
 import { WalletFundingModeEnum } from "../enums/WalletFundingModeEnum";
+import { WalletFundingChannelEnum } from "../enums/WalletFundingChannelEnum";
 export declare class CreateFundingReferenceRequest {
     directoryId: string;
     walletAccountId: string;
     name: string;
     email: string;
     mode: WalletFundingModeEnum;
+    /**
+     * Ausente o `NETWORK` reproduce el comportamiento histórico, para que la app
+     * anterior siga funcionando sin cambios. Con `OXXO`, `amount` es obligatorio
+     * y `mode` debe ser `FIXED`.
+     */
+    channel?: WalletFundingChannelEnum;
     /** `0` = OPEN (monto se decide en caja). `>0` = FIXED con monto exacto. */
     amount?: number;
     currencyCode: string;

package/bin/walletFunding/dtos/CreateFundingReferenceRequest.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateFundingReferenceRequest = void 0;
 const class_validator_1 = require("class-validator");
 const WalletFundingModeEnum_1 = require("../enums/WalletFundingModeEnum");
+const WalletFundingChannelEnum_1 = require("../enums/WalletFundingChannelEnum");
 class CreateFundingReferenceRequest {
 }
 exports.CreateFundingReferenceRequest = CreateFundingReferenceRequest;
@@ -38,6 +39,11 @@ __decorate([
     (0, class_validator_1.IsEnum)(WalletFundingModeEnum_1.WalletFundingModeEnum),
     __metadata("design:type", String)
 ], CreateFundingReferenceRequest.prototype, "mode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(WalletFundingChannelEnum_1.WalletFundingChannelEnum),
+    __metadata("design:type", String)
+], CreateFundingReferenceRequest.prototype, "channel", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsNumber)(),

package/bin/walletFunding/enums/WalletFundingChannelEnum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Red por la que se cobra la referencia de fondeo.
+ *
+ * No son intercambiables: la referencia OXXO sirve SOLO en OXXO, y la de red
+ * sirve en las 2.574 tiendas restantes pero no en OXXO. El canal determina a
+ * qué endpoint del proveedor se llama y con qué reglas.
+ */
+export declare enum WalletFundingChannelEnum {
+    /** Red general. Referencia reutilizable de monto abierto. */
+    NETWORK = "NETWORK",
+    /** OXXO Pay. Referencia de un solo uso, monto fijo, vence en 1 día. */
+    OXXO = "OXXO"
+}

package/bin/walletFunding/enums/WalletFundingChannelEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WalletFundingChannelEnum = void 0;
+/**
+ * Red por la que se cobra la referencia de fondeo.
+ *
+ * No son intercambiables: la referencia OXXO sirve SOLO en OXXO, y la de red
+ * sirve en las 2.574 tiendas restantes pero no en OXXO. El canal determina a
+ * qué endpoint del proveedor se llama y con qué reglas.
+ */
+var WalletFundingChannelEnum;
+(function (WalletFundingChannelEnum) {
+    /** Red general. Referencia reutilizable de monto abierto. */
+    WalletFundingChannelEnum["NETWORK"] = "NETWORK";
+    /** OXXO Pay. Referencia de un solo uso, monto fijo, vence en 1 día. */
+    WalletFundingChannelEnum["OXXO"] = "OXXO";
+})(WalletFundingChannelEnum || (exports.WalletFundingChannelEnum = WalletFundingChannelEnum = {}));

package/bin/walletFunding/enums/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./FundingMethodEnum";
 export * from "./WalletFundingModeEnum";
+export * from "./WalletFundingChannelEnum";
 export * from "./WalletFundingReferenceStatusEnum";
 export * from "./WalletFundingPaymentStatusEnum";
 export * from "./WalletFundingErrorCodeEnum";

package/bin/walletFunding/enums/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./FundingMethodEnum"), exports);
 __exportStar(require("./WalletFundingModeEnum"), exports);
+__exportStar(require("./WalletFundingChannelEnum"), exports);
 __exportStar(require("./WalletFundingReferenceStatusEnum"), exports);
 __exportStar(require("./WalletFundingPaymentStatusEnum"), exports);
 __exportStar(require("./WalletFundingErrorCodeEnum"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.352.0",
+  "version": "3.354.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/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';

package/src/walletFunding/dtos/CreateFundingReferenceRequest.ts

@@ -3,6 +3,7 @@ import {
     Length, MaxLength,
 } from "class-validator";
 import { WalletFundingModeEnum } from "../enums/WalletFundingModeEnum";
+import { WalletFundingChannelEnum } from "../enums/WalletFundingChannelEnum";
 
 export class CreateFundingReferenceRequest {
     @IsString() @MaxLength(64) directoryId!: string;
@@ -10,6 +11,12 @@ export class CreateFundingReferenceRequest {
     @IsString() @MaxLength(128) name!: string;
     @IsEmail() email!: string;
     @IsEnum(WalletFundingModeEnum) mode!: WalletFundingModeEnum;
+    /**
+     * Ausente o `NETWORK` reproduce el comportamiento histórico, para que la app
+     * anterior siga funcionando sin cambios. Con `OXXO`, `amount` es obligatorio
+     * y `mode` debe ser `FIXED`.
+     */
+    @IsOptional() @IsEnum(WalletFundingChannelEnum) channel?: WalletFundingChannelEnum;
     /** `0` = OPEN (monto se decide en caja). `>0` = FIXED con monto exacto. */
     @IsOptional() @IsNumber() @Min(0) amount?: number;
     @IsString() @Length(3, 3) currencyCode!: string;

package/src/walletFunding/enums/WalletFundingChannelEnum.ts

@@ -0,0 +1,13 @@
+/**
+ * Red por la que se cobra la referencia de fondeo.
+ *
+ * No son intercambiables: la referencia OXXO sirve SOLO en OXXO, y la de red
+ * sirve en las 2.574 tiendas restantes pero no en OXXO. El canal determina a
+ * qué endpoint del proveedor se llama y con qué reglas.
+ */
+export enum WalletFundingChannelEnum {
+    /** Red general. Referencia reutilizable de monto abierto. */
+    NETWORK = "NETWORK",
+    /** OXXO Pay. Referencia de un solo uso, monto fijo, vence en 1 día. */
+    OXXO = "OXXO",
+}

package/src/walletFunding/enums/index.ts

@@ -1,5 +1,6 @@
 export * from "./FundingMethodEnum";
 export * from "./WalletFundingModeEnum";
+export * from "./WalletFundingChannelEnum";
 export * from "./WalletFundingReferenceStatusEnum";
 export * from "./WalletFundingPaymentStatusEnum";
 export * from "./WalletFundingErrorCodeEnum";