@purpleproser/soundboard-downloader-cli 1.0.0

package/README.md

@@ -0,0 +1,173 @@
+# @purpleproser/soundboard-downloader-cli
+
+A command-line tool to download soundboard sounds from MyInstants.
+
+**npm Package**: `@purpleproser/soundboard-downloader-cli`
+**GitHub Repository**: [blacksagres/soundboard-downloader-cli](https://github.com/blacksagres/soundboard-downloader-cli) Built with TypeScript and Node.js.
+
+## Features
+
+- 🔍 Search for sounds by name using interactive prompts
+- 🎵 Preview sounds by playing them in your browser
+- ⬇️ Download individual sounds to your local machine
+- ✨ Simple and easy-to-use interactive interface
+
+## Tech Stack
+
+- **TypeScript** - Type-safe development
+- **Node.js** - Runtime environment
+- **Inquirer** - Interactive CLI prompts
+- **jsdom** - HTML parsing and DOM manipulation
+- **ora** - Elegant terminal spinners
+- **open** - Opens URLs in the user's browser
+
+## Prerequisites
+
+- Node.js 16.x or higher
+
+## Installation
+
+### Local Installation
+
+1. Clone this repository:
+
+   ```bash
+   git clone https://github.com/blacksagres/soundboard-downloader-cli.git
+   ```
+
+2. Navigate to the project directory:
+
+   ```bash
+   cd soundboard-downloader-cli
+   ```
+
+3. Install dependencies:
+
+   ```bash
+   npm install
+   ```
+
+### Global Installation
+
+Install globally to use the `soundboard-downloader` command anywhere:
+
+```bash
+npm install -g @purpleproser/soundboard-downloader-cli
+```
+
+Or from the project directory:
+
+```bash
+npm link
+```
+
+**Note**: This package uses the `@purpleproser` npm scope (my npm username) while the GitHub repository remains under `blacksagres`. Make sure to include the `@purpleproser/` prefix when installing!
+
+**For Developers**: If you fork this project and want to publish your own version, either:
+1. Use a different package name, or
+2. Create your own npm scope and update the package name, or
+3. Add `"publishConfig": { "access": "public" }` to your package.json
+
+## Usage
+
+### Development Mode
+
+Run directly with ts-node (no build required):
+
+```bash
+npm start
+```
+
+### Production Build
+
+Build the TypeScript project:
+
+```bash
+npm run build
+```
+
+Then run the compiled JavaScript:
+
+```bash
+node dist/main.js
+```
+
+### Global Command
+
+If installed globally:
+
+```bash
+soundboard-downloader
+```
+
+### Interactive Workflow
+
+The CLI will guide you through an interactive process:
+
+1. **Search**: You'll be prompted to enter what sound effects you're looking for
+2. **Select**: Choose from the list of matching sounds
+3. **Action**: Decide whether to play the sound in your browser or download it to your `./temp/` directory
+
+### Example Workflow
+
+```bash
+$ npm start
+
+? What sound effects are you looking for? wilhelm scream
+✔ Loading result...
+? Which one to download? (Use arrow keys)
+  > Wilhelm Scream - Original
+    Wilhelm Scream - Remastered
+    Wilhelm Scream - Short Version
+? Selected: Wilhelm Scream - Original
+? (Use arrow keys)
+  > Download
+    Play
+```
+
+## Development
+
+### Project Structure
+
+```
+src/
+├── main.ts                          # Entry point
+├── api/
+│   └── my-instants.api.ts          # API layer for MyInstants
+├── components/                      # CLI components
+└── service/
+    └── my-instants.service.ts      # Business logic
+```
+
+### Available Scripts
+
+- `npm start` - Run in development mode with ts-node
+- `npm run build` - Compile TypeScript to JavaScript
+- `npm test` - Run tests (not yet implemented)
+
+### Download Location
+
+Downloaded sounds are saved to the `./temp/` directory in the project root.
+
+## Contributing
+
+Contributions are welcome! Please open an issue or submit a pull request.
+
+## Legal Disclaimer
+
+**Important Notice About Copyright and Usage:**
+
+This tool is an automation layer that simulates what a real user would do manually on the MyInstants website. It uses the official download functionality provided by MyInstants and does not bypass any restrictions or access protected content.
+
+**User Responsibility:**
+
+- You are solely responsible for ensuring that your use of downloaded content complies with all applicable laws and MyInstants' Terms of Service
+- This application is not responsible for any copyright infringement that may occur through the use of downloaded audio files
+- Many sound effects may be copyrighted - check the specific rights and licenses for each sound before using it
+
+**Experimental Nature:**
+This project is a simple experiment with Node.js and CLI development. It is provided "as is" without warranty of any kind. The developers are not affiliated with MyInstants and cannot guarantee the continued functionality of this tool.
+
+## License
+
+This project is licensed under the MIT License.

package/dist/api/my-instants.api.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Fetch the html from myinstants.com.
+ *
+ * 1. Query the html for the sound based on name
+ * 2 .Then find the corresponding link to that sound
+ * 3. Transform the found html nodes to an object with `{ label: string, download_url: string }`
+ * 4. List them in the console - a user can pick one of the list (search in terminal)
+ * 5. Download the sound (donwload folder from the user)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNodeDownloadPage = exports.getSoundNodes = void 0;
+const getSoundNodes = async (searchString) => {
+    let page = 1;
+    const result = [];
+    const escapedSearchParam = encodeURIComponent(searchString);
+    /**
+     * Yeah so that page does a little trick to make an infinite scroll.
+     *
+     * Whenever you hit the page in your browser, there's a script that will try to fetch the next page and
+     * append the results to the current one, until it hits a 404 (ran out of pages). Here we try to do the same.
+     *
+     * One idea was to append this all into one string document but we just return 1 array with all
+     * the pages we found. Then he service layer can crunch on this to determine what to pick.
+     */
+    while (true) {
+        const url = `https://www.myinstants.com/en/search/?name=${escapedSearchParam}&page=${page}`;
+        const response = await fetch(url);
+        if (response.ok) {
+            const htmlResult = await response.text();
+            result.push(htmlResult);
+            page++;
+            continue;
+        }
+        break;
+    }
+    return result;
+};
+exports.getSoundNodes = getSoundNodes;
+const getNodeDownloadPage = async (soundNodeDetailsURL) => {
+    const root = `https://www.myinstants.com${soundNodeDetailsURL}`;
+    const response = await fetch(root);
+    return await response.text();
+};
+exports.getNodeDownloadPage = getNodeDownloadPage;
+//# sourceMappingURL=my-instants.api.js.map

package/dist/api/my-instants.api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"my-instants.api.js","sourceRoot":"","sources":["../../src/api/my-instants.api.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEI,MAAM,aAAa,GAAG,KAAK,EAAE,YAAoB,EAAE,EAAE;IAC1D,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,MAAM,GAAkB,EAAE,CAAC;IAEjC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAE5D;;;;;;;;OAQG;IAEH,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,8CAA8C,kBAAkB,SAAS,IAAI,EAAE,CAAC;QAC5F,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAExB,IAAI,EAAE,CAAC;YAEP,SAAS;QACX,CAAC;QAED,MAAM;IACR,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAjCW,QAAA,aAAa,iBAiCxB;AAEK,MAAM,mBAAmB,GAAG,KAAK,EAAE,mBAA2B,EAAE,EAAE;IACvE,MAAM,IAAI,GAAG,6BAA6B,mBAAmB,EAAE,CAAC;IAEhE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IAEnC,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;AAC/B,CAAC,CAAC;AANW,QAAA,mBAAmB,uBAM9B"}

package/dist/main.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const my_instants_service_1 = require("./service/my-instants.service");
+const ora_1 = require("ora");
+const prompts_1 = require("@inquirer/prompts");
+const open_1 = require("open");
+const file_downloader_service_1 = require("./service/file-downloader.service");
+(async function () {
+    const answer = await (0, prompts_1.input)({
+        message: "What sound effects are you looking for?",
+    });
+    const spinner = (0, ora_1.default)({
+        text: "Loading result...",
+        color: "magenta",
+        spinner: "bouncingBall",
+    }).start();
+    const sounds = await (0, my_instants_service_1.getSoundNodes)(answer);
+    spinner.stop();
+    const selection = await (0, prompts_1.select)({
+        message: "Which one to download?",
+        choices: sounds.map((sound) => ({
+            name: sound.label,
+            value: `${sound.label}||${sound.download_url}`,
+        })),
+    });
+    const [label, downloadUrl] = selection.split("||");
+    if (!downloadUrl) {
+        throw new ReferenceError(`There is no download URL for: ${label}`);
+    }
+    const actions = [
+        {
+            name: "Download",
+            value: "action:download",
+        },
+        {
+            name: "Play",
+            value: "action:play",
+        },
+    ];
+    const action = await (0, prompts_1.select)({
+        message: `Selected: ${label}`,
+        choices: actions,
+    });
+    if (action === "action:play") {
+        (0, open_1.default)(downloadUrl);
+    }
+    if (action === "action:download") {
+        const downloadSpinner = (0, ora_1.default)({
+            text: "Downloading file...",
+            color: "cyan",
+            spinner: "growHorizontal",
+        }).start();
+        const downloadFileName = downloadUrl.split("/").pop();
+        (0, file_downloader_service_1.downloadFile)(downloadUrl, {
+            destination: `./temp/${downloadFileName}`,
+            onStart: () => downloadSpinner.start(),
+            onFinish: () => downloadSpinner.stop(),
+        });
+    }
+})();
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";;;AAEA,uEAA8D;AAC9D,6BAAsB;AACtB,+CAAkD;AAClD,+BAAwB;AACxB,+EAAiE;AAEjE,CAAC,KAAK;IACJ,MAAM,MAAM,GAAG,MAAM,IAAA,eAAK,EAAC;QACzB,OAAO,EAAE,yCAAyC;KACnD,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,IAAA,aAAG,EAAC;QAClB,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC,KAAK,EAAE,CAAC;IAEX,MAAM,MAAM,GAAG,MAAM,IAAA,mCAAa,EAAC,MAAM,CAAC,CAAC;IAE3C,OAAO,CAAC,IAAI,EAAE,CAAC;IAEf,MAAM,SAAS,GAAG,MAAM,IAAA,gBAAM,EAAC;QAC7B,OAAO,EAAE,wBAAwB;QACjC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC9B,IAAI,EAAE,KAAK,CAAC,KAAK;YACjB,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,YAAY,EAAW;SACxD,CAAC,CAAC;KACJ,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEnD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,cAAc,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,OAAO,GAAG;QACd;YACE,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,iBAAiB;SACzB;QACD;YACE,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,aAAa;SACrB;KACO,CAAC;IAEX,MAAM,MAAM,GAAG,MAAM,IAAA,gBAAM,EAAC;QAC1B,OAAO,EAAE,aAAa,KAAK,EAAE;QAC7B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC7B,IAAA,cAAI,EAAC,WAAW,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,MAAM,KAAK,iBAAiB,EAAE,CAAC;QACjC,MAAM,eAAe,GAAG,IAAA,aAAG,EAAC;YAC1B,IAAI,EAAE,qBAAqB;YAC3B,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,gBAAgB;SAC1B,CAAC,CAAC,KAAK,EAAE,CAAC;QAEX,MAAM,gBAAgB,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QAEtD,IAAA,sCAAY,EAAC,WAAW,EAAE;YACxB,WAAW,EAAE,UAAU,gBAAgB,EAAE;YACzC,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE;YACtC,QAAQ,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE;SACvC,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,EAAE,CAAC"}

