@dagger.io/dagger 0.2.1 → 0.3.0

package/dist/api/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../api/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAO,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAkD3C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,MAAM,CAYjD;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,CAAC,EAAE,SAAS,EAAE,EACd,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC,CAmBhD;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,CAAC,CAAC,CAQZ"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../api/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAMjE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAsD3C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,MAAM,CAYjD;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,CAAC,EAAE,SAAS,EAAE,EACd,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC,CAqBhD;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,CAAC,CAAC,CAyBZ"}

package/dist/api/utils.js

@@ -8,7 +8,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 /* eslint-disable @typescript-eslint/no-explicit-any */
-import { gql } from "graphql-request";
+import { ClientError, gql } from "graphql-request";
+import { GraphQLRequestError, TooManyNestedObjectsError, UnknownDaggerError, } from "../common/errors/index.js";
 function buildArgs(item) {
     const entries = Object.entries(item.args)
         .filter((value) => value[1] !== undefined)
@@ -35,8 +36,12 @@ function computeNestedQuery(query, client) {
                 yield Promise.all(Object.entries(q.args).map((val) => __awaiter(this, void 0, void 0, function* () {
                     if (val[1] instanceof Object && isQueryTree(val[1])) {
                         // push an id that will be used by the container
-                        val[1]["_queryTree"].push({ operation: "id" });
-                        const getQueryTree = buildQuery(val[1]["_queryTree"]);
+                        const getQueryTree = buildQuery([
+                            ...val[1]["_queryTree"],
+                            {
+                                operation: "id",
+                            },
+                        ]);
                         const result = yield compute(getQueryTree, client);
                         // eslint-disable-next-line @typescript-eslint/ban-ts-comment
                         //@ts-ignore
@@ -91,8 +96,7 @@ export function queryFlatten(response) {
     if (keys.length != 1) {
         // Dagger is currently expecting to only return one value
         // If the response is nested in a way were more than one object is nested inside throw an error
-        // TODO Throw sensible Error
-        throw new Error("Too many Graphql nested objects");
+        throw new TooManyNestedObjectsError("Too many nested objects inside graphql response", { response: response });
     }
     const nestedKey = keys[0];
     return queryFlatten(response[nestedKey]);
@@ -104,9 +108,23 @@ export function queryFlatten(response) {
  */
 export function compute(query, client) {
     return __awaiter(this, void 0, void 0, function* () {
-        const computeQuery = yield client.request(gql `
-      ${query}
-    `);
+        let computeQuery;
+        try {
+            computeQuery = yield client.request(gql `
+        ${query}
+      `);
+        }
+        catch (e) {
+            if (e instanceof ClientError) {
+                throw new GraphQLRequestError("Error message", {
+                    request: e.request,
+                    response: e.response,
+                    cause: e,
+                });
+            }
+            // Just throw the unknown error
+            throw new UnknownDaggerError("Encountered an unknown error while requesting data via graphql", { cause: e });
+        }
         return queryFlatten(computeQuery);
     });
 }

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

@@ -0,0 +1,31 @@
+export interface DaggerSDKErrorOptions {
+    cause?: Error;
+}
+/**
+ * The base error. Every other error inherits this error.
+ */
+export declare abstract class DaggerSDKError extends Error {
+    /**
+     * The name of the dagger error.
+     */
+    abstract name: string;
+    /**
+     * The dagger specific error code.
+     * Use this to identify dagger errors programmatically.
+     */
+    abstract code: string;
+    /**
+     * The original error, which caused the DaggerSDKError.
+     */
+    cause?: Error;
+    protected constructor(message: string, options?: DaggerSDKErrorOptions);
+    /**
+     * @hidden
+     */
+    get [Symbol.toStringTag](): string;
+    /**
+     * Pretty prints the error
+     */
+    printStackTrace(): void;
+}
+//# sourceMappingURL=DaggerSDKError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DaggerSDKError.d.ts","sourceRoot":"","sources":["../../../common/errors/DaggerSDKError.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED;;GAEG;AACH,8BAAsB,cAAe,SAAQ,KAAK;IAChD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAA;IAEb,SAAS,aAAa,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAKtE;;OAEG;IACH,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,WAEvB;IAED;;OAEG;IACH,eAAe;CAGhB"}

package/dist/common/errors/DaggerSDKError.js

@@ -0,0 +1,22 @@
+import { log } from "../utils.js";
+/**
+ * The base error. Every other error inherits this error.
+ */
+export class DaggerSDKError extends Error {
+    constructor(message, options) {
+        super(message);
+        this.cause = options === null || options === void 0 ? void 0 : options.cause;
+    }
+    /**
+     * @hidden
+     */
+    get [Symbol.toStringTag]() {
+        return this.name;
+    }
+    /**
+     * Pretty prints the error
+     */
+    printStackTrace() {
+        log(this.stack);
+    }
+}

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

@@ -0,0 +1,22 @@
+import { DaggerSDKError, DaggerSDKErrorOptions } from "./DaggerSDKError.js";
+interface DockerImageRefValidationErrorOptions extends DaggerSDKErrorOptions {
+    ref: string;
+}
+/**
+ *  This error is thrown if the passed image reference does not pass validation and is not compliant with the
+ *  DockerImage constructor.
+ */
+export declare class DockerImageRefValidationError extends DaggerSDKError {
+    name: string;
+    code: string;
+    /**
+     *  The docker image reference, which caused the error.
+     */
+    ref: string;
+    /**
+     *  @hidden
+     */
+    constructor(message: string, options: DockerImageRefValidationErrorOptions);
+}
+export {};
+//# sourceMappingURL=DockerImageRefValidationError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DockerImageRefValidationError.d.ts","sourceRoot":"","sources":["../../../common/errors/DockerImageRefValidationError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE3E,UAAU,oCAAqC,SAAQ,qBAAqB;IAC1E,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;GAGG;AACH,qBAAa,6BAA8B,SAAQ,cAAc;IAC/D,IAAI,SAAkC;IACtC,IAAI,SAAS;IAEb;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IAEX;;OAEG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,oCAAoC;CAI3E"}

package/dist/common/errors/DockerImageRefValidationError.js

@@ -0,0 +1,16 @@
+import { DaggerSDKError } from "./DaggerSDKError.js";
+/**
+ *  This error is thrown if the passed image reference does not pass validation and is not compliant with the
+ *  DockerImage constructor.
+ */
+export class DockerImageRefValidationError extends DaggerSDKError {
+    /**
+     *  @hidden
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = "DockerImageRefValidationError";
+        this.code = "D104";
+        this.ref = options === null || options === void 0 ? void 0 : options.ref;
+    }
+}

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

@@ -0,0 +1,25 @@
+import { DaggerSDKError, DaggerSDKErrorOptions } from "./DaggerSDKError.js";
+interface EngineSessionPortParseErrorOptions extends DaggerSDKErrorOptions {
+    parsedLine: string;
+}
+/**
+ * This error is thrown if the EngineSession does not manage to parse the required port successfully.
+ * This can happen if
+ * - Reading the port times out after 30 seconds
+ * - The parsed port is not a number
+ * - the reader does not read a single line
+ */
+export declare class EngineSessionPortParseError extends DaggerSDKError {
+    name: string;
+    code: string;
+    /**
+     *  the line, which caused the error during parsing, if the error was caused because of parsing.
+     */
+    parsedLine?: string;
+    /**
+     * @hidden
+     */
+    constructor(message: string, options?: EngineSessionPortParseErrorOptions);
+}
+export {};
+//# sourceMappingURL=EngineSessionPortParseError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EngineSessionPortParseError.d.ts","sourceRoot":"","sources":["../../../common/errors/EngineSessionPortParseError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE3E,UAAU,kCAAmC,SAAQ,qBAAqB;IACxE,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,2BAA4B,SAAQ,cAAc;IAC7D,IAAI,SAA2B;IAC/B,IAAI,SAAS;IAEb;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;OAEG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kCAAkC;CAI1E"}

package/dist/common/errors/EngineSessionPortParseError.js

@@ -0,0 +1,20 @@
+import { DaggerSDKError } from "./DaggerSDKError.js";
+/**
+ * This error is thrown if the EngineSession does not manage to parse the required port successfully.
+ * This can happen if
+ * - Reading the port times out after 30 seconds
+ * - The parsed port is not a number
+ * - the reader does not read a single line
+ */
+export class EngineSessionPortParseError extends DaggerSDKError {
+    /**
+     * @hidden
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = "EngineSessionPortError";
+        this.code = "D103";
+        if (options)
+            this.parsedLine = options.parsedLine;
+    }
+}

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

@@ -0,0 +1,27 @@
+import { GraphQLRequestContext, GraphQLResponse } from "graphql-request/dist/types";
+import { DaggerSDKError, DaggerSDKErrorOptions } from "./DaggerSDKError.js";
+interface GraphQLRequestErrorOptions extends DaggerSDKErrorOptions {
+    response: GraphQLResponse;
+    request: GraphQLRequestContext;
+}
+/**
+ *  This error originates from the dagger engine. It means that some error was thrown and sent back via GraphQL.
+ */
+export declare class GraphQLRequestError extends DaggerSDKError {
+    name: string;
+    code: string;
+    /**
+     *  The query and variables, which caused the error.
+     */
+    requestContext: GraphQLRequestContext;
+    /**
+     *  the GraphQL response containing the error.
+     */
+    response: GraphQLResponse;
+    /**
+     *  @hidden
+     */
+    constructor(message: string, options: GraphQLRequestErrorOptions);
+}
+export {};
+//# sourceMappingURL=GraphQLRequestError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GraphQLRequestError.d.ts","sourceRoot":"","sources":["../../../common/errors/GraphQLRequestError.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,eAAe,EAChB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE3E,UAAU,0BAA2B,SAAQ,qBAAqB;IAChE,QAAQ,EAAE,eAAe,CAAA;IACzB,OAAO,EAAE,qBAAqB,CAAA;CAC/B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IAC9C,IAAI,SAAwB;IAC5B,IAAI,SAAS;IAEpB;;OAEG;IACH,cAAc,EAAE,qBAAqB,CAAA;IAErC;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAA;IAEzB;;OAEG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B;CAKjE"}

package/dist/common/errors/GraphQLRequestError.js

@@ -0,0 +1,16 @@
+import { DaggerSDKError } from "./DaggerSDKError.js";
+/**
+ *  This error originates from the dagger engine. It means that some error was thrown and sent back via GraphQL.
+ */
+export class GraphQLRequestError extends DaggerSDKError {
+    /**
+     *  @hidden
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = "GraphQLRequestError";
+        this.code = "D100";
+        this.requestContext = options.request;
+        this.response = options.response;
+    }
+}

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

@@ -0,0 +1,13 @@
+import { DaggerSDKError, DaggerSDKErrorOptions } from "./DaggerSDKError.js";
+/**
+ *  This error is thrown if the dagger binary cannot be copied from the dagger docker image and copied to the local host.
+ */
+export declare class InitEngineSessionBinaryError extends DaggerSDKError {
+    name: string;
+    code: string;
+    /**
+     *  @hidden
+     */
+    constructor(message: string, options?: DaggerSDKErrorOptions);
+}
+//# sourceMappingURL=InitEngineSessionBinaryError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InitEngineSessionBinaryError.d.ts","sourceRoot":"","sources":["../../../common/errors/InitEngineSessionBinaryError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE3E;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,cAAc;IAC9D,IAAI,SAAiC;IACrC,IAAI,SAAS;IAEb;;OAEG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;CAG7D"}

package/dist/common/errors/InitEngineSessionBinaryError.js

@@ -0,0 +1,14 @@
+import { DaggerSDKError } from "./DaggerSDKError.js";
+/**
+ *  This error is thrown if the dagger binary cannot be copied from the dagger docker image and copied to the local host.
+ */
+export class InitEngineSessionBinaryError extends DaggerSDKError {
+    /**
+     *  @hidden
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = "InitEngineSessionBinaryError";
+        this.code = "D105";
+    }
+}

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

@@ -0,0 +1,21 @@
+import { DaggerSDKError, DaggerSDKErrorOptions } from "./DaggerSDKError.js";
+interface TooManyNestedObjectsErrorOptions extends DaggerSDKErrorOptions {
+    response: unknown;
+}
+/**
+ *  Dagger only expects one response value from the engine. If the engine returns more than one value this error is thrown.
+ */
+export declare class TooManyNestedObjectsError extends DaggerSDKError {
+    name: string;
+    code: string;
+    /**
+     *  the response containing more than one value.
+     */
+    response: unknown;
+    /**
+     * @hidden
+     */
+    constructor(message: string, options: TooManyNestedObjectsErrorOptions);
+}
+export {};
+//# sourceMappingURL=TooManyNestedObjectsError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TooManyNestedObjectsError.d.ts","sourceRoot":"","sources":["../../../common/errors/TooManyNestedObjectsError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE3E,UAAU,gCAAiC,SAAQ,qBAAqB;IACtE,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,cAAc;IAC3D,IAAI,SAA8B;IAClC,IAAI,SAAS;IAEb;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAA;IAEjB;;OAEG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gCAAgC;CAIvE"}

package/dist/common/errors/TooManyNestedObjectsError.js

@@ -0,0 +1,15 @@
+import { DaggerSDKError } from "./DaggerSDKError.js";
+/**
+ *  Dagger only expects one response value from the engine. If the engine returns more than one value this error is thrown.
+ */
+export class TooManyNestedObjectsError extends DaggerSDKError {
+    /**
+     * @hidden
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = "TooManyNestedObjectsError";
+        this.code = "D102";
+        this.response = options.response;
+    }
+}

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

@@ -0,0 +1,13 @@
+import { DaggerSDKError, DaggerSDKErrorOptions } from "./DaggerSDKError.js";
+/**
+ *  This error is thrown if the dagger SDK does not identify the error and just wraps the cause.
+ */
+export declare class UnknownDaggerError extends DaggerSDKError {
+    name: string;
+    code: string;
+    /**
+     * @hidden
+     */
+    constructor(message: string, options: DaggerSDKErrorOptions);
+}
+//# sourceMappingURL=UnknownDaggerError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UnknownDaggerError.d.ts","sourceRoot":"","sources":["../../../common/errors/UnknownDaggerError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAE3E;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,IAAI,SAAuB;IAC3B,IAAI,SAAS;IAEb;;OAEG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB;CAG5D"}

package/dist/common/errors/UnknownDaggerError.js

@@ -0,0 +1,14 @@
+import { DaggerSDKError } from "./DaggerSDKError.js";
+/**
+ *  This error is thrown if the dagger SDK does not identify the error and just wraps the cause.
+ */
+export class UnknownDaggerError extends DaggerSDKError {
+    /**
+     * @hidden
+     */
+    constructor(message, options) {
+        super(message, options);
+        this.name = "UnknownDaggerError";
+        this.code = "D101";
+    }
+}

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

@@ -0,0 +1,8 @@
+export { DaggerSDKError } from "./DaggerSDKError.js";
+export { UnknownDaggerError } from "./UnknownDaggerError.js";
+export { DockerImageRefValidationError } from "./DockerImageRefValidationError.js";
+export { EngineSessionPortParseError } from "./EngineSessionPortParseError.js";
+export { GraphQLRequestError } from "./GraphQLRequestError.js";
+export { InitEngineSessionBinaryError } from "./InitEngineSessionBinaryError.js";
+export { TooManyNestedObjectsError } from "./TooManyNestedObjectsError.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../common/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAA;AAClF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAA;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAA;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/common/errors/index.js

@@ -0,0 +1,7 @@
+export { DaggerSDKError } from "./DaggerSDKError.js";
+export { UnknownDaggerError } from "./UnknownDaggerError.js";
+export { DockerImageRefValidationError } from "./DockerImageRefValidationError.js";
+export { EngineSessionPortParseError } from "./EngineSessionPortParseError.js";
+export { GraphQLRequestError } from "./GraphQLRequestError.js";
+export { InitEngineSessionBinaryError } from "./InitEngineSessionBinaryError.js";
+export { TooManyNestedObjectsError } from "./TooManyNestedObjectsError.js";

package/dist/common/utils.d.ts

@@ -0,0 +1,65 @@
+export declare const log: (stack?: string) => {
+    command: string;
+    lastCommand: string;
+    level: any;
+    noColor: boolean;
+    setLevel(level: "debug" | "info" | "warn" | "error" | "disable" | "success"): void;
+    createNamedLogger(name: string): any;
+    setLevelNoColor(): void;
+    setLevelColor(): void;
+    isLevelValid(level: "debug" | "info" | "warn" | "error" | "disable" | "success"): boolean;
+    isAllowedLevel(level: "debug" | "info" | "warn" | "error" | "disable" | "success"): boolean;
+    checkSetting(setting: {
+        bold?: boolean | undefined;
+        italic?: boolean | undefined;
+        dim?: boolean | undefined;
+        underscore?: boolean | undefined;
+        reverse?: boolean | undefined;
+        strikethrough?: boolean | undefined;
+    }): string;
+    joint(): any;
+    setDate(callback: Function): void;
+    getDate(): string;
+    color(ticket: "black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white"): any;
+    bgColor(ticket: "black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white"): any;
+    bold(): any;
+    dim(): any;
+    underscore(): any;
+    strikethrough(): any;
+    reverse(): any;
+    italic(): any;
+    fontColorLog(ticket: "black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white", text: string, setting?: {
+        bold?: boolean | undefined;
+        italic?: boolean | undefined;
+        dim?: boolean | undefined;
+        underscore?: boolean | undefined;
+        reverse?: boolean | undefined;
+        strikethrough?: boolean | undefined;
+    } | undefined): void;
+    bgColorLog(ticket: "black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white", text: string, setting?: {
+        bold?: boolean | undefined;
+        italic?: boolean | undefined;
+        dim?: boolean | undefined;
+        underscore?: boolean | undefined;
+        reverse?: boolean | undefined;
+        strikethrough?: boolean | undefined;
+    } | undefined): void;
+    colorLog(ticketObj: {
+        font?: ("black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white") | undefined;
+        bg?: ("black" | "red" | "green" | "yellow" | "blue" | "magenta" | "cyan" | "white") | undefined;
+    }, text: string, setting?: {
+        bold?: boolean | undefined;
+        italic?: boolean | undefined;
+        dim?: boolean | undefined;
+        underscore?: boolean | undefined;
+        reverse?: boolean | undefined;
+        strikethrough?: boolean | undefined;
+    } | undefined): void;
+    log(...args: any[]): any;
+    error(...args: any[]): void;
+    warn(...args: any[]): void;
+    info(...args: any[]): void;
+    debug(...args: any[]): void;
+    success(...args: any[]): void;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/common/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../common/utils.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,GAAG,WAAY,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CACe,CAAA"}

package/dist/common/utils.js

@@ -0,0 +1,2 @@
+import logger from "node-color-log";
+export const log = (stack) => logger.bgColor("red").color("black").log(stack);

package/dist/connect.d.ts

@@ -9,12 +9,11 @@ export interface ConnectOpts {
     ConfigPath?: string;
     LogOutput?: Writable;
 }
-type CallbackFct = (client: Client) => Promise<void>;
+export type CallbackFct = (client: Client) => Promise<void>;
 /**
  * connect runs GraphQL server and initializes a
  * GraphQL client to execute query on it through its callback.
  * This implementation is based on the existing Go SDK.
  */
 export declare function connect(cb: CallbackFct, config?: ConnectOpts): Promise<void>;
-export {};
 //# sourceMappingURL=connect.d.ts.map

package/dist/connect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../connect.ts"],"names":[],"mappings":";AAAA,OAAO,MAAM,MAAM,qBAAqB,CAAA;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,QAAQ,CAAA;CACrB;AAED,KAAK,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAEpD;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,EAAE,EAAE,WAAW,EACf,MAAM,GAAE,WAAgB,GACvB,OAAO,CAAC,IAAI,CAAC,CAgBf"}
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../connect.ts"],"names":[],"mappings":";AAAA,OAAO,MAAM,MAAM,qBAAqB,CAAA;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,QAAQ,CAAA;CACrB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAE3D;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,EAAE,EAAE,WAAW,EACf,MAAM,GAAE,WAAgB,GACvB,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import Client from "./api/client.gen.js";
 export { gql } from "graphql-tag";
 export { GraphQLClient } from "graphql-request";
-export { connect, ConnectOpts } from "./connect.js";
+export { connect, ConnectOpts, CallbackFct } from "./connect.js";
 export { getProvisioner } from "./provisioning/index.js";
 export default Client;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,qBAAqB,CAAA;AAExC,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAExD,eAAe,MAAM,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,qBAAqB,CAAA;AAExC,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAExD,eAAe,MAAM,CAAA"}

package/dist/provisioning/bin/bin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../../provisioning/bin/bin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAG1D,OAAO,MAAM,MAAM,yBAAyB,CAAA;AAE5C;;GAEG;AACH,qBAAa,GAAI,YAAW,UAAU;IACpC,OAAO,CAAC,UAAU,CAAC,CAAmB;IAEtC,OAAO,CAAC,IAAI,CAAQ;gBAER,CAAC,EAAE,GAAG;IAQlB,IAAI,IAAI,MAAM;IAIR,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjD;;;;OAIG;YACW,gBAAgB;YAqChB,QAAQ;IAShB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../../provisioning/bin/bin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAG1D,OAAO,MAAM,MAAM,yBAAyB,CAAA;AAG5C;;GAEG;AACH,qBAAa,GAAI,YAAW,UAAU;IACpC,OAAO,CAAC,UAAU,CAAC,CAAmB;IAEtC,OAAO,CAAC,IAAI,CAAQ;gBAER,CAAC,EAAE,GAAG;IAQlB,IAAI,IAAI,MAAM;IAIR,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAIjD;;;;OAIG;YACW,gBAAgB;YAyChB,QAAQ;IAiBhB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/dist/provisioning/bin/bin.js

@@ -17,6 +17,7 @@ var __asyncValues = (this && this.__asyncValues) || function (o) {
 import readline from "readline";
 import { execaCommand } from "execa";
 import Client from "../../api/client.gen.js";
+import { EngineSessionPortParseError } from "../../common/errors/index.js";
 /**
  * Bin runs an engine session from a specified binary
  */
@@ -63,7 +64,7 @@ export class Bin {
                 this.readPort(stdoutReader),
                 new Promise((_, reject) => {
                     setTimeout(() => {
-                        reject(new Error("timeout reading port from engine session"));
+                        reject(new EngineSessionPortParseError("timeout reading port from engine session"));
                     }, 300000).unref(); // long timeout to account for extensions, though that should be optimized in future
                 }),
             ]);
@@ -82,6 +83,9 @@ export class Bin {
                         const line = _d;
                         // Read line as a port number
                         const port = parseInt(line);
+                        if (isNaN(port)) {
+                            throw new EngineSessionPortParseError(`failed to parse port from engine session while parsing: ${line}`, { parsedLine: line });
+                        }
                         return port;
                     }
                     finally {
@@ -96,7 +100,7 @@ export class Bin {
                 }
                 finally { if (e_1) throw e_1.error; }
             }
-            throw new Error("failed to read port from engine session");
+            throw new EngineSessionPortParseError("No line was found to parse the engine port");
         });
     }
     Close() {

package/dist/provisioning/docker-provision/image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../../provisioning/docker-provision/image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAM1D,OAAO,MAAM,MAAM,yBAAyB,CAAA;AAqD5C;;;GAGG;AACH,qBAAa,WAAY,YAAW,UAAU;IAC5C,OAAO,CAAC,QAAQ,CAAU;IAE1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAGxB;IAED,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAA0B;IAEvE,OAAO,CAAC,UAAU,CAAC,CAAmB;gBAE1B,CAAC,EAAE,GAAG;IAIlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB,IAAI,IAAI,MAAM;IAIR,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAWjD;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAItB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IA+D5B;;;OAGG;YACW,gBAAgB;YA4ChB,QAAQ;IAShB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../../provisioning/docker-provision/image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAM1D,OAAO,MAAM,MAAM,yBAAyB,CAAA;AA4D5C;;;GAGG;AACH,qBAAa,WAAY,YAAW,UAAU;IAC5C,OAAO,CAAC,QAAQ,CAAU;IAE1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAGxB;IAED,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAA0B;IAEvE,OAAO,CAAC,UAAU,CAAC,CAAmB;gBAE1B,CAAC,EAAE,GAAG;IAIlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB,IAAI,IAAI,MAAM;IAIR,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAWjD;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAItB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAiE5B;;;OAGG;YACW,gBAAgB;YAgDhB,QAAQ;IAiBhB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/dist/provisioning/docker-provision/image.js

@@ -20,6 +20,7 @@ import * as os from "os";
 import readline from "readline";
 import { execaCommandSync, execaCommand } from "execa";
 import Client from "../../api/client.gen.js";
+import { DockerImageRefValidationError, EngineSessionPortParseError, InitEngineSessionBinaryError, } from "../../common/errors/index.js";
 /**
  * ImageRef is a simple abstraction of docker image reference.
  */
@@ -52,7 +53,9 @@ class ImageRef {
      */
     static validate(ref) {
         if (!ref.includes("@sha256:")) {
-            throw new Error(`no digest found in ref ${ref}`);
+            throw new DockerImageRefValidationError(`no digest found in ref ${ref}`, {
+                ref: ref,
+            });
         }
     }
 }
@@ -168,7 +171,7 @@ export class DockerImage {
         }
         catch (e) {
             fs.rmSync(tmpBinPath);
-            throw new Error(`failed to copy engine session binary: ${e}`);
+            throw new InitEngineSessionBinaryError(`failed to copy engine session binary: ${e}`, { cause: e });
         }
         // Remove all temporary binary files
         // Ignore current engine session binary or other files that have not be
@@ -220,7 +223,7 @@ export class DockerImage {
                 this.readPort(stdoutReader),
                 new Promise((_, reject) => {
                     setTimeout(() => {
-                        reject(new Error("timeout reading port from engine session"));
+                        reject(new EngineSessionPortParseError("timeout reading port from engine session"));
                     }, 300000).unref(); // long timeout to account for extensions, though that should be optimized in future
                 }),
             ]);
@@ -239,6 +242,9 @@ export class DockerImage {
                         const line = _d;
                         // Read line as a port number
                         const port = parseInt(line);
+                        if (isNaN(port)) {
+                            throw new EngineSessionPortParseError(`failed to parse port from engine session while parsing: ${line}`, { parsedLine: line });
+                        }
                         return port;
                     }
                     finally {
@@ -253,7 +259,7 @@ export class DockerImage {
                 }
                 finally { if (e_1) throw e_1.error; }
             }
-            throw new Error("failed to read port from engine session");
+            throw new EngineSessionPortParseError("No line was found to parse the engine port");
         });
     }
     Close() {