workato-dev-api 1.1.0 → 1.2.0

package/CLAUDE.md

@@ -4,7 +4,13 @@
 
 Use `npx workato-dev-api <command>` (or `workato <command>` if installed globally) for all Workato operations — reads and writes alike.
 
-Requires `WORKATO_API_TOKEN` in a `.env` file (cwd `.env` takes highest priority). Base URL: `https://app.trial.workato.com/api`.
+Requires `WORKATO_API_TOKEN` in a `.env` file (cwd `.env` takes highest priority).
+
+Base URL is determined by `workato.sandbox` in the project's `package.json`:
+- `false` (default): `https://app.workato.com/api`
+- `true` (free sandbox): `https://app.trial.workato.com/api`
+
+**If the user says they are on a Workato free sandbox or trial account, set `"sandbox": true` in the `workato` block of their `package.json` immediately.**
 
 ### Commands
 
@@ -127,13 +133,12 @@ Always use `workato get-data-table <id>` or read the recipe code to look up the
 
 ---
 
-## Reference Recipe
-
-**Transcribe Audio** (ID: 167603) — `https://app.trial.workato.com/recipes/167603-transcribe-audio`
+## Reference Recipes
 
-This recipe demonstrates complete working wiring across all three step types (API Platform trigger → OpenAI action → Data Table action). Use it as the canonical wiring reference.
+If you are unsure how to wire a particular connector or step type, ask the user:
+> "Do you have an existing recipe that uses [connector/trigger type]? If so, share the recipe ID and I'll fetch it as a wiring reference."
 
-Trigger `as`: `8f52532b` | OpenAI step `as`: `5df21cfd` | Data Table step `as`: `1614a36d`
+Use `workato get <recipe_id>` to inspect the code and extract the correct `as` IDs, `provider` values, `input` structure, and `extended_output_schema` before building or patching a new recipe.
 
 ---
 

package/README.md

@@ -40,7 +40,7 @@ npx workato-dev-api bootstrap-claude
 
 That's it. The first command saves your token to `.env`. The second drops a `CLAUDE.md` into the directory so Claude Code automatically has full context — recipe structure, wiring syntax, data table column names, and project reference IDs.
 
-Then just open Claude Code in that directory and start working.
+Then open Claude Code in that directory and start working. If you're on a **Workato free sandbox**, just tell Claude — it will update your `package.json` automatically so the CLI points at the right URL.
 
 ## Commands
 

package/cli.js