package/dist/service/file-downloader.service.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadFile = void 0;
+const https = require("https");
+const fs = require("fs");
+const downloadFile = (url, config) => {
+    const file = fs.createWriteStream(config.destination);
+    https.get(url, function (response) {
+        response.pipe(file);
+        file.on("open", () => {
+            config.onStart?.();
+        });
+        file.on("finish", () => {
+            file.close();
+            config.onFinish?.();
+            console.log("Download Completed");
+        });
+    });
+};
+exports.downloadFile = downloadFile;
+//# sourceMappingURL=file-downloader.service.js.map

package/dist/service/file-downloader.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-downloader.service.js","sourceRoot":"","sources":["../../src/service/file-downloader.service.ts"],"names":[],"mappings":";;;AAAA,+BAA+B;AAC/B,yBAAyB;AAElB,MAAM,YAAY,GAAG,CAC1B,GAAW,EACX,MAIC,EACD,EAAE;IACF,MAAM,IAAI,GAAG,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEtD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,QAAQ;QAC/B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpB,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YACnB,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACrB,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAvBW,QAAA,YAAY,gBAuBvB"}

package/dist/service/my-instants.service.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSoundNodes = void 0;
+const my_instants_api_1 = require("../api/my-instants.api");
+const jsdom = require("jsdom");
+const getDownloadUrl = async (originalUrl) => {
+    if (!originalUrl) {
+        return "not-found";
+    }
+    /**
+     * For example, this is what the url looks like from the link:
+     *
+     * '/en/instant/nemesis-resident-evil-3-stars/'
+     *
+     * And we want it to be like this:
+     *
+     * 'nemesis-resident-evil-3-stars'
+     *
+     * To eventually combine with the download url template and make a final link.
+     */
+    const cleanSoundName = originalUrl
+        .replace("/en/instant/", "")
+        .replace("/", "");
+    const downloadPage = await (0, my_instants_api_1.getNodeDownloadPage)(originalUrl);
+    const downloadLink = Array.from(new jsdom.JSDOM(downloadPage).window.document.querySelectorAll("a")).find((node) => {
+        return node.href.includes(".mp3") && node.hasAttribute("download");
+    });
+    if (downloadLink) {
+        return `https://www.myinstants.com${downloadLink.href}`;
+    }
+    return "not-found";
+};
+const getSoundNodes = async (searchString) => {
+    const result = await (0, my_instants_api_1.getSoundNodes)(searchString);
+    const allLabels = [];
+    const allDownloadLinks = [];
+    for (const page of result) {
+        const document = new jsdom.JSDOM(page);
+        document.window.document
+            .querySelectorAll("div.instant > a.instant-link")
+            .forEach((node) => {
+            allLabels.push(node.textContent);
+            allDownloadLinks.push(getDownloadUrl(node.getAttribute("href")));
+        });
+    }
+    const allLinksResolved = await Promise.all(allDownloadLinks);
+    const finalList = allLabels.map((label, index) => ({
+        label,
+        download_url: allLinksResolved[index] ?? "not-found",
+    }));
+    return finalList.toSorted((a, b) => a.label.localeCompare(b.label));
+};
+exports.getSoundNodes = getSoundNodes;
+//# sourceMappingURL=my-instants.service.js.map

