@dagger.io/dagger 0.6.3 → 0.8.0

package/dist/api/client.gen.js

@@ -54,7 +54,7 @@ export var CacheSharingMode;
     CacheSharingMode[CacheSharingMode["Shared"] = 2] = "Shared";
 })(CacheSharingMode || (CacheSharingMode = {}));
 /**
- * Compression algorithm to use for image layers
+ * Compression algorithm to use for image layers.
  */
 export var ImageLayerCompression;
 (function (ImageLayerCompression) {
@@ -63,6 +63,14 @@ export var ImageLayerCompression;
     ImageLayerCompression[ImageLayerCompression["Uncompressed"] = 2] = "Uncompressed";
     ImageLayerCompression[ImageLayerCompression["Zstd"] = 3] = "Zstd";
 })(ImageLayerCompression || (ImageLayerCompression = {}));
+/**
+ * Mediatypes to use in published or exported image metadata.
+ */
+export var ImageMediaTypes;
+(function (ImageMediaTypes) {
+    ImageMediaTypes[ImageMediaTypes["Dockermediatypes"] = 0] = "Dockermediatypes";
+    ImageMediaTypes[ImageMediaTypes["Ocimediatypes"] = 1] = "Ocimediatypes";
+})(ImageMediaTypes || (ImageMediaTypes = {}));
 /**
  * Transport layer network protocol associated to a port.
  */
@@ -81,8 +89,19 @@ export var NetworkProtocol;
  * A directory whose contents persist across runs.
  */
 export class CacheVolume extends BaseClient {
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id) {
+        super(parent);
+        this._id = undefined;
+        this._id = _id;
+    }
     id() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._id) {
+                return this._id;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -92,35 +111,45 @@ export class CacheVolume extends BaseClient {
             return response;
         });
     }
-    /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
-     *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
-     */
-    with(arg) {
-        return arg(this);
-    }
 }
 /**
  * An OCI-compatible container, also known as a docker container.
  */
 export class Container extends BaseClient {
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _endpoint, _envVariable, _export, _hostname, _id, _imageRef, _label, _platform, _publish, _stderr, _stdout, _sync, _user, _workdir) {
+        super(parent);
+        this._endpoint = undefined;
+        this._envVariable = undefined;
+        this._export = undefined;
+        this._hostname = undefined;
+        this._id = undefined;
+        this._imageRef = undefined;
+        this._label = undefined;
+        this._platform = undefined;
+        this._publish = undefined;
+        this._stderr = undefined;
+        this._stdout = undefined;
+        this._sync = undefined;
+        this._user = undefined;
+        this._workdir = undefined;
+        this._endpoint = _endpoint;
+        this._envVariable = _envVariable;
+        this._export = _export;
+        this._hostname = _hostname;
+        this._id = _id;
+        this._imageRef = _imageRef;
+        this._label = _label;
+        this._platform = _platform;
+        this._publish = _publish;
+        this._stderr = _stderr;
+        this._stdout = _stdout;
+        this._sync = _sync;
+        this._user = _user;
+        this._workdir = _workdir;
+    }
     /**
      * Initializes this container from a Dockerfile build.
      * @param context Directory context used by the Dockerfile.
@@ -192,6 +221,9 @@ export class Container extends BaseClient {
      */
     endpoint(opts) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._endpoint) {
+                return this._endpoint;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -222,6 +254,9 @@ export class Container extends BaseClient {
      */
     envVariable(name) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._envVariable) {
+                return this._envVariable;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -242,48 +277,15 @@ export class Container extends BaseClient {
                 {
                     operation: "envVariables",
                 },
-            ], this.client);
-            return response;
-        });
-    }
-    /**
-     * Retrieves this container after executing the specified command inside it.
-     * @param opts.args Command to run instead of the container's default command (e.g., ["run", "main.go"]).
-     * @param opts.stdin Content to write to the command's standard input before closing (e.g., "Hello world").
-     * @param opts.redirectStdout Redirect the command's standard output to a file in the container (e.g., "/tmp/stdout").
-     * @param opts.redirectStderr Redirect the command's standard error to a file in the container (e.g., "/tmp/stderr").
-     * @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) {
-        return new Container({
-            queryTree: [
-                ...this._queryTree,
-                {
-                    operation: "exec",
-                    args: Object.assign({}, opts),
-                },
-            ],
-            host: this.clientHost,
-            sessionToken: this.sessionToken,
-        });
-    }
-    /**
-     * Exit code of the last executed command. Zero means success.
-     *
-     * Will execute default command if none is set, or error if there's no default.
-     */
-    exitCode() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const response = yield computeQuery([
-                ...this._queryTree,
                 {
-                    operation: "exitCode",
+                    operation: "name value",
                 },
             ], this.client);
