Typedoc on Dagger

Author: joepio

.dagger/src/index.ts

@@ -5,8 +5,12 @@ import {
   object,
   func,
   argument,
+  File,
+  Secret,
 } from "@dagger.io/dagger";
 
+const NODE_IMAGE = "node:24";
+
 @object()
 export class AtomicServer {
   /**
@@ -57,7 +61,7 @@ export class AtomicServer {
     const nodeCache = dag.cacheVolume("node");
     return dag
       .container()
-      .from("node:21-slim")
+      .from(NODE_IMAGE)
       .withDirectory("/src", source)
       .withMountedCache("/root/.npm", nodeCache)
       .withWorkdir("/src")
@@ -99,12 +103,25 @@ export class AtomicServer {
       .stdout();
   }
 
+  @func()
+  typedocPublish(
+    @argument({ defaultPath: "/browser" }) source: Directory,
+    @argument() netlifyAuthToken: Secret
+  ): Promise<string> {
+    const browserDir = this.buildBrowser(source.directory("."));
+    return browserDir
+      .withWorkdir("/app")
+      .withSecretVariable("NETLIFY_AUTH_TOKEN", netlifyAuthToken)
+      .withExec(["pnpm", "run", "typedoc-publish"])
+      .stdout();
+  }
+
   @func()
   private getDeps(source: Directory): Container {
     // Create a container with PNPM installed
     const pnpmContainer = dag
       .container()
-      .from("node:24")
+      .from(NODE_IMAGE)
       .withExec(["npm", "install", "--global", "corepack@latest"])
       .withExec(["corepack", "enable"])
       .withExec(["corepack", "prepare", "pnpm@latest-10", "--activate"])

.gitignore

@@ -1,4 +1,5 @@
 /target
+.envrc
 .env
 trace-*.json
 **/.temp

CONTRIBUTING.md

@@ -67,6 +67,8 @@ The `.dagger` directory and the `dagger.json` file contain most of the configura
 Install the Dagger CLI from [here](https://docs.dagger.io/install/) and run the `dagger` command in the root of the project.
 Then you can run the commands from the `.dagger/src/index.ts` file, e.g. `dagger call build-browser`.
 Add `-i` to the command to run in interactive mode, add `--output` to save the output to a folder.
+You can pass secrets / ENVS to dagger like so:
+`dagger call typedoc-publish --netlify-auth-token="env://NETLIFY_AUTH_TOKEN"`
 Note that the camelCase functions in the `index.ts` file are converted to kebab-case commands in the Dagger API.
 
 Check out the [Dagger docs](https://docs.dagger.io/) for more information.

browser/DOCS.MD browser/typedoc-entry.mdbrowser/DOCS.MD renamed to browser/typedoc-entry.md

@@ -7,7 +7,7 @@
   ],
   "excludeExternals": true,
   "includeVersion": true,
-  "readme": "DOCS.md",
+  "readme": "typedoc-entry.md",
   "name": "@tomic",
   "out": "data-browser/publish/docs"
 }