@zapier/zapier-sdk 0.64.0 → 0.67.0

package/dist/utils/schema-utils.d.ts

@@ -1,211 +0,0 @@
-import { z } from "zod";
-import type { ZapierSdk } from "../sdk";
-export interface FormattedItem {
-    title: string;
-    id?: string;
-    key?: string;
-    keys?: string[];
-    description?: string;
-    data?: unknown;
-    details: Array<{
-        label?: string;
-        text: string;
-        style: "normal" | "dim" | "accent" | "warning" | "success";
-    }>;
-}
-export interface FormatMetadata<TItem = unknown> {
-    format: (item: TItem) => FormattedItem;
-}
-export interface OutputFormatter<TItem = unknown, TParams = Record<string, unknown>, TContext = unknown> {
-    fetch?: (sdk: ZapierSdk, params: TParams, item: TItem, context: TContext | undefined) => Promise<TContext>;
-    format: (item: TItem, context?: TContext) => FormattedItem;
-}
-export declare function withFormatter<T extends z.ZodType>(schema: T, formatMeta: FormatMetadata<z.infer<T>>): T;
-export declare function getOutputSchema(inputSchema: z.ZodType): z.ZodType | undefined;
-export declare function withOutputSchema<T extends z.ZodType>(inputSchema: T, outputSchema: z.ZodType): T & {
-    _def: T["_def"] & {
-        outputSchema: z.ZodType;
-    };
-};
-export interface PromptConfig {
-    type: "list" | "checkbox" | "confirm";
-    name: string;
-    message: string;
-    choices?: Array<{
-        name: string;
-        value: unknown;
-        /**
-         * Optional secondary info shown after `name`. The CLI wraps it in
-         * dimmed parens; an array is joined with ", ". Use for keys, ids, or
-         * other context that's useful but shouldn't compete visually with
-         * the primary label.
-         */
-        hint?: string | string[];
-    }>;
-    default?: unknown;
-    filter?: (value: unknown) => unknown;
-    /**
-     * Return `true` for valid; a string for a custom invalid message; or
-     * `false` for invalid with a generic fallback message ("X: invalid
-     * value."). Prefer returning a string so users see something specific.
-     */
-    validate?: (value: unknown) => boolean | string;
-}
-/** A PromptConfig narrowed to single-select list mode. */
-export type ListPromptConfig = PromptConfig & {
-    type: "list";
-};
-export interface Resolver {
-    type: string;
-    depends?: readonly string[] | string[];
-}
-export interface StaticResolver extends Resolver {
-    type: "static";
-    inputType?: "text" | "password" | "email";
-    placeholder?: string;
-}
-/**
- * A resolver that always resolves to a fixed value, never prompts. Use to
- * pin an implicit parameter that downstream resolvers or SDK calls require
- * but the user shouldn't have to provide. Triggers, for example, are always
- * `actionType: "read"` from the SDK's perspective; createTriggerInbox
- * declares `actionType: { type: "constant", value: "read" }` so the
- * standard `actionKeyResolver` and `inputsResolver` (which depend on
- * `actionType`) work without any pinned variants.
- *
- * Constants attached to keys that aren't in the schema are seeded into
- * `resolvedParams` upfront, so dependent resolvers find them in context
- * without the key appearing in the user-facing surface (TS option type,
- * CLI flags, generated docs).
- */
-export interface ConstantResolver extends Resolver {
-    type: "constant";
-    value: unknown;
-}
-/**
- * Fields shared by both variants of {@link DynamicResolver}.
- */
-interface DynamicResolverBase<TItem, TParams> extends Resolver {
-    type: "dynamic";
-    prompt: (items: TItem[], params: TParams) => PromptConfig;
-    /** Capabilities that expand results. The parameter resolver shows a hint for any that aren't enabled. */
-    requireCapabilities?: string[];
-    /**
-     * Optional hook called before fetch/prompt. If it returns a non-null object,
-     * resolvedValue is used directly and fetch/prompt are skipped entirely. Return
-     * null to fall through to the normal resolution flow. Implementations should
-     * catch their own errors and return null on failure rather than throwing, so
-     * that a transient API error does not block the CLI entirely.
-     */
-    tryResolveWithoutPrompt?: (sdk: ZapierSdk, params: TParams) => Promise<{
-        resolvedValue: unknown;
-    } | null>;
-}
-/**
- * The classic dynamic-resolver variant: `fetch` returns a list of items
- * that the CLI renders as a search-filterable dropdown. The user picks one.
- */
-export interface DynamicListResolver<TItem, TParams> extends DynamicResolverBase<TItem, TParams> {
-    /** Explicitly absent on the list variant — set `inputType: "search"` to opt into the search variant. */
-    inputType?: never;
-    /** Only meaningful for the search variant; set to `never` here so TS catches misuse. */
-    placeholder?: never;
-    fetch: (sdk: ZapierSdk, resolvedParams: TParams) => PromiseLike<TItem[] | {
-        data: TItem[];
-        nextCursor?: string;
-    } | AsyncIterable<{
-        data: TItem[];
-        nextCursor?: string;
-    }>>;
-}
-/**
- * The search-input variant: the CLI prompts the user for free-form text
- * first, then calls `fetch` with `{ ...resolvedParams, search }`.
- *
- * `fetch` can short-circuit by returning a primitive (`string | number`),
- * which the CLI treats as an exact match — no dropdown is rendered. Any
- * other return (array, page, async iterable) is rendered as the normal
- * search-filterable dropdown.
- *
- * The `search` key is injected by the CLI at call time; it isn't part of
- * `TParams` because callers that invoke `fetch` directly (outside the CLI)
- * are responsible for passing it themselves. Search-mode resolvers should
- * type `TParams` as `{ search?: string; ...otherDeps }` to make this
- * explicit.
- */
-export interface DynamicSearchResolver<TItem, TParams> extends Omit<DynamicResolverBase<TItem, TParams>, "prompt"> {
-    inputType: "search";
-    /**
-     * Hint text appended to the search prompt's message. NOT used as
-     * inquirer's `default` value, because inquirer prefills `default` as
-     * editable text that the user has to delete before typing.
-     */
-    placeholder?: string;
-    /**
-     * Search-mode always renders a single-select @inquirer/search dropdown,
-     * so `prompt` must return a list-typed PromptConfig. Checkbox/confirm
-     * configs would be silently ignored at runtime; the type narrows so
-     * misuse fails at compile time.
-     *
-     * Note: a primitive return from `fetch` (string | number) is treated
-     * as an exact match and short-circuits without running this prompt or
-     * the resolver's validate/filter. Canonicalize inside `fetch` if the
-     * exact-match path needs normalization.
-     */
-    prompt: (items: TItem[], params: TParams) => ListPromptConfig;
-    fetch: (sdk: ZapierSdk, resolvedParams: TParams) => PromiseLike<string | number | TItem[] | {
-        data: TItem[];
-        nextCursor?: string;
-    } | AsyncIterable<{
-        data: TItem[];
-        nextCursor?: string;
-    }>>;
-}
-/**
- * A dynamic resolver — either a classic list (`inputType` absent) or a
- * search-input variant (`inputType: "search"`). The discriminator is the
- * `inputType` field; TS narrows to the right variant when you check it.
- */
-export type DynamicResolver<TItem = unknown, TParams = Record<string, unknown>> = DynamicListResolver<TItem, TParams> | DynamicSearchResolver<TItem, TParams>;
-export interface ResolverFieldItem {
-    type: string;
-    key: string;
-    title?: string;
-    is_required?: boolean;
-    value_type?: string;
-    choices?: Array<{
-        label: string;
-        value: string;
-    }>;
-    fields?: ResolverFieldItem[];
-    resolver?: ResolverMetadata<any, any>;
-}
-export interface FieldsResolver<TParams = Record<string, unknown>, TResult = Record<string, unknown>> extends Resolver {
-    type: "fields";
-    fetch: (sdk: ZapierSdk, resolvedParams: TParams) => Promise<ResolverFieldItem[]>;
-    transform?: (value: Record<string, unknown>) => TResult;
-}
-export interface ArrayResolver<TParams = Record<string, unknown>> extends Resolver {
-    type: "array";
-    fetch: (sdk: ZapierSdk, resolvedParams: TParams) => Promise<ResolverMetadata<unknown, TParams>>;
-    minItems?: number;
-    maxItems?: number;
-}
-export type ResolverMetadata<TItem = unknown, TParams = Record<string, unknown>> = StaticResolver | ConstantResolver | DynamicResolver<TItem, TParams> | FieldsResolver<TParams> | ArrayResolver<TParams>;
-export interface ResolverConfig<TItem = unknown, TParams = Record<string, unknown>> {
-    resolver: ResolverMetadata<TItem, TParams>;
-}
-export declare function withResolver<T extends z.ZodType, TItem = unknown, TParams = Record<string, unknown>>(schema: T, config: ResolverConfig<TItem, TParams>): T;
-export declare function getSchemaDescription(schema: z.ZodSchema): string | undefined;
-export declare function getFieldDescriptions(schema: z.ZodObject<z.ZodRawShape>): Record<string, string>;
-export interface PositionalMetadata {
-    positionalMeta: {
-        positional: true;
-    };
-}
-export declare function withPositional<T extends z.ZodType>(schema: T): T & {
-    _def: T["_def"] & PositionalMetadata;
-};
-export declare function isPositional(schema: z.ZodType): boolean;
-export {};
-//# sourceMappingURL=schema-utils.d.ts.map

