@zapier/zapier-sdk 0.33.4 → 0.34.1

package/dist/types/errors.d.ts

@@ -24,6 +24,7 @@ export interface ErrorOptions {
  */
 export declare abstract class ZapierError extends Error {
     abstract readonly name: string;
+    abstract readonly code: string;
     statusCode?: number;
     errors?: ApiError[];
     cause?: unknown;
@@ -35,6 +36,7 @@ export declare abstract class ZapierError extends Error {
  */
 export declare class ZapierApiError extends ZapierError {
     readonly name = "ZapierApiError";
+    readonly code: "ZAPIER_API_ERROR";
     constructor(message: string, options?: ErrorOptions);
 }
 /**
@@ -42,6 +44,7 @@ export declare class ZapierApiError extends ZapierError {
  */
 export declare class ZapierAppNotFoundError extends ZapierError {
     readonly name = "ZapierAppNotFoundError";
+    readonly code: "ZAPIER_APP_NOT_FOUND_ERROR";
     appKey?: string;
     constructor(message: string, options?: ErrorOptions & {
         appKey?: string;
@@ -52,6 +55,7 @@ export declare class ZapierAppNotFoundError extends ZapierError {
  */
 export declare class ZapierValidationError extends ZapierError {
     readonly name = "ZapierValidationError";
+    readonly code: "ZAPIER_VALIDATION_ERROR";
     details?: unknown;
     constructor(message: string, options?: ErrorOptions & {
         details?: unknown;
@@ -62,6 +66,7 @@ export declare class ZapierValidationError extends ZapierError {
  */
 export declare class ZapierUnknownError extends ZapierError {
     readonly name = "ZapierUnknownError";
+    readonly code: "ZAPIER_UNKNOWN_ERROR";
     constructor(message: string, options?: ErrorOptions);
 }
 /**
@@ -69,6 +74,7 @@ export declare class ZapierUnknownError extends ZapierError {
  */
 export declare class ZapierAuthenticationError extends ZapierError {
     readonly name = "ZapierAuthenticationError";
+    readonly code: "ZAPIER_AUTHENTICATION_ERROR";
     constructor(message: string, options?: ErrorOptions);
 }
 /**
@@ -76,6 +82,7 @@ export declare class ZapierAuthenticationError extends ZapierError {
  */
 export declare class ZapierResourceNotFoundError extends ZapierError {
     readonly name = "ZapierResourceNotFoundError";
+    readonly code: "ZAPIER_RESOURCE_NOT_FOUND_ERROR";
     resourceType?: string;
     resourceId?: string;
     constructor(message: string, options?: ErrorOptions & {
@@ -88,6 +95,7 @@ export declare class ZapierResourceNotFoundError extends ZapierError {
  */
 export declare class ZapierConfigurationError extends ZapierError {
     readonly name = "ZapierConfigurationError";
+    readonly code: "ZAPIER_CONFIGURATION_ERROR";
     configType?: string;
     constructor(message: string, options?: ErrorOptions & {
         configType?: string;
@@ -98,6 +106,7 @@ export declare class ZapierConfigurationError extends ZapierError {
  */
 export declare class ZapierBundleError extends ZapierError {
     readonly name = "ZapierBundleError";
+    readonly code: "ZAPIER_BUNDLE_ERROR";
     buildErrors?: string[];
     constructor(message: string, options?: ErrorOptions & {
         buildErrors?: string[];
@@ -108,6 +117,7 @@ export declare class ZapierBundleError extends ZapierError {
  */
 export declare class ZapierTimeoutError extends ZapierError {
     readonly name = "ZapierTimeoutError";
+    readonly code: "ZAPIER_TIMEOUT_ERROR";
     attempts?: number;
     maxAttempts?: number;
     constructor(message: string, options?: ErrorOptions & {
@@ -121,6 +131,7 @@ export declare class ZapierTimeoutError extends ZapierError {
  */
 export declare class ZapierActionError extends ZapierError {
     readonly name = "ZapierActionError";
+    readonly code: "ZAPIER_ACTION_ERROR";
     appKey?: string;
     actionKey?: string;
     constructor(message: string, options?: ErrorOptions & {
@@ -134,6 +145,7 @@ export declare class ZapierActionError extends ZapierError {
  */
 export declare class ZapierNotFoundError extends ZapierError {
     readonly name = "ZapierNotFoundError";
+    readonly code: "ZAPIER_NOT_FOUND_ERROR";
     constructor(message: string, options?: ErrorOptions);
 }
 /**
@@ -154,6 +166,7 @@ export interface RateLimitInfo {
  */
 export declare class ZapierRateLimitError extends ZapierError {
     readonly name = "ZapierRateLimitError";
+    readonly code: "ZAPIER_RATE_LIMIT_ERROR";
     rateLimit: RateLimitInfo;
     retries: number;
     constructor(message: string, options?: ErrorOptions & {
@@ -167,6 +180,7 @@ export declare class ZapierRateLimitError extends ZapierError {
  */
 export declare class ZapierRelayError extends ZapierError {
     readonly name = "ZapierRelayError";
+    readonly code: "ZAPIER_RELAY_ERROR";
     constructor(message: string, options?: ErrorOptions);
 }
 /**

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

@@ -20,6 +20,7 @@ export class ZapierApiError extends ZapierError {
     constructor(message, options = {}) {
         super(message, options);
         this.name = "ZapierApiError";
+        this.code = "ZAPIER_API_ERROR";
     }
 }
 /**
@@ -29,6 +30,7 @@ export class ZapierAppNotFoundError extends ZapierError {
     constructor(message, options = {}) {
         super(message, options);
         this.name = "ZapierAppNotFoundError";
+        this.code = "ZAPIER_APP_NOT_FOUND_ERROR";
         this.appKey = options.appKey;
     }
 }
@@ -39,6 +41,7 @@ export class ZapierValidationError extends ZapierError {
     constructor(message, options = {}) {
         super(message, options);
         this.name = "ZapierValidationError";
+        this.code = "ZAPIER_VALIDATION_ERROR";
         this.details = options.details;
     }
 }
@@ -49,6 +52,7 @@ export class ZapierUnknownError extends ZapierError {
     constructor(message, options = {}) {
         super(message, options);
         this.name = "ZapierUnknownError";
+        this.code = "ZAPIER_UNKNOWN_ERROR";
     }
 }
 /**
@@ -58,6 +62,7 @@ export class ZapierAuthenticationError extends ZapierError {
     constructor(message, options = {}) {
         super(message, options);
         this.name = "ZapierAuthenticationError";
+        this.code = "ZAPIER_AUTHENTICATION_ERROR";
     }
 }
 /**
@@ -67,6 +72,7 @@ export class ZapierResourceNotFoundError extends ZapierError {
     constructor(message, options = {}) {
         super(message, options);
         this.name = "ZapierResourceNotFoundError";
+        this.code = "ZAPIER_RESOURCE_NOT_FOUND_ERROR";
         this.resourceType = options.resourceType;
         this.resourceId = options.resourceId;
     }
@@ -78,6 +84,7 @@ export class ZapierConfigurationError extends ZapierError {
     constructor(message, options = {}) {
         super(message, options);
         this.name = "ZapierConfigurationError";
+        this.code = "ZAPIER_CONFIGURATION_ERROR";
         this.configType = options.configType;
     }
 }
@@ -88,6 +95,7 @@ export class ZapierBundleError extends ZapierError {
     constructor(message, options = {}) {
         super(message, options);
         this.name = "ZapierBundleError";
+        this.code = "ZAPIER_BUNDLE_ERROR";
         this.buildErrors = options.buildErrors;
     }
 }
@@ -98,6 +106,7 @@ export class ZapierTimeoutError extends ZapierError {
     constructor(message, options = {}) {
         super(message, options);
         this.name = "ZapierTimeoutError";
+        this.code = "ZAPIER_TIMEOUT_ERROR";
         this.attempts = options.attempts;
         this.maxAttempts = options.maxAttempts;
     }
@@ -110,6 +119,7 @@ export class ZapierActionError extends ZapierError {
     constructor(message, options = {}) {
         super(message, options);
         this.name = "ZapierActionError";
+        this.code = "ZAPIER_ACTION_ERROR";
         this.appKey = options.appKey;
         this.actionKey = options.actionKey;
     }
@@ -125,6 +135,7 @@ export class ZapierNotFoundError extends ZapierError {
     constructor(message, options = {}) {
         super(message, options);
         this.name = "ZapierNotFoundError";
+        this.code = "ZAPIER_NOT_FOUND_ERROR";
     }
 }
 /**
@@ -134,6 +145,7 @@ export class ZapierRateLimitError extends ZapierError {
     constructor(message, options = {}) {
         super(message, options);
         this.name = "ZapierRateLimitError";
+        this.code = "ZAPIER_RATE_LIMIT_ERROR";
         this.rateLimit = options.rateLimit ?? {};
         this.retries = options.retries ?? 0;
     }
@@ -146,6 +158,7 @@ export class ZapierRelayError extends ZapierError {
     constructor(message, options = {}) {
         super(message, options);
         this.name = "ZapierRelayError";
+        this.code = "ZAPIER_RELAY_ERROR";
     }
 }
 /**

package/dist/types/functions.d.ts

@@ -16,12 +16,11 @@ export interface FunctionOptions {
     /** Custom fetch implementation */
     fetch?: typeof globalThis.fetch;
 }
-export type PaginatedSdkFunction<TOptions, TItem> = (options: TOptions) => Promise<{
-    data: TItem[];
-}> & AsyncIterable<{
-    data: TItem[];
+export interface SdkPage<T = unknown> {
+    data: T[];
     nextCursor?: string;
-}> & {
+}
+export type PaginatedSdkFunction<TOptions, TItem> = (options: TOptions) => Promise<SdkPage<TItem>> & AsyncIterable<SdkPage<TItem>> & {
     items(): AsyncIterable<TItem>;
 };
 //# sourceMappingURL=functions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../src/types/functions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C;;GAEG;AAGH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,2CAA2C;IAC3C,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kCAAkC;IAClC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAGD,MAAM,MAAM,oBAAoB,CAAC,QAAQ,EAAE,KAAK,IAAI,CAClD,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC;IAAE,IAAI,EAAE,KAAK,EAAE,CAAA;CAAE,CAAC,GAC7B,aAAa,CAAC;IAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG;IACtD,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;CAC/B,CAAC"}
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../src/types/functions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C;;GAEG;AAGH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,2CAA2C;IAC3C,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kCAAkC;IAClC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,OAAO;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,MAAM,oBAAoB,CAAC,QAAQ,EAAE,KAAK,IAAI,CAClD,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAC1B,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG;IAC9B,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;CAC/B,CAAC"}

package/dist/types/sdk.d.ts

@@ -126,6 +126,8 @@ export interface FunctionRegistryEntry {
     deprecatedParameters?: string[];
     /** Short flag aliases for CLI options (e.g., { request: "X", header: "H" }) */
     aliases?: Record<string, string>;
+    /** 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 */

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

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

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

@@ -7,14 +7,20 @@ type TPageOptions<TOptions> = TOptions extends undefined ? {
     maxItems?: number;
     pageSize?: number;
 };
+export declare function decodeIncomingCursor(incoming?: string): {
+    offset: number;
+    cursor: string | undefined;
+};
 export declare function createPrefixedCursor(prefix: string, cursor: string | undefined): string;
 export declare function splitPrefixedCursor(cursor: string | undefined, prefixes?: string[]): [string | undefined, string | undefined];
 /**
- * Utility for paginating through API endpoints that return cursor-based pages
+ * Utility for paginating through API endpoints that return cursor-based pages.
+ * Accepts and yields SDK-encoded cursor envelopes. Any incoming cursor is decoded
+ * before being passed to the page function; all outgoing cursors are encoded.
  *
  * @param pageFunction - Function that fetches a single page with {data, nextCursor} structure
  * @param pageOptions - Options to pass to the page function (cursor will be managed automatically)
- * @returns Async iterator that yields pages
+ * @returns Async iterator that yields pages with encoded cursors
  */
 export declare function paginateMaxItems<TOptions, TPage extends {
     data: any[];

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

@@ -1 +1 @@
-{"version":3,"file":"pagination-utils.d.ts","sourceRoot":"","sources":["../../src/utils/pagination-utils.ts"],"names":[],"mappings":"AAEA,KAAK,YAAY,CAAC,QAAQ,IAAI,QAAQ,SAAS,SAAS,GACpD;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD,QAAQ,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAoCzE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,CAKR;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,CAkB1C;AAED;;;;;;GAMG;AACH,wBAAuB,gBAAgB,CACrC,QAAQ,EACR,KAAK,SAAS;IAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAElD,YAAY,EAAE,CACZ,OAAO,EAAE,QAAQ,GAAG;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KACE,OAAO,CAAC,KAAK,CAAC,EACnB,WAAW,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,GACnC,qBAAqB,CAAC,KAAK,CAAC,CAoC9B;AAED,wBAAuB,gBAAgB,CACrC,QAAQ,EACR,KAAK,SAAS;IAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAElD,YAAY,EAAE,CACZ,OAAO,EAAE,QAAQ,GAAG;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KACE,OAAO,CAAC,KAAK,CAAC,EACnB,WAAW,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,GACnC,qBAAqB,CAAC,KAAK,CAAC,CAiG9B;AAED,eAAO,MAAM,QAAQ,yBAAmB,CAAC"}
+{"version":3,"file":"pagination-utils.d.ts","sourceRoot":"","sources":["../../src/utils/pagination-utils.ts"],"names":[],"mappings":"AAsBA,KAAK,YAAY,CAAC,QAAQ,IAAI,QAAQ,SAAS,SAAS,GACpD;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD,QAAQ,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAmCzE,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CAyBA;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,CAKR;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,CAAC,MAAM,GAAG,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,CAkB1C;AAuDD;;;;;;;;GAQG;AACH,wBAAuB,gBAAgB,CACrC,QAAQ,EACR,KAAK,SAAS;IAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAElD,YAAY,EAAE,CACZ,OAAO,EAAE,QAAQ,GAAG;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KACE,OAAO,CAAC,KAAK,CAAC,EACnB,WAAW,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,GACnC,qBAAqB,CAAC,KAAK,CAAC,CAkB9B;AAED,wBAAuB,gBAAgB,CACrC,QAAQ,EACR,KAAK,SAAS;IAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAElD,YAAY,EAAE,CACZ,OAAO,EAAE,QAAQ,GAAG;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KACE,OAAO,CAAC,KAAK,CAAC,EACnB,WAAW,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,GACnC,qBAAqB,CAAC,KAAK,CAAC,CA2H9B;AAED,eAAO,MAAM,QAAQ,yBAAmB,CAAC"}

package/dist/utils/pagination-utils.js

@@ -1,29 +1,53 @@
-const offsetCursorMarker = "$$offset$$";
-function splitOffsetCursor(cursor) {
-    if (!cursor) {
-        return [0, cursor];
+const CURSOR_VERSION = 1;
+const CURSOR_SOURCE = {
+    API: "api",
+    SDK: "sdk",
+};
+function encodeBase64(str) {
+    return btoa(Array.from(new TextEncoder().encode(str), (b) => String.fromCharCode(b)).join(""));
+}
+function decodeBase64(str) {
+    return new TextDecoder().decode(Uint8Array.from(atob(str), (c) => c.charCodeAt(0)));
+}
+function encodeApiCursor(cursor) {
+    const envelope = {
+        v: CURSOR_VERSION,
+        source: CURSOR_SOURCE.API,
+        cursor,
+    };
+    return encodeBase64(JSON.stringify(envelope));
+}
+function encodeSdkCursor(offset, cursor) {
+    const envelope = {
+        v: CURSOR_VERSION,
+        source: CURSOR_SOURCE.SDK,
+        cursor,
+        offset,
+    };
+    return encodeBase64(JSON.stringify(envelope));
+}
+export function decodeIncomingCursor(incoming) {
+    if (!incoming) {
+        return { offset: 0, cursor: undefined };
     }
     try {
-        const parsedCursor = JSON.parse(cursor);
-        if (!Array.isArray(parsedCursor)) {
-            return [0, cursor];
+        const decoded = decodeBase64(incoming);
+        const envelope = JSON.parse(decoded);
+        if (envelope.v !== CURSOR_VERSION) {
+            return { offset: 0, cursor: incoming };
         }
-        const [marker, offset, currentCursor] = parsedCursor;
-        if (marker !== offsetCursorMarker) {
-            return [0, cursor];
+        if (envelope.source === CURSOR_SOURCE.SDK) {
+            return { offset: envelope.offset ?? 0, cursor: envelope.cursor };
         }
-        if (typeof offset !== "number") {
-            return [0, cursor];
+        if (envelope.source === CURSOR_SOURCE.API) {
+            return { offset: 0, cursor: envelope.cursor };
         }
-        return [offset, currentCursor];
+        return { offset: 0, cursor: incoming };
     }
     catch {
-        return [0, cursor];
+        return { offset: 0, cursor: incoming };
     }
 }
-function createOffsetCursor(offset, currentCursor) {
-    return JSON.stringify([offsetCursorMarker, offset, currentCursor]);
-}
 export function createPrefixedCursor(prefix, cursor) {
     if (!cursor) {
         return `${prefix}::`;
@@ -45,13 +69,10 @@ export function splitPrefixedCursor(cursor, prefixes) {
     return [prefix, cursor];
 }
 /**
- * Utility for paginating through API endpoints that return cursor-based pages
- *
- * @param pageFunction - Function that fetches a single page with {data, nextCursor} structure
- * @param pageOptions - Options to pass to the page function (cursor will be managed automatically)
- * @returns Async iterator that yields pages
+ * Internal primitive: paginates through a page function using raw (unencoded) cursors.
+ * Encoding and decoding of cursors is the responsibility of the public wrappers.
  */
-export async function* paginateMaxItems(pageFunction, pageOptions) {
+async function* paginateMaxItemsWithUnencodedCursor(pageFunction, pageOptions) {
     let cursor = pageOptions?.cursor;
     let totalItemsYielded = 0;
     const maxItems = pageOptions?.maxItems;
@@ -68,12 +89,11 @@ export async function* paginateMaxItems(pageFunction, pageOptions) {
         if (maxItems !== undefined) {
             const remainingItems = maxItems - totalItemsYielded;
             if (page.data.length >= remainingItems) {
-                const yieldedPage = {
+                yield {
                     ...page,
                     data: page.data.slice(0, remainingItems),
                     nextCursor: undefined,
                 };
-                yield yieldedPage;
                 break;
             }
         }
@@ -82,18 +102,60 @@ export async function* paginateMaxItems(pageFunction, pageOptions) {
         cursor = page.nextCursor;
     } while (cursor);
 }
+/**
+ * Utility for paginating through API endpoints that return cursor-based pages.
+ * Accepts and yields SDK-encoded cursor envelopes. Any incoming cursor is decoded
+ * before being passed to the page function; all outgoing cursors are encoded.
+ *
+ * @param pageFunction - Function that fetches a single page with {data, nextCursor} structure
+ * @param pageOptions - Options to pass to the page function (cursor will be managed automatically)
+ * @returns Async iterator that yields pages with encoded cursors
+ */
+export async function* paginateMaxItems(pageFunction, pageOptions) {
+    const { cursor } = decodeIncomingCursor(pageOptions?.cursor);
+    const options = {
+        ...(pageOptions || {}),
+        cursor,
+    };
+    for await (const page of paginateMaxItemsWithUnencodedCursor(pageFunction, options)) {
+        yield {
+            ...page,
+            nextCursor: page.nextCursor
+                ? encodeApiCursor(page.nextCursor)
+                : undefined,
+        };
+    }
+}
 export async function* paginateBuffered(pageFunction, pageOptions) {
     const pageSize = pageOptions?.pageSize;
-    const [cursorOffset, currentCursor] = splitOffsetCursor(pageOptions?.cursor);
+    const { offset: cursorOffset, cursor: initialCursor } = decodeIncomingCursor(pageOptions?.cursor);
+    const requestedMaxItems = pageOptions?.maxItems;
     const options = {
         ...(pageOptions || {}),
-        cursor: currentCursor,
+        cursor: initialCursor,
+        // SDK cursors can carry an offset into a raw backend page. Since maxItems
+        // is expected to be relative to the resumed position, we add that offset
+        // so raw pagination still yields enough items after offset slicing.
+        maxItems: requestedMaxItems !== undefined && cursorOffset > 0
+            ? requestedMaxItems + cursorOffset
+            : requestedMaxItems,
     };
-    const iterator = paginateMaxItems(pageFunction, options);
+    if (!pageSize) {
+        for await (const page of paginateMaxItemsWithUnencodedCursor(pageFunction, options)) {
+            yield {
+                ...page,
+                nextCursor: page.nextCursor
+                    ? encodeApiCursor(page.nextCursor)
+                    : undefined,
+            };
+        }
+        return;
+    }
     let bufferedPages = [];
     let isFirstPage = true;
-    let cursor;
-    for await (let page of iterator) {
+    let rawCursor;
+    for await (let page of paginateMaxItemsWithUnencodedCursor(pageFunction, options)) {
+        const nextRawCursor = page.nextCursor;
         if (isFirstPage) {
             isFirstPage = false;
             if (cursorOffset) {
@@ -103,16 +165,11 @@ export async function* paginateBuffered(pageFunction, pageOptions) {
                 };
             }
         }
-        if (!pageSize) {
-            yield page;
-            cursor = page.nextCursor;
-            continue;
-        }
-        const bufferedLength = bufferedPages.reduce((acc, page) => acc + page.data.length, 0);
+        const bufferedLength = bufferedPages.reduce((acc, p) => acc + p.data.length, 0);
         // If we don't have enough to fill a page, buffer this page.
         if (bufferedLength + page.data.length < pageSize) {
             bufferedPages.push(page);
-            cursor = page.nextCursor;
+            rawCursor = nextRawCursor;
             continue;
         }
         // Let's yield a page from our buffered pages.
@@ -125,24 +182,24 @@ export async function* paginateBuffered(pageFunction, pageOptions) {
             yield {
                 ...page,
                 data: pageItems,
-                nextCursor: page.nextCursor,
+                nextCursor: nextRawCursor ? encodeApiCursor(nextRawCursor) : undefined,
             };
             bufferedPages = [];
-            cursor = page.nextCursor;
+            rawCursor = nextRawCursor;
             continue;
         }
         // Yield our items with a cursor to offset into this page.
         yield {
             ...page,
             data: pageItems,
-            nextCursor: createOffsetCursor(page.data.length - remainingItems.length, cursor),
+            nextCursor: encodeSdkCursor(page.data.length - remainingItems.length, rawCursor),
         };
         while (remainingItems.length > pageSize) {
-            const pageItems = remainingItems.splice(0, pageSize);
+            const chunkItems = remainingItems.splice(0, pageSize);
             yield {
                 ...page,
-                data: pageItems,
-                nextCursor: createOffsetCursor(page.data.length - remainingItems.length, cursor),
+                data: chunkItems,
+                nextCursor: encodeSdkCursor(page.data.length - remainingItems.length, rawCursor),
             };
         }
         bufferedPages = [
@@ -151,7 +208,7 @@ export async function* paginateBuffered(pageFunction, pageOptions) {
                 data: remainingItems,
             },
         ];
-        cursor = page.nextCursor;
+        rawCursor = nextRawCursor;
     }
     if (bufferedPages.length > 0) {
         const lastBufferedPage = bufferedPages.slice(-1)[0];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.33.4",
+  "version": "0.34.1",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -46,7 +46,7 @@
     "tsup": "^8.5.0",
     "typescript": "^5.8.3",
     "vitest": "^3.2.3",
-    "@zapier/zapier-sdk-cli-login": "0.8.2"
+    "@zapier/zapier-sdk-cli-login": "0.8.3"
   },
   "scripts": {
     "build": "tsup",