@e-n-v/env 0.0.2 → 0.0.4

package/dist/parse.d.ts

@@ -0,0 +1,52 @@
+import "./StringEnvVarSchema-B8MT7htU.js";
+import { i as EnvVarSchema } from "./BooleanMap-DmFnCA-O.js";
+import { n as schema, t as s } from "./schema-jN4EtvEP.js";
+import { a as SupportedSchema, n as EnvModelOptions, t as EnvModel } from "./EnvModel-D8rt0EJ6.js";
+import { t as define } from "./model-Dic8IJsf.js";
+import { n as ParseEnvOptions, t as parse } from "./parse-DwtLpVhC.js";
+
+//#region ../parse/src/errors/EnvParseError.d.ts
+type EnvParseIssueMissing = {
+  type: "missing";
+  key: string;
+  message: string;
+};
+type EnvParseIssueInvalid = {
+  type: "invalid";
+  key: string;
+  value: string;
+  message: string;
+};
+type EnvParseIssue = EnvParseIssueMissing | EnvParseIssueInvalid;
+type EnvParseResult<TValue> = {
+  ok: true;
+  value: TValue;
+} | {
+  ok: false;
+  error: EnvParseError<TValue>;
+};
+/**
+ * Error thrown when parsing environment variables fails.
+ * Collects all issues so callers can inspect them without relying on subclasses.
+ */
+declare class EnvParseError<TValue = Record<string, unknown>> extends Error {
+  readonly issues: ReadonlyArray<EnvParseIssue>;
+  readonly partial: Partial<TValue>;
+  constructor(params: {
+    issues: EnvParseIssue[];
+    partial?: Partial<TValue>;
+  });
+  /** Number of issues encountered while parsing. */
+  get issueCount(): number;
+  /** Keys that were missing but required. */
+  get missing(): string[];
+  /** Keys that were present but invalid. */
+  get invalid(): string[];
+  /**
+   * Get all issue messages as a numbered list for easy logging.
+   */
+  formatIssues(): string;
+  private static formatMessage;
+}
+//#endregion
+export { EnvModel, EnvModelOptions, EnvParseError, EnvParseIssue, EnvParseIssueInvalid, EnvParseIssueMissing, EnvParseResult, EnvVarSchema, ParseEnvOptions, SupportedSchema, parse as default, parse, define, s, schema };

package/dist/parse.js

@@ -0,0 +1,10 @@
+import { n as schema, t as s } from "./src-CLTURaoo.js";
+import "./coerce-DNIuYAx4.js";
+import { n as EnvModel, t as define } from "./src-CVdUqK3q.js";
+import { n as EnvParseError, t as parse } from "./src-BBwjK5SK.js";
+
+//#region src/parse.ts
+var parse_default = parse;
+
+//#endregion
+export { EnvModel, EnvParseError, parse_default as default, define, parse, s, schema };

package/dist/prompt-C5WudV9x.d.cts

@@ -0,0 +1,74 @@
+import { t as EnvChannelOptions } from "./EnvChannelOptions-BPkWDrmr.cjs";
+import { t as EnvChannel } from "./EnvChannel-LMIRYvT1.cjs";
+import { n as EnvModelOptions, t as EnvModel } from "./EnvModel-CrGclUpJ.cjs";
+import { Formatter } from "picocolors/types";
+
+//#region ../prompt/src/options/PromptEnvInteractiveOptions.d.ts
+/**
+ * Configuration options for the prompt function
+ */
+type PromptEnvInteractiveOptions = {
+  /**
+   * Path to the .env file to read from and write to
+   * @default ".env"
+   * @example ".env.local", ".env.production", "config/.env"
+   */
+  path?: string;
+  /**
+   * Root location used to resolve relative env file paths.
+   * Supply CommonJS `__dirname` or ESM `import.meta.url` so the env path resolves next to the caller.
+   * Falls back to the current working directory when omitted.
+   * @default process.cwd()
+   * @example import.meta.url, __dirname
+   */
+  root?: string;
+  /**
+   * Channel configuration for reading and writing environment variables.
+   * Can be undefined (default), "default", a dotenvx instance, channel config objects, or an EnvChannel instance.
+   * @default undefined (uses default file-based channel)
+   * @example dotenvx, { name: "default" }, { dotenvx: instance, get: {}, set: {} }, new DefaultEnvChannel(".env")
+   */
+  channel?: EnvChannelOptions | EnvChannel;
+  /**
+   * Maximum number of characters to display for values in prompts before truncating
+   * Longer values will be shown as "value..." to keep the interface clean
+   * @default 40
+   * @example 20, 60, 100
+   */
+  truncate?: number;
+  /**
+   * Array of patterns (strings or RegExp) used to identify secret environment variables
+   * Secret variables will be masked in prompts and can be toggled to reveal/hide
+   * @default DEFAULT_SECRET_PATTERNS (includes password, token, api_key, database_url, etc.)
+   * @example ["PASSWORD", /secret/i, "API_KEY"], [] (empty array disables masking)
+   */
+  secrets?: Array<RegExp | string>;
+  /**
+   * Color theme function for styling the CLI interface
+   * Uses picocolors formatter functions to customize the primary color scheme
+   * @default color.magenta
+   * @example color.blue, color.green, color.cyan
+   */
+  theme?: Formatter;
+};
+//#endregion
+//#region ../prompt/src/options/PromptEnvOptions.d.ts
+/**
+ * Configuration options for the prompt function
+ */
+type PromptEnvOptions = EnvModelOptions & PromptEnvInteractiveOptions;
+//#endregion
+//#region ../prompt/src/prompt.d.ts
+/**
+ * Interactive CLI tool to generate .env files with schema validation
+ * @param model - Environment model instance
+ * @param options - Interactive configuration options
+ */
+declare function prompt(model: EnvModel, options?: PromptEnvInteractiveOptions): Promise<void>;
+/**
+ * Interactive CLI tool to generate .env files with schema validation
+ * @param options - Configuration options including schemas and interactive settings
+ */
+declare function prompt(options: PromptEnvOptions): Promise<void>;
+//#endregion
+export { PromptEnvOptions as n, prompt as t };

