@zapier/zapier-sdk 0.70.3 → 0.71.0

package/dist/plugins/createConnection/index.d.ts

@@ -0,0 +1,189 @@
+import { type CreateConnectionItem } from "./schemas";
+export declare const createConnectionPlugin: (sdk: {
+    getConnectionStartUrl: (options?: {
+        app: string;
+    } | undefined) => Promise<{
+        data: import("../getConnectionStartUrl/schemas").GetConnectionStartUrlItem;
+    }>;
+} & {
+    context: {
+        meta: {
+            getConnectionStartUrl: import("kitcore").PluginMeta<unknown>;
+        };
+    };
+} & {
+    waitForNewConnection: (options?: {
+        app: string;
+        startedAt: number;
+        timeoutMs?: number | undefined;
+        pollIntervalMs?: number | undefined;
+    } | undefined) => Promise<{
+        data: import("../waitForNewConnection/schemas").WaitForNewConnectionItem;
+    }>;
+} & {
+    context: {
+        meta: {
+            waitForNewConnection: import("kitcore").PluginMeta<unknown>;
+        };
+    };
+} & {
+    getApp: (options?: {
+        app: string;
+    } | {
+        appKey: string;
+    } | undefined) => Promise<{
+        data: {
+            slug: string;
+            title: string;
+            key: string;
+            implementation_id: string;
+            description?: string | undefined;
+            is_hidden?: boolean | undefined;
+            auth_type?: string | undefined;
+            actions?: {
+                read?: number | undefined;
+                read_bulk?: number | undefined;
+                write?: number | undefined;
+                search?: number | undefined;
+                search_or_write?: number | undefined;
+                search_and_write?: number | undefined;
+                filter?: number | undefined;
+            } | undefined;
+            is_deprecated?: boolean | undefined;
+            is_beta?: boolean | undefined;
+            is_premium?: boolean | undefined;
+            age_in_days?: number | undefined;
+            banner?: string | undefined;
+            categories?: {
+                id: number;
+                name: string;
+                slug: string;
+            }[] | undefined;
+            images?: {
+                url_16x16?: string | undefined;
+                url_32x32?: string | undefined;
+                url_64x64?: string | undefined;
+                url_128x128?: string | undefined;
+            } | undefined;
+            popularity?: number | undefined;
+            has_filters?: boolean | undefined;
+            has_reads?: boolean | undefined;
+            has_searches?: boolean | undefined;
+            has_searches_or_writes?: boolean | undefined;
+            has_upfront_fields?: boolean | undefined;
+            has_writes?: boolean | undefined;
+            is_built_in?: boolean | undefined;
+            is_featured?: boolean | undefined;
+            is_invite?: boolean | undefined;
+            is_public?: boolean | undefined;
+            is_upcoming?: boolean | undefined;
+            visibility?: string | undefined;
+            primary_color?: string | undefined;
+            secondary_color?: string | undefined;
+            classification?: string | undefined;
+            api_docs_url?: string | undefined;
+            image?: string | undefined;
+            version?: string | undefined;
+        };
+    }>;
+} & {
+    context: {
+        meta: {
+            getApp: import("kitcore").PluginMeta<unknown>;
+        };
+    };
+} & {
+    listApps: (options?: ({
+        search?: string | undefined;
+        apps?: string[] | undefined;
+        appKeys?: string[] | undefined;
+        pageSize?: number | undefined;
+        maxItems?: number | undefined;
+        cursor?: string | undefined;
+    } & {
+        cursor?: string;
+        pageSize?: number;
+        maxItems?: number;
+    }) | undefined) => import("kitcore").PaginatedSdkResult<{
+        slug: string;
+        title: string;
+        key: string;
+        implementation_id: string;
+        description?: string | undefined;
+        is_hidden?: boolean | undefined;
+        auth_type?: string | undefined;
+        actions?: {
+            read?: number | undefined;
+            read_bulk?: number | undefined;
+            write?: number | undefined;
+            search?: number | undefined;
+            search_or_write?: number | undefined;
+            search_and_write?: number | undefined;
+            filter?: number | undefined;
+        } | undefined;
+        is_deprecated?: boolean | undefined;
+        is_beta?: boolean | undefined;
+        is_premium?: boolean | undefined;
+        age_in_days?: number | undefined;
+        banner?: string | undefined;
+        categories?: {
+            id: number;
+            name: string;
+            slug: string;
+        }[] | undefined;
+        images?: {
+            url_16x16?: string | undefined;
+            url_32x32?: string | undefined;
+            url_64x64?: string | undefined;
+            url_128x128?: string | undefined;
+        } | undefined;
+        popularity?: number | undefined;
+        has_filters?: boolean | undefined;
+        has_reads?: boolean | undefined;
+        has_searches?: boolean | undefined;
+        has_searches_or_writes?: boolean | undefined;
+        has_upfront_fields?: boolean | undefined;
+        has_writes?: boolean | undefined;
+        is_built_in?: boolean | undefined;
+        is_featured?: boolean | undefined;
+        is_invite?: boolean | undefined;
+        is_public?: boolean | undefined;
+        is_upcoming?: boolean | undefined;
+        visibility?: string | undefined;
+        primary_color?: string | undefined;
+        secondary_color?: string | undefined;
+        classification?: string | undefined;
+        api_docs_url?: string | undefined;
+        image?: string | undefined;
+        version?: string | undefined;
+    }>;
+} & {
+    context: {
+        meta: {
+            listApps: import("kitcore").PluginMeta<unknown>;
+        };
+    };
+} & {
+    context: import("../eventEmission").EventEmissionContext;
+} & {
+    context: {
+        meta: Record<string, import("kitcore").PluginMeta>;
+    };
+}) => {
+    createConnection: (options?: {
+        app: string;
+        browser: "never" | "auto" | "always";
+        timeoutMs?: number | undefined;
+        pollIntervalMs?: number | undefined;
+    } | undefined) => Promise<{
+        data: CreateConnectionItem;
+    }>;
+} & {
+    context: {
+        meta: {
+            createConnection: import("kitcore").PluginMeta<unknown>;
+        };
+    };
+};
+export type CreateConnectionPluginProvides = ReturnType<typeof createConnectionPlugin>;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/createConnection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/createConnection/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,WAAW,CAAC;AAWnB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAyBX,oBAAoB;;;;;;;;CAqD3C,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,UAAU,CACrD,OAAO,sBAAsB,CAC9B,CAAC"}