-            return response;
+            return response.map((r) => new EnvVariable({
+                queryTree: this.queryTree,
+                host: this.clientHost,
+                sessionToken: this.sessionToken,
+            }, r.name, r.value));
         });
     }
     /**
@@ -300,9 +302,15 @@ export class Container extends BaseClient {
      * cache, that will be used (this can result in a mix of compression algorithms for
      * different layers). If this is unset and a layer has no compressed blob in the
      * engine's cache, then it will be compressed using Gzip.
+     * @param opts.mediaTypes Use the specified media types for the exported image's layers. Defaults to OCI, which
+     * is largely compatible with most recent container runtimes, but Docker may be needed
+     * for older runtimes without OCI support.
      */
     export(path, opts) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._export) {
+                return this._export;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -328,8 +336,15 @@ export class Container extends BaseClient {
                 {
                     operation: "exposedPorts",
                 },
+                {
+                    operation: "description port protocol",
+                },
             ], this.client);
-            return response;
+            return response.map((r) => new Port({
+                queryTree: this.queryTree,
+                host: this.clientHost,
+                sessionToken: this.sessionToken,
+            }, r.description, r.port, r.protocol));
         });
     }
     /**
@@ -370,22 +385,6 @@ export class Container extends BaseClient {
             sessionToken: this.sessionToken,
         });
     }
-    /**
-     * Retrieves this container's root filesystem. Mounts are not included.
-     * @deprecated Replaced by rootfs.
-     */
-    fs() {
-        return new Directory({
-            queryTree: [
-                ...this._queryTree,
-                {
-                    operation: "fs",
-                },
-            ],
-            host: this.clientHost,
-            sessionToken: this.sessionToken,
-        });
-    }
     /**
      * Retrieves a hostname which can be used by clients to reach this container.
      *
@@ -393,6 +392,9 @@ export class Container extends BaseClient {
      */
     hostname() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._hostname) {
+                return this._hostname;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -407,6 +409,9 @@ export class Container extends BaseClient {
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._id) {
+                return this._id;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -421,6 +426,9 @@ export class Container extends BaseClient {
      */
     imageRef() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._imageRef) {
+                return this._imageRef;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -457,6 +465,9 @@ export class Container extends BaseClient {
      */
     label(name) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._label) {
+                return this._label;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -477,8 +488,15 @@ export class Container extends BaseClient {
                 {
                     operation: "labels",
                 },
+                {
+                    operation: "name value",
+                },
             ], this.client);
-            return response;
+            return response.map((r) => new Label({
+                queryTree: this.queryTree,
+                host: this.clientHost,
+                sessionToken: this.sessionToken,
+            }, r.name, r.value));
         });
     }
     /**
@@ -519,6 +537,9 @@ export class Container extends BaseClient {
      */
     platform() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._platform) {
+                return this._platform;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -543,9 +564,15 @@ export class Container extends BaseClient {
      * cache, that will be used (this can result in a mix of compression algorithms for
      * different layers). If this is unset and a layer has no compressed blob in the
      * engine's cache, then it will be compressed using Gzip.
+     * @param opts.mediaTypes Use the specified media types for the published image's layers. Defaults to OCI, which
+     * is largely compatible with most recent registries, but Docker may be needed for older
+     * registries without OCI support.
      */
     publish(address, opts) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._publish) {
+                return this._publish;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -578,6 +605,9 @@ export class Container extends BaseClient {
      */
     stderr() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._stderr) {
+                return this._stderr;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -594,6 +624,9 @@ export class Container extends BaseClient {
      */
     stdout() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._stdout) {
+                return this._stdout;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -624,6 +657,9 @@ export class Container extends BaseClient {
      */
     user() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._user) {
+                return this._user;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -768,23 +804,6 @@ export class Container extends BaseClient {
             sessionToken: this.sessionToken,
         });
     }
-    /**
-     * Initializes this container from this DirectoryID.
-     * @deprecated Replaced by withRootfs.
-     */
-    withFS(id) {
-        return new Container({
-            queryTree: [
-                ...this._queryTree,
-                {
-                    operation: "withFS",
-                    args: { id },
-                },
-            ],
-            host: this.clientHost,
-            sessionToken: this.sessionToken,
-        });
-    }
     /**
      * Retrieves this container plus the contents of the given file copied to the given path.
      * @param path Location of the copied file (e.g., "/tmp/file.txt").
@@ -811,6 +830,22 @@ export class Container extends BaseClient {
             sessionToken: this.sessionToken,
         });
     }
+    /**
+     * Indicate that subsequent operations should be featured more prominently in
+     * the UI.
+     */
+    withFocus() {
+        return new Container({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withFocus",
+                },
+            ],
+            host: this.clientHost,
+            sessionToken: this.sessionToken,
+        });
+    }
     /**
      * Retrieves this container plus the given label.
      * @param name The name of the label (e.g., "org.opencontainers.artifact.created").
@@ -993,13 +1028,13 @@ export class Container extends BaseClient {
     /**
      * Initializes this container from this DirectoryID.
      */
-    withRootfs(id) {
+    withRootfs(directory) {
         return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withRootfs",
-                    args: { id },
+                    args: { directory },
                 },
             ],
             host: this.clientHost,
@@ -1145,6 +1180,24 @@ export class Container extends BaseClient {
             sessionToken: this.sessionToken,
         });
     }
