@zapier/zapier-sdk 0.9.0 → 0.10.0

package/src/plugins/getAction/index.ts

@@ -5,6 +5,12 @@ import { GetActionSchema, type GetActionOptions } from "./schemas";
 import { ZapierResourceNotFoundError } from "../../types/errors";
 import { createFunction } from "../../utils/function-utils";
 import type { ListActionsPluginProvides } from "../listActions";
+import {
+  appKeyResolver,
+  actionTypeResolver,
+  actionKeyResolver,
+} from "../../resolvers";
+import { ActionItemSchema } from "../../schemas/Action";
 
 export interface GetActionPluginProvides {
   getAction: (options: GetActionOptions) => Promise<{ data: ActionItem }>;
@@ -50,7 +56,15 @@ export const getActionPlugin: Plugin<
       meta: {
         getAction: {
           categories: ["action"],
+          type: "item",
+          itemType: "Action",
           inputSchema: GetActionSchema,
+          outputSchema: ActionItemSchema,
+          resolvers: {
+            appKey: appKeyResolver,
+            actionType: actionTypeResolver,
+            actionKey: actionKeyResolver,
+          },
         },
       },
     },

package/src/plugins/getApp/index.test.ts

@@ -72,7 +72,7 @@ describe("getApp plugin", () => {
 
       expect(result.data.title).toBe("Slack");
       expect(result.data.key).toBe("SlackCLIAPI");
-      expect(result.data.current_implementation_id).toBe("SlackCLIAPI@1.0.0");
+      expect(result.data.implementation_id).toBe("SlackCLIAPI@1.0.0");
       expect(result.data.version).toBe("1.0.0");
     });
   });
@@ -121,7 +121,7 @@ describe("getApp plugin", () => {
 
       expect(result.data.title).toBeDefined();
       expect(result.data.key).toBeDefined();
-      expect(result.data.current_implementation_id).toBeDefined();
+      expect(result.data.implementation_id).toBeDefined();
       expect(result.data.title).toBe("Test App");
       expect(result.data.key).toBe("TestCLIAPI");
     });

package/src/plugins/getApp/index.ts

@@ -3,9 +3,11 @@ import { createFunction } from "../../utils/function-utils";
 import { GetAppSchema } from "./schemas";
 import type { GetAppOptions } from "./schemas";
 import type { AppItem } from "../../types/domain";
+import { AppItemSchema } from "../../schemas/App";
 import { ZapierAppNotFoundError } from "../../types/errors";
 import type { GetSdkType } from "../../types/plugin";
 import type { ListAppsPluginProvides } from "../listApps";
+import { appKeyResolver } from "../../resolvers";
 
 // GetApp plugin provides interface - getApp goes directly to SDK root
 export interface GetAppPluginProvides {
@@ -44,7 +46,13 @@ export const getAppPlugin: Plugin<
       meta: {
         getApp: {
           categories: ["app"],
+          type: "item",
+          itemType: "App",
           inputSchema: GetAppSchema,
+          outputSchema: AppItemSchema,
+          resolvers: {
+            appKey: appKeyResolver,
+          },
         },
       },
     },

package/src/plugins/getApp/schemas.ts

@@ -1,7 +1,5 @@
 import { z } from "zod";
 import { AppKeyPropertySchema } from "../../types/properties";
