@payware/mcp-server 1.0.0

package/src/isv/products/get-product.js

@@ -0,0 +1,168 @@
+import { getProduct } from '../../shared/products/products-api.js';
+import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
+
+/**
+ * Get product tool implementation for ISVs
+ */
+export const getProductTool = {
+  name: "payware_products_get_product",
+  description: "Get detailed information about a specific product by ID (ISV operation)",
+
+  inputSchema: {
+    type: "object",
+    properties: {
+      // ISV Authentication
+      merchantPartnerId: {
+        type: "string",
+        description: "Target merchant partner ID (8 alphanumeric characters, e.g., 'PZAYNMVE')"
+      },
+      oauth2Token: {
+        type: "string",
+        description: "OAuth2 access token obtained from the merchant"
+      },
+      productId: {
+        type: "string",
+        description: "Product identifier (starts with 'pr')",
+        pattern: "^pr[a-zA-Z0-9]+$"
+      },
+      useSandbox: {
+        type: "boolean",
+        description: "Use sandbox environment",
+        default: true
+      }
+    },
+    required: ["merchantPartnerId", "oauth2Token", "productId"]
+  },
+
+  async handler(args) {
+    const {
+      merchantPartnerId,
+      oauth2Token,
+      productId,
+      useSandbox = true
+    } = args;
+
+    // ISV validation
+    if (!merchantPartnerId) {
+      throw new Error("Merchant Partner ID is required for ISV operations");
+    }
+
+    if (!oauth2Token) {
+      throw new Error("OAuth2 token is required for ISV operations");
+    }
+
+    if (!productId) {
+      throw new Error("Product ID is required");
+    }
+
+    // Get ISV credentials
+    const isvPartnerId = getPartnerIdSafe();
+    const privateKey = getPrivateKeySafe();
+
+    if (!isvPartnerId) {
+      throw new Error("ISV Partner ID is required. Set PAYWARE_PARTNER_ID environment variable.");
+    }
+
+    if (!privateKey) {
+      throw new Error("Private key is required. Set environment-specific private key variable.");
+    }
+
+    try {
+      const result = await getProduct({
+        productId,
+        partnerType: 'isv',
+        isvPartnerId,
+        privateKey,
+        merchantPartnerId,
+        oauth2Token,
+        useSandbox
+      });
+
+      const product = result.data;
+
+      return {
+        content: [{
+          type: "text",
+          text: `📦 **Product Details (ISV -> Merchant: ${merchantPartnerId})**
+
+**Basic Information:**
+- ID: ${product.productId}
+- Name: ${product.name}
+- Type: ${product.type}
+- Status: ${product.active ? '✅ Active' : '⏸️ Inactive'}
+- Shop: ${product.shopCode} (${product.shopName})
+
+**Description:**
+${product.shortDescription ? `- Short: ${product.shortDescription}` : ''}
+${product.longDescription ? `- Long: ${product.longDescription}` : ''}
+
+**Identifiers:**
+${product.sku ? `- SKU: ${product.sku}` : ''}
+${product.upc ? `- UPC: ${product.upc}` : ''}
+
+**Pricing:**
+- Regular Price: ${product.regularPrice} ${product.currencyCode}
+- Current Sale Price: ${product.salePrice} ${product.currencyCode}
+- Time to Live: ${product.timeToLive} seconds
+
+**Settings:**
+- Shippable: ${product.shippable ? 'Yes (requires delivery address)' : 'No (digital product)'}
+
+**Active Period:**
+- From: ${product.activeFromZoned || product.activeFrom}
+- To: ${product.activeToZoned || product.activeTo}
+- Timezone: ${product.timeZone}
+
+**Resources:**
+${product.imageUrl ? `- Image: ${product.imageUrl}` : ''}
+${product.termsUrl ? `- Terms URL: ${product.termsUrl}` : ''}
+${product.termsText ? `- Terms Text: ${product.termsText.substring(0, 100)}${product.termsText.length > 100 ? '...' : ''}` : ''}
+${product.deepLink && product.deepLink !== '-' ? `- Deep Link: ${product.deepLink}` : ''}
+
+**ISV Integration Details:**
+- ISV Partner: ${isvPartnerId}
+- Target Merchant: ${merchantPartnerId}
+- OAuth2 Token: ${oauth2Token.substring(0, 8)}...
+
+**API Response:**
+\`\`\`json
+${JSON.stringify(product, null, 2)}
+\`\`\`
+
+**API Call Details:**
+- Endpoint: ${result.requestInfo.method} ${result.requestInfo.url}
+- Status: ${result.requestInfo.statusCode}
+
+**Available Actions:**
+- \`payware_products_update_product\` - Update this product
+- \`payware_products_delete_product\` - Delete this product
+- \`payware_products_get_product_image\` - Generate QR/barcode image
+- \`payware_products_get_schedules\` - View price schedules
+- \`payware_products_get_audios\` - View registered audios`
+        }]
+      };
+    } catch (error) {
+      return {
+        content: [{
+          type: "text",
+          text: `❌ **Failed to Get Product**
+
+**Error Details:**
+- Message: ${error.message}
+- Product ID: ${productId}
+
+**ISV Authentication Check:**
+- ISV Partner ID: ${isvPartnerId}
+- Merchant Partner ID: ${merchantPartnerId || 'Missing'}
+- OAuth2 Token: ${oauth2Token ? 'Provided' : 'Missing'}
+
+**Troubleshooting:**
+1. Verify the product ID is correct and starts with 'pr'
+2. Ensure the product exists and belongs to the target merchant
+3. Check OAuth2 token validity and permissions
+4. Confirm ISV has authorization to access merchant's products`
+        }]
+      };
+    }
+  }
+};

