@zapier/zapier-sdk 0.4.1 → 0.5.1

package/dist/types/plugin.d.ts

@@ -0,0 +1,61 @@
+/**
+ * ------------------------------
+ * Plugin Type System with Explicit Context Dependencies
+ * ------------------------------
+ *
+ * This system makes context dependencies explicit to restore TypeScript's
+ * ability to catch missing context at compile time.
+ */
+export interface PluginDependencies<TSdk = {}, TContext = {}> {
+    sdk: TSdk;
+    context: TContext;
+}
+export interface PluginProvides extends Record<string, any> {
+    context?: Record<string, any>;
+}
+export type ExtractSdkProperties<T extends Record<string, any>> = Omit<T, "context">;
+export type ExtractContextProperties<T extends PluginProvides> = T["context"];
+export type GetSdkType<TPluginProvides extends PluginProvides> = ExtractSdkProperties<TPluginProvides> & {
+    getContext(): NonNullable<ExtractContextProperties<TPluginProvides>>;
+};
+export type PluginOptions<TSdk = {}, TContext = {}> = {
+    sdk: TSdk;
+    context: TContext & {
+        meta: Record<string, any>;
+    };
+};
+/**
+ * Plugin interface — now has 3 type params:
+ *
+ *   TRequiresContext = what this plugin *needs* in context
+ *   TProvides = what this plugin *returns* (sdk + context)
+ *   TSdk = current sdk shape when plugin runs
+ */
+export interface Plugin<TSdk = {}, TRequiresContext = {}, TProvides extends PluginProvides = PluginProvides> {
+    (params: {
+        sdk: TSdk;
+        context: TRequiresContext & {
+            meta: Record<string, any>;
+        };
+    }): TProvides;
+}
+type MissingContextKeys<TRequired, TCurrent> = TRequired extends Record<string, any> ? TCurrent extends Record<string, any> ? {
+    [K in keyof TRequired]: K extends keyof TCurrent ? never : K;
+}[keyof TRequired] : keyof TRequired : never;
+type ContextError<TRequired, TCurrent> = MissingContextKeys<TRequired, TCurrent> extends never ? never : MissingContextKeys<TRequired, TCurrent> extends infer Missing ? Missing extends string ? `❌ Missing required context: { ${Missing}: any }` : Missing extends number ? `❌ Missing required context: { ${Missing}: any }` : `❌ Missing required context properties. Required: ${keyof TRequired extends string ? keyof TRequired : "unknown"}, Available: ${keyof TCurrent extends string ? keyof TCurrent : "unknown"}` : "❌ Context requirement not satisfied";
+/**
+ * SDK interface — result of createSdk()
+ *
+ * addPlugin now enforces that TRequiresContext is assignable to TCurrentContext.
+ * If not, TypeScript will emit a detailed error showing missing properties.
+ */
+export type Sdk<TCurrentSdk = {}, TCurrentContext = {
+    meta: Record<string, any>;
+}> = TCurrentSdk & {
+    addPlugin<TRequiresContext, TProvides extends PluginProvides>(plugin: Plugin<TCurrentSdk & {
+        getContext(): TCurrentContext;
+    }, TRequiresContext, TProvides>, options?: any): TCurrentContext extends TRequiresContext ? Sdk<TCurrentSdk & ExtractSdkProperties<TProvides>, TCurrentContext & NonNullable<ExtractContextProperties<TProvides>>> : ContextError<TRequiresContext, TCurrentContext>;
+    getContext(): TCurrentContext;
+};
+export {};
+//# sourceMappingURL=plugin.d.ts.map

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

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

package/dist/types/plugin.js

@@ -0,0 +1,9 @@
+/**
+ * ------------------------------
+ * Plugin Type System with Explicit Context Dependencies
+ * ------------------------------
+ *
+ * This system makes context dependencies explicit to restore TypeScript's
+ * ability to catch missing context at compile time.
+ */
+export {};

