From b3083083168b79fdf350d016bde560ff2a115a9e Mon Sep 17 00:00:00 2001 From: isshaddad Date: Fri, 13 Feb 2026 15:16:26 -0500 Subject: [PATCH 1/2] docs: document skipColumns for realtime hooks to reduce payload size --- docs/realtime/react-hooks/subscribe.mdx | 26 +++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs/realtime/react-hooks/subscribe.mdx b/docs/realtime/react-hooks/subscribe.mdx index 4cf0a79da3..41ef2b61f8 100644 --- a/docs/realtime/react-hooks/subscribe.mdx +++ b/docs/realtime/react-hooks/subscribe.mdx @@ -93,6 +93,32 @@ export function MyComponent({ } ``` +When you only need run status (for example, a progress bar or completion badge), you can omit large fields like `payload` and `output` by passing `skipColumns`. This reduces the data sent over the wire and avoids issues such as "Large HTTP Payload" warnings in tools like Sentry. + +```tsx +import { useRealtimeRun } from "@trigger.dev/react-hooks"; + +export function RunStatusBadge({ + runId, + publicAccessToken, +}: { + runId: string; + publicAccessToken: string; +}) { + const { run, error } = useRealtimeRun(runId, { + accessToken: publicAccessToken, + skipColumns: ["payload", "output"], + }); + + if (error) return Error; + if (!run) return Loading…; + + return Status: {run.status}; +} +``` + +You can skip any of: `payload`, `output`, `metadata`, `startedAt`, `delayUntil`, `queuedAt`, `expiredAt`, `completedAt`, `number`, `isTest`, `usageDurationMs`, `costInCents`, `baseCostInCents`, `ttl`, `payloadType`, `outputType`, `runTags`, `error`. The `useRealtimeRunsWithTag` hook also accepts a `skipColumns` option in the same way. + See our [run object reference](/realtime/run-object) for the complete schema and [How it Works documentation](/realtime/how-it-works) for more technical details. ### useRealtimeRunsWithTag From 5ef9957b5fdea6e80df683d64592e2f18665c5fa Mon Sep 17 00:00:00 2001 From: isshaddad Date: Fri, 13 Feb 2026 15:16:46 -0500 Subject: [PATCH 2/2] docs: add troubleshooting for Bun source-map indexing error --- docs/troubleshooting.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/troubleshooting.mdx b/docs/troubleshooting.mdx index 13d9216f86..bd612110e0 100644 --- a/docs/troubleshooting.mdx +++ b/docs/troubleshooting.mdx @@ -97,6 +97,10 @@ export default defineConfig({ If you see this error, add pino (and any other associated packages) to your `external` build settings in your `trigger.config.ts` file. Learn more about the `external` setting in the [config docs](/config/config-file#external). +### `Failed to index deployment` with `Column must be greater than or equal to 0, got -1` + +This can occur when using `runtime: "bun"` during the indexing phase (we load and execute your task files to discover exports). A short-term workaround is to [pnpm patch](https://pnpm.io/cli/patch) the `source-map` package. See [this GitHub issue](https://github.com/triggerdotdev/trigger.dev/issues/3045) for the patch details. + ### `reactDOMServer.renderToPipeableStream is not a function` when using react-email If you see this error when using `@react-email/render`: