sunnah 1.4.0 → 1.5.0

package/books/sahih-al-bukhari/bin/index.js

@@ -0,0 +1,306 @@
+#!/usr/bin/env node
+// CLI for sahih-al-bukhari
+// Usage:
+//   bukhari <hadithId> [-a|-b]
+//   bukhari <chapterId> <hadithId> [-a|-b]
+//   bukhari --search "prayer" [--all]
+//   bukhari --random
+//   bukhari --chapter <id>
+//   bukhari --react
+//   bukhari -h | --help
+//   bukhari -v | --version
+
+import fs   from 'fs';
+import zlib from 'zlib';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { Bukhari } 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'));
+
+// ── Load shared data/bukhari.json.gz (or .json fallback) ─────────────────────
+function loadData() {
+  const gzPath   = path.join(__dirname, '..', 'data', 'bukhari.json.gz');
+  const jsonPath = path.join(__dirname, '..', 'data', 'bukhari.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/bukhari.json.gz or data/bukhari.json');
+}
+
+const bukhariData = loadData();
+
+// ── Speed: build lookup maps at startup ───────────────────────────────────────
+const _byId      = new Map();
+const _byChapter = new Map();
+bukhariData.hadiths.forEach(h => {
+  _byId.set(h.id, h);
+  if (!_byChapter.has(h.chapterId)) _byChapter.set(h.chapterId, []);
+  _byChapter.get(h.chapterId).push(h);
+});
+
+const bukhari = new Bukhari(bukhariData);
+
+export default bukhari;
+export { Bukhari };
+
+// ── Colors ────────────────────────────────────────────────────────────────────
+const c = {
+  reset: '\x1b[0m', bold: '\x1b[1m', dim: '\x1b[2m',
+  green: '\x1b[32m', yellow: '\x1b[33m', cyan: '\x1b[36m',
+  white: '\x1b[37m', magenta: '\x1b[35m', blue: '\x1b[34m',
+  red: '\x1b[31m', gray: '\x1b[90m',
+};
+const clr     = (color, text) => `${color}${text}${c.reset}`;
+const bold    = (t) => clr(c.bold,    t);
+const green   = (t) => clr(c.green,   t);
+const yellow  = (t) => clr(c.yellow,  t);
+const cyan    = (t) => clr(c.cyan,    t);
+const magenta = (t) => clr(c.magenta, t);
+const gray    = (t) => clr(c.gray,    t);
+const red     = (t) => clr(c.red,     t);
+const blue    = (t) => clr(c.blue,    t);
+const 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(' ');
+  const 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 === 'bukhari';
+}
+
+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));
+const DIV2 = gray('═'.repeat(60));
+
+if (wantsVersion) {
+  console.log('');
+  console.log('  ' + bold(cyan('sahih-al-bukhari')) + gray(' v' + pkg.version));
+  console.log('  ' + gray('Total hadiths : ') + yellow(bukhariData.hadiths.length.toLocaleString()));
+  console.log('  ' + gray('Total chapters: ') + yellow(bukhariData.chapters.length.toLocaleString()));
+  console.log('  ' + gray('Author        : ') + cyan('Imam Muhammad ibn Ismail al-Bukhari'));
+  console.log('');
+  process.exit(0);
+}
+
+if (wantsRandom) {
+  const hadith = bukhariData.hadiths[Math.floor(Math.random() * bukhariData.hadiths.length)];
+  printHadith(hadith);
+  process.exit(0);
+}
+
+if (chapterArg !== null) {
+  const hadiths = _byChapter.get(chapterArg) || [];
+  const chapter = bukhariData.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();
+  const ql      = searchQuery.toLowerCase();
+  const results = bukhariData.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 = bukhariData.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('\n  ' + gray('Showing ') + cyan('5') + gray(' of ') + yellow(results.length) +
+      gray(' results.  ') + bold(blue('Run with --all to see all results')));
+    console.log('  ' + dim('bukhari --search "' + searchQuery + '" --all') + '\n');
+  }
+  process.exit(0);
+}
+
+if (wantsReact) {
+  const cwd      = process.cwd();
+  const srcDir   = path.join(cwd, 'src');
+  const hooksDir = path.join(srcDir, 'hooks');
+  const pkgPath  = path.join(cwd, 'package.json');
+  if (!fs.existsSync(pkgPath)) {
+    console.error(red('  ✗ No package.json found. Run inside your React project directory.'));
+    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. Run inside a React project.'));
+    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-al-bukhari@' + pkg.version + '/data/bukhari.json.gz';
+  const hookFile = path.join(hooksDir, 'useBukhari.js');
+  const hookSrc  = `// Auto-generated by: bukhari --react\nimport { useState, useEffect } from 'react';\nconst CDN = '${CDN}';\nlet _cache = null; let _promise = null; const _subs = new Set();\nfunction _load() {\n  if (_cache) return Promise.resolve(_cache);\n  if (_promise) return _promise;\n  _promise = fetch(CDN).then(r => r.arrayBuffer()).then(buf => {\n    const stream = new DecompressionStream('gzip');\n    const writer = stream.writable.getWriter();\n    const reader = stream.readable.getReader();\n    writer.write(new Uint8Array(buf)); writer.close();\n    const chunks = [];\n    return (function pump() {\n      return reader.read().then(({ done, value }) => {\n        if (done) {\n          const json = new TextDecoder().decode(new Uint8Array(chunks.reduce((a,b)=>[...a,...b],[])));\n          const data = JSON.parse(json);\n          const hadiths = data.hadiths;\n          const _byId = new Map(); hadiths.forEach(h => _byId.set(h.id, h));\n          _cache = Object.assign([], hadiths, {\n            metadata: data.metadata, chapters: data.chapters,\n            get: id => _byId.get(id),\n            getByChapter: id => hadiths.filter(h => h.chapterId === id),\n            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; },\n            getRandom: () => hadiths[Math.floor(Math.random()*hadiths.length)],\n          });\n          _subs.forEach(fn=>fn(_cache)); _subs.clear(); return _cache;\n        }\n        chunks.push(value); return pump();\n      });\n    })();\n  });\n  return _promise;\n}\n_load();\nexport function useBukhari() {\n  const [bukhari, setBukhari] = useState(_cache);\n  useEffect(() => { if (_cache) { setBukhari(_cache); } else { _subs.add(setBukhari); return () => _subs.delete(setBukhari); } }, []);\n  return bukhari;\n}\nexport default useBukhari;\n`;
+  fs.writeFileSync(hookFile, hookSrc, 'utf8');
+  console.log('\n  ' + green('✓') + bold(' Generated: ') + cyan('src/hooks/useBukhari.js') + '\n');
+  process.exit(0);
+}
+
+if (wantsHelp || (numArgs.length === 0 && !searchQuery && chapterArg === null && !wantsRandom)) {
+  console.log('');
+  console.log('  ' + bold(cyan('Sahih al-Bukhari CLI')) + gray('  v' + pkg.version));
+  console.log('');
+  console.log('  ' + bold('Usage:'));
+  console.log('    ' + cyan('bukhari') + yellow(' <hadithId>')                      + gray('                   Show hadith by global ID'));
+  console.log('    ' + cyan('bukhari') + yellow(' <chapterId> <hadithId>')          + gray('       Show hadith within a chapter'));
+  console.log('    ' + cyan('bukhari') + green(' --search') + yellow(' "<query>"') + gray('            Search hadiths (top 5)'));
+  console.log('    ' + cyan('bukhari') + green(' --search') + yellow(' "<query>"') + green(' --all') + gray('    Show all results'));
+  console.log('    ' + cyan('bukhari') + green(' --chapter') + yellow(' <id>')      + gray('              List all hadiths in a chapter'));
+  console.log('    ' + cyan('bukhari') + 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 useBukhari 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 = bukhariData.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]);
+    const 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('bukhari --help') + ' for usage.\n');
+    process.exit(1);
+  }
+  printHadith(hadith);
+}
+
+}

package/books/sahih-al-bukhari/examples/express/server.js

@@ -0,0 +1,49 @@
+// Express.js REST API example
+// Run: node examples/express/server.js
+import express from 'express';
+import bukhari from 'sahih-al-bukhari';
+
+const app  = express();
+const PORT = process.env.PORT || 3000;
+
+// GET /api/hadith/random
+app.get('/api/hadith/random', (_, res) => {
+  res.json(bukhari.getRandom());
+});
+
+// GET /api/hadith/:id
+app.get('/api/hadith/:id', (req, res) => {
+  const h = bukhari.get(parseInt(req.params.id));
+  if (!h) return res.status(404).json({ error: 'Hadith not found' });
+  res.json(h);
+});
+
+// GET /api/chapter/:id
+app.get('/api/chapter/:id', (req, res) => {
+  const hadiths = bukhari.getByChapter(parseInt(req.params.id));
+  if (!hadiths.length) return res.status(404).json({ error: 'Chapter not found' });
+  res.json({ count: hadiths.length, hadiths });
+});
+
+// GET /api/search?q=prayer&limit=10
+app.get('/api/search', (req, res) => {
+  const q      = req.query.q || '';
+  const limit  = parseInt(req.query.limit) || 0;
+  const results = bukhari.search(q, limit);
+  res.json({ query: q, count: results.length, results });
+});
+
+// GET /api/chapters
+app.get('/api/chapters', (_, res) => {
+  res.json(bukhari.chapters);
+});
+
+// GET /api/meta
+app.get('/api/meta', (_, res) => {
+  res.json({ ...bukhari.metadata, total: bukhari.length });
+});
+
+app.listen(PORT, () => {
+  console.log(`Sahih al-Bukhari API running at http://localhost:${PORT}`);
+  console.log(`Try: http://localhost:${PORT}/api/hadith/1`);
+});

