zapier-platform-cli 18.4.0 → 18.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zapier-platform-cli",
-  "version": "18.4.0",
+  "version": "18.5.1",
   "description": "The CLI for managing integrations in Zapier Developer Platform.",
   "repository": "zapier/zapier-platform",
   "homepage": "https://platform.zapier.com/",
@@ -41,7 +41,7 @@
     "ignore": "7.0.5",
     "inquirer": "8.2.5",
     "jscodeshift": "^17.3.0",
-    "lodash": "4.17.23",
+    "lodash": "4.18.1",
     "luxon": "3.7.1",
     "marked": "15.0.12",
     "marked-terminal": "7.3.0",
@@ -87,8 +87,8 @@
     "additionalVersionFlags": [
       "-v"
     ],
-    "bin": "zapier",
-    "dirname": "zapier",
+    "bin": "zapier-platform",
+    "dirname": "zapier-platform",
     "plugins": [
       "@oclif/plugin-autocomplete",
       "@oclif/plugin-help",

package/src/app-templates.js

@@ -20,6 +20,7 @@ module.exports = [
   // features
   'dynamic-dropdown',
   'files',
+  'line-items',
   'middleware',
   'resource',
   'rest-hooks',

package/src/generators/index.js

@@ -217,6 +217,7 @@ const TEMPLATE_ROUTES = {
   'digest-auth': writeForAuthTemplate,
   'dynamic-dropdown': writeForStandaloneTemplate,
   files: writeForStandaloneTemplate,
+  'line-items': writeForStandaloneTemplate,
   minimal: writeForMinimalTemplate,
   'oauth1-trello': writeForAuthTemplate,
   oauth2: writeForAuthTemplate,
@@ -246,12 +247,12 @@ const ProjectGeneratorPromise = createGeneratorClass((Generator) => {
       this.destinationRoot(path.resolve(this.options.path));
 
       const jsFilter = filter(['*.js', '*.json', '*.ts'], { restore: true });
-      this.queueTransformStream([
+      this.queueTransformStream(
         { disabled: true },
         jsFilter,
         prettier({ singleQuote: true }),
         jsFilter.restore,
-      ]);
+      );
     }
 
     async prompting() {

package/src/generators/templates/README.template.md

@@ -1,34 +1,34 @@
 # <%= name %>
 
-This Zapier integration project is generated by the `zapier init` CLI command.
+This Zapier integration project is generated by the `zapier-platform init` CLI command.
 
 These are what you normally do next:
 
 ```bash
 # Install dependencies
-npm install  # or you can use pnpm or yarn
+npm install --ignore-scripts  # or you can use pnpm or yarn
 
 # Run tests
-zapier test
+zapier-platform test
 
 # Register the integration on Zapier if you haven't
-zapier register "App Title"
+zapier-platform register "App Title"
 
 # Or you can link to an existing integration on Zapier
-zapier link
+zapier-platform link
 
 # Push it to Zapier
-zapier push
+zapier-platform push
 ```
 
-Then, to add more features, you can use the `zapier scaffold` command, for example:
+Then, to add more features, you can use the `zapier-platform scaffold` command, for example:
 
 ```bash
 # Add a trigger
-zapier scaffold trigger contact
+zapier-platform scaffold trigger contact
 
 # Add an action
-zapier scaffold create contact
+zapier-platform scaffold create contact
 ``` 
 
 Find out more on the latest docs: https://docs.zapier.com/platform

package/src/generators/templates/line-items/README.md

@@ -0,0 +1,16 @@
+# line-items
+
+An example integration demonstrating line item support. Line items are fields
+with a `children` property that represent structured, repeating data — like rows
+in a spreadsheet or items in an order.
+
+## Testing with `zapier-platform invoke`
+
+```bash
+# Non-interactive with JSON input
+zapier-platform invoke create order --non-interactive \
+  -i '{"name": "My Order", "line_items": [{"product_name": "Pens", "quantity": "12", "price": "1.50"}]}'
+
+# Interactive mode — use the line item editing UI
+zapier-platform invoke create order -i '{"name": "My Order"}'
+```

package/src/generators/templates/line-items/creates/order.js

@@ -0,0 +1,67 @@
+const perform = async (z, bundle) => {
+  const response = await z.request({
+    url: 'https://httpbin.zapier-tooling.com/post',
+    method: 'POST',
+    body: {
+      name: bundle.inputData.name,
+      line_items: bundle.inputData.line_items,
+    },
+  });
+
+  return response.data;
+};
+
+module.exports = {
+  key: 'order',
+  noun: 'Order',
+  display: {
+    label: 'Create Order',
+    description: 'Creates a new order with line items.',
+  },
+  operation: {
+    inputFields: [
+      { key: 'name', required: true, type: 'string', label: 'Order Name' },
+      {
+        key: 'line_items',
+        label: 'Line Items',
+        children: [
+          {
+            key: 'product_name',
+            type: 'string',
+            label: 'Product Name',
+            required: true,
+          },
+          {
+            key: 'quantity',
+            type: 'integer',
+            label: 'Quantity',
+            required: true,
+          },
+          { key: 'price', type: 'number', label: 'Unit Price' },
+        ],
+      },
+    ],
+    perform,
+    sample: {
+      id: 1,
+      name: 'Stationery Order',
+      line_items: [
+        { product_name: 'Pens', quantity: 12, price: 1.5 },
+        { product_name: 'Notebooks', quantity: 3, price: 8.99 },
+      ],
+    },
+    outputFields: [
+      { key: 'id', label: 'ID' },
+      { key: 'name', label: 'Order Name' },
+      {
+        key: 'line_items',
+        label: 'Line Items',
+        children: [
+          { key: 'product_name', label: 'Product Name' },
+          { key: 'quantity', label: 'Quantity' },
+          { key: 'price', label: 'Unit Price' },
+        ],
+      },
+    ],
+  },
+};

package/src/generators/templates/line-items/index.js

@@ -0,0 +1,12 @@
+const order = require('./creates/order');
+
+const App = {
+  version: require('./package.json').version,
+  platformVersion: require('zapier-platform-core').version,
+
+  creates: {
+    [order.key]: order,
+  },
+};
+
+module.exports = App;

package/src/generators/templates/line-items/test/creates.test.js

@@ -0,0 +1,30 @@
+/* globals describe, expect, test */
+
+const zapier = require('zapier-platform-core');
+
+const App = require('../index');
+const appTester = zapier.createAppTester(App);
+zapier.tools.env.inject();
+
+describe('creates', () => {
+  test('create order with line items', async () => {
+    const bundle = {
+      inputData: {
+        name: 'Test Order',
+        line_items: [
+          { product_name: 'Pens', quantity: 12, price: 1.5 },
+          { product_name: 'Notebooks', quantity: 3, price: 8.99 },
+        ],
+      },
+    };
+    const result = await appTester(
+      App.creates.order.operation.perform,
+      bundle,
+    );
+    const body = JSON.parse(result.data);
+    expect(body.name).toBe('Test Order');
+    expect(body.line_items).toHaveLength(2);
+    expect(body.line_items[0].product_name).toBe('Pens');
+    expect(body.line_items[1].quantity).toBe(3);
+  });
+});

package/src/oclif/ZapierBaseCommand.js

@@ -267,7 +267,7 @@ class ZapierBaseCommand extends Command {
     }));
     const visibleArgv = argv.filter((arg) => !arg.hidden);
 
-    return ['zapier', name, ...visibleArgv.map(formatArg)].join(' ');
+    return ['zapier-platform', name, ...visibleArgv.map(formatArg)].join(' ');
   }
 
   // this is fine for now but we'll want to hack into https://github.com/oclif/plugin-help/blob/master/src/command.ts at some point

package/src/oclif/commands/analytics.js

@@ -40,7 +40,7 @@ AnalyticsCommand.flags = buildFlags({
     }),
   },
 });
