wildcard-domain-finder-plus 1.0.0 → 1.0.3

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,43 @@
+name: Publish Package
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest   # You *can* change this, but ubuntu is simplest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      # Install Java (your build environment)
+      - name: Set up Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '21'
+
+      # Build your Java project
+      - name: Build Java project
+        run: ./gradlew build || mvn package
+
+      # Install Node (required for npm publish)
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          registry-url: 'https://registry.npmjs.org'
+
+      # Install npm dependencies (if any)
+      - name: Install npm dependencies
+        run: npm ci --ignore-scripts
+
+      # Publish to npm using Trusted Publishing
+      - name: Publish to npm
+        run: npm publish --provenance --access public

package/README.md

@@ -1,3 +1,7 @@
+[![npm version](https://img.shields.io/npm/v/wildcard-domain-finder-plus.svg)](https://www.npmjs.com/package/wildcard-domain-finder-plus)
+[![npm downloads](https://img.shields.io/npm/dm/wildcard-domain-finder-plus.svg)](https://www.npmjs.com/package/wildcard-domain-finder-plus)
+[![license](https://img.shields.io/badge/license-ISC-blue.svg)](LICENSE)
+
 ## Attribution
 
 This project is an enhanced fork of  
@@ -35,15 +39,20 @@ Install globally:
 
 Run a simple wildcard scan:
 
+	wdf -d "test*.com"
+
+Or use the full command:
+
     wildcard-domain-finder-plus -d "test*.com"
 
+
 Run a regex scan:
 
-    wildcard-domain-finder-plus --regex "^[a-z]{3}\\.com$"
+    wdf --regex "^[a-z]{3}\\.com$"
 
 Scan all TLDs:
 
-    wildcard-domain-finder-plus -d "go*" --tlds all
+    wdf -d "go*" --tlds all
 
 ---
 
@@ -77,7 +86,7 @@ Use * to represent any single alphanumeric character (a–z, 0–9).
 
 Example:
 
-    wildcard-domain-finder-plus -d "test*.com"
+    wdf -d "test*.com"
 
 This expands to:
 
@@ -96,7 +105,7 @@ Regex mode gives you full control over domain label generation.
 
 Example:
 
-    wildcard-domain-finder-plus --regex "^[a-z0-9]{3}\\.com$"
+    wdf --regex "^[a-z0-9]{3}\\.com$"
 
 This generates:
 
@@ -157,11 +166,11 @@ Choose from:
 
 Examples:
 
-    wildcard-domain-finder-plus -d "go*" --tlds all
+    wdf -d "go*" --tlds all
 
-    wildcard-domain-finder-plus -d "ai*" --tlds premium
+    wdf -d "ai*" --tlds premium
 
-    wildcard-domain-finder-plus -d "shop*" --tlds com,net,org,io
+    wdf -d "shop*" --tlds com,net,org,io
 
 ---
 
@@ -178,11 +187,11 @@ Supported filters:
 
 Examples:
 
-    wildcard-domain-finder-plus -d "***.com" --filter length<=3
+    wdf -d "***.com" --filter length<=3
 
-    wildcard-domain-finder-plus -d "*ai" --filter ends:ai
+    wdf -d "*ai" --filter ends:ai
 
-    wildcard-domain-finder-plus -d "go*" --filter starts:go
+    wdf -d "go*" --filter starts:go
 
 ---
 
@@ -197,7 +206,7 @@ Sorting options:
 
 Example:
 
-    wildcard-domain-finder-plus -d "***.com" --sort comfirst
+    wdf -d "***.com" --sort comfirst
 
 ---
 
@@ -212,7 +221,7 @@ Choose from:
 
 Example:
 
-    wildcard-domain-finder-plus -d "go*" -F jsonl -o results.jsonl
+    wdf -d "go*" -F jsonl -o results.jsonl
 
 ---
 
@@ -220,11 +229,11 @@ Example:
 
 Large scans can be resumed:
 
-    wildcard-domain-finder-plus -R
+    wdf -R
 
 Disable caching:
 
-    wildcard-domain-finder-plus --no-cache
+    wdf --no-cache
 
 ---
 
@@ -232,7 +241,7 @@ Disable caching:
 
 If no domain or regex is provided:
 
-    wildcard-domain-finder-plus
+    wdf
 
 You will be prompted for:
 
@@ -248,23 +257,23 @@ You will be prompted for:
 
 ### Find all 3‑letter .com domains
 
-    wildcard-domain-finder-plus --regex "^[a-z]{3}\\.com$"
+    wdf --regex "^[a-z]{3}\\.com$"
 
 ### Find all domains starting with “go” across all TLDs
 
-    wildcard-domain-finder-plus -d "go*" --tlds all
+    wdf -d "go*" --tlds all
 
 ### Find short premium domains
 
-    wildcard-domain-finder-plus -d "***" --tlds premium --filter length<=3
+    wdf -d "***" --tlds premium --filter length<=3
 
 ### Find 4‑letter .io or .ai domains
 
-    wildcard-domain-finder-plus --regex "^[a-z]{4}\\.(io|ai)$"
+    wdf --regex "^[a-z]{4}\\.(io|ai)$"
 
 ### Wildcard + filtering + sorting
 
-    wildcard-domain-finder-plus -d "go**.com" --filter length<=4 --sort alpha
+    wdf -d "go**.com" --filter length<=4 --sort alpha
 
 ---
 
@@ -302,15 +311,15 @@ Regex mode avoids generating unnecessary combinations.
 
 ### Wildcard + premium TLDs
 
-    wildcard-domain-finder-plus -d "ai*" --tlds premium
+    wdf -d "ai*" --tlds premium
 
 ### Regex + JSONL output
 
-    wildcard-domain-finder-plus --regex "^[a-z]{4}\\.(io|ai)$" -F jsonl
+    wdf --regex "^[a-z]{4}\\.(io|ai)$" -F jsonl
 
 ### Resume a long scan
 
-    wildcard-domain-finder-plus -R
+    wdf -R
 
 ---
 

package/README.txt

@@ -1,3 +1,357 @@
+[![npm version](https://img.shields.io/npm/v/wildcard-domain-finder-plus.svg)](https://www.npmjs.com/package/wildcard-domain-finder-plus)
+[![npm downloads](https://img.shields.io/npm/dm/wildcard-domain-finder-plus.svg)](https://www.npmjs.com/package/wildcard-domain-finder-plus)
+[![license](https://img.shields.io/badge/license-ISC-blue.svg)](LICENSE)
+
+   Attribution
+
+This project is an enhanced fork of  
+**besoeasy/wildcard-domain-finder**  
+Original work © the respective author(s), licensed under the ISC License.
+
+This fork adds major new capabilities including:
+- streaming domain generation (no memory blowups)
+- regex mode
+- wildcard mode
+- TLD selection (explicit, all, premium)
+- filtering (tld, length, starts, ends)
+- sorting (comfirst, tld, length, alpha)
+- JSON / JSONL / CSV / TXT output
+- caching + resume mode
+- interactive pause/resume/quit controls
+- concurrency + timeout controls
+- full CLI help system
+
+All original licensing terms are preserved.
+
+---
+
+  Wildcard Domain Finder Plus
+
+A command-line tool to find available domain names using wildcard patterns, regex patterns, or structured filters — now with streaming generation, caching, and advanced TLD control.
+
+---
+
+  Quick Start
+
+Install globally:
+
+    npm install -g wildcard-domain-finder-plus
+
+Run a simple wildcard scan:
+
+	wdf -d "test*.com"
+
+Or use the full command:
+
+    wildcard-domain-finder-plus -d "test*.com"
+
+
+Run a regex scan:
+
+    wdf --regex "^[a-z]{3}\\.com$"
+
+Scan all TLDs:
+
+    wdf -d "go*" --tlds all
+
+---
+
+  Installation
+
+    Via NPX (no installation required)
+
+    npx wildcard-domain-finder-plus
+
+    Or install globally
+
+    npm install -g wildcard-domain-finder-plus
+
+---
+
+  Usage Guide
+
+Wildcard Domain Finder Plus supports three primary modes:
+
+1. Wildcard mode  
+2. Regex mode  
+3. Structured filtering mode  
+
+Each mode can be combined with TLD selection, sorting, output formatting, and caching.
+
+---
+
+   Wildcard Mode
+
+Use * to represent any single alphanumeric character (a–z, 0–9).
+
+Example:
+
+    wdf -d "test*.com"
+
+This expands to:
+
+- testa.com  
+- testb.com  
+- test1.com  
+- …and so on  
+
+Wildcard mode is ideal when you know the pattern but not the exact characters.
+
+---
+
+   Regex Mode
+
+Regex mode gives you full control over domain label generation.
+
+Example:
+
+    wdf --regex "^[a-z0-9]{3}\\.com$"
+
+This generates:
+
+- aaa.com  
+- aab.com  
+- …  
+- zzz.com  
+
+Regex mode supports:
+
+- character classes  
+- alternation  
+- anchors  
+- quantifiers  
+- grouping  
+
+---
+
+  Regex Helper
+
+    Three‑letter domains
+
+    ^[a-z]{3}\\.(com|net|org)$
+
+    Two letters + one digit
+
+    ^[a-z]{2}[0-9]\\.com$
+
+    Start with “go”, then any 2 chars
+
+    ^go[a-z0-9]{2}\\.io$
+
+    Premium TLDs only
+
+    ^[a-z]{3,5}\\.(ai|io|dev)$
+
+    Only letters (no digits)
+
+    ^[a-z]+\\.(com|net)$
+
+    Letters + optional hyphen
+
+    ^[a-z]+(-[a-z]+)?\\.com$
+
+    Multiple TLDs
+
+    ^[a-z]{4}\\.(com|io|ai|co)$
+
+---
+
+  TLD Selection
+
+Choose from:
+
+- explicit list  
+- all known TLDs  
+- premium curated list  
+
+Examples:
+
+    wdf -d "go*" --tlds all
+
+    wdf -d "ai*" --tlds premium
+
+    wdf -d "shop*" --tlds com,net,org,io
+
+---
+
+  Filtering
+
+Filters allow you to refine generated domains.
+
+Supported filters:
+
+- tld:com  
+- length<=3  
+- starts:go  
+- ends:ai  
+
+Examples:
+
+    wdf -d "***.com" --filter length<=3
+
+    wdf -d "*ai" --filter ends:ai
+
+    wdf -d "go*" --filter starts:go
+
+---
+
+  Sorting
+
+Sorting options:
+
+- comfirst  
+- tld  
+- length  
+- alpha  
+
+Example:
+
+    wdf -d "***.com" --sort comfirst
+
+---
+
+  Output Formats
+
+Choose from:
+
+- txt  
+- json  
+- jsonl  
+- csv  
+
+Example:
+
+    wdf -d "go*" -F jsonl -o results.jsonl
+
+---
+
+  Caching and Resume Mode
+
+Large scans can be resumed:
+
+    wdf -R
+
+Disable caching:
+
+    wdf --no-cache
+
+---
+
+  Interactive Mode
+
+If no domain or regex is provided:
+
+    wdf
+
+You will be prompted for:
+
+- mode  
+- pattern  
+- TLDs  
+- filters  
+- output format  
+
+---
+
+  Common Recipes
+
+    Find all 3‑letter .com domains
+
+    wdf --regex "^[a-z]{3}\\.com$"
+
+    Find all domains starting with “go” across all TLDs
+
+    wdf -d "go*" --tlds all
+
+    Find short premium domains
+
+    wdf -d "***" --tlds premium --filter length<=3
+
+    Find 4‑letter .io or .ai domains
+
+    wdf --regex "^[a-z]{4}\\.(io|ai)$"
+
+    Wildcard + filtering + sorting
+
+    wdf -d "go**.com" --filter length<=4 --sort alpha
+
+---
+
+  Performance Tips
+
+    1. Increase concurrency for faster scans
+
+    --concurrency 50
+
+    2. Reduce DNS timeout for faster failures
+
+    --timeout 2000
+
+    3. Use JSONL for huge output sets
+
+    -F jsonl
+
+    4. Use resume mode for long scans
+
+    -R
+
+    5. Limit search space with filters
+
+    --filter length<=4  
+    --filter starts:go  
+    --filter tld:com  
+
+    6. Prefer regex for structured patterns
+
+Regex mode avoids generating unnecessary combinations.
+
+---
+
+  Full Examples
+
+    Wildcard + premium TLDs
+
+    wdf -d "ai*" --tlds premium
+
+    Regex + JSONL output
+
+    wdf --regex "^[a-z]{4}\\.(io|ai)$" -F jsonl
+
+    Resume a long scan
+
+    wdf -R
+
+---
+
+  Features
+
+- ⚡ Streaming domain generation (no memory blowups)
+- 🃏 Wildcard mode (* = single character)
+- 🔍 Regex mode
+- 🌍 TLD selection (explicit, all, premium)
+- 🧹 Filtering (tld, length, starts, ends)
+- 🔃 Sorting (comfirst, tld, length, alpha)
+- 📝 Multiple output formats (txt, json, jsonl, csv)
+- 💾 Caching + resume mode
+- ⏸️ Interactive pause/resume/quit
+- ⏱️ Concurrency + timeout controls
+- 🛡️ Graceful error handling
+- ❓ Full CLI help system
+
+---
+
+  License
+
+ISC  
+All original licensing terms are preserved.
+
+---
+
+  Links
+
+- NPM Package: https://www.npmjs.com/package/wildcard-domain-finder-plus  
+- GitHub Repository: https://github.com/nbcr/wildcard-domain-finder-plus  
+- Issues: https://github.com/nbcr/wildcard-domain-finder-plus/issues  
 Attribution
 This project is an enhanced fork of
 besoeasy/wildcard-domain-finder

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "wildcard-domain-finder-plus",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "Advanced wildcard and regex-based domain availability scanner with streaming generation, filtering, sorting, and caching.",
   "main": "app.js",
   "bin": {
-    "wildcard-domain-finder-plus": "app.js"
+    "wildcard-domain-finder-plus": "app.js",
+    "wdf": "app.js"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"