@fiado/api-invoker 5.33.1 → 5.34.0

package/bin/synergypay-connector/api/SynergyPayConnectorApi.d.ts

@@ -1,7 +1,7 @@
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ConnectorCatalogResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
-import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, ListFundingReferencesResponse, ApplyWalletFundingRequest, ApplyWalletFundingResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
+import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, ListFundingReferencesResponse, ApplyWalletFundingRequest, ApplyWalletFundingResponse, ListFundingStoresRequest, ListFundingStoresResponse, WalletFundingReferenceStatusEnum } from "@fiado/type-kit/bin/walletFunding/index.js";
 import { ISynergyPayConnectorApi } from "./interfaces/ISynergyPayConnectorApi.js";
 export default class SynergyPayConnectorApi implements ISynergyPayConnectorApi {
     private httpRequest;
@@ -14,5 +14,11 @@ export default class SynergyPayConnectorApi implements ISynergyPayConnectorApi {
         includeDisabled?: boolean;
     }): Promise<ApiGatewayResponse<ConnectorCatalogResponse>>;
     applyFunding(request: ApplyWalletFundingRequest): Promise<ApiGatewayResponse<ApplyWalletFundingResponse>>;
+    listStores(query: ListFundingStoresRequest): Promise<ApiGatewayResponse<ListFundingStoresResponse>>;
+    cancelFundingReference(reference: string, reason?: "USER" | "WALLET_DEACTIVATED" | "OPS"): Promise<ApiGatewayResponse<{
+        reference: string;
+        status: WalletFundingReferenceStatusEnum;
+        cancelled: boolean;
+    }>>;
     getPendingFunding(directoryId: string): Promise<ApiGatewayResponse<any>>;
 }

package/bin/synergypay-connector/api/SynergyPayConnectorApi.js

@@ -39,6 +39,29 @@ let SynergyPayConnectorApi = class SynergyPayConnectorApi {
         const url = `${this.baseUrl}/funding/apply`;
         return await this.httpRequest.post(url, request);
     }
+    async listStores(query) {
+        const params = new URLSearchParams({
+            latitude: String(query.latitude),
+            longitude: String(query.longitude),
+        });
+        // `radius` y `product` ausentes se OMITEN: el connector aplica sus
+        // defaults (el radio del proveedor y `cashin`). Mandarlos vacios los
+        // convertiria en filtros invalidos.
+        if (query.radius !== undefined)
+            params.set("radius", String(query.radius));
+        if (query.product !== undefined)
+            params.set("product", query.product);
+        const url = `${this.baseUrl}/stores?${params.toString()}`;
+        return await this.httpRequest.get(url);
+    }
+    async cancelFundingReference(reference, reason) {
+        const params = new URLSearchParams();
+        if (reason)
+            params.set("reason", reason);
+        const qs = params.toString();
+        const url = `${this.baseUrl}/funding/references/${encodeURIComponent(reference)}${qs ? `?${qs}` : ""}`;
+        return await this.httpRequest.delete(url);
+    }
     async getPendingFunding(directoryId) {
         const url = `${this.baseUrl}/funding/pending?directoryId=${encodeURIComponent(directoryId)}`;
         return await this.httpRequest.get(url);

package/bin/synergypay-connector/api/interfaces/ISynergyPayConnectorApi.d.ts

@@ -1,6 +1,6 @@
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ConnectorCatalogResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
-import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, ListFundingReferencesResponse, ApplyWalletFundingRequest, ApplyWalletFundingResponse } from "@fiado/type-kit/bin/walletFunding/index.js";
+import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, ListFundingReferencesResponse, ApplyWalletFundingRequest, ApplyWalletFundingResponse, ListFundingStoresRequest, ListFundingStoresResponse, WalletFundingReferenceStatusEnum } from "@fiado/type-kit/bin/walletFunding/index.js";
 /**
  * Cliente del marketplace hacia synergypay-connector (privado, dentro de la VPC).
  *
@@ -14,6 +14,8 @@ import { CreateFundingReferenceRequest, CreateFundingReferenceResponse, ListFund
  *  - GET  /funding/references?directoryId=&status=
  *  - GET  /catalog/standard?benefitId=&includeDisabled=
  *  - POST /funding/apply
+ *  - GET  /stores?latitude=&longitude=&radius=&product=
+ *  - DELETE /funding/references/{reference}?reason=
  *
  * NOTA: los endpoints `/passport/*` del BackOffice (SPEC 1.3) NO están incluidos —
  * el synergypay-connector aún no los expone (F6.1 construyó solo el money-path).
@@ -42,6 +44,35 @@ export interface ISynergyPayConnectorApi {
      * queda para el cierre SETTLED (conciliación bancaria) — mismo contrato canónico.
      */
     applyFunding(request: ApplyWalletFundingRequest): Promise<ApiGatewayResponse<ApplyWalletFundingResponse>>;