package/src/isv/products/index.js

@@ -0,0 +1,65 @@
+/**
+ * ISV Products Tools
+ * Complete implementation of the Products API for ISVs
+ */
+
+// Product Management
+import { createProductTool } from './create-product.js';
+import { listProductsTool } from './list-products.js';
+import { getProductTool } from './get-product.js';
+import { updateProductTool } from './update-product.js';
+import { deleteProductTool } from './delete-product.js';
+import { getProductImageTool } from './get-product-image.js';
+
+// Price Schedules
+import {
+  createScheduleTool,
+  getSchedulesTool,
+  getScheduleTool,
+  updateScheduleTool,
+  deleteScheduleTool
+} from './schedules.js';
+
+// Audio/Soundbite Management
+import {
+  registerAudioTool,
+  getAudiosTool,
+  getAudioTool,
+  updateAudioTool,
+  deleteAudioTool
+} from './audios.js';
+
+/**
+ * All ISV product tools
+ */
+export const isvProductTools = [
+  // Product Management
+  createProductTool,
+  listProductsTool,
+  getProductTool,
+  updateProductTool,
+  deleteProductTool,
+  getProductImageTool,
+
+  // Price Schedules
+  createScheduleTool,
+  getSchedulesTool,
+  getScheduleTool,
+  updateScheduleTool,
+  deleteScheduleTool,
+
+  // Audio/Soundbite Management
+  registerAudioTool,
+  getAudiosTool,
+  getAudioTool,
+  updateAudioTool,
+  deleteAudioTool
+];
+
+/**
+ * Get ISV product tools with proper naming
+ * @returns {Array} Array of ISV product tools
+ */
+export function getISVProductTools() {
+  return isvProductTools;
+}

package/src/isv/products/list-products.js

