@zapier/zapier-sdk 0.33.4 → 0.34.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @zapier/zapier-sdk
 
+## 0.34.0
+
+### Minor Changes
+
+- 3700f6a: Fix --json output
+
 ## 0.33.4
 
 ### Patch Changes

package/README.md

@@ -440,19 +440,19 @@ Get the available choices for a dynamic dropdown input field
 
 **Parameters:**
 
-| Name              | Type             | Required | Default | Possible Values                                                                                | Description                                            |
-| ----------------- | ---------------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
-| `options`         | `object`         | ✅       | —       | —                                                                                              |                                                        |
-| ↳ `appKey`        | `string`         | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI' or slug like 'github')    |
-| ↳ `actionType`    | `string`         | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type     |
-| ↳ `actionKey`     | `string`         | ✅       | —       | —                                                                                              | Action key to execute                                  |
-| ↳ `inputFieldKey` | `string`         | ✅       | —       | —                                                                                              | Input field key to get choices for.                    |
-| ↳ `connectionId`  | `string, number` | ❌       | —       | —                                                                                              | Connection ID to use for this action                   |
-| ↳ `inputs`        | `object`         | ❌       | —       | —                                                                                              | Current input values that may affect available choices |
-| ↳ `page`          | `number`         | ❌       | —       | —                                                                                              | Page number for paginated results                      |
-| ↳ `pageSize`      | `number`         | ❌       | —       | —                                                                                              | Number of choices per page                             |
-| ↳ `maxItems`      | `number`         | ❌       | —       | —                                                                                              | Maximum total items to return across all pages         |
-| ↳ `cursor`        | `string`         | ❌       | —       | —                                                                                              | Cursor to start from                                   |
+| Name              | Type             | Required | Default | Possible Values                                                                                | Description                                                                                                                                |
+| ----------------- | ---------------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| `options`         | `object`         | ✅       | —       | —                                                                                              |                                                                                                                                            |
+| ↳ `appKey`        | `string`         | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI' or slug like 'github')                                                                                        |
+| ↳ `actionType`    | `string`         | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type                                                                                         |
+| ↳ `actionKey`     | `string`         | ✅       | —       | —                                                                                              | Action key to execute                                                                                                                      |
+| ↳ `inputFieldKey` | `string`         | ✅       | —       | —                                                                                              | Input field key to get choices for.                                                                                                        |
+| ↳ `connectionId`  | `string, number` | ❌       | —       | —                                                                                              | Connection ID to use when listing available field choices. Required if the action needs a connection to populate dynamic dropdown options. |
+| ↳ `inputs`        | `object`         | ❌       | —       | —                                                                                              | Current input values that may affect available choices                                                                                     |
+| ↳ `page`          | `number`         | ❌       | —       | —                                                                                              | Page number for paginated results                                                                                                          |
+| ↳ `pageSize`      | `number`         | ❌       | —       | —                                                                                              | Number of choices per page                                                                                                                 |
+| ↳ `maxItems`      | `number`         | ❌       | —       | —                                                                                              | Maximum total items to return across all pages                                                                                             |
+| ↳ `cursor`        | `string`         | ❌       | —       | —                                                                                              | Cursor to start from                                                                                                                       |
 
 **Returns:** `Promise<PaginatedResult<InputFieldChoiceItem>>`
 
@@ -497,17 +497,17 @@ Get the input fields required for a specific action
 
 **Parameters:**
 
-| Name             | Type             | Required | Default | Possible Values                                                                                | Description                                           |
-| ---------------- | ---------------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
-| `options`        | `object`         | ✅       | —       | —                                                                                              |                                                       |
-| ↳ `appKey`       | `string`         | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI' or slug like 'github')   |
-| ↳ `actionType`   | `string`         | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type    |
-| ↳ `actionKey`    | `string`         | ✅       | —       | —                                                                                              | Action key to execute                                 |
-| ↳ `connectionId` | `string, number` | ❌       | —       | —                                                                                              | Connection ID to use for this action                  |
-| ↳ `inputs`       | `object`         | ❌       | —       | —                                                                                              | Current input values that may affect available fields |
-| ↳ `pageSize`     | `number`         | ❌       | —       | —                                                                                              | Number of input fields per page                       |
-| ↳ `maxItems`     | `number`         | ❌       | —       | —                                                                                              | Maximum total items to return across all pages        |
-| ↳ `cursor`       | `string`         | ❌       | —       | —                                                                                              | Cursor to start from                                  |
+| Name             | Type             | Required | Default | Possible Values                                                                                | Description                                                                                                              |
+| ---------------- | ---------------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| `options`        | `object`         | ✅       | —       | —                                                                                              |                                                                                                                          |
+| ↳ `appKey`       | `string`         | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI' or slug like 'github')                                                                      |
+| ↳ `actionType`   | `string`         | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type                                                                       |
+| ↳ `actionKey`    | `string`         | ✅       | —       | —                                                                                              | Action key to execute                                                                                                    |
+| ↳ `connectionId` | `string, number` | ❌       | —       | —                                                                                              | Connection ID to use when listing input fields. Required if the action needs a connection to determine available fields. |
+| ↳ `inputs`       | `object`         | ❌       | —       | —                                                                                              | Current input values that may affect available fields                                                                    |
+| ↳ `pageSize`     | `number`         | ❌       | —       | —                                                                                              | Number of input fields per page                                                                                          |
+| ↳ `maxItems`     | `number`         | ❌       | —       | —                                                                                              | Maximum total items to return across all pages                                                                           |
+| ↳ `cursor`       | `string`         | ❌       | —       | —                                                                                              | Cursor to start from                                                                                                     |
 
 **Returns:** `Promise<PaginatedResult<RootFieldItemItem>>`
 