-AnalyticsCommand.examples = ['zapier analytics --mode enabled'];
+AnalyticsCommand.examples = ['zapier-platform analytics --mode enabled'];
 AnalyticsCommand.description = `Show the status of the analytics that are collected. Also used to change what is collected.`;
 AnalyticsCommand.skipValidInstallCheck = true;
 

package/src/oclif/commands/build.js

@@ -24,12 +24,12 @@ class BuildCommand extends BaseCommand {
 
     this.log(
       `\nBuild complete! Created ${BUILD_PATH} and ${SOURCE_PATH}.\n` +
-        `Now you can upload them with the ${colors.bold.underline('zapier upload')} command.`,
+        `Now you can upload them with the ${colors.bold.underline('zapier-platform upload')} command.`,
     );
 
     if (!skipDepInstall) {
       this.log(
-        `\nTip: Try ${colors.bold.underline('zapier build --skip-dep-install')} for faster builds.`,
+        `\nTip: Try ${colors.bold.underline('zapier-platform build --skip-dep-install')} for faster builds.`,
       );
     }
   }
@@ -64,6 +64,6 @@ This command does the following:
 * Zips up all needed \`.js\` files. If you want to include more files, add a "includeInBuild" property (array with strings of regexp paths) to your \`${CURRENT_APP_FILE}\`.
 * Moves the zip to \`${BUILD_PATH}\` and \`${SOURCE_PATH}\` and deletes the temp folder
 
-This command is typically followed by \`zapier upload\`.`;
+This command is typically followed by \`zapier-platform upload\`.`;
 
 module.exports = BuildCommand;

