Updating docs for the move from beta -> latest (with new build system) (#1299)

* Add triggerAndWait().unwrap() to more easily get at the output or throw the subtask error

* Add taskId and runId to SubtaskUnwrapError

* WIP docs update beta -> latest

* trigger.dev init now adds @trigger.dev/build to devDependencies

* How it works doc

* Restructure some docs and update the cli commands

* Config file docs, plus aptGet and ffmpeg extensions

* Update to latest from beta docs

* Add runtime to templates

* Add --runtime option to the init CLI command

* A bunch more doc updates after feedback

* Document triggerAndWait with unwrap and result types

* beta -> latest in the webapp

* CLI update check no longer references beta

* Add major release

* Leave changeset beta, back to normal package release

* Fixed default dirs option in init command

* exclude windows-yarn variation of cli e2e tests because it’s buggy

* Remove cache to try and fix yarn e2e test workflow errors

Author: ericallam

.changeset/cuddly-penguins-cross.md

@@ -0,0 +1,8 @@
+---
+"@trigger.dev/sdk": major
+"trigger.dev": major
+"@trigger.dev/build": major
+"@trigger.dev/core": major
+---
+
+Release 3.0.0

.changeset/itchy-jars-pay.md

@@ -0,0 +1,5 @@
+---
+"@trigger.dev/build": patch
+---
+
+Add ffmpeg build extension

.changeset/ninety-countries-swim.md

@@ -0,0 +1,5 @@
+---
+"trigger.dev": patch
+---
+
+Add --runtime option to the init CLI command

.changeset/old-feet-brush.md

@@ -0,0 +1,5 @@
+---
+"trigger.dev": patch
+---
+
+trigger.dev init now adds @trigger.dev/build to devDependencies

.changeset/pre.json

@@ -1,5 +1,5 @@
 {
-  "mode": "pre",
+  "mode": "exit",
   "tag": "beta",
   "initialVersions": {
     "coordinator": "0.0.1",

.changeset/stale-actors-camp.md

@@ -0,0 +1,5 @@
+---
+"@trigger.dev/sdk": patch
+---
+
+Add triggerAndWait().unwrap() to more easily get at the output or throw the subtask error

.changeset/thick-trains-work.md

@@ -0,0 +1,5 @@
+---
+"@trigger.dev/build": patch
+---
+
+Add aptGet build extension to easily add system packages to install

.github/workflows/e2e.yml

@@ -16,9 +16,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [buildjet-8vcpu-ubuntu-2204, windows-latest]
-        package-manager: ["npm", "pnpm", "yarn"]
-    env:
-      YARN_ENABLE_IMMUTABLE_INSTALLS: false
+        package-manager: ["npm", "pnpm"]
     steps:
       - name: ⬇️ Checkout repo
         uses: actions/checkout@v3
@@ -34,7 +32,6 @@ jobs:
         uses: buildjet/setup-node@v3
         with:
           node-version: 20.11.1
-          cache: "pnpm"
 
       - name: 📥 Download deps
         run: pnpm install --frozen-lockfile --filter trigger.dev...

apps/webapp/app/components/SetupCommands.tsx

@@ -132,7 +132,7 @@ export function TriggerDevStep({ extra }: { extra?: string }) {
 }
 
 // Trigger.dev version 3 setup commands
-const v3PackageTag = "beta";
+const v3PackageTag = "latest";
 
 function getApiUrlArg() {
   const appOrigin = useAppOrigin();

apps/webapp/app/routes/_app.orgs.$organizationSlug.projects.v3.$projectParam.runs.$runParam/route.tsx

@@ -1147,7 +1147,7 @@ function ConnectedDevWarning() {
           <Paragraph variant="small">
             Runs usually start within 1 second in{" "}
             <EnvironmentLabel environment={{ type: "DEVELOPMENT" }} />. Check you're running the
-            CLI: <InlineCode className="whitespace-nowrap">npx trigger.dev@beta dev</InlineCode>
+            CLI: <InlineCode className="whitespace-nowrap">npx trigger.dev@latest dev</InlineCode>
           </Paragraph>
         </div>
       </Callout>

docs/cli-init-commands.mdx

@@ -9,27 +9,32 @@ Run the command like this:
 <CodeGroup>
 
 ```bash npm
-npx trigger.dev@beta init
+npx trigger.dev@latest init
 ```
 
 ```bash pnpm
-pnpm dlx trigger.dev@beta init
+pnpm dlx trigger.dev@latest init
 ```
 
 ```bash yarn
-yarn dlx trigger.dev@beta init
+yarn dlx trigger.dev@latest init
 ```
 
 </CodeGroup>
 
 ## Options
 
+<ParamField body="Javascript" type="--javascript">
+  By default, the init command assumes you are using TypeScript. Use this flag to initialize a
+  project that uses JavaScript.
+</ParamField>
+
 <ParamField body="Project ref" type="--project-ref | -p">
   The project ref to use when initializing the project.
 </ParamField>
 
 <ParamField body="Package tag" type="--tag | -t">
-  The version of the `@trigger.dev/sdk` package to install. Defaults to `3.0.0-beta.56`.
+  The version of the `@trigger.dev/sdk` package to install. Defaults to `latest`.
 </ParamField>
 
 <ParamField body="Skip package install" type="--skip-package-install">
@@ -53,7 +58,8 @@ yarn dlx trigger.dev@beta init
 </ParamField>
 
 <ParamField body="Log level" type="--log-level | -l">
-  The CLI log level to use. Options are `debug`, `info`, `log`, `warn`, `error`, and `none`. This does not affect the log level of your trigger.dev tasks. Defaults to "log".
+  The CLI log level to use. Options are `debug`, `info`, `log`, `warn`, `error`, and `none`. This
+  does not affect the log level of your trigger.dev tasks. Defaults to "log".
 </ParamField>
 
 <ParamField body="Skip telemetry" type="--skip-telemetry">
@@ -64,4 +70,4 @@ yarn dlx trigger.dev@beta init
 
 <ParamField body="Help" type="--help | -h">
   Shows the help information for the command.
-</ParamField>
+</ParamField>

docs/cli-list-profiles-commands.mdx

@@ -9,32 +9,32 @@ Run the command like this:
 <CodeGroup>
 
 ```bash npm
-npx trigger.dev@beta list-profiles
+npx trigger.dev@latest list-profiles
 ```
 
 ```bash pnpm
-pnpm dlx trigger.dev@beta list-profiles
+pnpm dlx trigger.dev@latest list-profiles
 ```
 
 ```bash yarn
-yarn dlx trigger.dev@beta list-profiles
+yarn dlx trigger.dev@latest list-profiles
 ```
 
 </CodeGroup>
 
 ## Options
 
 <ParamField body="Log level" type="--log-level | -l">
-  The CLI log level to use. Options are `debug`, `info`, `log`, `warn`, `error`, and `none`. This does not affect the log level of your trigger.dev tasks. Defaults to `log`.
+  The CLI log level to use. Options are `debug`, `info`, `log`, `warn`, `error`, and `none`. This
+  does not affect the log level of your trigger.dev tasks. Defaults to `log`.
 </ParamField>
 
 <ParamField body="Skip telemetry" type="--skip-telemetry">
   Opt-out of sending telemetry data.
 </ParamField>
 
-
 ## Standard options
 
 <ParamField body="Help" type="--help | -h">
   Shows the help information for the command.
-</ParamField>
+</ParamField>

docs/cli-login-commands.mdx

@@ -9,15 +9,15 @@ Run the command like this:
 <CodeGroup>
 
 ```bash npm
-npx trigger.dev@beta login
+npx trigger.dev@latest login
 ```
 
 ```bash pnpm
-pnpm dlx trigger.dev@beta login
+pnpm dlx trigger.dev@latest login
 ```
 
 ```bash yarn
-yarn dlx trigger.dev@beta login
+yarn dlx trigger.dev@latest login
 ```
 
 </CodeGroup>
@@ -33,7 +33,8 @@ yarn dlx trigger.dev@beta login
 </ParamField>
 
 <ParamField body="Log level" type="-l | --log-level">
-  Sets the CLI log level. Available options are `debug`, `info`, `log`, `warn`, `error`, and `none`. This setting doesn't affect the log level of your trigger.dev tasks. The default is `log`.
+  Sets the CLI log level. Available options are `debug`, `info`, `log`, `warn`, `error`, and `none`.
+  This setting doesn't affect the log level of your trigger.dev tasks. The default is `log`.
 </ParamField>
 
 <ParamField body="Skip telemetry" type="--skip-telemetry">
@@ -48,4 +49,4 @@ yarn dlx trigger.dev@beta login
 
 <ParamField body="Help" type="--help | -h">
   Shows the help information for the command.
-</ParamField>
+</ParamField>

docs/cli-logout-commands.mdx

@@ -9,15 +9,15 @@ Run the command like this:
 <CodeGroup>
 
 ```bash npm
-npx trigger.dev@beta logout
+npx trigger.dev@latest logout
 ```
 
 ```bash pnpm
-pnpm dlx trigger.dev@beta logout
+pnpm dlx trigger.dev@latest logout
 ```
 
 ```bash yarn
-yarn dlx trigger.dev@beta logout
+yarn dlx trigger.dev@latest logout
 ```
 
 </CodeGroup>
@@ -33,16 +33,16 @@ yarn dlx trigger.dev@beta logout
 </ParamField>
 
 <ParamField body="Log level" type="--log-level | -l">
-  The CLI log level to use. Options are `debug`, `info`, `log`, `warn`, `error`, and `none`. This does not affect the log level of your trigger.dev tasks. Defaults to `log`.
+  The CLI log level to use. Options are `debug`, `info`, `log`, `warn`, `error`, and `none`. This
+  does not affect the log level of your trigger.dev tasks. Defaults to `log`.
 </ParamField>
 
 <ParamField body="Skip telemetry" type="--skip-telemetry">
   Opt-out of sending telemetry data.
 </ParamField>
 
-
 ## Standard options
 
 <ParamField body="Help" type="--help | -h">
   Shows the help information for the command.
-</ParamField>
+</ParamField>

docs/cli-update-commands.mdx

@@ -9,32 +9,32 @@ Run the command like this:
 <CodeGroup>
 
 ```bash npm
-npx trigger.dev@beta update
+npx trigger.dev@latest update
 ```
 
 ```bash pnpm
-pnpm dlx trigger.dev@beta update
+pnpm dlx trigger.dev@latest update
 ```
 
 ```bash yarn
-yarn dlx trigger.dev@beta update
+yarn dlx trigger.dev@latest update
 ```
 
 </CodeGroup>
 
 ## Options
 
 <ParamField body="Log level" type="--log-level | -l">
-  The CLI log level to use. Options are `debug`, `info`, `log`, `warn`, `error`, and `none`. This does not affect the log level of your trigger.dev tasks. Defaults to `log`.
+  The CLI log level to use. Options are `debug`, `info`, `log`, `warn`, `error`, and `none`. This
+  does not affect the log level of your trigger.dev tasks. Defaults to `log`.
 </ParamField>
 
 <ParamField body="Skip telemetry" type="--skip-telemetry">
   Opt-out of sending telemetry data.
 </ParamField>
 
-
 ## Standard options
 
 <ParamField body="Help" type="--help | -h">
   Shows the help information for the command.
-</ParamField>
+</ParamField>

docs/cli-whoami-commands.mdx

@@ -9,15 +9,15 @@ Run the command like this:
 <CodeGroup>
 
 ```bash npm
-npx trigger.dev@beta whoami
+npx trigger.dev@latest whoami
 ```
 
 ```bash pnpm
-pnpm dlx trigger.dev@beta whoami
+pnpm dlx trigger.dev@latest whoami
 ```
 
 ```bash yarn
-yarn dlx trigger.dev@beta whoami
+yarn dlx trigger.dev@latest whoami
 ```
 
 </CodeGroup>
@@ -33,16 +33,16 @@ yarn dlx trigger.dev@beta whoami
 </ParamField>
 
 <ParamField body="Log level" type="--log-level | -l">
-  The CLI log level to use. Options are `debug`, `info`, `log`, `warn`, `error`, and `none`. This does not affect the log level of your trigger.dev tasks. Defaults to `log`.
+  The CLI log level to use. Options are `debug`, `info`, `log`, `warn`, `error`, and `none`. This
+  does not affect the log level of your trigger.dev tasks. Defaults to `log`.
 </ParamField>
 
 <ParamField body="Skip telemetry" type="--skip-telemetry">
   Opt-out of sending telemetry data.
 </ParamField>
 
-
 ## Standard options
 
 <ParamField body="Help" type="--help | -h">
   Shows the help information for the command.
-</ParamField>
+</ParamField>