+    /**
+     * Indicate that subsequent operations should not be featured more prominently
+     * in the UI.
+     *
+     * This is the initial state of all containers.
+     */
+    withoutFocus() {
+        return new Container({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withoutFocus",
+                },
+            ],
+            host: this.clientHost,
+            sessionToken: this.sessionToken,
+        });
+    }
     /**
      * Retrieves this container minus the given environment label.
      * @param name The name of the label to remove (e.g., "org.opencontainers.artifact.created").
@@ -1219,6 +1272,9 @@ export class Container extends BaseClient {
      */
     workdir() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._workdir) {
+                return this._workdir;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -1229,25 +1285,9 @@ export class Container extends BaseClient {
         });
     }
     /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
+     * Call the provided function with current Container.
      *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
+     * This is useful for reusability and readability by not breaking the calling chain.
      */
     with(arg) {
         return arg(this);
@@ -1257,6 +1297,18 @@ export class Container extends BaseClient {
  * A directory.
  */
 export class Directory extends BaseClient {
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _export, _id, _sync) {
+        super(parent);
+        this._export = undefined;
+        this._id = undefined;
+        this._sync = undefined;
+        this._export = _export;
+        this._id = _id;
+        this._sync = _sync;
+    }
     /**
      * Gets the difference between this directory and an another directory.
      * @param other Identifier of the directory to compare.
@@ -1338,6 +1390,9 @@ export class Directory extends BaseClient {
      */
     export(path) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._export) {
+                return this._export;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -1370,6 +1425,9 @@ export class Directory extends BaseClient {
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._id) {
+                return this._id;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -1398,6 +1456,20 @@ export class Directory extends BaseClient {
             sessionToken: this.sessionToken,
         });
     }
+    /**
+     * Force evaluation in the engine.
+     */
+    sync() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield computeQuery([
+                ...this._queryTree,
+                {
+                    operation: "sync",
+                },
+            ], this.client);
+            return this;
+        });
+    }
     /**
      * Retrieves this directory plus a directory written at the given path.
      * @param path Location of the written directory (e.g., "/src/").
@@ -1534,25 +1606,9 @@ export class Directory extends BaseClient {
         });
     }
     /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
+     * Call the provided function with current Directory.
      *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
+     * This is useful for reusability and readability by not breaking the calling chain.
      */
     with(arg) {
         return arg(this);
@@ -1562,11 +1618,24 @@ export class Directory extends BaseClient {
  * A simple key value object that represents an environment variable.
  */
 export class EnvVariable extends BaseClient {
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _name, _value) {
+        super(parent);
+        this._name = undefined;
+        this._value = undefined;
+        this._name = _name;
+        this._value = _value;
+    }
     /**
      * The environment variable name.
      */
     name() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._name) {
+                return this._name;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -1581,6 +1650,9 @@ export class EnvVariable extends BaseClient {
      */
     value() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._value) {
+                return this._value;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -1590,40 +1662,35 @@ export class EnvVariable extends BaseClient {
             return response;
         });
     }
-    /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
-     *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
-     */
-    with(arg) {
-        return arg(this);
-    }
 }
 /**
  * A file.
  */
 export class File extends BaseClient {
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _contents, _export, _id, _size, _sync) {
+        super(parent);
+        this._contents = undefined;
+        this._export = undefined;
+        this._id = undefined;
+        this._size = undefined;
+        this._sync = undefined;
+        this._contents = _contents;
+        this._export = _export;
+        this._id = _id;
+        this._size = _size;
+        this._sync = _sync;
+    }
     /**
      * Retrieves the contents of the file.
      */
     contents() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._contents) {
+                return this._contents;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -1641,6 +1708,9 @@ export class File extends BaseClient {
      */
     export(path, opts) {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._export) {
+                return this._export;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -1656,6 +1726,9 @@ export class File extends BaseClient {
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._id) {
+                return this._id;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -1666,33 +1739,34 @@ export class File extends BaseClient {
         });
     }
     /**
-     * Retrieves a secret referencing the contents of this file.
-     * @deprecated insecure, leaves secret in cache. Superseded by setSecret
+     * Gets the size of the file, in bytes.
      */
-    secret() {
-        return new Secret({
-            queryTree: [
+    size() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this._size) {
+                return this._size;
+            }
+            const response = yield computeQuery([
                 ...this._queryTree,
                 {
-                    operation: "secret",
+                    operation: "size",
                 },
-            ],
-            host: this.clientHost,
-            sessionToken: this.sessionToken,
+            ], this.client);
+            return response;
         });
     }
     /**
-     * Gets the size of the file, in bytes.
+     * Force evaluation in the engine.
      */
-    size() {
+    sync() {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield computeQuery([
+            yield computeQuery([
                 ...this._queryTree,
                 {
-                    operation: "size",
+                    operation: "sync",
                 },
             ], this.client);
-            return response;
+            return this;
         });
     }
     /**
@@ -1715,25 +1789,9 @@ export class File extends BaseClient {
         });
     }
     /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
+     * Call the provided function with current File.
      *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
+     * This is useful for reusability and readability by not breaking the calling chain.
      */
     with(arg) {
         return arg(this);
@@ -1744,18 +1802,10 @@ export class File extends BaseClient {
  */
 export class GitRef extends BaseClient {
     /**
-     * The digest of the current value of this ref.
+     * Constructor is used for internal usage only, do not create object from it.
      */
-    digest() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const response = yield computeQuery([
-                ...this._queryTree,
-                {
-                    operation: "digest",
-                },
-            ], this.client);
-            return response;
-        });
+    constructor(parent) {
+        super(parent);
     }
     /**
      * The filesystem tree at this ref.
@@ -1773,35 +1823,17 @@ export class GitRef extends BaseClient {
             sessionToken: this.sessionToken,
         });
     }
-    /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
-     *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
-     */
-    with(arg) {
-        return arg(this);
-    }
 }
 /**
  * A git repository.
  */
 export class GitRepository extends BaseClient {
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent) {
+        super(parent);
+    }
     /**
      * Returns details on one branch.
      * @param name Branch's name (e.g., "main").
@@ -1819,20 +1851,6 @@ export class GitRepository extends BaseClient {
             sessionToken: this.sessionToken,
         });
     }
-    /**
-     * Lists of branches on the repository.
-     */
-    branches() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const response = yield computeQuery([
-                ...this._queryTree,
-                {
-                    operation: "branches",
-                },
-            ], this.client);
-            return response;
-        });
-    }
     /**
      * Returns details on one commit.
      * @param id Identifier of the commit (e.g., "b6315d8f2810962c601af73f86831f6866ea798b").
@@ -1867,49 +1885,17 @@ export class GitRepository extends BaseClient {
             sessionToken: this.sessionToken,
         });
     }
-    /**
-     * Lists of tags on the repository.
-     */
-    tags() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const response = yield computeQuery([
-                ...this._queryTree,
-                {
-                    operation: "tags",
-                },
-            ], this.client);
-            return response;
-        });
-    }
-    /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
-     *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
-     */
-    with(arg) {
-        return arg(this);
-    }
 }
 /**
  * Information about the host execution environment.
  */
 export class Host extends BaseClient {
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent) {
+        super(parent);
+    }
     /**
      * Accesses a directory on the host.
      * @param path Location of the directory to access (e.g., ".").
@@ -1929,23 +1915,6 @@ export class Host extends BaseClient {
             sessionToken: this.sessionToken,
         });
     }
-    /**
-     * Accesses an environment variable on the host.
-     * @param name Name of the environment variable (e.g., "PATH").
-     */
-    envVariable(name) {
-        return new HostVariable({
-            queryTree: [
-                ...this._queryTree,
-                {
-                    operation: "envVariable",
-                    args: { name },
-                },
-            ],
-            host: this.clientHost,
-            sessionToken: this.sessionToken,
-        });
-    }
     /**
      * Accesses a file on the host.
      * @param path Location of the file to retrieve (e.g., "README.md").
@@ -1964,16 +1933,18 @@ export class Host extends BaseClient {
         });
     }
     /**
-     * Accesses a Unix socket on the host.
-     * @param path Location of the Unix socket (e.g., "/var/run/docker.sock").
+     * Sets a secret given a user-defined name and the file path on the host, and returns the secret.
+     * The file is limited to a size of 512000 bytes.
+     * @param name The user defined name for this secret.
+     * @param path Location of the file to set as a secret.
      */
