@o2vend/theme-cli 1.0.0

package/src/lib/api-client.js

@@ -0,0 +1,339 @@
+/**
+ * O2VEND API Client
+ * Standalone implementation - copied and adapted from webstore solution
+ * Update manually when webstore solution changes
+ * 
+ * Source: o2vend-webstore/services/o2vend-api-client.js
+ */
+
+const axios = require('axios');
+const NodeCache = require('node-cache');
+const crypto = require('crypto');
+
+/**
+ * O2VEND Storefront API Client
+ * Handles all API communication with the O2VEND Storefront API
+ * 
+ * Note: The API returns all field names in lowercase (camelCase), not PascalCase.
+ */
+class O2VendApiClient {
+  constructor(tenantId, apiKey, baseUrl = null, checkoutSignature = null) {
+    this.tenantId = tenantId;
+    this.apiKey = apiKey;
+    this.baseUrl = baseUrl || process.env.O2VEND_API_BASE_URL;
+    this.timeout = parseInt(process.env.O2VEND_API_TIMEOUT) || 10000;
+    this.checkoutSignature = checkoutSignature;
+    
+    // Initialize cache with 5 minute TTL
+    this.cache = new NodeCache({ 
+      stdTTL: 300, // 5 minutes
+      checkperiod: 60 // Check for expired keys every minute
+    });
+    
+    // Create axios instance with default config
+    this.client = axios.create({
+      baseURL: this.baseUrl && this.baseUrl.endsWith('/') ? this.baseUrl.slice(0, -1) : this.baseUrl,
+      timeout: this.timeout,
+      headers: {
+        'X-O2VEND-SHOPFRONT-API-KEY': this.apiKey,
+        'Content-Type': 'application/json',
+        'User-Agent': 'O2VEND-Theme-CLI/1.0'
+      }
+    });
+    
+    // Setup interceptors
+    this.setupInterceptors();
+  }
+
+  /**
+   * Normalize object keys from PascalCase to camelCase recursively
+   * @param {*} obj - Object to normalize
+   * @returns {*} Object with normalized keys
+   */
+  normalizeKeys(obj) {
+    if (obj === null || obj === undefined) {
+      return obj;
+    }
+
+    if (Array.isArray(obj)) {
+      return obj.map(item => this.normalizeKeys(item));
+    }
+
+    if (typeof obj === 'object') {
+      const normalized = {};
+      for (const key in obj) {
+        if (obj.hasOwnProperty(key)) {
+          const normalizedKey = key.charAt(0).toLowerCase() + key.slice(1);
+          normalized[normalizedKey] = this.normalizeKeys(obj[key]);
+        }
+      }
+      return normalized;
+    }
+
+    return obj;
+  }
+
+  /**
+   * Setup axios interceptors for logging and error handling
+   */
+  setupInterceptors() {
+    // Request interceptor
+    this.client.interceptors.request.use(
+      (config) => {
+        return config;
+      },
+      (error) => {
+        console.error('[O2VEND API] Request error:', error.message);
+        return Promise.reject(error);
+      }
+    );
+
+    // Response interceptor - normalize all response data
+    this.client.interceptors.response.use(
+      (response) => {
+        if (response.data) {
+          response.data = this.normalizeKeys(response.data);
+        }
+        return response;
+      },
+      (error) => {
+        if (error.response) {
+          const status = error.response.status;
+          if (status === 404 && process.env.DEBUG_API_ERRORS !== 'true') {
+            // Don't log 404s unless debug mode
+          } else {
+            console.error(`[O2VEND API] Response error: ${status}`, error.message);
+          }
+        } else if (error.request) {
+          console.error('[O2VEND API] Network error: Unable to reach API');
+        }
+        return Promise.reject(error);
+      }
+    );
+  }
+
+  /**
+   * Generic GET request with caching
+   * @param {string} endpoint - API endpoint
+   * @param {Object} params - Query parameters
+   * @param {boolean} useCache - Whether to use cache (default: false)
+   * @returns {Promise<Object>} API response data
+   */
+  async get(endpoint, params = {}, useCache = false) {
+    const cacheKey = `${endpoint}-${JSON.stringify(params)}`;
+    
+    if (useCache && this.cache.has(cacheKey)) {
+      return this.cache.get(cacheKey);
+    }
+    
+    try {
+      const response = await this.client.get(endpoint, { params });
+      const data = response.data;
+      
+      if (useCache) {
+        this.cache.set(cacheKey, data);
+      }
+      
+      return data;
+    } catch (error) {
+      console.error(`[O2VEND API] GET ${endpoint} failed:`, error.message);
+      throw error;
+    }
+  }
+
+  /**
+   * Generic POST request
+   * @param {string} endpoint - API endpoint
+   * @param {Object} data - Request body
+   * @param {Object} config - Additional axios config
+   * @returns {Promise<Object>} API response data
+   */
+  async post(endpoint, data = {}, config = {}) {
+    try {
+      const response = await this.client.post(endpoint, data, config);
+      return response.data;
+    } catch (error) {
+      console.error(`[O2VEND API] POST ${endpoint} failed:`, error.message);
+      throw error;
+    }
+  }
+
+  /**
+   * Generic PUT request
+   * @param {string} endpoint - API endpoint
+   * @param {Object} data - Request body
+   * @param {Object} config - Additional axios config
+   * @returns {Promise<Object>} API response data
+   */
+  async put(endpoint, data = {}, config = {}) {
+    try {
+      const response = await this.client.put(endpoint, data, config);
+      return response.data;
+    } catch (error) {
+      console.error(`[O2VEND API] PUT ${endpoint} failed:`, error.message);
+      throw error;
+    }
+  }
+
+  /**
+   * Generic DELETE request
+   * @param {string} endpoint - API endpoint
+   * @param {Object} config - Additional axios config
+   * @returns {Promise<Object>} API response data
+   */
+  async delete(endpoint, config = {}) {
+    try {
+      const response = await this.client.delete(endpoint, config);
+      return response.data;
+    } catch (error) {
+      console.error(`[O2VEND API] DELETE ${endpoint} failed:`, error.message);
+      throw error;
+    }
+  }
+
+  // ==================== CORE ENDPOINTS ====================
+
+  /**
+   * Get store information
+   * @param {boolean} useCache - Whether to use cache
+   * @returns {Promise<Object>} Store information
+   */
+  async getStoreInfo(useCache = false) {
+    return this.get('/shopfront/api/v2/storeinfo', {}, useCache);
+  }
+
+  /**
+   * Get store settings
+   * @param {boolean} useCache - Whether to use cache
+   * @returns {Promise<Object>} Store settings
+   */
+  async getSettings(useCache = false) {
+    return this.get('/shopfront/api/v2/settings', {}, useCache);
+  }
+
+  // ==================== PRODUCT ENDPOINTS ====================
+
+  /**
+   * Get products
+   * @param {Object} productQueryRequest - Query parameters
+   * @returns {Promise<Object>} Products response
+   */
+  async getProducts(productQueryRequest = {}) {
+    return this.post('/shopfront/api/v2/products', productQueryRequest);
+  }
+
+  /**
+   * Get product by ID
+   * @param {string} id - Product ID
+   * @param {boolean} useCache - Whether to use cache
+   * @returns {Promise<Object>} Product data
+   */
+  async getProductById(id, useCache = false) {
+    return this.get(`/shopfront/api/v2/products/${id}`, {}, useCache);
+  }
+
+  /**
+   * Search products
+   * @param {Object} searchRequest - Search parameters
+   * @returns {Promise<Object>} Search results
+   */
+  async searchProducts(searchRequest = {}) {
+    return this.post('/shopfront/api/v2/products/search', searchRequest);
+  }
+
+  // ==================== CATEGORY ENDPOINTS ====================
+
+  /**
+   * Get categories
+   * @param {Object} categoryQueryRequest - Query parameters
+   * @returns {Promise<Object>} Categories response
+   */
+  async getCategories(categoryQueryRequest = {}) {
+    return this.post('/shopfront/api/v2/categories', categoryQueryRequest);
+  }
+
+  // ==================== BRAND ENDPOINTS ====================
+
+  /**
+   * Get brands
+   * @param {Object} brandQueryRequest - Query parameters
+   * @returns {Promise<Object>} Brands response
+   */
+  async getBrands(brandQueryRequest = {}) {
+    return this.post('/shopfront/api/v2/brands', brandQueryRequest);
+  }
+
+  // ==================== WIDGET ENDPOINTS ====================
+
+  /**
+   * Get widgets
+   * @param {Object} params - Widget query parameters (section, pageId, etc.)
+   * @returns {Promise<Object>} Widgets response
+   */
+  async getWidgets(params = {}) {
+    return this.post('/shopfront/api/v2/widgets', params);
+  }
+
+  /**
+   * Get widgets by section
+   * @param {string} pageId - Page ID (optional)
+   * @param {string} section - Section name
+   * @returns {Promise<Array>} Widgets array
+   */
+  async getWidgetsBySection(pageId, section) {
+    const params = {
+      section,
+      status: 'active'
+    };
+    if (pageId) {
+      params.pageId = pageId;
+    }
+    
+    const response = await this.getWidgets(params);
+    return response.widgets || response.data || [];
+  }
+
+  // ==================== CART ENDPOINTS ====================
+
+  /**
+   * Get cart
+   * @param {string} cartId - Cart ID
+   * @returns {Promise<Object>} Cart data
+   */
+  async getCart(cartId) {
+    return this.get(`/shopfront/api/v2/cart/${cartId}`);
+  }
+
+  /**
+   * Add item to cart
+   * @param {string} cartId - Cart ID
+   * @param {Object} item - Cart item
+   * @returns {Promise<Object>} Updated cart
+   */
+  async addToCart(cartId, item) {
+    return this.post(`/shopfront/api/v2/cart/${cartId}/items`, item);
+  }
+
+  /**
+   * Update cart item
+   * @param {string} cartId - Cart ID
+   * @param {string} itemId - Item ID
+   * @param {Object} update - Update data
+   * @returns {Promise<Object>} Updated cart
+   */
+  async updateCartItem(cartId, itemId, update) {
+    return this.put(`/shopfront/api/v2/cart/${cartId}/items/${itemId}`, update);
+  }
+
+  /**
+   * Remove cart item
+   * @param {string} cartId - Cart ID
+   * @param {string} itemId - Item ID
+   * @returns {Promise<Object>} Updated cart
+   */
+  async removeCartItem(cartId, itemId) {
+    return this.delete(`/shopfront/api/v2/cart/${cartId}/items/${itemId}`);
+  }
+}
+
+module.exports = O2VendApiClient;