@payware/mcp-server 1.5.1 → 2.0.1

package/src/payment-institution/deep-links/get-transaction-link.js

@@ -1,143 +0,0 @@
-import { getTransactionDeepLink } from '../../shared/deep-links/api.js';
-import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
-import { ADDS } from '../../shared/tool-annotations.js';
-
-/**
- * Get deep link for a payment institution transaction
- */
-export const getTransactionLinkTool = {
-  name: "payware_deep_links_get_transaction_link",
-  annotations: ADDS,
-  description: `Get an active deep link for a transaction where the payment institution acts as source (SRC) or destination (DST). Returns a clickable URL that redirects to the payware mobile app.
-
-**Deep Link Format:**
-- Web URL: https://go.payware.eu/{transactionId}
-- Mobile Redirect: payware:/{transactionId} (one slash: the identifier is case-sensitive, so it must not sit in the URI host, which redirect services lowercase)
-
-**Use Cases:**
-- P2P payments initiated via messaging services
-- Transaction notifications with direct links
-- Transaction status sharing
-
-**Important Notes:**
-- Deep links are only supported in production environment
-- Apps that open payware links must accept \`payware:\` followed by one, two or three slashes (QR codes and NFC tags carry \`payware://{id}\`): read the identifier after the scheme and any slashes, up to \`/\`, \`?\` or \`#\`, and keep its case
-- Link expiration is synchronized with the referenced transaction
-- Payment institutions only manage transaction links (no product links)
-- Traditional deep links that route to app content when app is installed`,
-
-  inputSchema: {
-    type: "object",
-    properties: {
-      transactionId: {
-        type: "string",
-        description: "The transaction identifier (e.g., 'pw7e4rCToG')",
-        pattern: "^[a-zA-Z0-9]+$"
-      },
-      partnerId: {
-        type: "string",
-        description: "Payment Institution Partner ID from payware dashboard. Uses PAYWARE_PARTNER_ID env var as default.",
-        default: getPartnerIdSafe()
-      },
-      privateKey: {
-        type: "string",
-        description: "RSA private key for JWT token creation. Uses environment-specific private key as default."
-      }
-    },
-    required: ["transactionId"]
-  },
-
-  async handler(args) {
-    const {
-      transactionId,
-      partnerId = getPartnerIdSafe(),
-      privateKey = getPrivateKeySafe()
-    } = args;
-
-    if (!transactionId) {
-      throw new Error("transactionId is required");
-    }
-
-    if (!partnerId) {
-      throw new Error("Partner ID is required. Provide via 'partnerId' parameter or set PAYWARE_PARTNER_ID environment variable.");
-    }
-
-    if (!privateKey) {
-      throw new Error("Private key is required. Provide via 'privateKey' parameter or set PAYWARE_PRIVATE_KEY environment variable.");
-    }
-
-    try {
-      const result = await getTransactionDeepLink({
-        transactionId,
-        partnerType: 'payment_institution',
-        partnerId,
-        privateKey
-      });
-
-      // Extract the URL - API returns either string directly or object with link property
-      const linkUrl = typeof result.data === 'string' ? result.data : (result.data.link || result.data)
-
-      return {
-        content: [{
-          type: "text",
-          text: `🔗 **Transaction Deep Link Retrieved (Payment Institution)**
-
-**Deep Link Details:**
-- Transaction ID: ${transactionId}
-- Web URL: ${linkUrl}
-- Mobile Redirect: payware:/${transactionId}
-
-**Payment Institution Info:**
-- Partner ID: ${partnerId}
-- Role: SRC/DST for P2P transactions
-
-**Link Information:**
-- Status: Active
-- Expiration: Synchronized with transaction
-- Platform: Production only
-
-**API Response:**
-\`\`\`json
-${JSON.stringify(result.data, null, 2)}
-\`\`\`
-
-**API Call Details:**
-- Endpoint: GET ${result.requestInfo.url}
-- Status: ${result.requestInfo.statusCode}
-- Method: ${result.requestInfo.method}
-
-**Usage:**
-1. Share the web URL: \`${linkUrl}\`
-2. On mobile devices, it will redirect to: \`payware:/${transactionId}\`
-3. Link expires when the transaction expires
-4. Use for P2P transaction notifications and sharing`
-        }]
-      };
-    } catch (error) {
-      return {
-        content: [{
-          type: "text",
-          text: `❌ **Failed to Get Transaction Deep Link (Payment Institution)**
-
-**Error Details:**
-- Transaction ID: ${transactionId}
-- Message: ${error.message}
-
-**Common Issues:**
-1. **Transaction not found**: Check if transaction exists and is not expired
-2. **Authentication failed**: Verify partner ID and private key
-3. **Authorization failed**: Ensure PI is SRC or DST for this transaction
-4. **Sandbox environment**: Deep links are production-only
-5. **Invalid transaction ID**: Ensure transaction ID format is correct
-
-**Troubleshooting:**
-1. Verify transaction exists using \`payware_operations_get_transaction_status\`
-2. Check if running in production environment
-3. Ensure JWT authentication is working
-4. Confirm payment institution role in transaction
-5. Verify transaction is not expired`
-        }]
-      };
-    }
-  }
-};

