@ratio-mcp/shared 1.3.6 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,1067 +1,453 @@
1
1
  /**
2
- * Static scopes data — sourced from GET /api/v1/scopes
3
- * Enriched with LLM-friendly descriptions, use_cases, and pairing hints
4
- * so the LLM can intelligently suggest scopes based on app descriptions.
2
+ * Static scopes data — sourced from GET /api/v1/scopes (real platform data).
3
+ * Contains all 147 scopes across 78 resources exactly as they exist in the platform.
5
4
  *
6
- * To refresh base data: fetch from ${RATIO_API_BASE_URL}/api/v1/scopes
5
+ * To refresh: fetch from the scopes API and regenerate this file.
7
6
  *
8
- * Last updated: 2026-03-18
7
+ * Last updated: 2026-04-08
9
8
  */
10
9
  // ─── Primary Resources ─────────────────────────────────────────
10
+ // These are the most commonly used resources that developers will typically need.
11
+ // The full list of all 78 resources is in SCOPES_BY_RESOURCE below.
11
12
  export const PRIMARY_RESOURCES = [
12
- 'orders',
13
- 'products',
14
- 'customers',
15
- 'inventory',
16
- 'discounts',
17
- 'payments',
18
- 'shipping',
19
- 'fulfillments',
20
- 'draft_orders',
21
- 'returns',
22
- 'gift_cards',
23
- 'analytics',
24
- 'channels',
25
- 'content',
26
- 'files',
27
- 'locations',
28
- 'themes',
29
- 'markets',
30
- 'reports',
31
- 'locales',
32
- 'publications',
33
- 'settings',
34
- 'webhooks',
35
- 'apps',
13
+ 'orders', 'products', 'customers', 'inventory', 'discounts', 'fulfillments', 'draft_orders', 'returns', 'shipping', 'gift_cards', 'analytics', 'channels', 'content', 'files', 'locations', 'themes', 'markets', 'reports', 'locales', 'publications', 'apps',
36
14
  ];
37
15
  // ─── Resource Metadata ──────────────────────────────────────────
38
- // Tells the LLM what each resource is about, whether codegen works,
39
- // and which resources are commonly needed together.
16
+ // Rich descriptions for keyword matching in gather_requirements.
17
+ // Only primary resources have detailed metadata; others are matched by resource name.
40
18
  export const RESOURCE_METADATA = {
41
19
  orders: {
42
- description: 'Merchant orders — includes line items, pricing, customer info, payment status, ' +
43
- 'fulfillment status, shipping/billing addresses, and order lifecycle events. ' +
44
- 'This is the core transactional data for any e-commerce store.',
20
+ description: 'Merchant orders — line items, pricing, customer info, payment and fulfillment status, addresses.',
45
21
  codegen_ready: true,
46
22
  commonly_needed_with: ['products', 'customers', 'inventory'],
47
- example_app_types: [
48
- 'Order analytics & reporting',
49
- 'Order management & fulfillment',
50
- 'Fraud detection',
51
- 'Shipping & logistics',
52
- 'Accounting & invoicing',
53
- 'Customer support tools',
54
- ],
23
+ example_app_types: ['Order analytics', 'Order management', 'Fraud detection', 'Shipping & logistics', 'Accounting'],
55
24
  },
56
25
  products: {
57
- description: 'Product catalog — includes titles, descriptions, pricing (in paise), variants, ' +
58
- 'images, inventory tracking, SEO metadata, categories, collections, and tags. ' +
59
- 'This is the merchandise data that powers the storefront.',
26
+ description: 'Product catalog — titles, descriptions, pricing, variants, images, inventory tracking, SEO metadata.',
60
27
  codegen_ready: true,
61
- commonly_needed_with: ['inventory', 'orders', 'categories'],
62
- example_app_types: [
63
- 'Product catalog sync',
64
- 'Price comparison & optimization',
65
- 'SEO & content optimization',
66
- 'Marketplace integrations',
67
- 'Product recommendations',
68
- 'Bulk product management',
69
- ],
28
+ commonly_needed_with: ['inventory', 'orders'],
29
+ example_app_types: ['Product catalog sync', 'Price optimization', 'SEO tools', 'Marketplace integrations'],
70
30
  },
71
31
  customers: {
72
- description: 'Customer profiles — includes contact info (email, phone), addresses, ' +
73
- 'order history associations, and customer segmentation data. ' +
74
- 'Essential for any app that personalizes experiences or targets specific audiences.',
32
+ description: 'Customer profiles — contact info, addresses, order history, segmentation.',
75
33
  codegen_ready: false,
76
34
  commonly_needed_with: ['orders', 'analytics'],
77
- example_app_types: [
78
- 'CRM & customer management',
79
- 'Email/SMS marketing',
80
- 'Loyalty & rewards programs',
81
- 'Customer analytics & segmentation',
82
- 'Personalization engines',
83
- ],
35
+ example_app_types: ['CRM', 'Email/SMS marketing', 'Loyalty programs', 'Customer analytics'],
84
36
  },
85
37
  inventory: {
86
- description: 'Stock levels and inventory management — track quantities across locations, ' +
87
- 'set reorder points, manage warehouse stock. Critical for apps that need to ' +
88
- 'know product availability or manage supply chain.',
38
+ description: 'Stock levels and inventory management — quantities across locations, reorder points.',
89
39
  codegen_ready: false,
90
40
  commonly_needed_with: ['products', 'orders', 'locations'],
91
- example_app_types: [
92
- 'Inventory management & sync',
93
- 'Low-stock alerts',
94
- 'Warehouse management',
95
- 'Demand forecasting',
96
- 'Multi-location inventory',
97
- ],
41
+ example_app_types: ['Inventory sync', 'Low-stock alerts', 'Warehouse management'],
98
42
  },
99
43
  discounts: {
100
- description: 'Discount rules and promotional campaigns create percentage or fixed-amount ' +
101
- 'discounts, set eligibility conditions (minimum purchase, specific products/collections), ' +
102
- 'manage coupon codes, and track discount usage.',
44
+ description: 'Discount rules and promotions — percentage or fixed discounts, coupon codes, eligibility conditions.',
103
45
  codegen_ready: false,
104
46
  commonly_needed_with: ['orders', 'products', 'customers'],
105
- example_app_types: [
106
- 'Discount & coupon management',
107
- 'Promotional campaigns',
108
- 'Bundle & volume pricing',
109
- 'Loyalty discounts',
110
- 'Cart abandonment recovery',
111
- ],
112
- },
113
- payments: {
114
- description: 'Payment transactions — view payment status, process refunds, and track ' +
115
- 'payment gateway interactions. Covers the financial side of order processing.',
116
- codegen_ready: false,
117
- commonly_needed_with: ['orders', 'returns'],
118
- example_app_types: [
119
- 'Payment gateway integrations',
120
- 'Refund management',
121
- 'Financial reconciliation',
122
- 'Accounting tools',
123
- ],
124
- },
125
- shipping: {
126
- description: 'Shipping rates, methods, and carrier configurations — manage shipping zones, ' +
127
- 'calculate rates, and configure delivery options for the storefront.',
128
- codegen_ready: false,
129
- commonly_needed_with: ['orders', 'fulfillments', 'locations'],
130
- example_app_types: [
131
- 'Shipping rate calculators',
132
- 'Carrier integrations',
133
- 'Delivery estimation',
134
- 'Shipping label generators',
135
- ],
47
+ example_app_types: ['Coupon management', 'Promotional campaigns', 'Bundle pricing'],
136
48
  },
137
49
  fulfillments: {
138
- description: 'Order fulfillment tracking manage the process of picking, packing, and ' +
139
- 'shipping orders. Includes tracking numbers, fulfillment status, and shipment details.',
50
+ description: 'Order fulfillment — tracking numbers, shipment status, fulfillment history.',
140
51
  codegen_ready: false,
141
52
  commonly_needed_with: ['orders', 'shipping', 'inventory'],
142
- example_app_types: [
143
- 'Fulfillment automation',
144
- 'Warehouse management',
145
- 'Dropshipping tools',
146
- 'Shipment tracking',
147
- ],
53
+ example_app_types: ['Fulfillment automation', '3PL integrations', 'Tracking pages'],
148
54
  },
149
55
  draft_orders: {
150
- description: 'Draft/preliminary orders that haven\'t been finalized useful for B2B workflows, ' +
151
- 'custom quotes, or orders created on behalf of customers by staff.',
56
+ description: 'Draft/preliminary orders orders not yet finalized, useful for B2B and quoting.',
152
57
  codegen_ready: false,
153
- commonly_needed_with: ['orders', 'products', 'customers'],
154
- example_app_types: [
155
- 'B2B ordering tools',
156
- 'Custom quote generators',
157
- 'POS integrations',
158
- 'Wholesale platforms',
159
- ],
58
+ commonly_needed_with: ['orders', 'customers'],
59
+ example_app_types: ['B2B order management', 'Quoting tools', 'POS systems'],
160
60
  },
161
61
  returns: {
162
- description: 'Return and exchange management process return requests, track return shipments, ' +
163
- 'manage refunds, and handle exchange workflows.',
62
+ description: 'Return requests and statustrack what customers want to return and why.',
164
63
  codegen_ready: false,
165
- commonly_needed_with: ['orders', 'payments', 'inventory'],
166
- example_app_types: [
167
- 'Returns management portals',
168
- 'Exchange automation',
169
- 'Refund processing',
170
- 'RMA tracking',
171
- ],
64
+ commonly_needed_with: ['orders', 'inventory'],
65
+ example_app_types: ['Return management', 'Exchange tools', 'Customer support'],
66
+ },
67
+ shipping: {
68
+ description: 'Shipping rates, zones, and carrier configurations.',
69
+ codegen_ready: false,
70
+ commonly_needed_with: ['orders', 'fulfillments', 'locations'],
71
+ example_app_types: ['Shipping rate calculators', 'Carrier integrations', 'Label generators'],
172
72
  },
173
73
  gift_cards: {
174
- description: 'Gift card creation and management issue digital gift cards, track balances, ' +
175
- 'and handle redemptions.',
74
+ description: 'Gift cardsbalances, issued cards, redemptions.',
176
75
  codegen_ready: false,
177
76
  commonly_needed_with: ['orders', 'customers'],
178
- example_app_types: [
179
- 'Gift card platforms',
180
- 'Loyalty programs',
181
- 'Corporate gifting',
182
- ],
77
+ example_app_types: ['Gift card management', 'Loyalty programs'],
183
78
  },
184
79
  analytics: {
185
- description: 'Store analytics and metrics access aggregated data on sales, traffic, ' +
186
- 'conversion rates, and business performance.',
80
+ description: 'Store analytics — aggregated sales data, traffic metrics, conversion rates.',
187
81
  codegen_ready: false,
188
- commonly_needed_with: ['orders', 'products', 'customers'],
189
- example_app_types: [
190
- 'Dashboard & reporting tools',
191
- 'Business intelligence',
192
- 'Performance monitoring',
193
- ],
82
+ commonly_needed_with: ['orders', 'customers'],
83
+ example_app_types: ['Analytics dashboards', 'Business intelligence', 'Performance monitoring'],
194
84
  },
195
85
  channels: {
196
- description: 'Sales channels — manage where products are sold (online store, social media, ' +
197
- 'marketplaces, POS).',
86
+ description: 'Sales channels — manage where products are published and sold.',
198
87
  codegen_ready: false,
199
88
  commonly_needed_with: ['products', 'publications'],
200
- example_app_types: [
201
- 'Multi-channel selling',
202
- 'Marketplace integrations',
203
- 'Social commerce',
204
- ],
89
+ example_app_types: ['Multi-channel selling', 'Marketplace sync'],
205
90
  },
206
91
  content: {
207
- description: 'Store content like pages, blog posts, and media — manage the non-product ' +
208
- 'content on the storefront.',
92
+ description: 'Store content pages, blog posts, and media.',
209
93
  codegen_ready: false,
210
- commonly_needed_with: ['themes', 'files'],
211
- example_app_types: [
212
- 'CMS integrations',
213
- 'Blog management',
214
- 'Content marketing',
215
- ],
94
+ commonly_needed_with: ['themes'],
95
+ example_app_types: ['CMS tools', 'Blog management', 'Content marketing'],
216
96
  },
217
97
  files: {
218
- description: 'File managementupload, organize, and serve images, documents, and other ' +
219
- 'media assets used across the store.',
98
+ description: 'Files and media — images, documents, assets.',
220
99
  codegen_ready: false,
221
100
  commonly_needed_with: ['products', 'content'],
222
- example_app_types: [
223
- 'Asset management',
224
- 'Image optimization',
225
- 'Bulk media upload',
226
- ],
101
+ example_app_types: ['Media management', 'Image optimization', 'Asset libraries'],
227
102
  },
228
103
  locations: {
229
- description: 'Physical store locations and warehouses — manage addresses, operating hours, ' +
230
- 'and inventory assignment per location.',
104
+ description: 'Store locations and warehouses — addresses, hours, inventory assignments.',
231
105
  codegen_ready: false,
232
- commonly_needed_with: ['inventory', 'shipping', 'fulfillments'],
233
- example_app_types: [
234
- 'Store locator',
235
- 'Multi-location management',
236
- 'Local delivery',
237
- ],
106
+ commonly_needed_with: ['inventory', 'fulfillments'],
107
+ example_app_types: ['Store locator', 'Multi-location inventory', 'Warehouse management'],
238
108
  },
239
109
  themes: {
240
- description: 'Storefront themes and templates — customize the look and feel of the ' +
241
- 'merchant\'s online store.',
110
+ description: 'Storefront themes and templates.',
242
111
  codegen_ready: false,
243
- commonly_needed_with: ['content', 'files'],
244
- example_app_types: [
245
- 'Theme customization',
246
- 'A/B testing',
247
- 'Page builders',
248
- ],
112
+ commonly_needed_with: ['content'],
113
+ example_app_types: ['Theme customization', 'Storefront builders'],
249
114
  },
250
115
  markets: {
251
- description: 'International marketsmanage multi-currency, multi-language, and ' +
252
- 'region-specific selling configurations.',
116
+ description: 'Market configurations — multi-currency and regional selling.',
253
117
  codegen_ready: false,
254
- commonly_needed_with: ['locales', 'products', 'shipping'],
255
- example_app_types: [
256
- 'International expansion',
257
- 'Currency conversion',
258
- 'Localization tools',
259
- ],
118
+ commonly_needed_with: ['locales', 'products'],
119
+ example_app_types: ['International selling', 'Currency conversion'],
260
120
  },
261
121
  reports: {
262
- description: 'Custom reports — generate and access detailed reports on sales, inventory, ' +
263
- 'customers, and other business metrics.',
122
+ description: 'Custom reports on sales, inventory, customers.',
264
123
  codegen_ready: false,
265
- commonly_needed_with: ['analytics', 'orders', 'products'],
266
- example_app_types: [
267
- 'Custom reporting',
268
- 'Data export tools',
269
- 'Financial reports',
270
- ],
124
+ commonly_needed_with: ['analytics', 'orders'],
125
+ example_app_types: ['Custom reporting', 'Data export'],
271
126
  },
272
127
  locales: {
273
- description: 'Language and locale settings manage translations and language-specific ' +
274
- 'content for multi-language stores.',
128
+ description: 'Language and locale settings for multi-language stores.',
275
129
  codegen_ready: false,
276
- commonly_needed_with: ['markets', 'content'],
277
- example_app_types: [
278
- 'Translation management',
279
- 'Multi-language stores',
280
- ],
130
+ commonly_needed_with: ['markets', 'translations'],
131
+ example_app_types: ['Translation tools', 'Multi-language support'],
281
132
  },
282
133
  publications: {
283
- description: 'Product publishing — control which products are visible on which sales ' +
284
- 'channels and markets.',
134
+ description: 'Publishing channels — control where products appear.',
285
135
  codegen_ready: false,
286
- commonly_needed_with: ['products', 'channels'],
287
- example_app_types: [
288
- 'Channel management',
289
- 'Product syndication',
290
- ],
291
- },
292
- settings: {
293
- description: 'Store-wide settings — access and modify global store configuration ' +
294
- 'like checkout settings, tax rules, and notification preferences.',
295
- codegen_ready: false,
296
- commonly_needed_with: [],
297
- example_app_types: [
298
- 'Store configuration tools',
299
- 'Tax management',
300
- 'Checkout customization',
301
- ],
302
- },
303
- webhooks: {
304
- description: 'Webhook subscriptions — register URLs to receive real-time notifications ' +
305
- 'when events occur (order created, product updated, app uninstalled, etc.).',
306
- codegen_ready: false,
307
- commonly_needed_with: ['orders', 'products'],
308
- example_app_types: [
309
- 'Any app that needs real-time event processing',
310
- 'Integration middleware',
311
- 'Automation platforms',
312
- ],
136
+ commonly_needed_with: ['channels', 'products'],
137
+ example_app_types: ['Channel management', 'Product syndication'],
313
138
  },
314
139
  apps: {
315
- description: 'App metadata — access information about installed apps on the merchant\'s store.',
140
+ description: 'Installed apps on the merchant store.',
316
141
  codegen_ready: false,
317
- commonly_needed_with: [],
318
- example_app_types: [
319
- 'App management dashboards',
320
- 'Integration platforms',
321
- ],
142
+ example_app_types: ['App management', 'Integration hubs'],
322
143
  },
323
144
  };
