scenv-inquirer 0.3.2 → 0.4.0

package/README.md

@@ -1,8 +1,8 @@
 # scenv-inquirer
 
-Inquirer-based prompts for [scenv](https://www.npmjs.com/package/scenv): variable prompts and save/context callbacks.
+Inquirer-based prompts for [scenv](https://www.npmjs.com/package/scenv): variable prompts (and optional default prompt callback).
 
-Use with scenv when you want interactive prompts for variable values and for "save to context?" / "which context?" flows.
+Use with scenv when you want interactive prompts for variable values. Saving is controlled by scenv's `saveContextTo` config (path or context name); there are no "save?" or "which context?" callbacks in scenv.
 
 ## Install
 
@@ -45,11 +45,7 @@ configure({ callbacks: { defaultPrompt: prompt() } });
 
 Variable-level `prompt` overrides this default.
 
-### Save and context callbacks
-
-`askSaveAfterPrompt()` and `askContext()` return functions for scenv's `onAskSaveAfterPrompt` and `onAskContext` callbacks. Use them when `SCENV_SAVE_PROMPT=ask` or `saveContextTo: "ask"`.
-
-**`callbacks()`** wires all of the above in one go:
+**`callbacks()`** returns an object you can pass to `configure()` so all variables use inquirer when they need a value:
 
 ```ts
 import { configure } from "scenv";
@@ -60,20 +56,14 @@ configure(callbacks());
 configure({ ...yourConfig, ...callbacks() });
 ```
 
-This sets:
-
-- **defaultPrompt** – inquirer for variable values when no value is resolved
-- **onAskSaveAfterPrompt** – "Save '{name}' for next time?" then "Which context?"
-- **onAskContext** – "Save to which context?" (list or new)
+This sets **defaultPrompt** so variable values are prompted via inquirer when no value is resolved from set/env/context.
 
 ## API
 
 | Export | Description |
 |--------|-------------|
 | `prompt()` | Returns `(name, defaultValue) => Promise<T>` for use as variable `prompt` or `callbacks.defaultPrompt`. |
-| `askSaveAfterPrompt()` | Returns `onAskSaveAfterPrompt`: asks whether to save and which context. |
-| `askContext()` | Returns `onAskContext`: asks which context to save to. |
-| `callbacks()` | Returns `{ callbacks: { defaultPrompt, onAskSaveAfterPrompt, onAskContext } }`. |
+| `callbacks()` | Returns `{ callbacks: { defaultPrompt } }` for use with `configure()`. |
 
 ## License
 

package/dist/index.cjs

@@ -30,15 +30,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  askContext: () => askContext,
-  askSaveAfterPrompt: () => askSaveAfterPrompt,
   callbacks: () => callbacks,
   prompt: () => prompt
 });
 module.exports = __toCommonJS(index_exports);
 var import_inquirer = __toESM(require("inquirer"), 1);
 function prompt() {
-  return async (name, defaultValue) => {
+  return (async (name, defaultValue) => {
     const defaultStr = defaultValue !== void 0 && defaultValue !== null ? String(defaultValue) : "";
     const { value } = await import_inquirer.default.prompt([
       {
@@ -49,74 +47,13 @@ function prompt() {
       }
     ]);
     return value;
-  };
-}
-function askSaveAfterPrompt() {
-  return async (name, _value, contextNames) => {
-    const { save } = await import_inquirer.default.prompt([
-      {
-        type: "confirm",
-        name: "save",
-        message: `Save "${name}" for next time?`,
-        default: true
-      }
-    ]);
-    if (!save) return null;
-    const choices = [...contextNames];
-    if (choices.length === 0) choices.push("default");
-    choices.push("(new context)");
-    const { context } = await import_inquirer.default.prompt([
-      {
-        type: "list",
-        name: "context",
-        message: "Which context?",
-        choices
-      }
-    ]);
-    if (context === "(new context)") {
-      const { newContext } = await import_inquirer.default.prompt([
-        { type: "input", name: "newContext", message: "Context name:", default: "default" }
-      ]);
-      return newContext.trim() || "default";
-    }
-    return context;
-  };
-}
-function askContext() {
-  return async (name, contextNames) => {
-    const choices = [...contextNames];
-    if (choices.length === 0) choices.push("default");
-    choices.push("(new context)");
-    const { context } = await import_inquirer.default.prompt([
-      {
-        type: "list",
-        name: "context",
-        message: `Save "${name}" to which context?`,
-        choices
-      }
-    ]);
-    if (context === "(new context)") {
-      const { newContext } = await import_inquirer.default.prompt([
-        { type: "input", name: "newContext", message: "Context name:", default: "default" }
-      ]);
-      return newContext.trim() || "default";
-    }
-    return context;
-  };
+  });
 }
 function callbacks() {
-  return {
-    callbacks: {
-      defaultPrompt: prompt(),
-      onAskSaveAfterPrompt: askSaveAfterPrompt(),
-      onAskContext: askContext()
-    }
-  };
+  return { callbacks: { defaultPrompt: prompt() } };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  askContext,
-  askSaveAfterPrompt,
   callbacks,
   prompt
 });

