workato-dev-api 1.0.1 → 1.1.0

package/README.md

@@ -31,13 +31,16 @@ You can also export it directly in your shell environment.
 
 ## Claude Code setup
 
-In a clean working directory, run this once before starting Claude Code:
+In a clean working directory, run these two commands once before starting Claude Code:
 
 ```sh
+npx workato-dev-api auth YOUR_API_TOKEN
 npx workato-dev-api bootstrap-claude
 ```
 
-This writes a `CLAUDE.md` with full context — recipe code structure, wiring syntax, data table column naming, and project reference IDs — directly into your working directory where Claude Code will pick it up automatically.
+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.
 
 ## Commands
 
@@ -46,6 +49,7 @@ This writes a `CLAUDE.md` with full context — recipe code structure, wiring sy
 | Command | Description |
 |---|---|
 | `workato bootstrap-claude` | Copy `CLAUDE.md` into the current directory |
+| `workato auth <token>` | Save your API token to `.env` in the current directory |
 
 ### Read
 

package/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 'use strict';
 
-const fs = require('fs');
 const os = require('os');
 const path = require('path');
 const {
   loadEnv,
+  cmdBootstrapClaude, cmdAuth,
   cmdGet, cmdListRecipes, cmdListProjects, cmdListFolders,
   cmdListConnections, cmdListDataTables, cmdGetDataTable,
   cmdGetJobs, cmdGetJob,
@@ -13,12 +13,19 @@ const {
   cmdStart, cmdStop, cmdDelete,
 } = require('./lib');
 
-// bootstrap-claude runs before env/token setup — handle it immediately
-if (process.argv[2] === 'bootstrap-claude') {
-  const src = path.join(__dirname, 'CLAUDE.md');
-  const dest = path.join(process.cwd(), 'CLAUDE.md');
-  fs.copyFileSync(src, dest);
-  console.log(`CLAUDE.md written to ${dest}`);
+// Setup commands run before env/token setup
+const _setupCmd = process.argv[2];
+if (_setupCmd === 'bootstrap-claude') {
+  cmdBootstrapClaude(process.cwd());
+  process.exit(0);
+}
+if (_setupCmd === 'auth') {
+  const token = process.argv[3];
+  if (!token) {
+    console.error('Usage: workato auth <token>');
+    process.exit(1);
+  }
+  cmdAuth(token, process.cwd());
   process.exit(0);
 }
 
@@ -29,7 +36,7 @@ loadEnv(path.join(os.homedir(), '.env'));
 loadEnv(path.join(process.cwd(), '.env'));
 
 if (!process.env.WORKATO_API_TOKEN) {
-  console.error('Error: WORKATO_API_TOKEN not set.\nCreate a .env file in your current directory with:\n  WORKATO_API_TOKEN=your_token_here');
+  console.error('Error: WORKATO_API_TOKEN not set.\nRun: workato auth <your_token>\nOr create a .env file with: WORKATO_API_TOKEN=your_token_here');
   process.exit(1);
 }
 
@@ -61,6 +68,7 @@ workato <command> [options]
 
 Setup:
   bootstrap-claude                           Copy CLAUDE.md into the current directory
+  auth <token>                               Save API token to .env in the current directory
 
 Read commands:
   get <recipe_id>                            Fetch recipe code → recipe_<id>_code.json

package/lib.js

@@ -143,6 +143,30 @@ function apiTriggerConfig() {
   ];
 }
 
+// ── Setup commands ────────────────────────────────────────────────────────────
+
+function cmdBootstrapClaude(destDir) {
+  const src = path.join(__dirname, 'CLAUDE.md');
+  const dest = path.join(destDir ?? process.cwd(), 'CLAUDE.md');
+  fs.copyFileSync(src, dest);
+  console.log(`CLAUDE.md written to ${dest}`);
+  return dest;
+}
+
+function cmdAuth(token, destDir) {
+  const envPath = path.join(destDir ?? process.cwd(), '.env');
+  let content = fs.existsSync(envPath) ? fs.readFileSync(envPath, 'utf8') : '';
+  const line = `WORKATO_API_TOKEN=${token}`;
+  if (/^WORKATO_API_TOKEN=/m.test(content)) {
+    content = content.replace(/^WORKATO_API_TOKEN=.*/m, line);
+  } else {
+    content = content ? content.trimEnd() + '\n' + line + '\n' : line + '\n';
+  }
+  fs.writeFileSync(envPath, content);
+  console.log(`Token saved to ${envPath}`);
+  return envPath;
+}
+
 // ── Read commands ─────────────────────────────────────────────────────────────
 
 async function cmdGet(recipeId) {
@@ -313,6 +337,8 @@ module.exports = {
   // helpers
   findStep, deepMerge, extractCode,
   apiTriggerCode, apiTriggerConfig,
+  // setup commands
+  cmdBootstrapClaude, cmdAuth,
   // read commands
   cmdGet, cmdListRecipes, cmdListProjects, cmdListFolders,
   cmdListConnections, cmdListDataTables, cmdGetDataTable,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workato-dev-api",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "CLI for the Workato Developer API — recipes, connections, data tables, and more",
   "bin": {
     "workato": "cli.js"

package/test/cli.test.js

@@ -982,6 +982,144 @@ describe('cmdUpdateStep — deeply nested step', () => {
   });
 });
 
+// ── cmdBootstrapClaude ────────────────────────────────────────────────────────
+
+describe('cmdBootstrapClaude', () => {
+  function tmpDir() {
+    const d = path.join(os.tmpdir(), `workato-test-${Date.now()}-${Math.random()}`);
+    fs.mkdirSync(d, { recursive: true });
+    return d;
+  }
+
+  test('copies CLAUDE.md into the destination directory', () => {
+    const dir = tmpDir();
+    try {
+      lib.cmdBootstrapClaude(dir);
+      assert.ok(fs.existsSync(path.join(dir, 'CLAUDE.md')), 'CLAUDE.md should exist in dest dir');
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  test('written file content matches the source CLAUDE.md', () => {
+    const dir = tmpDir();
+    try {
+      lib.cmdBootstrapClaude(dir);
+      const srcPath = path.join(__dirname, '..', 'CLAUDE.md');
+      const src = fs.readFileSync(srcPath, 'utf8');
+      const dest = fs.readFileSync(path.join(dir, 'CLAUDE.md'), 'utf8');
+      assert.equal(dest, src);
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  test('returns the destination file path', () => {
+    const dir = tmpDir();
+    try {
+      const result = lib.cmdBootstrapClaude(dir);
+      assert.equal(result, path.join(dir, 'CLAUDE.md'));
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  test('overwrites an existing CLAUDE.md', () => {
+    const dir = tmpDir();
+    try {
+      fs.writeFileSync(path.join(dir, 'CLAUDE.md'), 'old content');
+      lib.cmdBootstrapClaude(dir);
+      const content = fs.readFileSync(path.join(dir, 'CLAUDE.md'), 'utf8');
+      assert.notEqual(content, 'old content');
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+});
+
+// ── cmdAuth ───────────────────────────────────────────────────────────────────
+
+describe('cmdAuth', () => {
+  function tmpDir() {
+    const d = path.join(os.tmpdir(), `workato-auth-test-${Date.now()}-${Math.random()}`);
+    fs.mkdirSync(d, { recursive: true });
+    return d;
+  }
+
+  test('creates .env with token when file does not exist', () => {
+    const dir = tmpDir();
+    try {
+      lib.cmdAuth('mytoken123', dir);
+      const content = fs.readFileSync(path.join(dir, '.env'), 'utf8');
+      assert.ok(content.includes('WORKATO_API_TOKEN=mytoken123'));
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  test('returns the .env file path', () => {
+    const dir = tmpDir();
+    try {
+      const result = lib.cmdAuth('tok', dir);
+      assert.equal(result, path.join(dir, '.env'));
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  test('updates existing WORKATO_API_TOKEN line in .env', () => {
+    const dir = tmpDir();
+    try {
+      fs.writeFileSync(path.join(dir, '.env'), 'WORKATO_API_TOKEN=oldtoken\n');
+      lib.cmdAuth('newtoken', dir);
+      const content = fs.readFileSync(path.join(dir, '.env'), 'utf8');
+      assert.ok(content.includes('WORKATO_API_TOKEN=newtoken'), 'should have new token');
+      assert.ok(!content.includes('oldtoken'), 'should not have old token');
+      assert.equal((content.match(/WORKATO_API_TOKEN=/g) || []).length, 1, 'only one token line');
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  test('appends token to .env that has other keys but no WORKATO_API_TOKEN', () => {
+    const dir = tmpDir();
+    try {
+      fs.writeFileSync(path.join(dir, '.env'), 'OTHER_KEY=value\n');
+      lib.cmdAuth('mytoken', dir);
+      const content = fs.readFileSync(path.join(dir, '.env'), 'utf8');
+      assert.ok(content.includes('OTHER_KEY=value'), 'existing key preserved');
+      assert.ok(content.includes('WORKATO_API_TOKEN=mytoken'), 'token appended');
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  test('token value containing = is preserved verbatim', () => {
+    const dir = tmpDir();
+    try {
+      lib.cmdAuth('tok==extra==', dir);
+      const content = fs.readFileSync(path.join(dir, '.env'), 'utf8');
+      assert.ok(content.includes('WORKATO_API_TOKEN=tok==extra=='));
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  test('preserves other keys in .env when updating token', () => {
+    const dir = tmpDir();
+    try {
+      fs.writeFileSync(path.join(dir, '.env'), 'FOO=bar\nWORKATO_API_TOKEN=old\nBAZ=qux\n');
+      lib.cmdAuth('updated', dir);
+      const content = fs.readFileSync(path.join(dir, '.env'), 'utf8');
+      assert.ok(content.includes('FOO=bar'), 'FOO preserved');
+      assert.ok(content.includes('BAZ=qux'), 'BAZ preserved');
+      assert.ok(content.includes('WORKATO_API_TOKEN=updated'), 'token updated');
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+});
+
 // Restore console at end
 process.on('exit', () => {
   console.log = origLog;