@zapier/zapier-sdk 0.15.1 → 0.15.3

package/dist/plugins/manifest/schemas.d.ts

@@ -8,15 +8,45 @@ export type ManifestEntry = {
 };
 export type GetVersionedImplementationId = (appKey: string) => Promise<string | null>;
 export type GetImplementation = (appKey: string) => Promise<AppItem | null>;
+/**
+ * Action entry for storing saved action configurations
+ * The key in the actions record IS the user-provided name
+ */
+export declare const ActionEntrySchema: z.ZodObject<{
+    appKey: z.ZodString;
+    actionKey: z.ZodString;
+    actionType: z.ZodString;
+    authenticationId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    schema: Record<string, unknown>;
+    appKey: string;
+    actionKey: string;
+    actionType: string;
+    createdAt: string;
+    authenticationId?: number | null | undefined;
+    inputs?: Record<string, unknown> | undefined;
+}, {
+    schema: Record<string, unknown>;
+    appKey: string;
+    actionKey: string;
+    actionType: string;
+    createdAt: string;
+    authenticationId?: number | null | undefined;
+    inputs?: Record<string, unknown> | undefined;
+}>;
+export type ActionEntry = z.infer<typeof ActionEntrySchema>;
 export type Manifest = {
     apps: Record<string, ManifestEntry>;
+    actions?: Record<string, ActionEntry>;
 };
 export type ResolveAppKeys = ({ appKeys, }: {
     appKeys: string[];
 }) => Promise<ResolvedAppLocator[]>;
 /**
- * Manifest schema for version locking
- * Maps app keys to their locked version information
+ * Manifest schema for version locking and saved action configurations
  */
 export declare const ManifestSchema: z.ZodObject<{
     apps: z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -29,16 +59,59 @@ export declare const ManifestSchema: z.ZodObject<{
         version: string;
         implementationName: string;
     }>>;
+    actions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        appKey: z.ZodString;
+        actionKey: z.ZodString;
+        actionType: z.ZodString;
+        authenticationId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        schema: Record<string, unknown>;
+        appKey: string;
+        actionKey: string;
+        actionType: string;
+        createdAt: string;
+        authenticationId?: number | null | undefined;
+        inputs?: Record<string, unknown> | undefined;
+    }, {
+        schema: Record<string, unknown>;
+        appKey: string;
+        actionKey: string;
+        actionType: string;
+        createdAt: string;
+        authenticationId?: number | null | undefined;
+        inputs?: Record<string, unknown> | undefined;
+    }>>>;
 }, "strip", z.ZodTypeAny, {
     apps: Record<string, {
         version: string;
         implementationName: string;
     }>;
+    actions?: Record<string, {
+        schema: Record<string, unknown>;
+        appKey: string;
+        actionKey: string;
+        actionType: string;
+        createdAt: string;
+        authenticationId?: number | null | undefined;
+        inputs?: Record<string, unknown> | undefined;
+    }> | undefined;
 }, {
     apps: Record<string, {
         version: string;
         implementationName: string;
     }>;
+    actions?: Record<string, {
+        schema: Record<string, unknown>;
+        appKey: string;
+        actionKey: string;
+        actionType: string;
+        createdAt: string;
+        authenticationId?: number | null | undefined;
+        inputs?: Record<string, unknown> | undefined;
+    }> | undefined;
 }>;
 export declare const ManifestPluginOptionsSchema: z.ZodObject<{
     manifestPath: z.ZodOptional<z.ZodString>;

package/dist/plugins/manifest/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/manifest/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,eAAO,MAAM,mBAAmB,EAAG,WAAoB,CAAC;AAExD,MAAM,MAAM,aAAa,GAAG;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,CACzC,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE5B,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;AAE5E,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,EAC5B,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,KAAK,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;EAcoC,CAAC;AAEhE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;EAYtC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/manifest/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,eAAO,MAAM,mBAAmB,EAAG,WAAoB,CAAC;AAExD,MAAM,MAAM,aAAa,GAAG;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,CACzC,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE5B,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;EAkB5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,EAC5B,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,KAAK,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB8C,CAAC;AAE1E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;EAYtC,CAAC"}

package/dist/plugins/manifest/schemas.js

@@ -1,8 +1,28 @@
 import { z } from "zod";
 export const DEFAULT_CONFIG_PATH = ".zapierrc";
 /**
- * Manifest schema for version locking
- * Maps app keys to their locked version information
+ * Action entry for storing saved action configurations
+ * The key in the actions record IS the user-provided name
+ */
+export const ActionEntrySchema = z.object({
+    appKey: z.string().describe("App key (slug or implementation name)"),
+    actionKey: z.string().describe("Action key identifier"),
+    actionType: z
+        .string()
+        .describe("Action type (e.g., 'read', 'write', 'search')"),
+    authenticationId: z
+        .number()
+        .nullable()
+        .optional()
+        .describe("Authentication ID used"),
+    inputs: z.record(z.unknown()).optional().describe("Resolved input values"),
+    schema: z
+        .record(z.unknown())
+        .describe("Complete JSON Schema from getInputFieldsSchema (includes $schema, type, properties, required, etc.)"),
+    createdAt: z.string().describe("ISO 8601 timestamp when created"),
+});
+/**
+ * Manifest schema for version locking and saved action configurations
  */
 export const ManifestSchema = z
     .object({
@@ -12,8 +32,12 @@ export const ManifestSchema = z
             .describe("Base implementation name without version (e.g., 'SlackCLIAPI')"),
         version: z.string().describe("Version string (e.g., '1.21.1')"),
     })),
