@purpleproser/soundboard-downloader-cli 1.6.3 → 1.8.4

package/README.md

@@ -1,6 +1,9 @@
 # @purpleproser/soundboard-downloader-cli
 
-[![Socket Badge](https://badge.socket.dev/npm/package/@purpleproser/soundboard-downloader-cli/1.6.0)](https://badge.socket.dev/npm/package/@purpleproser/soundboard-downloader-cli/1.6.0)
+[![npm version](https://img.shields.io/npm/v/@purpleproser/soundboard-downloader-cli?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@purpleproser/soundboard-downloader-cli)
+[![npm downloads](https://img.shields.io/npm/dm/@purpleproser/soundboard-downloader-cli?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@purpleproser/soundboard-downloader-cli)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
+[![Socket Badge](https://badge.socket.dev/npm/package/@purpleproser/soundboard-downloader-cli/1.6.2)](https://badge.socket.dev/npm/package/@purpleproser/soundboard-downloader-cli/1.6.2)
 
 A Node.js command-line tool to download soundboard sounds from [MyInstants](https://myinstants.com).
 
@@ -15,10 +18,10 @@ A Node.js command-line tool to download soundboard sounds from [MyInstants](http
 
 ## Tech Stack
 
-- **Inquirer** - Interactive CLI prompts
+- **prompts** - Lightweight interactive CLI prompts
 - **jsdom** - HTML parsing and DOM manipulation
 - **ora** - Elegant terminal spinners
-- **open** - Opens URLs in the user's browser to allow previewing the sound
+- **opener** - Opens URLs in the user's browser to allow previewing the sound
 
 ## Prerequisites
 
@@ -157,6 +160,42 @@ soundboard-downloader
 
 Contributions are welcome! Please open an issue or submit a pull request.
 
+## Compliance with MyInstants Terms of Use
+
+This tool is designed to comply with [MyInstants Terms of Use](https://www.myinstants.com/en/terms_of_use.html).
+
+### Compliance Features
+
+✅ **Personal Use Only**
+This tool is for personal, non-commercial use only. Commercial use violates MyInstants' terms.
+
+✅ **Official Functionality**
+Uses MyInstants' official download buttons and links, exactly as a manual user would.
+
+✅ **No Circumvention**
+Does not bypass any access controls, paywalls, or copyright protections.
+
+✅ **Rate Limiting**
+Includes 1-second delays between API requests to avoid being flagged as automated scraping.
+
+### User Responsibilities
+
+When using this tool, you agree to:
+
+- **Non-commercial use only** - No business or commercial applications
+- **Respect rate limits** - Do not make excessive automated requests
+- **Honor copyright** - Respect MyInstants' terms and copyright protections
+- **Accept revocable access** - MyInstants may change their terms or block access at any time
+
+### Important Notice
+
+MyInstants grants access to their website under a revocable license. While this tool is designed to comply with their current terms, it may stop working if:
+- MyInstants changes their website structure
+- MyInstants updates their terms of service
+- MyInstants decides to block automated tools
+
+Always check the [current MyInstants Terms of Use](https://www.myinstants.com/en/terms_of_use.html) for the latest requirements.
+
 ## Legal Disclaimer
 
 **Important Notice About Copyright and Usage:**

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

@@ -44,6 +44,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getNodeDownloadPage = exports.getAllSoundNodes = exports.hasNextPage = exports.getSoundNodesPage = void 0;
 const api_config_1 = require("./api-config");
 const MockApi = __importStar(require("./my-instants.api.mock"));
+const rate_limiter_1 = require("../utils/rate-limiter");
 /**
  * Fetch a single page of sound nodes from myinstants.com
  * @param searchString The search term
@@ -58,7 +59,7 @@ const getSoundNodesPage = async ({ searchString, page = 1 }) => {
     }
     const escapedSearchParam = encodeURIComponent(searchString);
     const url = `https://www.myinstants.com/en/search/?name=${escapedSearchParam}&page=${page}`;
-    const response = await fetch(url);
+    const response = await (0, rate_limiter_1.rateLimitedFetch)(url);
     if (!response.ok) {
         throw new Error(`Failed to fetch page ${page} for search: ${searchString}`);
     }
@@ -79,7 +80,7 @@ const hasNextPage = async ({ searchString, page = 1 }) => {
     const escapedSearchParam = encodeURIComponent(searchString);
     const url = `https://www.myinstants.com/en/search/?name=${escapedSearchParam}&page=${page + 1}`;
     try {
-        const response = await fetch(url, { method: 'HEAD' });
+        const response = await (0, rate_limiter_1.rateLimitedFetch)(url, { method: 'HEAD' });
         return response.ok;
     }
     catch (error) {
@@ -129,7 +130,7 @@ const getNodeDownloadPage = async (soundNodeDetailsURL) => {
         return MockApi.getNodeDownloadPage(soundNodeDetailsURL);
     }
     const root = `https://www.myinstants.com${soundNodeDetailsURL}`;
-    const response = await fetch(root);
+    const response = await (0, rate_limiter_1.rateLimitedFetch)(root);
     if (!response.ok) {
         throw new Error(`Failed to fetch sound detail page: ${soundNodeDetailsURL}`);
     }

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

@@ -1 +1 @@
-{"version":3,"file":"my-instants.api.js","sourceRoot":"","sources":["../../src/api/my-instants.api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"my-instants.api.js","sourceRoot":"","sources":["../../src/api/my-instants.api.ts"],"names":[],"mappings":"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"}

package/dist/utils/rate-limiter.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Rate limiting utility to ensure compliance with MyInstants Terms of Use
+ * Adds reasonable delays between requests to avoid being seen as scraping
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRateLimitDelay = exports.resetRateLimiter = exports.rateLimitedFetch = void 0;
+/**
+ * Minimum delay between requests (in milliseconds)
+ * This helps avoid being flagged as automated scraping
+ */
+const MIN_REQUEST_DELAY = 1000; // 1 second
+/**
+ * Track the last request time for rate limiting
+ */
+let lastRequestTime = 0;
+/**
+ * Rate-limited fetch wrapper
+ * Ensures minimum delay between consecutive requests to MyInstants
+ */
+const rateLimitedFetch = async (input, init) => {
+    // Calculate time since last request
+    const now = Date.now();
+    const timeSinceLastRequest = now - lastRequestTime;
+    // If we're making requests too quickly, add a delay
+    if (timeSinceLastRequest < MIN_REQUEST_DELAY) {
+        const delayNeeded = MIN_REQUEST_DELAY - timeSinceLastRequest;
+        await new Promise(resolve => setTimeout(resolve, delayNeeded));
+    }
+    // Update last request time
+    lastRequestTime = Date.now();
+    // Make the actual fetch request
+    return fetch(input, init);
+};
+exports.rateLimitedFetch = rateLimitedFetch;
+/**
+ * Reset the rate limiter (useful for testing)
+ */
+const resetRateLimiter = () => {
+    lastRequestTime = 0;
+};
+exports.resetRateLimiter = resetRateLimiter;
+/**
+ * Get the current rate limit delay
+ */
+const getRateLimitDelay = () => {
+    return MIN_REQUEST_DELAY;
+};
+exports.getRateLimitDelay = getRateLimitDelay;
+//# sourceMappingURL=rate-limiter.js.map

package/dist/utils/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/utils/rate-limiter.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH;;;GAGG;AACH,MAAM,iBAAiB,GAAG,IAAI,CAAC,CAAC,WAAW;AAE3C;;GAEG;AACH,IAAI,eAAe,GAAG,CAAC,CAAC;AAExB;;;GAGG;AACI,MAAM,gBAAgB,GAAG,KAAK,EAAE,KAAwB,EAAE,IAAkB,EAAqB,EAAE;IACxG,oCAAoC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,oBAAoB,GAAG,GAAG,GAAG,eAAe,CAAC;IAEnD,oDAAoD;IACpD,IAAI,oBAAoB,GAAG,iBAAiB,EAAE,CAAC;QAC7C,MAAM,WAAW,GAAG,iBAAiB,GAAG,oBAAoB,CAAC;QAC7D,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,2BAA2B;IAC3B,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,gCAAgC;IAChC,OAAO,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC5B,CAAC,CAAC;AAhBW,QAAA,gBAAgB,oBAgB3B;AAEF;;GAEG;AACI,MAAM,gBAAgB,GAAG,GAAS,EAAE;IACzC,eAAe,GAAG,CAAC,CAAC;AACtB,CAAC,CAAC;AAFW,QAAA,gBAAgB,oBAE3B;AAEF;;GAEG;AACI,MAAM,iBAAiB,GAAG,GAAW,EAAE;IAC5C,OAAO,iBAAiB,CAAC;AAC3B,CAAC,CAAC;AAFW,QAAA,iBAAiB,qBAE5B"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@purpleproser/soundboard-downloader-cli",
-  "version": "1.6.3",
-  "description": "Easily download sounds from myinstants.com using this interactive CLI tool",
+  "version": "1.8.4",
+  "description": "Easily download sounds from myinstants.com using this interactive CLI tool (for personal, non-commercial use only)",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -12,12 +12,6 @@
   "bin": {
     "soundboard-downloader": "./dist/main.js"
   },
-  "scripts": {
-    "test": "vitest --coverage",
-    "start": "ts-node ./src/main.ts",
-    "build": "tsc -p tsconfig.build.json",
-    "prepublishOnly": "npm run build"
-  },
   "keywords": [
     "soundboard",
     "myinstants",
@@ -34,20 +28,33 @@
     "url": "https://github.com/blacksagres/soundboard-downloader-cli/issues"
   },
   "homepage": "https://github.com/blacksagres/soundboard-downloader-cli#readme",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENCE",
+    "package.json"
+  ],
   "devDependencies": {
+    "@types/node": "^25.0.0",
     "@types/jsdom": "^28.0.0",
     "@types/opener": "^1.4.3",
     "@types/prompts": "^2.4.9",
     "@vitest/coverage-v8": "^4.0.18",
     "ts-node": "^10.9.2",
-    "typescript": "^5.9.3",
+    "typescript": "^6.0.2",
     "vitest": "^4.0.18"
   },
   "dependencies": {
-    "jsdom": "^28.0.0",
+    "jsdom": "^29.1.1",
     "opener": "^1.5.2",
     "ora": "^9.3.0",
     "prompts": "^2.4.2",
     "valibot": "^1.2.0"
+  },
+  "scripts": {
+    "test": "vitest run --coverage",
+    "test:watch": "vitest --coverage",
+    "start": "ts-node ./src/main.ts",
+    "build": "tsc -p tsconfig.build.json"
   }
-}
+}

package/.github/dependabot.yml

@@ -1,14 +0,0 @@
-# To get started with Dependabot version updates, you'll need to specify which
-# package ecosystems to update and where the package manifests are located.
-# Please see the documentation for all configuration options:
-# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
-
-version: 2
-updates:
-  - package-ecosystem: "npm" # See documentation for possible values
-    directory: "/" # Location of package manifests
-    labels:
-      - "security"
-    schedule:
-      interval: "daily"
-    target-branch: "main"

package/.github/workflows/publish.yml

@@ -1,37 +0,0 @@
-name: 📦️ Publish to NPM
-
-on:
-  push:
-    tags:
-      - "v*"
-
-permissions:
-  id-token: write # Required for OIDC
-  contents: read
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: "24"
-          registry-url: "https://registry.npmjs.org"
-      - run: npm ci
-      - run: npm run build --if-present
-      - name: Check if version exists
-        id: check_version
-        run: |
-          VERSION=$(node -p "require('./package.json').version")
-          if npm view @purpleproser/soundboard-downloader-cli@$VERSION >/dev/null 2>&1; then
-            echo "version_exists=true" >> $GITHUB_OUTPUT
-            echo "Version $VERSION already exists in npm registry"
-          else
-            echo "version_exists=false" >> $GITHUB_OUTPUT
-            echo "Version $VERSION does not exist in npm registry"
-          fi
-      - name: Publish to npm (only if version doesn't exist)
-        if: steps.check_version.outputs.version_exists != 'true'
-        run: npm publish --provenance

package/.github/workflows/release-please.yml

@@ -1,25 +0,0 @@
-name: ➡️ Release please
-
-on:
-  push:
-    branches:
-      - main
-
-permissions:
-  contents: write
-  issues: write
-  pull-requests: write
-
-jobs:
-  release-please:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: googleapis/release-please-action@v4
-        with:
-          # this assumes that you have created a personal access token
-          # (PAT) and configured it as a GitHub action secret named
-          # `MY_RELEASE_PLEASE_TOKEN` (this secret name is not important).
-          token: ${{ secrets.MY_RELEASE_PLEASE_TOKEN }}
-          # this is a built-in strategy in release-please, see "Action Inputs"
-          # for more options
-          release-type: node

package/.github/workflows/test.yml

@@ -1,29 +0,0 @@
-name: 🧪 Run Tests
-
-permissions:
-  contents: read
-
-on:
-  pull_request:
-    branches: [main]
-
-jobs:
-  test:
-    name: Run tests
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 24
-          cache: "npm"
-
-      - name: Install dependencies
-        run: npm install
-
-      - name: Run tests
-        run: npm test -- --reporter=verbose
-        env:
-          NODE_OPTIONS: --max-old-space-size=4096

package/CHANGELOG.md

@@ -1,169 +0,0 @@
-# Changelog
-
-This changelog is automatically generated by [release-please](https://github.com/google-github-actions/release-please-action).
-
-## [1.6.3](https://github.com/blacksagres/soundboard-downloader-cli/compare/v1.6.2...v1.6.3) (2026-03-10)
-
-
-### Bug Fixes
-
-* replace @inquirer/prompts with prompts ([366c79b](https://github.com/blacksagres/soundboard-downloader-cli/commit/366c79b6d842ca4de5da7ea843c15b66c10bddcf))
-* replace open with opener ([97ec29d](https://github.com/blacksagres/soundboard-downloader-cli/commit/97ec29d3cc487abad964fea89129a82e1424a6e5))
-
-## [1.6.2](https://github.com/blacksagres/soundboard-downloader-cli/compare/v1.6.1...v1.6.2) (2026-03-07)
-
-
-### Bug Fixes
-
-* add correct parameters for dependabot workflow ([f1737c1](https://github.com/blacksagres/soundboard-downloader-cli/commit/f1737c1ec83f67b68fd182e967fa7ffceaaf0194))
-* explicitely add read only permission to workflow ([3f17d79](https://github.com/blacksagres/soundboard-downloader-cli/commit/3f17d798c789f5e26e74282b60f8df6e49493918))
-
-## [1.6.1](https://github.com/blacksagres/soundboard-downloader-cli/compare/v1.6.0...v1.6.1) (2026-03-07)
-
-
-### Bug Fixes
-
-* run npm audit ([7dfe691](https://github.com/blacksagres/soundboard-downloader-cli/commit/7dfe69192dfe2aac1f407b3eb731fe15531334bb))
-
-## [1.6.0](https://github.com/blacksagres/soundboard-downloader-cli/compare/v1.5.0...v1.6.0) (2026-03-01)
-
-
-### Features
-
-* data validation with valibot ([1357286](https://github.com/blacksagres/soundboard-downloader-cli/commit/1357286c9c22153fccc6571f1b7dd1f554bbb057))
-* paginate search list to avoid blastinhg the myinstants page with requests ([439751c](https://github.com/blacksagres/soundboard-downloader-cli/commit/439751cb70d3586aae8d026db902932d41fc2a68))
-* restore single selection for sounds to keep UI clean ([c21895d](https://github.com/blacksagres/soundboard-downloader-cli/commit/c21895dcf373d55b1b87659371c5550d21773355))
-
-
-### Bug Fixes
-
-* use a mock api for integration tests ([9f410df](https://github.com/blacksagres/soundboard-downloader-cli/commit/9f410dfa796bafc11dc49177667388a84e638e41))
-
-## [1.5.0](https://github.com/blacksagres/soundboard-downloader-cli/compare/v1.4.0...v1.5.0) (2026-02-26)
-
-
-### Features
-
-* download multiple files ([c2e257c](https://github.com/blacksagres/soundboard-downloader-cli/commit/c2e257cc6e9916679c86c902609fb328431cebbd))
-
-## [1.4.0](https://github.com/blacksagres/soundboard-downloader-cli/compare/v1.3.0...v1.4.0) (2026-02-20)
-
-
-### Features
-
-* add music note emoji to sound list for better UX ([7d6f12a](https://github.com/blacksagres/soundboard-downloader-cli/commit/7d6f12a12a46902e1d3bb261723094e8b1b470f9))
-
-## [1.3.0](https://github.com/blacksagres/soundboard-downloader-cli/compare/v1.2.3...v1.3.0) (2026-02-20)
-
-
-### Features
-
-* show total number of sounds found ([6b661df](https://github.com/blacksagres/soundboard-downloader-cli/commit/6b661dfd96f6e7a03289f7c7b153ca3dd345d6ab))
-
-## [1.2.3](https://github.com/blacksagres/soundboard-downloader-cli/compare/v1.2.2...v1.2.3) (2026-02-20)
-
-
-### Bug Fixes
-
-* prevent republishing existing versions ([#10](https://github.com/blacksagres/soundboard-downloader-cli/issues/10)) ([cf43fa6](https://github.com/blacksagres/soundboard-downloader-cli/commit/cf43fa611b2ac3b9b7700acfb23383deb33e7296))
-
-## 1.0.0 (2026-02-20)
-
-
-### Features
-
-* add new option to display url ([2e64f55](https://github.com/blacksagres/soundboard-downloader-cli/commit/2e64f55fab67f3a26db1698be374316e9132d4b0))
-* add npm provenance to publishing workflow ([7b467c1](https://github.com/blacksagres/soundboard-downloader-cli/commit/7b467c1c2d092b136988e5cf61a12df73efa429a))
-* display all results in terminal ([b3d7e20](https://github.com/blacksagres/soundboard-downloader-cli/commit/b3d7e2026eb9cedee3ad44ef47ab081d0c1f3510))
-* publish dist ([602b341](https://github.com/blacksagres/soundboard-downloader-cli/commit/602b341d1566f7a464d4da53498d4b5412113232))
-* **ui:** add a better commander ([fd2cd3f](https://github.com/blacksagres/soundboard-downloader-cli/commit/fd2cd3f5343a14ea94012dfbb204a7ca0a5e76e0))
-
-
-### Bug Fixes
-
-* add correct release type to config ([fb86613](https://github.com/blacksagres/soundboard-downloader-cli/commit/fb866133e36a22ef9de04872449d967d42f5cc35))
-* add preinstall and postinstall to see if it works ([06eaf63](https://github.com/blacksagres/soundboard-downloader-cli/commit/06eaf637d5aa5233d88e9e5dfd5007d8e8104560))
-* add the correct url to the download link ([72d510d](https://github.com/blacksagres/soundboard-downloader-cli/commit/72d510d7515472aa0e3ca4a93f7c4afaf01cb6bf))
-* catch exit errors ([a9503e4](https://github.com/blacksagres/soundboard-downloader-cli/commit/a9503e4d1cfc5fa7ebcef009ed299b93806c8808))
-* configure trusted publisher in npm and adjust the publish file ([cf33842](https://github.com/blacksagres/soundboard-downloader-cli/commit/cf33842708df2d3075c1fa5ed1da440f9931557d))
-* handle potential undefined from file name generation ([de8233f](https://github.com/blacksagres/soundboard-downloader-cli/commit/de8233f8df39c053ae2f2ff2ce50a03c8b5593c5))
-* infinite install loop ([323f9ed](https://github.com/blacksagres/soundboard-downloader-cli/commit/323f9edf5033cd75a4e2f2b419af0267ba5ba6c3))
-* make vitest ignore files outside src ([d43ee2c](https://github.com/blacksagres/soundboard-downloader-cli/commit/d43ee2cf0ec027ba99d2668418be8770f65add78))
-* my big brain sorting that broke the links ([53cbc5b](https://github.com/blacksagres/soundboard-downloader-cli/commit/53cbc5b67cea0dffaf43d7740112826be5cf659c))
-* prevent shipping declaration files in the package ([e7c9d68](https://github.com/blacksagres/soundboard-downloader-cli/commit/e7c9d68c4427624d71d44177db6a98e7f6b7b1e7))
-* prevent test files from being added to build ([ac679ff](https://github.com/blacksagres/soundboard-downloader-cli/commit/ac679ffd4e0e7bc0500d7f302ba586b9a479f9e4))
-* prevent tests from running until fixed ([74142b8](https://github.com/blacksagres/soundboard-downloader-cli/commit/74142b8771959faa73efdc14d8b7c49d6f80a8e5))
-* remove need for temp folder ([8d7e2fa](https://github.com/blacksagres/soundboard-downloader-cli/commit/8d7e2faf1aa479a048d0cd7ad0623c686e82bd23))
-* remove prepare script ([737d7e4](https://github.com/blacksagres/soundboard-downloader-cli/commit/737d7e4d88cf49a211ec85705b1bf11ea37f5ff1))
-* unblock other workflows until I know what's wrong with the test ([8cb6d59](https://github.com/blacksagres/soundboard-downloader-cli/commit/8cb6d59050da184072480efac887b52b22caaf72))
-* use the correct yml file for publishing to npm ([8877330](https://github.com/blacksagres/soundboard-downloader-cli/commit/88773308eed96262d6a6994809ffc87fa92b5dd5))
-
-## [1.2.2](https://github.com/blacksagres/soundboard-downloader-cli/compare/v1.2.1...v1.2.2) (2026-02-15)
-
-
-### Bug Fixes
-
-* prevent tests from running until fixed ([2da9ad1](https://github.com/blacksagres/soundboard-downloader-cli/commit/2da9ad1e3616dddb4868babde7c39a97f92a2c30))
-* use the correct yml file for publishing to npm ([364cbb8](https://github.com/blacksagres/soundboard-downloader-cli/commit/364cbb8fe95456fb036d90a1a8bd014bccc7cea7))
-
-## [1.2.1](https://github.com/blacksagres/soundboard-downloader-cli/compare/v1.2.0...v1.2.1) (2026-02-15)
-
-
-### Bug Fixes
-
-* configure trusted publisher in npm and adjust the publish file ([8cbddce](https://github.com/blacksagres/soundboard-downloader-cli/commit/8cbddce0b6e80ce099bd848aef855d5e27abbc18))
-
-## [1.2.0](https://github.com/blacksagres/soundboard-downloader-cli/compare/v1.1.1...v1.2.0) (2026-02-15)
-
-
-### Features
-
-* add new option to display url ([51758d3](https://github.com/blacksagres/soundboard-downloader-cli/commit/51758d3c26602a649f5172a8dcb31981f5e7bc89))
-
-
-### Bug Fixes
-
-* add correct release type to config ([737d1b9](https://github.com/blacksagres/soundboard-downloader-cli/commit/737d1b925ccaae715061a2023470e0f3d7534688))
-* handle potential undefined from file name generation ([484129f](https://github.com/blacksagres/soundboard-downloader-cli/commit/484129f79da05d56edee650c320fcc82cf81d042))
-* make vitest ignore files outside src ([7313579](https://github.com/blacksagres/soundboard-downloader-cli/commit/7313579f62f482bbd069da7de539f10697e2de83))
-* prevent shipping declaration files in the package ([fad7dc7](https://github.com/blacksagres/soundboard-downloader-cli/commit/fad7dc76c1b916a5becfa9677a486821b75c9792))
-* prevent test files from being added to build ([268b43f](https://github.com/blacksagres/soundboard-downloader-cli/commit/268b43fb788d7f9438b2473c4376349aa27e446b))
-* remove prepare script ([362e823](https://github.com/blacksagres/soundboard-downloader-cli/commit/362e823434f368bede87541d9fef3e70ca260343))
-* unblock other workflows until I know what's wrong with the test ([9f8c092](https://github.com/blacksagres/soundboard-downloader-cli/commit/9f8c092c6086cbbaaec087ae1de02dc47f5c954d))
-
-## v1.0.1 (2024-02-14)
-
-### Features
-
-- **download**: simplify download location to use current working directory
-
-### Bug Fixes
-
-- **publish**: fix scoped package publishing with public access config
-- **deps**: remove unused @types/node dependency
-
-### Documentation
-
-- **readme**: update with clear download location examples
-- **readme**: add npm scope vs GitHub username explanation
-- **changelog**: add comprehensive change tracking
-- **release**: add management guide for future releases
-
-### Chores
-
-- **ci**: set up GitHub Actions for automated releases
-- **config**: add release-please workflow
-
-## v1.0.0 (2024-02-14)
-
-### Features(v1.0.0)
-
-- **core**: initial implementation with MyInstants API integration
-- **cli**: interactive interface with @inquirer/prompts
-- **download**: sound download with progress indicators
-- **playback**: browser playback option using open package
-
-### Documentation(v1.0.0)
-
-- **readme**: initial setup and usage instructions
-- **license**: add MIT license file

package/src/api/README.md

@@ -1,128 +0,0 @@
-# API Mocking System
-
-This directory contains the API mocking system for the soundboard downloader CLI.
-
-## Overview
-
-The mocking system allows you to switch between real API calls to myinstants.com and mock data for testing purposes. This is particularly useful for:
-
-- Running tests in CI environments (GitHub Actions, etc.)
-- Avoiding rate limiting issues
-- Having predictable test data
-- Faster test execution
-- Offline development
-
-## Files
-
-- `api-config.ts` - Configuration system for switching between real and mock API
-- `my-instants.api.ts` - Main API layer with conditional mock support
-- `my-instants.api.mock.ts` - Mock implementation with predictable test data
-
-## Usage
-
-### In Tests
-
-```typescript
-import { setApiMode } from "./api/api-config";
-import { getPaginatedResults, getAllResults } from "./service/my-instants.service";
-
-// Switch to mock mode before running tests
-beforeAll(() => {
-  setApiMode("mock");
-});
-
-// Now all API calls will use mock data
-test("pagination works", async () => {
-  const results = await getPaginatedResults("test", 1);
-  // results will contain predictable mock data
-});
-```
-
-### In Development
-
-```typescript
-import { setApiMode, getApiMode, isMockMode } from "./api/api-config";
-
-// Check current mode
-console.log(`Current mode: ${getApiMode()}`); // 'real' or 'mock'
-console.log(`Using mock: ${isMockMode()}`); // true or false
-
-// Switch modes
-setApiMode("mock"); // Use mock data
-setApiMode("real"); // Use real API
-```
-
-## Mock Data Structure
-
-The mock API provides predictable test data:
-
-- **14 total sounds** in the mock database
-- **6 sounds per page** for pagination
-- **Valid download URLs** for all sounds
-- **Consistent labels** (Wilhelm Scream, THX Deep Note, Test Sound 1-12)
-
-### Example Mock Results
-
-**Pagination (Page 1):**
-```json
-[
-  {"label": "Wilhelm Scream", "download_url": "https://.../test-sound.mp3"},
-  {"label": "THX Deep Note", "download_url": "https://.../test-sound.mp3"},
-  {"label": "Test Sound 1", "download_url": "https://.../test-sound.mp3"},
-  {"label": "Test Sound 2", "download_url": "https://.../test-sound.mp3"},
-  {"label": "Test Sound 3", "download_url": "https://.../test-sound.mp3"},
-  {"label": "Test Sound 4", "download_url": "https://.../test-sound.mp3"}
-]
-```
-
-**Fetch All:**
-- Returns all 14 sounds sorted alphabetically
-- Same structure as pagination results
-
-## CI Integration
-
-The mock API is automatically used in CI environments. In your GitHub Actions workflow:
-
-```yaml
-- name: Run tests
-  run: npm test
-  env:
-    NODE_ENV: test
-```
-
-The test file automatically detects CI environments and uses mock data.
-
-## Benefits
-
-1. **Reliability**: Tests don't depend on external API availability
-2. **Speed**: Mock responses are instantaneous
-3. **Predictability**: Always get the same test data
-4. **No Rate Limiting**: Avoid GitHub Actions IP blocking
-5. **Offline Testing**: Can run tests without internet connection
-
-## Implementation Details
-
-The mock system works by:
-
-1. **Intercepting API calls**: Each function in `my-instants.api.ts` checks `isMockMode()`
-2. **Returning mock data**: If in mock mode, calls the corresponding mock function
-3. **Maintaining interface**: Mock functions have the same signature as real functions
-4. **HTML templates**: Mock functions return HTML strings that match the real site structure
-
-The mock HTML templates include the necessary DOM structure that the service layer expects to parse.
-
-## Adding More Mock Data
-
-To add more test sounds, edit the `mockSounds` array in `my-instants.api.mock.ts`:
-
-```typescript
-const mockSounds = [
-  ...existingSounds,
-  {
-    label: "New Test Sound",
-    detail_url: "/en/instant/new-test-sound/"
-  }
-];
-```
-
-The system will automatically handle pagination based on the array length.

package/tsconfig.build.json

@@ -1,8 +0,0 @@
-{
-  "extends": "./tsconfig",
-  "exclude": ["**/*.test.ts", "**/*.mock.ts", "vitest.config.ts"],
-  "compilerOptions": {
-    "declaration": false,
-    "declarationMap": false
-  }
-}

package/tsconfig.json

@@ -1,43 +0,0 @@
-{
-  // 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,
-    "esModuleInterop": true
-  }
-}

package/tsconfig.prod.json

@@ -1,8 +0,0 @@
-{
-  "extends": "./tsconfig",
-  "exclude": ["**/*.test.ts", "**/*.mock.ts", "vitest.config.ts"],
-  "compilerOptions": {
-    "declaration": false,
-    "declarationMap": false
-  }
-}

package/vite.config.js

@@ -1,13 +0,0 @@
-import { defineConfig } from "vitest/config";
-
-export default defineConfig({
-  test: {
-    exclude: ["**/node_modules/**", "**/dist/**", "./temp/**"],
-    // Increase timeout for network tests
-    testTimeout: 30000,
-    // Retry failed tests (helpful for flaky network tests)
-    retries: 1,
-    // Show more detailed output
-    verbose: true,
-  },
-});