sunnah 1.3.6 → 1.5.0

package/books/sunan-ibn-majah/README.md

@@ -0,0 +1,198 @@
+<div align="center">
+
+<h1>
+  <img src="https://em-content.zobj.net/source/apple/391/mosque_1f54c.png" width="36" />
+  &nbsp;sunan-ibn-majah
+</h1>
+
+<p align="center">
+  <strong>The complete Sunan Ibn Majah — 4,341 hadiths, full Arabic & English.</strong><br />
+  Offline-first · zero dependencies · published on both <strong>npm</strong> and <strong>PyPI</strong>.
+</p>
+
+<br />
+
+<p>
+  <a href="https://www.npmjs.com/package/sunan-ibn-majah">
+    <img src="https://img.shields.io/npm/v/sunan-ibn-majah?style=for-the-badge&logo=npm&logoColor=white&color=CB3837&labelColor=1a1a1a" />
+  </a>
+  &nbsp;
+  <a href="https://pypi.org/project/sunan-ibn-majah/">
+    <img src="https://img.shields.io/pypi/v/sunan-ibn-majah?style=for-the-badge&logo=pypi&logoColor=white&color=3775A9&labelColor=1a1a1a" />
+  </a>
+  &nbsp;
+  <a href="https://github.com/SENODROOM/sunan-ibn-majah/blob/main/LICENSE">
+    <img src="https://img.shields.io/github/license/SENODROOM/sunan-ibn-majah?style=for-the-badge&logo=gnu&logoColor=white&color=A42E2B&labelColor=1a1a1a" />
+  </a>
+</p>
+
+<p>
+  <img src="https://img.shields.io/badge/Node.js-%3E%3D18-339933?style=for-the-badge&logo=node.js&logoColor=white&labelColor=1a1a1a" />
+  &nbsp;
+  <img src="https://img.shields.io/badge/Python-%3E%3D3.8-3776AB?style=for-the-badge&logo=python&logoColor=white&labelColor=1a1a1a" />
+  &nbsp;
+  <img src="https://img.shields.io/badge/Zero-Dependencies-00C853?style=for-the-badge&logoColor=white&labelColor=1a1a1a" />
+</p>
+
+</div>
+
+---
+
+## ✨ Features
+
+| | Feature | Details |
+|---|---|---|
+| 📚 | **Complete Collection** | All 4,341 hadiths from Sunan Ibn Majah |
+| 🌐 | **Bilingual** | Full Arabic text + English translation |
+| ⚡ | **Offline-first** | Data bundled — no CDN needed |
+| 🔧 | **Zero Dependencies** | Nothing extra to install |
+| 🔍 | **Full-text Search** | Search English text and narrator names |
+| 🖥️ | **CLI** | Terminal access with `-a`/`-b` Arabic flags + `--info`, `--chapters` |
+| ⚛️ | **React Hook** | One command generates `useMajah()` |
+| 🐍 | **Python** | Identical API — same camelCase method names |
+| 📘 | **TypeScript** | Full type definitions included |
+
+---
+
+## 🚀 Installation
+
+```bash
+npm install sunan-ibn-majah       # JS local
+npm install -g sunan-ibn-majah    # JS global CLI
+pip install sunan-ibn-majah       # Python
+```
+
+---
+
+## 🟨 JavaScript / Node.js
+
+```javascript
+const majah = require('sunan-ibn-majah');  // CJS
+import majah from 'sunan-ibn-majah';       // ESM
+
+majah.get(1)
+majah.getByChapter(1)
+majah.search('prayer')
+majah.search('prayer', 5)
+majah.getRandom()
+majah[0]
+majah.length
+majah.metadata
+majah.chapters
+```
+
+---
+
+## ⚛️ React
+
+```bash
+cd my-react-app
+majah --react    # generates src/hooks/useMajah.js
+```
+
+```jsx
+import { useMajah } from '../hooks/useMajah';
+
+function HadithOfTheDay() {
+  const majah = useMajah();
+  if (!majah) return <p>Loading...</p>;
+  const h = majah.getRandom();
+  return <div><strong>{h.english.narrator}</strong><p>{h.english.text}</p></div>;
+}
+```
+
+---
+
+## 🐍 Python
+
+```python
+from sunan_ibn_majah import Majah
+
+majah = Majah()
+
+majah.get(1)
+majah.getByChapter(1)
+majah.search("prayer")
+majah.search("prayer", limit=5)
+majah.getRandom()
+majah[0]
+majah.length
+majah.find(lambda h: h.id == 23)
+majah.filter(lambda h: h.chapterId == 1)
+majah.slice(0, 10)
+
+# Custom path
+majah = Majah(data_path="/path/to/majah.json")
+```
+
+---
+
+## 🖥️ CLI
+
+```bash
+majah 1                      # Hadith by ID
+majah 2345 -a                # Arabic only
+majah 2345 -b                # Arabic + English
+majah 23 3                   # 3rd hadith of chapter 23
+majah --search "prayer"
+majah --search "fasting" --all
+majah --chapter 1
+majah --chapters             # List all chapters
+majah --random
+majah --info                 # Book metadata
+majah --react
+majah --version
+```
+
+---
+
+## 📂 Structure
+
+```
+sunan-ibn-majah/
+├── data/
+│   ├── majah.json           ← source of truth
+│   ├── majah.json.gz        ← generated (shipped in packages)
+│   └── chapters/            ← generated (gitignored)
+├── bin/index.js             ← CLI
+├── src/                     ← JS source
+├── types/index.d.ts
+├── python/sunan_ibn_majah/  ← Python package
+├── scripts/build.mjs
+├── examples/
+├── docs/
+└── tests/
+```
+
+---
+
+## 🔧 Development
+
+```bash
+# Place your real majah.json in data/
+node scripts/build.mjs
+
+# Test locally
+python -m build --wheel
+python -m zipfile -l dist\sunan_ibn_majah-1.1.0-py3-none-any.whl | findstr "majah.json.gz"
+pip install dist\sunan_ibn_majah-1.1.0-py3-none-any.whl --force-reinstall
+majah 23
+```
+
+Publishing is automatic via GitHub Actions on every GitHub Release.
+
+---
+
+## 📄 License
+
+GNU Affero General Public License v3.0 (AGPL-3.0)
+
+---
+
+<div align="center">
+
+**Made with ❤️ for the Muslim community · Seeking knowledge together**
+
+[![Stars](https://img.shields.io/github/stars/SENODROOM/sunan-ibn-majah?style=for-the-badge&logo=github&logoColor=white&color=f0c040&labelColor=1a1a1a)](https://github.com/SENODROOM/sunan-ibn-majah/stargazers)
+
+</div>

package/books/sunan-ibn-majah/bin/index.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+// CLI for sunan-ibn-majah
+
+import fs   from 'fs';
+import zlib from 'zlib';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { Majah } 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', 'majah.json.gz');
+  const jsonPath = path.join(__dirname, '..', 'data', 'majah.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/majah.json.gz or data/majah.json');
+}
+
+const majahData = loadData();
+const { hadiths, chapters, metadata } = majahData;
+const _byId      = new Map();
+const _byChapter = new Map();
+hadiths.forEach(h => {
+  _byId.set(h.id, h);
+  if (!_byChapter.has(h.chapterId)) _byChapter.set(h.chapterId, []);
+  _byChapter.get(h.chapterId).push(h);
+});
+
+const majah = new Majah(majahData);
+export default majah;
+export { Majah };
+
+const c = { reset:'\x1b[0m',bold:'\x1b[1m',dim:'\x1b[2m',cyan:'\x1b[36m',green:'\x1b[32m',yellow:'\x1b[33m',magenta:'\x1b[35m',gray:'\x1b[90m',red:'\x1b[31m',blue:'\x1b[34m' };
+const cyan=s=>`${c.cyan}${c.bold}${s}${c.reset}`,green=s=>`${c.green}${s}${c.reset}`,yellow=s=>`${c.yellow}${s}${c.reset}`,magenta=s=>`${c.magenta}${s}${c.reset}`,bold=s=>`${c.bold}${s}${c.reset}`,dim=s=>`${c.dim}${s}${c.reset}`,gray=s=>`${c.gray}${s}${c.reset}`,red=s=>`${c.red}${s}${c.reset}`,blue=s=>`${c.blue}${s}${c.reset}`;
+const DIV=()=>gray('═'.repeat(60)),DIV2=()=>gray('─'.repeat(60));
+
+function getChapterName(id){const ch=chapters.find(c=>c.id===id);return ch?ch.english:'Unknown Chapter';}
+function highlightMatch(text,q){if(!q)return text;const re=new RegExp(`(${q.replace(/[.*+?^${}()|[\]\\]/g,'\\$&')})`,'gi');return text.replace(re,`${c.green}${c.bold}$1${c.reset}`);}
+function wrapText(text,indent=2,width=78){const words=text.split(' '),lines=[];let line=' '.repeat(indent);for(const word of words){if(line.length+word.length+1>width){lines.push(line);line=' '.repeat(indent)+word;}else{line+=(line.trim()?' ':'')+word;}}if(line.trim())lines.push(line);return lines.join('\n');}
+
+function printHadith(h, mode, query) {
+  if(!h){console.log(yellow('\n  Hadith not found.\n'));return;}
+  const chName=getChapterName(h.chapterId);
+  console.log('\n'+DIV());
+  if(mode==='-a'){
+    console.log(`\n  ${cyan('Hadith #'+h.id)}  ${gray('|')}  ${bold('Chapter: '+h.chapterId)} ${gray('—')} ${yellow(chName)}\n`);
+    console.log(wrapText(h.arabic)+'\n');
+  } else if(mode==='-b'){
+    console.log(`\n  ${cyan('Hadith #'+h.id)}  ${gray('|')}  ${bold('Chapter: '+h.chapterId)} ${gray('—')} ${yellow(chName)}\n`);
+    console.log(wrapText(h.arabic)+'\n');
+    console.log(`  ${bold('Narrator:')} ${magenta(h.english.narrator)}\n`);
+    console.log(wrapText(h.english.text)+'\n');
+  } else {
+    console.log(`\n  ${cyan('Hadith #'+h.id)}  ${gray('|')}  ${bold('Chapter: '+h.chapterId)} ${gray('—')} ${yellow(chName)}\n`);
+    console.log(`  ${bold('Narrator:')} ${magenta(query?highlightMatch(h.english.narrator,query):h.english.narrator)}\n`);
+    console.log(wrapText(query?highlightMatch(h.english.text,query):h.english.text)+'\n');
+  }
+  console.log(DIV()+'\n');
+}
+
+const args = process.argv.slice(2);
+
+if(!args.length||args[0]==='--help'){
+  console.log(`\n${DIV()}\n  ${cyan('majah')}  ${gray('·')}  ${bold('Sunan Ibn Majah')}  ${gray('v'+pkg.version)}\n${DIV()}\n\n  ${bold('Usage:')}\n\n    ${cyan('majah')} ${yellow('<id>')}                   Hadith by ID\n    ${cyan('majah')} ${yellow('<id>')} ${gray('-a')}                Arabic only\n    ${cyan('majah')} ${yellow('<id>')} ${gray('-b')}                Arabic + English\n    ${cyan('majah')} ${yellow('<chapter>')} ${yellow('<n>')}           nth hadith of a chapter\n    ${cyan('majah')} ${gray('--search')} ${yellow('"<query>"')}       Search in English text\n    ${cyan('majah')} ${gray('--search')} ${yellow('"<query>"')} ${gray('--all')}   Show all results\n    ${cyan('majah')} ${gray('--random')}                 Random hadith\n    ${cyan('majah')} ${gray('--chapter')} ${yellow('<id>')}           All hadiths in chapter\n    ${cyan('majah')} ${gray('--chapters')}               List all chapters\n    ${cyan('majah')} ${gray('--info')}                   Book metadata\n    ${cyan('majah')} ${gray('--react')}                  Generate React hook\n    ${cyan('majah')} ${gray('--version')}\n    ${cyan('majah')} ${gray('--help')}\n\n${DIV()}\n`);
+  process.exit(0);
+}
+
+if(args[0]==='--version'){console.log(`\n  ${cyan('sunan-ibn-majah')} ${gray('v'+pkg.version)}\n`);process.exit(0);}
+
+if(args[0]==='--info'){
+  console.log(`\n${DIV()}\n  ${cyan('Sunan Ibn Majah')}\n${DIV()}\n\n  ${bold('Title:')}        ${metadata.english.title}\n  ${bold('Author:')}       ${metadata.english.author}\n  ${bold('Total Hadiths:')} ${yellow(String(hadiths.length))}\n  ${bold('Chapters:')}     ${yellow(String(chapters.length))}\n\n${DIV()}\n`);
+  process.exit(0);
+}
+
+if(args[0]==='--chapters'){
+  console.log(`\n${DIV()}\n  ${cyan('Chapters')} ${gray('—')} ${bold('Sunan Ibn Majah')}\n${DIV()}\n`);
+  chapters.forEach(ch=>console.log(`  ${cyan('#'+String(ch.id).padEnd(5))} ${ch.english}`));
+  console.log(`\n${DIV()}\n`);process.exit(0);
+}
+
+if(args[0]==='--random'){printHadith(hadiths[Math.floor(Math.random()*hadiths.length)],args[1]);process.exit(0);}
+
+if(args[0]==='--chapter'){
+  const chapterId=parseInt(args[1]);
+  const results=hadiths.filter(h=>h.chapterId===chapterId);
+  const chName=getChapterName(chapterId);
+  if(!results.length){console.log(yellow(`\n  No hadiths found for chapter ${chapterId}.\n`));process.exit(0);}
+  console.log(`\n${DIV()}\n  ${cyan('Chapter '+chapterId)} ${gray('—')} ${bold(chName)}  ${gray('('+results.length+' hadiths)')}\n${DIV()}`);
+  results.forEach(h=>{console.log(`\n  ${cyan('Hadith #'+h.id)}`);console.log(`  ${bold('Narrator:')} ${magenta(h.english.narrator)}`);console.log(wrapText(h.english.text));console.log('\n'+DIV2());});
+  console.log('');process.exit(0);
+}
+
+if(args[0]==='--search'){
+  const showAll=args.includes('--all');
+  const query=args.slice(1).filter(a=>a!=='--all').join(' ').replace(/^["']|["']$/g,'');
+  if(!query){console.log(yellow('\n  Usage: majah --search "<query>" [--all]\n'));process.exit(1);}
+  const t0=Date.now();
+  const results=hadiths.filter(h=>h.english?.text?.toLowerCase().includes(query.toLowerCase())||h.english?.narrator?.toLowerCase().includes(query.toLowerCase()));
+  const ms=Date.now()-t0;
+  console.log('\n'+DIV());
+  console.log(`  ${bold('Search:')} ${yellow('"'+query+'"')}  ${gray('—')}  ${cyan(results.length+' results')}  ${gray('('+ms+'ms)')}`);
+  console.log(DIV());
+  if(!results.length){console.log(yellow(`\n  No results for "${query}"\n`));process.exit(0);}
+  const toShow=showAll?results:results.slice(0,5);
+  toShow.forEach((h,i)=>{
+    const chName=getChapterName(h.chapterId);
+    console.log(`\n  ${cyan('#'+(i+1))}  ${bold('Hadith '+h.id)}  ${gray('|')}  ${bold('Chapter: '+h.chapterId)} ${gray('—')} ${yellow(chName)}`);
+    console.log(`  ${bold('Narrator:')} ${magenta(highlightMatch(h.english.narrator,query))}`);
+    console.log(wrapText(highlightMatch(h.english.text,query)));
+    console.log('\n'+DIV2());
+  });
+  if(!showAll&&results.length>5){console.log(`\n  ${dim('Showing')} ${cyan('5')} ${dim('of')} ${cyan(String(results.length))} ${dim('results.')}  ${yellow('Run with --all to see all results')}`);console.log(`  ${gray('majah --search "'+query+'" --all')}\n`);}
+  else{console.log(`\n  ${dim('Showing all')} ${cyan(String(results.length))} ${dim('results.')}\n`);}
+  process.exit(0);
+}
+
+if(args[0]==='--react'){
+  const CDN='https://cdn.jsdelivr.net/npm/sunan-ibn-majah@'+pkg.version+'/data/majah.json.gz';
+  const hookSrc="// Auto-generated by: majah --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 useMajah(){const[majah,setMajah]=useState(_cache);useEffect(()=>{if(_cache){setMajah(_cache);}else{_subs.add(setMajah);return()=>_subs.delete(setMajah);}},[]);return majah;}\nexport default useMajah;\n";
+  const hooksDir=path.join(process.cwd(),'src','hooks');
+  if(!fs.existsSync(hooksDir))fs.mkdirSync(hooksDir,{recursive:true});
+  fs.writeFileSync(path.join(hooksDir,'useMajah.js'),hookSrc,'utf8');
+  console.log(green('\n\u2713 Generated: src/hooks/useMajah.js\n'));
+  process.exit(0);
+}
+
+if(args.length>=2&&!isNaN(parseInt(args[0]))&&!isNaN(parseInt(args[1]))){
+  const chapterId=parseInt(args[0]),n=parseInt(args[1]);
+  const inChapter=_byChapter.get(chapterId)||[];
+  printHadith(inChapter[n-1]??null,args[2]);process.exit(0);
+}
+
+const id=parseInt(args[0]);
+if(isNaN(id)){console.log(yellow(`\n  Unknown command: ${args[0]}. Run majah --help\n`));process.exit(1);}
+printHadith(_byId.get(id)||null,args[1]);

package/books/sunan-ibn-majah/examples/express/server.js

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

package/books/sunan-ibn-majah/examples/node-commonjs/example.js

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

package/books/sunan-ibn-majah/examples/node-esm/example.mjs

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

package/books/sunan-ibn-majah/examples/react/HadithExample.jsx

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

package/books/sunan-ibn-majah/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "sunan-ibn-majah",
+  "version": "1.1.2",
+  "description": "Complete Sunan Ibn Majah. 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": {
+    "majah": "bin/index.js"
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "prepublishOnly": "node scripts/build.mjs"
+  },
+  "keywords": [
+    "islam",
+    "hadith",
+    "majah",
+    "ibn-majah",
+    "sunan",
+    "sunnah",
+    "json",
+    "arabic",
+    "english",
+    "quran",
+    "react",
+    "hook"
+  ],
+  "author": "muhammadsaadamin",
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SENODROOM/sunan-ibn-majah.git"
+  },
+  "bugs": {
+    "url": "https://github.com/SENODROOM/sunan-ibn-majah/issues"
+  },
+  "homepage": "https://github.com/SENODROOM/sunan-ibn-majah#readme",
+  "files": [
+    "src/",
+    "types/",
+    "bin/index.js",
+    "data/majah.json.gz"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/books/sunan-ibn-majah/src/index.cjs

@@ -0,0 +1,52 @@
+// CommonJS entry — require('sunan-ibn-majah')
+'use strict';
+const fs   = require('fs');
+const zlib = require('zlib');
+const path = require('path');
+
+function loadData() {
+  const gzPath   = path.join(__dirname, '..', 'data', 'majah.json.gz');
+  const jsonPath = path.join(__dirname, '..', 'data', 'majah.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/majah.json.gz or data/majah.json');
+}
+const majahData = loadData();
+
+class Majah {
+  constructor(majahData) {
+    this._hadiths = majahData.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 majahData.metadata;
+          case 'chapters':     return majahData.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 majah = new Majah(majahData);
+module.exports = majah;
+module.exports.Majah   = Majah;
+module.exports.default = majah;

package/books/sunan-ibn-majah/src/index.js

@@ -0,0 +1,35 @@
+// ESM browser-safe entry (class only — no data)
+export class Majah {
+  constructor(majahData) {
+    this._hadiths = majahData.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 majahData.metadata;
+          case 'chapters':     return majahData.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 Majah;

package/books/sunan-ibn-majah/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 { Majah } from './index.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+function loadData() {
+  const gzPath   = path.join(__dirname, '..', 'data', 'majah.json.gz');
+  const jsonPath = path.join(__dirname, '..', 'data', 'majah.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/majah.json.gz or data/majah.json');
+}
+export { Majah };
+export default new Majah(loadData());

package/books/sunan-ibn-majah/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 MajahData { metadata: Metadata; chapters: Chapter[]; hadiths: Hadith[]; }
+export interface MajahInstance 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 Majah { constructor(data: MajahData); }
+export declare function loadMajah(): Promise<MajahInstance>;
+declare const majah: MajahInstance;
+export default majah;

package/package.json

@@ -1,27 +1,39 @@
-{
-  "name": "sunnah",
-  "version": "1.3.6",
-  "description": "Interactive CLI installer for Sunnah hadith npm packages",
-  "bin": {
-    "sunnah": "./bin/index.js"
-  },
-  "scripts": {
-    "test": "node bin/index.js --list"
-  },
-  "keywords": [
-    "sunnah",
-    "hadith",
-    "bukhari",
-    "muslim",
-    "tirmidhi",
-    "dawud",
-    "islam",
-    "quran",
-    "cli"
-  ],
-  "author": "",
-  "license": "MIT",
-  "engines": {
-    "node": ">=16.0.0"
-  }
-}
+{
+  "name": "sunnah",
+  "version": "1.5.0",
+  "description": "Interactive CLI installer and manager for all Sunnah hadith npm + PyPI packages",
+  "type": "module",
+  "bin": {
+    "sunnah": "./bin/index.js"
+  },
+  "scripts": {
+    "test": "node bin/index.js --list"
+  },
+  "keywords": [
+    "sunnah",
+    "hadith",
+    "bukhari",
+    "muslim",
+    "tirmidhi",
+    "dawud",
+    "nasai",
+    "majah",
+    "islam",
+    "quran",
+    "cli",
+    "package-manager"
+  ],
+  "author": "muhammadsaadamin",
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SENODROOM/sunnah.git"
+  },
+  "bugs": {
+    "url": "https://github.com/SENODROOM/sunnah/issues"
+  },
+  "homepage": "https://github.com/SENODROOM/sunnah#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}