+    actions: z
+        .record(z.string(), ActionEntrySchema)
+        .optional()
+        .describe("Saved action configurations with their schemas"),
 })
-    .describe("Manifest mapping app keys to version information");
+    .describe("Manifest for app version locking and action configurations");
 export const ManifestPluginOptionsSchema = z.object({
     manifestPath: z.string().optional().describe("Path to manifest file"),
     manifest: z

package/dist/plugins/request/schemas.d.ts

@@ -13,18 +13,18 @@ export declare const RelayRequestSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     url: string;
     method?: "POST" | "GET" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
+    authenticationId?: number | undefined;
     headers?: Record<string, string> | [string, string][] | Headers | undefined;
     body?: any;
-    authenticationId?: number | undefined;
     callbackUrl?: string | undefined;
     authenticationTemplate?: string | undefined;
     relayBaseUrl?: string | undefined;
 }, {
     url: string;
     method?: "POST" | "GET" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
+    authenticationId?: number | undefined;
     headers?: Record<string, string> | [string, string][] | Headers | undefined;
     body?: any;
-    authenticationId?: number | undefined;
     callbackUrl?: string | undefined;
     authenticationTemplate?: string | undefined;
     relayBaseUrl?: string | undefined;
@@ -47,18 +47,18 @@ export declare const RelayFetchSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     url: string;
     method?: "POST" | "GET" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
+    authenticationId?: number | undefined;
     headers?: Record<string, string> | [string, string][] | Headers | undefined;
     body?: any;
-    authenticationId?: number | undefined;
     callbackUrl?: string | undefined;
     authenticationTemplate?: string | undefined;
     relayBaseUrl?: string | undefined;
 }, {
     url: string;
     method?: "POST" | "GET" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
+    authenticationId?: number | undefined;
     headers?: Record<string, string> | [string, string][] | Headers | undefined;
     body?: any;
-    authenticationId?: number | undefined;
     callbackUrl?: string | undefined;
     authenticationTemplate?: string | undefined;
     relayBaseUrl?: string | undefined;

package/dist/plugins/runAction/schemas.d.ts

@@ -14,22 +14,22 @@ export declare const RunActionSchema: z.ZodObject<{
     cursor: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     appKey: string;
-    actionType: "search" | "filter" | "read" | "read_bulk" | "run" | "search_and_write" | "search_or_write" | "write";
     actionKey: string;
-    cursor?: string | undefined;
-    maxItems?: number | undefined;
-    pageSize?: number | undefined;
+    actionType: "search" | "filter" | "read" | "read_bulk" | "run" | "search_and_write" | "search_or_write" | "write";
     authenticationId?: number | null | undefined;
     inputs?: Record<string, unknown> | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
+    cursor?: string | undefined;
 }, {
     appKey: string;
-    actionType: "search" | "filter" | "read" | "read_bulk" | "run" | "search_and_write" | "search_or_write" | "write";
     actionKey: string;
-    cursor?: string | undefined;
-    maxItems?: number | undefined;
-    pageSize?: number | undefined;
+    actionType: "search" | "filter" | "read" | "read_bulk" | "run" | "search_and_write" | "search_or_write" | "write";
     authenticationId?: number | null | undefined;
     inputs?: Record<string, unknown> | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
+    cursor?: string | undefined;
 }>;
 export type RunActionOptions = z.infer<typeof RunActionSchema>;
 export interface RunActionPage {

package/dist/sdk.d.ts

@@ -20,11 +20,33 @@ export declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOption
 } & {
     getVersionedImplementationId: import("./plugins/manifest/schemas").GetVersionedImplementationId;
     resolveAppKeys: import("./plugins/manifest/schemas").ResolveAppKeys;
-    updateManifestEntry: (options: import(".").UpdateManifestEntryOptions) => Promise<[string, import(".").ManifestEntry, import(".").Manifest]>;
+    updateManifestEntry: (options: import(".").UpdateManifestEntryOptions) => Promise<import(".").UpdateManifestEntryResult>;
+    addActionEntry: (options: import(".").AddActionEntryOptions) => Promise<import(".").AddActionEntryResult>;
+    findActionEntry: (options: {
+        name: string;
+        manifest: import(".").Manifest;
+    }) => import(".").ActionEntry | null;
+    listActionEntries: (options?: {
+        configPath?: string;
+    }) => Promise<Array<[string, import(".").ActionEntry]>>;
+    deleteActionEntry: (options: {
+        name: string;
+        configPath?: string;
+        skipWrite?: boolean;
+    }) => Promise<import(".").Manifest>;
+    hasActionEntry: (options: {
+        name: string;
+        manifest: import(".").Manifest;
+    }) => boolean;
+    findManifestEntry: (options: {
+        appKey: string;
+        manifest: import(".").Manifest;
+    }) => [string, import(".").ManifestEntry] | null;
+    readManifestFromFile: (filePath: string) => Promise<import(".").Manifest | null>;
 } & {
     meta: {
         listApps: {
-            inputSchema: typeof import("./plugins/listApps/schemas").ListAppsSchema;
+            inputSchema: typeof import("./temporary-internal-core").ListAppsOptionsSchema;
         };
     };
 } & {

package/dist/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EACV,GAAG,EACH,MAAM,EACN,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,UAAU,EACX,MAAM,gBAAgB,CAAC;AA2BxB,MAAM,WAAW,gBAAiB,SAAQ,cAAc;CAAG;AAG3D,wBAAgB,SAAS,CACvB,WAAW,GAAG,EAAE,EAChB,eAAe,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAAE,GAAG;IAC7D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAClC,EAED,OAAO,GAAE,gBAAqB,EAC9B,UAAU,GAAE,WAA+B,EAC3C,cAAc,GAAE,eAAiD;;cAKrD,gBAAgB,EAAE,SAAS,SAAS,cAAc,UAClD,MAAM,CACZ,WAAW,GAAG;QAAE,UAAU,IAAI,eAAe,CAAA;KAAE,EAC/C,gBAAgB,EAChB,SAAS,CACV,qBACiB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,GAAG,CACJ,WAAW,GAAG,oBAAoB,CAAC,SAAS,CAAC,EAC7C,eAAe,GAAG,WAAW,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC,CACnE;EA8DJ;AAED,wBAAgB,8BAA8B,CAAC,OAAO,GAAE,gBAAqB;UApFnE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4HnC;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAMzE"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EACV,GAAG,EACH,MAAM,EACN,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,UAAU,EACX,MAAM,gBAAgB,CAAC;AA2BxB,MAAM,WAAW,gBAAiB,SAAQ,cAAc;CAAG;AAG3D,wBAAgB,SAAS,CACvB,WAAW,GAAG,EAAE,EAChB,eAAe,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAAE,GAAG;IAC7D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAClC,EAED,OAAO,GAAE,gBAAqB,EAC9B,UAAU,GAAE,WAA+B,EAC3C,cAAc,GAAE,eAAiD;;cAKrD,gBAAgB,EAAE,SAAS,SAAS,cAAc,UAClD,MAAM,CACZ,WAAW,GAAG;QAAE,UAAU,IAAI,eAAe,CAAA;KAAE,EAC/C,gBAAgB,EAChB,SAAS,CACV,qBACiB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,GAAG,CACJ,WAAW,GAAG,oBAAoB,CAAC,SAAS,CAAC,EAC7C,eAAe,GAAG,WAAW,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC,CACnE;EA8DJ;AAED,wBAAgB,8BAA8B,CAAC,OAAO,GAAE,gBAAqB;UApFnE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;;;;;;;;;;;;+BAD2B,CAAC;kBAC/C,CAAC;;;;kBAKG,CAAC;iBAAyB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuH/C;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAMzE"}

package/dist/temporary-internal-core/handlers/listApps.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Handler for listApps operation
+ *
+ * This handler will become an SDK API endpoint handler.
+ * It encapsulates the business logic for listing apps, including:
+ * - Search augmentation (merging search results with specified apps)
+ * - API calls to internal services
+ * - Response transformation
+ * - Pagination with latest_only support
+ *
+ * Note: App key resolution (slugs → implementation IDs) happens in the SDK plugin.
+ * The handler receives pre-resolved implementation IDs and performs search augmentation.
+ */
+import type { Handler, HandlerDeps } from "../types";
+import { type ListAppsHandlerRequest, type ListAppsResponse } from "../schemas/apps";
+/**
+ * Simple HTTP client interface for calling internal APIs
+ *
+ * Why pass this as a dependency instead of importing directly?
+ *
+ * 1. **Different implementations in different contexts:**
+ *    - In the SDK: Uses the ApiClient wrapper (adds auth, error handling, etc.)
+ *    - In the SDK API: Would use internal HTTP client or direct service calls
+ *
+ * 2. **Testability:**
+ *    - Can mock httpClient in tests without complex setup
+ *    - Can verify API calls and responses in isolation
+ *
+ * 3. **No hard coupling:**
+ *    - Handler doesn't know/care how HTTP calls are made
+ *    - Makes migration to SDK API easier (just swap implementation)
+ */
+export interface HttpClient {
+    get<T = unknown>(path: string, options?: {
+        searchParams?: Record<string, string>;
+    }): Promise<T>;
+}
+/**
+ * Dependencies required by the listApps handler
+ *
+ * Passed as a parameter (dependency injection) rather than imported directly
+ * to allow different implementations in different environments:
+ * - SDK plugin injects: { httpClient: api } (SDK's ApiClient)
+ * - SDK API would inject: { httpClient: internalHttpClient } (direct internal calls)
+ * - Tests inject: { httpClient: mockHttpClient } (mocked responses)
+ *
+ * Extends HandlerDeps to ensure compatibility with the Handler interface.
+ */
+export interface ListAppsHandlerDeps extends HandlerDeps {
+    httpClient: HttpClient;
+}
+/**
+ * Handles listApps operation
+ *
+ * Conforms to the Handler<TRequest, TResponse, TDeps> interface contract.
+ * Validates and normalizes the request at the handler boundary before processing.
+ *
+ * Accepts flexible input types (via schema):
+ * - implementationIds: string (comma-separated) or string[]
+ * - pageSize: string or number
+ *
+ * @param request - The request with pre-resolved implementation IDs (handler performs search augmentation)
+ * @param deps - Dependencies injected by the caller (see ListAppsHandlerDeps for why we use DI)
+ * @returns Paginated list of apps with normalized data
+ */
+export declare const handleListApps: Handler<ListAppsHandlerRequest, ListAppsResponse, ListAppsHandlerDeps>;
+//# sourceMappingURL=listApps.d.ts.map

package/dist/temporary-internal-core/handlers/listApps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listApps.d.ts","sourceRoot":"","sources":["../../../src/temporary-internal-core/handlers/listApps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AAkBzB;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,CAAC,GAAG,OAAO,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAClD,OAAO,CAAC,CAAC,CAAC,CAAC;CACf;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,UAAU,EAAE,UAAU,CAAC;CACxB;AAwDD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,CAClC,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,CA+EpB,CAAC"}

package/dist/temporary-internal-core/handlers/listApps.js

@@ -0,0 +1,121 @@
+/**
+ * Handler for listApps operation
+ *
+ * This handler will become an SDK API endpoint handler.
+ * It encapsulates the business logic for listing apps, including:
+ * - Search augmentation (merging search results with specified apps)
+ * - API calls to internal services
+ * - Response transformation
+ * - Pagination with latest_only support
+ *
+ * Note: App key resolution (slugs → implementation IDs) happens in the SDK plugin.
+ * The handler receives pre-resolved implementation IDs and performs search augmentation.
+ */
+import { ListAppsHandlerRequestSchema, } from "../schemas/apps";
+import { splitVersionedKey } from "../utils/app-locators";
+import { transformImplementationMetaToAppItem, extractPaginationCursor, } from "../utils/transformations";
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_PAGE_SIZE = 20;
+// ============================================================================
+// Business Logic Helpers
+// ============================================================================
+/**
+ * Augments implementation IDs with search results
+ *
+ * Calls the search endpoint and merges results with existing implementation IDs,
+ * deduplicating by implementation name (without version).
+ */
+async function augmentWithSearchResults({ searchTerm, implementationIds, httpClient, }) {
+    const searchResponse = await httpClient.get("/zapier/api/v4/implementations-meta/search/", {
+        searchParams: { term: searchTerm },
+    });
+    const searchResults = searchResponse.results.map(transformImplementationMetaToAppItem);
+    const implementationNameSet = new Set(implementationIds.map((id) => {
+        const [name] = splitVersionedKey(id);
+        return name;
+    }));
+    const additionalIds = [];
+    for (const result of searchResults) {
+        const [implementationName] = splitVersionedKey(result.key);
+        if (!implementationNameSet.has(implementationName)) {
+            implementationNameSet.add(implementationName);
+            // Use the full implementation_id from the result
+            additionalIds.push(result.implementation_id);
+        }
+    }
+    return [...implementationIds, ...additionalIds];
+}
+// ============================================================================
+// Main Handler
+// ============================================================================
+/**
+ * Handles listApps operation
+ *
+ * Conforms to the Handler<TRequest, TResponse, TDeps> interface contract.
+ * Validates and normalizes the request at the handler boundary before processing.
+ *
+ * Accepts flexible input types (via schema):
+ * - implementationIds: string (comma-separated) or string[]
+ * - pageSize: string or number
+ *
+ * @param request - The request with pre-resolved implementation IDs (handler performs search augmentation)
+ * @param deps - Dependencies injected by the caller (see ListAppsHandlerDeps for why we use DI)
+ * @returns Paginated list of apps with normalized data
+ */
+export const handleListApps = async ({ request, deps }) => {
+    // Validate and normalize request at handler boundary
+    // Schema automatically normalizes:
+    // - implementationIds: string → string[]
+    // - pageSize: string → number
+    const validatedRequest = ListAppsHandlerRequestSchema.parse(request);
+    const { httpClient } = deps;
+    let { implementationIds } = validatedRequest;
+    const pageSize = validatedRequest.pageSize ?? DEFAULT_PAGE_SIZE;
+    if (validatedRequest.search) {
+        implementationIds = await augmentWithSearchResults({
+            searchTerm: validatedRequest.search,
+            implementationIds,
+            httpClient,
+        });
+    }
+    if (implementationIds.length === 0) {
+        // If search was provided but found nothing, return empty (bug fix)
+        if (validatedRequest.search) {
+            return {
+                data: [],
+                nextCursor: undefined,
+            };
+        }
+        const searchParams = {
+            latest_only: "true",
+            selected_apis: "",
+            limit: pageSize.toString(),
+        };
+        if (validatedRequest.cursor) {
+            searchParams.offset = validatedRequest.cursor;
+        }
+        const implementationsResponse = await httpClient.get("/zapier/api/v4/implementations-meta/lookup/", {
+            searchParams,
+        });
+        return {
+            data: implementationsResponse.results.map(transformImplementationMetaToAppItem),
+            nextCursor: extractPaginationCursor(implementationsResponse),
+        };
+    }
+    const searchParams = {
+        selected_apis: implementationIds.join(","),
+        limit: pageSize.toString(),
+    };
+    if (validatedRequest.cursor) {
+        searchParams.offset = validatedRequest.cursor;
+    }
+    const implementationsResponse = await httpClient.get("/zapier/api/v4/implementations-meta/lookup/", {
+        searchParams,
+    });
+    return {
+        data: implementationsResponse.results.map(transformImplementationMetaToAppItem),
+        nextCursor: extractPaginationCursor(implementationsResponse),
+    };
+};

package/dist/temporary-internal-core/handlers/listApps.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=listApps.test.d.ts.map

package/dist/temporary-internal-core/handlers/listApps.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listApps.test.d.ts","sourceRoot":"","sources":["../../../src/temporary-internal-core/handlers/listApps.test.ts"],"names":[],"mappings":""}