chore: import upstream snapshot with attribution

2026-07-13 13:32:57 +08:00
commit cd420f9332
4811 changed files with 884702 additions and 0 deletions
@@ -0,0 +1,42 @@
+---
+title: "Wait for"
+description: "Wait for a period of time, then continue execution."
+---
+
+import PausedExecutionFree from "/snippets/paused-execution-free.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.
+
+<PausedExecutionFree />
+
+## Wait idempotency
+
+You can pass an idempotency key to any wait function, allowing you to skip waits if the same idempotency key is used again. This can be useful if you want to skip waits when retrying a task, for example:
+
+```ts
+// Specify the idempotency key and TTL when waiting for a duration:
+await wait.for({ seconds: 10, idempotencyKey: "my-idempotency-key", idempotencyKeyTTL: "1h" });
+```