package/dist/utils/schema-utils.d.ts.map

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

package/dist/utils/schema-utils.js

@@ -1,72 +0,0 @@
-import { z } from "zod";
-// Helper function to add format metadata to schemas
-export function withFormatter(schema, formatMeta) {
-    // Store format metadata on the schema definition
-    Object.assign(schema._zod.def, {
-        formatMeta: formatMeta,
-    });
-    return schema;
-}
-// Helper function to get output schema from an input schema
-export function getOutputSchema(inputSchema) {
-    return inputSchema._zod.def.outputSchema;
-}
-// Helper function to link input schemas to output schemas
-export function withOutputSchema(inputSchema, outputSchema) {
-    // Store output schema reference on the input schema
-    Object.assign(inputSchema._zod.def, {
-        outputSchema,
-    });
-    return inputSchema;
-}
-// Helper function to add resolver metadata to schemas
-export function withResolver(schema, config) {
-    // Store resolver metadata on the schema definition
-    schema._zod.def.resolverMeta = config;
-    return schema;
-}
-// ============================================================================
-// Schema Description Utilities
-// ============================================================================
-export function getSchemaDescription(schema) {
-    return schema.description;
-}
-export function getFieldDescriptions(schema) {
-    const descriptions = {};
-    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;
-}
-// Helper function to mark a parameter as positional for CLI
-export function withPositional(schema) {
-    // Store positional metadata on the schema definition
-    Object.assign(schema._zod.def, {
-        positionalMeta: { positional: true },
-    });
-    return schema;
-}
-function schemaHasPositionalMeta(schema) {
-    return "positionalMeta" in schema._zod.def;
-}
-// Helper function to check if a parameter should be positional
-export function isPositional(schema) {
-    // Check the current schema first
-    if (schemaHasPositionalMeta(schema) &&
-        schema._zod.def
-            .positionalMeta?.positional) {
-        return true;
-    }
-    // If this is a ZodOptional, check the inner type
-    if (schema instanceof z.ZodOptional) {
-        return isPositional(schema._zod.def.innerType);
-    }
-    // If this is a ZodDefault, check the inner type
-    if (schema instanceof z.ZodDefault) {
-        return isPositional(schema._zod.def.innerType);
-    }
-    return false;
-}

