ecomcoder-cli 1.3.11 → 1.3.13

package/dist/lib/image-library.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Image Library Service
+ * Provides smart, context-aware images for products
+ *
+ * Strategy:
+ * 1. Extract keywords from product title
+ * 2. Search Pexels for relevant images (if API key available)
+ * 3. Fallback to Lorem Picsum if Pexels unavailable/fails
+ */
+export interface ImageSource {
+    url: string;
+    alt?: string;
+}
+/**
+ * Extract meaningful keywords from product title for image search
+ *
+ * Examples:
+ * - "Premium Hair Serum - Natural Formula" → "hair serum"
+ * - "Nike Running Shoes Size 10" → "running shoes"
+ * - "Organic Skincare Bundle" → "skincare"
+ */
+export declare function extractSearchKeywords(title: string): string;
+/**
+ * Generate random placeholder images using Lorem Picsum
+ * No API key required, no rate limits
+ *
+ * @param count Number of images to generate (default: 6)
+ * @returns Array of image sources with Lorem Picsum URLs
+ */
+export declare function getRandomPlaceholderImages(count?: number): ImageSource[];
+/**
+ * Search Pexels for relevant product images based on query
+ * Requires PEXELS_API_KEY environment variable
+ *
+ * @param query Search query (e.g., "hair serum", "running shoes")
+ * @param count Number of images to fetch (default: 6, max: 80)
+ * @returns Array of high-quality stock photos from Pexels
+ */
+export declare function searchPexelsForProduct(query: string, count?: number): Promise<ImageSource[]>;
+/**
+ * Get smart, context-aware images for a product
+ *
+ * This is the main function to use for product image generation.
+ * It intelligently selects images based on the product title.
+ *
+ * Strategy:
+ * 1. Extract keywords from product title
+ * 2. Search Pexels for relevant images (if API key available)
+ * 3. Fallback to Lorem Picsum if needed
+ *
+ * @param productTitle The product title (e.g., "Premium Hair Serum")
+ * @param count Number of images to fetch (default: 6)
+ * @param customQuery Optional custom search query (overrides title extraction)
+ * @returns Array of context-appropriate images
+ *
+ * @example
+ * // Automatically extracts "hair serum" and searches Pexels
+ * const images = await getSmartProductImages("Premium Hair Serum - Natural Formula");
+ *
+ * @example
+ * // Use custom search query
+ * const images = await getSmartProductImages("Product Name", 5, "organic skincare");
+ */
+export declare function getSmartProductImages(productTitle: string, count?: number, customQuery?: string): Promise<ImageSource[]>;
+//# sourceMappingURL=image-library.d.ts.map

package/dist/lib/image-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-library.d.ts","sourceRoot":"","sources":["../../src/lib/image-library.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA2B3D;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,GAAE,MAAU,GAAG,WAAW,EAAE,CAY3E;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAU,GAChB,OAAO,CAAC,WAAW,EAAE,CAAC,CAoDxB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,EACpB,KAAK,GAAE,MAAU,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,EAAE,CAAC,CAQxB"}

package/dist/lib/image-library.js