package/src/oclif/commands/cache/clear.js

@@ -104,9 +104,12 @@ ClearCacheCommand.description = `Clear the cache data for a major version.
 
 This command clears the cache data for a major version of your integration.
 The job will be run in the background and may take some time to complete.
-You can check \`zapier history\` to see the job status.
+You can check \`zapier-platform history\` to see the job status.
 `;
-ClearCacheCommand.examples = [`zapier cache:clear`, `zapier cache:clear 2`];
+ClearCacheCommand.examples = [
+  `zapier-platform cache:clear`,
+  `zapier-platform cache:clear 2`,
+];
 ClearCacheCommand.skipValidInstallCheck = true;
 ClearCacheCommand.hide = true;
 

package/src/oclif/commands/canary/create.js

@@ -24,7 +24,7 @@ class CanaryCreateCommand extends ZapierBaseCommand {
       this
         .log(`A canary deployment already exists from version ${existingCanary.from_version} to version ${existingCanary.to_version}, there are ${secondsRemaining} seconds remaining.
         
-If you would like to stop this canary now, run \`zapier canary:delete ${existingCanary.from_version} ${existingCanary.to_version}\``);
+If you would like to stop this canary now, run \`zapier-platform canary:delete ${existingCanary.from_version} ${existingCanary.to_version}\``);
       return;
     }
 
@@ -126,7 +126,7 @@ CanaryCreateCommand.args = {
 
 CanaryCreateCommand.description = `Create a new canary deployment, diverting a specified percentage of traffic from one version to another for a specified duration.
 
-Only one canary can be active at the same time. You can run \`zapier canary:list\` to check. If you would like to create a new canary with different parameters, you can wait for the canary to finish, or delete it using \`zapier canary:delete a.b.c x.y.z\`.
+Only one canary can be active at the same time. You can run \`zapier-platform canary:list\` to check. If you would like to create a new canary with different parameters, you can wait for the canary to finish, or delete it using \`zapier-platform canary:delete a.b.c x.y.z\`.
 
 To canary traffic for a specific user, use the --user flag.
 
@@ -134,15 +134,15 @@ To canary traffic for an entire account, use the --account-id. Note: this scenar
 
 To canary traffic for a specific user within a specific account, use both --user and --account-id flags.
 
-Note: this is similar to \`zapier migrate\` but different in that this is temporary and will "revert" the changes once the specified duration is expired.
+Note: this is similar to \`zapier-platform migrate\` but different in that this is temporary and will "revert" the changes once the specified duration is expired.
 
 **Only use this command to canary traffic between non-breaking versions!**`;
 
 CanaryCreateCommand.examples = [
-  'zapier canary:create 1.0.0 1.1.0 -p 10 -d 3600',
-  'zapier canary:create 2.0.0 2.1.0 --percent 25 --duration 1800 --user user@example.com',
-  'zapier canary:create 2.0.0 2.1.0 -p 15 -d 7200 -a 12345 -u user@example.com',
-  'zapier canary:create 2.0.0 2.1.0 -p 15 -d 7200 -a 12345',
+  'zapier-platform canary:create 1.0.0 1.1.0 -p 10 -d 3600',
+  'zapier-platform canary:create 2.0.0 2.1.0 --percent 25 --duration 1800 --user user@example.com',
+  'zapier-platform canary:create 2.0.0 2.1.0 -p 15 -d 7200 -a 12345 -u user@example.com',
+  'zapier-platform canary:create 2.0.0 2.1.0 -p 15 -d 7200 -a 12345',
 ];
 CanaryCreateCommand.skipValidInstallCheck = true;
 

package/src/oclif/commands/canary/delete.js

@@ -63,7 +63,7 @@ CanaryDeleteCommand.args = {
   }),
 };
 CanaryDeleteCommand.description = 'Delete an active canary deployment';