-    unixSocket(path) {
-        return new Socket({
+    setSecretFile(name, path) {
+        return new Secret({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "unixSocket",
-                    args: { path },
+                    operation: "setSecretFile",
+                    args: { name, path },
                 },
             ],
             host: this.clientHost,
@@ -1981,117 +1952,45 @@ export class Host extends BaseClient {
         });
     }
     /**
-     * Retrieves the current working directory on the host.
-     * @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.*"]).
-     * @deprecated Use directory with path set to '.' instead.
+     * Accesses a Unix socket on the host.
+     * @param path Location of the Unix socket (e.g., "/var/run/docker.sock").
      */
-    workdir(opts) {
-        return new Directory({
+    unixSocket(path) {
+        return new Socket({
             queryTree: [
                 ...this._queryTree,
                 {
-                    operation: "workdir",
-                    args: Object.assign({}, opts),
+                    operation: "unixSocket",
+                    args: { path },
                 },
             ],
             host: this.clientHost,
             sessionToken: this.sessionToken,
         });
     }
-    /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
-     *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
-     */
-    with(arg) {
-        return arg(this);
-    }
 }
 /**
- * An environment variable on the host environment.
+ * A simple key value object that represents a label.
  */
-export class HostVariable extends BaseClient {
-    /**
-     * A secret referencing the value of this variable.
-     * @deprecated been superseded by setSecret
-     */
-    secret() {
-        return new Secret({
-            queryTree: [
-                ...this._queryTree,
-                {
-                    operation: "secret",
-                },
-            ],
-            host: this.clientHost,
-            sessionToken: this.sessionToken,
-        });
-    }
-    /**
-     * The value of this variable.
-     */
-    value() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const response = yield computeQuery([
-                ...this._queryTree,
-                {
-                    operation: "value",
-                },
-            ], this.client);
-            return response;
-        });
-    }
+export class Label extends BaseClient {
     /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
-     *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
+     * Constructor is used for internal usage only, do not create object from it.
      */
-    with(arg) {
-        return arg(this);
+    constructor(parent, _name, _value) {
+        super(parent);
+        this._name = undefined;
+        this._value = undefined;
+        this._name = _name;
+        this._value = _value;
     }
-}
-/**
- * A simple key value object that represents a label.
- */
-export class Label extends BaseClient {
     /**
      * The label name.
      */
     name() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._name) {
+                return this._name;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2106,6 +2005,9 @@ export class Label extends BaseClient {
      */
     value() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._value) {
+                return this._value;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2115,40 +2017,31 @@ export class Label extends BaseClient {
             return response;
         });
     }
-    /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
-     *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
-     */
-    with(arg) {
-        return arg(this);
-    }
 }
 /**
  * A port exposed by a container.
  */
 export class Port extends BaseClient {
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _description, _port, _protocol) {
+        super(parent);
+        this._description = undefined;
+        this._port = undefined;
+        this._protocol = undefined;
+        this._description = _description;
+        this._port = _port;
+        this._protocol = _protocol;
+    }
     /**
      * The port description.
      */
     description() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._description) {
+                return this._description;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2163,6 +2056,9 @@ export class Port extends BaseClient {
      */
     port() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._port) {
+                return this._port;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2177,6 +2073,9 @@ export class Port extends BaseClient {
      */
     protocol() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._protocol) {
+                return this._protocol;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2186,35 +2085,21 @@ export class Port extends BaseClient {
             return response;
         });
     }
-    /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
-     *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
-     */
-    with(arg) {
-        return arg(this);
-    }
 }
 /**
  * A collection of Dagger resources that can be queried and invoked.
  */
 export class Project extends BaseClient {
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id, _name) {
+        super(parent);
+        this._id = undefined;
+        this._name = undefined;
+        this._id = _id;
+        this._name = _name;
+    }
     /**
      * Commands provided by this project
      */
@@ -2225,8 +2110,15 @@ export class Project extends BaseClient {
                 {
                     operation: "commands",
                 },
+                {
+                    operation: "description id name resultType",
+                },
             ], this.client);
