@swell/cli 2.5.8 → 2.7.0

package/oclif.manifest.json

@@ -385,6 +385,7 @@
       "examples": [
         "swell api delete /products/abc123",
         "swell api delete /functions/my-app/clear-cache",
+        "swell api delete /functions/my-app/clear-cache -H 'Authorization: Bearer xxx'",
         "swell api delete /products/abc123 --api frontend"
       ],
       "flags": {
@@ -405,6 +406,14 @@
             "frontend"
           ],
           "type": "option"
+        },
+        "header": {
+          "char": "H",
+          "description": "HTTP header to forward to a function (format: 'Name: value'). Repeat for multiple. Only applies to /functions/* paths.",
+          "name": "header",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -438,6 +447,7 @@
         "swell api get \"/products?limit=10&category=shoes\"",
         "swell api get /products/abc123",
         "swell api get /functions/my-app/get-inventory",
+        "swell api get /functions/my-app/get-inventory -H 'Authorization: Bearer xxx'",
         "swell api get /products --api frontend"
       ],
       "flags": {
@@ -458,6 +468,14 @@
             "frontend"
           ],
           "type": "option"
+        },
+        "header": {
+          "char": "H",
+          "description": "HTTP header to forward to a function (format: 'Name: value'). Repeat for multiple. Only applies to /functions/* paths.",
+          "name": "header",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -521,6 +539,7 @@
         "swell api post /products --body '{\"name\": \"Product\", \"price\": 100}'",
         "swell api post /products --body ./product.json",
         "swell api post /functions/my-app/create-order --body '{\"items\":[\"sku-1\"]}'",
+        "swell api post /functions/my-app/webhook --body @./payload.json -H 'Stripe-Signature: t=123,v1=abc'",
         "swell api post /products --body '{\"name\": \"Product\"}' --api frontend"
       ],
       "flags": {
@@ -548,6 +567,14 @@
             "frontend"
           ],
           "type": "option"
+        },
+        "header": {
+          "char": "H",
+          "description": "HTTP header to forward to a function (format: 'Name: value'). Repeat for multiple. Only applies to /functions/* paths.",
+          "name": "header",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -580,6 +607,7 @@
         "swell api put /products/{id} --body '{\"id\": \"abc123\", \"name\": \"Updated\"}'",
         "swell api put /products/abc123 --body ./product.json",
         "swell api put /functions/my-app/update-stock --body '{\"sku\":\"abc\",\"qty\":10}'",
+        "swell api put /functions/my-app/update-stock --body '{\"sku\":\"abc\"}' -H 'X-Idempotency-Key: 42'",
         "swell api put /products/abc123 --body '{\"name\": \"Updated\"}' --api frontend"
       ],
       "flags": {
@@ -607,6 +635,14 @@
             "frontend"
           ],
           "type": "option"