package/books/sahih-al-bukhari/examples/node-commonjs/example.js

@@ -0,0 +1,21 @@
+// CommonJS example — run with: node examples/node-commonjs/example.js
+'use strict';
+
+const bukhari = require('sahih-al-bukhari');
+
+console.log('Total hadiths:', bukhari.length);
+
+// Get by ID
+const h = bukhari.get(1);
+console.log('\nHadith #1:');
+console.log('Narrator:', h.english.narrator);
+console.log('Text:', h.english.text);
+
+// Search
+const results = bukhari.search('prayer', 3);
+console.log(`\nTop 3 results for "prayer":`);
+results.forEach((r, i) => console.log(`  ${i + 1}. [${r.id}] ${r.english.text.slice(0, 80)}...`));
+
+// Random
+const random = bukhari.getRandom();
+console.log('\nRandom hadith:', random.id, '-', random.english.text.slice(0, 60) + '...');

package/books/sahih-al-bukhari/examples/node-esm/example.mjs

@@ -0,0 +1,24 @@
+// ESM example — run with: node examples/node-esm/example.mjs
+import bukhari from 'sahih-al-bukhari';
+
+console.log('Total hadiths:', bukhari.length);
+console.log('Total chapters:', bukhari.chapters.length);
+console.log('Title:', bukhari.metadata.english.title);
+
+// Get by ID
+const h = bukhari.get(23);
+console.log('\nHadith #23:');
+console.log('Narrator:', h.english.narrator);
+console.log('Text:', h.english.text);
+
+// Get by chapter
+const chapter1 = bukhari.getByChapter(1);
+console.log(`\nChapter 1 has ${chapter1.length} hadiths`);
+
+// Search
+const results = bukhari.search('fasting');
+console.log(`\n"fasting" → ${results.length} results`);
+
+// Native array methods
+const narrators = bukhari.slice(0, 5).map(h => h.english.narrator);
+console.log('\nFirst 5 narrators:', narrators);

package/books/sahih-al-bukhari/examples/react/HadithExample.jsx