+    /**
+     * Directorio de tiendas cercanas donde el cliente puede presentar su
+     * referencia y entregar el efectivo.
+     *
+     * Va APARTE de la referencia a proposito: una referencia sirve en cualquier
+     * tienda afiliada, asi que el directorio cambia —altas, bajas, horarios,
+     * comisiones— sin tocar referencias vivas. El connector filtra por
+     * `product=cashin` cuando no se especifica: sin ese filtro, buena parte de
+     * las tiendas que devuelve el proveedor no aceptan deposito.
+     */
+    listStores(query: ListFundingStoresRequest): Promise<ApiGatewayResponse<ListFundingStoresResponse>>;
+    /**
+     * Cancela una referencia en el proveedor Y en la tabla del connector, en ese
+     * orden.
+     *
+     * Es la unica palanca que frena el efectivo ANTES de que entre a la caja:
+     * rechazar el webhook no alcanza, porque cuando el proveedor llama el cobro
+     * ya ocurrio. NO cancelar por fuera (curl directo al proveedor) — las dos
+     * mitades quedan desincronizadas y creeriamos que el cliente puede
+     * depositar cuando la caja ya no se lo permite.
+     *
+     * Idempotente: cancelar algo ya cancelado devuelve `cancelled: false`, no
+     * un error.
+     */
+    cancelFundingReference(reference: string, reason?: "USER" | "WALLET_DEACTIVATED" | "OPS"): Promise<ApiGatewayResponse<{
+        reference: string;
+        status: WalletFundingReferenceStatusEnum;
+        cancelled: boolean;
+    }>>;
     /**
      * Cash-in AUTORIZADO pero aun no acreditado del cliente, en el mes en curso.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.33.1",
+    "version": "5.34.0",
   "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicación entre ellas a través de invocaciones http",
   "type": "module",
   "main": "bin/index.js",
@@ -34,7 +34,7 @@
     "@fiado/gateway-adapter": "^3.9.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.319.0",
+    "@fiado/type-kit": "^3.327.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/synergypay-connector/api/SynergyPayConnectorApi.ts

@@ -1,5 +1,5 @@
 import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { ApiGatewayResponse } from "@fiado/gateway-adapter";
 import { ConnectorCatalogResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
 import {
@@ -8,6 +8,9 @@ import {
     ListFundingReferencesResponse,
     ApplyWalletFundingRequest,
     ApplyWalletFundingResponse,
+    ListFundingStoresRequest,
+    ListFundingStoresResponse,
+    WalletFundingReferenceStatusEnum,
 } from "@fiado/type-kit/bin/walletFunding/index.js";
 import { ISynergyPayConnectorApi } from "./interfaces/ISynergyPayConnectorApi.js";
 
@@ -50,6 +53,36 @@ export default class SynergyPayConnectorApi implements ISynergyPayConnectorApi {
         return await this.httpRequest.post(url, request);
     }
 
+    async listStores(
+        query: ListFundingStoresRequest,
+    ): Promise<ApiGatewayResponse<ListFundingStoresResponse>> {
+        const params = new URLSearchParams({
+            latitude: String(query.latitude),
+            longitude: String(query.longitude),
+        });
+        // `radius` y `product` ausentes se OMITEN: el connector aplica sus
+        // defaults (el radio del proveedor y `cashin`). Mandarlos vacios los
+        // convertiria en filtros invalidos.
+        if (query.radius !== undefined) params.set("radius", String(query.radius));
+        if (query.product !== undefined) params.set("product", query.product);
+        const url = `${this.baseUrl}/stores?${params.toString()}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async cancelFundingReference(
+        reference: string,
+        reason?: "USER" | "WALLET_DEACTIVATED" | "OPS",
+    ): Promise<ApiGatewayResponse<{
+        reference: string;
+        status: WalletFundingReferenceStatusEnum;
+        cancelled: boolean;
+    }>> {
+        const params = new URLSearchParams();
+        if (reason) params.set("reason", reason);
+        const qs = params.toString();
+        const url = `${this.baseUrl}/funding/references/${encodeURIComponent(reference)}${qs ? `?${qs}` : ""}`;
+        return await this.httpRequest.delete(url);
+    }
     async getPendingFunding(directoryId: string): Promise<ApiGatewayResponse<any>> {
         const url = `${this.baseUrl}/funding/pending?directoryId=${encodeURIComponent(directoryId)}`;
         return await this.httpRequest.get(url);

package/src/synergypay-connector/api/interfaces/ISynergyPayConnectorApi.ts

@@ -6,6 +6,9 @@ import {
     ListFundingReferencesResponse,
     ApplyWalletFundingRequest,
     ApplyWalletFundingResponse,
+    ListFundingStoresRequest,
+    ListFundingStoresResponse,
+    WalletFundingReferenceStatusEnum,
 } from "@fiado/type-kit/bin/walletFunding/index.js";
 
 /**
@@ -21,6 +24,8 @@ import {
  *  - GET  /funding/references?directoryId=&status=
  *  - GET  /catalog/standard?benefitId=&includeDisabled=
  *  - POST /funding/apply
+ *  - GET  /stores?latitude=&longitude=&radius=&product=
+ *  - DELETE /funding/references/{reference}?reason=
  *
  * NOTA: los endpoints `/passport/*` del BackOffice (SPEC 1.3) NO están incluidos —
  * el synergypay-connector aún no los expone (F6.1 construyó solo el money-path).
@@ -58,6 +63,39 @@ export interface ISynergyPayConnectorApi {
     applyFunding(
         request: ApplyWalletFundingRequest,
     ): Promise<ApiGatewayResponse<ApplyWalletFundingResponse>>;
+
+    /**
+     * Directorio de tiendas cercanas donde el cliente puede presentar su
+     * referencia y entregar el efectivo.
+     *
+     * Va APARTE de la referencia a proposito: una referencia sirve en cualquier
+     * tienda afiliada, asi que el directorio cambia —altas, bajas, horarios,
+     * comisiones— sin tocar referencias vivas. El connector filtra por
+     * `product=cashin` cuando no se especifica: sin ese filtro, buena parte de
+     * las tiendas que devuelve el proveedor no aceptan deposito.
+     */
+    listStores(query: ListFundingStoresRequest): Promise<ApiGatewayResponse<ListFundingStoresResponse>>;
+    /**
+     * Cancela una referencia en el proveedor Y en la tabla del connector, en ese
+     * orden.
+     *
+     * Es la unica palanca que frena el efectivo ANTES de que entre a la caja:
+     * rechazar el webhook no alcanza, porque cuando el proveedor llama el cobro
+     * ya ocurrio. NO cancelar por fuera (curl directo al proveedor) — las dos
+     * mitades quedan desincronizadas y creeriamos que el cliente puede
+     * depositar cuando la caja ya no se lo permite.
+     *
+     * Idempotente: cancelar algo ya cancelado devuelve `cancelled: false`, no
+     * un error.
+     */
+    cancelFundingReference(
+        reference: string,
+        reason?: "USER" | "WALLET_DEACTIVATED" | "OPS",
+    ): Promise<ApiGatewayResponse<{
+        reference: string;
+        status: WalletFundingReferenceStatusEnum;
+        cancelled: boolean;
+    }>>;
     /**
      * Cash-in AUTORIZADO pero aun no acreditado del cliente, en el mes en curso.
      *