@cloudcart/dev-mcp 0.2.15 → 0.2.16

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.
package/data/admin.json CHANGED
@@ -5924,6 +5924,68 @@
5924
5924
  "isDeprecated": false,
5925
5925
  "deprecationReason": null
5926
5926
  },
5927
+ {
5928
+ "name": "storefrontWidgets",
5929
+ "description": "List all configurable storefront widgets (theme modules) for the current\nsite / theme, each tagged with its origin (CORE / THEME / APP) plus its\ncurrent settings, defaults and validation schema.\n\nUse this — not the page builder `availableWidgets` query, which covers a\ndifferent widget system — to discover and audit the storefront modules a\nsite exposes.",
5930
+ "args": [
5931
+ {
5932
+ "name": "filter",
5933
+ "description": "Filters for narrowing results.",
5934
+ "type": {
5935
+ "kind": "INPUT_OBJECT",
5936
+ "name": "StorefrontWidgetFilterInput",
5937
+ "ofType": null
5938
+ },
5939
+ "defaultValue": null
5940
+ }
5941
+ ],
5942
+ "type": {
5943
+ "kind": "NON_NULL",
5944
+ "name": null,
5945
+ "ofType": {
5946
+ "kind": "LIST",
5947
+ "name": null,
5948
+ "ofType": {
5949
+ "kind": "NON_NULL",
5950
+ "name": null,
5951
+ "ofType": {
5952
+ "kind": "OBJECT",
5953
+ "name": "StorefrontWidget",
5954
+ "ofType": null
5955
+ }
5956
+ }
5957
+ }
5958
+ },
5959
+ "isDeprecated": false,
5960
+ "deprecationReason": null
5961
+ },
5962
+ {
5963
+ "name": "storefrontWidget",
5964
+ "description": "Find a single storefront widget by its mapping (e.g. 'layout.header').",
5965
+ "args": [
5966
+ {
5967
+ "name": "mapping",
5968
+ "description": "Widget mapping.",
5969
+ "type": {
5970
+ "kind": "NON_NULL",
5971
+ "name": null,
5972
+ "ofType": {
5973
+ "kind": "SCALAR",
5974
+ "name": "String",
5975
+ "ofType": null
5976
+ }
5977
+ },
5978
+ "defaultValue": null
5979
+ }
5980
+ ],
5981
+ "type": {
5982
+ "kind": "OBJECT",
5983
+ "name": "StorefrontWidget",
5984
+ "ofType": null
5985
+ },
5986
+ "isDeprecated": false,
5987
+ "deprecationReason": null
5988
+ },
5927
5989
  {
5928
5990
  "name": "generalSettings",
5929
5991
  "description": "Get general store settings.",
@@ -27427,6 +27489,82 @@
27427
27489
  "isDeprecated": false,
27428
27490
  "deprecationReason": null
27429
27491
  },
