@ossy/cli 1.40.0 → 1.40.2

package/README.md

@@ -23,8 +23,8 @@ For one-off use without installing, you can still run `npx @ossy/cli <command>`.
 The contract for everything the platform can do is the **SDK action POJO** in [`@ossy/sdk`](../sdk) (`{ id, endpoint, method, payload }`). The CLI is one channel onto that catalog, organized in three layers:
 
 1. **Local utilities** — no API call, or per-machine state. `auth`, `workspace`, `app init`, `app build`, `app validate`.
-2. **Action dispatcher** — `call <action.id>` invokes any action in the SDK catalog. New endpoints added to the SDK are callable from the terminal with no extra CLI wiring.
-3. **High-level workflows** — verbs that wrap one or more actions and add value the dispatcher doesn't (reading `src/config.js`, formatting output for CI, multi-step pipelines). Each workflow's docs name the underlying action(s) so you can drop down to `ossy call` if you outgrow the verb.
+2. **Action dispatcher** — `invoke <action.id>` invokes any action in the SDK catalog. New endpoints added to the SDK are callable from the terminal with no extra CLI wiring.
+3. **High-level workflows** — verbs that wrap one or more actions and add value the dispatcher doesn't (reading `src/config.js`, formatting output for CI, multi-step pipelines). Each workflow's docs name the underlying action(s) so you can drop down to `ossy invoke` if you outgrow the verb.
 
 | Layer | Command | Description |
 |-------|---------|-------------|
@@ -33,12 +33,12 @@ The contract for everything the platform can do is the **SDK action POJO** in [`
 | Local | `app init [dir]` | Scaffold a new Ossy app (default: current directory) |
 | Local | `app build` | Production build of the app in the current directory |
 | Local | `app validate` | Validate `src/config.js` (`workspaceId`, `resourceTemplates`) without calling the API |
-| Dispatcher | `call <action.id>` | Invoke any Ossy SDK action by id (`ossy call --help` for the full catalog) |
+| Dispatcher | `invoke <action.id>` | Invoke any Ossy SDK action by id (`ossy invoke --help` for the full catalog) |
 | Workflow | `app upload` | Read `resourceTemplates` from `src/config.js` and call `workspaces.import-resource-templates` |
 | Workflow | `app publish` | Upload resource templates and `build/` to the CMS (combines `app upload` + `upload-dir`) |
 | Workflow | `upload-dir <dir> <location>` | Recursively mirror a local directory into the CMS (mkdir + upload per file) |
 
-If you need an endpoint that no verb wraps, reach for `ossy call` — it's the universal channel.
+If you need an endpoint that no verb wraps, reach for `ossy invoke` — it's the universal channel.
 
 ## Auth and active workspace
 
@@ -65,34 +65,34 @@ Resolution order for the workspace id (when a command isn't reading it from `src
 
 So existing CI scripts that set `OSSY_API_KEY` keep working unchanged; you only need `ossy auth login` for interactive use.
 
-## Generic dispatcher: `ossy call`
+## Generic dispatcher: `ossy invoke`
 
-`ossy call` invokes any Ossy API action by id. The action catalog comes from `@ossy/sdk`, so any new endpoint added to the SDK is callable from the terminal with no extra wiring.
+`ossy invoke` invokes any Ossy API action by id. The action catalog comes from `@ossy/sdk`, so any new endpoint added to the SDK is callable from the terminal with no extra wiring.
 
 ```bash
 # Discover what's available
-ossy call --help                                  # full catalog, grouped by domain
-ossy call resources.create --help                 # one action's method, endpoint, default payload
+ossy invoke --help                                  # full catalog, grouped by domain
+ossy invoke resources.create --help                 # one action's method, endpoint, default payload
 
 # Read calls
-ossy call workspaces.get-current
-ossy call resources.list --search 'location=/docs'
+ossy invoke workspaces.get-current
+ossy invoke resources.list --search 'location=/docs'
 
 # Write calls — flag names map to payload keys (--first-name -> firstName)
-ossy call resources.create-directory --location /docs --name images
-ossy call workspaces.invite-user --email teammate@example.com
+ossy invoke resources.create-directory --location /docs --name images
+ossy invoke workspaces.invite-user --email teammate@example.com
 
 # Use --json for nested or non-string payloads
-ossy call resources.update-content --id res_abc --json '{"content":{"title":"Hi"}}'
+ossy invoke resources.update-content --id res_abc --json '{"content":{"title":"Hi"}}'
 
 # Upload a file: --file fills name/type/size as defaults, then PUTs the bytes
 # when the response carries content.uploadUrl (works for resources.upload,
 # resources.upload-named-version, etc.)
-ossy call resources.upload --location /docs --file ./hero.jpg
-ossy call resources.upload-named-version --id res_abc --name medium --file ./hero.jpg
+ossy invoke resources.upload --location /docs --file ./hero.jpg
+ossy invoke resources.upload-named-version --id res_abc --name medium --file ./hero.jpg
 
 # Per-call overrides (otherwise resolved from `ossy auth login` / `ossy workspace use`)
-ossy call workspaces.get-all -a <jwt> --api-url http://localhost:3001/api/v0
+ossy invoke workspaces.get-all -a <jwt> --api-url http://localhost:3001/api/v0
 ```
 
 Output is JSON pretty-printed to stdout on success. Errors go to stderr with a non-zero exit. Add `--raw` to get the response body verbatim (useful for piping non-JSON responses).
@@ -171,7 +171,7 @@ Upload resource templates to your workspace so they can be used in the UI.
 Wraps the SDK action **`workspaces.import-resource-templates`** and adds: reading `resourceTemplates` and `workspaceId` from `src/config.js` (so you don't have to inline the templates JSON yourself). If you already have the templates as a JSON object, the equivalent dispatcher call is:
 
 ```bash
-ossy call workspaces.import-resource-templates --json '{"templates":[…]}'
+ossy invoke workspaces.import-resource-templates --json '{"templates":[…]}'
 ```
 
 Prefer **`--authentication` / `-a`** for the **Ossy API JWT** (same as **`app publish`**); it matches **`OSSY_API_KEY`** in CI.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ossy/cli",
-  "version": "1.40.0",
+  "version": "1.40.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ossy-se/packages.git"
@@ -20,8 +20,8 @@
   },
   "dependencies": {
     "@babel/parser": "^7.28.6",
-    "@ossy/app": "^1.40.0",
-    "@ossy/sdk": "^1.40.0",
+    "@ossy/app": "^1.40.2",
+    "@ossy/sdk": "^1.40.2",
     "arg": "^5.0.2",
     "glob": "^13.0.6"
   },
@@ -33,5 +33,5 @@
     "/src",
     "README.md"
   ],
