@nangohq/runner-sdk 0.70.8 → 0.71.0

package/dist/function.unit.test.js

@@ -0,0 +1,254 @@
+/* eslint-disable @typescript-eslint/unbound-method */
+import { describe, expect, expectTypeOf, it } from 'vitest';
+import * as z from 'zod';
+import { createFunction } from './function.js';
+describe('createFunction', () => {
+    describe('schedule (sync)', () => {
+        it('computes capabilities and exposes records + checkpoint + metadata + proxy', () => {
+            const fn = createFunction({
+                description: 'Fetch issues from GitHub',
+                data: {
+                    models: { GithubIssue: z.object({ id: z.string(), title: z.string() }) },
+                    checkpoint: z.object({ lastId: z.string() }),
+                    metadata: z.object({ org: z.string() })
+                },
+                trigger: { kind: 'schedule', frequency: 'every 2h', autoStart: true },
+                exec: async (nango, trigger) => {
+                    await nango.batchSave([{ id: '1', title: 't' }], 'GithubIssue');
+                    await nango.batchUpdate([{ id: '1', title: 't' }], 'GithubIssue');
+                    await nango.batchDelete([{ id: '1', title: 't' }], 'GithubIssue');
+                    await nango.trackDeletesStart('GithubIssue');
+                    await nango.trackDeletesEnd('GithubIssue');
+                    const cp = await nango.getCheckpoint();
+                    await nango.saveCheckpoint({ lastId: '1' });
+                    await nango.getMetadata();
+                    expectTypeOf().toEqualTypeOf();
+                    expectTypeOf(nango.batchSave).parameter(1).toEqualTypeOf();
+                    expectTypeOf(cp).toEqualTypeOf();
+                    expectTypeOf(nango.getMetadata()).toEqualTypeOf();
+                    expectTypeOf(trigger.kind).toEqualTypeOf();
+                    expectTypeOf(trigger.input).toEqualTypeOf();
+                }
+            });
+            expect(fn.type).toBe('function');
+            expect(fn.capabilities).toStrictEqual({
+                usesRecords: true,
+                usesCheckpoints: true,
+                usesMetadata: true,
+                usesOutbound: true,
+                usesInvoke: false
+            });
+        });
+        it('disallows a declared input on schedule and event triggers', () => {
+            createFunction({
+                description: 'schedule cannot declare input',
+                // @ts-expect-error schedule triggers carry no caller input
+                input: z.object({ since: z.string() }),
+                trigger: { kind: 'schedule', frequency: 'every hour' },
+                exec: (_nango, trigger) => {
+                    expectTypeOf(trigger.input).toEqualTypeOf();
+                }
+            });
+            createFunction({
+                description: 'event cannot declare input',
+                // @ts-expect-error event triggers carry no caller input
+                input: z.object({ since: z.string() }),
+                trigger: { kind: 'event', events: ['pre-connection-deletion'] },
+                exec: (_nango, trigger) => {
+                    expectTypeOf(trigger.input).toEqualTypeOf();
+                }
+            });
+        });
+    });
+    describe('http with models (webhook)', () => {
+        it('exposes record capability and types the http payload from the trigger input', () => {
+            const fn = createFunction({
+                description: 'Handle GitHub issue webhooks',
+                input: z.object({ action: z.string() }),
+                data: { models: { GithubIssue: z.object({ id: z.string() }) } },
+                trigger: { kind: 'http', subscriptions: ['issues.opened'] },
+                exec: async (nango, trigger) => {
+                    await nango.batchSave([{ id: '1' }], 'GithubIssue');
+                    expectTypeOf().toEqualTypeOf();
+                    expectTypeOf(trigger.kind).toEqualTypeOf();
+                    expectTypeOf(trigger.input).toEqualTypeOf();
+                    expectTypeOf(trigger.request.headers).toEqualTypeOf();
+                }
+            });
+            expect(fn.capabilities).toStrictEqual({
+                usesRecords: true,
+                usesCheckpoints: false,
+                usesMetadata: false,
+                usesOutbound: true,
+                usesInvoke: false
+            });
+        });
+        it('types the input as an array when debounce take is "all"', () => {
+            createFunction({
+                description: 'Handle coalesced webhooks',
+                input: z.object({ action: z.string() }),
+                trigger: { kind: 'http', debounce: { windowMs: 5000, take: 'all' } },
+                exec: (_nango, trigger) => {
+                    expectTypeOf(trigger.input).toEqualTypeOf();
+                }
+            });
+            createFunction({
+                description: 'Handle latest webhook',
+                input: z.object({ action: z.string() }),
+                trigger: { kind: 'http', debounce: { windowMs: 5000, take: 'latest' } },
+                exec: (_nango, trigger) => {
+                    expectTypeOf(trigger.input).toEqualTypeOf();
+                }
+            });
+        });
+    });
+    describe('http without models (action)', () => {
+        it('has no record methods, types input and output', () => {
+            const fn = createFunction({
+                description: 'Create a GitHub issue',
+                input: z.object({ title: z.string() }),
+                output: z.object({ issueId: z.string() }),
+                trigger: { kind: 'http' },
+                exec: (_nango, trigger) => {
+                    expectTypeOf().toEqualTypeOf();
+                    expectTypeOf().toEqualTypeOf();
+                    expectTypeOf(trigger.input).toEqualTypeOf();
+                    return { issueId: '123' };
+                }
+            });
+            expect(fn.capabilities.usesRecords).toBe(false);
+            expect(fn.capabilities.usesOutbound).toBe(true);
+        });
+    });
+    describe('event', () => {
+        it('exposes the lifecycle event payload', () => {
+            const fn = createFunction({
+                description: 'Run before a connection is deleted',
+                trigger: { kind: 'event', events: ['pre-connection-deletion'] },
+                exec: async (nango, trigger) => {
+                    await nango.log('executed');
+                    expectTypeOf(trigger.kind).toEqualTypeOf();
+                    expectTypeOf(trigger.input).toEqualTypeOf();
+                }
+            });
+            expect(fn.capabilities.usesRecords).toBe(false);
+        });
+    });
+    describe('requires', () => {
+        it('exposes invoke and removes proxy when requires disables it', () => {
+            const child = createFunction({
+                description: 'child',
+                input: z.object({ q: z.string() }),
+                output: z.object({ n: z.number() }),
+                exec: (_nango, trigger) => {
+                    expectTypeOf(trigger.kind).toEqualTypeOf();
+                    expectTypeOf(trigger.input).toEqualTypeOf();
+                    return { n: 1 };
+                }
+            });
+            const fn = createFunction({
+                description: 'dispatcher',
+                requires: { outbound: false, invoke: true },
+                trigger: { kind: 'schedule', frequency: 'every hour' },
+                exec: async (nango) => {
+                    expectTypeOf().toEqualTypeOf();
+                    expectTypeOf().toEqualTypeOf();
+                    const res = await nango.invoke(child, { input: { q: 'x' } });
+                    expectTypeOf(res).toEqualTypeOf();
+                }
+            });
+            expect(fn.capabilities).toStrictEqual({
+                usesRecords: false,
+                usesCheckpoints: false,
+                usesMetadata: false,
+                usesOutbound: false,
+                usesInvoke: true
+            });
+        });
+        it('invoke types its input from the target, regardless of trigger kind', () => {
+            const httpFn = createFunction({
+                description: 'http target',
+                input: z.object({ title: z.string() }),
+                output: z.object({ ok: z.boolean() }),
+                trigger: { kind: 'http', debounce: { windowMs: 1000, take: 'all' } },
+                exec: () => ({ ok: true })
+            });
+            const scheduleFn = createFunction({
+                description: 'schedule target',
+                trigger: { kind: 'schedule', frequency: 'every hour' },
+                exec: () => { }
+            });
+            createFunction({
+                description: 'dispatcher',
+                requires: { outbound: false, invoke: true },
+                trigger: { kind: 'schedule', frequency: 'every hour' },
+                exec: async (nango) => {
+                    // http target: invoke passes the single declared input (not the coalesced array)
+                    const httpRes = await nango.invoke(httpFn, { input: { title: 'x' } });
+                    expectTypeOf(httpRes).toEqualTypeOf();
+                    // @ts-expect-error http input must match the declared input schema
+                    await nango.invoke(httpFn, { input: { wrong: 1 } });
+                    // @ts-expect-error required input cannot be skipped
+                    await nango.invoke(httpFn);
+                    // schedule target: no declared input
+                    await nango.invoke(scheduleFn);
+                    // a widened/opaque function reference is rejected
+                    const opaque = httpFn;
+                    // @ts-expect-error opaque reference does not satisfy the invoke target constraint
+                    await nango.invoke(opaque, { input: { title: 'x' } });
+                }
+            });
+        });
+        it('connection-less function can only searchConnections and invoke', () => {
+            createFunction({
+                description: 'resolves connections at runtime',
+                requires: { connection: false, invoke: true },
+                trigger: { kind: 'schedule', frequency: 'every hour' },
+                exec: async (nango) => {
+                    await nango.searchConnections({ provider: 'github' });
+                    expectTypeOf().toEqualTypeOf();
+                    expectTypeOf().toEqualTypeOf();
+                    expectTypeOf().toEqualTypeOf();
+                    expectTypeOf().toEqualTypeOf();
+                }
+            });
+        });
+    });
+    describe('no models', () => {
+        it('does not expose record/checkpoint/metadata methods', () => {
+            createFunction({
+                description: 'no models',
+                trigger: { kind: 'schedule', frequency: 'every hour' },
+                exec: (_nango) => {
+                    expectTypeOf().toEqualTypeOf();
+                    expectTypeOf().toEqualTypeOf();
+                    expectTypeOf().toEqualTypeOf();
+                }
+            });
+        });
+    });
+    describe('limits.concurrency.perConnection', () => {
+        it('is fixed to 1 for schedule triggers and a ConcurrencyLimit otherwise', () => {
+            createFunction({
+                description: 'scheduled',
+                trigger: { kind: 'schedule', frequency: 'every hour' },
+                limits: { concurrency: { perConnection: 1 } },
+                exec: () => { }
+            });
+            createFunction({
+                description: 'http can overlap runs for a connection',
+                trigger: { kind: 'http' },
+                limits: { concurrency: { perConnection: 'max' } },
+                exec: () => { }
+            });
+            createFunction({
+                description: 'schedule function cannot overlap',
+                trigger: { kind: 'schedule', frequency: 'every hour' },
+                // @ts-expect-error schedule triggers are pinned to perConnection: 1
+                limits: { concurrency: { perConnection: 'max' } },
+                exec: () => { }
+            });
+        });
+    });
+});
+//# sourceMappingURL=function.unit.test.js.map