package/src/payment-institution/deep-links/index.js

@@ -1,17 +0,0 @@
-/**
- * Payment Institution Deep Links Tools
- * Deep link management for payment institutions (transaction links only)
- */
-
-import { getTransactionLinkTool } from './get-transaction-link.js';
-import { deleteTransactionLinkTool } from './delete-transaction-link.js';
-
-export const paymentInstitutionDeepLinksTools = [
-  getTransactionLinkTool,
-  deleteTransactionLinkTool
-];
-
-export {
-  getTransactionLinkTool,
-  deleteTransactionLinkTool
-};

package/src/shared/deep-links/api.js

@@ -1,215 +0,0 @@
-import axios from 'axios';
-import { createJWTToken } from '../../core/auth/jwt-token.js';
-import { createJWTForPartner } from '../../core/auth/jwt-factory.js';
-import { getProductionUrl } from '../../config/env.js';
-import { describeApiError } from '../api-errors.js';
-
-/**
- * Create authentication headers based on partner type
- * @param {string} partnerType - merchant, isv, or payment_institution
- * @param {Object} authParams - Authentication parameters
- * @returns {Object} Headers for API request
- */
-async function createAuthHeaders(partnerType, authParams) {
-  const baseHeaders = {
-    'Content-Type': 'application/json',
-    'Api-Version': '1'
-  };
-
-  let tokenData;
-
-  switch (partnerType) {
-    case 'merchant':
-    case 'payment_institution':
-      // Standard JWT authentication
-      tokenData = createJWTToken(
-        authParams.partnerId,
-        authParams.privateKey,
-        authParams.requestBody || ''
-      );
-      break;
-
-    case 'isv':
-      // ISV JWT with OAuth2 - note the parameter mapping
-      tokenData = await createJWTForPartner({
-        partnerId: authParams.isvPartnerId,
-        privateKey: authParams.privateKey,
-        merchantId: authParams.merchantPartnerId,  // Map merchantPartnerId to merchantId
-        oauth2Token: authParams.oauth2Token,
-        requestBody: authParams.requestBody || ''
-      });
-      break;
-
-    default:
-      throw new Error(`Unknown partner type: ${partnerType}`);
-  }
-
-  return {
-    ...baseHeaders,
-    'Authorization': `Bearer ${tokenData.token}`
-  };
-}
-
-/**
- * Get deep link for a transaction
- * @param {Object} params - Parameters
- * @param {string} params.transactionId - Transaction ID
- * @param {string} params.partnerType - Partner type (merchant, isv, payment_institution)
- * @param {Object} params.authParams - Authentication parameters
- * @returns {Object} Deep link response
- */
-export async function getTransactionDeepLink({
-  transactionId,
-  partnerType,
-  ...authParams
-}) {
-  if (!transactionId) {
-    throw new Error('transactionId is required');
-  }
-
-  const headers = await createAuthHeaders(partnerType, authParams);
-
-  try {
-    const response = await axios.get(
-      `${getProductionUrl()}/transactions/${transactionId}/link`,
-      { headers }
-    );
-
-    return {
-      success: true,
-      data: response.data,
-      requestInfo: {
-        url: `${getProductionUrl()}/transactions/${transactionId}/link`,
-        method: 'GET',
-        statusCode: response.status
-      }
-    };
-  } catch (error) {
-    throw describeApiError(error, 'get transaction deep link');
-  }
-}
-
-/**
- * Get deep link for a product
- * @param {Object} params - Parameters
- * @param {string} params.productId - Product ID
- * @param {string} params.partnerType - Partner type (merchant, isv)
- * @param {Object} params.authParams - Authentication parameters
- * @returns {Object} Deep link response
- */
-export async function getProductDeepLink({
-  productId,
-  partnerType,
-  ...authParams
-}) {
-  if (!productId) {
-    throw new Error('productId is required');
-  }
-
-  if (partnerType === 'payment_institution') {
-    throw new Error('Payment institutions do not manage products');
-  }
-
-  const headers = await createAuthHeaders(partnerType, authParams);
-
-  try {
-    const response = await axios.get(
-      `${getProductionUrl()}/products/${productId}/link`,
-      { headers }
-    );
-
-    return {
-      success: true,
-      data: response.data,
-      requestInfo: {
-        url: `${getProductionUrl()}/products/${productId}/link`,
-        method: 'GET',
-        statusCode: response.status
-      }
-    };
-  } catch (error) {
-    throw describeApiError(error, 'get product deep link');
-  }
-}
-
-/**
- * Delete deep link for a transaction
- * @param {Object} params - Parameters
- * @param {string} params.transactionId - Transaction ID
- * @param {string} params.partnerType - Partner type (merchant, isv, payment_institution)
- * @param {Object} params.authParams - Authentication parameters
- * @returns {Object} Delete response
- */
-export async function deleteTransactionDeepLink({
-  transactionId,
-  partnerType,
-  ...authParams
-}) {
-  if (!transactionId) {
-    throw new Error('transactionId is required');
-  }
-
-  const headers = await createAuthHeaders(partnerType, authParams);
-
-  try {
-    const response = await axios.delete(
-      `${getProductionUrl()}/transactions/${transactionId}/link`,
-      { headers }
-    );
-
-    return {
-      success: true,
-      data: response.data,
-      requestInfo: {
-        url: `${getProductionUrl()}/transactions/${transactionId}/link`,
-        method: 'DELETE',
-        statusCode: response.status
-      }
-    };
-  } catch (error) {
-    throw describeApiError(error, 'delete transaction deep link');
-  }
-}
-
-/**
- * Delete deep link for a product
- * @param {Object} params - Parameters
- * @param {string} params.productId - Product ID
- * @param {string} params.partnerType - Partner type (merchant, isv)
- * @param {Object} params.authParams - Authentication parameters
- * @returns {Object} Delete response
- */
-export async function deleteProductDeepLink({
-  productId,
-  partnerType,
-  ...authParams
-}) {
-  if (!productId) {
-    throw new Error('productId is required');
-  }
-
-  if (partnerType === 'payment_institution') {
-    throw new Error('Payment institutions do not manage products');
-  }
-
-  const headers = await createAuthHeaders(partnerType, authParams);
-
-  try {
-    const response = await axios.delete(
-      `${getProductionUrl()}/products/${productId}/link`,
-      { headers }
-    );
-
-    return {
-      success: true,
-      data: response.data,
-      requestInfo: {
-        url: `${getProductionUrl()}/products/${productId}/link`,
-        method: 'DELETE',
-        statusCode: response.status
-      }
-    };
-  } catch (error) {
-    throw describeApiError(error, 'delete product deep link');
-  }
-}