@trigger.dev/sdk 2.2.3 → 2.2.5

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import * as _trigger_dev_core from '@trigger.dev/core';
-import { RunTaskBodyInput, CompleteTaskBodyInput, FailTaskBodyInput, SendEvent, SendEventOptions, StatusUpdate, UpdateTriggerSourceBodyV2, TriggerSource, RegisterTriggerBodyV2, RegisterSourceEventV2, ScheduleMetadata, GetRunOptionsWithTaskDetails, GetRunsOptions, LogLevel, RuntimeEnvironmentType, DisplayProperty, TriggerMetadata, EventFilter, Prettify, HandleTriggerSource, Logger, RegisterTriggerSource, SerializableJson, ConnectionAuth, NormalizedResponse, HttpSourceResponseMetadata, IntervalOptions, CronOptions, ScheduledPayload, DeserializedJson, ServerTask, CachedTask, InitialStatusUpdate, FetchRequestInit, FetchRetryOptions, RunTaskOptions, IntegrationMetadata, QueueOptions, IntegrationConfig, JobMetadata, MissingConnectionNotificationPayload, MissingConnectionResolvedNotificationPayload, ErrorWithStack, ApiEventLog, RedactString } from '@trigger.dev/core';
+import { RunTaskBodyInput, CompleteTaskBodyV2Input, FailTaskBodyInput, SendEvent, SendEventOptions, StatusUpdate, UpdateTriggerSourceBodyV2, TriggerSource, RegisterTriggerBodyV2, RegisterSourceEventV2, ScheduleMetadata, GetRunOptionsWithTaskDetails, GetRunsOptions, InvokeOptions, LogLevel, RuntimeEnvironmentType, DisplayProperty, TriggerMetadata, EventFilter, HttpEndpointMetadata, RequestFilter, Prettify, HandleTriggerSource, Logger, RegisterTriggerSource, SerializableJson, ConnectionAuth, NormalizedResponse, HttpSourceResponseMetadata, IntervalOptions, CronOptions, ScheduledPayload, DeserializedJson, ServerTask, CachedTask, InitialStatusUpdate, FetchRequestInit, FetchRetryOptions, FetchTimeoutOptions, RunTaskOptions, IntegrationMetadata, QueueOptions, IntegrationConfig, JobMetadata, RunNotification, MissingConnectionNotificationPayload, MissingConnectionResolvedNotificationPayload, ErrorWithStack, ApiEventLog, RedactString } from '@trigger.dev/core';
 export { ConnectionAuth, DisplayProperty, EventFilter, Logger, NormalizedRequest, OverridableRunTaskOptions, Prettify, RedactString, RegisteredOptionsDiff, RunTaskOptions, SourceEventOption } from '@trigger.dev/core';
 import * as zod from 'zod';
-import { z } from 'zod';
+import { z, ZodType, TypeOf } from 'zod';
 
 type ApiClientOptions = {
     apiKey?: string;
@@ -77,6 +77,7 @@ declare class ApiClient {
                 }>>>;
                 operation: z.ZodNullable<z.ZodOptional<z.ZodString>>;
                 callbackUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                childExecutionMode: z.ZodNullable<z.ZodOptional<z.ZodEnum<["SEQUENTIAL", "PARALLEL"]>>>;
                 idempotencyKey: z.ZodString;
                 attempts: z.ZodNumber;
                 forceYield: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
@@ -112,6 +113,7 @@ declare class ApiClient {
                 } | null | undefined;
                 operation?: string | null | undefined;
                 callbackUrl?: string | null | undefined;
+                childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
                 forceYield?: boolean | null | undefined;
             }, {
                 id: string;
@@ -145,6 +147,7 @@ declare class ApiClient {
                 } | null | undefined;
                 operation?: string | null | undefined;
                 callbackUrl?: string | null | undefined;
+                childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
                 forceYield?: boolean | null | undefined;
             }>;
             cachedTasks: z.ZodOptional<z.ZodObject<{
@@ -225,6 +228,7 @@ declare class ApiClient {
                 } | null | undefined;
                 operation?: string | null | undefined;
                 callbackUrl?: string | null | undefined;
+                childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
                 forceYield?: boolean | null | undefined;
             };
             cachedTasks?: {
@@ -271,6 +275,7 @@ declare class ApiClient {
                 } | null | undefined;
                 operation?: string | null | undefined;
                 callbackUrl?: string | null | undefined;
+                childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
                 forceYield?: boolean | null | undefined;
             };
             cachedTasks?: {
@@ -337,6 +342,7 @@ declare class ApiClient {
         }>>>;
         operation: z.ZodNullable<z.ZodOptional<z.ZodString>>;
         callbackUrl: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        childExecutionMode: z.ZodNullable<z.ZodOptional<z.ZodEnum<["SEQUENTIAL", "PARALLEL"]>>>;
         idempotencyKey: z.ZodString;
         attempts: z.ZodNumber;
         forceYield: z.ZodNullable<z.ZodOptional<z.ZodBoolean>>;
@@ -372,6 +378,7 @@ declare class ApiClient {
         } | null | undefined;
         operation?: string | null | undefined;
         callbackUrl?: string | null | undefined;
+        childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
         forceYield?: boolean | null | undefined;
     }, {
         id: string;
@@ -405,9 +412,10 @@ declare class ApiClient {
         } | null | undefined;
         operation?: string | null | undefined;
         callbackUrl?: string | null | undefined;
+        childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
         forceYield?: boolean | null | undefined;
     }>>>;