package/dist/plugins/createConnection/index.js

@@ -0,0 +1,71 @@
+import { definePlugin, createPluginMethod } from "kitcore";
+import { setMethodMetadata } from "../eventEmission/method-metadata";
+import { appKeyResolver } from "../../resolvers";
+import openUrl from "../../utils/open-url";
+import { shouldOpenBrowser } from "../../utils/should-open-browser";
+import { CreateConnectionSchema, CreateConnectionItemSchema, } from "./schemas";
+export const createConnectionPlugin = definePlugin((sdk) => createPluginMethod(sdk, {
+    name: "createConnection",
+    categories: ["connection"],
+    type: "create",
+    itemType: "Connection",
+    inputSchema: CreateConnectionSchema,
+    outputSchema: CreateConnectionItemSchema,
+    resolvers: { app: appKeyResolver },
+    formatter: {
+        format: (item) => ({
+            title: `Connection created: ${item.title || item.id}`,
+            id: item.id,
+            details: [
+                { text: `App: ${item.app}`, style: "normal" },
+                { text: `ID:  ${item.id}`, style: "accent" },
+            ],
+        }),
+    },
+    handler: async ({ sdk: inner, options, }) => {
+        const { data: start } = await inner.getConnectionStartUrl({
+            app: options.app,
+        });
+        // Tag this method's scope so eventEmission's onMethodEnd hook
+        // emits the MethodCalled event with `selected_api` set. The inner
+        // call sets metadata in its own scope, so we set it again here for
+        // createConnection's outer scope.
+        setMethodMetadata({ selectedApi: start.app });
+        // console.error (stderr) so JSON output on stdout (CLI --json flag)
+        // stays parseable, and so this works without bare `process` access in
+        // browser bundles — matching open-approval.ts. Always printed: a
+        // failed / skipped browser-open falls back to user copy-paste, so this
+        // is the load-bearing contract.
+        console.error(`\nOpen this URL to complete the connection:\n  ${start.url}\n`);
+        const shouldOpen = options.browser === "always" ||
+            (options.browser === "auto" && shouldOpenBrowser());
+        if (shouldOpen) {
+            try {
+                // Resolves once the OS handler is launched, not when the user
+                // finishes auth — that's waitForNewConnection's job.
+                await openUrl(start.url);
+            }
+            catch {
+                // openUrl can throw on unsupported platforms or when no handler is
+                // available. The URL is already printed to stderr, so the user can
+                // copy it.
+            }
+        }
+        const { data: fresh } = await inner.waitForNewConnection({
+            app: start.app,
+            // Server-stamped mint time: measured on the same clock as a
+            // connection's `date`, so the freshness check is immune to
+            // client/server clock skew.
+            startedAt: start.startedAt,
+            timeoutMs: options.timeoutMs,
+            pollIntervalMs: options.pollIntervalMs,
+        });
+        return {
+            data: CreateConnectionItemSchema.parse({
+                id: fresh.id,
+                app: start.app,
+                title: fresh.title ?? null,
+            }),
+        };
+    },
+}));

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

