@youversion/platform-core 1.3.0 → 1.5.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @youversion/platform-core@1.3.0 build /home/runner/work/platform-sdk-react/platform-sdk-react/packages/core
+> @youversion/platform-core@1.5.0 build /home/runner/work/platform-sdk-react/platform-sdk-react/packages/core
 > tsup src/index.ts --format cjs,esm --dts
 
 CLI Building entry: src/index.ts
@@ -8,11 +8,11 @@
 CLI Target: es2022
 CJS Build start
 ESM Build start
-ESM dist/index.js 41.47 KB
-ESM ⚡️ Build success in 34ms
-CJS dist/index.cjs 43.29 KB
-CJS ⚡️ Build success in 35ms
+ESM dist/index.js 41.76 KB
+ESM ⚡️ Build success in 39ms
+CJS dist/index.cjs 43.59 KB
+CJS ⚡️ Build success in 40ms
 DTS Build start
-DTS ⚡️ Build success in 1804ms
-DTS dist/index.d.cts 32.84 KB
-DTS dist/index.d.ts  32.84 KB
+DTS ⚡️ Build success in 1818ms
+DTS dist/index.d.cts 32.92 KB
+DTS dist/index.d.ts  32.92 KB

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @youversion/platform-core
 
+## 1.5.0
+
+### Minor Changes
+
+- 6ff47de: feat(core): add pagination to the getVersions endpoint
+  - update tests to ensure that proper amount of responses are returned
+    based on the page_size query param.
+  - add the ability to specify a page_size to fetch a specific number of
+    items at a time.
+
+## 1.4.0
+
+### Minor Changes
+
+- 8275a27: feat(ui): add bible reader settings
+  - refactor popover component to have consistent styling across
+    multiple components and reduce duplication in code.
+  - add bible reader settings and save the users settings to localStorage.
+
 ## 1.3.0
 
 ### Minor Changes

package/dist/index.cjs

