sunan-abi-dawud 1.0.4

Complete Sunan Abi Dawud — 5,274 hadiths with full Arabic text and English translations. Offline-first, zero dependencies. CLI + Python library.

🕌 Sunan Abi Dawud

📚 Complete Sunan Abi Dawud for JavaScript — CLI, Node.js, React, Vue, and every bundler. Tiny package, data served from CDN.

---

📊 Package Statistics

Metric	Value	Description
📚 Total Hadiths	5,274	Complete Sunan Abi Dawud collection
📝 Chapters	1,871	Detailed chapter organization
📦 Package Size	~3KB	Core package — data loads from CDN
🔧 Dependencies	0	Zero external dependencies
🌐 Bilingual	✅	Full Arabic text + English translations
📘 TypeScript	✅	Built-in type definitions

---

🚀 Installation

npm install sunan-abi-dawud        # local
npm install -g sunan-abi-dawud     # global CLI

---

🖥️ CLI Usage

dawud 1                  # First hadith
dawud 2345               # Hadith #2345
dawud 23 34              # 34th hadith of chapter 23
dawud 2345 -a            # Arabic only
dawud 2345 -b            # Arabic + English
dawud --react            # Generate React hook in current project
dawud --help
dawud --version

---

⚛️ React / Vue / Vite

cd my-react-app
dawud --react
# ✓ Generated: src/hooks/useDawud.js

import { useDawud } from '../hooks/useDawud';

function HadithOfTheDay() {
  const dawud = useDawud();
  if (!dawud) return <p>Loading...</p>;

  const hadith = dawud.getRandom();
  return (
    <div>
      <p><strong>{hadith.english.narrator}</strong></p>
      <p>{hadith.english.text}</p>
    </div>
  );
}

---

🟩 Node.js Usage

// CommonJS
const dawud = require('sunan-abi-dawud');
console.log(dawud.get(1));
console.log(dawud.search('prayer'));
console.log(dawud.getRandom());
console.log(dawud.getByChapter(1));
console.log(dawud.length);

// ESM
import dawud from 'sunan-abi-dawud';
const hadith = dawud.get(23);
console.log(hadith.english.text);

---

🛠️ API Reference

Method / Property	Description
dawud[0]	Hadith at index 0
dawud.get(id)	Hadith by ID
dawud.getByChapter(id)	All hadiths in a chapter
dawud.search(query)	Full-text search
dawud.getRandom()	Random hadith
dawud.length	Total hadiths
dawud.metadata	Book metadata
dawud.chapters	All chapters

All native array methods work: find, filter, map, forEach, slice.

---

📐 Data Structure

{
  "id": 1,
  "chapterId": 1,
  "arabic": "حَدَّثَنَا...",
  "english": {
    "narrator": "Abu Huraira",
    "text": "The Prophet (ﷺ) said..."
  }
}

---

📄 License

GNU Affero General Public License v3.0 (AGPL-3.0)

---

Made with ❤️ for the Muslim community | Seeking knowledge together