free-use-bible-api 0.2.0 → 0.3.0

package/dist/esm/FreeUseBibleApi.js

@@ -32,6 +32,21 @@ export class FreeUseBibleApi {
       false
     );
   }
+  /**
+   * Gets the complete content of a specific Bible translation, using the simplified chapter format.
+   *
+   * The results of this endpoint are very large, so the response is not cached.
+   * @param translation The ID of the translation to get the complete content for.
+   * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+   */
+  async getSimpleCompleteTranslation(translation, endpoint) {
+    const encodedTranslation = encodeURIComponent(translation);
+    return this._getJson(
+      `api/${encodedTranslation}/complete.simple.json`,
+      endpoint,
+      false
+    );
+  }
   /**
    * Gets the list of available Bible commentaries from the API.
    * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
@@ -72,7 +87,7 @@ export class FreeUseBibleApi {
   async getCommentaryBooks(commentary, endpoint) {
     const encodedCommentary = encodeURIComponent(commentary);
     return this._getJson(
-      `api/${encodedCommentary}/books.json`,
+      `api/c/${encodedCommentary}/books.json`,
       endpoint
     );
   }
@@ -104,6 +119,98 @@ export class FreeUseBibleApi {
       endpoint
     );
   }
+  /**
+   * Gets the word-level annotations (Strong's numbers and related source data) for a specific chapter of a specific book for a specific Bible translation.
+   *
+   * Only some translations have word-level annotations. This request will fail for chapters that don't have any.
+   * Use `getChapterWords()` to get the annotations for a chapter that you have already loaded, which returns null instead of failing.
+   * @param translation The ID of the translation to get the annotations for.
+   * @param book The ID of the book to get the annotations for.
+   * @param chapter The chapter number to get the annotations for.
+   * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+   */
+  async getTranslationBookChapterWords(translation, book, chapter, endpoint) {
+    const encodedTranslation = encodeURIComponent(translation);
+    const encodedBook = encodeURIComponent(book);
+    const encodedChapter = encodeURIComponent(String(chapter));
+    return this._getJson(
+      `api/${encodedTranslation}/${encodedBook}/${encodedChapter}.words.json`,
+      endpoint
+    );
+  }
+  /**
+   * Gets the word-level annotations for the given chapter, if it has any.
+   * @param chapter The chapter to get the annotations for.
+   * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+   * @returns The annotations for the chapter, or null if the chapter doesn't have any.
+   */
+  async getChapterWords(chapter, endpoint) {
+    if (!chapter.thisChapterWordsLink) {
+      return null;
+    }
+    return this._getJson(
+      chapter.thisChapterWordsLink,
+      endpoint
+    );
+  }
+  /**
+   * Gets the content of a specific chapter of a specific book for a specific Bible translation, using the simplified chapter format.
+   *
+   * In the simplified format, each verse's content is a single string instead of a list of formatted content, and footnotes, inline headings, the Words of Jesus, and poetry are represented as offset ranges into that string.
+   * @param translation The ID of the translation to get the chapter for.
+   * @param book The ID of the book to get the chapter for.
+   * @param chapter The chapter number to get.
+   * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+   */
+  async getSimpleTranslationBookChapter(translation, book, chapter, endpoint) {
+    const encodedTranslation = encodeURIComponent(translation);
+    const encodedBook = encodeURIComponent(book);
+    const encodedChapter = encodeURIComponent(String(chapter));
+    return this._getJson(
+      `api/${encodedTranslation}/${encodedBook}/${encodedChapter}.simple.json`,
+      endpoint
+    );
+  }
+  /**
+   * Gets the word-level annotations (Strong's numbers and related source data) for a specific chapter of a specific book for a specific Bible translation, with their offsets remapped onto the text of each simplified verse.
+   *
+   * Use this instead of `getTranslationBookChapterWords()` when working with the simplified chapter format, since the offsets in the regular annotations are anchored to a verse's content array instead of its plain text.
+   * Use `getSimpleChapterWords()` to get the annotations for a simplified chapter that you have already loaded, which returns null instead of failing.
+   * @param translation The ID of the translation to get the annotations for.
+   * @param book The ID of the book to get the annotations for.
+   * @param chapter The chapter number to get the annotations for.
+   * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+   */
+  async getSimpleTranslationBookChapterWords(translation, book, chapter, endpoint) {
+    const encodedTranslation = encodeURIComponent(translation);
+    const encodedBook = encodeURIComponent(book);
+    const encodedChapter = encodeURIComponent(String(chapter));
+    return this._getJson(
+      `api/${encodedTranslation}/${encodedBook}/${encodedChapter}.words.simple.json`,
+      endpoint
+    );
+  }
+  async getSimpleChapter(chapter, endpoint) {
+    if (!chapter.simpleChapterApiLink) {
+      return null;
+    }
+    return this._getJson(chapter.simpleChapterApiLink, endpoint);
+  }
+  /**
+   * Gets the word-level annotations for the given simplified chapter, if it has any.
+   * @param chapter The simplified chapter to get the annotations for.
+   * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+   * @returns The annotations for the chapter, or null if the chapter doesn't have any.
+   */
+  async getSimpleChapterWords(chapter, endpoint) {
+    if (!chapter.thisChapterWordsLink) {
+      return null;
+    }
+    return this._getJson(
+      chapter.thisChapterWordsLink,
+      endpoint
+    );
+  }
   /**
    * Gets the content of a specific chapter of a specific book for a specific Bible commentary.
    * @param commentary The ID of the commentary to get the chapter for.
@@ -116,7 +223,23 @@ export class FreeUseBibleApi {
     const encodedBook = encodeURIComponent(book);
     const encodedChapter = encodeURIComponent(String(chapter));
     return this._getJson(
-      `api/${encodedCommentary}/${encodedBook}/${encodedChapter}.json`,
+      `api/c/${encodedCommentary}/${encodedBook}/${encodedChapter}.json`,
+      endpoint
+    );
+  }
+  /**
+   * Gets the content of a specific chapter of a specific book for a specific Bible commentary, using the simplified chapter format.
+   * @param commentary The ID of the commentary to get the chapter for.
+   * @param book The ID of the book to get the chapter for.
+   * @param chapter The chapter number to get.
+   * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+   */
+  async getSimpleCommentaryBookChapter(commentary, book, chapter, endpoint) {
+    const encodedCommentary = encodeURIComponent(commentary);
+    const encodedBook = encodeURIComponent(book);
+    const encodedChapter = encodeURIComponent(String(chapter));
+    return this._getJson(
+      `api/c/${encodedCommentary}/${encodedBook}/${encodedChapter}.simple.json`,
       endpoint
     );
   }