324
- // ─── Enriched Scope Data ────────────────────────────────────────
145
+ // ─── Scope Data (from platform API) ─────────────────────────────
146
+ // All 147 scopes across 78 resources — exactly as returned by GET /api/v1/scopes.
147
+ // No made-up scopes. No fabricated descriptions.
325
148
  export const SCOPES_BY_RESOURCE = {
326
- orders: [
327
- {
328
- id: '35f7087f-3412-49f2-8b39-4617100e2587',
329
- code: 'read_orders',
330
- label: 'Read Orders',
331
- resource: 'orders',
332
- createdAt: '2026-02-12T08:46:36.791Z',
333
- description: 'View all order data — list orders with filtering/pagination, get individual order details ' +
334
- 'including line items, pricing, customer info, addresses, payment status, and fulfillment status. ' +
335
- 'This is the most commonly needed scope for any app that works with orders.',
336
- use_cases: [
337
- 'Display order lists and dashboards',
338
- 'Analyze order trends and revenue',
339
- 'Check order status for fulfillment workflows',
340
- 'Validate discount eligibility based on past orders',
341
- 'Customer support tools that look up orders',
342
- ],
343
- commonly_paired_with: ['read_products', 'read_customers'],
344
- },
345
- {
346
- id: '0f8ee481-5e5f-41e3-996b-857b51e81e9c',
347
- code: 'write_orders',
348
- label: 'Write Orders',
349
- resource: 'orders',
350
- createdAt: '2026-02-12T08:46:36.415Z',
351
- description: 'Create new orders, update existing orders (email, phone, note, tags, status, addresses, line items), ' +
352
- 'cancel orders with optional restock, and update external IDs for third-party sync. ' +
353
- 'Includes all read_orders permissions automatically.',
354
- use_cases: [
355
- 'Create orders from external channels (marketplace, POS)',
356
- 'Update order notes or tags for internal workflows',
357
- 'Cancel orders and trigger restocking',
358
- 'Sync order IDs with external ERP/WMS systems',
359
- 'Automated order management and processing',
360
- ],
361
- commonly_paired_with: ['read_products', 'write_inventory'],
362
- },
363
- {
364
- id: '6615dcee-afc2-4131-adbc-d0051b0e5fb8',
365
- code: 'order-cancel',
366
- label: 'Order cancel',
367
- resource: 'orders',
368
- createdAt: '2026-02-12T12:54:16.601Z',
369
- description: 'Specific permission to cancel orders — allows cancelling with reason, staff notes, ' +
370
- 'restock options, and customer notification control.',
371
- use_cases: [
372
- 'Fraud detection apps that auto-cancel suspicious orders',
373
- 'Customer self-service cancellation portals',
374
- 'Automated cancellation workflows',
375
- ],
376
- commonly_paired_with: ['read_orders', 'write_inventory'],
377
- },
378
- {
379
- id: 'e62a3d30-d9f4-455e-afa8-0d753e9697e3',
380
- code: 'order-create',
381
- label: 'Order create',
382
- resource: 'orders',
383
- createdAt: '2026-02-12T12:54:00.455Z',
384
- description: 'Specific permission to create new orders — submit orders with full details ' +
385
- 'including line items, customer, addresses, and payment info.',
386
- use_cases: [
387
- 'POS systems creating in-store orders',
388
- 'Marketplace sync apps importing orders',
389
- 'B2B platforms creating wholesale orders',
390
- 'Subscription apps generating recurring orders',
391
- ],
392
- commonly_paired_with: ['read_orders', 'read_products', 'read_customers'],
393
- },
394
- {
395
- id: 'fa1143a9-619d-4975-a031-6701e4b00ce7',
396
- code: 'order-update',
397
- label: 'Order update',
398
- resource: 'orders',
399
- createdAt: '2026-02-12T12:54:31.203Z',
400
- description: 'Specific permission to update existing orders — modify order fields like ' +
401
- 'email, phone, notes, tags, status, addresses, and line items.',
402
- use_cases: [
403
- 'Order editing tools for customer support',
404
- 'Automated tagging and categorization',
405
- 'Address correction workflows',
406
- 'Order status update integrations',
407
- ],
408
- commonly_paired_with: ['read_orders'],
409
- },
149
+ all_cart_transforms: [
150
+ { id: 'd98803d9-9105-4615-b3c7-aba2d6c527ae', code: 'read_all_cart_transforms', label: 'Read All Cart Transforms', resource: 'all_cart_transforms', createdAt: '2026-02-11T18:44:20.083Z' },
410
151
  ],
411
- products: [
412
- {
413
- id: '6ed56a65-fad1-44b0-8faa-f26f7b420f93',
414
- code: 'read_products',
415
- label: 'Read Products',
416
- resource: 'products',
417
- createdAt: '2026-02-01T12:21:12.348Z',
418
- description: 'View product catalog — list products with filtering (status, vendor, tags, category, collection), ' +
419
- 'get product details including variants, images, pricing, inventory tracking, and SEO metadata. ' +
420
- 'Essential for any app that needs to reference what the merchant sells.',
421
- use_cases: [
422
- 'Display product catalogs and listings',
423
- 'Sync products to external marketplaces',
424
- 'Analyze product performance alongside orders',
425
- 'Build product recommendation engines',
426
- 'SEO audit tools that review product metadata',
427
- ],
428
- commonly_paired_with: ['read_orders', 'read_inventory'],
429
- },
430
- {
431
- id: '0a7be257-d312-429e-9e94-9b8be04f0a25',
432
- code: 'write_products',
433
- label: 'Write Products',
434
- resource: 'products',
435
- createdAt: '2026-02-12T08:46:41.885Z',
436
- description: 'Create and update products add new products with full details (title, description, pricing, ' +
437
- 'variants, SEO, categories, collections, tags), and update any product field. ' +
438
- 'Includes all read_products permissions automatically.',
439
- use_cases: [
440
- 'Bulk product import from suppliers or spreadsheets',
441
- 'Marketplace sync (two-way product updates)',
442
- 'Automated price optimization',
443
- 'Product content generation and SEO improvement',
444
- 'Catalog management tools',
445
- ],
446
- commonly_paired_with: ['read_orders', 'write_inventory'],
447
- },
448
- {
449
- id: 'a7f8f95e-1884-4f5e-bc21-be52586b1564',
450
- code: 'delete_products',
451
- label: 'Delete Products',
452
- resource: 'products',
453
- createdAt: '2026-02-01T12:21:12.749Z',
454
- description: 'Permanently delete products from the store. This is a destructive action. ' +
455
- 'Includes all write_products and read_products permissions automatically.',
456
- use_cases: [
457
- 'Catalog cleanup tools that remove discontinued items',
458
- 'Sync tools that need to mirror deletions from external systems',
459
- 'Bulk product management with full lifecycle control',
460
- ],
461
- commonly_paired_with: ['write_products'],
462
- },
152
+ all_checkout_completion_target_customizations: [
153
+ { id: 'cc5f2957-a535-4534-acd4-87f690177f23', code: 'read_all_checkout_completion_target_customizations', label: 'Read All Checkout Completion Target Customizations', resource: 'all_checkout_completion_target_customizations', createdAt: '2026-02-11T18:44:20.454Z' },
154
+ { id: '5299e491-a5c4-4a15-9e16-a23acb04b8ad', code: 'write_all_checkout_completion_target_customizations', label: 'Write All Checkout Completion Target Customizations', resource: 'all_checkout_completion_target_customizations', createdAt: '2026-02-11T18:44:20.296Z' },
155
+ ],
156
+ all_orders: [
157
+ { id: '2ad46603-174c-4a2e-8cca-dafd5849a585', code: 'read_all_orders', label: 'Read All Orders', resource: 'all_orders', createdAt: '2026-02-11T18:44:29.122Z' },
158
+ ],
159
+ analytics: [
160
+ { id: '658595c3-8f82-43b1-973c-8048ad9975ff', code: 'read_analytics', label: 'Read Analytics', resource: 'analytics', createdAt: '2026-02-11T18:43:58.803Z' },
161
+ ],
162
+ app_proxy: [
163
+ { id: '62a0b4c4-86b1-4732-9827-3a4ab93e97eb', code: 'read_app_proxy', label: 'Read App Proxy', resource: 'app_proxy', createdAt: '2026-02-11T18:44:28.883Z' },
164
+ ],
165
+ apps: [
166
+ { id: 'c5628b73-6a1e-4be7-9fb9-4cf8876b4705', code: 'read_apps', label: 'Read Apps', resource: 'apps', createdAt: '2026-02-11T18:43:59.034Z' },
167
+ ],
168
+ assigned_fulfillment_orders: [
169
+ { id: '50e3f1c9-c2ff-48ec-9db4-ffdd34c96d02', code: 'read_assigned_fulfillment_orders', label: 'Read Assigned Fulfillment Orders', resource: 'assigned_fulfillment_orders', createdAt: '2026-02-11T18:43:59.443Z' },
170
+ { id: '9a5f0351-7e6c-470b-92e1-81eb825d7fc7', code: 'write_assigned_fulfillment_orders', label: 'Write Assigned Fulfillment Orders', resource: 'assigned_fulfillment_orders', createdAt: '2026-02-11T18:43:59.220Z' },
171
+ ],
172
+ cart_transforms: [
173
+ { id: '395e5eaa-7d9c-4a23-bc5c-3157e65749d5', code: 'read_cart_transforms', label: 'Read Cart Transforms', resource: 'cart_transforms', createdAt: '2026-02-11T18:44:20.902Z' },
174
+ { id: '95c35326-b42c-48f0-83ba-af573b2381bc', code: 'write_cart_transforms', label: 'Write Cart Transforms', resource: 'cart_transforms', createdAt: '2026-02-11T18:44:20.681Z' },
175
+ ],
176
+ cash_tracking: [
177
+ { id: '8ce65836-79ae-4d9b-9bcc-3838084082a7', code: 'read_cash_tracking', label: 'Read Cash Tracking', resource: 'cash_tracking', createdAt: '2026-02-11T18:44:21.121Z' },
178
+ ],
179
+ channels: [
180
+ { id: '4e9937bf-ff43-4e14-987a-3b8a3a6477db', code: 'read_channels', label: 'Read Channels', resource: 'channels', createdAt: '2026-02-11T18:44:14.582Z' },
181
+ { id: 'f8310ebd-8df4-4229-ae6a-bc0021a08a3b', code: 'write_channels', label: 'Write Channels', resource: 'channels', createdAt: '2026-02-11T18:44:14.359Z' },
182
+ ],
183
+ checkout_branding_settings: [
184
+ { id: 'd9200c30-e606-4e6e-ba11-58109615fde1', code: 'read_checkout_branding_settings', label: 'Read Checkout Branding Settings', resource: 'checkout_branding_settings', createdAt: '2026-02-11T18:44:00.073Z' },
185
+ { id: '57ea8676-3171-4a2f-8a15-bd968532f1da', code: 'write_checkout_branding_settings', label: 'Write Checkout Branding Settings', resource: 'checkout_branding_settings', createdAt: '2026-02-11T18:43:59.892Z' },
186
+ ],
187
+ companies: [
188
+ { id: 'a51c9146-8410-4193-9830-ee956c4ce7d3', code: 'read_companies', label: 'Read Companies', resource: 'companies', createdAt: '2026-02-11T18:44:21.571Z' },
189
+ { id: 'afdb0140-97f9-4404-a58f-93d69045c5c6', code: 'write_companies', label: 'Write Companies', resource: 'companies', createdAt: '2026-02-11T18:44:21.381Z' },
190
+ ],
191
+ content: [
192
+ { id: '264cc096-5b23-44f6-9886-2cacc9a33740', code: 'read_content', label: 'Read Content', resource: 'content', createdAt: '2026-02-11T18:44:17.853Z' },
193
+ { id: '261853b6-ea35-4407-bcc4-88c17b49177f', code: 'write_content', label: 'Write Content', resource: 'content', createdAt: '2026-02-11T18:44:17.633Z' },
194
+ ],
195
+ custom_fulfillment_services: [
196
+ { id: 'a640b3d2-85bd-4a35-8ad1-bcdcf6953be2', code: 'read_custom_fulfillment_services', label: 'Read Custom Fulfillment Services', resource: 'custom_fulfillment_services', createdAt: '2026-02-11T18:44:21.918Z' },
197
+ { id: 'a1c5f6c4-c183-4652-a76e-e758a94c3e59', code: 'write_custom_fulfillment_services', label: 'Write Custom Fulfillment Services', resource: 'custom_fulfillment_services', createdAt: '2026-02-11T18:44:21.760Z' },
198
+ ],
199
+ custom_pixels: [
200
+ { id: 'c2053498-5db4-4a9f-acc5-cbbb2b60c70c', code: 'read_custom_pixels', label: 'Read Custom Pixels', resource: 'custom_pixels', createdAt: '2026-02-11T18:44:00.408Z' },
201
+ { id: 'eb75d5bf-1d82-4dcc-93d4-d1e02542bd3a', code: 'write_custom_pixels', label: 'Write Custom Pixels', resource: 'custom_pixels', createdAt: '2026-02-11T18:44:00.272Z' },
202
+ ],
203
+ customer_data_erasure: [
204
+ { id: '30138e7d-f4db-4095-87a8-f64855a6a56d', code: 'read_customer_data_erasure', label: 'Read Customer Data Erasure', resource: 'customer_data_erasure', createdAt: '2026-02-11T18:44:22.338Z' },
205
+ { id: '1552ee3b-e5a4-4a8b-9179-f99be535fecc', code: 'write_customer_data_erasure', label: 'Write Customer Data Erasure', resource: 'customer_data_erasure', createdAt: '2026-02-11T18:44:22.131Z' },
206
+ ],
207
+ customer_events: [
208
+ { id: 'e80d4bdc-e2a4-446a-b69c-417c0b49547b', code: 'read_customer_events', label: 'Read Customer Events', resource: 'customer_events', createdAt: '2026-02-11T18:43:59.672Z' },
209
+ ],
210
+ customer_merge: [
211
+ { id: 'bb44fc16-d788-4973-8fcd-a4074321514f', code: 'read_customer_merge', label: 'Read Customer Merge', resource: 'customer_merge', createdAt: '2026-02-11T18:44:22.771Z' },
212
+ { id: '0e42e9e2-717d-4c27-a29e-061950bbbecd', code: 'write_customer_merge', label: 'Write Customer Merge', resource: 'customer_merge', createdAt: '2026-02-11T18:44:22.553Z' },
463
213
  ],
464
214
  customers: [
465
- {
466
- id: '1f6e9370-96f7-4af6-ad4d-bb65ec26677f',
467
- code: 'read_customers',
468
- label: 'Read Customers',
469
- resource: 'customers',
470
- createdAt: '2026-02-01T12:21:13.548Z',
471
- description: 'View customer profiles — access contact info (email, phone), addresses, ' +
472
- 'and associated order history. Needed for personalization, marketing, and support apps.',
473
- use_cases: [
474
- 'Customer analytics and segmentation',
475
- 'Email/SMS marketing targeting',
476
- 'CRM integrations',
477
- 'Loyalty program member lookups',
478
- 'Customer support tools',
479
- ],
480
- commonly_paired_with: ['read_orders', 'read_analytics'],
481
- },
482
- {
483
- id: '8389df02-33a8-4037-b9e0-2577f6187d3f',
484
- code: 'write_customers',
485
- label: 'Write Customers',
486
- resource: 'customers',
487
- createdAt: '2026-02-01T12:21:13.749Z',
488
- description: 'Create and update customer profiles — add new customers, update contact info and addresses. ' +
489
- 'Includes all read_customers permissions automatically.',
490
- use_cases: [
491
- 'CRM sync (import customers from external systems)',
492
- 'Customer data enrichment',
493
- 'Loyalty program enrollment',
494
- 'POS customer creation',
495
- ],
496
- commonly_paired_with: ['read_orders', 'write_orders'],
497
- },
498
- {
499
- id: 'f635340b-3d1e-4377-b591-b8487021b314',
500
- code: 'delete_customers',
501
- label: 'Delete Customers',
502
- resource: 'customers',
503
- createdAt: '2026-02-01T12:21:13.948Z',
504
- description: 'Delete customer records. Destructive action — use with caution. ' +
505
- 'Includes all write_customers and read_customers permissions.',
506
- use_cases: [
507
- 'GDPR/data privacy compliance tools',
508
- 'Customer data cleanup',
509
- ],
510
- commonly_paired_with: ['write_customers'],
511
- },
215
+ { id: 'a9226273-bb0d-11f0-8124-0a45148612a5', code: 'manage_customers', label: 'Manage Customers', resource: 'customers', createdAt: '2025-11-06T12:39:39.505Z' },
216
+ { id: '78bc3718-df80-4631-8532-cd3639b3472b', code: 'read_customers', label: 'Read Customers', resource: 'customers', createdAt: '2026-02-11T18:44:00.840Z' },
217
+ { id: '403c7a63-cf00-4ee1-9d1f-47cf669bc746', code: 'write_customers', label: 'Write Customers', resource: 'customers', createdAt: '2026-02-11T18:44:00.622Z' },
512
218
  ],
513
- inventory: [
514
- {
515
- id: '9a1b34af-2974-4e09-a855-4d444a914169',
516
- code: 'read_inventory',
517
- label: 'Read Inventory',
518
- resource: 'inventory',
519
- createdAt: '2026-02-01T12:21:14.198Z',
520
- description: 'View inventory levels — check stock quantities across locations, see reorder points, ' +
521
- 'and monitor availability. Essential for any app that needs to know if products are in stock.',
522
- use_cases: [
523
- 'Low-stock alert systems',
524
- 'Inventory dashboards and reporting',
525
- 'Product availability checks for external channels',
526
- 'Demand forecasting based on stock levels',
527
- 'Warehouse management visibility',
528
- ],
529
- commonly_paired_with: ['read_products', 'read_orders'],
530
- },
531
- {
532
- id: '30575c53-aa12-498e-8c76-4e8b5ae9f633',
533
- code: 'write_inventory',
534
- label: 'Write Inventory',
535
- resource: 'inventory',
536
- createdAt: '2026-02-12T08:46:29.910Z',
537
- description: 'Update stock levels — adjust quantities, set inventory at locations, manage restocking. ' +
538
- 'Includes all read_inventory permissions automatically.',
539
- use_cases: [
540
- 'Inventory sync with warehouses or ERP systems',
541
- 'Automatic restocking when orders are cancelled',
542
- 'Multi-location stock transfers',
543
- 'Supplier integration for stock updates',
544
- ],
545
- commonly_paired_with: ['read_products', 'write_orders'],
546
- },
547
- {
548
- id: 'aac7fb27-4df1-4331-a8b9-5f51ffab0623',
549
- code: 'delete_inventory',
550
- label: 'Delete Inventory',
551
- resource: 'inventory',
552
- createdAt: '2026-02-01T12:21:14.598Z',
553
- description: 'Delete inventory records. Includes all write_inventory and read_inventory permissions.',
554
- use_cases: [
555
- 'Inventory cleanup tools',
556
- 'Location decommissioning workflows',
557
- ],
558
- commonly_paired_with: ['write_inventory'],
559
- },
219
+ delivery_customizations: [
220
+ { id: 'eeb0d065-00a0-4e0b-9178-12444f2ac223', code: 'read_delivery_customizations', label: 'Read Delivery Customizations', resource: 'delivery_customizations', createdAt: '2026-02-11T18:44:23.176Z' },
221
+ { id: '12af6b14-57f7-487f-bc29-b38000ef5e6b', code: 'write_delivery_customizations', label: 'Write Delivery Customizations', resource: 'delivery_customizations', createdAt: '2026-02-11T18:44:22.994Z' },
222
+ ],
223
+ delivery_option_generators: [
224
+ { id: 'c77ebfb6-f5f1-454c-aa56-fdce8c7e0e61', code: 'read_delivery_option_generators', label: 'Read Delivery Option Generators', resource: 'delivery_option_generators', createdAt: '2026-02-11T18:44:23.632Z' },
225
+ { id: '4691a39a-cd42-4b5d-9738-db77fed9c8c9', code: 'write_delivery_option_generators', label: 'Write Delivery Option Generators', resource: 'delivery_option_generators', createdAt: '2026-02-11T18:44:23.382Z' },
560
226
  ],
561
227
  discounts: [
562
- {
563
- id: '2c14f243-75b1-4a16-85ce-ba4608ff78bc',
564
- code: 'read_discounts',
565
- label: 'Read Discounts',
566
- resource: 'discounts',
567
- createdAt: '2026-02-12T08:46:25.745Z',
568
- description: 'View discount rules and campaigns — see active promotions, coupon codes, ' +
569
- 'eligibility conditions, usage stats, and discount values (percentage or fixed amount).',
570
- use_cases: [
571
- 'Discount analytics and performance tracking',
572
- 'Display active promotions on external channels',
573
- 'Validate coupon codes before applying',
574
- 'Marketing campaign reporting',
575
- ],
576
- commonly_paired_with: ['read_orders', 'read_products'],
577
- },
578
- {
579
- id: '6207720c-3954-447d-a4ed-69b90b43cc8a',
580
- code: 'write_discounts',
581
- label: 'Write Discounts',
582
- resource: 'discounts',
583
- createdAt: '2026-02-12T08:46:25.470Z',
584
- description: 'Create and update discounts — build promotional campaigns, generate coupon codes, ' +
585
- 'set eligibility rules (min purchase, specific products/collections, customer segments). ' +
586
- 'Includes all read_discounts permissions automatically.',
587
- use_cases: [
588
- 'Promotional campaign management tools',
589
- 'Automated discount creation (flash sales, seasonal)',
590
- 'Loyalty reward generation',
591
- 'Bundle pricing and volume discount engines',
592
- 'Cart abandonment recovery with auto-generated coupons',
593
- ],
594
- commonly_paired_with: ['read_orders', 'read_products', 'read_customers'],
595
- },
596
- {
597
- id: 'cd09bd6e-b186-4637-ba21-99e376230cba',
598
- code: 'delete_discounts',
599
- label: 'Delete Discounts',
600
- resource: 'discounts',
601
- createdAt: '2026-02-01T12:21:16.528Z',
602
- description: 'Delete discount rules and campaigns. Includes all write_discounts and read_discounts permissions.',
603
- use_cases: [
604
- 'Cleanup expired promotions automatically',
605
- 'Campaign lifecycle management',
606
- ],
607
- commonly_paired_with: ['write_discounts'],
608
- },
609
- ],
610
- payments: [
611
- {
612
- id: 'a7bc79b5-8003-465a-ab3b-1ff49ddc7748',
613
- code: 'read_payments',
614
- label: 'Read Payments',
615
- resource: 'payments',
616
- createdAt: '2026-02-01T12:21:14.988Z',
617
- description: 'View payment transactions — see payment status, gateway details, and transaction history for orders.',
618
- use_cases: [
619
- 'Financial reporting and reconciliation',
620
- 'Payment status dashboards',
621
- 'Accounting tool integrations',
622
- ],
623
- commonly_paired_with: ['read_orders'],
624
- },
625
- {
626
- id: 'b48d4b6a-3998-4cfa-babd-96226c14c24b',
627
- code: 'write_payments',
628
- label: 'Write Payments',
629
- resource: 'payments',
630
- createdAt: '2026-02-01T12:21:15.188Z',
631
- description: 'Process payments and refunds. Includes read_payments permissions.',
632
- use_cases: [
633
- 'Payment gateway integrations',
634
- 'Refund processing tools',
635
- 'Automated payment capture',
636
- ],
637
- commonly_paired_with: ['write_orders', 'read_orders'],
638
- },
639
- {
640
- id: '47a7d9df-18a0-40e4-a596-8aec7f4c93c8',
641
- code: 'delete_payments',
642
- label: 'Delete Payments',
643
- resource: 'payments',
644
- createdAt: '2026-02-01T12:21:15.388Z',
645
- description: 'Delete payment records. Includes all payment permissions.',
646
- use_cases: ['Payment record cleanup'],
647
- commonly_paired_with: ['write_payments'],
648
- },
228
+ { id: 'b73dab7f-9e7b-42a7-bace-5d3181b71aec', code: 'read_discounts', label: 'Read Discounts', resource: 'discounts', createdAt: '2026-02-11T18:44:01.250Z' },
229
+ { id: '31c3e63e-18cf-4330-929d-fbc375470523', code: 'write_discounts', label: 'Write Discounts', resource: 'discounts', createdAt: '2026-02-11T18:44:01.062Z' },
649
230
  ],
650
- shipping: [
651
- {
652
- id: '5647544a-8cc1-41e0-9717-a8bebade010a',
653
- code: 'read_shipping',
654
- label: 'Read Shipping',
655
- resource: 'shipping',
656
- createdAt: '2026-02-01T12:21:15.588Z',
657
- description: 'View shipping rates, zones, and carrier configurations.',
658
- use_cases: ['Shipping rate display', 'Carrier comparison tools', 'Delivery estimation'],
659
- commonly_paired_with: ['read_orders', 'read_fulfillments'],
660
- },
661
- {
662
- id: 'b0aa2cca-8377-42b2-ae40-f3ae45fe995b',
663
- code: 'write_shipping',
664
- label: 'Write Shipping',
665
- resource: 'shipping',
666
- createdAt: '2026-02-01T12:21:15.769Z',
667
- description: 'Create and update shipping rates and configurations. Includes read_shipping.',
668
- use_cases: ['Carrier integration setup', 'Dynamic shipping rate engines'],
669
- commonly_paired_with: ['write_orders', 'write_fulfillments'],
670
- },
671
- {
672
- id: '5b3ad1c9-a610-4c85-9ad4-8723132f855f',
673
- code: 'delete_shipping',
674
- label: 'Delete Shipping',
675
- resource: 'shipping',
676
- createdAt: '2026-02-01T12:21:15.925Z',
677
- description: 'Delete shipping configurations. Includes all shipping permissions.',
678
- use_cases: ['Shipping config cleanup'],
679
- commonly_paired_with: ['write_shipping'],
680
- },
231
+ discounts_allocator_functions: [
232
+ { id: '06a2ef02-3f12-42a6-b572-a952bd86823c', code: 'read_discounts_allocator_functions', label: 'Read Discounts Allocator Functions', resource: 'discounts_allocator_functions', createdAt: '2026-02-11T18:44:24.082Z' },
233
+ { id: 'c89c9ce4-e143-45c7-9f11-cedfea2de94d', code: 'write_discounts_allocator_functions', label: 'Write Discounts Allocator Functions', resource: 'discounts_allocator_functions', createdAt: '2026-02-11T18:44:23.853Z' },
681
234
  ],
682
- fulfillments: [
683
- {
684
- id: '6032bfc2-63ea-46b8-939f-713127f2887c',
685
- code: 'read_fulfillments',
686
- label: 'Read Fulfillments',
687
- resource: 'fulfillments',
688
- createdAt: '2026-02-12T08:46:28.272Z',
689
- description: 'View fulfillment details — tracking numbers, shipment status, and fulfillment history.',
690
- use_cases: ['Shipment tracking dashboards', 'Fulfillment analytics', 'Customer delivery notifications'],
691
- commonly_paired_with: ['read_orders', 'read_shipping'],
692
- },
693
- {
694
- id: 'c778ad47-744b-4486-91fb-305c81e55069',
695
- code: 'write_fulfillments',
696
- label: 'Write Fulfillments',
697
- resource: 'fulfillments',
698
- createdAt: '2026-02-12T08:46:28.030Z',
699
- description: 'Create and update fulfillments — mark orders as fulfilled, add tracking info. Includes read_fulfillments.',
700
- use_cases: ['Fulfillment automation', 'Warehouse management systems', 'Dropshipping integrations'],
701
- commonly_paired_with: ['write_orders', 'read_inventory'],
702
- },
235
+ discovery: [
236
+ { id: '4d421b78-1f33-4877-a0f3-659a3875df9f', code: 'read_discovery', label: 'Read Discovery', resource: 'discovery', createdAt: '2026-02-11T18:44:01.673Z' },
237
+ { id: '0179a27f-492b-4112-a3bb-9abeafe4ac19', code: 'write_discovery', label: 'Write Discovery', resource: 'discovery', createdAt: '2026-02-11T18:44:01.449Z' },
703
238
  ],
704
239
  draft_orders: [
705
- {
706
- id: '7fc8e283-ff75-45d8-9c0e-dd216820c659',
707
- code: 'read_draft_orders',
708
- label: 'Read Draft Orders',
709
- resource: 'draft_orders',
710
- createdAt: '2026-02-12T08:46:27.120Z',
711
- description: 'View draft/preliminary orders — orders not yet finalized, useful for B2B and quoting workflows.',
712
- use_cases: ['Draft order dashboards', 'Quote management', 'B2B order review'],
713
- commonly_paired_with: ['read_orders', 'read_products'],
714
- },
715
- {
716
- id: '61bb98e5-543b-43c1-b29f-bb42aa612569',
717
- code: 'write_draft_orders',
718
- label: 'Write Draft Orders',
719
- resource: 'draft_orders',
720
- createdAt: '2026-02-12T08:46:26.760Z',
721
- description: 'Create and update draft orders. Includes read_draft_orders.',
722
- use_cases: ['B2B quoting tools', 'Custom order creation workflows', 'POS draft creation'],
723
- commonly_paired_with: ['write_orders', 'read_products', 'read_customers'],
724
- },
240
+ { id: 'c648be00-2f0b-4091-a701-88ab5b6cb34c', code: 'read_draft_orders', label: 'Read Draft Orders', resource: 'draft_orders', createdAt: '2026-02-11T18:44:02.133Z' },
241
+ { id: 'a122fc60-aad7-4cbf-a105-af6853a971bb', code: 'write_draft_orders', label: 'Write Draft Orders', resource: 'draft_orders', createdAt: '2026-02-11T18:44:01.903Z' },
725
242
  ],
726
- returns: [
727
- {
728
- id: 'b241cad0-c7fb-42c3-8817-be5a855c66f8',
729
- code: 'read_returns',
730
- label: 'Read Returns',
731
- resource: 'returns',
732
- createdAt: '2026-02-12T08:46:45.510Z',
733
- description: 'View return requests and their status — track what customers want to return and why.',
734
- use_cases: ['Returns dashboard', 'Return rate analytics', 'Customer support lookups'],
735
- commonly_paired_with: ['read_orders', 'read_payments'],
736
- },
737
- {
738
- id: 'ca27e565-7727-4c08-a4e1-967f579c268d',
739
- code: 'write_returns',
740
- label: 'Write Returns',
741
- resource: 'returns',
742
- createdAt: '2026-02-12T08:46:45.127Z',
743
- description: 'Process return requests approve, reject, and manage return workflows. Includes read_returns.',
744
- use_cases: ['Returns management portals', 'Automated return approval', 'Exchange workflows'],
745
- commonly_paired_with: ['write_orders', 'write_payments', 'write_inventory'],
746
- },
243
+ files: [
244
+ { id: '943037c5-6844-44c3-ab6e-084cdfc3f53e', code: 'read_files', label: 'Read Files', resource: 'files', createdAt: '2026-02-11T18:44:02.612Z' },
245
+ { id: 'cad33953-ed6a-4cca-82d7-7af2c1151368', code: 'write_files', label: 'Write Files', resource: 'files', createdAt: '2026-02-11T18:44:02.383Z' },
246
+ ],
247
+ fulfillment_constraint_rules: [
248
+ { id: 'c991e6aa-628f-48f6-995f-1299d2b6e652', code: 'read_fulfillment_constraint_rules', label: 'Read Fulfillment Constraint Rules', resource: 'fulfillment_constraint_rules', createdAt: '2026-02-11T18:44:24.532Z' },
249
+ { id: '328881fb-d119-4e43-a8e1-e9f73f900681', code: 'write_fulfillment_constraint_rules', label: 'Write Fulfillment Constraint Rules', resource: 'fulfillment_constraint_rules', createdAt: '2026-02-11T18:44:24.311Z' },
250
+ ],
251
+ fulfillments: [
252
+ { id: 'f861989a-9d35-4bf8-a3d1-fc7d203cbff5', code: 'read_fulfillments', label: 'Read Fulfillments', resource: 'fulfillments', createdAt: '2026-02-11T18:44:03.072Z' },
253
+ { id: 'd7ec3c6e-143d-474f-822f-67a784ef7a99', code: 'write_fulfillments', label: 'Write Fulfillments', resource: 'fulfillments', createdAt: '2026-02-11T18:44:02.845Z' },
254
+ ],
255
+ gates: [
256
+ { id: 'a50266c9-d3f2-478b-860d-ccddf28f1cca', code: 'read_gates', label: 'Read Gates', resource: 'gates', createdAt: '2026-02-11T18:44:24.941Z' },
257
+ { id: '1f9a0c52-e34b-4bc8-a466-1eab486275df', code: 'write_gates', label: 'Write Gates', resource: 'gates', createdAt: '2026-02-11T18:44:24.763Z' },
258
+ ],
259
+ gift_card_transactions: [
260
+ { id: '01b918b8-cf3b-470a-b565-198d0c2aba36', code: 'read_gift_card_transactions', label: 'Read Gift Card Transactions', resource: 'gift_card_transactions', createdAt: '2026-02-11T18:44:03.523Z' },
261
+ { id: '0370a6a6-c2cc-4f3e-bae3-9ae2438229e2', code: 'write_gift_card_transactions', label: 'Write Gift Card Transactions', resource: 'gift_card_transactions', createdAt: '2026-02-11T18:44:03.303Z' },
747
262
  ],
748
263
  gift_cards: [
749
- {
750
- id: 'd48db2ee-e1e3-4c4a-aedc-890ef324d89a',
751
- code: 'read_gift_cards',
752
- label: 'Read Gift Cards',
753
- resource: 'gift_cards',
754
- createdAt: '2026-02-12T08:46:29.595Z',
755
- description: 'View gift cards — check balances, see issued cards, and track redemptions.',
756
- use_cases: ['Gift card balance lookups', 'Gift card analytics'],
757
- commonly_paired_with: ['read_orders', 'read_customers'],
758
- },
759
- {
760
- id: 'dbd0bd71-f7e3-41f6-9084-f78bf7867724',
761
- code: 'write_gift_cards',
762
- label: 'Write Gift Cards',
763
- resource: 'gift_cards',
764
- createdAt: '2026-02-12T08:46:29.295Z',
765
- description: 'Issue and manage gift cards — create new cards, adjust balances. Includes read_gift_cards.',
766
- use_cases: ['Gift card issuance platforms', 'Loyalty reward distribution', 'Corporate gifting tools'],
767
- commonly_paired_with: ['read_customers', 'read_orders'],
768
- },
264
+ { id: 'd367352d-411b-4377-a2b2-9da9d95dc623', code: 'read_gift_cards', label: 'Read Gift Cards', resource: 'gift_cards', createdAt: '2026-02-11T18:44:03.984Z' },
265
+ { id: '745264b2-2e63-4d96-ad18-f09a256de6a9', code: 'write_gift_cards', label: 'Write Gift Cards', resource: 'gift_cards', createdAt: '2026-02-11T18:44:03.753Z' },
769
266
  ],
770
- analytics: [
771
- {
772
- id: '79ef776f-d3da-4ef2-9f0b-88b034476bbd',
773
- code: 'read_analytics',
774
- label: 'Read Analytics',
775
- resource: 'analytics',
776
- createdAt: '2026-02-01T12:21:14.798Z',
777
- description: 'Access store analytics — aggregated sales data, traffic metrics, conversion rates, ' +
778
- 'and business performance insights.',
779
- use_cases: [
780
- 'Business intelligence dashboards',
781
- 'Performance reporting tools',
782
- 'Revenue tracking and forecasting',
783
- 'Marketing attribution analysis',
784
- ],
785
- commonly_paired_with: ['read_orders', 'read_products', 'read_customers'],
786
- },
267
+ inventory: [
268
+ { id: 'a9c0cd41-f8b2-4875-bcd9-fd9aa2d9bc62', code: 'read_inventory', label: 'Read Inventory', resource: 'inventory', createdAt: '2026-02-11T18:44:04.434Z' },
269
+ { id: 'cfc2c440-2552-4cbe-bc60-f42284efcc83', code: 'write_inventory', label: 'Write Inventory', resource: 'inventory', createdAt: '2026-02-11T18:44:04.169Z' },
787
270
  ],
788
- channels: [
789
- {
790
- id: '1444cdcc-8179-4324-a04f-bc037baf2adb',
791
- code: 'read_channels',
792
- label: 'Read Channels',
793
- resource: 'channels',
794
- createdAt: '2026-02-12T08:46:46.140Z',
795
- description: 'View sales channels configured for the store.',
796
- use_cases: ['Multi-channel dashboards', 'Channel performance comparison'],
797
- commonly_paired_with: ['read_products', 'read_publications'],
798
- },
799
- {
800
- id: 'a2557094-db43-42bf-b6df-4c04c86e3f72',
801
- code: 'write_channels',
802
- label: 'Write Channels',
803
- resource: 'channels',
804
- createdAt: '2026-02-12T08:46:45.800Z',
805
- description: 'Create and configure sales channels. Includes read_channels.',
806
- use_cases: ['Marketplace integration setup', 'Social commerce channel creation'],
807
- commonly_paired_with: ['write_products', 'write_publications'],
808
- },
271
+ inventory_shipments: [
272
+ { id: '2549e328-87b7-4025-9d9e-106fa315af97', code: 'read_inventory_shipments', label: 'Read Inventory Shipments', resource: 'inventory_shipments', createdAt: '2026-02-11T18:44:25.392Z' },
273
+ { id: 'f74c9bc6-ada4-4c8f-95a2-dee6bca324ac', code: 'write_inventory_shipments', label: 'Write Inventory Shipments', resource: 'inventory_shipments', createdAt: '2026-02-11T18:44:25.162Z' },
809
274
  ],
810
- content: [
811
- {
812
- id: 'f86e34f0-d00c-46b5-b6bf-ebe5b60f5266',
813
- code: 'read_content',
814
- label: 'Read Content',
815
- resource: 'content',
816
- createdAt: '2026-02-12T08:46:51.255Z',
817
- description: 'View store content — pages, blog posts, and media content.',
818
- use_cases: ['Content audit tools', 'SEO analysis', 'Content migration'],
819
- commonly_paired_with: ['read_themes', 'read_files'],
820
- },
821
- {
822
- id: '7a27a369-408e-410a-8b17-f374eac4cdf8',
823
- code: 'write_content',
824
- label: 'Write Content',
825
- resource: 'content',
826
- createdAt: '2026-02-12T08:46:50.905Z',
827
- description: 'Create and update store content. Includes read_content.',
828
- use_cases: ['CMS integrations', 'AI content generation', 'Blog management tools'],
829
- commonly_paired_with: ['write_files', 'write_themes'],
830
- },
275
+ inventory_shipments_received_items: [
276
+ { id: 'ca761c84-b561-4145-97fd-5ca16a3d1a1e', code: 'read_inventory_shipments_received_items', label: 'Read Inventory Shipments Received Items', resource: 'inventory_shipments_received_items', createdAt: '2026-02-11T18:44:25.763Z' },
277
+ { id: 'b42a2990-e74a-40b6-95cb-65b9d8b1146b', code: 'write_inventory_shipments_received_items', label: 'Write Inventory Shipments Received Items', resource: 'inventory_shipments_received_items', createdAt: '2026-02-11T18:44:25.586Z' },
831
278
  ],
832
- files: [
833
- {
834
- id: '4f231a25-92fa-4ad6-b718-9061b922087a',
835
- code: 'read_files',
836
- label: 'Read Files',
837
- resource: 'files',
838
- createdAt: '2026-02-12T08:46:27.780Z',
839
- description: 'View and download files — images, documents, and media assets.',
840
- use_cases: ['Asset management dashboards', 'Image optimization analysis'],
841
- commonly_paired_with: ['read_products', 'read_content'],
842
- },
843
- {
844
- id: '823abdce-dd71-474e-9cd2-637ff4e978dd',
845
- code: 'write_files',
846
- label: 'Write Files',
847
- resource: 'files',
848
- createdAt: '2026-02-12T08:46:27.440Z',
849
- description: 'Upload and manage files. Includes read_files.',
850
- use_cases: ['Bulk image upload tools', 'Asset management with editing'],
851
- commonly_paired_with: ['write_products', 'write_content'],
852
- },
279
+ inventory_transfers: [
280
+ { id: '91510a15-9168-4190-ae3c-6e1e001c9578', code: 'read_inventory_transfers', label: 'Read Inventory Transfers', resource: 'inventory_transfers', createdAt: '2026-02-11T18:44:26.168Z' },
281
+ { id: 'de7ea14d-40eb-4e3c-9155-58e40bcd93b2', code: 'write_inventory_transfers', label: 'Write Inventory Transfers', resource: 'inventory_transfers', createdAt: '2026-02-11T18:44:25.992Z' },
282
+ ],
283
+ legal_policies: [
284
+ { id: '51bcc1a5-0c07-407a-a426-115e1a7cd7d3', code: 'read_legal_policies', label: 'Read Legal Policies', resource: 'legal_policies', createdAt: '2026-02-11T18:44:04.862Z' },
285
+ { id: '3a1c9e83-4a17-4e20-a00a-e3bd62d1b3f7', code: 'write_legal_policies', label: 'Write Legal Policies', resource: 'legal_policies', createdAt: '2026-02-11T18:44:04.616Z' },
286
+ ],
287
+ locales: [
288
+ { id: '989e8d52-85f1-4c2f-85a1-8a41b492c2b4', code: 'read_locales', label: 'Read Locales', resource: 'locales', createdAt: '2026-02-11T18:44:15.840Z' },
289
+ { id: '32a5395b-fd3f-460d-a373-3bab147e3da1', code: 'write_locales', label: 'Write Locales', resource: 'locales', createdAt: '2026-02-11T18:44:15.642Z' },
853
290
  ],
854
291
  locations: [
855
- {
856
- id: 'c6e7e99c-b92d-4505-85c6-c5ede28fd2ad',
857
- code: 'read_locations',
858
- label: 'Read Locations',
859
- resource: 'locations',
860
- createdAt: '2026-02-12T08:46:31.545Z',
861
- description: 'View store locations and warehouses — addresses, hours, and inventory assignments.',
862
- use_cases: ['Store locator features', 'Multi-location inventory visibility'],
863
- commonly_paired_with: ['read_inventory', 'read_shipping'],
864
- },
865
- {
866
- id: '2e1b5c94-32d1-49a3-bc3b-b1a85cd1b888',
867
- code: 'write_locations',
868
- label: 'Write Locations',
869
- resource: 'locations',
870
- createdAt: '2026-02-12T08:46:31.255Z',
871
- description: 'Create and update locations. Includes read_locations.',
872
- use_cases: ['Multi-location management tools', 'Warehouse setup automation'],
873
- commonly_paired_with: ['write_inventory'],
874
- },
292
+ { id: 'cc2e6007-bac0-45b7-abf7-c32898076e82', code: 'read_locations', label: 'Read Locations', resource: 'locations', createdAt: '2026-02-11T18:44:05.301Z' },
293
+ { id: '908cb91e-be90-45e4-9629-5ca9920c1256', code: 'write_locations', label: 'Write Locations', resource: 'locations', createdAt: '2026-02-11T18:44:05.081Z' },
875
294
  ],
876
- themes: [
877
- {
878
- id: 'a78d0d9b-0de9-4a26-ae80-77d189810a43',
879
- code: 'read_themes',
880
- label: 'Read Themes',
881
- resource: 'themes',
882
- createdAt: '2026-02-12T08:46:52.995Z',
883
- description: 'View storefront themes and templates.',
884
- use_cases: ['Theme analysis', 'Design audit tools'],
885
- commonly_paired_with: ['read_content'],
886
- },
887
- {
888
- id: '5e390a72-c9f8-447f-8d3c-7504d19c4c03',
889
- code: 'write_themes',
890
- label: 'Write Themes',
891
- resource: 'themes',
892
- createdAt: '2026-02-12T08:46:52.665Z',
893
- description: 'Create and modify themes. Includes read_themes.',
894
- use_cases: ['Theme builders', 'A/B testing tools', 'Page builders'],
895
- commonly_paired_with: ['write_content', 'write_files'],
896
- },
295
+ marketing_events: [
296
+ { id: '4fd0dc86-c38b-424b-a3f0-f761b2d03570', code: 'read_marketing_events', label: 'Read Marketing Events', resource: 'marketing_events', createdAt: '2026-02-11T18:44:05.743Z' },
297
+ { id: '7034a934-69d8-4d7a-9f6f-0127688dd650', code: 'write_marketing_events', label: 'Write Marketing Events', resource: 'marketing_events', createdAt: '2026-02-11T18:44:05.521Z' },
298
+ ],
299
+ marketing_integrated_campaigns: [
300
+ { id: '6b95edd5-a684-409a-8aa0-ec6dbd4027d5', code: 'read_marketing_integrated_campaigns', label: 'Read Marketing Integrated Campaigns', resource: 'marketing_integrated_campaigns', createdAt: '2026-02-11T18:44:28.653Z' },
897
301
  ],
898
302
  markets: [
899
- {
900
- id: '4e301e82-0b94-46b9-8c1c-2f0e959339fe',
901
- code: 'read_markets',
902
- label: 'Read Markets',
903
- resource: 'markets',
904
- createdAt: '2026-02-12T08:46:48.800Z',
905
- description: 'View market configurations — multi-currency and regional selling settings.',
906
- use_cases: ['International expansion dashboards', 'Market performance comparison'],
907
- commonly_paired_with: ['read_locales', 'read_products'],
908
- },
909
- {
910
- id: '1c3e1143-f01d-46ea-9163-506e819e889d',
911
- code: 'write_markets',
912
- label: 'Write Markets',
913
- resource: 'markets',
914
- createdAt: '2026-02-12T08:46:48.400Z',
915
- description: 'Create and configure markets. Includes read_markets.',
916
- use_cases: ['International expansion tools', 'Market configuration automation'],
917
- commonly_paired_with: ['write_locales', 'write_products'],
918
- },
303
+ { id: '3a224510-d013-4efa-85da-b782f6fa1e83', code: 'read_markets', label: 'Read Markets', resource: 'markets', createdAt: '2026-02-11T18:44:16.261Z' },
304
+ { id: 'f35140a3-bec7-4f96-969e-04ba6c2e5244', code: 'write_markets', label: 'Write Markets', resource: 'markets', createdAt: '2026-02-11T18:44:16.042Z' },
919
305
  ],
920
- reports: [
921
- {
922
- id: 'cdd7d0a6-e144-45d8-948f-56f949c53faa',
923
- code: 'read_reports',
924
- label: 'Read Reports',
925
- resource: 'reports',
926
- createdAt: '2026-02-12T08:46:44.190Z',
927
- description: 'Access and generate custom reports on sales, inventory, customers.',
928
- use_cases: ['Custom reporting dashboards', 'Data export tools', 'Financial reports'],
929
- commonly_paired_with: ['read_analytics', 'read_orders'],
930
- },
931
- {
932
- id: '23016fc4-e7d0-4cda-8bf6-d9c7e7a5fb52',
933
- code: 'write_reports',
934
- label: 'Write Reports',
935
- resource: 'reports',
936
- createdAt: '2026-02-12T08:46:43.880Z',
937
- description: 'Create and schedule custom reports. Includes read_reports.',
938
- use_cases: ['Automated report generation', 'Scheduled data exports'],
939
- commonly_paired_with: ['read_orders', 'read_products'],
940
- },
306
+ markets_home: [
307
+ { id: 'cc36810c-7537-4830-9402-a3a863c89af2', code: 'read_markets_home', label: 'Read Markets Home', resource: 'markets_home', createdAt: '2026-02-11T18:44:26.568Z' },
308
+ { id: '6bbe083a-6ae9-40cd-ad20-973744ed1f8d', code: 'write_markets_home', label: 'Write Markets Home', resource: 'markets_home', createdAt: '2026-02-11T18:44:26.330Z' },
941
309
  ],
942
- locales: [
943
- {
944
- id: 'e9d07b59-2757-44a9-ade1-c08e07f694a9',
945
- code: 'read_locales',
946
- label: 'Read Locales',
947
- resource: 'locales',
948
- createdAt: '2026-02-12T08:46:48.095Z',
949
- description: 'View language and locale settings for multi-language stores.',
950
- use_cases: ['Translation management', 'Locale-aware content display'],
951
- commonly_paired_with: ['read_markets', 'read_content'],
952
- },
953
- {
954
- id: 'cd12d037-5a42-4434-9761-b1af076c6852',
955
- code: 'write_locales',
956
- label: 'Write Locales',
957
- resource: 'locales',
958
- createdAt: '2026-02-12T08:46:47.785Z',
959
- description: 'Create and manage locale settings. Includes read_locales.',
960
- use_cases: ['Translation management tools', 'Auto-translation services'],
961
- commonly_paired_with: ['write_markets', 'write_content'],
962
- },
310
+ merchant_managed_fulfillment_orders: [
311
+ { id: '707d91b7-e4f3-4b00-a8b6-79cc76eaed51', code: 'read_merchant_managed_fulfillment_orders', label: 'Read Merchant Managed Fulfillment Orders', resource: 'merchant_managed_fulfillment_orders', createdAt: '2026-02-11T18:44:06.202Z' },
312
+ { id: '03014631-476f-43ad-b28e-8e95b5dd1a01', code: 'write_merchant_managed_fulfillment_orders', label: 'Write Merchant Managed Fulfillment Orders', resource: 'merchant_managed_fulfillment_orders', createdAt: '2026-02-11T18:44:05.971Z' },
313
+ ],
314
+ metaobject_definitions: [
315
+ { id: 'dfbc7895-1614-4f68-98c3-08086263bd84', code: 'read_metaobject_definitions', label: 'Read Metaobject Definitions', resource: 'metaobject_definitions', createdAt: '2026-02-11T18:44:06.573Z' },
316
+ { id: 'deb7913b-6f41-422b-b8d8-aec219829aea', code: 'write_metaobject_definitions', label: 'Write Metaobject Definitions', resource: 'metaobject_definitions', createdAt: '2026-02-11T18:44:06.363Z' },
317
+ ],
318
+ metaobjects: [
319
+ { id: '30dc7a7e-653f-4c83-91cc-f66043019536', code: 'read_metaobjects', label: 'Read Metaobjects', resource: 'metaobjects', createdAt: '2026-02-11T18:44:07.062Z' },
320
+ { id: '9aa0bf8b-5211-4e4f-b86d-ef41cb4cce84', code: 'write_metaobjects', label: 'Write Metaobjects', resource: 'metaobjects', createdAt: '2026-02-11T18:44:06.813Z' },
321
+ ],
322
+ online_store_navigation: [
323
+ { id: '838a67d5-30de-4679-a784-8b12393f0644', code: 'read_online_store_navigation', label: 'Read Online Store Navigation', resource: 'online_store_navigation', createdAt: '2026-02-11T18:44:07.502Z' },
324
+ { id: 'cc75a89e-b38d-4533-a91b-22b3a18f4e54', code: 'write_online_store_navigation', label: 'Write Online Store Navigation', resource: 'online_store_navigation', createdAt: '2026-02-11T18:44:07.281Z' },
325
+ ],
326
+ online_store_pages: [
327
+ { id: 'ee7ac10b-f033-4cc8-b1fb-447e98bcaae5', code: 'read_online_store_pages', label: 'Read Online Store Pages', resource: 'online_store_pages', createdAt: '2026-02-11T18:44:07.954Z' },
328
+ { id: '3fbc7806-b1a1-4c7f-8dc0-d2c5eea83f6b', code: 'write_online_store_pages', label: 'Write Online Store Pages', resource: 'online_store_pages', createdAt: '2026-02-11T18:44:07.722Z' },
329
+ ],
330
+ order_edits: [
331
+ { id: '1c140fd5-1a88-4219-9807-9d029929690b', code: 'read_order_edits', label: 'Read Order Edits', resource: 'order_edits', createdAt: '2026-02-11T18:44:08.342Z' },
332
+ { id: '706a0024-6588-4e0c-9a45-14e9acc3c4f6', code: 'write_order_edits', label: 'Write Order Edits', resource: 'order_edits', createdAt: '2026-02-11T18:44:08.181Z' },
333
+ ],
334
+ order_submission_rules: [
335
+ { id: '5f7ad2b4-3459-4b37-8fc0-852c828b31b2', code: 'read_order_submission_rules', label: 'Read Order Submission Rules', resource: 'order_submission_rules', createdAt: '2026-02-11T18:44:27.025Z' },
336
+ { id: 'b9a7ff14-55b8-43cc-8c0c-bd56db44de26', code: 'write_order_submission_rules', label: 'Write Order Submission Rules', resource: 'order_submission_rules', createdAt: '2026-02-11T18:44:26.794Z' },
337
+ ],
338
+ orders: [
339
+ { id: 'a922611b-bb0d-11f0-8124-0a45348612a5', code: 'order-cancel', label: 'Delete Orders', resource: 'orders', createdAt: '2026-02-08T21:38:39.505Z' },
340
+ { id: '3e6b4559-8393-422d-a97b-e99de0b42401', code: 'order-cancelled', label: 'Order cancel', resource: 'orders', createdAt: '2026-02-12T13:08:55.999Z' },
341
+ { id: 'acf60de4-67fe-4084-a104-6e6d6cb2e701', code: 'order-create', label: 'Order Create', resource: 'orders', createdAt: '2025-12-24T11:10:23.824Z' },
342
+ { id: '9fb3f9ce-36ee-403d-ab62-34d22d961f1f', code: 'order-update', label: 'Order Update', resource: 'orders', createdAt: '2026-02-12T13:08:35.971Z' },
343
+ { id: '8c129e3f-8c00-4893-96a4-22cb90e03614', code: 'read_orders', label: 'Read Orders', resource: 'orders', createdAt: '2026-02-11T18:44:08.762Z' },
344
+ { id: 'a9226237-bb0d-11f0-8124-0a45148612a5', code: 'write_orders', label: 'Write Orders', resource: 'orders', createdAt: '2025-11-06T12:39:39.505Z' },
345
+ ],
346
+ packing_slip_templates: [
347
+ { id: '1afbfe8a-8df6-42df-9968-dd54ea2c29c3', code: 'read_packing_slip_templates', label: 'Read Packing Slip Templates', resource: 'packing_slip_templates', createdAt: '2026-02-11T18:44:09.185Z' },
348
+ { id: '4ed3dea4-f23e-4ba3-8286-8a1db0e77d53', code: 'write_packing_slip_templates', label: 'Write Packing Slip Templates', resource: 'packing_slip_templates', createdAt: '2026-02-11T18:44:08.953Z' },
349
+ ],
350
+ payment_customizations: [
351
+ { id: '8f38494a-c450-4de8-b1b6-960253e20491', code: 'read_payment_customizations', label: 'Read Payment Customizations', resource: 'payment_customizations', createdAt: '2026-02-11T18:44:09.643Z' },
352
+ { id: 'f04fdd09-ce76-4556-b701-176345628114', code: 'write_payment_customizations', label: 'Write Payment Customizations', resource: 'payment_customizations', createdAt: '2026-02-11T18:44:09.414Z' },
353
+ ],
354
+ payment_terms: [
355
+ { id: '5d26a842-df8f-4e2f-8ec8-6f47c1b4c480', code: 'read_payment_terms', label: 'Read Payment Terms', resource: 'payment_terms', createdAt: '2026-02-11T18:44:10.071Z' },
356
+ { id: 'cdf525ce-fb93-4e5e-99f2-05ab92a5a7e8', code: 'write_payment_terms', label: 'Write Payment Terms', resource: 'payment_terms', createdAt: '2026-02-11T18:44:09.863Z' },
357
+ ],
358
+ pixels: [
359
+ { id: '48919cd6-a81f-41f7-bd1d-1501f59ca9c3', code: 'read_pixels', label: 'Read Pixels', resource: 'pixels', createdAt: '2026-02-11T18:44:10.402Z' },
360
+ { id: '37aaed8c-51ac-4bc9-8deb-6d7473a6858b', code: 'write_pixels', label: 'Write Pixels', resource: 'pixels', createdAt: '2026-02-11T18:44:10.276Z' },
361
+ ],
362
+ price_rules: [
363
+ { id: 'f14039e0-6d62-4a8f-a1aa-97b36af483dc', code: 'read_price_rules', label: 'Read Price Rules', resource: 'price_rules', createdAt: '2026-02-11T18:44:10.762Z' },
364
+ { id: 'ccfe085c-01ae-42fc-884d-87791d3d663f', code: 'write_price_rules', label: 'Write Price Rules', resource: 'price_rules', createdAt: '2026-02-11T18:44:10.583Z' },
365
+ ],
366
+ privacy_settings: [
367
+ { id: 'e000d438-6f1c-48c7-b938-80ddf19200d8', code: 'read_privacy_settings', label: 'Read Privacy Settings', resource: 'privacy_settings', createdAt: '2026-02-11T18:44:27.483Z' },
368
+ { id: '1c105f7e-f714-4cbc-af3b-953609e4c9a5', code: 'write_privacy_settings', label: 'Write Privacy Settings', resource: 'privacy_settings', createdAt: '2026-02-11T18:44:27.253Z' },
369
+ ],
370
+ product_feeds: [
371
+ { id: 'ee020766-87fe-4aa4-9e19-1e0f0f031bc1', code: 'read_product_feeds', label: 'Read Product Feeds', resource: 'product_feeds', createdAt: '2026-02-11T18:44:11.167Z' },
372
+ { id: '7e36756c-24ff-44fe-8d52-82cc4857bff4', code: 'write_product_feeds', label: 'Write Product Feeds', resource: 'product_feeds', createdAt: '2026-02-11T18:44:10.991Z' },
373
+ ],
374
+ product_listings: [
375
+ { id: '85c517b9-0d70-4c4b-b6c1-5020dc8c700e', code: 'read_product_listings', label: 'Read Product Listings', resource: 'product_listings', createdAt: '2026-02-11T18:44:11.614Z' },
376
+ { id: 'c6db4594-cc2a-4cd7-b68a-c3aece28a9fa', code: 'write_product_listings', label: 'Write Product Listings', resource: 'product_listings', createdAt: '2026-02-11T18:44:11.381Z' },
377
+ ],
378
+ products: [
379
+ { id: 'a9225c55-bb0d-11f0-8124-0a45148612a5', code: 'read_products', label: 'Read Products', resource: 'products', createdAt: '2025-11-06T12:39:39.505Z' },
380
+ { id: 'a922611b-bb0d-11f0-8124-0a45148612a5', code: 'write_products', label: 'Write Products', resource: 'products', createdAt: '2025-11-06T12:39:39.505Z' },
963
381
  ],
964
382
  publications: [
965
- {
966
- id: '54fa765c-00ce-4db7-b420-19e534181ed8',
967
- code: 'read_publications',
968
- label: 'Read Publications',
969
- resource: 'publications',
970
- createdAt: '2026-02-12T08:46:42.885Z',
971
- description: 'View product publication status — which products are visible on which channels.',
972
- use_cases: ['Channel visibility dashboards', 'Product syndication tools'],
973
- commonly_paired_with: ['read_products', 'read_channels'],
974
- },
975
- {
976
- id: '6824a934-6b0a-42c0-a1c4-b9a46f6b5c6c',
977
- code: 'write_publications',
978
- label: 'Write Publications',
979
- resource: 'publications',
980
- createdAt: '2026-02-12T08:46:42.575Z',
981
- description: 'Control product visibility on channels. Includes read_publications.',
982
- use_cases: ['Bulk publish/unpublish tools', 'Channel management automation'],
983
- commonly_paired_with: ['write_products', 'write_channels'],
984
- },
985
- ],
986
- settings: [
987
- {
988
- id: 'e2468aea-a218-404d-b80b-e16c27ce215a',
989
- code: 'read_settings',
990
- label: 'Read Settings',
991
- resource: 'settings',
992
- createdAt: '2026-02-01T12:21:17.478Z',
993
- description: 'View store-wide settings — checkout, tax, notification, and general configurations.',
994
- use_cases: ['Store audit tools', 'Configuration backup'],
995
- commonly_paired_with: [],
996
- },
997
- {
998
- id: '5af4403a-7193-4c34-8767-995ff75df69e',
999
- code: 'write_settings',
1000
- label: 'Write Settings',
1001
- resource: 'settings',
1002
- createdAt: '2026-02-01T12:21:17.678Z',
1003
- description: 'Modify store settings. Includes read_settings.',
1004
- use_cases: ['Store setup automation', 'Configuration management tools'],
1005
- commonly_paired_with: [],
1006
- },
1007
- {
1008
- id: '9f77b645-ab8b-4d16-86be-c893927e08d0',
1009
- code: 'delete_settings',
1010
- label: 'Delete Settings',
1011
- resource: 'settings',
1012
- createdAt: '2026-02-01T12:21:17.878Z',
1013
- description: 'Delete store settings. Includes all settings permissions.',
1014
- use_cases: ['Configuration reset tools'],
1015
- commonly_paired_with: ['write_settings'],
1016
- },
1017
- ],
1018
- webhooks: [
1019
- {
1020
- id: 'b53a6288-8c27-4ee6-89de-c3ab0cbf45da',
1021
- code: 'read_webhooks',
1022
- label: 'Read Webhooks',
1023
- resource: 'webhooks',
1024
- createdAt: '2026-02-01T12:21:16.738Z',
1025
- description: 'View webhook subscriptions — see which events the app is listening to.',
1026
- use_cases: ['Webhook management dashboards', 'Integration health monitoring'],
1027
- commonly_paired_with: ['read_orders', 'read_products'],
1028
- },
1029
- {
1030
- id: '702ae668-59b6-48c2-9a92-92c39fbb63c8',
1031
- code: 'write_webhooks',
1032
- label: 'Write Webhooks',
1033
- resource: 'webhooks',
1034
- createdAt: '2026-02-01T12:21:17.139Z',
1035
- description: 'Create and manage webhook subscriptions — register URLs for real-time event notifications. Includes read_webhooks.',
1036
- use_cases: [
1037
- 'Register for order/product/app events',
1038
- 'Integration setup automation',
1039
- 'Real-time sync with external systems',
1040
- ],
1041
- commonly_paired_with: ['read_orders', 'read_products'],
1042
- },
1043
- {
1044
- id: '64e22053-7dee-4417-816a-5e78ac954e3d',
1045
- code: 'delete_webhooks',
1046
- label: 'Delete Webhooks',
1047
- resource: 'webhooks',
1048
- createdAt: '2026-02-01T12:21:17.280Z',
1049
- description: 'Delete webhook subscriptions. Includes all webhooks permissions.',
1050
- use_cases: ['Webhook cleanup during app uninstall'],
1051
- commonly_paired_with: ['write_webhooks'],
1052
- },
383
+ { id: 'c24d33fd-60ac-4f4a-af8f-9e28ad9fe206', code: 'read_publications', label: 'Read Publications', resource: 'publications', createdAt: '2026-02-11T18:44:12.448Z' },
384
+ { id: 'b0b37d25-d913-4485-9965-6e646fc04217', code: 'write_publications', label: 'Write Publications', resource: 'publications', createdAt: '2026-02-11T18:44:12.257Z' },
1053
385
  ],
1054
- apps: [
1055
- {
1056
- id: '9bca0790-64e0-48e3-af0a-4b94ebc42bff',
1057
- code: 'read_apps',
1058
- label: 'Read Apps',
1059
- resource: 'apps',
1060
- createdAt: '2026-02-12T08:46:22.240Z',
1061
- description: 'View installed apps on the merchant\'s store.',
1062
- use_cases: ['Integration platform dashboards', 'App compatibility checks'],
1063
- commonly_paired_with: [],
1064
- },
386
+ purchase_options: [
387
+ { id: 'fe9ac286-8dfe-4a77-aa00-c7162a2123ae', code: 'read_purchase_options', label: 'Read Purchase Options', resource: 'purchase_options', createdAt: '2026-02-11T18:44:12.912Z' },
388
+ { id: '5e0456c4-2dee-4060-9ecb-3d7d79e2c87d', code: 'write_purchase_options', label: 'Write Purchase Options', resource: 'purchase_options', createdAt: '2026-02-11T18:44:12.674Z' },
389
+ ],
390
+ reports: [
391
+ { id: '23354dee-c19e-4586-8600-bcdb6eb348b8', code: 'read_reports', label: 'Read Reports', resource: 'reports', createdAt: '2026-02-11T18:44:13.362Z' },
392
+ { id: 'eac51778-6feb-4a18-b8b7-f4f2834efa75', code: 'write_reports', label: 'Write Reports', resource: 'reports', createdAt: '2026-02-11T18:44:13.133Z' },
393
+ ],
394
+ resource_feedbacks: [
395
+ { id: '41a5a226-f660-456d-a39f-e13f49ce2790', code: 'read_resource_feedbacks', label: 'Read Resource Feedbacks', resource: 'resource_feedbacks', createdAt: '2026-02-11T18:44:13.823Z' },
396
+ { id: '9f4220e3-ab40-4676-9811-be2ac90ecc2b', code: 'write_resource_feedbacks', label: 'Write Resource Feedbacks', resource: 'resource_feedbacks', createdAt: '2026-02-11T18:44:13.592Z' },
397
+ ],
398
+ returns: [
399
+ { id: '14da388e-3180-4053-8003-b4c7ec18afca', code: 'read_returns', label: 'Read Returns', resource: 'returns', createdAt: '2026-02-11T18:44:14.227Z' },
400
+ { id: 'e7fd72c5-84fe-4bf6-99ab-2e7e99f82479', code: 'write_returns', label: 'Write Returns', resource: 'returns', createdAt: '2026-02-11T18:44:14.043Z' },
401
+ ],
402
+ script_tags: [
403
+ { id: '4c7ad79a-2549-425e-ab8d-b687049d346c', code: 'read_script_tags', label: 'Read Script Tags', resource: 'script_tags', createdAt: '2026-02-11T18:44:15.032Z' },
404
+ { id: 'fc47c892-bb35-433b-8d61-f17b94a4b198', code: 'write_script_tags', label: 'Write Script Tags', resource: 'script_tags', createdAt: '2026-02-11T18:44:14.802Z' },
405
+ ],
406
+ shipping: [
407
+ { id: '0a549fad-2dec-4ae1-9cb1-07bfba0fecb0', code: 'read_shipping', label: 'Read Shipping', resource: 'shipping', createdAt: '2026-02-11T18:44:15.413Z' },
408
+ { id: 'b8bcff7d-fb23-4a72-a2ec-bdb821ef62d5', code: 'write_shipping', label: 'Write Shipping', resource: 'shipping', createdAt: '2026-02-11T18:44:15.239Z' },
409
+ ],
410
+ shopify_payments_accounts: [
411
+ { id: 'f57af6b6-a026-4653-a74c-83bad8a2f7a6', code: 'read_shopify_payments_accounts', label: 'Read Shopify Payments Accounts', resource: 'shopify_payments_accounts', createdAt: '2026-02-11T18:44:16.482Z' },
412
+ ],
413
+ shopify_payments_bank_accounts: [
414
+ { id: '5c1ae3bf-db97-496a-b3c9-6cd36746f584', code: 'read_shopify_payments_bank_accounts', label: 'Read Shopify Payments Bank Accounts', resource: 'shopify_payments_bank_accounts', createdAt: '2026-02-11T18:44:16.701Z' },
415
+ ],
416
+ shopify_payments_disputes: [
417
+ { id: '6af98f3f-f182-4ddb-8679-d227972ccd90', code: 'read_shopify_payments_disputes', label: 'Read Shopify Payments Disputes', resource: 'shopify_payments_disputes', createdAt: '2026-02-11T18:44:17.151Z' },
418
+ { id: 'cf6c2118-925b-425e-8f8c-0f4d1be827b9', code: 'write_shopify_payments_disputes', label: 'Write Shopify Payments Disputes', resource: 'shopify_payments_disputes', createdAt: '2026-02-11T18:44:16.931Z' },
419
+ ],
420
+ shopify_payments_payouts: [
421
+ { id: 'c893ca1c-0a68-419d-a7fd-43afb4714891', code: 'read_shopify_payments_payouts', label: 'Read Shopify Payments Payouts', resource: 'shopify_payments_payouts', createdAt: '2026-02-11T18:44:17.402Z' },
422
+ ],
423
+ shopify_payments_provider_accounts_sensitive: [
424
+ { id: '02549157-84d1-4c9b-8833-9b7a4b7f0245', code: 'read_shopify_payments_provider_accounts_sensitive', label: 'Read Shopify Payments Provider Accounts Sensitive', resource: 'shopify_payments_provider_accounts_sensitive', createdAt: '2026-02-11T18:44:27.714Z' },
425
+ ],
426
+ store_credit_account_transactions: [
427
+ { id: 'f7721d19-1583-4393-9fd5-d483eea4ca91', code: 'read_store_credit_account_transactions', label: 'Read Store Credit Account Transactions', resource: 'store_credit_account_transactions', createdAt: '2026-02-11T18:44:18.292Z' },
428
+ { id: 'e278b387-2077-4673-92e2-a7ebb673c61d', code: 'write_store_credit_account_transactions', label: 'Write Store Credit Account Transactions', resource: 'store_credit_account_transactions', createdAt: '2026-02-11T18:44:18.072Z' },
429
+ ],
430
+ store_credit_accounts: [
431
+ { id: 'b8b124fe-6880-47ee-92bd-4c4f4f8c9a23', code: 'read_store_credit_accounts', label: 'Read Store Credit Accounts', resource: 'store_credit_accounts', createdAt: '2026-02-11T18:44:18.512Z' },
432
+ ],
433
+ theme_code: [
434
+ { id: 'f514b197-41a5-4ec0-b114-ed4a26b90f15', code: 'write_theme_code', label: 'Write Theme Code', resource: 'theme_code', createdAt: '2026-02-11T18:44:27.954Z' },
435
+ ],
436
+ themes: [
437
+ { id: '851d9fbf-ed62-4e72-8011-75d6d7b0e3b4', code: 'read_themes', label: 'Read Themes', resource: 'themes', createdAt: '2026-02-11T18:44:18.963Z' },
438
+ { id: '40119c82-f368-45e4-bdbb-c55d71fffbd5', code: 'write_themes', label: 'Write Themes', resource: 'themes', createdAt: '2026-02-11T18:44:18.733Z' },
439
+ ],
440
+ third_party_fulfillment_orders: [
441
+ { id: '53a4efcc-a527-4226-8119-3793b8d3b505', code: 'read_third_party_fulfillment_orders', label: 'Read Third Party Fulfillment Orders', resource: 'third_party_fulfillment_orders', createdAt: '2026-02-11T18:44:19.432Z' },
442
+ { id: '9072d1ce-31ff-4ca1-8912-6c19e32d72b9', code: 'write_third_party_fulfillment_orders', label: 'Write Third Party Fulfillment Orders', resource: 'third_party_fulfillment_orders', createdAt: '2026-02-11T18:44:19.184Z' },
443
+ ],
444
+ translations: [
445
+ { id: '10387a0f-41c1-477e-9e6e-2318c3ab95ca', code: 'read_translations', label: 'Read Translations', resource: 'translations', createdAt: '2026-02-11T18:44:19.862Z' },
446
+ { id: 'a551725a-11b5-44b7-8538-4e3194a54e97', code: 'write_translations', label: 'Write Translations', resource: 'translations', createdAt: '2026-02-11T18:44:19.615Z' },
447
+ ],
448
+ validations: [
449
+ { id: '3b2a6efc-8f61-43b5-9f5f-bd8abfa687e0', code: 'read_validations', label: 'Read Validations', resource: 'validations', createdAt: '2026-02-11T18:44:28.424Z' },
450
+ { id: '8d2bf591-425c-46dd-84c0-cab0c42dab6b', code: 'write_validations', label: 'Write Validations', resource: 'validations', createdAt: '2026-02-11T18:44:28.182Z' },
1065
451
  ],
1066
452
  };
1067
453
  /**
@@ -1079,4 +465,10 @@ export function getResourceForScope(code) {
1079
465
  }
1080
466
  return undefined;
1081
467
  }
468
+ /**
469
+ * Get all resource names (all 78).
470
+ */
471
+ export function getAllResources() {
472
+ return Object.keys(SCOPES_BY_RESOURCE);
473
+ }
1082
474
  //# sourceMappingURL=scopes-data.js.map