@zapier/zapier-sdk 0.0.3 → 0.1.0

package/src/output-schemas.ts

@@ -1,196 +0,0 @@
-import { z } from "zod";
-
-// ============================================================================
-// Format Metadata Types
-// ============================================================================
-
-export interface FormattedItem {
-  title: string;
-  subtitle?: string;
-  details: Array<{
-    text: string;
-    style: "normal" | "dim" | "accent" | "warning" | "success";
-  }>;
-}
-
-export interface FormatMetadata {
-  format: (item: any) => FormattedItem;
-}
-
-// ============================================================================
-// Schema Enhancement Helpers
-// ============================================================================
-
-// Helper function to add format metadata to schemas
-function withFormatter<T extends z.ZodType>(
-  schema: T,
-  formatMeta: FormatMetadata,
-): T {
-  // Store format metadata on the schema definition
-  (schema._def as any).formatMeta = formatMeta;
-  return schema;
-}
-
-// Helper function to link input schemas to output schemas
-export function withOutputSchema<T extends z.ZodType>(
-  inputSchema: T,
-  outputSchema: z.ZodType,
-): T {
-  // Store output schema reference on the input schema
-  (inputSchema._def as any).outputSchema = outputSchema;
-  return inputSchema;
-}
-
-// Helper function to get format metadata from a schema
-export function getFormatMetadata(
-  schema: z.ZodType,
-): FormatMetadata | undefined {
-  return (schema._def as any).formatMeta;
-}
-
-// Helper function to get output schema from an input schema
-export function getOutputSchema(inputSchema: z.ZodType): z.ZodType | undefined {
-  return (inputSchema._def as any).outputSchema;
-}
-
-// ============================================================================
-// Output Item Schemas
-// ============================================================================
-
-export const AppItemSchema = withFormatter(
-  z.object({
-    key: z.string(),
-    name: z.string().optional(),
-    description: z.string().optional(),
-    category: z.string().optional(),
-  }),
-  {
-    format: (item) => {
-      const details = [];
-      if (item.description) {
-        details.push({ text: item.description, style: "dim" as const });
-      }
-      if (item.category) {
-        details.push({
-          text: `Category: ${item.category}`,
-          style: "accent" as const,
-        });
-      }
-
-      return {
-        title: item.name || item.key,
-        subtitle: `(${item.key})`,
-        details,
-      };
-    },
-  },
-);
-
-export const ActionItemSchema = withFormatter(
-  z.object({
-    key: z.string(),
-    name: z.string().optional(),
-    type: z.string(),
-    appKey: z.string().optional(),
-    description: z.string().optional(),
-  }),
-  {
-    format: (item) => {
-      const details = [];
-      details.push({ text: `Type: ${item.type}`, style: "accent" as const });
-      if (item.appKey) {
-        details.push({ text: `App: ${item.appKey}`, style: "normal" as const });
-      }
-      if (item.description) {
-        details.push({ text: item.description, style: "dim" as const });
-      }
-
-      return {
-        title: item.name || item.key,
-        subtitle: `(${item.key})`,
-        details,
-      };
-    },
-  },
-);
-
-export const AuthItemSchema = withFormatter(
-  z.object({
-    id: z.number(),
-    title: z.string().optional(),
-    label: z.string().optional(),
-    identifier: z.string().optional(),
-    account_id: z.string().optional(),
-    is_private: z.boolean().optional(),
-    shared_with_all: z.boolean().optional(),
-    marked_stale_at: z.string().optional(),
-  }),
-  {
-    format: (item) => {
-      const details = [];
-
-      if (item.identifier) {
-        details.push({
-          text: `Identifier: ${item.identifier}`,
-          style: "accent" as const,
-        });
-      }
-
-      if (item.label && item.title && item.label !== item.title) {
-        details.push({
-          text: `Label: ${item.label}`,
-          style: "normal" as const,
-        });
-      }
-
-      details.push({
-        text: `Account: ${item.account_id || "unknown"} | Private: ${item.is_private || false} | Shared: ${item.shared_with_all || false}`,
-        style: "dim" as const,
-      });
-
-      if (item.marked_stale_at) {
-        details.push({
-          text: `⚠️  Marked stale: ${new Date(item.marked_stale_at).toLocaleDateString()}`,
-          style: "warning" as const,
-        });
-      }
-
-      return {
-        title: item.title || item.label || `Authentication ${item.id}`,
-        subtitle: `(ID: ${item.id})`,
-        details,
-      };
-    },
-  },
-);
-
-export const FieldItemSchema = withFormatter(
-  z.object({
-    key: z.string(),
-    name: z.string().optional(),
-    description: z.string().optional(),
-  }),
-  {
-    format: (item) => {
-      const details = [];
-      if (item.description) {
-        details.push({ text: item.description, style: "dim" as const });
-      }
-
-      return {
-        title: item.name || item.key,
-        subtitle: `(${item.key})`,
-        details,
-      };
-    },
-  },
-);
-
-// ============================================================================
-// Type Exports
-// ============================================================================
-
-export type AppItem = z.infer<typeof AppItemSchema>;
-export type ActionItem = z.infer<typeof ActionItemSchema>;
-export type AuthItem = z.infer<typeof AuthItemSchema>;
-export type FieldItem = z.infer<typeof FieldItemSchema>;

