Wait docs pages

Author: matt-aitken

docs/_snippets/v3/paused-execution-free.mdx

@@ -0,0 +1,4 @@
+<Note>
+  In the Trigger.dev Cloud we automatically pause execution of tasks when they are waiting for
+  longer than a few seconds. You are not charged when execution is paused.
+</Note>

docs/v3/tasks-regular.mdx

@@ -36,7 +36,7 @@ export const emailSequence = task({
     //send the first email immediately
     const firstEmailResult = await retry.onThrow(
       async ({ attempt }) => {
-        const { data, error } = resend.emails.send({
+        const { data, error } = await resend.emails.send({
           from: "[email protected]",
           to: payload.email,
           subject: "Welcome to Trigger.dev",
@@ -59,7 +59,7 @@ export const emailSequence = task({
     //send the second email
     const secondEmailResult = await retry.onThrow(
       async ({ attempt }) => {
-        const { data, error } = resend.emails.send({
+        const { data, error } = await resend.emails.send({
           from: "[email protected]",
           to: payload.email,
           subject: "Some tips for you",

docs/v3/wait-for-event.mdx

@@ -3,4 +3,4 @@ title: "Wait for event"
 description: "Wait until an event has been received, then continue execution."
 ---
 
-<Snippet file="incomplete-docs.mdx" />
+<Snippet file="coming-soon.mdx" />

docs/v3/wait-for-request.mdx

@@ -3,4 +3,4 @@ title: "Wait for request"
 description: "Wait until a `Request` has been received at the provided URL, then continue execution."
 ---
 
-<Snippet file="incomplete-docs.mdx" />
+<Snippet file="coming-soon.mdx" />

docs/v3/wait-for.mdx

@@ -3,4 +3,29 @@ title: "Wait for"
 description: "Wait for a period of time, then continue execution."
 ---
 
-<Snippet file="incomplete-docs.mdx" />
+Inside your tasks you can wait for a period of time before you want execution to continue.
+
+```ts /trigger/long-task.ts
+export const veryLongTask = task({
+  id: "very-long-task",
+  run: async (payload) => {
+    await wait.for({ seconds: 5 });
+
+    await wait.for({ minutes: 10 });
+
+    await wait.for({ hours: 1 });
+
+    await wait.for({ days: 1 });
+
+    await wait.for({ weeks: 1 });
+
+    await wait.for({ months: 1 });
+
+    await wait.for({ years: 1 });
+  },
+});
+```
+
+This allows you to write linear code without having to worry about the complexity of scheduling or managing CRON jobs.
+
+<Snippet file="v3/paused-execution-free.mdx" />

docs/v3/wait-until.mdx

@@ -3,4 +3,36 @@ title: "Wait until"
 description: "Wait until a date, then continue execution."
 ---
 
-<Snippet file="incomplete-docs.mdx" />
+This example sends a reminder email to a user at the specified datetime.
+
+```ts /trigger/reminder-email.ts
+export const sendReminderEmail = task({
+  id: "send-reminder-email",
+  run: async (payload: { to: string; name: string; date: string }) => {
+    //wait until the date
+    await wait.until({ date: new Date(payload.date) });
+
+    //todo send email
+    const { data, error } = await resend.emails.send({
+      from: "[email protected]",
+      to: payload.to,
+      subject: "Don't forget…",
+      html: `<p>Hello ${payload.name},</p><p>...</p>`,
+    });
+  },
+});
+```
+
+This allows you to write linear code without having to worry about the complexity of scheduling or managing CRON jobs.
+
+<Snippet file="v3/paused-execution-free.mdx" />
+
+## `throwIfInThePast`
+
+You can optionally throw an error if the date is already in the past when the function is called:
+
+```ts
+await wait.until({ date: new Date(date), throwIfInThePast: true });
+```
+
+You can of course use try/catch if you want to do something special in this case.

docs/v3/wait.mdx

@@ -6,10 +6,7 @@ description: "During your run you can wait for a period of time or for something
 
 Waiting allows you to write complex tasks as a set of async code, without having to scheduled another task or poll for changes.
 
-<Note>
-  In the cloud product we automatically pause execution of tasks if the wait is longer than a few
-  seconds. You are not charged for the time spent waiting.
-</Note>
+<Snippet file="v3/paused-execution-free.mdx" />
 
 | Function                                  | What it does                                                                              |
 | ----------------------------------------- | ----------------------------------------------------------------------------------------- |