+        },
+        "header": {
+          "char": "H",
+          "description": "HTTP header to forward to a function (format: 'Name: value'). Repeat for multiple. Only applies to /functions/* paths.",
+          "name": "header",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -822,16 +858,18 @@
       ],
       "flags": {
         "frontend": {
-          "description": "Framework: astro | angular | hono | nuxt | nextjs | none",
+          "description": "Framework: nextjs | astro | nuxt | react | hono | angular | react-storefront | none",
           "name": "frontend",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
+            "nextjs",
             "astro",
-            "angular",
-            "hono",
             "nuxt",
-            "nextjs",
+            "react",
+            "hono",
+            "angular",
+            "react-storefront",
             "none"
           ],
           "type": "option"
@@ -1380,16 +1418,18 @@
       ],
       "flags": {
         "frontend": {
-          "description": "Framework: astro | angular | hono | nuxt | nextjs | none",
+          "description": "Framework: nextjs | astro | nuxt | react | hono | angular | react-storefront | none",
           "name": "frontend",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
+            "nextjs",
             "astro",
-            "angular",
-            "hono",
             "nuxt",
-            "nextjs",
+            "react",
+            "hono",
+            "angular",
+            "react-storefront",
             "none"
           ],
           "type": "option"
@@ -1649,16 +1689,18 @@
       ],
       "flags": {
         "frontend": {
-          "description": "Framework: astro | angular | hono | nuxt | nextjs | none",
+          "description": "Framework: nextjs | astro | nuxt | react | hono | angular | react-storefront | none",
           "name": "frontend",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
+            "nextjs",
             "astro",
-            "angular",
-            "hono",
             "nuxt",
-            "nextjs",
+            "react",
+            "hono",
+            "angular",
+            "react-storefront",
             "none"
           ],
           "type": "option"
@@ -2307,29 +2349,45 @@
     "inspect:content": {
       "aliases": [],
       "args": {
-        "content-id": {
-          "description": "Optional content view ID. Example: custom.admin.products, app.myapp.products",
-          "name": "content-id",
+        "identifier": {
+          "description": "Resource identifier — see \"Identifier forms\" below.",
+          "name": "identifier",
           "required": false
         }
       },
-      "description": "\nView content view extensions available in your Swell store.\n\nWithout a content ID, this command lists all available content views.\nWith a content ID, it retrieves the configuration for that specific content view in JSON format.\n",
+      "description": "Lists content view extensions across all apps plus platform 'custom' sources, grouped by owner. Pass --app=<slug> or --app=. (current swell.json) to scope.\n\nPass an identifier to view a single record as JSON.\n\nIdentifier forms:\n  app.<app>.<name>         — app-owned view (list column 1)\n  custom.<source>.<name>   — platform custom view (e.g. custom.admin.products)\n  <name>                   — requires --app= scope\n",
       "examples": [
         "swell inspect content",
-        "swell inspect content custom.admin.products",
+        "swell inspect content --app=my-app",
         "swell inspect content app.honest_reviews.reviews",
-        "swell inspect content app.myapp.products --live"
+        "swell inspect content custom.admin.products",
+        "swell inspect content reviews --app=honest_reviews",
+        "swell inspect content --live"
       ],
       "flags": {
+        "app": {
+          "description": "Filter by app slug, or \".\" for current swell.json.",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "live": {
-          "description": "Use the live environment instead of test (default: test).",
+          "description": "Use live environment (default: test).",
           "name": "live",
           "allowNo": false,
           "type": "boolean"
         },
+        "json": {
+          "description": "Emit pure JSON without the \"Next steps\" footer. Detail mode only.",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "yes": {
           "char": "y",
-          "description": "Accept all prompts automatically (for agent compatibility; no functional effect).",
+          "description": "No-op; accepted for agent compatibility.",
+          "hidden": true,
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
@@ -2342,8 +2400,7 @@
       "pluginName": "@swell/cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Inspect content view extensions deployed in your store.",
-      "enableJsonFlag": false,
+      "summary": "App and platform content views.",
       "isESM": true,
       "relativePath": [
         "dist",
@@ -2352,14 +2409,79 @@
         "content.js"
       ]
     },
+    "inspect:functions": {
+      "aliases": [],
+      "args": {
+        "identifier": {
+          "description": "Resource identifier — see \"Identifier forms\" below.",
+          "name": "identifier",
+          "required": false
+        }
+      },
+      "description": "Lists functions across all apps, grouped by app. Pass --app=<slug> or --app=. (current swell.json) to scope.\n\nList output: paste-back key + status (disabled, trigger, next cron run, last failure).\n\nPass an identifier to view a single record as JSON.\n\nIdentifier forms:\n  app.<app>.<name>     — full paste-back key (list column 1)\n  <name>               — requires --app= scope\n  <24-char id>         — any scope\n",
+      "examples": [
+        "swell inspect functions",
+        "swell inspect functions --app=my-app",
+        "swell inspect functions app.my-app.payment-sync",
+        "swell inspect functions payment-sync --app=my-app",
+        "swell inspect functions --live"
+      ],
+      "flags": {
+        "app": {
+          "description": "Filter by app slug, or \".\" for current swell.json.",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "live": {
+          "description": "Use live environment (default: test).",
+          "name": "live",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Emit pure JSON without the \"Next steps\" footer. Detail mode only.",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "No-op; accepted for agent compatibility.",
+          "hidden": true,
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "inspect:functions",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Functions with scheduling and trigger state.",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "inspect",
+        "functions.js"
+      ]
+    },
     "inspect": {
       "aliases": [],
       "args": {},
-      "description": "View configuration and data for deployed resources.\n\nInspect models, content views, and other deployed artifacts in your Swell store.",
+      "description": "Subcommands list globally and group by app. Pass --app=<slug> or --app=. (current swell.json) to scope. Pass an identifier to print the full record as JSON, followed by a \"Next steps\" footer of related commands. Use --json to omit the footer for piping.\n",
       "examples": [
-        "swell inspect models",
         "swell inspect models /products",
-        "swell inspect models /apps/myapp/orders"
+        "swell inspect content app.honest_reviews.reviews",
+        "swell inspect webhooks --app=my-app",
+        "swell inspect functions app.my-app.payment-sync",
+        "swell inspect notifications com.orders.receipt.v2",
+        "swell inspect settings app.my-app"
       ],
       "flags": {},
       "hasDynamicHelp": false,
@@ -2388,24 +2510,40 @@
           "required": false
         }
       },
-      "description": "\nView models for collections available in your Swell store.\n\nWithout a collection path, this command lists all available collections grouped by type.\nWith a collection path, it retrieves the model for that specific collection in JSON format.\n",
+      "description": "Lists all collections grouped by type. Pass --app=<slug> or --app=. (current swell.json) to filter to one app's models.\n\nPass a collection path to view a single model as JSON. Paths are fully qualified, so --app is ignored in detail mode.\n",
       "examples": [
         "swell inspect models",
+        "swell inspect models --app=my-app",
+        "swell inspect models --live",
         "swell inspect models /products",
         "swell inspect models /content/blogs",
         "swell inspect models /apps/myapp/orders",
-        "swell inspect models /orders --live"
+        "swell inspect models /products --json"
       ],
       "flags": {
+        "app": {
+          "description": "Filter by app slug, or \".\" for current swell.json.",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "live": {
-          "description": "Use the live environment instead of test (default: test).",
+          "description": "Use live environment (default: test).",
           "name": "live",
           "allowNo": false,
           "type": "boolean"
         },
+        "json": {
+          "description": "Emit pure JSON without the \"Next steps\" footer. Detail mode only.",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "yes": {
           "char": "y",
-          "description": "Accept all prompts automatically (for agent compatibility; no functional effect).",
+          "description": "No-op; accepted for agent compatibility.",
+          "hidden": true,
           "name": "yes",
           "allowNo": false,
           "type": "boolean"
@@ -2418,7 +2556,7 @@
       "pluginName": "@swell/cli",
       "pluginType": "core",
       "strict": true,
-      "summary": "Inspect models for collections deployed in your store.",
+      "summary": "Collection models and fields (hierarchical).",
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
@@ -2428,6 +2566,195 @@
         "models.js"
       ]
     },
+    "inspect:notifications": {
+      "aliases": [],
+      "args": {
+        "identifier": {
+          "description": "Resource identifier — see \"Identifier forms\" below.",
+          "name": "identifier",
+          "required": false
+        }
+      },
+      "description": "Lists notifications across all apps plus platform 'com.*' system records, grouped by owner. Pass --app=<slug> or --app=. (current swell.json) to scope.\n\nApp keys include the model (app.<slug>.<model>.<name>) since identity is (api, model, name, app_id?) — two notifications in one app can share a name on different models. Own-app prefix apps/<own>/... is stripped in display.\n\nPass an identifier to view a single record as JSON.\n\nIdentifier forms:\n  com.<model>.<name>          — platform record\n  app.<app>.<model>.<name>    — app record (full key)\n  app.<app>.<name>            — legacy; ambiguous → errors with candidates\n  <name>                      — requires --app= scope\n  <24-char id>                — any scope\n",
+      "examples": [
+        "swell inspect notifications",
+        "swell inspect notifications --app=my-app",
+        "swell inspect notifications com.orders.receipt.v2",
+        "swell inspect notifications app.notify_me.subscriptions.back-in-stock",
+        "swell inspect notifications back-in-stock --app=notify_me",
+        "swell inspect notifications --live"
+      ],
+      "flags": {
+        "app": {
+          "description": "Filter by app slug, or \".\" for current swell.json.",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "live": {
+          "description": "Use live environment (default: test).",
+          "name": "live",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Emit pure JSON without the \"Next steps\" footer. Detail mode only.",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "No-op; accepted for agent compatibility.",
+          "hidden": true,
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "inspect:notifications",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Notifications across apps and platform.",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "inspect",
+        "notifications.js"
+      ]
+    },
+    "inspect:settings": {
+      "aliases": [],
+      "args": {
+        "identifier": {
+          "description": "Resource identifier — see \"Identifier forms\" below.",
+          "name": "identifier",
+          "required": false
+        }
+      },
+      "description": "Lists app settings records plus platform 'com.*' system records, grouped by owner. Pass --app=<slug> or --app=. (current swell.json) to scope.\n\nEach app collapses to one settings record at push time, so the list shows one row per app.\n\nPass an identifier to view a single record as JSON.\n\nIdentifier forms:\n  <name>          — system record (e.g. taxes, payments)\n  app.<slug>      — app record\n  com.<name>      — full system id\n  <24-char id>    — direct fetch\n\nDeprecated records (general, admin) are filtered from the list but remain reachable by name.\n",
+      "examples": [
+        "swell inspect settings",
+        "swell inspect settings --app=my-app",
+        "swell inspect settings taxes",
+        "swell inspect settings app.notify_me",
+        "swell inspect settings com.payments",
+        "swell inspect settings --live",
+        "swell inspect settings taxes --json"
+      ],
+      "flags": {
+        "app": {
+          "description": "Filter by app slug, or \".\" for current swell.json.",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "live": {
+          "description": "Use live environment (default: test).",
+          "name": "live",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Emit pure JSON without the \"Next steps\" footer. Detail mode only.",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "No-op; accepted for agent compatibility.",
+          "hidden": true,
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "inspect:settings",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "App and platform settings records.",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "inspect",
+        "settings.js"
+      ]
+    },
+    "inspect:webhooks": {
+      "aliases": [],
+      "args": {
+        "identifier": {
+          "description": "Resource identifier — see \"Identifier forms\" below.",
+          "name": "identifier",
+          "required": false
+        }
+      },
+      "description": "Lists webhooks across all apps, grouped by app. Pass --app=<slug> or --app=. (current swell.json) to scope.\n\nList output: paste-back key + status (disabled, events, failures since date).\n\nPass an identifier to view a single record as JSON.\n\nIdentifier forms:\n  app.<app>.<alias>    — full paste-back key (list column 1)\n  <alias>              — requires --app= scope\n  <24-char id>         — any scope\n",
+      "examples": [
+        "swell inspect webhooks",
+        "swell inspect webhooks --app=my-app",
+        "swell inspect webhooks app.my-app.order-sync",
+        "swell inspect webhooks order-sync --app=my-app",
+        "swell inspect webhooks --live"
+      ],
+      "flags": {
+        "app": {
+          "description": "Filter by app slug, or \".\" for current swell.json.",
+          "name": "app",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "live": {
+          "description": "Use live environment (default: test).",
+          "name": "live",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "description": "Emit pure JSON without the \"Next steps\" footer. Detail mode only.",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "No-op; accepted for agent compatibility.",
+          "hidden": true,
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "inspect:webhooks",
+      "pluginAlias": "@swell/cli",
+      "pluginName": "@swell/cli",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Webhooks with delivery state.",
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "inspect",
+        "webhooks.js"
+      ]
+    },
     "theme:dev": {
       "aliases": [],
       "args": {},
@@ -2534,16 +2861,18 @@
       ],
       "flags": {
         "frontend": {
-          "description": "Framework: astro | angular | hono | nuxt | nextjs | none",
+          "description": "Framework: nextjs | astro | nuxt | react | hono | angular | react-storefront | none",
           "name": "frontend",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
+            "nextjs",
             "astro",
-            "angular",
-            "hono",
             "nuxt",
-            "nextjs",
+            "react",
+            "hono",
+            "angular",
+            "react-storefront",
             "none"
           ],
           "type": "option"
@@ -2969,5 +3298,5 @@
       ]
     }
   },
-  "version": "2.5.8"
+  "version": "2.7.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swell/cli",
-  "version": "2.5.8",
+  "version": "2.7.0",
   "type": "module",
   "description": "Swell's command line interface/utility",
   "keywords": [