-            return response;
+            return response.map((r) => new ProjectCommand({
+                queryTree: this.queryTree,
+                host: this.clientHost,
+                sessionToken: this.sessionToken,
+            }, r.description, r.id, r.name, r.resultType));
         });
     }
     /**
@@ -2234,6 +2126,9 @@ export class Project extends BaseClient {
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._id) {
+                return this._id;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2264,6 +2159,9 @@ export class Project extends BaseClient {
      */
     name() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._name) {
+                return this._name;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2274,25 +2172,9 @@ export class Project extends BaseClient {
         });
     }
     /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
+     * Call the provided function with current Project.
      *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
+     * This is useful for reusability and readability by not breaking the calling chain.
      */
     with(arg) {
         return arg(this);
@@ -2302,11 +2184,28 @@ export class Project extends BaseClient {
  * A command defined in a project that can be invoked from the CLI.
  */
 export class ProjectCommand extends BaseClient {
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _description, _id, _name, _resultType) {
+        super(parent);
+        this._description = undefined;
+        this._id = undefined;
+        this._name = undefined;
+        this._resultType = undefined;
+        this._description = _description;
+        this._id = _id;
+        this._name = _name;
+        this._resultType = _resultType;
+    }
     /**
      * Documentation for what this command does.
      */
     description() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._description) {
+                return this._description;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2326,8 +2225,15 @@ export class ProjectCommand extends BaseClient {
                 {
                     operation: "flags",
                 },
+                {
+                    operation: "description name",
+                },
             ], this.client);
-            return response;
+            return response.map((r) => new ProjectCommandFlag({
+                queryTree: this.queryTree,
+                host: this.clientHost,
+                sessionToken: this.sessionToken,
+            }, r.description, r.name));
         });
     }
     /**
@@ -2335,6 +2241,9 @@ export class ProjectCommand extends BaseClient {
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._id) {
+                return this._id;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2349,6 +2258,9 @@ export class ProjectCommand extends BaseClient {
      */
     name() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._name) {
+                return this._name;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2363,6 +2275,9 @@ export class ProjectCommand extends BaseClient {
      */
     resultType() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._resultType) {
+                return this._resultType;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2382,44 +2297,40 @@ export class ProjectCommand extends BaseClient {
                 {
                     operation: "subcommands",
                 },
+                {
+                    operation: "description id name resultType",
+                },
             ], this.client);
-            return response;
+            return response.map((r) => new ProjectCommand({
+                queryTree: this.queryTree,
+                host: this.clientHost,
+                sessionToken: this.sessionToken,
+            }, r.description, r.id, r.name, r.resultType));
         });
     }
