@ratio-mcp/shared 1.0.0

package/dist/scopes-data.js

@@ -0,0 +1,1082 @@
+/**
+ * Static scopes data — sourced from GET /api/v1/scopes
+ * Enriched with LLM-friendly descriptions, use_cases, and pairing hints
+ * so the LLM can intelligently suggest scopes based on app descriptions.
+ *
+ * To refresh base data: fetch from ${RATIO_API_BASE_URL}/api/v1/scopes
+ *
+ * Last updated: 2026-03-18
+ */
+// ─── Primary Resources ─────────────────────────────────────────
+export const PRIMARY_RESOURCES = [
+    'orders',
+    'products',
+    'customers',
+    'inventory',
+    'discounts',
+    'payments',
+    'shipping',
+    'fulfillments',
+    'draft_orders',
+    'returns',
+    'gift_cards',
+    'analytics',
+    'channels',
+    'content',
+    'files',
+    'locations',
+    'themes',
+    'markets',
+    'reports',
+    'locales',
+    'publications',
+    'settings',
+    'webhooks',
+    'apps',
+];
+// ─── Resource Metadata ──────────────────────────────────────────
+// Tells the LLM what each resource is about, whether codegen works,
+// and which resources are commonly needed together.
+export const RESOURCE_METADATA = {
+    orders: {
+        description: 'Merchant orders — includes line items, pricing, customer info, payment status, ' +
+            'fulfillment status, shipping/billing addresses, and order lifecycle events. ' +
+            'This is the core transactional data for any e-commerce store.',
+        codegen_ready: true,
+        commonly_needed_with: ['products', 'customers', 'inventory'],
+        example_app_types: [
+            'Order analytics & reporting',
+            'Order management & fulfillment',
+            'Fraud detection',
+            'Shipping & logistics',
+            'Accounting & invoicing',
+            'Customer support tools',
+        ],
+    },
+    products: {
+        description: 'Product catalog — includes titles, descriptions, pricing (in paise), variants, ' +
+            'images, inventory tracking, SEO metadata, categories, collections, and tags. ' +
+            'This is the merchandise data that powers the storefront.',
+        codegen_ready: true,
+        commonly_needed_with: ['inventory', 'orders', 'categories'],
+        example_app_types: [
+            'Product catalog sync',
+            'Price comparison & optimization',
+            'SEO & content optimization',
+            'Marketplace integrations',
+            'Product recommendations',
+            'Bulk product management',
+        ],
+    },
+    customers: {
+        description: 'Customer profiles — includes contact info (email, phone), addresses, ' +
+            'order history associations, and customer segmentation data. ' +
+            'Essential for any app that personalizes experiences or targets specific audiences.',
+        codegen_ready: false,
+        commonly_needed_with: ['orders', 'analytics'],
+        example_app_types: [
+            'CRM & customer management',
+            'Email/SMS marketing',
+            'Loyalty & rewards programs',
+            'Customer analytics & segmentation',
+            'Personalization engines',
+        ],
+    },
+    inventory: {
+        description: 'Stock levels and inventory management — track quantities across locations, ' +
+            'set reorder points, manage warehouse stock. Critical for apps that need to ' +
+            'know product availability or manage supply chain.',
+        codegen_ready: false,
+        commonly_needed_with: ['products', 'orders', 'locations'],
+        example_app_types: [
+            'Inventory management & sync',
+            'Low-stock alerts',
+            'Warehouse management',
+            'Demand forecasting',
+            'Multi-location inventory',
+        ],
+    },
+    discounts: {
+        description: 'Discount rules and promotional campaigns — create percentage or fixed-amount ' +
+            'discounts, set eligibility conditions (minimum purchase, specific products/collections), ' +
+            'manage coupon codes, and track discount usage.',
+        codegen_ready: false,
+        commonly_needed_with: ['orders', 'products', 'customers'],
+        example_app_types: [
+            'Discount & coupon management',
+            'Promotional campaigns',
+            'Bundle & volume pricing',
+            'Loyalty discounts',
+            'Cart abandonment recovery',
+        ],
+    },
+    payments: {
+        description: 'Payment transactions — view payment status, process refunds, and track ' +
+            'payment gateway interactions. Covers the financial side of order processing.',
+        codegen_ready: false,
+        commonly_needed_with: ['orders', 'returns'],
+        example_app_types: [
+            'Payment gateway integrations',
+            'Refund management',
+            'Financial reconciliation',
+            'Accounting tools',
+        ],
+    },
+    shipping: {
+        description: 'Shipping rates, methods, and carrier configurations — manage shipping zones, ' +
+            'calculate rates, and configure delivery options for the storefront.',
+        codegen_ready: false,
+        commonly_needed_with: ['orders', 'fulfillments', 'locations'],
+        example_app_types: [
+            'Shipping rate calculators',
+            'Carrier integrations',
+            'Delivery estimation',
+            'Shipping label generators',
+        ],
+    },
+    fulfillments: {
+        description: 'Order fulfillment tracking — manage the process of picking, packing, and ' +
+            'shipping orders. Includes tracking numbers, fulfillment status, and shipment details.',
+        codegen_ready: false,
+        commonly_needed_with: ['orders', 'shipping', 'inventory'],
+        example_app_types: [
+            'Fulfillment automation',
+            'Warehouse management',
+            'Dropshipping tools',
+            'Shipment tracking',
+        ],
+    },
+    draft_orders: {
+        description: 'Draft/preliminary orders that haven\'t been finalized — useful for B2B workflows, ' +
+            'custom quotes, or orders created on behalf of customers by staff.',
+        codegen_ready: false,
+        commonly_needed_with: ['orders', 'products', 'customers'],
+        example_app_types: [
+            'B2B ordering tools',
+            'Custom quote generators',
+            'POS integrations',
+            'Wholesale platforms',
+        ],
+    },
+    returns: {
+        description: 'Return and exchange management — process return requests, track return shipments, ' +
+            'manage refunds, and handle exchange workflows.',
+        codegen_ready: false,
+        commonly_needed_with: ['orders', 'payments', 'inventory'],
+        example_app_types: [
+            'Returns management portals',
+            'Exchange automation',
+            'Refund processing',
+            'RMA tracking',
+        ],
+    },
+    gift_cards: {
+        description: 'Gift card creation and management — issue digital gift cards, track balances, ' +
+            'and handle redemptions.',
+        codegen_ready: false,
+        commonly_needed_with: ['orders', 'customers'],
+        example_app_types: [
+            'Gift card platforms',
+            'Loyalty programs',
+            'Corporate gifting',
+        ],
+    },
+    analytics: {
+        description: 'Store analytics and metrics — access aggregated data on sales, traffic, ' +
+            'conversion rates, and business performance.',
+        codegen_ready: false,
+        commonly_needed_with: ['orders', 'products', 'customers'],
+        example_app_types: [
+            'Dashboard & reporting tools',
+            'Business intelligence',
+            'Performance monitoring',
+        ],
+    },
+    channels: {
+        description: 'Sales channels — manage where products are sold (online store, social media, ' +
+            'marketplaces, POS).',
+        codegen_ready: false,
+        commonly_needed_with: ['products', 'publications'],
+        example_app_types: [
+            'Multi-channel selling',
+            'Marketplace integrations',
+            'Social commerce',
+        ],
+    },
+    content: {
+        description: 'Store content like pages, blog posts, and media — manage the non-product ' +
+            'content on the storefront.',
+        codegen_ready: false,
+        commonly_needed_with: ['themes', 'files'],
+        example_app_types: [
+            'CMS integrations',
+            'Blog management',
+            'Content marketing',
+        ],
+    },
+    files: {
+        description: 'File management — upload, organize, and serve images, documents, and other ' +
+            'media assets used across the store.',
+        codegen_ready: false,
+        commonly_needed_with: ['products', 'content'],
+        example_app_types: [
+            'Asset management',
+            'Image optimization',
+            'Bulk media upload',
+        ],
+    },
+    locations: {
+        description: 'Physical store locations and warehouses — manage addresses, operating hours, ' +
+            'and inventory assignment per location.',
+        codegen_ready: false,
+        commonly_needed_with: ['inventory', 'shipping', 'fulfillments'],
+        example_app_types: [
+            'Store locator',
+            'Multi-location management',
+            'Local delivery',
+        ],
+    },
+    themes: {
+        description: 'Storefront themes and templates — customize the look and feel of the ' +
+            'merchant\'s online store.',
+        codegen_ready: false,
+        commonly_needed_with: ['content', 'files'],
+        example_app_types: [
+            'Theme customization',
+            'A/B testing',
+            'Page builders',
+        ],
+    },
+    markets: {
+        description: 'International markets — manage multi-currency, multi-language, and ' +
+            'region-specific selling configurations.',
+        codegen_ready: false,
+        commonly_needed_with: ['locales', 'products', 'shipping'],
+        example_app_types: [
+            'International expansion',
+            'Currency conversion',
+            'Localization tools',
+        ],
+    },
+    reports: {
+        description: 'Custom reports — generate and access detailed reports on sales, inventory, ' +
+            'customers, and other business metrics.',
+        codegen_ready: false,
+        commonly_needed_with: ['analytics', 'orders', 'products'],
+        example_app_types: [
+            'Custom reporting',
+            'Data export tools',
+            'Financial reports',
+        ],
+    },
+    locales: {
+        description: 'Language and locale settings — manage translations and language-specific ' +
+            'content for multi-language stores.',
+        codegen_ready: false,
+        commonly_needed_with: ['markets', 'content'],
+        example_app_types: [
+            'Translation management',
+            'Multi-language stores',
+        ],
+    },
+    publications: {
+        description: 'Product publishing — control which products are visible on which sales ' +
+            'channels and markets.',
+        codegen_ready: false,
+        commonly_needed_with: ['products', 'channels'],
+        example_app_types: [
+            'Channel management',
+            'Product syndication',
+        ],
+    },
+    settings: {
+        description: 'Store-wide settings — access and modify global store configuration ' +
+            'like checkout settings, tax rules, and notification preferences.',
+        codegen_ready: false,
+        commonly_needed_with: [],
+        example_app_types: [
+            'Store configuration tools',
+            'Tax management',
+            'Checkout customization',
+        ],
+    },
+    webhooks: {
+        description: 'Webhook subscriptions — register URLs to receive real-time notifications ' +
+            'when events occur (order created, product updated, app uninstalled, etc.).',
+        codegen_ready: false,
+        commonly_needed_with: ['orders', 'products'],
+        example_app_types: [
+            'Any app that needs real-time event processing',
+            'Integration middleware',
+            'Automation platforms',
+        ],
+    },
+    apps: {
+        description: 'App metadata — access information about installed apps on the merchant\'s store.',
+        codegen_ready: false,
+        commonly_needed_with: [],
+        example_app_types: [
+            'App management dashboards',
+            'Integration platforms',
+        ],
+    },
+};
+// ─── Enriched Scope Data ────────────────────────────────────────
+export const SCOPES_BY_RESOURCE = {
+    orders: [
+        {
+            id: '35f7087f-3412-49f2-8b39-4617100e2587',
+            code: 'read_orders',
+            label: 'Read Orders',
+            resource: 'orders',
+            createdAt: '2026-02-12T08:46:36.791Z',
+            description: 'View all order data — list orders with filtering/pagination, get individual order details ' +
+                'including line items, pricing, customer info, addresses, payment status, and fulfillment status. ' +
+                'This is the most commonly needed scope for any app that works with orders.',
+            use_cases: [
+                'Display order lists and dashboards',
+                'Analyze order trends and revenue',
+                'Check order status for fulfillment workflows',
+                'Validate discount eligibility based on past orders',
+                'Customer support tools that look up orders',
+            ],
+            commonly_paired_with: ['read_products', 'read_customers'],
+        },
+        {
+            id: '0f8ee481-5e5f-41e3-996b-857b51e81e9c',
+            code: 'write_orders',
+            label: 'Write Orders',
+            resource: 'orders',
+            createdAt: '2026-02-12T08:46:36.415Z',
+            description: 'Create new orders, update existing orders (email, phone, note, tags, status, addresses, line items), ' +
+                'cancel orders with optional restock, and update external IDs for third-party sync. ' +
+                'Includes all read_orders permissions automatically.',
+            use_cases: [
+                'Create orders from external channels (marketplace, POS)',
+                'Update order notes or tags for internal workflows',
+                'Cancel orders and trigger restocking',
+                'Sync order IDs with external ERP/WMS systems',
+                'Automated order management and processing',
+            ],
+            commonly_paired_with: ['read_products', 'write_inventory'],
+        },
+        {
+            id: '6615dcee-afc2-4131-adbc-d0051b0e5fb8',
+            code: 'order-cancel',
+            label: 'Order cancel',
+            resource: 'orders',
+            createdAt: '2026-02-12T12:54:16.601Z',
+            description: 'Specific permission to cancel orders — allows cancelling with reason, staff notes, ' +
+                'restock options, and customer notification control.',
+            use_cases: [
+                'Fraud detection apps that auto-cancel suspicious orders',
+                'Customer self-service cancellation portals',
+                'Automated cancellation workflows',
+            ],
+            commonly_paired_with: ['read_orders', 'write_inventory'],
+        },
+        {
+            id: 'e62a3d30-d9f4-455e-afa8-0d753e9697e3',
+            code: 'order-create',
+            label: 'Order create',
+            resource: 'orders',
+            createdAt: '2026-02-12T12:54:00.455Z',
+            description: 'Specific permission to create new orders — submit orders with full details ' +
+                'including line items, customer, addresses, and payment info.',
+            use_cases: [
+                'POS systems creating in-store orders',
+                'Marketplace sync apps importing orders',
+                'B2B platforms creating wholesale orders',
+                'Subscription apps generating recurring orders',
+            ],
+            commonly_paired_with: ['read_orders', 'read_products', 'read_customers'],
+        },
+        {
+            id: 'fa1143a9-619d-4975-a031-6701e4b00ce7',
+            code: 'order-update',
+            label: 'Order update',
+            resource: 'orders',
+            createdAt: '2026-02-12T12:54:31.203Z',
+            description: 'Specific permission to update existing orders — modify order fields like ' +
+                'email, phone, notes, tags, status, addresses, and line items.',
+            use_cases: [
+                'Order editing tools for customer support',
+                'Automated tagging and categorization',
+                'Address correction workflows',
+                'Order status update integrations',
+            ],
+            commonly_paired_with: ['read_orders'],
+        },
+    ],
+    products: [
+        {
+            id: '6ed56a65-fad1-44b0-8faa-f26f7b420f93',
+            code: 'read_products',
+            label: 'Read Products',
+            resource: 'products',
+            createdAt: '2026-02-01T12:21:12.348Z',
+            description: 'View product catalog — list products with filtering (status, vendor, tags, category, collection), ' +
+                'get product details including variants, images, pricing, inventory tracking, and SEO metadata. ' +
+                'Essential for any app that needs to reference what the merchant sells.',
+            use_cases: [
+                'Display product catalogs and listings',
+                'Sync products to external marketplaces',
+                'Analyze product performance alongside orders',
+                'Build product recommendation engines',
+                'SEO audit tools that review product metadata',
+            ],
+            commonly_paired_with: ['read_orders', 'read_inventory'],
+        },
+        {
+            id: '0a7be257-d312-429e-9e94-9b8be04f0a25',
+            code: 'write_products',
+            label: 'Write Products',
+            resource: 'products',
+            createdAt: '2026-02-12T08:46:41.885Z',
+            description: 'Create and update products — add new products with full details (title, description, pricing, ' +
+                'variants, SEO, categories, collections, tags), and update any product field. ' +
+                'Includes all read_products permissions automatically.',
+            use_cases: [
+                'Bulk product import from suppliers or spreadsheets',
+                'Marketplace sync (two-way product updates)',
+                'Automated price optimization',
+                'Product content generation and SEO improvement',
+                'Catalog management tools',
+            ],
+            commonly_paired_with: ['read_orders', 'write_inventory'],
+        },
+        {
+            id: 'a7f8f95e-1884-4f5e-bc21-be52586b1564',
+            code: 'delete_products',
+            label: 'Delete Products',
+            resource: 'products',
+            createdAt: '2026-02-01T12:21:12.749Z',
+            description: 'Permanently delete products from the store. This is a destructive action. ' +
+                'Includes all write_products and read_products permissions automatically.',
+            use_cases: [
+                'Catalog cleanup tools that remove discontinued items',
+                'Sync tools that need to mirror deletions from external systems',
+                'Bulk product management with full lifecycle control',
+            ],
+            commonly_paired_with: ['write_products'],
+        },
+    ],
+    customers: [
+        {
+            id: '1f6e9370-96f7-4af6-ad4d-bb65ec26677f',
+            code: 'read_customers',
+            label: 'Read Customers',
+            resource: 'customers',
+            createdAt: '2026-02-01T12:21:13.548Z',
+            description: 'View customer profiles — access contact info (email, phone), addresses, ' +
+                'and associated order history. Needed for personalization, marketing, and support apps.',
+            use_cases: [
+                'Customer analytics and segmentation',
+                'Email/SMS marketing targeting',
+                'CRM integrations',
+                'Loyalty program member lookups',
+                'Customer support tools',
+            ],
+            commonly_paired_with: ['read_orders', 'read_analytics'],
+        },
+        {
+            id: '8389df02-33a8-4037-b9e0-2577f6187d3f',
+            code: 'write_customers',
+            label: 'Write Customers',
+            resource: 'customers',
+            createdAt: '2026-02-01T12:21:13.749Z',
+            description: 'Create and update customer profiles — add new customers, update contact info and addresses. ' +
+                'Includes all read_customers permissions automatically.',
+            use_cases: [
+                'CRM sync (import customers from external systems)',
+                'Customer data enrichment',
+                'Loyalty program enrollment',
+                'POS customer creation',
+            ],
+            commonly_paired_with: ['read_orders', 'write_orders'],
+        },
+        {
+            id: 'f635340b-3d1e-4377-b591-b8487021b314',
+            code: 'delete_customers',
+            label: 'Delete Customers',
+            resource: 'customers',
+            createdAt: '2026-02-01T12:21:13.948Z',
+            description: 'Delete customer records. Destructive action — use with caution. ' +
+                'Includes all write_customers and read_customers permissions.',
+            use_cases: [
+                'GDPR/data privacy compliance tools',
+                'Customer data cleanup',
+            ],
+            commonly_paired_with: ['write_customers'],
+        },
+    ],
+    inventory: [
+        {
+            id: '9a1b34af-2974-4e09-a855-4d444a914169',
+            code: 'read_inventory',
+            label: 'Read Inventory',
+            resource: 'inventory',
+            createdAt: '2026-02-01T12:21:14.198Z',
+            description: 'View inventory levels — check stock quantities across locations, see reorder points, ' +
+                'and monitor availability. Essential for any app that needs to know if products are in stock.',
+            use_cases: [
+                'Low-stock alert systems',
+                'Inventory dashboards and reporting',
+                'Product availability checks for external channels',
+                'Demand forecasting based on stock levels',
+                'Warehouse management visibility',
+            ],
+            commonly_paired_with: ['read_products', 'read_orders'],
+        },
+        {
+            id: '30575c53-aa12-498e-8c76-4e8b5ae9f633',
+            code: 'write_inventory',
+            label: 'Write Inventory',
+            resource: 'inventory',
+            createdAt: '2026-02-12T08:46:29.910Z',
+            description: 'Update stock levels — adjust quantities, set inventory at locations, manage restocking. ' +
+                'Includes all read_inventory permissions automatically.',
+            use_cases: [
+                'Inventory sync with warehouses or ERP systems',
+                'Automatic restocking when orders are cancelled',
+                'Multi-location stock transfers',
+                'Supplier integration for stock updates',
+            ],
+            commonly_paired_with: ['read_products', 'write_orders'],
+        },
+        {
+            id: 'aac7fb27-4df1-4331-a8b9-5f51ffab0623',
+            code: 'delete_inventory',
+            label: 'Delete Inventory',
+            resource: 'inventory',
+            createdAt: '2026-02-01T12:21:14.598Z',
+            description: 'Delete inventory records. Includes all write_inventory and read_inventory permissions.',
+            use_cases: [
+                'Inventory cleanup tools',
+                'Location decommissioning workflows',
+            ],
+            commonly_paired_with: ['write_inventory'],
+        },
+    ],
+    discounts: [
+        {
+            id: '2c14f243-75b1-4a16-85ce-ba4608ff78bc',
+            code: 'read_discounts',
+            label: 'Read Discounts',
+            resource: 'discounts',
+            createdAt: '2026-02-12T08:46:25.745Z',
+            description: 'View discount rules and campaigns — see active promotions, coupon codes, ' +
+                'eligibility conditions, usage stats, and discount values (percentage or fixed amount).',
+            use_cases: [
+                'Discount analytics and performance tracking',
+                'Display active promotions on external channels',
+                'Validate coupon codes before applying',
+                'Marketing campaign reporting',
+            ],
+            commonly_paired_with: ['read_orders', 'read_products'],
+        },
+        {
+            id: '6207720c-3954-447d-a4ed-69b90b43cc8a',
+            code: 'write_discounts',
+            label: 'Write Discounts',
+            resource: 'discounts',
+            createdAt: '2026-02-12T08:46:25.470Z',
+            description: 'Create and update discounts — build promotional campaigns, generate coupon codes, ' +
+                'set eligibility rules (min purchase, specific products/collections, customer segments). ' +
+                'Includes all read_discounts permissions automatically.',
+            use_cases: [
+                'Promotional campaign management tools',
+                'Automated discount creation (flash sales, seasonal)',
+                'Loyalty reward generation',
+                'Bundle pricing and volume discount engines',
+                'Cart abandonment recovery with auto-generated coupons',
+            ],
+            commonly_paired_with: ['read_orders', 'read_products', 'read_customers'],
+        },
+        {
+            id: 'cd09bd6e-b186-4637-ba21-99e376230cba',
+            code: 'delete_discounts',
+            label: 'Delete Discounts',
+            resource: 'discounts',
+            createdAt: '2026-02-01T12:21:16.528Z',
+            description: 'Delete discount rules and campaigns. Includes all write_discounts and read_discounts permissions.',
+            use_cases: [
+                'Cleanup expired promotions automatically',
+                'Campaign lifecycle management',
+            ],
+            commonly_paired_with: ['write_discounts'],
+        },
+    ],
+    payments: [
+        {
+            id: 'a7bc79b5-8003-465a-ab3b-1ff49ddc7748',
+            code: 'read_payments',
+            label: 'Read Payments',
+            resource: 'payments',
+            createdAt: '2026-02-01T12:21:14.988Z',
+            description: 'View payment transactions — see payment status, gateway details, and transaction history for orders.',
+            use_cases: [
+                'Financial reporting and reconciliation',
+                'Payment status dashboards',
+                'Accounting tool integrations',
+            ],
+            commonly_paired_with: ['read_orders'],
+        },
+        {
+            id: 'b48d4b6a-3998-4cfa-babd-96226c14c24b',
+            code: 'write_payments',
+            label: 'Write Payments',
+            resource: 'payments',
+            createdAt: '2026-02-01T12:21:15.188Z',
+            description: 'Process payments and refunds. Includes read_payments permissions.',
+            use_cases: [
+                'Payment gateway integrations',
+                'Refund processing tools',
+                'Automated payment capture',
+            ],
+            commonly_paired_with: ['write_orders', 'read_orders'],
+        },
+        {
+            id: '47a7d9df-18a0-40e4-a596-8aec7f4c93c8',
+            code: 'delete_payments',
+            label: 'Delete Payments',
+            resource: 'payments',
+            createdAt: '2026-02-01T12:21:15.388Z',
+            description: 'Delete payment records. Includes all payment permissions.',
+            use_cases: ['Payment record cleanup'],
+            commonly_paired_with: ['write_payments'],
+        },
+    ],
+    shipping: [
+        {
+            id: '5647544a-8cc1-41e0-9717-a8bebade010a',
+            code: 'read_shipping',
+            label: 'Read Shipping',
+            resource: 'shipping',
+            createdAt: '2026-02-01T12:21:15.588Z',
+            description: 'View shipping rates, zones, and carrier configurations.',
+            use_cases: ['Shipping rate display', 'Carrier comparison tools', 'Delivery estimation'],
+            commonly_paired_with: ['read_orders', 'read_fulfillments'],
+        },
+        {
+            id: 'b0aa2cca-8377-42b2-ae40-f3ae45fe995b',
+            code: 'write_shipping',
+            label: 'Write Shipping',
+            resource: 'shipping',
+            createdAt: '2026-02-01T12:21:15.769Z',
+            description: 'Create and update shipping rates and configurations. Includes read_shipping.',
+            use_cases: ['Carrier integration setup', 'Dynamic shipping rate engines'],
+            commonly_paired_with: ['write_orders', 'write_fulfillments'],
+        },
+        {
+            id: '5b3ad1c9-a610-4c85-9ad4-8723132f855f',
+            code: 'delete_shipping',
+            label: 'Delete Shipping',
+            resource: 'shipping',
+            createdAt: '2026-02-01T12:21:15.925Z',
+            description: 'Delete shipping configurations. Includes all shipping permissions.',
+            use_cases: ['Shipping config cleanup'],
+            commonly_paired_with: ['write_shipping'],
+        },
+    ],
+    fulfillments: [
+        {
+            id: '6032bfc2-63ea-46b8-939f-713127f2887c',
+            code: 'read_fulfillments',
+            label: 'Read Fulfillments',
+            resource: 'fulfillments',
+            createdAt: '2026-02-12T08:46:28.272Z',
+            description: 'View fulfillment details — tracking numbers, shipment status, and fulfillment history.',
+            use_cases: ['Shipment tracking dashboards', 'Fulfillment analytics', 'Customer delivery notifications'],
+            commonly_paired_with: ['read_orders', 'read_shipping'],
+        },
+        {
+            id: 'c778ad47-744b-4486-91fb-305c81e55069',
+            code: 'write_fulfillments',
+            label: 'Write Fulfillments',
+            resource: 'fulfillments',
+            createdAt: '2026-02-12T08:46:28.030Z',
+            description: 'Create and update fulfillments — mark orders as fulfilled, add tracking info. Includes read_fulfillments.',
+            use_cases: ['Fulfillment automation', 'Warehouse management systems', 'Dropshipping integrations'],
+            commonly_paired_with: ['write_orders', 'read_inventory'],
+        },
+    ],
+    draft_orders: [
+        {
+            id: '7fc8e283-ff75-45d8-9c0e-dd216820c659',
+            code: 'read_draft_orders',
+            label: 'Read Draft Orders',
+            resource: 'draft_orders',
+            createdAt: '2026-02-12T08:46:27.120Z',
+            description: 'View draft/preliminary orders — orders not yet finalized, useful for B2B and quoting workflows.',
+            use_cases: ['Draft order dashboards', 'Quote management', 'B2B order review'],
+            commonly_paired_with: ['read_orders', 'read_products'],
+        },
+        {
+            id: '61bb98e5-543b-43c1-b29f-bb42aa612569',
+            code: 'write_draft_orders',
+            label: 'Write Draft Orders',
+            resource: 'draft_orders',
+            createdAt: '2026-02-12T08:46:26.760Z',
+            description: 'Create and update draft orders. Includes read_draft_orders.',
+            use_cases: ['B2B quoting tools', 'Custom order creation workflows', 'POS draft creation'],
+            commonly_paired_with: ['write_orders', 'read_products', 'read_customers'],
+        },
+    ],
+    returns: [
+        {
+            id: 'b241cad0-c7fb-42c3-8817-be5a855c66f8',
+            code: 'read_returns',
+            label: 'Read Returns',
+            resource: 'returns',
+            createdAt: '2026-02-12T08:46:45.510Z',
+            description: 'View return requests and their status — track what customers want to return and why.',
+            use_cases: ['Returns dashboard', 'Return rate analytics', 'Customer support lookups'],
+            commonly_paired_with: ['read_orders', 'read_payments'],
+        },
+        {
+            id: 'ca27e565-7727-4c08-a4e1-967f579c268d',
+            code: 'write_returns',
+            label: 'Write Returns',
+            resource: 'returns',
+            createdAt: '2026-02-12T08:46:45.127Z',
+            description: 'Process return requests — approve, reject, and manage return workflows. Includes read_returns.',
+            use_cases: ['Returns management portals', 'Automated return approval', 'Exchange workflows'],
+            commonly_paired_with: ['write_orders', 'write_payments', 'write_inventory'],
+        },
+    ],
+    gift_cards: [
+        {
+            id: 'd48db2ee-e1e3-4c4a-aedc-890ef324d89a',
+            code: 'read_gift_cards',
+            label: 'Read Gift Cards',
+            resource: 'gift_cards',
+            createdAt: '2026-02-12T08:46:29.595Z',
+            description: 'View gift cards — check balances, see issued cards, and track redemptions.',
+            use_cases: ['Gift card balance lookups', 'Gift card analytics'],
+            commonly_paired_with: ['read_orders', 'read_customers'],
+        },
+        {
+            id: 'dbd0bd71-f7e3-41f6-9084-f78bf7867724',
+            code: 'write_gift_cards',
+            label: 'Write Gift Cards',
+            resource: 'gift_cards',
+            createdAt: '2026-02-12T08:46:29.295Z',
+            description: 'Issue and manage gift cards — create new cards, adjust balances. Includes read_gift_cards.',
+            use_cases: ['Gift card issuance platforms', 'Loyalty reward distribution', 'Corporate gifting tools'],
+            commonly_paired_with: ['read_customers', 'read_orders'],
+        },
+    ],
+    analytics: [
+        {
+            id: '79ef776f-d3da-4ef2-9f0b-88b034476bbd',
+            code: 'read_analytics',
+            label: 'Read Analytics',
+            resource: 'analytics',
+            createdAt: '2026-02-01T12:21:14.798Z',
+            description: 'Access store analytics — aggregated sales data, traffic metrics, conversion rates, ' +
+                'and business performance insights.',
+            use_cases: [
+                'Business intelligence dashboards',
+                'Performance reporting tools',
+                'Revenue tracking and forecasting',
+                'Marketing attribution analysis',
+            ],
+            commonly_paired_with: ['read_orders', 'read_products', 'read_customers'],
+        },
+    ],
+    channels: [
+        {
+            id: '1444cdcc-8179-4324-a04f-bc037baf2adb',
+            code: 'read_channels',
+            label: 'Read Channels',
+            resource: 'channels',
+            createdAt: '2026-02-12T08:46:46.140Z',
+            description: 'View sales channels configured for the store.',
+            use_cases: ['Multi-channel dashboards', 'Channel performance comparison'],
+            commonly_paired_with: ['read_products', 'read_publications'],
+        },
+        {
+            id: 'a2557094-db43-42bf-b6df-4c04c86e3f72',
+            code: 'write_channels',
+            label: 'Write Channels',
+            resource: 'channels',
+            createdAt: '2026-02-12T08:46:45.800Z',
+            description: 'Create and configure sales channels. Includes read_channels.',
+            use_cases: ['Marketplace integration setup', 'Social commerce channel creation'],
+            commonly_paired_with: ['write_products', 'write_publications'],
+        },
+    ],
+    content: [
+        {
+            id: 'f86e34f0-d00c-46b5-b6bf-ebe5b60f5266',
+            code: 'read_content',
+            label: 'Read Content',
+            resource: 'content',
+            createdAt: '2026-02-12T08:46:51.255Z',
+            description: 'View store content — pages, blog posts, and media content.',
+            use_cases: ['Content audit tools', 'SEO analysis', 'Content migration'],
+            commonly_paired_with: ['read_themes', 'read_files'],
+        },
+        {
+            id: '7a27a369-408e-410a-8b17-f374eac4cdf8',
+            code: 'write_content',
+            label: 'Write Content',
+            resource: 'content',
+            createdAt: '2026-02-12T08:46:50.905Z',
+            description: 'Create and update store content. Includes read_content.',
+            use_cases: ['CMS integrations', 'AI content generation', 'Blog management tools'],
+            commonly_paired_with: ['write_files', 'write_themes'],
+        },
+    ],
+    files: [
+        {
+            id: '4f231a25-92fa-4ad6-b718-9061b922087a',
+            code: 'read_files',
+            label: 'Read Files',
+            resource: 'files',
+            createdAt: '2026-02-12T08:46:27.780Z',
+            description: 'View and download files — images, documents, and media assets.',
+            use_cases: ['Asset management dashboards', 'Image optimization analysis'],
+            commonly_paired_with: ['read_products', 'read_content'],
+        },
+        {
+            id: '823abdce-dd71-474e-9cd2-637ff4e978dd',
+            code: 'write_files',
+            label: 'Write Files',
+            resource: 'files',
+            createdAt: '2026-02-12T08:46:27.440Z',
+            description: 'Upload and manage files. Includes read_files.',
+            use_cases: ['Bulk image upload tools', 'Asset management with editing'],
+            commonly_paired_with: ['write_products', 'write_content'],
+        },
+    ],
+    locations: [
+        {
+            id: 'c6e7e99c-b92d-4505-85c6-c5ede28fd2ad',
+            code: 'read_locations',
+            label: 'Read Locations',
+            resource: 'locations',
+            createdAt: '2026-02-12T08:46:31.545Z',
+            description: 'View store locations and warehouses — addresses, hours, and inventory assignments.',
+            use_cases: ['Store locator features', 'Multi-location inventory visibility'],
+            commonly_paired_with: ['read_inventory', 'read_shipping'],
+        },
+        {
+            id: '2e1b5c94-32d1-49a3-bc3b-b1a85cd1b888',
+            code: 'write_locations',
+            label: 'Write Locations',
+            resource: 'locations',
+            createdAt: '2026-02-12T08:46:31.255Z',
+            description: 'Create and update locations. Includes read_locations.',
+            use_cases: ['Multi-location management tools', 'Warehouse setup automation'],
+            commonly_paired_with: ['write_inventory'],
+        },
+    ],
+    themes: [
+        {
+            id: 'a78d0d9b-0de9-4a26-ae80-77d189810a43',
+            code: 'read_themes',
+            label: 'Read Themes',
+            resource: 'themes',
+            createdAt: '2026-02-12T08:46:52.995Z',
+            description: 'View storefront themes and templates.',
+            use_cases: ['Theme analysis', 'Design audit tools'],
+            commonly_paired_with: ['read_content'],
+        },
+        {
+            id: '5e390a72-c9f8-447f-8d3c-7504d19c4c03',
+            code: 'write_themes',
+            label: 'Write Themes',
+            resource: 'themes',
+            createdAt: '2026-02-12T08:46:52.665Z',
+            description: 'Create and modify themes. Includes read_themes.',
+            use_cases: ['Theme builders', 'A/B testing tools', 'Page builders'],
+            commonly_paired_with: ['write_content', 'write_files'],
+        },
+    ],
+    markets: [
+        {
+            id: '4e301e82-0b94-46b9-8c1c-2f0e959339fe',
+            code: 'read_markets',
+            label: 'Read Markets',
+            resource: 'markets',
+            createdAt: '2026-02-12T08:46:48.800Z',
+            description: 'View market configurations — multi-currency and regional selling settings.',
+            use_cases: ['International expansion dashboards', 'Market performance comparison'],
+            commonly_paired_with: ['read_locales', 'read_products'],
+        },
+        {
+            id: '1c3e1143-f01d-46ea-9163-506e819e889d',
+            code: 'write_markets',
+            label: 'Write Markets',
+            resource: 'markets',
+            createdAt: '2026-02-12T08:46:48.400Z',
+            description: 'Create and configure markets. Includes read_markets.',
+            use_cases: ['International expansion tools', 'Market configuration automation'],
+            commonly_paired_with: ['write_locales', 'write_products'],
+        },
+    ],
+    reports: [
+        {
+            id: 'cdd7d0a6-e144-45d8-948f-56f949c53faa',
+            code: 'read_reports',
+            label: 'Read Reports',
+            resource: 'reports',
+            createdAt: '2026-02-12T08:46:44.190Z',
+            description: 'Access and generate custom reports on sales, inventory, customers.',
+            use_cases: ['Custom reporting dashboards', 'Data export tools', 'Financial reports'],
+            commonly_paired_with: ['read_analytics', 'read_orders'],
+        },
+        {
+            id: '23016fc4-e7d0-4cda-8bf6-d9c7e7a5fb52',
+            code: 'write_reports',
+            label: 'Write Reports',
+            resource: 'reports',
+            createdAt: '2026-02-12T08:46:43.880Z',
+            description: 'Create and schedule custom reports. Includes read_reports.',
+            use_cases: ['Automated report generation', 'Scheduled data exports'],
+            commonly_paired_with: ['read_orders', 'read_products'],
+        },
+    ],
+    locales: [
+        {
+            id: 'e9d07b59-2757-44a9-ade1-c08e07f694a9',
+            code: 'read_locales',
+            label: 'Read Locales',
+            resource: 'locales',
+            createdAt: '2026-02-12T08:46:48.095Z',
+            description: 'View language and locale settings for multi-language stores.',
+            use_cases: ['Translation management', 'Locale-aware content display'],
+            commonly_paired_with: ['read_markets', 'read_content'],
+        },
+        {
+            id: 'cd12d037-5a42-4434-9761-b1af076c6852',
+            code: 'write_locales',
+            label: 'Write Locales',
+            resource: 'locales',
+            createdAt: '2026-02-12T08:46:47.785Z',
+            description: 'Create and manage locale settings. Includes read_locales.',
+            use_cases: ['Translation management tools', 'Auto-translation services'],
+            commonly_paired_with: ['write_markets', 'write_content'],
+        },
+    ],
+    publications: [
+        {
+            id: '54fa765c-00ce-4db7-b420-19e534181ed8',
+            code: 'read_publications',
+            label: 'Read Publications',
+            resource: 'publications',
+            createdAt: '2026-02-12T08:46:42.885Z',
+            description: 'View product publication status — which products are visible on which channels.',
+            use_cases: ['Channel visibility dashboards', 'Product syndication tools'],
+            commonly_paired_with: ['read_products', 'read_channels'],
+        },
+        {
+            id: '6824a934-6b0a-42c0-a1c4-b9a46f6b5c6c',
+            code: 'write_publications',
+            label: 'Write Publications',
+            resource: 'publications',
+            createdAt: '2026-02-12T08:46:42.575Z',
+            description: 'Control product visibility on channels. Includes read_publications.',
+            use_cases: ['Bulk publish/unpublish tools', 'Channel management automation'],
+            commonly_paired_with: ['write_products', 'write_channels'],
+        },
+    ],
+    settings: [
+        {
+            id: 'e2468aea-a218-404d-b80b-e16c27ce215a',
+            code: 'read_settings',
+            label: 'Read Settings',
+            resource: 'settings',
+            createdAt: '2026-02-01T12:21:17.478Z',
+            description: 'View store-wide settings — checkout, tax, notification, and general configurations.',
+            use_cases: ['Store audit tools', 'Configuration backup'],
+            commonly_paired_with: [],
+        },
+        {
+            id: '5af4403a-7193-4c34-8767-995ff75df69e',
+            code: 'write_settings',
+            label: 'Write Settings',
+            resource: 'settings',
+            createdAt: '2026-02-01T12:21:17.678Z',
+            description: 'Modify store settings. Includes read_settings.',
+            use_cases: ['Store setup automation', 'Configuration management tools'],
+            commonly_paired_with: [],
+        },
+        {
+            id: '9f77b645-ab8b-4d16-86be-c893927e08d0',
+            code: 'delete_settings',
+            label: 'Delete Settings',
+            resource: 'settings',
+            createdAt: '2026-02-01T12:21:17.878Z',
+            description: 'Delete store settings. Includes all settings permissions.',
+            use_cases: ['Configuration reset tools'],
+            commonly_paired_with: ['write_settings'],
+        },
+    ],
+    webhooks: [
+        {
+            id: 'b53a6288-8c27-4ee6-89de-c3ab0cbf45da',
+            code: 'read_webhooks',
+            label: 'Read Webhooks',
+            resource: 'webhooks',
+            createdAt: '2026-02-01T12:21:16.738Z',
+            description: 'View webhook subscriptions — see which events the app is listening to.',
+            use_cases: ['Webhook management dashboards', 'Integration health monitoring'],
+            commonly_paired_with: ['read_orders', 'read_products'],
+        },
+        {
+            id: '702ae668-59b6-48c2-9a92-92c39fbb63c8',
+            code: 'write_webhooks',
+            label: 'Write Webhooks',
+            resource: 'webhooks',
+            createdAt: '2026-02-01T12:21:17.139Z',
+            description: 'Create and manage webhook subscriptions — register URLs for real-time event notifications. Includes read_webhooks.',
+            use_cases: [
+                'Register for order/product/app events',
+                'Integration setup automation',
+                'Real-time sync with external systems',
+            ],
+            commonly_paired_with: ['read_orders', 'read_products'],
+        },
+        {
+            id: '64e22053-7dee-4417-816a-5e78ac954e3d',
+            code: 'delete_webhooks',
+            label: 'Delete Webhooks',
+            resource: 'webhooks',
+            createdAt: '2026-02-01T12:21:17.280Z',
+            description: 'Delete webhook subscriptions. Includes all webhooks permissions.',
+            use_cases: ['Webhook cleanup during app uninstall'],
+            commonly_paired_with: ['write_webhooks'],
+        },
+    ],
+    apps: [
+        {
+            id: '9bca0790-64e0-48e3-af0a-4b94ebc42bff',
+            code: 'read_apps',
+            label: 'Read Apps',
+            resource: 'apps',
+            createdAt: '2026-02-12T08:46:22.240Z',
+            description: 'View installed apps on the merchant\'s store.',
+            use_cases: ['Integration platform dashboards', 'App compatibility checks'],
+            commonly_paired_with: [],
+        },
+    ],
+};
+/**
+ * Flat set of all valid scope codes for quick validation.
+ */
+export const ALL_SCOPE_CODES = new Set(Object.values(SCOPES_BY_RESOURCE).flatMap((scopes) => scopes.map((s) => s.code)));
+/**
+ * Look up which resource a scope code belongs to.
+ */
+export function getResourceForScope(code) {
+    for (const [resource, scopes] of Object.entries(SCOPES_BY_RESOURCE)) {
+        if (scopes.some((s) => s.code === code)) {
+            return resource;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=scopes-data.js.map