@payware/mcp-server 1.0.0

package/src/isv/data/index.js

@@ -0,0 +1,291 @@
+/**
+ * ISV Data Tools - Complete Data API Implementation
+ * Production-only tools for data retrieval, reporting, and export functionality for ISVs
+ */
+
+import {
+  generateReport,
+  getReportStatus,
+  exportReport,
+  getExportStatus,
+  downloadExport,
+  cancelReport,
+  cancelExport,
+  REPORT_TYPES,
+  EXPORT_FORMATS,
+  LOCALES
+} from '../../shared/data/data-api.js';
+import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
+
+// Create ISV data tool factory
+const createISVDataTool = (toolName, apiFunction, description, additionalParams = {}) => ({
+  name: `payware_data_${toolName}`,
+  description: `${description} (ISV acting on behalf of merchant)`,
+  inputSchema: {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+      merchantPartnerId: {
+        type: "string",
+        description: "The merchant's partner ID (required for ISV operations)"
+      },
+      oauth2Token: {
+        type: "string",
+        description: "OAuth2 access token obtained from the merchant"
+      },
+      isvPartnerId: {
+        type: "string",
+        description: "ISV Partner ID from payware dashboard. Uses PAYWARE_PARTNER_ID env var as default.",
+        default: getPartnerIdSafe()
+      },
+      privateKey: {
+        type: "string",
+        description: "ISV RSA private key for authentication. Uses environment-specific private key as default.",
+        default: getPrivateKeySafe()
+      },
+      ...additionalParams
+    },
+    required: ["merchantPartnerId", "oauth2Token", ...Object.keys(additionalParams)]
+  },
+
+  async handler(args) {
+    const {
+      merchantPartnerId,
+      oauth2Token,
+      isvPartnerId = getPartnerIdSafe(),
+      privateKey = getPrivateKeySafe()
+    } = args;
+
+    if (!isvPartnerId || !privateKey) {
+      throw new Error("ISV Partner ID and private key are required.");
+    }
+
+    if (!merchantPartnerId || !oauth2Token) {
+      throw new Error("Merchant Partner ID and OAuth2 token are required for ISV operations.");
+    }
+
+    try {
+      const result = await apiFunction({
+        ...args,
+        partnerType: 'isv',
+        isvPartnerId,
+        privateKey,
+        merchantPartnerId,
+        oauth2Token
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `📊 **ISV ${description} Completed**
+
+**Result:**
+${JSON.stringify(result.data, null, 2)}
+
+**ISV Context:**
+- ISV Partner ID: ${isvPartnerId}
+- Merchant Partner ID: ${merchantPartnerId}
+- OAuth2 Token: ${oauth2Token.substring(0, 20)}...
+
+**Note:** This operation was performed on behalf of the merchant using ISV authentication.`
+        }]
+      };
+    } catch (error) {
+      throw new Error(`ISV failed to ${toolName.replace('_', ' ')}: ${error.message}`);
+    }
+  }
+});
+
+/**
+ * Generate report tool for ISVs
+ */
+export const generateReportTool = {
+  name: "payware_data_generate_report",
+  description: "Generate an asynchronous data report for ISV data analysis and reporting on behalf of merchants. Production only - not supported in sandbox.",
+  inputSchema: {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+      reportUnitId: {
+        type: "string",
+        description: "The ID of the report to generate",
+        enum: Object.values(REPORT_TYPES),
+        default: REPORT_TYPES.PROCESSED_TRANSACTIONS
+      },
+      merchantPartnerId: {
+        type: "string",
+        description: "The merchant's partner ID (required for ISV operations)"
+      },
+      oauth2Token: {
+        type: "string",
+        description: "OAuth2 access token obtained from the merchant"
+      },
+      dateFrom: {
+        type: "string",
+        description: "Start date for the reporting period (YYYY-MM-DD format). Required for premium reports.",
+        pattern: "^\\d{4}-\\d{2}-\\d{2}$"
+      },
+      dateTo: {
+        type: "string",
+        description: "End date for the reporting period (YYYY-MM-DD format). Required for premium reports.",
+        pattern: "^\\d{4}-\\d{2}-\\d{2}$"
+      },
+      ignorePagination: {
+        type: "boolean",
+        description: "If true, return report as single continuous document. If false, paginate results.",
+        default: false
+      },
+      locale: {
+        type: "string",
+        description: "Locale for the report",
+        enum: Object.values(LOCALES),
+        default: LOCALES.ENGLISH_US
+      },
+      timeZone: {
+        type: "string",
+        description: "Timezone for date calculations (e.g., 'Europe/Sofia', 'America/New_York')",
+        default: "GMT"
+      },
+      isvPartnerId: {
+        type: "string",
+        description: "ISV Partner ID from payware dashboard. Uses PAYWARE_PARTNER_ID env var as default.",
+        default: getPartnerIdSafe()
+      },
+      privateKey: {
+        type: "string",
+        description: "ISV RSA private key for authentication. Uses environment-specific private key as default.",
+        default: getPrivateKeySafe()
+      }
+    },
+    required: ["reportUnitId", "merchantPartnerId", "oauth2Token"]
+  },
+
+  async handler(args) {
+    const {
+      reportUnitId,
+      merchantPartnerId,
+      oauth2Token,
+      dateFrom,
+      dateTo,
+      ignorePagination = false,
+      locale = LOCALES.ENGLISH_US,
+      timeZone = 'GMT',
+      isvPartnerId = getPartnerIdSafe(),
+      privateKey = getPrivateKeySafe()
+    } = args;
+
+    if (!isvPartnerId || !privateKey) {
+      throw new Error("ISV Partner ID and private key are required. Set PAYWARE_PARTNER_ID and environment-specific private key variables or provide them as parameters.");
+    }
+
+    if (!merchantPartnerId || !oauth2Token) {
+      throw new Error("Merchant Partner ID and OAuth2 token are required for ISV operations.");
+    }
+
+    try {
+      const result = await generateReport({
+        reportUnitId,
+        dateFrom,
+        dateTo,
+        ignorePagination,
+        locale,
+        timeZone,
+        partnerType: 'isv',
+        isvPartnerId,
+        privateKey,
+        merchantPartnerId,
+        oauth2Token
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `📊 **ISV Data Report Generation Started**
+
+**Report Details:**
+- Request ID: ${result.data.requestId}
+- Status: ${result.data.status}
+- Report Type: ${reportUnitId}
+- Generated: ${result.data.generatedAt}
+
+**ISV Authentication:**
+- ISV Partner ID: ${isvPartnerId}
+- Merchant Partner ID: ${merchantPartnerId}
+- OAuth2 Token: ${oauth2Token.substring(0, 20)}...
+
+**Next Steps:**
+1. Save the Request ID: \`${result.data.requestId}\`
+2. Use "Get Report Status" tool to monitor progress
+3. When status is "READY", use "Export Report" tool to get the data
+
+**⚠️ Production Only & ISV Authorization Required:**
+This feature requires proper OAuth2 authorization from the merchant and is only available in production.`
+        }]
+      };
+    } catch (error) {
+      throw new Error(`Failed to generate ISV report: ${error.message}`);
+    }
+  }
+};
+
+// Create all other ISV data tools
+export const getReportStatusTool = createISVDataTool('get_report_status', getReportStatus, 'Get Report Status', {
+  requestId: {
+    type: "string",
+    description: "The request ID returned from the report generation request (UUID format)"
+  }
+});
+
+export const exportReportTool = createISVDataTool('export_report', exportReport, 'Export Report', {
+  requestId: {
+    type: "string",
+    description: "The request ID from the report generation (UUID format)"
+  },
+  outputFormat: {
+    type: "string",
+    description: "Export format",
+    enum: Object.values(EXPORT_FORMATS),
+    default: EXPORT_FORMATS.PDF
+  }
+});
+
+export const getExportStatusTool = createISVDataTool('get_export_status', getExportStatus, 'Get Export Status', {
+  exportId: {
+    type: "string",
+    description: "The export ID returned from the export request (UUID format)"
+  }
+});
+
+export const downloadExportTool = createISVDataTool('download_export', downloadExport, 'Download Export', {
+  exportId: {
+    type: "string",
+    description: "The export ID from the export request (UUID format)"
+  }
+});
+
+export const cancelReportTool = createISVDataTool('cancel_report', cancelReport, 'Cancel Report', {
+  requestId: {
+    type: "string",
+    description: "The request ID of the report to cancel (UUID format)"
+  }
+});
+
+export const cancelExportTool = createISVDataTool('cancel_export', cancelExport, 'Cancel Export', {
+  exportId: {
+    type: "string",
+    description: "The export ID of the export to cancel (UUID format)"
+  }
+});
+
+/**
+ * All ISV data tools
+ */
+export const isvDataTools = [
+  generateReportTool,
+  getReportStatusTool,
+  exportReportTool,
+  getExportStatusTool,
+  downloadExportTool,
+  cancelReportTool,
+  cancelExportTool
+];

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

@@ -0,0 +1,154 @@
+import { deleteProductDeepLink } from '../../shared/deep-links/api.js';
+import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
+
+/**
+ * Delete deep link for a product (ISV on behalf of merchant)
+ */
+export const deleteProductLinkTool = {
+  name: "payware_deep_links_delete_product_link",
+  description: `Delete an active deep link for a product on behalf of a merchant. Once deleted, the deep link URL will no longer redirect to the payware mobile app.
+
+**ISV Authentication:**
+- Requires ISV JWT token with merchant partner ID in 'aud' claim
+- Requires OAuth2 token in 'sub' claim
+
+**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]+$"
+      },
+      merchantPartnerId: {
+        type: "string",
+        description: "Partner ID of the merchant for whom the product is being deleted"
+      },
+      oauth2Token: {
+        type: "string",
+        description: "OAuth2 access token for merchant authorization"
+      },
+      isvPartnerId: {
+        type: "string",
+        description: "ISV Partner ID from payware dashboard. Uses PAYWARE_PARTNER_ID env var as default.",
+        default: getPartnerIdSafe()
+      },
+      privateKey: {
+        type: "string",
+        description: "ISV RSA private key for JWT token creation. Uses environment-specific private key as default.",
+        default: getPrivateKeySafe()
+      }
+    },
+    required: ["productId", "merchantPartnerId", "oauth2Token"]
+  },
+
+  async handler(args) {
+    const {
+      productId,
+      merchantPartnerId,
+      oauth2Token,
+      isvPartnerId = getPartnerIdSafe(),
+      privateKey = getPrivateKeySafe()
+    } = args;
+
+    if (!productId) {
+      throw new Error("productId is required");
+    }
+
+    if (!merchantPartnerId) {
+      throw new Error("merchantPartnerId is required for ISV operations");
+    }
+
+    if (!oauth2Token) {
+      throw new Error("oauth2Token is required for ISV operations");
+    }
+
+    if (!isvPartnerId) {
+      throw new Error("ISV Partner ID is required. Provide via 'isvPartnerId' 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: 'isv',
+        isvPartnerId,
+        privateKey,
+        merchantPartnerId,
+        oauth2Token
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `✅ **Product Deep Link Deleted (ISV)**
+
+**Deletion Details:**
+- Product ID: ${productId}
+- Merchant: ${merchantPartnerId}
+- Status: Successfully deleted
+- Link URL: https://url.payware.eu/${productId} (now inactive)
+
+**ISV Authentication:**
+- ISV Partner ID: ${isvPartnerId}
+- Merchant Partner ID: ${merchantPartnerId}
+- OAuth2 Token: ${oauth2Token.substring(0, 10)}...
+
+**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 (ISV)**
+
+**Error Details:**
+- Product ID: ${productId}
+- Merchant: ${merchantPartnerId}
+- Message: ${error.message}
+
+**Common Issues:**
+1. **Link not found**: Deep link may already be deleted or never existed
+2. **Authentication failed**: Verify ISV partner ID, private key, and OAuth2 token
+3. **Authorization failed**: Ensure OAuth2 token authorizes access to merchant
+4. **Sandbox environment**: Deep links are production-only
+5. **Invalid product ID**: Ensure product ID format is correct
+
+**Troubleshooting:**
+1. Check if deep link exists using \`payware_deep_links_get_product_link\`
+2. Check OAuth2 token is valid and not expired
+3. Ensure ISV has permission to access merchant data
+4. Verify running in production environment
+5. Ensure JWT authentication is working`
+        }]
+      };
+    }
+  }
+};

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