@@ -0,0 +1,21 @@
+import { z } from "zod";
+export declare const CreateConnectionSchema: z.ZodObject<{
+    app: z.ZodString & {
+        _def: z.core.$ZodStringDef & import("kitcore").PositionalMetadata;
+    };
+    browser: z.ZodDefault<z.ZodEnum<{
+        never: "never";
+        auto: "auto";
+        always: "always";
+    }>>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type CreateConnectionOptions = z.infer<typeof CreateConnectionSchema>;
+export declare const CreateConnectionItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    app: z.ZodString;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type CreateConnectionItem = z.infer<typeof CreateConnectionItemSchema>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/createConnection/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;iBA4BhC,CAAC;AAEJ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE7E,eAAO,MAAM,0BAA0B;;;;iBAoBK,CAAC;AAE7C,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/plugins/createConnection/schemas.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { AppPropertySchema } from "../../types/properties";
+export const CreateConnectionSchema = z
+    .object({
+    app: AppPropertySchema,
+    browser: z
+        .enum(["auto", "always", "never"])
+        .default("auto")
+        .describe("When to auto-open the URL in a browser. `auto` (default) opens in local sessions and skips opening in CI / SSH / headless-Linux. `always` forces the open attempt. `never` skips it. The URL is always printed to stderr regardless — a failed or skipped open degrades gracefully to copy-paste."),
+    timeoutMs: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("How long to wait for the user to complete the connection flow before giving up. Default 5 minutes (300_000)."),
+    pollIntervalMs: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Delay before the first poll request, in ms. Default 3 seconds (3_000). Subsequent polling cadence is managed by the SDK's polling primitive (backoff with sane defaults)."),
+})
+    .describe("Create a new app connection, end-to-end. Mints the start URL via `get-connection-start-url`, prints it to stderr, opportunistically opens it in a browser when it looks safe to do so (skipping CI / SSH / headless-Linux by default — pass `--browser always` to force, `--browser never` to suppress), then polls via `wait-for-new-connection` until the user completes OAuth and the new connection appears. Returns the connection.\n\nThis is the right command for most callers. Reach for the lower-level building blocks when you want either of: (a) hand off the URL and *not* block on completion — call `get-connection-start-url` alone, no `wait-for-new-connection` needed, or (b) do something custom between minting the URL and waiting — call `get-connection-start-url`, do your work (email or DM the URL, render a QR code, etc.), then `wait-for-new-connection`.");
+export const CreateConnectionItemSchema = z
+    .object({
+    id: z
+        .string()
+        .describe("The new connection's ID. Public UUID when available, falling back to the numeric ID."),
+    app: z
+        .string()
+        .describe("Versionless app key the connection was created for (e.g., 'SlackCLIAPI')."),
+    title: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("Human-readable connection title set by the auth flow, when available."),
+})
+    .describe("The newly created connection.");

package/dist/plugins/getConnectionStartUrl/index.d.ts

@@ -0,0 +1,206 @@
+import { type GetConnectionStartUrlItem } from "./schemas";
+export declare const getConnectionStartUrlPlugin: (sdk: {
+    context: {
+        api: import("../..").ApiClient;
+        resolveCredentials: () => Promise<string | {
+            clientId: string;
+            clientSecret: string;
+            type?: "client_credentials" | undefined;
+            baseUrl?: string | undefined;
+            scope?: string | undefined;
+        } | {
+            clientId: string;
+            type?: "pkce" | undefined;
+            baseUrl?: string | undefined;
+            scope?: string | undefined;
+        } | undefined>;
+    };
+} & {
+    context: {
+        getResolvedManifest: () => Promise<import("../manifest").Manifest | null>;
+        getVersionedImplementationId: (appKey: string) => Promise<string | null>;
+        resolveAppKeys: ({ appKeys }: {
+            appKeys: string[];
+        }) => Promise<import("../..").ResolvedAppLocator[]>;
+        updateManifestEntry: (options: import("../manifest").UpdateManifestEntryOptions) => Promise<import("../manifest").UpdateManifestEntryResult>;
+        addActionEntry: (options: import("../manifest").AddActionEntryOptions) => Promise<import("../manifest").AddActionEntryResult>;
+        findActionEntry: ({ name, manifest, }: {
+            name: string;
+            manifest: import("../manifest").Manifest;
+        }) => import("../manifest").ActionEntry | null;
+        listActionEntries: ({ configPath, }?: {
+            configPath?: string;
+        }) => Promise<Array<[string, import("../manifest").ActionEntry]>>;
+        deleteActionEntry: ({ name, configPath, skipWrite, }: {
+            name: string;
+            configPath?: string;
+            skipWrite?: boolean;
+        }) => Promise<import("../manifest").Manifest>;
+        hasActionEntry: ({ name, manifest, }: {
+            name: string;
+            manifest: import("../manifest").Manifest;
+        }) => boolean;
+        findManifestEntry: typeof import("../manifest").findManifestEntry;
+        readManifestFromFile: typeof import("../manifest").readManifestFromFile;
+        getManifestConnections: () => Promise<Record<string, {
+            connectionId: string | number;
+        }> | null>;
+    };
+} & {
+    getApp: (options?: {
+        app: string;
+    } | {
+        appKey: string;
+    } | undefined) => Promise<{
+        data: {
+            slug: string;
+            title: string;
+            key: string;
+            implementation_id: string;
+            description?: string | undefined;
+            is_hidden?: boolean | undefined;
+            auth_type?: string | undefined;
+            actions?: {
+                read?: number | undefined;
+                read_bulk?: number | undefined;
+                write?: number | undefined;
+                search?: number | undefined;
+                search_or_write?: number | undefined;
+                search_and_write?: number | undefined;
+                filter?: number | undefined;
+            } | undefined;
+            is_deprecated?: boolean | undefined;
+            is_beta?: boolean | undefined;
+            is_premium?: boolean | undefined;
+            age_in_days?: number | undefined;
+            banner?: string | undefined;
+            categories?: {
+                id: number;
+                name: string;
+                slug: string;
+            }[] | undefined;
+            images?: {
+                url_16x16?: string | undefined;
+                url_32x32?: string | undefined;
+                url_64x64?: string | undefined;
+                url_128x128?: string | undefined;
+            } | undefined;
+            popularity?: number | undefined;
+            has_filters?: boolean | undefined;
+            has_reads?: boolean | undefined;
+            has_searches?: boolean | undefined;
+            has_searches_or_writes?: boolean | undefined;
+            has_upfront_fields?: boolean | undefined;
+            has_writes?: boolean | undefined;
+            is_built_in?: boolean | undefined;
+            is_featured?: boolean | undefined;
+            is_invite?: boolean | undefined;
+            is_public?: boolean | undefined;
+            is_upcoming?: boolean | undefined;
+            visibility?: string | undefined;
+            primary_color?: string | undefined;
+            secondary_color?: string | undefined;
+            classification?: string | undefined;
+            api_docs_url?: string | undefined;
+            image?: string | undefined;
+            version?: string | undefined;
+        };
+    }>;
+} & {
+    context: {
+        meta: {
+            getApp: import("kitcore").PluginMeta<unknown>;
+        };
+    };
+} & {
+    listApps: (options?: ({
+        search?: string | undefined;
+        apps?: string[] | undefined;
+        appKeys?: string[] | undefined;
+        pageSize?: number | undefined;
+        maxItems?: number | undefined;
+        cursor?: string | undefined;
+    } & {
+        cursor?: string;
+        pageSize?: number;
+        maxItems?: number;
+    }) | undefined) => import("kitcore").PaginatedSdkResult<{
+        slug: string;
+        title: string;
+        key: string;
+        implementation_id: string;
+        description?: string | undefined;
+        is_hidden?: boolean | undefined;
+        auth_type?: string | undefined;
+        actions?: {
+            read?: number | undefined;
+            read_bulk?: number | undefined;
+            write?: number | undefined;
+            search?: number | undefined;
+            search_or_write?: number | undefined;
+            search_and_write?: number | undefined;
+            filter?: number | undefined;
+        } | undefined;
+        is_deprecated?: boolean | undefined;
+        is_beta?: boolean | undefined;
+        is_premium?: boolean | undefined;
+        age_in_days?: number | undefined;
+        banner?: string | undefined;
+        categories?: {
+            id: number;
+            name: string;
+            slug: string;
+        }[] | undefined;
+        images?: {
+            url_16x16?: string | undefined;
+            url_32x32?: string | undefined;
+            url_64x64?: string | undefined;
+            url_128x128?: string | undefined;
+        } | undefined;
+        popularity?: number | undefined;
+        has_filters?: boolean | undefined;
+        has_reads?: boolean | undefined;
+        has_searches?: boolean | undefined;
+        has_searches_or_writes?: boolean | undefined;
+        has_upfront_fields?: boolean | undefined;
+        has_writes?: boolean | undefined;
+        is_built_in?: boolean | undefined;
+        is_featured?: boolean | undefined;
+        is_invite?: boolean | undefined;
+        is_public?: boolean | undefined;
+        is_upcoming?: boolean | undefined;
+        visibility?: string | undefined;
+        primary_color?: string | undefined;
+        secondary_color?: string | undefined;
+        classification?: string | undefined;
+        api_docs_url?: string | undefined;
+        image?: string | undefined;
+        version?: string | undefined;
+    }>;
+} & {
+    context: {
+        meta: {
+            listApps: import("kitcore").PluginMeta<unknown>;
+        };
+    };
+} & {
+    context: import("../eventEmission").EventEmissionContext;
+} & {
+    context: {
+        meta: Record<string, import("kitcore").PluginMeta>;
+    };
+}) => {
+    getConnectionStartUrl: (options?: {
+        app: string;
+    } | undefined) => Promise<{
+        data: GetConnectionStartUrlItem;
+    }>;
+} & {
+    context: {
+        meta: {
+            getConnectionStartUrl: import("kitcore").PluginMeta<unknown>;
+        };
+    };
+};
+export type GetConnectionStartUrlPluginProvides = ReturnType<typeof getConnectionStartUrlPlugin>;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/getConnectionStartUrl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/getConnectionStartUrl/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,yBAAyB,EAC/B,MAAM,WAAW,CAAC;AAoBnB,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAmDuhX,CAAC;;;;sBAAiX,CAAC;qBAAyB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cApCp7X,yBAAyB;;;;;;;;CA+BhD,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG,UAAU,CAC1D,OAAO,2BAA2B,CACnC,CAAC"}

package/dist/plugins/getConnectionStartUrl/index.js

@@ -0,0 +1,39 @@
+import { definePlugin, createPluginMethod } from "kitcore";
+import { setMethodMetadata } from "../eventEmission/method-metadata";
+import { appKeyResolver } from "../../resolvers";
+import { GetConnectionStartUrlSchema, GetConnectionStartUrlItemSchema, } from "./schemas";
+// Server endpoint that mints a signed, single-use connection start URL.
+const START_PATH = "/zapier/api/authentications/v1/sdk/connections/start";
+export const getConnectionStartUrlPlugin = definePlugin((sdk) => createPluginMethod(sdk, {
+    name: "getConnectionStartUrl",
+    categories: ["connection"],
+    type: "create",
+    itemType: "ConnectionStartUrl",
+    inputSchema: GetConnectionStartUrlSchema,
+    outputSchema: GetConnectionStartUrlItemSchema,
+    resolvers: { app: appKeyResolver },
+    handler: async ({ sdk: inner, options, }) => {
+        // Send the versionless app key: the server resolves it to the freshest
+        // production version when the user opens the URL, which can be minutes
+        // after this call.
+        const versionedKey = await inner.context.getVersionedImplementationId(options.app);
+        const selectedApi = versionedKey
+            ? versionedKey.split("@")[0]
+            : options.app;
+        // Tag this method's scope so eventEmission's onMethodEnd hook
+        // emits the MethodCalled event with `selected_api` set.
+        setMethodMetadata({ selectedApi });
+        const response = await inner.context.api.post(START_PATH, { selected_api: selectedApi }, { authRequired: true });
+        // Parse the mapped shape against the output schema so a server-side
+        // response change surfaces as a validation error here rather than
+        // silently producing a malformed item.
+        return {
+            data: GetConnectionStartUrlItemSchema.parse({
+                url: response.url,
+                expiresAt: response.expires_at,
+                startedAt: response.started_at,
+                app: selectedApi,
+            }),
+        };
+    },
+}));

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

@@ -0,0 +1,15 @@
+import { z } from "zod";
+export declare const GetConnectionStartUrlSchema: z.ZodObject<{
+    app: z.ZodString & {
+        _def: z.core.$ZodStringDef & import("kitcore").PositionalMetadata;
+    };
+}, z.core.$strip>;
+export type GetConnectionStartUrlOptions = z.infer<typeof GetConnectionStartUrlSchema>;
+export declare const GetConnectionStartUrlItemSchema: z.ZodObject<{
+    url: z.ZodString;
+    expiresAt: z.ZodNumber;
+    startedAt: z.ZodNumber;
+    app: z.ZodString;
+}, z.core.$strip>;
+export type GetConnectionStartUrlItem = z.infer<typeof GetConnectionStartUrlItemSchema>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/getConnectionStartUrl/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,2BAA2B;;;;iBAMrC,CAAC;AAEJ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,2BAA2B,CACnC,CAAC;AAEF,eAAO,MAAM,+BAA+B;;;;;iBAyBzC,CAAC;AAEJ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,+BAA+B,CACvC,CAAC"}

package/dist/plugins/getConnectionStartUrl/schemas.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { AppPropertySchema } from "../../types/properties";
+export const GetConnectionStartUrlSchema = z
+    .object({
+    app: AppPropertySchema,
+})
+    .describe("Mint a short-lived URL that begins an SDK-initiated connection flow. The URL is signed by zapier.com and bound to the current user/account — opening it in a different browser session will fail the binding check. Returns the URL as data so the caller decides what to do with it.\n\nUse this directly (rather than the higher-level `create-connection`) when you want either of: (a) hand off the URL and *not* block waiting for completion — call this alone, skip `wait-for-new-connection` entirely, or (b) do something custom between minting the URL and waiting for the connection — call this, then email or DM the URL, render it as a QR code for mobile sign-in, etc., then call `wait-for-new-connection`. For the common case where you'd just print and poll back-to-back, `create-connection` is one call.\n\nPair with `wait-for-new-connection` to detect completion: pass the `startedAt` returned here straight through (it's the server's mint time, so polling isn't affected by client clock skew). Example (JS):\n\n```ts\nconst { data: { url, app, startedAt } } = await zapier.getConnectionStartUrl({ app: 'slack' });\n// hand `url` off — print it, DM it, email it, render a button, whatever\nconst { data: conn } = await zapier.waitForNewConnection({ app, startedAt });\n```");
+export const GetConnectionStartUrlItemSchema = z
+    .object({
+    url: z
+        .string()
+        .describe("URL the user should open in their browser to complete the auth flow. Single-use, time-limited."),
+    expiresAt: z
+        .number()
+        .describe("Unix timestamp (seconds) after which the URL's signature is rejected by zapier.com."),
+    startedAt: z
+        .number()
+        .describe("Unix timestamp (seconds) when the server minted the URL. Use it as the `startedAt` for `wait-for-new-connection` so polling is anchored to server time rather than a possibly-skewed client clock."),
+    app: z
+        .string()
+        .describe("Versionless app key the URL was minted for (e.g., 'SlackCLIAPI'). Useful for downstream filtering."),
+})
+    .describe("The signed start-URL plus metadata needed to poll for completion.");