scenv 0.8.0 → 1.0.0

package/README.md

@@ -42,13 +42,13 @@ await apiUrl.save(); // write current value to a context file
 
 Any string value matching **`@<context>:<key>`** (e.g. `@prod:core_server_url`) is resolved from that context file first—in set, env, context, default, and prompts.
 
-Prompting (when to ask the user) is controlled by config `prompt`: `always` | `never` | `fallback` | `no-env`.
+Prompting is off by default (`prompt: "never"`). To enable it, set config `prompt` to `always`, `fallback`, or `no-env` (via config file, `SCENV_PROMPT`, or `configure()`).
 
 ## Optional integrations
 
 | Package                                                        | Purpose                                                       |
 | -------------------------------------------------------------- | ------------------------------------------------------------- |
-| [scenv-zod](https://www.npmjs.com/package/scenv-zod)           | `validator(zodSchema)` for type-safe validation and coercion. |
+| [scenv-zod](https://www.npmjs.com/package/scenv-zod)           | `parser(zodSchema)` for type-safe parsing and coercion. |
 | [scenv-inquirer](https://www.npmjs.com/package/scenv-inquirer) | `prompt()` and callbacks for interactive prompts.             |
 
 ## Documentation

package/dist/index.cjs

@@ -477,7 +477,7 @@ function defaultKeyFromName(name) {
 function defaultEnvFromKey(key) {
   return key.toUpperCase().replace(/-/g, "_");
 }
-function normalizeValidatorResult(result) {
+function normalizeParserResult(result) {
   if (typeof result === "boolean") {
     return result ? { success: true } : { success: false };
   }
@@ -487,7 +487,7 @@ function normalizeValidatorResult(result) {
 function scenv(name, options = {}) {
   const key = options.key ?? defaultKeyFromName(name);
   const envKey = options.env ?? defaultEnvFromKey(key);
-  const validator = options.validator;
+  const parserFn = options.parser;
   const promptFn = options.prompt;
   const defaultValue = options.default;
   async function resolveRaw() {
@@ -526,7 +526,7 @@ function scenv(name, options = {}) {
     return { raw: void 0, source: void 0 };
   }
   function shouldPrompt(config, hadValue, hadEnv) {
-    const mode = config.prompt ?? "fallback";
+    const mode = config.prompt ?? "never";
     if (mode === "never") return false;
     if (mode === "always") return true;
     if (mode === "fallback") return !hadValue;
@@ -542,7 +542,7 @@ function scenv(name, options = {}) {
     const doPrompt = shouldPrompt(config, hadValue, hadEnv);
     log(
       "debug",
-      `prompt decision key=${key} prompt=${config.prompt ?? "fallback"} hadValue=${hadValue} hadEnv=${hadEnv} -> ${doPrompt ? "prompt" : "no prompt"}`
+      `prompt decision key=${key} prompt=${config.prompt ?? "never"} hadValue=${hadValue} hadEnv=${hadEnv} -> ${doPrompt ? "prompt" : "no prompt"}`
     );
     const effectiveDefault = overrides?.default !== void 0 ? overrides.default : defaultValue;
     const resolvedDefault = effectiveDefault === void 0 ? void 0 : typeof effectiveDefault === "string" ? resolveContextReference(effectiveDefault, key) : effectiveDefault;
@@ -574,10 +574,10 @@ function scenv(name, options = {}) {
     log("info", `variable "${name}" (key=${key}) resolved from ${resolvedFrom}`);
     return { value, raw, hadEnv, wasPrompted };
   }
-  function validate(value) {
-    if (!validator) return { success: true, data: value };
-    const result = validator(value);
-    const normalized = normalizeValidatorResult(result);
+  function parse(value) {
+    if (!parserFn) return { success: true, data: value };
+    const result = parserFn(value);
+    const normalized = normalizeParserResult(result);
     if (normalized.success) {
       const data = "data" in normalized && normalized.data !== void 0 ? normalized.data : value;
       return { success: true, data };
@@ -589,13 +589,13 @@ function scenv(name, options = {}) {
   }
   async function get(options2) {
     const { value, wasPrompted } = await getResolvedValue(options2);
-    const validated = validate(value);
-    if (!validated.success) {
-      const errMsg = `Validation failed for "${name}": ${validated.error ?? "unknown"}`;
+    const parsed = parse(value);
+    if (!parsed.success) {
+      const errMsg = `Parsing failed for "${name}": ${parsed.error ?? "unknown"}`;
       log("error", errMsg);
       throw new Error(errMsg);
     }
-    const final = validated.data;
+    const final = parsed.data;
     const config = loadConfig();
     if (wasPrompted) setInMemoryContext(key, String(final));
     if (config.saveContextTo) {
@@ -617,16 +617,16 @@ function scenv(name, options = {}) {
   }
   async function save(value) {
     const toSave = value ?? (await getResolvedValue()).value;
-    const validated = validate(toSave);
-    if (!validated.success) {
-      const errMsg = `Validation failed for "${name}": ${validated.error ?? "unknown"}`;
+    const parsed = parse(toSave);
+    if (!parsed.success) {
+      const errMsg = `Parsing failed for "${name}": ${parsed.error ?? "unknown"}`;
       log("error", errMsg);
       throw new Error(errMsg);
     }
     const config = loadConfig();
-    setInMemoryContext(key, String(validated.data));
+    setInMemoryContext(key, String(parsed.data));
     if (config.saveContextTo) {
-      writeToContext(config.saveContextTo, key, String(validated.data));
+      writeToContext(config.saveContextTo, key, String(parsed.data));
       log("info", `Saved key=${key} to saveContextTo ${config.saveContextTo}`);
     }
   }

package/dist/index.d.cts

@@ -29,7 +29,7 @@ interface ScenvConfig {
     context?: string[];
     /** Merge these context names with existing (CLI: `--add-context a,b,c`). Ignored if `context` is set in the same layer. */
     addContext?: string[];
-    /** When to prompt for a variable value. See {@link PromptMode}. Default is `"fallback"`. */
+    /** When to prompt for a variable value. See {@link PromptMode}. Default is `"never"`; set to `always`, `fallback`, or `no-env` to enable prompting (via config file, SCENV_PROMPT, or configure()). */
     prompt?: PromptMode;
     /** If true, environment variables are not used during resolution. */
     ignoreEnv?: boolean;
@@ -154,18 +154,35 @@ declare function getMergedContextValues(): Record<string, string>;
 declare function getContextWritePath(contextName: string): string;
 
 /**
- * Return type for a variable's optional `validator` function. Use a boolean for simple
- * pass/fail, or an object to pass a transformed value or a custom error.
- * - `true` or `{ success: true, data?: T }` – validation passed; optional `data` replaces the value.
- * - `false` or `{ success: false, error?: unknown }` – validation failed; `.get()` throws with the error.
+ * Return type for a variable's optional `parser` function. Input is always the raw string
+ * (from set/env/context) or the default. Use a boolean for simple pass/fail, or an object
+ * to pass a parsed/transformed value or a custom error.
+ * - `true` or `{ success: true, data?: T }` – parsing passed; optional `data` is the output value (type T).
+ * - `false` or `{ success: false, error?: unknown }` – parsing failed; `.get()` throws with the error.
  */
-type ValidatorResult<T> = boolean | {
+type ParserResult<T> = boolean | {
     success: true;
     data?: T;
 } | {
     success: false;
     error?: unknown;
 };
+/**
+ * Infers the variable's value type (output type) from options: when a parser returns
+ * `{ success: true, data: D }`, that D is used; otherwise the type comes from `default` or defaults to string.
+ */
+type InferVariableType<O> = O extends {
+    parser: (v: unknown) => infer R;
+} ? R extends {
+    success: true;
+    data: infer D;
+} ? D extends undefined ? O extends {
+    default: infer Def;
+} ? Def : string : D : O extends {
+    default: infer Def;
+} ? Def : string : O extends {
+    default: infer Def;
+} ? Def : string;
 /**
  * Prompt function signature. Called when config requests prompting for this variable.
  * Receives the variable's display name and the current default (from set/env/context or option default).
@@ -175,17 +192,18 @@ type PromptFn<T> = (name: string, defaultValue: T) => T | Promise<T>;
 /**
  * Options when creating a variable with {@link scenv}. All properties are optional.
  * If you omit `key` and `env`, they are derived from `name`: e.g. "API URL" → key `api_url`, env `API_URL`.
+ * Input from set/env/context is always string; `default` and the variable's value type are the output type T.
  */
-interface ScenvVariableOptions<T> {
+interface ScenvVariableOptions<T = string> {
     /** Internal key for --set, context files, and env. Default: name lowercased, spaces → underscores, non-alphanumeric stripped (e.g. "API URL" → "api_url"). */
     key?: string;
     /** Environment variable name (e.g. API_URL). Default: key uppercased, hyphens → underscores. */
     env?: string;
-    /** Fallback when nothing is provided via --set, env, or context (and we're not prompting). */
+    /** Fallback when nothing is provided via --set, env, or context (and we're not prompting). Same type T as the variable's output (not parsed). */
     default?: T;
-    /** Optional. Run after value is resolved or prompted. Return true / { success: true } to accept, false / { success: false, error } to reject (get() throws). Use to coerce types or enforce rules. */
-    validator?: (val: T) => ValidatorResult<T>;
-    /** Optional. Called when config says to prompt (e.g. prompt: "fallback" and no value found). Overrides callbacks.defaultPrompt for this variable. */
+    /** Optional. Parses the raw string (or default) into output type T. Receives raw value (typically string). Return { success: true, data } with the parsed value; variable type is inferred from data. */
+    parser?: (val: unknown) => ParserResult<T>;
+    /** Optional. Called when config has enabled prompting (e.g. prompt: "fallback" and no value found). Overrides callbacks.defaultPrompt for this variable. */
     prompt?: PromptFn<T>;
 }
 /**
@@ -204,8 +222,8 @@ interface GetOptions<T> {
  */
 interface ScenvVariable<T> {
     /**
-     * Resolve and return the value. Uses resolution order (set > env > context > default) and any prompt/validator.
-     * @throws If no value is found and no default/prompt, or if validation fails.
+     * Resolve and return the value. Uses resolution order (set > env > context > default) and any prompt/parser.
+     * @throws If no value is found and no default/prompt, or if parsing fails.
      */
     get(options?: GetOptions<T>): Promise<T>;
     /**
@@ -236,16 +254,15 @@ interface ScenvVariable<T> {
  * - Environment variable (e.g. API_URL for key "api_url")
  * - Context files (merged key-value from the context list in config, e.g. dev.context.json)
  *
- * If config says to prompt (see prompt mode in config: "always", "fallback", "no-env"), the prompt callback
+ * If prompting is enabled in config (prompt: "always", "fallback", or "no-env"), the prompt callback
  * may run. When it runs, it receives the variable name and a suggested value (the raw value if any, otherwise
  * the default option). The callback's return value is used as the value. When we don't prompt, we use the
  * raw value if present, otherwise the default option, otherwise get() throws (no value).
  *
- * ## Validator
+ * ## Parser
  *
- * If you pass a validator option, it is called with the resolved or prompted value. It can return true or
- * { success: true } to accept, or false or { success: false, error } to reject; on reject, get() throws.
- * Use it to coerce types (e.g. string to number) or enforce rules.
+ * If you pass a parser option, it is called with the raw value (typically string from set/env/context) or the default.
+ * Return { success: true, data } with the parsed output; the variable's type is inferred from data. On { success: false }, get() throws.
  *
  * ## save()
  *
@@ -254,16 +271,20 @@ interface ScenvVariable<T> {
  * When the user is prompted during get(), the value is always saved (to saveContextTo file if set, and always to in-memory)
  * so a second get() on the same variable does not prompt again.
  *
- * @typeParam T - Value type (default string). Use a validator to coerce to number, boolean, etc.
+ * @typeParam T - Output (value) type of the variable, e.g. string, number, URL. Defaults to string.
  * @param name - Display name used in prompts and errors. If you omit key/env, key is derived from name (e.g. "API URL" → "api_url") and env from key (e.g. "API_URL").
- * @param options - Optional. key, env, default, validator, prompt. See {@link ScenvVariableOptions}.
- * @returns A {@link ScenvVariable} with get(), safeGet(), and save().
+ * @param options - Optional. key, env, default, parser, prompt. See {@link ScenvVariableOptions}.
+ * @returns A {@link ScenvVariable<T>} with get(), safeGet(), and save().
  *
  * @example
  * const apiUrl = scenv("API URL", { default: "http://localhost:4000" });
  * const url = await apiUrl.get();
+ *
+ * @example
+ * const port = scenv<number>("Port", { parser: parser(z.coerce.number()), default: 3000 });
+ * const n = await port.get(); // number
  */
-declare function scenv<T>(name: string, options?: ScenvVariableOptions<T>): ScenvVariable<T>;
+declare function scenv<T = string>(name: string, options?: ScenvVariableOptions<T>): ScenvVariable<T>;
 
 /**
  * Parses command-line arguments into a partial {@link ScenvConfig} suitable for {@link configure}.
@@ -286,4 +307,4 @@ declare function scenv<T>(name: string, options?: ScenvVariableOptions<T>): Scen
  */
 declare function parseScenvArgs(argv: string[]): Partial<ScenvConfig>;
 
-export { type DefaultPromptFn, type GetOptions, LOG_LEVELS, type LogLevel, type PromptMode, type SaveMode, type ScenvCallbacks, type ScenvConfig, type ScenvVariable, configure, discoverContextPaths, getCallbacks, getContext, getContextWritePath, getInMemoryContext, getMergedContextValues, loadConfig, parseScenvArgs, resetConfig, resetInMemoryContext, resetLogState, scenv, setInMemoryContext };
+export { type DefaultPromptFn, type GetOptions, type InferVariableType, LOG_LEVELS, type LogLevel, type ParserResult, type PromptMode, type SaveMode, type ScenvCallbacks, type ScenvConfig, type ScenvVariable, type ScenvVariableOptions, configure, discoverContextPaths, getCallbacks, getContext, getContextWritePath, getInMemoryContext, getMergedContextValues, loadConfig, parseScenvArgs, resetConfig, resetInMemoryContext, resetLogState, scenv, setInMemoryContext };

package/dist/index.d.ts

@@ -29,7 +29,7 @@ interface ScenvConfig {
     context?: string[];
     /** Merge these context names with existing (CLI: `--add-context a,b,c`). Ignored if `context` is set in the same layer. */
     addContext?: string[];
-    /** When to prompt for a variable value. See {@link PromptMode}. Default is `"fallback"`. */
+    /** When to prompt for a variable value. See {@link PromptMode}. Default is `"never"`; set to `always`, `fallback`, or `no-env` to enable prompting (via config file, SCENV_PROMPT, or configure()). */
     prompt?: PromptMode;
     /** If true, environment variables are not used during resolution. */
     ignoreEnv?: boolean;
@@ -154,18 +154,35 @@ declare function getMergedContextValues(): Record<string, string>;
 declare function getContextWritePath(contextName: string): string;
 
 /**
- * Return type for a variable's optional `validator` function. Use a boolean for simple
- * pass/fail, or an object to pass a transformed value or a custom error.
- * - `true` or `{ success: true, data?: T }` – validation passed; optional `data` replaces the value.
- * - `false` or `{ success: false, error?: unknown }` – validation failed; `.get()` throws with the error.
+ * Return type for a variable's optional `parser` function. Input is always the raw string
+ * (from set/env/context) or the default. Use a boolean for simple pass/fail, or an object
+ * to pass a parsed/transformed value or a custom error.
+ * - `true` or `{ success: true, data?: T }` – parsing passed; optional `data` is the output value (type T).
+ * - `false` or `{ success: false, error?: unknown }` – parsing failed; `.get()` throws with the error.
  */
-type ValidatorResult<T> = boolean | {
+type ParserResult<T> = boolean | {
     success: true;
     data?: T;
 } | {
     success: false;
     error?: unknown;
 };
+/**
+ * Infers the variable's value type (output type) from options: when a parser returns
+ * `{ success: true, data: D }`, that D is used; otherwise the type comes from `default` or defaults to string.
+ */
+type InferVariableType<O> = O extends {
+    parser: (v: unknown) => infer R;
+} ? R extends {
+    success: true;
+    data: infer D;
+} ? D extends undefined ? O extends {
+    default: infer Def;
+} ? Def : string : D : O extends {
+    default: infer Def;
+} ? Def : string : O extends {
+    default: infer Def;
+} ? Def : string;
 /**
  * Prompt function signature. Called when config requests prompting for this variable.
  * Receives the variable's display name and the current default (from set/env/context or option default).
@@ -175,17 +192,18 @@ type PromptFn<T> = (name: string, defaultValue: T) => T | Promise<T>;
 /**
  * Options when creating a variable with {@link scenv}. All properties are optional.
  * If you omit `key` and `env`, they are derived from `name`: e.g. "API URL" → key `api_url`, env `API_URL`.
+ * Input from set/env/context is always string; `default` and the variable's value type are the output type T.
  */
-interface ScenvVariableOptions<T> {
+interface ScenvVariableOptions<T = string> {
     /** Internal key for --set, context files, and env. Default: name lowercased, spaces → underscores, non-alphanumeric stripped (e.g. "API URL" → "api_url"). */
     key?: string;
     /** Environment variable name (e.g. API_URL). Default: key uppercased, hyphens → underscores. */
     env?: string;
-    /** Fallback when nothing is provided via --set, env, or context (and we're not prompting). */
+    /** Fallback when nothing is provided via --set, env, or context (and we're not prompting). Same type T as the variable's output (not parsed). */
     default?: T;
-    /** Optional. Run after value is resolved or prompted. Return true / { success: true } to accept, false / { success: false, error } to reject (get() throws). Use to coerce types or enforce rules. */
-    validator?: (val: T) => ValidatorResult<T>;
-    /** Optional. Called when config says to prompt (e.g. prompt: "fallback" and no value found). Overrides callbacks.defaultPrompt for this variable. */
+    /** Optional. Parses the raw string (or default) into output type T. Receives raw value (typically string). Return { success: true, data } with the parsed value; variable type is inferred from data. */
+    parser?: (val: unknown) => ParserResult<T>;
+    /** Optional. Called when config has enabled prompting (e.g. prompt: "fallback" and no value found). Overrides callbacks.defaultPrompt for this variable. */
     prompt?: PromptFn<T>;
 }
 /**
@@ -204,8 +222,8 @@ interface GetOptions<T> {
  */
 interface ScenvVariable<T> {
     /**
-     * Resolve and return the value. Uses resolution order (set > env > context > default) and any prompt/validator.
-     * @throws If no value is found and no default/prompt, or if validation fails.
+     * Resolve and return the value. Uses resolution order (set > env > context > default) and any prompt/parser.
+     * @throws If no value is found and no default/prompt, or if parsing fails.
      */
     get(options?: GetOptions<T>): Promise<T>;
     /**
@@ -236,16 +254,15 @@ interface ScenvVariable<T> {
  * - Environment variable (e.g. API_URL for key "api_url")
  * - Context files (merged key-value from the context list in config, e.g. dev.context.json)
  *
- * If config says to prompt (see prompt mode in config: "always", "fallback", "no-env"), the prompt callback
+ * If prompting is enabled in config (prompt: "always", "fallback", or "no-env"), the prompt callback
  * may run. When it runs, it receives the variable name and a suggested value (the raw value if any, otherwise
  * the default option). The callback's return value is used as the value. When we don't prompt, we use the
  * raw value if present, otherwise the default option, otherwise get() throws (no value).
  *
- * ## Validator
+ * ## Parser
  *
- * If you pass a validator option, it is called with the resolved or prompted value. It can return true or
- * { success: true } to accept, or false or { success: false, error } to reject; on reject, get() throws.
- * Use it to coerce types (e.g. string to number) or enforce rules.
+ * If you pass a parser option, it is called with the raw value (typically string from set/env/context) or the default.
+ * Return { success: true, data } with the parsed output; the variable's type is inferred from data. On { success: false }, get() throws.
  *
  * ## save()
  *
@@ -254,16 +271,20 @@ interface ScenvVariable<T> {
  * When the user is prompted during get(), the value is always saved (to saveContextTo file if set, and always to in-memory)
  * so a second get() on the same variable does not prompt again.
  *
- * @typeParam T - Value type (default string). Use a validator to coerce to number, boolean, etc.
+ * @typeParam T - Output (value) type of the variable, e.g. string, number, URL. Defaults to string.
  * @param name - Display name used in prompts and errors. If you omit key/env, key is derived from name (e.g. "API URL" → "api_url") and env from key (e.g. "API_URL").
- * @param options - Optional. key, env, default, validator, prompt. See {@link ScenvVariableOptions}.
- * @returns A {@link ScenvVariable} with get(), safeGet(), and save().
+ * @param options - Optional. key, env, default, parser, prompt. See {@link ScenvVariableOptions}.
+ * @returns A {@link ScenvVariable<T>} with get(), safeGet(), and save().
  *
  * @example
  * const apiUrl = scenv("API URL", { default: "http://localhost:4000" });
  * const url = await apiUrl.get();
+ *
+ * @example
+ * const port = scenv<number>("Port", { parser: parser(z.coerce.number()), default: 3000 });
+ * const n = await port.get(); // number
  */
-declare function scenv<T>(name: string, options?: ScenvVariableOptions<T>): ScenvVariable<T>;
+declare function scenv<T = string>(name: string, options?: ScenvVariableOptions<T>): ScenvVariable<T>;
 
 /**
  * Parses command-line arguments into a partial {@link ScenvConfig} suitable for {@link configure}.
@@ -286,4 +307,4 @@ declare function scenv<T>(name: string, options?: ScenvVariableOptions<T>): Scen
  */
 declare function parseScenvArgs(argv: string[]): Partial<ScenvConfig>;
 
-export { type DefaultPromptFn, type GetOptions, LOG_LEVELS, type LogLevel, type PromptMode, type SaveMode, type ScenvCallbacks, type ScenvConfig, type ScenvVariable, configure, discoverContextPaths, getCallbacks, getContext, getContextWritePath, getInMemoryContext, getMergedContextValues, loadConfig, parseScenvArgs, resetConfig, resetInMemoryContext, resetLogState, scenv, setInMemoryContext };
+export { type DefaultPromptFn, type GetOptions, type InferVariableType, LOG_LEVELS, type LogLevel, type ParserResult, type PromptMode, type SaveMode, type ScenvCallbacks, type ScenvConfig, type ScenvVariable, type ScenvVariableOptions, configure, discoverContextPaths, getCallbacks, getContext, getContextWritePath, getInMemoryContext, getMergedContextValues, loadConfig, parseScenvArgs, resetConfig, resetInMemoryContext, resetLogState, scenv, setInMemoryContext };

package/dist/index.js

@@ -444,7 +444,7 @@ function defaultKeyFromName(name) {
 function defaultEnvFromKey(key) {
   return key.toUpperCase().replace(/-/g, "_");
 }
-function normalizeValidatorResult(result) {
+function normalizeParserResult(result) {
   if (typeof result === "boolean") {
     return result ? { success: true } : { success: false };
   }
@@ -454,7 +454,7 @@ function normalizeValidatorResult(result) {
 function scenv(name, options = {}) {
   const key = options.key ?? defaultKeyFromName(name);
   const envKey = options.env ?? defaultEnvFromKey(key);
-  const validator = options.validator;
+  const parserFn = options.parser;
   const promptFn = options.prompt;
   const defaultValue = options.default;
   async function resolveRaw() {
@@ -493,7 +493,7 @@ function scenv(name, options = {}) {
     return { raw: void 0, source: void 0 };
   }
   function shouldPrompt(config, hadValue, hadEnv) {
-    const mode = config.prompt ?? "fallback";
+    const mode = config.prompt ?? "never";
     if (mode === "never") return false;
     if (mode === "always") return true;
     if (mode === "fallback") return !hadValue;
@@ -509,7 +509,7 @@ function scenv(name, options = {}) {
     const doPrompt = shouldPrompt(config, hadValue, hadEnv);
     log(
       "debug",
-      `prompt decision key=${key} prompt=${config.prompt ?? "fallback"} hadValue=${hadValue} hadEnv=${hadEnv} -> ${doPrompt ? "prompt" : "no prompt"}`
+      `prompt decision key=${key} prompt=${config.prompt ?? "never"} hadValue=${hadValue} hadEnv=${hadEnv} -> ${doPrompt ? "prompt" : "no prompt"}`
     );
     const effectiveDefault = overrides?.default !== void 0 ? overrides.default : defaultValue;
     const resolvedDefault = effectiveDefault === void 0 ? void 0 : typeof effectiveDefault === "string" ? resolveContextReference(effectiveDefault, key) : effectiveDefault;
@@ -541,10 +541,10 @@ function scenv(name, options = {}) {
     log("info", `variable "${name}" (key=${key}) resolved from ${resolvedFrom}`);
     return { value, raw, hadEnv, wasPrompted };
   }
-  function validate(value) {
-    if (!validator) return { success: true, data: value };
-    const result = validator(value);
-    const normalized = normalizeValidatorResult(result);
+  function parse(value) {
+    if (!parserFn) return { success: true, data: value };
+    const result = parserFn(value);
+    const normalized = normalizeParserResult(result);
     if (normalized.success) {
       const data = "data" in normalized && normalized.data !== void 0 ? normalized.data : value;
       return { success: true, data };
@@ -556,13 +556,13 @@ function scenv(name, options = {}) {
   }
   async function get(options2) {
     const { value, wasPrompted } = await getResolvedValue(options2);
-    const validated = validate(value);
-    if (!validated.success) {
-      const errMsg = `Validation failed for "${name}": ${validated.error ?? "unknown"}`;
+    const parsed = parse(value);
+    if (!parsed.success) {
+      const errMsg = `Parsing failed for "${name}": ${parsed.error ?? "unknown"}`;
       log("error", errMsg);
       throw new Error(errMsg);
     }
-    const final = validated.data;
+    const final = parsed.data;
     const config = loadConfig();
     if (wasPrompted) setInMemoryContext(key, String(final));
     if (config.saveContextTo) {
@@ -584,16 +584,16 @@ function scenv(name, options = {}) {
   }
   async function save(value) {
     const toSave = value ?? (await getResolvedValue()).value;
-    const validated = validate(toSave);
-    if (!validated.success) {
-      const errMsg = `Validation failed for "${name}": ${validated.error ?? "unknown"}`;
+    const parsed = parse(toSave);
+    if (!parsed.success) {
+      const errMsg = `Parsing failed for "${name}": ${parsed.error ?? "unknown"}`;
       log("error", errMsg);
       throw new Error(errMsg);
     }
     const config = loadConfig();
-    setInMemoryContext(key, String(validated.data));
+    setInMemoryContext(key, String(parsed.data));
     if (config.saveContextTo) {
-      writeToContext(config.saveContextTo, key, String(validated.data));
+      writeToContext(config.saveContextTo, key, String(parsed.data));
       log("info", `Saved key=${key} to saveContextTo ${config.saveContextTo}`);
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scenv",
-  "version": "0.8.0",
+  "version": "1.0.0",
   "description": "Environment and context variables with runtime-configurable resolution",
   "repository": {
     "type": "git",