@@ -0,0 +1,154 @@
+import { deleteTransactionDeepLink } from '../../shared/deep-links/api.js';
+import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
+
+/**
+ * Delete deep link for a transaction (ISV on behalf of merchant)
+ */
+export const deleteTransactionLinkTool = {
+  name: "payware_deep_links_delete_transaction_link",
+  description: `Delete an active deep link for a transaction on behalf of a merchant. Once deleted, the deep link URL will no longer redirect to the payware mobile app.
+
+**ISV Authentication:**
+- Requires ISV JWT token with merchant partner ID in 'aud' claim
+- Requires OAuth2 token in 'sub' claim
+
+**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]+$"
+      },
+      merchantPartnerId: {
+        type: "string",
+        description: "Partner ID of the merchant for whom the transaction is being deleted"
+      },
+      oauth2Token: {
+        type: "string",
+        description: "OAuth2 access token for merchant authorization"
+      },
+      isvPartnerId: {
+        type: "string",
+        description: "ISV Partner ID from payware dashboard. Uses PAYWARE_PARTNER_ID env var as default.",
+        default: getPartnerIdSafe()
+      },
+      privateKey: {
+        type: "string",
+        description: "ISV RSA private key for JWT token creation. Uses environment-specific private key as default.",
+        default: getPrivateKeySafe()
+      }
+    },
+    required: ["transactionId", "merchantPartnerId", "oauth2Token"]
+  },
+
+  async handler(args) {
+    const {
+      transactionId,
+      merchantPartnerId,
+      oauth2Token,
+      isvPartnerId = getPartnerIdSafe(),
+      privateKey = getPrivateKeySafe()
+    } = args;
+
+    if (!transactionId) {
+      throw new Error("transactionId is required");
+    }
+
+    if (!merchantPartnerId) {
+      throw new Error("merchantPartnerId is required for ISV operations");
+    }
+
+    if (!oauth2Token) {
+      throw new Error("oauth2Token is required for ISV operations");
+    }
+
+    if (!isvPartnerId) {
+      throw new Error("ISV Partner ID is required. Provide via 'isvPartnerId' 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: 'isv',
+        isvPartnerId,
+        privateKey,
+        merchantPartnerId,
+        oauth2Token
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `✅ **Transaction Deep Link Deleted (ISV)**
+
+**Deletion Details:**
+- Transaction ID: ${transactionId}
+- Merchant: ${merchantPartnerId}
+- Status: Successfully deleted
+- Link URL: https://url.payware.eu/${transactionId} (now inactive)
+
+**ISV Authentication:**
+- ISV Partner ID: ${isvPartnerId}
+- Merchant Partner ID: ${merchantPartnerId}
+- OAuth2 Token: ${oauth2Token.substring(0, 10)}...
+
+**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 (ISV)**
+
+**Error Details:**
+- Transaction ID: ${transactionId}
+- Merchant: ${merchantPartnerId}
+- Message: ${error.message}
+
+**Common Issues:**
+1. **Link not found**: Deep link may already be deleted or never existed
+2. **Authentication failed**: Verify ISV partner ID, private key, and OAuth2 token
+3. **Authorization failed**: Ensure OAuth2 token authorizes access to merchant
+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. Check OAuth2 token is valid and not expired
+3. Ensure ISV has permission to access merchant data
+4. Verify running in production environment
+5. Ensure JWT authentication is working`
+        }]
+      };
+    }
+  }
+};