@zapier/zapier-sdk 0.64.0 → 0.67.0

package/dist/types/properties.d.ts

@@ -1,9 +1,9 @@
 import { z } from "zod";
 export declare const AppKeyPropertySchema: z.ZodString & {
-    _def: z.core.$ZodStringDef & import("..").PositionalMetadata;
+    _def: z.core.$ZodStringDef & import("kitcore").PositionalMetadata;
 };
 export declare const AppPropertySchema: z.ZodString & {
-    _def: z.core.$ZodStringDef & import("..").PositionalMetadata;
+    _def: z.core.$ZodStringDef & import("kitcore").PositionalMetadata;
 };
 export declare const ActionTypePropertySchema: z.ZodEnum<{
     filter: "filter";
@@ -17,10 +17,10 @@ export declare const ActionTypePropertySchema: z.ZodEnum<{
 }>;
 export declare const ActionKeyPropertySchema: z.ZodString;
 export declare const ActionPropertySchema: z.ZodString & {
-    _def: z.core.$ZodStringDef & import("..").PositionalMetadata;
+    _def: z.core.$ZodStringDef & import("kitcore").PositionalMetadata;
 };
 export declare const InputFieldPropertySchema: z.ZodString & {
-    _def: z.core.$ZodStringDef & import("..").PositionalMetadata;
+    _def: z.core.$ZodStringDef & import("kitcore").PositionalMetadata;
 };
 export declare const ConnectionIdPropertySchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
 /** @deprecated Use ConnectionIdPropertySchema instead */
@@ -34,10 +34,10 @@ export declare const DebugPropertySchema: z.ZodDefault<z.ZodBoolean>;
 export declare const ParamsPropertySchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 export declare const ActionTimeoutMsPropertySchema: z.ZodOptional<z.ZodNumber>;
 export declare const TablePropertySchema: z.ZodString & {
-    _def: z.core.$ZodStringDef & import("..").PositionalMetadata;
+    _def: z.core.$ZodStringDef & import("kitcore").PositionalMetadata;
 };
 export declare const RecordPropertySchema: z.ZodString & {
-    _def: z.core.$ZodStringDef & import("..").PositionalMetadata;
+    _def: z.core.$ZodStringDef & import("kitcore").PositionalMetadata;
 };
 export declare const RecordsPropertySchema: z.ZodArray<z.ZodString>;
 export declare const FieldsPropertySchema: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
@@ -45,7 +45,7 @@ export declare const AppsPropertySchema: z.ZodArray<z.ZodString>;
 export declare const TablesPropertySchema: z.ZodArray<z.ZodString>;
 export declare const ConnectionsPropertySchema: z.ZodArray<z.ZodString>;
 export declare const TriggerInboxPropertySchema: z.ZodString & {
-    _def: z.core.$ZodStringDef & import("..").PositionalMetadata;
+    _def: z.core.$ZodStringDef & import("kitcore").PositionalMetadata;
 };
 export declare const TriggerInboxNamePropertySchema: z.ZodString;
 export declare const LeasePropertySchema: z.ZodString;

package/dist/types/properties.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { withPositional } from "../utils/schema-utils";
+import { withPositional } from "kitcore";
 import { MAX_PAGE_LIMIT, DEFAULT_ACTION_TIMEOUT_MS } from "../constants";
 // Shared property definitions for common parameters across functions
 // These can be reused in function schemas without duplication

package/dist/types/sdk.d.ts

@@ -90,7 +90,7 @@ import type { GetConnectionSdkFunction } from "../plugins/getConnection/schemas"
 import type { FindFirstConnectionSdkFunction } from "../plugins/findFirstConnection/schemas";
 import type { FindUniqueConnectionSdkFunction } from "../plugins/findUniqueConnection/schemas";
 import type { RelayRequestSdkFunction } from "../plugins/request/schemas";
-export type { FunctionRegistryEntry, FunctionDeprecation } from "./registry";
+export type { FunctionRegistryEntry, FunctionDeprecation } from "kitcore";
 export interface ZapierSdkFunctions extends ListActionInputFieldsSdkFunction, GetConnectionSdkFunction, FindFirstConnectionSdkFunction, FindUniqueConnectionSdkFunction, RelayRequestSdkFunction {
 }
 //# sourceMappingURL=sdk.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/types/sdk.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmGb,MAAM;iBAAW,MAAM;;cAAvB,MAAM;iBAAW,MAAM;;;;;;;iBAiBzC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAGlE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AACjG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAC7F,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAC/F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAE1E,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAG7E,MAAM,WAAW,kBACf,SAAQ,gCAAgC,EACtC,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,uBAAuB;CAAG"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/types/sdk.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAmGb,MAAM;iBAAW,MAAM;;cAAvB,MAAM;iBAAW,MAAM;;;;;;;iBAiBzC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAGlE,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AACjG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAC7F,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAC/F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAE1E,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAG1E,MAAM,WAAW,kBACf,SAAQ,gCAAgC,EACtC,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,uBAAuB;CAAG"}

package/dist/utils/domain-utils.js

@@ -2,7 +2,7 @@
  * Domain utility functions for working with app identifiers and data normalization
  */
 import { ZapierValidationError, ZapierConfigurationError, } from "../types/errors";
-import { toSnakeCase } from "./string-utils";
+import { toSnakeCase } from "kitcore";
 /**
  * Checks if a string value looks like a direct connection ID rather than a named alias.
  * Returns true for numeric strings and UUIDs.

package/dist/utils/logging.d.ts

@@ -1,13 +1,2 @@
-/**
- * Logging utilities for the SDK
- */
-/**
- * Log a deprecation warning. Each unique message is only logged once per process.
- */
-export declare function logDeprecation(message: string): void;
-/**
- * Reset the set of logged deprecation warnings.
- * Useful for testing.
- */
-export declare function resetDeprecationWarnings(): void;
+export declare const logDeprecation: (message: string) => void, resetDeprecationWarnings: () => void;
 //# sourceMappingURL=logging.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/utils/logging.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAIpD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/utils/logging.ts"],"names":[],"mappings":"AAEA,eAAO,MAAQ,cAAc,6BAAE,wBAAwB,YAChB,CAAC"}

package/dist/utils/logging.js

@@ -1,20 +1,2 @@
-/**
- * Logging utilities for the SDK
- */
-const loggedDeprecations = new Set();
-/**
- * Log a deprecation warning. Each unique message is only logged once per process.
- */
-export function logDeprecation(message) {
-    if (loggedDeprecations.has(message))
-        return;
-    loggedDeprecations.add(message);
-    console.warn(`[zapier-sdk] Deprecation: ${message}`);
-}
-/**
- * Reset the set of logged deprecation warnings.
- * Useful for testing.
- */
-export function resetDeprecationWarnings() {
-    loggedDeprecations.clear();
-}
+import { createDeprecationLogger } from "kitcore";
+export const { logDeprecation, resetDeprecationWarnings } = createDeprecationLogger("zapier-sdk");

package/dist/utils/pagination.d.ts

@@ -0,0 +1,38 @@
+import type { SdkPage } from "kitcore";
+/**
+ * Pull the cursor token out of a paginated URL's query string. Zapier
+ * endpoints variously use `offset` (most JSON:API responses) or `cursor`
+ * (trigger inbox messages); try the canonical one first and fall back.
+ */
+export declare function extractCursorFromUrl(url: string): string | undefined;
+/**
+ * Adapts a Zapier paginated envelope into `SdkPage<T>`, extracting the cursor
+ * from wherever Zapier puts it:
+ *
+ *  - JSON:API envelope `{ data, links: { next: "<url>?offset=..." } }` →
+ *    cursor from `links.next`.
+ *  - Top-level next URL `{ data, next: "<url>?offset|cursor=..." }`
+ *    (trigger inbox endpoints) → cursor from `next`.
+ *  - No recognized cursor location → `{ data }` (single / last page).
+ *
+ * `data` is passed through as-is — a response without a `data` array is NOT
+ * coerced to an empty page; it trips the page guard in
+ * `createPaginatedFunction`, so a malformed response fails loudly instead of
+ * masquerading as a valid empty page.
+ */
+export declare function adaptZapierPage<T>(response: unknown): SdkPage<T>;
+/**
+ * Shared pagination config for the Zapier plugins whose handler returns a raw
+ * envelope: spread `...zapierPagination` into `createPaginatedPluginMethod` to
+ * supply `adaptZapierPage` as the per-method `adaptPage`.
+ *
+ * Spreading this typed object (rather than writing `adaptPage: adaptZapierPage`
+ * inline) is load-bearing: as a direct property the generic `adaptZapierPage`
+ * is re-instantiated against the config's `NoInfer` adapter slot and collapses
+ * the method's item type to `never`. Spread from this const its type is already
+ * resolved, so it's only checked for assignability and the item type survives.
+ */
+export declare const zapierPagination: {
+    adaptPage: typeof adaptZapierPage;
+};
+//# sourceMappingURL=pagination.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOpE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAkBhE;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB;;CAAiC,CAAC"}

package/dist/utils/pagination.js

@@ -0,0 +1,53 @@
+/**
+ * Pull the cursor token out of a paginated URL's query string. Zapier
+ * endpoints variously use `offset` (most JSON:API responses) or `cursor`
+ * (trigger inbox messages); try the canonical one first and fall back.
+ */
+export function extractCursorFromUrl(url) {
+    try {
+        const params = new URL(url).searchParams;
+        return params.get("offset") ?? params.get("cursor") ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Adapts a Zapier paginated envelope into `SdkPage<T>`, extracting the cursor
+ * from wherever Zapier puts it:
+ *
+ *  - JSON:API envelope `{ data, links: { next: "<url>?offset=..." } }` →
+ *    cursor from `links.next`.
+ *  - Top-level next URL `{ data, next: "<url>?offset|cursor=..." }`
+ *    (trigger inbox endpoints) → cursor from `next`.
+ *  - No recognized cursor location → `{ data }` (single / last page).
+ *
+ * `data` is passed through as-is — a response without a `data` array is NOT
+ * coerced to an empty page; it trips the page guard in
+ * `createPaginatedFunction`, so a malformed response fails loudly instead of
+ * masquerading as a valid empty page.
+ */
+export function adaptZapierPage(response) {
+    const r = (response ?? {});
+    const data = r.data;
+    const linksNext = r.links?.next;
+    if (typeof linksNext === "string") {
+        return { data, nextCursor: extractCursorFromUrl(linksNext) };
+    }
+    if (typeof r.next === "string") {
+        return { data, nextCursor: extractCursorFromUrl(r.next) };
+    }
+    return { data };
+}
+/**
+ * Shared pagination config for the Zapier plugins whose handler returns a raw
+ * envelope: spread `...zapierPagination` into `createPaginatedPluginMethod` to
+ * supply `adaptZapierPage` as the per-method `adaptPage`.
+ *
+ * Spreading this typed object (rather than writing `adaptPage: adaptZapierPage`
+ * inline) is load-bearing: as a direct property the generic `adaptZapierPage`
+ * is re-instantiated against the config's `NoInfer` adapter slot and collapses
+ * the method's item type to `never`. Spread from this const its type is already
+ * resolved, so it's only checked for assignability and the item type survives.
+ */
+export const zapierPagination = { adaptPage: adaptZapierPage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.64.0",
+  "version": "0.67.0",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -93,7 +93,8 @@
     "@types/node": "^24.0.1",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
-    "vitest": "^4.1.4"
+    "vitest": "^4.1.4",
+    "kitcore": "0.0.0"
   },
   "scripts": {
     "build": "tsup",

package/dist/registry.d.ts

@@ -1,9 +0,0 @@
-import type { PluginMeta } from "./types/plugin";
-import type { RegistryResult } from "./types/registry";
-export type { RegistryResult } from "./types/registry";
-export declare function buildRegistry({ sdk, meta, packageFilter, }: {
-    sdk: Record<string, unknown>;
-    meta: Record<string, PluginMeta>;
-    packageFilter?: string;
-}): RegistryResult;
-//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAiDvD,wBAAgB,aAAa,CAAC,EAC5B,GAAG,EACH,IAAI,EACJ,aAAa,GACd,EAAE;IACD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,cAAc,CAoEjB"}

package/dist/registry.js

@@ -1,103 +0,0 @@
-import { z } from "zod";
-/**
- * Plugins with deprecated parameter aliases declare two schemas: a canonical
- * one (new names only, with `.meta({ aliases })` declarations) and a union
- * of the canonical + a deprecated variant for runtime input parsing. The
- * union form is what `createPluginMethod` stores in plugin meta so SDK
- * callers passing deprecated names keep validating; for the registry — and
- * all downstream consumers (CLI help, MCP tool definitions, generated
- * docs) — we want only the canonical.
- *
- * Convention: when a plugin's `inputSchema` is a `z.ZodUnion`, the first
- * variant is the canonical schema. Every plugin that uses unions today
- * follows this; explicit, easy to enforce, no extra metadata needed.
- */
-function canonicalInputSchema(schema) {
-    if (schema instanceof z.ZodUnion) {
-        return schema.options[0];
-    }
-    return schema;
-}
-const categoryDefinitions = {
-    account: { title: "Account" },
-    app: { title: "App", titlePlural: "Apps" },
-    connection: { title: "Connection" },
-    action: { title: "Action" },
-    "client-credentials": {
-        title: "Client Credentials",
-        titlePlural: "Client Credentials",
-    },
-    table: { title: "Table" },
-    trigger: { title: "Trigger" },
-    "code-workflow": {
-        title: "Code Workflow",
-        titlePlural: "Code Workflows",
-    },
-    http: { title: "HTTP Request" },
-    utility: { title: "Utility", titlePlural: "Utilities" },
-    other: { title: "Other" },
-};
-const knownCategories = Object.keys(categoryDefinitions);
-export function buildRegistry({ sdk, meta, packageFilter, }) {
-    const functions = Object.keys(meta)
-        .filter((key) => {
-        const property = sdk[key];
-        if (typeof property === "function")
-            return true;
-        const [rootKey] = key.split(".");
-        const rootProperty = sdk[rootKey];
-        return typeof rootProperty === "object" && rootProperty !== null;
-    })
-        .map((key) => {
-        const m = meta[key];
-        return {
-            name: key,
-            description: m.description,
-            type: m.type,
-            itemType: m.itemType,
-            returnType: m.returnType,
-            inputSchema: canonicalInputSchema(m.inputSchema),
-            inputParameters: m.inputParameters,
-            outputSchema: m.outputSchema,
-            categories: m.categories || [],
-            resolvers: m.resolvers,
-            formatter: m.formatter,
-            experimental: m.experimental,
-            packages: m.packages,
-            confirm: m.confirm ?? (m.type === "delete" ? "delete" : undefined),
-            deprecation: m.deprecation,
-            aliases: m.aliases,
-            supportsJsonOutput: m.supportsJsonOutput ?? true,
-        };
-    })
-        .sort((a, b) => a.name.localeCompare(b.name));
-    const filteredFunctions = packageFilter
-        ? functions.filter((f) => !f.packages || f.packages.includes(packageFilter))
-        : functions;
-    const filteredCategories = knownCategories
-        .slice()
-        .sort((a, b) => {
-        if (a === "other")
-            return 1;
-        if (b === "other")
-            return -1;
-        return categoryDefinitions[a].title.localeCompare(categoryDefinitions[b].title);
-    })
-        .map((categoryKey) => {
-        const categoryFunctions = filteredFunctions
-            .filter((f) => f.categories.includes(categoryKey) ||
-            (categoryKey === "other" &&
-                !f.categories.some((c) => knownCategories.includes(c))))
-            .map((f) => f.name)
-            .sort();
-        const definition = categoryDefinitions[categoryKey];
-        return {
-            key: categoryKey,
-            title: definition.title,
-            titlePlural: definition.titlePlural ?? `${definition.title}s`,
-            functions: categoryFunctions,
-        };
-    })
-        .filter((category) => category.functions.length > 0);
-    return { functions: filteredFunctions, categories: filteredCategories };
-}

package/dist/types/meta.d.ts

@@ -1,9 +0,0 @@
-declare module "zod" {
-    interface GlobalMeta {
-        internal?: boolean;
-        deprecated?: boolean;
-        valueHint?: string;
-    }
-}
-export {};
-//# sourceMappingURL=meta.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/types/meta.ts"],"names":[],"mappings":"AAGA,OAAO,QAAQ,KAAK,CAAC;IACnB,UAAU,UAAU;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CACF;AAGD,OAAO,EAAE,CAAC"}

package/dist/types/meta.js

@@ -1,3 +0,0 @@
-// Augment the Zod Metadata Registry
-// https://zod.dev/metadata?id=metadata
-export {};

package/dist/types/plugin.d.ts

@@ -1,84 +0,0 @@
-/**
- * ------------------------------
- * Plugin Type System
- * ------------------------------
- *
- * 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 { RegistryResult } from "./registry";
-export interface PluginProvides extends Record<string, any> {
-    context?: {
-        meta?: Record<string, PluginMeta>;
-        [key: string]: any;
-    };
-}
-export interface PluginMeta {
-    /**
-     * Human-readable description of the plugin function. Used by the CLI (help text),
-     * MCP (tool description), and README generators. When omitted, falls back to
-     * the inputSchema's `.describe()` value or a generic placeholder.
-     */
-    description?: string;
-    categories?: string[];
-    type?: "list" | "item" | "create" | "update" | "delete" | "function";
-    itemType?: string;
-    returnType?: string;
-    inputSchema?: z.ZodSchema;
-    outputSchema?: z.ZodSchema;
-    resolvers?: Record<string, any>;
-    /** Confirmation prompt type - prompts user before executing */
-    confirm?: "create-secret" | "delete";
-    /**
-     * Marks this plugin as experimental — registered only in the
-     * `@zapier/zapier-sdk/experimental` factory and badged in
-     * generated docs / CLI help. Access is gated structurally by the
-     * subpath import: stable callers can't reach experimental methods
-     * because the stable SDK type and runtime registry don't include
-     * them. No runtime capability check.
-     */
-    experimental?: boolean;
-    [key: string]: any;
-}
-/**
- * Plugin interface — 2 type params:
- *
- *   TSdk = what this plugin needs (the SDK shape including context)
- *   TProvides = what this plugin returns (a partial SDK shape)
- *
- * The sdk param always includes context.meta, even if TSdk doesn't declare it.
- */
-export interface Plugin<TSdk = {}, TProvides extends PluginProvides = PluginProvides> {
-    (sdk: TSdk & {
-        context: {
-            meta: Record<string, PluginMeta>;
-        };
-    }): TProvides;
-}
-/**
- * Takes an SDK shape and adds addPlugin and getRegistry methods to it.
- * addPlugin merges a plugin's result into the shape, producing a new SDK.
- * Use composePlugins(...) to bundle multiple plugins into one before
- * adding — addPlugin itself is single-plugin only, which keeps inference
- * stable through long chains.
- * getRegistry is a lazy view over context.meta, available on every sdk
- * produced by buildSdk regardless of plugin order.
- */
-export type WithAddPlugin<T = {
-    context: {
-        meta: Record<string, PluginMeta>;
-    };
-}> = T & {
-    addPlugin<TProvides extends PluginProvides>(plugin: Plugin<T, TProvides>, options?: {
-        override?: boolean;
-    }): WithAddPlugin<T & TProvides>;
-    getRegistry(options?: {
-        package?: string;
-    }): RegistryResult;
-};
-//# sourceMappingURL=plugin.d.ts.map

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

@@ -1 +0,0 @@
-{"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;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,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,GAAG,QAAQ,GAAG,UAAU,CAAC;IACrE,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;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,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;;;;;;;;GAQG;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,EAC5B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,aAAa,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAChC,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,CAAC;CAC7D,CAAC"}

package/dist/types/plugin.js

@@ -1,13 +0,0 @@
-/**
- * ------------------------------
- * Plugin Type System
- * ------------------------------
- *
- * 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.
- */
-export {};

package/dist/types/registry.d.ts

@@ -1,54 +0,0 @@
-import type { z } from "zod";
-import type { OutputFormatter } from "../utils/schema-utils";
-export interface FunctionRegistryEntry {
-    name: string;
-    /**
-     * Human-readable description of the function. Surfaced as CLI help text,
-     * MCP tool description, and README documentation. Prefer providing this
-     * directly rather than relying solely on inputSchema.describe().
-     */
-    description?: string;
-    type?: "list" | "item" | "create" | "update" | "delete" | "function";
-    itemType?: string;
-    returnType?: string;
-    inputSchema?: z.ZodSchema;
-    inputParameters?: Array<{
-        name: string;
-        schema: z.ZodSchema;
-    }>;
-    outputSchema?: z.ZodSchema;
-    categories: string[];
-    resolvers?: Record<string, any>;
-    packages?: string[];
-    /**
-     * True if the plugin is registered only in the experimental SDK
-     * factory. See `PluginMeta.experimental`.
-     */
-    experimental?: boolean;
-    /** Confirmation prompt type - prompts user before executing */
-    confirm?: "create-secret" | "delete";
-    /**
-     * Optional deprecation metadata for commands.
-     */
-    deprecation?: FunctionDeprecation;
-    /** Short flag aliases for CLI options (e.g., { request: "X", header: "H" }) */
-    aliases?: Record<string, string>;
-    /** Output formatter with optional page-level enrichment (mirrors resolvers for output) */
-    formatter?: OutputFormatter;
-    /** Defaults to true. Set to false to suppress --json (e.g. login/logout/init). */
-    supportsJsonOutput: boolean;
-}
-export interface FunctionDeprecation {
-    /** User-facing deprecation message for why/how to migrate */
-    message: string;
-}
-export interface RegistryResult {
-    functions: FunctionRegistryEntry[];
-    categories: {
-        key: string;
-        title: string;
-        titlePlural: string;
-        functions: string[];
-    }[];
-}
-//# sourceMappingURL=registry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/types/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC;IAC1B,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAA;KAAE,CAAC,CAAC;IAC/D,YAAY,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,CAAC;IACrC;;OAEG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,0FAA0F;IAC1F,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,kFAAkF;IAClF,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,UAAU,EAAE;QACV,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,EAAE,CAAC;CACL"}

package/dist/types/registry.js

@@ -1 +0,0 @@
-export {};

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

@@ -1,59 +0,0 @@
-/**
- * Generic utility functions for creating paginated SDK functions
- */
-import type { z } from "zod";
-import type { PaginatedSdkResult } from "../types/functions";
-/**
- * Callbacks for telemetry events during function execution
- */
-export interface TelemetryCallbacks {
-    onMethodCalled?: (data: {
-        methodName: string;
-        durationMs: number;
-        success: boolean;
-        error?: Error;
-        argumentCount: number;
-        isPaginated: boolean;
-    }) => void;
-}
-/**
- * Helper function to extract cursor from pagination data
- * Supports JSON:API style `links.next` URLs by extracting the `offset` parameter.
- */
-export declare function extractCursor(data: {
-    next?: string | null;
-} | null | undefined): string | undefined;
-/**
- * Higher-order function that creates a function from a core function
- *
- * @param coreFn - Function that returns T directly or throws errors
- * @param schema - Optional Zod schema for validation
- * @param telemetry - Optional telemetry callbacks
- * @returns A function that normalizes and rethrows errors
- */
-export declare function createFunction<TOptions, TResult, TSchemaOptions extends TOptions = TOptions>(coreFn: (options: TOptions) => Promise<TResult>, schema?: z.ZodSchema<TSchemaOptions>, telemetry?: TelemetryCallbacks): (options?: TOptions) => Promise<TResult>;
-/**
- * Higher-order function that creates a paginated function that wraps results in {data}
- *
- * @param coreFn - Function that returns T directly or throws errors
- * @returns A function that normalizes errors and wraps results in {data}
- */
-/**
- * Extract the item type from a page handler's return shape. The handler
- * may return a flat `{ data: TItem[] }` (or single `data: TItem`), a bare
- * array, or a JSON:API envelope; in all cases the wrapper normalizes to
- * `SdkPage<TItem>` and this resolves the right `TItem`.
- */
-type ItemType<TResult> = TResult extends {
-    data: infer TData;
-} ? TData extends readonly (infer TItem)[] ? TItem : TData : TResult extends readonly (infer TItem)[] ? TItem : TResult;
-export declare function createPaginatedFunction<TUserOptions, TResult>(coreFn: (options: TUserOptions & {
-    cursor?: string;
-    pageSize?: number;
-}) => Promise<TResult>, schema?: z.ZodSchema<TUserOptions>, telemetry?: TelemetryCallbacks, explicitFunctionName?: string, defaultPageSize?: number): (options?: TUserOptions & {
-    cursor?: string;
-    pageSize?: number;
-    maxItems?: number;
-}) => PaginatedSdkResult<ItemType<TResult>>;
-export {};
-//# sourceMappingURL=function-utils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"function-utils.d.ts","sourceRoot":"","sources":["../../src/utils/function-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAM7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAQ7D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,OAAO,CAAC;KACtB,KAAK,IAAI,CAAC;CACZ;AAUD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAChD,MAAM,GAAG,SAAS,CAYpB;AAyBD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EACR,OAAO,EACP,cAAc,SAAS,QAAQ,GAAG,QAAQ,EAE1C,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,EAC/C,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,EACpC,SAAS,CAAC,EAAE,kBAAkB,cAMc,QAAQ,KAAG,OAAO,CAAC,OAAO,CAAC,CAsExE;AA6DD;;;;;GAKG;AACH;;;;;GAKG;AACH,KAAK,QAAQ,CAAC,OAAO,IAAI,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,KAAK,CAAA;CAAE,GAC1D,KAAK,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,GACpC,KAAK,GACL,KAAK,GACP,OAAO,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,GACtC,KAAK,GACL,OAAO,CAAC;AAEd,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,OAAO,EAC3D,MAAM,EAAE,CACN,OAAO,EAAE,YAAY,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,KAC3D,OAAO,CAAC,OAAO,CAAC,EACrB,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,EAClC,SAAS,CAAC,EAAE,kBAAkB,EAC9B,oBAAoB,CAAC,EAAE,MAAM,EAC7B,eAAe,CAAC,EAAE,MAAM,GACvB,CACD,OAAO,CAAC,EAAE,YAAY,GAAG;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KACE,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAiHzC"}