@zapier/zapier-sdk 0.15.1 → 0.15.2

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

@@ -0,0 +1,54 @@
+/**
+ * App locator utilities for resolving app keys to implementation IDs
+ *
+ * These utilities handle the mapping between user-friendly app identifiers
+ * (slugs like "slack") and internal implementation IDs (like "SlackCLIAPI@1.0.0")
+ */
+/**
+ * Represents an app identifier that may need resolution
+ */
+export interface AppLocator {
+    lookupAppKey: string;
+    slug?: string;
+    implementationName?: string;
+    version?: string;
+}
+/**
+ * An app locator that has been resolved to an implementation name
+ */
+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
+ */
+export declare function toAppLocator(appKey: string): AppLocator;
+/**
+ * Converts a resolved app locator to a full implementation ID
+ */
+export declare function toImplementationId(appLocator: ResolvedAppLocator): string;
+/**
+ * Type guard to check if an app locator has been resolved
+ */
+export declare function isResolvedAppLocator(appLocator: AppLocator): appLocator is ResolvedAppLocator;
+//# sourceMappingURL=app-locators.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,83 @@
+/**
+ * App locator utilities for resolving app keys to implementation IDs
+ *
+ * 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];
+}
+/**
+ * Converts an app key to an app locator structure
+ */
+export function toAppLocator(appKey) {
+    const [appKeyWithoutVersion, version] = splitVersionedKey(appKey);
+    if (isUuid(appKeyWithoutVersion)) {
+        throw new Error(`UUID app keys are not supported. Use app slug or implementation ID instead of: ${appKey}`);
+    }
+    const slug = isSlug(appKeyWithoutVersion)
+        ? appKeyWithoutVersion
+        : isSnakeCasedSlug(appKeyWithoutVersion)
+            ? dashifySnakeCasedSlug(appKeyWithoutVersion)
+            : undefined;
+    return {
+        lookupAppKey: appKeyWithoutVersion,
+        slug,
+        implementationName: slug ? undefined : appKeyWithoutVersion,
+        version,
+    };
+}
+/**
+ * Converts a resolved app locator to a full implementation ID
+ */
+export function toImplementationId(appLocator) {
+    return `${appLocator.implementationName}@${appLocator.version || "latest"}`;
+}
+/**
+ * Type guard to check if an app locator has been resolved
+ */
+export function isResolvedAppLocator(appLocator) {
+    return !!appLocator.implementationName;
+}

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

@@ -0,0 +1,18 @@
+/**
+ * Transformation utilities for converting API responses to SDK types
+ *
+ * These will move to SDK API server as part of the response transformation layer
+ */
+import type { ImplementationMeta } from "../schemas/implementations";
+import type { AppItem } from "../schemas/apps";
+/**
+ * Transforms ImplementationMeta from internal API to AppItem for SDK responses
+ */
+export declare function transformImplementationMetaToAppItem(implementationMeta: ImplementationMeta): AppItem;
+/**
+ * Extracts pagination cursor from API response
+ */
+export declare function extractPaginationCursor(response: {
+    next?: string | null;
+}): string | undefined;
+//# sourceMappingURL=transformations.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,36 @@
+/**
+ * Transformation utilities for converting API responses to SDK types
+ *
+ * These will move to SDK API server as part of the response transformation layer
+ */
+import { splitVersionedKey } from "./app-locators";
+/**
+ * Transforms ImplementationMeta from internal API to AppItem for SDK responses
+ */
+export function transformImplementationMetaToAppItem(implementationMeta) {
+    const [selectedApi, appVersion] = splitVersionedKey(implementationMeta.id);
+    const { id, name, ...restOfImplementationMeta } = implementationMeta;
+    return {
+        ...restOfImplementationMeta,
+        title: name,
+        key: selectedApi,
+        implementation_id: id,
+        version: appVersion,
+    };
+}
+/**
+ * Extracts pagination cursor from API response
+ */
+export function extractPaginationCursor(response) {
+    if (!response.next) {
+        return undefined;
+    }
+    try {
+        const url = new URL(response.next);
+        const offset = url.searchParams.get("offset");
+        return offset || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}

package/package.json

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