package/dist/service/my-instants.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"my-instants.service.js","sourceRoot":"","sources":["../../src/service/my-instants.service.ts"],"names":[],"mappings":";;;AAAA,4DAGgC;AAChC,+BAA+B;AAE/B,MAAM,cAAc,GAAG,KAAK,EAAE,WAA0B,EAAE,EAAE;IAC1D,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,cAAc,GAAG,WAAW;SAC/B,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAEpB,MAAM,YAAY,GAAG,MAAM,IAAA,qCAAmB,EAAC,WAAW,CAAC,CAAC;IAE5D,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAC7B,IAAI,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,CACpE,CAAC,IAAI,CAAC,CAAC,IAAuB,EAAE,EAAE;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,6BAA6B,YAAY,CAAC,IAAI,EAAE,CAAC;IAC1D,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC;AAEK,MAAM,aAAa,GAAG,KAAK,EAAE,YAAoB,EAAE,EAAE;IAC1D,MAAM,MAAM,GAAG,MAAM,IAAA,+BAAgB,EAAC,YAAY,CAAC,CAAC;IAEpD,MAAM,SAAS,GAAkB,EAAE,CAAC;IACpC,MAAM,gBAAgB,GAA2B,EAAE,CAAC;IAEpD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEvC,QAAQ,CAAC,MAAM,CAAC,QAAQ;aACrB,gBAAgB,CAAC,8BAA8B,CAAC;aAChD,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAChB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACjC,gBAAgB,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;IACP,CAAC;IAED,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAE7D,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACjD,KAAK;QACL,YAAY,EAAE,gBAAgB,CAAC,KAAK,CAAC,IAAI,WAAW;KACrD,CAAC,CAAC,CAAC;IAEJ,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AACtE,CAAC,CAAC;AAzBW,QAAA,aAAa,iBAyBxB"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@purpleproser/soundboard-downloader-cli",
+  "version": "1.0.0",
+  "description": "Easily download sounds from myinstants.com using this interactive CLI tool",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "blacksagres",
+  "type": "commonjs",
+  "main": "dist/main.js",
+  "bin": {
+    "soundboard-downloader": "./dist/main.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "start": "ts-node ./src/main.ts",
+    "build": "tsc",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "soundboard",
+    "myinstants",
+    "cli",
+    "downloader",
+    "audio",
+    "interactive"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/blacksagres/soundboard-downloader-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/blacksagres/soundboard-downloader-cli/issues"
+  },
+  "homepage": "https://github.com/blacksagres/soundboard-downloader-cli#readme",
+  "devDependencies": {
+    "@types/jsdom": "^27.0.0",
+    "@types/node": "^25.2.3",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.2.0",
+    "jsdom": "^28.0.0",
+    "open": "^11.0.0",
+    "ora": "^9.3.0"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,42 @@
+{
+  // Visit https://aka.ms/tsconfig to read more about this file
+  "compilerOptions": {
+    // File Layout
+    "rootDir": "./src",
+    "outDir": "./dist",
+
+    // Environment Settings
+    // See also https://aka.ms/tsconfig/module
+    "module": "commonjs",
+    "target": "esnext",
+    // For nodejs:
+    "lib": ["esnext"],
+    "types": ["node"],
+
+    // Other Outputs
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+
+    // Stricter Typechecking Options
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+
+    // Style Options
+    // "noImplicitReturns": true,
+    // "noImplicitOverride": true,
+    // "noUnusedLocals": true,
+    // "noUnusedParameters": true,
+    // "noFallthroughCasesInSwitch": true,
+    // "noPropertyAccessFromIndexSignature": true,
+
+    // Recommended Options
+    "strict": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": false,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true
+  }
+}