package/dist/types/properties.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export declare const AppKeyPropertySchema: z.ZodString;
+export declare const ActionTypePropertySchema: z.ZodEnum<["read", "read_bulk", "write", "run", "search", "search_or_write", "search_and_write", "filter"]>;
+export declare const ActionKeyPropertySchema: z.ZodString;
+export declare const AuthenticationIdPropertySchema: z.ZodNumber;
+export declare const InputsPropertySchema: z.ZodRecord<z.ZodString, z.ZodAny>;
+export declare const LimitPropertySchema: z.ZodDefault<z.ZodNumber>;
+export declare const OffsetPropertySchema: z.ZodDefault<z.ZodNumber>;
+export declare const OutputPropertySchema: z.ZodString;
+export declare const DebugPropertySchema: z.ZodDefault<z.ZodBoolean>;
+export declare const ParamsPropertySchema: z.ZodRecord<z.ZodString, z.ZodAny>;
+export type AppKeyProperty = z.infer<typeof AppKeyPropertySchema>;
+export type ActionTypeProperty = z.infer<typeof ActionTypePropertySchema>;
+export type ActionKeyProperty = z.infer<typeof ActionKeyPropertySchema>;
+export type AuthenticationIdProperty = z.infer<typeof AuthenticationIdPropertySchema>;
+export type InputsProperty = z.infer<typeof InputsPropertySchema>;
+export type LimitProperty = z.infer<typeof LimitPropertySchema>;
+export type OffsetProperty = z.infer<typeof OffsetPropertySchema>;
+export type OutputProperty = z.infer<typeof OutputPropertySchema>;
+export type DebugProperty = z.infer<typeof DebugPropertySchema>;
+export type ParamsProperty = z.infer<typeof ParamsPropertySchema>;
+//# sourceMappingURL=properties.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../src/types/properties.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,oBAAoB,aAEhC,CAAC;AAEF,eAAO,MAAM,wBAAwB,6GAW4B,CAAC;AAElE,eAAO,MAAM,uBAAuB,aAGA,CAAC;AAErC,eAAO,MAAM,8BAA8B,aAGY,CAAC;AAExD,eAAO,MAAM,oBAAoB,oCAEa,CAAC;AAE/C,eAAO,MAAM,mBAAmB,2BAMgB,CAAC;AAEjD,eAAO,MAAM,oBAAoB,2BAKoB,CAAC;AAEtD,eAAO,MAAM,oBAAoB,aAA0C,CAAC;AAE5E,eAAO,MAAM,mBAAmB,4BAGG,CAAC;AAEpC,eAAO,MAAM,oBAAoB,oCAEG,CAAC;AAGrC,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/types/properties.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+import { withPositional } from "../utils/schema-utils";
+import { MAX_PAGE_LIMIT } from "../constants";
+// Shared property definitions for common parameters across functions
+// These can be reused in function schemas without duplication
+export const AppKeyPropertySchema = withPositional(z.string().min(1).describe("App key (e.g., 'SlackCLIAPI')"));
+export const ActionTypePropertySchema = z
+    .enum([
+    "read",
+    "read_bulk",
+    "write",
+    "run",
+    "search",
+    "search_or_write",
+    "search_and_write",
+    "filter",
+])
+    .describe("Action type that matches the action's defined type");
+export const ActionKeyPropertySchema = z
+    .string()
+    .min(1)
+    .describe("Action key to execute");
+export const AuthenticationIdPropertySchema = z
+    .number()
+    .int()
+    .describe("Authentication ID to use for this action");
+export const InputsPropertySchema = z
+    .record(z.any())
+    .describe("Input parameters for the action");
+export const LimitPropertySchema = z
+    .number()
+    .int()
+    .min(1)
+    .max(MAX_PAGE_LIMIT)
+    .default(50)
+    .describe("Maximum number of items to return");
+export const OffsetPropertySchema = z
+    .number()
+    .int()
+    .min(0)
+    .default(0)
+    .describe("Number of items to skip for pagination");
+export const OutputPropertySchema = z.string().describe("Output file path");
+export const DebugPropertySchema = z
+    .boolean()
+    .default(false)
+    .describe("Enable debug logging");
+export const ParamsPropertySchema = z
+    .record(z.any())
+    .describe("Additional parameters");

package/dist/types/sdk.d.ts