package/dist/prompt-yKdccbtZ.d.ts

@@ -0,0 +1,74 @@
+import { t as EnvChannelOptions } from "./EnvChannelOptions-CRwDLWjd.js";
+import { t as EnvChannel } from "./EnvChannel-w27PEm7x.js";
+import { n as EnvModelOptions, t as EnvModel } from "./EnvModel-D8rt0EJ6.js";
+import { Formatter } from "picocolors/types";
+
+//#region ../prompt/src/options/PromptEnvInteractiveOptions.d.ts
+/**
+ * Configuration options for the prompt function
+ */
+type PromptEnvInteractiveOptions = {
+  /**
+   * Path to the .env file to read from and write to
+   * @default ".env"
+   * @example ".env.local", ".env.production", "config/.env"
+   */
+  path?: string;
+  /**
+   * Root location used to resolve relative env file paths.
+   * Supply CommonJS `__dirname` or ESM `import.meta.url` so the env path resolves next to the caller.
+   * Falls back to the current working directory when omitted.
+   * @default process.cwd()
+   * @example import.meta.url, __dirname
+   */
+  root?: string;
+  /**
+   * Channel configuration for reading and writing environment variables.
+   * Can be undefined (default), "default", a dotenvx instance, channel config objects, or an EnvChannel instance.
+   * @default undefined (uses default file-based channel)
+   * @example dotenvx, { name: "default" }, { dotenvx: instance, get: {}, set: {} }, new DefaultEnvChannel(".env")
+   */
+  channel?: EnvChannelOptions | EnvChannel;
+  /**
+   * Maximum number of characters to display for values in prompts before truncating
+   * Longer values will be shown as "value..." to keep the interface clean
+   * @default 40
+   * @example 20, 60, 100
+   */
+  truncate?: number;
+  /**
+   * Array of patterns (strings or RegExp) used to identify secret environment variables
+   * Secret variables will be masked in prompts and can be toggled to reveal/hide
+   * @default DEFAULT_SECRET_PATTERNS (includes password, token, api_key, database_url, etc.)
+   * @example ["PASSWORD", /secret/i, "API_KEY"], [] (empty array disables masking)
+   */
+  secrets?: Array<RegExp | string>;
+  /**
+   * Color theme function for styling the CLI interface
+   * Uses picocolors formatter functions to customize the primary color scheme
+   * @default color.magenta
+   * @example color.blue, color.green, color.cyan
+   */
+  theme?: Formatter;
+};
+//#endregion
+//#region ../prompt/src/options/PromptEnvOptions.d.ts
+/**
+ * Configuration options for the prompt function
+ */
+type PromptEnvOptions = EnvModelOptions & PromptEnvInteractiveOptions;
+//#endregion
+//#region ../prompt/src/prompt.d.ts
+/**
+ * Interactive CLI tool to generate .env files with schema validation
+ * @param model - Environment model instance
+ * @param options - Interactive configuration options
+ */
+declare function prompt(model: EnvModel, options?: PromptEnvInteractiveOptions): Promise<void>;
+/**
+ * Interactive CLI tool to generate .env files with schema validation
+ * @param options - Configuration options including schemas and interactive settings
+ */
+declare function prompt(options: PromptEnvOptions): Promise<void>;
+//#endregion
+export { PromptEnvOptions as n, prompt as t };

package/dist/prompt.cjs