package/dist/utils/string-utils.d.ts

@@ -1,40 +0,0 @@
-/**
- * String utility functions for the Zapier SDK
- */
-/**
- * Converts a string to title case, handling various input formats:
- * - camelCase: "firstName" → "First Name"
- * - snake_case: "first_name" → "First Name"
- * - kebab-case: "first-name" → "First Name"
- * - mixed formats: "first_name-value" → "First Name Value"
- */
-export declare function toTitleCase(input: string): string;
-/**
- * Converts a string to snake_case, handling various input formats:
- * - camelCase: "firstName" → "first_name"
- * - kebab-case: "first-name" → "first_name"
- * - title case: "First Name" → "first_name"
- * - mixed formats: "first-Name Value" → "first_name_value"
- * - starts with number: "123abc" → "_123abc"
- */
-export declare function toSnakeCase(input: string): string;
-/**
- * Strips the "Page" suffix from a function name, used for deriving method names
- * from paginated function implementations.
- *
- * This is commonly used with `createPaginatedFunction` where the internal function
- * has a "Page" suffix (e.g., "listAppsPage") but the public method name should not
- * (e.g., "listApps").
- *
- * @param functionName - The function name, typically from `function.name`
- * @returns The function name with "Page" suffix removed, or original if no suffix
- *
- * @example
- * ```typescript
- * stripPageSuffix("listAppsPage") // "listApps"
- * stripPageSuffix("listApps") // "listApps" (no change)
- * stripPageSuffix("myPageFunction") // "myPageFunction" (only strips from end)
- * ```
- */
-export declare function stripPageSuffix(functionName: string): string;
-//# sourceMappingURL=string-utils.d.ts.map

