@picahq/cli 1.11.1 → 1.12.0

package/README.md

@@ -201,6 +201,7 @@ one actions execute stripe <actionId> <connectionKey> \
 | `--headers <json>` | Additional request headers |
 | `--form-data` | Send as multipart/form-data |
 | `--form-url-encoded` | Send as application/x-www-form-urlencoded |
+| `--dry-run` | Show the request without executing it |
 
 ### `one guide [topic]`
 

package/dist/index.js

@@ -483,6 +483,12 @@ var OneApi = class {
       ) : void 0,
       data: requestData
     };
+    if (args.dryRun) {
+      return {
+        requestConfig: sanitizedConfig,
+        responseData: null
+      };
+    }
     const response = await fetch(fullUrl, fetchOpts);
     if (!response.ok) {
       const text4 = await response.text();
@@ -1841,7 +1847,7 @@ async function actionsExecuteCommand(platform, actionId, connectionKey, options)
     const queryParams = options.queryParams ? parseJsonArg(options.queryParams, "--query-params") : void 0;
     const headers = options.headers ? parseJsonArg(options.headers, "--headers") : void 0;
     const execSpinner = createSpinner();
-    execSpinner.start("Executing action...");
+    execSpinner.start(options.dryRun ? "Building request..." : "Executing action...");
     const result = await api.executePassthroughRequest(
       {
         platform,
@@ -1852,18 +1858,22 @@ async function actionsExecuteCommand(platform, actionId, connectionKey, options)
         queryParams,
         headers,
         isFormData: options.formData,
-        isFormUrlEncoded: options.formUrlEncoded
+        isFormUrlEncoded: options.formUrlEncoded,
+        dryRun: options.dryRun
       },
       actionDetails
     );
-    execSpinner.stop("Action executed successfully");
+    execSpinner.stop(options.dryRun ? "Dry run \u2014 request not sent" : "Action executed successfully");
     if (isAgentMode()) {
       json({
+        dryRun: options.dryRun || false,
         request: {
           method: result.requestConfig.method,
-          url: result.requestConfig.url
+          url: result.requestConfig.url,
+          headers: options.dryRun ? result.requestConfig.headers : void 0,
+          data: options.dryRun ? result.requestConfig.data : void 0
         },
-        response: result.responseData
+        response: options.dryRun ? void 0 : result.responseData
       });
       return;
     }
@@ -1874,9 +1884,19 @@ async function actionsExecuteCommand(platform, actionId, connectionKey, options)
         `  ${result.requestConfig.method} ${result.requestConfig.url}`
       )
     );