package/dist/index.d.cts

@@ -1,30 +1,33 @@
+import { ScenvCallbacks, DefaultPromptFn } from 'scenv';
+
 /**
- * Returns a prompt function for use with scenv(): (name, defaultValue) => Promise<T>.
- * Scenv passes the variable name and default (from env/context/default); this uses inquirer to ask for input.
- * Returns string; use a validator (e.g. scenv-zod) for type/coercion.
- */
-declare function prompt<T = string>(): (name: string, defaultValue: T) => Promise<T>;
-/**
- * Returns a function suitable for scenv's onAskSaveAfterPrompt callback.
- * Asks "Save '{name}' for next time?" and, if yes, "Which context?" (from contextNames or new).
- * @returns Context name to save to, or null to skip saving
- */
-declare function askSaveAfterPrompt(): (name: string, value: unknown, contextNames: string[]) => Promise<string | null>;
-/**
- * Returns a function suitable for scenv's onAskContext callback.
- * Asks user to choose a context from contextNames or enter a new one.
+ * Returns an inquirer-based prompt function for use with scenv variables. Use as the
+ * variable's `prompt` option or as `callbacks.defaultPrompt`. Scenv calls it with the
+ * variable name and default value when prompting; this shows an inquirer input prompt.
+ * Returned value is a string; use a validator (e.g. scenv-zod) for type coercion.
+ *
+ * @typeParam T - Value type (default string). Cast or validate in your validator.
+ * @returns A function `(name, defaultValue) => Promise<T>` suitable for scenv's prompt or defaultPrompt.
+ *
+ * @example
+ * const apiUrl = scenv("API URL", { default: "http://localhost:4000", prompt: prompt() });
+ * const url = await apiUrl.get(); // prompts via inquirer if no env/context
  */
-declare function askContext(): (name: string, contextNames: string[]) => Promise<string>;
+declare function prompt<T = string>(): DefaultPromptFn;
 /**
- * Returns an object suitable for scenv's configure(): { callbacks: { defaultPrompt, onAskSaveAfterPrompt, onAskContext } }.
- * Use as configure(callbacks()) or configure({ ...config, ...callbacks() }) to wire a default inquirer prompt for variables and save/context prompts via inquirer. Variable-level prompt overrides defaultPrompt.
+ * Returns an object with the defaultPrompt callback for scenv. Pass to {@link configure}
+ * to use inquirer for variable prompts. Variable-level `prompt` overrides defaultPrompt.
+ *
+ * @returns `{ callbacks: { defaultPrompt } }` – spread into configure() or merge with other config.
+ *
+ * @example
+ * import { configure } from "scenv";
+ * import { callbacks } from "scenv-inquirer";
+ * configure(callbacks());
+ * // or: configure({ ...parseScenvArgs(process.argv.slice(2)), ...callbacks() });
  */
 declare function callbacks(): {
-    callbacks: {
-        defaultPrompt: ReturnType<typeof prompt>;
-        onAskSaveAfterPrompt: ReturnType<typeof askSaveAfterPrompt>;
-        onAskContext: ReturnType<typeof askContext>;
-    };
+    callbacks: ScenvCallbacks;
 };
 
-export { askContext, askSaveAfterPrompt, callbacks, prompt };
+export { callbacks, prompt };

package/dist/index.d.ts

@@ -1,30 +1,33 @@
+import { ScenvCallbacks, DefaultPromptFn } from 'scenv';
+
 /**
- * Returns a prompt function for use with scenv(): (name, defaultValue) => Promise<T>.
- * Scenv passes the variable name and default (from env/context/default); this uses inquirer to ask for input.
- * Returns string; use a validator (e.g. scenv-zod) for type/coercion.
- */
-declare function prompt<T = string>(): (name: string, defaultValue: T) => Promise<T>;
-/**
- * Returns a function suitable for scenv's onAskSaveAfterPrompt callback.
- * Asks "Save '{name}' for next time?" and, if yes, "Which context?" (from contextNames or new).
- * @returns Context name to save to, or null to skip saving
- */
-declare function askSaveAfterPrompt(): (name: string, value: unknown, contextNames: string[]) => Promise<string | null>;
-/**
- * Returns a function suitable for scenv's onAskContext callback.
- * Asks user to choose a context from contextNames or enter a new one.
+ * Returns an inquirer-based prompt function for use with scenv variables. Use as the
+ * variable's `prompt` option or as `callbacks.defaultPrompt`. Scenv calls it with the
+ * variable name and default value when prompting; this shows an inquirer input prompt.
+ * Returned value is a string; use a validator (e.g. scenv-zod) for type coercion.
+ *
+ * @typeParam T - Value type (default string). Cast or validate in your validator.
+ * @returns A function `(name, defaultValue) => Promise<T>` suitable for scenv's prompt or defaultPrompt.
+ *
+ * @example
+ * const apiUrl = scenv("API URL", { default: "http://localhost:4000", prompt: prompt() });
+ * const url = await apiUrl.get(); // prompts via inquirer if no env/context
  */
