sunnah 1.4.0 → 1.5.0

package/books/sunan-abi-dawud/README.md

@@ -0,0 +1,149 @@
+<div align="center">
+
+<h1>🕌 Sunan Abi Dawud</h1>
+
+![npm version](https://img.shields.io/npm/v/sunan-abi-dawud?style=for-the-badge&logo=npm)
+![npm downloads](https://img.shields.io/npm/dt/sunan-abi-dawud?style=for-the-badge&logo=npm)
+![npm downloads per month](https://img.shields.io/npm/dm/sunan-abi-dawud?style=for-the-badge&logo=npm)
+![license](https://img.shields.io/github/license/SENODROOM/sunan-abi-dawud?style=for-the-badge&logo=gnu)
+![node version](https://img.shields.io/node/v/sunan-abi-dawud?style=for-the-badge&logo=node.js)
+![bundle size](https://img.shields.io/bundlephobia/minzip/sunan-abi-dawud?style=for-the-badge)
+![GitHub stars](https://img.shields.io/github/stars/SENODROOM/sunan-abi-dawud?style=for-the-badge&logo=github)
+
+**📚 Complete Sunan Abi Dawud for JavaScript — CLI, Node.js, React, Vue, and every bundler. Tiny package, data served from CDN.**
+
+[![NPM](https://nodei.co/npm/sunan-abi-dawud.png)](https://nodei.co/npm/sunan-abi-dawud/)
+
+</div>
+
+---
+
+## 📊 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
+
+```bash
+npm install sunan-abi-dawud        # local
+npm install -g sunan-abi-dawud     # global CLI
+```
+
+---
+
+## 🖥️ CLI Usage
+
+```bash
+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
+
+```bash
+cd my-react-app
+dawud --react
+# ✓ Generated: src/hooks/useDawud.js
+```
+
+```jsx
+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
+
+```javascript
+// 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
+
+```javascript
+{
+  "id": 1,
+  "chapterId": 1,
+  "arabic": "حَدَّثَنَا...",
+  "english": {
+    "narrator": "Abu Huraira",
+    "text": "The Prophet (ﷺ) said..."
+  }
+}
+```
+
+---
+
+## 📄 License
+
+**GNU Affero General Public License v3.0 (AGPL-3.0)**
+
+---
+
+<div align="center">
+
+**Made with ❤️ for the Muslim community | Seeking knowledge together**
+
+[![GitHub stars](https://img.shields.io/github/stars/SENODROOM/sunan-abi-dawud?style=for-the-badge&logo=github)](https://github.com/SENODROOM/sunan-abi-dawud)
+
+</div>

package/books/sunan-abi-dawud/bin/index.js

@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+// CLI for sahih-dawud
+
+import fs   from 'fs';
+import zlib from 'zlib';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { Dawud } from '../src/index.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname  = path.dirname(__filename);
+const pkg        = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
+
+function loadData() {
+  const gzPath   = path.join(__dirname, '..', 'data', 'dawud.json.gz');
+  const jsonPath = path.join(__dirname, '..', 'data', 'dawud.json');
+  if (fs.existsSync(gzPath))   return JSON.parse(zlib.gunzipSync(fs.readFileSync(gzPath)).toString('utf8'));
+  if (fs.existsSync(jsonPath)) return JSON.parse(fs.readFileSync(jsonPath, 'utf8'));
+  throw new Error('Data file not found. Expected data/dawud.json.gz or data/dawud.json');
+}
+
+const dawudData = loadData();
+const _byId      = new Map();
+const _byChapter = new Map();
+dawudData.hadiths.forEach(h => {
+  _byId.set(h.id, h);
+  if (!_byChapter.has(h.chapterId)) _byChapter.set(h.chapterId, []);
+  _byChapter.get(h.chapterId).push(h);
+});
+
+const dawud = new Dawud(dawudData);
+export default dawud;
+export { Dawud };
+
+const c = { reset:'\x1b[0m',bold:'\x1b[1m',dim:'\x1b[2m',green:'\x1b[32m',yellow:'\x1b[33m',cyan:'\x1b[36m',magenta:'\x1b[35m',blue:'\x1b[34m',red:'\x1b[31m',gray:'\x1b[90m' };
+const clr=(col,t)=>`${col}${t}${c.reset}`;
+const bold=t=>clr(c.bold,t),green=t=>clr(c.green,t),yellow=t=>clr(c.yellow,t),cyan=t=>clr(c.cyan,t),magenta=t=>clr(c.magenta,t),gray=t=>clr(c.gray,t),red=t=>clr(c.red,t),blue=t=>clr(c.blue,t),dim=t=>clr(c.dim,t);
+
+function highlight(text, term) {
+  if (!term) return text;
+  const re = new RegExp(`(${term.replace(/[.*+?^${}()|[\]\\]/g,'\\$&')})`,'gi');
+  return text.replace(re,`\x1b[1m\x1b[33m$1\x1b[0m`);
+}
+
+function wrap(text, width=72, indent='') {
+  const words=text.split(' '),lines=[];let line='';
+  for(const word of words){if((line+' '+word).trim().length>width){if(line)lines.push(indent+line.trim());line=word;}else{line=(line+' '+word).trim();}}
+  if(line)lines.push(indent+line.trim());
+  return lines.join('\n');
+}
+
+function isRunDirectly(){
+  if(!process.argv[1])return false;
+  const argv1=path.resolve(process.argv[1]).toLowerCase().replace(/\\/g,'/');
+  const self=__filename.toLowerCase().replace(/\\/g,'/');
+  const base=path.basename(argv1).replace(/\.js$/,'');
+  return argv1===self||base==='dawud';
+}
+
+if(isRunDirectly()){
+const rawArgs=process.argv.slice(2);
+const flags=rawArgs.filter(a=>a.startsWith('-'));
+const numArgs=rawArgs.filter(a=>!a.startsWith('-'));
+const wantsHelp=flags.some(f=>f==='-h'||f==='--help');
+const wantsVersion=flags.some(f=>f==='-v'||f==='--version');
+const wantsReact=flags.some(f=>f==='--react');
+const wantsRandom=flags.some(f=>f==='--random'||f==='-r');
+const wantsAll=flags.some(f=>f==='--all');
+const showArabic=flags.some(f=>f==='-a'||f==='--arabic');
+const showBoth=flags.some(f=>f==='-b'||f==='--both');
+const printArabic=showArabic||showBoth;
+const printEnglish=!showArabic||showBoth;
+const searchIdx=rawArgs.findIndex(a=>a==='--search'||a==='-s');
+const searchQuery=searchIdx!==-1&&rawArgs[searchIdx+1]&&!rawArgs[searchIdx+1].startsWith('-')?rawArgs[searchIdx+1]:null;
+const chapterIdx=rawArgs.findIndex(a=>a==='--chapter'||a==='-c');
+const chapterArg=chapterIdx!==-1&&rawArgs[chapterIdx+1]&&!rawArgs[chapterIdx+1].startsWith('-')?parseInt(rawArgs[chapterIdx+1]):null;
+const DIV=gray('─'.repeat(60)),DIV2=gray('═'.repeat(60));
+
+if(wantsVersion){console.log('');console.log('  '+bold(cyan('sahih-dawud'))+gray(' v'+pkg.version));console.log('  '+gray('Total hadiths : ')+yellow(dawudData.hadiths.length.toLocaleString()));console.log('  '+gray('Total chapters: ')+yellow(dawudData.chapters.length.toLocaleString()));console.log('  '+gray('Author        : ')+cyan('Imam Dawud ibn al-Hajjaj'));console.log('');process.exit(0);}
+
+if(wantsRandom){printHadith(dawudData.hadiths[Math.floor(Math.random()*dawudData.hadiths.length)]);process.exit(0);}
+
+if(chapterArg!==null){
+  const hadiths=_byChapter.get(chapterArg)||[];
+  const chapter=dawudData.chapters.find(c=>c.id===chapterArg);
+  if(!hadiths.length){console.log('\n'+red('  No chapter found with id '+chapterArg)+'\n');process.exit(1);}
+  console.log('');console.log(DIV2);
+  console.log(bold(cyan('  Chapter '+chapterArg))+(chapter?gray(' — ')+yellow(chapter.english):''));
+  if(chapter?.arabic)console.log('  '+magenta(chapter.arabic));
+  console.log(gray('  '+hadiths.length+' hadiths'));console.log(DIV2);
+  hadiths.forEach(h=>printHadith(h));process.exit(0);
+}
+
+if(searchQuery!==null){
+  const start=Date.now(),ql=searchQuery.toLowerCase();
+  const results=dawudData.hadiths.filter(h=>h.english?.text?.toLowerCase().includes(ql)||h.english?.narrator?.toLowerCase().includes(ql));
+  const elapsed=Date.now()-start;
+  console.log('');console.log(DIV2);
+  console.log(bold(cyan('  Search: '))+yellow('"'+searchQuery+'"')+gray('  —  ')+green(results.length+' results')+gray('  ('+elapsed+'ms)'));
+  console.log(DIV2);
+  if(!results.length){console.log('\n  '+red('No hadiths found for: ')+yellow('"'+searchQuery+'"')+'\n');process.exit(0);}
+  const limit=wantsAll?results.length:Math.min(5,results.length);
+  results.slice(0,limit).forEach((hadith,i)=>{
+    const chapter=dawudData.chapters.find(c=>c.id===hadith.chapterId);
+    console.log('');
+    console.log(bold(green('  #'+(i+1)))+gray('  Hadith '+hadith.id)+gray('  |  Chapter: ')+cyan(hadith.chapterId)+(chapter?gray(' — ')+dim(chapter.english):''));
+    if(hadith.english?.narrator)console.log('  '+bold(yellow('Narrator: '))+magenta(hadith.english.narrator));
+    if(hadith.english?.text)console.log('  '+wrap(highlight(hadith.english.text,searchQuery),68,'  ').trimStart());
+    console.log(DIV);
+  });
+  if(!wantsAll&&results.length>5){console.log('');console.log('  '+gray('Showing ')+cyan('5')+gray(' of ')+yellow(results.length)+gray(' results.  ')+bold(blue('Run with --all to see all results')));console.log('  '+dim('dawud --search "'+searchQuery+'" --all'));console.log('');}
+  process.exit(0);
+}
+
+if(wantsReact){
+  const cwd=process.cwd(),srcDir=path.join(cwd,'src'),hooksDir=path.join(srcDir,'hooks');
+  const pkgPath=path.join(cwd,'package.json');
+  if(!fs.existsSync(pkgPath)){console.error(red('  ✗ No package.json found.'));process.exit(1);}
+  const projectPkg=JSON.parse(fs.readFileSync(pkgPath,'utf8'));
+  const deps={...projectPkg.dependencies,...projectPkg.devDependencies};
+  if(!deps['react']){console.error(red('  ✗ React not found.'));process.exit(1);}
+  if(!fs.existsSync(srcDir)){console.error(red('  ✗ No src/ directory found.'));process.exit(1);}
+  if(!fs.existsSync(hooksDir))fs.mkdirSync(hooksDir,{recursive:true});
+  const CDN=`https://cdn.jsdelivr.net/npm/sahih-dawud@${pkg.version}/data/dawud.json.gz`;
+  const hookFile=path.join(hooksDir,'useDawud.js');
+  const hookSrc=`// Auto-generated by: dawud --react\nimport { useState, useEffect } from 'react';\nconst CDN = '${CDN}';\nlet _cache=null,_promise=null;\nconst _subs=new Set();\nfunction _load(){if(_cache)return Promise.resolve(_cache);if(_promise)return _promise;_promise=fetch(CDN).then(r=>r.arrayBuffer()).then(buf=>{const stream=new DecompressionStream('gzip');const writer=stream.writable.getWriter();const reader=stream.readable.getReader();writer.write(new Uint8Array(buf));writer.close();const chunks=[];return(function pump(){return reader.read().then(({done,value})=>{if(done){const text=new TextDecoder().decode(new Uint8Array(chunks.reduce((a,b)=>[...a,...b],[])));const data=JSON.parse(text);const hadiths=data.hadiths;const _byId=new Map();hadiths.forEach(h=>_byId.set(h.id,h));_cache=Object.assign([],hadiths,{metadata:data.metadata,chapters:data.chapters,get:id=>_byId.get(id),getByChapter:id=>hadiths.filter(h=>h.chapterId===id),search:(q,limit=0)=>{const ql=q.toLowerCase();const r=hadiths.filter(h=>h.english?.text?.toLowerCase().includes(ql)||h.english?.narrator?.toLowerCase().includes(ql));return limit>0?r.slice(0,limit):r;},getRandom:()=>hadiths[Math.floor(Math.random()*hadiths.length)]});_subs.forEach(fn=>fn(_cache));_subs.clear();return _cache;}chunks.push(value);return pump();});})();});return _promise;}\n_load();\nexport function useDawud(){const[dawud,setDawud]=useState(_cache);useEffect(()=>{if(_cache){setDawud(_cache);}else{_subs.add(setDawud);return()=>_subs.delete(setDawud);}},[]);return dawud;}\nexport default useDawud;\n`;
+  fs.writeFileSync(hookFile,hookSrc,'utf8');
+  console.log('\n  '+green('✓')+bold(' Generated: ')+cyan('src/hooks/useDawud.js')+'\n');
+  process.exit(0);
+}
+
+if(wantsHelp||(numArgs.length===0&&!searchQuery&&chapterArg===null&&!wantsRandom)){
+  console.log('');console.log('  '+bold(cyan('Sahih Dawud CLI'))+gray('  v'+pkg.version));console.log('');
+  console.log('  '+bold('Usage:'));
+  console.log('    '+cyan('dawud')+yellow(' <hadithId>')+gray('                   Show hadith by global ID'));
+  console.log('    '+cyan('dawud')+yellow(' <chapterId> <hadithId>')+gray('       Show hadith within a chapter'));
+  console.log('    '+cyan('dawud')+green(' --search')+yellow(' "<query>"')+gray('            Search hadiths (top 5)'));
+  console.log('    '+cyan('dawud')+green(' --search')+yellow(' "<query>"')+green(' --all')+gray('    Show all results'));
+  console.log('    '+cyan('dawud')+green(' --chapter')+yellow(' <id>')+gray('              List all hadiths in a chapter'));
+  console.log('    '+cyan('dawud')+green(' --random')+gray('                   Show a random hadith'));
+  console.log('');
+  console.log('  '+bold('Language flags:')+gray('  (default = English only)'));
+  console.log('    '+green('-a')+gray(', ')+green('--arabic')+gray('   Arabic only'));
+  console.log('    '+green('-b')+gray(', ')+green('--both')+gray('     Arabic + English'));
+  console.log('');
+  console.log('  '+bold('Other:'));
+  console.log('    '+green('--react')+gray('    Generate useDawud React hook'));
+  console.log('    '+green('-v')+gray(', ')+green('--version')+gray(' Show version'));
+  console.log('    '+green('-h')+gray(', ')+green('--help')+gray('    Show this help'));
+  console.log('');process.exit(0);
+}
+
+function printHadith(hadith){
+  if(!hadith){console.log('\n  '+red('Hadith not found.')+'\n');process.exit(1);}
+  const chapter=dawudData.chapters?.find(c=>c.id===hadith.chapterId);
+  console.log('');console.log(DIV2);
+  const headerEn=bold(cyan('Hadith #'+hadith.id))+gray('  |  Chapter: ')+cyan(hadith.chapterId)+(chapter?.english?gray(' — ')+yellow(chapter.english):'');
+  const headerAr=bold(magenta('حديث #'+hadith.id))+gray('  |  باب: ')+magenta(hadith.chapterId)+(chapter?.arabic?gray(' — ')+magenta(chapter.arabic):'');
+  console.log('  '+(printArabic&&!printEnglish?headerAr:headerEn));
+  console.log(DIV2);
+  if(printEnglish){if(hadith.english?.narrator)console.log('  '+bold(yellow('Narrator: '))+magenta(hadith.english.narrator));if(hadith.english?.text){console.log('');console.log(wrap(hadith.english.text,68,'  '));}}
+  if(printArabic){if(printEnglish)console.log('\n'+DIV);if(hadith.arabic){console.log('');console.log('  '+magenta(hadith.arabic));}}
+  console.log('');console.log(DIV2);console.log('');
+}
+
+function resolveHadith(){
+  if(numArgs.length===1){const id=parseInt(numArgs[0]);if(isNaN(id))return null;return _byId.get(id)||null;}
+  if(numArgs.length===2){
+    const chapterId=parseInt(numArgs[0]),hadithNum=parseInt(numArgs[1]);
+    if(isNaN(chapterId)||isNaN(hadithNum))return null;
+    const inChapter=_byChapter.get(chapterId);
+    if(!inChapter?.length){console.log('\n  '+red('No chapter found with id '+chapterId+'.')+'\n');process.exit(1);}
+    return inChapter.find(h=>h.id===hadithNum)??inChapter[hadithNum-1]??null;
+  }
+  return null;
+}
+
+if(numArgs.length>0){
+  const hadith=resolveHadith();
+  if(!hadith){console.log('\n  '+red('Invalid arguments.')+' Run '+cyan('dawud --help')+' for usage.\n');process.exit(1);}
+  printHadith(hadith);
+}
+}

package/books/sunan-abi-dawud/examples/express/server.js

@@ -0,0 +1,7 @@
+import express from 'express';
+import dawud from 'sunan-abi-dawud';
+const app = express();
+app.get('/api/hadith/random', (_, res) => res.json(dawud.getRandom()));
+app.get('/api/hadith/:id', (req, res) => { const h = dawud.get(parseInt(req.params.id)); h ? res.json(h) : res.status(404).json({error:'Not found'}); });
+app.get('/api/search', (req, res) => res.json(dawud.search(req.query.q||'', parseInt(req.query.limit)||0)));
+app.listen(3000, () => console.log('Sunan Abi Dawud API at http://localhost:3000'));

package/books/sunan-abi-dawud/examples/node-commonjs/example.js

@@ -0,0 +1,7 @@
+'use strict';
+const dawud = require('sunan-abi-dawud');
+console.log('Total hadiths:', dawud.length);
+const h = dawud.get(1);
+console.log('Hadith #1:', h.english.narrator, '-', h.english.text.slice(0,60)+'...');
+console.log('Search "prayer":', dawud.search('prayer').length, 'results');
+console.log('Random:', dawud.getRandom().id);

package/books/sunan-abi-dawud/examples/node-esm/example.mjs

@@ -0,0 +1,6 @@
+import dawud from 'sunan-abi-dawud';
+console.log('Total hadiths:', dawud.length);
+console.log('Title:', dawud.metadata.english.title);
+const h = dawud.get(1);
+console.log('Hadith #1:', h.english.narrator, '-', h.english.text.slice(0,60)+'...');
+console.log('Chapter 1 hadiths:', dawud.getByChapter(1).length);

package/books/sunan-abi-dawud/examples/react/HadithExample.jsx

@@ -0,0 +1,17 @@
+// Run `dawud --react` in your project first
+import { useState } from 'react';
+import { useDawud } from '../hooks/useDawud';
+
+export function HadithOfTheDay() {
+  const dawud = useDawud();
+  if (!dawud) return <p>Loading...</p>;
+  const h = dawud.getRandom();
+  return (<div><strong>{h.english.narrator}</strong><p>{h.english.text}</p></div>);
+}
+
+export function HadithSearch() {
+  const dawud = useDawud();
+  const [results, setResults] = useState([]);
+  if (!dawud) return <p>Loading...</p>;
+  return (<><input placeholder="Search..." onChange={e => setResults(dawud.search(e.target.value, 20))} />{results.map(h => <div key={h.id}><p>{h.english.text}</p></div>)}</>);
+}

package/books/sunan-abi-dawud/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "sunan-abi-dawud",
+  "version": "1.0.5",
+  "description": "Complete Sunan Abi Dawud. Offline-first, zero dependencies. CLI + Node + React/Vue/Vite.",
+  "type": "module",
+  "main": "./src/index.cjs",
+  "module": "./src/index.browser.js",
+  "types": "./types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "browser": "./src/index.browser.js",
+      "require": "./src/index.cjs",
+      "import": "./src/index.node.js"
+    },
+    "./data/chapters/*": "./data/chapters/*"
+  },
+  "bin": {
+    "dawud": "bin/index.js"
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "prepublishOnly": "node scripts/build.mjs"
+  },
+  "keywords": [
+    "islam",
+    "hadith",
+    "dawud",
+    "abu-dawud",
+    "sunan",
+    "sunnah",
+    "json",
+    "arabic",
+    "english",
+    "quran",
+    "react",
+    "hook"
+  ],
+  "author": "muhammadsaadamin",
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SENODROOM/sunan-abi-dawud.git"
+  },
+  "bugs": {
+    "url": "https://github.com/SENODROOM/sunan-abi-dawud/issues"
+  },
+  "homepage": "https://github.com/SENODROOM/sunan-abi-dawud#readme",
+  "files": [
+    "src/",
+    "types/",
+    "bin/index.js",
+    "data/dawud.json.gz"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/books/sunan-abi-dawud/src/index.cjs

@@ -0,0 +1,52 @@
+// CommonJS entry — require('sunan-abi-dawud')
+'use strict';
+const fs   = require('fs');
+const zlib = require('zlib');
+const path = require('path');
+
+function loadData() {
+  const gzPath   = path.join(__dirname, '..', 'data', 'dawud.json.gz');
+  const jsonPath = path.join(__dirname, '..', 'data', 'dawud.json');
+  if (fs.existsSync(gzPath))   return JSON.parse(zlib.gunzipSync(fs.readFileSync(gzPath)).toString('utf8'));
+  if (fs.existsSync(jsonPath)) return JSON.parse(fs.readFileSync(jsonPath, 'utf8'));
+  throw new Error('Data file not found. Expected data/dawud.json.gz or data/dawud.json');
+}
+const dawudData = loadData();
+
+class Dawud {
+  constructor(dawudData) {
+    this._hadiths = dawudData.hadiths;
+    return new Proxy(this._hadiths, {
+      get: (target, prop) => {
+        if (!isNaN(prop))   return target[parseInt(prop)];
+        if (prop in target) return target[prop];
+        switch (prop) {
+          case 'metadata':     return dawudData.metadata;
+          case 'chapters':     return dawudData.chapters;
+          case 'get':          return (id) => this._hadiths.find(h => h.id === id);
+          case 'getByChapter': return (id) => this._hadiths.filter(h => h.chapterId === id);
+          case 'search':       return (q, limit = 0) => {
+            const ql = q.toLowerCase();
+            const r  = this._hadiths.filter(h =>
+              h.english?.text?.toLowerCase().includes(ql) ||
+              h.english?.narrator?.toLowerCase().includes(ql)
+            );
+            return limit > 0 ? r.slice(0, limit) : r;
+          };
+          case 'getRandom': return () => this._hadiths[Math.floor(Math.random() * this._hadiths.length)];
+          case 'length':    return target.length;
+          default:          return target[prop];
+        }
+      },
+      ownKeys: (target) => [
+        'length',
+        ...Array.from({ length: target.length }, (_, i) => String(i)),
+        'metadata', 'chapters', 'get', 'getByChapter', 'search', 'getRandom'
+      ]
+    });
+  }
+}
+const dawud = new Dawud(dawudData);
+module.exports = dawud;
+module.exports.Dawud   = Dawud;
+module.exports.default = dawud;

package/books/sunan-abi-dawud/src/index.js

@@ -0,0 +1,35 @@
+// ESM browser-safe entry (class only — no data)
+export class Dawud {
+  constructor(dawudData) {
+    this._hadiths = dawudData.hadiths;
+    return new Proxy(this._hadiths, {
+      get: (target, prop) => {
+        if (!isNaN(prop))   return target[parseInt(prop)];
+        if (prop in target) return target[prop];
+        switch (prop) {
+          case 'metadata':     return dawudData.metadata;
+          case 'chapters':     return dawudData.chapters;
+          case 'get':          return (id) => this._hadiths.find(h => h.id === id);
+          case 'getByChapter': return (id) => this._hadiths.filter(h => h.chapterId === id);
+          case 'search':       return (q, limit = 0) => {
+            const ql = q.toLowerCase();
+            const r  = this._hadiths.filter(h =>
+              h.english?.text?.toLowerCase().includes(ql) ||
+              h.english?.narrator?.toLowerCase().includes(ql)
+            );
+            return limit > 0 ? r.slice(0, limit) : r;
+          };
+          case 'getRandom': return () => this._hadiths[Math.floor(Math.random() * this._hadiths.length)];
+          case 'length':    return target.length;
+          default:          return target[prop];
+        }
+      },
+      ownKeys: (target) => [
+        'length',
+        ...Array.from({ length: target.length }, (_, i) => String(i)),
+        'metadata', 'chapters', 'get', 'getByChapter', 'search', 'getRandom'
+      ]
+    });
+  }
+}
+export default Dawud;

package/books/sunan-abi-dawud/src/index.node.js

@@ -0,0 +1,18 @@
+// Node ESM entry
+import fs   from 'fs';
+import zlib from 'zlib';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { Dawud } from './index.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+function loadData() {
+  const gzPath   = path.join(__dirname, '..', 'data', 'dawud.json.gz');
+  const jsonPath = path.join(__dirname, '..', 'data', 'dawud.json');
+  if (fs.existsSync(gzPath))   return JSON.parse(zlib.gunzipSync(fs.readFileSync(gzPath)).toString('utf8'));
+  if (fs.existsSync(jsonPath)) return JSON.parse(fs.readFileSync(jsonPath, 'utf8'));
+  throw new Error('Data file not found. Expected data/dawud.json.gz or data/dawud.json');
+}
+export { Dawud };
+export default new Dawud(loadData());

package/books/sunan-abi-dawud/types/index.d.ts

@@ -0,0 +1,28 @@
+export interface HadithEnglish { narrator: string; text: string; }
+export interface Hadith { id: number; chapterId: number; arabic: string; english: HadithEnglish; }
+export interface Chapter { id: number; arabic: string; english: string; }
+export interface Metadata {
+  id: number; length: number;
+  arabic:  { title: string; author: string; introduction: string };
+  english: { title: string; author: string; introduction: string };
+}
+export interface DawudData { metadata: Metadata; chapters: Chapter[]; hadiths: Hadith[]; }
+export interface DawudInstance extends ArrayLike<Hadith> {
+  [index: number]: Hadith;
+  readonly length: number;
+  readonly metadata: Metadata;
+  readonly chapters: Chapter[];
+  get(id: number): Hadith | undefined;
+  getByChapter(chapterId: number): Hadith[];
+  search(query: string, limit?: number): Hadith[];
+  getRandom(): Hadith;
+  find(predicate: (h: Hadith) => boolean): Hadith | undefined;
+  filter(predicate: (h: Hadith) => boolean): Hadith[];
+  map<T>(cb: (h: Hadith, i: number) => T): T[];
+  forEach(cb: (h: Hadith, i: number) => void): void;
+  slice(start?: number, end?: number): Hadith[];
+}
+export declare class Dawud { constructor(data: DawudData); }
+export declare function loadDawud(): Promise<DawudInstance>;
+declare const dawud: DawudInstance;
+export default dawud;