@youversion/platform-core 1.11.0 → 1.12.1

package/dist/index.js

@@ -152,229 +152,13 @@ var ApiClient = class {
 };
 
 // src/bible.ts
-import { z } from "zod";
-var BibleClient = class {
-  client;
-  // Validation schemas
-  versionIdSchema = z.number().int().positive("Version ID must be a positive integer");
-  bookSchema = z.string().trim().min(3, "Book ID must be exactly 3 characters").max(3, "Book ID must be exactly 3 characters");
-  chapterSchema = z.number().int("Chapter must be an integer").positive("Chapter must be a positive integer");
-  verseSchema = z.number().int("Verse must be an integer").positive("Verse must be a positive integer");
-  languageRangesSchema = z.string().trim().min(1, "Language ranges must be a non-empty string");
-  booleanSchema = z.boolean();
-  /**
-   * Creates a new BibleClient instance.
-   * @param client The API client to use for requests.
-   */
-  constructor(client) {
-    this.client = client;
-  }
-  /**
-   * Fetches a collection of Bible versions filtered by language ranges.
-   *
-   * @param language_ranges - One or more language codes or ranges to filter the versions (required).
-   * @param license_id - Optional license ID to filter versions by license.
-   * @returns A promise that resolves to a collection of BibleVersion objects.
-   */
-  async getVersions(language_ranges, license_id, options) {
-    const languageRangeArray = Array.isArray(language_ranges) ? language_ranges : [language_ranges];
-    const parsedLanguageRanges = z.array(this.languageRangesSchema).nonempty("At least one language range is required").parse(languageRangeArray);
-    const params = {
-      "language_ranges[]": parsedLanguageRanges
-    };
-    if (license_id !== void 0) {
-      params.license_id = license_id;
-    }
-    if (options?.page_size !== void 0) {
-      const pageSizeSchema = z.number().int().positive();
-      pageSizeSchema.parse(options.page_size);
-      params.page_size = options.page_size;
-    }
-    if (options?.page_token !== void 0) {
-      params.page_token = options.page_token;
-    }
-    return this.client.get(`/v1/bibles`, params);
-  }
-  /**
-   * Fetches a Bible version by its ID.
-   * @param id The version ID.
-   * @returns The requested BibleVersion object.
-   */
-  async getVersion(id) {
-    this.versionIdSchema.parse(id);
-    return this.client.get(`/v1/bibles/${id}`);
-  }
-  /**
-   * Fetches all books for a given Bible version.
-   * @param versionId The version ID.
-   * @param canon Optional canon filter ("old_testament", 'new_testament', 'deuterocanon').
-   * @returns An array of BibleBook objects. Each book may include an optional `intro` field
-   *          containing metadata (id, passage_id, title) for the book's introduction when
-   *          available in the Bible version.
-   */
-  async getBooks(versionId, canon) {
-    this.versionIdSchema.parse(versionId);
-    return this.client.get(`/v1/bibles/${versionId}/books`, {
-      ...canon && { canon }
-    });
-  }
-  /**
-   * Fetches a specific book by USFM code for a given version.
-   * @param versionId The version ID.
-   * @param book The Book Identifier code of the book.
-   * @returns The requested BibleBook object, which may include an optional `intro` field
-   *          containing metadata (id, passage_id, title) for the book's introduction when
-   *          available. Use the `passage_id` with `getPassage()` to fetch intro content.
-   */
-  async getBook(versionId, book) {
-    this.versionIdSchema.parse(versionId);
-    this.bookSchema.parse(book);
-    return this.client.get(`/v1/bibles/${versionId}/books/${book}`);
-  }
-  /**
-   * Fetches all chapters for a specific book in a version.
-   * @param versionId The version ID.
-   * @param book The Book Identifier code of the book.
-   * @returns An array of BibleChapter objects.
-   */
-  async getChapters(versionId, book) {
-    this.versionIdSchema.parse(versionId);
-    this.bookSchema.parse(book);
-    return this.client.get(
-      `/v1/bibles/${versionId}/books/${book}/chapters`
-    );
-  }
-  /**
-   * Fetches a specific chapter for a book in a version.
-   * @param versionId The version ID.
-   * @param book The Book Identifier code of the book (3 characters, e.g., "MAT").
-   * @param chapter The chapter number
-   * @returns The requested BibleChapter object.
-   */
-  async getChapter(versionId, book, chapter) {
-    this.versionIdSchema.parse(versionId);
-    this.bookSchema.parse(book);
-    this.chapterSchema.parse(chapter);
-    return this.client.get(
-      `/v1/bibles/${versionId}/books/${book}/chapters/${chapter}`
-    );
-  }
-  /**
-   * Fetches all verses for a specific chapter in a book and version.
-   * @param versionId The version ID.
-   * @param book The Book Identifier code of the book (3 characters, e.g., "MAT").
-   * @param chapter The chapter number.
-   * @returns An array of BibleVerse objects.
-   */
-  async getVerses(versionId, book, chapter) {
-    this.versionIdSchema.parse(versionId);
-    this.bookSchema.parse(book);
-    this.chapterSchema.parse(chapter);
-    return this.client.get(
-      `/v1/bibles/${versionId}/books/${book}/chapters/${chapter}/verses`
-    );
-  }
-  /**
-   * Fetches a specific verse from a chapter, book, and version.
-   * @param versionId The version ID.
-   * @param book The Book Identifier code of the book (3 characters, e.g., "MAT").
-   * @param chapter The chapter number.
-   * @param verse The verse number.
-   * @returns The requested BibleVerse object.
-   */
-  async getVerse(versionId, book, chapter, verse) {
-    this.versionIdSchema.parse(versionId);
-    this.bookSchema.parse(book);
-    this.chapterSchema.parse(chapter);
-    this.verseSchema.parse(verse);
-    return this.client.get(
-      `/v1/bibles/${versionId}/books/${book}/chapters/${chapter}/verses/${verse}`
-    );
-  }
-  /**
-   * Fetches a passage (range of verses) from the Bible using the passages endpoint.
-   * This is the new API format that returns HTML-formatted content.
-   * @param versionId The version ID.
-   * @param usfm The USFM reference (e.g., "JHN.3.1-2", "GEN.1", "JHN.3.16").
-   * @param format The format to return ("html" or "text", default: "html").
-   * @param include_headings Whether to include headings in the content.
-   * @param include_notes Whether to include notes in the content.
-   * @returns The requested BiblePassage object with HTML content.
-   * @example
-   * ```ts
-   * // Get a single verse
-   * const verse = await bibleClient.getPassage(111, "JHN.3.16");
-   *
-   * // Get a range of verses
-   * const verses = await bibleClient.getPassage(111, "JHN.3.1-5");
-   *
-   * // Get an entire chapter
-   * const chapter = await bibleClient.getPassage(111, "GEN.1");
-   * ```
-   */
-  async getPassage(versionId, usfm, format = "html", include_headings, include_notes) {
-    this.versionIdSchema.parse(versionId);
-    if (include_headings !== void 0) {
-      this.booleanSchema.parse(include_headings);
-    }
-    if (include_notes !== void 0) {
-      this.booleanSchema.parse(include_notes);
-    }
-    const params = {
-      format
-    };
-    if (include_headings !== void 0) {
-      params.include_headings = include_headings;
-    }
-    if (include_notes !== void 0) {
-      params.include_notes = include_notes;
-    }
-    return this.client.get(`/v1/bibles/${versionId}/passages/${usfm}`, params);
-  }
-  /**
-   * Fetches the indexing structure for a Bible version.
-   * @param versionId The version ID.
-   * @returns The BibleIndex object containing full hierarchy of books, chapters, and verses.
-   */
-  async getIndex(versionId) {
-    this.versionIdSchema.parse(versionId);
-    return this.client.get(`/v1/bibles/${versionId}/index`);
-  }
-  /**
-   * Fetches the verse of the day calendar for an entire year.
-   * @returns A collection of VOTD objects for all days of the year.
-   */
-  async getAllVOTDs() {
-    return this.client.get(`/v1/verse_of_the_days`);
-  }
-  /**
-   * Fetches the passage_id for the Verse Of The Day.
-   * @param day The day of the year (1-366).
-   * @returns The day of the year and the passage_id for that day of the year
-   * @example
-   * ```ts
-   * // Get the passageId for the verse of the first day of the year.
-   * const passageId = await bibleClient.getVOTD(1);
-   *
-   * // Get the passageId for the verse of the 100th day of the year.
-   * const passageId = await bibleClient.getVOTD(100);
-   * ```
-   */
-  async getVOTD(day) {
-    const daySchema = z.number().int().min(1).max(366);
-    daySchema.parse(day);
-    return this.client.get(`/v1/verse_of_the_days/${day}`);
-  }
-};
-
-// src/languages.ts
-import { z as z13 } from "zod";
+import { z as z12 } from "zod";
 
 // src/schemas/bible-index.ts
