ecomcoder-cli 1.3.3 → 1.3.4

package/dist/commands/shop/index.js

@@ -0,0 +1,61 @@
+/**
+ * Shop Commands Registration
+ *
+ * Following Open/Closed Principle - commands register themselves
+ */
+import { registry } from '../../lib/command-registry.js';
+/**
+ * Register all shop commands
+ */
+export function registerShopCommands() {
+    // Register command group
+    registry.registerGroup({
+        command: 'shop',
+        description: 'Manage shop-level (store-wide) settings and metafields',
+        showHelp: () => {
+            console.log(`
+Shop Commands - Manage store-wide settings and metafields
+
+USAGE:
+  ecomcoder shop <subcommand> [options]
+
+SUBCOMMANDS:
+  set-metafield        Set or update shop metafield values
+  get-metafield        View shop metafield values
+
+EXAMPLES:
+  # Set store-wide announcement
+  ecomcoder shop set-metafield --namespace=custom --key=announcement --value="Sale!" --type=single_line_text_field
+
+  # Get announcement metafield
+  ecomcoder shop get-metafield --namespace=custom --key=announcement
+
+  # Get all metafields in 'custom' namespace
+  ecomcoder shop get-metafield --namespace=custom
+
+  # Set free shipping threshold
+  ecomcoder shop set-metafield --namespace=shipping --key=min_amount --value="50.00" --type=number_decimal
+
+  # Set featured products (global)
+  ecomcoder shop set-metafield --namespace=products --key=featured --value='["gid://shopify/Product/123"]' --type=list.product_reference
+
+For detailed help on a specific subcommand:
+  ecomcoder shop <subcommand> --help
+`);
+        }
+    });
+    // Register individual subcommands
+    registry.register({
+        command: 'shop',
+        subcommand: 'set-metafield',
+        description: 'Set or update shop metafield values',
+        handler: async () => await import('./set-metafield.js')
+    });
+    registry.register({
+        command: 'shop',
+        subcommand: 'get-metafield',
+        description: 'View shop metafield values',
+        handler: async () => await import('./get-metafield.js')
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/shop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/shop/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAEzD;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,yBAAyB;IACzB,QAAQ,CAAC,aAAa,CAAC;QACrB,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,wDAAwD;QACrE,QAAQ,EAAE,GAAG,EAAE;YACb,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BjB,CAAC,CAAC;QACC,CAAC;KACF,CAAC,CAAC;IAEH,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,CAAC;QAChB,OAAO,EAAE,MAAM;QACf,UAAU,EAAE,eAAe;QAC3B,WAAW,EAAE,qCAAqC;QAClD,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,oBAAoB,CAAC;KACxD,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,CAAC;QAChB,OAAO,EAAE,MAAM;QACf,UAAU,EAAE,eAAe;QAC3B,WAAW,EAAE,4BAA4B;QACzC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,MAAM,MAAM,CAAC,oBAAoB,CAAC;KACxD,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/shop/queries.d.ts

@@ -0,0 +1,24 @@
+/**
+ * GraphQL Queries and Mutations for Shop Operations
+ *
+ * Following Single Responsibility Principle - this module only contains GraphQL strings
+ */
+/**
+ * Get shop ID (needed for metafield mutations)
+ */
+export declare const GET_SHOP_ID = "\n  query getShopId {\n    shop {\n      id\n    }\n  }\n";
+/**
+ * Get specific shop metafield by namespace and key
+ */
+export declare const GET_SHOP_METAFIELD = "\n  query getShopMetafield($namespace: String!, $key: String!) {\n    shop {\n      id\n      metafield(namespace: $namespace, key: $key) {\n        id\n        namespace\n        key\n        value\n        type\n        createdAt\n        updatedAt\n      }\n    }\n  }\n";
+/**
+ * Get shop metafields (multiple)
+ * Used for querying all metafields or by namespace
+ */
+export declare const GET_SHOP_METAFIELDS = "\n  query getShopMetafields($namespace: String, $first: Int) {\n    shop {\n      id\n      metafields(namespace: $namespace, first: $first) {\n        edges {\n          node {\n            id\n            namespace\n            key\n            value\n            type\n            createdAt\n            updatedAt\n          }\n        }\n      }\n    }\n  }\n";
+/**
+ * Set metafield values for shop
+ * Maximum 25 metafields per request, atomic operation
+ */
+export declare const METAFIELDS_SET = "\n  mutation metafieldsSet($metafields: [MetafieldsSetInput!]!) {\n    metafieldsSet(metafields: $metafields) {\n      metafields {\n        id\n        namespace\n        key\n        value\n        type\n        createdAt\n        updatedAt\n      }\n      userErrors {\n        field\n        message\n        code\n      }\n    }\n  }\n";
+//# sourceMappingURL=queries.d.ts.map

package/dist/commands/shop/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/commands/shop/queries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,8DAMvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,sRAe9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,gXAmB/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,yVAmB1B,CAAC"}

package/dist/commands/shop/queries.js

@@ -0,0 +1,83 @@
+/**
+ * GraphQL Queries and Mutations for Shop Operations
+ *
+ * Following Single Responsibility Principle - this module only contains GraphQL strings
+ */
+/**
+ * Get shop ID (needed for metafield mutations)
+ */
+export const GET_SHOP_ID = `
+  query getShopId {
+    shop {
+      id
+    }
+  }
+`;
+/**
+ * Get specific shop metafield by namespace and key
+ */
+export const GET_SHOP_METAFIELD = `
+  query getShopMetafield($namespace: String!, $key: String!) {
+    shop {
+      id
+      metafield(namespace: $namespace, key: $key) {
+        id
+        namespace
+        key
+        value
+        type
+        createdAt
+        updatedAt
+      }
+    }
+  }
+`;
+/**
+ * Get shop metafields (multiple)
+ * Used for querying all metafields or by namespace
+ */
+export const GET_SHOP_METAFIELDS = `
+  query getShopMetafields($namespace: String, $first: Int) {
+    shop {
+      id
+      metafields(namespace: $namespace, first: $first) {
+        edges {
+          node {
+            id
+            namespace
+            key
+            value
+            type
+            createdAt
+            updatedAt
+          }
+        }
+      }
+    }
+  }
+`;
+/**
+ * Set metafield values for shop
+ * Maximum 25 metafields per request, atomic operation
+ */
+export const METAFIELDS_SET = `
+  mutation metafieldsSet($metafields: [MetafieldsSetInput!]!) {
+    metafieldsSet(metafields: $metafields) {
+      metafields {
+        id
+        namespace
+        key
+        value
+        type
+        createdAt
+        updatedAt
+      }
+      userErrors {
+        field
+        message
+        code
+      }
+    }
+  }
+`;
+//# sourceMappingURL=queries.js.map

package/dist/commands/shop/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/commands/shop/queries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;CAM1B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;CAejC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;CAmBlC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;CAmB7B,CAAC"}

package/dist/commands/shop/service.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shop Service - Business Logic Layer
+ *
+ * Following Service Layer Pattern - all shop business logic here
+ * Thin command handlers delegate to these methods
+ */
+import type { ShopifyCredentials } from '../../lib/types.js';
+import { CommandResult, SetShopMetafieldInput, GetShopMetafieldInput } from './types.js';
+export declare class ShopService {
+    /**
+     * Get shop ID
+     * Required for metafield mutations (ownerId)
+     */
+    static getShopId(credentials: ShopifyCredentials): Promise<CommandResult<{
+        shopId: string;
+    }>>;
+    /**
+     * Set shop metafield value
+     */
+    static setMetafield(credentials: ShopifyCredentials, input: SetShopMetafieldInput): Promise<CommandResult>;
+    /**
+     * Get shop metafield(s)
+     * Supports:
+     * - Specific metafield (namespace + key)
+     * - All metafields in namespace (namespace only)
+     * - All metafields (no params)
+     */
+    static getMetafield(credentials: ShopifyCredentials, input: GetShopMetafieldInput): Promise<CommandResult>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/commands/shop/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/commands/shop/service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAO7D,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,qBAAqB,EAKtB,MAAM,YAAY,CAAC;AAEpB,qBAAa,WAAW;IACtB;;;OAGG;WACU,SAAS,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAsBnG;;OAEG;WACU,YAAY,CACvB,WAAW,EAAE,kBAAkB,EAC/B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,aAAa,CAAC;IAiEzB;;;;;;OAMG;WACU,YAAY,CACvB,WAAW,EAAE,kBAAkB,EAC/B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,aAAa,CAAC;CAmD1B"}

package/dist/commands/shop/service.js

@@ -0,0 +1,131 @@
+/**
+ * Shop Service - Business Logic Layer
+ *
+ * Following Service Layer Pattern - all shop business logic here
+ * Thin command handlers delegate to these methods
+ */
+import { shopifyGraphQL } from '../../lib/shopify-client.js';
+import { GET_SHOP_ID, GET_SHOP_METAFIELD, GET_SHOP_METAFIELDS, METAFIELDS_SET } from './queries.js';
+export class ShopService {
+    /**
+     * Get shop ID
+     * Required for metafield mutations (ownerId)
+     */
+    static async getShopId(credentials) {
+        const response = await shopifyGraphQL(credentials, GET_SHOP_ID, {});
+        if (!response.data?.shop) {
+            return {
+                success: false,
+                error: 'Shop not found'
+            };
+        }
+        return {
+            success: true,
+            data: {
+                shopId: response.data.shop.id
+            }
+        };
+    }
+    /**
+     * Set shop metafield value
+     */
+    static async setMetafield(credentials, input) {
+        // Get shop ID first
+        const shopIdResult = await this.getShopId(credentials);
+        if (!shopIdResult.success || !shopIdResult.data) {
+            return {
+                success: false,
+                error: shopIdResult.error || 'Failed to get shop ID'
+            };
+        }
+        const { shopId } = shopIdResult.data;
+        // Prepare metafield input
+        const metafieldInput = {
+            ownerId: shopId,
+            namespace: input.namespace,
+            key: input.key,
+            value: input.value,
+            type: input.type
+        };
+        // Execute mutation
+        const response = await shopifyGraphQL(credentials, METAFIELDS_SET, { metafields: [metafieldInput] });
+        // Check for user errors
+        const userErrors = response.data?.metafieldsSet?.userErrors || [];
+        if (userErrors.length > 0) {
+            const errors = userErrors
+                .map((e) => e.message)
+                .join(', ');
+            return {
+                success: false,
+                error: `GraphQL errors: ${errors}`
+            };
+        }
+        // Return the set metafield
+        const metafield = response.data?.metafieldsSet?.metafields?.[0];
+        if (!metafield) {
+            return {
+                success: false,
+                error: 'No metafield returned from mutation'
+            };
+        }
+        return {
+            success: true,
+            data: {
+                metafield: {
+                    id: metafield.id,
+                    namespace: metafield.namespace,
+                    key: metafield.key,
+                    value: metafield.value,
+                    type: metafield.type,
+                    createdAt: metafield.createdAt,
+                    updatedAt: metafield.updatedAt
+                }
+            }
+        };
+    }
+    /**
+     * Get shop metafield(s)
+     * Supports:
+     * - Specific metafield (namespace + key)
+     * - All metafields in namespace (namespace only)
+     * - All metafields (no params)
+     */
+    static async getMetafield(credentials, input) {
+        // If both namespace and key provided, get specific metafield
+        if (input.namespace && input.key) {
+            const response = await shopifyGraphQL(credentials, GET_SHOP_METAFIELD, { namespace: input.namespace, key: input.key });
+            if (!response.data?.shop) {
+                return {
+                    success: false,
+                    error: 'Shop not found'
+                };
+            }
+            return {
+                success: true,
+                data: {
+                    metafield: response.data.shop.metafield
+                }
+            };
+        }
+        // Otherwise, get multiple metafields
+        const response = await shopifyGraphQL(credentials, GET_SHOP_METAFIELDS, {
+            namespace: input.namespace || undefined,
+            first: 250 // Maximum allowed
+        });
+        if (!response.data?.shop) {
+            return {
+                success: false,
+                error: 'Shop not found'
+            };
+        }
+        const metafields = response.data.shop.metafields.edges.map((edge) => edge.node);
+        return {
+            success: true,
+            data: {
+                metafields,
+                count: metafields.length
+            }
+        };
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/commands/shop/service.js.map

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

package/dist/commands/shop/set-metafield.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Set Shop Metafield Command
+ *
+ * Following Command Pattern - thin orchestration layer
+ * Delegates business logic to ShopService
+ */
+export declare function run(argv?: string[]): Promise<void>;
+//# sourceMappingURL=set-metafield.d.ts.map

package/dist/commands/shop/set-metafield.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-metafield.d.ts","sourceRoot":"","sources":["../../../src/commands/shop/set-metafield.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmIH,wBAAsB,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,iBA6C/D"}

package/dist/commands/shop/set-metafield.js

@@ -0,0 +1,174 @@
+/**
+ * Set Shop Metafield Command
+ *
+ * Following Command Pattern - thin orchestration layer
+ * Delegates business logic to ShopService
+ */
+import { getCredentials, getSessionId } from '../../lib/api-client.js';
+import { parseArgs, hasHelpFlag } from '../../lib/args-parser.js';
+import { ShopService } from './service.js';
+function showHelp() {
+    console.log(`
+Set Shop Metafield
+
+USAGE:
+  ecomcoder shop set-metafield [OPTIONS]
+
+REQUIRED OPTIONS:
+  --namespace <namespace>   Metafield namespace (e.g., 'custom', 'app')
+  --key <key>               Metafield key/identifier
+  --value <value>           Metafield value (format depends on type)
+  --type <type>             Metafield type (see list below)
+
+OPTIONAL:
+  --session-id              Session ID (auto-provided via SESSION_ID env var)
+  --help, -h                Show this help message
+
+SUPPORTED TYPES:
+  Text:
+    single_line_text_field      Single line of text
+    multi_line_text_field       Multiple lines of text
+    rich_text_field             Rich text with formatting
+
+  Numbers:
+    number_integer              Whole numbers
+    number_decimal              Decimal numbers
+    rating                      Rating on a scale
+
+  Boolean:
+    boolean                     True or false value
+
+  Dates:
+    date                        ISO 8601 date (YYYY-MM-DD)
+    date_time                   ISO 8601 timestamp
+
+  Measurements:
+    dimension                   Length with unit
+    volume                      Volume with unit
+    weight                      Weight with unit
+
+  Commerce:
+    money                       Amount with currency
+    color                       Hexadecimal color code
+
+  References (Links to Shopify Resources):
+    product_reference           Link to a product
+    variant_reference           Link to a variant
+    collection_reference        Link to a collection
+    page_reference              Link to a page
+    file_reference              Link to uploaded file
+
+  Other:
+    url                         URL (https, http, mailto, sms, tel)
+    json                        JSON-serializable value
+    link                        Text and URL pairing
+
+  Lists (prefix with 'list.'):
+    list.single_line_text_field
+    list.number_integer
+    list.product_reference
+    list.color
+    (etc. - all types support lists)
+
+EXAMPLES:
+  # Store-wide announcement
+  ecomcoder shop set-metafield \\
+    --namespace=custom \\
+    --key=announcement \\
+    --value="Black Friday Sale!" \\
+    --type=single_line_text_field
+
+  # Free shipping minimum
+  ecomcoder shop set-metafield \\
+    --namespace=custom \\
+    --key=free_shipping_min \\
+    --value="50.00" \\
+    --type=number_decimal
+
+  # Featured products (global)
+  ecomcoder shop set-metafield \\
+    --namespace=custom \\
+    --key=featured_products \\
+    --value='["gid://shopify/Product/123","gid://shopify/Product/456"]' \\
+    --type=list.product_reference
+
+  # Store settings as JSON
+  ecomcoder shop set-metafield \\
+    --namespace=custom \\
+    --key=settings \\
+    --value='{"theme":"dark","currency":"USD"}' \\
+    --type=json
+
+  # Enable feature flag
+  ecomcoder shop set-metafield \\
+    --namespace=features \\
+    --key=show_reviews \\
+    --value="true" \\
+    --type=boolean
+
+OUTPUT FORMAT:
+  {
+    "success": true,
+    "data": {
+      "metafield": {
+        "id": "gid://shopify/Metafield/123",
+        "namespace": "custom",
+        "key": "announcement",
+        "value": "Black Friday Sale!",
+        "type": "single_line_text_field",
+        "createdAt": "2024-01-20T10:30:00Z",
+        "updatedAt": "2024-01-20T15:45:00Z"
+      }
+    }
+  }
+
+NOTES:
+  - Maximum 25 metafields per request
+  - Maximum 10MB total payload size
+  - All values stored as strings (validated by type)
+  - Reference types use GID format: gid://shopify/Resource/ID
+  - List values must be valid JSON arrays
+`);
+    process.exit(0);
+}
+export async function run(argv = process.argv.slice(2)) {
+    if (hasHelpFlag(argv)) {
+        showHelp();
+    }
+    const args = parseArgs(argv);
+    // Validate required arguments
+    const requiredArgs = ['namespace', 'key', 'value', 'type'];
+    const missing = requiredArgs.filter(arg => !args[arg]);
+    if (missing.length > 0) {
+        console.error(JSON.stringify({
+            success: false,
+            error: `Missing required arguments: ${missing.map(a => `--${a}`).join(', ')}`
+        }));
+        process.exit(1);
+    }
+    try {
+        // Get credentials
+        const sessionId = getSessionId(args.sessionId);
+        const credentials = await getCredentials(sessionId, args.backendUrl, args.jwt);
+        // Execute set metafield via service
+        const result = await ShopService.setMetafield(credentials, {
+            namespace: args.namespace,
+            key: args.key,
+            value: args.value,
+            type: args.type
+        });
+        // Output result
+        console.log(JSON.stringify(result, null, 2));
+        if (!result.success) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(JSON.stringify({
+            success: false,
+            error: error.message || 'Unknown error occurred'
+        }));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=set-metafield.js.map

package/dist/commands/shop/set-metafield.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-metafield.js","sourceRoot":"","sources":["../../../src/commands/shop/set-metafield.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,SAAS,QAAQ;IACf,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwHb,CAAC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,OAAiB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9D,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,QAAQ,EAAE,CAAC;IACb,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE7B,8BAA8B;IAC9B,MAAM,YAAY,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAEvD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;YAC3B,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,+BAA+B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAC9E,CAAC,CAAC,CAAC;QACJ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,kBAAkB;QAClB,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAE/E,oCAAoC;QACpC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,YAAY,CAAC,WAAW,EAAE;YACzD,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;QAEH,gBAAgB;QAChB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAE7C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;YAC3B,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK,CAAC,OAAO,IAAI,wBAAwB;SACjD,CAAC,CAAC,CAAC;QACJ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/shop/types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Shop Command Types
+ * Type definitions for shop-related commands
+ */
+/**
+ * Shop metafield operations
+ */
+export interface SetShopMetafieldInput {
+    namespace: string;
+    key: string;
+    value: string;
+    type: string;
+}
+export interface GetShopMetafieldInput {
+    namespace?: string;
+    key?: string;
+}
+/**
+ * Shopify GraphQL response types
+ */
+export interface ShopMetafieldResponse {
+    shop: {
+        id: string;
+        metafield: {
+            id: string;
+            namespace: string;
+            key: string;
+            value: string;
+            type: string;
+            createdAt: string;
+            updatedAt: string;
+        } | null;
+    } | null;
+}
+export interface ShopMetafieldsResponse {
+    shop: {
+        id: string;
+        metafields: {
+            edges: Array<{
+                node: {
+                    id: string;
+                    namespace: string;
+                    key: string;
+                    value: string;
+                    type: string;
+                    createdAt: string;
+                    updatedAt: string;
+                };
+            }>;
+        };
+    } | null;
+}
+export interface MetafieldsSetResponse {
+    metafieldsSet: {
+        metafields: Array<{
+            id: string;
+            namespace: string;
+            key: string;
+            value: string;
+            type: string;
+            createdAt: string;
+            updatedAt: string;
+        }>;
+        userErrors: Array<{
+            field: string[] | null;
+            message: string;
+            code?: string;
+        }>;
+    };
+}
+export interface ShopIdResponse {
+    shop: {
+        id: string;
+    };
+}
+/**
+ * CLI command result types
+ */
+export interface CommandResult<T = any> {
+    success: boolean;
+    data?: T;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/shop/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/commands/shop/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE;YACT,EAAE,EAAE,MAAM,CAAC;YACX,SAAS,EAAE,MAAM,CAAC;YAClB,GAAG,EAAE,MAAM,CAAC;YACZ,KAAK,EAAE,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,CAAC;YAClB,SAAS,EAAE,MAAM,CAAC;SACnB,GAAG,IAAI,CAAC;KACV,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE;YACV,KAAK,EAAE,KAAK,CAAC;gBACX,IAAI,EAAE;oBACJ,EAAE,EAAE,MAAM,CAAC;oBACX,SAAS,EAAE,MAAM,CAAC;oBAClB,GAAG,EAAE,MAAM,CAAC;oBACZ,KAAK,EAAE,MAAM,CAAC;oBACd,IAAI,EAAE,MAAM,CAAC;oBACb,SAAS,EAAE,MAAM,CAAC;oBAClB,SAAS,EAAE,MAAM,CAAC;iBACnB,CAAC;aACH,CAAC,CAAC;SACJ,CAAC;KACH,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE;QACb,UAAU,EAAE,KAAK,CAAC;YAChB,EAAE,EAAE,MAAM,CAAC;YACX,SAAS,EAAE,MAAM,CAAC;YAClB,GAAG,EAAE,MAAM,CAAC;YACZ,KAAK,EAAE,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,SAAS,EAAE,MAAM,CAAC;YAClB,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC,CAAC;QACH,UAAU,EAAE,KAAK,CAAC;YAChB,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;YACvB,OAAO,EAAE,MAAM,CAAC;YAChB,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC,CAAC;KACJ,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,GAAG;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/commands/shop/types.js

@@ -0,0 +1,6 @@
+/**
+ * Shop Command Types
+ * Type definitions for shop-related commands
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/commands/shop/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/commands/shop/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

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