@payware/mcp-server 1.0.0

package/src/merchant/data/index.js

@@ -0,0 +1,351 @@
+/**
+ * Merchant Data Tools - Complete Data API Implementation
+ * Production-only tools for data retrieval, reporting, and export functionality
+ */
+
+import {
+  getReportStatus,
+  getExportStatus,
+  downloadExport,
+  cancelReport,
+  cancelExport,
+  EXPORT_FORMATS
+} from '../../shared/data/data-api.js';
+import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
+
+// Import individual tools
+import { generateReportTool } from './generate-report.js';
+import { getReportStatusTool } from './get-report-status.js';
+import { exportReportTool } from './export-report.js';
+
+/**
+ * Get export status tool for merchants
+ */
+export const getExportStatusTool = {
+  name: "payware_data_get_export_status",
+  description: "Get the status of a report export request. Use this to monitor export progress.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      exportId: {
+        type: "string",
+        description: "The export ID returned from the export request (UUID format)"
+      },
+      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 authentication. Uses environment-specific private key as default.",
+        default: getPrivateKeySafe()
+      }
+    },
+    required: ["exportId"]
+  },
+
+  async handler(args) {
+    const {
+      exportId,
+      partnerId = getPartnerIdSafe(),
+      privateKey = getPrivateKeySafe()
+    } = args;
+
+    if (!partnerId || !privateKey) {
+      throw new Error("Partner ID and private key are required. Set PAYWARE_PARTNER_ID and environment-specific private key variables or provide them as parameters.");
+    }
+
+    try {
+      const result = await getExportStatus({
+        exportId,
+        partnerType: 'merchant',
+        partnerId,
+        privateKey
+      });
+
+      const data = result.data;
+      const exportResource = data.outputResource;
+
+      // The export status API returns export information in outputResource
+      let downloadInfo = '';
+      if (exportResource?.status === 'READY') {
+        downloadInfo = `
+**🎉 Export is Ready for Download!**
+Use the "Download Export" tool with export ID: \`${exportId}\`
+Format: ${exportResource.contentType?.toUpperCase()}
+Pages: ${exportResource.pages || 'N/A'}`;
+      }
+
+      return {
+        content: [{
+          type: "text",
+          text: `📊 **Export Status Check**
+
+**Export Information:**
+- Export ID: ${exportId}
+- Status: ${exportResource?.status || 'Unknown'}
+- Format: ${exportResource?.contentType?.toUpperCase() || 'Unknown'}
+- Pages: ${exportResource?.pages || 'N/A'}
+- Completed: ${exportResource?.outputFinal ? 'Yes' : 'No'}
+- Exported: ${exportResource?.exportedAt || 'N/A'}
+
+**Related Report:**
+- Request ID: ${data.requestId}
+- Report Type: ${data.reportUnitId}
+- Date Range: ${data.dateFrom || 'Default'} to ${data.dateTo || 'Default'}
+${downloadInfo}
+
+**Status Meanings:**
+- 🟡 **QUEUED**: Export is being processed
+- ✅ **READY**: Export completed and ready for download
+- ❌ **CANCELLED**: Export was cancelled
+- 💥 **FAILED**: Error occurred during export`
+        }]
+      };
+    } catch (error) {
+      throw new Error(`Failed to get export status: ${error.message}`);
+    }
+  }
+};
+
+/**
+ * Download export tool for merchants
+ */
+export const downloadExportTool = {
+  name: "payware_data_download_export",
+  description: "Download a READY export file. The export must be in READY status. Returns binary data for the file.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      exportId: {
+        type: "string",
+        description: "The export ID from the export request (UUID format)"
+      },
+      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 authentication. Uses environment-specific private key as default.",
+        default: getPrivateKeySafe()
+      }
+    },
+    required: ["exportId"]
+  },
+
+  async handler(args) {
+    const {
+      exportId,
+      partnerId = getPartnerIdSafe(),
+      privateKey = getPrivateKeySafe()
+    } = args;
+
+    if (!partnerId || !privateKey) {
+      throw new Error("Partner ID and private key are required. Set PAYWARE_PARTNER_ID and environment-specific private key variables or provide them as parameters.");
+    }
+
+    try {
+      const result = await downloadExport({
+        exportId,
+        partnerType: 'merchant',
+        partnerId,
+        privateKey
+      });
+
+      // Convert binary data to base64 for display
+      const base64Data = Buffer.from(result.data).toString('base64');
+      const sizeInKB = Math.round(result.data.length / 1024);
+
+      return {
+        content: [{
+          type: "text",
+          text: `📊 **Export Download Completed**
+
+**File Information:**
+- Export ID: ${exportId}
+- Content Type: ${result.contentType}
+- File Size: ${sizeInKB} KB (${result.contentLength} bytes)
+- Status: Successfully downloaded
+
+**File Data (Base64 encoded):**
+\`\`\`
+${base64Data.substring(0, 200)}${base64Data.length > 200 ? '...[truncated]' : ''}
+\`\`\`
+
+**Usage Notes:**
+- The file data is provided in Base64 encoding above
+- For CSV/JSON files, you can decode and view the content
+- For binary files (PDF, Excel), save the Base64 data and decode to get the original file
+- Full file size: ${sizeInKB} KB
+
+**Next Steps:**
+1. Copy the Base64 data if you need to save the file
+2. For text formats (CSV, JSON), decode Base64 to view content
+3. For binary formats (PDF, Excel), decode and save as appropriate file type
+
+**Successfully downloaded ${result.contentType} file (${sizeInKB} KB)**`
+        }]
+      };
+    } catch (error) {
+      throw new Error(`Failed to download export: ${error.message}`);
+    }
+  }
+};
+
+/**
+ * Cancel report tool for merchants
+ */
+export const cancelReportTool = {
+  name: "payware_data_cancel_report",
+  description: "Cancel a running report generation. Only reports in QUEUED status can be cancelled.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      requestId: {
+        type: "string",
+        description: "The request ID of the report to cancel (UUID format)"
+      },
+      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 authentication. Uses environment-specific private key as default.",
+        default: getPrivateKeySafe()
+      }
+    },
+    required: ["requestId"]
+  },
+
+  async handler(args) {
+    const {
+      requestId,
+      partnerId = getPartnerIdSafe(),
+      privateKey = getPrivateKeySafe()
+    } = args;
+
+    if (!partnerId || !privateKey) {
+      throw new Error("Partner ID and private key are required. Set PAYWARE_PARTNER_ID and environment-specific private key variables or provide them as parameters.");
+    }
+
+    try {
+      const result = await cancelReport({
+        requestId,
+        partnerType: 'merchant',
+        partnerId,
+        privateKey
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `📊 **Report Cancellation**
+
+**Cancellation Result:**
+- Request ID: ${requestId}
+- Status: Successfully cancelled
+- Response: ${typeof result.data === 'string' ? result.data : 'CANCELLED'}
+
+**What This Means:**
+- The report generation has been stopped
+- No further processing will occur for this request
+- You can generate a new report with the same or different parameters if needed
+
+**Note:**
+Only reports in QUEUED status can be cancelled. Reports that are already READY, FAILED, or previously CANCELLED cannot be cancelled.`
+        }]
+      };
+    } catch (error) {
+      throw new Error(`Failed to cancel report: ${error.message}`);
+    }
+  }
+};
+
+/**
+ * Cancel export tool for merchants
+ */
+export const cancelExportTool = {
+  name: "payware_data_cancel_export",
+  description: "Cancel a running export process. Only exports in QUEUED status can be cancelled.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      exportId: {
+        type: "string",
+        description: "The export ID of the export to cancel (UUID format)"
+      },
+      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 authentication. Uses environment-specific private key as default.",
+        default: getPrivateKeySafe()
+      }
+    },
+    required: ["exportId"]
+  },
+
+  async handler(args) {
+    const {
+      exportId,
+      partnerId = getPartnerIdSafe(),
+      privateKey = getPrivateKeySafe()
+    } = args;
+
+    if (!partnerId || !privateKey) {
+      throw new Error("Partner ID and private key are required. Set PAYWARE_PARTNER_ID and environment-specific private key variables or provide them as parameters.");
+    }
+
+    try {
+      const result = await cancelExport({
+        exportId,
+        partnerType: 'merchant',
+        partnerId,
+        privateKey
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `📊 **Export Cancellation**
+
+**Cancellation Result:**
+- Export ID: ${exportId}
+- Status: Successfully cancelled
+- Response: ${typeof result.data === 'string' ? result.data : 'CANCELLED'}
+
+**What This Means:**
+- The export process has been stopped
+- No file will be generated for this export request
+- You can start a new export with the same report request if the report is still READY
+
+**Note:**
+Only exports in QUEUED status can be cancelled. Exports that are already READY, FAILED, or previously CANCELLED cannot be cancelled.`
+        }]
+      };
+    } catch (error) {
+      throw new Error(`Failed to cancel export: ${error.message}`);
+    }
+  }
+};
+
+/**
+ * All merchant data tools
+ */
+export const merchantDataTools = [
+  generateReportTool,
+  getReportStatusTool,
+  exportReportTool,
+  getExportStatusTool,
+  downloadExportTool,
+  cancelReportTool,
+  cancelExportTool
+];

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

