awt-prompt 1.0.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mourão
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,112 @@
+# Awt-Prompt
+
+**Simple async prompt for Node.js using modern ES modules**
+
+Node.js does not provide a built in `prompt()` like browsers.
+This tiny package gives you a clean, promise based solution that works perfectly with `async/await`.
+
+---
+
+## Installation
+
+Install directly from GitHub:
+
+```bash
+npm install github:MouraoDev22/awt-prompt
+```
+
+Or from npm
+
+```bash
+npm install awt-prompt
+```
+
+---
+
+## Requirements
+
+Node.js **18+ recommended**
+
+Your project must use ES modules. Add this to your `package.json`:
+
+```json
+{
+  "type": "module"
+}
+```
+
+---
+
+## Quick Start
+
+```js
+import prompt from 'awt-prompt';
+
+const name = await prompt('What is your name?');
+console.log(`Hello ${name}`);
+```
+
+The function always returns a **string**.
+
+---
+
+## Working With Numbers
+
+```js
+import prompt from 'awt-prompt';
+
+const age = Number(await prompt('Your age:'));
+console.log(age);
+```
+
+---
+
+## Example With Validation
+
+```js
+import prompt from 'awt-prompt';
+
+async function getPositiveNumber() {
+  let value = Number(await prompt('Enter a number:'));
+
+  while (isNaN(value) || value <= 0) {
+    value = Number(await prompt('Invalid input. Enter a valid number:'));
+  }
+
+  return value;
+}
+
+const number = await getPositiveNumber();
+console.log(number);
+```
+
+---
+
+## Why This Exists
+
+Browsers have `prompt()`.
+Node.js does not.
+
+This package provides a minimal, modern and promise based alternative using `readline`.
+
+No setup. No boilerplate. Just ask and get input.
+
+---
+
+## API
+
+### `prompt(question)`
+
+| Parameter | Type   | Description                |
+| --------- | ------ | -------------------------- |
+| question  | string | Text shown in the terminal |
+
+**Returns:** `Promise<string>`
+
+---
+
+## License
+
+MIT License
+
+---

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "awt-prompt",
+  "version": "1.0.4",
+  "type": "module",
+  "main": "./prompt.js",
+  "exports": "./prompt.js",
+  "description": "Simple prompt method for Node.js",
+  "author": "Mourão",
+  "license": "MIT",
+  "files": [
+    "prompt.js"
+  ],
+  "keywords": [
+    "prompt",
+    "cli",
+    "input",
+    "terminal",
+    "node"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MouraoDev22/awt-prompt.git"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/prompt.js

@@ -0,0 +1,15 @@
+import readline from 'readline';
+
+export default function prompt(question) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  return new Promise((resolve) => {
+    rl.question(question + ' ', (answer) => {
+      rl.close();
+      resolve(answer);
+    });
+  });
+};