ecomcoder-cli 1.2.12 → 1.3.0

package/README.md

@@ -0,0 +1,293 @@
+# EcomCoder CLI
+
+> CLI tools for EcomCoder - Shopify development utilities
+
+A command-line interface for streamlining Shopify theme development and testing. Built for developers working with EcomCoder's Shopify development platform.
+
+## Installation
+
+```bash
+npm install -g ecomcoder-cli
+```
+
+Or use with npx (no installation required):
+
+```bash
+npx ecomcoder-cli [command]
+```
+
+## Prerequisites
+
+- Node.js >= 18.0.0
+- Active EcomCoder session (authenticated via Claude Agent SDK)
+
+## Usage
+
+```bash
+ecomcoder <command> <subcommand> [options]
+```
+
+## Commands
+
+### Products
+
+#### Create Dummy Products
+
+Create test products in your Shopify store for development and testing.
+
+```bash
+ecomcoder products create --count=10
+```
+
+**Options:**
+- `--count` - Number of products to create (default: 10)
+
+#### List Products
+
+Retrieve and display products from your Shopify store.
+
+```bash
+ecomcoder products list --limit=50
+```
+
+**Options:**
+- `--limit` - Maximum number of products to retrieve (default: 50)
+
+#### Set Product Rating
+
+Add rating metafields to a product (useful for testing review systems).
+
+```bash
+ecomcoder products set-rating \
+  --product-id="gid://shopify/Product/123456789" \
+  --rating=4.5 \
+  --count=127
+```
+
+**Options:**
+- `--product-id` - Shopify product GID
+- `--rating` - Rating value (e.g., 4.5)
+- `--count` - Number of reviews/ratings
+
+### Metafields
+
+#### Create Metafield Definition
+
+Create custom metafield definitions at product or shop level.
+
+**Product-level metafield:**
+```bash
+ecomcoder metafield create \
+  --name="Product Rating" \
+  --key=rating \
+  --type=number_decimal \
+  --owner-type=PRODUCT
+```
+
+**Shop-level metafield (global):**
+```bash
+ecomcoder metafield create \
+  --name="Cart Upsell Product" \
+  --key=cart_upsell \
+  --type=product_reference \
+  --owner-type=SHOP
+```
+
+**Options:**
+- `--name` - Display name for the metafield
+- `--key` - Metafield key (used in code)
+- `--type` - Metafield type (e.g., `number_decimal`, `product_reference`, `single_line_text_field`)
+- `--owner-type` - Owner type: `PRODUCT` or `SHOP`
+
+#### Get Metafield Definition
+
+Retrieve metafield definitions from your store.
+
+```bash
+ecomcoder metafield get \
+  --namespace=ecomcoder \
+  --key=upsell \
+  --owner-type=PRODUCT
+```
+
+**Options:**
+- `--namespace` - Metafield namespace
+- `--key` - Metafield key
+- `--owner-type` - Owner type: `PRODUCT` or `SHOP`
+
+### Documentation
+
+#### Search Shopify Docs
+
+Search Shopify theme documentation using AI-powered semantic search.
+
+```bash
+ecomcoder docs search --query="How do sections work in Shopify themes?"
+```
+
+**Options:**
+- `--query` - Your search question
+
+## Authentication
+
+The CLI uses session-based authentication that's automatically provided when running within the Claude Agent SDK environment. The following environment variables are auto-injected:
+
+- `SESSION_ID` - Session identifier
+- `BACKEND_URL` - Orchestrator backend URL
+- `SUPABASE_JWT` - Authentication token
+- `SUPABASE_URL` - Supabase project URL
+- `SUPABASE_ANON_KEY` - Supabase anonymous key
+
+You can also manually provide the session ID:
+
+```bash
+ecomcoder products list --session-id=your-session-id
+```
+
+## Development
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/ImadMoka/ecomcoder-cli.git
+cd ecomcoder-cli
+
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run in development mode (watch mode)
+npm run dev
+```
+
+### Project Structure
+
+```
+ecomcoder-cli/
+├── bin/
+│   └── ecomcoder.js        # CLI executable
+├── src/
+│   ├── commands/           # Command implementations
+│   │   ├── create-dummy-products.ts
+│   │   ├── list-products.ts
+│   │   ├── set-product-rating.ts
+│   │   ├── create-metafield.ts
+│   │   ├── get-metafield.ts
+│   │   └── docs-search.ts
+│   ├── lib/                # Shared utilities
+│   │   ├── api-client.ts
+│   │   ├── shopify-client.ts
+│   │   ├── supabase-client.ts
+│   │   ├── pinecone-client.ts
+│   │   ├── args-parser.ts
+│   │   └── types.ts
+│   └── cli.ts              # Main CLI entry point
+├── dist/                   # Compiled output
+└── package.json
+```
+
+### Scripts
+
+- `npm run build` - Compile TypeScript to JavaScript
+- `npm run dev` - Watch mode for development
+- `npm run release:patch` - Bump patch version and publish (manual)
+- `npm run release:minor` - Bump minor version and publish (manual)
+- `npm run release:major` - Bump major version and publish (manual)
+
+## Publishing
+
+### Automated Publishing (Recommended)
+
+This project uses GitHub Actions for automated npm publishing:
+
+1. **Create a GitHub Release:**
+   - Go to your repository on GitHub
+   - Click "Releases" → "Create a new release"
+   - Create a tag following semver (e.g., `v1.2.12`, `v1.3.0`)
+   - Add release notes describing changes
+   - Click "Publish release"
+
+2. **Automatic Publishing:**
+   - GitHub Actions automatically triggers
+   - Updates package.json version from the tag
+   - Builds the project
+   - Publishes to npm with provenance
+   - Provides a summary with npm link
+
+### Setup (First Time Only)
+
+**1. Create npm Access Token:**
+   - Go to [npmjs.com](https://www.npmjs.com/) → Account Settings → Access Tokens
+   - Generate a new "Automation" token
+   - Copy the token
+
+**2. Add Token to GitHub:**
+   - Repository Settings → Secrets and variables → Actions
+   - Click "New repository secret"
+   - Name: `NPM_TOKEN`
+   - Value: paste your npm token
+   - Save
+
+### Manual Publishing (Legacy)
+
+```bash
+# Patch release (1.2.11 → 1.2.12)
+npm run release:patch
+
+# Minor release (1.2.11 → 1.3.0)
+npm run release:minor
+
+# Major release (1.2.11 → 2.0.0)
+npm run release:major
+```
+
+## Examples
+
+```bash
+# Create 25 test products
+ecomcoder products create --count=25
+
+# List all products (up to 100)
+ecomcoder products list --limit=100
+
+# Add a 4.8 star rating with 243 reviews
+ecomcoder products set-rating \
+  --product-id="gid://shopify/Product/8234567890" \
+  --rating=4.8 \
+  --count=243
+
+# Create a shop-level recommended products metafield
+ecomcoder metafield create \
+  --name="Recommended Products" \
+  --key=recommended \
+  --type=list.product_reference \
+  --owner-type=SHOP
+
+# Search for information about Liquid filters
+ecomcoder docs search --query="What are the available date filters in Liquid?"
+```
+
+## License
+
+MIT
+
+## Support
+
+For issues and feature requests, please visit:
+- [GitHub Issues](https://github.com/ImadMoka/ecomcoder-cli/issues)
+- [EcomCoder Platform](https://ecomcoder.com)
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+---
+
+**Built with:**
+- TypeScript
+- Shopify Admin API
+- Supabase
+- Pinecone (for semantic search)

package/dist/__tests__/test-utils.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Test Utilities
+ *
+ * Shared helpers for testing CLI commands
+ */
+import type { ShopifyCredentials } from '../lib/types.js';
+/**
+ * Mock Shopify credentials for testing
+ */
+export declare const mockCredentials: ShopifyCredentials;
+/**
+ * Mock GraphQL response helper
+ */
+export declare function mockGraphQLResponse<T>(data: T, errors?: any[]): {
+    data: T;
+    errors: any[] | undefined;
+};
+/**
+ * Mock product data
+ */
+export declare const mockProduct: {
+    id: string;
+    title: string;
+    description: string;
+    descriptionHtml: string;
+    handle: string;
+    productType: string;
+    vendor: string;
+    tags: string[];
+    status: "ACTIVE";
+    templateSuffix: null;
+    variants: {
+        edges: {
+            node: {
+                id: string;
+                title: string;
+                sku: string;
+                price: string;
+                compareAtPrice: null;
+                inventoryQuantity: number;
+                availableForSale: boolean;
+            };
+        }[];
+    };
+    images: {
+        edges: never[];
+    };
+    priceRangeV2: {
+        minVariantPrice: {
+            amount: string;
+            currencyCode: string;
+        };
+        maxVariantPrice: {
+            amount: string;
+            currencyCode: string;
+        };
+    };
+};
+/**
+ * Mock product with multiple variants
+ */
+export declare const mockProductMultipleVariants: {
+    variants: {
+        edges: {
+            node: {
+                id: string;
+                title: string;
+                sku: string;
+                price: string;
+                compareAtPrice: null;
+                inventoryQuantity: number;
+                availableForSale: boolean;
+            };
+        }[];
+    };
+    id: string;
+    title: string;
+    description: string;
+    descriptionHtml: string;
+    handle: string;
+    productType: string;
+    vendor: string;
+    tags: string[];
+    status: "ACTIVE";
+    templateSuffix: null;
+    images: {
+        edges: never[];
+    };
+    priceRangeV2: {
+        minVariantPrice: {
+            amount: string;
+            currencyCode: string;
+        };
+        maxVariantPrice: {
+            amount: string;
+            currencyCode: string;
+        };
+    };
+};
+/**
+ * Mock variant data
+ */
+export declare const mockVariant: {
+    id: string;
+    price: string;
+    compareAtPrice: null;
+};
+/**
+ * Mock user errors
+ */
+export declare const mockUserErrors: {
+    field: string[];
+    message: string;
+}[];
+/**
+ * Parse JSON output from CLI commands
+ */
+export declare function parseCommandOutput(output: string): any;
+/**
+ * Create mock shopifyGraphQL function
+ */
+export declare function createMockShopifyGraphQL(mockResponse: any): (credentials: ShopifyCredentials, query: string, variables?: any) => Promise<any>;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/__tests__/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../src/__tests__/test-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,kBAG7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE;;;EAK7D;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BvC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;;;;CAIvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc;;;GAK1B,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAMtD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,GAAG,IAC1C,aAAa,kBAAkB,EAAE,OAAO,MAAM,EAAE,YAAY,GAAG,kBAG9E"}

package/dist/__tests__/test-utils.js

@@ -0,0 +1,133 @@
+/**
+ * Test Utilities
+ *
+ * Shared helpers for testing CLI commands
+ */
+/**
+ * Mock Shopify credentials for testing
+ */
+export const mockCredentials = {
+    shopifyUrl: 'https://test-shop.myshopify.com',
+    shopifyAdminPassword: 'shpat_test_token_12345'
+};
+/**
+ * Mock GraphQL response helper
+ */
+export function mockGraphQLResponse(data, errors) {
+    return {
+        data,
+        errors: errors || undefined
+    };
+}
+/**
+ * Mock product data
+ */
+export const mockProduct = {
+    id: 'gid://shopify/Product/123456789',
+    title: 'Test Product',
+    description: 'Test description',
+    descriptionHtml: '<p>Test description</p>',
+    handle: 'test-product',
+    productType: 'Test Type',
+    vendor: 'Test Vendor',
+    tags: ['test', 'sample'],
+    status: 'ACTIVE',
+    templateSuffix: null,
+    variants: {
+        edges: [
+            {
+                node: {
+                    id: 'gid://shopify/ProductVariant/987654321',
+                    title: 'Default Title',
+                    sku: 'TEST-SKU',
+                    price: '29.99',
+                    compareAtPrice: null,
+                    inventoryQuantity: 100,
+                    availableForSale: true
+                }
+            }
+        ]
+    },
+    images: {
+        edges: []
+    },
+    priceRangeV2: {
+        minVariantPrice: {
+            amount: '29.99',
+            currencyCode: 'USD'
+        },
+        maxVariantPrice: {
+            amount: '29.99',
+            currencyCode: 'USD'
+        }
+    }
+};
+/**
+ * Mock product with multiple variants
+ */
+export const mockProductMultipleVariants = {
+    ...mockProduct,
+    variants: {
+        edges: [
+            {
+                node: {
+                    id: 'gid://shopify/ProductVariant/111',
+                    title: 'Small',
+                    sku: 'TEST-SKU-S',
+                    price: '29.99',
+                    compareAtPrice: null,
+                    inventoryQuantity: 50,
+                    availableForSale: true,
+                }
+            },
+            {
+                node: {
+                    id: 'gid://shopify/ProductVariant/222',
+                    title: 'Medium',
+                    sku: 'TEST-SKU-M',
+                    price: '29.99',
+                    compareAtPrice: null,
+                    inventoryQuantity: 50,
+                    availableForSale: true,
+                }
+            }
+        ]
+    }
+};
+/**
+ * Mock variant data
+ */
+export const mockVariant = {
+    id: 'gid://shopify/ProductVariant/987654321',
+    price: '29.99',
+    compareAtPrice: null
+};
+/**
+ * Mock user errors
+ */
+export const mockUserErrors = [
+    {
+        field: ['input', 'price'],
+        message: 'Price must be positive'
+    }
+];
+/**
+ * Parse JSON output from CLI commands
+ */
+export function parseCommandOutput(output) {
+    try {
+        return JSON.parse(output);
+    }
+    catch (error) {
+        throw new Error(`Failed to parse command output: ${output}`);
+    }
+}
+/**
+ * Create mock shopifyGraphQL function
+ */
+export function createMockShopifyGraphQL(mockResponse) {
+    return async (credentials, query, variables) => {
+        return mockResponse;
+    };
+}
+//# sourceMappingURL=test-utils.js.map

package/dist/__tests__/test-utils.js.map

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

package/dist/cli.d.ts

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 /**
- * EcomCoder CLI - Main Entry Point
+ * EcomCoder CLI - Main Entry Point (Refactored)
  *
- * Command structure:
- *   ecomcoder products create --count=10
- *   ecomcoder products list --limit=50
- *   ecomcoder products set-rating --product-id=... --rating=4.5 --count=127
- *   ecomcoder metafield create --name=... --key=... --type=...
- *   ecomcoder metafield get --namespace=... --key=...
+ * Architecture: Command Registry Pattern
+ *
+ * Benefits:
+ * ✅ Open/Closed Principle - Add commands without modifying this file
+ * ✅ Single Responsibility - This file only routes, doesn't know command details
+ * ✅ Scalability - Supports unlimited commands
+ * ✅ Testability - Easy to test routing logic
  */
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG"}