-CanaryDeleteCommand.examples = ['zapier canary:delete 1.0.0 1.1.0'];
+CanaryDeleteCommand.examples = ['zapier-platform canary:delete 1.0.0 1.1.0'];
 CanaryDeleteCommand.skipValidInstallCheck = true;
 
 module.exports = CanaryDeleteCommand;

package/src/oclif/commands/canary/list.js

@@ -34,7 +34,7 @@ class CanaryListCommand extends ZapierBaseCommand {
 
 CanaryListCommand.flags = buildFlags({ opts: { format: true } });
 CanaryListCommand.description = 'List all active canary deployments';
-CanaryListCommand.examples = ['zapier canary:list'];
+CanaryListCommand.examples = ['zapier-platform canary:list'];
 CanaryListCommand.skipValidInstallCheck = true;
 
 module.exports = CanaryListCommand;

package/src/oclif/commands/convert.js

@@ -156,7 +156,7 @@ The resulting CLI integration will be identical to its Visual Builder version an
 
 If you re-run this command on an existing directory it will leave existing files alone and not clobber them.
 
-You'll need to do a \`zapier push\` before the new version is visible in the editor, but otherwise you're good to go.`;
+You'll need to do a \`zapier-platform push\` before the new version is visible in the editor, but otherwise you're good to go.`;
 
 ConvertCommand.skipValidInstallCheck = true;
 

package/src/oclif/commands/delete/integration.js

@@ -17,7 +17,7 @@ class DeleteAppCommand extends BaseCommand {
 DeleteAppCommand.flags = buildFlags();
 DeleteAppCommand.description = `Delete your integration (including all versions).
 
-This only works if there are no active users or Zaps on any version. If you only want to delete certain versions, use the \`zapier delete:version\` command instead. It's unlikely that you'll be able to run this on an app that you've pushed publicly, since there are usually still users.`;
+This only works if there are no active users or Zaps on any version. If you only want to delete certain versions, use the \`zapier-platform delete:version\` command instead. It's unlikely that you'll be able to run this on an app that you've pushed publicly, since there are usually still users.`;
 DeleteAppCommand.aliases = ['delete:app'];
 DeleteAppCommand.skipValidInstallCheck = true;
 

package/src/oclif/commands/delete/version.js

@@ -27,6 +27,6 @@ DeleteVersionCommand.flags = buildFlags();
 DeleteVersionCommand.skipValidInstallCheck = true;
 DeleteVersionCommand.description = `Delete a specific version of your integration.
 
-This only works if there are no users or Zaps on that version. You will probably need to have run \`zapier migrate\` and \`zapier deprecate\` before this command will work.`;
+This only works if there are no users or Zaps on that version. You will probably need to have run \`zapier-platform migrate\` and \`zapier-platform deprecate\` before this command will work.`;
 
 module.exports = DeleteVersionCommand;

package/src/oclif/commands/deprecate.js

@@ -23,7 +23,7 @@ class DeprecateCommand extends BaseCommand {
 
     this.log(
       `${colors.yellow('Warning: Deprecation is an irreversible action that will eventually block access to this version.')}\n` +
-        `${colors.yellow('If all your changes are non-breaking, use `zapier migrate` instead to move users over to a newer version.')}\n`,
+        `${colors.yellow('If all your changes are non-breaking, use `zapier-platform migrate` instead to move users over to a newer version.')}\n`,
     );
 
     // Get deprecation reason - either from flag or prompt user
@@ -118,9 +118,9 @@ DeprecateCommand.args = {
   }),
 };
 DeprecateCommand.examples = [
-  'zapier deprecate 1.2.3 2011-10-01',
-  'zapier deprecate 1.2.3 2011-10-01 --reason=security_vulnerability',
-  'zapier deprecate 1.2.3 2011-10-01 -r critical_bug',
+  'zapier-platform deprecate 1.2.3 2011-10-01',
+  'zapier-platform deprecate 1.2.3 2011-10-01 --reason=security_vulnerability',
+  'zapier-platform deprecate 1.2.3 2011-10-01 -r critical_bug',
 ];
 DeprecateCommand.description = `Mark a non-production version of your integration as deprecated, with removal by a certain date.
 

package/src/oclif/commands/describe.js

@@ -95,7 +95,7 @@ class DescribeCommand extends BaseCommand {
           authentication.redirect_uri = version.oauth_redirect_uri;
         } else {
           authentication.redirect_uri = grey(
-            'Run `zapier push` to see the redirect_uri.',
+            'Run `zapier-platform push` to see the redirect_uri.',
           );
         }
       }
@@ -182,13 +182,13 @@ class DescribeCommand extends BaseCommand {
           ['Available Methods', 'paths', grey('n/a')],
         ],
         emptyMessage: grey(
-          `Nothing found for ${type}. Use the \`zapier scaffold\` command to add one.`,
+          `Nothing found for ${type}. Use the \`zapier-platform scaffold\` command to add one.`,
         ),
       });
 
       this.log();
 
