@dagger.io/dagger 0.13.5 → 0.13.7

package/dist/api/client.gen.js

@@ -73,6 +73,24 @@ export var NetworkProtocol;
     NetworkProtocol["Tcp"] = "TCP";
     NetworkProtocol["Udp"] = "UDP";
 })(NetworkProtocol || (NetworkProtocol = {}));
+/**
+ * Expected return type of an execution
+ */
+export var ReturnType;
+(function (ReturnType) {
+    /**
+     * Any execution (exit codes 0-127)
+     */
+    ReturnType["Any"] = "ANY";
+    /**
+     * A failed execution (exit codes 1-127)
+     */
+    ReturnType["Failure"] = "FAILURE";
+    /**
+     * A successful execution (exit code 0)
+     */
+    ReturnType["Success"] = "SUCCESS";
+})(ReturnType || (ReturnType = {}));
 /**
  * Distinguishes the different kinds of TypeDefs.
  */
@@ -163,6 +181,7 @@ export class CacheVolume extends BaseClient {
 export class Container extends BaseClient {
     _id = undefined;
     _envVariable = undefined;
+    _exitCode = undefined;
     _export = undefined;
     _imageRef = undefined;
     _label = undefined;
@@ -177,10 +196,11 @@ export class Container extends BaseClient {
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _id, _envVariable, _export, _imageRef, _label, _platform, _publish, _stderr, _stdout, _sync, _up, _user, _workdir) {
+    constructor(parent, _id, _envVariable, _exitCode, _export, _imageRef, _label, _platform, _publish, _stderr, _stdout, _sync, _up, _user, _workdir) {
         super(parent);
         this._id = _id;
         this._envVariable = _envVariable;
+        this._exitCode = _exitCode;
         this._export = _export;
         this._imageRef = _imageRef;
         this._label = _label;
@@ -359,6 +379,23 @@ export class Container extends BaseClient {
             ctx: this._ctx,
         }, r.id));
     };
+    /**
+     * The exit code of the last executed command.
+     *
+     * Returns an error if no command was set.
+     */
+    exitCode = async () => {
+        if (this._exitCode) {
+            return this._exitCode;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "exitCode",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
     /**
      * EXPERIMENTAL API! Subject to change/removal at any time.
      *
@@ -646,7 +683,7 @@ export class Container extends BaseClient {
     /**
      * The error stream of the last executed command.
      *
-     * Will execute default command if none is set, or error if there's no default.
+     * Returns an error if no command was set.
      */
     stderr = async () => {
         if (this._stderr) {
@@ -663,7 +700,7 @@ export class Container extends BaseClient {
     /**
      * The output stream of the last executed command.
      *
-     * Will execute default command if none is set, or error if there's no default.
+     * Returns an error if no command was set.
      */
     stdout = async () => {
         if (this._stdout) {
@@ -877,6 +914,7 @@ export class Container extends BaseClient {
      * @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.expect Exit codes this command is allowed to exit with without error
      * @param opts.experimentalPrivilegedNesting Provides 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.
@@ -887,12 +925,15 @@ export class Container extends BaseClient {
      * This should only be used if the user requires that their exec process be the pid 1 process in the container. Otherwise it may result in unexpected behavior.
      */
     withExec = (args, opts) => {
+        const metadata = {
+            expect: { is_enum: true },
+        };
         return new Container({
             queryTree: [
                 ...this._queryTree,
                 {
                     operation: "withExec",
-                    args: { args, ...opts },
+                    args: { args, ...opts, __metadata: metadata },
                 },
             ],
             ctx: this._ctx,
@@ -1711,15 +1752,21 @@ export class DaggerEngine extends BaseClient {
 export class DaggerEngineCache extends BaseClient {
     _id = undefined;
     _keepBytes = undefined;
+    _maxUsedSpace = undefined;
+    _minFreeSpace = undefined;
     _prune = undefined;
+    _reservedSpace = undefined;
     /**
      * Constructor is used for internal usage only, do not create object from it.
      */
-    constructor(parent, _id, _keepBytes, _prune) {
+    constructor(parent, _id, _keepBytes, _maxUsedSpace, _minFreeSpace, _prune, _reservedSpace) {
         super(parent);
         this._id = _id;
         this._keepBytes = _keepBytes;
+        this._maxUsedSpace = _maxUsedSpace;
+        this._minFreeSpace = _minFreeSpace;
         this._prune = _prune;
+        this._reservedSpace = _reservedSpace;
     }
     /**
      * A unique identifier for this DaggerEngineCache.
@@ -1752,6 +1799,7 @@ export class DaggerEngineCache extends BaseClient {
     };
     /**
      * The maximum bytes to keep in the cache without pruning, after which automatic pruning may kick in.
+     * @deprecated Use minFreeSpace instead.
      */
     keepBytes = async () => {
         if (this._keepBytes) {
@@ -1765,6 +1813,36 @@ export class DaggerEngineCache extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The maximum bytes to keep in the cache without pruning.
+     */
+    maxUsedSpace = async () => {
+        if (this._maxUsedSpace) {
+            return this._maxUsedSpace;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "maxUsedSpace",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The target amount of free disk space the garbage collector will attempt to leave.
+     */
+    minFreeSpace = async () => {
+        if (this._minFreeSpace) {
+            return this._minFreeSpace;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "minFreeSpace",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
     /**
      * Prune the cache of releaseable entries
      */
@@ -1779,6 +1857,18 @@ export class DaggerEngineCache extends BaseClient {
             },
         ], await this._ctx.connection());
     };
+    reservedSpace = async () => {
+        if (this._reservedSpace) {
+            return this._reservedSpace;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "reservedSpace",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
 }
 /**
  * An individual cache entry in a cache entry set
@@ -2432,6 +2522,20 @@ export class EnumTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The location of this enum declaration.
+     */
+    sourceMap = () => {
+        return new SourceMap({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "sourceMap",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * If this EnumTypeDef is associated with a Module, the name of the module. Unset otherwise.
      */
@@ -2532,6 +2636,20 @@ export class EnumValueTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The location of this enum value declaration.
+     */
+    sourceMap = () => {
+        return new SourceMap({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "sourceMap",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
 }
 /**
  * An environment variable name and value.
@@ -2658,6 +2776,20 @@ export class FieldTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The location of this field declaration.
+     */
+    sourceMap = () => {
+        return new SourceMap({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "sourceMap",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * The type of the field.
      */
@@ -2955,6 +3087,20 @@ export class Function_ extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * The location of this function declaration.
+     */
+    sourceMap = () => {
+        return new SourceMap({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "sourceMap",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Returns the function with the provided argument
      * @param name The name of the argument
@@ -2992,6 +3138,22 @@ export class Function_ extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Returns the function with the given source map.
+     * @param sourceMap The source map for the function definition.
+     */
+    withSourceMap = (sourceMap) => {
+        return new Function_({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "withSourceMap",
+                    args: { sourceMap },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Call the provided function with current Function.
      *
@@ -3110,6 +3272,20 @@ export class FunctionArg extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The location of this arg declaration.
+     */
+    sourceMap = () => {
+        return new SourceMap({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "sourceMap",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * The type of the argument.
      */
@@ -4094,6 +4270,20 @@ export class InterfaceTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The location of this interface declaration.
+     */
+    sourceMap = () => {
+        return new SourceMap({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "sourceMap",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * If this InterfaceTypeDef is associated with a Module, the name of the module. Unset otherwise.
      */
@@ -5385,6 +5575,20 @@ export class ObjectTypeDef extends BaseClient {
         ], await this._ctx.connection());
         return response;
     };
+    /**
+     * The location of this object declaration.
+     */
+    sourceMap = () => {
+        return new SourceMap({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "sourceMap",
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * If this ObjectTypeDef is associated with a Module, the name of the module. Unset otherwise.
      */
@@ -6321,6 +6525,21 @@ export class Client extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Load a SourceMap from its ID.
+     */
+    loadSourceMapFromID = (id) => {
+        return new SourceMap({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "loadSourceMapFromID",
+                    args: { id },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Load a Terminal from its ID.
      */
@@ -6385,6 +6604,7 @@ export class Client extends BaseClient {
     /**
      * Create a new module source instance from a source ref string.
      * @param refString The string ref representation of the module source
+     * @param opts.refPin The pinned version of the module source
      * @param opts.stable If true, enforce that the source is a stable version for source kinds that support versioning.
      * @param opts.relHostPath The relative path to the module root from the host directory
      */
@@ -6434,6 +6654,24 @@ export class Client extends BaseClient {
             ctx: this._ctx,
         });
     };
+    /**
+     * Creates source map metadata.
+     * @param filename The filename from the module source.
+     * @param line The line number within the filename.
+     * @param column The column number within the line.
+     */
+    sourceMap = (filename, line, column) => {
+        return new SourceMap({
+            queryTree: [
+                ...this._queryTree,
+                {
+                    operation: "sourceMap",
+                    args: { filename, line, column },
+                },
+            ],
+            ctx: this._ctx,
+        });
+    };
     /**
      * Create a new TypeDef.
      */
@@ -6815,6 +7053,102 @@ export class Socket extends BaseClient {
         return response;
     };
 }
+/**
+ * Source location information.
+ */
+export class SourceMap extends BaseClient {
+    _id = undefined;
+    _column = undefined;
+    _filename = undefined;
+    _line = undefined;
+    _module = undefined;
+    /**
+     * Constructor is used for internal usage only, do not create object from it.
+     */
+    constructor(parent, _id, _column, _filename, _line, _module) {
+        super(parent);
+        this._id = _id;
+        this._column = _column;
+        this._filename = _filename;
+        this._line = _line;
+        this._module = _module;
+    }
+    /**
+     * A unique identifier for this SourceMap.
+     */
+    id = async () => {
+        if (this._id) {
+            return this._id;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "id",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The column number within the line.
+     */
+    column = async () => {
+        if (this._column) {
+            return this._column;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "column",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The filename from the module source.
+     */
+    filename = async () => {
+        if (this._filename) {
+            return this._filename;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "filename",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The line number within the filename.
+     */
+    line = async () => {
+        if (this._line) {
+            return this._line;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "line",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+    /**
+     * The module dependency this was declared in.
+     */
+    module_ = async () => {
+        if (this._module) {
+            return this._module;
+        }
+        const response = await computeQuery([
+            ...this._queryTree,
+            {
+                operation: "module",
+            },
+        ], await this._ctx.connection());
+        return response;
+    };
+}
 /**
  * An interactive terminal that clients can connect to.
  */
@@ -7035,6 +7369,7 @@ export class TypeDef extends BaseClient {
      * Note that an enum's values may be omitted if the intent is only to refer to an enum. This is how functions are able to return their own, or any other circular reference.
      * @param name The name of the enum
      * @param opts.description A doc string for the enum, if any
+     * @param opts.sourceMap The source map for the enum definition.
      */
     withEnum = (name, opts) => {
         return new TypeDef({
@@ -7052,6 +7387,7 @@ export class TypeDef extends BaseClient {
      * Adds a static value for an Enum TypeDef, failing if the type is not an enum.
      * @param value The name of the value in the enum
      * @param opts.description A doc string for the value, if any
+     * @param opts.sourceMap The source map for the enum value definition.
      */
     withEnumValue = (value, opts) => {
         return new TypeDef({
@@ -7070,6 +7406,7 @@ export class TypeDef extends BaseClient {
      * @param name The name of the field in the object
      * @param typeDef The type of the field
      * @param opts.description A doc string for the field, if any
+     * @param opts.sourceMap The source map for the field definition.
      */
     withField = (name, typeDef, opts) => {
         return new TypeDef({

package/dist/common/errors/FunctionNotFound.d.ts

@@ -0,0 +1,7 @@
+import { DaggerSDKError, DaggerSDKErrorOptions } from "./DaggerSDKError.js";
+export declare class FunctionNotFound extends DaggerSDKError {
+    name: "ExecError";
+    code: "D109";
+    constructor(message: string, options?: DaggerSDKErrorOptions);
+}
+//# sourceMappingURL=FunctionNotFound.d.ts.map

package/dist/common/errors/FunctionNotFound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FunctionNotFound.d.ts","sourceRoot":"","sources":["../../../common/errors/FunctionNotFound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAG3E,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,IAAI,cAAwB;IAC5B,IAAI,SAAwB;gBAEhB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;CAG7D"}

package/dist/common/errors/FunctionNotFound.js

@@ -0,0 +1,9 @@
+import { DaggerSDKError } from "./DaggerSDKError.js";
+import { ERROR_CODES, ERROR_NAMES } from "./errors-codes.js";
+export class FunctionNotFound extends DaggerSDKError {
+    name = ERROR_NAMES.ExecError;
+    code = ERROR_CODES.ExecError;
+    constructor(message, options) {
+        super(message, options);
+    }
+}

package/dist/entrypoint/context.d.ts

@@ -1,4 +1,4 @@
-import { Args } from "../introspector/registry/registry.js";
+import { Args } from "../introspector/executor/executor.js";
 export type InvokeCtx = {
     parentName: string;
     fnName: string;

package/dist/entrypoint/entrypoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoint.d.ts","sourceRoot":"","sources":["../../entrypoint/entrypoint.ts"],"names":[],"mappings":"AAiBA,wBAAsB,UAAU,kBAmE/B"}
+{"version":3,"file":"entrypoint.d.ts","sourceRoot":"","sources":["../../entrypoint/entrypoint.ts"],"names":[],"mappings":"AAkBA,wBAAsB,UAAU,kBAoE/B"}

package/dist/entrypoint/entrypoint.js

@@ -2,6 +2,7 @@ import * as path from "path";
 import { fileURLToPath } from "url";
 import { dag } from "../api/client.gen.js";
 import { connection } from "../connect.js";
+import { Executor } from "../introspector/executor/executor.js";
 import { scan } from "../introspector/scanner/scan.js";
 import { listFiles } from "../introspector/utils/files.js";
 import { invoke } from "./invoke.js";
@@ -36,9 +37,10 @@ export async function entrypoint() {
             for (const arg of fnArgs) {
                 args[await arg.name()] = JSON.parse(await arg.value());
             }
-            await load(files);
+            const modules = await load(files);
+            const executor = new Executor(modules);
             try {
-                result = await invoke(scanResult, {
+                result = await invoke(executor, scanResult, {
                     parentName,
                     fnName,
                     parentArgs,

package/dist/entrypoint/invoke.d.ts

@@ -1,3 +1,4 @@
+import { Executor } from "../introspector/executor/executor.js";
 import { DaggerModule } from "../introspector/scanner/abtractions/module.js";
 import { InvokeCtx } from "./context.js";
 /**
@@ -9,5 +10,5 @@ import { InvokeCtx } from "./context.js";
  * @param parentArgs The arguments of the parent object.
  * @param fnArgs The arguments of the function to call.
  */
-export declare function invoke(module: DaggerModule, ctx: InvokeCtx): Promise<any>;
+export declare function invoke(executor: Executor, module: DaggerModule, ctx: InvokeCtx): Promise<any>;
 //# sourceMappingURL=invoke.d.ts.map

package/dist/entrypoint/invoke.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../entrypoint/invoke.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAA;AAE5E,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAcxC;;;;;;;;GAQG;AACH,wBAAsB,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,gBAoChE"}
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../entrypoint/invoke.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AAK/D,OAAO,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAA;AAE5E,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAcxC;;;;;;;;GAQG;AACH,wBAAsB,MAAM,CAC1B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,SAAS,gBAwDf"}

package/dist/entrypoint/invoke.js

@@ -1,3 +1,4 @@
+import { FunctionNotFound } from "../common/errors/FunctionNotFound.js";
 import { registry } from "../introspector/registry/registry.js";
 import { loadResult, loadInvokedMethod, loadInvokedObject, loadArgs, loadParentState, loadObjectReturnType, } from "./load.js";
 function isConstructor(method) {
@@ -12,7 +13,7 @@ function isConstructor(method) {
  * @param parentArgs The arguments of the parent object.
  * @param fnArgs The arguments of the function to call.
  */
-export async function invoke(module, ctx) {
+export async function invoke(executor, module, ctx) {
     const object = loadInvokedObject(module, ctx.parentName);
     if (!object) {
         throw new Error(`could not find object ${ctx.parentName}`);
@@ -21,9 +22,24 @@ export async function invoke(module, ctx) {
     if (!method) {
         throw new Error(`could not find method ${ctx.fnName}`);
     }
-    const args = await loadArgs(registry, method, ctx);
-    const parentState = await loadParentState(registry, object, ctx);
-    let result = await registry.getResult(object.name, method.name, parentState, args);
+    const args = await loadArgs(executor, method, ctx);
+    const parentState = await loadParentState(executor, object, ctx);
+    // Disabling linter because the result could be anything.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let result = {};
+    try {
+        result = await executor.getResult(object.name, method.name, parentState, args);
+    }
+    catch (e) {
+        // If the function isn't found because it's
+        // not exported, we try to get the result from the registry.
+        if (e instanceof FunctionNotFound) {
+            result = await registry.getResult(object.name, method.name, parentState, args);
+        }
+        else {
+            throw e;
+        }
+    }
     if (result) {
         let returnType;
         // Handle alias serialization by getting the return type to load