package/dist/function.unit.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function.unit.test.js","sourceRoot":"","sources":["../lib/function.unit.test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import PaginationService from './paginate.service.js';
 export type { ZodCheckpoint } from './types.js';
 export * from './action.js';
 export * from './dataValidation.js';
@@ -5,8 +6,9 @@ export * from './errors.js';
 export * from './sync.js';
 export * from './scripts.js';
 export * from './checkpoint.js';
+export { createFunction, deriveFunctionCapabilities } from './function.js';
+export type { CreateFunctionProps, CreateFunctionResponse, Requires, TriggerDefinition } from './function.js';
 export { executeUncontrolledFetch } from './uncontrolledFetch.js';
 export type { UncontrolledFetchOptions } from './uncontrolledFetch.js';
 export { isBaseUrlOverridePolicyEnabledFromEnv, resolveProxyBaseUrlOverrideDenylist } from './baseUrlOverrideDenylist.js';
-import PaginationService from './paginate.service.js';
 export { PaginationService };

package/dist/index.js

@@ -1,11 +1,12 @@
+import PaginationService from './paginate.service.js';
 export * from './action.js';
 export * from './dataValidation.js';
 export * from './errors.js';
 export * from './sync.js';
 export * from './scripts.js';
 export * from './checkpoint.js';