@@ -548,18 +548,18 @@ Execute an action with the given inputs
 
 **Parameters:**
 
-| Name             | Type             | Required | Default | Possible Values                                                                                | Description                                                                  |
-| ---------------- | ---------------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
-| `options`        | `object`         | ✅       | —       | —                                                                                              |                                                                              |
-| ↳ `appKey`       | `string`         | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI' or slug like 'github')                          |
-| ↳ `actionType`   | `string`         | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type                           |
-| ↳ `actionKey`    | `string`         | ✅       | —       | —                                                                                              | Action key to execute                                                        |
-| ↳ `connectionId` | `string, number` | ❌       | —       | —                                                                                              | Connection ID to use for this action                                         |
-| ↳ `inputs`       | `object`         | ❌       | —       | —                                                                                              | Input parameters for the action                                              |
-| ↳ `timeoutMs`    | `number`         | ❌       | —       | —                                                                                              | Maximum time to wait for action completion in milliseconds (default: 180000) |
-| ↳ `pageSize`     | `number`         | ❌       | —       | —                                                                                              | Number of results per page                                                   |
-| ↳ `maxItems`     | `number`         | ❌       | —       | —                                                                                              | Maximum total items to return across all pages                               |
-| ↳ `cursor`       | `string`         | ❌       | —       | —                                                                                              | Cursor to start from                                                         |
+| Name             | Type             | Required | Default | Possible Values                                                                                | Description                                                                                                                            |
+| ---------------- | ---------------- | -------- | ------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
+| `options`        | `object`         | ✅       | —       | —                                                                                              |                                                                                                                                        |
+| ↳ `appKey`       | `string`         | ✅       | —       | —                                                                                              | App key (e.g., 'SlackCLIAPI' or slug like 'github')                                                                                    |
+| ↳ `actionType`   | `string`         | ✅       | —       | `read`, `read_bulk`, `write`, `run`, `search`, `search_or_write`, `search_and_write`, `filter` | Action type that matches the action's defined type                                                                                     |
+| ↳ `actionKey`    | `string`         | ✅       | —       | —                                                                                              | Action key to execute                                                                                                                  |
+| ↳ `connectionId` | `string, number` | ❌       | —       | —                                                                                              | Connection ID to use when running the action. Required if the action needs a connection to authenticate and interact with the service. |
+| ↳ `inputs`       | `object`         | ❌       | —       | —                                                                                              | Input parameters for the action                                                                                                        |
+| ↳ `timeoutMs`    | `number`         | ❌       | —       | —                                                                                              | Maximum time to wait for action completion in milliseconds (default: 180000)                                                           |
+| ↳ `pageSize`     | `number`         | ❌       | —       | —                                                                                              | Number of results per page                                                                                                             |
+| ↳ `maxItems`     | `number`         | ❌       | —       | —                                                                                              | Maximum total items to return across all pages                                                                                         |
+| ↳ `cursor`       | `string`         | ❌       | —       | —                                                                                              | Cursor to start from                                                                                                                   |
 
 **Returns:** `Promise<PaginatedResult<ActionResultItem>>`
 

package/dist/index.cjs

@@ -122,12 +122,14 @@ var ZapierApiError = class extends ZapierError {
   constructor(message, options = {}) {
     super(message, options);
     this.name = "ZapierApiError";
+    this.code = "ZAPIER_API_ERROR";
   }
 };
 var ZapierAppNotFoundError = class extends ZapierError {
   constructor(message, options = {}) {
     super(message, options);
     this.name = "ZapierAppNotFoundError";
+    this.code = "ZAPIER_APP_NOT_FOUND_ERROR";
     this.appKey = options.appKey;
   }
 };