-import { z as z5 } from "zod";
+import { z as z4 } from "zod";
 
 // src/schemas/book.ts
-import { z as z4 } from "zod";
+import { z as z3 } from "zod";
 
 // src/utils/constants.ts
 var BOOK_IDS = [
@@ -592,212 +376,450 @@ var BOOK_CANON = {
 };
 
 // src/schemas/chapter.ts
-import { z as z3 } from "zod";
+import { z as z2 } from "zod";
 
 // src/schemas/verse.ts
-import { z as z2 } from "zod";
-var BibleVerseSchema = z2.object({
+import { z } from "zod";
+var BibleVerseSchema = z.object({
   /** Verse identifier (e.g., "1") */
-  id: z2.string(),
+  id: z.string(),
   /** Passage identifier (e.g., "MAT.1.1") */
-  passage_id: z2.string(),
+  passage_id: z.string(),
   /** Verse Number (e.g., "1") */
-  title: z2.string()
+  title: z.string()
 });
 
 // src/schemas/chapter.ts
-var BibleChapterSchema = z3.object({
+var BibleChapterSchema = z2.object({
   /** Chapter identifier (e.g., "1") */
-  id: z3.string(),
+  id: z2.string(),
   /** Passage identifier (e.g., "MAT.1") */
-  passage_id: z3.string(),
+  passage_id: z2.string(),
   /** Chapter title (e.g., "1") */
-  title: z3.string(),
+  title: z2.string(),
   /** Array of verses */
-  verses: z3.array(BibleVerseSchema).optional()
+  verses: z2.array(BibleVerseSchema).optional()
 });
 
 // src/schemas/book.ts
-var CanonSchema = z4.enum(["old_testament", "new_testament", "deuterocanon"]);
-var BibleBookIntroSchema = z4.object({
+var CanonSchema = z3.enum(["old_testament", "new_testament", "deuterocanon"]);
+var BibleBookIntroSchema = z3.object({
   /** Intro identifier */
-  id: z4.string(),
+  id: z3.string(),
   /** Intro passage identifier */
-  passage_id: z4.string(),
+  passage_id: z3.string(),
   /** Intro title */
-  title: z4.string()
+  title: z3.string()
 });
-var BookUsfmSchema = z4.union([
-  ...BOOK_IDS.map((id) => z4.literal(id)),
-  z4.string().length(3)
+var BookUsfmSchema = z3.union([
+  ...BOOK_IDS.map((id) => z3.literal(id)),
+  z3.string().length(3)
 ]);
-var BibleBookSchema = z4.object({
+var BibleBookSchema = z3.object({
   /** Book identifier (e.g., "MAT") */
   id: BookUsfmSchema,
   /** Book title (e.g., "Genesis") */
-  title: z4.string(),
+  title: z3.string(),
   /** Full Book title (e.g., "The First Book of Moses, Commonly Called Genesis") */
-  full_title: z4.string(),
+  full_title: z3.string(),
   /** Book abbreviation (e.g., "Gen") */
-  abbreviation: z4.string().optional(),
+  abbreviation: z3.string().optional(),
   /** Canonical section (new_testament, old_testament, deuterocanon) */
   canon: CanonSchema,
   /** Intro metadata (optional) */
   intro: BibleBookIntroSchema.optional(),
   /** Array of chapter identifiers (e.g., ["GEN.1", "GEN.2", "GEN.3"]) */
-  chapters: z4.array(BibleChapterSchema).optional()
+  chapters: z3.array(BibleChapterSchema).optional()
 });
 
 // src/schemas/bible-index.ts
-var BibleIndexVerseSchema = z5.object({
+var BibleIndexVerseSchema = z4.object({
   /** Verse identifier */
-  id: z5.string(),
+  id: z4.string(),
   /** Verse title */
-  title: z5.string()
+  title: z4.string()
 });
-var BibleIndexChapterSchema = z5.object({
+var BibleIndexChapterSchema = z4.object({
   /** Chapter identifier */
-  id: z5.string(),
+  id: z4.string(),
   /** Chapter title */
-  title: z5.string(),
+  title: z4.string(),
   /** Array of verses in this chapter */
-  verses: z5.array(BibleIndexVerseSchema)
+  verses: z4.array(BibleIndexVerseSchema)
 });
-var BibleIndexBookSchema = z5.object({
+var BibleIndexBookSchema = z4.object({
   /** Book identifier */
   id: BookUsfmSchema,
   /** Book title */
-  title: z5.string(),
+  title: z4.string(),
   /** Full book title */
-  full_title: z5.string(),
+  full_title: z4.string(),
   /** Book abbreviation */
-  abbreviation: z5.string(),
+  abbreviation: z4.string(),
   /** Canonical section */
   canon: CanonSchema,
   /** Array of chapters in this book */
-  chapters: z5.array(BibleIndexChapterSchema)
+  chapters: z4.array(BibleIndexChapterSchema)
 });
-var _BibleIndexSchema = z5.object({
+var _BibleIndexSchema = z4.object({
   /** Text direction (e.g., "ltr") */
-  text_direction: z5.string(),
+  text_direction: z4.string(),
   /** Array of books with chapters and verses */
-  books: z5.array(BibleIndexBookSchema)
+  books: z4.array(BibleIndexBookSchema)
 });
 
 // src/schemas/collection.ts
-import { z as z6 } from "zod";
+import { z as z5 } from "zod";
 
 // src/schemas/highlight.ts
-import { z as z7 } from "zod";
-var _HighlightSchema = z7.object({
+import { z as z6 } from "zod";
+var _HighlightSchema = z6.object({
   /** Bible version identifier */
-  version_id: z7.number().int().positive(),
+  version_id: z6.number().int().positive(),
   /** Passage identifier (e.g., "MAT.1.1") */
-  passage_id: z7.string(),
+  passage_id: z6.string(),
   /** Hex color code (6 digits, no #) */
-  color: z7.string().regex(/^[0-9a-f]{6}$/)
+  color: z6.string().regex(/^[0-9a-f]{6}$/)
 });
-var _CreateHighlightSchema = z7.object({
+var _CreateHighlightSchema = z6.object({
   /** Bible version identifier */
-  version_id: z7.number().int().positive(),
+  version_id: z6.number().int().positive(),
   /** Passage identifier (e.g., "MAT.1.1") */
-  passage_id: z7.string(),
+  passage_id: z6.string(),
   /** Hex color code (6 digits, no #) */
-  color: z7.string().regex(/^[0-9a-f]{6}$/)
+  color: z6.string().regex(/^[0-9a-f]{6}$/)
 });
 
 // src/schemas/language.ts
-import { z as z8 } from "zod";
-var LanguageSchema = z8.object({
+import { z as z7 } from "zod";
+var LanguageSchema = z7.object({
   /** BCP 47 language identifier (e.g., "en") */
-  id: z8.string().regex(/^[a-z]{2,3}(?:-[A-Z][a-z]{3})?$/, "BCP 47 id limited to language or language+script"),
+  id: z7.string().regex(/^[a-z]{2,3}(?:-[A-Z][a-z]{3})?$/, "BCP 47 id limited to language or language+script"),
   /** ISO 639 language code */
-  language: z8.string().regex(/^[a-z]{2,3}$/, "ISO 639 canonical language subtag"),
+  language: z7.string().regex(/^[a-z]{2,3}$/, "ISO 639 canonical language subtag"),
   /** ISO 15924 script code (e.g., "Latn") */
-  script: z8.string().regex(/^[A-Z][a-z]{3}$/, 'Script must match ISO 15924 format (e.g., "Latn")').nullable().optional(),
+  script: z7.string().regex(/^[A-Z][a-z]{3}$/, 'Script must match ISO 15924 format (e.g., "Latn")').nullable().optional(),
   /** Script name (e.g., "Latin") */
-  script_name: z8.string().nullable().optional(),
+  script_name: z7.string().nullable().optional(),
   /** Language aliases */
-  aliases: z8.array(z8.string()).optional(),
+  aliases: z7.array(z7.string()).optional(),
   /** Display names for different locales */
-  display_names: z8.record(z8.string(), z8.string()).optional(),
+  display_names: z7.record(z7.string(), z7.string()).optional(),
   /** Available scripts for this language (e.g., ["Cyrl", "Latn"]) */
-  scripts: z8.array(z8.string().regex(/^[A-Z][a-z]{3}$/, "ISO 15924 script code")).optional(),
+  scripts: z7.array(z7.string().regex(/^[A-Z][a-z]{3}$/, "ISO 15924 script code")).optional(),
   /** Language variants (e.g., ["1996", "fonipa"]) */
-  variants: z8.array(z8.string()).optional(),
+  variants: z7.array(z7.string()).optional(),
   /** ISO 3166-1 alpha-2 country codes (e.g., ["RS", "BA", "ME"]) */
-  countries: z8.array(z8.string().regex(/^[A-Z]{2}$/, "ISO 3166-1 alpha-2 country code")).optional(),
+  countries: z7.array(z7.string().regex(/^[A-Z]{2}$/, "ISO 3166-1 alpha-2 country code")).optional(),
   /** Text direction (ltr or rtl) */
-  text_direction: z8.enum(["ltr", "rtl"]).optional(),
+  text_direction: z7.enum(["ltr", "rtl"]).optional(),
   /** Writing population count */
-  writing_population: z8.number().int().optional(),
+  writing_population: z7.number().int().optional(),
   /** Speaking population count */
-  speaking_population: z8.number().int().optional(),
+  speaking_population: z7.number().int().optional(),
   /** Default Bible version ID for this language */
-  default_bible_id: z8.number().int().nullable().optional()
+  default_bible_id: z7.number().int().nullable().optional()
 });
 
 // src/schemas/passage.ts
-import { z as z9 } from "zod";
-var BiblePassageSchema = z9.object({
+import { z as z8 } from "zod";
+var BiblePassageSchema = z8.object({
   /** Passage identifier (e.g., "MAT.1.1") */
-  id: z9.string(),
+  id: z8.string(),
   /** Passage content text */
-  content: z9.string(),
+  content: z8.string(),
   /** Human-readable reference (e.g., "Matthew 1:1") */
-  reference: z9.string()
+  reference: z8.string()
 });
 
 // src/schemas/version.ts
-import { z as z10 } from "zod";
-var BibleVersionSchema = z10.object({
+import { z as z9 } from "zod";
+var BibleVersionSchema = z9.object({
   /** Bible version identifier */
-  id: z10.number().int(),
+  id: z9.number().int(),
   /** Bible version abbreviation */
-  abbreviation: z10.string(),
+  abbreviation: z9.string(),
   /** Long copyright text */
-  promotional_content: z10.string().nullable().optional(),
+  promotional_content: z9.string().nullable().optional(),
   /** Short copyright text */
-  copyright: z10.string().nullable().optional(),
+  copyright: z9.string().nullable().optional(),
   /** Bible information text */
-  info: z10.string().nullable().optional(),
+  info: z9.string().nullable().optional(),
   /** Publisher URL */
-  publisher_url: z10.url().nullable().optional(),
+  publisher_url: z9.url().nullable().optional(),
   /** Language tag (e.g., "en") */
-  language_tag: z10.string(),
+  language_tag: z9.string(),
   /** Localized abbreviation */
-  localized_abbreviation: z10.string(),
+  localized_abbreviation: z9.string(),
   /** Localized title */
-  localized_title: z10.string(),
+  localized_title: z9.string(),
   /** Organization ID of publisher */
-  organization_id: z10.string().nullable().optional(),
+  organization_id: z9.string().nullable().optional(),
   /** Full title */
-  title: z10.string(),
+  title: z9.string(),
   /** Array of book identifiers (e.g., ["GEN", "EXO", "LEV"]) */
-  books: z10.array(BookUsfmSchema),
+  books: z9.array(BookUsfmSchema),
   /** YouVersion deep link URL */
-  youversion_deep_link: z10.url()
+  youversion_deep_link: z9.url()
 });
 
 // src/schemas/votd.ts
-import { z as z11 } from "zod";
-var VOTDSchema = z11.object({
+import { z as z10 } from "zod";
+var VOTDSchema = z10.object({
   /** Day of year (1-366) */
-  day: z11.number().int().min(1).max(366),
+  day: z10.number().int().min(1).max(366),
   /** Passage identifier (e.g., "JHN.3.16") */
-  passage_id: z11.string()
+  passage_id: z10.string()
 });
 
 // src/schemas/user.ts
-import { z as z12 } from "zod";
-var _UserSchema = z12.object({
-  avatar_url: z12.string(),
-  first_name: z12.string(),
-  id: z12.uuid(),
-  last_name: z12.string()
+import { z as z11 } from "zod";
+var _UserSchema = z11.object({
+  avatar_url: z11.string(),
+  first_name: z11.string(),
+  id: z11.uuid(),
+  last_name: z11.string()
 });
 
+// src/bible.ts
+var BibleClient = class _BibleClient {
+  client;
+  // Validation schemas
+  static versionIdSchema = z12.number().int().positive("Version ID must be a positive integer");
+  static bookSchema = z12.string().trim().min(3, "Book ID must be exactly 3 characters").max(3, "Book ID must be exactly 3 characters");
+  static chapterSchema = z12.number().int("Chapter must be an integer").positive("Chapter must be a positive integer");
+  static verseSchema = z12.number().int("Verse must be an integer").positive("Verse must be a positive integer");
+  static languageRangesSchema = z12.string().trim().min(1, "Language ranges must be a non-empty string");
+  static booleanSchema = z12.boolean();
+  static GetVersionsOptionsSchema = z12.object({
+    page_size: z12.union([z12.number().int().positive(), z12.literal("*")]).optional(),
+    page_token: z12.string().optional(),
+    fields: z12.array(BibleVersionSchema.keyof()).optional(),
+    all_available: z12.boolean().optional()
+  }).optional().refine(
+    (data) => {
+      if (data?.page_size === "*") {
+        return data.fields && data.fields.length >= 1 && data.fields.length <= 3;
+      }
+      return true;
+    },
+    {
+      message: 'page_size="*" required 1-3 fields to be specified',
+      path: ["page_size", "fields"]
+    }
+  );
+  /**
+   * Creates a new BibleClient instance.
+   * @param client The API client to use for requests.
+   */
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Fetches a collection of Bible versions filtered by language ranges.
+   *
+   * @param language_ranges - One or more language codes or ranges to filter the versions (required).
+   * @param license_id - Optional license ID to filter versions by license.
+   * @returns A promise that resolves to a collection of BibleVersion objects.
+   */
+  async getVersions(language_ranges, license_id, options) {
+    const languageRangeArray = Array.isArray(language_ranges) ? language_ranges : [language_ranges];
+    const parsedLanguageRanges = z12.array(_BibleClient.languageRangesSchema).nonempty("At least one language range is required").parse(languageRangeArray);
+    const params = {
+      "language_ranges[]": parsedLanguageRanges
+    };
+    if (license_id) {
+      params.license_id = license_id;
+    }
+    _BibleClient.GetVersionsOptionsSchema.parse(options);
+    if (options?.page_size) {
+      params.page_size = options.page_size;
+    }
+    if (options?.fields) {
+      params["fields[]"] = options.fields;
+    }
+    if (options?.page_token) {
+      params.page_token = options.page_token;
+    }
+    if (options?.all_available) {
+      params.all_available = "true";
+    }
+    return this.client.get(`/v1/bibles`, params);
+  }
+  /**
+   * Fetches a Bible version by its ID.
+   * @param id The version ID.
+   * @returns The requested BibleVersion object.
+   */
+  async getVersion(id) {
+    _BibleClient.versionIdSchema.parse(id);
+    return this.client.get(`/v1/bibles/${id}`);
+  }
+  /**
+   * Fetches all books for a given Bible version.
+   * @param versionId The version ID.
+   * @param canon Optional canon filter ("old_testament", 'new_testament', 'deuterocanon').
+   * @returns An array of BibleBook objects. Each book may include an optional `intro` field
+   *          containing metadata (id, passage_id, title) for the book's introduction when
+   *          available in the Bible version.
+   */
+  async getBooks(versionId, canon) {
+    _BibleClient.versionIdSchema.parse(versionId);
+    return this.client.get(`/v1/bibles/${versionId}/books`, {
+      ...canon && { canon }
+    });
+  }
+  /**
+   * Fetches a specific book by USFM code for a given version.
+   * @param versionId The version ID.
+   * @param book The Book Identifier code of the book.
+   * @returns The requested BibleBook object, which may include an optional `intro` field
+   *          containing metadata (id, passage_id, title) for the book's introduction when
+   *          available. Use the `passage_id` with `getPassage()` to fetch intro content.
+   */
+  async getBook(versionId, book) {
+    _BibleClient.versionIdSchema.parse(versionId);
+    _BibleClient.bookSchema.parse(book);
+    return this.client.get(`/v1/bibles/${versionId}/books/${book}`);
+  }
+  /**
+   * Fetches all chapters for a specific book in a version.
+   * @param versionId The version ID.
+   * @param book The Book Identifier code of the book.
+   * @returns An array of BibleChapter objects.
+   */
+  async getChapters(versionId, book) {
+    _BibleClient.versionIdSchema.parse(versionId);
+    _BibleClient.bookSchema.parse(book);
+    return this.client.get(
+      `/v1/bibles/${versionId}/books/${book}/chapters`
+    );
+  }
+  /**
+   * Fetches a specific chapter for a book in a version.
+   * @param versionId The version ID.
+   * @param book The Book Identifier code of the book (3 characters, e.g., "MAT").
+   * @param chapter The chapter number
+   * @returns The requested BibleChapter object.
+   */
+  async getChapter(versionId, book, chapter) {
+    _BibleClient.versionIdSchema.parse(versionId);
+    _BibleClient.bookSchema.parse(book);
+    _BibleClient.chapterSchema.parse(chapter);
+    return this.client.get(
+      `/v1/bibles/${versionId}/books/${book}/chapters/${chapter}`
+    );
+  }
+  /**
+   * Fetches all verses for a specific chapter in a book and version.
+   * @param versionId The version ID.
+   * @param book The Book Identifier code of the book (3 characters, e.g., "MAT").
+   * @param chapter The chapter number.
+   * @returns An array of BibleVerse objects.
+   */
+  async getVerses(versionId, book, chapter) {
+    _BibleClient.versionIdSchema.parse(versionId);
+    _BibleClient.bookSchema.parse(book);
+    _BibleClient.chapterSchema.parse(chapter);
+    return this.client.get(
+      `/v1/bibles/${versionId}/books/${book}/chapters/${chapter}/verses`
+    );
+  }
+  /**
+   * Fetches a specific verse from a chapter, book, and version.
+   * @param versionId The version ID.
+   * @param book The Book Identifier code of the book (3 characters, e.g., "MAT").
+   * @param chapter The chapter number.
+   * @param verse The verse number.
+   * @returns The requested BibleVerse object.
+   */
+  async getVerse(versionId, book, chapter, verse) {
+    _BibleClient.versionIdSchema.parse(versionId);
+    _BibleClient.bookSchema.parse(book);
+    _BibleClient.chapterSchema.parse(chapter);
+    _BibleClient.verseSchema.parse(verse);
+    return this.client.get(
+      `/v1/bibles/${versionId}/books/${book}/chapters/${chapter}/verses/${verse}`
+    );
+  }
+  /**
+   * Fetches a passage (range of verses) from the Bible using the passages endpoint.
+   * This is the new API format that returns HTML-formatted content.
+   * @param versionId The version ID.
+   * @param usfm The USFM reference (e.g., "JHN.3.1-2", "GEN.1", "JHN.3.16").
+   * @param format The format to return ("html" or "text", default: "html").
+   * @param include_headings Whether to include headings in the content.
+   * @param include_notes Whether to include notes in the content.
+   * @returns The requested BiblePassage object with HTML content.
+   * @example
+   * ```ts
+   * // Get a single verse
+   * const verse = await bibleClient.getPassage(111, "JHN.3.16");
+   *
+   * // Get a range of verses
+   * const verses = await bibleClient.getPassage(111, "JHN.3.1-5");
+   *
+   * // Get an entire chapter
+   * const chapter = await bibleClient.getPassage(111, "GEN.1");
+   * ```
+   */
+  async getPassage(versionId, usfm, format = "html", include_headings, include_notes) {
+    _BibleClient.versionIdSchema.parse(versionId);
+    if (include_headings !== void 0) {
+      _BibleClient.booleanSchema.parse(include_headings);
+    }
+    if (include_notes !== void 0) {
+      _BibleClient.booleanSchema.parse(include_notes);
+    }
+    const params = {
+      format
+    };
+    if (include_headings !== void 0) {
+      params.include_headings = include_headings;
+    }
+    if (include_notes !== void 0) {
+      params.include_notes = include_notes;
+    }
+    return this.client.get(`/v1/bibles/${versionId}/passages/${usfm}`, params);
+  }
+  /**
+   * Fetches the indexing structure for a Bible version.
+   * @param versionId The version ID.
+   * @returns The BibleIndex object containing full hierarchy of books, chapters, and verses.
+   */
+  async getIndex(versionId) {
+    _BibleClient.versionIdSchema.parse(versionId);
+    return this.client.get(`/v1/bibles/${versionId}/index`);
+  }
+  /**
+   * Fetches the verse of the day calendar for an entire year.
+   * @returns A collection of VOTD objects for all days of the year.
+   */
+  async getAllVOTDs() {
+    return this.client.get(`/v1/verse_of_the_days`);
+  }
+  /**
+   * Fetches the passage_id for the Verse Of The Day.
+   * @param day The day of the year (1-366).
+   * @returns The day of the year and the passage_id for that day of the year
+   * @example
+   * ```ts
+   * // Get the passageId for the verse of the first day of the year.
+   * const passageId = await bibleClient.getVOTD(1);
+   *
+   * // Get the passageId for the verse of the 100th day of the year.
+   * const passageId = await bibleClient.getVOTD(100);
+   * ```
+   */
+  async getVOTD(day) {
+    const daySchema = z12.number().int().min(1).max(366);
+    daySchema.parse(day);
+    return this.client.get(`/v1/verse_of_the_days/${day}`);
+  }
+};
+
 // src/languages.ts
+import { z as z13 } from "zod";
 var LanguagesClient = class _LanguagesClient {
   client;
   static languageIdSchema = z13.string().trim().min(1, "Language ID must be a non-empty string").regex(