@zapier/zapier-sdk 0.31.4 → 0.32.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @zapier/zapier-sdk
 
+## 0.32.1
+
+### Patch Changes
+
+- c7be13e: Fix bug where `add` command hangs after completing successfully
+
+## 0.32.0
+
+### Minor Changes
+
+- 250cb7d: Store CLI login credentials in system keychain.
+
 ## 0.31.4
 
 ### Patch Changes

package/README.md

@@ -4,8 +4,9 @@
 
 - [Closed Beta](#closed-beta)
 - [Documentation](#documentation)
-- [Installation](#installation)
 - [Quick Start](#quick-start)
+- [Installation](#installation)
+- [Walkthrough](#walkthrough)
 - [Factory](#factory)
 - [Available Functions](#available-functions)
 - [Accounts](#accounts)
@@ -50,20 +51,32 @@ While the dust settles, that documentation may be incomplete, and this README ma
 
 Agents are sometimes blocked from viewing docs on npm, so you may want to provide them a link to the official docs or copy the docs here into a prompt.
 
-## Installation
+## Quick Start
+
+_For new projects._
+
+The following will create a new project from scratch, set up the SDK and the SDK CLI, and give you a working starter example to get you going:
 
 ```bash
-# If you're starting a new project:
-cd your-project-dir
-npm init -y
-npx tsc --init
-# Also, set `"type": "module"` in your package.json for the code examples below.
+# Create a new Zapier SDK project (scaffolds files, installs deps, and logs you in).
+npx @zapier/zapier-sdk-cli init my-zapier-app
+
+# Or skip the interactive prompts and accept all defaults.
+npx @zapier/zapier-sdk-cli init my-zapier-app --skip-prompts
+```
+
+## Installation
+
+_For existing projects._
 
+If you already have a project and want to start integrating apps through Zapier using the SDK:
+
+```bash
 npm install @zapier/zapier-sdk
 npm install -D @zapier/zapier-sdk-cli @types/node typescript
 ```
 
-## Quick Start
+## Walkthrough
 
 Assuming you've installed the CLI package into your project (see instructions above), you (or an agent) can start using it right away. This is useful for introspecting actions, connections, etc. that you want to use in code, but you can also use it to directly use integrations.
 

package/dist/api/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAGjB,MAAM,SAAS,CAAC;AA2oBjB,eAAO,MAAM,eAAe,GAAI,SAAS,gBAAgB,KAAG,SAW3D,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAGjB,MAAM,SAAS,CAAC;AA4oBjB,eAAO,MAAM,eAAe,GAAI,SAAS,gBAAgB,KAAG,SAW3D,CAAC"}

package/dist/api/client.js

@@ -420,7 +420,8 @@ class ZapierApiClient {
         // If we know auth is required, and we don't have a token, throw an error
         // before we even make a request.
         if (options.authRequired) {
-            if (headers.get("Authorization") == null && authToken == null) {
+            const authHeaderName = pathConfig?.authHeader ?? "Authorization";
+            if (headers.get(authHeaderName) == null && authToken == null) {
                 const message = isCliLoginAvailable() === false
                     ? "Authentication required but no credentials available. " +
                         "To use CLI login, install the CLI as a dev dependency " +

package/dist/api/schemas.d.ts

@@ -43,8 +43,8 @@ export declare const NeedSchema: z.ZodObject<{
         string: "string";
         boolean: "boolean";
         file: "file";
-        filter: "filter";
         integer: "integer";
+        filter: "filter";
         text: "text";
         datetime: "datetime";
         decimal: "decimal";
@@ -65,8 +65,8 @@ export declare const ActionPermissionsSchema: z.ZodObject<{
 export declare const ActionSchema: z.ZodObject<{
     id: z.ZodOptional<z.ZodString>;
     type: z.ZodEnum<{
-        filter: "filter";
         search: "search";
+        filter: "filter";
         read: "read";
         read_bulk: "read_bulk";
         run: "run";
@@ -287,8 +287,8 @@ export declare const NeedsResponseSchema: z.ZodObject<{
             string: "string";
             boolean: "boolean";
             file: "file";
-            filter: "filter";
             integer: "integer";
+            filter: "filter";
             text: "text";
             datetime: "datetime";
             decimal: "decimal";
@@ -312,8 +312,8 @@ export declare const ImplementationSchema: z.ZodObject<{
     actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         type: z.ZodEnum<{
-            filter: "filter";
             search: "search";
+            filter: "filter";
             read: "read";
             read_bulk: "read_bulk";
             run: "run";
@@ -354,8 +354,8 @@ export declare const ImplementationsResponseSchema: z.ZodObject<{
         actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             type: z.ZodEnum<{
-                filter: "filter";
                 search: "search";
+                filter: "filter";
                 read: "read";
                 read_bulk: "read_bulk";
                 run: "run";

package/dist/auth.d.ts

@@ -55,6 +55,12 @@ interface CliLoginOptions {
     };
     debug?: boolean;
 }
+type CliLoginModule = typeof import("@zapier/zapier-sdk-cli-login");
+/**
+ * Inject an already-loaded CLI login module so the SDK skips its dynamic import.
+ * This guarantees CLI and SDK share the same module instance in the same process.
+ */
+export declare function injectCliLogin(module: CliLoginModule): void;
 /**
  * Returns whether a CLI login package is available.
  * `undefined` if no import has been attempted yet, `true` if found, `false` if not.

package/dist/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,qBAAqB,CAAC;AAM5E,YAAY,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA+BD;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAItC;AA0CD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,CAIN;AA6HD;;GAEG;AACH,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,WAAW,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAsCD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,GAAG,SAAS,CAGzD;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAK7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkB7B;AA6ED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE;IACxD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhB"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,qBAAqB,CAAC;AAM5E,YAAY,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA+BD;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAItC;AA0CD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,CAIN;AA6HD;;GAEG;AACH,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,WAAW,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAGD,KAAK,cAAc,GAAG,cAAc,8BAA8B,CAAC,CAAC;AAmCpE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAE3D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,GAAG,SAAS,CAGzD;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAK7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkB7B;AA6ED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE;IACxD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhB"}

package/dist/auth.js

@@ -201,6 +201,13 @@ async function getCliLogin() {
         return undefined;
     }
 }
+/**
+ * Inject an already-loaded CLI login module so the SDK skips its dynamic import.
+ * This guarantees CLI and SDK share the same module instance in the same process.
+ */
+export function injectCliLogin(module) {
+    cachedCliLogin = module;
+}
 /**
  * Returns whether a CLI login package is available.
  * `undefined` if no import has been attempted yet, `true` if found, `false` if not.

package/dist/index.cjs

@@ -4303,6 +4303,9 @@ async function getCliLogin() {
     return void 0;
   }
 }
+function injectCliLogin(module) {
+  cachedCliLogin = module;
+}
 function isCliLoginAvailable() {
   if (cachedCliLogin === void 0) return void 0;
   return cachedCliLogin !== false;
@@ -4734,7 +4737,8 @@ var ZapierApiClient = class {
       headers.set(authHeaderName, getAuthorizationHeader(authToken));
     }
     if (options.authRequired) {
-      if (headers.get("Authorization") == null && authToken == null) {
+      const authHeaderName = pathConfig2?.authHeader ?? "Authorization";
+      if (headers.get(authHeaderName) == null && authToken == null) {
         const message = isCliLoginAvailable() === false ? "Authentication required but no credentials available. To use CLI login, install the CLI as a dev dependency (e.g. `npm install -D @zapier/zapier-sdk-cli`) and log in (e.g. `npx zapier-sdk login`). Alternatively, set the ZAPIER_CREDENTIALS environment variable or ZAPIER_CREDENTIALS_CLIENT_ID and ZAPIER_CREDENTIALS_CLIENT_SECRET environment variables." : "Authentication required but no credentials available. Please log in (e.g. `npx zapier-sdk login`) or set the ZAPIER_CREDENTIALS environment variable or ZAPIER_CREDENTIALS_CLIENT_ID and ZAPIER_CREDENTIALS_CLIENT_SECRET environment variables.";
         throw new ZapierAuthenticationError(message);
       }
@@ -5499,7 +5503,7 @@ function getCpuTime() {
 
 // package.json
 var package_default = {
-  version: "0.31.4"};
+  version: "0.32.1"};
 
 // src/plugins/eventEmission/builders.ts
 function createBaseEvent(context = {}) {
@@ -5623,6 +5627,20 @@ var APPLICATION_LIFECYCLE_EVENT_SUBJECT = "platform.sdk.ApplicationLifecycleEven
 var ERROR_OCCURRED_EVENT_SUBJECT = "platform.sdk.ErrorOccurredEvent";
 var METHOD_CALLED_EVENT_SUBJECT = "platform.sdk.MethodCalledEvent";
 var transportStates = /* @__PURE__ */ new WeakMap();
+async function emitWithTimeout(transport, subject, event) {
+  try {
+    await Promise.race([
+      transport.emit(subject, event),
+      new Promise((resolve2) => {
+        const timer = setTimeout(resolve2, TELEMETRY_EMIT_TIMEOUT_MS);
+        if (typeof timer.unref === "function") {
+          timer.unref();
+        }
+      })
+    ]);
+  } catch {
+  }
+}
 async function silentEmit(transport, subject, event, userContextPromise) {
   try {
     let state = transportStates.get(transport);
@@ -5701,6 +5719,7 @@ var eventEmissionPlugin = ({ context }) => {
   })();
   const startupTime = Date.now();
   let shutdownStartTime = null;
+  let closed = false;
   if (!config.enabled) {
     return {
       context: {
@@ -5720,6 +5739,8 @@ var eventEmissionPlugin = ({ context }) => {
             correlation_id: null
           }),
           emitMethodCalled: () => {
+          },
+          close: async () => {
           }
         }
       }
@@ -5762,6 +5783,7 @@ var eventEmissionPlugin = ({ context }) => {
     if (typeof process?.on === "function") {
       removeExistingListeners();
       const exitHandler = (code) => {
+        if (closed) return;
         const uptime = Date.now() - startupTime;
         const shutdownDuration = shutdownStartTime ? Date.now() - shutdownStartTime : null;
         const exitEvent = buildApplicationLifecycleEvent({
@@ -5795,18 +5817,11 @@ var eventEmissionPlugin = ({ context }) => {
           errorEvent = { ...errorEvent, ...userContext };
         } catch {
         }
-        try {
-          await Promise.race([
-            transport.emit(ERROR_OCCURRED_EVENT_SUBJECT, errorEvent),
-            new Promise((resolve2) => {
-              const timer = setTimeout(resolve2, TELEMETRY_EMIT_TIMEOUT_MS);
-              if (typeof timer.unref === "function") {
-                timer.unref();
-              }
-            })
-          ]);
-        } catch {
-        }
+        await emitWithTimeout(
+          transport,
+          ERROR_OCCURRED_EVENT_SUBJECT,
+          errorEvent
+        );
       };
       registeredListeners.uncaughtException = uncaughtExceptionHandler;
       process.on("uncaughtException", uncaughtExceptionHandler);
@@ -5830,18 +5845,11 @@ var eventEmissionPlugin = ({ context }) => {
           errorEvent = { ...errorEvent, ...userContext };
         } catch {
         }
-        try {
-          await Promise.race([
-            transport.emit(ERROR_OCCURRED_EVENT_SUBJECT, errorEvent),
-            new Promise((resolve2) => {
-              const timer = setTimeout(resolve2, TELEMETRY_EMIT_TIMEOUT_MS);
-              if (typeof timer.unref === "function") {
-                timer.unref();
-              }
-            })
-          ]);
-        } catch {
-        }
+        await emitWithTimeout(
+          transport,
+          ERROR_OCCURRED_EVENT_SUBJECT,
+          errorEvent
+        );
       };
       registeredListeners.unhandledRejection = unhandledRejectionHandler;
       process.on("unhandledRejection", unhandledRejectionHandler);
@@ -5859,18 +5867,11 @@ var eventEmissionPlugin = ({ context }) => {
           signalEvent = { ...signalEvent, ...userContext };
         } catch {
         }
-        try {
-          await Promise.race([
-            transport.emit(APPLICATION_LIFECYCLE_EVENT_SUBJECT, signalEvent),
-            new Promise((resolve2) => {
-              const timer = setTimeout(resolve2, TELEMETRY_EMIT_TIMEOUT_MS);
-              if (typeof timer.unref === "function") {
-                timer.unref();
-              }
-            })
-          ]);
-        } catch {
-        }
+        await emitWithTimeout(
+          transport,
+          APPLICATION_LIFECYCLE_EVENT_SUBJECT,
+          signalEvent
+        );
         const exitCode = signal === "SIGINT" ? 130 : 143;
         process.exit(exitCode);
       };
@@ -5882,6 +5883,30 @@ var eventEmissionPlugin = ({ context }) => {
       process.on("SIGTERM", sigtermHandler);
     }
   }
+  const close = async (exitCode) => {
+    if (closed) return;
+    closed = true;
+    const uptime = Date.now() - startupTime;
+    const shutdownDuration = shutdownStartTime ? Date.now() - shutdownStartTime : null;
+    let exitEvent = buildApplicationLifecycleEvent({
+      lifecycle_event_type: "exit",
+      exit_code: exitCode ?? 0,
+      uptime_ms: uptime,
+      is_graceful_shutdown: (exitCode ?? 0) === 0,
+      shutdown_duration_ms: shutdownDuration
+    });
+    try {
+      const userContext = await getUserContext;
+      exitEvent = { ...exitEvent, ...userContext };
+    } catch {
+    }
+    await emitWithTimeout(
+      transport,
+      APPLICATION_LIFECYCLE_EVENT_SUBJECT,
+      exitEvent
+    );
+    removeExistingListeners();
+  };
   return {
     context: {
       eventEmission: {
@@ -5902,7 +5927,8 @@ var eventEmissionPlugin = ({ context }) => {
             event,
             getUserContext
           );
-        }
+        },
+        close
       }
     }
   };
@@ -6085,6 +6111,7 @@ exports.getPreferredManifestEntryKey = getPreferredManifestEntryKey;
 exports.getProfilePlugin = getProfilePlugin;
 exports.getReleaseId = getReleaseId;
 exports.getTokenFromCliLogin = getTokenFromCliLogin;
+exports.injectCliLogin = injectCliLogin;
 exports.inputFieldKeyResolver = inputFieldKeyResolver;
 exports.inputsAllOptionalResolver = inputsAllOptionalResolver;
 exports.inputsResolver = inputsResolver;

package/dist/index.d.mts

@@ -3,6 +3,7 @@ import { z } from 'zod';
 import { ConnectionSchema, ConnectionsResponseSchema, ConnectionItem as ConnectionItem$2, GetConnectionResponse } from '@zapier/zapier-sdk-core/v0/schemas/connections';
 import { AppItem as AppItem$1 } from '@zapier/zapier-sdk-core/v0/schemas/apps';
 import { ClientCredentialsItem as ClientCredentialsItem$1, ClientCredentialsCreatedItem } from '@zapier/zapier-sdk-core/v0/schemas/client-credentials';
+import * as _zapier_zapier_sdk_cli_login from '@zapier/zapier-sdk-cli-login';
 
 /**
  * SDK Event System
@@ -387,6 +388,7 @@ interface EventEmissionContext {
         emit<T extends any>(subject: string, event: T): void;
         createBaseEvent(): Promise<BaseEvent>;
         emitMethodCalled(data: MethodCalledEventData): void;
+        close(exitCode?: number): Promise<void>;
     };
 }
 interface EventEmissionProvides {
@@ -612,6 +614,7 @@ declare const NeedSchema: z.ZodObject<{
         boolean: "boolean";
         file: "file";
         integer: "integer";
+        filter: "filter";
         text: "text";
         datetime: "datetime";
         decimal: "decimal";
@@ -619,7 +622,6 @@ declare const NeedSchema: z.ZodObject<{
         password: "password";
         dict: "dict";
         code: "code";
-        filter: "filter";
         json: "json";
     }>>;
     list: z.ZodOptional<z.ZodBoolean>;
@@ -818,6 +820,7 @@ declare const NeedsResponseSchema: z.ZodObject<{
             boolean: "boolean";
             file: "file";
             integer: "integer";
+            filter: "filter";
             text: "text";
             datetime: "datetime";
             decimal: "decimal";
@@ -825,7 +828,6 @@ declare const NeedsResponseSchema: z.ZodObject<{
             password: "password";
             dict: "dict";
             code: "code";
-            filter: "filter";
             json: "json";
         }>>;
         list: z.ZodOptional<z.ZodBoolean>;
@@ -2578,17 +2580,6 @@ type ClientCredentialsItem = z.infer<typeof ClientCredentialsItemSchema>;
 
 declare const clientIdResolver: DynamicResolver<ClientCredentialsItem, {}>;
 
-/**
- * SDK Authentication Utilities
- *
- * This module provides SDK-level authentication utilities focused
- * on token acquisition. It uses the credentials system for resolution
- * and handles different credential types appropriately.
- *
- * CLI-specific functionality like login/logout is handled by the
- * @zapier/zapier-sdk-cli-login package.
- */
-
 /**
  * Options for resolving auth tokens.
  */
@@ -2631,6 +2622,12 @@ interface CliLoginOptions {
     };
     debug?: boolean;
 }
+type CliLoginModule = typeof _zapier_zapier_sdk_cli_login;
+/**
+ * Inject an already-loaded CLI login module so the SDK skips its dynamic import.
+ * This guarantees CLI and SDK share the same module instance in the same process.
+ */
+declare function injectCliLogin(module: CliLoginModule): void;
 /**
  * Returns whether a CLI login package is available.
  * `undefined` if no import has been attempted yet, `true` if found, `false` if not.
@@ -2962,4 +2959,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 EnhancedErrorEventData, type ErrorOptions, type EventCallback, type EventContext, type EventEmissionContext, type FetchPluginProvides, type Field, type FieldsetItem, type FindFirstAuthenticationPluginProvides, type FindFirstConnectionPluginProvides, type FindUniqueAuthenticationPluginProvides, type FindUniqueConnectionPluginProvides, type FormatMetadata, type FormattedItem, 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 RootFieldItem, type RunActionPluginProvides, type Sdk, type SdkEvent, type StaticResolver, type UpdateManifestEntryOptions, type UpdateManifestEntryResult, type UserProfile, type UserProfileItem, ZAPIER_AUTH_BASE_URL, ZAPIER_AUTH_CLIENT_ID, ZAPIER_BASE_URL, ZAPIER_CREDENTIALS, ZAPIER_CREDENTIALS_BASE_URL, ZAPIER_CREDENTIALS_CLIENT_ID, ZAPIER_CREDENTIALS_CLIENT_SECRET, ZAPIER_CREDENTIALS_SCOPE, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZAPIER_TOKEN, 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, 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, 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 EnhancedErrorEventData, type ErrorOptions, type EventCallback, type EventContext, type EventEmissionContext, type FetchPluginProvides, type Field, type FieldsetItem, type FindFirstAuthenticationPluginProvides, type FindFirstConnectionPluginProvides, type FindUniqueAuthenticationPluginProvides, type FindUniqueConnectionPluginProvides, type FormatMetadata, type FormattedItem, 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 RootFieldItem, type RunActionPluginProvides, type Sdk, type SdkEvent, type StaticResolver, type UpdateManifestEntryOptions, type UpdateManifestEntryResult, type UserProfile, type UserProfileItem, ZAPIER_AUTH_BASE_URL, ZAPIER_AUTH_CLIENT_ID, ZAPIER_BASE_URL, ZAPIER_CREDENTIALS, ZAPIER_CREDENTIALS_BASE_URL, ZAPIER_CREDENTIALS_CLIENT_ID, ZAPIER_CREDENTIALS_CLIENT_SECRET, ZAPIER_CREDENTIALS_SCOPE, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZAPIER_TOKEN, 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, toSnakeCase, toTitleCase };

package/dist/index.mjs

@@ -4281,6 +4281,9 @@ async function getCliLogin() {
     return void 0;
   }
 }
+function injectCliLogin(module) {
+  cachedCliLogin = module;
+}
 function isCliLoginAvailable() {
   if (cachedCliLogin === void 0) return void 0;
   return cachedCliLogin !== false;
@@ -4712,7 +4715,8 @@ var ZapierApiClient = class {
       headers.set(authHeaderName, getAuthorizationHeader(authToken));
     }
     if (options.authRequired) {
-      if (headers.get("Authorization") == null && authToken == null) {
+      const authHeaderName = pathConfig2?.authHeader ?? "Authorization";
+      if (headers.get(authHeaderName) == null && authToken == null) {
         const message = isCliLoginAvailable() === false ? "Authentication required but no credentials available. To use CLI login, install the CLI as a dev dependency (e.g. `npm install -D @zapier/zapier-sdk-cli`) and log in (e.g. `npx zapier-sdk login`). Alternatively, set the ZAPIER_CREDENTIALS environment variable or ZAPIER_CREDENTIALS_CLIENT_ID and ZAPIER_CREDENTIALS_CLIENT_SECRET environment variables." : "Authentication required but no credentials available. Please log in (e.g. `npx zapier-sdk login`) or set the ZAPIER_CREDENTIALS environment variable or ZAPIER_CREDENTIALS_CLIENT_ID and ZAPIER_CREDENTIALS_CLIENT_SECRET environment variables.";
         throw new ZapierAuthenticationError(message);
       }
@@ -5477,7 +5481,7 @@ function getCpuTime() {
 
 // package.json
 var package_default = {
-  version: "0.31.4"};
+  version: "0.32.1"};
 
 // src/plugins/eventEmission/builders.ts
 function createBaseEvent(context = {}) {
@@ -5601,6 +5605,20 @@ var APPLICATION_LIFECYCLE_EVENT_SUBJECT = "platform.sdk.ApplicationLifecycleEven
 var ERROR_OCCURRED_EVENT_SUBJECT = "platform.sdk.ErrorOccurredEvent";
 var METHOD_CALLED_EVENT_SUBJECT = "platform.sdk.MethodCalledEvent";
 var transportStates = /* @__PURE__ */ new WeakMap();
+async function emitWithTimeout(transport, subject, event) {
+  try {
+    await Promise.race([
+      transport.emit(subject, event),
+      new Promise((resolve2) => {
+        const timer = setTimeout(resolve2, TELEMETRY_EMIT_TIMEOUT_MS);
+        if (typeof timer.unref === "function") {
+          timer.unref();
+        }
+      })
+    ]);
+  } catch {
+  }
+}
 async function silentEmit(transport, subject, event, userContextPromise) {
   try {
     let state = transportStates.get(transport);
@@ -5679,6 +5697,7 @@ var eventEmissionPlugin = ({ context }) => {
   })();
   const startupTime = Date.now();
   let shutdownStartTime = null;
+  let closed = false;
   if (!config.enabled) {
     return {
       context: {
@@ -5698,6 +5717,8 @@ var eventEmissionPlugin = ({ context }) => {
             correlation_id: null
           }),
           emitMethodCalled: () => {
+          },
+          close: async () => {
           }
         }
       }
@@ -5740,6 +5761,7 @@ var eventEmissionPlugin = ({ context }) => {
     if (typeof process?.on === "function") {
       removeExistingListeners();
       const exitHandler = (code) => {
+        if (closed) return;
         const uptime = Date.now() - startupTime;
         const shutdownDuration = shutdownStartTime ? Date.now() - shutdownStartTime : null;
         const exitEvent = buildApplicationLifecycleEvent({
@@ -5773,18 +5795,11 @@ var eventEmissionPlugin = ({ context }) => {
           errorEvent = { ...errorEvent, ...userContext };
         } catch {
         }
-        try {
-          await Promise.race([
-            transport.emit(ERROR_OCCURRED_EVENT_SUBJECT, errorEvent),
-            new Promise((resolve2) => {
-              const timer = setTimeout(resolve2, TELEMETRY_EMIT_TIMEOUT_MS);
-              if (typeof timer.unref === "function") {
-                timer.unref();
-              }
-            })
-          ]);
-        } catch {
-        }
+        await emitWithTimeout(
+          transport,
+          ERROR_OCCURRED_EVENT_SUBJECT,
+          errorEvent
+        );
       };
       registeredListeners.uncaughtException = uncaughtExceptionHandler;
       process.on("uncaughtException", uncaughtExceptionHandler);
@@ -5808,18 +5823,11 @@ var eventEmissionPlugin = ({ context }) => {
           errorEvent = { ...errorEvent, ...userContext };
         } catch {
         }
-        try {
-          await Promise.race([
-            transport.emit(ERROR_OCCURRED_EVENT_SUBJECT, errorEvent),
-            new Promise((resolve2) => {
-              const timer = setTimeout(resolve2, TELEMETRY_EMIT_TIMEOUT_MS);
-              if (typeof timer.unref === "function") {
-                timer.unref();
-              }
-            })
-          ]);
-        } catch {
-        }
+        await emitWithTimeout(
+          transport,
+          ERROR_OCCURRED_EVENT_SUBJECT,
+          errorEvent
+        );
       };
       registeredListeners.unhandledRejection = unhandledRejectionHandler;
       process.on("unhandledRejection", unhandledRejectionHandler);
@@ -5837,18 +5845,11 @@ var eventEmissionPlugin = ({ context }) => {
           signalEvent = { ...signalEvent, ...userContext };
         } catch {
         }
-        try {
-          await Promise.race([
-            transport.emit(APPLICATION_LIFECYCLE_EVENT_SUBJECT, signalEvent),
-            new Promise((resolve2) => {
-              const timer = setTimeout(resolve2, TELEMETRY_EMIT_TIMEOUT_MS);
-              if (typeof timer.unref === "function") {
-                timer.unref();
-              }
-            })
-          ]);
-        } catch {
-        }
+        await emitWithTimeout(
+          transport,
+          APPLICATION_LIFECYCLE_EVENT_SUBJECT,
+          signalEvent
+        );
         const exitCode = signal === "SIGINT" ? 130 : 143;
         process.exit(exitCode);
       };
@@ -5860,6 +5861,30 @@ var eventEmissionPlugin = ({ context }) => {
       process.on("SIGTERM", sigtermHandler);
     }
   }
+  const close = async (exitCode) => {
+    if (closed) return;
+    closed = true;
+    const uptime = Date.now() - startupTime;
+    const shutdownDuration = shutdownStartTime ? Date.now() - shutdownStartTime : null;
+    let exitEvent = buildApplicationLifecycleEvent({
+      lifecycle_event_type: "exit",
+      exit_code: exitCode ?? 0,
+      uptime_ms: uptime,
+      is_graceful_shutdown: (exitCode ?? 0) === 0,
+      shutdown_duration_ms: shutdownDuration
+    });
+    try {
+      const userContext = await getUserContext;
+      exitEvent = { ...exitEvent, ...userContext };
+    } catch {
+    }
+    await emitWithTimeout(
+      transport,
+      APPLICATION_LIFECYCLE_EVENT_SUBJECT,
+      exitEvent
+    );
+    removeExistingListeners();
+  };
   return {
     context: {
       eventEmission: {
@@ -5880,7 +5905,8 @@ var eventEmissionPlugin = ({ context }) => {
             event,
             getUserContext
           );
-        }
+        },
+        close
       }
     }
   };
@@ -5969,4 +5995,4 @@ var BaseSdkOptionsSchema = z.object({
   // Use credentials instead
 });
 
-export { ActionKeyPropertySchema, ActionTimeoutMsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AuthenticationIdPropertySchema, BaseSdkOptionsSchema, ClientCredentialsObjectSchema, ConnectionIdPropertySchema, CredentialsFunctionSchema, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_CONFIG_PATH, DebugPropertySchema, InputsPropertySchema, LimitPropertySchema, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, PkceCredentialsObjectSchema, RelayFetchSchema, RelayRequestSchema, ResolvedCredentialsSchema, ZAPIER_AUTH_BASE_URL, ZAPIER_AUTH_CLIENT_ID, ZAPIER_BASE_URL, ZAPIER_CREDENTIALS, ZAPIER_CREDENTIALS_BASE_URL, ZAPIER_CREDENTIALS_CLIENT_ID, ZAPIER_CREDENTIALS_CLIENT_SECRET, ZAPIER_CREDENTIALS_SCOPE, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZAPIER_TOKEN, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierRateLimitError, ZapierRelayError, ZapierResourceNotFoundError, 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, 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, toSnakeCase, toTitleCase };
+export { ActionKeyPropertySchema, ActionTimeoutMsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AuthenticationIdPropertySchema, BaseSdkOptionsSchema, ClientCredentialsObjectSchema, ConnectionIdPropertySchema, CredentialsFunctionSchema, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_CONFIG_PATH, DebugPropertySchema, InputsPropertySchema, LimitPropertySchema, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, PkceCredentialsObjectSchema, RelayFetchSchema, RelayRequestSchema, ResolvedCredentialsSchema, ZAPIER_AUTH_BASE_URL, ZAPIER_AUTH_CLIENT_ID, ZAPIER_BASE_URL, ZAPIER_CREDENTIALS, ZAPIER_CREDENTIALS_BASE_URL, ZAPIER_CREDENTIALS_CLIENT_ID, ZAPIER_CREDENTIALS_CLIENT_SECRET, ZAPIER_CREDENTIALS_SCOPE, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZAPIER_TOKEN, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierRateLimitError, ZapierRelayError, ZapierResourceNotFoundError, 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, toSnakeCase, toTitleCase };

package/dist/plugins/eventEmission/index.d.ts

@@ -25,6 +25,7 @@ export interface EventEmissionContext {
         emit<T extends any>(subject: string, event: T): void;
         createBaseEvent(): Promise<BaseEvent>;
         emitMethodCalled(data: MethodCalledEventData): void;
+        close(exitCode?: number): Promise<void>;
     };
 }
 export interface EventEmissionProvides {

package/dist/plugins/eventEmission/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/eventEmission/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAWnE,OAAO,KAAK,EAAgB,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAsCnE;;;GAGG;AACH,wBAAgB,qBAAqB,SAEpC;AAGD,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,WAAW,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;CACrC;AAGD,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE;QACb,SAAS,EAAE,cAAc,CAAC;QAC1B,MAAM,EAAE,mBAAmB,CAAC;QAE5B,IAAI,CAAC,CAAC,SAAS,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;QAErD,eAAe,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;QAEtC,gBAAgB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAC;KACrD,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AA6FD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CACtC,EAAE,EACF;IACE,OAAO,EAAE;QACP,aAAa,CAAC,EAAE,mBAAmB,CAAC;QACpC,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,EACD,qBAAqB,CA8StB,CAAC;AAGF,YAAY,EACV,YAAY,EACZ,6BAA6B,EAC7B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,eAAe,EACf,eAAe,EACf,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/eventEmission/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAWnE,OAAO,KAAK,EAAgB,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAsCnE;;;GAGG;AACH,wBAAgB,qBAAqB,SAEpC;AAGD,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,WAAW,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;CACrC;AAGD,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE;QACb,SAAS,EAAE,cAAc,CAAC;QAC1B,MAAM,EAAE,mBAAmB,CAAC;QAE5B,IAAI,CAAC,CAAC,SAAS,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;QAErD,eAAe,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;QAEtC,gBAAgB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAC;QAIpD,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACzC,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAiHD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CACtC,EAAE,EACF;IACE,OAAO,EAAE;QACP,aAAa,CAAC,EAAE,mBAAmB,CAAC;QACpC,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,EACD,qBAAqB,CAwTtB,CAAC;AAGF,YAAY,EACV,YAAY,EACZ,6BAA6B,EAC7B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,eAAe,EACf,eAAe,EACf,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,cAAc,SAAS,CAAC"}

package/dist/plugins/eventEmission/index.js

@@ -41,6 +41,22 @@ const ERROR_OCCURRED_EVENT_SUBJECT = "platform.sdk.ErrorOccurredEvent";
 const METHOD_CALLED_EVENT_SUBJECT = "platform.sdk.MethodCalledEvent";
 // Track transport success/failure so we only log failure once.
 const transportStates = new WeakMap();
+async function emitWithTimeout(transport, subject, event) {
+    try {
+        await Promise.race([
+            transport.emit(subject, event),
+            new Promise((resolve) => {
+                const timer = setTimeout(resolve, TELEMETRY_EMIT_TIMEOUT_MS);
+                if (typeof timer.unref === "function") {
+                    timer.unref();
+                }
+            }),
+        ]);
+    }
+    catch {
+        // Silently ignore telemetry failures
+    }
+}
 // Silent emission wrapper with smart first-failure logging
 async function silentEmit(transport, subject, event, userContextPromise) {
     try {
@@ -135,6 +151,7 @@ export const eventEmissionPlugin = ({ context }) => {
     })();
     const startupTime = Date.now();
     let shutdownStartTime = null;
+    let closed = false;
     // If disabled, return noop implementations
     if (!config.enabled) {
         return {
@@ -154,6 +171,7 @@ export const eventEmissionPlugin = ({ context }) => {
                         correlation_id: null,
                     }),
                     emitMethodCalled: () => { },
+                    close: async () => { },
                 },
             },
         };
@@ -201,6 +219,8 @@ export const eventEmissionPlugin = ({ context }) => {
             removeExistingListeners();
             // Handle normal process exit
             const exitHandler = (code) => {
+                if (closed)
+                    return;
                 const uptime = Date.now() - startupTime;
                 const shutdownDuration = shutdownStartTime
                     ? Date.now() - shutdownStartTime
@@ -235,21 +255,7 @@ export const eventEmissionPlugin = ({ context }) => {
                 catch {
                     // Continue with original event if user context fails
                 }
-                // Wait up to 300ms for telemetry to send before allowing process to exit
-                try {
-                    await Promise.race([
-                        transport.emit(ERROR_OCCURRED_EVENT_SUBJECT, errorEvent),
-                        new Promise((resolve) => {
-                            const timer = setTimeout(resolve, TELEMETRY_EMIT_TIMEOUT_MS);
-                            if (typeof timer.unref === "function") {
-                                timer.unref();
-                            }
-                        }),
-                    ]);
-                }
-                catch {
-                    // Silently ignore telemetry failures
-                }
+                await emitWithTimeout(transport, ERROR_OCCURRED_EVENT_SUBJECT, errorEvent);
             };
             registeredListeners.uncaughtException = uncaughtExceptionHandler;
             process.on("uncaughtException", uncaughtExceptionHandler);
@@ -281,21 +287,7 @@ export const eventEmissionPlugin = ({ context }) => {
                 catch {
                     // Continue with original event if user context fails
                 }
-                // Wait up to 300ms for telemetry to send
-                try {
-                    await Promise.race([
-                        transport.emit(ERROR_OCCURRED_EVENT_SUBJECT, errorEvent),
-                        new Promise((resolve) => {
-                            const timer = setTimeout(resolve, TELEMETRY_EMIT_TIMEOUT_MS);
-                            if (typeof timer.unref === "function") {
-                                timer.unref();
-                            }
-                        }),
-                    ]);
-                }
-                catch {
-                    // Silently ignore telemetry failures
-                }
+                await emitWithTimeout(transport, ERROR_OCCURRED_EVENT_SUBJECT, errorEvent);
             };
             registeredListeners.unhandledRejection = unhandledRejectionHandler;
             process.on("unhandledRejection", unhandledRejectionHandler);
@@ -317,21 +309,7 @@ export const eventEmissionPlugin = ({ context }) => {
                 catch {
                     // Continue with original event if user context fails
                 }
-                // Wait up to 300ms for telemetry to send
-                try {
-                    await Promise.race([
-                        transport.emit(APPLICATION_LIFECYCLE_EVENT_SUBJECT, signalEvent),
-                        new Promise((resolve) => {
-                            const timer = setTimeout(resolve, TELEMETRY_EMIT_TIMEOUT_MS);
-                            if (typeof timer.unref === "function") {
-                                timer.unref();
-                            }
-                        }),
-                    ]);
-                }
-                catch {
-                    // Silently ignore telemetry failures
-                }
+                await emitWithTimeout(transport, APPLICATION_LIFECYCLE_EVENT_SUBJECT, signalEvent);
                 // Exit with appropriate code (128 + signal number)
                 const exitCode = signal === "SIGINT" ? 130 : 143;
                 process.exit(exitCode);
@@ -345,6 +323,31 @@ export const eventEmissionPlugin = ({ context }) => {
             process.on("SIGTERM", sigtermHandler);
         }
     }
+    const close = async (exitCode) => {
+        if (closed)
+            return;
+        closed = true;
+        const uptime = Date.now() - startupTime;
+        const shutdownDuration = shutdownStartTime
+            ? Date.now() - shutdownStartTime
+            : null;
+        let exitEvent = buildApplicationLifecycleEvent({
+            lifecycle_event_type: "exit",
+            exit_code: exitCode ?? 0,
+            uptime_ms: uptime,
+            is_graceful_shutdown: (exitCode ?? 0) === 0,
+            shutdown_duration_ms: shutdownDuration,
+        });
+        try {
+            const userContext = await getUserContext;
+            exitEvent = { ...exitEvent, ...userContext };
+        }
+        catch {
+            // Continue with original event if user context fails
+        }
+        await emitWithTimeout(transport, APPLICATION_LIFECYCLE_EVENT_SUBJECT, exitEvent);
+        removeExistingListeners();
+    };
     return {
         context: {
             eventEmission: {
@@ -361,6 +364,7 @@ export const eventEmissionPlugin = ({ context }) => {
                     };
                     silentEmit(transport, METHOD_CALLED_EVENT_SUBJECT, event, getUserContext);
                 },
+                close,
             },
         },
     };

package/dist/plugins/eventEmission/index.test.js

@@ -661,6 +661,98 @@ describe("emitMethodCalled call_context", () => {
         expect(mockTransport.emit).toHaveBeenCalledWith("platform.sdk.MethodCalledEvent", expect.objectContaining({ call_context: "mcp" }));
     });
 });
+describe("close()", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        cleanupEventListeners();
+        mockGetToken.mockResolvedValue(undefined);
+    });
+    afterEach(() => {
+        cleanupEventListeners();
+    });
+    it("should emit exit lifecycle event", async () => {
+        const plugin = eventEmissionPlugin({
+            sdk: {},
+            context: {
+                meta: {},
+                options: {
+                    eventEmission: {
+                        enabled: true,
+                        transport: { type: "console" },
+                    },
+                },
+            },
+        });
+        await plugin.context.eventEmission.close(0);
+        expect(mockTransport.emit).toHaveBeenCalledWith("platform.sdk.ApplicationLifecycleEvent", expect.objectContaining({
+            lifecycle_event_type: "exit",
+            exit_code: 0,
+            is_graceful_shutdown: true,
+        }));
+    });
+    it("should be idempotent — second call is a no-op", async () => {
+        const plugin = eventEmissionPlugin({
+            sdk: {},
+            context: {
+                meta: {},
+                options: {
+                    eventEmission: {
+                        enabled: true,
+                        transport: { type: "console" },
+                    },
+                },
+            },
+        });
+        await plugin.context.eventEmission.close(0);
+        const callCountAfterFirst = mockTransport.emit.mock.calls.filter((call) => call[0] === "platform.sdk.ApplicationLifecycleEvent" &&
+            call[1]?.lifecycle_event_type === "exit").length;
+        await plugin.context.eventEmission.close(0);
+        const callCountAfterSecond = mockTransport.emit.mock.calls.filter((call) => call[0] === "platform.sdk.ApplicationLifecycleEvent" &&
+            call[1]?.lifecycle_event_type === "exit").length;
+        expect(callCountAfterSecond).toBe(callCountAfterFirst);
+    });
+    it("should remove process listeners after close", async () => {
+        const initialExitCount = process.listenerCount("exit");
+        const plugin = eventEmissionPlugin({
+            sdk: {},
+            context: {
+                meta: {},
+                options: {
+                    eventEmission: {
+                        enabled: true,
+                        transport: { type: "console" },
+                    },
+                },
+            },
+        });
+        expect(process.listenerCount("exit")).toBe(initialExitCount + 1);
+        await plugin.context.eventEmission.close(0);
+        expect(process.listenerCount("exit")).toBe(initialExitCount);
+    });
+    it("should handle transport failures silently", async () => {
+        const failingTransport = {
+            emit: vi.fn().mockRejectedValue(new Error("Network error")),
+            close: vi.fn().mockResolvedValue(undefined),
+        };
+        vi.mocked(createTransport).mockReturnValueOnce(failingTransport);
+        const plugin = eventEmissionPlugin({
+            sdk: {},
+            context: {
+                meta: {},
+                options: {
+                    eventEmission: {
+                        enabled: true,
+                        transport: {
+                            type: "http",
+                            endpoint: "https://example.com",
+                        },
+                    },
+                },
+            },
+        });
+        await expect(plugin.context.eventEmission.close(1)).resolves.toBeUndefined();
+    });
+});
 describe("Process Listener Cleanup", () => {
     beforeEach(() => {
         // Clean up any listeners from previous tests

package/dist/plugins/getAction/schemas.d.ts

@@ -6,8 +6,8 @@ export declare const GetActionSchema: z.ZodObject<{
         _def: z.core.$ZodStringDef & import("../..").PositionalMetadata;
     };
     actionType: z.ZodEnum<{
-        filter: "filter";
         search: "search";
+        filter: "filter";
         read: "read";
         read_bulk: "read_bulk";
         run: "run";

package/dist/plugins/getInputFieldsSchema/schemas.d.ts

@@ -5,8 +5,8 @@ export declare const GetInputFieldsSchemaSchema: z.ZodObject<{
         _def: z.core.$ZodStringDef & import("../..").PositionalMetadata;
     };
     actionType: z.ZodEnum<{
-        filter: "filter";
         search: "search";
+        filter: "filter";
         read: "read";
         read_bulk: "read_bulk";
         run: "run";

package/dist/plugins/listActions/schemas.d.ts

@@ -7,8 +7,8 @@ export declare const ListActionsSchema: z.ZodObject<{
         _def: z.core.$ZodStringDef & import("../..").PositionalMetadata;
     };
     actionType: z.ZodOptional<z.ZodEnum<{
-        filter: "filter";
         search: "search";
+        filter: "filter";
         read: "read";
         read_bulk: "read_bulk";
         run: "run";

package/dist/plugins/listInputFieldChoices/schemas.d.ts

@@ -13,8 +13,8 @@ export declare const ListInputFieldChoicesSchema: z.ZodObject<{
         _def: z.core.$ZodStringDef & import("../..").PositionalMetadata;
     };
     actionType: z.ZodEnum<{
-        filter: "filter";
         search: "search";
+        filter: "filter";
         read: "read";
         read_bulk: "read_bulk";
         run: "run";

package/dist/plugins/listInputFields/schemas.d.ts

@@ -7,8 +7,8 @@ export declare const ListInputFieldsSchema: z.ZodObject<{
         _def: z.core.$ZodStringDef & import("../..").PositionalMetadata;
     };
     actionType: z.ZodEnum<{
-        filter: "filter";
         search: "search";
+        filter: "filter";
         read: "read";
         read_bulk: "read_bulk";
         run: "run";

package/dist/plugins/request/index.test.js

@@ -437,6 +437,7 @@ describe("request plugin", () => {
                         emit: () => { },
                         createBaseEvent: (() => ({})),
                         emitMethodCalled: emitSpy,
+                        close: async () => { },
                     },
                 },
             });

package/dist/plugins/runAction/schemas.d.ts

@@ -6,8 +6,8 @@ export declare const RunActionSchema: z.ZodObject<{
         _def: z.core.$ZodStringDef & import("../..").PositionalMetadata;
     };
     actionType: z.ZodEnum<{
-        filter: "filter";
         search: "search";
+        filter: "filter";
         read: "read";
         read_bulk: "read_bulk";
         run: "run";

package/dist/schemas/Action.d.ts

@@ -8,8 +8,8 @@ export declare const ActionItemSchema: z.ZodObject<{
     app_key: z.ZodString;
     app_version: z.ZodOptional<z.ZodString>;
     action_type: z.ZodEnum<{
-        filter: "filter";
         search: "search";
+        filter: "filter";
         read: "read";
         read_bulk: "read_bulk";
         run: "run";

package/dist/types/properties.d.ts

@@ -3,8 +3,8 @@ export declare const AppKeyPropertySchema: z.ZodString & {
     _def: z.core.$ZodStringDef & import("..").PositionalMetadata;
 };
 export declare const ActionTypePropertySchema: z.ZodEnum<{
-    filter: "filter";
     search: "search";
+    filter: "filter";
     read: "read";
     read_bulk: "read_bulk";
     run: "run";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.31.4",
+  "version": "0.32.1",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -45,7 +45,7 @@
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
     "vitest": "^3.2.3",
-    "@zapier/zapier-sdk-cli-login": "0.7.0"
+    "@zapier/zapier-sdk-cli-login": "0.8.0"
   },
   "scripts": {
     "build": "tsup",