@@ -0,0 +1,73 @@
+// React example — run `bukhari --react` inside your React project first
+// to generate src/hooks/useBukhari.js, then use like this:
+import { useState } from 'react';
+import { useBukhari } from '../hooks/useBukhari';
+
+// ── Hadith of the Day ─────────────────────────────────────────────────────────
+export function HadithOfTheDay() {
+  const bukhari = useBukhari();
+  if (!bukhari) return <p>Loading...</p>;
+
+  const h = bukhari.getRandom();
+  return (
+    <div className="hadith-card">
+      <p className="narrator"><strong>{h.english.narrator}</strong></p>
+      <p className="text">{h.english.text}</p>
+      <small>Hadith #{h.id} · Chapter {h.chapterId}</small>
+    </div>
+  );
+}
+
+// ── Search ────────────────────────────────────────────────────────────────────
+export function HadithSearch() {
+  const bukhari  = useBukhari();
+  const [query, setQuery]     = useState('');
+  const [results, setResults] = useState([]);
+
+  if (!bukhari) return <p>Loading hadiths...</p>;
+
+  const handleSearch = (e) => {
+    const q = e.target.value;
+    setQuery(q);
+    setResults(q.length > 1 ? bukhari.search(q, 20) : []);
+  };
+
+  return (
+    <div>
+      <input
+        value={query}
+        onChange={handleSearch}
+        placeholder="Search hadiths..."
+      />
+      <p>{results.length} results</p>
+      {results.map(h => (
+        <div key={h.id}>
+          <strong>{h.english.narrator}</strong>
+          <p>{h.english.text}</p>
+        </div>
+      ))}
+    </div>
+  );
+}
+
+// ── By Chapter ────────────────────────────────────────────────────────────────
+export function ChapterView({ chapterId = 1 }) {
+  const bukhari = useBukhari();
+  if (!bukhari) return <p>Loading...</p>;
+
+  const hadiths = bukhari.getByChapter(chapterId);
+  const chapter = bukhari.chapters.find(c => c.id === chapterId);
+
+  return (
+    <div>
+      <h2>{chapter?.english}</h2>
+      <p>{hadiths.length} hadiths</p>
+      {hadiths.map(h => (
+        <div key={h.id}>
+          <strong>#{h.id} — {h.english.narrator}</strong>
+          <p>{h.english.text}</p>
+        </div>
+      ))}
+    </div>
+  );
+}

package/books/sahih-al-bukhari/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "sahih-al-bukhari",
+  "version": "3.1.5",
+  "description": "Complete Sahih al-Bukhari. 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": {
+    "bukhari": "./bin/index.js"
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "prepublishOnly": "node scripts/build.mjs"
+  },
+  "keywords": [
+    "islam",
+    "hadith",
+    "bukhari",
+    "sahih",
+    "prophet",
+    "muslim",
+    "json",
+    "arabic",
+    "english",
+    "quran",
+    "react",
+    "hook"
+  ],
+  "author": "muhammadsaadamin",
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SENODROOM/sahih-al-bukhari.git"
+  },
+  "files": [
+    "src/",
+    "types/",
+    "bin/index.js",
+    "data/bukhari.json.gz"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/books/sahih-al-bukhari/src/index.cjs

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

package/books/sahih-al-bukhari/src/index.js

@@ -0,0 +1,35 @@
+// ESM browser-safe entry (class only — no data)
+// Works in: React, Vue, Vite, webpack, Next.js (client)
+
+export class Bukhari {
+  constructor(bukhariData) {
+    this._hadiths = bukhariData.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 bukhariData.metadata;
+          case 'chapters':     return bukhariData.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)  => this._hadiths.filter(h =>
+            h.english?.text?.toLowerCase().includes(q.toLowerCase()) ||
+            h.english?.narrator?.toLowerCase().includes(q.toLowerCase())
+          );
+          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 Bukhari;

package/books/sahih-al-bukhari/src/index.node.js

@@ -0,0 +1,21 @@
+// Node ESM entry — import bukhari from 'sahih-al-bukhari'
+import fs   from 'fs';
+import zlib from 'zlib';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { Bukhari } from './index.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+function loadData() {
+  const gzPath   = path.join(__dirname, '..', 'data', 'bukhari.json.gz');
+  const jsonPath = path.join(__dirname, '..', 'data', 'bukhari.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/bukhari.json.gz or data/bukhari.json');
+}
+
+const bukhari = new Bukhari(loadData());
+
+export { Bukhari };
+export default bukhari;