+export { createFunction, deriveFunctionCapabilities } from './function.js';
 export { executeUncontrolledFetch } from './uncontrolledFetch.js';
 export { isBaseUrlOverridePolicyEnabledFromEnv, resolveProxyBaseUrlOverrideDenylist } from './baseUrlOverrideDenylist.js';
-import PaginationService from './paginate.service.js';
 export { PaginationService };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,qCAAqC,EAAE,mCAAmC,EAAE,MAAM,8BAA8B,CAAC;AAC1H,OAAO,iBAAiB,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,uBAAuB,CAAC;AAGtD,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAE3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,qCAAqC,EAAE,mCAAmC,EAAE,MAAM,8BAA8B,CAAC;AAE1H,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/scripts.d.ts

@@ -4,7 +4,7 @@ import type { ZodCheckpoint, ZodMetadata, ZodModel } from './types.js';
 import type { NangoSyncEndpointV2 } from '@nangohq/types';
 import type { MaybePromise } from 'rollup';
 import type * as z from 'zod';
-export type CreateAnyResponse = CreateSyncResponse<any, ZodMetadata, ZodCheckpoint> | CreateActionResponse<any, any, ZodMetadata, ZodCheckpoint> | CreateOnEventResponse<ZodMetadata, ZodCheckpoint> | CreateFunctionResponse<any, any, any, ZodMetadata, ZodCheckpoint>;
+export type CreateAnyResponse = CreateSyncResponse<any, ZodMetadata, ZodCheckpoint> | CreateActionResponse<any, any, ZodMetadata, ZodCheckpoint> | CreateOnEventResponse<ZodMetadata, ZodCheckpoint>;
 export type { ActionError } from './errors.js';
 export type { NangoActionBase as NangoAction, ProxyConfiguration } from './action.js';
 export type { NangoSyncBase as NangoSync } from './sync.js';
