@zapier/zapier-sdk 0.42.0 → 0.43.0

package/dist/sdk.d.ts

@@ -1,265 +1,37 @@
-import type { BaseSdkOptions } from "./types/sdk";
-import type { ZapierSdk } from "./types/sdk";
-import type { Sdk, Plugin, ExtractContextProperties, ExtractSdkProperties, PluginProvides, PluginMeta } from "./types/plugin";
+import type { BaseSdkOptions, ZapierSdk } from "./types/sdk";
+import type { WithAddPlugin, Plugin, PluginProvides, PluginMeta } from "./types/plugin";
 export interface ZapierSdkOptions extends BaseSdkOptions {
 }
-export declare function createSdk<TCurrentSdk = {}, TCurrentContext extends {
-    meta: Record<string, PluginMeta>;
-} = {
-    meta: Record<string, PluginMeta>;
-}>(options?: ZapierSdkOptions, initialSdk?: TCurrentSdk, initialContext?: TCurrentContext): TCurrentSdk & {
-    getContext: () => TCurrentContext;
-    addPlugin<TRequiresContext, TProvides extends PluginProvides>(plugin: Plugin<TCurrentSdk & {
-        getContext(): TCurrentContext;
-    }, TRequiresContext, TProvides>, addPluginOptions?: Record<string, unknown>): Sdk<TCurrentSdk & ExtractSdkProperties<TProvides>, TCurrentContext & NonNullable<ExtractContextProperties<TProvides>>>;
-};
-export declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): Sdk<ExtractSdkProperties<import("./plugins/eventEmission").EventEmissionProvides> & ExtractSdkProperties<import(".").ApiPluginProvides> & ExtractSdkProperties<import(".").ManifestPluginProvides> & ExtractSdkProperties<import("./plugins/capabilities").CapabilitiesPluginProvides> & ExtractSdkProperties<import(".").ConnectionsPluginProvides> & ExtractSdkProperties<import(".").ListAppsPluginProvides> & ExtractSdkProperties<import(".").GetAppPluginProvides> & ExtractSdkProperties<import(".").ListActionsPluginProvides> & ExtractSdkProperties<import(".").GetActionPluginProvides> & ExtractSdkProperties<import(".").ListInputFieldsPluginProvides> & ExtractSdkProperties<import("./plugins/getInputFieldsSchema").GetInputFieldsSchemaPluginProvides> & ExtractSdkProperties<import("./plugins/listInputFieldChoices").ListInputFieldChoicesPluginProvides> & ExtractSdkProperties<import(".").RunActionPluginProvides> & ExtractSdkProperties<import(".").ListConnectionsPluginProvides> & ExtractSdkProperties<import(".").GetConnectionPluginProvides> & ExtractSdkProperties<import(".").FindFirstConnectionPluginProvides> & ExtractSdkProperties<import(".").FindUniqueConnectionPluginProvides> & ExtractSdkProperties<import(".").ListAuthenticationsPluginProvides> & ExtractSdkProperties<import(".").GetAuthenticationPluginProvides> & ExtractSdkProperties<import(".").FindFirstAuthenticationPluginProvides> & ExtractSdkProperties<import(".").FindUniqueAuthenticationPluginProvides> & ExtractSdkProperties<import(".").ListClientCredentialsPluginProvides> & ExtractSdkProperties<import(".").CreateClientCredentialsPluginProvides> & ExtractSdkProperties<import(".").DeleteClientCredentialsPluginProvides> & ExtractSdkProperties<import(".").FetchPluginProvides> & ExtractSdkProperties<import(".").RequestPluginProvides> & ExtractSdkProperties<import(".").ListTablesPluginProvides> & ExtractSdkProperties<import(".").GetTablePluginProvides> & ExtractSdkProperties<import(".").DeleteTablePluginProvides> & ExtractSdkProperties<import(".").CreateTablePluginProvides> & ExtractSdkProperties<import(".").ListTableFieldsPluginProvides> & ExtractSdkProperties<import(".").CreateTableFieldsPluginProvides> & ExtractSdkProperties<import(".").DeleteTableFieldsPluginProvides> & ExtractSdkProperties<import(".").GetTableRecordPluginProvides> & ExtractSdkProperties<import(".").ListTableRecordsPluginProvides> & ExtractSdkProperties<import(".").CreateTableRecordsPluginProvides> & ExtractSdkProperties<import(".").DeleteTableRecordsPluginProvides> & ExtractSdkProperties<import(".").UpdateTableRecordsPluginProvides> & ExtractSdkProperties<import(".").AppsPluginProvides> & ExtractSdkProperties<import(".").GetProfilePluginProvides>, {
-    meta: Record<string, PluginMeta>;
-} & import(".").EventEmissionContext & {
-    api: import("./api").ApiClient;
-    resolveCredentials: () => Promise<import("./auth").ResolvedCredentials | undefined>;
-} & {
-    getResolvedManifest: () => Promise<import(".").Manifest | null>;
-    getVersionedImplementationId: import("./plugins/manifest/schemas").GetVersionedImplementationId;
-    resolveAppKeys: import("./plugins/manifest/schemas").ResolveAppKeys;
-    getManifestConnections: () => Promise<import(".").ConnectionsMap | null>;
-    updateManifestEntry: (options: import(".").UpdateManifestEntryOptions) => Promise<import(".").UpdateManifestEntryResult>;
-    addActionEntry: (options: import(".").AddActionEntryOptions) => Promise<import(".").AddActionEntryResult>;
-    findActionEntry: (options: {
-        name: string;
-        manifest: import(".").Manifest;
-    }) => import(".").ActionEntry | null;
-    listActionEntries: (options?: {
-        configPath?: string;
-    }) => Promise<Array<[string, import(".").ActionEntry]>>;
-    deleteActionEntry: (options: {
-        name: string;
-        configPath?: string;
-        skipWrite?: boolean;
-    }) => Promise<import(".").Manifest>;
-    hasActionEntry: (options: {
-        name: string;
-        manifest: import(".").Manifest;
-    }) => boolean;
-    findManifestEntry: (options: {
-        appKey: string;
-        manifest: import(".").Manifest;
-    }) => [string, import(".").ManifestEntry] | null;
-    readManifestFromFile: (filePath: string) => Promise<import(".").Manifest | null>;
-} & import("./plugins/capabilities").CapabilitiesContext & {
-    resolveConnection: (name: string) => Promise<import(".").ConnectionEntry | undefined>;
-    getConnectionsMap: () => Promise<import(".").ConnectionsMap | null>;
-} & {
-    meta: {
-        listApps: {
-            inputSchema: typeof import("./plugins/listApps/schemas").ListAppsSchema;
-        };
-    };
-} & {
-    meta: {
-        getApp: {
-            inputSchema: typeof import("./plugins/getApp/schemas").GetAppSchema;
-        };
-    };
-} & {
-    meta: {
-        listActions: {
-            inputSchema: typeof import("./plugins/listActions/schemas").ListActionsSchema;
-        };
-    };
-} & {
-    meta: {
-        getAction: {
-            inputSchema: typeof import("./plugins/getAction/schemas").GetActionSchema;
-        };
-    };
-} & {
-    meta: {
-        listInputFields: {
-            inputSchema: typeof import("./plugins/listInputFields/schemas").ListInputFieldsSchema;
-        };
-    };
-} & {
-    meta: {
-        getInputFieldsSchema: {
-            inputSchema: typeof import("./plugins/getInputFieldsSchema/schemas").GetInputFieldsSchemaSchema;
-        };
-    };
-} & {
-    meta: {
-        listInputFieldChoices: {
-            inputSchema: typeof import("./plugins/listInputFieldChoices/schemas").ListInputFieldChoicesSchema;
-        };
-    };
-} & {
-    meta: {
-        runAction: {
-            inputSchema: typeof import("./plugins/runAction/schemas").RunActionSchema;
-        };
-    };
-} & {
-    meta: {
-        listConnections: {
-            inputSchema: typeof import("./plugins/listConnections/schemas").ListConnectionsQuerySchema;
-        };
-    };
-} & {
-    meta: {
-        getConnection: {
-            inputSchema: typeof import("./plugins/getConnection/schemas").GetConnectionParamSchema;
-        };
-    };
-} & {
-    meta: {
-        findFirstConnection: {
-            inputSchema: typeof import("./plugins/findFirstConnection/schemas").FindFirstConnectionSchema;
-        };
-    };
-} & {
-    meta: {
-        findUniqueConnection: {
-            inputSchema: typeof import("./plugins/findUniqueConnection/schemas").FindUniqueConnectionSchema;
-        };
-    };
-} & {
-    meta: {
-        listAuthentications: {
-            inputSchema: typeof import("./plugins/listConnections/schemas").ListConnectionsQuerySchema;
-        };
-    };
-} & {
-    meta: {
-        getAuthentication: {
-            inputSchema: typeof import("./plugins/getConnection/schemas").GetConnectionParamSchema;
-        };
-    };
-} & {
-    meta: {
-        findFirstAuthentication: {
-            inputSchema: typeof import("./plugins/findFirstConnection/schemas").FindFirstConnectionSchema;
-        };
-    };
-} & {
-    meta: {
-        findUniqueAuthentication: {
-            inputSchema: typeof import("./plugins/findUniqueConnection/schemas").FindUniqueConnectionSchema;
-        };
-    };
-} & {
-    meta: {
-        listClientCredentials: {
-            inputSchema: typeof import("./plugins/listClientCredentials/schemas").ListClientCredentialsQuerySchema;
-        };
-    };
-} & {
-    meta: {
-        createClientCredentials: {
-            inputSchema: typeof import("./plugins/createClientCredentials/schemas").CreateClientCredentialsSchema;
-        };
-    };
-} & {
-    meta: {
-        deleteClientCredentials: {
-            inputSchema: typeof import("./plugins/deleteClientCredentials/schemas").DeleteClientCredentialsSchema;
-        };
-    };
-} & {
-    meta: {
-        fetch: {
-            description: string;
-            packages: string[];
-            categories: string[];
-            returnType: string;
-            inputParameters: Array<{
-                name: string;
-                schema: import("zod").ZodType;
-            }>;
-        };
-    };
-} & {
-    meta: {
-        request: {
-            inputSchema: typeof import(".").RelayRequestSchema;
-        };
+export declare function createOptionsPlugin(options: ZapierSdkOptions): () => {
+    context: {
+        options: ZapierSdkOptions;
     };
-} & {
-    meta: {
-        listTables: {
-            inputSchema: typeof import("./plugins/tables/listTables/schemas").ListTablesOptionsSchema;
-        };
-    };
-} & {
-    meta: {
-        getTable: {
-            inputSchema: typeof import("./plugins/tables/getTable/schemas").GetTableOptionsSchema;
-        };
-    };
-} & {
-    meta: {
-        deleteTable: {
-            inputSchema: typeof import("./plugins/tables/deleteTable/schemas").DeleteTableOptionsSchema;
-        };
-    };
-} & {
-    meta: {
-        createTable: {
-            inputSchema: typeof import("./plugins/tables/createTable/schemas").CreateTableOptionsSchema;
-        };
-    };
-} & {
-    meta: {
-        listTableFields: {
-            inputSchema: typeof import("./plugins/tables/listTableFields/schemas").ListTableFieldsOptionsSchema;
-        };
-    };
-} & {
-    meta: {
-        createTableFields: {
-            inputSchema: typeof import("./plugins/tables/createTableFields/schemas").CreateTableFieldsOptionsSchema;
-        };
-    };
-} & {
-    meta: {
-        deleteTableFields: {
-            inputSchema: typeof import("./plugins/tables/deleteTableFields/schemas").DeleteTableFieldsOptionsSchema;
-        };
-    };
-} & {
-    meta: {
-        getTableRecord: {
-            inputSchema: typeof import("./plugins/tables/getTableRecord/schemas").GetTableRecordOptionsSchema;
-        };
-    };
-} & {
-    meta: {
-        listTableRecords: {
-            inputSchema: typeof import("./plugins/tables/listTableRecords/schemas").ListTableRecordsOptionsSchema;
-        };
-    };
-} & {
-    meta: {
-        createTableRecords: {
-            inputSchema: typeof import("./plugins/tables/createTableRecords/schemas").CreateTableRecordsOptionsSchema;
-        };
-    };
-} & {
-    meta: {
-        deleteTableRecords: {
-            inputSchema: typeof import("./plugins/tables/deleteTableRecords/schemas").DeleteTableRecordsOptionsSchema;
-        };
-    };
-} & {
-    meta: {
-        updateTableRecords: {
-            inputSchema: typeof import("./plugins/tables/updateTableRecords/schemas").UpdateTableRecordsOptionsSchema;
-        };
+};
+export declare function createSdk(): {
+    readonly context: Readonly<{
+        meta: Record<string, PluginMeta>;
+    }>;
+    getContext: () => Readonly<{
+        meta: Record<string, PluginMeta>;
+    }>;
+    addPlugin<TProvides extends PluginProvides>(plugin: Plugin<{
+        context: {
+            meta: Record<string, PluginMeta>;
+        };
+    }, TProvides>): WithAddPlugin<{
+        context: {
+            meta: Record<string, PluginMeta>;
+        };
+    } & TProvides>;
+};
+export declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): WithAddPlugin<{
+    context: {
+        meta: Record<string, PluginMeta>;
     };
 } & {
-    meta: {
-        getProfile: {
-            inputSchema: typeof import("./plugins/getProfile/schemas").GetProfileSchema;
-        };
+    context: {
+        options: ZapierSdkOptions;
     };
-}>;
+} & import(".").EventEmissionProvides & import(".").ApiPluginProvides & import(".").ManifestPluginProvides & import("./plugins/capabilities").CapabilitiesPluginProvides & import(".").ConnectionsPluginProvides & import(".").ListAppsPluginProvides & import(".").GetAppPluginProvides & import(".").ListActionsPluginProvides & import(".").GetActionPluginProvides & import(".").ListInputFieldsPluginProvides & import("./plugins/getInputFieldsSchema").GetInputFieldsSchemaPluginProvides & import("./plugins/listInputFieldChoices").ListInputFieldChoicesPluginProvides & import(".").RunActionPluginProvides & import(".").ListConnectionsPluginProvides & import(".").GetConnectionPluginProvides & import(".").FindFirstConnectionPluginProvides & import(".").FindUniqueConnectionPluginProvides & import(".").ListAuthenticationsPluginProvides & import(".").GetAuthenticationPluginProvides & import(".").FindFirstAuthenticationPluginProvides & import(".").FindUniqueAuthenticationPluginProvides & import(".").ListClientCredentialsPluginProvides & import(".").CreateClientCredentialsPluginProvides & import(".").DeleteClientCredentialsPluginProvides & import(".").FetchPluginProvides & import(".").RequestPluginProvides & import(".").ListTablesPluginProvides & import(".").GetTablePluginProvides & import(".").DeleteTablePluginProvides & import(".").CreateTablePluginProvides & import(".").ListTableFieldsPluginProvides & import(".").CreateTableFieldsPluginProvides & import(".").DeleteTableFieldsPluginProvides & import(".").GetTableRecordPluginProvides & import(".").ListTableRecordsPluginProvides & import(".").CreateTableRecordsPluginProvides & import(".").DeleteTableRecordsPluginProvides & import(".").UpdateTableRecordsPluginProvides & import(".").AppsPluginProvides & import(".").GetProfilePluginProvides>;
 export declare function createZapierSdk(options?: ZapierSdkOptions): ZapierSdk;
 //# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EACV,GAAG,EACH,MAAM,EACN,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,UAAU,EACX,MAAM,gBAAgB,CAAC;AAoDxB,MAAM,WAAW,gBAAiB,SAAQ,cAAc;CAAG;AAG3D,wBAAgB,SAAS,CACvB,WAAW,GAAG,EAAE,EAChB,eAAe,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAAE,GAAG;IAC7D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAClC,EAED,OAAO,GAAE,gBAAqB,EAC9B,UAAU,GAAE,WAA+B,EAC3C,cAAc,GAAE,eAAiD;;cAKrD,gBAAgB,EAAE,SAAS,SAAS,cAAc,UAClD,MAAM,CACZ,WAAW,GAAG;QAAE,UAAU,IAAI,eAAe,CAAA;KAAE,EAC/C,gBAAgB,EAChB,SAAS,CACV,qBACiB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,GAAG,CACJ,WAAW,GAAG,oBAAoB,CAAC,SAAS,CAAC,EAC7C,eAAe,GAAG,WAAW,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC,CACnE;EA8DJ;AAED,wBAAgB,8BAA8B,CAAC,OAAO,GAAE,gBAAqB;UApFnE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;;;;;;;;;;;;;;;+BAxBvB,CAAC;kBAAoB,CAAC;;;;kBAEtB,CAAC;iBAA0B,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiLvC;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAMzE"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EACV,aAAa,EACb,MAAM,EACN,cAAc,EACd,UAAU,EACX,MAAM,gBAAgB,CAAC;AAiDxB,MAAM,WAAW,gBAAiB,SAAQ,cAAc;CAAG;AAE3D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB;;;;EAE5D;AAED,wBAAgB,SAAS;;cACW,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;;;cAA1B,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;;cAmBhD,SAAS,SAAS,cAAc;;kBAnBV,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;;;;kBAA1B,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;;;EAC7D;AA0DD,wBAAgB,8BAA8B,CAAC,OAAO,GAAE,gBAAqB;;cA3DzC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;;;;;;uwDAmI7D;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAMzE"}

package/dist/sdk.js

@@ -38,63 +38,53 @@ import { manifestPlugin } from "./plugins/manifest";
 import { capabilitiesPlugin } from "./plugins/capabilities";
 import { connectionsPlugin } from "./plugins/connections";
 import { eventEmissionPlugin } from "./plugins/eventEmission";
-// Create SDK that supports flat plugins - returns an SDK, not a builder
-export function createSdk(options = {}, initialSdk = {}, initialContext = { meta: {} }) {
+export function createOptionsPlugin(options) {
+    return () => ({ context: { options } });
+}
+export function createSdk() {
+    return buildSdk({}, { meta: {} });
+}
+// context is separated from other properties because it gets frozen
+// and its meta sub-property is deep-merged across plugins
+function buildSdk(properties, context) {
+    const frozenContext = Object.freeze(context);
     return {
-        ...initialSdk,
-        getContext: () => initialContext,
-        addPlugin(plugin, addPluginOptions = {}) {
-            // Create SDK with getContext method for plugins to use
-            const currentSdkWithContext = {
-                ...initialSdk,
-                getContext: () => initialContext,
-            };
-            // Apply the plugin with options merged in
+        ...properties,
+        get context() {
+            return frozenContext;
+        },
+        getContext: () => frozenContext, // runtime compat shim, not in types
+        addPlugin(plugin) {
             const pluginResult = plugin({
-                sdk: currentSdkWithContext,
-                context: {
-                    ...initialContext,
-                    // Add the options that createSdk was called with to context
-                    options,
-                },
-                ...addPluginOptions,
+                ...properties,
+                context: frozenContext,
             });
-            // Extract context from plugin result if present
-            const { context: pluginContext, ...sdkProperties } = pluginResult;
-            // Merge SDK properties directly (flat structure)
-            const newSdk = { ...initialSdk, ...sdkProperties };
-            // Merge context additions if plugin returned any
-            // Ensure meta is always present, starting with existing or empty object
-            let newContext = {
-                ...initialContext,
-                ...addPluginOptions,
-                meta: initialContext.meta || {},
+            const { context: pluginContext, ...pluginProperties } = pluginResult;
+            const mergedProperties = { ...properties, ...pluginProperties };
+            let mergedContext = {
+                ...context,
+                meta: context.meta || {},
             };
             if (pluginContext) {
-                // Extract meta from plugin context for special merging
-                const { meta: pluginMeta, ...otherPluginContext } = pluginContext;
-                newContext = {
-                    ...newContext,
-                    ...otherPluginContext,
+                const { meta: pluginMeta, ...pluginContextRest } = pluginContext;
+                mergedContext = {
+                    ...mergedContext,
+                    ...pluginContextRest,
                 };
-                // Merge meta separately to avoid overwriting
                 if (pluginMeta) {
-                    newContext = {
-                        ...newContext,
-                        meta: {
-                            ...newContext.meta, // Existing meta (now guaranteed to exist)
-                            ...pluginMeta, // New meta from plugin
-                        },
+                    mergedContext = {
+                        ...mergedContext,
+                        meta: { ...mergedContext.meta, ...pluginMeta },
                     };
                 }
             }
-            // Recursively create new SDK with updated properties
-            return createSdk(options, newSdk, newContext);
+            return buildSdk(mergedProperties, mergedContext);
         },
     };
 }
 export function createZapierSdkWithoutRegistry(options = {}) {
-    return (createSdk(options)
+    return (createSdk()
+        .addPlugin(createOptionsPlugin(options))
         // Event emission (must be first to be available to other plugins)
         .addPlugin(eventEmissionPlugin)
         // Provides the API client in context

package/dist/types/errors.d.ts

@@ -174,6 +174,43 @@ export declare class ZapierRateLimitError extends ZapierError {
         retries?: number;
     });
 }
+/**
+ * Terminal status of an approval attempt, exposed on `ZapierApprovalError.approvalStatus`.
+ *
+ * - `pending`: The approval was created but not yet resolved. Only thrown in
+ *   `approvalMode: "fail"` — the caller is expected to surface the approval URL
+ *   to an end user (e.g. an LLM instructing its user to click the link).
+ * - `denied`: A human explicitly rejected the approval in the UI.
+ * - `policy_denied`: A policy rule blocked the request before (or instead of)
+ *   creating an approval. Cannot be approved by a human.
+ * - `approval_required`: The backend requested approval, but the current
+ *   session is non-interactive so the SDK cannot open the approval URL. Retry
+ *   in an interactive session, or use `approvalMode: "fail"` to surface the
+ *   approval URL to the caller.
+ * - `timeout`: Poll mode exceeded `approvalTimeoutMs` without the approval
+ *   being resolved.
+ * - `max_retries_exceeded`: A single request triggered more sequential approval
+ *   rounds than `maxApprovalRetries` allows (runaway-loop safeguard).
+ */
+export type ApprovalStatus = "denied" | "timeout" | "pending" | "policy_denied" | "approval_required" | "max_retries_exceeded";
+/**
+ * Error thrown when a request requires approval and the approval is denied, times out,
+ * or the auth type doesn't support the approval flow.
+ */
+export declare class ZapierApprovalError extends ZapierError {
+    readonly name = "ZapierApprovalError";
+    readonly code: "ZAPIER_APPROVAL_ERROR";
+    approvalId?: string;
+    approvalStatus?: ApprovalStatus;
+    approvalUrl?: string;
+    pollUrl?: string;
+    constructor(message: string, options?: ErrorOptions & {
+        approvalId?: string;
+        status?: ApprovalStatus;
+        approvalUrl?: string;
+        pollUrl?: string;
+    });
+}
 /**
  * Error thrown when Relay itself encounters an error (as opposed to the upstream partner API returning an error).
  * Indicated by the presence of the X-Relay-Error response header.

package/dist/types/errors.d.ts.map

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

package/dist/types/errors.js

@@ -150,6 +150,21 @@ export class ZapierRateLimitError extends ZapierError {
         this.retries = options.retries ?? 0;
     }
 }
+/**
+ * Error thrown when a request requires approval and the approval is denied, times out,
+ * or the auth type doesn't support the approval flow.
+ */
+export class ZapierApprovalError extends ZapierError {
+    constructor(message, options = {}) {
+        super(message, options);
+        this.name = "ZapierApprovalError";
+        this.code = "ZAPIER_APPROVAL_ERROR";
+        this.approvalId = options.approvalId;
+        this.approvalStatus = options.status;
+        this.approvalUrl = options.approvalUrl;
+        this.pollUrl = options.pollUrl;
+    }
+}
 /**
  * Error thrown when Relay itself encounters an error (as opposed to the upstream partner API returning an error).
  * Indicated by the presence of the X-Relay-Error response header.
@@ -213,6 +228,9 @@ export function formatErrorMessage(error) {
             "\n\nBuild errors:\n" +
                 error.buildErrors.map((err) => `  • ${err}`).join("\n");
     }
+    if (error instanceof ZapierApprovalError && error.approvalUrl) {
+        message += `\nApproval URL: ${error.approvalUrl}`;
+    }
     if (error instanceof ZapierRateLimitError) {
         const { limit, remaining, retryAfterMs } = error.rateLimit;
         const parts = [];

package/dist/types/plugin.d.ts

@@ -1,19 +1,21 @@
 /**
  * ------------------------------
- * Plugin Type System with Explicit Context Dependencies
+ * Plugin Type System
  * ------------------------------
  *
- * This system makes context dependencies explicit to restore TypeScript's
- * ability to catch missing context at compile time.
+ * Plugins receive the sdk as a positional parameter. sdk.context holds shared
+ * internal state (api client, event emission, meta, options, etc.). SDK methods
+ * live at the root, context nests under .context.
+ *
+ * A plugin is (sdk) => partialSdk. createSdk() returns an empty SDK. addPlugin
+ * merges the plugin's result into the SDK, producing a new SDK.
  */
 import type { z } from "zod";
-import type { BaseSdkOptions } from "./sdk";
-export interface PluginDependencies<TSdk = {}, TContext = {}> {
-    sdk: TSdk;
-    context: TContext;
-}
 export interface PluginProvides extends Record<string, any> {
-    context?: Record<string, any>;
+    context?: {
+        meta?: Record<string, PluginMeta>;
+        [key: string]: any;
+    };
 }
 export interface PluginMeta {
     /**
@@ -22,62 +24,41 @@ export interface PluginMeta {
      * the inputSchema's `.describe()` value or a generic placeholder.
      */
     description?: string;
-    categories: string[];
+    categories?: string[];
     type?: "list" | "item" | "create" | "delete";
     itemType?: string;
     returnType?: string;
-    inputSchema: z.ZodSchema;
+    inputSchema?: z.ZodSchema;
     outputSchema?: z.ZodSchema;
     resolvers?: Record<string, any>;
     /** Confirmation prompt type - prompts user before executing */
     confirm?: "create-secret" | "delete";
     [key: string]: any;
 }
-export type ExtractSdkProperties<T extends Record<string, any>> = Omit<T, "context">;
-export type ExtractContextProperties<T extends PluginProvides> = T["context"];
-export type GetSdkType<TPluginProvides extends PluginProvides> = ExtractSdkProperties<TPluginProvides> & {
-    getContext(): NonNullable<ExtractContextProperties<TPluginProvides>>;
-};
-export type GetContextType<TPluginProvides extends PluginProvides> = NonNullable<ExtractContextProperties<TPluginProvides>>;
-export type PluginOptions<TSdk = {}, TContext = {}> = {
-    sdk: TSdk;
-    context: TContext & {
-        meta: Record<string, any>;
-    };
-};
 /**
- * Plugin interface — now has 3 type params:
+ * Plugin interface — 2 type params:
+ *
+ *   TSdk = what this plugin needs (the SDK shape including context)
+ *   TProvides = what this plugin returns (a partial SDK shape)
  *
- *   TRequiresContext = what this plugin *needs* in context
- *   TProvides = what this plugin *returns* (sdk + context)
- *   TSdk = current sdk shape when plugin runs
+ * The sdk param always includes context.meta, even if TSdk doesn't declare it.
  */
-export interface Plugin<TSdk = {}, TRequiresContext = {}, TProvides extends PluginProvides = PluginProvides> {
-    (params: {
-        sdk: TSdk;
-        context: TRequiresContext & {
+export interface Plugin<TSdk = {}, TProvides extends PluginProvides = PluginProvides> {
+    (sdk: TSdk & {
+        context: {
             meta: Record<string, PluginMeta>;
-            options: BaseSdkOptions;
         };
     }): TProvides;
 }
-type MissingContextKeys<TRequired, TCurrent> = TRequired extends Record<string, any> ? TCurrent extends Record<string, any> ? {
-    [K in keyof TRequired]: K extends keyof TCurrent ? never : K;
-}[keyof TRequired] : keyof TRequired : never;
-type ContextError<TRequired, TCurrent> = MissingContextKeys<TRequired, TCurrent> extends never ? never : MissingContextKeys<TRequired, TCurrent> extends infer Missing ? Missing extends string ? `❌ Missing required context: { ${Missing}: any }` : Missing extends number ? `❌ Missing required context: { ${Missing}: any }` : `❌ Missing required context properties. Required: ${keyof TRequired extends string ? keyof TRequired : "unknown"}, Available: ${keyof TCurrent extends string ? keyof TCurrent : "unknown"}` : "❌ Context requirement not satisfied";
 /**
- * SDK interface — result of createSdk()
- *
- * addPlugin now enforces that TRequiresContext is assignable to TCurrentContext.
- * If not, TypeScript will emit a detailed error showing missing properties.
+ * Takes an SDK shape and adds an addPlugin method to it.
+ * addPlugin merges a plugin's result into the shape, producing a new SDK.
  */
-export type Sdk<TCurrentSdk = {}, TCurrentContext = {
-    meta: Record<string, PluginMeta>;
-}> = TCurrentSdk & {
-    addPlugin<TRequiresContext, TProvides extends PluginProvides>(plugin: Plugin<TCurrentSdk & {
-        getContext(): TCurrentContext;
-    }, TRequiresContext, TProvides>, options?: any): TCurrentContext extends TRequiresContext ? Sdk<TCurrentSdk & ExtractSdkProperties<TProvides>, TCurrentContext & NonNullable<ExtractContextProperties<TProvides>>> : ContextError<TRequiresContext, TCurrentContext>;
-    getContext(): TCurrentContext;
+export type WithAddPlugin<T = {
+    context: {
+        meta: Record<string, PluginMeta>;
+    };
+}> = T & {
+    addPlugin<TProvides extends PluginProvides>(plugin: Plugin<T, TProvides>): WithAddPlugin<T & TProvides>;
 };
-export {};
 //# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,MAAM,WAAW,cAAe,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IACzD,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAClC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,CAAC;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM,CACrB,IAAI,GAAG,EAAE,EACT,SAAS,SAAS,cAAc,GAAG,cAAc;IAEjD,CACE,GAAG,EAAE,IAAI,GAAG;QACV,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;SAClC,CAAC;KACH,GACA,SAAS,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,CACvB,CAAC,GAAG;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;KAAE,CAAA;CAAE,IACnD,CAAC,GAAG;IACN,SAAS,CAAC,SAAS,SAAS,cAAc,EACxC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,GAC3B,aAAa,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CACjC,CAAC"}