package/dist/utils/string-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcjD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBjD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/utils/string-utils.js

@@ -1,69 +0,0 @@
-/**
- * String utility functions for the Zapier SDK
- */
-/**
- * Converts a string to title case, handling various input formats:
- * - camelCase: "firstName" → "First Name"
- * - snake_case: "first_name" → "First Name"
- * - kebab-case: "first-name" → "First Name"
- * - mixed formats: "first_name-value" → "First Name Value"
- */
-export function toTitleCase(input) {
-    return (input
-        // insert a space before capital letters (handles camelCase)
-        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
-        // replace delimiters (underscore, dash, multiple spaces) with single space
-        .replace(/[_\-]+/g, " ")
-        .replace(/\s+/g, " ")
-        .trim()
-        // split and capitalize each word
-        .split(" ")
-        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
-        .join(" "));
-}
-/**
- * Converts a string to snake_case, handling various input formats:
- * - camelCase: "firstName" → "first_name"
- * - kebab-case: "first-name" → "first_name"
- * - title case: "First Name" → "first_name"
- * - mixed formats: "first-Name Value" → "first_name_value"
- * - starts with number: "123abc" → "_123abc"
- */
-export function toSnakeCase(input) {
-    let result = input
-        // insert underscore before capital letters (handles camelCase)
-        .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
-        // replace spaces and dashes with underscores
-        .replace(/[\s\-]+/g, "_")
-        // replace multiple underscores with single underscore
-        .replace(/_+/g, "_")
-        // remove leading/trailing underscores and convert to lowercase
-        .replace(/^_|_$/g, "")
-        .toLowerCase();
-    // If the result starts with a number, prefix with underscore
-    if (/^[0-9]/.test(result)) {
-        result = "_" + result;
-    }
-    return result;
-}
-/**
- * Strips the "Page" suffix from a function name, used for deriving method names
- * from paginated function implementations.
- *
- * This is commonly used with `createPaginatedFunction` where the internal function
- * has a "Page" suffix (e.g., "listAppsPage") but the public method name should not
- * (e.g., "listApps").
- *
- * @param functionName - The function name, typically from `function.name`
- * @returns The function name with "Page" suffix removed, or original if no suffix
- *
- * @example
- * ```typescript
- * stripPageSuffix("listAppsPage") // "listApps"
- * stripPageSuffix("listApps") // "listApps" (no change)
- * stripPageSuffix("myPageFunction") // "myPageFunction" (only strips from end)
- * ```
- */
-export function stripPageSuffix(functionName) {
-    return functionName.replace(/Page$/, "");
-}

package/dist/utils/telemetry-context.d.ts

@@ -1,15 +0,0 @@
-/**
- * Async-local storage context for per-invocation telemetry state. Each top-level
- * SDK method call runs in its own ALS scope (via runWithTelemetryContext), isolating
- * its depth counter and method metadata from concurrent calls.
- */
-export interface MethodMetadata {
-    selectedApi?: string | null;
-    operationType?: string | null;
-    operationKey?: string | null;
-}
-export declare function isTelemetryNested(): boolean;
-export declare function runWithTelemetryContext<T>(fn: () => T): T;
-export declare function setMethodMetadata(metadata: MethodMetadata): void;
-export declare function getMethodMetadata(): MethodMetadata | undefined;
-//# sourceMappingURL=telemetry-context.d.ts.map

package/dist/utils/telemetry-context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"telemetry-context.d.ts","sourceRoot":"","sources":["../../src/utils/telemetry-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAwBD,wBAAgB,iBAAiB,IAAI,OAAO,CAI3C;AAED,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAIzD;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAKhE;AAED,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAG9D"}