@@ -0,0 +1,136 @@
+import { getProducts } from '../../shared/products/products-api.js';
+import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
+
+/**
+ * List products tool implementation for ISVs
+ */
+export const listProductsTool = {
+  name: "payware_products_list_products",
+  description: "Get a list of all products for a merchant account (ISV operation)",
+
+  inputSchema: {
+    type: "object",
+    properties: {
+      // ISV Authentication
+      merchantPartnerId: {
+        type: "string",
+        description: "Target merchant partner ID (8 alphanumeric characters, e.g., 'PZAYNMVE')"
+      },
+      oauth2Token: {
+        type: "string",
+        description: "OAuth2 access token obtained from the merchant"
+      },
+      useSandbox: {
+        type: "boolean",
+        description: "Use sandbox environment",
+        default: true
+      }
+    },
+    required: ["merchantPartnerId", "oauth2Token"]
+  },
+
+  async handler(args) {
+    const {
+      merchantPartnerId,
+      oauth2Token,
+      useSandbox = true
+    } = args;
+
+    // ISV validation
+    if (!merchantPartnerId) {
+      throw new Error("Merchant Partner ID is required for ISV operations");
+    }
+
+    if (!oauth2Token) {
+      throw new Error("OAuth2 token is required for ISV operations");
+    }
+
+    // Get ISV credentials
+    const isvPartnerId = getPartnerIdSafe();
+    const privateKey = getPrivateKeySafe();
+
+    if (!isvPartnerId) {
+      throw new Error("ISV Partner ID is required. Set PAYWARE_PARTNER_ID environment variable.");
+    }
+
+    if (!privateKey) {
+      throw new Error("Private key is required. Set environment-specific private key variable.");
+    }
+
+    try {
+      const result = await getProducts({
+        partnerType: 'isv',
+        isvPartnerId,
+        privateKey,
+        merchantPartnerId,
+        oauth2Token,
+        useSandbox
+      });
+
+      const products = result.data;
+      const productCount = Array.isArray(products) ? products.length : 0;
+
+      let productsList = '';
+      if (Array.isArray(products) && products.length > 0) {
+        productsList = products.map(product =>
+          `- **${product.name}** (${product.productId})
+  - Type: ${product.type} | Price: ${product.salePrice} ${product.currencyCode}
+  - Status: ${product.active ? '✅ Active' : '⏸️ Inactive'} | Shop: ${product.shopCode}
+  - TTL: ${product.timeToLive}s | ${product.shippable ? 'Shippable' : 'Digital'}`
+        ).join('\n\n');
+      } else {
+        productsList = 'No products found.';
+      }
+
+      return {
+        content: [{
+          type: "text",
+          text: `📦 **Products List (ISV -> Merchant: ${merchantPartnerId})**
+
+**Summary:**
+- Total Products: ${productCount}
+- Environment: ${useSandbox ? 'Sandbox' : 'Production'}
+
+**ISV Integration Details:**
+- ISV Partner: ${isvPartnerId}
+- Target Merchant: ${merchantPartnerId}
+- OAuth2 Token: ${oauth2Token.substring(0, 8)}...
+
+**Products:**
+${productsList}
+
+**API Call Details:**
+- Endpoint: ${result.requestInfo.method} ${result.requestInfo.url}
+- Status: ${result.requestInfo.statusCode}
+
+**Available Actions:**
+- \`payware_products_get_product\` - Get detailed product information
+- \`payware_products_create_product\` - Create a new product
+- \`payware_products_update_product\` - Update existing product
+- \`payware_products_delete_product\` - Delete a product`
+        }]
+      };
+    } catch (error) {
+      return {
+        content: [{
+          type: "text",
+          text: `❌ **Failed to List Products**
+
+**Error Details:**
+- Message: ${error.message}
+
+**ISV Authentication Check:**
+- ISV Partner ID: ${isvPartnerId}
+- Merchant Partner ID: ${merchantPartnerId || 'Missing'}
+- OAuth2 Token: ${oauth2Token ? 'Provided' : 'Missing'}
+
+**Troubleshooting:**
+1. Verify OAuth2 token is valid and not expired
+2. Ensure merchant partner ID is correct (8 characters)
+3. Confirm ISV has authorization to act on behalf of merchant
+4. Check private key matches public key registered with payware`
+        }]
+      };
+    }
+  }
+};