Fetch Product

curl -X GET "https://api.devdraft.ai/api/v0/products/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-client-key: YOUR_CLIENT_KEY" \
  -H "x-client-secret: YOUR_CLIENT_SECRET"

{
  "statusCode": 404,
  "message": "Product not found",
  "error": "Not Found",
  "details": {
    "productId": "550e8400-e29b-41d4-a716-446655440000",
    "suggestion": "Verify the product ID is correct and the product exists in your catalog"
  }
}

// Create a comprehensive product dashboard
const createProductDashboard = async (productId) => {
  const product = await analytics.getProductDetails(productId);
  
  return {
    overview: {
      name: product.name,
      status: product.status,
      price: `${product.currency} ${product.price}`,
      lastUpdated: new Date(product.dateUpdated).toLocaleDateString()
    },
    performance: {
      totalRevenue: product.analytics?.totalRevenue || 0,
      totalSales: product.analytics?.totalTransactions || 0,
      conversionRate: `${product.analytics?.conversionRate || 0}%`,
      avgOrderValue: product.analytics?.averageOrderValue || 0
    },
    inventory: {
      stockLevel: product.stockCount || 'Unlimited',
      status: product.stockCount === 0 ? 'Out of Stock' : 
              product.stockCount < 10 ? 'Low Stock' : 'In Stock',
      lastRestocked: product.dateUpdated
    },
    alerts: await analytics.validateProductHealth(productId)
  };
};

// Monitor product status and alert on issues
const monitorProductStatus = async (productId) => {
  const product = await analytics.getProductDetails(productId);
  const statusChecks = {
    isActive: product.status === 'ACTIVE',
    hasImages: product.images && product.images.length > 0,
    hasStock: !product.stockCount || product.stockCount > 0,
    hasPaymentLink: !!product.paymentLink,
    recentActivity: product.analytics?.lastSaleDate ? 
      new Date(product.analytics.lastSaleDate) > new Date(Date.now() - 30 * 24 * 60 * 60 * 1000) : false
  };
  
  const alerts = [];
  if (!statusChecks.isActive) alerts.push('Product is inactive');
  if (!statusChecks.hasImages) alerts.push('Missing product images');
  if (!statusChecks.hasStock) alerts.push('Out of stock');
  if (!statusChecks.hasPaymentLink) alerts.push('No payment link configured');
  if (!statusChecks.recentActivity) alerts.push('No recent sales activity');
  
  return {
    productId,
    overallHealth: alerts.length === 0 ? 'excellent' : 
                   alerts.length <= 2 ? 'good' : 'needs-attention',
    statusChecks,
    alerts,
    lastChecked: new Date().toISOString()
  };
};

// Comprehensive product validation
const validateProduct = async (productId) => {
  const product = await analytics.getProductDetails(productId);
  const validation = {
    errors: [],
    warnings: [],
    recommendations: []
  };
  
  // Required fields validation
  if (!product.name || product.name.length < 3) {
    validation.errors.push('Product name must be at least 3 characters');
  }
  
  if (!product.description || product.description.length < 10) {
    validation.errors.push('Product description must be at least 10 characters');
  }
  
  if (product.price <= 0) {
    validation.errors.push('Product price must be greater than 0');
  }
  
  // Best practices warnings
  if (!product.images || product.images.length === 0) {
    validation.warnings.push('Consider adding product images for better conversion');
  }
  
  if (product.images && product.images.length < 3) {
    validation.recommendations.push('Add more product images to showcase features');
  }
  
  // SEO recommendations
  if (product.description.length > 2000) {
    validation.warnings.push('Product description is very long, consider summarizing');
  }
  
  return {
    isValid: validation.errors.length === 0,
    score: Math.max(0, 100 - (validation.errors.length * 20) - (validation.warnings.length * 5)),
    ...validation
  };
};

// Assess product-related business risks
const assessProductRisk = async (productId) => {
  const product = await analytics.getProductDetails(productId);
  const risks = [];
  let riskScore = 0;
  
  // Revenue dependency risk
  if (product.analytics?.totalRevenue > 10000) {
    const revenueShare = product.analytics.totalRevenue; // Would need total app revenue for comparison
    if (revenueShare > 5000) { // Significant revenue contributor
      risks.push({
        type: 'revenue_dependency',
        level: 'medium',
        message: 'High revenue dependency on this product'
      });
      riskScore += 15;
    }
  }
  
  // Inventory risk
  if (product.stockCount !== null && product.stockCount < 5) {
    risks.push({
      type: 'inventory',
      level: product.stockCount === 0 ? 'high' : 'medium',
      message: product.stockCount === 0 ? 'Out of stock' : 'Very low stock levels'
    });
    riskScore += product.stockCount === 0 ? 25 : 10;
  }
  
  // Performance risk
  if (product.analytics?.conversionRate < 2) {
    risks.push({
      type: 'performance',
      level: 'medium',
      message: 'Low conversion rate may indicate pricing or presentation issues'
    });
    riskScore += 10;
  }
  
  return {
    productId,
    overallRisk: riskScore < 15 ? 'low' : riskScore < 35 ? 'medium' : 'high',
    riskScore,
    risks,
    mitigationSuggestions: generateMitigationSuggestions(risks)
  };
};

const generateMitigationSuggestions = (risks) => {
  return risks.map(risk => {
    switch (risk.type) {
      case 'inventory':
        return 'Restock product or adjust availability status';
      case 'performance':
        return 'Review product pricing, description, and images';
      case 'revenue_dependency':
        return 'Diversify product portfolio to reduce dependency';
      default:
        return 'Monitor closely and take corrective action';
    }
  });
};