@@ -237,6 +360,86 @@ ${content.trim()}`;
     }
     return content.trim();
   }
+  /**
+   * Gets the verse text for the given simplified chapter.
+   * By default, the returned text includes markers for verse numbers and a reference to the chapter, but these can be omitted by passing options to the `options` parameter.
+   * @param chapter The simplified chapter to get the text for.
+   * @param options Options for getting the chapter text.
+   */
+  getSimpleChapterVerseText(chapter, options = {}) {
+    let content = "";
+    for (let chapterContent of chapter.chapter.content) {
+      if (chapterContent.type === "verse") {
+        if (!options.omitVerseNumbers) {
+          content += `[${chapterContent.number}] `;
+        }
+        content += chapterContent.text.trim() + " ";
+      } else if (chapterContent.type === "line_break") {
+        content = content.trim() + "\n";
+      }
+    }
+    if (!options.omitReference) {
+      content = `${this.formatReference(chapter.book, {
+        chapter: chapter.chapter.number
+      })}
+${content.trim()}`;
+    }
+    return content.trim();
+  }
+  /**
+   * Gets the text that the given word-level annotation applies to.
+   *
+   * Annotations are anchored to a range of characters in a single item of the verse's content,
+   * so that the ranges stay correct for verses whose content is split into multiple items,
+   * such as poem lines and the words of Jesus.
+   * @param verse The verse that the annotation is in.
+   * @param word The annotation to get the text for.
+   * @returns The annotated text, or an empty string if the annotation doesn't point at any text.
+   */
+  getWordText(verse, word) {
+    const content = verse.content[word.contentIndex];
+    if (typeof content === "string") {
+      return content.slice(word.start, word.end);
+    } else if (typeof content === "object" && content !== null && "text" in content) {
+      return content.text.slice(word.start, word.end);
+    }
+    return "";
+  }
+  /**
+   * Gets the word-level annotations for the given verse, paired with the text that each one applies to.
+   * @param verse The verse to get the annotations for.
+   * @param words The annotations for the chapter that the verse is in.
+   * @returns The annotations for the verse, in the order that they occur. Empty if the verse has no annotations.
+   */
+  getVerseWords(verse, words) {
+    const verseWords = words.verses[verse.number.toString()] ?? [];
+    return verseWords.map((word) => ({
+      ...word,
+      text: this.getWordText(verse, word)
+    }));
+  }
+  /**
+   * Gets the text that the given simplified word-level annotation applies to.
+   * @param verse The simplified verse that the annotation is in.
+   * @param word The annotation to get the text for.
+   * @returns The annotated text.
+   */
+  getSimpleWordText(verse, word) {
+    return verse.text.slice(word.start, word.end);
+  }
+  /**
+   * Gets the word-level annotations for the given simplified verse, paired with the text that each one applies to.
+   * @param verse The simplified verse to get the annotations for.
+   * @param words The simplified annotations for the chapter that the verse is in.
+   * @returns The annotations for the verse, in the order that they occur. Empty if the verse has no annotations.
+   */
+  getSimpleVerseWords(verse, words) {
+    const verseWords = words.verses[verse.number.toString()] ?? [];
+    return verseWords.map((word) => ({
+      ...word,
+      text: this.getSimpleWordText(verse, word)
+    }));
+  }
   _getJson(path, endpoint, useCache = true) {
     const url = this._buildUrl(path, endpoint);
     const existing = this._responseCache.get(url);

package/dist/esm/FreeUseBibleApi.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../FreeUseBibleApi.ts"],
-  "sourcesContent": ["import type {\r\n    ApiAvailableDatasets,\r\n    ApiAvailableTranslations,\r\n    ApiCommentaryBook,\r\n    ApiCommentaryBookChapter,\r\n    ApiDatasetBook,\r\n    ApiDatasetBookChapter,\r\n    ApiDatasetBooks,\r\n    ApiTranslationBook,\r\n    ApiTranslationBookChapter,\r\n    ApiTranslationBooks,\r\n    ApiTranslationComplete,\r\n    ChapterVerse,\r\n    TranslationChapterReference,\r\n} from './types.gen.js';\r\n\r\n/**\r\n * Options for the FreeUseBibleApi class.\r\n */\r\nexport interface FreeUseBibleApiOptions {\r\n    /**\r\n     * The API endpoint to use for the requests. If not provided, the default endpoint will be used.\r\n     */\r\n    endpoint?: string;\r\n\r\n    /**\r\n     * Whether to cache responses in memory.\r\n     *\r\n     * Defaults to `true`.\r\n     */\r\n    useCache?: boolean;\r\n}\r\n\r\n/**\r\n * Options for the `getChapterText` method.\r\n */\r\nexport interface GetChapterTextOptions {\r\n    /**\r\n     * Whether to omit verse numbers from the returned text.\r\n     * Defaults to `false`.\r\n     */\r\n    omitVerseNumbers?: boolean;\r\n\r\n    /**\r\n     * Whether to omit the chapter reference from the returned text.\r\n     */\r\n    omitReference?: boolean;\r\n}\r\n\r\n/**\r\n * Options for the `getVerseText` method.\r\n */\r\nexport interface GetVerseTextOptions {\r\n    /**\r\n     * Whether to omit the chapter reference from the returned text.\r\n     */\r\n    omitReference?: boolean;\r\n}\r\n\r\n/**\r\n * A reference to a specific verse in a Bible translation, commentary, or dataset.\r\n */\r\nexport interface VerseReference {\r\n    /**\r\n     * The chapter number of the reference. This should be a positive integer.\r\n     */\r\n    chapter: number;\r\n\r\n    /**\r\n     * The verse number of the reference.\r\n     *\r\n     * If omitted, then the reference refers to the entire chapter rather than a specific verse.\r\n     */\r\n    verse?: number;\r\n\r\n    /**\r\n     * The ending verse number of the reference, for references that span multiple verses. This should be greater than or equal to the `verse` property if it is provided.\r\n     */\r\n    endVerse?: number;\r\n\r\n    /**\r\n     * The ending chapter number of the reference, for references that span multiple chapters. This should be greater than or equal to the `chapter` property if it is provided.\r\n     */\r\n    endChapter?: number;\r\n}\r\n\r\n/**\r\n * A client for interacting with the [Free Use Bible API](https://bible.helloao.org/).\r\n *\r\n * This API provides access to a large collection of Bible translations, commentaries, and datasets that are free to use.\r\n */\r\nexport class FreeUseBibleApi {\r\n    endpoint: string = 'https://bible.helloao.org/';\r\n    private _responseCache = new Map<string, Promise<unknown>>();\r\n    private _useCache: boolean = true;\r\n\r\n    constructor(options?: FreeUseBibleApiOptions) {\r\n        this.endpoint = options?.endpoint ?? this.endpoint;\r\n        this._useCache = options?.useCache ?? this._useCache;\r\n    }\r\n\r\n    /**\r\n     * Gets the list of available Bible translations from the API.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getAvailableTranslations(\r\n        endpoint?: string\r\n    ): Promise<ApiAvailableTranslations> {\r\n        return this._getJson<ApiAvailableTranslations>(\r\n            'api/available_translations.json',\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the complete content of a specific Bible translation.\r\n     *\r\n     * The results of this endpoint are very large, so the response is not cached.\r\n     * @param translation The ID of the translation to get the complete content for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getCompleteTranslation(\r\n        translation: string,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationComplete> {\r\n        const encodedTranslation = encodeURIComponent(translation);\r\n        return this._getJson<ApiTranslationComplete>(\r\n            `api/${encodedTranslation}/complete.json`,\r\n            endpoint,\r\n            false\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the list of available Bible commentaries from the API.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getAvailableCommentaries(\r\n        endpoint?: string\r\n    ): Promise<ApiAvailableTranslations> {\r\n        return this._getJson<ApiAvailableTranslations>(\r\n            'api/available_commentaries.json',\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the list of available datasets from the API.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getAvailableDatasets(\r\n        endpoint?: string\r\n    ): Promise<ApiAvailableDatasets> {\r\n        return this._getJson<ApiAvailableDatasets>(\r\n            'api/available_datasets.json',\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the list of books for a given Bible translation.\r\n     * @param translation The ID of the translation to get the books for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getTranslationBooks(\r\n        translation: string,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBooks> {\r\n        const encodedTranslation = encodeURIComponent(translation);\r\n        return this._getJson<ApiTranslationBooks>(\r\n            `api/${encodedTranslation}/books.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the list of books for a given Bible commentary.\r\n     * @param commentary The ID of the commentary to get the books for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getCommentaryBooks(\r\n        commentary: string,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBooks> {\r\n        const encodedCommentary = encodeURIComponent(commentary);\r\n        return this._getJson<ApiTranslationBooks>(\r\n            `api/${encodedCommentary}/books.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the list of books for a given dataset.\r\n     * @param dataset The ID of the dataset to get the books for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getDatasetBooks(\r\n        dataset: string,\r\n        endpoint?: string\r\n    ): Promise<ApiDatasetBooks> {\r\n        const encodedDataset = encodeURIComponent(dataset);\r\n        return this._getJson<ApiDatasetBooks>(\r\n            `api/d/${encodedDataset}/books.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the content of a specific chapter of a specific book for a specific Bible translation.\r\n     * @param translation The ID of the translation to get the chapter for.\r\n     * @param book The ID of the book to get the chapter for.\r\n     * @param chapter The chapter number to get.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getTranslationBookChapter(\r\n        translation: string,\r\n        book: string,\r\n        chapter: number | string,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBookChapter> {\r\n        const encodedTranslation = encodeURIComponent(translation);\r\n        const encodedBook = encodeURIComponent(book);\r\n        const encodedChapter = encodeURIComponent(String(chapter));\r\n        return this._getJson<ApiTranslationBookChapter>(\r\n            `api/${encodedTranslation}/${encodedBook}/${encodedChapter}.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the content of a specific chapter of a specific book for a specific Bible commentary.\r\n     * @param commentary The ID of the commentary to get the chapter for.\r\n     * @param book The ID of the book to get the chapter for.\r\n     * @param chapter The chapter number to get.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getCommentaryBookChapter(\r\n        commentary: string,\r\n        book: string,\r\n        chapter: number | string,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBookChapter> {\r\n        const encodedCommentary = encodeURIComponent(commentary);\r\n        const encodedBook = encodeURIComponent(book);\r\n        const encodedChapter = encodeURIComponent(String(chapter));\r\n        return this._getJson<ApiTranslationBookChapter>(\r\n            `api/${encodedCommentary}/${encodedBook}/${encodedChapter}.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the content of a specific chapter of a specific book for a specific dataset.\r\n     * @param dataset The ID of the dataset to get the chapter for.\r\n     * @param book The ID of the book to get the chapter for.\r\n     * @param chapter The chapter number to get.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getDatasetBookChapter(\r\n        dataset: string,\r\n        book: string,\r\n        chapter: number | string,\r\n        endpoint?: string\r\n    ): Promise<ApiDatasetBookChapter> {\r\n        const encodedDataset = encodeURIComponent(dataset);\r\n        const encodedBook = encodeURIComponent(book);\r\n        const encodedChapter = encodeURIComponent(String(chapter));\r\n        return this._getJson<ApiDatasetBookChapter>(\r\n            `api/d/${encodedDataset}/${encodedBook}/${encodedChapter}.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the next chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the next chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The next chapter, or null if there is no next chapter.\r\n     */\r\n    getNextChapter(\r\n        chapter: ApiCommentaryBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiCommentaryBookChapter | null>;\r\n    /**\r\n     * Gets the next chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the next chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The next chapter, or null if there is no next chapter.\r\n     */\r\n    getNextChapter(\r\n        chapter: ApiTranslationBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBookChapter | null>;\r\n    /**\r\n     * Gets the next chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the next chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The next chapter, or null if there is no next chapter.\r\n     */\r\n    getNextChapter(\r\n        chapter: ApiDatasetBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiDatasetBookChapter | null>;\r\n    async getNextChapter(\r\n        chapter:\r\n            | ApiTranslationBookChapter\r\n            | ApiCommentaryBookChapter\r\n            | ApiDatasetBookChapter,\r\n        endpoint?: string\r\n    ): Promise<\r\n        | ApiTranslationBookChapter\r\n        | ApiCommentaryBookChapter\r\n        | ApiDatasetBookChapter\r\n        | null\r\n    > {\r\n        if (!chapter.nextChapterApiLink) {\r\n            return null;\r\n        }\r\n        return this._getJson<\r\n            | ApiTranslationBookChapter\r\n            | ApiCommentaryBookChapter\r\n            | ApiDatasetBookChapter\r\n        >(chapter.nextChapterApiLink, endpoint);\r\n    }\r\n\r\n    /**\r\n     * Gets the previous chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the previous chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The previous chapter, or null if there is no previous chapter.\r\n     */\r\n    getPreviousChapter(\r\n        chapter: ApiCommentaryBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiCommentaryBookChapter | null>;\r\n    /**\r\n     * Gets the previous chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the previous chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The previous chapter, or null if there is no previous chapter.\r\n     */\r\n    getPreviousChapter(\r\n        chapter: ApiTranslationBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBookChapter | null>;\r\n    /**\r\n     * Gets the previous chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the previous chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The previous chapter, or null if there is no previous chapter.\r\n     */\r\n    getPreviousChapter(\r\n        chapter: ApiDatasetBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiDatasetBookChapter | null>;\r\n    async getPreviousChapter(\r\n        chapter:\r\n            | ApiTranslationBookChapter\r\n            | ApiCommentaryBookChapter\r\n            | ApiDatasetBookChapter,\r\n        endpoint?: string\r\n    ): Promise<\r\n        | ApiTranslationBookChapter\r\n        | ApiCommentaryBookChapter\r\n        | ApiDatasetBookChapter\r\n        | null\r\n    > {\r\n        if (!chapter.previousChapterApiLink) {\r\n            return null;\r\n        }\r\n        return this._getJson<\r\n            | ApiTranslationBookChapter\r\n            | ApiCommentaryBookChapter\r\n            | ApiDatasetBookChapter\r\n        >(chapter.previousChapterApiLink, endpoint);\r\n    }\r\n\r\n    /**\r\n     * Gets the first chapter for a given book, if available.\r\n     * @param book The book to get the first chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The first chapter, or null if there is no first chapter.\r\n     */\r\n    getFirstChapter(\r\n        book: ApiCommentaryBook,\r\n        endpoint?: string\r\n    ): Promise<ApiCommentaryBookChapter | null>;\r\n    /**\r\n     * Gets the first chapter for a given book, if available.\r\n     * @param book The book to get the first chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The first chapter, or null if there is no first chapter.\r\n     */\r\n    getFirstChapter(\r\n        book: ApiTranslationBook,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBookChapter>;\r\n    /**\r\n     * Gets the first chapter for a given book, if available.\r\n     * @param book The book to get the first chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The first chapter, or null if there is no first chapter.\r\n     */\r\n    getFirstChapter(\r\n        book: ApiDatasetBook,\r\n        endpoint?: string\r\n    ): Promise<ApiDatasetBookChapter>;\r\n    async getFirstChapter(\r\n        book: ApiTranslationBook | ApiCommentaryBook | ApiDatasetBook,\r\n        endpoint?: string\r\n    ): Promise<\r\n        | ApiTranslationBookChapter\r\n        | ApiCommentaryBookChapter\r\n        | ApiDatasetBookChapter\r\n        | null\r\n    > {\r\n        if (!book.firstChapterApiLink) {\r\n            return null;\r\n        }\r\n        return this._getJson<\r\n            | ApiTranslationBookChapter\r\n            | ApiCommentaryBookChapter\r\n            | ApiDatasetBookChapter\r\n        >(book.firstChapterApiLink, endpoint);\r\n    }\r\n\r\n    /**\r\n     * Gets the last chapter for a given book, if available.\r\n     * @param book The book to get the last chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The last chapter, or null if there is no last chapter.\r\n     */\r\n    getLastChapter(\r\n        book: ApiCommentaryBook,\r\n        endpoint?: string\r\n    ): Promise<ApiCommentaryBookChapter | null>;\r\n    /**\r\n     * Gets the last chapter for a given book, if available.\r\n     * @param book The book to get the last chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The last chapter, or null if there is no last chapter.\r\n     */\r\n    getLastChapter(\r\n        book: ApiTranslationBook,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBookChapter>;\r\n    /**\r\n     * Gets the last chapter for a given book, if available.\r\n     * @param book The book to get the last chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The last chapter, or null if there is no last chapter.\r\n     */\r\n    getLastChapter(\r\n        book: ApiDatasetBook,\r\n        endpoint?: string\r\n    ): Promise<ApiDatasetBookChapter>;\r\n    async getLastChapter(\r\n        book: ApiTranslationBook | ApiCommentaryBook | ApiDatasetBook,\r\n        endpoint?: string\r\n    ): Promise<\r\n        | ApiTranslationBookChapter\r\n        | ApiCommentaryBookChapter\r\n        | ApiDatasetBookChapter\r\n        | null\r\n    > {\r\n        if (!book.lastChapterApiLink) {\r\n            return null;\r\n        }\r\n        return this._getJson<\r\n            | ApiTranslationBookChapter\r\n            | ApiCommentaryBookChapter\r\n            | ApiDatasetBookChapter\r\n        >(book.lastChapterApiLink, endpoint);\r\n    }\r\n\r\n    /**\r\n     * Formats a verse reference as a human-readable string.\r\n     *\r\n     * e.g. Genesis 1:1-2, John 3:16, Exodus 20-22, etc.\r\n     *\r\n     * @param book The book that the reference is for.\r\n     * @param reference The reference to format.\r\n     */\r\n    formatReference(\r\n        book: ApiTranslationBook,\r\n        reference: VerseReference\r\n    ): string {\r\n        const bookName = book.name;\r\n        const chapter = reference.chapter;\r\n        const verse = reference.verse;\r\n        const endChapter = reference.endChapter;\r\n        const endVerse = reference.endVerse;\r\n\r\n        let referenceStr = `${bookName} ${chapter}`;\r\n        if (endChapter) {\r\n            referenceStr += `-${endChapter}`;\r\n        } else if (verse) {\r\n            referenceStr += `:${verse}`;\r\n            if (endVerse) {\r\n                referenceStr += `-${endVerse}`;\r\n            }\r\n        }\r\n        return referenceStr;\r\n    }\r\n\r\n    /**\r\n     * Gets the text for a verse.\r\n     * @param verse The verse to get the text for.\r\n     * @param options Options for getting the verse text.\r\n     */\r\n    getVerseText(verse: ChapterVerse): string {\r\n        let content = '';\r\n        for (let part of verse.content) {\r\n            if (typeof part === 'string') {\r\n                content += part;\r\n            } else if (typeof part === 'object' && 'text' in part) {\r\n                if (part.poem) {\r\n                    content += '\\n';\r\n                    for (let i = 0; i < part.poem; i++) {\r\n                        content += '\\t';\r\n                    }\r\n                }\r\n                content += part.text;\r\n            } else if (typeof part === 'object' && 'lineBreak' in part) {\r\n                content += '\\n';\r\n            } else if (typeof part === 'object') {\r\n                content += ' ';\r\n            }\r\n        }\r\n        return content.trim();\r\n    }\r\n\r\n    /**\r\n     * Gets the verse text for the given chapter.\r\n     * By default, the returned text includes markers for verse numbers and a reference to the chapter, but these can be omitted by passing options to the `options` parameter.\r\n     * @param chapter The chapter to get the text for.\r\n     * @param options Options for getting the chapter text.\r\n     */\r\n    getChapterVerseText(\r\n        chapter: ApiTranslationBookChapter,\r\n        options: GetChapterTextOptions = {}\r\n    ): string {\r\n        let content = '';\r\n        for (let chapterContent of chapter.chapter.content) {\r\n            if (chapterContent.type === 'verse') {\r\n                if (!options.omitVerseNumbers) {\r\n                    content += `[${chapterContent.number}] `;\r\n                }\r\n                content += this.getVerseText(chapterContent) + ' ';\r\n            } else if (chapterContent.type === 'line_break') {\r\n                content = content.trim() + '\\n';\r\n            }\r\n        }\r\n\r\n        if (!options.omitReference) {\r\n            content = `${this.formatReference(chapter.book, {\r\n                chapter: chapter.chapter.number,\r\n            })}\\n${content.trim()}`;\r\n        }\r\n\r\n        return content.trim();\r\n    }\r\n\r\n    private _getJson<T>(\r\n        path: string,\r\n        endpoint: string | undefined,\r\n        useCache: boolean = true\r\n    ): Promise<T> {\r\n        const url = this._buildUrl(path, endpoint);\r\n        const existing = this._responseCache.get(url) as Promise<T> | undefined;\r\n        if (existing) {\r\n            return existing;\r\n        }\r\n\r\n        const request: Promise<T> = fetch(url)\r\n            .then(async (response) => {\r\n                if (response.status < 200 || response.status >= 300) {\r\n                    throw new Error(\r\n                        `Failed request to ${url}. Status: ${response.status} ${response.statusText}`\r\n                    );\r\n                }\r\n                return await response.json();\r\n            })\r\n            .catch((error) => {\r\n                this._responseCache.delete(url);\r\n                throw error;\r\n            });\r\n\r\n        if (this._useCache && useCache) {\r\n            this._responseCache.set(url, request);\r\n        }\r\n        return request;\r\n    }\r\n\r\n    private _buildUrl(path: string, endpoint?: string): string {\r\n        if (/^https?:\\/\\//i.test(path)) {\r\n            return path;\r\n        }\r\n\r\n        const baseEndpoint = endpoint ?? this.endpoint;\r\n        return new URL(path, baseEndpoint).href;\r\n    }\r\n}\r\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type {\r\n    ApiAvailableDatasets,\r\n    ApiAvailableTranslations,\r\n    ApiCommentaryBook,\r\n    ApiCommentaryBookChapter,\r\n    ApiDatasetBook,\r\n    ApiDatasetBookChapter,\r\n    ApiDatasetBooks,\r\n    ApiSimpleCommentaryBookChapter,\r\n    ApiSimpleTranslationBookChapter,\r\n    ApiSimpleTranslationBookChapterWords,\r\n    ApiSimpleTranslationComplete,\r\n    ApiTranslationBook,\r\n    ApiTranslationBookChapter,\r\n    ApiTranslationBookChapterWords,\r\n    ApiTranslationBooks,\r\n    ApiTranslationComplete,\r\n    ChapterVerse,\r\n    ChapterWord,\r\n    SimpleChapterVerse,\r\n    SimpleChapterWord,\r\n    TranslationChapterReference,\r\n} from './types.gen.js';\r\n\r\n/**\r\n * Options for the FreeUseBibleApi class.\r\n */\r\nexport interface FreeUseBibleApiOptions {\r\n    /**\r\n     * The API endpoint to use for the requests. If not provided, the default endpoint will be used.\r\n     */\r\n    endpoint?: string;\r\n\r\n    /**\r\n     * Whether to cache responses in memory.\r\n     *\r\n     * Defaults to `true`.\r\n     */\r\n    useCache?: boolean;\r\n}\r\n\r\n/**\r\n * Options for the `getChapterText` method.\r\n */\r\nexport interface GetChapterTextOptions {\r\n    /**\r\n     * Whether to omit verse numbers from the returned text.\r\n     * Defaults to `false`.\r\n     */\r\n    omitVerseNumbers?: boolean;\r\n\r\n    /**\r\n     * Whether to omit the chapter reference from the returned text.\r\n     */\r\n    omitReference?: boolean;\r\n}\r\n\r\n/**\r\n * Options for the `getVerseText` method.\r\n */\r\nexport interface GetVerseTextOptions {\r\n    /**\r\n     * Whether to omit the chapter reference from the returned text.\r\n     */\r\n    omitReference?: boolean;\r\n}\r\n\r\n/**\r\n * A word-level annotation, paired with the text of the verse that it covers.\r\n */\r\nexport interface AnnotatedWord extends ChapterWord {\r\n    /**\r\n     * The text that the annotation applies to.\r\n     */\r\n    text: string;\r\n}\r\n\r\n/**\r\n * A word-level annotation in a simplified chapter, paired with the text of the verse that it covers.\r\n */\r\nexport interface SimpleAnnotatedWord extends SimpleChapterWord {\r\n    /**\r\n     * The text that the annotation applies to.\r\n     */\r\n    text: string;\r\n}\r\n\r\n/**\r\n * A reference to a specific verse in a Bible translation, commentary, or dataset.\r\n */\r\nexport interface VerseReference {\r\n    /**\r\n     * The chapter number of the reference. This should be a positive integer.\r\n     */\r\n    chapter: number;\r\n\r\n    /**\r\n     * The verse number of the reference.\r\n     *\r\n     * If omitted, then the reference refers to the entire chapter rather than a specific verse.\r\n     */\r\n    verse?: number;\r\n\r\n    /**\r\n     * The ending verse number of the reference, for references that span multiple verses. This should be greater than or equal to the `verse` property if it is provided.\r\n     */\r\n    endVerse?: number;\r\n\r\n    /**\r\n     * The ending chapter number of the reference, for references that span multiple chapters. This should be greater than or equal to the `chapter` property if it is provided.\r\n     */\r\n    endChapter?: number;\r\n}\r\n\r\n/**\r\n * A client for interacting with the [Free Use Bible API](https://bible.helloao.org/).\r\n *\r\n * This API provides access to a large collection of Bible translations, commentaries, and datasets that are free to use.\r\n */\r\nexport class FreeUseBibleApi {\r\n    endpoint: string = 'https://bible.helloao.org/';\r\n    private _responseCache = new Map<string, Promise<unknown>>();\r\n    private _useCache: boolean = true;\r\n\r\n    constructor(options?: FreeUseBibleApiOptions) {\r\n        this.endpoint = options?.endpoint ?? this.endpoint;\r\n        this._useCache = options?.useCache ?? this._useCache;\r\n    }\r\n\r\n    /**\r\n     * Gets the list of available Bible translations from the API.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getAvailableTranslations(\r\n        endpoint?: string\r\n    ): Promise<ApiAvailableTranslations> {\r\n        return this._getJson<ApiAvailableTranslations>(\r\n            'api/available_translations.json',\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the complete content of a specific Bible translation.\r\n     *\r\n     * The results of this endpoint are very large, so the response is not cached.\r\n     * @param translation The ID of the translation to get the complete content for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getCompleteTranslation(\r\n        translation: string,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationComplete> {\r\n        const encodedTranslation = encodeURIComponent(translation);\r\n        return this._getJson<ApiTranslationComplete>(\r\n            `api/${encodedTranslation}/complete.json`,\r\n            endpoint,\r\n            false\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the complete content of a specific Bible translation, using the simplified chapter format.\r\n     *\r\n     * The results of this endpoint are very large, so the response is not cached.\r\n     * @param translation The ID of the translation to get the complete content for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getSimpleCompleteTranslation(\r\n        translation: string,\r\n        endpoint?: string\r\n    ): Promise<ApiSimpleTranslationComplete> {\r\n        const encodedTranslation = encodeURIComponent(translation);\r\n        return this._getJson<ApiSimpleTranslationComplete>(\r\n            `api/${encodedTranslation}/complete.simple.json`,\r\n            endpoint,\r\n            false\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the list of available Bible commentaries from the API.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getAvailableCommentaries(\r\n        endpoint?: string\r\n    ): Promise<ApiAvailableTranslations> {\r\n        return this._getJson<ApiAvailableTranslations>(\r\n            'api/available_commentaries.json',\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the list of available datasets from the API.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getAvailableDatasets(\r\n        endpoint?: string\r\n    ): Promise<ApiAvailableDatasets> {\r\n        return this._getJson<ApiAvailableDatasets>(\r\n            'api/available_datasets.json',\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the list of books for a given Bible translation.\r\n     * @param translation The ID of the translation to get the books for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getTranslationBooks(\r\n        translation: string,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBooks> {\r\n        const encodedTranslation = encodeURIComponent(translation);\r\n        return this._getJson<ApiTranslationBooks>(\r\n            `api/${encodedTranslation}/books.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the list of books for a given Bible commentary.\r\n     * @param commentary The ID of the commentary to get the books for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getCommentaryBooks(\r\n        commentary: string,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBooks> {\r\n        const encodedCommentary = encodeURIComponent(commentary);\r\n        return this._getJson<ApiTranslationBooks>(\r\n            `api/c/${encodedCommentary}/books.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the list of books for a given dataset.\r\n     * @param dataset The ID of the dataset to get the books for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getDatasetBooks(\r\n        dataset: string,\r\n        endpoint?: string\r\n    ): Promise<ApiDatasetBooks> {\r\n        const encodedDataset = encodeURIComponent(dataset);\r\n        return this._getJson<ApiDatasetBooks>(\r\n            `api/d/${encodedDataset}/books.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the content of a specific chapter of a specific book for a specific Bible translation.\r\n     * @param translation The ID of the translation to get the chapter for.\r\n     * @param book The ID of the book to get the chapter for.\r\n     * @param chapter The chapter number to get.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getTranslationBookChapter(\r\n        translation: string,\r\n        book: string,\r\n        chapter: number | string,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBookChapter> {\r\n        const encodedTranslation = encodeURIComponent(translation);\r\n        const encodedBook = encodeURIComponent(book);\r\n        const encodedChapter = encodeURIComponent(String(chapter));\r\n        return this._getJson<ApiTranslationBookChapter>(\r\n            `api/${encodedTranslation}/${encodedBook}/${encodedChapter}.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the word-level annotations (Strong's numbers and related source data) for a specific chapter of a specific book for a specific Bible translation.\r\n     *\r\n     * Only some translations have word-level annotations. This request will fail for chapters that don't have any.\r\n     * Use `getChapterWords()` to get the annotations for a chapter that you have already loaded, which returns null instead of failing.\r\n     * @param translation The ID of the translation to get the annotations for.\r\n     * @param book The ID of the book to get the annotations for.\r\n     * @param chapter The chapter number to get the annotations for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getTranslationBookChapterWords(\r\n        translation: string,\r\n        book: string,\r\n        chapter: number | string,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBookChapterWords> {\r\n        const encodedTranslation = encodeURIComponent(translation);\r\n        const encodedBook = encodeURIComponent(book);\r\n        const encodedChapter = encodeURIComponent(String(chapter));\r\n        return this._getJson<ApiTranslationBookChapterWords>(\r\n            `api/${encodedTranslation}/${encodedBook}/${encodedChapter}.words.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the word-level annotations for the given chapter, if it has any.\r\n     * @param chapter The chapter to get the annotations for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The annotations for the chapter, or null if the chapter doesn't have any.\r\n     */\r\n    async getChapterWords(\r\n        chapter: ApiTranslationBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBookChapterWords | null> {\r\n        if (!chapter.thisChapterWordsLink) {\r\n            return null;\r\n        }\r\n        return this._getJson<ApiTranslationBookChapterWords>(\r\n            chapter.thisChapterWordsLink,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the content of a specific chapter of a specific book for a specific Bible translation, using the simplified chapter format.\r\n     *\r\n     * In the simplified format, each verse's content is a single string instead of a list of formatted content, and footnotes, inline headings, the Words of Jesus, and poetry are represented as offset ranges into that string.\r\n     * @param translation The ID of the translation to get the chapter for.\r\n     * @param book The ID of the book to get the chapter for.\r\n     * @param chapter The chapter number to get.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getSimpleTranslationBookChapter(\r\n        translation: string,\r\n        book: string,\r\n        chapter: number | string,\r\n        endpoint?: string\r\n    ): Promise<ApiSimpleTranslationBookChapter> {\r\n        const encodedTranslation = encodeURIComponent(translation);\r\n        const encodedBook = encodeURIComponent(book);\r\n        const encodedChapter = encodeURIComponent(String(chapter));\r\n        return this._getJson<ApiSimpleTranslationBookChapter>(\r\n            `api/${encodedTranslation}/${encodedBook}/${encodedChapter}.simple.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the word-level annotations (Strong's numbers and related source data) for a specific chapter of a specific book for a specific Bible translation, with their offsets remapped onto the text of each simplified verse.\r\n     *\r\n     * Use this instead of `getTranslationBookChapterWords()` when working with the simplified chapter format, since the offsets in the regular annotations are anchored to a verse's content array instead of its plain text.\r\n     * Use `getSimpleChapterWords()` to get the annotations for a simplified chapter that you have already loaded, which returns null instead of failing.\r\n     * @param translation The ID of the translation to get the annotations for.\r\n     * @param book The ID of the book to get the annotations for.\r\n     * @param chapter The chapter number to get the annotations for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getSimpleTranslationBookChapterWords(\r\n        translation: string,\r\n        book: string,\r\n        chapter: number | string,\r\n        endpoint?: string\r\n    ): Promise<ApiSimpleTranslationBookChapterWords> {\r\n        const encodedTranslation = encodeURIComponent(translation);\r\n        const encodedBook = encodeURIComponent(book);\r\n        const encodedChapter = encodeURIComponent(String(chapter));\r\n        return this._getJson<ApiSimpleTranslationBookChapterWords>(\r\n            `api/${encodedTranslation}/${encodedBook}/${encodedChapter}.words.simple.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the simplified version of a given chapter, if available.\r\n     * @param chapter The chapter to get the simplified version of.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The simplified chapter, or null if simplified chapters aren't available for it.\r\n     */\r\n    getSimpleChapter(\r\n        chapter: ApiCommentaryBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiSimpleCommentaryBookChapter | null>;\r\n    /**\r\n     * Gets the simplified version of a given chapter, if available.\r\n     * @param chapter The chapter to get the simplified version of.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The simplified chapter, or null if simplified chapters aren't available for it.\r\n     */\r\n    getSimpleChapter(\r\n        chapter: ApiTranslationBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiSimpleTranslationBookChapter | null>;\r\n    async getSimpleChapter(\r\n        chapter: ApiTranslationBookChapter | ApiCommentaryBookChapter,\r\n        endpoint?: string\r\n    ): Promise<\r\n        ApiSimpleTranslationBookChapter | ApiSimpleCommentaryBookChapter | null\r\n    > {\r\n        if (!chapter.simpleChapterApiLink) {\r\n            return null;\r\n        }\r\n        return this._getJson<\r\n            ApiSimpleTranslationBookChapter | ApiSimpleCommentaryBookChapter\r\n        >(chapter.simpleChapterApiLink, endpoint);\r\n    }\r\n\r\n    /**\r\n     * Gets the word-level annotations for the given simplified chapter, if it has any.\r\n     * @param chapter The simplified chapter to get the annotations for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The annotations for the chapter, or null if the chapter doesn't have any.\r\n     */\r\n    async getSimpleChapterWords(\r\n        chapter: ApiSimpleTranslationBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiSimpleTranslationBookChapterWords | null> {\r\n        if (!chapter.thisChapterWordsLink) {\r\n            return null;\r\n        }\r\n        return this._getJson<ApiSimpleTranslationBookChapterWords>(\r\n            chapter.thisChapterWordsLink,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the content of a specific chapter of a specific book for a specific Bible commentary.\r\n     * @param commentary The ID of the commentary to get the chapter for.\r\n     * @param book The ID of the book to get the chapter for.\r\n     * @param chapter The chapter number to get.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getCommentaryBookChapter(\r\n        commentary: string,\r\n        book: string,\r\n        chapter: number | string,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBookChapter> {\r\n        const encodedCommentary = encodeURIComponent(commentary);\r\n        const encodedBook = encodeURIComponent(book);\r\n        const encodedChapter = encodeURIComponent(String(chapter));\r\n        return this._getJson<ApiTranslationBookChapter>(\r\n            `api/c/${encodedCommentary}/${encodedBook}/${encodedChapter}.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the content of a specific chapter of a specific book for a specific Bible commentary, using the simplified chapter format.\r\n     * @param commentary The ID of the commentary to get the chapter for.\r\n     * @param book The ID of the book to get the chapter for.\r\n     * @param chapter The chapter number to get.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getSimpleCommentaryBookChapter(\r\n        commentary: string,\r\n        book: string,\r\n        chapter: number | string,\r\n        endpoint?: string\r\n    ): Promise<ApiSimpleCommentaryBookChapter> {\r\n        const encodedCommentary = encodeURIComponent(commentary);\r\n        const encodedBook = encodeURIComponent(book);\r\n        const encodedChapter = encodeURIComponent(String(chapter));\r\n        return this._getJson<ApiSimpleCommentaryBookChapter>(\r\n            `api/c/${encodedCommentary}/${encodedBook}/${encodedChapter}.simple.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the content of a specific chapter of a specific book for a specific dataset.\r\n     * @param dataset The ID of the dataset to get the chapter for.\r\n     * @param book The ID of the book to get the chapter for.\r\n     * @param chapter The chapter number to get.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     */\r\n    async getDatasetBookChapter(\r\n        dataset: string,\r\n        book: string,\r\n        chapter: number | string,\r\n        endpoint?: string\r\n    ): Promise<ApiDatasetBookChapter> {\r\n        const encodedDataset = encodeURIComponent(dataset);\r\n        const encodedBook = encodeURIComponent(book);\r\n        const encodedChapter = encodeURIComponent(String(chapter));\r\n        return this._getJson<ApiDatasetBookChapter>(\r\n            `api/d/${encodedDataset}/${encodedBook}/${encodedChapter}.json`,\r\n            endpoint\r\n        );\r\n    }\r\n\r\n    /**\r\n     * Gets the next chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the next chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The next chapter, or null if there is no next chapter.\r\n     */\r\n    getNextChapter(\r\n        chapter: ApiCommentaryBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiCommentaryBookChapter | null>;\r\n    /**\r\n     * Gets the next chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the next chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The next chapter, or null if there is no next chapter.\r\n     */\r\n    getNextChapter(\r\n        chapter: ApiTranslationBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBookChapter | null>;\r\n    /**\r\n     * Gets the next chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the next chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The next chapter, or null if there is no next chapter.\r\n     */\r\n    getNextChapter(\r\n        chapter: ApiDatasetBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiDatasetBookChapter | null>;\r\n    /**\r\n     * Gets the next chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the next chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The next chapter, or null if there is no next chapter.\r\n     */\r\n    getNextChapter(\r\n        chapter: ApiSimpleCommentaryBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiSimpleCommentaryBookChapter | null>;\r\n    /**\r\n     * Gets the next chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the next chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The next chapter, or null if there is no next chapter.\r\n     */\r\n    getNextChapter(\r\n        chapter: ApiSimpleTranslationBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiSimpleTranslationBookChapter | null>;\r\n    async getNextChapter(\r\n        chapter:\r\n            | ApiTranslationBookChapter\r\n            | ApiCommentaryBookChapter\r\n            | ApiDatasetBookChapter\r\n            | ApiSimpleTranslationBookChapter\r\n            | ApiSimpleCommentaryBookChapter,\r\n        endpoint?: string\r\n    ): Promise<\r\n        | ApiTranslationBookChapter\r\n        | ApiCommentaryBookChapter\r\n        | ApiDatasetBookChapter\r\n        | ApiSimpleTranslationBookChapter\r\n        | ApiSimpleCommentaryBookChapter\r\n        | null\r\n    > {\r\n        if (!chapter.nextChapterApiLink) {\r\n            return null;\r\n        }\r\n        return this._getJson<\r\n            | ApiTranslationBookChapter\r\n            | ApiCommentaryBookChapter\r\n            | ApiDatasetBookChapter\r\n            | ApiSimpleTranslationBookChapter\r\n            | ApiSimpleCommentaryBookChapter\r\n        >(chapter.nextChapterApiLink, endpoint);\r\n    }\r\n\r\n    /**\r\n     * Gets the previous chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the previous chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The previous chapter, or null if there is no previous chapter.\r\n     */\r\n    getPreviousChapter(\r\n        chapter: ApiCommentaryBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiCommentaryBookChapter | null>;\r\n    /**\r\n     * Gets the previous chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the previous chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The previous chapter, or null if there is no previous chapter.\r\n     */\r\n    getPreviousChapter(\r\n        chapter: ApiTranslationBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBookChapter | null>;\r\n    /**\r\n     * Gets the previous chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the previous chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The previous chapter, or null if there is no previous chapter.\r\n     */\r\n    getPreviousChapter(\r\n        chapter: ApiDatasetBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiDatasetBookChapter | null>;\r\n    /**\r\n     * Gets the previous chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the previous chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The previous chapter, or null if there is no previous chapter.\r\n     */\r\n    getPreviousChapter(\r\n        chapter: ApiSimpleCommentaryBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiSimpleCommentaryBookChapter | null>;\r\n    /**\r\n     * Gets the previous chapter for a given chapter, if available.\r\n     * @param chapter The chapter to get the previous chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The previous chapter, or null if there is no previous chapter.\r\n     */\r\n    getPreviousChapter(\r\n        chapter: ApiSimpleTranslationBookChapter,\r\n        endpoint?: string\r\n    ): Promise<ApiSimpleTranslationBookChapter | null>;\r\n    async getPreviousChapter(\r\n        chapter:\r\n            | ApiTranslationBookChapter\r\n            | ApiCommentaryBookChapter\r\n            | ApiDatasetBookChapter\r\n            | ApiSimpleTranslationBookChapter\r\n            | ApiSimpleCommentaryBookChapter,\r\n        endpoint?: string\r\n    ): Promise<\r\n        | ApiTranslationBookChapter\r\n        | ApiCommentaryBookChapter\r\n        | ApiDatasetBookChapter\r\n        | ApiSimpleTranslationBookChapter\r\n        | ApiSimpleCommentaryBookChapter\r\n        | null\r\n    > {\r\n        if (!chapter.previousChapterApiLink) {\r\n            return null;\r\n        }\r\n        return this._getJson<\r\n            | ApiTranslationBookChapter\r\n            | ApiCommentaryBookChapter\r\n            | ApiDatasetBookChapter\r\n            | ApiSimpleTranslationBookChapter\r\n            | ApiSimpleCommentaryBookChapter\r\n        >(chapter.previousChapterApiLink, endpoint);\r\n    }\r\n\r\n    /**\r\n     * Gets the first chapter for a given book, if available.\r\n     * @param book The book to get the first chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The first chapter, or null if there is no first chapter.\r\n     */\r\n    getFirstChapter(\r\n        book: ApiCommentaryBook,\r\n        endpoint?: string\r\n    ): Promise<ApiCommentaryBookChapter | null>;\r\n    /**\r\n     * Gets the first chapter for a given book, if available.\r\n     * @param book The book to get the first chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The first chapter, or null if there is no first chapter.\r\n     */\r\n    getFirstChapter(\r\n        book: ApiTranslationBook,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBookChapter>;\r\n    /**\r\n     * Gets the first chapter for a given book, if available.\r\n     * @param book The book to get the first chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The first chapter, or null if there is no first chapter.\r\n     */\r\n    getFirstChapter(\r\n        book: ApiDatasetBook,\r\n        endpoint?: string\r\n    ): Promise<ApiDatasetBookChapter>;\r\n    async getFirstChapter(\r\n        book: ApiTranslationBook | ApiCommentaryBook | ApiDatasetBook,\r\n        endpoint?: string\r\n    ): Promise<\r\n        | ApiTranslationBookChapter\r\n        | ApiCommentaryBookChapter\r\n        | ApiDatasetBookChapter\r\n        | null\r\n    > {\r\n        if (!book.firstChapterApiLink) {\r\n            return null;\r\n        }\r\n        return this._getJson<\r\n            | ApiTranslationBookChapter\r\n            | ApiCommentaryBookChapter\r\n            | ApiDatasetBookChapter\r\n        >(book.firstChapterApiLink, endpoint);\r\n    }\r\n\r\n    /**\r\n     * Gets the last chapter for a given book, if available.\r\n     * @param book The book to get the last chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The last chapter, or null if there is no last chapter.\r\n     */\r\n    getLastChapter(\r\n        book: ApiCommentaryBook,\r\n        endpoint?: string\r\n    ): Promise<ApiCommentaryBookChapter | null>;\r\n    /**\r\n     * Gets the last chapter for a given book, if available.\r\n     * @param book The book to get the last chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The last chapter, or null if there is no last chapter.\r\n     */\r\n    getLastChapter(\r\n        book: ApiTranslationBook,\r\n        endpoint?: string\r\n    ): Promise<ApiTranslationBookChapter>;\r\n    /**\r\n     * Gets the last chapter for a given book, if available.\r\n     * @param book The book to get the last chapter for.\r\n     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.\r\n     * @returns The last chapter, or null if there is no last chapter.\r\n     */\r\n    getLastChapter(\r\n        book: ApiDatasetBook,\r\n        endpoint?: string\r\n    ): Promise<ApiDatasetBookChapter>;\r\n    async getLastChapter(\r\n        book: ApiTranslationBook | ApiCommentaryBook | ApiDatasetBook,\r\n        endpoint?: string\r\n    ): Promise<\r\n        | ApiTranslationBookChapter\r\n        | ApiCommentaryBookChapter\r\n        | ApiDatasetBookChapter\r\n        | null\r\n    > {\r\n        if (!book.lastChapterApiLink) {\r\n            return null;\r\n        }\r\n        return this._getJson<\r\n            | ApiTranslationBookChapter\r\n            | ApiCommentaryBookChapter\r\n            | ApiDatasetBookChapter\r\n        >(book.lastChapterApiLink, endpoint);\r\n    }\r\n\r\n    /**\r\n     * Formats a verse reference as a human-readable string.\r\n     *\r\n     * e.g. Genesis 1:1-2, John 3:16, Exodus 20-22, etc.\r\n     *\r\n     * @param book The book that the reference is for.\r\n     * @param reference The reference to format.\r\n     */\r\n    formatReference(\r\n        book: ApiTranslationBook,\r\n        reference: VerseReference\r\n    ): string {\r\n        const bookName = book.name;\r\n        const chapter = reference.chapter;\r\n        const verse = reference.verse;\r\n        const endChapter = reference.endChapter;\r\n        const endVerse = reference.endVerse;\r\n\r\n        let referenceStr = `${bookName} ${chapter}`;\r\n        if (endChapter) {\r\n            referenceStr += `-${endChapter}`;\r\n        } else if (verse) {\r\n            referenceStr += `:${verse}`;\r\n            if (endVerse) {\r\n                referenceStr += `-${endVerse}`;\r\n            }\r\n        }\r\n        return referenceStr;\r\n    }\r\n\r\n    /**\r\n     * Gets the text for a verse.\r\n     * @param verse The verse to get the text for.\r\n     * @param options Options for getting the verse text.\r\n     */\r\n    getVerseText(verse: ChapterVerse): string {\r\n        let content = '';\r\n        for (let part of verse.content) {\r\n            if (typeof part === 'string') {\r\n                content += part;\r\n            } else if (typeof part === 'object' && 'text' in part) {\r\n                if (part.poem) {\r\n                    content += '\\n';\r\n                    for (let i = 0; i < part.poem; i++) {\r\n                        content += '\\t';\r\n                    }\r\n                }\r\n                content += part.text;\r\n            } else if (typeof part === 'object' && 'lineBreak' in part) {\r\n                content += '\\n';\r\n            } else if (typeof part === 'object') {\r\n                content += ' ';\r\n            }\r\n        }\r\n        return content.trim();\r\n    }\r\n\r\n    /**\r\n     * Gets the verse text for the given chapter.\r\n     * By default, the returned text includes markers for verse numbers and a reference to the chapter, but these can be omitted by passing options to the `options` parameter.\r\n     * @param chapter The chapter to get the text for.\r\n     * @param options Options for getting the chapter text.\r\n     */\r\n    getChapterVerseText(\r\n        chapter: ApiTranslationBookChapter,\r\n        options: GetChapterTextOptions = {}\r\n    ): string {\r\n        let content = '';\r\n        for (let chapterContent of chapter.chapter.content) {\r\n            if (chapterContent.type === 'verse') {\r\n                if (!options.omitVerseNumbers) {\r\n                    content += `[${chapterContent.number}] `;\r\n                }\r\n                content += this.getVerseText(chapterContent) + ' ';\r\n            } else if (chapterContent.type === 'line_break') {\r\n                content = content.trim() + '\\n';\r\n            }\r\n        }\r\n\r\n        if (!options.omitReference) {\r\n            content = `${this.formatReference(chapter.book, {\r\n                chapter: chapter.chapter.number,\r\n            })}\\n${content.trim()}`;\r\n        }\r\n\r\n        return content.trim();\r\n    }\r\n\r\n    /**\r\n     * Gets the verse text for the given simplified chapter.\r\n     * By default, the returned text includes markers for verse numbers and a reference to the chapter, but these can be omitted by passing options to the `options` parameter.\r\n     * @param chapter The simplified chapter to get the text for.\r\n     * @param options Options for getting the chapter text.\r\n     */\r\n    getSimpleChapterVerseText(\r\n        chapter: ApiSimpleTranslationBookChapter,\r\n        options: GetChapterTextOptions = {}\r\n    ): string {\r\n        let content = '';\r\n        for (let chapterContent of chapter.chapter.content) {\r\n            if (chapterContent.type === 'verse') {\r\n                if (!options.omitVerseNumbers) {\r\n                    content += `[${chapterContent.number}] `;\r\n                }\r\n                content += chapterContent.text.trim() + ' ';\r\n            } else if (chapterContent.type === 'line_break') {\r\n                content = content.trim() + '\\n';\r\n            }\r\n        }\r\n\r\n        if (!options.omitReference) {\r\n            content = `${this.formatReference(chapter.book, {\r\n                chapter: chapter.chapter.number,\r\n            })}\\n${content.trim()}`;\r\n        }\r\n\r\n        return content.trim();\r\n    }\r\n\r\n    /**\r\n     * Gets the text that the given word-level annotation applies to.\r\n     *\r\n     * Annotations are anchored to a range of characters in a single item of the verse's content,\r\n     * so that the ranges stay correct for verses whose content is split into multiple items,\r\n     * such as poem lines and the words of Jesus.\r\n     * @param verse The verse that the annotation is in.\r\n     * @param word The annotation to get the text for.\r\n     * @returns The annotated text, or an empty string if the annotation doesn't point at any text.\r\n     */\r\n    getWordText(verse: ChapterVerse, word: ChapterWord): string {\r\n        const content = verse.content[word.contentIndex];\r\n\r\n        if (typeof content === 'string') {\r\n            return content.slice(word.start, word.end);\r\n        } else if (\r\n            typeof content === 'object' &&\r\n            content !== null &&\r\n            'text' in content\r\n        ) {\r\n            return content.text.slice(word.start, word.end);\r\n        }\r\n\r\n        // Line breaks, inline headings, and footnote references have no text of their own.\r\n        return '';\r\n    }\r\n\r\n    /**\r\n     * Gets the word-level annotations for the given verse, paired with the text that each one applies to.\r\n     * @param verse The verse to get the annotations for.\r\n     * @param words The annotations for the chapter that the verse is in.\r\n     * @returns The annotations for the verse, in the order that they occur. Empty if the verse has no annotations.\r\n     */\r\n    getVerseWords(\r\n        verse: ChapterVerse,\r\n        words: ApiTranslationBookChapterWords\r\n    ): AnnotatedWord[] {\r\n        const verseWords = words.verses[verse.number.toString()] ?? [];\r\n\r\n        return verseWords.map((word) => ({\r\n            ...word,\r\n            text: this.getWordText(verse, word),\r\n        }));\r\n    }\r\n\r\n    /**\r\n     * Gets the text that the given simplified word-level annotation applies to.\r\n     * @param verse The simplified verse that the annotation is in.\r\n     * @param word The annotation to get the text for.\r\n     * @returns The annotated text.\r\n     */\r\n    getSimpleWordText(\r\n        verse: SimpleChapterVerse,\r\n        word: SimpleChapterWord\r\n    ): string {\r\n        return verse.text.slice(word.start, word.end);\r\n    }\r\n\r\n    /**\r\n     * Gets the word-level annotations for the given simplified verse, paired with the text that each one applies to.\r\n     * @param verse The simplified verse to get the annotations for.\r\n     * @param words The simplified annotations for the chapter that the verse is in.\r\n     * @returns The annotations for the verse, in the order that they occur. Empty if the verse has no annotations.\r\n     */\r\n    getSimpleVerseWords(\r\n        verse: SimpleChapterVerse,\r\n        words: ApiSimpleTranslationBookChapterWords\r\n    ): SimpleAnnotatedWord[] {\r\n        const verseWords = words.verses[verse.number.toString()] ?? [];\r\n\r\n        return verseWords.map((word) => ({\r\n            ...word,\r\n            text: this.getSimpleWordText(verse, word),\r\n        }));\r\n    }\r\n\r\n    private _getJson<T>(\r\n        path: string,\r\n        endpoint: string | undefined,\r\n        useCache: boolean = true\r\n    ): Promise<T> {\r\n        const url = this._buildUrl(path, endpoint);\r\n        const existing = this._responseCache.get(url) as Promise<T> | undefined;\r\n        if (existing) {\r\n            return existing;\r\n        }\r\n\r\n        const request: Promise<T> = fetch(url)\r\n            .then(async (response) => {\r\n                if (response.status < 200 || response.status >= 300) {\r\n                    throw new Error(\r\n                        `Failed request to ${url}. Status: ${response.status} ${response.statusText}`\r\n                    );\r\n                }\r\n                return await response.json();\r\n            })\r\n            .catch((error) => {\r\n                this._responseCache.delete(url);\r\n                throw error;\r\n            });\r\n\r\n        if (this._useCache && useCache) {\r\n            this._responseCache.set(url, request);\r\n        }\r\n        return request;\r\n    }\r\n\r\n    private _buildUrl(path: string, endpoint?: string): string {\r\n        if (/^https?:\\/\\//i.test(path)) {\r\n            return path;\r\n        }\r\n\r\n        const baseEndpoint = endpoint ?? this.endpoint;\r\n        return new URL(path, baseEndpoint).href;\r\n    }\r\n}\r\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/types/FreeUseBibleApi.d.ts

@@ -1,4 +1,4 @@
-import type { ApiAvailableDatasets, ApiAvailableTranslations, ApiCommentaryBook, ApiCommentaryBookChapter, ApiDatasetBook, ApiDatasetBookChapter, ApiDatasetBooks, ApiTranslationBook, ApiTranslationBookChapter, ApiTranslationBooks, ApiTranslationComplete, ChapterVerse } from './types.gen.js';
+import type { ApiAvailableDatasets, ApiAvailableTranslations, ApiCommentaryBook, ApiCommentaryBookChapter, ApiDatasetBook, ApiDatasetBookChapter, ApiDatasetBooks, ApiSimpleCommentaryBookChapter, ApiSimpleTranslationBookChapter, ApiSimpleTranslationBookChapterWords, ApiSimpleTranslationComplete, ApiTranslationBook, ApiTranslationBookChapter, ApiTranslationBookChapterWords, ApiTranslationBooks, ApiTranslationComplete, ChapterVerse, ChapterWord, SimpleChapterVerse, SimpleChapterWord } from './types.gen.js';
 /**
  * Options for the FreeUseBibleApi class.
  */
@@ -37,6 +37,24 @@ export interface GetVerseTextOptions {
      */
     omitReference?: boolean;
 }
+/**
+ * A word-level annotation, paired with the text of the verse that it covers.
+ */
+export interface AnnotatedWord extends ChapterWord {
+    /**
+     * The text that the annotation applies to.
+     */
+    text: string;
+}
+/**
+ * A word-level annotation in a simplified chapter, paired with the text of the verse that it covers.
+ */
+export interface SimpleAnnotatedWord extends SimpleChapterWord {
+    /**
+     * The text that the annotation applies to.
+     */
+    text: string;
+}
 /**
  * A reference to a specific verse in a Bible translation, commentary, or dataset.
  */
@@ -83,6 +101,14 @@ export declare class FreeUseBibleApi {
      * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
      */
     getCompleteTranslation(translation: string, endpoint?: string): Promise<ApiTranslationComplete>;
+    /**
+     * Gets the complete content of a specific Bible translation, using the simplified chapter format.
+     *
+     * The results of this endpoint are very large, so the response is not cached.
+     * @param translation The ID of the translation to get the complete content for.
+     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+     */
+    getSimpleCompleteTranslation(translation: string, endpoint?: string): Promise<ApiSimpleTranslationComplete>;
     /**
      * Gets the list of available Bible commentaries from the API.
      * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
@@ -119,6 +145,66 @@ export declare class FreeUseBibleApi {
      * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
      */
     getTranslationBookChapter(translation: string, book: string, chapter: number | string, endpoint?: string): Promise<ApiTranslationBookChapter>;
+    /**
+     * Gets the word-level annotations (Strong's numbers and related source data) for a specific chapter of a specific book for a specific Bible translation.
+     *
+     * Only some translations have word-level annotations. This request will fail for chapters that don't have any.
+     * Use `getChapterWords()` to get the annotations for a chapter that you have already loaded, which returns null instead of failing.
+     * @param translation The ID of the translation to get the annotations for.
+     * @param book The ID of the book to get the annotations for.
+     * @param chapter The chapter number to get the annotations for.
+     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+     */
+    getTranslationBookChapterWords(translation: string, book: string, chapter: number | string, endpoint?: string): Promise<ApiTranslationBookChapterWords>;
+    /**
+     * Gets the word-level annotations for the given chapter, if it has any.
+     * @param chapter The chapter to get the annotations for.
+     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+     * @returns The annotations for the chapter, or null if the chapter doesn't have any.
+     */
+    getChapterWords(chapter: ApiTranslationBookChapter, endpoint?: string): Promise<ApiTranslationBookChapterWords | null>;
+    /**
+     * Gets the content of a specific chapter of a specific book for a specific Bible translation, using the simplified chapter format.
+     *
+     * In the simplified format, each verse's content is a single string instead of a list of formatted content, and footnotes, inline headings, the Words of Jesus, and poetry are represented as offset ranges into that string.
+     * @param translation The ID of the translation to get the chapter for.
+     * @param book The ID of the book to get the chapter for.
+     * @param chapter The chapter number to get.
+     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+     */
+    getSimpleTranslationBookChapter(translation: string, book: string, chapter: number | string, endpoint?: string): Promise<ApiSimpleTranslationBookChapter>;
+    /**
+     * Gets the word-level annotations (Strong's numbers and related source data) for a specific chapter of a specific book for a specific Bible translation, with their offsets remapped onto the text of each simplified verse.
+     *
+     * Use this instead of `getTranslationBookChapterWords()` when working with the simplified chapter format, since the offsets in the regular annotations are anchored to a verse's content array instead of its plain text.
+     * Use `getSimpleChapterWords()` to get the annotations for a simplified chapter that you have already loaded, which returns null instead of failing.
+     * @param translation The ID of the translation to get the annotations for.
+     * @param book The ID of the book to get the annotations for.
+     * @param chapter The chapter number to get the annotations for.
+     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+     */
+    getSimpleTranslationBookChapterWords(translation: string, book: string, chapter: number | string, endpoint?: string): Promise<ApiSimpleTranslationBookChapterWords>;
+    /**
+     * Gets the simplified version of a given chapter, if available.
+     * @param chapter The chapter to get the simplified version of.
+     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+     * @returns The simplified chapter, or null if simplified chapters aren't available for it.
+     */
+    getSimpleChapter(chapter: ApiCommentaryBookChapter, endpoint?: string): Promise<ApiSimpleCommentaryBookChapter | null>;
+    /**
+     * Gets the simplified version of a given chapter, if available.
+     * @param chapter The chapter to get the simplified version of.
+     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+     * @returns The simplified chapter, or null if simplified chapters aren't available for it.
+     */
+    getSimpleChapter(chapter: ApiTranslationBookChapter, endpoint?: string): Promise<ApiSimpleTranslationBookChapter | null>;
+    /**
+     * Gets the word-level annotations for the given simplified chapter, if it has any.
+     * @param chapter The simplified chapter to get the annotations for.
+     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+     * @returns The annotations for the chapter, or null if the chapter doesn't have any.
+     */
+    getSimpleChapterWords(chapter: ApiSimpleTranslationBookChapter, endpoint?: string): Promise<ApiSimpleTranslationBookChapterWords | null>;
     /**
      * Gets the content of a specific chapter of a specific book for a specific Bible commentary.
      * @param commentary The ID of the commentary to get the chapter for.
@@ -127,6 +213,14 @@ export declare class FreeUseBibleApi {
      * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
      */
     getCommentaryBookChapter(commentary: string, book: string, chapter: number | string, endpoint?: string): Promise<ApiTranslationBookChapter>;
+    /**
+     * Gets the content of a specific chapter of a specific book for a specific Bible commentary, using the simplified chapter format.
+     * @param commentary The ID of the commentary to get the chapter for.
+     * @param book The ID of the book to get the chapter for.
+     * @param chapter The chapter number to get.
+     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+     */
+    getSimpleCommentaryBookChapter(commentary: string, book: string, chapter: number | string, endpoint?: string): Promise<ApiSimpleCommentaryBookChapter>;
     /**
      * Gets the content of a specific chapter of a specific book for a specific dataset.
      * @param dataset The ID of the dataset to get the chapter for.
@@ -156,6 +250,20 @@ export declare class FreeUseBibleApi {
      * @returns The next chapter, or null if there is no next chapter.
      */
     getNextChapter(chapter: ApiDatasetBookChapter, endpoint?: string): Promise<ApiDatasetBookChapter | null>;
+    /**
+     * Gets the next chapter for a given chapter, if available.
+     * @param chapter The chapter to get the next chapter for.
+     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+     * @returns The next chapter, or null if there is no next chapter.
+     */
+    getNextChapter(chapter: ApiSimpleCommentaryBookChapter, endpoint?: string): Promise<ApiSimpleCommentaryBookChapter | null>;
+    /**
+     * Gets the next chapter for a given chapter, if available.
+     * @param chapter The chapter to get the next chapter for.
+     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+     * @returns The next chapter, or null if there is no next chapter.
+     */
+    getNextChapter(chapter: ApiSimpleTranslationBookChapter, endpoint?: string): Promise<ApiSimpleTranslationBookChapter | null>;
     /**
      * Gets the previous chapter for a given chapter, if available.
      * @param chapter The chapter to get the previous chapter for.
@@ -177,6 +285,20 @@ export declare class FreeUseBibleApi {
      * @returns The previous chapter, or null if there is no previous chapter.
      */
     getPreviousChapter(chapter: ApiDatasetBookChapter, endpoint?: string): Promise<ApiDatasetBookChapter | null>;
+    /**
+     * Gets the previous chapter for a given chapter, if available.
+     * @param chapter The chapter to get the previous chapter for.
+     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+     * @returns The previous chapter, or null if there is no previous chapter.
+     */
+    getPreviousChapter(chapter: ApiSimpleCommentaryBookChapter, endpoint?: string): Promise<ApiSimpleCommentaryBookChapter | null>;
+    /**
+     * Gets the previous chapter for a given chapter, if available.
+     * @param chapter The chapter to get the previous chapter for.
+     * @param endpoint The API endpoint to use for the request. If not provided, the default endpoint will be used.
+     * @returns The previous chapter, or null if there is no previous chapter.
+     */
+    getPreviousChapter(chapter: ApiSimpleTranslationBookChapter, endpoint?: string): Promise<ApiSimpleTranslationBookChapter | null>;
     /**
      * Gets the first chapter for a given book, if available.
      * @param book The book to get the first chapter for.
@@ -241,6 +363,45 @@ export declare class FreeUseBibleApi {
      * @param options Options for getting the chapter text.
      */
     getChapterVerseText(chapter: ApiTranslationBookChapter, options?: GetChapterTextOptions): string;
+    /**
+     * Gets the verse text for the given simplified chapter.
+     * By default, the returned text includes markers for verse numbers and a reference to the chapter, but these can be omitted by passing options to the `options` parameter.
+     * @param chapter The simplified chapter to get the text for.
+     * @param options Options for getting the chapter text.
+     */
+    getSimpleChapterVerseText(chapter: ApiSimpleTranslationBookChapter, options?: GetChapterTextOptions): string;
+    /**
+     * Gets the text that the given word-level annotation applies to.
+     *
+     * Annotations are anchored to a range of characters in a single item of the verse's content,
+     * so that the ranges stay correct for verses whose content is split into multiple items,
+     * such as poem lines and the words of Jesus.
+     * @param verse The verse that the annotation is in.
+     * @param word The annotation to get the text for.
+     * @returns The annotated text, or an empty string if the annotation doesn't point at any text.
+     */
+    getWordText(verse: ChapterVerse, word: ChapterWord): string;
+    /**
+     * Gets the word-level annotations for the given verse, paired with the text that each one applies to.
+     * @param verse The verse to get the annotations for.
+     * @param words The annotations for the chapter that the verse is in.
+     * @returns The annotations for the verse, in the order that they occur. Empty if the verse has no annotations.
+     */
+    getVerseWords(verse: ChapterVerse, words: ApiTranslationBookChapterWords): AnnotatedWord[];
+    /**
+     * Gets the text that the given simplified word-level annotation applies to.
+     * @param verse The simplified verse that the annotation is in.
+     * @param word The annotation to get the text for.
+     * @returns The annotated text.
+     */
+    getSimpleWordText(verse: SimpleChapterVerse, word: SimpleChapterWord): string;
+    /**
+     * Gets the word-level annotations for the given simplified verse, paired with the text that each one applies to.
+     * @param verse The simplified verse to get the annotations for.
+     * @param words The simplified annotations for the chapter that the verse is in.
+     * @returns The annotations for the verse, in the order that they occur. Empty if the verse has no annotations.
+     */
+    getSimpleVerseWords(verse: SimpleChapterVerse, words: ApiSimpleTranslationBookChapterWords): SimpleAnnotatedWord[];
     private _getJson;
     private _buildUrl;
 }