-    /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
-     *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
-     */
-    with(arg) {
-        return arg(this);
-    }
 }
 /**
  * A flag accepted by a project command.
  */
 export class ProjectCommandFlag extends BaseClient {
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _description, _name) {
+        super(parent);
+        this._description = undefined;
+        this._name = undefined;
+        this._description = _description;
+        this._name = _name;
+    }
     /**
      * Documentation for what this flag sets.
      */
     description() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._description) {
+                return this._description;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2434,6 +2345,9 @@ export class ProjectCommandFlag extends BaseClient {
      */
     name() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._name) {
+                return this._name;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2443,32 +2357,18 @@ export class ProjectCommandFlag extends BaseClient {
             return response;
         });
     }
+}
+export class Client extends BaseClient {
     /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
-     *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
+     * Constructor is used for internal usage only, do not create object from it.
      */
-    with(arg) {
-        return arg(this);
+    constructor(parent, _checkVersionCompatibility, _defaultPlatform) {
+        super(parent);
+        this._checkVersionCompatibility = undefined;
+        this._defaultPlatform = undefined;
+        this._checkVersionCompatibility = _checkVersionCompatibility;
+        this._defaultPlatform = _defaultPlatform;
     }
-}
-export default class Client extends BaseClient {
     /**
      * Constructs a cache volume for a given cache key.
      * @param key A string identifier to target this cache volume (e.g., "modules-cache").
@@ -2486,6 +2386,22 @@ export default class Client extends BaseClient {
             sessionToken: this.sessionToken,
         });
     }
+    /**
+     * Checks if the current Dagger Engine is compatible with an SDK's required version.
+     * @param version The SDK's required version.
+     */
+    checkVersionCompatibility(version) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield computeQuery([
+                ...this._queryTree,
+                {
+                    operation: "checkVersionCompatibility",
+                    args: { version },
+                },
+            ], this.client);
+            return response;
+        });
+    }
     /**
      * Loads a container from ID.
      *
@@ -2708,16 +2624,37 @@ export default class Client extends BaseClient {
             sessionToken: this.sessionToken,
         });
     }
+    /**
+     * Call the provided function with current Client.
+     *
+     * This is useful for reusability and readability by not breaking the calling chain.
+     */
+    with(arg) {
+        return arg(this);
+    }
 }
 /**
  * A reference to a secret value, which can be handled more safely than the value itself.
  */
 export class Secret extends BaseClient {
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id, _plaintext) {
+        super(parent);
+        this._id = undefined;
+        this._plaintext = undefined;
+        this._id = _id;
+        this._plaintext = _plaintext;
+    }
     /**
      * The identifier for this secret.
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._id) {
+                return this._id;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2732,6 +2669,9 @@ export class Secret extends BaseClient {
      */
     plaintext() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._plaintext) {
+                return this._plaintext;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2741,37 +2681,24 @@ export class Secret extends BaseClient {
             return response;
         });
     }