@@ -0,0 +1,43 @@
+/**
+ * SDK-related types and interfaces
+ */
+import type { EventCallback } from "./events";
+export interface BaseSdkOptions {
+    token?: string;
+    getToken?: () => Promise<string | undefined>;
+    onEvent?: EventCallback;
+    fetch?: typeof fetch;
+    baseUrl?: string;
+    debug?: boolean;
+}
+import type { ListInputFieldsSdkFunction } from "../plugins/listInputFields/schemas";
+import type { GetAuthenticationSdkFunction } from "../plugins/getAuthentication/schemas";
+import type { FindFirstAuthenticationSdkFunction } from "../plugins/findFirstAuthentication/schemas";
+import type { FindUniqueAuthenticationSdkFunction } from "../plugins/findUniqueAuthentication/schemas";
+import type { RelayRequestSdkFunction } from "../plugins/request/schemas";
+import type { z } from "zod";
+import { RegistryPluginProvides } from "../plugins/registry";
+import { GetProfilePluginProvides } from "../plugins/getProfile";
+import { AppsPluginProvides } from "../plugins/apps";
+import { FetchPluginProvides } from "../plugins/fetch";
+import { ListAppsPluginProvides } from "../plugins/listApps";
+import { GetAppPluginProvides } from "../plugins/getApp";
+import { ListActionsPluginProvides } from "../plugins/listActions";
+import { GetActionPluginProvides } from "../plugins/getAction";
+import { RunActionPluginProvides } from "../plugins/runAction";
+import { ListAuthenticationsPluginProvides } from "../plugins/listAuthentications";
+import { GetAuthenticationPluginProvides } from "../plugins/getAuthentication";
+import { FindFirstAuthenticationPluginProvides } from "../plugins/findFirstAuthentication";
+import { FindUniqueAuthenticationPluginProvides } from "../plugins/findUniqueAuthentication";
+import { ListInputFieldsPluginProvides } from "../plugins/listInputFields";
+import { RequestPluginProvides } from "../plugins/request";
+import { GetSdkType } from "./plugin";
+export interface FunctionRegistryEntry {
+    name: string;
+    inputSchema: z.ZodSchema;
+    implementation: Function;
+}
+export interface ZapierSdkFunctions extends ListInputFieldsSdkFunction, GetAuthenticationSdkFunction, FindFirstAuthenticationSdkFunction, FindUniqueAuthenticationSdkFunction, RelayRequestSdkFunction {
+}
+export type ZapierSdk = GetSdkType<RegistryPluginProvides & FetchPluginProvides & AppsPluginProvides & ListAppsPluginProvides & GetAppPluginProvides & ListActionsPluginProvides & GetActionPluginProvides & RunActionPluginProvides & ListAuthenticationsPluginProvides & GetAuthenticationPluginProvides & FindFirstAuthenticationPluginProvides & FindUniqueAuthenticationPluginProvides & ListInputFieldsPluginProvides & RequestPluginProvides & GetProfilePluginProvides>;
+//# sourceMappingURL=sdk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/types/sdk.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAGD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACzF,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,4CAA4C,CAAC;AACrG,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,6CAA6C,CAAC;AACvG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,EAAE,+BAA+B,EAAE,MAAM,8BAA8B,CAAC;AAC/E,OAAO,EAAE,qCAAqC,EAAE,MAAM,oCAAoC,CAAC;AAC3F,OAAO,EAAE,sCAAsC,EAAE,MAAM,qCAAqC,CAAC;AAC7F,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAMtC,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC;IACzB,cAAc,EAAE,QAAQ,CAAC;CAC1B;AAGD,MAAM,WAAW,kBACf,SAAQ,0BAA0B,EAChC,4BAA4B,EAC5B,kCAAkC,EAClC,mCAAmC,EACnC,uBAAuB;CAE1B;AAUD,MAAM,MAAM,SAAS,GAAG,UAAU,CAChC,sBAAsB,GACpB,mBAAmB,GACnB,kBAAkB,GAClB,sBAAsB,GACtB,oBAAoB,GACpB,yBAAyB,GACzB,uBAAuB,GACvB,uBAAuB,GACvB,iCAAiC,GACjC,+BAA+B,GAC/B,qCAAqC,GACrC,sCAAsC,GACtC,6BAA6B,GAC7B,qBAAqB,GACrB,wBAAwB,CAC3B,CAAC"}

package/dist/types/sdk.js

@@ -0,0 +1,4 @@
+/**
+ * SDK-related types and interfaces
+ */
+export {};

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

@@ -0,0 +1,31 @@
+/**
+ * Array utility functions for working with async iterators and arrays
+ */
+/**
+ * Creates an array from an async iterable, similar to Array.from() but for async iterables
+ *
+ * @param asyncIterable - An async iterable to convert to an array
+ * @returns Promise that resolves to an array containing all items from the async iterable
+ *
+ * @example
+ * async function* generateNumbers() {
+ *   yield 1;
+ *   yield 2;
+ *   yield 3;
+ * }
+ *
+ * const numbers = await fromAsync(generateNumbers()); // [1, 2, 3]
+ *
+ * @example
+ * // With async generator that fetches data
+ * async function* fetchUsers() {
+ *   for (let page = 1; page <= 3; page++) {
+ *     const users = await fetchUsersPage(page);
+ *     yield* users;
+ *   }
+ * }
+ *
+ * const allUsers = await fromAsync(fetchUsers());
+ */
+export declare function toArrayFromAsync<T>(asyncIterable: AsyncIterable<T>): Promise<T[]>;
+//# sourceMappingURL=array-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"array-utils.d.ts","sourceRoot":"","sources":["../../src/utils/array-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,GAC9B,OAAO,CAAC,CAAC,EAAE,CAAC,CAQd"}

package/dist/utils/array-utils.js

@@ -0,0 +1,36 @@
+/**
+ * Array utility functions for working with async iterators and arrays
+ */
+/**
+ * Creates an array from an async iterable, similar to Array.from() but for async iterables
+ *
+ * @param asyncIterable - An async iterable to convert to an array
+ * @returns Promise that resolves to an array containing all items from the async iterable
+ *
+ * @example
+ * async function* generateNumbers() {
+ *   yield 1;
+ *   yield 2;
+ *   yield 3;
+ * }
+ *
+ * const numbers = await fromAsync(generateNumbers()); // [1, 2, 3]
+ *
+ * @example
+ * // With async generator that fetches data
+ * async function* fetchUsers() {
+ *   for (let page = 1; page <= 3; page++) {
+ *     const users = await fetchUsersPage(page);
+ *     yield* users;
+ *   }
+ * }
+ *
+ * const allUsers = await fromAsync(fetchUsers());
+ */
+export async function toArrayFromAsync(asyncIterable) {
+    const result = [];
+    for await (const item of asyncIterable) {
+        result.push(item);
+    }
+    return result;
+}

package/dist/utils/array-utils.test.d.ts

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

package/dist/utils/array-utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-utils.test.d.ts","sourceRoot":"","sources":["../../src/utils/array-utils.test.ts"],"names":[],"mappings":""}

package/dist/utils/array-utils.test.js

@@ -0,0 +1,107 @@
+import { describe, it, expect } from "vitest";
+import { toArrayFromAsync } from "./array-utils";
+describe("array-utils", () => {
+    describe("fromAsync", () => {
+        it("should convert async generator to array", async () => {
+            async function* generateNumbers() {
+                yield 1;
+                yield 2;
+                yield 3;
+            }
+            const result = await toArrayFromAsync(generateNumbers());
+            expect(result).toEqual([1, 2, 3]);
+        });
+        it("should handle empty async generator", async () => {
+            async function* generateNothing() {
+                // yield nothing
+            }
+            const result = await toArrayFromAsync(generateNothing());
+            expect(result).toEqual([]);
+        });
+        it("should handle async generator with async operations", async () => {
+            async function* generateWithDelay() {
+                for (let i = 1; i <= 3; i++) {
+                    await new Promise((resolve) => setTimeout(resolve, 1)); // Small delay
+                    yield i * 10;
+                }
+            }
+            const result = await toArrayFromAsync(generateWithDelay());
+            expect(result).toEqual([10, 20, 30]);
+        });
+        it("should handle async generator that yields different types", async () => {
+            async function* generateMixed() {
+                yield "hello";
+                yield 42;
+                yield { name: "test" };
+                yield [1, 2, 3];
+            }
+            const result = await toArrayFromAsync(generateMixed());
+            expect(result).toEqual(["hello", 42, { name: "test" }, [1, 2, 3]]);
+        });
+        it("should handle async generator with error", async () => {
+            async function* generateWithError() {
+                yield 1;
+                yield 2;
+                throw new Error("Test error");
+            }
+            await expect(toArrayFromAsync(generateWithError())).rejects.toThrow("Test error");
+        });
+        it("should handle async iterable from array with Symbol.asyncIterator", async () => {
+            const asyncIterable = {
+                async *[Symbol.asyncIterator]() {
+                    for (const item of ["a", "b", "c"]) {
+                        yield item;
+                    }
+                },
+            };
+            const result = await toArrayFromAsync(asyncIterable);
+            expect(result).toEqual(["a", "b", "c"]);
+        });
+        it("should handle large async generator efficiently", async () => {
+            async function* generateLargeSequence() {
+                for (let i = 0; i < 1000; i++) {
+                    yield i;
+                }
+            }
+            const result = await toArrayFromAsync(generateLargeSequence());
+            expect(result).toHaveLength(1000);
+            expect(result[0]).toBe(0);
+            expect(result[999]).toBe(999);
+        });
+        it("should handle async generator that yields promises (promises are auto-awaited)", async () => {
+            async function* generatePromises() {
+                yield Promise.resolve("first");
+                yield Promise.resolve("second");
+            }
+            const result = await toArrayFromAsync(generatePromises());
+            // for await automatically awaits promises, so we get resolved values
+            expect(result).toEqual(["first", "second"]);
+        });
+        it("should handle async generator that yields already resolved values", async () => {
+            async function* generateResolvedValues() {
+                yield await Promise.resolve("first");
+                yield await Promise.resolve("second");
+            }
+            const result = await toArrayFromAsync(generateResolvedValues());
+            // The resolved values are yielded directly
+            expect(result).toEqual(["first", "second"]);
+        });
+        it("should maintain order of async generator items", async () => {
+            async function* generateInOrder() {
+                for (let i = 1; i <= 5; i++) {
+                    // Simulate varying delays
+                    await new Promise((resolve) => setTimeout(resolve, Math.random() * 10));
+                    yield `item-${i}`;
+                }
+            }
+            const result = await toArrayFromAsync(generateInOrder());
+            expect(result).toEqual([
+                "item-1",
+                "item-2",
+                "item-3",
+                "item-4",
+                "item-5",
+            ]);
+        });
+    });
+});

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

