@zapier/zapier-sdk 0.5.1 → 0.6.0

package/dist/index.d.mts

@@ -728,8 +728,8 @@ interface ApiError {
     code: string;
     title: string;
     detail: string;
-    source?: any;
-    meta?: any;
+    source?: unknown;
+    meta?: unknown;
 }
 /**
  * Base options for all error constructors
@@ -738,7 +738,7 @@ interface ErrorOptions {
     statusCode?: number;
     errors?: ApiError[];
     cause?: unknown;
-    response?: any;
+    response?: unknown;
 }
 /**
  * Base class for all Zapier SDK errors
@@ -749,7 +749,7 @@ declare abstract class ZapierError extends Error {
     statusCode?: number;
     errors?: ApiError[];
     cause?: unknown;
-    response?: any;
+    response?: unknown;
     constructor(message: string, options?: ErrorOptions);
 }
 /**
@@ -774,9 +774,9 @@ declare class ZapierAppNotFoundError extends ZapierError {
  */
 declare class ZapierValidationError extends ZapierError {
     readonly name = "ZapierValidationError";
-    details?: any;
+    details?: unknown;
     constructor(message: string, options?: ErrorOptions & {
-        details?: any;
+        details?: unknown;
     });
 }
 /**
@@ -871,7 +871,7 @@ interface AppFactoryOptions {
     authenticationId: number;
 }
 interface BaseActionTypeProxy {
-    [action: string]: (options?: ActionExecutionOptions) => any;
+    [action: string]: (options?: ActionExecutionOptions) => unknown;
 }
 interface FetchActionType {
     fetch: (url: string | URL, init?: RequestInit & {
@@ -893,64 +893,189 @@ interface ActionProxy {
 }
 
 /**
- * ------------------------------
- * Plugin Type System with Explicit Context Dependencies
- * ------------------------------
+ * SDK Event System
  *
- * This system makes context dependencies explicit to restore TypeScript's
- * ability to catch missing context at compile time.
+ * This module provides common event type definitions for the SDK's
+ * event system, including authentication, API, and loading events.
  */
