@fiado/type-kit 3.94.0 → 3.96.0

package/bin/networkConnector/dtos/UploadProfilePhotoRequest.d.ts

@@ -0,0 +1,7 @@
+import { PhotoContentType } from '../enums/PhotoContentType';
+export declare class UploadProfilePhotoRequest {
+    /** Base64 puro (sin prefijo data:image/...) */
+    photoBase64: string;
+    /** MIME type de la imagen */
+    mimeType: PhotoContentType;
+}

package/bin/networkConnector/dtos/UploadProfilePhotoRequest.js

@@ -0,0 +1,29 @@
+"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.UploadProfilePhotoRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const PhotoContentType_1 = require("../enums/PhotoContentType");
+class UploadProfilePhotoRequest {
+}
+exports.UploadProfilePhotoRequest = UploadProfilePhotoRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], UploadProfilePhotoRequest.prototype, "photoBase64", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(PhotoContentType_1.PhotoContentType),
+    __metadata("design:type", String)
+], UploadProfilePhotoRequest.prototype, "mimeType", void 0);

package/bin/networkConnector/dtos/UploadProfilePhotoResponse.d.ts

@@ -0,0 +1,4 @@
+export interface UploadProfilePhotoResponse {
+    /** Presigned URL para acceder a la foto recien subida */
+    photoUrl: string;
+}

package/bin/networkConnector/dtos/UploadProfilePhotoResponse.js

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

package/bin/networkConnector/index.d.ts

@@ -21,3 +21,5 @@ export * from './dtos/ListLeadGroupsResponse';
 export * from './dtos/GetPhotoUploadUrlRequest';
 export * from './dtos/PhotoUploadUrlResponse';
 export * from './dtos/DeletePhotoResponse';
+export * from './dtos/UploadProfilePhotoRequest';
+export * from './dtos/UploadProfilePhotoResponse';

package/bin/networkConnector/index.js

@@ -42,3 +42,5 @@ __exportStar(require("./dtos/ListLeadGroupsResponse"), exports);
 __exportStar(require("./dtos/GetPhotoUploadUrlRequest"), exports);
 __exportStar(require("./dtos/PhotoUploadUrlResponse"), exports);
 __exportStar(require("./dtos/DeletePhotoResponse"), exports);
+__exportStar(require("./dtos/UploadProfilePhotoRequest"), exports);
+__exportStar(require("./dtos/UploadProfilePhotoResponse"), exports);

package/bin/walletFunding/dtos/FundingPaymentChannel.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Canal/tienda donde el cliente puede pagar la referencia de fondeo.
+ * Provider-agnóstico: equivale a `centers` de Equality, `stores` de OpenPay, etc.
+ */
+export declare class FundingPaymentChannel {
+    /** Nombre legible. Ej: "OXXO", "7-Eleven", "Farmacia Guadalajara". */
+    name: string;
+    /** URL del logo del canal (opcional). */
+    logo?: string;
+    /**
+     * Categoría comercial. Permite agrupar/filtrar en el frontend.
+     * Valores sugeridos: `CONVENIENCE_STORE | PHARMACY | BANK | SUPERMARKET | OTHER`.
+     * No se enforza enum para mantener extensibilidad sin breaking change.
+     */
+    category?: string;
+}

package/bin/walletFunding/dtos/FundingPaymentChannel.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FundingPaymentChannel = void 0;
+/**
+ * Canal/tienda donde el cliente puede pagar la referencia de fondeo.
+ * Provider-agnóstico: equivale a `centers` de Equality, `stores` de OpenPay, etc.
+ */
+class FundingPaymentChannel {
+}
+exports.FundingPaymentChannel = FundingPaymentChannel;

package/bin/walletFunding/dtos/FundingProviderReferenceData.d.ts