package/dist/utils/telemetry-context.js

@@ -1,48 +0,0 @@
-/**
- * Async-local storage context for per-invocation telemetry state. Each top-level
- * SDK method call runs in its own ALS scope (via runWithTelemetryContext), isolating
- * its depth counter and method metadata from concurrent calls.
- */
-import { AsyncLocalStorage, } from "node:async_hooks";
-// Static import of `AsyncLocalStorage` works in both CJS and ESM tsup bundles
-// because tsup converts the import statement directly (to `require()` in CJS,
-// kept as native `import` in ESM), bypassing the `__require` shim that
-// silently broke the previous `require("node:async_hooks")` pattern in ESM —
-// the bug that left ESM consumers (notably the CLI) without a telemetry
-// store and dropped nested-call detection on every call.
-//
-// Browsers can't resolve `node:async_hooks` at bundle time; consumers who
-// bundle the SDK for browsers need to mark this module external or polyfill
-// it. The try/catch covers any other instantiation failure.
-let telemetryStore = null;
-try {
-    telemetryStore = new AsyncLocalStorage();
-}
-catch {
-    // Non-Node environment (browser, etc.) — telemetry context disabled.
-}
-export function isTelemetryNested() {
-    if (!telemetryStore)
-        return true;
-    const store = telemetryStore.getStore();
-    return store !== undefined && store.depth > 0;
-}
-export function runWithTelemetryContext(fn) {
-    if (!telemetryStore)
-        return fn();
-    const currentDepth = telemetryStore.getStore()?.depth ?? -1;
-    return telemetryStore.run({ depth: currentDepth + 1 }, fn);
-}
-export function setMethodMetadata(metadata) {
-    if (!telemetryStore)
-        return;
-    const store = telemetryStore.getStore();
-    if (!store)
-        return;
-    store.methodMetadata = { ...store.methodMetadata, ...metadata };
-}
-export function getMethodMetadata() {
-    if (!telemetryStore)
-        return undefined;
-    return telemetryStore.getStore()?.methodMetadata;
-}

package/dist/utils/telemetry-utils.d.ts

@@ -1,44 +0,0 @@
-import type { TelemetryCallbacks } from "./function-utils";
-import type { EventEmissionContext } from "../plugins/eventEmission";
-/**
- * Creates a standardized telemetry callback for SDK method invocations.
- *
- * This factory eliminates boilerplate by providing a consistent implementation
- * of the onMethodCalled callback used by createFunction and createPaginatedFunction.
- *
- * @param emitMethodCalled - The event emission function from EventEmissionContext
- * @param methodName - The method name to report in telemetry. Use `function.name` to derive
- *   this automatically from the function declaration, ensuring DRY principles and making
- *   refactoring easier. Function names are preserved through bundling.
- * @returns TelemetryCallbacks object with standardized onMethodCalled implementation
- *
- * @example
- * Basic usage with createFunction:
- * ```typescript
- * async function listApps(options: ListAppsOptions) { ... }
- *
- * const listAppsDefinition = createFunction(
- *   listApps,
- *   ListAppsSchema,
- *   createTelemetryCallback(context.eventEmission.emitMethodCalled, listApps.name),
- * );
- * ```
- *
- * @example
- * For paginated functions, use stripPageSuffix to remove the "Page" suffix:
- * ```typescript
- * import { stripPageSuffix } from "./string-utils";
- *
- * async function listAppsPage(options: ListAppsOptions & { pageSize: number }) { ... }
- *
- * const methodName = stripPageSuffix(listAppsPage.name);
- * const listAppsDefinition = createPaginatedFunction(
- *   listAppsPage,
- *   ListAppsSchema,
- *   createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
- *   methodName,
- * );
- * ```
- */
-export declare function createTelemetryCallback(emitMethodCalled: EventEmissionContext["eventEmission"]["emitMethodCalled"], methodName: string): TelemetryCallbacks;
-//# sourceMappingURL=telemetry-utils.d.ts.map

package/dist/utils/telemetry-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"telemetry-utils.d.ts","sourceRoot":"","sources":["../../src/utils/telemetry-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,uBAAuB,CACrC,gBAAgB,EAAE,oBAAoB,CAAC,eAAe,CAAC,CAAC,kBAAkB,CAAC,EAC3E,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAkBpB"}