27492
+ {
27493
+ "name": "saveStorefrontWidgetSettings",
27494
+ "description": "Save settings for a storefront widget. The settings object is validated\nagainst the widget's settingsSchema using the same backend rules as the\nstorefront admin (App\\\\Helper\\\\Validator); rejected fields are reported as a\n422 validation error. Plan-gated widgets require the matching paid feature.\nReturns the updated widget.",
27495
+ "args": [
27496
+ {
27497
+ "name": "mapping",
27498
+ "description": "Widget mapping (e.g. 'layout.header').",
27499
+ "type": {
27500
+ "kind": "NON_NULL",
27501
+ "name": null,
27502
+ "ofType": {
27503
+ "kind": "SCALAR",
27504
+ "name": "String",
27505
+ "ofType": null
27506
+ }
27507
+ },
27508
+ "defaultValue": null
27509
+ },
27510
+ {
27511
+ "name": "settings",
27512
+ "description": "Settings object — keys must match the widget's settingsSchema.",
27513
+ "type": {
27514
+ "kind": "NON_NULL",
27515
+ "name": null,
27516
+ "ofType": {
27517
+ "kind": "SCALAR",
27518
+ "name": "JSON",
27519
+ "ofType": null
27520
+ }
27521
+ },
27522
+ "defaultValue": null
27523
+ }
27524
+ ],
27525
+ "type": {
27526
+ "kind": "NON_NULL",
27527
+ "name": null,
27528
+ "ofType": {
27529
+ "kind": "OBJECT",
27530
+ "name": "StorefrontWidget",
27531
+ "ofType": null
27532
+ }
27533
+ },
27534
+ "isDeprecated": false,
27535
+ "deprecationReason": null
27536
+ },
27537
+ {
27538
+ "name": "resetStorefrontWidgetSettings",
27539
+ "description": "Reset a storefront widget to its default settings (removes the saved override). Returns the reset widget.",
27540
+ "args": [
27541
+ {
27542
+ "name": "mapping",
27543
+ "description": "Widget mapping (e.g. 'layout.header').",
27544
+ "type": {
27545
+ "kind": "NON_NULL",
27546
+ "name": null,
27547
+ "ofType": {
27548
+ "kind": "SCALAR",
27549
+ "name": "String",
27550
+ "ofType": null
27551
+ }
27552
+ },
27553
+ "defaultValue": null
27554
+ }
27555
+ ],
27556
+ "type": {
27557
+ "kind": "NON_NULL",
27558
+ "name": null,
27559
+ "ofType": {
27560
+ "kind": "OBJECT",
27561
+ "name": "StorefrontWidget",
27562
+ "ofType": null
27563
+ }
27564
+ },
27565
+ "isDeprecated": false,
27566
+ "deprecationReason": null
27567
+ },
27430
27568
  {
27431
27569
  "name": "updateGeneralSettings",
27432
27570
  "description": "Update general store settings.",
@@ -48538,6 +48676,29 @@
48538
48676
  "isDeprecated": false,
48539
48677
  "deprecationReason": null
48540
48678
  },
48679
+ {
48680
+ "name": "imageUrl",
48681
+ "description": "Thumbnail URL for the main product image. Pass a size string (e.g. '150x150') or omit for the original.",
48682
+ "args": [
48683
+ {
48684
+ "name": "size",
48685
+ "description": null,
48686
+ "type": {
48687
+ "kind": "SCALAR",
48688
+ "name": "String",
48689
+ "ofType": null
48690
+ },
48691
+ "defaultValue": "\"150x150\""
48692
+ }
48693
+ ],
48694
+ "type": {
48695
+ "kind": "SCALAR",
48696
+ "name": "String",
48697
+ "ofType": null
48698
+ },
48699
+ "isDeprecated": false,
48700
+ "deprecationReason": null
48701
+ },
48541
48702
  {
48542
48703
  "name": "p1Parameter",
48543
48704
  "description": "Parameter 1 definition (if applicable).",
@@ -84817,6 +84978,238 @@
84817
84978
  "enumValues": null,
84818
84979
  "possibleTypes": null
84819
84980
  },