@@ -0,0 +1,143 @@
+/**
+ * Image Library Service
+ * Provides smart, context-aware images for products
+ *
+ * Strategy:
+ * 1. Extract keywords from product title
+ * 2. Search Pexels for relevant images (if API key available)
+ * 3. Fallback to Lorem Picsum if Pexels unavailable/fails
+ */
+/**
+ * Extract meaningful keywords from product title for image search
+ *
+ * Examples:
+ * - "Premium Hair Serum - Natural Formula" → "hair serum"
+ * - "Nike Running Shoes Size 10" → "running shoes"
+ * - "Organic Skincare Bundle" → "skincare"
+ */
+export function extractSearchKeywords(title) {
+    // Remove common filler words and qualifiers
+    const fillerWords = [
+        'premium', 'deluxe', 'professional', 'natural', 'organic',
+        'new', 'best', 'top', 'quality', 'high', 'low',
+        'small', 'medium', 'large', 'xl', 'xxl',
+        'pack', 'set', 'bundle', 'kit', 'collection',
+        'size', 'color', 'variant', 'option'
+    ];
+    // Remove HTML tags if present
+    let cleanTitle = title.replace(/<[^>]*>/g, '');
+    // Split by common separators
+    cleanTitle = cleanTitle.split(/[-–—:|]/)[0].trim();
+    // Convert to lowercase and split into words
+    const words = cleanTitle.toLowerCase()
+        .replace(/[^\w\s]/g, ' ') // Remove special chars
+        .split(/\s+/)
+        .filter(word => word.length > 2); // Remove very short words
+    // Filter out filler words
+    const meaningfulWords = words.filter(word => !fillerWords.includes(word));
+    // Return first 2-3 meaningful words for better search results
+    return meaningfulWords.slice(0, 3).join(' ') || cleanTitle.toLowerCase();
+}
+/**
+ * Generate random placeholder images using Lorem Picsum
+ * No API key required, no rate limits
+ *
+ * @param count Number of images to generate (default: 6)
+ * @returns Array of image sources with Lorem Picsum URLs
+ */
+export function getRandomPlaceholderImages(count = 6) {
+    const images = [];
+    for (let i = 0; i < count; i++) {
+        const seed = Date.now() + i; // Unique seed for variety
+        images.push({
+            url: `https://picsum.photos/seed/${seed}/800/800`,
+            alt: `Product Image ${i + 1}`
+        });
+    }
+    return images;
+}
+/**
+ * Search Pexels for relevant product images based on query
+ * Requires PEXELS_API_KEY environment variable
+ *
+ * @param query Search query (e.g., "hair serum", "running shoes")
+ * @param count Number of images to fetch (default: 6, max: 80)
+ * @returns Array of high-quality stock photos from Pexels
+ */
+export async function searchPexelsForProduct(query, count = 6) {
+    const apiKey = process.env.PEXELS_API_KEY;
+    if (!apiKey) {
+        console.error('ℹ️  PEXELS_API_KEY not set. Using Lorem Picsum placeholders instead.');
+        console.error('   Get free API key at: https://www.pexels.com/api/');
+        return getRandomPlaceholderImages(count);
+    }
+    try {
+        const limit = Math.min(count, 80); // Pexels max per request
+        const params = new URLSearchParams({
+            query: query,
+            per_page: limit.toString(),
+            orientation: 'square' // Square images work best for product thumbnails
+        });
+        const response = await fetch(`https://api.pexels.com/v1/search?${params}`, {
+            headers: {
+                'Authorization': apiKey
+            }
+        });
+        if (!response.ok) {
+            if (response.status === 429) {
+                console.error('⚠️  Pexels rate limit exceeded. Using Lorem Picsum placeholders.');
+                console.error('   Free tier: 200/hour, 20,000/month');
+                return getRandomPlaceholderImages(count);
+            }
+            throw new Error(`Pexels API error: ${response.status}`);
+        }
+        const data = await response.json();
+        if (!data.photos || data.photos.length === 0) {
+            console.error(`ℹ️  No Pexels images found for "${query}". Using Lorem Picsum placeholders.`);
+            return getRandomPlaceholderImages(count);
+        }
+        // Map Pexels photos to our ImageSource format
+        const images = data.photos.map((photo, index) => ({
+            url: photo.src.large2x || photo.src.large, // High quality image
+            alt: photo.alt || `${query} - Image ${index + 1}`
+        }));
+        console.error(`✅  Found ${images.length} relevant images from Pexels for "${query}"`);
+        return images;
+    }
+    catch (error) {
+        console.error(`⚠️  Pexels search failed: ${error.message}. Using Lorem Picsum placeholders.`);
+        return getRandomPlaceholderImages(count);
+    }
+}
+/**
+ * Get smart, context-aware images for a product
+ *
+ * This is the main function to use for product image generation.
+ * It intelligently selects images based on the product title.
+ *
+ * Strategy:
+ * 1. Extract keywords from product title
+ * 2. Search Pexels for relevant images (if API key available)
+ * 3. Fallback to Lorem Picsum if needed
+ *
+ * @param productTitle The product title (e.g., "Premium Hair Serum")
+ * @param count Number of images to fetch (default: 6)
+ * @param customQuery Optional custom search query (overrides title extraction)
+ * @returns Array of context-appropriate images
+ *
+ * @example
+ * // Automatically extracts "hair serum" and searches Pexels
+ * const images = await getSmartProductImages("Premium Hair Serum - Natural Formula");
+ *
+ * @example
+ * // Use custom search query
+ * const images = await getSmartProductImages("Product Name", 5, "organic skincare");
+ */
+export async function getSmartProductImages(productTitle, count = 6, customQuery) {
+    // Use custom query if provided, otherwise extract from title
+    const searchQuery = customQuery || extractSearchKeywords(productTitle);
+    console.error(`🔍 Searching for images: "${searchQuery}"`);
+    // Try Pexels first, will auto-fallback to Lorem Picsum if needed
+    return await searchPexelsForProduct(searchQuery, count);
+}
+//# sourceMappingURL=image-library.js.map

package/dist/lib/image-library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-library.js","sourceRoot":"","sources":["../../src/lib/image-library.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ecomcoder-cli",
-  "version": "1.3.11",
+  "version": "1.3.13",
   "type": "module",
   "description": "CLI tools for EcomCoder - Shopify development utilities",
   "main": "./dist/index.js",