wideholy 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WideHoly
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,315 @@
+# wideholy
+
+[![npm](https://img.shields.io/npm/v/wideholy)](https://www.npmjs.com/package/wideholy)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Zero Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](https://www.npmjs.com/package/wideholy)
+
+TypeScript SDK for **WideHoly** — cross-religion scripture search, verse comparison, verse of the day, religious calendar, and commentary across 5 world religions. Access 236,866 scripture records spanning Christianity (124K verses), Islam (31K ayahs), Judaism (69K verses), Hinduism (6,800 verses), and Buddhism (5,326 texts) through a unified, zero-dependency API client.
+
+Built on the [WideHoly](https://wideholy.com) platform, which aggregates scripture data from 5 religion-specific sites — [WideBible](https://widebible.com), [WideQuran](https://widequran.com), [WideTorah](https://widetorah.com), [WideGita](https://widegita.com), and [WideSutra](https://widesutra.com) — into a single cross-religion hub with comparison tools, shared topics, and a unified religious calendar.
+
+> **Explore the interactive tools at [wideholy.com](https://wideholy.com)** — [Compare Verses](https://wideholy.com/compare/), [Religious Calendar](https://wideholy.com/calendar/), [Cross-Religion Topics](https://wideholy.com/topics/)
+
+## Table of Contents
+
+- [Install](#install)
+- [Quick Start](#quick-start)
+- [What You'll Find on WideHoly](#what-youll-find-on-wideholy)
+  - [Five World Scriptures](#five-world-scriptures)
+  - [Cross-Religion Comparison](#cross-religion-comparison)
+  - [Religious Calendar](#religious-calendar)
+- [API Reference](#api-reference)
+- [TypeScript Types](#typescript-types)
+- [Learn More About World Scriptures](#learn-more-about-world-scriptures)
+- [Also Available for Python](#also-available-for-python)
+- [WideHoly Family](#wideholy-family)
+- [License](#license)
+
+## Install
+
+```bash
+npm install wideholy
+```
+
+```bash
+yarn add wideholy
+```
+
+```bash
+pnpm add wideholy
+```
+
+Zero runtime dependencies. Uses native `fetch` (Node 18+, Deno, Bun, browsers).
+
+Works in any JavaScript runtime with global `fetch`:
+
+| Runtime | Version |
+|---------|---------|
+| Node.js | 18+ |
+| Deno | 1.0+ |
+| Bun | 1.0+ |
+| Browsers | All modern (Chrome, Firefox, Safari, Edge) |
+
+## Quick Start
+
+```typescript
+import { WideHoly } from "wideholy";
+
+const api = new WideHoly();
+
+// Get today's verse of the day from the Bible
+const votd = await api.verseOfTheDay("bible");
+console.log(votd.reference); // e.g. "Psalm 23:1"
+console.log(votd.text);      // "The LORD is my shepherd; I shall not want."
+
+// Compare Genesis 1:1 with Quran Al-Fatihah 1
+const result = await api.compare("bible:genesis.1.1", "quran:al-fatihah.1");
+console.log(result.verse_a.text); // "In the beginning God created..."
+console.log(result.verse_b.text); // "In the name of Allah..."
+
+// Search across all religions
+const suggestions = await api.searchSuggest("love");
+for (const s of suggestions.suggestions) {
+  console.log(`  ${s.religion}: ${s.text} (${s.type})`);
+}
+```
+
+## What You'll Find on WideHoly
+
+### Five World Scriptures
+
+WideHoly aggregates scripture data from 5 major world religions, each with its own dedicated site for deep exploration. The hub API provides unified cross-religion access to all 236,866 records.
+
+| Religion | Scripture | Books | Records | Translations | Native Script |
+|----------|-----------|-------|---------|-------------|---------------|
+| Christianity | Holy Bible | 66 books (OT + NT) | 124,425 verses | KJV, NIV, ESV, NASB, NLT, ASV | English (Greek/Hebrew source) |
+| Islam | Holy Quran | 114 surahs | 31,102 ayahs | Sahih International, Pickthall, Yusuf Ali | Arabic |
+| Judaism | Tanakh + Talmud | 24 books + 63 tractates | 69,213 verses + 2,121 dapim | JPS, Koren, Artscroll | Hebrew / Aramaic |
+| Hinduism | Bhagavad Gita | 18 chapters | 6,800 verses | Swami Mukundananda, Eknath Easwaran | Sanskrit / Devanagari |
+| Buddhism | Tripitaka + Mahayana | 5 collections | 5,326 texts | Thanissaro Bhikkhu, Bhikkhu Bodhi | Pali / Sanskrit |
+
+Each religion's data includes structured metadata: book/surah/chapter hierarchy, verse references, multiple translation editions, original language text, and cross-referenced topics for thematic exploration.
+
+```typescript
+import { WideHoly } from "wideholy";
+
+const api = new WideHoly();
+
+// Get a random verse from any religion
+const verse = await api.randomVerse();
+console.log(`[${verse.religion}] ${verse.reference}: ${verse.text}`);
+
+// Get today's Quran verse of the day
+const quranVotd = await api.verseOfTheDay("quran");
+console.log(quranVotd.text); // Today's selected ayah in English
+```
+
+The 5 religions use different verse reference formats. WideHoly normalizes all references to a `religion:book.chapter.verse` pattern for unified access:
+
+| Religion | Reference Format | Example |
+|----------|-----------------|---------|
+| Bible | `bible:book.chapter.verse` | `bible:genesis.1.1` |
+| Quran | `quran:surah.ayah` | `quran:al-fatihah.1` |
+| Torah | `torah:book.chapter.verse` | `torah:genesis.1.1` |
+| Gita | `gita:chapter.verse` | `gita:2.47` |
+| Sutra | `sutra:collection.text` | `sutra:dhammapada.1` |
+
+Learn more: [WideBible](https://widebible.com) · [WideQuran](https://widequran.com) · [WideTorah](https://widetorah.com) · [WideGita](https://widegita.com) · [WideSutra](https://widesutra.com)
+
+### Cross-Religion Comparison
+
+WideHoly provides 10 universal spiritual themes for cross-religion comparison, showing how different traditions address the same fundamental questions of human existence. Each theme includes curated verses and scholarly summaries from all 5 religions.
+
+| Topic | Description | Religions |
+|-------|-------------|-----------|
+| Creation | Origin of the universe and humanity | Bible, Quran, Torah, Gita, Sutra |
+| Prayer | Communication with the divine | Bible, Quran, Torah, Gita, Sutra |
+| Love | Divine and human love | Bible, Quran, Torah, Gita, Sutra |
+| Afterlife | Death, judgment, and eternal life | Bible, Quran, Torah, Gita, Sutra |
+| Compassion | Mercy, kindness, and empathy | Bible, Quran, Torah, Gita, Sutra |
+| Fasting | Spiritual discipline and abstinence | Bible, Quran, Torah, Gita, Sutra |
+| Forgiveness | Repentance and divine pardon | Bible, Quran, Torah, Gita, Sutra |
+| Gratitude | Thankfulness and praise | Bible, Quran, Torah, Gita, Sutra |
+| Justice | Righteousness and moral law | Bible, Quran, Torah, Gita, Sutra |
+| Wisdom | Knowledge, understanding, and truth | Bible, Quran, Torah, Gita, Sutra |
+
+```typescript
+import { WideHoly } from "wideholy";
+
+const api = new WideHoly();
+
+// Compare how religions discuss creation
+const creation = await api.crossReligion("creation");
+console.log(creation.title);   // "Creation"
+console.log(creation.summary); // Scholarly overview
+for (const entry of creation.religions) {
+  console.log(`${entry.religion}: ${entry.summary}`);
+  console.log(`  Key verse: [${entry.key_verse.reference}] ${entry.key_verse.text}`);
+}
+
+// Compare specific verses side by side — Genesis vs Al-Fatihah
+const result = await api.compare("bible:genesis.1.1", "quran:al-fatihah.1");
+console.log(`Bible:  ${result.verse_a.text}`);
+console.log(`Quran:  ${result.verse_b.text}`);
+console.log(`Cross-religion: ${!result.same_religion}`); // true
+```
+
+Learn more: [Compare Verses](https://wideholy.com/compare/) · [Cross-Religion Topics](https://wideholy.com/topics/)
+
+### Religious Calendar
+
+WideHoly tracks 50 major religious events across all 5 traditions for 2026, including holidays, fasts, festivals, and observances. Events are sourced from each religion's liturgical calendar.
+
+| Religion | Events | Examples |
+|----------|--------|---------|
+| Christianity | Easter, Christmas, Lent, Pentecost, Advent | Easter: April 5, 2026 |
+| Islam | Ramadan, Eid al-Fitr, Eid al-Adha, Mawlid | Ramadan begins: February 18, 2026 |
+| Judaism | Passover, Rosh Hashanah, Yom Kippur, Sukkot | Passover: April 2-9, 2026 |
+| Hinduism | Diwali, Holi, Navratri, Maha Shivaratri | Diwali: October 20, 2026 |
+| Buddhism | Vesak, Asalha Puja, Kathina, Magha Puja | Vesak: May 12, 2026 |
+
+```typescript
+import { WideHoly } from "wideholy";
+
+const api = new WideHoly();
+
+// Get all religious events for March 2026
+const events = await api.calendar({ month: 3 });
+for (const e of events.events) {
+  console.log(`  ${e.date}  ${e.religion.padEnd(10)}  ${e.name}`);
+}
+
+// Get only Jewish holidays for 2026
+const torahEvents = await api.calendar({ religion: "torah" });
+for (const e of torahEvents.events) {
+  console.log(`  ${e.date}  ${e.name}`);
+}
+
+// Get Islamic events in December
+const islamDec = await api.calendar({ religion: "quran", month: 12 });
+```
+
+Learn more: [Religious Calendar](https://wideholy.com/calendar/)
+
+## Features
+
+- **Zero dependencies** -- uses native `fetch`, no axios/node-fetch/undici
+- **Fully typed** -- all 8 endpoints return typed response interfaces
+- **Cross-religion** -- unified API across Bible, Quran, Torah, Gita, and Sutra
+- **Tree-shakeable** -- ESM-only output, import only what you need
+- **Configurable** -- custom base URL for local development or self-hosted instances
+- **Lightweight** -- under 4 KB bundled, no bloat
+
+## API Reference
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `verseOfTheDay(religion?)` | `GET /api/v1/verse-of-the-day/` | Curated verse of the day, deterministic per date |
+| `randomVerse(religion?)` | `GET /api/v1/random/` | Random verse, optionally filtered by religion |
+| `compare(refA, refB)` | `GET /api/v1/compare/` | Side-by-side verse comparison |
+| `searchSuggest(query, religion?)` | `GET /api/v1/search/suggest/` | Autocomplete across topics, people, glossary |
+| `topicVerses(topic)` | `GET /api/v1/topics/{slug}/verses/` | Verses for a topic across religions |
+| `crossReligion(topic)` | `GET /api/v1/cross-religion/{topic}/` | Thematic comparison with summaries |
+| `calendar(options?)` | `GET /api/v1/calendar/` | Religious holidays and observances |
+| `commentary(verseRef)` | `GET /api/v1/commentary/{verseRef}/` | Scholarly commentary (tafsir, Rashi, Gita) |
+
+### Example: Commentary
+
+```typescript
+import { WideHoly } from "wideholy";
+
+const api = new WideHoly();
+
+// Get Quran tafsir for Al-Fatihah verse 1
+const comm = await api.commentary("quran:al-fatihah.1");
+console.log(comm.religion); // "quran"
+for (const c of comm.commentaries) {
+  console.log(`[${c.source}] ${c.author}: ${c.text.slice(0, 100)}...`);
+}
+
+// Get Torah Rashi commentary for Genesis 1:1
+const rashi = await api.commentary("torah:genesis.1.1");
+for (const c of rashi.commentaries) {
+  console.log(`${c.author}: ${c.text}`);
+}
+```
+
+### Custom Base URL
+
+```typescript
+// Use a local development server
+const dev = new WideHoly("http://localhost:8000");
+
+// Use a self-hosted instance
+const selfHosted = new WideHoly("https://scripture.internal.company.com");
+```
+
+Full API documentation at [wideholy.com/developers/](https://wideholy.com/developers/).
+OpenAPI 3.1.0 spec: [wideholy.com/api/schema/](https://wideholy.com/api/schema/).
+
+## TypeScript Types
+
+All API responses are fully typed. Import individual types as needed:
+
+```typescript
+import type {
+  VerseOfTheDay,
+  RandomVerse,
+  CompareResult,
+  Suggestions,
+  TopicVerses,
+  CrossReligionResult,
+  CalendarEvents,
+  CalendarOptions,
+  Commentary,
+  Verse,
+  CalendarEvent,
+  CommentaryEntry,
+} from "wideholy";
+```
+
+### Key Types
+
+| Type | Description |
+|------|-------------|
+| `VerseOfTheDay` | Daily verse with religion, reference, text, translation, date |
+| `RandomVerse` | Random verse with full metadata |
+| `CompareResult` | Two verses side-by-side with `same_religion` flag |
+| `Suggestions` | Search autocomplete with query and suggestion list |
+| `TopicVerses` | Per-religion verse collections for a topic |
+| `CrossReligionResult` | Thematic comparison with summaries per religion |
+| `CalendarEvents` | Religious events filtered by year, month, religion |
+| `Commentary` | Scholarly annotations (tafsir, Rashi, Gita commentaries) |
+| `Verse` | Base verse type: religion, reference, text, book, chapter, verse |
+| `CalendarOptions` | Query options: `{ religion?, year?, month? }` |
+
+## Learn More About World Scriptures
+
+- **Compare**: [Verse Comparison Tool](https://wideholy.com/compare/) · [Cross-Religion Topics](https://wideholy.com/topics/)
+- **Calendar**: [Religious Calendar 2026](https://wideholy.com/calendar/)
+- **Browse**: [Bible Books](https://widebible.com) · [Quran Surahs](https://widequran.com) · [Torah Books](https://widetorah.com) · [Gita Chapters](https://widegita.com) · [Buddhist Sutras](https://widesutra.com)
+- **API**: [REST API Docs](https://wideholy.com/developers/) · [OpenAPI Spec](https://wideholy.com/api/schema/)
+- **Python**: [PyPI Package](https://pypi.org/project/wideholy/)
+
+## Also Available for Python
+
+| Platform | Install | Link |
+|----------|---------|------|
+| **PyPI** | `pip install wideholy` | [PyPI](https://pypi.org/project/wideholy/) |
+| **MCP** | `uvx --from "wideholy[mcp]" python -m wideholy.mcp_server` | [Config](#) |
+
+## WideHoly Family
+
+| Site | Domain | Focus |
+|------|--------|-------|
+| WideBible | [widebible.com](https://widebible.com) | 66 books, 124K verses, 6 translations, commentaries |
+| WideQuran | [widequran.com](https://widequran.com) | 114 surahs, 31K ayahs, tafsir, hadith collections |
+| WideTorah | [widetorah.com](https://widetorah.com) | 24 Tanakh books, 63 Talmud tractates, Rashi commentary |
+| WideGita | [widegita.com](https://widegita.com) | 18 chapters, 6,800 verses, Sanskrit, multiple commentaries |
+| WideSutra | [widesutra.com](https://widesutra.com) | 5 collections, 5,326 texts, Pali/Sanskrit traditions |
+| **WideHoly** | [**wideholy.com**](https://wideholy.com) | **Cross-religion hub -- comparison, calendar, unified search** |
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.

package/dist/index.d.ts

@@ -0,0 +1,201 @@
+/**
+ * TypeScript interfaces for WideHoly API responses.
+ *
+ * All types mirror the wideholy.com REST API JSON structure.
+ * See https://wideholy.com/api/schema/ for the OpenAPI 3.1.0 spec.
+ */
+/** A scripture verse from any of the 5 world religions. */
+interface Verse {
+    religion: string;
+    reference: string;
+    text: string;
+    translation: string;
+    book: string;
+    chapter: number;
+    verse: number;
+}
+/** Verse of the day response. */
+interface VerseOfTheDay {
+    religion: string;
+    reference: string;
+    text: string;
+    translation: string;
+    book: string;
+    chapter: number;
+    verse: number;
+    date: string;
+}
+/** Random verse response. */
+interface RandomVerse {
+    religion: string;
+    reference: string;
+    text: string;
+    translation: string;
+    book: string;
+    chapter: number;
+    verse: number;
+}
+/** Side-by-side verse comparison result. */
+interface CompareResult {
+    verse_a: Verse;
+    verse_b: Verse;
+    same_religion: boolean;
+}
+/** A single search suggestion. */
+interface Suggestion {
+    text: string;
+    type: string;
+    religion: string;
+    url: string;
+}
+/** Search suggestions response. */
+interface Suggestions {
+    query: string;
+    suggestions: Suggestion[];
+}
+/** Per-religion data within a topic. */
+interface TopicReligionData {
+    religion: string;
+    verses: Verse[];
+    verse_count: number;
+}
+/** Topic verses response. */
+interface TopicVerses {
+    topic: string;
+    religions_found: number;
+    verses: TopicReligionData[];
+}
+/** Per-religion summary for cross-religion comparison. */
+interface CrossReligionEntry {
+    religion: string;
+    summary: string;
+    key_verse: Verse;
+}
+/** Cross-religion topic comparison result. */
+interface CrossReligionResult {
+    topic: string;
+    title: string;
+    summary: string;
+    religions: CrossReligionEntry[];
+}
+/** A religious calendar event. */
+interface CalendarEvent {
+    name: string;
+    date: string;
+    religion: string;
+    description: string;
+}
+/** Calendar response. */
+interface CalendarEvents {
+    year: number;
+    month: number | null;
+    religion: string | null;
+    events: CalendarEvent[];
+}
+/** A commentary entry for a verse. */
+interface CommentaryEntry {
+    source: string;
+    author: string;
+    text: string;
+}
+/** Commentary response. */
+interface Commentary {
+    verse_ref: string;
+    religion: string;
+    commentaries: CommentaryEntry[];
+}
+/** Calendar query options. */
+interface CalendarOptions {
+    religion?: string;
+    year?: number;
+    month?: number;
+}
+
+/**
+ * WideHoly API client — TypeScript wrapper for wideholy.com REST API.
+ *
+ * Zero dependencies. Uses native `fetch`.
+ *
+ * @example
+ * ```ts
+ * import { WideHoly } from "wideholy";
+ *
+ * const api = new WideHoly();
+ * const votd = await api.verseOfTheDay("bible");
+ * console.log(votd.reference); // Genesis 1:1
+ *
+ * const result = await api.compare("bible:genesis.1.1", "quran:al-fatihah.1");
+ * console.log(result.verse_a.text);
+ * ```
+ */
+
+declare class WideHoly {
+    private baseUrl;
+    /**
+     * Create a new WideHoly API client.
+     *
+     * @param baseUrl - API base URL. Defaults to `https://wideholy.com`.
+     */
+    constructor(baseUrl?: string);
+    private get;
+    /**
+     * Get the verse of the day for a religion.
+     *
+     * Returns a curated verse, deterministic per religion per date.
+     *
+     * @param religion - Religion key (bible, quran, torah, gita, sutra).
+     */
+    verseOfTheDay(religion?: string): Promise<VerseOfTheDay>;
+    /**
+     * Get a random verse, optionally filtered by religion.
+     *
+     * @param religion - Religion key. If omitted, picks a random religion.
+     */
+    randomVerse(religion?: string): Promise<RandomVerse>;
+    /**
+     * Compare two verses side-by-side (same or cross-religion).
+     *
+     * Use `religion:ref` format for cross-religion comparison.
+     *
+     * @param refA - First verse reference (e.g. `"bible:genesis.1.1"`).
+     * @param refB - Second verse reference (e.g. `"quran:al-fatihah.1"`).
+     */
+    compare(refA: string, refB: string): Promise<CompareResult>;
+    /**
+     * Autocomplete suggestions across religions.
+     *
+     * Returns topic, person, and glossary term suggestions matching the query.
+     *
+     * @param query - Search query prefix (minimum 2 characters).
+     * @param religion - Filter to a specific religion.
+     */
+    searchSuggest(query: string, religion?: string): Promise<Suggestions>;
+    /**
+     * Get verses for a topic across all religions.
+     *
+     * @param topic - Topic slug (e.g. `"love"`, `"creation"`, `"prayer"`).
+     */
+    topicVerses(topic: string): Promise<TopicVerses>;
+    /**
+     * Get cross-religion comparison for a universal spiritual theme.
+     *
+     * @param topic - Topic key (e.g. `"creation"`, `"prayer"`, `"love"`).
+     */
+    crossReligion(topic: string): Promise<CrossReligionResult>;
+    /**
+     * Get religious calendar events.
+     *
+     * @param options - Optional filters: religion, year, month.
+     */
+    calendar(options?: CalendarOptions): Promise<CalendarEvents>;
+    /**
+     * Get commentary for a verse.
+     *
+     * Supports Quran (tafsir), Torah (Rashi), and Gita commentaries.
+     *
+     * @param verseRef - Verse reference (e.g. `"quran:al-fatihah.1"`).
+     */
+    commentary(verseRef: string): Promise<Commentary>;
+}
+
+export { type CalendarEvent, type CalendarEvents, type CalendarOptions, type Commentary, type CommentaryEntry, type CompareResult, type CrossReligionEntry, type CrossReligionResult, type RandomVerse, type Suggestion, type Suggestions, type TopicReligionData, type TopicVerses, type Verse, type VerseOfTheDay, WideHoly };

package/dist/index.js

@@ -0,0 +1,125 @@
+// src/client.ts
+var WideHoly = class {
+  baseUrl;
+  /**
+   * Create a new WideHoly API client.
+   *
+   * @param baseUrl - API base URL. Defaults to `https://wideholy.com`.
+   */
+  constructor(baseUrl = "https://wideholy.com") {
+    this.baseUrl = baseUrl.replace(/\/+$/, "");
+  }
+  async get(path, params) {
+    const url = new URL(`/api/v1/${path}`, this.baseUrl);
+    if (params) {
+      Object.entries(params).forEach(([k, v]) => {
+        if (v !== void 0 && v !== null) {
+          url.searchParams.set(k, v);
+        }
+      });
+    }
+    const res = await fetch(url.toString());
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    return res.json();
+  }
+  // -- 1. Verse of the Day --------------------------------------------------
+  /**
+   * Get the verse of the day for a religion.
+   *
+   * Returns a curated verse, deterministic per religion per date.
+   *
+   * @param religion - Religion key (bible, quran, torah, gita, sutra).
+   */
+  async verseOfTheDay(religion) {
+    return this.get(
+      "verse-of-the-day/",
+      religion ? { religion } : void 0
+    );
+  }
+  // -- 2. Random Verse ------------------------------------------------------
+  /**
+   * Get a random verse, optionally filtered by religion.
+   *
+   * @param religion - Religion key. If omitted, picks a random religion.
+   */
+  async randomVerse(religion) {
+    return this.get(
+      "random/",
+      religion ? { religion } : void 0
+    );
+  }
+  // -- 3. Compare Verses ----------------------------------------------------
+  /**
+   * Compare two verses side-by-side (same or cross-religion).
+   *
+   * Use `religion:ref` format for cross-religion comparison.
+   *
+   * @param refA - First verse reference (e.g. `"bible:genesis.1.1"`).
+   * @param refB - Second verse reference (e.g. `"quran:al-fatihah.1"`).
+   */
+  async compare(refA, refB) {
+    return this.get("compare/", { a: refA, b: refB });
+  }
+  // -- 4. Search Suggest ----------------------------------------------------
+  /**
+   * Autocomplete suggestions across religions.
+   *
+   * Returns topic, person, and glossary term suggestions matching the query.
+   *
+   * @param query - Search query prefix (minimum 2 characters).
+   * @param religion - Filter to a specific religion.
+   */
+  async searchSuggest(query, religion) {
+    const params = { q: query };
+    if (religion) params.religion = religion;
+    return this.get("search/suggest/", params);
+  }
+  // -- 5. Topic Verses ------------------------------------------------------
+  /**
+   * Get verses for a topic across all religions.
+   *
+   * @param topic - Topic slug (e.g. `"love"`, `"creation"`, `"prayer"`).
+   */
+  async topicVerses(topic) {
+    return this.get(`topics/${topic}/verses/`);
+  }
+  // -- 6. Cross-Religion Topic ----------------------------------------------
+  /**
+   * Get cross-religion comparison for a universal spiritual theme.
+   *
+   * @param topic - Topic key (e.g. `"creation"`, `"prayer"`, `"love"`).
+   */
+  async crossReligion(topic) {
+    return this.get(`cross-religion/${topic}/`);
+  }
+  // -- 7. Religious Calendar ------------------------------------------------
+  /**
+   * Get religious calendar events.
+   *
+   * @param options - Optional filters: religion, year, month.
+   */
+  async calendar(options) {
+    const params = {};
+    if (options?.religion) params.religion = options.religion;
+    if (options?.year) params.year = String(options.year);
+    if (options?.month) params.month = String(options.month);
+    return this.get(
+      "calendar/",
+      Object.keys(params).length > 0 ? params : void 0
+    );
+  }
+  // -- 8. Commentary --------------------------------------------------------
+  /**
+   * Get commentary for a verse.
+   *
+   * Supports Quran (tafsir), Torah (Rashi), and Gita commentaries.
+   *
+   * @param verseRef - Verse reference (e.g. `"quran:al-fatihah.1"`).
+   */
+  async commentary(verseRef) {
+    return this.get(`commentary/${verseRef}/`);
+  }
+};
+export {
+  WideHoly
+};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "wideholy",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for WideHoly -- cross-religion scripture search, verse comparison, verse of the day, religious calendar, and commentary across 5 world religions",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "bible",
+    "quran",
+    "torah",
+    "gita",
+    "sutra",
+    "scripture",
+    "religion",
+    "verse",
+    "cross-religion",
+    "comparison",
+    "commentary",
+    "calendar",
+    "verse-of-the-day",
+    "interfaith",
+    "typescript"
+  ],
+  "author": "WideHoly",
+  "license": "MIT",
+  "homepage": "https://wideholy.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dobestan/wideholy-js"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "tsup": "^8.0",
+    "typescript": "^5.7",
+    "vitest": "^2.0"
+  }
+}