@@ -0,0 +1,78 @@
+/**
+ * Domain utility functions for working with app identifiers and data normalization
+ */
+import type { Action, App, Authentication, Implementation, ImplementationMeta, Service } from "../api/types";
+import type { ActionItem, AppItem, AuthenticationItem } from "../types/domain";
+/**
+ * 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];
+/**
+ * Converts an API App to an AppItem with normalized field names
+ *
+ * @param app - Raw App from API
+ * @returns Normalized AppItem
+ */
+export declare function normalizeAppItem(app: App): AppItem;
+/**
+ * Converts an Implementation to an AppItem with normalized field names
+ *
+ * @param implementation - Raw Implementation from API
+ * @returns Normalized AppItem
+ */
+export declare function normalizeImplementationToAppItem(implementation: Implementation): AppItem;
+/**
+ * Converts a lightweight ImplementationMeta to a slimmed AppItem
+ *
+ * @param implementationMeta - Raw ImplementationMeta from API
+ * @returns Normalized AppItem with essential fields only
+ */
+export declare function normalizeImplementationMetaToAppItem(implementationMeta: ImplementationMeta): AppItem;
+export declare function normalizeServiceToAppItem(service: Service): AppItem;
+/**
+ * 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.version - Version extracted from selected_api
+ * @returns Normalized AuthenticationItem
+ */
+export declare function normalizeAuthenticationItem(auth: Authentication, options?: {
+    app_key?: string;
+    version?: string;
+}): AuthenticationItem;
+export declare function normalizeActionItem(action: Action): ActionItem;
+/**
+ * Groups app keys by their type based on format patterns
+ *
+ * @param appKeys Array of app key strings to categorize
+ * @returns Object with arrays of keys grouped by type: selectedApi (CLI APIs), slug (everything else)
+ *
+ * @example
+ * groupVersionedAppKeysByType([
+ *   'FormatterCLIAPI@1.0.0',
+ *   'slack',
+ *   'AnotherAPI'
+ * ])
+ * // Returns: {
+ * //   selectedApi: ['FormatterCLIAPI@1.0.0', 'AnotherAPI'],
+ * //   slug: ['slack']
+ * // }
+ */
+export declare function groupVersionedAppKeysByType(appKeys: string[]): {
+    selectedApi: string[];
+    slug: string[];
+};
+export declare function groupAppKeysByType(appKeys: string[]): {
+    selectedApi: string[];
+    slug: string[];
+};
+//# sourceMappingURL=domain-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domain-utils.d.ts","sourceRoot":"","sources":["../../src/utils/domain-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,MAAM,EACN,GAAG,EACH,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,OAAO,EACR,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE/E;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,GACnB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAQ9B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAYlD;AAED;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAC9C,cAAc,EAAE,cAAc,GAC7B,OAAO,CAYT;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,kBAAkB,EAAE,kBAAkB,GACrC,OAAO,CAWT;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAYnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,kBAAkB,CAqCpB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAS9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG;IAC9D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAiDA;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG;IACrD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAUA"}