pnpm add @youversion/platform-core

import { ApiClient, BibleClient } from '@youversion/platform-core';

// Initialize the API client
const apiClient = new ApiClient({
  appKey: 'YOUR_APP_KEY',
  apiHost: 'api.youversion.com', // optional
  timeout: 10000, // optional, defaults to 10000ms
});

// Create specialized clients
const bibleClient = new BibleClient(apiClient);

// Fetch Bible versions in English
const versions = await bibleClient.getVersions('en*');
console.log(versions.data[0].title);

// Get John 3:16
const passage = await bibleClient.getPassage(
  versions.data[0].id,
  'JHN.3.16'
);
console.log(passage.content);

ApiClient (HTTP layer)
   ├── BibleClient (Bible data operations)
   ├── LanguagesClient (Language data)
   └── HighlightsClient (User highlights)

import type { BibleVersion, BiblePassage, Collection } from '@youversion/platform-core';

// Collection type for paginated responses
const versions: Collection<BibleVersion> = await bibleClient.getVersions('en*');

// Iterate with full type safety
versions.data.forEach((version: BibleVersion) => {
  console.log(version.title, version.language_tag);
});

// BiblePassage type
const passage: BiblePassage = await bibleClient.getPassage(1, 'JHN.3.16');
console.log(passage.reference, passage.content);

try {
  const passage = await bibleClient.getPassage(9999, 'INVALID.1.1');
} catch (error) {
  if (error instanceof Error) {
    console.error(error.message);
    // Error objects include HTTP status if available
    const httpError = error as Error & { status?: number; statusText?: string };
    console.error(`Status: ${httpError.status} ${httpError.statusText}`);
  }
}

import { getAdjacentChapter } from '@youversion/platform-core';

// Get next chapter
const next = getAdjacentChapter(
  books,           // Array of BibleBook with populated chapters
  'JHN',           // Current book USFM ID
  '3',             // Current chapter ID
  'next'           // Direction: 'next' | 'previous'
);

if (next) {
  console.log(`Next: ${next.bookId} ${next.chapterId}`);
  // Navigate to next.bookId and next.chapterId
}

// Get previous chapter
const prev = getAdjacentChapter(books, 'JHN', '3', 'previous');