+}
+export class Socket extends BaseClient {
     /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
-     *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
+     * Constructor is used for internal usage only, do not create object from it.
      */
-    with(arg) {
-        return arg(this);
+    constructor(parent, _id) {
+        super(parent);
+        this._id = undefined;
+        this._id = _id;
     }
-}
-export class Socket extends BaseClient {
     /**
      * The content-addressed identifier of the socket.
      */
     id() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (this._id) {
+                return this._id;
+            }
             const response = yield computeQuery([
                 ...this._queryTree,
                 {
@@ -2781,28 +2708,4 @@ export class Socket extends BaseClient {
             return response;
         });
     }
-    /**
-     * Chain objects together
-     * @example
-     * ```ts
-     *	function AddAFewMounts(c) {
-     *			return c
-     *			.withMountedDirectory("/foo", new Client().host().directory("/Users/slumbering/forks/dagger"))
-     *			.withMountedDirectory("/bar", new Client().host().directory("/Users/slumbering/forks/dagger/sdk/nodejs"))
-     *	}
-     *
-     * connect(async (client) => {
-     *		const tree = await client
-     *			.container()
-     *			.from("alpine")
-     *			.withWorkdir("/foo")
-     *			.with(AddAFewMounts)
-     *			.withExec(["ls", "-lh"])
-     *			.stdout()
-     * })
-     *```
-     */
-    with(arg) {
-        return arg(this);
-    }
 }