@payware/mcp-server 1.0.0

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

@@ -0,0 +1,144 @@
+import { getProduct } from '../../shared/products/products-api.js';
+import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
+
+/**
+ * Get product tool implementation for merchants
+ */
+export const getProductTool = {
+  name: "payware_products_get_product",
+  description: "Get detailed information about a specific product by ID",
+
+  inputSchema: {
+    type: "object",
+    properties: {
+      productId: {
+        type: "string",
+        description: "Product identifier (starts with 'pr')",
+        pattern: "^pr[a-zA-Z0-9]+$"
+      },
+      partnerId: {
+        type: "string",
+        description: "Merchant partner ID (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()
+      },
+      useSandbox: {
+        type: "boolean",
+        description: "Use sandbox environment",
+        default: true
+      }
+    },
+    required: ["productId"]
+  },
+
+  async handler(args) {
+    const {
+      productId,
+      partnerId = getPartnerIdSafe(),
+      privateKey = getPrivateKeySafe(),
+      useSandbox = true
+    } = args;
+
+    if (!productId) {
+      throw new Error("Product ID 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 environment-specific private key variable.");
+    }
+
+    try {
+      const result = await getProduct({
+        productId,
+        partnerType: 'merchant',
+        partnerId,
+        privateKey,
+        useSandbox
+      });
+
+      const product = result.data;
+
+      return {
+        content: [{
+          type: "text",
+          text: `📦 **Product Details**
+
+**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}` : ''}
+
+**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}
+
+**Troubleshooting:**
+1. Verify the product ID is correct and starts with 'pr'
+2. Ensure the product exists and belongs to your account
+3. Check JWT token validity
+4. Verify partner ID and API access`
+        }]
+      };
+    }
+  }
+};

package/src/merchant/products/index.js

@@ -0,0 +1,65 @@
+/**
+ * Merchant Products Tools
+ * Complete implementation of the Products API for merchants
+ */
+
+// 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 merchant product tools
+ */
+export const merchantProductTools = [
+  // Product Management
+  createProductTool,
+  listProductsTool,
+  getProductTool,
+  updateProductTool,
+  deleteProductTool,
+  getProductImageTool,
+
+  // Price Schedules
+  createScheduleTool,
+  getSchedulesTool,
+  getScheduleTool,
+  updateScheduleTool,
+  deleteScheduleTool,
+
+  // Audio/Soundbite Management
+  registerAudioTool,
+  getAudiosTool,
+  getAudioTool,
+  updateAudioTool,
+  deleteAudioTool
+];
+
+/**
+ * Get merchant product tools with proper naming
+ * @returns {Array} Array of merchant product tools
+ */
+export function getMerchantProductTools() {
+  return merchantProductTools;
+}

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

@@ -0,0 +1,112 @@
+import { getProducts } from '../../shared/products/products-api.js';
+import { getPartnerIdSafe, getPrivateKeySafe } from '../../config/env.js';
+
+/**
+ * List products tool implementation for merchants
+ */
+export const listProductsTool = {
+  name: "payware_products_list_products",
+  description: "Get a list of all products for the merchant account",
+
+  inputSchema: {
+    type: "object",
+    properties: {
+      partnerId: {
+        type: "string",
+        description: "Merchant partner ID (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()
+      },
+      useSandbox: {
+        type: "boolean",
+        description: "Use sandbox environment",
+        default: true
+      }
+    },
+    required: []
+  },
+
+  async handler(args) {
+    const {
+      partnerId = getPartnerIdSafe(),
+      privateKey = getPrivateKeySafe(),
+      useSandbox = true
+    } = args;
+
+    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 environment-specific private key variable.");
+    }
+
+    try {
+      const result = await getProducts({
+        partnerType: 'merchant',
+        partnerId,
+        privateKey,
+        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**
+
+**Summary:**
+- Total Products: ${productCount}
+- Environment: ${useSandbox ? 'Sandbox' : 'Production'}
+
+**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}
+
+**Troubleshooting:**
+1. Verify JWT token is valid and not expired
+2. Ensure private key matches public key registered with payware
+3. Verify partner ID and API access
+4. Check sandbox API status`
+        }]
+      };
+    }
+  }
+};