package/src/schemas.ts

@@ -1,467 +0,0 @@
-import { z } from "zod";
-import {
-  withOutputSchema,
-  AppItemSchema,
-  ActionItemSchema,
-  AuthItemSchema,
-  FieldItemSchema,
-} from "./output-schemas";
-
-// ============================================================================
-// Resolution Metadata Types
-// ============================================================================
-
-export interface StaticResolver {
-  type: "static";
-  inputType?: "input" | "password" | "editor";
-  placeholder?: string;
-}
-
-export interface DynamicResolver {
-  type: "dynamic";
-  fetch: (sdk: any, resolvedParams: any) => Promise<any[]>; // Function to fetch data using SDK
-  prompt: (items: any[], params: any) => any;
-  depends?: string[]; // Parameters this resolver depends on
-}
-
-export interface FieldsResolver {
-  type: "fields";
-  fetch: (sdk: any, resolvedParams: any) => Promise<any[]>; // Function to fetch field definitions using sdk.fields.list
-  depends?: string[]; // Parameters this resolver depends on
-}
-
-export interface ResolverMetadata {
-  resolver?: StaticResolver | DynamicResolver | FieldsResolver;
-}
-
-// Helper function to add resolver metadata to schemas
-function withResolver<T extends z.ZodType>(
-  schema: T,
-  meta: ResolverMetadata,
-): T {
-  // Store resolver metadata on the schema definition
-  (schema._def as any).resolverMeta = meta;
-  return schema;
-}
-
-// ============================================================================
-// Base Schemas
-// ============================================================================
-
-const PaginationSchema = z.object({
-  limit: z
-    .number()
-    .int()
-    .min(1)
-    .max(200)
-    .optional()
-    .describe("Maximum number of items to return (1-200)"),
-  offset: z
-    .number()
-    .int()
-    .min(0)
-    .optional()
-    .describe("Number of items to skip for pagination"),
-});
-
-// ============================================================================
-// Apps Service Schemas
-// ============================================================================
-
-export const AppsListSchema = withOutputSchema(
-  z
-    .object({
-      category: z
-        .string()
-        .optional()
-        .describe(
-          "Filter apps by category (e.g., 'productivity', 'crm', 'hr')",
-        ),
-      ...PaginationSchema.shape,
-    })
-    .describe("List available apps with optional filtering"),
-  AppItemSchema,
-);
-
-export const AppsGetSchema = z
-  .object({
-    key: z
-      .string()
-      .min(1)
-      .describe(
-        "The unique app key/slug (e.g., 'slack', 'github', '100hires-ats')",
-      ),
-  })
-  .describe("Get detailed information about a specific app");
-
-// ============================================================================
-// Shared Parameter Schemas
-// ============================================================================
-
-// Shared app parameter with resolver
-const AppParameterSchema = withResolver(
-  z.string().min(1).describe("App slug (e.g., 'slack', 'github')"),
-  {
-    resolver: {
-      type: "static",
-    },
-  },
-);
-
-// Shared type parameter with resolver that depends on app
-const ActionTypeParameterSchema = withResolver(
-  z
-    .enum(["read", "write", "search", "create", "update", "delete"])
-    .describe("Action type that matches the action's defined type"),
-  {
-    resolver: {
-      type: "dynamic",
-      depends: ["app"],
-      fetch: async (sdk: any, resolvedParams: any) => {
-        const actions = await sdk.actions.list({ appKey: resolvedParams.app });
-        const types = [...new Set(actions.map((action: any) => action.type))];
-        return types.map((type) => ({ key: type, name: type }));
-      },
-      prompt: (types: any[]) => ({
-        type: "list",
-        name: "type",
-        message: "Select action type:",
-        choices: types.map((type) => ({
-          name: type.name,
-          value: type.key,
-        })),
-      }),
-    },
-  },
-);
-
-// Shared action parameter with resolver that depends on app and type
-const ActionParameterSchema = withResolver(
-  z.string().min(1).describe("Action key to execute"),
-  {
-    resolver: {
-      type: "dynamic",
-      depends: ["app", "type"],
-      fetch: async (sdk: any, resolvedParams: any) => {
-        const actions = await sdk.actions.list({ appKey: resolvedParams.app });
-        return actions.filter(
-          (action: any) => action.type === resolvedParams.type,
-        );
-      },
-      prompt: (actions: any[]) => ({
-        type: "list",
-        name: "action",
-        message: "Select action:",
-        choices: actions.map((action) => ({
-          name: `${action.name || action.key} - ${
-            action.description || "No description"
-          }`,
-          value: action.key,
-        })),
-      }),
-    },
-  },
-);
-
-// Shared authId parameter with resolver that depends on app
-const AuthIdParameterSchema = withResolver(
-  z
-    .number()
-    .int()
-    .optional()
-    .describe("Authentication ID to use for this action"),
-  {
-    resolver: {
-      type: "dynamic",
-      depends: ["app"],
-      fetch: async (sdk: any, resolvedParams: any) => {
-        // Get auths for the specific app (owned auths will be prioritized automatically)
-        return await sdk.auths.list({
-          appKey: resolvedParams.app,
-          limit: 1000,
-        });
-      },
-      prompt: (auths: any[], params: any) => ({
-        type: "list",
-        name: "authId",
-        message: `Select authentication for ${params.app}:`,
-        choices: [
-          ...auths.map((auth) => ({
-            name: `${auth.title || auth.label || "Authentication"} (ID: ${auth.id})`,
-            value: auth.id,
-          })),
-          {
-            name: "↗ Skip authentication (may fail)",
-            value: null,
-          },
-        ],
-      }),
-    },
-  },
-);
-
-// ============================================================================
-// Fields Service Schemas
-// ============================================================================
-
-export const FieldsListSchema = withOutputSchema(
-  z
-    .object({
-      app: AppParameterSchema,
-      type: ActionTypeParameterSchema,
-      action: ActionParameterSchema,
-      authId: AuthIdParameterSchema,
-      params: z
-        .record(z.any())
-        .optional()
-        .describe("Additional parameters that may affect available fields"),
-    })
-    .describe("Get the input fields required for a specific action"),
-  FieldItemSchema,
-);
-
-// ============================================================================
-// Actions Service Schemas
-// ============================================================================
-
-export const ActionsListSchema = withOutputSchema(
-  z
-    .object({
-      appKey: withResolver(
-        z
-          .string()
-          .min(1)
-          .describe("App slug to get actions for (e.g., 'slack', 'github')"),
-        {
-          resolver: {
-            type: "static",
-          },
-        },
-      ),
-      type: z
-        .enum(["read", "write", "search", "create", "update", "delete"])
-        .optional()
-        .describe("Filter actions by type"),
-    })
-    .describe("List all actions for a specific app"),
-  ActionItemSchema,
-);
-
-export const ActionsGetSchema = z
-  .object({
-    app: AppParameterSchema,
-    type: ActionTypeParameterSchema,
-    action: ActionParameterSchema,
-  })
-  .describe("Get detailed information about a specific action");
-
-export const ActionsRunSchema = z
-  .object({
-    app: AppParameterSchema,
-    type: ActionTypeParameterSchema,
-    action: ActionParameterSchema,
-    inputs: withResolver(
-      z
-        .record(z.any())
-        .optional()
-        .describe("Input parameters for the action as key-value pairs"),
-      {
-        resolver: {
-          type: "fields",
-          depends: ["app", "action", "type", "authId"],
-          fetch: async (sdk: any, resolvedParams: any) => {
-            return await sdk.fields.list({
-              app: resolvedParams.app,
-              action: resolvedParams.action,
-              type: resolvedParams.type,
-              authId: resolvedParams.authId,
-            });
-          },
-        },
-      },
-    ),
-    authId: AuthIdParameterSchema,
-  })
-  .describe("Execute an action on a specific app");
-
-// ============================================================================
-// Auths Service Schemas
-// ============================================================================
-
-export const AuthsListSchema = withOutputSchema(
-  z
-    .object({
-      appKey: withResolver(
-        z
-          .string()
-          .min(1)
-          .describe(
-            "App slug to get authentications for (e.g., 'slack', 'github')",
-          ),
-        {
-          resolver: {
-            type: "static",
-          },
-        },
-      ),
-      account_id: z.string().optional().describe("Filter by account ID"),
-      owner: z.string().optional().describe("Filter by owner"),
-      ...PaginationSchema.shape,
-    })
-    .describe("List available authentications with optional filtering"),
-  AuthItemSchema,
-);
-
-export const AuthsFindSchema = z
-  .object({
-    appKey: z.string().min(1).describe("App key to find authentication for"),
-  })
-  .describe("Find the authentication ID for a specific app");
-
-// ============================================================================
-// Root Tools Schemas
-// ============================================================================
-
-export const GenerateSchema = z
-  .object({
-    appKey: withResolver(
-      z.string().min(1).describe("App key to generate SDK code for"),
-      {
-        resolver: {
-          type: "static",
-        },
-      },
-    ),
-    token: z
-      .string()
-      .optional()
-      .describe("Zapier API token (defaults to ZAPIER_TOKEN env var)"),
-    authId: withResolver(
-      z.number().int().optional().describe("Authentication ID to use"),
-      {
-        resolver: {
-          type: "dynamic",
-          depends: ["appKey"],
-          fetch: async (sdk: any, resolvedParams: any) => {
-            // Get auths for the specific app (owned auths will be prioritized automatically)
-            return await sdk.auths.list({
-              appKey: resolvedParams.appKey,
-              limit: 1000,
-            });
-          },
-          prompt: (auths: any[], params: any) => ({
-            type: "list",
-            name: "authId",
-            message: `Select authentication for ${params.appKey}:`,
-            choices: [
-              ...auths.map((auth) => ({
-                name: `${auth.title || auth.label || "Authentication"} (ID: ${auth.id})`,
-                value: auth.id,
-              })),
-              {
-                name: "↗ Skip authentication (may fail)",
-                value: null,
-              },
-            ],
-          }),
-        },
-      },
-    ),
-    output: z
-      .string()
-      .optional()
-      .describe("Output file path (defaults to generated/<appKey>.ts)"),
-    debug: z
-      .boolean()
-      .default(false)
-      .describe("Enable debug logging during generation"),
-  })
-  .describe("Generate TypeScript SDK code for a specific app");
-
-export const BundleSchema = z
-  .object({
-    input: z.string().min(1).describe("Input TypeScript file path to bundle"),
-    output: z
-      .string()
-      .optional()
-      .describe("Output file path (defaults to input with .js extension)"),
-    string: z
-      .boolean()
-      .default(false)
-      .describe("Return bundled code as string instead of writing to file"),
-    minify: z.boolean().default(false).describe("Minify the bundled output"),
-    target: z.string().default("es2020").describe("ECMAScript target version"),
-    cjs: z
-      .boolean()
-      .default(false)
-      .describe("Output CommonJS format instead of ESM"),
-  })
-  .describe("Bundle TypeScript code into executable JavaScript");
-
-// ============================================================================
-// SDK Schema Collection
-// ============================================================================
-
-export const SdkSchemas = {
-  apps: {
-    list: AppsListSchema,
-    get: AppsGetSchema,
-  },
-  actions: {
-    list: ActionsListSchema,
-    get: ActionsGetSchema,
-    run: ActionsRunSchema,
-  },
-  auths: {
-    list: AuthsListSchema,
-    find: AuthsFindSchema,
-  },
-  fields: {
-    list: FieldsListSchema,
-  },
-  // Root namespace tools
-  generate: GenerateSchema,
-  bundle: BundleSchema,
-} as const;
-
-// ============================================================================
-// Inferred Types
-// ============================================================================
-
-export type AppsListOptions = z.infer<typeof AppsListSchema>;
-export type AppsGetOptions = z.infer<typeof AppsGetSchema>;
-
-export type ActionsListOptions = z.infer<typeof ActionsListSchema>;
-export type ActionsGetOptions = z.infer<typeof ActionsGetSchema>;
-export type ActionsRunOptions = z.infer<typeof ActionsRunSchema>;
-
-export type AuthsListOptions = z.infer<typeof AuthsListSchema>;
-export type AuthsFindOptions = z.infer<typeof AuthsFindSchema>;
-
-export type FieldsListOptions = z.infer<typeof FieldsListSchema>;
-
-export type GenerateOptions = z.infer<typeof GenerateSchema>;
-export type BundleOptions = z.infer<typeof BundleSchema>;
-
-// ============================================================================
-// Schema Utilities
-// ============================================================================
-
-export function getSchemaDescription(schema: z.ZodSchema): string | undefined {
-  return schema.description;
-}
-
-export function getFieldDescriptions(
-  schema: z.ZodObject<any>,
-): Record<string, string> {
-  const descriptions: Record<string, string> = {};
-  const shape = schema.shape;
-
-  for (const [key, fieldSchema] of Object.entries(shape)) {
-    if (fieldSchema instanceof z.ZodType && fieldSchema.description) {
-      descriptions[key] = fieldSchema.description;
-    }
-  }
-
-  return descriptions;
-}