@@ -0,0 +1,121 @@
+import { deleteProductDeepLink } from '../../shared/deep-links/api.js';
+import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
+
+/**
+ * Delete deep link for a merchant product
+ */
+export const deleteProductLinkTool = {
+  name: "payware_deep_links_delete_product_link",
+  description: `Delete an active deep link for a product. Once deleted, the deep link URL will no longer redirect to the payware mobile app.
+
+**Use Cases:**
+- Remove expired product links
+- Clean up after product removal
+- Security cleanup for discontinued products
+
+**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: {
+      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.",
+        default: getPrivateKeySafe()
+      }
+    },
+    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 deleteProductDeepLink({
+        productId,
+        partnerType: 'merchant',
+        partnerId,
+        privateKey
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `✅ **Product Deep Link Deleted**
+
+**Deletion Details:**
+- Product ID: ${productId}
+- Status: Successfully deleted
+- Link URL: https://url.payware.eu/${productId} (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_product_link\`
+⚠️ Any existing shared links will stop working immediately`
+        }]
+      };
+    } catch (error) {
+      return {
+        content: [{
+          type: "text",
+          text: `❌ **Failed to Delete Product Deep Link**
+
+**Error Details:**
+- Product ID: ${productId}
+- 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 product ID**: Ensure product ID format is correct
+
+**Troubleshooting:**
+1. Check if deep link exists using \`payware_deep_links_get_product_link\`
+2. Verify running in production environment
+3. Ensure JWT authentication is working
+4. Confirm product ID is correct`
+        }]
+      };
+    }
+  }
+};

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

@@ -0,0 +1,121 @@
+import { deleteTransactionDeepLink } from '../../shared/deep-links/api.js';
+import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
+
+/**
+ * Delete deep link for a merchant transaction
+ */
+export const deleteTransactionLinkTool = {
+  name: "payware_deep_links_delete_transaction_link",
+  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.",
+        default: getPrivateKeySafe()
+      }
+    },
+    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://url.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`
+        }]
+      };
+    }
+  }
+};