@@ -362,217 +362,3 @@ export interface CreateOnEventResponse<TMetadata extends ZodMetadata = undefined
  * Create an onEvent script
  */
 export declare function createOnEvent<TMetadata extends ZodMetadata = undefined, TCheckpoint extends ZodCheckpoint = undefined>(params: CreateOnEventProps<TMetadata, TCheckpoint>): CreateOnEventResponse<TMetadata, TCheckpoint>;
-/**
- * The kind of declared trigger that initiated a function run.
- * - `http`: an incoming http call or webhook request
- * - `schedule`: a periodic schedule
- * - `event`: an internal Nango event
- *
- * On-demand invocation (`nango.triggerFunction()`, the REST API, the CLI, or the UI) is always
- * available regardless of declared triggers — it is not a trigger type. Such runs leave
- * `FunctionEvent.trigger` undefined.
- */
-export type FunctionTriggerType = 'http' | 'schedule' | 'event';
-/**
- * Declares where the debounce/coalescing key is extracted from.
- * - `{ body: '$.portalId' }` — dot-notation path into the normalized body
- * - `{ header: 'x-goog-resource-id' }` — flat, case-insensitive header lookup
- */
-export type DebounceKeySource = {
-    body: string;
-} | {
-    header: string;
-};
-/**
- * Coalesces multiple inbound events into a single function run within a sliding window.
- */
-export interface WebhookDebounceConfig {
-    key?: DebounceKeySource;
-    /** Sliding window in milliseconds. */
-    windowMs: number;
-    /** Hard ceiling for the window regardless of incoming events. */
-    maxWindowMs?: number;
-    /** When exceeded, the window stops sliding and `event.coalesced.overflowed` is set. */
-    maxEntities?: number;
-    /** Whether the handler receives only the latest payload or every coalesced payload. */
-    payloadMode?: 'latest' | 'all';
-}
-/** Read-only request view passed to ingress hooks. No SDK, no I/O, hard timeout. */
-export interface IngressEvent {
-    rawBody: string;
-    headers: Record<string, string>;
-    query: Record<string, string | string[] | undefined>;
-}
-/**
- * Runs synchronously at ingress before enqueueing. Return a response object to short-circuit
- * the HTTP exchange (provider handshake), or `undefined` to let the request proceed.
- */
-export type IngressChallenge = (event: IngressEvent) => MaybePromise<{
-    status?: number;
-    body?: unknown;
-    headers?: Record<string, string>;
-} | undefined | void>;
-/**
- * Runs synchronously at ingress before enqueueing. Return `true` to accept the event,
- * or `false` (or throw) to reject it with a 401.
- */
-export type IngressValidation = (event: IngressEvent) => MaybePromise<boolean>;
-export interface HttpTrigger {
-    type: 'http';
-    /** Maps to the webhook URL path segment. Defaults to the file basename. */
-    name?: string;
-    /** `connection` opts into connection-level URLs (`/:webhookName/:targetToken`). */
-    scope?: 'integration' | 'connection';
-    ingressChallenge?: IngressChallenge;
-    ingressValidation?: IngressValidation;
-    debounce?: WebhookDebounceConfig;
-}
-export interface ScheduleTrigger {
-    type: 'schedule';
-    /** e.g. 'every hour', 'every 2 minutes'. */
-    schedule: string;
-}
-export interface EventTrigger {
-    type: 'event';
-    event: string;
-}
-export type FunctionTrigger = HttpTrigger | ScheduleTrigger | EventTrigger;
-/** Coalescing summary, present on the event when `debounce` is configured. */
-export interface CoalescedInfo {
-    count: number;
-    firstSeenAt: Date;
-    lastSeenAt: Date;
-    overflowed: boolean;
-}
-/**
- * The event a function `exec` receives. Distinct from `(nango, input)` for actions —
- * functions are trigger-driven, so the second argument describes the trigger and its payload.
- */
-export interface FunctionEvent<TPayload = unknown> {
-    /**
-     * Which declared trigger fired, and (for named triggers) its name.
-     * Undefined when the run was started on-demand (`nango.triggerFunction()`, the REST API, the CLI, or the UI).
-     */
-    trigger?: {
-        type: FunctionTriggerType;
-        name?: string;
-    };
-    /**
-     * The payload that initiated the run. Typed as the function's `input` schema when declared,
-     * otherwise `unknown`. For http triggers this is the provider's body (not validated against
-     * `input` at runtime), and it is an array of `TPayload` when `payloadMode: 'all'` is set and debounced.
-     */
-    payload: TPayload;
-    /** Raw headers from the provider (http trigger only). */
-    headers?: Record<string, string>;
-    /** Original request body as received by ingress (http trigger only). */
-    rawBody?: string;
-    /** Coalescing summary when `debounce` is configured. */
-    coalesced?: CoalescedInfo;
-    /**
-     * Pre-populated when the run was started with connection context (connection-level URL,
-     * `triggerFunction({ connectionId })`, or CLI `--connection`). Undefined for connection-less runs.
-     */
-    connection?: {
-        connection_id: string;
-        provider_config_key: string;
-    };
-}
-export interface CreateFunctionProps<TModels extends Record<string, ZodModel>, TInput extends z.ZodTypeAny = z.ZodUnknown, TOutput extends z.ZodTypeAny = z.ZodTypeAny, TMetadata extends ZodMetadata = undefined, TCheckpoint extends ZodCheckpoint = undefined> {
-    /**
-     * The version of the function. Use it to track changes inside Nango's UI.
-     * Supports semver (e.g. `'1.0.0'`)
-     * If omitted, Nango auto-manages it: `1` on first deploy, and auto-increments for subsequent deploys.
-     */
-    version?: string;
-    /** The description of the function. */
-    description?: string;
-    /**
-     * What can initiate execution. A function can have multiple triggers of different types
-     * (e.g. a webhook trigger plus a scheduled safety net). Any function can also be started
-     * on-demand via `nango.triggerFunction()` or the API regardless of declared triggers.
-     */
-    triggers: FunctionTrigger[];
-    /** Models the function can `batchSave`/`batchUpdate`/`batchDelete` against. */
-    models?: TModels;
-    /** Optional input schema. When set, it types `event.payload` and is used for API invocation. */
-    input?: TInput;
-    /** Optional typed output schema (reserved; unused for webhooks today). */
-    output?: TOutput;
-    metadata?: TMetadata;
-    checkpoint?: TCheckpoint;
-    scopes?: string[];
-    /**
-     * The handler. Runs on the customer runner with full SDK access.
-     * @example
-     * ```ts
-     * exec: async (nango, event) => {
-     *   const connections = await nango.searchConnections({ tags: { portalId: event.payload.portalId } });
-     *   for (const connection of connections) {
-     *     await nango.triggerSync(connection.provider_config_key, connection.connection_id, 'contacts');
-     *   }
-     * }
-     * ```
-     */
-    exec: (nango: NangoSyncBase<TModels, TMetadata, TCheckpoint>, event: FunctionEvent<z.infer<TInput>>) => MaybePromise<void>;
-}
-export interface CreateFunctionResponse<TModels extends Record<string, ZodModel>, TInput extends z.ZodTypeAny = z.ZodUnknown, TOutput extends z.ZodTypeAny = z.ZodTypeAny, TMetadata extends ZodMetadata = undefined, TCheckpoint extends ZodCheckpoint = undefined> extends CreateFunctionProps<TModels, TInput, TOutput, TMetadata, TCheckpoint> {
-    type: 'function';
-    /** Set when authored via `createWebhook()`; mirrors the http trigger name. */
-    name?: string;
-}
-/**
- * Create a function — the trigger-agnostic primitive.
- *
- * Use this directly when you need multiple trigger types (e.g. webhook + cron).
- * For a single webhook trigger, prefer the `createWebhook()` sugar.
- *
- * @example
- * ```ts
- * export default createFunction({
- *     triggers: [
- *         { type: 'http', name: 'contacts-updated', debounce: { key: { body: '$.objectId' }, windowMs: 5000 } },
- *         { type: 'schedule', schedule: 'every hour' }
- *     ],
- *     exec: async (nango, event) => { ... }
- * });
- * ```
- */
-export declare function createFunction<TModels extends Record<string, ZodModel> = Record<never, ZodModel>, TInput extends z.ZodTypeAny = z.ZodUnknown, TOutput extends z.ZodTypeAny = z.ZodTypeAny, TMetadata extends ZodMetadata = undefined, TCheckpoint extends ZodCheckpoint = undefined>(params: CreateFunctionProps<TModels, TInput, TOutput, TMetadata, TCheckpoint>): CreateFunctionResponse<TModels, TInput, TOutput, TMetadata, TCheckpoint>;
-export interface CreateWebhookProps<TModels extends Record<string, ZodModel>, TMetadata extends ZodMetadata = undefined, TCheckpoint extends ZodCheckpoint = undefined> {
-    /** Maps to the webhook URL path segment. Defaults to the file basename. */
-    name?: string;
-    version?: string;
-    description?: string;
-    /** `connection` opts into connection-level URLs (`/:webhookName/:targetToken`). */
-    scope?: 'integration' | 'connection';
-    ingressChallenge?: IngressChallenge;
-    ingressValidation?: IngressValidation;
-    debounce?: WebhookDebounceConfig;
-    models?: TModels;
-    metadata?: TMetadata;
-    checkpoint?: TCheckpoint;
-    exec: (nango: NangoSyncBase<TModels, TMetadata, TCheckpoint>, event: FunctionEvent) => MaybePromise<void>;
-}
-/**
- * Create a webhook handler — sugar for a function with a single implicit `http` trigger.
- *
- * Routing lives entirely in `exec` (customer-owned, runs on your runner). Provider protocol
- * mechanics (handshake, signature verification) live in `ingressChallenge` / `ingressValidation`,
- * which run synchronously at ingress with no SDK access.
- *
- * @example
- * ```ts
- * export default createWebhook({
- *     name: 'contacts-updated',
- *     debounce: { key: { body: '$.portalId' }, windowMs: 5000 },
- *     exec: async (nango, event) => {
- *         const connections = await nango.searchConnections({ tags: { portalId: event.payload.portalId } });
- *         for (const connection of connections) {
- *             await nango.triggerSync(connection.provider_config_key, connection.connection_id, 'contacts');
- *         }
- *     }
- * });
- * ```
- */
-export declare function createWebhook<TModels extends Record<string, ZodModel> = Record<never, ZodModel>, TMetadata extends ZodMetadata = undefined, TCheckpoint extends ZodCheckpoint = undefined>(params: CreateWebhookProps<TModels, TMetadata, TCheckpoint>): CreateFunctionResponse<TModels, z.ZodTypeAny, z.ZodTypeAny, TMetadata, TCheckpoint>;