package/dist/utils/telemetry-utils.js

@@ -1,60 +0,0 @@
-import { getMethodMetadata } from "./telemetry-context";
-/**
- * Creates a standardized telemetry callback for SDK method invocations.
- *
- * This factory eliminates boilerplate by providing a consistent implementation
- * of the onMethodCalled callback used by createFunction and createPaginatedFunction.
- *
- * @param emitMethodCalled - The event emission function from EventEmissionContext
- * @param methodName - The method name to report in telemetry. Use `function.name` to derive
- *   this automatically from the function declaration, ensuring DRY principles and making
- *   refactoring easier. Function names are preserved through bundling.
- * @returns TelemetryCallbacks object with standardized onMethodCalled implementation
- *
- * @example
- * Basic usage with createFunction:
- * ```typescript
- * async function listApps(options: ListAppsOptions) { ... }
- *
- * const listAppsDefinition = createFunction(
- *   listApps,
- *   ListAppsSchema,
- *   createTelemetryCallback(context.eventEmission.emitMethodCalled, listApps.name),
- * );
- * ```
- *
- * @example
- * For paginated functions, use stripPageSuffix to remove the "Page" suffix:
- * ```typescript
- * import { stripPageSuffix } from "./string-utils";
- *
- * async function listAppsPage(options: ListAppsOptions & { pageSize: number }) { ... }
- *
- * const methodName = stripPageSuffix(listAppsPage.name);
- * const listAppsDefinition = createPaginatedFunction(
- *   listAppsPage,
- *   ListAppsSchema,
- *   createTelemetryCallback(context.eventEmission.emitMethodCalled, methodName),
- *   methodName,
- * );
- * ```
- */
-export function createTelemetryCallback(emitMethodCalled, methodName) {
-    return {
-        onMethodCalled: (data) => {
-            const metadata = getMethodMetadata();
-            emitMethodCalled({
-                method_name: methodName,
-                execution_duration_ms: data.durationMs,
-                success_flag: data.success,
-                error_message: data.error?.message ?? null,
-                error_type: data.error?.constructor.name ?? null,
-                argument_count: data.argumentCount,
-                is_paginated: data.isPaginated,
-                selected_api: metadata?.selectedApi ?? null,
-                operation_type: metadata?.operationType ?? null,
-                operation_key: metadata?.operationKey ?? null,
-            });
-        },
-    };
-}

package/dist/utils/validation.d.ts

@@ -1,4 +0,0 @@
-import type { z } from "zod";
-export declare function createValidator<TSchema extends z.ZodSchema>(schema: TSchema): (input: unknown) => z.infer<TSchema>;
-export declare const validateOptions: <TOptions, TSchemaOptions extends TOptions>(schema: z.ZodSchema<TSchemaOptions>, options: TOptions) => TSchemaOptions;
-//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgC7B,wBAAgB,eAAe,CAAC,OAAO,SAAS,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,IAC/C,OAAO,OAAO,KAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAG7D;AAED,eAAO,MAAM,eAAe,GAAI,QAAQ,EAAE,cAAc,SAAS,QAAQ,EACvE,QAAQ,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,EACnC,SAAS,QAAQ,mBAGlB,CAAC"}

package/dist/utils/validation.js

@@ -1,30 +0,0 @@
-import { ZapierValidationError } from "../types/errors";
-/**
- * Throws clean ZapierValidationError on validation failures
- */
-const validate = (schema, input) => {
-    const result = schema.safeParse(input);
-    if (!result.success) {
-        // Format Zod errors into a clean, user-friendly message
-        const errorMessages = result.error.issues.map((error) => {
-            const path = error.path.length > 0 ? error.path.join(".") : "input";
-            return `${path}: ${error.message}`;
-        });
-        const message = `Validation failed:\n  ${errorMessages.join("\n  ")}`;
-        throw new ZapierValidationError(message, {
-            details: {
-                zodErrors: result.error.issues,
-                input,
-            },
-        });
-    }
-    return result.data;
-};
-export function createValidator(schema) {
-    return function validateFn(input) {
-        return validate(schema, input);
-    };
-}
-export const validateOptions = (schema, options) => {
-    return validate(schema, options);
-};