-      this.log('To add more, use the `zapier scaffold` command.');
+      this.log('To add more, use the `zapier-platform scaffold` command.');
     });
   }
 }

package/src/oclif/commands/env/get.js

@@ -19,7 +19,7 @@ class GetEnvCommand extends BaseCommand {
       emptyMessage: `Version ${version} has no environment values set`,
     });
 
-    this.log('Set new values with `zapier env:set`');
+    this.log('Set new values with `zapier-platform env:set`');
   }
 }
 
@@ -31,7 +31,7 @@ GetEnvCommand.args = {
 };
 GetEnvCommand.flags = buildFlags({ opts: { format: true } });
 GetEnvCommand.description = `Get environment variables for a version.`;
-GetEnvCommand.examples = [`zapier env:get 1.2.3`];
+GetEnvCommand.examples = [`zapier-platform env:get 1.2.3`];
 GetEnvCommand.skipValidInstallCheck = true;
 
 module.exports = GetEnvCommand;

package/src/oclif/commands/env/set.js

@@ -104,7 +104,9 @@ SetEnvCommand.flags = buildFlags({
   },
 });
 SetEnvCommand.description = `Set environment variables for a version.`;
-SetEnvCommand.examples = [`zapier env:set 1.2.3 SECRET=12345 OTHER=4321`];
+SetEnvCommand.examples = [
+  `zapier-platform env:set 1.2.3 SECRET=12345 OTHER=4321`,
+];
 SetEnvCommand.strict = false;
 SetEnvCommand.skipValidInstallCheck = true;
 

package/src/oclif/commands/env/unset.js

@@ -90,7 +90,7 @@ UnsetEnvCommand.flags = buildFlags({
   },
 });
 UnsetEnvCommand.description = `Unset environment variables for a version.`;
-UnsetEnvCommand.examples = [`zapier env:unset 1.2.3 SECRET OTHER`];
+UnsetEnvCommand.examples = [`zapier-platform env:unset 1.2.3 SECRET OTHER`];
 UnsetEnvCommand.strict = false;
 UnsetEnvCommand.skipValidInstallCheck = true;
 

package/src/oclif/commands/init.js

@@ -56,16 +56,16 @@ InitCommand.args = {
   }),
 };
 InitCommand.examples = [
-  'zapier init myapp',
-  'zapier init ./path/myapp --template oauth2',
-  'zapier init ./path/myapp --template minimal --module esm',
-  'zapier init ./path/myapp --template oauth2 --language typescript',
+  'zapier-platform init myapp',
+  'zapier-platform init ./path/myapp --template oauth2',
+  'zapier-platform init ./path/myapp --template minimal --module esm',
+  'zapier-platform init ./path/myapp --template oauth2 --language typescript',
 ];
 InitCommand.description = `Initialize a new Zapier integration with a project template.
 
 After running this, you'll have a new integration in the specified directory. If you re-run this command on an existing directory, it will prompt before overwriting any existing files.
 
-This doesn't register or deploy the integration with Zapier - try the \`zapier register\` and \`zapier push\` commands for that!`;
+This doesn't register or deploy the integration with Zapier - try the \`zapier-platform register\` and \`zapier-platform push\` commands for that!`;
 
 InitCommand.skipValidInstallCheck = true;
 

