@corsair-dev/cli 0.1.2 → 0.1.3

package/README.md

@@ -1,4 +1,4 @@
-# @corsair-ai/cli
+# @corsair-dev/cli
 
 The Corsair CLI handles everything needed to get a Corsair instance running: database setup, credential storage, and OAuth token acquisition. The intention is that a developer (or an agent) can go from a blank project to a fully authorized integration with a minimal number of commands, without ever needing to manually touch a database or manage encryption keys.
 
@@ -11,7 +11,7 @@ All output is JSON, so both humans and agents can consume it the same way.
 The CLI is included when you install `corsair`:
 
 ```bash
-pnpm add corsair @corsair-ai/cli
+pnpm add corsair @corsair-dev/cli
 ```
 
 The `corsair` binary is available immediately after install via `pnpm exec corsair <command>` or `npx corsair <command>`. No additional configuration needed.
@@ -106,7 +106,7 @@ npx corsair auth --plugin=gmail --credentials
     "client_secret": "***",
     "access_token": "ya29.A...abc",
     "refresh_token": "1//0g...xyz",
-    "expires_at": "1234567890000"
+    "expires_at": "1234567890"
   }
 }
 ```

package/dist/index.js

@@ -268,7 +268,7 @@ async function oauthExchangeCode(database, plugin, kek, tenantId, code, redirect
   });
   await accountKm.set_access_token(tokens.access_token);
   if (tokens.refresh_token) await accountKm.set_refresh_token(tokens.refresh_token);
-  if (tokens.expires_in) await accountKm.set_expires_at((Date.now() + tokens.expires_in * 1e3).toString());
+  if (tokens.expires_in) await accountKm.set_expires_at((Math.floor(Date.now() / 1e3) + tokens.expires_in).toString());
   out({ status: "success", plugin: plugin.id, tenant: tenantId });
 }
 async function oauthWithCode(database, plugin, kek, tenantId, code) {
@@ -1124,6 +1124,46 @@ or reinstall your dependencies:
     process.exit(1);
   }
 }
+function resolveClient(instance, tenant) {
+  const obj = instance;
+  if ("withTenant" in obj && typeof obj.withTenant === "function") {
+    if (!tenant) {
+      console.error("[#corsair]: This is a multi-tenant instance. Pass --tenant=<id>.");
+      process.exit(1);
+    }
+    return obj.withTenant(tenant);
+  }
+  return obj;
+}
+function navigateToEndpoint(client, path3) {
+  const parts = path3.split(".");
+  let current = client;
+  for (const part of parts) {
+    if (current === null || typeof current !== "object") return void 0;
+    current = current[part];
+  }
+  return typeof current === "function" ? current : void 0;
+}
+function parseListArgs(args) {
+  let plugin;
+  let type;
+  for (const arg of args) {
+    const eqIdx = arg.indexOf("=");
+    if (arg.startsWith("--") && eqIdx !== -1) {
+      const key = arg.slice(2, eqIdx);
+      const value = arg.slice(eqIdx + 1);
+      if (key === "plugin") {
+        plugin = value;
+        continue;
+      }
+      if (key === "type" && (value === "api" || value === "webhooks" || value === "db")) {
+        type = value;
+        continue;
+      }
+    }
+  }
+  return { plugin, type };
+}
 function parseAuthArgs(args) {
   let pluginId;
   let tenantId;
@@ -1180,24 +1220,84 @@ function parseSetupArgs(args) {
   }
   return { backfill, credentials };
 }
+function parseRunArgs(args) {
+  let endpointPath;
+  let input;
+  let tenant;
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--tenant" && args[i + 1]) {
+      tenant = args[++i];
+    } else if (arg.startsWith("--tenant=")) {
+      tenant = arg.slice("--tenant=".length);
+    } else if (arg === "--input" && args[i + 1]) {
+      input = args[++i];
+    } else if (arg.startsWith("--input=")) {
+      input = arg.slice("--input=".length);
+    } else if (!arg.startsWith("-")) {
+      if (!endpointPath) endpointPath = arg;
+      else if (!input) input = arg;
+    }
+  }
+  return { path: endpointPath, input, tenant };
+}
+function parseScriptArgs(args) {
+  let code;
+  let tenant;
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--code" && args[i + 1]) {
+      code = args[++i];
+    } else if (arg.startsWith("--code=")) {
+      code = arg.slice("--code=".length);
+    } else if (arg === "--tenant" && args[i + 1]) {
+      tenant = args[++i];
+    } else if (arg.startsWith("--tenant=")) {
+      tenant = arg.slice("--tenant=".length);
+    }
+  }
+  return { code, tenant };
+}
+function printHelp() {
+  console.log("[#corsair]: Corsair CLI\n");
+  console.log("Commands:");
+  console.log("  corsair setup                                   Initialize your Corsair instance");
+  console.log("  corsair setup -backfill                         Initialize and backfill initial data");
+  console.log("  corsair setup --<plugin> <field>=VALUE ...      Set credentials for a plugin");
+  console.log("");
+  console.log("  corsair auth --plugin=<id>                      Start OAuth flow (outputs auth URL as JSON)");
+  console.log("  corsair auth --plugin=<id> --code=<code>        Exchange OAuth code for tokens");
+  console.log("  corsair auth --plugin=<id> --credentials        Show current credential status");
+  console.log("");
+  console.log("  corsair list                                     List all API endpoint paths across all plugins");
+  console.log("  corsair list --plugin=<id>                      List paths for a specific plugin");
+  console.log("  corsair list --type=api|webhooks|db             Filter by operation type (default: api)");
+  console.log("  corsair list --plugin=<id> --type=<type>        Combine plugin + type filters");
+  console.log("");
+  console.log("  corsair schema <path>                           Show schema for an endpoint, webhook, or DB entity");
+  console.log("  corsair schema slack.api.messages.post          Example: API endpoint schema");
+  console.log("  corsair schema slack.webhooks.messages.message  Example: webhook schema");
+  console.log("  corsair schema slack.db.messages.search         Example: DB search schema");
+  console.log("");
+  console.log("  corsair run <path> [input-json]                 Call an API endpoint and print the result");
+  console.log("  corsair run slack.api.channels.list             Example: no input needed");
+  console.log(`  corsair run slack.api.messages.post '{"channel":"C123","text":"hi"}'`);
+  console.log("  corsair run <path> [input-json] --tenant=<id>   Multi-tenant variant");
+  console.log("");
+  console.log('  corsair script --code "<js>"                    Run a sandboxed script with corsair injected');
+  console.log('  corsair script --code "<js>" --tenant=<id>      Multi-tenant variant');
+  console.log("  # corsair is pre-injected; use return to output a value:");
+  console.log(`  # --code "const r = await corsair.slack.api.channels.list(); return r.channels.find(c => c.name === 'general')?.id"`);
+  console.log("");
+  console.log("  corsair watch-renew                             Renew Google webhook watch (Gmail/Drive/Calendar)");
+  console.log("  corsair help                                    Show this help message\n");
+}
 async function main() {
   const cwd = process.cwd();
   const args = process.argv.slice(2);
   const command = args[0];
   if (command === "help" || command === "--help" || command === "-h") {
-    console.log("[#corsair]: Corsair CLI\n");
-    console.log("Commands:");
-    console.log("  corsair setup                               Initialize your Corsair instance");
-    console.log("  corsair setup -backfill                     Initialize and backfill initial data");
-    console.log("  corsair setup --<plugin> <field>=VALUE ...  Set credentials for a plugin");
-    console.log("  corsair auth --plugin=<id>                 Start OAuth flow (outputs auth URL as JSON)");
-    console.log("  corsair auth --plugin=<id> --code=<code>   Exchange OAuth code for tokens");
-    console.log("  corsair auth --plugin=<id> --credentials   Show current credential status");
-    console.log(
-      "  corsair watch-renew        Renew Google webhook watch (Gmail/Drive/Calendar)"
-    );
-    console.log("  corsair migrate            Create a data migration script");
-    console.log("  corsair migrate help       Show migration help\n");
+    printHelp();
     return;
   }
   if (command === "setup") {
@@ -1222,6 +1322,113 @@ async function main() {
     await runWatchRenew2({ cwd });
     return;
   }
+  if (command === "list") {
+    const { plugin, type } = parseListArgs(args.slice(1));
+    const instance = await getCorsairInstance({ cwd });
+    const corsair = instance;
+    if (typeof corsair.list_operations !== "function") {
+      console.error("[#corsair]: list_operations not available on this Corsair instance.");
+      process.exit(1);
+    }
+    const result = corsair.list_operations({ plugin, type });
+    if (typeof result === "string") {
+      console.log(result);
+    } else if (Array.isArray(result)) {
+      for (const path3 of result) {
+        console.log(path3);
+      }
+      console.log("");
+      console.log("Run `pnpm corsair schema <path>` to get the schema for any of the above.");
+    } else if (result && typeof result === "object") {
+      const grouped = result;
+      for (const [pluginId, paths] of Object.entries(grouped)) {
+        console.log(`${pluginId}:`);
+        for (const path3 of paths) {
+          console.log(`  ${path3}`);
+        }
+      }
+      console.log("");
+      console.log("Run `pnpm corsair schema <path>` to get the schema for any of the above.");
+    }
+    return;
+  }
+  if (command === "run") {
+    const { path: endpointPath, input, tenant } = parseRunArgs(args.slice(1));
+    if (!endpointPath) {
+      console.error("[#corsair]: Usage: corsair run <path> [input-json]");
+      console.error(`[#corsair]: Example: corsair run slack.api.messages.post '{"channel":"C123","text":"hi"}'`);
+      process.exit(1);
+    }
+    const instance = await getCorsairInstance({ cwd });
+    const client = resolveClient(instance, tenant);
+    const fn = navigateToEndpoint(client, endpointPath);
+    if (!fn) {
+      console.error(`[#corsair]: Could not find endpoint "${endpointPath}".`);
+      console.error("[#corsair]: Run `pnpm corsair list` to see available paths.");
+      process.exit(1);
+    }
+    let parsedInput = {};
+    if (input) {
+      try {
+        parsedInput = JSON.parse(input);
+      } catch {
+        console.error("[#corsair]: Invalid JSON input. Make sure to quote the JSON string.");
+        process.exit(1);
+      }
+    }
+    try {
+      const result = await fn(parsedInput);
+      console.log(JSON.stringify(result, null, 2));
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      console.error(`[#corsair]: ${msg.slice(0, 500)}`);
+      process.exit(1);
+    }
+    return;
+  }
+  if (command === "script") {
+    const { code, tenant } = parseScriptArgs(args.slice(1));
+    if (!code) {
+      console.error('[#corsair]: Usage: corsair script --code "<js>"');
+      console.error(`[#corsair]: Example: corsair script --code "const r = await corsair.slack.channels.list(); return r.channels.find(c => c.name === 'general')?.id"`);
+      process.exit(1);
+    }
+    const instance = await getCorsairInstance({ cwd });
+    const client = resolveClient(instance, tenant);
+    const AsyncFunction = Object.getPrototypeOf(async function() {
+    }).constructor;
+    const fn = new AsyncFunction("corsair", code);
+    try {
+      const result = await fn(client);
+      if (result !== void 0) {
+        console.log(JSON.stringify(result, null, 2));
+      }
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      console.error(`[#corsair]: ${msg.slice(0, 500)}`);
+      process.exit(1);
+    }
+    return;
+  }
+  if (command === "schema") {
+    const schemaPath = args[1];
+    if (!schemaPath) {
+      console.error("[#corsair]: Usage: corsair schema <path>");
+      console.error("[#corsair]: Example: corsair schema slack.api.messages.post");
+      process.exit(1);
+    }
+    const instance = await getCorsairInstance({ cwd });
+    const corsair = instance;
+    if (typeof corsair.get_schema !== "function") {
+      console.error("[#corsair]: get_schema not available on this Corsair instance.");
+      process.exit(1);
+    }
+    const result = corsair.get_schema(schemaPath);
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  printHelp();
+  console.log("");
   console.log(`[#corsair]: Looking for Corsair instance in ${cwd}...
 `);
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corsair-dev/cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "",
   "type": "module",
   "main": "./dist/index.js",
@@ -23,7 +23,7 @@
     "@clack/prompts": "^1.0.0",
     "c12": "^3.3.3",
     "zod": "^3.25.76",
-    "corsair": "0.1.45"
+    "corsair": "0.1.46"
   },
   "devDependencies": {
     "@types/jest": "^29.5.14",