@zapier/zapier-sdk 0.99.0 → 0.100.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @zapier/zapier-sdk
 
+## 0.100.0
+
+### Minor Changes
+
+- 22a885c: Added `validateWorkflow` (experimental) to check durable workflow source without publishing it. Pass `sourceFiles` (absolute logical path → TypeScript source) and an optional `entrypointFile`, which defaults to `/workflow.ts`. The response carries an `issues` array that is empty when the source is valid; each issue has a `kind`, a `message`, a `severity` (`error`, `warning`, `info`, or `hint`), an optional `suggestion`, and usually the `source` location it points at. New `kind` values are added over time, so treat an unfamiliar one as a diagnostic rather than an error.
+
 ## 0.99.0
 
 ### Minor Changes

package/README.md

@@ -53,6 +53,7 @@
   - [`triggerWorkflow`](#triggerworkflow--experimental)
   - [`updateWorkflow`](#updateworkflow--experimental)
   - [`updateWorkflowDraft`](#updateworkflowdraft--experimental)
+  - [`validateWorkflow`](#validateworkflow--experimental)
 - [Connections](#connections)
   - [`createConnection`](#createconnection)
   - [`findFirstConnection`](#findfirstconnection)
@@ -2213,6 +2214,48 @@ const { data: workflowDraft } = await zapier.updateWorkflowDraft({
 });
 ```
 
+#### `validateWorkflow` 🧪 _experimental_
+
+Validate durable workflow source without publishing it. Returns source diagnostics; issue kinds are extensible and may be unfamiliar to the client.
+
+**Parameters:**
+
+| Name                 | Type     | Required | Default | Possible Values | Description                                                                       |
+| -------------------- | -------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------- |
+| `options`            | `object` | ✅       | —       | —               |                                                                                   |
+| ​ ↳ `sourceFiles`    | `object` | ✅       | —       | —               | Exact TypeScript sources keyed by absolute logical path.                          |
+| ​ ↳ `entrypointFile` | `string` | ❌       | —       | —               | Absolute logical path of the entry file in sourceFiles. Defaults to /workflow.ts. |
+
+**Returns:** `Promise<WorkflowValidationItem>`
+
+| Name                   | Type       | Required | Possible Values                    | Description                                                                         |
+| ---------------------- | ---------- | -------- | ---------------------------------- | ----------------------------------------------------------------------------------- |
+| `data`                 | `object`   | ✅       | —                                  |                                                                                     |
+| ​ ↳ `issues[]`         | `object[]` | ✅       | —                                  | Source diagnostics, or an empty array when validation passes.                       |
+| ​   ↳ `kind`           | `string`   | ✅       | —                                  | Extensible diagnostic category; clients must accept unfamiliar values.              |
+| ​   ↳ `message`        | `string`   | ✅       | —                                  | Safe human-readable explanation.                                                    |
+| ​   ↳ `severity`       | `string`   | ✅       | `error`, `warning`, `info`, `hint` | Diagnostic severity.                                                                |
+| ​   ↳ `suggestion`     | `string`   | ❌       | —                                  | Actionable fix hint.                                                                |
+| ​   ↳ `source`         | `object`   | ❌       | —                                  | Affected source location.                                                           |
+| ​     ↳ `file_id`      | `string`   | ✅       | —                                  | Source file containing the diagnostic.                                              |
+| ​     ↳ `start_line`   | `number`   | ✅       | —                                  | Inclusive 1-based start line.                                                       |
+| ​     ↳ `start_column` | `number`   | ✅       | —                                  | Inclusive 1-based start column.                                                     |
+| ​     ↳ `end_line`     | `number`   | ✅       | —                                  | Inclusive 1-based end line.                                                         |
+| ​     ↳ `end_column`   | `number`   | ✅       | —                                  | Inclusive 1-based end column.                                                       |
+| ​   ↳ `source_excerpt` | `string`   | ❌       | —                                  | Source text the diagnostic was raised against, truncated to 240 characters.         |
+| ​   ↳ `syntax_kind`    | `string`   | ❌       | —                                  | TypeScript AST node kind the diagnostic was raised against (e.g. `CallExpression`). |
+
+**Example:**
+
+```typescript
+const { data: workflowValidation } = await zapier.validateWorkflow({
+  sourceFiles: {
+    "/workflow.ts":
+      'import { defineDurable } from "@zapier/zapier-durable"; export default defineDurable("hello-world", async (ctx, input) => { return ctx.step("greet", async () => "Hello, world!"); });',
+  },
+});
+```
+
 ### Connections
 
 #### `createConnection`

package/dist/{chunk-BUAAO3AY.cjs → chunk-7MVYZYCM.cjs}

@@ -6903,7 +6903,7 @@ function parseDeprecationDate(value) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.99.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.100.0" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -7138,6 +7138,13 @@ var pathConfig = {
     authHeader: "Authorization",
     pathPrefix: "/api/v0/sdk/code-substrate-workflows"
   },
+  // e.g. /code-substrate-analyzer/validations ->
+  // https://api.zapier.com/code-substrate-analyzer/v0/validations
+  "/code-substrate-analyzer": {
+    authHeader: "Authorization",
+    pathPrefix: "/code-substrate-analyzer/v0",
+    subdomain: "api"
+  },
   // e.g. /forms/v0/forms -> https://api.zapier.com/forms/v0/forms
   // The Forms API is registered on the Public API Gateway and has no sdkapi
   // proxy route, so it goes straight to the gateway. Its governance metadata

package/dist/{chunk-VXVMVORI.mjs → chunk-BSSVO2VM.mjs}

@@ -6901,7 +6901,7 @@ function parseDeprecationDate(value) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.99.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.100.0" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -7136,6 +7136,13 @@ var pathConfig = {
     authHeader: "Authorization",
     pathPrefix: "/api/v0/sdk/code-substrate-workflows"
   },
+  // e.g. /code-substrate-analyzer/validations ->
+  // https://api.zapier.com/code-substrate-analyzer/v0/validations
+  "/code-substrate-analyzer": {
+    authHeader: "Authorization",
+    pathPrefix: "/code-substrate-analyzer/v0",
+    subdomain: "api"
+  },
   // e.g. /forms/v0/forms -> https://api.zapier.com/forms/v0/forms
   // The Forms API is registered on the Public API Gateway and has no sdkapi
   // proxy route, so it goes straight to the gateway. Its governance metadata