-interface PluginDependencies<TSdk = {}, TContext = {}> {
-    sdk: TSdk;
-    context: TContext;
+interface SdkEvent {
+    type: string;
+    payload?: Record<string, unknown>;
+    timestamp?: number;
 }
-interface PluginProvides extends Record<string, any> {
-    context?: Record<string, any>;
+interface AuthEvent extends SdkEvent {
+    type: "auth_refreshing" | "auth_success" | "auth_error" | "auth_logout";
+    payload?: {
+        message?: string;
+        error?: string;
+        operation?: string;
+    };
 }
-type ExtractSdkProperties<T extends Record<string, any>> = Omit<T, "context">;
-type ExtractContextProperties<T extends PluginProvides> = T["context"];
-type GetSdkType<TPluginProvides extends PluginProvides> = ExtractSdkProperties<TPluginProvides> & {
-    getContext(): NonNullable<ExtractContextProperties<TPluginProvides>>;
-};
-type PluginOptions<TSdk = {}, TContext = {}> = {
-    sdk: TSdk;
-    context: TContext & {
-        meta: Record<string, any>;
+interface ApiEvent extends SdkEvent {
+    type: "api_request" | "api_response" | "api_error";
+    payload?: {
+        url?: string;
+        method?: string;
+        status?: number;
+        duration?: number;
+        error?: string;
     };
-};
-/**
- * Plugin interface — now has 3 type params:
- *
- *   TRequiresContext = what this plugin *needs* in context
- *   TProvides = what this plugin *returns* (sdk + context)
- *   TSdk = current sdk shape when plugin runs
- */
-interface Plugin<TSdk = {}, TRequiresContext = {}, TProvides extends PluginProvides = PluginProvides> {
-    (params: {
-        sdk: TSdk;
-        context: TRequiresContext & {
-            meta: Record<string, any>;
-        };
-    }): 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.
- */
-type Sdk<TCurrentSdk = {}, TCurrentContext = {
-    meta: Record<string, any>;
-}> = 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;
-};
+interface LoadingEvent extends SdkEvent {
+    type: "loading_start" | "loading_end";
+    payload?: {
+        operation?: string;
+        resource?: string;
+    };
+}
+type EventCallback = (event: SdkEvent) => void;
+
+declare const ListInputFieldsSchema: z.ZodObject<{
+    appKey: z.ZodString;
+    actionType: z.ZodEnum<["read", "read_bulk", "write", "run", "search", "search_or_write", "search_and_write", "filter"]>;
+    actionKey: z.ZodString;
+    authenticationId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    maxItems: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    appKey: string;
+    actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
+    actionKey: string;
+    authenticationId?: number | null | undefined;
+    inputs?: Record<string, any> | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
+}, {
+    appKey: string;
+    actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
+    actionKey: string;
+    authenticationId?: number | null | undefined;
+    inputs?: Record<string, any> | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
+}>;
+type ListInputFieldsOptions = z.infer<typeof ListInputFieldsSchema>;
+
+declare const GetAuthenticationSchema: z.ZodObject<{
+    authenticationId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    authenticationId: number;
+}, {
+    authenticationId: number;
+}>;
+type GetAuthenticationOptions = z.infer<typeof GetAuthenticationSchema>;
+
+declare const FindFirstAuthenticationSchema: z.ZodObject<{
+    appKey: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    account_id: z.ZodOptional<z.ZodString>;
+    owner: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title?: string | undefined;
+    search?: string | undefined;
+    account_id?: string | undefined;
+    appKey?: string | undefined;
+    owner?: string | undefined;
+}, {
+    title?: string | undefined;
+    search?: string | undefined;
+    account_id?: string | undefined;
+    appKey?: string | undefined;
+    owner?: string | undefined;
+}>;
+type FindFirstAuthenticationOptions = z.infer<typeof FindFirstAuthenticationSchema>;
+
+declare const FindUniqueAuthenticationSchema: z.ZodObject<{
+    appKey: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    account_id: z.ZodOptional<z.ZodString>;
+    owner: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title?: string | undefined;
+    search?: string | undefined;
+    account_id?: string | undefined;
+    appKey?: string | undefined;
+    owner?: string | undefined;
+}, {
+    title?: string | undefined;
+    search?: string | undefined;
+    account_id?: string | undefined;
+    appKey?: string | undefined;
+    owner?: string | undefined;
+}>;
+type FindUniqueAuthenticationOptions = z.infer<typeof FindUniqueAuthenticationSchema>;
+
+declare const RelayRequestSchema: z.ZodObject<{
+    url: z.ZodString;
+    method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]>>;
+    body: z.ZodOptional<z.ZodAny>;
+    authenticationId: z.ZodOptional<z.ZodNumber>;
+    callbackUrl: z.ZodOptional<z.ZodString>;
+    authenticationTemplate: z.ZodOptional<z.ZodString>;
+    headers: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodString>, z.ZodType<Headers, z.ZodTypeDef, Headers>, z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString], null>, "many">]>>;
+} & {
+    relayBaseUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
+    authenticationId?: number | undefined;
+    body?: any;
+    callbackUrl?: string | undefined;
+    authenticationTemplate?: string | undefined;
+    headers?: Record<string, string> | [string, string][] | Headers | undefined;
+    relayBaseUrl?: string | undefined;
+}, {
+    url: string;
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
+    authenticationId?: number | undefined;
+    body?: any;
+    callbackUrl?: string | undefined;
+    authenticationTemplate?: string | undefined;
+    headers?: Record<string, string> | [string, string][] | Headers | undefined;
+    relayBaseUrl?: string | undefined;
+}>;
+type RelayRequestOptions = z.infer<typeof RelayRequestSchema>;
+declare const RelayFetchSchema: z.ZodObject<{
+    url: z.ZodString;
+    method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]>>;
+    body: z.ZodOptional<z.ZodAny>;
+    authenticationId: z.ZodOptional<z.ZodNumber>;
+    callbackUrl: z.ZodOptional<z.ZodString>;
+    authenticationTemplate: z.ZodOptional<z.ZodString>;
+    headers: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodString>, z.ZodType<Headers, z.ZodTypeDef, Headers>, z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString], null>, "many">]>>;
+} & {
+    relayBaseUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
+    authenticationId?: number | undefined;
+    body?: any;
+    callbackUrl?: string | undefined;
+    authenticationTemplate?: string | undefined;
+    headers?: Record<string, string> | [string, string][] | Headers | undefined;
+    relayBaseUrl?: string | undefined;
+}, {
+    url: string;
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
+    authenticationId?: number | undefined;
+    body?: any;
+    callbackUrl?: string | undefined;
+    authenticationTemplate?: string | undefined;
+    headers?: Record<string, string> | [string, string][] | Headers | undefined;
+    relayBaseUrl?: string | undefined;
+}>;
+
+declare const LockVersionSchema: z.ZodObject<{
+    appKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    appKey: string;
+}, {
+    appKey: string;
+}>;
+type LockVersionOptions = z.infer<typeof LockVersionSchema>;
 
 declare const NeedSchema: z.ZodObject<{
     key: z.ZodString;
@@ -2074,65 +2199,85 @@ type App = z.infer<typeof AppSchema>;
 type NeedsRequest = z.infer<typeof NeedsRequestSchema>;
 type NeedsResponse = z.infer<typeof NeedsResponseSchema>;
 
-declare const RelayRequestSchema: z.ZodObject<{
-    url: z.ZodString;
-    method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]>>;
-    body: z.ZodOptional<z.ZodAny>;
-    authenticationId: z.ZodOptional<z.ZodNumber>;
-    callbackUrl: z.ZodOptional<z.ZodString>;
-    authenticationTemplate: z.ZodOptional<z.ZodString>;
-    headers: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodString>, z.ZodType<Headers, z.ZodTypeDef, Headers>, z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString], null>, "many">]>>;
-} & {
-    relayBaseUrl: z.ZodOptional<z.ZodString>;
+declare const ListAppsSchema: z.ZodObject<{
+    appKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    search: z.ZodOptional<z.ZodString>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    maxItems: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    url: string;
-    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
-    body?: any;
-    authenticationId?: number | undefined;
-    callbackUrl?: string | undefined;
-    authenticationTemplate?: string | undefined;
-    headers?: Record<string, string> | [string, string][] | Headers | undefined;
-    relayBaseUrl?: string | undefined;
+    search?: string | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
+    appKeys?: string[] | undefined;
 }, {
-    url: string;
-    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
-    body?: any;
-    authenticationId?: number | undefined;
-    callbackUrl?: string | undefined;
-    authenticationTemplate?: string | undefined;
-    headers?: Record<string, string> | [string, string][] | Headers | undefined;
-    relayBaseUrl?: string | undefined;
-}>;
-type RelayRequestOptions = z.infer<typeof RelayRequestSchema>;
-declare const RelayFetchSchema: z.ZodObject<{
-    url: z.ZodString;
-    method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]>>;
-    body: z.ZodOptional<z.ZodAny>;
-    authenticationId: z.ZodOptional<z.ZodNumber>;
-    callbackUrl: z.ZodOptional<z.ZodString>;
-    authenticationTemplate: z.ZodOptional<z.ZodString>;
-    headers: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodString>, z.ZodType<Headers, z.ZodTypeDef, Headers>, z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString], null>, "many">]>>;
-} & {
-    relayBaseUrl: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    url: string;
-    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
-    body?: any;
-    authenticationId?: number | undefined;
-    callbackUrl?: string | undefined;
-    authenticationTemplate?: string | undefined;
-    headers?: Record<string, string> | [string, string][] | Headers | undefined;
-    relayBaseUrl?: string | undefined;
-}, {
-    url: string;
-    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
-    body?: any;
-    authenticationId?: number | undefined;
-    callbackUrl?: string | undefined;
-    authenticationTemplate?: string | undefined;
-    headers?: Record<string, string> | [string, string][] | Headers | undefined;
-    relayBaseUrl?: string | undefined;
+    search?: string | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
+    appKeys?: string[] | undefined;
 }>;