-import { withOutputSchema } from "../../utils/schema-utils";
-import { AppItemSchema } from "../../schemas/App";
 import type { AppItem } from "../../types/domain";
 import type {
   ZapierApiError,
@@ -18,16 +16,13 @@ export type GetAppError =
   | ZapierValidationError;
 
 // Pure Zod schema - no resolver metadata!
-export const GetAppSchema = withOutputSchema(
-  z
-    .object({
-      appKey: AppKeyPropertySchema.describe(
-        "App key of app to fetch (e.g., 'SlackCLIAPI')",
-      ),
-    })
-    .describe("Get detailed information about a specific app"),
-  AppItemSchema,
-);
+export const GetAppSchema = z
+  .object({
+    appKey: AppKeyPropertySchema.describe(
+      "App key of app to fetch (e.g., 'SlackCLIAPI')",
+    ),
+  })
+  .describe("Get detailed information about a specific app");
 
 // Type inferred from schema
 export type GetAppOptions = z.infer<typeof GetAppSchema>;

package/src/plugins/getAuthentication/index.ts

@@ -12,6 +12,8 @@ import {
 } from "../../types/errors";
 import { createFunction } from "../../utils/function-utils";
 import { normalizeAuthenticationItem } from "../../utils/domain-utils";
+import { authenticationIdGenericResolver } from "../../resolvers";
+import { AuthenticationItemSchema } from "../../schemas/Auth";
 
 export interface GetAuthenticationPluginProvides {
   getAuthentication: (
@@ -79,7 +81,13 @@ export const getAuthenticationPlugin: Plugin<
       meta: {
         getAuthentication: {
           categories: ["authentication"],
+          type: "item",
+          itemType: "Authentication",
           inputSchema: GetAuthenticationSchema,
+          outputSchema: AuthenticationItemSchema,
+          resolvers: {
+            authenticationId: authenticationIdGenericResolver,
+          },
         },
       },
     },

package/src/plugins/getProfile/index.ts

@@ -4,6 +4,7 @@ import { createFunction } from "../../utils/function-utils";
 import type { Plugin } from "../../types/plugin";
 import type { UserProfileItem } from "../../types/domain";
 import { GetProfileSchema } from "./schemas";
+import { UserProfileItemSchema } from "../../schemas/UserProfile";
 
 // GetProfile plugin provides interface - getProfile goes directly to SDK root
 export interface GetProfilePluginProvides {
@@ -48,7 +49,10 @@ export const getProfilePlugin: Plugin<
       meta: {
         getProfile: {
           categories: ["account"],
+          type: "item",
+          itemType: "Profile",
           inputSchema: GetProfileSchema,
+          outputSchema: UserProfileItemSchema,
         },
       },
     },

package/src/plugins/getProfile/schemas.ts

@@ -1,6 +1,4 @@
 import { z } from "zod";
-import { withOutputSchema } from "../../utils/schema-utils";
-import { UserProfileItemSchema } from "../../schemas/UserProfile";
 import type { FunctionOptions } from "../../types/functions";
 import type { UserProfileItem } from "../../types/domain";
 import type { ZapierApiError, ZapierValidationError } from "../../types/errors";
@@ -9,10 +7,10 @@ import type { ZapierApiError, ZapierValidationError } from "../../types/errors";
 export type GetProfileError = ZapierApiError | ZapierValidationError;
 
 // Pure Zod schema - no resolver metadata!
-export const GetProfileSchema = withOutputSchema(
-  z.object({}).optional().describe("Get current user's profile information"),
-  UserProfileItemSchema,
-);
+export const GetProfileSchema = z
+  .object({})
+  .optional()
+  .describe("Get current user's profile information");
 
 // Type inferred from schema + function config
 export type GetProfileOptions = z.infer<typeof GetProfileSchema> &

package/src/plugins/listActions/index.ts

@@ -7,6 +7,7 @@ import {
   type ListActionsOptions,
   type ListActionsPage,
 } from "./schemas";
+import { ActionItemSchema } from "../../schemas/Action";
 import {
   ZapierConfigurationError,
   ZapierAuthenticationError,
@@ -14,6 +15,7 @@ import {
 import { createPaginatedFunction } from "../../utils/function-utils";
 import type { ManifestPluginProvides } from "../manifest";
 import type { GetVersionedImplementationId } from "../manifest/schemas";
+import { appKeyResolver, actionTypeResolver } from "../../resolvers";
 
 export interface ListActionsPluginProvides {
   listActions: (options?: ListActionsOptions) => Promise<{
@@ -114,7 +116,14 @@ export const listActionsPlugin: Plugin<
       meta: {
         listActions: {
           categories: ["action"],
+          type: "list",
+          itemType: "Action",
           inputSchema: ListActionsSchema,
+          outputSchema: ActionItemSchema,
+          resolvers: {
+            appKey: appKeyResolver,
+            actionType: actionTypeResolver,
+          },
         },
       },
     },

package/src/plugins/listActions/schemas.ts

@@ -3,8 +3,6 @@ import {
   AppKeyPropertySchema,
   ActionTypePropertySchema,
 } from "../../types/properties";
-import { withOutputSchema } from "../../utils/schema-utils";
-import { ActionItemSchema } from "../../schemas/Action";
 import type { ActionItem } from "../../types/domain";
 import type { PaginatedSdkFunction } from "../../types/functions";
 import type {
@@ -14,29 +12,26 @@ import type {
 } from "../../types/errors";
 
 // Pure Zod schema - no resolver metadata!
-export const ListActionsSchema = withOutputSchema(
-  z
-    .object({
-      appKey: AppKeyPropertySchema.describe(
-        "App key of actions to list (e.g., 'SlackCLIAPI')",
-      ),
-      actionType: ActionTypePropertySchema.optional().describe(
-        "Filter actions by type",
-      ),
-      pageSize: z
-        .number()
-        .min(1)
-        .optional()
-        .describe("Number of actions per page"),
-      maxItems: z
-        .number()
-        .min(1)
-        .optional()
-        .describe("Maximum total items to return across all pages"),
-    })
-    .describe("List all actions for a specific app"),
-  ActionItemSchema,
-);
+export const ListActionsSchema = z
+  .object({
+    appKey: AppKeyPropertySchema.describe(
+      "App key of actions to list (e.g., 'SlackCLIAPI')",
+    ),
+    actionType: ActionTypePropertySchema.optional().describe(
+      "Filter actions by type",
+    ),
+    pageSize: z
+      .number()
+      .min(1)
+      .optional()
+      .describe("Number of actions per page"),
+    maxItems: z
+      .number()
+      .min(1)
+      .optional()
+      .describe("Maximum total items to return across all pages"),
+  })
+  .describe("List all actions for a specific app");
 
 // Type inferred from schema
 export type ListActionsOptions = z.infer<typeof ListActionsSchema>;

package/src/plugins/listApps/index.test.ts

@@ -228,7 +228,7 @@ describe("listApps plugin", () => {
 
       expect(result.data[0]).toHaveProperty("title");
       expect(result.data[0]).toHaveProperty("key");
-      expect(result.data[0]).toHaveProperty("current_implementation_id");
+      expect(result.data[0]).toHaveProperty("implementation_id");
       // Version is optional
       expect(result.data[0]).toHaveProperty("version");
     });

package/src/plugins/listApps/index.ts

@@ -3,6 +3,7 @@ import { createPaginatedFunction } from "../../utils/function-utils";
 import { ListAppsSchema } from "./schemas";
 import type { ListAppsOptions, ListAppsPage } from "./schemas";
 import type { AppItem } from "../../types/domain";
+import { AppItemSchema } from "../../schemas/App";
 import type { ResolvedAppLocator } from "../../utils/domain-utils";
 import {
   normalizeImplementationMetaToAppItem,
@@ -135,7 +136,10 @@ export const listAppsPlugin: Plugin<
       meta: {
         listApps: {
           categories: ["app"],
+          type: "list",
+          itemType: "App",
           inputSchema: ListAppsSchema,
+          outputSchema: AppItemSchema,
         },
       },
     },

package/src/plugins/listApps/schemas.ts

@@ -2,8 +2,6 @@ import { z } from "zod";
 import type { AppItem } from "../../types/domain";
 import type { PaginatedSdkFunction } from "../../types/functions";
 import type { ZapierApiError, ZapierValidationError } from "../../types/errors";
-import { AppItemSchema } from "../../schemas/App";
-import { withOutputSchema } from "../../utils/schema-utils";
 
 // Union of all possible errors for listApps
 export type ListAppsError = ZapierApiError | ZapierValidationError;
@@ -15,30 +13,23 @@ export interface ListAppsPage {
 }
 
 // Pure Zod schema - no pagination metadata exposed
-export const ListAppsSchema = withOutputSchema(
-  z
-    .object({
-      appKeys: z
-        .array(z.string())
-        .optional()
-        .describe(
-          "Filter apps by app keys (e.g., 'SlackCLIAPI' or slug like 'github')",
-        ),
-      search: z.string().optional().describe("Search for apps by name"),
-      pageSize: z
-        .number()
-        .min(1)
-        .optional()
-        .describe("Number of apps per page"),
-      maxItems: z
-        .number()
-        .min(1)
-        .optional()
-        .describe("Maximum total items to return across all pages"),
-    })
-    .describe("List all available apps with optional filtering"),
-  AppItemSchema,
-);
+export const ListAppsSchema = z
+  .object({
+    appKeys: z
+      .array(z.string())
+      .optional()
+      .describe(
+        "Filter apps by app keys (e.g., 'SlackCLIAPI' or slug like 'github')",
+      ),
+    search: z.string().optional().describe("Search for apps by name"),
+    pageSize: z.number().min(1).optional().describe("Number of apps per page"),
+    maxItems: z
+      .number()
+      .min(1)
+      .optional()
+      .describe("Maximum total items to return across all pages"),
+  })
+  .describe("List all available apps with optional filtering");
 
 // Type inferred from schema
 export type ListAppsOptions = z.infer<typeof ListAppsSchema>;

package/src/plugins/listAuthentications/index.ts

@@ -18,6 +18,8 @@ import {
 } from "../../utils/function-utils";
 import type { GetVersionedImplementationId } from "../manifest/schemas";
 import type { ManifestPluginProvides } from "../manifest";
+import { appKeyResolver } from "../../resolvers";
+import { AuthenticationItemSchema } from "../../schemas/Auth";
 
 export interface ListAuthenticationsPluginProvides {
   listAuthentications: (options?: ListAuthenticationsOptions) => Promise<{
@@ -135,7 +137,13 @@ export const listAuthenticationsPlugin: Plugin<
       meta: {
         listAuthentications: {
           categories: ["authentication"],
+          type: "list",
+          itemType: "Authentication",
           inputSchema: ListAuthenticationsSchema,
+          outputSchema: AuthenticationItemSchema,
+          resolvers: {
+            appKey: appKeyResolver,
+          },
         },
       },
     },

package/src/plugins/listInputFieldChoices/index.ts

@@ -10,10 +10,19 @@ import {
   ListInputFieldChoicesSchema,
   type ListInputFieldChoicesOptions,
   type ListInputFieldChoicesPage,
+  InputFieldChoiceItemSchema,
 } from "./schemas";
 import { ZapierApiError } from "../../types/errors";
 import { createPaginatedFunction } from "../../utils/function-utils";
 import type { GetActionPluginProvides } from "../getAction";
+import {
+  appKeyResolver,
+  actionTypeResolver,
+  actionKeyResolver,
+  authenticationIdResolver,
+  inputFieldKeyResolver,
+  inputsAllOptionalResolver,
+} from "../../resolvers";
 
 // Transform NeedChoices to InputFieldChoiceItem
 function transformNeedChoicesToInputFieldChoiceItem(
@@ -116,7 +125,7 @@ export const listInputFieldChoicesPlugin: Plugin<
 
     // Handle pagination
     let nextCursor: string | undefined;
-    if (choicesData.next_page !== undefined) {
+    if (choicesData.next_page != null) {
       nextCursor = choicesData.next_page.toString();
     } else if (choicesData.links?.next) {
       // Extract page from next URL for external actions
@@ -144,7 +153,18 @@ export const listInputFieldChoicesPlugin: Plugin<
       meta: {
         listInputFieldChoices: {
           categories: ["action"],
+          type: "list",
+          itemType: "InputFieldChoice",
           inputSchema: ListInputFieldChoicesSchema,
+          outputSchema: InputFieldChoiceItemSchema,
+          resolvers: {
+            appKey: appKeyResolver,
+            actionType: actionTypeResolver,
+            actionKey: actionKeyResolver,
+            authenticationId: authenticationIdResolver,
+            inputFieldKey: inputFieldKeyResolver,
+            inputs: inputsAllOptionalResolver,
+          },
         },
       },
     },

package/src/plugins/listInputFieldChoices/schemas.ts

@@ -6,7 +6,8 @@ import {
   ActionKeyPropertySchema,
   InputsPropertySchema,
 } from "../../types/properties";
-import { withFormatter, withOutputSchema } from "../../utils/schema-utils";
+import { withFormatter } from "../../utils/schema-utils";
+import { NeedChoicesSchema } from "../../api/schemas";
 import type { PaginatedSdkFunction } from "../../types/functions";
 import type {
   ZapierConfigurationError,
@@ -21,46 +22,33 @@ import type {
 // Input Field Choice Item Schema
 // ============================================================================
 
-export const InputFieldChoiceItemSchema = withFormatter(
-  z.object({
-    key: z.string().optional().describe("Unique key/value for the choice"),
-    label: z
-      .string()
-      .optional()
-      .describe("Human readable label for the choice"),
-    sample: z.string().optional().describe("Sample value for the choice"),
-    value: z
-      .string()
-      .optional()
-      .describe("Value to be submitted when selected"),
-  }),
-  {
-    format: (item) => {
-      const title = item.label || item.key || "Choice";
-      const subtitle =
-        item.label && item.key && item.label !== item.key
-          ? `(${item.key})`
-          : undefined;
-      const details: Array<{
-        text: string;
-        style: "success" | "dim" | "normal" | "accent" | "warning";
-      }> = [];
+export const InputFieldChoiceItemSchema = withFormatter(NeedChoicesSchema, {
+  format: (item) => {
+    const title = item.label || item.key || "Choice";
+    const details: Array<{
+      text: string;
+      style: "success" | "dim" | "normal" | "accent" | "warning";
+    }> = [];
+
+    // Show key as detail if different from label
+    if (item.label && item.key && item.label !== item.key) {
+      details.push({ text: `Key: ${item.key}`, style: "dim" });
+    }
 
-      if (item.sample && item.sample !== item.key) {
-        details.push({ text: `Sample: ${item.sample}`, style: "dim" });
-      }
-      if (item.value && item.value !== item.key) {
-        details.push({ text: `Value: ${item.value}`, style: "normal" });
-      }
+    if (item.sample && item.sample !== item.key) {
+      details.push({ text: `Sample: ${item.sample}`, style: "dim" });
+    }
+    if (item.value && item.value !== item.key) {
+      details.push({ text: `Value: ${item.value}`, style: "normal" });
+    }
 
-      return {
-        title,
-        subtitle,
-        details,
-      };
-    },
+    return {
+      title,
+      key: item.key,
+      details,
+    };
   },
-);
+});
 
 export type InputFieldChoiceItem = z.infer<typeof InputFieldChoiceItemSchema>;
 
@@ -68,47 +56,44 @@ export type InputFieldChoiceItem = z.infer<typeof InputFieldChoiceItemSchema>;
 // Plugin Schema Definition
 // ============================================================================
 
-export const ListInputFieldChoicesSchema = withOutputSchema(
-  z
-    .object({
-      // Required action identification
-      appKey: AppKeyPropertySchema,
-      actionType: ActionTypePropertySchema,
-      actionKey: ActionKeyPropertySchema,
+export const ListInputFieldChoicesSchema = z
+  .object({
+    // Required action identification
+    appKey: AppKeyPropertySchema,
+    actionType: ActionTypePropertySchema,
+    actionKey: ActionKeyPropertySchema,
 
-      // Input field specification
-      inputFieldKey: z
-        .string()
-        .min(1)
-        .describe("Input field key to get choices for."),
+    // Input field specification
+    inputFieldKey: z
+      .string()
+      .min(1)
+      .describe("Input field key to get choices for."),
 
-      // Common parameters
-      authenticationId: AuthenticationIdPropertySchema.nullable().optional(),
-      inputs: InputsPropertySchema.optional().describe(
-        "Current input values that may affect available choices",
-      ),
-      page: z
-        .number()
-        .int()
-        .min(0)
-        .optional()
-        .describe("Page number for paginated results"),
+    // Common parameters
+    authenticationId: AuthenticationIdPropertySchema.nullable().optional(),
+    inputs: InputsPropertySchema.optional().describe(
+      "Current input values that may affect available choices",
+    ),
+    page: z
+      .number()
+      .int()
+      .min(0)
+      .optional()
+      .describe("Page number for paginated results"),
 
-      // Pagination options (SDK-level)
-      pageSize: z
-        .number()
-        .min(1)
-        .optional()
-        .describe("Number of choices per page"),
-      maxItems: z
-        .number()
-        .min(1)
-        .optional()
-        .describe("Maximum total items to return across all pages"),
-    })
-    .describe("Get the available choices for a dynamic dropdown input field"),
-  InputFieldChoiceItemSchema,
-);
+    // Pagination options (SDK-level)
+    pageSize: z
+      .number()
+      .min(1)
+      .optional()
+      .describe("Number of choices per page"),
+    maxItems: z
+      .number()
+      .min(1)
+      .optional()
+      .describe("Maximum total items to return across all pages"),
+  })
+  .describe("Get the available choices for a dynamic dropdown input field");
 
 // Type inferred from schema
 export type ListInputFieldChoicesOptions = z.infer<

package/src/plugins/listInputFields/index.test.ts

@@ -217,7 +217,7 @@ describe("listInputFields plugin", () => {
       // Check message field transformation
       expect(result.data[0]).toEqual(
         expect.objectContaining({
-          id: "message",
+          key: "message",
           title: "Message",
           description: "The message to send",
           is_required: true,
@@ -227,26 +227,22 @@ describe("listInputFields plugin", () => {
         }),
       );
 
-      // Check channel field with choices (SELECT format)
+      // Check channel field with SELECT format
       expect(result.data[1]).toEqual(
         expect.objectContaining({
-          id: "channel",
+          key: "channel",
           title: "Channel",
           description: "The channel to send to",
           is_required: true,
           value_type: "STRING",
           format: "SELECT",
-          choices: [
-            { value: "#general", label: "General", sample: "#general" },
-            { value: "#random", label: "Random", sample: "#random" },
-          ],
         }),
       );
 
       // Check array field
       expect(result.data[2]).toEqual(
         expect.objectContaining({
-          id: "tags",
+          key: "tags",
           title: "Tags",
           description: "List of tags",
           value_type: "ARRAY",
@@ -405,7 +401,7 @@ describe("listInputFields plugin", () => {
       }
 
       expect(items).toHaveLength(3);
-      expect(items[0].id).toBe("message");
+      expect(items[0].key).toBe("message");
     });
   });
 });