@@ -0,0 +1,24 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+require('./EnvSource-BVnmdHku.cjs');
+const require_resolveChannel = require('./resolveChannel-CjAuxy3p.cjs');
+const require_src = require('./src-DWYoqPX1.cjs');
+require('./src-meUnCASg.cjs');
+require('./coerce-b7UVodS9.cjs');
+require('./src-XjL5cyPG.cjs');
+
+//#region src/prompt.ts
+var prompt_default = require_src.prompt;
+
+//#endregion
+exports.DefaultEnvChannel = require_resolveChannel.DefaultEnvChannel;
+exports.DotEnvXChannel = require_resolveChannel.DotEnvXChannel;
+exports.ProcessEnvChannel = require_resolveChannel.ProcessEnvChannel;
+exports.default = prompt_default;
+Object.defineProperty(exports, 'defaults', {
+  enumerable: true,
+  get: function () {
+    return require_src.defaults_exports;
+  }
+});
+exports.prompt = require_src.prompt;
+exports.resolveChannel = require_resolveChannel.resolveChannel;

package/dist/prompt.d.cts

@@ -0,0 +1,17 @@
+import { a as DotEnvXChannelConfig, i as DefaultChannelConfig, n as ProcessChannelConfig, r as ProcessEnvChannelConfig, t as EnvChannelOptions } from "./EnvChannelOptions-BPkWDrmr.cjs";
+import "./StringEnvVarSchema-BF6C0nyT.cjs";
+import "./BooleanMap-B2eIP3tZ.cjs";
+import { t as EnvChannel } from "./EnvChannel-LMIRYvT1.cjs";
+import { i as resolveChannel, n as DotEnvXChannel, r as DefaultEnvChannel, t as ProcessEnvChannel } from "./ProcessEnvChannel-D465c-dp.cjs";
+import "./EnvModel-CrGclUpJ.cjs";
+import { n as PromptEnvOptions, t as prompt } from "./prompt-C5WudV9x.cjs";
+
+//#region ../prompt/src/options/defaults.d.ts
+declare namespace defaults_d_exports {
+  export { ENV_PATH, SECRET_PATTERNS, TRUNCATE_LENGTH };
+}
+declare const ENV_PATH = ".env";
+declare const TRUNCATE_LENGTH = 40;
+declare const SECRET_PATTERNS: ReadonlyArray<RegExp | string>;
+//#endregion
+export { DefaultChannelConfig, DefaultEnvChannel, DotEnvXChannel, DotEnvXChannelConfig, EnvChannel, EnvChannelOptions, ProcessChannelConfig, ProcessEnvChannel, ProcessEnvChannelConfig, PromptEnvOptions, prompt as default, prompt, defaults_d_exports as defaults, resolveChannel };

package/dist/prompt.d.ts

@@ -0,0 +1,17 @@
+import { a as DotEnvXChannelConfig, i as DefaultChannelConfig, n as ProcessChannelConfig, r as ProcessEnvChannelConfig, t as EnvChannelOptions } from "./EnvChannelOptions-CRwDLWjd.js";
+import "./StringEnvVarSchema-B8MT7htU.js";
+import "./BooleanMap-DmFnCA-O.js";
+import { t as EnvChannel } from "./EnvChannel-w27PEm7x.js";
+import { i as resolveChannel, n as DotEnvXChannel, r as DefaultEnvChannel, t as ProcessEnvChannel } from "./ProcessEnvChannel-Do4-yiLI.js";
+import "./EnvModel-D8rt0EJ6.js";
+import { n as PromptEnvOptions, t as prompt } from "./prompt-yKdccbtZ.js";
+
+//#region ../prompt/src/options/defaults.d.ts
+declare namespace defaults_d_exports {
+  export { ENV_PATH, SECRET_PATTERNS, TRUNCATE_LENGTH };
+}
+declare const ENV_PATH = ".env";
+declare const TRUNCATE_LENGTH = 40;
+declare const SECRET_PATTERNS: ReadonlyArray<RegExp | string>;
+//#endregion
+export { DefaultChannelConfig, DefaultEnvChannel, DotEnvXChannel, DotEnvXChannelConfig, EnvChannel, EnvChannelOptions, ProcessChannelConfig, ProcessEnvChannel, ProcessEnvChannelConfig, PromptEnvOptions, prompt as default, prompt, defaults_d_exports as defaults, resolveChannel };

package/dist/prompt.js

@@ -0,0 +1,12 @@
+import "./EnvSource-DA3ZGlES.js";
+import { a as DefaultEnvChannel, n as ProcessEnvChannel, r as DotEnvXChannel, t as resolveChannel } from "./resolveChannel-v9BDsw-M.js";
+import { n as defaults_exports, t as prompt } from "./src-Dtv7TlJx.js";
+import "./src-CLTURaoo.js";
+import "./coerce-DNIuYAx4.js";
+import "./src-CVdUqK3q.js";
+
+//#region src/prompt.ts
+var prompt_default = prompt;
+
+//#endregion
+export { DefaultEnvChannel, DotEnvXChannel, ProcessEnvChannel, prompt_default as default, defaults_exports as defaults, prompt, resolveChannel };