-declare function askContext(): (name: string, contextNames: string[]) => Promise<string>;
+declare function prompt<T = string>(): DefaultPromptFn;
 /**
- * Returns an object suitable for scenv's configure(): { callbacks: { defaultPrompt, onAskSaveAfterPrompt, onAskContext } }.
- * Use as configure(callbacks()) or configure({ ...config, ...callbacks() }) to wire a default inquirer prompt for variables and save/context prompts via inquirer. Variable-level prompt overrides defaultPrompt.
+ * Returns an object with the defaultPrompt callback for scenv. Pass to {@link configure}
+ * to use inquirer for variable prompts. Variable-level `prompt` overrides defaultPrompt.
+ *
+ * @returns `{ callbacks: { defaultPrompt } }` – spread into configure() or merge with other config.
+ *
+ * @example
+ * import { configure } from "scenv";
+ * import { callbacks } from "scenv-inquirer";
+ * configure(callbacks());
+ * // or: configure({ ...parseScenvArgs(process.argv.slice(2)), ...callbacks() });
  */
 declare function callbacks(): {
-    callbacks: {
-        defaultPrompt: ReturnType<typeof prompt>;
-        onAskSaveAfterPrompt: ReturnType<typeof askSaveAfterPrompt>;
-        onAskContext: ReturnType<typeof askContext>;
-    };
+    callbacks: ScenvCallbacks;
 };
 
-export { askContext, askSaveAfterPrompt, callbacks, prompt };
+export { callbacks, prompt };

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/index.ts
 import inquirer from "inquirer";
 function prompt() {
-  return async (name, defaultValue) => {
+  return (async (name, defaultValue) => {
     const defaultStr = defaultValue !== void 0 && defaultValue !== null ? String(defaultValue) : "";
     const { value } = await inquirer.prompt([
       {
@@ -12,73 +12,12 @@ function prompt() {
       }
     ]);
     return value;
-  };
-}
-function askSaveAfterPrompt() {
-  return async (name, _value, contextNames) => {
-    const { save } = await inquirer.prompt([
-      {
-        type: "confirm",
-        name: "save",
-        message: `Save "${name}" for next time?`,
-        default: true
-      }
-    ]);
-    if (!save) return null;
-    const choices = [...contextNames];
-    if (choices.length === 0) choices.push("default");
-    choices.push("(new context)");
-    const { context } = await inquirer.prompt([
-      {
-        type: "list",
-        name: "context",
-        message: "Which context?",
-        choices
-      }
-    ]);
-    if (context === "(new context)") {
-      const { newContext } = await inquirer.prompt([
-        { type: "input", name: "newContext", message: "Context name:", default: "default" }
-      ]);
-      return newContext.trim() || "default";
-    }
-    return context;
-  };
-}
-function askContext() {
-  return async (name, contextNames) => {
-    const choices = [...contextNames];
-    if (choices.length === 0) choices.push("default");
-    choices.push("(new context)");
-    const { context } = await inquirer.prompt([
-      {
-        type: "list",
-        name: "context",
-        message: `Save "${name}" to which context?`,
-        choices
-      }
-    ]);
-    if (context === "(new context)") {
-      const { newContext } = await inquirer.prompt([
-        { type: "input", name: "newContext", message: "Context name:", default: "default" }
-      ]);
-      return newContext.trim() || "default";
-    }
-    return context;
-  };
+  });
 }
 function callbacks() {
-  return {
-    callbacks: {
-      defaultPrompt: prompt(),
-      onAskSaveAfterPrompt: askSaveAfterPrompt(),
-      onAskContext: askContext()
-    }
-  };
+  return { callbacks: { defaultPrompt: prompt() } };
 }
 export {
-  askContext,
-  askSaveAfterPrompt,
   callbacks,
   prompt
 };

package/package.json

@@ -1,24 +1,20 @@
 {
   "name": "scenv-inquirer",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "Inquirer prompt for scenv variables",
-  "repository": { "type": "git", "url": "https://github.com/PKWadsy/scenv" },
-  "publishConfig": { "access": "public", "provenance": true },
+  "repository": {"type": "git", "url": "https://github.com/PKWadsy/scenv"},
+  "publishConfig": {"access": "public", "provenance": true},
   "keywords": ["scenv", "inquirer", "prompt"],
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs",
-      "types": "./dist/index.d.ts"
-    }
-  },
+  "exports": {".": {"import": "./dist/index.js", "require": "./dist/index.cjs", "types": "./dist/index.d.ts"}},
   "files": ["dist"],
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean"
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "peerDependencies": {
     "inquirer": "^8.0.0 || ^9.0.0",
@@ -29,6 +25,7 @@
     "inquirer": "^9.2.0",
     "scenv": "workspace:*",
     "tsup": "^8.0.0",
-    "typescript": "^5.3.0"
+    "typescript": "^5.3.0",
+    "vitest": "^2.0.0"
   }
 }