@zapier/zapier-sdk-cli 0.67.6 → 0.69.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +33 -15
  3. package/dist/cli.cjs +1598 -328
  4. package/dist/cli.mjs +1599 -331
  5. package/dist/experimental.cjs +1793 -30
  6. package/dist/experimental.d.mts +1 -1
  7. package/dist/experimental.d.ts +1 -1
  8. package/dist/experimental.mjs +1791 -33
  9. package/dist/{extensions-CU5Oy_Wv.d.mts → extensions-DSCQgX9d.d.mts} +177 -2
  10. package/dist/{extensions-CU5Oy_Wv.d.ts → extensions-DSCQgX9d.d.ts} +177 -2
  11. package/dist/index.cjs +1794 -33
  12. package/dist/index.d.mts +1 -1
  13. package/dist/index.d.ts +1 -1
  14. package/dist/index.mjs +1790 -34
  15. package/package.json +6 -4
  16. package/templates/setup/zapier-slack-test.mjs +38 -0
  17. package/templates/setup/zapier-slack-test.ts +38 -0
package/CHANGELOG.md CHANGED
@@ -1,5 +1,32 @@
1
1
  # @zapier/zapier-sdk-cli
2
2
 
3
+ ## 0.69.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 67db455: Added the interactive `zapier-sdk setup` command for guided SDK installation, authentication, connection discovery, a Slack proof, and connected-app ideas in your AI agent.
8
+
9
+ ### Patch Changes
10
+
11
+ - Updated dependencies [67db455]
12
+ - @zapier/zapier-sdk@0.92.1
13
+ - @zapier/zapier-sdk-mcp@0.18.22
14
+
15
+ ## 0.68.0
16
+
17
+ ### Minor Changes
18
+
19
+ - 56f0789: Added an `ignoreOpenDrafts` option (experimental) to `publishWorkflowVersion`, exposed in the CLI as `--ignore-open-drafts` on `publish-workflow-version`. Publishing a version directly is rejected with a 409 conflict while the workflow has open draft(s), since publishing a draft later would ship its stale content over the new version; set this option to publish anyway.
20
+
21
+ Every 409 from `publishWorkflowVersion` now surfaces as a `ZapierConflictError` (matching `publishWorkflowDraft`) instead of a generic API error. The open-draft 409 additionally lists the blocking drafts (id, slug, last edited) and the remediations — publish the draft (`publishWorkflowDraft`), discard it (`discardWorkflowDraft`), or force with `ignoreOpenDrafts`. The structured draft list rides on the error's `meta.open_drafts` (typed via the new `OpenDraftRef` export on `@zapier/zapier-sdk/experimental`), and the CLI's `--json` error envelope includes it, so agents can resolve the conflict without parsing the message.
22
+
23
+ ### Patch Changes
24
+
25
+ - Updated dependencies [87e634f]
26
+ - Updated dependencies [56f0789]
27
+ - @zapier/zapier-sdk@0.92.0
28
+ - @zapier/zapier-sdk-mcp@0.18.21
29
+
3
30
  ## 0.67.6
4
31
 
5
32
  ### Patch Changes