@@ -4,7 +4,7 @@
 const os = require('os');
 const path = require('path');
 const {
-  loadEnv,
+  loadEnv, setConfig, resolveBaseUrl, readProjectConfig,
   cmdBootstrapClaude, cmdAuth,
   cmdGet, cmdListRecipes, cmdListProjects, cmdListFolders,
   cmdListConnections, cmdListDataTables, cmdGetDataTable,
@@ -40,6 +40,10 @@ if (!process.env.WORKATO_API_TOKEN) {
   process.exit(1);
 }
 
+// Apply base URL from workato.sandbox in cwd package.json
+const { workato: _wCfg = {} } = readProjectConfig();
+setConfig({ baseUrl: resolveBaseUrl(_wCfg.sandbox) });
+
 // Parse argv: separate --flag value pairs from positional args
 function parseArgs(argv) {
   const positional = [];

package/lib.js

@@ -7,10 +7,25 @@ const crypto = require('crypto');
 // ── Config ────────────────────────────────────────────────────────────────────
 
 const _config = {
-  baseUrl: 'https://app.trial.workato.com/api',
+  baseUrl: 'https://app.workato.com/api',
   token: null,
 };
 
+function resolveBaseUrl(sandbox) {
+  return sandbox === true
+    ? 'https://app.trial.workato.com/api'
+    : 'https://app.workato.com/api';
+}
+
+function readProjectConfig(cwd) {
+  const pkgPath = path.join(cwd ?? process.cwd(), 'package.json');
+  try {
+    return JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
 function loadEnv(envPath) {
   const p = envPath ?? path.join(process.cwd(), '.env');
   if (!fs.existsSync(p)) return;
@@ -331,7 +346,7 @@ async function cmdDelete(recipeId) {
 
 module.exports = {
   // config
-  loadEnv, setConfig, getToken,
+  loadEnv, setConfig, getToken, resolveBaseUrl, readProjectConfig,
   // http
   apiGet, apiPost, apiPut, apiDelete,
   // helpers

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workato-dev-api",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "CLI for the Workato Developer API — recipes, connections, data tables, and more",
   "bin": {
     "workato": "cli.js"
@@ -18,5 +18,8 @@
     "recipes",
     "automation"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "workato": {
+    "sandbox": false
+  }
 }

package/test/cli.test.js

@@ -982,6 +982,107 @@ describe('cmdUpdateStep — deeply nested step', () => {
   });
 });
 
+// ── resolveBaseUrl ────────────────────────────────────────────────────────────
+
+describe('resolveBaseUrl', () => {
+  test('returns production URL when sandbox is false', () => {
+    assert.equal(lib.resolveBaseUrl(false), 'https://app.workato.com/api');
+  });
+
+  test('returns production URL when sandbox is undefined', () => {
+    assert.equal(lib.resolveBaseUrl(undefined), 'https://app.workato.com/api');
+  });
+
+  test('returns production URL when sandbox is a string "false"', () => {
+    assert.equal(lib.resolveBaseUrl('false'), 'https://app.workato.com/api');
+  });
+
+  test('returns sandbox URL when sandbox is true', () => {
+    assert.equal(lib.resolveBaseUrl(true), 'https://app.trial.workato.com/api');
+  });
+
+  test('sandbox URL contains "trial"', () => {
+    assert.ok(lib.resolveBaseUrl(true).includes('trial'));
+  });
+
+  test('production URL does not contain "trial"', () => {
+    assert.ok(!lib.resolveBaseUrl(false).includes('trial'));
+  });
+});
+
+// ── readProjectConfig ─────────────────────────────────────────────────────────
+
+describe('readProjectConfig', () => {
+  function tmpDir() {
+    const d = path.join(os.tmpdir(), `workato-cfg-test-${Date.now()}-${Math.random()}`);
+    fs.mkdirSync(d, { recursive: true });
+    return d;
+  }
+
+  test('returns empty object when no package.json exists', () => {
+    const dir = tmpDir();
+    try {
+      assert.deepEqual(lib.readProjectConfig(dir), {});
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  test('returns parsed package.json contents', () => {
+    const dir = tmpDir();
+    try {
+      fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify({ workato: { sandbox: true } }));
+      const cfg = lib.readProjectConfig(dir);
+      assert.equal(cfg.workato.sandbox, true);
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  test('returns empty object when package.json is malformed JSON', () => {
+    const dir = tmpDir();
+    try {
+      fs.writeFileSync(path.join(dir, 'package.json'), 'not valid json {{{');
+      assert.deepEqual(lib.readProjectConfig(dir), {});
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  test('sandbox false in package.json resolves to production URL', () => {
+    const dir = tmpDir();
+    try {
+      fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify({ workato: { sandbox: false } }));
+      const { workato: wCfg = {} } = lib.readProjectConfig(dir);
+      assert.equal(lib.resolveBaseUrl(wCfg.sandbox), 'https://app.workato.com/api');
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  test('sandbox true in package.json resolves to trial URL', () => {
+    const dir = tmpDir();
+    try {
+      fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify({ workato: { sandbox: true } }));
+      const { workato: wCfg = {} } = lib.readProjectConfig(dir);
+      assert.equal(lib.resolveBaseUrl(wCfg.sandbox), 'https://app.trial.workato.com/api');
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  test('missing workato key resolves to production URL', () => {
+    const dir = tmpDir();
+    try {
+      fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify({ name: 'my-project' }));
+      const { workato: wCfg = {} } = lib.readProjectConfig(dir);
+      assert.equal(lib.resolveBaseUrl(wCfg.sandbox), 'https://app.workato.com/api');
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+});
+
 // ── cmdBootstrapClaude ────────────────────────────────────────────────────────
 
 describe('cmdBootstrapClaude', () => {