@@ -135,6 +137,7 @@ var ZapierValidationError = class extends ZapierError {
   constructor(message, options = {}) {
     super(message, options);
     this.name = "ZapierValidationError";
+    this.code = "ZAPIER_VALIDATION_ERROR";
     this.details = options.details;
   }
 };
@@ -142,18 +145,21 @@ var ZapierUnknownError = class extends ZapierError {
   constructor(message, options = {}) {
     super(message, options);
     this.name = "ZapierUnknownError";
+    this.code = "ZAPIER_UNKNOWN_ERROR";
   }
 };
 var ZapierAuthenticationError = class extends ZapierError {
   constructor(message, options = {}) {
     super(message, options);
     this.name = "ZapierAuthenticationError";
+    this.code = "ZAPIER_AUTHENTICATION_ERROR";
   }
 };
 var ZapierResourceNotFoundError = class extends ZapierError {
   constructor(message, options = {}) {
     super(message, options);
     this.name = "ZapierResourceNotFoundError";
+    this.code = "ZAPIER_RESOURCE_NOT_FOUND_ERROR";
     this.resourceType = options.resourceType;
     this.resourceId = options.resourceId;
   }
@@ -162,6 +168,7 @@ var ZapierConfigurationError = class extends ZapierError {
   constructor(message, options = {}) {
     super(message, options);
     this.name = "ZapierConfigurationError";
+    this.code = "ZAPIER_CONFIGURATION_ERROR";
     this.configType = options.configType;
   }
 };
@@ -169,6 +176,7 @@ var ZapierBundleError = class extends ZapierError {
   constructor(message, options = {}) {
     super(message, options);
     this.name = "ZapierBundleError";
+    this.code = "ZAPIER_BUNDLE_ERROR";
     this.buildErrors = options.buildErrors;
   }
 };
@@ -176,6 +184,7 @@ var ZapierTimeoutError = class extends ZapierError {
   constructor(message, options = {}) {
     super(message, options);
     this.name = "ZapierTimeoutError";
+    this.code = "ZAPIER_TIMEOUT_ERROR";
     this.attempts = options.attempts;
     this.maxAttempts = options.maxAttempts;
   }
@@ -184,6 +193,7 @@ var ZapierActionError = class extends ZapierError {
   constructor(message, options = {}) {
     super(message, options);
     this.name = "ZapierActionError";
+    this.code = "ZAPIER_ACTION_ERROR";
     this.appKey = options.appKey;
     this.actionKey = options.actionKey;
   }
@@ -196,12 +206,14 @@ var ZapierNotFoundError = class extends ZapierError {
   constructor(message, options = {}) {
     super(message, options);
     this.name = "ZapierNotFoundError";
+    this.code = "ZAPIER_NOT_FOUND_ERROR";
   }
 };
 var ZapierRateLimitError = class extends ZapierError {
   constructor(message, options = {}) {
     super(message, options);
     this.name = "ZapierRateLimitError";
+    this.code = "ZAPIER_RATE_LIMIT_ERROR";
     this.rateLimit = options.rateLimit ?? {};
     this.retries = options.retries ?? 0;
   }
@@ -210,6 +222,7 @@ var ZapierRelayError = class extends ZapierError {
   constructor(message, options = {}) {
     super(message, options);
     this.name = "ZapierRelayError";
+    this.code = "ZAPIER_RELAY_ERROR";
   }
 };
 function formatErrorMessage(error) {
@@ -632,32 +645,63 @@ var fetchPlugin = ({ context }) => {
 };
 
 // src/utils/pagination-utils.ts
-var offsetCursorMarker = "$$offset$$";
-function splitOffsetCursor(cursor) {
-  if (!cursor) {
-    return [0, cursor];
+var CURSOR_VERSION = 1;
+var CURSOR_SOURCE = {
+  API: "api",
+  SDK: "sdk"
+};
+function encodeBase64(str) {
+  return btoa(
+    Array.from(
+      new TextEncoder().encode(str),
+      (b) => String.fromCharCode(b)
+    ).join("")
+  );
+}
+function decodeBase64(str) {
+  return new TextDecoder().decode(
+    Uint8Array.from(atob(str), (c) => c.charCodeAt(0))
+  );
+}
+function encodeApiCursor(cursor) {
+  const envelope = {
+    v: CURSOR_VERSION,
+    source: CURSOR_SOURCE.API,
+    cursor
+  };
+  return encodeBase64(JSON.stringify(envelope));
+}
+function encodeSdkCursor(offset, cursor) {
+  const envelope = {
+    v: CURSOR_VERSION,
+    source: CURSOR_SOURCE.SDK,
+    cursor,
+    offset
+  };
+  return encodeBase64(JSON.stringify(envelope));
+}
+function decodeIncomingCursor(incoming) {
+  if (!incoming) {
+    return { offset: 0, cursor: void 0 };
   }
   try {
-    const parsedCursor = JSON.parse(cursor);
-    if (!Array.isArray(parsedCursor)) {
-      return [0, cursor];
+    const decoded = decodeBase64(incoming);
+    const envelope = JSON.parse(decoded);
+    if (envelope.v !== CURSOR_VERSION) {
+      return { offset: 0, cursor: incoming };
     }
-    const [marker, offset, currentCursor] = parsedCursor;
-    if (marker !== offsetCursorMarker) {
-      return [0, cursor];
+    if (envelope.source === CURSOR_SOURCE.SDK) {
+      return { offset: envelope.offset ?? 0, cursor: envelope.cursor };
     }
-    if (typeof offset !== "number") {
-      return [0, cursor];
+    if (envelope.source === CURSOR_SOURCE.API) {
+      return { offset: 0, cursor: envelope.cursor };
     }
-    return [offset, currentCursor];
+    return { offset: 0, cursor: incoming };
   } catch {
-    return [0, cursor];
+    return { offset: 0, cursor: incoming };
   }
 }
-function createOffsetCursor(offset, currentCursor) {
-  return JSON.stringify([offsetCursorMarker, offset, currentCursor]);
-}
-async function* paginateMaxItems(pageFunction, pageOptions) {
+async function* paginateMaxItemsWithUnencodedCursor(pageFunction, pageOptions) {
   let cursor = pageOptions?.cursor;
   let totalItemsYielded = 0;
   const maxItems = pageOptions?.maxItems;
@@ -672,12 +716,11 @@ async function* paginateMaxItems(pageFunction, pageOptions) {
     if (maxItems !== void 0) {
       const remainingItems = maxItems - totalItemsYielded;
       if (page.data.length >= remainingItems) {
-        const yieldedPage = {
+        yield {
           ...page,
           data: page.data.slice(0, remainingItems),
           nextCursor: void 0
         };
-        yield yieldedPage;
         break;
       }
     }
@@ -688,16 +731,38 @@ async function* paginateMaxItems(pageFunction, pageOptions) {
 }
 async function* paginateBuffered(pageFunction, pageOptions) {
   const pageSize = pageOptions?.pageSize;
-  const [cursorOffset, currentCursor] = splitOffsetCursor(pageOptions?.cursor);
+  const { offset: cursorOffset, cursor: initialCursor } = decodeIncomingCursor(
+    pageOptions?.cursor
+  );
+  const requestedMaxItems = pageOptions?.maxItems;
   const options = {
     ...pageOptions || {},
-    cursor: currentCursor
+    cursor: initialCursor,
+    // SDK cursors can carry an offset into a raw backend page. Since maxItems
+    // is expected to be relative to the resumed position, we add that offset
+    // so raw pagination still yields enough items after offset slicing.
+    maxItems: requestedMaxItems !== void 0 && cursorOffset > 0 ? requestedMaxItems + cursorOffset : requestedMaxItems
   };
-  const iterator = paginateMaxItems(pageFunction, options);
+  if (!pageSize) {
+    for await (const page of paginateMaxItemsWithUnencodedCursor(
+      pageFunction,
+      options
+    )) {
+      yield {
+        ...page,
+        nextCursor: page.nextCursor ? encodeApiCursor(page.nextCursor) : void 0
+      };
+    }
+    return;
+  }
   let bufferedPages = [];
   let isFirstPage = true;
-  let cursor;
-  for await (let page of iterator) {
+  let rawCursor;
+  for await (let page of paginateMaxItemsWithUnencodedCursor(
+    pageFunction,
+    options
+  )) {
+    const nextRawCursor = page.nextCursor;
     if (isFirstPage) {
       isFirstPage = false;
       if (cursorOffset) {
@@ -707,18 +772,13 @@ async function* paginateBuffered(pageFunction, pageOptions) {
         };
       }
     }
-    if (!pageSize) {
-      yield page;
-      cursor = page.nextCursor;
-      continue;
-    }
     const bufferedLength = bufferedPages.reduce(
-      (acc, page2) => acc + page2.data.length,
+      (acc, p) => acc + p.data.length,
       0
     );
     if (bufferedLength + page.data.length < pageSize) {
       bufferedPages.push(page);
-      cursor = page.nextCursor;
+      rawCursor = nextRawCursor;
       continue;
     }
     const bufferedItems = bufferedPages.map((p) => p.data).flat();
@@ -729,28 +789,28 @@ async function* paginateBuffered(pageFunction, pageOptions) {
       yield {
         ...page,
         data: pageItems,
-        nextCursor: page.nextCursor
+        nextCursor: nextRawCursor ? encodeApiCursor(nextRawCursor) : void 0
       };
       bufferedPages = [];
-      cursor = page.nextCursor;
+      rawCursor = nextRawCursor;
       continue;
     }
     yield {
       ...page,
       data: pageItems,
-      nextCursor: createOffsetCursor(
+      nextCursor: encodeSdkCursor(
         page.data.length - remainingItems.length,
-        cursor
+        rawCursor
       )
     };
     while (remainingItems.length > pageSize) {
-      const pageItems2 = remainingItems.splice(0, pageSize);
+      const chunkItems = remainingItems.splice(0, pageSize);
       yield {
         ...page,
-        data: pageItems2,
-        nextCursor: createOffsetCursor(
+        data: chunkItems,
+        nextCursor: encodeSdkCursor(
           page.data.length - remainingItems.length,
-          cursor
+          rawCursor
         )
       };
     }
@@ -760,7 +820,7 @@ async function* paginateBuffered(pageFunction, pageOptions) {
         data: remainingItems
       }
     ];
-    cursor = page.nextCursor;
+    rawCursor = nextRawCursor;
   }
   if (bufferedPages.length > 0) {
     const lastBufferedPage = bufferedPages.slice(-1)[0];
@@ -1897,7 +1957,9 @@ var ListInputFieldsSchema = zod.z.object({
   appKey: AppKeyPropertySchema,
   actionType: ActionTypePropertySchema,
   actionKey: ActionKeyPropertySchema,
-  connectionId: ConnectionIdPropertySchema.nullable().optional(),
+  connectionId: ConnectionIdPropertySchema.nullable().optional().describe(
+    "Connection ID to use when listing input fields. Required if the action needs a connection to determine available fields."
+  ),
   /** @deprecated Use connectionId instead */
   authenticationId: AuthenticationIdPropertySchema.nullable().optional(),
   inputs: InputsPropertySchema.optional().describe(
@@ -2895,7 +2957,9 @@ var RunActionSchema = zod.z.object({
   appKey: AppKeyPropertySchema,
   actionType: ActionTypePropertySchema,
   actionKey: ActionKeyPropertySchema,
-  connectionId: ConnectionIdPropertySchema.nullable().optional(),
+  connectionId: ConnectionIdPropertySchema.nullable().optional().describe(
+    "Connection ID to use when running the action. Required if the action needs a connection to authenticate and interact with the service."
+  ),
   /** @deprecated Use connectionId instead */
   authenticationId: ConnectionIdPropertySchema.nullable().optional(),
   inputs: InputsPropertySchema.optional().describe(
@@ -4980,7 +5044,8 @@ var registryPlugin = ({ sdk, context }) => {
       confirm: meta.confirm ?? (meta.type === "delete" ? "delete" : void 0),
       deprecation: meta.deprecation,
       deprecatedParameters: meta.deprecatedParameters,
-      aliases: meta.aliases
+      aliases: meta.aliases,
+      supportsJsonOutput: meta.supportsJsonOutput ?? true
     };
   }).sort((a, b) => a.name.localeCompare(b.name));
   const knownCategories = Object.keys(categoryDefinitions);
@@ -5214,7 +5279,9 @@ var ListInputFieldChoicesSchema = zod.z.object({
   // Input field specification
   inputFieldKey: zod.z.string().min(1).describe("Input field key to get choices for."),
   // Common parameters
-  connectionId: ConnectionIdPropertySchema.nullable().optional(),
+  connectionId: ConnectionIdPropertySchema.nullable().optional().describe(
+    "Connection ID to use when listing available field choices. Required if the action needs a connection to populate dynamic dropdown options."
+  ),
   /** @deprecated Use connectionId instead */
   authenticationId: AuthenticationIdPropertySchema.nullable().optional(),
   inputs: InputsPropertySchema.optional().describe(
@@ -5513,7 +5580,7 @@ function getCpuTime() {
 }
 
 // src/plugins/eventEmission/builders.ts
-var SDK_VERSION = "0.33.4";
+var SDK_VERSION = "0.34.0";
 function createBaseEvent(context = {}) {
   return {
     event_id: generateEventId(),

package/dist/index.d.mts

@@ -1045,12 +1045,11 @@ interface FunctionOptions {
     /** Custom fetch implementation */
     fetch?: typeof globalThis.fetch;
 }
-type PaginatedSdkFunction<TOptions, TItem> = (options: TOptions) => Promise<{
-    data: TItem[];
-}> & AsyncIterable<{
-    data: TItem[];
+interface SdkPage<T = unknown> {
+    data: T[];
     nextCursor?: string;
-}> & {
+}
+type PaginatedSdkFunction<TOptions, TItem> = (options: TOptions) => Promise<SdkPage<TItem>> & AsyncIterable<SdkPage<TItem>> & {
     items(): AsyncIterable<TItem>;
 };
 
@@ -1080,6 +1079,7 @@ interface ErrorOptions {
  */
 declare abstract class ZapierError extends Error {
     abstract readonly name: string;
+    abstract readonly code: string;
     statusCode?: number;
     errors?: ApiError[];
     cause?: unknown;
@@ -1091,6 +1091,7 @@ declare abstract class ZapierError extends Error {
  */
 declare class ZapierApiError extends ZapierError {
     readonly name = "ZapierApiError";
+    readonly code: "ZAPIER_API_ERROR";
     constructor(message: string, options?: ErrorOptions);
 }
 /**
@@ -1098,6 +1099,7 @@ declare class ZapierApiError extends ZapierError {
  */
 declare class ZapierAppNotFoundError extends ZapierError {
     readonly name = "ZapierAppNotFoundError";
+    readonly code: "ZAPIER_APP_NOT_FOUND_ERROR";
     appKey?: string;
     constructor(message: string, options?: ErrorOptions & {
         appKey?: string;
@@ -1108,6 +1110,7 @@ declare class ZapierAppNotFoundError extends ZapierError {
  */
 declare class ZapierValidationError extends ZapierError {
     readonly name = "ZapierValidationError";
+    readonly code: "ZAPIER_VALIDATION_ERROR";
     details?: unknown;
     constructor(message: string, options?: ErrorOptions & {
         details?: unknown;
@@ -1118,6 +1121,7 @@ declare class ZapierValidationError extends ZapierError {
  */
 declare class ZapierUnknownError extends ZapierError {
     readonly name = "ZapierUnknownError";
+    readonly code: "ZAPIER_UNKNOWN_ERROR";
     constructor(message: string, options?: ErrorOptions);
 }
 /**
@@ -1125,6 +1129,7 @@ declare class ZapierUnknownError extends ZapierError {
  */
 declare class ZapierAuthenticationError extends ZapierError {
     readonly name = "ZapierAuthenticationError";
+    readonly code: "ZAPIER_AUTHENTICATION_ERROR";
     constructor(message: string, options?: ErrorOptions);
 }
 /**
@@ -1132,6 +1137,7 @@ declare class ZapierAuthenticationError extends ZapierError {
  */
 declare class ZapierResourceNotFoundError extends ZapierError {
     readonly name = "ZapierResourceNotFoundError";
+    readonly code: "ZAPIER_RESOURCE_NOT_FOUND_ERROR";
     resourceType?: string;
     resourceId?: string;
     constructor(message: string, options?: ErrorOptions & {
@@ -1144,6 +1150,7 @@ declare class ZapierResourceNotFoundError extends ZapierError {
  */
 declare class ZapierConfigurationError extends ZapierError {
     readonly name = "ZapierConfigurationError";
+    readonly code: "ZAPIER_CONFIGURATION_ERROR";
     configType?: string;
     constructor(message: string, options?: ErrorOptions & {
         configType?: string;
@@ -1154,6 +1161,7 @@ declare class ZapierConfigurationError extends ZapierError {
  */
 declare class ZapierBundleError extends ZapierError {
     readonly name = "ZapierBundleError";
+    readonly code: "ZAPIER_BUNDLE_ERROR";
     buildErrors?: string[];
     constructor(message: string, options?: ErrorOptions & {
         buildErrors?: string[];
@@ -1164,6 +1172,7 @@ declare class ZapierBundleError extends ZapierError {
  */
 declare class ZapierTimeoutError extends ZapierError {
     readonly name = "ZapierTimeoutError";
+    readonly code: "ZAPIER_TIMEOUT_ERROR";
     attempts?: number;
     maxAttempts?: number;
     constructor(message: string, options?: ErrorOptions & {
@@ -1177,6 +1186,7 @@ declare class ZapierTimeoutError extends ZapierError {
  */
 declare class ZapierActionError extends ZapierError {
     readonly name = "ZapierActionError";
+    readonly code: "ZAPIER_ACTION_ERROR";
     appKey?: string;
     actionKey?: string;
     constructor(message: string, options?: ErrorOptions & {
@@ -1190,6 +1200,7 @@ declare class ZapierActionError extends ZapierError {
  */
 declare class ZapierNotFoundError extends ZapierError {
     readonly name = "ZapierNotFoundError";
+    readonly code: "ZAPIER_NOT_FOUND_ERROR";
     constructor(message: string, options?: ErrorOptions);
 }
 /**
@@ -1210,6 +1221,7 @@ interface RateLimitInfo {
  */
 declare class ZapierRateLimitError extends ZapierError {
     readonly name = "ZapierRateLimitError";
+    readonly code: "ZAPIER_RATE_LIMIT_ERROR";
     rateLimit: RateLimitInfo;
     retries: number;
     constructor(message: string, options?: ErrorOptions & {
@@ -1223,6 +1235,7 @@ declare class ZapierRateLimitError extends ZapierError {
  */
 declare class ZapierRelayError extends ZapierError {
     readonly name = "ZapierRelayError";
+    readonly code: "ZAPIER_RELAY_ERROR";
     constructor(message: string, options?: ErrorOptions);
 }
 /**
@@ -2143,6 +2156,8 @@ interface FunctionRegistryEntry {
     deprecatedParameters?: string[];
     /** Short flag aliases for CLI options (e.g., { request: "X", header: "H" }) */
     aliases?: Record<string, string>;
+    /** Defaults to true. Set to false to suppress --json (e.g. login/logout/init). */
+    supportsJsonOutput: boolean;
 }
 interface FunctionDeprecation {
     /** User-facing deprecation message for why/how to migrate */
@@ -2969,4 +2984,4 @@ declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): Sdk
 }>;
 declare function createZapierSdk(options?: ZapierSdkOptions): ZapierSdk;
 
-export { type Action, type ActionEntry, type ActionExecutionOptions, type ActionExecutionResult, type ActionField, type ActionFieldChoice, type ActionItem$1 as ActionItem, type ActionKeyProperty, ActionKeyPropertySchema, type ActionTimeoutMsProperty, ActionTimeoutMsPropertySchema, type ActionTypeProperty, ActionTypePropertySchema, type AddActionEntryOptions, type AddActionEntryResult, type ApiError, type ApiEvent, type ApiPluginOptions, type ApiPluginProvides, type App, type AppItem, type AppKeyProperty, AppKeyPropertySchema, type ApplicationLifecycleEventData, type AppsPluginProvides, type AuthEvent, type AuthenticationIdProperty, AuthenticationIdPropertySchema, type BaseEvent, BaseSdkOptionsSchema, type BatchOptions, type Choice, type ClientCredentialsObject, ClientCredentialsObjectSchema, type Connection, type ConnectionIdProperty, ConnectionIdPropertySchema, type ConnectionItem, type ConnectionsResponse, type CreateClientCredentialsPluginProvides, type Credentials, type CredentialsFunction, CredentialsFunctionSchema, type CredentialsObject, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_CONFIG_PATH, type DebugProperty, DebugPropertySchema, type DeleteClientCredentialsPluginProvides, type DynamicResolver, type EnhancedErrorEventData, type ErrorOptions, type EventCallback, type EventContext, type EventEmissionContext, type FetchPluginProvides, type Field, type FieldsResolver, type FieldsetItem, type FindFirstAuthenticationPluginProvides, type FindFirstConnectionPluginProvides, type FindUniqueAuthenticationPluginProvides, type FindUniqueConnectionPluginProvides, type FormatMetadata, type FormattedItem, type FunctionDeprecation, type FunctionOptions, type FunctionRegistryEntry, type GetActionPluginProvides, type GetAppPluginProvides, type GetAuthenticationPluginProvides, type GetConnectionPluginProvides, type GetContextType, type GetProfilePluginProvides, type GetSdkType, type InfoFieldItem, type InputFieldItem, type InputsProperty, InputsPropertySchema, type LimitProperty, LimitPropertySchema, type ListActionsPluginProvides, type ListAppsPluginProvides, type ListAuthenticationsPluginProvides, type ListClientCredentialsPluginProvides, type ListConnectionsPluginProvides, type ListInputFieldsPluginProvides, type LoadingEvent, MAX_PAGE_LIMIT, type Manifest, type ManifestEntry, type ManifestPluginOptions, type ManifestPluginProvides, type MethodCalledEvent, type MethodCalledEventData, type Need, type NeedsRequest, type NeedsResponse, type OffsetProperty, OffsetPropertySchema, type OutputProperty, OutputPropertySchema, type PaginatedSdkFunction, type ParamsProperty, ParamsPropertySchema, type PkceCredentialsObject, PkceCredentialsObjectSchema, type Plugin, type PluginDependencies, type PluginOptions, type PluginProvides, type PositionalMetadata, type RateLimitInfo, RelayFetchSchema, RelayRequestSchema, type RequestPluginProvides, type ResolveAuthTokenOptions, type ResolveCredentialsOptions, type ResolvedCredentials, ResolvedCredentialsSchema, type Resolver, type RootFieldItem, type RunActionPluginProvides, type Sdk, type SdkEvent, type StaticResolver, type UpdateManifestEntryOptions, type UpdateManifestEntryResult, type UserProfile, type UserProfileItem, ZAPIER_BASE_URL, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, type ZapierFetchInitOptions, ZapierNotFoundError, ZapierRateLimitError, ZapierRelayError, ZapierResourceNotFoundError, type ZapierSdk, type ZapierSdkApps, type ZapierSdkOptions, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, connectionIdGenericResolver as authenticationIdGenericResolver, connectionIdResolver as authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, connectionIdGenericResolver, connectionIdResolver, createBaseEvent, createClientCredentialsPlugin, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, deleteClientCredentialsPlugin, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getBaseUrlFromCredentials, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTokenFromCliLogin, injectCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isCliLoginAvailable, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPkceCredentials, isPositional, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listInputFieldsPlugin, logDeprecation, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, runActionPlugin, runWithTelemetryContext, toSnakeCase, toTitleCase };
+export { type Action, type ActionEntry, type ActionExecutionOptions, type ActionExecutionResult, type ActionField, type ActionFieldChoice, type ActionItem$1 as ActionItem, type ActionKeyProperty, ActionKeyPropertySchema, type ActionTimeoutMsProperty, ActionTimeoutMsPropertySchema, type ActionTypeProperty, ActionTypePropertySchema, type AddActionEntryOptions, type AddActionEntryResult, type ApiError, type ApiEvent, type ApiPluginOptions, type ApiPluginProvides, type App, type AppItem, type AppKeyProperty, AppKeyPropertySchema, type ApplicationLifecycleEventData, type AppsPluginProvides, type AuthEvent, type AuthenticationIdProperty, AuthenticationIdPropertySchema, type BaseEvent, BaseSdkOptionsSchema, type BatchOptions, type Choice, type ClientCredentialsObject, ClientCredentialsObjectSchema, type Connection, type ConnectionIdProperty, ConnectionIdPropertySchema, type ConnectionItem, type ConnectionsResponse, type CreateClientCredentialsPluginProvides, type Credentials, type CredentialsFunction, CredentialsFunctionSchema, type CredentialsObject, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_CONFIG_PATH, type DebugProperty, DebugPropertySchema, type DeleteClientCredentialsPluginProvides, type DynamicResolver, type EnhancedErrorEventData, type ErrorOptions, type EventCallback, type EventContext, type EventEmissionContext, type FetchPluginProvides, type Field, type FieldsResolver, type FieldsetItem, type FindFirstAuthenticationPluginProvides, type FindFirstConnectionPluginProvides, type FindUniqueAuthenticationPluginProvides, type FindUniqueConnectionPluginProvides, type FormatMetadata, type FormattedItem, type FunctionDeprecation, type FunctionOptions, type FunctionRegistryEntry, type GetActionPluginProvides, type GetAppPluginProvides, type GetAuthenticationPluginProvides, type GetConnectionPluginProvides, type GetContextType, type GetProfilePluginProvides, type GetSdkType, type InfoFieldItem, type InputFieldItem, type InputsProperty, InputsPropertySchema, type LimitProperty, LimitPropertySchema, type ListActionsPluginProvides, type ListAppsPluginProvides, type ListAuthenticationsPluginProvides, type ListClientCredentialsPluginProvides, type ListConnectionsPluginProvides, type ListInputFieldsPluginProvides, type LoadingEvent, MAX_PAGE_LIMIT, type Manifest, type ManifestEntry, type ManifestPluginOptions, type ManifestPluginProvides, type MethodCalledEvent, type MethodCalledEventData, type Need, type NeedsRequest, type NeedsResponse, type OffsetProperty, OffsetPropertySchema, type OutputProperty, OutputPropertySchema, type PaginatedSdkFunction, type ParamsProperty, ParamsPropertySchema, type PkceCredentialsObject, PkceCredentialsObjectSchema, type Plugin, type PluginDependencies, type PluginOptions, type PluginProvides, type PositionalMetadata, type RateLimitInfo, RelayFetchSchema, RelayRequestSchema, type RequestPluginProvides, type ResolveAuthTokenOptions, type ResolveCredentialsOptions, type ResolvedCredentials, ResolvedCredentialsSchema, type Resolver, type RootFieldItem, type RunActionPluginProvides, type Sdk, type SdkEvent, type SdkPage, type StaticResolver, type UpdateManifestEntryOptions, type UpdateManifestEntryResult, type UserProfile, type UserProfileItem, ZAPIER_BASE_URL, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, type ZapierFetchInitOptions, ZapierNotFoundError, ZapierRateLimitError, ZapierRelayError, ZapierResourceNotFoundError, type ZapierSdk, type ZapierSdkApps, type ZapierSdkOptions, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, connectionIdGenericResolver as authenticationIdGenericResolver, connectionIdResolver as authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, connectionIdGenericResolver, connectionIdResolver, createBaseEvent, createClientCredentialsPlugin, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, deleteClientCredentialsPlugin, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getBaseUrlFromCredentials, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTokenFromCliLogin, injectCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isCliLoginAvailable, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPkceCredentials, isPositional, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listInputFieldsPlugin, logDeprecation, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, runActionPlugin, runWithTelemetryContext, toSnakeCase, toTitleCase };