package/dist/scripts.js

@@ -48,62 +48,4 @@ export function createAction(params) {
 export function createOnEvent(params) {
     return { type: 'onEvent', ...params };
 }
-/**
- * Create a function — the trigger-agnostic primitive.
- *
- * Use this directly when you need multiple trigger types (e.g. webhook + cron).
- * For a single webhook trigger, prefer the `createWebhook()` sugar.
- *
- * @example
- * ```ts
- * export default createFunction({
- *     triggers: [
- *         { type: 'http', name: 'contacts-updated', debounce: { key: { body: '$.objectId' }, windowMs: 5000 } },
- *         { type: 'schedule', schedule: 'every hour' }
- *     ],
- *     exec: async (nango, event) => { ... }
- * });
- * ```
- */
-export function createFunction(params) {
-    return { type: 'function', ...params };
-}
-/**
- * Create a webhook handler — sugar for a function with a single implicit `http` trigger.
- *
- * Routing lives entirely in `exec` (customer-owned, runs on your runner). Provider protocol
- * mechanics (handshake, signature verification) live in `ingressChallenge` / `ingressValidation`,
- * which run synchronously at ingress with no SDK access.
- *
- * @example
- * ```ts
- * export default createWebhook({
- *     name: 'contacts-updated',
- *     debounce: { key: { body: '$.portalId' }, windowMs: 5000 },
- *     exec: async (nango, event) => {
- *         const connections = await nango.searchConnections({ tags: { portalId: event.payload.portalId } });
- *         for (const connection of connections) {
- *             await nango.triggerSync(connection.provider_config_key, connection.connection_id, 'contacts');
- *         }
- *     }
- * });
- * ```
- */
-export function createWebhook(params) {
-    const { name, scope, ingressChallenge, ingressValidation, debounce, ...rest } = params;
-    const trigger = {
-        type: 'http',
-        ...(name !== undefined ? { name } : {}),
-        ...(scope !== undefined ? { scope } : {}),
-        ...(ingressChallenge !== undefined ? { ingressChallenge } : {}),
-        ...(ingressValidation !== undefined ? { ingressValidation } : {}),
-        ...(debounce !== undefined ? { debounce } : {})
-    };
-    return {
-        type: 'function',
-        ...rest,
-        ...(name !== undefined ? { name } : {}),
-        triggers: [trigger]
-    };
-}
 //# sourceMappingURL=scripts.js.map

package/dist/scripts.js.map

@@ -1 +1 @@
-{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../lib/scripts.ts"],"names":[],"mappings":"AAmLA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,UAAU,CACtB,MAAwD;IAExD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;AACvC,CAAC;AAgID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,YAAY,CAK1B,MAAkE;IAChE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;AACzC,CAAC;AAoED;;GAEG;AACH,MAAM,UAAU,aAAa,CACzB,MAAkD;IAElD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAAC;AAC1C,CAAC;AAwLD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,cAAc,CAS5B,MAA6E;IAC3E,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAAC;AAC3C,CAAC;AAsBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa,CAI3B,MAA2D;IACzD,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;IACvF,MAAM,OAAO,GAAgB;QACzB,IAAI,EAAE,MAAM;QACZ,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;IACF,OAAO;QACH,IAAI,EAAE,UAAU;QAChB,GAAG,IAAI;QACP,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,QAAQ,EAAE,CAAC,OAAO,CAAC;KACtB,CAAC;AACN,CAAC"}
+{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../lib/scripts.ts"],"names":[],"mappings":"AAkLA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,UAAU,CACtB,MAAwD;IAExD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;AACvC,CAAC;AAgID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,YAAY,CAK1B,MAAkE;IAChE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;AACzC,CAAC;AAoED;;GAEG;AACH,MAAM,UAAU,aAAa,CACzB,MAAkD;IAElD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAAC;AAC1C,CAAC"}