@@ -215,7 +215,7 @@ var BibleClient = class {
    * @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) {
+  async getVersions(language_ranges, license_id, options) {
     const languageRangeArray = Array.isArray(language_ranges) ? language_ranges : [language_ranges];
     const parsedLanguageRanges = import_zod.z.array(this.languageRangesSchema).nonempty("At least one language range is required").parse(languageRangeArray);
     const params = {
@@ -224,6 +224,14 @@ var BibleClient = class {
     if (license_id !== void 0) {
       params.license_id = license_id;
     }
+    if (options?.page_size !== void 0) {
+      const pageSizeSchema = import_zod.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);
   }
   /**

package/dist/index.d.cts

@@ -338,7 +338,10 @@ declare class BibleClient {
      * @param license_id - Optional license ID to filter versions by license.
      * @returns A promise that resolves to a collection of BibleVersion objects.
      */
-    getVersions(language_ranges: string | string[], license_id?: string | number): Promise<Collection<BibleVersion>>;
+    getVersions(language_ranges: string | string[], license_id?: string | number, options?: {
+        page_size?: number;
+        page_token?: string;
+    }): Promise<Collection<BibleVersion>>;
     /**
      * Fetches a Bible version by its ID.
      * @param id The version ID.

package/dist/index.d.ts

@@ -338,7 +338,10 @@ declare class BibleClient {
      * @param license_id - Optional license ID to filter versions by license.
      * @returns A promise that resolves to a collection of BibleVersion objects.
      */
-    getVersions(language_ranges: string | string[], license_id?: string | number): Promise<Collection<BibleVersion>>;
+    getVersions(language_ranges: string | string[], license_id?: string | number, options?: {
+        page_size?: number;
+        page_token?: string;
+    }): Promise<Collection<BibleVersion>>;
     /**
      * Fetches a Bible version by its ID.
      * @param id The version ID.

package/dist/index.js

@@ -176,7 +176,7 @@ var BibleClient = class {
    * @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) {
+  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 = {
@@ -185,6 +185,14 @@ var BibleClient = class {
     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);
   }
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youversion/platform-core",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "type": "module",
   "publishConfig": {
     "access": "public",

package/src/__tests__/MockBibles.ts

@@ -4,8 +4,8 @@ const baseBibleBooks = [
   {
     id: 'GEN',
     title: 'Genesis',
-    full_title: 'The First Book of Moses, Called Genesis',
-    abbreviation: 'Gen',
+    full_title: 'Genesis',
+    abbreviation: 'Gen.',
     canon: 'old_testament',
     chapters: mockGenesisChapters,
   },

package/src/__tests__/bible.test.ts

@@ -27,6 +27,27 @@ describe('BibleClient', () => {
   });
 
   describe('getVersions', () => {
+    it('should fetch number of Bible versions specified by page_size param', async () => {
+      const versions = await bibleClient.getVersions('en*', undefined, { page_size: 11 });
+
+      expect(versions.data.length).toEqual(11);
+    });
+
+    it('should fetch next page using page_token from first response', async () => {
+      const firstPage = await bibleClient.getVersions('en*', undefined, { page_size: 5 });
+
+      expect(firstPage.data.length).toEqual(5);
+      expect(firstPage.next_page_token).toBeDefined();
+
+      const secondPage = await bibleClient.getVersions('en*', undefined, {
+        page_size: 5,
+        page_token: firstPage.next_page_token!,
+      });
+
+      expect(secondPage.data.length).toEqual(5);
+      expect(secondPage.data[0]?.id).not.toEqual(firstPage.data[0]?.id);
+    });
+
     it('should fetch Bible versions with language ranges', async () => {
       const versions = await bibleClient.getVersions('en*');
 
@@ -117,7 +138,7 @@ describe('BibleClient', () => {
 
   describe('getBooks', () => {
     it('should fetch all books for a version', async () => {
-      const books = await bibleClient.getBooks(1);
+      const books = await bibleClient.getBooks(111);
 
       const { success } = BibleBookSchema.safeParse(books.data[0]);
       expect(success).toBe(true);
@@ -125,8 +146,8 @@ describe('BibleClient', () => {
       expect(books.data).toHaveLength(66);
       expect(books.data[0]).toHaveProperty('id', 'GEN');
       expect(books.data[0]).toHaveProperty('title', 'Genesis');
-      expect(books.data[0]).toHaveProperty('full_title', 'The First Book of Moses, Called Genesis');
-      expect(books.data[0]).toHaveProperty('abbreviation', 'Gen');
+      expect(books.data[0]).toHaveProperty('full_title', 'Genesis');
+      expect(books.data[0]).toHaveProperty('abbreviation', 'Gen.');
       expect(books.data[0]?.intro).toEqual({
         id: 'INTRO',
         passage_id: 'GEN.INTRO',
@@ -139,7 +160,7 @@ describe('BibleClient', () => {
 
   describe('getBook', () => {
     it('should fetch a specific book', async () => {
-      const book = await bibleClient.getBook(1, 'GEN');
+      const book = await bibleClient.getBook(111, 'GEN');
 
       const { success } = BibleBookSchema.safeParse(book);
       expect(success).toBe(true);
@@ -147,7 +168,7 @@ describe('BibleClient', () => {
       expect(book.chapters).toHaveLength(50);
       expect(book).toHaveProperty('id', 'GEN');
       expect(book).toHaveProperty('title', 'Genesis');
-      expect(book).toHaveProperty('abbreviation', 'Gen');
+      expect(book).toHaveProperty('abbreviation', 'Gen.');
       expect(book).toHaveProperty('intro');
       expect(book.intro).toEqual({
         id: 'INTRO',

package/src/__tests__/handlers.ts

@@ -106,11 +106,32 @@ export const handlers = [
   }),
 
   // Versions endpoints
-  http.get(`https://${apiHost}/v1/bibles`, () => {
+  http.get(`https://${apiHost}/v1/bibles`, ({ request }) => {
+    const url = new URL(request.url);
+    const pageSize = url.searchParams.get('page_size');
+    const pageToken = url.searchParams.get('page_token');
+
+    const defaultPageSize = 25;
+    const size = pageSize ? parseInt(pageSize, 10) : defaultPageSize;
+    let start = 0;
+
+    if (pageToken) {
+      try {
+        const decoded = JSON.parse(atob(pageToken)) as { start?: number };
+        start = decoded.start || 0;
+      } catch {
+        start = 0;
+      }
+    }
+
+    const end = start + size;
+    const paginatedVersions = mockVersions.slice(start, end);
+    const hasMore = end < mockVersions.length;
+
     return HttpResponse.json({
-      data: mockVersions,
-      next_page_token: null,
-      total_size: 14,
+      data: paginatedVersions,
+      next_page_token: hasMore ? btoa(JSON.stringify({ start: end })) : null,
+      total_size: mockVersions.length,
     });
   }),
 
@@ -127,7 +148,7 @@ export const handlers = [
     return HttpResponse.json(mockBibleGenesis);
   }),
 
-  // Chaper endpoints
+  // Chapter endpoints
   http.get(`https://${apiHost}/v1/bibles/:bible_id/books/:book_id/chapters`, () => {
     return HttpResponse.json({ data: mockGenesisChapters });
   }),

package/src/__tests__/languages.test.ts

@@ -32,7 +32,11 @@ describe('LanguagesClient', () => {
       const { success } = LanguageSchema.safeParse(languages.data[0]);
       expect(success).toBe(true);
       expect(languages.data).toHaveLength(20);
-      expect(languages.data.every((language) => language.countries?.includes('US'))).toBe(true);
+      /** This is not true, it will always return the number provided in page_size
+       *  and it will put the ones that have the country in their countries array
+       *  at the top of the list.
+       */
+      // expect(languages.data.every((language) => language.countries?.includes('US'))).toBe(true);
       expect(languages.next_page_token).not.toBeNull();
     });
 

package/src/__tests__/polyfills.ts

@@ -0,0 +1,29 @@
+class LocalStorageMock {
+  private store: Record<string, string> = {};
+
+  getItem(key: string): string | null {
+    return this.store[key] ?? null;
+  }
+
+  setItem(key: string, value: string): void {
+    this.store[key] = value;
+  }
+
+  removeItem(key: string): void {
+    delete this.store[key];
+  }
+
+  clear(): void {
+    this.store = {};
+  }
+
+  get length(): number {
+    return Object.keys(this.store).length;
+  }
+
+  key(index: number): string | null {
+    return Object.keys(this.store)[index] ?? null;
+  }
+}
+
+globalThis.localStorage = new LocalStorageMock() as Storage;

package/src/bible.ts

@@ -57,6 +57,7 @@ export class BibleClient {
   async getVersions(
     language_ranges: string | string[],
     license_id?: string | number,
+    options?: { page_size?: number; page_token?: string },
   ): Promise<Collection<BibleVersion>> {
     const languageRangeArray = Array.isArray(language_ranges) ? language_ranges : [language_ranges];
 
@@ -68,9 +69,20 @@ export class BibleClient {
     const params: Record<string, string | number | string[]> = {
       'language_ranges[]': parsedLanguageRanges,
     };
+
     if (license_id !== undefined) {
       params.license_id = license_id;
     }
+
+    if (options?.page_size !== undefined) {
+      const pageSizeSchema = z.number().int().positive();
+      pageSizeSchema.parse(options.page_size);
+      params.page_size = options.page_size;
+    }
+
+    if (options?.page_token !== undefined) {
+      params.page_token = options.page_token;
+    }
     return this.client.get<Collection<BibleVersion>>(`/v1/bibles`, params);
   }
 

package/vitest.config.ts

@@ -3,7 +3,7 @@ import { defineConfig } from 'vitest/config';
 export default defineConfig({
   test: {
     environment: 'node',
-    setupFiles: ['./src/__tests__/setup.ts'],
+    setupFiles: ['./src/__tests__/polyfills.ts', './src/__tests__/setup.ts'],
     testTimeout: 10_000,
     coverage: {
       provider: 'v8',