scenv 0.1.1 → 0.2.1

package/dist/index.cjs

@@ -25,24 +25,24 @@ __export(index_exports, {
   getCallbacks: () => getCallbacks,
   getContextValues: () => getContextValues,
   loadConfig: () => loadConfig,
-  parseSenvArgs: () => parseSenvArgs,
+  parseScenvArgs: () => parseScenvArgs,
   resetConfig: () => resetConfig,
-  senv: () => senv
+  scenv: () => scenv
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/config.ts
 var import_node_fs = require("fs");
 var import_node_path = require("path");
-var CONFIG_FILENAME = "senv.config.json";
+var CONFIG_FILENAME = "scenv.config.json";
 var envKeyMap = {
-  SENV_CONTEXT: "contexts",
-  SENV_ADD_CONTEXTS: "addContexts",
-  SENV_PROMPT: "prompt",
-  SENV_IGNORE_ENV: "ignoreEnv",
-  SENV_IGNORE_CONTEXT: "ignoreContext",
-  SENV_SAVE_PROMPT: "savePrompt",
-  SENV_SAVE_CONTEXT_TO: "saveContextTo"
+  SCENV_CONTEXT: "contexts",
+  SCENV_ADD_CONTEXTS: "addContexts",
+  SCENV_PROMPT: "prompt",
+  SCENV_IGNORE_ENV: "ignoreEnv",
+  SCENV_IGNORE_CONTEXT: "ignoreContext",
+  SCENV_SAVE_PROMPT: "savePrompt",
+  SCENV_SAVE_CONTEXT_TO: "saveContextTo"
 };
 var programmaticConfig = {};
 var programmaticCallbacks = {};
@@ -269,7 +269,7 @@ function normalizeValidatorResult(result) {
   if (result.success === true) return result;
   return result;
 }
-function senv(name, options = {}) {
+function scenv(name, options = {}) {
   const key = options.key ?? defaultKeyFromName(name);
   const envKey = options.env ?? defaultEnvFromKey(key);
   const validator = options.validator;
@@ -305,7 +305,8 @@ function senv(name, options = {}) {
     let value;
     if (shouldPrompt(config, hadValue, hadEnv)) {
       const defaultForPrompt = raw !== void 0 ? raw : defaultValue;
-      const fn = promptFn ?? defaultPrompt;
+      const callbacks = getCallbacks();
+      const fn = promptFn ?? callbacks.defaultPrompt ?? defaultPrompt;
       value = await Promise.resolve(fn(name, defaultForPrompt));
       wasPrompted = true;
     } else if (raw !== void 0) {
@@ -391,7 +392,7 @@ function senv(name, options = {}) {
 }
 
 // src/cli-args.ts
-function parseSenvArgs(argv) {
+function parseScenvArgs(argv) {
   const config = {};
   let i = 0;
   while (i < argv.length) {
@@ -442,7 +443,7 @@ function parseSenvArgs(argv) {
   getCallbacks,
   getContextValues,
   loadConfig,
-  parseSenvArgs,
+  parseScenvArgs,
   resetConfig,
-  senv
+  scenv
 });

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 type PromptMode = "always" | "never" | "fallback" | "no-env";
 type SavePromptMode = "always" | "never" | "ask";
-interface SenvConfig {
+interface ScenvConfig {
     /** Replace all contexts with this list (CLI: --context a,b,c) */
     contexts?: string[];
     /** Merge these contexts with existing (CLI: --add-context a,b,c) */
@@ -20,22 +20,26 @@ interface SenvConfig {
     /** Root directory for config/context search (default: cwd) */
     root?: string;
 }
-interface SenvCallbacks {
+/** (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 */
     onAskContext?: (name: string, contextNames: string[]) => Promise<string>;
 }
-declare function getCallbacks(): SenvCallbacks;
+declare function getCallbacks(): ScenvCallbacks;
 /**
  * Load full config: file (from root or cwd) <- env <- programmatic. Precedence: programmatic > env > file.
  */
-declare function loadConfig(root?: string): SenvConfig;
+declare function loadConfig(root?: string): ScenvConfig;
 /**
  * Set programmatic config (e.g. from CLI flags). Merged on top of env and file in loadConfig().
  */
-declare function configure(partial: Partial<SenvConfig> & {
-    callbacks?: SenvCallbacks;
+declare function configure(partial: Partial<ScenvConfig> & {
+    callbacks?: ScenvCallbacks;
 }): void;
 /**
  * Reset programmatic config (mainly for tests).
@@ -59,14 +63,14 @@ type ValidatorResult<T> = boolean | {
     error?: unknown;
 };
 type PromptFn<T> = (name: string, defaultValue: T) => T | Promise<T>;
-interface SenvVariableOptions<T> {
+interface ScenvVariableOptions<T> {
     key?: string;
     env?: string;
     default?: T;
     validator?: (val: T) => ValidatorResult<T>;
     prompt?: PromptFn<T>;
 }
-interface SenvVariable<T> {
+interface ScenvVariable<T> {
     get(): Promise<T>;
     safeGet(): Promise<{
         success: true;
@@ -77,13 +81,13 @@ interface SenvVariable<T> {
     }>;
     save(value?: T): Promise<void>;
 }
-declare function senv<T>(name: string, options?: SenvVariableOptions<T>): SenvVariable<T>;
+declare function scenv<T>(name: string, options?: ScenvVariableOptions<T>): ScenvVariable<T>;
 
 /**
- * Parse argv (e.g. process.argv.slice(2)) into SenvConfig for configure().
+ * Parse argv (e.g. process.argv.slice(2)) into ScenvConfig for configure().
  * Supports: --context a,b,c --add-context x,y --prompt fallback --ignore-env --ignore-context
  * --set key=value --save-prompt ask --save-context-to prod
  */
-declare function parseSenvArgs(argv: string[]): Partial<SenvConfig>;
+declare function parseScenvArgs(argv: string[]): Partial<ScenvConfig>;
 
-export { type PromptMode, type SavePromptMode, type SenvCallbacks, type SenvConfig, type SenvVariable, configure, discoverContextPaths, getCallbacks, getContextValues, loadConfig, parseSenvArgs, resetConfig, senv };
+export { type DefaultPromptFn, type PromptMode, type SavePromptMode, type ScenvCallbacks, type ScenvConfig, type ScenvVariable, configure, discoverContextPaths, getCallbacks, getContextValues, loadConfig, parseScenvArgs, resetConfig, scenv };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 type PromptMode = "always" | "never" | "fallback" | "no-env";
 type SavePromptMode = "always" | "never" | "ask";
-interface SenvConfig {
+interface ScenvConfig {
     /** Replace all contexts with this list (CLI: --context a,b,c) */
     contexts?: string[];
     /** Merge these contexts with existing (CLI: --add-context a,b,c) */
@@ -20,22 +20,26 @@ interface SenvConfig {
     /** Root directory for config/context search (default: cwd) */
     root?: string;
 }
-interface SenvCallbacks {
+/** (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 */
     onAskContext?: (name: string, contextNames: string[]) => Promise<string>;
 }
-declare function getCallbacks(): SenvCallbacks;
+declare function getCallbacks(): ScenvCallbacks;
 /**
  * Load full config: file (from root or cwd) <- env <- programmatic. Precedence: programmatic > env > file.
  */
-declare function loadConfig(root?: string): SenvConfig;
+declare function loadConfig(root?: string): ScenvConfig;
 /**
  * Set programmatic config (e.g. from CLI flags). Merged on top of env and file in loadConfig().
  */
-declare function configure(partial: Partial<SenvConfig> & {
-    callbacks?: SenvCallbacks;
+declare function configure(partial: Partial<ScenvConfig> & {
+    callbacks?: ScenvCallbacks;
 }): void;
 /**
  * Reset programmatic config (mainly for tests).
@@ -59,14 +63,14 @@ type ValidatorResult<T> = boolean | {
     error?: unknown;
 };
 type PromptFn<T> = (name: string, defaultValue: T) => T | Promise<T>;
-interface SenvVariableOptions<T> {
+interface ScenvVariableOptions<T> {
     key?: string;
     env?: string;
     default?: T;
     validator?: (val: T) => ValidatorResult<T>;
     prompt?: PromptFn<T>;
 }
-interface SenvVariable<T> {
+interface ScenvVariable<T> {
     get(): Promise<T>;
     safeGet(): Promise<{
         success: true;
@@ -77,13 +81,13 @@ interface SenvVariable<T> {
     }>;
     save(value?: T): Promise<void>;
 }
-declare function senv<T>(name: string, options?: SenvVariableOptions<T>): SenvVariable<T>;
+declare function scenv<T>(name: string, options?: ScenvVariableOptions<T>): ScenvVariable<T>;
 
 /**
- * Parse argv (e.g. process.argv.slice(2)) into SenvConfig for configure().
+ * Parse argv (e.g. process.argv.slice(2)) into ScenvConfig for configure().
  * Supports: --context a,b,c --add-context x,y --prompt fallback --ignore-env --ignore-context
  * --set key=value --save-prompt ask --save-context-to prod
  */
-declare function parseSenvArgs(argv: string[]): Partial<SenvConfig>;
+declare function parseScenvArgs(argv: string[]): Partial<ScenvConfig>;
 
-export { type PromptMode, type SavePromptMode, type SenvCallbacks, type SenvConfig, type SenvVariable, configure, discoverContextPaths, getCallbacks, getContextValues, loadConfig, parseSenvArgs, resetConfig, senv };
+export { type DefaultPromptFn, type PromptMode, type SavePromptMode, type ScenvCallbacks, type ScenvConfig, type ScenvVariable, configure, discoverContextPaths, getCallbacks, getContextValues, loadConfig, parseScenvArgs, resetConfig, scenv };

package/dist/index.js

@@ -1,15 +1,15 @@
 // src/config.ts
 import { readFileSync, existsSync } from "fs";
 import { dirname, join } from "path";
-var CONFIG_FILENAME = "senv.config.json";
+var CONFIG_FILENAME = "scenv.config.json";
 var envKeyMap = {
-  SENV_CONTEXT: "contexts",
-  SENV_ADD_CONTEXTS: "addContexts",
-  SENV_PROMPT: "prompt",
-  SENV_IGNORE_ENV: "ignoreEnv",
-  SENV_IGNORE_CONTEXT: "ignoreContext",
-  SENV_SAVE_PROMPT: "savePrompt",
-  SENV_SAVE_CONTEXT_TO: "saveContextTo"
+  SCENV_CONTEXT: "contexts",
+  SCENV_ADD_CONTEXTS: "addContexts",
+  SCENV_PROMPT: "prompt",
+  SCENV_IGNORE_ENV: "ignoreEnv",
+  SCENV_IGNORE_CONTEXT: "ignoreContext",
+  SCENV_SAVE_PROMPT: "savePrompt",
+  SCENV_SAVE_CONTEXT_TO: "saveContextTo"
 };
 var programmaticConfig = {};
 var programmaticCallbacks = {};
@@ -242,7 +242,7 @@ function normalizeValidatorResult(result) {
   if (result.success === true) return result;
   return result;
 }
-function senv(name, options = {}) {
+function scenv(name, options = {}) {
   const key = options.key ?? defaultKeyFromName(name);
   const envKey = options.env ?? defaultEnvFromKey(key);
   const validator = options.validator;
@@ -278,7 +278,8 @@ function senv(name, options = {}) {
     let value;
     if (shouldPrompt(config, hadValue, hadEnv)) {
       const defaultForPrompt = raw !== void 0 ? raw : defaultValue;
-      const fn = promptFn ?? defaultPrompt;
+      const callbacks = getCallbacks();
+      const fn = promptFn ?? callbacks.defaultPrompt ?? defaultPrompt;
       value = await Promise.resolve(fn(name, defaultForPrompt));
       wasPrompted = true;
     } else if (raw !== void 0) {
@@ -364,7 +365,7 @@ function senv(name, options = {}) {
 }
 
 // src/cli-args.ts
-function parseSenvArgs(argv) {
+function parseScenvArgs(argv) {
   const config = {};
   let i = 0;
   while (i < argv.length) {
@@ -414,7 +415,7 @@ export {
   getCallbacks,
   getContextValues,
   loadConfig,
-  parseSenvArgs,
+  parseScenvArgs,
   resetConfig,
-  senv
+  scenv
 };

package/package.json

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