@dagger.io/dagger 0.3.0 → 0.3.1

package/dist/api/client.gen.js

@@ -1,7 +1,3 @@
-/**
- * This file was auto-generated by `cloak clientgen`.
- * Do not make direct changes to the file.
- */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -11,16 +7,25 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+/**
+ * This file was auto-generated by `client-gen`.
+ * Do not make direct changes to the file.
+ */
 import { GraphQLClient } from "graphql-request";
-import { queryBuilder } from "./utils.js";
+import { computeQuery } from "./utils.js";
 class BaseClient {
     /**
      * @hidden
      */
-    constructor({ queryTree, host } = {}) {
+    constructor({ queryTree, host, sessionToken } = {}) {
         this._queryTree = queryTree || [];
         this.clientHost = host || "127.0.0.1:8080";
-        this.client = new GraphQLClient(`http://${host}/query`);
+        this.sessionToken = sessionToken || "";
+        this.client = new GraphQLClient(`http://${host}/query`, {
+            headers: {
+                Authorization: "Basic " + Buffer.from(sessionToken + ":").toString("base64"),
+            },
+        });
     }
     /**
      * @hidden
@@ -30,12 +35,12 @@ class BaseClient {
     }
 }
 /**
- * A directory whose contents persist across runs
+ * A directory whose contents persist across runs.
  */
 export class CacheVolume extends BaseClient {
     id() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "id",
@@ -46,11 +51,15 @@ export class CacheVolume extends BaseClient {
     }
 }
 /**
- * An OCI-compatible container, also known as a docker container
+ * An OCI-compatible container, also known as a docker container.
  */
 export class Container extends BaseClient {
     /**
-     * Initialize this container from a Dockerfile build
+     * Initializes this container from a Dockerfile build, using the context, a dockerfile file path and some additional buildArgs.
+     * @param context Directory context used by the Dockerfile.
+     * @param opts.dockerfile Path to the Dockerfile to use.
+  Defaults to './Dockerfile'.
+     * @param opts.buildArgs Additional build arguments.
      */
     build(context, opts) {
         return new Container({
@@ -62,14 +71,15 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Default arguments for future commands
+     * Retrieves default arguments for future commands.
      */
     defaultArgs() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "defaultArgs",
@@ -79,7 +89,7 @@ export class Container extends BaseClient {
         });
     }
     /**
-     * Retrieve a directory at the given path. Mounts are included.
+     * Retrieves a directory at the given path. Mounts are included.
      */
     directory(path) {
         return new Directory({
@@ -91,14 +101,15 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Entrypoint to be prepended to the arguments of all commands
+     * Retrieves entrypoint to be prepended to the arguments of all commands.
      */
     entrypoint() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "entrypoint",
@@ -108,11 +119,11 @@ export class Container extends BaseClient {
         });
     }
     /**
-     * The value of the specified environment variable
+     * Retrieves the value of the specified environment variable.
      */
     envVariable(name) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "envVariable",
@@ -123,11 +134,11 @@ export class Container extends BaseClient {
         });
     }
     /**
-     * A list of environment variables passed to commands
+     * Retrieves the list of environment variables passed to commands.
      */
     envVariables() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "envVariables",
@@ -137,10 +148,14 @@ export class Container extends BaseClient {
         });
     }
     /**
-     * This container after executing the specified command inside it
-     *
-     * @param opts optional params for exec
-     *
+     * Retrieves this container after executing the specified command inside it.
+     * @param opts.args Command to run instead of the container's default command.
+     * @param opts.stdin Content to write to the command's standard input before closing.
+     * @param opts.redirectStdout Redirect the command's standard output to a file in the container.
+     * @param opts.redirectStderr Redirect the command's standard error to a file in the container.
+     * @param opts.experimentalPrivilegedNesting Provide dagger access to the executed command.
+  Do not use this option unless you trust the command being executed.
+  The command being executed WILL BE GRANTED FULL ACCESS TO YOUR HOST FILESYSTEM.
      * @deprecated Replaced by withExec.
      */
     exec(opts) {
@@ -153,6 +168,7 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
@@ -161,7 +177,7 @@ export class Container extends BaseClient {
      */
     exitCode() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "exitCode",
@@ -171,11 +187,16 @@ export class Container extends BaseClient {
         });
     }
     /**
-     * Write the container as an OCI tarball to the destination file path on the host
+     * Writes the container as an OCI tarball to the destination file path on the host for the specified platformVariants.
+     * Return true on success.
+     * @param path Host's destination path.
+  Path can be relative to the engine's workdir or absolute.
+     * @param opts.platformVariants Identifiers for other platform specific containers.
+  Used for multi-platform image.
      */
     export(path, opts) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "export",
@@ -186,7 +207,7 @@ export class Container extends BaseClient {
         });
     }
     /**
-     * Retrieve a file at the given path. Mounts are included.
+     * Retrieves a file at the given path. Mounts are included.
      */
     file(path) {
         return new File({
@@ -198,10 +219,13 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Initialize this container from the base image published at the given address
+     * Initializes this container from the base image published at the given address.
+     * @param address Image's address from its registry.
+  Formatted as {host}/{user}/{repo}:{tag} (e.g. docker.io/dagger/dagger:main).
      */
     from(address) {
         return new Container({
@@ -213,12 +237,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container's root filesystem. Mounts are not included.
-     *
-     *
+     * Retrieves this container's root filesystem. Mounts are not included.
      * @deprecated Replaced by rootfs.
      */
     fs() {
@@ -230,14 +253,15 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * A unique identifier for this container
+     * A unique identifier for this container.
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "id",
@@ -247,11 +271,11 @@ export class Container extends BaseClient {
         });
     }
     /**
-     * List of paths where a directory is mounted
+     * Retrieves the list of paths where a directory is mounted.
      */
     mounts() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "mounts",
@@ -261,11 +285,11 @@ export class Container extends BaseClient {
         });
     }
     /**
-     * The platform this container executes and publishes as
+     * The platform this container executes and publishes as.
      */
     platform() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "platform",
@@ -275,11 +299,15 @@ export class Container extends BaseClient {
         });
     }
     /**
-     * Publish this container as a new image, returning a fully qualified ref
+     * Publishes this container as a new image to the specified address, for the platformVariants, returning a fully qualified ref.
+     * @param address Registry's address to publish the image to.
+  Formatted as {host}/{user}/{repo}:{tag} (e.g. docker.io/dagger/dagger:main).
+     * @param opts.platformVariants Identifiers for other platform specific containers.
+  Used for multi-platform image.
      */
     publish(address, opts) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "publish",
@@ -290,7 +318,7 @@ export class Container extends BaseClient {
         });
     }
     /**
-     * This container's root filesystem. Mounts are not included.
+     * Retrieves this container's root filesystem. Mounts are not included.
      */
     rootfs() {
         return new Directory({
@@ -301,6 +329,7 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
@@ -309,7 +338,7 @@ export class Container extends BaseClient {
      */
     stderr() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "stderr",
@@ -324,7 +353,7 @@ export class Container extends BaseClient {
      */
     stdout() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "stdout",
@@ -334,11 +363,11 @@ export class Container extends BaseClient {
         });
     }
     /**
-     * The user to be set for all commands
+     * Retrieves the user to be set for all commands.
      */
     user() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "user",
@@ -348,7 +377,7 @@ export class Container extends BaseClient {
         });
     }
     /**
-     * Configures default arguments for future commands
+     * Configures default arguments for future commands.
      */
     withDefaultArgs(opts) {
         return new Container({
@@ -360,10 +389,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a directory written at the given path
+     * Retrieves this container plus a directory written at the given path.
      */
     withDirectory(path, directory, opts) {
         return new Container({
@@ -375,10 +405,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container but with a different command entrypoint
+     * Retrieves this container but with a different command entrypoint.
      */
     withEntrypoint(args) {
         return new Container({
@@ -390,10 +421,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus the given environment variable
+     * Retrieves this container plus the given environment variable.
      */
     withEnvVariable(name, value) {
         return new Container({
@@ -405,10 +437,18 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container after executing the specified command inside it
+     * Retrieves this container after executing the specified command inside it.
+     * @param args Command to run instead of the container's default command.
+     * @param opts.stdin Content to write to the command's standard input before closing.
+     * @param opts.redirectStdout Redirect the command's standard output to a file in the container.
+     * @param opts.redirectStderr Redirect the command's standard error to a file in the container.
+     * @param opts.experimentalPrivilegedNesting Provide dagger access to the executed command.
+  Do not use this option unless you trust the command being executed.
+  The command being executed WILL BE GRANTED FULL ACCESS TO YOUR HOST FILESYSTEM.
      */
     withExec(args, opts) {
         return new Container({
@@ -420,12 +460,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Initialize this container from this DirectoryID
-     *
-     *
+     * Initializes this container from this DirectoryID.
      * @deprecated Replaced by withRootfs.
      */
     withFS(id) {
@@ -438,25 +477,27 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus the contents of the given file copied to the given path
+     * Retrieves this container plus the contents of the given file copied to the given path.
      */
-    withFile(path, source) {
+    withFile(path, source, opts) {
         return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withFile",
-                    args: { path, source },
+                    args: Object.assign({ path, source }, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a cache volume mounted at the given path
+     * Retrieves this container plus a cache volume mounted at the given path.
      */
     withMountedCache(path, cache, opts) {
         return new Container({
@@ -468,10 +509,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a directory mounted at the given path
+     * Retrieves this container plus a directory mounted at the given path.
      */
     withMountedDirectory(path, source) {
         return new Container({
@@ -483,10 +525,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a file mounted at the given path
+     * Retrieves this container plus a file mounted at the given path.
      */
     withMountedFile(path, source) {
         return new Container({
@@ -498,10 +541,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a secret mounted into a file at the given path
+     * Retrieves this container plus a secret mounted into a file at the given path.
      */
     withMountedSecret(path, source) {
         return new Container({
@@ -513,10 +557,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a temporary directory mounted at the given path
+     * Retrieves this container plus a temporary directory mounted at the given path.
      */
     withMountedTemp(path) {
         return new Container({
@@ -528,10 +573,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a new file written at the given path
+     * Retrieves this container plus a new file written at the given path.
      */
     withNewFile(path, opts) {
         return new Container({
@@ -543,10 +589,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Initialize this container from this DirectoryID
+     * Initializes this container from this DirectoryID.
      */
     withRootfs(id) {
         return new Container({
@@ -558,10 +605,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus an env variable containing the given secret
+     * Retrieves this container plus an env variable containing the given secret.
      */
     withSecretVariable(name, secret) {
         return new Container({
@@ -573,10 +621,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container plus a socket forwarded to the given Unix socket path
+     * Retrieves this container plus a socket forwarded to the given Unix socket path.
      */
     withUnixSocket(path, source) {
         return new Container({
@@ -588,10 +637,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container but with a different command user
+     * Retrieves this containers with a different command user.
      */
     withUser(name) {
         return new Container({
@@ -603,10 +653,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container but with a different working directory
+     * Retrieves this container with a different working directory.
      */
     withWorkdir(path) {
         return new Container({
@@ -618,10 +669,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container minus the given environment variable
+     * Retrieves this container minus the given environment variable.
      */
     withoutEnvVariable(name) {
         return new Container({
@@ -633,10 +685,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container after unmounting everything at the given path.
+     * Retrieves this container after unmounting everything at the given path.
      */
     withoutMount(path) {
         return new Container({
@@ -648,10 +701,11 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This container with a previously added Unix socket removed
+     * Retrieves this container with a previously added Unix socket removed.
      */
     withoutUnixSocket(path) {
         return new Container({
@@ -663,14 +717,15 @@ export class Container extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * The working directory for all commands
+     * Retrieves the working directory for all commands.
      */
     workdir() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "workdir",
@@ -681,11 +736,11 @@ export class Container extends BaseClient {
     }
 }
 /**
- * A directory
+ * A directory.
  */
 export class Directory extends BaseClient {
     /**
-     * The difference between this directory and an another directory
+     * Gets the difference between this directory and an another directory.
      */
     diff(other) {
         return new Directory({
@@ -697,10 +752,11 @@ export class Directory extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Retrieve a directory at the given path
+     * Retrieves a directory at the given path.
      */
     directory(path) {
         return new Directory({
@@ -712,10 +768,13 @@ export class Directory extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Build a new Docker container from this directory
+     * Builds a new Docker container from this directory.
+     * @param opts.dockerfile Path to the Dockerfile to use.
+  Defaults to './Dockerfile'.
      */
     dockerBuild(opts) {
         return new Container({
@@ -727,14 +786,15 @@ export class Directory extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Return a list of files and directories at the given path
+     * Returns a list of files and directories at the given path.
      */
     entries(opts) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "entries",
@@ -745,11 +805,11 @@ export class Directory extends BaseClient {
         });
     }
     /**
-     * Write the contents of the directory to a path on the host
+     * Writes the contents of the directory to a path on the host.
      */
     export(path) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "export",
@@ -760,7 +820,7 @@ export class Directory extends BaseClient {
         });
     }
     /**
-     * Retrieve a file at the given path
+     * Retrieves a file at the given path.
      */
     file(path) {
         return new File({
@@ -772,14 +832,15 @@ export class Directory extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * The content-addressed identifier of the directory
+     * The content-addressed identifier of the directory.
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "id",
@@ -801,10 +862,15 @@ export class Directory extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This directory plus a directory written at the given path
+     * Retrieves this directory plus a directory written at the given path.
+     * @param opts.exclude Exclude artifacts that match the given pattern.
+  (e.g. ["node_modules/", ".git*"]).
+     * @param opts.include Include only artifacts that match the given pattern.
+  (e.g. ["app/", "package.*"]).
      */
     withDirectory(path, directory, opts) {
         return new Directory({
@@ -816,55 +882,75 @@ export class Directory extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This directory plus the contents of the given file copied to the given path
+     * Retrieves this directory plus the contents of the given file copied to the given path.
      */
-    withFile(path, source) {
+    withFile(path, source, opts) {
         return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withFile",
-                    args: { path, source },
+                    args: Object.assign({ path, source }, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This directory plus a new directory created at the given path
+     * Retrieves this directory plus a new directory created at the given path.
      */
-    withNewDirectory(path) {
+    withNewDirectory(path, opts) {
         return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withNewDirectory",
-                    args: { path },
+                    args: Object.assign({ path }, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This directory plus a new file written at the given path
+     * Retrieves this directory plus a new file written at the given path.
      */
-    withNewFile(path, contents) {
+    withNewFile(path, contents, opts) {
         return new Directory({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withNewFile",
-                    args: { path, contents },
+                    args: Object.assign({ path, contents }, opts),
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This directory with the directory at the given path removed
+     * Retrieves this directory with all file/dir timestamps set to the given time, in seconds from the Unix epoch.
+     */
+    withTimestamps(timestamp) {
+        return new Directory({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withTimestamps",
+                    args: { timestamp },
+                },
+            ],
+            host: this.clientHost,
+            sessionToken: this.sessionToken,
+        });
+    }
+    /**
+     * Retrieves this directory with the directory at the given path removed.
      */
     withoutDirectory(path) {
         return new Directory({
@@ -876,10 +962,11 @@ export class Directory extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * This directory with the file at the given path removed
+     * Retrieves this directory with the file at the given path removed.
      */
     withoutFile(path) {
         return new Directory({
@@ -891,19 +978,20 @@ export class Directory extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
 }
 /**
- * EnvVariable is a simple key value object that represents an environment variable.
+ * A simple key value object that represents an environment variable.
  */
 export class EnvVariable extends BaseClient {
     /**
-     * name is the environment variable name.
+     * The environment variable name.
      */
     name() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "name",
@@ -913,11 +1001,11 @@ export class EnvVariable extends BaseClient {
         });
     }
     /**
-     * value is the environment variable value
+     * The environment variable value.
      */
     value() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "value",
@@ -928,15 +1016,15 @@ export class EnvVariable extends BaseClient {
     }
 }
 /**
- * A file
+ * A file.
  */
 export class File extends BaseClient {
     /**
-     * The contents of the file
+     * Retrieves the contents of the file.
      */
     contents() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "contents",
@@ -946,11 +1034,11 @@ export class File extends BaseClient {
         });
     }
     /**
-     * Write the file to a file path on the host
+     * Writes the file to a file path on the host.
      */
     export(path) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "export",
@@ -961,11 +1049,11 @@ export class File extends BaseClient {
         });
     }
     /**
-     * The content-addressed identifier of the file
+     * Retrieves the content-addressed identifier of the file.
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "id",
@@ -974,6 +1062,9 @@ export class File extends BaseClient {
             return response;
         });
     }
+    /**
+     * Retrieves a secret referencing the contents of this file.
+     */
     secret() {
         return new Secret({
             queryTree: [
@@ -983,14 +1074,15 @@ export class File extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * The size of the file, in bytes
+     * Gets the size of the file, in bytes.
      */
     size() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "size",
@@ -999,17 +1091,33 @@ export class File extends BaseClient {
             return response;
         });
     }
+    /**
+     * Retrieves this file with its created/modified timestamps set to the given time, in seconds from the Unix epoch.
+     */
+    withTimestamps(timestamp) {
+        return new File({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withTimestamps",
+                    args: { timestamp },
+                },
+            ],
+            host: this.clientHost,
+            sessionToken: this.sessionToken,
+        });
+    }
 }
 /**
- * A git ref (tag or branch)
+ * A git ref (tag, branch or commit).
  */
 export class GitRef extends BaseClient {
     /**
-     * The digest of the current value of this ref
+     * The digest of the current value of this ref.
      */
     digest() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "digest",
@@ -1019,7 +1127,7 @@ export class GitRef extends BaseClient {
         });
     }
     /**
-     * The filesystem tree at this ref
+     * The filesystem tree at this ref.
      */
     tree(opts) {
         return new Directory({
@@ -1031,15 +1139,16 @@ export class GitRef extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
 }
 /**
- * A git repository
+ * A git repository.
  */
 export class GitRepository extends BaseClient {
     /**
-     * Details on one branch
+     * Returns details on one branch.
      */
     branch(name) {
         return new GitRef({
@@ -1051,14 +1160,15 @@ export class GitRepository extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * List of branches on the repository
+     * Lists of branches on the repository.
      */
     branches() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "branches",
@@ -1068,7 +1178,7 @@ export class GitRepository extends BaseClient {
         });
     }
     /**
-     * Details on one commit
+     * Returns details on one commit.
      */
     commit(id) {
         return new GitRef({
@@ -1080,10 +1190,11 @@ export class GitRepository extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Details on one tag
+     * Returns details on one tag.
      */
     tag(name) {
         return new GitRef({
@@ -1095,14 +1206,15 @@ export class GitRepository extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * List of tags on the repository
+     * Lists of tags on the repository.
      */
     tags() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "tags",
@@ -1113,11 +1225,11 @@ export class GitRepository extends BaseClient {
     }
 }
 /**
- * Information about the host execution environment
+ * Information about the host execution environment.
  */
 export class Host extends BaseClient {
     /**
-     * Access a directory on the host
+     * Accesses a directory on the host.
      */
     directory(path, opts) {
         return new Directory({
@@ -1129,10 +1241,11 @@ export class Host extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Access an environment variable on the host
+     * Accesses an environment variable on the host.
      */
     envVariable(name) {
         return new HostVariable({
@@ -1144,10 +1257,11 @@ export class Host extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Access a Unix socket on the host
+     * Accesses a Unix socket on the host.
      */
     unixSocket(path) {
         return new Socket({
@@ -1159,13 +1273,11 @@ export class Host extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * The current working directory on the host
-     *
-     * @param opts optional params for workdir
-     *
+     * Retrieves the current working directory on the host.
      * @deprecated Use directory with path set to '.' instead.
      */
     workdir(opts) {
@@ -1178,15 +1290,16 @@ export class Host extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
 }
 /**
- * An environment variable on the host environment
+ * An environment variable on the host environment.
  */
 export class HostVariable extends BaseClient {
     /**
-     * A secret referencing the value of this variable
+     * A secret referencing the value of this variable.
      */
     secret() {
         return new Secret({
@@ -1197,14 +1310,15 @@ export class HostVariable extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * The value of this variable
+     * The value of this variable.
      */
     value() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "value",
@@ -1223,7 +1337,7 @@ export class Project extends BaseClient {
      */
     extensions() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "extensions",
@@ -1244,6 +1358,7 @@ export class Project extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
@@ -1251,7 +1366,7 @@ export class Project extends BaseClient {
      */
     install() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "install",
@@ -1265,7 +1380,7 @@ export class Project extends BaseClient {
      */
     name() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "name",
@@ -1279,7 +1394,7 @@ export class Project extends BaseClient {
      */
     schema() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "schema",
@@ -1293,7 +1408,7 @@ export class Project extends BaseClient {
      */
     sdk() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "sdk",
@@ -1305,7 +1420,8 @@ export class Project extends BaseClient {
 }
 export default class Client extends BaseClient {
     /**
-     * Construct a cache volume for a given cache key
+     * Constructs a cache volume for a given cache key.
+     * @param key A string identifier to target this cache volume (e.g. "myapp-cache").
      */
     cacheVolume(key) {
         return new CacheVolume({
@@ -1317,10 +1433,11 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Load a container from ID.
+     * Loads a container from ID.
      * Null ID returns an empty container (scratch).
      * Optional platform argument initializes new containers to execute and publish as that platform. Platform defaults to that of the builder's host.
      */
@@ -1334,6 +1451,7 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
@@ -1341,7 +1459,7 @@ export default class Client extends BaseClient {
      */
     defaultPlatform() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "defaultPlatform",
@@ -1363,10 +1481,11 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Load a file by ID
+     * Loads a file by ID.
      */
     file(id) {
         return new File({
@@ -1378,10 +1497,11 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Query a git repository
+     * Queries a git repository.
      */
     git(url, opts) {
         return new GitRepository({
@@ -1393,10 +1513,11 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Query the host environment
+     * Queries the host environment.
      */
     host() {
         return new Host({
@@ -1407,10 +1528,11 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * An http remote
+     * Returns a file containing an http remote url content.
      */
     http(url) {
         return new File({
@@ -1422,6 +1544,7 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
@@ -1437,10 +1560,11 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Load a secret from its ID
+     * Loads a secret from its ID.
      */
     secret(id) {
         return new Secret({
@@ -1452,10 +1576,11 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
     /**
-     * Load a socket by ID
+     * Loads a socket by its ID.
      */
     socket(opts) {
         return new Socket({
@@ -1467,19 +1592,20 @@ export default class Client extends BaseClient {
                 },
             ],
             host: this.clientHost,
+            sessionToken: this.sessionToken,
         });
     }
 }
 /**
- * A reference to a secret value, which can be handled more safely than the value itself
+ * A reference to a secret value, which can be handled more safely than the value itself.
  */
 export class Secret extends BaseClient {
     /**
-     * The identifier for this secret
+     * The identifier for this secret.
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "id",
@@ -1489,11 +1615,11 @@ export class Secret extends BaseClient {
         });
     }
     /**
-     * The value of this secret
+     * The value of this secret.
      */
     plaintext() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "plaintext",
@@ -1505,11 +1631,11 @@ export class Secret extends BaseClient {
 }
 export class Socket extends BaseClient {
     /**
-     * The content-addressed identifier of the socket
+     * The content-addressed identifier of the socket.
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield queryBuilder([
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
                     operation: "id",