@payware/mcp-server 1.5.1 → 2.0.0

package/src/merchant/deep-links/delete-transaction-link.js

@@ -1,122 +0,0 @@
-import { deleteTransactionDeepLink } from '../../shared/deep-links/api.js';
-import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
-import { CHANGES } from '../../shared/tool-annotations.js';
-
-/**
- * Delete deep link for a merchant transaction
- */
-export const deleteTransactionLinkTool = {
-  name: "payware_deep_links_delete_transaction_link",
-  annotations: CHANGES,
-  description: `Delete an active deep link for a transaction. Once deleted, the deep link URL will no longer redirect to the payware mobile app.
-
-**Use Cases:**
-- Remove expired transaction links
-- Clean up after transaction completion
-- Security cleanup for sensitive transactions
-
-**Important Notes:**
-- Deep links are only supported in production environment
-- Once deleted, the link cannot be recovered - you'll need to create a new one
-- This operation is irreversible`,
-
-  inputSchema: {
-    type: "object",
-    properties: {
-      transactionId: {
-        type: "string",
-        description: "The transaction identifier (e.g., 'pw7e4rCToG')",
-        pattern: "^[a-zA-Z0-9]+$"
-      },
-      partnerId: {
-        type: "string",
-        description: "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 deleteTransactionDeepLink({
-        transactionId,
-        partnerType: 'merchant',
-        partnerId,
-        privateKey
-      });
-
-      return {
-        content: [{
-          type: "text",
-          text: `✅ **Transaction Deep Link Deleted**
-
-**Deletion Details:**
-- Transaction ID: ${transactionId}
-- Status: Successfully deleted
-- Link URL: https://go.payware.eu/${transactionId} (now inactive)
-
-**API Call Details:**
-- Endpoint: DELETE ${result.requestInfo.url}
-- Status: ${result.requestInfo.statusCode}
-- Method: ${result.requestInfo.method}
-
-**Result:**
-- The deep link is no longer active
-- Mobile redirects will no longer work
-- URL will return an error if accessed
-
-**Important Notes:**
-⚠️ This operation is irreversible
-⚠️ Create a new link if needed using \`payware_deep_links_get_transaction_link\`
-⚠️ Any existing shared links will stop working immediately`
-        }]
-      };
-    } catch (error) {
-      return {
-        content: [{
-          type: "text",
-          text: `❌ **Failed to Delete Transaction Deep Link**
-
-**Error Details:**
-- Transaction ID: ${transactionId}
-- Message: ${error.message}
-
-**Common Issues:**
-1. **Link not found**: Deep link may already be deleted or never existed
-2. **Authentication failed**: Verify partner ID and private key
-3. **Sandbox environment**: Deep links are production-only
-4. **Invalid transaction ID**: Ensure transaction ID format is correct
-
-**Troubleshooting:**
-1. Check if deep link exists using \`payware_deep_links_get_transaction_link\`
-2. Verify running in production environment
-3. Ensure JWT authentication is working
-4. Confirm transaction ID is correct`
-        }]
-      };
-    }
-  }
-};

package/src/merchant/deep-links/get-product-link.js

@@ -1,136 +0,0 @@
-import { getProductDeepLink } 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 merchant product
- */
-export const getProductLinkTool = {
-  name: "payware_deep_links_get_product_link",
-  annotations: ADDS,
-  description: `Get an active deep link for a product. Returns a clickable URL that redirects to the payware mobile app. For a link whose payments are attributed to one placement of the product (a poster, an ad, a mailing), use payware_products_get_placement_link instead.
-
-**Deep Link Format:**
-- Web URL: https://go.payware.eu/{productId}
-- Mobile Redirect: payware:/{productId} (one slash: the identifier is case-sensitive, so it must not sit in the URI host, which redirect services lowercase)
-
-**Use Cases:**
-- Mobile-only e-commerce product references
-- Advertisement links to products
-- Product sharing via messaging
-
-**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 product
-- Traditional deep links that route to app content when app is installed`,
-
-  inputSchema: {
-    type: "object",
-    properties: {
-      productId: {
-        type: "string",
-        description: "The product identifier (e.g., 'pr7e4rCToG')",
-        pattern: "^[a-zA-Z0-9]+$"
-      },
-      partnerId: {
-        type: "string",
-        description: "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: ["productId"]
-  },
-
-  async handler(args) {
-    const {
-      productId,
-      partnerId = getPartnerIdSafe(),
-      privateKey = getPrivateKeySafe()
-    } = args;
-
-    if (!productId) {
-      throw new Error("productId 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 getProductDeepLink({
-        productId,
-        partnerType: 'merchant',
-        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: `🔗 **Product Deep Link Retrieved**
-
-**Deep Link Details:**
-- Product ID: ${productId}
-- Web URL: ${linkUrl}
-- Mobile Redirect: payware:/${productId}
-
-**Link Information:**
-- Status: Active
-- Expiration: Synchronized with product
-- 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:/${productId}\`
-3. Link expires when the product expires
-4. Recreate if product is updated`
-        }]
-      };
-    } catch (error) {
-      return {
-        content: [{
-          type: "text",
-          text: `❌ **Failed to Get Product Deep Link**
-
-**Error Details:**
-- Product ID: ${productId}
-- Message: ${error.message}
-
-**Common Issues:**
-1. **Product not found**: Check if product exists and is not expired
-2. **Authentication failed**: Verify partner ID and private key
-3. **Sandbox environment**: Deep links are production-only
-4. **Invalid product ID**: Ensure product ID format is correct
-
-**Troubleshooting:**
-1. Verify product exists in your payware dashboard
-2. Check if running in production environment
-3. Ensure JWT authentication is working
-4. Confirm product is active and not expired`
-        }]
-      };
-    }
-  }
-};

package/src/merchant/deep-links/get-transaction-link.js

@@ -1,136 +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 merchant transaction
- */
-export const getTransactionLinkTool = {
-  name: "payware_deep_links_get_transaction_link",
-  annotations: ADDS,
-  description: `Get an active deep link for a transaction. 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 via messaging services
-- Mobile-only e-commerce payments
-- Advertisement references
-
-**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
-- 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: "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: 'merchant',
-        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**
-
-**Deep Link Details:**
-- Transaction ID: ${transactionId}
-- Web URL: ${linkUrl}
-- Mobile Redirect: payware:/${transactionId}
-
-**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. Recreate if transaction is extended`
-        }]
-      };
-    } catch (error) {
-      return {
-        content: [{
-          type: "text",
-          text: `❌ **Failed to Get Transaction Deep Link**
-
-**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. **Sandbox environment**: Deep links are production-only
-4. **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 transaction is not expired`
-        }]
-      };
-    }
-  }
-};

package/src/merchant/deep-links/index.js

@@ -1,23 +0,0 @@
-/**
- * Merchant Deep Links Tools
- * Deep link management for merchants
- */
-
-import { getTransactionLinkTool } from './get-transaction-link.js';
-import { getProductLinkTool } from './get-product-link.js';
-import { deleteTransactionLinkTool } from './delete-transaction-link.js';
-import { deleteProductLinkTool } from './delete-product-link.js';
-
-export const merchantDeepLinksTools = [
-  getTransactionLinkTool,
-  getProductLinkTool,
-  deleteTransactionLinkTool,
-  deleteProductLinkTool
-];
-
-export {
-  getTransactionLinkTool,
-  getProductLinkTool,
-  deleteTransactionLinkTool,
-  deleteProductLinkTool
-};

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

@@ -1,129 +0,0 @@
-import { deleteTransactionDeepLink } from '../../shared/deep-links/api.js';
-import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
-import { CHANGES } from '../../shared/tool-annotations.js';
-
-/**
- * Delete deep link for a payment institution transaction
- */
-export const deleteTransactionLinkTool = {
-  name: "payware_deep_links_delete_transaction_link",
-  annotations: CHANGES,
-  description: `Delete an active deep link for a transaction where the payment institution acts as source (SRC) or destination (DST). Once deleted, the deep link URL will no longer redirect to the payware mobile app.
-
-**Use Cases:**
-- Remove expired transaction links
-- Clean up after transaction completion
-- Security cleanup for sensitive P2P transactions
-
-**Important Notes:**
-- Deep links are only supported in production environment
-- Once deleted, the link cannot be recovered - you'll need to create a new one
-- Payment institutions only manage transaction links (no product links)
-- This operation is irreversible`,
-
-  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 deleteTransactionDeepLink({
-        transactionId,
-        partnerType: 'payment_institution',
-        partnerId,
-        privateKey
-      });
-
-      return {
-        content: [{
-          type: "text",
-          text: `✅ **Transaction Deep Link Deleted (Payment Institution)**
-
-**Deletion Details:**
-- Transaction ID: ${transactionId}
-- Status: Successfully deleted
-- Link URL: https://go.payware.eu/${transactionId} (now inactive)
-
-**Payment Institution Info:**
-- Partner ID: ${partnerId}
-- Role: SRC/DST for P2P transactions
-
-**API Call Details:**
-- Endpoint: DELETE ${result.requestInfo.url}
-- Status: ${result.requestInfo.statusCode}
-- Method: ${result.requestInfo.method}
-
-**Result:**
-- The deep link is no longer active
-- Mobile redirects will no longer work
-- URL will return an error if accessed
-
-**Important Notes:**
-⚠️ This operation is irreversible
-⚠️ Create a new link if needed using \`payware_deep_links_get_transaction_link\`
-⚠️ Any existing shared links will stop working immediately`
-        }]
-      };
-    } catch (error) {
-      return {
-        content: [{
-          type: "text",
-          text: `❌ **Failed to Delete Transaction Deep Link (Payment Institution)**
-
-**Error Details:**
-- Transaction ID: ${transactionId}
-- Message: ${error.message}
-
-**Common Issues:**
-1. **Link not found**: Deep link may already be deleted or never existed
-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. Check if deep link exists using \`payware_deep_links_get_transaction_link\`
-2. Verify running in production environment
-3. Ensure JWT authentication is working
-4. Confirm payment institution role in transaction
-5. Ensure transaction ID is correct`
-        }]
-      };
-    }
-  }
-};

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`
-        }]
-      };
-    }
-  }
-};