@zapier/zapier-sdk 0.54.0 → 0.54.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @zapier/zapier-sdk
 
+## 0.54.1
+
+### Patch Changes
+
+- 22a1727: Add optional `name` parameter to `createTriggerInbox` method
+
 ## 0.54.0
 
 ### Minor Changes

package/README.md

@@ -1835,18 +1835,19 @@ const result = await zapier.ackTriggerInboxMessages({
 
 #### `createTriggerInbox` 🧪 _experimental_
 
-Create a new trigger inbox subscription with an auto-generated name. Always creates; use ensureTriggerInbox for get-or-create on a stable name.
+Create a new trigger inbox subscription. Always creates a new inbox; use ensureTriggerInbox for get-or-create on a stable name.
 
 **Parameters:**
 
-| Name                  | Type             | Required | Default | Possible Values | Description                                                                                                  |
-| --------------------- | ---------------- | -------- | ------- | --------------- | ------------------------------------------------------------------------------------------------------------ |
-| `options`             | `object`         | ✅       | —       | —               |                                                                                                              |
-| ​ ↳ `app`             | `string`         | ✅       | —       | —               | App slug (e.g., 'github'), implementation name (e.g., 'SlackCLIAPI'), or versioned ID (e.g., 'github@1.2.3') |
-| ​ ↳ `action`          | `string`         | ✅       | —       | —               | Action key (e.g., 'send_message' or 'find_row')                                                              |
-| ​ ↳ `connection`      | `string, number` | ❌       | —       | —               | Connection alias or connection ID. Optional for triggers that don't require auth.                            |
-| ​ ↳ `inputs`          | `object`         | ❌       | —       | —               | Input parameters for the trigger subscription                                                                |
-| ​ ↳ `notificationUrl` | `string`         | ❌       | —       | —               | Webhook URL to POST to when new messages arrive                                                              |
+| Name                  | Type             | Required | Default | Possible Values | Description                                                                                                                      |
+| --------------------- | ---------------- | -------- | ------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| `options`             | `object`         | ✅       | —       | —               |                                                                                                                                  |
+| ​ ↳ `name`            | `string`         | ❌       | —       | —               | Optional inbox name. Auto-generated when omitted. Throws a conflict error if the name is already in use by another subscription. |
+| ​ ↳ `app`             | `string`         | ✅       | —       | —               | App slug (e.g., 'github'), implementation name (e.g., 'SlackCLIAPI'), or versioned ID (e.g., 'github@1.2.3')                     |
+| ​ ↳ `action`          | `string`         | ✅       | —       | —               | Action key (e.g., 'send_message' or 'find_row')                                                                                  |
+| ​ ↳ `connection`      | `string, number` | ❌       | —       | —               | Connection alias or connection ID. Optional for triggers that don't require auth.                                                |
+| ​ ↳ `inputs`          | `object`         | ❌       | —       | —               | Input parameters for the trigger subscription                                                                                    |
+| ​ ↳ `notificationUrl` | `string`         | ❌       | —       | —               | Webhook URL to POST to when new messages arrive                                                                                  |
 
 **Returns:** `Promise<TriggerInboxItem>`
 

package/dist/experimental.cjs

@@ -2881,7 +2881,7 @@ async function invalidateCredentialsToken(options) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.54.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.54.1" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -8999,8 +8999,11 @@ var TriggerInboxItemSchema = withFormatter(
 );
 
 // src/plugins/triggers/createTriggerInbox/schemas.ts
-var CreateTriggerInboxDescription = "Create a new trigger inbox subscription with an auto-generated name. Always creates; use ensureTriggerInbox for get-or-create on a stable name.";
+var CreateTriggerInboxDescription = "Create a new trigger inbox subscription. Always creates a new inbox; use ensureTriggerInbox for get-or-create on a stable name.";
 var CreateTriggerInboxSchema = zod.z.object({
+  name: TriggerInboxNamePropertySchema.optional().describe(
+    "Optional inbox name. Auto-generated when omitted. Throws a conflict error if the name is already in use by another subscription."
+  ),
   app: AppPropertySchema,
   action: ActionPropertySchema,
   connection: ConnectionPropertySchema.nullable().optional().describe(
@@ -9018,6 +9021,39 @@ var triggersDefaults = {
   experimental: true
 };
 
+// src/plugins/triggers/utils.ts
+var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+async function resolveTriggerInboxId({
+  api,
+  inbox
+}) {
+  if (UUID_REGEX.test(inbox)) {
+    return inbox;
+  }
+  const rawResponse = await api.get("/trigger-inbox/api/v1/inboxes", {
+    searchParams: { name: inbox, limit: "1" },
+    authRequired: true
+  });
+  const response = rawResponse;
+  const id = response.results?.[0]?.id;
+  if (!id) {
+    throw new ZapierResourceNotFoundError(
+      `No trigger inbox named "${inbox}" found.`,
+      { resourceType: "trigger_inbox", resourceId: inbox }
+    );
+  }
+  return id;
+}
+function extractErrorDetail(data) {
+  if (typeof data !== "object" || data === null) return void 0;
+  const errors = data.errors;
+  if (!Array.isArray(errors) || errors.length === 0) return void 0;
+  const first = errors[0];
+  if (typeof first !== "object" || first === null) return void 0;
+  const detail = first.detail;
+  return typeof detail === "string" ? detail : void 0;
+}
+
 // src/plugins/triggers/createTriggerInbox/index.ts
 var createTriggerInboxPlugin = definePlugin(
   (sdk) => createPluginMethod(sdk, {
@@ -9032,6 +9068,7 @@ var createTriggerInboxPlugin = definePlugin(
     // seeded into resolvedParams without polluting the user-facing schema
     // (where it would leak into the SDK method signature and CLI flags).
     resolvers: {
+      name: { type: "static", inputType: "text" },
       app: appKeyResolver,
       action: actionKeyResolver,
       connection: connectionIdResolver,
@@ -9041,6 +9078,7 @@ var createTriggerInboxPlugin = definePlugin(
     handler: async ({ sdk: sdk2, options }) => {
       const { api } = sdk2.context;
       const {
+        name,
         app: appKey,
         action: actionKey,
         connection,
@@ -9066,13 +9104,28 @@ var createTriggerInboxPlugin = definePlugin(
           connection_id: resolvedConnectionId ?? null
         }
       };
+      if (name !== void 0) {
+        requestBody.name = name;
+      }
       if (notificationUrl !== void 0) {
         requestBody.notification_url = notificationUrl;
       }
       const rawResponse = await api.post(
         "/trigger-inbox/api/v1/inboxes",
         requestBody,
-        { authRequired: true }
+        {
+          authRequired: true,
+          customErrorHandler: ({ status, data }) => {
+            if (status === 409) {
+              const detail = extractErrorDetail(data);
+              return new ZapierConflictError(
+                detail ?? `An inbox named "${name}" already exists with a different subscription.`,
+                { statusCode: status, resourceType: "trigger_inbox" }
+              );
+            }
+            return void 0;
+          }
+        }
       );
       return { data: TriggerInboxItemSchema.parse(rawResponse) };
     }
@@ -9095,15 +9148,6 @@ var EnsureTriggerInboxSchema = zod.z.object({
 }).describe(EnsureTriggerInboxDescription);
 
 // src/plugins/triggers/ensureTriggerInbox/index.ts
-function extractErrorDetail(data) {
-  if (typeof data !== "object" || data === null) return void 0;
-  const errors = data.errors;
-  if (!Array.isArray(errors) || errors.length === 0) return void 0;
-  const first = errors[0];
-  if (typeof first !== "object" || first === null) return void 0;
-  const detail = first.detail;
-  return typeof detail === "string" ? detail : void 0;
-}
 var ensureTriggerInboxPlugin = definePlugin(
   (sdk) => createPluginMethod(sdk, {
     ...triggersDefaults,
@@ -9247,30 +9291,6 @@ var GetTriggerInboxSchema = zod.z.object({
   inbox: TriggerInboxPropertySchema
 }).describe("Get details of a trigger inbox by ID");
 
-// src/plugins/triggers/utils.ts
-var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-async function resolveTriggerInboxId({
-  api,
-  inbox
-}) {
-  if (UUID_REGEX.test(inbox)) {
-    return inbox;
-  }
-  const rawResponse = await api.get("/trigger-inbox/api/v1/inboxes", {
-    searchParams: { name: inbox, limit: "1" },
-    authRequired: true
-  });
-  const response = rawResponse;
-  const id = response.results?.[0]?.id;
-  if (!id) {
-    throw new ZapierResourceNotFoundError(
-      `No trigger inbox named "${inbox}" found.`,
-      { resourceType: "trigger_inbox", resourceId: inbox }
-    );
-  }
-  return id;
-}
-
 // src/plugins/triggers/getTriggerInbox/index.ts
 var getTriggerInboxPlugin = definePlugin(
   (sdk) => createPluginMethod(sdk, {

package/dist/experimental.d.mts

@@ -1432,6 +1432,7 @@ declare function createZapierSdk(options?: ZapierSdkOptions): WithAddPlugin<{
     createTriggerInbox: (options?: {
         app: string;
         action: string;
+        name?: string | undefined;
         connection?: string | number | null | undefined;
         inputs?: Record<string, unknown> | undefined;
         notificationUrl?: string | undefined;

package/dist/experimental.d.ts

@@ -1447,6 +1447,7 @@ export declare function createZapierSdk(options?: ZapierSdkOptions): import("./i
     createTriggerInbox: (options?: {
         app: string;
         action: string;
+        name?: string | undefined;
         connection?: string | number | null | undefined;
         inputs?: Record<string, unknown> | undefined;
         notificationUrl?: string | undefined;

package/dist/experimental.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"experimental.d.ts","sourceRoot":"","sources":["../src/experimental.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"experimental.d.ts","sourceRoot":"","sources":["../src/experimental.ts"],"names":[],"mappings":"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"}

package/dist/experimental.mjs

@@ -2879,7 +2879,7 @@ async function invalidateCredentialsToken(options) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.54.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.54.1" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";
@@ -8997,8 +8997,11 @@ var TriggerInboxItemSchema = withFormatter(
 );
 
 // src/plugins/triggers/createTriggerInbox/schemas.ts
-var CreateTriggerInboxDescription = "Create a new trigger inbox subscription with an auto-generated name. Always creates; use ensureTriggerInbox for get-or-create on a stable name.";
+var CreateTriggerInboxDescription = "Create a new trigger inbox subscription. Always creates a new inbox; use ensureTriggerInbox for get-or-create on a stable name.";
 var CreateTriggerInboxSchema = z.object({
+  name: TriggerInboxNamePropertySchema.optional().describe(
+    "Optional inbox name. Auto-generated when omitted. Throws a conflict error if the name is already in use by another subscription."
+  ),
   app: AppPropertySchema,
   action: ActionPropertySchema,
   connection: ConnectionPropertySchema.nullable().optional().describe(
@@ -9016,6 +9019,39 @@ var triggersDefaults = {
   experimental: true
 };
 
+// src/plugins/triggers/utils.ts
+var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+async function resolveTriggerInboxId({
+  api,
+  inbox
+}) {
+  if (UUID_REGEX.test(inbox)) {
+    return inbox;
+  }
+  const rawResponse = await api.get("/trigger-inbox/api/v1/inboxes", {
+    searchParams: { name: inbox, limit: "1" },
+    authRequired: true
+  });
+  const response = rawResponse;
+  const id = response.results?.[0]?.id;
+  if (!id) {
+    throw new ZapierResourceNotFoundError(
+      `No trigger inbox named "${inbox}" found.`,
+      { resourceType: "trigger_inbox", resourceId: inbox }
+    );
+  }
+  return id;
+}
+function extractErrorDetail(data) {
+  if (typeof data !== "object" || data === null) return void 0;
+  const errors = data.errors;
+  if (!Array.isArray(errors) || errors.length === 0) return void 0;
+  const first = errors[0];
+  if (typeof first !== "object" || first === null) return void 0;
+  const detail = first.detail;
+  return typeof detail === "string" ? detail : void 0;
+}
+
 // src/plugins/triggers/createTriggerInbox/index.ts
 var createTriggerInboxPlugin = definePlugin(
   (sdk) => createPluginMethod(sdk, {
@@ -9030,6 +9066,7 @@ var createTriggerInboxPlugin = definePlugin(
     // seeded into resolvedParams without polluting the user-facing schema
     // (where it would leak into the SDK method signature and CLI flags).
     resolvers: {
+      name: { type: "static", inputType: "text" },
       app: appKeyResolver,
       action: actionKeyResolver,
       connection: connectionIdResolver,
@@ -9039,6 +9076,7 @@ var createTriggerInboxPlugin = definePlugin(
     handler: async ({ sdk: sdk2, options }) => {
       const { api } = sdk2.context;
       const {
+        name,
         app: appKey,
         action: actionKey,
         connection,
@@ -9064,13 +9102,28 @@ var createTriggerInboxPlugin = definePlugin(
           connection_id: resolvedConnectionId ?? null
         }
       };
+      if (name !== void 0) {
+        requestBody.name = name;
+      }
       if (notificationUrl !== void 0) {
         requestBody.notification_url = notificationUrl;
       }
       const rawResponse = await api.post(
         "/trigger-inbox/api/v1/inboxes",
         requestBody,
-        { authRequired: true }
+        {
+          authRequired: true,
+          customErrorHandler: ({ status, data }) => {
+            if (status === 409) {
+              const detail = extractErrorDetail(data);
+              return new ZapierConflictError(
+                detail ?? `An inbox named "${name}" already exists with a different subscription.`,
+                { statusCode: status, resourceType: "trigger_inbox" }
+              );
+            }
+            return void 0;
+          }
+        }
       );
       return { data: TriggerInboxItemSchema.parse(rawResponse) };
     }
@@ -9093,15 +9146,6 @@ var EnsureTriggerInboxSchema = z.object({
 }).describe(EnsureTriggerInboxDescription);
 
 // src/plugins/triggers/ensureTriggerInbox/index.ts
-function extractErrorDetail(data) {
-  if (typeof data !== "object" || data === null) return void 0;
-  const errors = data.errors;
-  if (!Array.isArray(errors) || errors.length === 0) return void 0;
-  const first = errors[0];
-  if (typeof first !== "object" || first === null) return void 0;
-  const detail = first.detail;
-  return typeof detail === "string" ? detail : void 0;
-}
 var ensureTriggerInboxPlugin = definePlugin(
   (sdk) => createPluginMethod(sdk, {
     ...triggersDefaults,
@@ -9245,30 +9289,6 @@ var GetTriggerInboxSchema = z.object({
   inbox: TriggerInboxPropertySchema
 }).describe("Get details of a trigger inbox by ID");
 
-// src/plugins/triggers/utils.ts
-var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-async function resolveTriggerInboxId({
-  api,
-  inbox
-}) {
-  if (UUID_REGEX.test(inbox)) {
-    return inbox;
-  }
-  const rawResponse = await api.get("/trigger-inbox/api/v1/inboxes", {
-    searchParams: { name: inbox, limit: "1" },
-    authRequired: true
-  });
-  const response = rawResponse;
-  const id = response.results?.[0]?.id;
-  if (!id) {
-    throw new ZapierResourceNotFoundError(
-      `No trigger inbox named "${inbox}" found.`,
-      { resourceType: "trigger_inbox", resourceId: inbox }
-    );
-  }
-  return id;
-}
-
 // src/plugins/triggers/getTriggerInbox/index.ts
 var getTriggerInboxPlugin = definePlugin(
   (sdk) => createPluginMethod(sdk, {

package/dist/index.cjs

@@ -6309,7 +6309,7 @@ async function invalidateCredentialsToken(options) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.54.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.54.1" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";

package/dist/index.mjs

@@ -6307,7 +6307,7 @@ async function invalidateCredentialsToken(options) {
 }
 
 // src/sdk-version.ts
-var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.54.0" : void 0) || "unknown";
+var SDK_VERSION = (typeof process !== "undefined" && process.env ? "0.54.1" : void 0) || "unknown";
 
 // src/utils/open-url.ts
 var nodePrefix = "node:";

package/dist/plugins/triggers/createTriggerInbox/index.d.ts

@@ -31,6 +31,7 @@ export declare const createTriggerInboxPlugin: (sdk: {
     createTriggerInbox: (options?: {
         app: string;
         action: string;
+        name?: string | undefined;
         connection?: string | number | null | undefined;
         inputs?: Record<string, unknown> | undefined;
         notificationUrl?: string | undefined;

package/dist/plugins/triggers/createTriggerInbox/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/triggers/createTriggerInbox/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAA0B,MAAM,WAAW,CAAC;AAU7E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAInE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;aAIpB;QACP,4BAA4B,EAAE,4BAA4B,CAAC;KAC5D,GAAG,yBAAyB,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2E/C,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG,UAAU,CACvD,OAAO,wBAAwB,CAChC,CAAC;AAEF,OAAO,EAAE,wBAAwB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/triggers/createTriggerInbox/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAA0B,MAAM,WAAW,CAAC;AAa7E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAKnE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;aAIpB;QACP,4BAA4B,EAAE,4BAA4B,CAAC;KAC5D,GAAG,yBAAyB,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+F/C,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG,UAAU,CACvD,OAAO,wBAAwB,CAChC,CAAC;AAEF,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/plugins/triggers/createTriggerInbox/index.js

@@ -1,9 +1,10 @@
 import { definePlugin, createPluginMethod } from "../../../utils/plugin-utils";
 import { CreateTriggerInboxSchema, TriggerInboxItemSchema } from "./schemas";
-import { ZapierConfigurationError } from "../../../types/errors";
+import { ZapierConfigurationError, ZapierConflictError, } from "../../../types/errors";
 import { appKeyResolver, actionKeyResolver, connectionIdResolver, inputsResolver, } from "../../../resolvers";
 import { resolveConnectionId } from "../../../utils/domain-utils";
 import { triggersDefaults } from "../shared";
+import { extractErrorDetail } from "../utils";
 export const createTriggerInboxPlugin = definePlugin((sdk) => createPluginMethod(sdk, {
     ...triggersDefaults,
     name: "createTriggerInbox",
@@ -16,6 +17,7 @@ export const createTriggerInboxPlugin = definePlugin((sdk) => createPluginMethod
     // seeded into resolvedParams without polluting the user-facing schema
     // (where it would leak into the SDK method signature and CLI flags).
     resolvers: {
+        name: { type: "static", inputType: "text" },
         app: appKeyResolver,
         action: actionKeyResolver,
         connection: connectionIdResolver,
@@ -24,7 +26,7 @@ export const createTriggerInboxPlugin = definePlugin((sdk) => createPluginMethod
     },
     handler: async ({ sdk, options }) => {
         const { api } = sdk.context;
-        const { app: appKey, action: actionKey, connection, inputs = {}, notificationUrl, } = options;
+        const { name, app: appKey, action: actionKey, connection, inputs = {}, notificationUrl, } = options;
         const resolvedConnectionId = await resolveConnectionId({
             connection,
             resolveConnection: sdk.context.resolveConnection,
@@ -41,10 +43,23 @@ export const createTriggerInboxPlugin = definePlugin((sdk) => createPluginMethod
                 connection_id: resolvedConnectionId ?? null,
             },
         };
+        if (name !== undefined) {
+            requestBody.name = name;
+        }
         if (notificationUrl !== undefined) {
             requestBody.notification_url = notificationUrl;
         }
-        const rawResponse = await api.post("/trigger-inbox/api/v1/inboxes", requestBody, { authRequired: true });
+        const rawResponse = await api.post("/trigger-inbox/api/v1/inboxes", requestBody, {
+            authRequired: true,
+            customErrorHandler: ({ status, data }) => {
+                if (status === 409) {
+                    const detail = extractErrorDetail(data);
+                    return new ZapierConflictError(detail ??
+                        `An inbox named "${name}" already exists with a different subscription.`, { statusCode: status, resourceType: "trigger_inbox" });
+                }
+                return undefined;
+            },
+        });
         return { data: TriggerInboxItemSchema.parse(rawResponse) };
     },
 }));

package/dist/plugins/triggers/createTriggerInbox/schemas.d.ts

@@ -2,6 +2,7 @@ import { z } from "zod";
 import type { FunctionOptions } from "../../../types/functions";
 import { TriggerInboxItemSchema, type TriggerInboxItem } from "../../../schemas/TriggerInbox";
 export declare const CreateTriggerInboxSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
     app: z.ZodString & {
         _def: z.core.$ZodStringDef & import("../../..").PositionalMetadata;
     };

package/dist/plugins/triggers/createTriggerInbox/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/plugins/triggers/createTriggerInbox/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAOhE,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAC;AAKvC,eAAO,MAAM,wBAAwB;;;;;;;;;;iBAkBK,CAAC;AAE3C,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,wBAAwB,CAChC,GACC,eAAe,CAAC;AAElB,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/plugins/triggers/createTriggerInbox/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAQhE,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAC;AAKvC,eAAO,MAAM,wBAAwB;;;;;;;;;;;iBAqBK,CAAC;AAE3C,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,wBAAwB,CAChC,GACC,eAAe,CAAC;AAElB,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/plugins/triggers/createTriggerInbox/schemas.js

@@ -1,9 +1,10 @@
 import { z } from "zod";
-import { AppPropertySchema, ActionPropertySchema, ConnectionPropertySchema, InputsPropertySchema, } from "../../../types/properties";
+import { AppPropertySchema, ActionPropertySchema, ConnectionPropertySchema, InputsPropertySchema, TriggerInboxNamePropertySchema, } from "../../../types/properties";
 import { TriggerInboxItemSchema, } from "../../../schemas/TriggerInbox";
-const CreateTriggerInboxDescription = "Create a new trigger inbox subscription with an auto-generated name. Always creates; use ensureTriggerInbox for get-or-create on a stable name.";
+const CreateTriggerInboxDescription = "Create a new trigger inbox subscription. Always creates a new inbox; use ensureTriggerInbox for get-or-create on a stable name.";
 export const CreateTriggerInboxSchema = z
     .object({
+    name: TriggerInboxNamePropertySchema.optional().describe("Optional inbox name. Auto-generated when omitted. Throws a conflict error if the name is already in use by another subscription."),
     app: AppPropertySchema,
     action: ActionPropertySchema,
     connection: ConnectionPropertySchema.nullable()

package/dist/plugins/triggers/ensureTriggerInbox/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/triggers/ensureTriggerInbox/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAA0B,MAAM,WAAW,CAAC;AAa7E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAcnE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;aAIpB;QACP,4BAA4B,EAAE,4BAA4B,CAAC;KAC5D,GAAG,yBAAyB,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2F/C,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG,UAAU,CACvD,OAAO,wBAAwB,CAChC,CAAC;AAEF,OAAO,EAAE,wBAAwB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/triggers/ensureTriggerInbox/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAA0B,MAAM,WAAW,CAAC;AAa7E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAKnE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;aAIpB;QACP,4BAA4B,EAAE,4BAA4B,CAAC;KAC5D,GAAG,yBAAyB,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2F/C,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG,UAAU,CACvD,OAAO,wBAAwB,CAChC,CAAC;AAEF,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/plugins/triggers/ensureTriggerInbox/index.js

@@ -4,18 +4,7 @@ import { ZapierConfigurationError, ZapierConflictError, } from "../../../types/e
 import { appKeyResolver, actionKeyResolver, connectionIdResolver, inputsResolver, } from "../../../resolvers";
 import { resolveConnectionId } from "../../../utils/domain-utils";
 import { triggersDefaults } from "../shared";
-function extractErrorDetail(data) {
-    if (typeof data !== "object" || data === null)
-        return undefined;
-    const errors = data.errors;
-    if (!Array.isArray(errors) || errors.length === 0)
-        return undefined;
-    const first = errors[0];
-    if (typeof first !== "object" || first === null)
-        return undefined;
-    const detail = first.detail;
-    return typeof detail === "string" ? detail : undefined;
-}
+import { extractErrorDetail } from "../utils";
 export const ensureTriggerInboxPlugin = definePlugin((sdk) => createPluginMethod(sdk, {
     ...triggersDefaults,
     name: "ensureTriggerInbox",

package/dist/plugins/triggers/utils.d.ts

@@ -14,4 +14,10 @@ export declare function resolveTriggerInboxId({ api, inbox, }: {
     api: ApiClient;
     inbox: string;
 }): Promise<string>;
+/**
+ * Pulls `errors[0].detail` off a JSON:API-style error response body.
+ * Returns `undefined` for any shape that doesn't match, so callers can
+ * fall back to a default message.
+ */
+export declare function extractErrorDetail(data: unknown): string | undefined;
 //# sourceMappingURL=utils.d.ts.map

package/dist/plugins/triggers/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/plugins/triggers/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAM3C;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,GAAG,EACH,KAAK,GACN,EAAE;IACD,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBlB"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/plugins/triggers/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAM3C;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,GAAG,EACH,KAAK,GACN,EAAE;IACD,GAAG,EAAE,SAAS,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBlB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQpE"}

package/dist/plugins/triggers/utils.js

@@ -26,3 +26,20 @@ export async function resolveTriggerInboxId({ api, inbox, }) {
     }
     return id;
 }
+/**
+ * Pulls `errors[0].detail` off a JSON:API-style error response body.
+ * Returns `undefined` for any shape that doesn't match, so callers can
+ * fall back to a default message.
+ */
+export function extractErrorDetail(data) {
+    if (typeof data !== "object" || data === null)
+        return undefined;
+    const errors = data.errors;
+    if (!Array.isArray(errors) || errors.length === 0)
+        return undefined;
+    const first = errors[0];
+    if (typeof first !== "object" || first === null)
+        return undefined;
+    const detail = first.detail;
+    return typeof detail === "string" ? detail : undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.54.0",
+  "version": "0.54.1",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",