-  "gitHead": "d9d31182be64a448d575da432af2830d909ad4b9"
+  "gitHead": "2b8745d57fee8b6c08787e2755b4df489291a5cd"
 }

package/src/app/publish.js

@@ -115,7 +115,7 @@ export async function publish (options) {
     const parent = i === 0 ? '/' : '/' + destSegments.slice(0, i).join('/')
     const name = destSegments[i]
     try {
-      await sdk.makeRequest(createDir)({ location: parent, name })
+      await sdk.invoke(createDir, { location: parent, name })
     } catch (err) {
       const status = err && err.status
       if (status !== 409 && status !== 422) {
@@ -133,7 +133,7 @@ export async function publish (options) {
     const parent = normaliseLoc(remoteDest + path.dirname(rel))
     const name = path.basename(d)
     try {
-      await sdk.makeRequest(createDir)({ location: parent, name })
+      await sdk.invoke(createDir, { location: parent, name })
     } catch (err) {
       const status = err && err.status
       if (status !== 409 && status !== 422) {
@@ -164,7 +164,7 @@ export async function publish (options) {
 
     let result
     try {
-      result = await sdk.makeRequest(uploadAction)({
+      result = await sdk.invoke(uploadAction, {
         location: remoteDir,
         name: fileMeta.name,
         type: fileMeta.type,

package/src/call/cli.js

@@ -1,4 +1,5 @@
 import * as Sdk from '@ossy/sdk'
+import { resolveActionId } from '@ossy/sdk'
 import { logError } from '../log.js'
 import { getAuth, getApiUrl, getWorkspaceId } from '../state.js'
 import { prepareFileUpload, uploadFileToUrl } from '../file.js'
@@ -8,16 +9,19 @@ const ACTIONS = Object.values(Sdk).filter(
     v
     && typeof v === 'object'
     && typeof v.id === 'string'
-    && typeof v.endpoint === 'string'
-    && typeof v.method === 'string'
+    && v.id.includes('/')
 )
 
-const ACTION_BY_ID = new Map(ACTIONS.map((a) => [a.id, a]))
+const ACTION_BY_ID = new Map()
+for (const action of ACTIONS) {
+  ACTION_BY_ID.set(action.id, action)
+  ACTION_BY_ID.set(action.id.replace(/\//g, '.'), action)
+}
 
 function listActionsByDomain () {
   const grouped = new Map()
   for (const action of ACTIONS) {
-    const domain = action.id.split('.')[0]
+    const domain = action.id.split('/')[0]
     if (!grouped.has(domain)) grouped.set(domain, [])
     grouped.get(domain).push(action.id)
   }
@@ -31,7 +35,7 @@ function buildHelp () {
   for (const [domain, ids] of grouped) {
     blocks.push(`  ${domain}\n${ids.map((id) => `    ${id}`).join('\n')}`)
   }
-  return `ossy call <action.id> [--key value]... [--json '{...}'] [options]
+  return `ossy invoke <action.id> [--key value]... [--json '{...}'] [options]
 
 Generic dispatcher for any Ossy API action. Flags become payload fields
 (--first-name -> firstName); --json '{...}' is merged on top.
@@ -46,7 +50,7 @@ Options:
   --raw                  Print response body without JSON pretty-printing
 
 Per-action help:
-  ossy call <action.id> --help
+  ossy invoke <action.id> --help
 
 Available actions:
 
@@ -56,11 +60,11 @@ ${blocks.join('\n\n')}
 
 function actionHelp (action) {
   const def = action.payload ? `Default payload:\n  ${JSON.stringify(action.payload)}\n\n` : ''
-  return `${action.id}  ${action.method} ${action.endpoint}
+  return `${action.id}  POST /actions  { action: "${action.id}", payload: … }
 
 ${def}Examples:
-  ossy call ${action.id} --key value --other value
-  ossy call ${action.id} --json '{"key":"value"}'
+  ossy invoke ${action.id} --key value --other value
+  ossy invoke ${action.id} --json '{"key":"value"}'
 `
 }
 
@@ -211,7 +215,7 @@ async function call (args) {
     return
   }
 
-  const action = ACTION_BY_ID.get(parsed.actionId)
+  const action = ACTION_BY_ID.get(parsed.actionId) ?? ACTION_BY_ID.get(resolveActionId(parsed.actionId))
   if (!action) {
     logError({
       message: `[@ossy/cli] call: unknown action "${parsed.actionId}". Run \`ossy call --help\` for the list.`,
@@ -249,7 +253,7 @@ async function call (args) {
 
   let result
   try {
-    result = await sdk.makeRequest(action)(parsed.payload)
+    result = await sdk.invoke(action, parsed.payload)
   } catch (err) {
     if (isResponseLike(err)) {
       const text = await err.text().catch(() => '')

package/src/index.js

@@ -25,7 +25,7 @@ Local utilities:
   app <subcommand>        App commands: init | build | upload | validate | publish
 
 Action dispatcher (any Ossy SDK action, no per-action wiring needed):
-  call <action.id>        Run \`ossy call --help\` for the full catalog
+  invoke <action.id>      Run \`ossy invoke --help\` for the full catalog
 
 Workflows (wrap one or more actions with extra ergonomics):
   upload-dir <dir> <loc>  Recursively upload a local directory to the CMS
@@ -120,7 +120,12 @@ const run = async () => {
     await Workspace.handler(restArgs)
     return
   }
+  if (command === 'invoke') {
+    await Call.handler(restArgs)
+    return
+  }
   if (command === 'call') {
+    process.stderr.write('[@ossy/cli] `ossy call` is deprecated — use `ossy invoke` instead.\n')
     await Call.handler(restArgs)
     return
   }

package/src/upload-dir/cli.js

@@ -198,7 +198,7 @@ export async function handler (args) {
     const name = path.basename(d)
     logInfo({ message: `[@ossy/cli] upload-dir: mkdir ${parent}/${name}` })
     try {
-      await sdk.makeRequest(createDir)({ location: parent, name })
+      await sdk.invoke(createDir, { location: parent, name })
       dirsMade++
     } catch (err) {
       // Treat "already exists" (HTTP 409 / 422 / resource conflict) as success
@@ -231,7 +231,7 @@ export async function handler (args) {
 
     let result
     try {
-      result = await sdk.makeRequest(uploadAction)({
+      result = await sdk.invoke(uploadAction, {
         location: remoteDir,
         name: fileMeta.name,
         type: fileMeta.type,