84981
+ {
84982
+ "kind": "ENUM",
84983
+ "name": "StorefrontWidgetSource",
84984
+ "description": "Where a storefront widget (module) originates.",
84985
+ "fields": null,
84986
+ "inputFields": null,
84987
+ "interfaces": null,
84988
+ "enumValues": [
84989
+ {
84990
+ "name": "CORE",
84991
+ "description": "Platform default widget, available regardless of the active theme.",
84992
+ "isDeprecated": false,
84993
+ "deprecationReason": null
84994
+ },
84995
+ {
84996
+ "name": "THEME",
84997
+ "description": "Defined by the active theme.",
84998
+ "isDeprecated": false,
84999
+ "deprecationReason": null
85000
+ },
85001
+ {
85002
+ "name": "APP",
85003
+ "description": "Provided by an installed app / integration.",
85004
+ "isDeprecated": false,
85005
+ "deprecationReason": null
85006
+ }
85007
+ ],
85008
+ "possibleTypes": null
85009
+ },
85010
+ {
85011
+ "kind": "OBJECT",
85012
+ "name": "StorefrontWidget",
85013
+ "description": "A storefront widget (theme module) — the configurable blocks listed under\nStorefront → Widgets in the admin. Mirrors the BuilderWidget shape (map,\ndefaultSettings, settingsSchema) and adds the widget's origin (`source`),\nwhether it is editable / plan-gated, and its current effective `settings`.",
85014
+ "fields": [
85015
+ {
85016
+ "name": "mapping",
85017
+ "description": "Stable widget identifier — pass this to the save / reset mutations (e.g. 'layout.header', 'store.cart').",
85018
+ "args": [],
85019
+ "type": {
85020
+ "kind": "NON_NULL",
85021
+ "name": null,
85022
+ "ofType": {
85023
+ "kind": "SCALAR",
85024
+ "name": "String",
85025
+ "ofType": null
85026
+ }
85027
+ },
85028
+ "isDeprecated": false,
85029
+ "deprecationReason": null
85030
+ },
85031
+ {
85032
+ "name": "map",
85033
+ "description": "Internal widget map (the lib\\widget map), when it differs from `mapping`.",
85034
+ "args": [],
85035
+ "type": {
85036
+ "kind": "SCALAR",
85037
+ "name": "String",
85038
+ "ofType": null
85039
+ },
85040
+ "isDeprecated": false,
85041
+ "deprecationReason": null
85042
+ },
85043
+ {
85044
+ "name": "name",
85045
+ "description": "Human-readable, translated widget name.",
85046
+ "args": [],
85047
+ "type": {
85048
+ "kind": "NON_NULL",
85049
+ "name": null,
85050
+ "ofType": {
85051
+ "kind": "SCALAR",
85052
+ "name": "String",
85053
+ "ofType": null
85054
+ }
85055
+ },
85056
+ "isDeprecated": false,
85057
+ "deprecationReason": null
85058
+ },
85059
+ {
85060
+ "name": "description",
85061
+ "description": "Translated widget description.",
85062
+ "args": [],
85063
+ "type": {
85064
+ "kind": "SCALAR",
85065
+ "name": "String",
85066
+ "ofType": null
85067
+ },
85068
+ "isDeprecated": false,
85069
+ "deprecationReason": null
85070
+ },
85071
+ {
85072
+ "name": "category",
85073
+ "description": "Category the widget is grouped under (store, user, blog, contact, extra, custom, layout).",
85074
+ "args": [],
85075
+ "type": {
85076
+ "kind": "NON_NULL",
85077
+ "name": null,
85078
+ "ofType": {
85079
+ "kind": "SCALAR",
85080
+ "name": "String",
85081
+ "ofType": null
85082
+ }
85083
+ },
85084
+ "isDeprecated": false,
85085
+ "deprecationReason": null
85086
+ },
85087
+ {
85088
+ "name": "group",
85089
+ "description": "Optional sub-group within the category.",
85090
+ "args": [],
85091
+ "type": {
85092
+ "kind": "SCALAR",
85093
+ "name": "String",
85094
+ "ofType": null
85095
+ },
85096
+ "isDeprecated": false,
85097
+ "deprecationReason": null
85098
+ },
85099
+ {
85100
+ "name": "source",
85101
+ "description": "Where the widget comes from: CORE (platform), THEME (active theme) or APP (installed app).",
85102
+ "args": [],
85103
+ "type": {
85104
+ "kind": "NON_NULL",
85105
+ "name": null,
85106
+ "ofType": {
85107
+ "kind": "ENUM",
85108
+ "name": "StorefrontWidgetSource",
85109
+ "ofType": null
85110
+ }
85111
+ },
85112
+ "isDeprecated": false,
85113
+ "deprecationReason": null
85114
+ },
85115
+ {
85116
+ "name": "editable",
85117
+ "description": "Whether the widget's settings can be edited.",
85118
+ "args": [],
85119
+ "type": {
85120
+ "kind": "NON_NULL",
85121
+ "name": null,
85122
+ "ofType": {
85123
+ "kind": "SCALAR",
85124
+ "name": "Boolean",
85125
+ "ofType": null
85126
+ }
85127
+ },
85128
+ "isDeprecated": false,
85129
+ "deprecationReason": null
85130
+ },
85131
+ {
85132
+ "name": "isPaid",
85133
+ "description": "Whether the widget is gated behind a paid plan feature.",
85134
+ "args": [],
85135
+ "type": {
85136
+ "kind": "NON_NULL",
85137
+ "name": null,
85138
+ "ofType": {
85139
+ "kind": "SCALAR",
85140
+ "name": "Boolean",
85141
+ "ofType": null
85142
+ }
85143
+ },
85144
+ "isDeprecated": false,
85145
+ "deprecationReason": null
85146
+ },
85147
+ {
85148
+ "name": "paidFeature",
85149
+ "description": "Plan feature key required to configure the widget when `isPaid` is true.",
85150
+ "args": [],
85151
+ "type": {
85152
+ "kind": "SCALAR",
85153
+ "name": "String",
85154
+ "ofType": null
85155
+ },
85156
+ "isDeprecated": false,
85157
+ "deprecationReason": null
85158
+ },
85159
+ {
85160
+ "name": "settings",
85161
+ "description": "Current effective settings (saved overrides merged with the defaults).",
85162
+ "args": [],
85163
+ "type": {
85164
+ "kind": "NON_NULL",
85165
+ "name": null,
85166
+ "ofType": {
85167
+ "kind": "SCALAR",
85168
+ "name": "JSON",
85169
+ "ofType": null
85170
+ }
85171
+ },
85172
+ "isDeprecated": false,
85173
+ "deprecationReason": null
85174
+ },
85175
+ {
85176
+ "name": "defaultSettings",
85177
+ "description": "Default settings template for the widget.",
85178
+ "args": [],
85179
+ "type": {
85180
+ "kind": "NON_NULL",
85181
+ "name": null,
85182
+ "ofType": {
85183
+ "kind": "SCALAR",
85184
+ "name": "JSON",
85185
+ "ofType": null
85186
+ }
85187
+ },
85188
+ "isDeprecated": false,
85189
+ "deprecationReason": null
85190
+ },
85191
+ {
85192
+ "name": "settingsSchema",
85193
+ "description": "Settings validation schema. Keys are setting names, values are restriction rules:\n- false: no validation\n- 'bool': boolean\n- 'char:min,max': string length\n- 'int:min,max': integer range\n- 'in:val1,val2': enum\n- 'url': URL validation\nThe save mutation enforces these exactly as the storefront admin does.",
85194
+ "args": [],
85195
+ "type": {
85196
+ "kind": "NON_NULL",
85197
+ "name": null,
85198
+ "ofType": {
85199
+ "kind": "SCALAR",
85200
+ "name": "JSON",
85201
+ "ofType": null
85202
+ }
85203
+ },
85204
+ "isDeprecated": false,
85205
+ "deprecationReason": null
85206
+ }
85207
+ ],
85208
+ "inputFields": null,
85209
+ "interfaces": [],
85210
+ "enumValues": null,
85211
+ "possibleTypes": null
85212
+ },
84820
85213
  {
84821
85214
  "kind": "INPUT_OBJECT",
84822
85215
  "name": "CreatePageInput",
@@ -85531,6 +85924,47 @@
85531
85924
  ],