package/src/oclif/commands/integrations.js

@@ -19,7 +19,8 @@ class IntegrationsCommand extends BaseCommand {
         ['Date Created', 'date'],
         ['Linked', 'linked'],
       ],
-      emptyMessage: 'No integrations found, try the `zapier register` command.',
+      emptyMessage:
+        'No integrations found, try the `zapier-platform register` command.',
     });
   }
 }

package/src/oclif/commands/invoke/action.js

@@ -1,4 +1,5 @@
 const debug = require('debug')('zapier:invoke');
+const _ = require('lodash');
 
 const { startSpinner, endSpinner } = require('../../../utils/display');
 const { customLogger } = require('./logger');
@@ -71,8 +72,9 @@ const invokeAction = async (command, context) => {
     await promptForFields(command, context, inputFields, invokeAction);
   }
 
-  // Preserve original inputData as inputDataRaw before type resolution
-  const inputDataRaw = { ...context.inputData };
+  // Preserve original inputData as inputDataRaw before type resolution (deep
+  // copy needed because resolveInputDataTypes mutates nested objects in-place)
+  const inputDataRaw = _.cloneDeep(context.inputData);
   let inputData;
   if (context.remote) {
     // Let the remote server resolve input data types

package/src/oclif/commands/invoke/auth/refresh.js

@@ -69,7 +69,7 @@ const refreshAuth = async (context) => {
   }
   if (_.isEmpty(context.authData)) {
     throw new Error(
-      'No auth data found in the .env file. Run `zapier invoke auth start` first to initialize the auth data.',
+      'No auth data found in the .env file. Run `zapier-platform invoke auth start` first to initialize the auth data.',
     );
   }
   switch (authentication.type) {

package/src/oclif/commands/invoke/index.js

@@ -146,10 +146,12 @@ class InvokeCommand extends BaseCommand {
     context.appId = (await getLinkedAppConfig(null, false))?.id;
     context.deployKey = (await readCredentials(false))[AUTH_KEY];
 
+    const hasAuth = Boolean(context.appDefinition.authentication);
+
     if (
       context.authId === '-' ||
       context.authId === '' ||
-      (context.remote && !context.authId)
+      (context.remote && !context.authId && hasAuth)
     ) {
       if (context.nonInteractive) {
         throw new Error(
@@ -159,6 +161,12 @@ class InvokeCommand extends BaseCommand {
       context.authId = (await promptForAuthentication(this)).toString();
     }
 
+    if (context.remote && !context.authId && !hasAuth) {
+      // The remote invoke API requires authentication_id in the POST body,
+      // but the server accepts 0 for apps without authentication configured.
+      context.authId = '0';
+    }
+
     if (context.authId) {
       context.authId = parseInt(context.authId);
       if (isNaN(context.authId)) {
@@ -482,7 +490,6 @@ The \`--debug\` flag will show you the HTTP request logs and any console logs yo
 The following is a non-exhaustive list of current limitations in local and relay mode. We may support them in the future.
 
 - Hook triggers, including REST hook subscribe/unsubscribe
-- Line items
 - Output hydration
 - File upload
 - Function-based connection label

package/src/oclif/commands/invoke/input-types.js

@@ -57,7 +57,8 @@ const parseDecimal = (s) => {
     }
   }
   const cleaned = chars.join('').replace(/[.,-]$/, '');
-  return parseFloat(cleaned);
+  const result = parseFloat(cleaned);
+  return isNaN(result) ? 0 : result;
 };
 
 /**
@@ -232,7 +233,14 @@ const resolveInputDataTypes = (inputData, inputFields, timezone) => {
     }
   }
 
-  // TODO: Handle line items (fields with "children")
+  // Handle line items (fields with "children")
+  for (const field of inputFields) {
+    if (field.children && field.children.length && Array.isArray(inputData[field.key])) {
+      for (const item of inputData[field.key]) {
+        resolveInputDataTypes(item, field.children, timezone);
+      }
+    }
+  }
 
   return inputData;
 };