-    completeTask(runId: string, id: string, task: CompleteTaskBodyInput): Promise<{
+    completeTask(runId: string, id: string, task: CompleteTaskBodyV2Input): Promise<{
         id: string;
         name: string;
         noop: boolean;
@@ -439,6 +447,7 @@ declare class ApiClient {
         } | null | undefined;
         operation?: string | null | undefined;
         callbackUrl?: string | null | undefined;
+        childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
         forceYield?: boolean | null | undefined;
     }>;
     failTask(runId: string, id: string, body: FailTaskBodyInput): Promise<{
@@ -473,6 +482,7 @@ declare class ApiClient {
         } | null | undefined;
         operation?: string | null | undefined;
         callbackUrl?: string | null | undefined;
+        childExecutionMode?: "SEQUENTIAL" | "PARALLEL" | null | undefined;
         forceYield?: boolean | null | undefined;
     }>;
     sendEvent(event: SendEvent, options?: SendEventOptions): Promise<{
@@ -519,7 +529,7 @@ declare class ApiClient {
         state?: "loading" | "success" | "failure" | undefined;
     }>;
     updateSource(client: string, key: string, source: UpdateTriggerSourceBodyV2): Promise<TriggerSource>;
-    registerTrigger(client: string, id: string, key: string, payload: RegisterTriggerBodyV2): Promise<RegisterSourceEventV2>;
+    registerTrigger(client: string, id: string, key: string, payload: RegisterTriggerBodyV2, idempotencyKey?: string): Promise<RegisterSourceEventV2>;
     registerSchedule(client: string, id: string, key: string, payload: ScheduleMetadata): Promise<{
         id: string;
         schedule: {
@@ -631,6 +641,9 @@ declare class ApiClient {
         }[];
         nextCursor?: string | undefined;
     }>;
+    invokeJob(jobId: string, payload: any, options?: InvokeOptions): Promise<{
+        id: string;
+    }>;
 }
 type VersionedResponseBodyMap = {
     [key: string]: z.ZodTypeAny;
@@ -645,6 +658,23 @@ type VersionedResponseBody<TVersions extends VersionedResponseBodyMap, TUnversio
     body: z.infer<TUnversioned>;
 };
 
+declare class TriggerStatus {
+    private id;
+    private io;
+    constructor(id: string, io: IO);
+    update(key: IntegrationTaskKey, status: StatusUpdate): Promise<{
+        label: string;
+        key: string;
+        history: {
+            label?: string | undefined;
+            state?: "loading" | "success" | "failure" | undefined;
+            data?: Record<string, _trigger_dev_core.SerializableJson> | undefined;
+        }[];
+        data?: Record<string, _trigger_dev_core.SerializableJson> | undefined;
+        state?: "loading" | "success" | "failure" | undefined;
+    }>;
+}
+
 interface TriggerContext {
     /** Job metadata */
     job: {
@@ -663,6 +693,12 @@ interface TriggerContext {
         id: string;
         title: string;
     };
+    /** Project metadata */
+    project: {
+        slug: string;
+        id: string;
+        name: string;
+    };
     /** Run metadata */
     run: {
         id: string;
@@ -729,20 +765,39 @@ type PreprocessResults = {
     properties: DisplayProperty[];
 };
 type TriggerEventType<TTrigger extends Trigger<any>> = TTrigger extends Trigger<infer TEventSpec> ? ReturnType<TEventSpec["parsePayload"]> : never;
+type TriggerInvokeType<TTrigger extends Trigger<any>> = TTrigger extends Trigger<infer TEventSpec> ? TEventSpec["parseInvokePayload"] extends (payload: unknown) => infer TInvoke ? TInvoke : any : never;
+type VerifyResult = {
+    success: true;
+} | {
+    success: false;
+    reason?: string;
+};
 interface Trigger<TEventSpec extends EventSpecification<any>> {
     event: TEventSpec;
     toJSON(): TriggerMetadata;
     attachToJob(triggerClient: TriggerClient, job: Job<Trigger<TEventSpec>, any>): void;
     preprocessRuns: boolean;
+    verifyPayload: (payload: ReturnType<TEventSpec["parsePayload"]>) => Promise<VerifyResult>;
 }
 type TriggerPayload<TTrigger> = TTrigger extends Trigger<EventSpecification<infer TEvent>> ? TEvent : never;
-type EventSpecificationExample = {
+declare const EventSpecificationExampleSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    payload: z.ZodAny;
+}, "strip", z.ZodTypeAny, {
     id: string;
     name: string;
-    icon?: string;
-    payload: any;
-};
-interface EventSpecification<TEvent extends any> {
+    icon?: string | undefined;
+    payload?: any;
+}, {
+    id: string;
+    name: string;
+    icon?: string | undefined;
+    payload?: any;
+}>;
+type EventSpecificationExample = z.infer<typeof EventSpecificationExampleSchema>;
+interface EventSpecification<TEvent extends any, TInvoke extends any = TEvent> {
     name: string | string[];
     title: string;
     source: string;
@@ -752,6 +807,7 @@ interface EventSpecification<TEvent extends any> {
     examples?: Array<EventSpecificationExample>;
     filter?: EventFilter;
     parsePayload: (payload: unknown) => TEvent;
+    parseInvokePayload?: (payload: unknown) => TInvoke;
     runProperties?: (payload: TEvent) => DisplayProperty[];
 }
 type EventTypeFromSpecification<TEventSpec extends EventSpecification<any>> = TEventSpec extends EventSpecification<infer TEvent> ? TEvent : never;
@@ -772,6 +828,88 @@ type SchemaParser<T extends unknown = unknown> = {
     safeParse: (a: unknown) => SchemaParserResult<T>;
 };
 
+type HttpEndpointOptions<TEventSpecification extends EventSpecification<any>> = {
+    id: string;
+    enabled?: boolean;
+    event: TEventSpecification;
+    respondWith?: RespondWith;
+    verify: VerifyCallback;
+};
+type RequestOptions = {
+    filter?: RequestFilter;
+};
+declare class HttpEndpoint<TEventSpecification extends EventSpecification<any>> {
+    private readonly options;
+    constructor(options: HttpEndpointOptions<TEventSpecification>);
+    get id(): string;
+    onRequest(options?: RequestOptions): HttpTrigger<EventSpecification<Request>>;
+    toJSON(): HttpEndpointMetadata;
+}
+type TriggerOptions$1<TEventSpecification extends EventSpecification<any>> = {
+    endpointId: string;
+    event: TEventSpecification;
+    filter?: EventFilter;
+    verify: VerifyCallback;
+};
+declare class HttpTrigger<TEventSpecification extends EventSpecification<any>> implements Trigger<TEventSpecification> {
+    private readonly options;
+    constructor(options: TriggerOptions$1<TEventSpecification>);
+    toJSON(): TriggerMetadata;
+    get event(): TEventSpecification;
+    attachToJob(triggerClient: TriggerClient, job: Job<Trigger<TEventSpecification>, any>): void;
+    get preprocessRuns(): boolean;
+    verifyPayload(payload: Request): Promise<VerifyResult>;
+}
+type RespondWith = {
+    /** Only Requests that match this filter will cause the `handler` function to run.
+     * For example, you can use this to only respond to `GET` Requests. */
+    filter?: RequestFilter;
+    /** If you set this to `true`, the Request that comes in won't go on to Trigger any Runs.
+     * This is useful if you want to Respond to the Request, but don't want to Trigger any Runs. */
+    skipTriggeringRuns?: boolean;
+    /** This is a function that's called when a Request comes in.
+     * It's passed the Request object, and expects you to return a Response object. */
+    handler: (request: Request, verify: () => Promise<VerifyResult>) => Promise<Response>;
+};
+type VerifyCallback = (request: Request) => Promise<VerifyResult>;
+type EndpointOptions = {
+    /** Used to uniquely identify the HTTP Endpoint inside your Project. */
+    id: string;
+    enabled?: boolean;
+    /** Usually you would use the domain name of the service, e.g. `cal.com`. */
+    source: string;
+    /** An optional title, displayed in the dashboard. */
+    title?: string;
+    /** An optional icon name that's displayed in the dashboard.
+     * Lots of company names are supported, e.g. `github`, `twilio`.
+     * You can also reference the name of any [Tabler icon](https://tabler-icons.io/), e.g. `brand-google-maps`, `brand-twitch`. */
+    icon?: string;
+    /** Used to provide example payloads that are accepted by the job.
+     * This will be available in the dashboard and can be used to trigger test runs. */
+    examples?: EventSpecificationExample[];
+    /** Properties that are displayed in the dashboard. */
+    properties?: DisplayProperty[];
+    /** This optional object allows you to immediately Respond to a Request. This is useful for some APIs where they do a `GET` Request when the webhook is first setup and expect a specific Response.
+  
+        Only use this if you really need to Respond to the Request that comes in. Most of the time you don't. */
+    respondWith?: RespondWith;
+    /** This is compulsory, and is used to verify that the received webhook is authentic.
+     * It's a function that expects you to return a result object like:
+      
+    In 90% of cases, you'll want to use the `verifyRequestSignature` helper function we provide.
+  
+      @example
+      ```ts
+      //if it's valid
+      return { success: true }
+      //if it's invalid, reason is optional
+      return { success: false, reason: "No header" }
+      ```
+  
+     */
+    verify: VerifyCallback;
+};
+
 type HttpSourceEvent = {
     url: string;
     method: string;
@@ -876,6 +1014,7 @@ declare class ExternalSource<TIntegration extends TriggerIntegration, TParams ex
             id?: string | undefined;
             timestamp?: Date | undefined;
             source?: string | undefined;
+            payloadType?: "JSON" | "REQUEST" | undefined;
         }[];
         response?: {
             status: number;
@@ -914,6 +1053,9 @@ declare class ExternalSourceTrigger<TEventSpecification extends EventSpecificati
     toJSON(): TriggerMetadata;
     attachToJob(triggerClient: TriggerClient, job: Job<Trigger<TEventSpecification>, any>): void;
     get preprocessRuns(): boolean;
+    verifyPayload(payload: ReturnType<TEventSpecification["parsePayload"]>): Promise<{
+        success: true;
+    }>;
 }
 declare function omit<T extends Record<string, unknown>, K extends keyof T>(obj: T, key: K): {
     result: Omit<T, K>;
@@ -966,6 +1108,9 @@ declare class DynamicTrigger<TEventSpec extends EventSpecification<any>, TExtern
     }): Promise<RegisterSourceEventV2>;
     attachToJob(triggerClient: TriggerClient, job: Job<Trigger<TEventSpec>, any>): void;
     get preprocessRuns(): boolean;
+    verifyPayload(payload: ReturnType<TEventSpec["parsePayload"]>): Promise<{
+        success: true;
+    }>;
 }
 
 type ScheduledEventSpecification = EventSpecification<ScheduledPayload>;
@@ -997,6 +1142,9 @@ declare class IntervalTrigger implements Trigger<ScheduledEventSpecification> {
     };
     attachToJob(triggerClient: TriggerClient, job: Job<Trigger<ScheduledEventSpecification>, any>): void;
     get preprocessRuns(): boolean;
+    verifyPayload(payload: ReturnType<ScheduledEventSpecification["parsePayload"]>): Promise<{
+        success: true;
+    }>;
     toJSON(): TriggerMetadata;
 }
 /** `intervalTrigger()` is set as a [Job's trigger](/sdk/job) to trigger a Job at a recurring interval.
@@ -1031,6 +1179,9 @@ declare class CronTrigger implements Trigger<ScheduledEventSpecification> {
     };
     attachToJob(triggerClient: TriggerClient, job: Job<Trigger<ScheduledEventSpecification>, any>): void;
     get preprocessRuns(): boolean;
+    verifyPayload(payload: ReturnType<ScheduledEventSpecification["parsePayload"]>): Promise<{
+        success: true;
+    }>;
     toJSON(): TriggerMetadata;
 }
 /** `cronTrigger()` is set as a [Job's trigger](https://trigger.dev/docs/sdk/job) to trigger a Job on a recurring schedule using a CRON expression.
@@ -1097,6 +1248,9 @@ declare class DynamicSchedule implements Trigger<ScheduledEventSpecification> {
     }>;
     attachToJob(triggerClient: TriggerClient, job: Job<Trigger<ScheduledEventSpecification>, any>): void;
     get preprocessRuns(): boolean;
+    verifyPayload(payload: ReturnType<ScheduledEventSpecification["parsePayload"]>): Promise<{
+        success: true;
+    }>;
     toJSON(): TriggerMetadata;
 }
 
@@ -1131,10 +1285,17 @@ declare class TriggerClient {
     id: string;
     constructor(options: Prettify<TriggerClientOptions>);
     handleRequest(request: Request, timeOrigin?: number): Promise<NormalizedResponse>;
-    defineJob<TTrigger extends Trigger<EventSpecification<any>>, TIntegrations extends Record<string, TriggerIntegration> = {}>(options: JobOptions<TTrigger, TIntegrations>): Job<TTrigger, TIntegrations>;
+    defineJob<TTrigger extends Trigger<EventSpecification<any>>, TIntegrations extends Record<string, TriggerIntegration> = {}, TOutput extends any = any>(options: JobOptions<TTrigger, TIntegrations, TOutput>): Job<TTrigger, TIntegrations, TOutput>;
     defineAuthResolver(integration: TriggerIntegration, resolver: TriggerAuthResolver): TriggerClient;
     defineDynamicSchedule(options: DynamicIntervalOptions): DynamicSchedule;
     defineDynamicTrigger<TEventSpec extends EventSpecification<any>, TExternalSource extends ExternalSource<any, any, any>>(options: DynamicTriggerOptions<TEventSpec, TExternalSource>): DynamicTrigger<TEventSpec, TExternalSource>;
+    /**
+     * An [HTTP endpoint](https://trigger.dev/docs/documentation/concepts/http-endpoints) allows you to create a [HTTP Trigger](https://trigger.dev/docs/documentation/concepts/triggers/http), which means you can trigger your Jobs from any webhooks.
+     * @param options The Endpoint options
+     * @returns An HTTP Endpoint, that can be used to create an HTTP Trigger.
+     * @link https://trigger.dev/docs/documentation/concepts/http-endpoints
+     */
+    defineHttpEndpoint(options: EndpointOptions): HttpEndpoint<EventSpecification<Request, Request>>;
     attach(job: Job<Trigger<any>, any>): void;
     attachDynamicTrigger(trigger: DynamicTrigger<any, any>): void;
     attachJobToDynamicTrigger(job: Job<Trigger<any>, any>, trigger: DynamicTrigger<any, any>): void;
@@ -1147,7 +1308,7 @@ declare class TriggerClient {
     }): void;
     attachDynamicSchedule(key: string): void;
     attachDynamicScheduleToJob(key: string, job: Job<Trigger<any>, any>): void;
-    registerTrigger(id: string, key: string, options: RegisterTriggerBodyV2): Promise<{
+    registerTrigger(id: string, key: string, options: RegisterTriggerBodyV2, idempotencyKey?: string): Promise<{
         id: string;
         options: {
             event: {
@@ -1337,27 +1498,13 @@ declare class TriggerClient {
             output?: any;
         };
     }>;
+    invokeJob(jobId: string, payload: any, options?: InvokeOptions): Promise<{
+        id: string;
+    }>;
     authorized(apiKey?: string | null): "authorized" | "unauthorized" | "missing-client" | "missing-header";
     apiKey(): string | undefined;
 }
 
-declare class TriggerStatus {
-    private id;
-    private io;
-    constructor(id: string, io: IO);
-    update(key: IntegrationTaskKey, status: StatusUpdate): Promise<{
-        label: string;
-        key: string;
-        history: {
-            label?: string | undefined;
-            state?: "loading" | "success" | "failure" | undefined;
-            data?: Record<string, _trigger_dev_core.SerializableJson> | undefined;
-        }[];
-        data?: Record<string, _trigger_dev_core.SerializableJson> | undefined;
-        state?: "loading" | "success" | "failure" | undefined;
-    }>;
-}
-
 type IOTask = ServerTask;
 type IOOptions = {
     id: string;
@@ -1397,6 +1544,14 @@ type IOStats = {
     noopCachedTaskHits: number;
     noopCachedTaskMisses: number;
 };
+interface OutputSerializer {
+    serialize(value: any): string;
+    deserialize<T>(value: string): T;
+}
+declare class JSONOutputSerializer implements OutputSerializer {
+    serialize(value: any): string;
+    deserialize(value?: string): any;
+}
 declare class IO {
     #private;
     private _id;
@@ -1415,15 +1570,50 @@ declare class IO {
     private _serverVersion;
     private _timeOrigin;
     private _executionTimeout?;
+    private _outputSerializer;
+    private _visitedCacheKeys;
     get stats(): IOStats;
     constructor(options: IOOptions);
     /** Used to send log messages to the [Run log](https://trigger.dev/docs/documentation/guides/viewing-runs). */
     get logger(): IOLogger;
+    /** `io.random()` is identical to `Math.random()` when called without options but ensures your random numbers are not regenerated on resume or retry. It will return a pseudo-random floating-point number between optional `min` (default: 0, inclusive) and `max` (default: 1, exclusive). Can optionally `round` to the nearest integer.
+     * @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
+     * @param min Sets the lower bound (inclusive). Can't be higher than `max`.
+     * @param max Sets the upper bound (exclusive). Can't be lower than `min`.
+     * @param round Controls rounding to the nearest integer. Any `max` integer will become inclusive when enabled. Rounding with floating-point bounds may cause unexpected skew and boundary inclusivity.
+     */
+    random(cacheKey: string | any[], { min, max, round, }?: {
+        min?: number;
+        max?: number;
+        round?: boolean;
+    }): Promise<number>;
     /** `io.wait()` waits for the specified amount of time before continuing the Job. Delays work even if you're on a serverless platform with timeouts, or if your server goes down. They utilize [resumability](https://trigger.dev/docs/documentation/concepts/resumability) to ensure that the Run can be resumed after the delay.
      * @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
      * @param seconds The number of seconds to wait. This can be very long, serverless timeouts are not an issue.
      */
     wait(cacheKey: string | any[], seconds: number): Promise<void>;
+    /** `io.waitForRequest()` allows you to pause the execution of a run until the url provided in the callback is POSTed to.
+     *  This is useful for integrating with external services that require a callback URL to be provided, or if you want to be able to wait until an action is performed somewhere else in your system.
+     *  @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
+     *  @param callback A callback function that will provide the unique URL to POST to.
+     *  @param options Options for the callback.
+     *  @param options.timeoutInSeconds How long to wait for the request to be POSTed to the callback URL before timing out. Defaults to 1hr.
+     *  @returns The POSTed request JSON body.
+     *  @example
+     * ```ts
+      const result = await io.waitForRequest<{ message: string }>(
+        "wait-for-request",
+        async (url, task) => {
+          // Save the URL somewhere so you can POST to it later
+          // Or send it to an external service that will POST to it
+        },
+        { timeoutInSeconds: 60 } // wait 60 seconds
+      );
+      * ```
+     */
+    waitForRequest<T extends Json<T> | unknown = unknown>(cacheKey: string | any[], callback: (url: string) => Promise<unknown>, options?: {
+        timeoutInSeconds?: number;
+    }): Promise<T>;
     /** `io.createStatus()` allows you to set a status with associated data during the Run. Statuses can be used by your UI using the react package
      * @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
      * @param initialStatus The initial status you want this status to have. You can update it during the rub using the returned object.
@@ -1468,7 +1658,7 @@ declare class IO {
      * - Ranges: 500-599
      * - Wildcards: 2xx, 3xx, 4xx, 5xx
      */
-    backgroundFetch<TResponseData>(cacheKey: string | any[], url: string, requestInit?: FetchRequestInit, retry?: FetchRetryOptions): Promise<TResponseData>;
+    backgroundFetch<TResponseData>(cacheKey: string | any[], url: string, requestInit?: FetchRequestInit, retry?: FetchRetryOptions, timeout?: FetchTimeoutOptions): Promise<TResponseData>;
     /** `io.sendEvent()` allows you to send an event from inside a Job run. The sent even will trigger any Jobs that are listening for that event (based on the name).
      * @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
      * @param event The event to send. The event name must match the name of the event that your Jobs are listening for.
@@ -1610,6 +1800,7 @@ declare class IO {
         key: string;
     } | undefined>;
     getAuth(cacheKey: string | any[], clientId?: string): Promise<ConnectionAuth | undefined>;
+    parallel<T extends Json<T> | void, TItem>(cacheKey: string | any[], items: Array<TItem>, callback: (item: TItem, index: number) => Promise<T>, options?: Pick<RunTaskOptions, "name" | "properties">): Promise<Array<T>>;
     /** `io.runTask()` allows you to run a [Task](https://trigger.dev/docs/documentation/concepts/tasks) from inside a Job run. A Task is a resumable unit of a Run that can be retried, resumed and is logged. [Integrations](https://trigger.dev/docs/integrations) use Tasks internally to perform their actions.
      *
      * @param cacheKey Should be a stable and unique key inside the `run()`. See [resumability](https://trigger.dev/docs/documentation/concepts/resumability) for more information.
@@ -1627,7 +1818,7 @@ declare class IO {
      * `io.brb()` is an alias of `io.yield()`
      */
     brb: (cacheKey: string) => void;
-    /** `io.try()` allows you to run Tasks and catch any errors that are thrown, it's similar to a normal `try/catch` block but works with [io.runTask()](/sdk/io/runtask).
+    /** `io.try()` allows you to run Tasks and catch any errors that are thrown, it's similar to a normal `try/catch` block but works with [io.runTask()](https://trigger.dev/docs/sdk/io/runtask).
      * A regular `try/catch` block on its own won't work as expected with Tasks. Internally `runTask()` throws some special errors to control flow execution. This is necessary to deal with resumability, serverless timeouts, and retrying Tasks.
      * @param tryCallback The code you wish to run
      * @param catchCallback Thhis will be called if the Task fails. The callback receives the error
@@ -1660,7 +1851,7 @@ interface TriggerIntegration {
 type IOWithIntegrations<TIntegrations extends Record<string, TriggerIntegration>> = IO & TIntegrations;
 type IntegrationTaskKey = string | any[];
 
-type JobOptions<TTrigger extends Trigger<EventSpecification<any>>, TIntegrations extends Record<string, TriggerIntegration> = {}> = {
+type JobOptions<TTrigger extends Trigger<EventSpecification<any>>, TIntegrations extends Record<string, TriggerIntegration> = {}, TOutput extends any = any> = {
     /** The `id` property is used to uniquely identify the Job. Only change this if you want to create a new Job. */
     id: string;
     /** The `name` of the Job that you want to appear in the dashboard and logs. You can change this without creating a new Job. */
@@ -1706,19 +1897,19 @@ type JobOptions<TTrigger extends Trigger<EventSpecification<any>>, TIntegrations
      * @param io An object that contains the integrations that you specified in the `integrations` property and other useful functions like delays and running Tasks.
      * @param context An object that contains information about the Organization, Job, Run and more.
      */
-    run: (payload: TriggerEventType<TTrigger>, io: IOWithIntegrations<TIntegrations>, context: TriggerContext) => Promise<any>;
+    run: (payload: TriggerEventType<TTrigger>, io: IOWithIntegrations<TIntegrations>, context: TriggerContext) => Promise<TOutput>;
 };
 type JobPayload<TJob> = TJob extends Job<Trigger<EventSpecification<infer TEvent>>, any> ? TEvent : never;
 type JobIO<TJob> = TJob extends Job<any, infer TIntegrations> ? IOWithIntegrations<TIntegrations> : never;
 /** A [Job](https://trigger.dev/docs/documentation/concepts/jobs) is used to define the [Trigger](https://trigger.dev/docs/documentation/concepts/triggers), metadata, and what happens when it runs. */
-declare class Job<TTrigger extends Trigger<EventSpecification<any>>, TIntegrations extends Record<string, TriggerIntegration> = {}> {
+declare class Job<TTrigger extends Trigger<EventSpecification<any>>, TIntegrations extends Record<string, TriggerIntegration> = {}, TOutput extends any = any> {
     #private;
-    readonly options: JobOptions<TTrigger, TIntegrations>;
+    readonly options: JobOptions<TTrigger, TIntegrations, TOutput>;
     client: TriggerClient;
     constructor(
     /** An instance of [TriggerClient](/sdk/triggerclient) that is used to send events
   to the Trigger API. */
-    client: TriggerClient, options: JobOptions<TTrigger, TIntegrations>);
+    client: TriggerClient, options: JobOptions<TTrigger, TIntegrations, TOutput>);
     get id(): string;
     get enabled(): boolean;
     get name(): string;
@@ -1727,6 +1918,19 @@ declare class Job<TTrigger extends Trigger<EventSpecification<any>>, TIntegratio
     get logLevel(): LogLevel | undefined;
     get integrations(): Record<string, IntegrationConfig>;
     toJSON(): JobMetadata;
+    invoke(cacheKey: string, payload: TriggerInvokeType<TTrigger>, options?: InvokeOptions): Promise<{
+        id: string;
+    }>;
+    invoke(payload: TriggerInvokeType<TTrigger>, options?: InvokeOptions): Promise<{
+        id: string;
+    }>;
+    invokeAndWaitForCompletion(cacheKey: string | string[], payload: TriggerInvokeType<TTrigger>, timeoutInSeconds?: number, // 1 hour
+    options?: Prettify<Pick<InvokeOptions, "accountId" | "context">>): Promise<RunNotification<TOutput>>;
+    batchInvokeAndWaitForCompletion(cacheKey: string | string[], batch: Array<{
+        payload: TriggerInvokeType<TTrigger>;
+        timeoutInSeconds?: number;
+        options?: Prettify<Pick<InvokeOptions, "accountId" | "context">>;
+    }>): Promise<Array<RunNotification<TOutput>>>;
 }
 
 type EventTriggerOptions<TEventSpecification extends EventSpecification<any>> = {
@@ -1742,6 +1946,9 @@ declare class EventTrigger<TEventSpecification extends EventSpecification<any>>
     get event(): TEventSpecification;
     attachToJob(triggerClient: TriggerClient, job: Job<Trigger<TEventSpecification>, any>): void;
     get preprocessRuns(): boolean;
+    verifyPayload(payload: ReturnType<TEventSpecification["parsePayload"]>): Promise<{
+        success: true;
+    }>;
 }
 /** Configuration options for an EventTrigger */
 type TriggerOptions<TEvent> = {
@@ -1828,6 +2035,9 @@ declare class MissingConnectionNotification implements Trigger<MissingConnection
     };
     attachToJob(triggerClient: TriggerClient, job: Job<Trigger<MissingConnectionNotificationSpecification>, any>): void;
     get preprocessRuns(): boolean;
+    verifyPayload(payload: ReturnType<MissingConnectionNotificationSpecification["parsePayload"]>): Promise<{
+        success: true;
+    }>;
     toJSON(): TriggerMetadata;
 }
 type MissingConnectionResolvedNotificationSpecification = EventSpecification<MissingConnectionResolvedNotificationPayload>;
@@ -1877,13 +2087,70 @@ declare class MissingConnectionResolvedNotification implements Trigger<MissingCo
     };
     attachToJob(triggerClient: TriggerClient, job: Job<Trigger<MissingConnectionResolvedNotificationSpecification>, any>): void;
     get preprocessRuns(): boolean;
+    verifyPayload(payload: ReturnType<MissingConnectionResolvedNotificationSpecification["parsePayload"]>): Promise<{
+        success: true;
+    }>;
     toJSON(): TriggerMetadata;
 }
 
+/** Configuration options for an InvokeTrigger */
+type InvokeTriggerOptions<TSchema extends ZodType = z.ZodTypeAny> = {
+    /** A [Zod](https://trigger.dev/docs/documentation/guides/zod) schema that defines the shape of the event payload.
+     * The default is `z.any()` which is `any`.
+     * */
+    schema?: TSchema;
+    examples?: EventSpecificationExample[];
+};
+declare class InvokeTrigger<TSchema extends ZodType = z.ZodTypeAny> implements Trigger<EventSpecification<TypeOf<TSchema>, z.input<TSchema>>> {
+    #private;
+    constructor(options: InvokeTriggerOptions<TSchema>);
+    toJSON(): TriggerMetadata;
+    get event(): {
+        name: string;
+        title: string;
+        source: string;
+        examples: {
+            id: string;
+            name: string;
+            icon?: string | undefined;
+            payload?: any;
+        }[];
+        icon: string;
+        parsePayload: (rawPayload: unknown) => any;
+        parseInvokePayload: (rawPayload: unknown) => any;
+    };
+    attachToJob(triggerClient: TriggerClient, job: Job<Trigger<EventSpecification<ZodType<TSchema>>>, any>): void;
+    get preprocessRuns(): boolean;
+    verifyPayload(): Promise<{
+        success: true;
+    }>;
+}
+declare function invokeTrigger<TSchema extends ZodType = z.ZodTypeAny>(options?: InvokeTriggerOptions<TSchema>): Trigger<EventSpecification<TypeOf<TSchema>, z.input<TSchema>>>;
+
+/** Easily verify webhook payloads when they're using common signing methods. */
+declare function verifyRequestSignature({ request, headerName, secret, algorithm, }: {
+    /** The web request that you want to verify. */
+    request: Request;
+    /** The name of the header that contains the signature. E.g. `X-Cal-Signature-256`. */
+    headerName: string;
+    /** The secret that you use to hash the payload. For HttpEndpoints this will usually originally
+        come from the Trigger.dev dashboard and should be stored in an environment variable. */
+    secret: string;
+    /** The hashing algorithm that was used to create the signature. Currently only `sha256` is
+        supported. */
+    algorithm: "sha256";
+}): Promise<VerifyResult>;
+declare function verifyHmacSha256(headerValue: string, secret: string, body: string): boolean;
+
 declare class ResumeWithTaskError {
     task: ServerTask;
     constructor(task: ServerTask);
 }
+declare class ResumeWithParallelTaskError {
+    task: ServerTask;
+    childErrors: Array<TriggerInternalError>;
+    constructor(task: ServerTask, childErrors: Array<TriggerInternalError>);
+}
 declare class RetryWithTaskError {
     cause: ErrorWithStack;
     task: ServerTask;
@@ -1907,25 +2174,26 @@ declare class AutoYieldExecutionError {
 declare class AutoYieldWithCompletedTaskExecutionError {
     id: string;
     properties: DisplayProperty[] | undefined;
-    output: any;
     data: {
         location: string;
         timeRemaining: number;
         timeElapsed: number;
     };
-    constructor(id: string, properties: DisplayProperty[] | undefined, output: any, data: {
+    output?: string | undefined;
+    constructor(id: string, properties: DisplayProperty[] | undefined, data: {
         location: string;
         timeRemaining: number;
         timeElapsed: number;
-    });
+    }, output?: string | undefined);
 }
+type TriggerInternalError = ResumeWithTaskError | RetryWithTaskError | CanceledWithTaskError | YieldExecutionError | AutoYieldExecutionError | AutoYieldWithCompletedTaskExecutionError | ResumeWithParallelTaskError;
 /** Use this function if you're using a `try/catch` block to catch errors.
  * It checks if a thrown error is a special internal error that you should ignore.
  * If this returns `true` then you must rethrow the error: `throw err;`
  * @param err The error to check
  * @returns `true` if the error is a Trigger Error, `false` otherwise.
  */
-declare function isTriggerError(err: unknown): err is ResumeWithTaskError | RetryWithTaskError | CanceledWithTaskError | YieldExecutionError | AutoYieldExecutionError | AutoYieldWithCompletedTaskExecutionError;
+declare function isTriggerError(err: unknown): err is TriggerInternalError;
 
 declare const retry: {
     readonly standardBackoff: {
@@ -1942,4 +2210,4 @@ type Task = ServerTask;
 type SentEvent = ApiEventLog;
 declare function redactString(strings: TemplateStringsArray, ...interpolations: string[]): RedactString;
 
-export { AuthResolverResult, CronTrigger, DynamicIntervalOptions, DynamicSchedule, DynamicTrigger, DynamicTriggerOptions, EventSpecification, EventSpecificationExample, EventTrigger, EventTypeFromSpecification, ExternalSource, ExternalSourceParams, ExternalSourceTrigger, ExternalSourceTriggerOptions, HandlerEvent, HttpSourceEvent, IO, IOLogger, IOOptions, IOStats, IOTask, IOWithIntegrations, IntegrationTaskKey, IntervalTrigger, Job, JobIO, JobOptions, JobPayload, Json, MissingConnectionNotification, MissingConnectionResolvedNotification, PreprocessResults, RunTaskErrorCallback, SchemaParser, SchemaParserIssue, SchemaParserResult, SentEvent, Task, TaskLogger, Trigger, TriggerAuthResolver, TriggerClient, TriggerClientOptions, TriggerContext, TriggerEventType, TriggerIntegration, TriggerOptionRecord, TriggerPayload, TriggerPreprocessContext, cronTrigger, eventTrigger, intervalTrigger, isTriggerError, missingConnectionNotification, missingConnectionResolvedNotification, omit, redactString, retry };
+export { AuthResolverResult, CronTrigger, DynamicIntervalOptions, DynamicSchedule, DynamicTrigger, DynamicTriggerOptions, EventSpecification, EventSpecificationExample, EventSpecificationExampleSchema, EventTrigger, EventTypeFromSpecification, ExternalSource, ExternalSourceParams, ExternalSourceTrigger, ExternalSourceTriggerOptions, HandlerEvent, HttpSourceEvent, IO, IOLogger, IOOptions, IOStats, IOTask, IOWithIntegrations, IntegrationTaskKey, IntervalTrigger, InvokeTrigger, JSONOutputSerializer, Job, JobIO, JobOptions, JobPayload, Json, MissingConnectionNotification, MissingConnectionResolvedNotification, OutputSerializer, PreprocessResults, RunTaskErrorCallback, SchemaParser, SchemaParserIssue, SchemaParserResult, SentEvent, Task, TaskLogger, Trigger, TriggerAuthResolver, TriggerClient, TriggerClientOptions, TriggerContext, TriggerEventType, TriggerIntegration, TriggerInvokeType, TriggerOptionRecord, TriggerPayload, TriggerPreprocessContext, VerifyResult, cronTrigger, eventTrigger, intervalTrigger, invokeTrigger, isTriggerError, missingConnectionNotification, missingConnectionResolvedNotification, omit, redactString, retry, verifyHmacSha256, verifyRequestSignature };