+type ListAppsOptions = z.infer<typeof ListAppsSchema>;
+
+interface ListAppsPluginProvides {
+    listApps: (options?: ListAppsOptions) => Promise<{
+        data: AppItem[];
+    }> & AsyncIterable<{
+        data: AppItem[];
+        nextCursor?: string;
+    }> & {
+        items(): AsyncIterable<AppItem>;
+    };
+    context: {
+        meta: {
+            listApps: {
+                inputSchema: typeof ListAppsSchema;
+            };
+        };
+    };
+}
+
+interface LockVersionPluginProvides {
+    lockVersion: (options: LockVersionOptions & {
+        configPath?: string;
+    }) => Promise<{
+        data: AppItem;
+        configPath: string;
+    }>;
+    context: {
+        meta: {
+            lockVersion: {
+                inputSchema: typeof LockVersionSchema;
+            };
+        };
+    };
+}
+
+interface RegistryPluginProvides {
+    getRegistry: () => {
+        functions: FunctionRegistryEntry[];
+        categories: {
+            key: string;
+            title: string;
+            titlePlural: string;
+            functions: string[];
+        }[];
+    };
+}
+
+declare const GetProfileSchema: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
+type GetProfileOptions = z.infer<typeof GetProfileSchema> & FunctionOptions;
+
+interface GetProfilePluginProvides {
+    getProfile: (options?: GetProfileOptions) => Promise<{
+        data: UserProfileItem;
+    }>;
+    context: {
+        meta: {
+            getProfile: {
+                inputSchema: typeof GetProfileSchema;
+            };
+        };
+    };
+}
 
 interface RequestPluginProvides {
     request: (options: RelayRequestOptions) => Promise<Response>;
@@ -2164,66 +2309,6 @@ type ZapierFetchInitOptions = RequestInit & {
     authenticationTemplate?: string;
 };
 
-declare const RunActionSchema: z.ZodObject<{
-    appKey: z.ZodString;
-    actionType: z.ZodEnum<["read", "read_bulk", "write", "run", "search", "search_or_write", "search_and_write", "filter"]>;
-    actionKey: z.ZodString;
-    authenticationId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    pageSize: z.ZodOptional<z.ZodNumber>;
-    maxItems: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    appKey: string;
-    actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
-    actionKey: string;
-    authenticationId?: number | null | undefined;
-    maxItems?: number | undefined;
-    pageSize?: number | undefined;
-    inputs?: Record<string, any> | undefined;
-}, {
-    appKey: string;
-    actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
-    actionKey: string;
-    authenticationId?: number | null | undefined;
-    maxItems?: number | undefined;
-    pageSize?: number | undefined;
-    inputs?: Record<string, any> | undefined;
-}>;
-type RunActionOptions = z.infer<typeof RunActionSchema>;
-
-declare const GetActionSchema: z.ZodObject<{
-    appKey: z.ZodString;
-    actionType: z.ZodEnum<["read", "read_bulk", "write", "run", "search", "search_or_write", "search_and_write", "filter"]>;
-    actionKey: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    appKey: string;
-    actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
-    actionKey: string;
-}, {
-    appKey: string;
-    actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
-    actionKey: string;
-}>;
-type GetActionOptions = z.infer<typeof GetActionSchema>;
-
-declare const ListActionsSchema: z.ZodObject<{
-    appKey: z.ZodString;
-    actionType: z.ZodOptional<z.ZodEnum<["read", "read_bulk", "write", "run", "search", "search_or_write", "search_and_write", "filter"]>>;
-    pageSize: z.ZodOptional<z.ZodNumber>;
-    maxItems: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    appKey: string;
-    maxItems?: number | undefined;
-    pageSize?: number | undefined;
-    actionType?: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write" | undefined;
-}, {
-    appKey: string;
-    maxItems?: number | undefined;
-    pageSize?: number | undefined;
-    actionType?: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write" | undefined;
-}>;
-type ListActionsOptions = z.infer<typeof ListActionsSchema>;
-
 declare const GetAppSchema: z.ZodObject<{
     appKey: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -2233,39 +2318,23 @@ declare const GetAppSchema: z.ZodObject<{
 }>;
 type GetAppOptions = z.infer<typeof GetAppSchema>;
 
-declare const ListAppsSchema: z.ZodObject<{
-    appKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    search: z.ZodOptional<z.ZodString>;
-    pageSize: z.ZodOptional<z.ZodNumber>;
-    maxItems: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    search?: string | undefined;
-    maxItems?: number | undefined;
-    pageSize?: number | undefined;
-    appKeys?: string[] | undefined;
-}, {
-    search?: string | undefined;
-    maxItems?: number | undefined;
-    pageSize?: number | undefined;
-    appKeys?: string[] | undefined;
-}>;
-type ListAppsOptions = z.infer<typeof ListAppsSchema>;
+type ManifestEntry = {
+    implementationName: string;
+    version?: string;
+};
+type GetManifestEntry = (appKey: string) => ManifestEntry | null;
+type GetVersionedImplementationId = (appKey: string) => Promise<string | null>;
+type GetImplementation = (appKey: string) => Promise<AppItem | null>;
+type Manifest = {
+    apps: Record<string, ManifestEntry>;
+};
 
-interface ListAppsPluginProvides {
-    listApps: (options?: ListAppsOptions) => Promise<{
-        data: AppItem[];
-    }> & AsyncIterable<{
-        data: AppItem[];
-        nextCursor?: string;
-    }> & {
-        items(): AsyncIterable<AppItem>;
-    };
+interface ManifestPluginProvides {
     context: {
-        meta: {
-            listApps: {
-                inputSchema: typeof ListAppsSchema;
-            };
-        };
+        manifest: Manifest | null;
+        getVersionedImplementationId: GetVersionedImplementationId;
+        getManifestEntry: GetManifestEntry;
+        getImplementation: GetImplementation;
     };
 }
 
@@ -2282,6 +2351,24 @@ interface GetAppPluginProvides {
     };
 }
 
+declare const ListActionsSchema: z.ZodObject<{
+    appKey: z.ZodString;
+    actionType: z.ZodOptional<z.ZodEnum<["read", "read_bulk", "write", "run", "search", "search_or_write", "search_and_write", "filter"]>>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    maxItems: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    appKey: string;
+    actionType?: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write" | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
+}, {
+    appKey: string;
+    actionType?: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write" | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
+}>;
+type ListActionsOptions = z.infer<typeof ListActionsSchema>;
+
 interface ListActionsPluginProvides {
     listActions: (options?: ListActionsOptions) => Promise<{
         data: ActionItem[];
@@ -2300,6 +2387,21 @@ interface ListActionsPluginProvides {
     };
 }
 
+declare const GetActionSchema: z.ZodObject<{
+    appKey: z.ZodString;
+    actionType: z.ZodEnum<["read", "read_bulk", "write", "run", "search", "search_or_write", "search_and_write", "filter"]>;
+    actionKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    appKey: string;
+    actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
+    actionKey: string;
+}, {
+    appKey: string;
+    actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
+    actionKey: string;
+}>;
+type GetActionOptions = z.infer<typeof GetActionSchema>;
+
 interface GetActionPluginProvides {
     getAction: (options: GetActionOptions) => Promise<{
         data: ActionItem;
@@ -2313,70 +2415,7 @@ interface GetActionPluginProvides {
     };
 }
 
-interface RunActionPluginProvides {
-    runAction: (options?: RunActionOptions) => Promise<{
-        data: any[];
-    }> & AsyncIterable<{
-        data: any[];
-        nextCursor?: string;
-    }> & {
-        items(): AsyncIterable<any>;
-    };
-    context: {
-        meta: {
-            runAction: {
-                inputSchema: typeof RunActionSchema;
-            };
-        };
-    };
-}
-
-interface AppsPluginProvides {
-    apps: ActionProxy;
-}
-declare const appsPlugin: Plugin<GetSdkType<FetchPluginProvides & RunActionPluginProvides>, // requires fetch + runAction in SDK
-{}, // no context requirements
-AppsPluginProvides>;
-
-/**
- * SDK Event System
- *
- * This module provides common event type definitions for the SDK's
- * event system, including authentication, API, and loading events.
- */
-interface SdkEvent {
-    type: string;
-    payload?: Record<string, any>;
-    timestamp?: number;
-}
-interface AuthEvent extends SdkEvent {
-    type: "auth_refreshing" | "auth_success" | "auth_error" | "auth_logout";
-    payload?: {
-        message?: string;
-        error?: string;
-        operation?: string;
-    };
-}
-interface ApiEvent extends SdkEvent {
-    type: "api_request" | "api_response" | "api_error";
-    payload?: {
-        url?: string;
-        method?: string;
-        status?: number;
-        duration?: number;
-        error?: string;
-    };
-}
-interface LoadingEvent extends SdkEvent {
-    type: "loading_start" | "loading_end";
-    payload?: {
-        operation?: string;
-        resource?: string;
-    };
-}
-type EventCallback = (event: SdkEvent) => void;
-
-declare const ListInputFieldsSchema: z.ZodObject<{
+declare const RunActionSchema: z.ZodObject<{
     appKey: z.ZodString;
     actionType: z.ZodEnum<["read", "read_bulk", "write", "run", "search", "search_or_write", "search_and_write", "filter"]>;
     actionKey: z.ZodString;
@@ -2389,86 +2428,33 @@ declare const ListInputFieldsSchema: z.ZodObject<{
     actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
     actionKey: string;
     authenticationId?: number | null | undefined;
-    maxItems?: number | undefined;
-    pageSize?: number | undefined;
     inputs?: Record<string, any> | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
 }, {
     appKey: string;
     actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
     actionKey: string;
     authenticationId?: number | null | undefined;
-    maxItems?: number | undefined;
-    pageSize?: number | undefined;
     inputs?: Record<string, any> | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
 }>;
-type ListInputFieldsOptions = z.infer<typeof ListInputFieldsSchema>;
-
-declare const GetAuthenticationSchema: z.ZodObject<{
-    authenticationId: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    authenticationId: number;
-}, {
-    authenticationId: number;
-}>;
-type GetAuthenticationOptions = z.infer<typeof GetAuthenticationSchema>;
-
-declare const FindFirstAuthenticationSchema: z.ZodObject<{
-    appKey: z.ZodOptional<z.ZodString>;
-    search: z.ZodOptional<z.ZodString>;
-    title: z.ZodOptional<z.ZodString>;
-    account_id: z.ZodOptional<z.ZodString>;
-    owner: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    title?: string | undefined;
-    search?: string | undefined;
-    account_id?: string | undefined;
-    appKey?: string | undefined;
-    owner?: string | undefined;
-}, {
-    title?: string | undefined;
-    search?: string | undefined;
-    account_id?: string | undefined;
-    appKey?: string | undefined;
-    owner?: string | undefined;
-}>;
-type FindFirstAuthenticationOptions = z.infer<typeof FindFirstAuthenticationSchema>;
-
-declare const FindUniqueAuthenticationSchema: z.ZodObject<{
-    appKey: z.ZodOptional<z.ZodString>;
-    search: z.ZodOptional<z.ZodString>;
-    title: z.ZodOptional<z.ZodString>;
-    account_id: z.ZodOptional<z.ZodString>;
-    owner: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    title?: string | undefined;
-    search?: string | undefined;
-    account_id?: string | undefined;
-    appKey?: string | undefined;
-    owner?: string | undefined;
-}, {
-    title?: string | undefined;
-    search?: string | undefined;
-    account_id?: string | undefined;
-    appKey?: string | undefined;
-    owner?: string | undefined;
-}>;
-type FindUniqueAuthenticationOptions = z.infer<typeof FindUniqueAuthenticationSchema>;
-
-interface RegistryPluginProvides {
-    __registry: FunctionRegistryEntry[];
-}
-
-declare const GetProfileSchema: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>;
-type GetProfileOptions = z.infer<typeof GetProfileSchema> & FunctionOptions;
+type RunActionOptions = z.infer<typeof RunActionSchema>;
 
-interface GetProfilePluginProvides {
-    getProfile: (options?: GetProfileOptions) => Promise<{
-        data: UserProfileItem;
-    }>;
+interface RunActionPluginProvides {
+    runAction: (options?: RunActionOptions) => Promise<{
+        data: any[];
+    }> & AsyncIterable<{
+        data: any[];
+        nextCursor?: string;
+    }> & {
+        items(): AsyncIterable<any>;
+    };
     context: {
         meta: {
-            getProfile: {
-                inputSchema: typeof GetProfileSchema;
+            runAction: {
+                inputSchema: typeof RunActionSchema;
             };
         };
     };
@@ -2486,17 +2472,17 @@ declare const ListAuthenticationsSchema: z.ZodObject<{
     title?: string | undefined;
     search?: string | undefined;
     account_id?: string | undefined;
-    maxItems?: number | undefined;
-    pageSize?: number | undefined;
     appKey?: string | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
     owner?: string | undefined;
 }, {
     title?: string | undefined;
     search?: string | undefined;
     account_id?: string | undefined;
-    maxItems?: number | undefined;
-    pageSize?: number | undefined;
     appKey?: string | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
     owner?: string | undefined;
 }>;
 type ListAuthenticationsOptions = z.infer<typeof ListAuthenticationsSchema>;
@@ -2587,14 +2573,97 @@ interface BaseSdkOptions {
     fetch?: typeof fetch;
     baseUrl?: string;
     debug?: boolean;
+    manifestPath?: string;
+    manifest?: {
+        apps: {
+            [appKey: string]: {
+                implementationName: string;
+                version?: string;
+            };
+        };
+    };
 }
 
 interface FunctionRegistryEntry {
     name: string;
     inputSchema: z.ZodSchema;
-    implementation: Function;
+    categories: string[];
+}
+type ZapierSdk = GetSdkType<RegistryPluginProvides & FetchPluginProvides & AppsPluginProvides & ListAppsPluginProvides & ManifestPluginProvides & GetAppPluginProvides & ListActionsPluginProvides & GetActionPluginProvides & RunActionPluginProvides & LockVersionPluginProvides & ListAuthenticationsPluginProvides & GetAuthenticationPluginProvides & FindFirstAuthenticationPluginProvides & FindUniqueAuthenticationPluginProvides & ListInputFieldsPluginProvides & RequestPluginProvides & GetProfilePluginProvides>;
+
+/**
+ * ------------------------------
+ * Plugin Type System with Explicit Context Dependencies
+ * ------------------------------
+ *
+ * This system makes context dependencies explicit to restore TypeScript's
+ * ability to catch missing context at compile time.
+ */
+
+interface PluginDependencies<TSdk = {}, TContext = {}> {
+    sdk: TSdk;
+    context: TContext;
 }
-type ZapierSdk = GetSdkType<RegistryPluginProvides & FetchPluginProvides & AppsPluginProvides & ListAppsPluginProvides & GetAppPluginProvides & ListActionsPluginProvides & GetActionPluginProvides & RunActionPluginProvides & ListAuthenticationsPluginProvides & GetAuthenticationPluginProvides & FindFirstAuthenticationPluginProvides & FindUniqueAuthenticationPluginProvides & ListInputFieldsPluginProvides & RequestPluginProvides & GetProfilePluginProvides>;
+interface PluginProvides extends Record<string, any> {
+    context?: Record<string, any>;
+}
+interface PluginMeta {
+    categories: string[];
+    inputSchema: z.ZodSchema;
+    [key: string]: any;
+}
+type ExtractSdkProperties<T extends Record<string, any>> = Omit<T, "context">;
+type ExtractContextProperties<T extends PluginProvides> = T["context"];
+type GetSdkType<TPluginProvides extends PluginProvides> = ExtractSdkProperties<TPluginProvides> & {
+    getContext(): NonNullable<ExtractContextProperties<TPluginProvides>>;
+};
+type PluginOptions<TSdk = {}, TContext = {}> = {
+    sdk: TSdk;
+    context: TContext & {
+        meta: Record<string, any>;
+    };
+};
+/**
+ * Plugin interface — now has 3 type params:
+ *
+ *   TRequiresContext = what this plugin *needs* in context
+ *   TProvides = what this plugin *returns* (sdk + context)
+ *   TSdk = current sdk shape when plugin runs
+ */
+interface Plugin<TSdk = {}, TRequiresContext = {}, TProvides extends PluginProvides = PluginProvides> {
+    (params: {
+        sdk: TSdk;
+        context: TRequiresContext & {
+            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.
+ */
+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;
+};
+
+interface AppsPluginProvides {
+    apps: ActionProxy;
+}
+declare const appsPlugin: Plugin<GetSdkType<FetchPluginProvides & RunActionPluginProvides>, // requires fetch + runAction in SDK
+{}, // no context requirements
+AppsPluginProvides>;
 
 interface InputsResolver {
     type: "fields";
@@ -2705,8 +2774,8 @@ declare function getTokenFromEnvOrConfig(options?: AuthOptions): Promise<string
 interface ZapierSdkOptions extends BaseSdkOptions {
 }
 declare function createSdk<TCurrentSdk = {}, TCurrentContext = {
-    meta: Record<string, any>;
-}>(initialSdk?: TCurrentSdk, initialContext?: TCurrentContext): Sdk<TCurrentSdk, TCurrentContext>;
+    meta: Record<string, PluginMeta>;
+}>(options?: ZapierSdkOptions, initialSdk?: TCurrentSdk, initialContext?: TCurrentContext): Sdk<TCurrentSdk, TCurrentContext>;
 declare function createZapierSdk(options?: ZapierSdkOptions): ZapierSdk;
 
 export { type Action, type ActionExecutionResult, type ActionField, type ActionFieldChoice, type ActionItem, type ActionKeyProperty, ActionKeyPropertySchema, type ActionTypeProperty, ActionTypePropertySchema, type ApiError, type ApiEvent, type App, type AppItem, type AppKeyProperty, AppKeyPropertySchema, type AppsPluginProvides, type AuthEvent, type AuthOptions, type Authentication, type AuthenticationIdProperty, AuthenticationIdPropertySchema, type AuthenticationItem, type AuthenticationsResponse, type Choice, type DebugProperty, DebugPropertySchema, type ErrorOptions, type EventCallback, type FetchPluginProvides, type Field, type FunctionOptions, type FunctionRegistryEntry, type GetSdkType, type InputFieldItem, type InputsProperty, InputsPropertySchema, type LimitProperty, LimitPropertySchema, type LoadingEvent, type Need, type NeedsRequest, type NeedsResponse, type OffsetProperty, OffsetPropertySchema, type OutputProperty, OutputPropertySchema, type PaginatedSdkFunction, type ParamsProperty, ParamsPropertySchema, type Plugin, type PluginDependencies, type PluginOptions, type PluginProvides, RelayFetchSchema, RelayRequestSchema, type ResolverName, type ResolverType, type Sdk, type SdkEvent, type UserProfile, type UserProfileItem, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, type ZapierFetchInitOptions, ZapierNotFoundError, ZapierResourceNotFoundError, type ZapierSdk, type ZapierSdkOptions, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, appKeyResolver, appsPlugin, authenticationIdResolver, createSdk, createZapierSdk, fetchPlugin, formatErrorMessage, getResolutionOrder, getResolutionOrderForParams, getResolvableParams, getResolver, getResolversForMissingParams, getTokenFromCliLogin, getTokenFromEnv, getTokenFromEnvOrConfig, hasResolver, inputsResolver, isPositional, resolverRegistry };