@zapier/zapier-sdk 0.15.4 → 0.15.9

package/dist/temporary-internal-core/schemas/errors/index.js

@@ -0,0 +1,129 @@
+/**
+ * Base class for all Zapier SDK errors
+ * Use instanceof ZapierError to check if an error is from the SDK
+ */
+export class ZapierError extends Error {
+    constructor(message, options = {}) {
+        super(message);
+        this.statusCode = options.statusCode;
+        this.errors = options.errors;
+        this.cause = options.cause;
+        this.response = options.response;
+        // Maintain proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Error thrown when API requests fail
+ */
+export class ZapierApiError extends ZapierError {
+    constructor(message, options = {}) {
+        super(message, options);
+        this.name = "ZapierApiError";
+    }
+}
+/**
+ * Error thrown when an app is not found
+ */
+export class ZapierAppNotFoundError extends ZapierError {
+    constructor(message, options = {}) {
+        super(message, options);
+        this.name = "ZapierAppNotFoundError";
+        this.appKey = options.appKey;
+    }
+}
+/**
+ * Error thrown when validation fails (e.g., invalid parameters)
+ */
+export class ZapierValidationError extends ZapierError {
+    constructor(message, options = {}) {
+        super(message, options);
+        this.name = "ZapierValidationError";
+        this.details = options.details;
+    }
+}
+/**
+ * Error for unrecognized/unknown errors that get wrapped by safe functions
+ */
+export class ZapierUnknownError extends ZapierError {
+    constructor(message, options = {}) {
+        super(message, options);
+        this.name = "ZapierUnknownError";
+    }
+}
+/**
+ * Error thrown for authentication and authorization failures (401/403)
+ */
+export class ZapierAuthenticationError extends ZapierError {
+    constructor(message, options = {}) {
+        super(message, options);
+        this.name = "ZapierAuthenticationError";
+    }
+}
+/**
+ * Error thrown when a requested resource is not found
+ */
+export class ZapierResourceNotFoundError extends ZapierError {
+    constructor(message, options = {}) {
+        super(message, options);
+        this.name = "ZapierResourceNotFoundError";
+        this.resourceType = options.resourceType;
+        this.resourceId = options.resourceId;
+    }
+}
+/**
+ * Error thrown when required app or implementation configuration is missing
+ */
+export class ZapierConfigurationError extends ZapierError {
+    constructor(message, options = {}) {
+        super(message, options);
+        this.name = "ZapierConfigurationError";
+        this.configType = options.configType;
+    }
+}
+/**
+ * Error thrown when code bundling or compilation fails
+ */
+export class ZapierBundleError extends ZapierError {
+    constructor(message, options = {}) {
+        super(message, options);
+        this.name = "ZapierBundleError";
+        this.buildErrors = options.buildErrors;
+    }
+}
+/**
+ * Error thrown when operations timeout or exceed retry limits
+ */
+export class ZapierTimeoutError extends ZapierError {
+    constructor(message, options = {}) {
+        super(message, options);
+        this.name = "ZapierTimeoutError";
+        this.attempts = options.attempts;
+        this.maxAttempts = options.maxAttempts;
+    }
+}
+/**
+ * Error thrown when action execution fails due to errors returned from the third-party service
+ * This happens when the Actions API returns a 200 status but includes errors in the response
+ */
+export class ZapierActionError extends ZapierError {
+    constructor(message, options = {}) {
+        super(message, options);
+        this.name = "ZapierActionError";
+        this.appKey = options.appKey;
+        this.actionKey = options.actionKey;
+    }
+    // Legacy accessor for backward compatibility
+    get actionErrors() {
+        return this.errors;
+    }
+}
+/**
+ * Error thrown when a resource is not found (404)
+ */
+export class ZapierNotFoundError extends ZapierError {
+    constructor(message, options = {}) {
+        super(message, options);
+        this.name = "ZapierNotFoundError";
+    }
+}

package/dist/temporary-internal-core/utils/app-locators.d.ts

@@ -19,26 +19,6 @@ export interface AppLocator {
 export interface ResolvedAppLocator extends AppLocator {
     implementationName: string;
 }
-/**
- * Checks if a string is a valid slug (kebab-case)
- */
-export declare function isSlug(slug: string): boolean;
-/**
- * Checks if a string is a valid snake_case slug
- */
-export declare function isSnakeCasedSlug(slug: string): boolean;
-/**
- * Converts snake_case to kebab-case
- */
-export declare function dashifySnakeCasedSlug(slug: string): string;
-/**
- * Checks if a string is a UUID
- */
-export declare function isUuid(appKey: string): boolean;
-/**
- * Splits a versioned key into base key and version
- */
-export declare function splitVersionedKey(versionedKey: string): [string, string | undefined];
 /**
  * Converts an app key to an app locator structure
  */

package/dist/temporary-internal-core/utils/app-locators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-locators.d.ts","sourceRoot":"","sources":["../../../src/temporary-internal-core/utils/app-locators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKtD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU1D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAI9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,GACnB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAQ9B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAqBvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAEzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,GACrB,UAAU,IAAI,kBAAkB,CAElC"}
+{"version":3,"file":"app-locators.d.ts","sourceRoot":"","sources":["../../../src/temporary-internal-core/utils/app-locators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAqBvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAEzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,UAAU,GACrB,UAAU,IAAI,kBAAkB,CAElC"}

package/dist/temporary-internal-core/utils/app-locators.js

@@ -4,51 +4,7 @@
  * These utilities handle the mapping between user-friendly app identifiers
  * (slugs like "slack") and internal implementation IDs (like "SlackCLIAPI@1.0.0")
  */
-/**
- * Checks if a string is a valid slug (kebab-case)
- */
-export function isSlug(slug) {
-    return !!slug.match(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
-}
-/**
- * Checks if a string is a valid snake_case slug
- */
-export function isSnakeCasedSlug(slug) {
-    if (slug.match(/^_[0-9]/)) {
-        slug = slug.slice(1);
-    }
-    return !!slug.match(/^[a-z0-9]+(?:_[a-z0-9]+)*$/);
-}
-/**
- * Converts snake_case to kebab-case
- */
-export function dashifySnakeCasedSlug(slug) {
-    if (!isSnakeCasedSlug(slug)) {
-        return slug;
-    }
-    if (slug.startsWith("_")) {
-        slug = slug.slice(1);
-    }
-    return slug.replace(/_/g, "-");
-}
-/**
- * Checks if a string is a UUID
- */
-export function isUuid(appKey) {
-    return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(appKey);
-}
-/**
- * Splits a versioned key into base key and version
- */
-export function splitVersionedKey(versionedKey) {
-    const parts = versionedKey.split("@");
-    if (parts.length >= 2) {
-        const baseKey = parts[0];
-        const version = parts.slice(1).join("@");
-        return [baseKey, version];
-    }
-    return [versionedKey, undefined];
-}
+import { dashifySnakeCasedSlug, isSlug, isSnakeCasedSlug, isUuid, splitVersionedKey, } from "./string-utils";
 /**
  * Converts an app key to an app locator structure
  */

package/dist/temporary-internal-core/utils/string-utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Splits a versioned key to extract the base key and version
+ *
+ * @param versionedKey - Versioned key in format "KeyName@version" (e.g., "SlackCLIAPI@1.21.1")
+ * @returns Tuple of [baseKey, version] or [versionedKey, undefined] if no @ symbol
+ *
+ * @example
+ * splitVersionedKey("SlackCLIAPI@1.21.1") // ["SlackCLIAPI", "1.21.1"]
+ * splitVersionedKey("SomeAPI") // ["SomeAPI", undefined]
+ */
+export declare function splitVersionedKey(versionedKey: string): [string, string | undefined];
+/**
+ * Checks if a string is a valid slug (kebab-case)
+ */
+export declare function isSlug(slug: string): boolean;
+/**
+ * Checks if a string is a valid snake_case slug
+ */
+export declare function isSnakeCasedSlug(slug: string): boolean;
+/**
+ * Converts snake_case to kebab-case
+ */
+export declare function dashifySnakeCasedSlug(slug: string): string;
+/**
+ * Checks if a string is a UUID
+ */
+export declare function isUuid(appKey: string): boolean;
+//# sourceMappingURL=string-utils.d.ts.map

package/dist/temporary-internal-core/utils/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../../src/temporary-internal-core/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,GACnB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAQ9B;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKtD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU1D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAI9C"}

package/dist/temporary-internal-core/utils/string-utils.js

@@ -0,0 +1,52 @@
+/**
+ * Splits a versioned key to extract the base key and version
+ *
+ * @param versionedKey - Versioned key in format "KeyName@version" (e.g., "SlackCLIAPI@1.21.1")
+ * @returns Tuple of [baseKey, version] or [versionedKey, undefined] if no @ symbol
+ *
+ * @example
+ * splitVersionedKey("SlackCLIAPI@1.21.1") // ["SlackCLIAPI", "1.21.1"]
+ * splitVersionedKey("SomeAPI") // ["SomeAPI", undefined]
+ */
+export function splitVersionedKey(versionedKey) {
+    const parts = versionedKey.split("@");
+    if (parts.length >= 2) {
+        const baseKey = parts[0];
+        const version = parts.slice(1).join("@"); // Handle edge case of multiple @ symbols
+        return [baseKey, version];
+    }
+    return [versionedKey, undefined];
+}
+/**
+ * Checks if a string is a valid slug (kebab-case)
+ */
+export function isSlug(slug) {
+    return !!slug.match(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
+}
+/**
+ * Checks if a string is a valid snake_case slug
+ */
+export function isSnakeCasedSlug(slug) {
+    if (slug.match(/^_[0-9]/)) {
+        slug = slug.slice(1);
+    }
+    return !!slug.match(/^[a-z0-9]+(?:_[a-z0-9]+)*$/);
+}
+/**
+ * Converts snake_case to kebab-case
+ */
+export function dashifySnakeCasedSlug(slug) {
+    if (!isSnakeCasedSlug(slug)) {
+        return slug;
+    }
+    if (slug.startsWith("_")) {
+        slug = slug.slice(1);
+    }
+    return slug.replace(/_/g, "-");
+}
+/**
+ * Checks if a string is a UUID
+ */
+export function isUuid(appKey) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(appKey);
+}

package/dist/temporary-internal-core/utils/transformations.d.ts

@@ -5,6 +5,7 @@
  */
 import type { ImplementationMeta } from "../schemas/implementations";
 import type { AppItem } from "../schemas/apps";
+import { type Authentication, type AuthenticationItem } from "../schemas/authentications";
 /**
  * Transforms ImplementationMeta from internal API to AppItem for SDK responses
  */
@@ -15,4 +16,17 @@ export declare function transformImplementationMetaToAppItem(implementationMeta:
 export declare function extractPaginationCursor(response: {
     next?: string | null;
 }): string | undefined;
+/**
+ * Converts an API Authentication to an AuthenticationItem with normalized field names
+ *
+ * @param auth - Raw Authentication from API
+ * @param options - Additional fields to include
+ * @param options.app_key - selected_api from implementations endpoint
+ * @param options.app_version - Version extracted from selected_api
+ * @returns Normalized AuthenticationItem
+ */
+export declare function normalizeAuthenticationItem(auth: Authentication, options?: {
+    app_key?: string;
+    app_version?: string;
+}): AuthenticationItem;
 //# sourceMappingURL=transformations.d.ts.map

package/dist/temporary-internal-core/utils/transformations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transformations.d.ts","sourceRoot":"","sources":["../../../src/temporary-internal-core/utils/transformations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,kBAAkB,EAAE,kBAAkB,GACrC,OAAO,CAYT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE;IAChD,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,GAAG,MAAM,GAAG,SAAS,CAYrB"}
+{"version":3,"file":"transformations.d.ts","sourceRoot":"","sources":["../../../src/temporary-internal-core/utils/transformations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AAEpC;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,kBAAkB,EAAE,kBAAkB,GACrC,OAAO,CAYT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE;IAChD,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,GAAG,MAAM,GAAG,SAAS,CAYrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,kBAAkB,CAqCpB"}

package/dist/temporary-internal-core/utils/transformations.js

@@ -3,7 +3,7 @@
  *
  * These will move to SDK API server as part of the response transformation layer
  */
-import { splitVersionedKey } from "./app-locators";
+import { splitVersionedKey } from "./string-utils";
 /**
  * Transforms ImplementationMeta from internal API to AppItem for SDK responses
  */
@@ -34,3 +34,39 @@ export function extractPaginationCursor(response) {
         return undefined;
     }
 }
+/**
+ * Converts an API Authentication to an AuthenticationItem with normalized field names
+ *
+ * @param auth - Raw Authentication from API
+ * @param options - Additional fields to include
+ * @param options.app_key - selected_api from implementations endpoint
+ * @param options.app_version - Version extracted from selected_api
+ * @returns Normalized AuthenticationItem
+ */
+export function normalizeAuthenticationItem(auth, options = {}) {
+    // Extract app key and version from selected_api if not provided
+    let appKey = options.app_key;
+    let appVersion = options.app_version;
+    if (auth.selected_api) {
+        const [extractedAppKey, extractedVersion] = splitVersionedKey(auth.selected_api);
+        // Use extracted app key if not provided in options
+        if (!appKey) {
+            appKey = extractedAppKey;
+        }
+        // Use extracted version if not provided in options
+        if (!appVersion) {
+            appVersion = extractedVersion;
+        }
+    }
+    const { selected_api: selectedApi, customuser_id: userId, ...restOfAuth } = auth;
+    return {
+        ...restOfAuth, // Pass through all other API response fields except selected_api
+        implementation_id: selectedApi, // Rename selected_api to implementation_id
+        title: auth.title || auth.label || undefined, // Coerce title from label if missing
+        is_expired: auth.is_stale, // Map is_stale to is_expired
+        expired_at: auth.marked_stale_at, // Map marked_stale_at to expired_at
+        app_key: appKey, // App key from implementations endpoint or parsed from selected_api
+        app_version: appVersion, // Version from selected_api or provided
+        user_id: userId, // Map customuser_id to user_id
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.15.4",
+  "version": "0.15.9",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",