@zapier/zapier-sdk 0.17.0 → 0.18.1

package/dist/index.cjs

@@ -72,7 +72,7 @@ var ActionTypePropertySchema = zod.z.enum([
   "filter"
 ]).describe("Action type that matches the action's defined type");
 var ActionKeyPropertySchema = zod.z.string().min(1).describe("Action key to execute");
-var AuthenticationIdPropertySchema = zod.z.number().int().describe("Authentication ID to use for this action");
+var AuthenticationIdPropertySchema = zod.z.union([zod.z.string(), zod.z.number().int().positive()]).describe("Authentication ID to use for this action");
 var InputsPropertySchema = zod.z.record(zod.z.string(), zod.z.unknown()).describe("Input parameters for the action");
 var LimitPropertySchema = zod.z.number().int().min(1).max(MAX_PAGE_LIMIT).default(50).describe("Maximum number of items to return");
 var OffsetPropertySchema = zod.z.number().int().min(0).default(0).describe("Number of items to skip for pagination");
@@ -216,12 +216,12 @@ HTTP Status: ${error.statusCode}`;
 }
 var ActionExecutionInputSchema = zod.z.object({
   inputs: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
-  authenticationId: zod.z.number().optional()
+  authenticationId: AuthenticationIdPropertySchema.optional()
 }).describe(
   "Execute an action with the given inputs for the bound app, as an alternative to runAction"
 );
 var AppFactoryInputSchema = zod.z.object({
-  authenticationId: zod.z.number()
+  authenticationId: AuthenticationIdPropertySchema
 }).describe("Bind an authentication ID to an app");
 function getStringProperty(obj, key) {
   if (typeof obj === "object" && obj !== null && key in obj) {
@@ -254,7 +254,7 @@ function createActionFunction(appKey, actionType, actionKey, options, pinnedAuth
   return (actionOptions = {}) => {
     const { sdk } = options;
     const { inputs, authenticationId: providedAuthenticationId } = actionOptions;
-    const authenticationId = pinnedAuthId || providedAuthenticationId;
+    const authenticationId = pinnedAuthId ?? providedAuthenticationId;
     if (!authenticationId) {
       throw new ZapierValidationError(
         `Authentication ID is required. Either use the factory pattern: sdk.apps.${appKey}({ authenticationId }) or provide authenticationId in the action call.`
@@ -273,7 +273,7 @@ function createActionTypeProxy(appKey, actionType, options, pinnedAuthId) {
   if (actionType === "fetch") {
     return async (url, init) => {
       const { sdk } = options;
-      const authenticationId = pinnedAuthId || init?.authenticationId;
+      const authenticationId = pinnedAuthId ?? init?.authenticationId;
       if (!authenticationId) {
         throw new ZapierValidationError(
           `Authentication ID is required for fetch. Either use the factory pattern: sdk.apps.${appKey}({ authenticationId }).fetch(...) or provide authenticationId in the fetch call.`
@@ -382,7 +382,7 @@ var FetchInitSchema = zod.z.object({
     zod.z.instanceof(FormData),
     zod.z.instanceof(URLSearchParams)
   ]).optional(),
-  authenticationId: zod.z.number().optional().describe("Zapier authentication ID to use for the request"),
+  authenticationId: AuthenticationIdPropertySchema.optional(),
   callbackUrl: zod.z.string().optional().describe("URL to send async response to (makes request async)"),
   authenticationTemplate: zod.z.string().optional().describe(
     "Optional JSON string authentication template to bypass Notary lookup"
@@ -1052,7 +1052,7 @@ zod.z.object({
   previous: zod.z.string().nullable().optional(),
   results: zod.z.array(AuthenticationSchema)
 });
-var UserProfileSchema = zod.z.object({
+zod.z.object({
   id: zod.z.number(),
   code: zod.z.string(),
   user_id: zod.z.number(),
@@ -1269,7 +1269,7 @@ zod.z.object({
   selected_api: zod.z.string().optional().describe(
     "Something like `SlackAPI` (for Python apps) or `SplitwiseCLIAPI@1.0.0` (for CLI apps). Non-public apps are fine as long as the authed user can access them."
   ),
-  authentication_id: zod.z.number().optional().describe(
+  authentication_id: zod.z.coerce.number().optional().describe(
     "If the app needs auth, provide an `authentication_id` that has the `selected_api` of the app you want to run. Can be any auth visible to the user (including shared)."
   ),
   params: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe(
@@ -1459,11 +1459,17 @@ function normalizeAuthenticationItem(auth, options = {}) {
   const {
     selected_api: selectedApi,
     customuser_id: profileId,
+    id,
+    account_id: accountId,
     ...restOfAuth
   } = auth;
   return {
     ...restOfAuth,
     // Pass through all other API response fields except selected_api
+    id: String(id),
+    // Convert to string
+    account_id: String(accountId),
+    // Convert to string
     implementation_id: selectedApi,
     // Rename selected_api to implementation_id
     title: auth.title || auth.label || void 0,
@@ -1476,8 +1482,8 @@ function normalizeAuthenticationItem(auth, options = {}) {
     // App key from implementations endpoint or parsed from selected_api
     app_version: appVersion,
     // Version from selected_api or provided
-    profile_id: profileId
-    // Map customuser_id to profile_id
+    profile_id: profileId != null ? String(profileId) : void 0
+    // Map customuser_id to profile_id, convert to string
   };
 }
 function normalizeActionItem(action) {
@@ -1998,6 +2004,20 @@ var RootFieldItemSchema = zod.z.union([
   FieldsetItemSchema
 ]);
 
+// src/utils/id-utils.ts
+function coerceToNumericId(fieldName, value) {
+  if (value === "") {
+    throw new ZapierValidationError(`The ${fieldName} cannot be empty`);
+  }
+  const numericValue = typeof value === "number" ? value : Number(value);
+  if (!Number.isFinite(numericValue)) {
+    throw new ZapierValidationError(
+      `The ${fieldName} "${value}" could not be converted to a number`
+    );
+  }
+  return numericValue;
+}
+
 // src/services/implementations.ts
 async function fetchImplementationNeeds({
   api,
@@ -2014,7 +2034,10 @@ async function fetchImplementationNeeds({
     params: inputs || {}
   };
   if (authenticationId !== null) {
-    request.authentication_id = authenticationId;
+    request.authentication_id = coerceToNumericId(
+      "authentication_id",
+      authenticationId
+    );
   }
   const response = await api.post(
     "/zapier/api/v4/implementations/needs/",
@@ -2042,7 +2065,10 @@ async function fetchImplementationChoices({
     params: inputs || {}
   };
   if (authenticationId !== null) {
-    request.authentication_id = authenticationId;
+    request.authentication_id = coerceToNumericId(
+      "authentication_id",
+      authenticationId
+    );
   }
   const response = await api.post(
     "/zapier/api/v4/implementations/choices/",
@@ -2239,6 +2265,10 @@ var ListAuthenticationsSchema = zod.z.object({
 var AuthenticationItemSchema = withFormatter(
   AuthenticationSchema.omit({ selected_api: true, customuser_id: true }).extend(
     {
+      id: zod.z.string(),
+      // Converted from number
+      account_id: zod.z.string(),
+      // Converted from number
       implementation_id: zod.z.string().optional(),
       // Renamed from selected_api
       is_expired: zod.z.string().optional(),
@@ -2249,8 +2279,8 @@ var AuthenticationItemSchema = withFormatter(
       // App key from implementations endpoint
       app_version: zod.z.string().optional(),
       // Version extracted from implementation_id
-      profile_id: zod.z.number().optional()
-      // Mapped from customuser_id
+      profile_id: zod.z.string().optional()
+      // Mapped from customuser_id, converted from number
     }
   ),
   {
@@ -2499,9 +2529,12 @@ var AuthenticationItemSchema2 = AuthenticationSchema2.omit({
   selected_api: true,
   customuser_id: true
 }).extend({
+  // Override numeric IDs with string versions (converted by normalizeAuthenticationItem)
+  id: zod.z.string(),
+  account_id: zod.z.string(),
   // Renamed fields
   implementation_id: zod.z.string().optional(),
-  profile_id: zod.z.number().optional(),
+  profile_id: zod.z.string().optional(),
   // Mapped fields (originals preserved in ...restOfAuth)
   is_expired: zod.z.string().optional(),
   expired_at: zod.z.string().nullable().optional(),
@@ -2510,7 +2543,7 @@ var AuthenticationItemSchema2 = AuthenticationSchema2.omit({
   app_version: zod.z.string().optional()
 });
 var GetAuthenticationOptionsSchema = zod.z.object({
-  authenticationId: zod.z.number().int().positive().describe("Authentication ID to retrieve")
+  authenticationId: zod.z.union([zod.z.string(), zod.z.number().int().positive()]).describe("Authentication ID to retrieve")
 }).describe("Get a specific authentication by ID");
 var GetAuthenticationHandlerRequestSchema = zod.z.object({
   authenticationId: zod.z.union([zod.z.string(), zod.z.number()]).describe("Authentication ID - string from searchParams or number")
@@ -2526,7 +2559,7 @@ var getAuthenticationPlugin = ({ context }) => {
   async function getAuthentication(options) {
     const { api } = context;
     return await api.get(
-      `/api/v0/authentications/${options.authenticationId}`
+      `/api/v0/authentications/${encodeURIComponent(options.authenticationId)}`
     );
   }
   const getAuthenticationDefinition = createFunction(
@@ -2800,7 +2833,7 @@ var RelayRequestSchema = zod.z.object({
   url: zod.z.string().url().describe("The URL to request (will be proxied through Relay)"),
   method: zod.z.enum(["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]).optional().describe("HTTP method"),
   body: zod.z.any().optional().describe("Request body as a string"),
-  authenticationId: zod.z.number().int().optional().describe("Zapier authentication ID to use for the request"),
+  authenticationId: AuthenticationIdPropertySchema.optional(),
   callbackUrl: zod.z.string().url().optional().describe("URL to send async response to (makes request async)"),
   authenticationTemplate: zod.z.string().optional().describe(
     "Optional JSON string authentication template to bypass Notary lookup"
@@ -2852,7 +2885,10 @@ var requestPlugin = ({ context }) => {
       }
     }
     if (authenticationId) {
-      headers["X-Relay-Authentication-Id"] = authenticationId.toString();
+      headers["X-Relay-Authentication-Id"] = coerceToNumericId(
+        "authenticationId",
+        authenticationId
+      ).toString();
     }
     if (callbackUrl) {
       headers["X-Relay-Callback-Url"] = callbackUrl;
@@ -2952,7 +2988,7 @@ var ActionEntrySchema = zod.z.object({
   appKey: zod.z.string().describe("App key (slug or implementation name)"),
   actionKey: zod.z.string().describe("Action key identifier"),
   actionType: zod.z.string().describe("Action type (e.g., 'read', 'write', 'search')"),
-  authenticationId: zod.z.number().nullable().optional().describe("Authentication ID used"),
+  authenticationId: AuthenticationIdPropertySchema.nullable().optional(),
   inputs: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("Resolved input values"),
   schema: zod.z.record(zod.z.string(), zod.z.unknown()).describe(
     "Complete JSON Schema from getInputFieldsSchema (includes $schema, type, properties, required, etc.)"
@@ -3338,20 +3374,18 @@ var manifestPlugin = (params) => {
 };
 var GetProfileSchema = zod.z.object({}).optional().describe("Get current user's profile information");
 var UserProfileItemSchema = withFormatter(
-  UserProfileSchema.omit({ user_id: true }).extend({
-    full_name: zod.z.string()
-    // Computed field: first_name + " " + last_name
+  zod.z.object({
+    id: zod.z.string(),
+    first_name: zod.z.string(),
+    last_name: zod.z.string(),
+    full_name: zod.z.string(),
+    email: zod.z.string(),
+    email_confirmed: zod.z.boolean(),
+    timezone: zod.z.string()
   }),
   {
     format: (item) => {
       const details = [];
-      if (item == null || typeof item !== "object" || !("full_name" in item) || !("username" in item)) {
-        return {
-          title: "User Profile",
-          subtitle: "Malformatted result item",
-          details: []
-        };
-      }
       if ("email" in item) {
         details.push({ text: item.email, style: "dim" });
       }
@@ -3361,15 +3395,9 @@ var UserProfileItemSchema = withFormatter(
           style: "accent"
         });
       }
-      if ("since_signup" in item && item.since_signup) {
-        details.push({
-          text: `Member since: ${item.since_signup}`,
-          style: "dim"
-        });
-      }
       return {
         title: item.full_name,
-        id: item.id.toString(),
+        id: item.id,
         details
       };
     }
@@ -3385,13 +3413,15 @@ var getProfilePlugin = ({ context }) => {
         authRequired: true
       }
     );
-    const { user_id: _unusedUserId, ...data } = profile;
     return {
       data: {
-        ...data,
-        // Pass through all API response fields
-        full_name: `${profile.first_name} ${profile.last_name}`
-        // Computed field
+        id: String(profile.id),
+        first_name: profile.first_name,
+        last_name: profile.last_name,
+        full_name: `${profile.first_name} ${profile.last_name}`,
+        email: profile.email,
+        email_confirmed: profile.email_confirmed,
+        timezone: profile.timezone
       }
     };
   }
@@ -3863,11 +3893,17 @@ function normalizeAuthenticationItem2(auth, options = {}) {
   const {
     selected_api: selectedApi,
     customuser_id: profileId,
+    id,
+    account_id: accountId,
     ...restOfAuth
   } = auth;
   return {
     ...restOfAuth,
     // Pass through all other API response fields except selected_api
+    id: String(id),
+    // Convert to string
+    account_id: String(accountId),
+    // Convert to string
     implementation_id: selectedApi,
     // Rename selected_api to implementation_id
     title: auth.title || auth.label || void 0,
@@ -3880,8 +3916,8 @@ function normalizeAuthenticationItem2(auth, options = {}) {
     // App key from implementations endpoint or parsed from selected_api
     app_version: appVersion,
     // Version from selected_api or provided
-    profile_id: profileId
-    // Map customuser_id to profile_id
+    profile_id: profileId != null ? String(profileId) : void 0
+    // Map customuser_id to profile_id, convert to string
   };
 }
 
@@ -4880,70 +4916,73 @@ var listInputFieldChoicesPlugin = ({ context, sdk }) => {
 // src/plugins/eventEmission/transport.ts
 var DEFAULT_RETRY_ATTEMPTS = 2;
 var DEFAULT_RETRY_DELAY_MS = 300;
-var HttpTransport = class {
-  constructor(config) {
-    this.config = config;
-  }
-  async emit(subject, event) {
-    try {
-      await this.emitWithRetry(
-        subject,
-        event,
-        this.config.retryAttempts || DEFAULT_RETRY_ATTEMPTS
-      );
-    } catch {
-    }
-  }
-  async emitWithRetry(subject, event, attemptsLeft) {
+function createHttpTransport(config) {
+  const delay = async (ms) => {
+    return new Promise((resolve2) => {
+      const timer = setTimeout(resolve2, ms);
+      if (typeof timer.unref === "function") {
+        timer.unref();
+      }
+    });
+  };
+  const emitWithRetry = async (subject, event, attemptsLeft) => {
     try {
       const payload = {
         subject,
         properties: event
       };
-      const response = await fetch(this.config.endpoint, {
+      const response = await fetch(config.endpoint, {
         method: "POST",
         headers: {
           "Content-Type": "application/json",
-          ...this.config.headers
+          ...config.headers
         },
         body: JSON.stringify(payload)
       });
       if (!response.ok && attemptsLeft > 1) {
-        await this.delay(this.config.retryDelayMs || DEFAULT_RETRY_DELAY_MS);
-        return this.emitWithRetry(subject, event, attemptsLeft - 1);
+        await delay(config.retryDelayMs || DEFAULT_RETRY_DELAY_MS);
+        return emitWithRetry(subject, event, attemptsLeft - 1);
       }
     } catch (error) {
       if (attemptsLeft > 1) {
-        await this.delay(this.config.retryDelayMs || DEFAULT_RETRY_DELAY_MS);
-        return this.emitWithRetry(subject, event, attemptsLeft - 1);
+        await delay(config.retryDelayMs || DEFAULT_RETRY_DELAY_MS);
+        return emitWithRetry(subject, event, attemptsLeft - 1);
       }
       throw error;
     }
-  }
-  async delay(ms) {
-    return new Promise((resolve2) => {
-      const timer = setTimeout(resolve2, ms);
-      if (typeof timer.unref === "function") {
-        timer.unref();
+  };
+  return {
+    async emit(subject, event) {
+      try {
+        await emitWithRetry(
+          subject,
+          event,
+          config.retryAttempts || DEFAULT_RETRY_ATTEMPTS
+        );
+      } catch {
       }
-    });
-  }
-};
-var ConsoleTransport = class {
-  async emit(subject, event) {
-    try {
-      console.log(
-        "[SDK Telemetry]",
-        JSON.stringify({ subject, properties: event }, null, 2)
-      );
-    } catch {
     }
-  }
-};
-var NoopTransport = class {
-  async emit(_subject, _event) {
-  }
-};
+  };
+}
+function createConsoleTransport() {
+  return {
+    async emit(subject, event) {
+      try {
+        console.log(
+          "[SDK Telemetry]",
+          JSON.stringify({ subject, properties: event }, null, 2)
+        );
+      } catch {
+      }
+    }
+  };
+}
+function createNoopTransport() {
+  return {
+    async emit(_subject, _event) {
+    }
+  };
+}
 function createTransport(config) {
   try {
     switch (config.type) {
@@ -4951,20 +4990,20 @@ function createTransport(config) {
         if (!config.endpoint) {
           throw new Error("HTTP transport requires endpoint");
         }
-        return new HttpTransport({
+        return createHttpTransport({
           endpoint: config.endpoint,
           headers: config.headers,
           retryAttempts: config.retryAttempts,
           retryDelayMs: config.retryDelayMs
         });
       case "console":
-        return new ConsoleTransport();
+        return createConsoleTransport();
       case "noop":
       default:
-        return new NoopTransport();
+        return createNoopTransport();
     }
   } catch {
-    return new NoopTransport();
+    return createNoopTransport();
   }
 }
 function generateEventId() {
@@ -5033,7 +5072,7 @@ function getCpuTime() {
 
 // package.json
 var package_default = {
-  version: "0.17.0"};
+  version: "0.18.1"};
 
 // src/plugins/eventEmission/builders.ts
 function createBaseEvent(context = {}) {