@@ -1,3 +1,8 @@
+import { FundingReferenceItem } from "./FundingReferenceItem";
+/**
+ * @deprecated Usar {@link FundingReferenceItem} (standard Fiado provider-agnóstico).
+ * Shape Equality-específico — solo se mantiene para compat con consumers viejos.
+ */
 export declare class FundingProviderReferenceItem {
     reference: string;
     centers: Array<{
@@ -7,6 +12,14 @@ export declare class FundingProviderReferenceItem {
     centerId: number | string;
     barcode: string;
 }
+/**
+ * Wrapper de referencias devueltas por el provider tras `createFundingReference`.
+ * Usa el shape estándar Fiado {@link FundingReferenceItem} — provider-agnóstico.
+ *
+ * Una sola operación puede devolver múltiples referencias (una por canal o por
+ * región). Equality/Passport típicamente devuelve 1 referencia con N canales
+ * agrupados en `paymentChannels`; otros providers pueden separar por reference.
+ */
 export declare class FundingProviderReferenceData {
-    references: FundingProviderReferenceItem[];
+    references: FundingReferenceItem[];
 }

package/bin/walletFunding/dtos/FundingProviderReferenceData.js

@@ -1,9 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FundingProviderReferenceData = exports.FundingProviderReferenceItem = void 0;
+/**
+ * @deprecated Usar {@link FundingReferenceItem} (standard Fiado provider-agnóstico).
+ * Shape Equality-específico — solo se mantiene para compat con consumers viejos.
+ */
 class FundingProviderReferenceItem {
 }
 exports.FundingProviderReferenceItem = FundingProviderReferenceItem;
+/**
+ * Wrapper de referencias devueltas por el provider tras `createFundingReference`.
+ * Usa el shape estándar Fiado {@link FundingReferenceItem} — provider-agnóstico.
+ *
+ * Una sola operación puede devolver múltiples referencias (una por canal o por
+ * región). Equality/Passport típicamente devuelve 1 referencia con N canales
+ * agrupados en `paymentChannels`; otros providers pueden separar por reference.
+ */
 class FundingProviderReferenceData {
 }
 exports.FundingProviderReferenceData = FundingProviderReferenceData;

package/bin/walletFunding/dtos/FundingReferenceItem.d.ts

@@ -0,0 +1,36 @@
+import { PaymentCodeTypeEnum } from "../enums/PaymentCodeTypeEnum";
+import { FundingPaymentChannel } from "./FundingPaymentChannel";
+/**
+ * Forma estándar Fiado de una referencia de fondeo. Provider-agnóstica.
+ *
+ * Cada provider concreto (Equality, OpenPay, Mercado Pago…) implementa un mapper
+ * que traduce su shape nativo a este DTO. El wallet-app y los consumers internos
+ * SOLO conocen este shape — el shape del provider queda aislado en el connector.
+ *
+ * Mapping references:
+ *  - Equality/Passport: `{reference, barcode, centers, centerId}`
+ *     → `{reference, paymentCodeImage: barcode, paymentCodeType: BARCODE_1D,
+ *         paymentChannels: centers, providerMetadata: {centerId}}`.
+ *  - OpenPay: `{qrToken, qrUrl, affiliationId}`
+ *     → `{reference: qrToken, paymentCodeImage: qrUrl, paymentCodeType: QR,
+ *         providerMetadata: {affiliationId}}`.
+ */
+export declare class FundingReferenceItem {
+    /** Identificador/cadena que el cliente paga en caja. */
+    reference: string;
+    /** Tipo del código (define cómo lo renderiza el frontend). */
+    paymentCodeType: PaymentCodeTypeEnum;
+    /** URL de la imagen del código (barcode/QR). Null si paymentCodeType=TEXT|NONE. */
+    paymentCodeImage?: string;
+    /** Lista de canales/tiendas donde el cliente puede pagar. */
+    paymentChannels?: FundingPaymentChannel[];
+    /** Texto instructivo localizable para el cliente. */
+    instructions?: string;
+    /** Vencimiento ISO de la referencia (puede heredarse del request). */
+    expiresAt?: string;
+    /**
+     * Metadata específica del provider — OPACA al wallet-app.
+     * Útil para soporte/debug. Cada provider la usa a su discreción.
+     */
+    providerMetadata?: Record<string, unknown>;
+}

package/bin/walletFunding/dtos/FundingReferenceItem.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FundingReferenceItem = void 0;
+/**
+ * Forma estándar Fiado de una referencia de fondeo. Provider-agnóstica.
+ *
+ * Cada provider concreto (Equality, OpenPay, Mercado Pago…) implementa un mapper
+ * que traduce su shape nativo a este DTO. El wallet-app y los consumers internos
+ * SOLO conocen este shape — el shape del provider queda aislado en el connector.
+ *
+ * Mapping references:
+ *  - Equality/Passport: `{reference, barcode, centers, centerId}`
+ *     → `{reference, paymentCodeImage: barcode, paymentCodeType: BARCODE_1D,
+ *         paymentChannels: centers, providerMetadata: {centerId}}`.
+ *  - OpenPay: `{qrToken, qrUrl, affiliationId}`
+ *     → `{reference: qrToken, paymentCodeImage: qrUrl, paymentCodeType: QR,
+ *         providerMetadata: {affiliationId}}`.
+ */
+class FundingReferenceItem {
+}
+exports.FundingReferenceItem = FundingReferenceItem;

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

@@ -1,4 +1,6 @@
 export * from "./FundingProviderReferenceData";
+export * from "./FundingPaymentChannel";
+export * from "./FundingReferenceItem";
 export * from "./AuthorizeWalletFundingRequest";
 export * from "./AuthorizeWalletFundingResponse";
 export * from "./CancelWalletFundingRequest";

package/bin/walletFunding/dtos/index.js

@@ -15,6 +15,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./FundingProviderReferenceData"), exports);
+__exportStar(require("./FundingPaymentChannel"), exports);
+__exportStar(require("./FundingReferenceItem"), exports);
 __exportStar(require("./AuthorizeWalletFundingRequest"), exports);
 __exportStar(require("./AuthorizeWalletFundingResponse"), exports);
 __exportStar(require("./CancelWalletFundingRequest"), exports);

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

@@ -0,0 +1,17 @@
+/**
+ * Tipo del código de pago que el cliente presenta en caja. Permite al frontend
+ * renderizar la imagen correcta (barcode 1D, QR) o solo texto.
+ *
+ * Provider-agnóstico: cada provider (Equality, OpenPay, Mercado Pago…) mapea
+ * su shape nativo a este enum.
+ */
+export declare enum PaymentCodeTypeEnum {
+    /** Código de barras 1D (Code 128, EAN-13, etc.). Ej: Equality/Passport. */
+    BARCODE_1D = "BARCODE_1D",
+    /** QR code. Ej: OpenPay, Mercado Pago. */
+    QR = "QR",
+    /** Solo referencia numérica/alfanumérica sin imagen. */
+    TEXT = "TEXT",
+    /** Sin código (provider no genera código visible). */
+    NONE = "NONE"
+}

package/bin/walletFunding/enums/PaymentCodeTypeEnum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentCodeTypeEnum = void 0;
+/**
+ * Tipo del código de pago que el cliente presenta en caja. Permite al frontend
+ * renderizar la imagen correcta (barcode 1D, QR) o solo texto.
+ *
+ * Provider-agnóstico: cada provider (Equality, OpenPay, Mercado Pago…) mapea
+ * su shape nativo a este enum.
+ */
+var PaymentCodeTypeEnum;
+(function (PaymentCodeTypeEnum) {
+    /** Código de barras 1D (Code 128, EAN-13, etc.). Ej: Equality/Passport. */
+    PaymentCodeTypeEnum["BARCODE_1D"] = "BARCODE_1D";
+    /** QR code. Ej: OpenPay, Mercado Pago. */
+    PaymentCodeTypeEnum["QR"] = "QR";
+    /** Solo referencia numérica/alfanumérica sin imagen. */
+    PaymentCodeTypeEnum["TEXT"] = "TEXT";
+    /** Sin código (provider no genera código visible). */
+    PaymentCodeTypeEnum["NONE"] = "NONE";
+})(PaymentCodeTypeEnum || (exports.PaymentCodeTypeEnum = PaymentCodeTypeEnum = {}));

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

@@ -4,3 +4,4 @@ export * from "./WalletFundingReferenceStatusEnum";
 export * from "./WalletFundingPaymentStatusEnum";
 export * from "./WalletFundingErrorCodeEnum";
 export * from "./WalletFundingRefundReasonEnum";
+export * from "./PaymentCodeTypeEnum";

package/bin/walletFunding/enums/index.js

@@ -20,3 +20,4 @@ __exportStar(require("./WalletFundingReferenceStatusEnum"), exports);
 __exportStar(require("./WalletFundingPaymentStatusEnum"), exports);
 __exportStar(require("./WalletFundingErrorCodeEnum"), exports);
 __exportStar(require("./WalletFundingRefundReasonEnum"), exports);
+__exportStar(require("./PaymentCodeTypeEnum"), exports);

package/package.json

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

package/src/networkConnector/dtos/UploadProfilePhotoRequest.ts

@@ -0,0 +1,11 @@
+import { Expose } from 'class-transformer';
+import { IsString, IsNotEmpty, IsEnum } from 'class-validator';
+import { PhotoContentType } from '../enums/PhotoContentType';
+
+export class UploadProfilePhotoRequest {
+    /** Base64 puro (sin prefijo data:image/...) */
+    @Expose() @IsString() @IsNotEmpty() photoBase64!: string;
+
+    /** MIME type de la imagen */
+    @Expose() @IsEnum(PhotoContentType) mimeType!: PhotoContentType;
+}

package/src/networkConnector/dtos/UploadProfilePhotoResponse.ts

@@ -0,0 +1,4 @@
+export interface UploadProfilePhotoResponse {
+    /** Presigned URL para acceder a la foto recien subida */
+    photoUrl: string;
+}

package/src/networkConnector/index.ts

@@ -30,3 +30,5 @@ export * from './dtos/ListLeadGroupsResponse';
 export * from './dtos/GetPhotoUploadUrlRequest';
 export * from './dtos/PhotoUploadUrlResponse';
 export * from './dtos/DeletePhotoResponse';
+export * from './dtos/UploadProfilePhotoRequest';
+export * from './dtos/UploadProfilePhotoResponse';

package/src/walletFunding/dtos/FundingPaymentChannel.ts

@@ -0,0 +1,16 @@
+/**
+ * Canal/tienda donde el cliente puede pagar la referencia de fondeo.
+ * Provider-agnóstico: equivale a `centers` de Equality, `stores` de OpenPay, etc.
+ */
+export class FundingPaymentChannel {
+    /** Nombre legible. Ej: "OXXO", "7-Eleven", "Farmacia Guadalajara". */
+    name!: string;
+    /** URL del logo del canal (opcional). */
+    logo?: string;
+    /**
+     * Categoría comercial. Permite agrupar/filtrar en el frontend.
+     * Valores sugeridos: `CONVENIENCE_STORE | PHARMACY | BANK | SUPERMARKET | OTHER`.
+     * No se enforza enum para mantener extensibilidad sin breaking change.
+     */
+    category?: string;
+}

package/src/walletFunding/dtos/FundingProviderReferenceData.ts

@@ -1,3 +1,9 @@
+import { FundingReferenceItem } from "./FundingReferenceItem";
+
+/**
+ * @deprecated Usar {@link FundingReferenceItem} (standard Fiado provider-agnóstico).
+ * Shape Equality-específico — solo se mantiene para compat con consumers viejos.
+ */
 export class FundingProviderReferenceItem {
     reference!: string;
     centers!: Array<{ name: string; logo: string }>;
@@ -5,6 +11,14 @@ export class FundingProviderReferenceItem {
     barcode!: string;
 }
 
+/**
+ * Wrapper de referencias devueltas por el provider tras `createFundingReference`.
+ * Usa el shape estándar Fiado {@link FundingReferenceItem} — provider-agnóstico.
+ *
+ * Una sola operación puede devolver múltiples referencias (una por canal o por
+ * región). Equality/Passport típicamente devuelve 1 referencia con N canales
+ * agrupados en `paymentChannels`; otros providers pueden separar por reference.
+ */
 export class FundingProviderReferenceData {
-    references!: FundingProviderReferenceItem[];
+    references!: FundingReferenceItem[];
 }

package/src/walletFunding/dtos/FundingReferenceItem.ts

@@ -0,0 +1,37 @@
+import { PaymentCodeTypeEnum } from "../enums/PaymentCodeTypeEnum";
+import { FundingPaymentChannel } from "./FundingPaymentChannel";
+
+/**
+ * Forma estándar Fiado de una referencia de fondeo. Provider-agnóstica.
+ *
+ * Cada provider concreto (Equality, OpenPay, Mercado Pago…) implementa un mapper
+ * que traduce su shape nativo a este DTO. El wallet-app y los consumers internos
+ * SOLO conocen este shape — el shape del provider queda aislado en el connector.
+ *
+ * Mapping references:
+ *  - Equality/Passport: `{reference, barcode, centers, centerId}`
+ *     → `{reference, paymentCodeImage: barcode, paymentCodeType: BARCODE_1D,
+ *         paymentChannels: centers, providerMetadata: {centerId}}`.
+ *  - OpenPay: `{qrToken, qrUrl, affiliationId}`
+ *     → `{reference: qrToken, paymentCodeImage: qrUrl, paymentCodeType: QR,
+ *         providerMetadata: {affiliationId}}`.
+ */
+export class FundingReferenceItem {
+    /** Identificador/cadena que el cliente paga en caja. */
+    reference!: string;
+    /** Tipo del código (define cómo lo renderiza el frontend). */
+    paymentCodeType!: PaymentCodeTypeEnum;
+    /** URL de la imagen del código (barcode/QR). Null si paymentCodeType=TEXT|NONE. */
+    paymentCodeImage?: string;
+    /** Lista de canales/tiendas donde el cliente puede pagar. */
+    paymentChannels?: FundingPaymentChannel[];
+    /** Texto instructivo localizable para el cliente. */
+    instructions?: string;
+    /** Vencimiento ISO de la referencia (puede heredarse del request). */
+    expiresAt?: string;
+    /**
+     * Metadata específica del provider — OPACA al wallet-app.
+     * Útil para soporte/debug. Cada provider la usa a su discreción.
+     */
+    providerMetadata?: Record<string, unknown>;
+}

package/src/walletFunding/dtos/index.ts

@@ -1,4 +1,6 @@
 export * from "./FundingProviderReferenceData";
+export * from "./FundingPaymentChannel";
+export * from "./FundingReferenceItem";
 export * from "./AuthorizeWalletFundingRequest";
 export * from "./AuthorizeWalletFundingResponse";
 export * from "./CancelWalletFundingRequest";

package/src/walletFunding/enums/PaymentCodeTypeEnum.ts

@@ -0,0 +1,17 @@
+/**
+ * Tipo del código de pago que el cliente presenta en caja. Permite al frontend
+ * renderizar la imagen correcta (barcode 1D, QR) o solo texto.
+ *
+ * Provider-agnóstico: cada provider (Equality, OpenPay, Mercado Pago…) mapea
+ * su shape nativo a este enum.
+ */
+export enum PaymentCodeTypeEnum {
+    /** Código de barras 1D (Code 128, EAN-13, etc.). Ej: Equality/Passport. */
+    BARCODE_1D = "BARCODE_1D",
+    /** QR code. Ej: OpenPay, Mercado Pago. */
+    QR = "QR",
+    /** Solo referencia numérica/alfanumérica sin imagen. */
+    TEXT = "TEXT",
+    /** Sin código (provider no genera código visible). */
+    NONE = "NONE",
+}

package/src/walletFunding/enums/index.ts

@@ -4,3 +4,4 @@ export * from "./WalletFundingReferenceStatusEnum";
 export * from "./WalletFundingPaymentStatusEnum";
 export * from "./WalletFundingErrorCodeEnum";
 export * from "./WalletFundingRefundReasonEnum";
+export * from "./PaymentCodeTypeEnum";