scenv 0.9.0 → 1.0.0

package/README.md

@@ -42,7 +42,7 @@ 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/dist/index.cjs

@@ -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;

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;
@@ -203,7 +203,7 @@ interface ScenvVariableOptions<T = string> {
     default?: T;
     /** 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 says to prompt (e.g. prompt: "fallback" and no value found). Overrides callbacks.defaultPrompt for this variable. */
+    /** Optional. Called when config has enabled prompting (e.g. prompt: "fallback" and no value found). Overrides callbacks.defaultPrompt for this variable. */
     prompt?: PromptFn<T>;
 }
 /**
@@ -254,7 +254,7 @@ 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).

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;
@@ -203,7 +203,7 @@ interface ScenvVariableOptions<T = string> {
     default?: T;
     /** 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 says to prompt (e.g. prompt: "fallback" and no value found). Overrides callbacks.defaultPrompt for this variable. */
+    /** Optional. Called when config has enabled prompting (e.g. prompt: "fallback" and no value found). Overrides callbacks.defaultPrompt for this variable. */
     prompt?: PromptFn<T>;
 }
 /**
@@ -254,7 +254,7 @@ 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).

package/dist/index.js

@@ -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;

package/package.json

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