85532
85925
  "possibleTypes": null
85533
85926
  },
85927
+ {
85928
+ "kind": "INPUT_OBJECT",
85929
+ "name": "StorefrontWidgetFilterInput",
85930
+ "description": "Filters for the storefrontWidgets query.",
85931
+ "fields": null,
85932
+ "inputFields": [
85933
+ {
85934
+ "name": "category",
85935
+ "description": "Keep only widgets in this category (store, user, blog, contact, extra, custom, layout).",
85936
+ "type": {
85937
+ "kind": "SCALAR",
85938
+ "name": "String",
85939
+ "ofType": null
85940
+ },
85941
+ "defaultValue": null
85942
+ },
85943
+ {
85944
+ "name": "source",
85945
+ "description": "Keep only widgets from this origin (CORE / THEME / APP).",
85946
+ "type": {
85947
+ "kind": "ENUM",
85948
+ "name": "StorefrontWidgetSource",
85949
+ "ofType": null
85950
+ },
85951
+ "defaultValue": null
85952
+ },
85953
+ {
85954
+ "name": "editableOnly",
85955
+ "description": "Keep only editable widgets. The listing is already limited to editable widgets, so this is normally a no-op.",
85956
+ "type": {
85957
+ "kind": "SCALAR",
85958
+ "name": "Boolean",
85959
+ "ofType": null
85960
+ },
85961
+ "defaultValue": null
85962
+ }
85963
+ ],
85964
+ "interfaces": null,
85965
+ "enumValues": null,
85966
+ "possibleTypes": null
85967
+ },
85534
85968
  {
85535
85969
  "kind": "ENUM",
85536
85970
  "name": "TaxType",
Binary file