scenv 0.2.0 → 0.3.0

package/dist/index.cjs

@@ -235,26 +235,6 @@ function writeToContext(contextName, key, value) {
   (0, import_node_fs2.writeFileSync)(path, JSON.stringify(data, null, 2) + "\n", "utf-8");
 }
 
-// src/prompt-default.ts
-var import_node_readline = require("readline");
-function defaultPrompt(name, defaultValue) {
-  const defaultStr = defaultValue !== void 0 && defaultValue !== null ? String(defaultValue) : "";
-  const message = defaultStr ? `Enter ${name} [${defaultStr}]: ` : `Enter ${name}: `;
-  const rl = (0, import_node_readline.createInterface)({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve, reject) => {
-    rl.question(message, (answer) => {
-      rl.close();
-      const trimmed = answer.trim();
-      const value = trimmed !== "" ? trimmed : defaultStr;
-      resolve(value);
-    });
-    rl.on("error", (err) => {
-      rl.close();
-      reject(err);
-    });
-  });
-}
-
 // src/variable.ts
 function defaultKeyFromName(name) {
   return name.toLowerCase().replace(/\s+/g, "_").replace(/[^a-z0-9_]/gi, "");
@@ -296,22 +276,29 @@ function scenv(name, options = {}) {
     if (mode === "no-env") return !hadEnv;
     return false;
   }
-  async function getResolvedValue() {
+  async function getResolvedValue(overrides) {
     const config = loadConfig();
     const raw = await resolveRaw();
     const hadEnv = !config.ignoreEnv && process.env[envKey] !== void 0 && process.env[envKey] !== "";
     const hadValue = raw !== void 0;
+    const effectiveDefault = overrides?.default !== void 0 ? overrides.default : defaultValue;
     let wasPrompted = false;
     let value;
     if (shouldPrompt(config, hadValue, hadEnv)) {
-      const defaultForPrompt = raw !== void 0 ? raw : defaultValue;
-      const fn = promptFn ?? defaultPrompt;
+      const callbacks = getCallbacks();
+      const fn = overrides?.prompt ?? promptFn ?? callbacks.defaultPrompt;
+      if (typeof fn !== "function") {
+        throw new Error(
+          `Prompt required for variable "${name}" (key: ${key}) but no prompt was supplied and no defaultPrompt callback is configured. Set a prompt on the variable or configure({ callbacks: { defaultPrompt: ... } }).`
+        );
+      }
+      const defaultForPrompt = raw !== void 0 ? raw : effectiveDefault;
       value = await Promise.resolve(fn(name, defaultForPrompt));
       wasPrompted = true;
     } else if (raw !== void 0) {
       value = raw;
-    } else if (defaultValue !== void 0) {
-      value = defaultValue;
+    } else if (effectiveDefault !== void 0) {
+      value = effectiveDefault;
     } else {
       throw new Error(`Missing value for variable "${name}" (key: ${key})`);
     }
@@ -330,8 +317,8 @@ function scenv(name, options = {}) {
       error: "error" in normalized ? normalized.error : void 0
     };
   }
-  async function get() {
-    const { value, wasPrompted } = await getResolvedValue();
+  async function get(options2) {
+    const { value, wasPrompted } = await getResolvedValue(options2);
     const validated = validate(value);
     if (!validated.success) {
       throw new Error(
@@ -345,7 +332,12 @@ function scenv(name, options = {}) {
       const shouldAskSave = savePrompt === "always" || savePrompt === "ask" && wasPrompted;
       if (shouldAskSave) {
         const callbacks = getCallbacks();
-        const ctxToSave = callbacks.onAskSaveAfterPrompt && await callbacks.onAskSaveAfterPrompt(
+        if (typeof callbacks.onAskSaveAfterPrompt !== "function") {
+          throw new Error(
+            `savePrompt is "${savePrompt}" but onAskSaveAfterPrompt callback is not set. Configure callbacks via configure({ callbacks: { onAskSaveAfterPrompt: ... } }).`
+          );
+        }
+        const ctxToSave = await callbacks.onAskSaveAfterPrompt(
           name,
           final,
           config.contexts ?? []
@@ -355,9 +347,9 @@ function scenv(name, options = {}) {
     }
     return final;
   }
-  async function safeGet() {
+  async function safeGet(options2) {
     try {
-      const v = await get();
+      const v = await get(options2);
       return { success: true, value: v };
     } catch (err) {
       return { success: false, error: err };
@@ -375,14 +367,15 @@ function scenv(name, options = {}) {
     let contextName = config.saveContextTo;
     if (contextName === "ask") {
       const callbacks = getCallbacks();
-      if (typeof callbacks.onAskContext === "function") {
-        contextName = await callbacks.onAskContext(
-          name,
-          config.contexts ?? []
+      if (typeof callbacks.onAskContext !== "function") {
+        throw new Error(
+          `saveContextTo is "ask" but onAskContext callback is not set. Configure callbacks via configure({ callbacks: { onAskContext: ... } }).`
         );
-      } else {
-        contextName = config.contexts?.[0] ?? "default";
       }
+      contextName = await callbacks.onAskContext(
+        name,
+        config.contexts ?? []
+      );
     }
     if (!contextName) contextName = config.contexts?.[0] ?? "default";
     writeToContext(contextName, key, String(validated.data));

package/dist/index.d.cts

@@ -20,7 +20,11 @@ interface ScenvConfig {
     /** Root directory for config/context search (default: cwd) */
     root?: string;
 }
+/** (name, defaultValue) => value; used when a variable has no prompt option. Overridable per variable. */
+type DefaultPromptFn = (name: string, defaultValue: unknown) => unknown | Promise<unknown>;
 interface ScenvCallbacks {
+    /** Default prompt when a variable does not provide its own `prompt`. Variable's `prompt` overrides this. */
+    defaultPrompt?: DefaultPromptFn;
     /** When user was just prompted for a value and savePrompt is ask/always: (variableName, value, contextNames) => context name to save to, or null to skip */
     onAskSaveAfterPrompt?: (name: string, value: unknown, contextNames: string[]) => Promise<string | null>;
     /** When saveContextTo is "ask": (variableName, contextNames) => context name to save to */
@@ -66,9 +70,16 @@ interface ScenvVariableOptions<T> {
     validator?: (val: T) => ValidatorResult<T>;
     prompt?: PromptFn<T>;
 }
+/** Overrides for a single .get() or .safeGet() call. */
+interface GetOptions<T> {
+    /** Use this prompt for this call instead of the variable's prompt or callbacks.defaultPrompt. */
+    prompt?: PromptFn<T>;
+    /** Use this as the default for this call if no value from set/env/context. */
+    default?: T;
+}
 interface ScenvVariable<T> {
-    get(): Promise<T>;
-    safeGet(): Promise<{
+    get(options?: GetOptions<T>): Promise<T>;
+    safeGet(options?: GetOptions<T>): Promise<{
         success: true;
         value: T;
     } | {
@@ -86,4 +97,4 @@ declare function scenv<T>(name: string, options?: ScenvVariableOptions<T>): Scen
  */
 declare function parseScenvArgs(argv: string[]): Partial<ScenvConfig>;
 
-export { type PromptMode, type SavePromptMode, type ScenvCallbacks, type ScenvConfig, type ScenvVariable, configure, discoverContextPaths, getCallbacks, getContextValues, loadConfig, parseScenvArgs, resetConfig, scenv };
+export { type DefaultPromptFn, type GetOptions, type PromptMode, type SavePromptMode, type ScenvCallbacks, type ScenvConfig, type ScenvVariable, configure, discoverContextPaths, getCallbacks, getContextValues, loadConfig, parseScenvArgs, resetConfig, scenv };

package/dist/index.d.ts

@@ -20,7 +20,11 @@ interface ScenvConfig {
     /** Root directory for config/context search (default: cwd) */
     root?: string;
 }
+/** (name, defaultValue) => value; used when a variable has no prompt option. Overridable per variable. */
+type DefaultPromptFn = (name: string, defaultValue: unknown) => unknown | Promise<unknown>;
 interface ScenvCallbacks {
+    /** Default prompt when a variable does not provide its own `prompt`. Variable's `prompt` overrides this. */
+    defaultPrompt?: DefaultPromptFn;
     /** When user was just prompted for a value and savePrompt is ask/always: (variableName, value, contextNames) => context name to save to, or null to skip */
     onAskSaveAfterPrompt?: (name: string, value: unknown, contextNames: string[]) => Promise<string | null>;
     /** When saveContextTo is "ask": (variableName, contextNames) => context name to save to */
@@ -66,9 +70,16 @@ interface ScenvVariableOptions<T> {
     validator?: (val: T) => ValidatorResult<T>;
     prompt?: PromptFn<T>;
 }
+/** Overrides for a single .get() or .safeGet() call. */
+interface GetOptions<T> {
+    /** Use this prompt for this call instead of the variable's prompt or callbacks.defaultPrompt. */
+    prompt?: PromptFn<T>;
+    /** Use this as the default for this call if no value from set/env/context. */
+    default?: T;
+}
 interface ScenvVariable<T> {
-    get(): Promise<T>;
-    safeGet(): Promise<{
+    get(options?: GetOptions<T>): Promise<T>;
+    safeGet(options?: GetOptions<T>): Promise<{
         success: true;
         value: T;
     } | {
@@ -86,4 +97,4 @@ declare function scenv<T>(name: string, options?: ScenvVariableOptions<T>): Scen
  */
 declare function parseScenvArgs(argv: string[]): Partial<ScenvConfig>;
 
-export { type PromptMode, type SavePromptMode, type ScenvCallbacks, type ScenvConfig, type ScenvVariable, configure, discoverContextPaths, getCallbacks, getContextValues, loadConfig, parseScenvArgs, resetConfig, scenv };
+export { type DefaultPromptFn, type GetOptions, type PromptMode, type SavePromptMode, type ScenvCallbacks, type ScenvConfig, type ScenvVariable, configure, discoverContextPaths, getCallbacks, getContextValues, loadConfig, parseScenvArgs, resetConfig, scenv };

package/dist/index.js

@@ -208,26 +208,6 @@ function writeToContext(contextName, key, value) {
   writeFileSync(path, JSON.stringify(data, null, 2) + "\n", "utf-8");
 }
 
-// src/prompt-default.ts
-import { createInterface } from "readline";
-function defaultPrompt(name, defaultValue) {
-  const defaultStr = defaultValue !== void 0 && defaultValue !== null ? String(defaultValue) : "";
-  const message = defaultStr ? `Enter ${name} [${defaultStr}]: ` : `Enter ${name}: `;
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve, reject) => {
-    rl.question(message, (answer) => {
-      rl.close();
-      const trimmed = answer.trim();
-      const value = trimmed !== "" ? trimmed : defaultStr;
-      resolve(value);
-    });
-    rl.on("error", (err) => {
-      rl.close();
-      reject(err);
-    });
-  });
-}
-
 // src/variable.ts
 function defaultKeyFromName(name) {
   return name.toLowerCase().replace(/\s+/g, "_").replace(/[^a-z0-9_]/gi, "");
@@ -269,22 +249,29 @@ function scenv(name, options = {}) {
     if (mode === "no-env") return !hadEnv;
     return false;
   }
-  async function getResolvedValue() {
+  async function getResolvedValue(overrides) {
     const config = loadConfig();
     const raw = await resolveRaw();
     const hadEnv = !config.ignoreEnv && process.env[envKey] !== void 0 && process.env[envKey] !== "";
     const hadValue = raw !== void 0;
+    const effectiveDefault = overrides?.default !== void 0 ? overrides.default : defaultValue;
     let wasPrompted = false;
     let value;
     if (shouldPrompt(config, hadValue, hadEnv)) {
-      const defaultForPrompt = raw !== void 0 ? raw : defaultValue;
-      const fn = promptFn ?? defaultPrompt;
+      const callbacks = getCallbacks();
+      const fn = overrides?.prompt ?? promptFn ?? callbacks.defaultPrompt;
+      if (typeof fn !== "function") {
+        throw new Error(
+          `Prompt required for variable "${name}" (key: ${key}) but no prompt was supplied and no defaultPrompt callback is configured. Set a prompt on the variable or configure({ callbacks: { defaultPrompt: ... } }).`
+        );
+      }
+      const defaultForPrompt = raw !== void 0 ? raw : effectiveDefault;
       value = await Promise.resolve(fn(name, defaultForPrompt));
       wasPrompted = true;
     } else if (raw !== void 0) {
       value = raw;
-    } else if (defaultValue !== void 0) {
-      value = defaultValue;
+    } else if (effectiveDefault !== void 0) {
+      value = effectiveDefault;
     } else {
       throw new Error(`Missing value for variable "${name}" (key: ${key})`);
     }
@@ -303,8 +290,8 @@ function scenv(name, options = {}) {
       error: "error" in normalized ? normalized.error : void 0
     };
   }
-  async function get() {
-    const { value, wasPrompted } = await getResolvedValue();
+  async function get(options2) {
+    const { value, wasPrompted } = await getResolvedValue(options2);
     const validated = validate(value);
     if (!validated.success) {
       throw new Error(
@@ -318,7 +305,12 @@ function scenv(name, options = {}) {
       const shouldAskSave = savePrompt === "always" || savePrompt === "ask" && wasPrompted;
       if (shouldAskSave) {
         const callbacks = getCallbacks();
-        const ctxToSave = callbacks.onAskSaveAfterPrompt && await callbacks.onAskSaveAfterPrompt(
+        if (typeof callbacks.onAskSaveAfterPrompt !== "function") {
+          throw new Error(
+            `savePrompt is "${savePrompt}" but onAskSaveAfterPrompt callback is not set. Configure callbacks via configure({ callbacks: { onAskSaveAfterPrompt: ... } }).`
+          );
+        }
+        const ctxToSave = await callbacks.onAskSaveAfterPrompt(
           name,
           final,
           config.contexts ?? []
@@ -328,9 +320,9 @@ function scenv(name, options = {}) {
     }
     return final;
   }
-  async function safeGet() {
+  async function safeGet(options2) {
     try {
-      const v = await get();
+      const v = await get(options2);
       return { success: true, value: v };
     } catch (err) {
       return { success: false, error: err };
@@ -348,14 +340,15 @@ function scenv(name, options = {}) {
     let contextName = config.saveContextTo;
     if (contextName === "ask") {
       const callbacks = getCallbacks();
-      if (typeof callbacks.onAskContext === "function") {
-        contextName = await callbacks.onAskContext(
-          name,
-          config.contexts ?? []
+      if (typeof callbacks.onAskContext !== "function") {
+        throw new Error(
+          `saveContextTo is "ask" but onAskContext callback is not set. Configure callbacks via configure({ callbacks: { onAskContext: ... } }).`
         );
-      } else {
-        contextName = config.contexts?.[0] ?? "default";
       }
+      contextName = await callbacks.onAskContext(
+        name,
+        config.contexts ?? []
+      );
     }
     if (!contextName) contextName = config.contexts?.[0] ?? "default";
     writeToContext(contextName, key, String(validated.data));

package/package.json

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