-    console.log();
-    console.log(pc6.bold("Response:"));
-    console.log(JSON.stringify(result.responseData, null, 2));
+    if (options.dryRun) {
+      if (result.requestConfig.data) {
+        console.log();
+        console.log(pc6.dim("Body:"));
+        console.log(pc6.dim(JSON.stringify(result.requestConfig.data, null, 2)));
+      }
+      console.log();
+      note2("Dry run \u2014 request was not sent", "Dry Run");
+    } else {
+      console.log();
+      console.log(pc6.bold("Response:"));
+      console.log(JSON.stringify(result.responseData, null, 2));
+    }
   } catch (error2) {
     spinner5.stop("Execution failed");
     error(
@@ -2355,12 +2375,42 @@ async function executeLoopStep(step, context, api, permissions, allowedActionIds
     throw new Error(`Loop "over" must resolve to an array, got ${typeof items}`);
   }
   const maxIterations = loop.maxIterations || 1e3;
-  const results = [];
+  const bounded = items.slice(0, maxIterations);
   const savedLoop = { ...context.loop };
-  for (let i = 0; i < Math.min(items.length, maxIterations); i++) {
+  if (loop.maxConcurrency && loop.maxConcurrency > 1) {
+    const results2 = new Array(bounded.length);
+    for (let batchStart = 0; batchStart < bounded.length; batchStart += loop.maxConcurrency) {
+      const batch = bounded.slice(batchStart, batchStart + loop.maxConcurrency);
+      const batchResults = await Promise.all(
+        batch.map(async (item, batchIdx) => {
+          const i = batchStart + batchIdx;
+          const iterContext = {
+            ...context,
+            loop: {
+              [loop.as]: item,
+              item,
+              i,
+              ...loop.indexAs ? { [loop.indexAs]: i } : {}
+            },
+            steps: { ...context.steps }
+          };
+          await executeSteps(loop.steps, iterContext, api, permissions, allowedActionIds, options);
+          Object.assign(context.steps, iterContext.steps);
+          return iterContext.loop[loop.as];
+        })
+      );
+      for (let j = 0; j < batchResults.length; j++) {
+        results2[batchStart + j] = batchResults[j];
+      }
+    }
+    context.loop = savedLoop;
+    return { status: "success", output: results2, response: results2 };
+  }
+  const results = [];
+  for (let i = 0; i < bounded.length; i++) {
     context.loop = {
-      [loop.as]: items[i],
-      item: items[i],
+      [loop.as]: bounded[i],
+      item: bounded[i],
       i
     };
     if (loop.indexAs) {
@@ -3343,6 +3393,7 @@ Options:
 - \`--headers <json>\` \u2014 Additional headers as JSON
 - \`--form-data\` \u2014 Send as multipart/form-data instead of JSON
 - \`--form-url-encoded\` \u2014 Send as application/x-www-form-urlencoded
+- \`--dry-run\` \u2014 Show the request that would be sent without executing it
 
 Examples:
 \`\`\`bash
@@ -3605,6 +3656,7 @@ The \`source\` field contains a JS function body. The flow context is available
     "as": "order",
     "indexAs": "i",
     "maxIterations": 1000,
+    "maxConcurrency": 5,
     "steps": [
       {
         "id": "createInvoice",
@@ -3622,6 +3674,8 @@ The \`source\` field contains a JS function body. The flow context is available
 }
 \`\`\`
 
+- \`maxConcurrency\` (optional): When set > 1, loop iterations run in parallel batches of that size. Default is sequential (1).
+
 ### \`parallel\` \u2014 Run steps concurrently
 
 \`\`\`json
@@ -4084,14 +4138,15 @@ actions.command("search <platform> <query>").description('Search for actions on
 actions.command("knowledge <platform> <actionId>").alias("k").description("Get full docs for an action \u2014 MUST call before execute to know required params").action(async (platform, actionId) => {
   await actionsKnowledgeCommand(platform, actionId);
 });
-actions.command("execute <platform> <actionId> <connectionKey>").alias("x").description('Execute an action \u2014 pass connectionKey from "one list", actionId from "actions search"').option("-d, --data <json>", "Request body as JSON").option("--path-vars <json>", "Path variables as JSON").option("--query-params <json>", "Query parameters as JSON").option("--headers <json>", "Additional headers as JSON").option("--form-data", "Send as multipart/form-data").option("--form-url-encoded", "Send as application/x-www-form-urlencoded").action(async (platform, actionId, connectionKey, options) => {
+actions.command("execute <platform> <actionId> <connectionKey>").alias("x").description('Execute an action \u2014 pass connectionKey from "one list", actionId from "actions search"').option("-d, --data <json>", "Request body as JSON").option("--path-vars <json>", "Path variables as JSON").option("--query-params <json>", "Query parameters as JSON").option("--headers <json>", "Additional headers as JSON").option("--form-data", "Send as multipart/form-data").option("--form-url-encoded", "Send as application/x-www-form-urlencoded").option("--dry-run", "Show request that would be sent without executing").action(async (platform, actionId, connectionKey, options) => {
   await actionsExecuteCommand(platform, actionId, connectionKey, {
     data: options.data,
     pathVars: options.pathVars,
     queryParams: options.queryParams,
     headers: options.headers,
     formData: options.formData,
-    formUrlEncoded: options.formUrlEncoded
+    formUrlEncoded: options.formUrlEncoded,
+    dryRun: options.dryRun
   });
 });
 var flow = program.command("flow").alias("f").description("Create, execute, and manage multi-step API workflows");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picahq/cli",
-  "version": "1.11.1",
+  "version": "1.12.0",
   "description": "CLI for managing One",
   "type": "module",
   "files": [