package/README.md CHANGED
@@ -101,6 +101,7 @@
101
101
  - [`get-login-config-path`](#get-login-config-path)
102
102
  - [`init`](#init)
103
103
  - [`mcp`](#mcp)
104
+ - [`setup`](#setup)
104
105
 
105
106
  ## Quick Start
106
107
 
@@ -120,6 +121,12 @@ npx @zapier/zapier-sdk-cli init my-zapier-app --non-interactive
120
121
 
121
122
  _For existing projects._
122
123
 
124
+ Run the guided setup to add undeclared Zapier SDK dependencies, authenticate, and inspect your connected apps:
125
+
126
+ ```bash
127
+ npx @zapier/zapier-sdk-cli setup
128
+ ```
129
+
123
130
  If you already have a project and want to add the CLI as a dependency:
124
131
 
125
132
  ```bash
@@ -815,25 +822,26 @@ Publish a new version of a durable workflow. Enables the workflow by default.
815
822
 
816
823
  **Options:**
817
824
 
818
- | Option | Type | Required | Default | Possible Values | Description |
819
- | -------------------------- | --------- | -------- | ------- | --------------- | -------------------------------------------------------------------------------------------------------------------- |
820
- | `<workflow>` | `string` | ✅ | — | — | Durable workflow ID |
821
- | `<source-files>` | `object` | ✅ | — | — | Source files keyed by filename → contents |
822
- | `--dependencies` | `object` | ❌ | — | — | Optional npm package dependencies |
823
- | `--zapier-durable-version` | `string` | ❌ | — | — | Exact semver of @zapier/zapier-durable to use (e.g. "1.2.3"). Defaults to server-configured version if omitted. |
824
- | `--enabled` | `boolean` | ❌ | — | — | Enable the workflow after publishing. Defaults to true; pass false to publish without enabling. |
825
- | `--connections` | `object` | ❌ | — | — | Map of connection aliases to Zapier connections used by the workflow. Pass `null` to clear an existing binding. |
826
- | `--app-versions` | `object` | ❌ | — | — | Map of app keys to pinned app implementation/version used by the workflow. Pass `null` to clear an existing binding. |
827
- | `--trigger` | `object` | ❌ | — | — | Trigger configuration. When provided, the workflow subscribes to a Zapier trigger; omit for webhook-only workflows. |
828
- | ​ ↳ `selectedApi` | `string` | ❌ | — | — | Zapier app/API identifier (e.g. 'GoogleSheetsAPI'). Required when a trigger is configured. |
829
- | ​ ↳ `action` | `string` | ✅ | — | — | Trigger action key (e.g. 'new_row') |
830
- | ​ ↳ `authenticationId` | `string` | ❌ | — | — | Connection ID for the trigger source. Omit or pass null for no-auth triggers (e.g. Schedule by Zapier). |
831
- | ​ ↳ `params` | `object` | ❌ | — | — | Trigger parameters as a JSON object |
825
+ | Option | Type | Required | Default | Possible Values | Description |
826
+ | -------------------------- | --------- | -------- | ------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
827
+ | `<workflow>` | `string` | ✅ | — | — | Durable workflow ID |
828
+ | `<source-files>` | `object` | ✅ | — | — | Source files keyed by filename → contents |
829
+ | `--dependencies` | `object` | ❌ | — | — | Optional npm package dependencies |
830
+ | `--zapier-durable-version` | `string` | ❌ | — | — | Exact semver of @zapier/zapier-durable to use (e.g. "1.2.3"). Defaults to server-configured version if omitted. |
831
+ | `--enabled` | `boolean` | ❌ | — | — | Enable the workflow after publishing. Defaults to true; pass false to publish without enabling. |
832
+ | `--ignore-open-drafts` | `boolean` | ❌ | — | — | Publish even though the workflow has open draft(s). Without this, the API rejects a direct publish with a 409 while any draft is open, since publishing the draft later would ship its stale content over this version. |
833
+ | `--connections` | `object` | ❌ | — | — | Map of connection aliases to Zapier connections used by the workflow. Pass `null` to clear an existing binding. |
834
+ | `--app-versions` | `object` | ❌ | — | — | Map of app keys to pinned app implementation/version used by the workflow. Pass `null` to clear an existing binding. |
835
+ | `--trigger` | `object` | ❌ | — | — | Trigger configuration. When provided, the workflow subscribes to a Zapier trigger; omit for webhook-only workflows. |
836
+ | ​ ↳ `selectedApi` | `string` | ❌ | — | — | Zapier app/API identifier (e.g. 'GoogleSheetsAPI'). Required when a trigger is configured. |
837
+ | ​ ↳ `action` | `string` | ✅ | — | — | Trigger action key (e.g. 'new_row') |
838
+ | ​ ↳ `authenticationId` | `string` | ❌ | — | — | Connection ID for the trigger source. Omit or pass null for no-auth triggers (e.g. Schedule by Zapier). |
839
+ | ​ ↳ `params` | `object` | ❌ | — | — | Trigger parameters as a JSON object |
832
840
 
833
841
  **Usage:**
834
842
 
835
843
  ```bash
836
- npx zapier-sdk publish-workflow-version <workflow> <source-files> [--dependencies] [--zapier-durable-version] [--enabled] [--connections] [--app-versions] [--trigger]
844
+ npx zapier-sdk publish-workflow-version <workflow> <source-files> [--dependencies] [--zapier-durable-version] [--enabled] [--ignore-open-drafts] [--connections] [--app-versions] [--trigger]
837
845
  ```
838
846
 
839
847
  #### `run-durable` 🧪 _experimental_
@@ -1816,3 +1824,13 @@ Start MCP server for Zapier SDK
1816
1824
  ```bash
1817
1825
  npx zapier-sdk mcp [--port]
1818
1826
  ```
1827
+
1828
+ #### `setup`
1829
+
1830
+ Set up the Zapier SDK in an existing or new project
1831
+
1832
+ **Usage:**
1833
+
1834
+ ```bash
1835
+ npx zapier-sdk setup
1836
+ ```