@c9up/ream 0.1.25 → 0.1.27

package/dist/env/Env.js

@@ -1,3 +1,4 @@
+import { defineIdentifier, defineIdentifierIfMissing, removeIdentifier, } from './interpolate.js';
 import { loadEnvFiles } from './loadEnvFiles.js';
 import { schema } from './schema.js';
 /** Raised when one or more environment variables fail validation. */
@@ -13,6 +14,18 @@ export class EnvValidationException extends Error {
 export class Env {
     /** The validation schema surface — `Env.schema.string()`, `.number()`, … */
     static schema = schema;
+    /** Register an interpolation identifier (AdonisJS `Env.defineIdentifier`). */
+    static defineIdentifier(name, resolver) {
+        defineIdentifier(name, resolver);
+    }
+    /** Register an identifier only if the name is free (AdonisJS `defineIdentifierIfMissing`). */
+    static defineIdentifierIfMissing(name, resolver) {
+        defineIdentifierIfMissing(name, resolver);
+    }
+    /** Remove a registered interpolation identifier (AdonisJS `Env.removeIdentifier`). */
+    static removeIdentifier(name) {
+        removeIdentifier(name);
+    }
     #values;
     constructor(values) {
         this.#values = values;
@@ -43,10 +56,20 @@ export class Env {
         return new Env(collected);
     }
     get(key, fallback) {
-        const value = this.#values[key];
-        if (value === undefined && fallback !== undefined)
-            return fallback;
-        return value;
+        const cached = this.#values[key];
+        if (cached !== undefined)
+            return cached;
+        // Fallback to raw process.env for keys outside the validated schema.
+        const fromEnv = process.env[key];
+        if (fromEnv !== undefined && fromEnv !== '')
+            return fromEnv;
+        return fallback;
+    }
+    set(key, value) {
+        // Reflect.set writes to the generic-typed cache without a cast (a direct
+        // `this.#values[key] = value` is rejected: a generic type is read-only-indexed).
+        Reflect.set(this.#values, key, value);
+        process.env[key] = String(value);
     }
 }
 //# sourceMappingURL=Env.js.map

package/dist/env/Env.js.map

@@ -1 +1 @@
-{"version":3,"file":"Env.js","sourceRoot":"","sources":["../../src/env/Env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAmB,MAAM,EAAE,MAAM,aAAa,CAAA;AA+BrD,qEAAqE;AACrE,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,sFAAsF;IAC7E,IAAI,CAAQ;IACrB,YAAY,QAAkB;QAC5B,KAAK,CAAC,yCAAyC,CAAC,CAAA;QAChD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;QACrC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;CACF;AAED,MAAM,OAAO,GAAG;IACd,4EAA4E;IAC5E,MAAM,CAAU,MAAM,GAAG,MAAM,CAAA;IAEtB,OAAO,CAAQ;IAExB,YAAoB,MAAc;QAChC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;IACvB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,OAAY,EACZ,MAAS;QAET,YAAY,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC,CAAA;QAExE,MAAM,QAAQ,GAAa,EAAE,CAAA;QAC7B,MAAM,SAAS,GAA4B,EAAE,CAAA;QAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;YAC9D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;YACjE,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,sBAAsB,CAAC,QAAQ,CAAC,CAAA;QAEnE,6EAA6E;QAC7E,0EAA0E;QAC1E,2EAA2E;QAC3E,+EAA+E;QAC/E,OAAO,IAAI,GAAG,CAAC,SAAyB,CAAC,CAAA;IAC3C,CAAC;IAKD,GAAG,CAAyB,GAAM,EAAE,QAAoB;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAA;QAClE,OAAO,KAAK,CAAA;IACd,CAAC"}
+{"version":3,"file":"Env.js","sourceRoot":"","sources":["../../src/env/Env.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EAEzB,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAmB,MAAM,EAAE,MAAM,aAAa,CAAA;AA+BrD,qEAAqE;AACrE,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,sFAAsF;IAC7E,IAAI,CAAQ;IACrB,YAAY,QAAkB;QAC5B,KAAK,CAAC,yCAAyC,CAAC,CAAA;QAChD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;QACrC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;CACF;AAED,MAAM,OAAO,GAAG;IACd,4EAA4E;IAC5E,MAAM,CAAU,MAAM,GAAG,MAAM,CAAA;IAE/B,8EAA8E;IAC9E,MAAM,CAAC,gBAAgB,CAAC,IAAY,EAAE,QAA4B;QAChE,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAClC,CAAC;IAED,8FAA8F;IAC9F,MAAM,CAAC,yBAAyB,CAAC,IAAY,EAAE,QAA4B;QACzE,yBAAyB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC3C,CAAC;IAED,sFAAsF;IACtF,MAAM,CAAC,gBAAgB,CAAC,IAAY;QAClC,gBAAgB,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC;IAEQ,OAAO,CAAQ;IAExB,YAAoB,MAAc;QAChC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;IACvB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,OAAY,EACZ,MAAS;QAET,YAAY,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC,CAAA;QAExE,MAAM,QAAQ,GAAa,EAAE,CAAA;QAC7B,MAAM,SAAS,GAA4B,EAAE,CAAA;QAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;YAC9D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;YACjE,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,sBAAsB,CAAC,QAAQ,CAAC,CAAA;QAEnE,6EAA6E;QAC7E,0EAA0E;QAC1E,2EAA2E;QAC3E,+EAA+E;QAC/E,OAAO,IAAI,GAAG,CAAC,SAAyB,CAAC,CAAA;IAC3C,CAAC;IAYD,GAAG,CAAC,GAAW,EAAE,QAAkB;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAA;QACvC,qEAAqE;QACrE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,EAAE;YAAE,OAAO,OAAO,CAAA;QAC3D,OAAO,QAAQ,CAAA;IACjB,CAAC;IAQD,GAAG,CAAC,GAAW,EAAE,KAAc;QAC7B,yEAAyE;QACzE,iFAAiF;QACjF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;QACrC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC"}

package/dist/env/Secret.d.ts

@@ -0,0 +1,11 @@
+export declare class Secret<T> {
+    #private;
+    constructor(value: T, redactedKeyword?: string);
+    /** Redacted placeholder (so `JSON.stringify` never emits the secret). */
+    toJSON(): string;
+    /** Redacted placeholder for string coercion + template literals. */
+    toString(): string;
+    /** Release the underlying value — the one deliberate way to read the secret. */
+    release(): T;
+}
+//# sourceMappingURL=Secret.d.ts.map

package/dist/env/Secret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Secret.d.ts","sourceRoot":"","sources":["../../src/env/Secret.ts"],"names":[],"mappings":"AAYA,qBAAa,MAAM,CAAC,CAAC;;gBAIP,KAAK,EAAE,CAAC,EAAE,eAAe,GAAE,MAAiB;IAKxD,yEAAyE;IACzE,MAAM,IAAI,MAAM;IAIhB,oEAAoE;IACpE,QAAQ,IAAI,MAAM;IASlB,gFAAgF;IAChF,OAAO,IAAI,CAAC;CAGb"}

package/dist/env/Secret.js

@@ -0,0 +1,36 @@
+/**
+ * Secret — wraps a sensitive value so it never leaks through logs, JSON, or
+ * `util.inspect`. Mirrors `@poppinss/utils`'s `Secret` (zero-dep here). Read the
+ * underlying value explicitly with {@link release}.
+ *
+ *   const key = env.get('APP_KEY')   // Secret<string> when declared via schema.secret
+ *   key.toString()   // '[redacted]'
+ *   JSON.stringify({ key })          // '{"key":"[redacted]"}'
+ *   key.release()    // the real value — only when you deliberately need it
+ */
+const REDACTED = '[redacted]';
+export class Secret {
+    #value;
+    #keyword;
+    constructor(value, redactedKeyword = REDACTED) {
+        this.#value = value;
+        this.#keyword = redactedKeyword;
+    }
+    /** Redacted placeholder (so `JSON.stringify` never emits the secret). */
+    toJSON() {
+        return this.#keyword;
+    }
+    /** Redacted placeholder for string coercion + template literals. */
+    toString() {
+        return this.#keyword;
+    }
+    /** Redacted placeholder for `console.log` / `util.inspect`. */
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return this.#keyword;
+    }
+    /** Release the underlying value — the one deliberate way to read the secret. */
+    release() {
+        return this.#value;
+    }
+}
+//# sourceMappingURL=Secret.js.map

package/dist/env/Secret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Secret.js","sourceRoot":"","sources":["../../src/env/Secret.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,QAAQ,GAAG,YAAY,CAAA;AAE7B,MAAM,OAAO,MAAM;IACR,MAAM,CAAG;IACT,QAAQ,CAAQ;IAEzB,YAAY,KAAQ,EAAE,kBAA0B,QAAQ;QACtD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAA;IACjC,CAAC;IAED,yEAAyE;IACzE,MAAM;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED,oEAAoE;IACpE,QAAQ;QACN,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED,+DAA+D;IAC/D,CAAC,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED,gFAAgF;IAChF,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;CACF"}

package/dist/env/interpolate.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Env value interpolation — AdonisJS-style variable substitution + identifiers,
+ * applied by {@link loadEnvFiles} as each `.env` value is loaded.
+ *
+ * - `$VAR` / `${VAR}` are replaced with the value of `VAR` (looked up against
+ *   the values already loaded + `process.env`). A missing reference expands to
+ *   an empty string. `\$` is a literal dollar sign (escape).
+ * - `identifier:rest` — when `identifier` was registered via
+ *   {@link defineIdentifier}, the registered callback transforms `rest`
+ *   (e.g. a `base64:` decoder). Unregistered prefixes (like `postgres://…`)
+ *   are left untouched.
+ */
+/** Transform the remainder of an `identifier:rest` value into its final form. */
+export type IdentifierResolver = (value: string) => string;
+/** Register an identifier resolver (AdonisJS `Env.defineIdentifier`). */
+export declare function defineIdentifier(name: string, resolver: IdentifierResolver): void;
+/** Register an identifier resolver only if the name is free (AdonisJS `defineIdentifierIfMissing`). */
+export declare function defineIdentifierIfMissing(name: string, resolver: IdentifierResolver): void;
+/** Remove a registered identifier (AdonisJS `Env.removeIdentifier`). */
+export declare function removeIdentifier(name: string): void;
+/**
+ * Expand `$VAR` / `${VAR}` references and apply an identifier prefix. `lookup`
+ * resolves a referenced variable name to its current value (or undefined).
+ */
+export declare function interpolate(value: string, lookup: (name: string) => string | undefined): string;
+//# sourceMappingURL=interpolate.d.ts.map

package/dist/env/interpolate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.d.ts","sourceRoot":"","sources":["../../src/env/interpolate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,iFAAiF;AACjF,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;AAI1D,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAEjF;AAED,uGAAuG;AACvG,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAE1F;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEnD;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,MAAM,CAc/F"}

package/dist/env/interpolate.js

@@ -0,0 +1,48 @@
+/**
+ * Env value interpolation — AdonisJS-style variable substitution + identifiers,
+ * applied by {@link loadEnvFiles} as each `.env` value is loaded.
+ *
+ * - `$VAR` / `${VAR}` are replaced with the value of `VAR` (looked up against
+ *   the values already loaded + `process.env`). A missing reference expands to
+ *   an empty string. `\$` is a literal dollar sign (escape).
+ * - `identifier:rest` — when `identifier` was registered via
+ *   {@link defineIdentifier}, the registered callback transforms `rest`
+ *   (e.g. a `base64:` decoder). Unregistered prefixes (like `postgres://…`)
+ *   are left untouched.
+ */
+const identifiers = new Map();
+/** Register an identifier resolver (AdonisJS `Env.defineIdentifier`). */
+export function defineIdentifier(name, resolver) {
+    identifiers.set(name, resolver);
+}
+/** Register an identifier resolver only if the name is free (AdonisJS `defineIdentifierIfMissing`). */
+export function defineIdentifierIfMissing(name, resolver) {
+    if (!identifiers.has(name))
+        identifiers.set(name, resolver);
+}
+/** Remove a registered identifier (AdonisJS `Env.removeIdentifier`). */
+export function removeIdentifier(name) {
+    identifiers.delete(name);
+}
+const REFERENCE = /(\\)?\$(?:\{([^}]+)\}|([A-Za-z_][A-Za-z0-9_]*))/g;
+/**
+ * Expand `$VAR` / `${VAR}` references and apply an identifier prefix. `lookup`
+ * resolves a referenced variable name to its current value (or undefined).
+ */
+export function interpolate(value, lookup) {
+    const substituted = value.replace(REFERENCE, (full, escaped, braced, bare) => {
+        // `\$FOO` → literal `$FOO` (drop only the escaping backslash).
+        if (escaped)
+            return full.slice(1);
+        const name = braced ?? bare;
+        return lookup(name) ?? '';
+    });
+    const prefixed = /^([A-Za-z_][A-Za-z0-9_]*):([\s\S]*)$/.exec(substituted);
+    if (prefixed) {
+        const resolver = identifiers.get(prefixed[1]);
+        if (resolver)
+            return resolver(prefixed[2]);
+    }
+    return substituted;
+}
+//# sourceMappingURL=interpolate.js.map

package/dist/env/interpolate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.js","sourceRoot":"","sources":["../../src/env/interpolate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,MAAM,WAAW,GAAG,IAAI,GAAG,EAA8B,CAAA;AAEzD,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAA4B;IACzE,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AACjC,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,yBAAyB,CAAC,IAAY,EAAE,QAA4B;IAClF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AAC7D,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC;AAED,MAAM,SAAS,GAAG,kDAAkD,CAAA;AAEpE;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,MAA4C;IACrF,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAC3E,+DAA+D;QAC/D,IAAI,OAAO;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QACjC,MAAM,IAAI,GAAG,MAAM,IAAI,IAAI,CAAA;QAC3B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,CAAC,CAAC,CAAA;IAEF,MAAM,QAAQ,GAAG,sCAAsC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IACzE,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;QAC7C,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5C,CAAC;IACD,OAAO,WAAW,CAAA;AACpB,CAAC"}

package/dist/env/loadEnvFiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadEnvFiles.d.ts","sourceRoot":"","sources":["../../src/env/loadEnvFiles.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,IAAI,CAsBzF"}
+{"version":3,"file":"loadEnvFiles.d.ts","sourceRoot":"","sources":["../../src/env/loadEnvFiles.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,IAAI,CA6BzF"}

package/dist/env/loadEnvFiles.js

@@ -1,6 +1,7 @@
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { parseEnv } from 'node:util';
+import { interpolate } from './interpolate.js';
 /**
  * Load `.env` files into `process.env` — the shared primitive behind both the
  * Ignitor (HTTP/console boot) and `Env.create()` (config/test flow), mirroring
@@ -30,10 +31,19 @@ export function loadEnvFiles(appRoot, options = {}) {
         catch {
             continue; // file absent — nothing to load
         }
-        for (const [key, value] of Object.entries(parseEnv(contents))) {
-            if (typeof value === 'string' && process.env[key] === undefined) {
-                process.env[key] = value;
-            }
+        const parsed = parseEnv(contents);
+        for (const [key, value] of Object.entries(parsed)) {
+            if (typeof value !== 'string' || process.env[key] !== undefined)
+                continue;
+            // Interpolate `$VAR`/`${VAR}` against process.env then this file's own
+            // (already-loaded) values, and apply any `identifier:` resolver.
+            process.env[key] = interpolate(value, (name) => {
+                const fromProcess = process.env[name];
+                if (fromProcess !== undefined)
+                    return fromProcess;
+                const fromFile = parsed[name];
+                return typeof fromFile === 'string' ? fromFile : undefined;
+            });
         }
     }
 }

package/dist/env/loadEnvFiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"loadEnvFiles.js","sourceRoot":"","sources":["../../src/env/loadEnvFiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,OAAY,EAAE,UAAsC,EAAE;IACjF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAA;IACpC,MAAM,KAAK,GAAG;QACZ,OAAO,CAAC,CAAC,CAAC,QAAQ,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI;QACxC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY;QAC1C,OAAO,CAAC,CAAC,CAAC,QAAQ,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI;QAClC,MAAM;KACP,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;IAEjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,QAAgB,CAAA;QACpB,IAAI,CAAC;YACH,QAAQ,GAAG,YAAY,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;QACxE,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ,CAAC,gCAAgC;QAC3C,CAAC;QACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;gBAChE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"loadEnvFiles.js","sourceRoot":"","sources":["../../src/env/loadEnvFiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,OAAY,EAAE,UAAsC,EAAE;IACjF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAA;IACpC,MAAM,KAAK,GAAG;QACZ,OAAO,CAAC,CAAC,CAAC,QAAQ,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI;QACxC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY;QAC1C,OAAO,CAAC,CAAC,CAAC,QAAQ,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI;QAClC,MAAM;KACP,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;IAEjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,QAAgB,CAAA;QACpB,IAAI,CAAC;YACH,QAAQ,GAAG,YAAY,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;QACxE,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ,CAAC,gCAAgC;QAC3C,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;gBAAE,SAAQ;YACzE,uEAAuE;YACvE,iEAAiE;YACjE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;gBAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBACrC,IAAI,WAAW,KAAK,SAAS;oBAAE,OAAO,WAAW,CAAA;gBACjD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAA;gBAC7B,OAAO,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAA;YAC5D,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/env/schema.d.ts

@@ -12,6 +12,7 @@
  * value (or throws {@link EnvVarError}); `.optional()` accepts an absent/empty
  * value as `undefined`.
  */
+import { Secret } from './Secret.js';
 /** A single failed-variable validation — collected by `Env.create`. */
 export declare class EnvVarError extends Error {
     constructor(message: string);
@@ -20,29 +21,45 @@ export declare class EnvVarError extends Error {
 export interface SchemaNode<T> {
     validate(name: string, value: string | undefined): T;
 }
-/** A required node that can be turned optional — `.optional()` widens `T` to `T | undefined`. */
+/** Condition deciding whether a variable is optional (AdonisJS `optionalWhen`). */
+export type OptionalCondition = boolean | ((name: string, value: string | undefined) => boolean);
+/**
+ * A required node that can be turned optional — `.optional()` widens `T` to
+ * `T | undefined`; `.optionalWhen(cond)` does so only when `cond` holds.
+ */
 export interface RequiredNode<T> extends SchemaNode<T> {
     optional(): SchemaNode<T | undefined>;
+    optionalWhen(condition: OptionalCondition): SchemaNode<T | undefined>;
 }
-export interface StringOptions {
+/** Options common to every schema function (AdonisJS `SchemaFnOptions`). */
+export interface SchemaFnOptions {
+    /** Custom error message, replacing the default when validation fails. */
+    message?: string;
+}
+export interface StringOptions extends SchemaFnOptions {
     /** Validate the string against a known format. */
-    format?: 'host' | 'url' | 'email';
+    format?: 'host' | 'url' | 'email' | 'uuid';
     /** For `format: 'url'` — require a TLD (default true). */
     tld?: boolean;
     /** For `format: 'url'` — require a protocol (default true). */
     protocol?: boolean;
 }
-declare function number(): RequiredNode<number>;
-declare function boolean(): RequiredNode<boolean>;
-declare function enumNode<V extends readonly string[]>(values: V): RequiredNode<V[number]>;
+declare function number(options?: SchemaFnOptions): RequiredNode<number>;
+declare function boolean(options?: SchemaFnOptions): RequiredNode<boolean>;
+declare function enumNode<V extends readonly string[]>(values: V, options?: SchemaFnOptions): RequiredNode<V[number]>;
 /** The `Env.schema` surface. */
 export declare const schema: {
     string: ((options?: StringOptions) => RequiredNode<string>) & {
         optional(options?: StringOptions): SchemaNode<string | undefined>;
+        optionalWhen(condition: OptionalCondition, options?: StringOptions): SchemaNode<string | undefined>;
     };
     number: typeof number;
     boolean: typeof boolean;
     enum: typeof enumNode;
+    secret: ((options?: SchemaFnOptions) => RequiredNode<Secret<string>>) & {
+        optional(options?: SchemaFnOptions): SchemaNode<Secret<string> | undefined>;
+        optionalWhen(condition: OptionalCondition, options?: SchemaFnOptions): SchemaNode<Secret<string> | undefined>;
+    };
 };
 export {};
 //# sourceMappingURL=schema.d.ts.map

package/dist/env/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/env/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,uEAAuE;AACvE,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,CAAC,CAAA;CACrD;AAED,iGAAiG;AACjG,MAAM,WAAW,YAAY,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IACpD,QAAQ,IAAI,UAAU,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAA;IACjC,0DAA0D;IAC1D,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAoFD,iBAAS,MAAM,IAAI,YAAY,CAAC,MAAM,CAAC,CAQtC;AAED,iBAAS,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAQxC;AAED,iBAAS,QAAQ,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAUjF;AAED,gCAAgC;AAChC,eAAO,MAAM,MAAM;wBAvCO,aAAa,KAAK,YAAY,CAAC,MAAM,CAAC;2BAC3C,aAAa,GAAG,UAAU,CAAC,MAAM,GAAG,SAAS,CAAC;;;;;CA2ClE,CAAA"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/env/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,uEAAuE;AACvE,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,CAAC,CAAA;CACrD;AAED,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,CAAA;AAEhG;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,CAAE,SAAQ,UAAU,CAAC,CAAC,CAAC;IACpD,QAAQ,IAAI,UAAU,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IACrC,YAAY,CAAC,SAAS,EAAE,iBAAiB,GAAG,UAAU,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;CACtE;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAA;IAC1C,0DAA0D;IAC1D,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAuHD,iBAAS,MAAM,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,YAAY,CAAC,MAAM,CAAC,CAE/D;AAaD,iBAAS,OAAO,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,YAAY,CAAC,OAAO,CAAC,CAEjE;AAED,iBAAS,QAAQ,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EAC3C,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,eAAe,GACxB,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAWzB;AAsBD,gCAAgC;AAChC,eAAO,MAAM,MAAM;wBAjFO,aAAa,KAAK,YAAY,CAAC,MAAM,CAAC;2BAC3C,aAAa,GAAG,UAAU,CAAC,MAAM,GAAG,SAAS,CAAC;gCAEpD,iBAAiB,YAClB,aAAa,GACtB,UAAU,CAAC,MAAM,GAAG,SAAS,CAAC;;;;;wBA2DT,eAAe,KAAK,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;2BACrD,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;gCAE9D,iBAAiB,YAClB,eAAe,GACxB,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;;CAkB1C,CAAA"}

package/dist/env/schema.js

@@ -12,6 +12,7 @@
  * value (or throws {@link EnvVarError}); `.optional()` accepts an absent/empty
  * value as `undefined`.
  */
+import { Secret } from './Secret.js';
 /** A single failed-variable validation — collected by `Env.create`. */
 export class EnvVarError extends Error {
     constructor(message) {
@@ -23,25 +24,31 @@ const TRUE_VALUES = new Set(['true', '1']);
 const FALSE_VALUES = new Set(['false', '0']);
 /**
  * Build a node from a `parse` that only ever sees a present, non-empty string.
- * Required `validate` throws on absent/empty; `.optional()` returns `undefined`.
+ * Required `validate` throws on absent/empty (using `message` when given);
+ * `.optional()` returns `undefined`; `.optionalWhen(cond)` is optional only
+ * when the condition holds.
  */
-function makeNode(parse) {
+function makeNode(parse, message) {
+    const required = (name, value) => {
+        if (value === undefined || value === '') {
+            throw new EnvVarError(message ?? `Missing required environment variable "${name}"`);
+        }
+        return parse(name, value);
+    };
+    const optional = (name, value) => {
+        if (value === undefined || value === '')
+            return undefined;
+        return parse(name, value);
+    };
     return {
-        validate(name, value) {
-            if (value === undefined || value === '') {
-                throw new EnvVarError(`Missing required environment variable "${name}"`);
-            }
-            return parse(name, value);
-        },
-        optional() {
-            return {
-                validate(name, value) {
-                    if (value === undefined || value === '')
-                        return undefined;
-                    return parse(name, value);
-                },
-            };
-        },
+        validate: required,
+        optional: () => ({ validate: optional }),
+        optionalWhen: (condition) => ({
+            validate(name, value) {
+                const skip = typeof condition === 'function' ? condition(name, value) : condition;
+                return skip ? optional(name, value) : required(name, value);
+            },
+        }),
     };
 }
 function isHost(value) {
@@ -71,6 +78,9 @@ function isUrl(value, options) {
 function isEmail(value) {
     return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);
 }
+function isUuid(value) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value);
+}
 function checkFormat(name, value, options) {
     if (!options?.format)
         return;
@@ -78,9 +88,12 @@ function checkFormat(name, value, options) {
         ? isHost(value)
         : options.format === 'url'
             ? isUrl(value, options)
-            : isEmail(value);
+            : options.format === 'uuid'
+                ? isUuid(value)
+                : isEmail(value);
     if (!ok) {
-        throw new EnvVarError(`Environment variable "${name}" must be a valid ${options.format}, got "${value}"`);
+        throw new EnvVarError(options.message ??
+            `Environment variable "${name}" must be a valid ${options.format}, got "${value}"`);
     }
 }
 function stringParse(options) {
@@ -89,42 +102,63 @@ function stringParse(options) {
         return raw;
     };
 }
-/** `string(opts?)` is callable AND exposes `.optional(opts?)` — both Adonis forms. */
-const string = Object.assign((options) => makeNode(stringParse(options)), {
-    optional: (options) => makeNode(stringParse(options)).optional(),
+/**
+ * `string(opts?)` is callable AND exposes `.optional(opts?)` / `.optionalWhen()`
+ * shortcuts — all AdonisJS forms.
+ */
+const string = Object.assign((options) => makeNode(stringParse(options), options?.message), {
+    optional: (options) => makeNode(stringParse(options), options?.message).optional(),
+    optionalWhen: (condition, options) => makeNode(stringParse(options), options?.message).optionalWhen(condition),
 });
-function number() {
-    return makeNode((name, raw) => {
+function numberParse(options) {
+    return (name, raw) => {
         const parsed = Number(raw);
         if (Number.isNaN(parsed)) {
-            throw new EnvVarError(`Environment variable "${name}" must be a number, got "${raw}"`);
+            throw new EnvVarError(options?.message ?? `Environment variable "${name}" must be a number, got "${raw}"`);
         }
         return parsed;
-    });
+    };
 }
-function boolean() {
-    return makeNode((name, raw) => {
+function number(options) {
+    return makeNode(numberParse(options), options?.message);
+}
+function booleanParse(options) {
+    return (name, raw) => {
         if (TRUE_VALUES.has(raw))
             return true;
         if (FALSE_VALUES.has(raw))
             return false;
-        throw new EnvVarError(`Environment variable "${name}" must be a boolean (true/false/1/0), got "${raw}"`);
-    });
+        throw new EnvVarError(options?.message ??
+            `Environment variable "${name}" must be a boolean (true/false/1/0), got "${raw}"`);
+    };
 }
-function enumNode(values) {
+function boolean(options) {
+    return makeNode(booleanParse(options), options?.message);
+}
+function enumNode(values, options) {
     return makeNode((name, raw) => {
         const match = values.find((candidate) => candidate === raw);
         if (match === undefined) {
-            throw new EnvVarError(`Environment variable "${name}" must be one of [${values.join(', ')}], got "${raw}"`);
+            throw new EnvVarError(options?.message ??
+                `Environment variable "${name}" must be one of [${values.join(', ')}], got "${raw}"`);
         }
         return match;
-    });
+    }, options?.message);
 }
+/**
+ * `secret(opts?)` wraps the value in a {@link Secret} so it never leaks through
+ * logs/JSON (AdonisJS `Env.schema.secret`). Read it with `.release()`.
+ */
+const secret = Object.assign((options) => makeNode((_name, raw) => new Secret(raw), options?.message), {
+    optional: (options) => makeNode((_name, raw) => new Secret(raw), options?.message).optional(),
+    optionalWhen: (condition, options) => makeNode((_name, raw) => new Secret(raw), options?.message).optionalWhen(condition),
+});
 /** The `Env.schema` surface. */
 export const schema = {
     string,
     number,
     boolean,
     enum: enumNode,
+    secret,
 };
 //# sourceMappingURL=schema.js.map

package/dist/env/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/env/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/env/schema.ts"],"names":[],"mappings":"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"}

package/dist/errors/ReamError.d.ts

@@ -6,6 +6,31 @@
  *
  * @implements FR71, FR72, FR73, FR77
  */
+/**
+ * Is this a Ream error, and one of these codes?
+ *
+ * The framework carries ONE error type with a `code`, because an error can be
+ * raised in Rust and rebuilt in TypeScript across the NAPI boundary — see
+ * {@link ReamError.fromNapi}. A class per code cannot cross that line, so the
+ * check that replaces `instanceof MyError` is this one.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await consoleApp.exec('provision')
+ * } catch (error) {
+ *   if (isReamError(error, 'E_CONSOLE_MISSING_FLAG', 'E_CONSOLE_MISSING_ARGUMENT')) {
+ *     console.error(error.hint)   // narrowed: `error` IS a ReamError here
+ *     return
+ *   }
+ *   throw error
+ * }
+ * ```
+ */
+export declare function isReamError(error: unknown): error is ReamError;
+export declare function isReamError<const Code extends string>(error: unknown, ...codes: [Code, ...Code[]]): error is ReamError & {
+    code: Code;
+};
 export declare class ReamError extends Error {
     /** Error code (e.g., "ATLAS_QUERY_ERROR", "CONTAINER_NOT_FOUND") */
     readonly code: string;

package/dist/errors/ReamError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReamError.d.ts","sourceRoot":"","sources":["../../src/errors/ReamError.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,SAAU,SAAQ,KAAK;IAClC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAExC,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IAEtB,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAE5B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAE5B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IAEzB,8DAA8D;IAC9D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;gBAG7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB;IAaH;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS;IAoBxC;;OAEG;IACH,WAAW,IAAI,MAAM;IA2CrB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,iBAAiB,IAAI,MAAM;CAG5B"}
+{"version":3,"file":"ReamError.d.ts","sourceRoot":"","sources":["../../src/errors/ReamError.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAAA;AAC/D,wBAAgB,WAAW,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,EACnD,KAAK,EAAE,OAAO,EACd,GAAG,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,GAC1B,KAAK,IAAI,SAAS,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAA;AAMtC,qBAAa,SAAU,SAAQ,KAAK;IAClC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAExC,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IAEtB,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAE5B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAE5B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IAEzB,8DAA8D;IAC9D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;gBAG7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB;IAaH;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS;IAoBxC;;OAEG;IACH,WAAW,IAAI,MAAM;IA2CrB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,iBAAiB,IAAI,MAAM;CAG5B"}

package/dist/errors/ReamError.js

@@ -6,6 +6,11 @@
  *
  * @implements FR71, FR72, FR73, FR77
  */
+export function isReamError(error, ...codes) {
+    if (!(error instanceof ReamError))
+        return false;
+    return codes.length === 0 || codes.includes(error.code);
+}
 export class ReamError extends Error {
     /** Error code (e.g., "ATLAS_QUERY_ERROR", "CONTAINER_NOT_FOUND") */
     code;

package/dist/errors/ReamError.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReamError.js","sourceRoot":"","sources":["../../src/errors/ReamError.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ReamError.js","sourceRoot":"","sources":["../../src/errors/ReamError.ts"],"names":[],"mappings":"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"}

package/dist/errors/prettyPrintError.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Render an error for a human reading a terminal (AdonisJS `prettyPrintError`).
+ *
+ * Its own module rather than a helper inside `Ignitor.ts`: the console kernel
+ * renders the failures of the command it ran, and reaching into the Ignitor for
+ * that would make the two import each other.
+ */
+export declare function prettyPrintError(error: unknown): void;
+//# sourceMappingURL=prettyPrintError.d.ts.map

package/dist/errors/prettyPrintError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prettyPrintError.d.ts","sourceRoot":"","sources":["../../src/errors/prettyPrintError.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CASrD"}

package/dist/errors/prettyPrintError.js

@@ -0,0 +1,22 @@
+/**
+ * Render an error for a human reading a terminal (AdonisJS `prettyPrintError`).
+ *
+ * Its own module rather than a helper inside `Ignitor.ts`: the console kernel
+ * renders the failures of the command it ran, and reaching into the Ignitor for
+ * that would make the two import each other.
+ */
+import { ReamError } from './ReamError.js';
+export function prettyPrintError(error) {
+    if (error instanceof ReamError) {
+        console.error(error.toDevString());
+    }
+    else if (error instanceof Error) {
+        console.error(`\n  ${error.message}\n`);
+        if (error.stack)
+            console.error(error.stack);
+    }
+    else {
+        console.error(error);
+    }
+}
+//# sourceMappingURL=prettyPrintError.js.map

package/dist/errors/prettyPrintError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prettyPrintError.js","sourceRoot":"","sources":["../../src/errors/prettyPrintError.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;IACpC,CAAC;SAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,OAAO,IAAI,CAAC,CAAA;QACvC,IAAI,KAAK,CAAC,KAAK;YAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC7C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACtB,CAAC;AACH,CAAC"}