@youversion/platform-core 0.8.1 → 0.9.0

package/src/__tests__/SignInWithYouVersionPKCE.test.ts

@@ -1,8 +1,6 @@
 import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
 import { SignInWithYouVersionPKCEAuthorizationRequestBuilder } from '../SignInWithYouVersionPKCE';
 import { YouVersionPlatformConfiguration } from '../YouVersionPlatformConfiguration';
-import { SignInWithYouVersionPermission } from '../SignInWithYouVersionResult';
-import type { SignInWithYouVersionPermissionValues } from '../types/auth';
 import { setupBrowserMocks, cleanupBrowserMocks } from './mocks/browser';
 
 describe('SignInWithYouVersionPKCEAuthorizationRequestBuilder', () => {
@@ -61,15 +59,10 @@ describe('SignInWithYouVersionPKCEAuthorizationRequestBuilder', () => {
         .mockReturnValueOnce('stateBase64==') // State
         .mockReturnValueOnce('nonceBase64=='); // Nonce
 
-      const permissions = new Set<SignInWithYouVersionPermissionValues>([
-        SignInWithYouVersionPermission.bibles,
-        SignInWithYouVersionPermission.highlights,
-      ]);
       const redirectURL = new URL('https://example.com/callback');
 
       const result = await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make(
         'test-app-key',
-        permissions,
         redirectURL,
       );
 
@@ -101,17 +94,14 @@ describe('SignInWithYouVersionPKCEAuthorizationRequestBuilder', () => {
       mocks.crypto.subtle.digest.mockResolvedValue(new Uint8Array(32).buffer);
       mocks.btoa.mockImplementation((str: string) => `base64_${callCount}_${str.length}`);
 
-      const permissions = new Set<SignInWithYouVersionPermissionValues>();
       const redirectURL = new URL('https://example.com/callback');
 
       const result1 = await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make(
         'app-key',
-        permissions,
         redirectURL,
       );
       const result2 = await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make(
         'app-key',
-        permissions,
         redirectURL,
       );
 
@@ -136,14 +126,10 @@ describe('SignInWithYouVersionPKCEAuthorizationRequestBuilder', () => {
     });
 
     it('should build authorization URL with all required OAuth2 parameters', async () => {
-      const permissions = new Set<SignInWithYouVersionPermissionValues>([
-        SignInWithYouVersionPermission.bibles,
-      ]);
       const redirectURL = new URL('https://example.com/callback');
 
       const result = await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make(
         'test-app-key',
-        permissions,
         redirectURL,
       );
 
@@ -163,12 +149,10 @@ describe('SignInWithYouVersionPKCEAuthorizationRequestBuilder', () => {
     });
 
     it('should handle redirect URL with trailing slash', async () => {
-      const permissions = new Set<SignInWithYouVersionPermissionValues>();
       const redirectURL = new URL('https://example.com/callback/');
 
       const result = await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make(
         'test-app-key',
-        permissions,
         redirectURL,
       );
 
@@ -177,12 +161,10 @@ describe('SignInWithYouVersionPKCEAuthorizationRequestBuilder', () => {
     });
 
     it('should include x-yvp-installation-id param', async () => {
-      const permissions = new Set<SignInWithYouVersionPermissionValues>();
       const redirectURL = new URL('https://example.com/callback');
 
       const result = await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make(
         'test-app-key',
-        permissions,
         redirectURL,
       );
 
@@ -190,73 +172,41 @@ describe('SignInWithYouVersionPKCEAuthorizationRequestBuilder', () => {
       expect(params.get('x-yvp-installation-id')).not.toBeFalsy();
     });
 
-    it('should create scope string with permissions and openid', async () => {
-      const permissions = new Set<SignInWithYouVersionPermissionValues>([
-        SignInWithYouVersionPermission.bibles,
-        SignInWithYouVersionPermission.highlights,
-      ]);
+    it('should create scope string with profile and openid', async () => {
       const redirectURL = new URL('https://example.com/callback');
 
       const result = await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make(
         'test-app-key',
-        permissions,
         redirectURL,
+        ['profile'],
       );
 
       const params = new URLSearchParams(result.url.search);
       const scope = params.get('scope');
 
-      expect(scope).toContain('bibles');
-      expect(scope).toContain('highlights');
-      expect(scope).toContain('openid');
-    });
-
-    it('should sort permissions alphabetically', async () => {
-      const permissions = new Set<SignInWithYouVersionPermissionValues>([
-        SignInWithYouVersionPermission.votd,
-        SignInWithYouVersionPermission.bibles,
-        SignInWithYouVersionPermission.demographics,
-      ]);
-      const redirectURL = new URL('https://example.com/callback');
-
-      const result = await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make(
-        'test-app-key',
-        permissions,
-        redirectURL,
-      );
-
-      const params = new URLSearchParams(result.url.search);
-      const scope = params.get('scope');
-
-      // Should be sorted: bibles demographics votd openid
-      expect(scope).toBe('bibles demographics votd openid');
+      expect(scope).toContain('profile');
     });
 
     it('should add openid when not present', async () => {
-      const permissions = new Set<SignInWithYouVersionPermissionValues>([
-        SignInWithYouVersionPermission.bibles,
-      ]);
       const redirectURL = new URL('https://example.com/callback');
 
       const result = await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make(
         'test-app-key',
-        permissions,
         redirectURL,
+        ['profile'],
       );
 
       const params = new URLSearchParams(result.url.search);
       const scope = params.get('scope');
 
-      expect(scope).toBe('bibles openid');
+      expect(scope).toBe('profile openid');
     });
 
-    it('should handle empty permissions set', async () => {
-      const permissions = new Set<SignInWithYouVersionPermissionValues>();
+    it('should handle empty scope params', async () => {
       const redirectURL = new URL('https://example.com/callback');
 
       const result = await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make(
         'test-app-key',
-        permissions,
         redirectURL,
       );
 
@@ -267,16 +217,10 @@ describe('SignInWithYouVersionPKCEAuthorizationRequestBuilder', () => {
     });
 
     it('should not duplicate openid if already present', async () => {
-      // This test simulates if openid was somehow in the permissions set
-      const permissions = new Set<SignInWithYouVersionPermissionValues>([
-        'openid' as SignInWithYouVersionPermissionValues,
-        SignInWithYouVersionPermission.bibles,
-      ]);
       const redirectURL = new URL('https://example.com/callback');
 
       const result = await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make(
         'test-app-key',
-        permissions,
         redirectURL,
       );
 
@@ -347,14 +291,9 @@ describe('SignInWithYouVersionPKCEAuthorizationRequestBuilder', () => {
     });
 
     it('should use crypto.getRandomValues for secure random generation', async () => {
-      const permissions = new Set<SignInWithYouVersionPermissionValues>();
       const redirectURL = new URL('https://example.com/callback');
 
-      await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make(
-        'test-app-key',
-        permissions,
-        redirectURL,
-      );
+      await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make('test-app-key', redirectURL);
 
       // Should call crypto.getRandomValues for code verifier, state, and nonce
       expect(mocks.crypto.getRandomValues).toHaveBeenCalledTimes(3);
@@ -367,14 +306,9 @@ describe('SignInWithYouVersionPKCEAuthorizationRequestBuilder', () => {
     });
 
     it('should use SHA-256 for code challenge', async () => {
-      const permissions = new Set<SignInWithYouVersionPermissionValues>();
       const redirectURL = new URL('https://example.com/callback');
 
-      await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make(
-        'test-app-key',
-        permissions,
-        redirectURL,
-      );
+      await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make('test-app-key', redirectURL);
 
       expect(mocks.crypto.subtle.digest).toHaveBeenCalledWith('SHA-256', expect.any(Uint8Array));
     });
@@ -383,17 +317,14 @@ describe('SignInWithYouVersionPKCEAuthorizationRequestBuilder', () => {
       // Use real crypto for this test to verify actual randomness
       cleanupBrowserMocks();
 
-      const permissions = new Set<SignInWithYouVersionPermissionValues>();
       const redirectURL = new URL('https://example.com/callback');
 
       const result1 = await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make(
         'test-app-key',
-        permissions,
         redirectURL,
       );
       const result2 = await SignInWithYouVersionPKCEAuthorizationRequestBuilder.make(
         'test-app-key',
-        permissions,
         redirectURL,
       );
 

package/src/__tests__/SignInWithYouVersionResult.test.ts

@@ -9,7 +9,6 @@ describe('SignInWithYouVersionResult', () => {
       accessToken: 'test-access-token',
       expiresIn: 3600,
       refreshToken: 'test-refresh-token',
-      permissions: ['votd', 'bibles'],
       yvpUserId: 'test-user-id',
       name: 'test user',
       profilePicture: 'https://this-is-a-test-picture.com',
@@ -19,7 +18,6 @@ describe('SignInWithYouVersionResult', () => {
     expect(result.accessToken).toBe('test-access-token');
     expect(result.expiryDate).toStrictEqual(new Date(fixedDate.getTime() + 60 * 60 * 1000));
     expect(result.refreshToken).toBe('test-refresh-token');
-    expect(result.permissions).toStrictEqual(['votd', 'bibles']);
     expect(result.yvpUserId).toBe('test-user-id');
     expect(result.name).toBe('test user');
     expect(result.profilePicture).toBe('https://this-is-a-test-picture.com');

package/src/__tests__/Users.test.ts

@@ -1,9 +1,7 @@
 import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
 import { YouVersionAPIUsers } from '../Users';
 import { YouVersionPlatformConfiguration } from '../YouVersionPlatformConfiguration';
-import { SignInWithYouVersionPermission } from '../SignInWithYouVersionResult';
 import { YouVersionUserInfo } from '../YouVersionUserInfo';
-import type { SignInWithYouVersionPermissionValues } from '../types/auth';
 import { setupBrowserMocks, cleanupBrowserMocks } from './mocks/browser';
 
 const mockFetch = vi.fn();
@@ -40,13 +38,9 @@ describe('YouVersionAPIUsers', () => {
     it('should throw error when appKey is not set', async () => {
       YouVersionPlatformConfiguration.appKey = null;
 
-      const permissions = new Set<SignInWithYouVersionPermissionValues>([
-        SignInWithYouVersionPermission.bibles,
-      ]);
-
-      await expect(
-        YouVersionAPIUsers.signIn(permissions, 'https://example.com/callback'),
-      ).rejects.toThrow('YouVersionPlatformConfiguration.appKey must be set before calling signIn');
+      await expect(YouVersionAPIUsers.signIn('https://example.com/callback')).rejects.toThrow(
+        'YouVersionPlatformConfiguration.appKey must be set before calling signIn',
+      );
     });
 
     it('should create authorization request and redirect on successful signIn', async () => {
@@ -62,13 +56,9 @@ describe('YouVersionAPIUsers', () => {
       vi.spyOn(crypto.subtle, 'digest').mockResolvedValue(new Uint8Array(32).buffer);
       mocks.btoa.mockReturnValue('mockBase64Value');
 
-      const permissions = new Set<SignInWithYouVersionPermissionValues>([
-        SignInWithYouVersionPermission.bibles,
-        SignInWithYouVersionPermission.highlights,
-      ]);
       const redirectURL = 'https://example.com/callback';
 
-      await YouVersionAPIUsers.signIn(permissions, redirectURL);
+      await YouVersionAPIUsers.signIn(redirectURL);
 
       // Verify localStorage items stored
       expect(mocks.localStorage.setItem).toHaveBeenCalledWith(
@@ -210,7 +200,6 @@ describe('YouVersionAPIUsers', () => {
       expect(result).toBeTruthy();
       expect(result?.accessToken).toBe('access-token-123');
       expect(result?.refreshToken).toBe('refresh-token-456');
-      expect(result?.permissions).toEqual(['bibles', 'highlights']);
       expect(result?.yvpUserId).toBe('1234567890');
       expect(result?.name).toBe('John Doe');
       expect(result?.email).toBe('john@example.com');
@@ -323,32 +312,11 @@ describe('YouVersionAPIUsers', () => {
       expect(result.accessToken).toBe('access-token-123');
       expect(result.expiryDate).toStrictEqual(new Date(fixedDate.getTime() + 60 * 60 * 1000));
       expect(result.refreshToken).toBe('refresh-token-456');
-      expect(result.permissions).toEqual(['bibles', 'highlights']);
       expect(result.yvpUserId).toBe('1234567890');
       expect(result.name).toBe('John Doe');
       expect(result.email).toBe('john@example.com');
       expect(result.profilePicture).toBe('https://example.com/avatar.jpg');
     });
-
-    it('should filter out unknown permissions', () => {
-      const tokens = {
-        access_token: 'token',
-        expires_in: 3600,
-        id_token:
-          'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.e30.Et9HFtf9R3GEMA0IICOfFMVXY7kkTX1wr4qCyhIf58U',
-        refresh_token: 'refresh',
-        scope: 'bibles unknown_permission highlights invalid_scope',
-        token_type: 'Bearer',
-      };
-
-      // Mock JWT decoding
-      vi.mocked(atob).mockReturnValue(JSON.stringify({ sub: 'user123' }));
-
-      // @ts-expect-error - accessing private method for testing
-      const result = YouVersionAPIUsers.extractSignInResult(tokens);
-
-      expect(result.permissions).toEqual(['bibles', 'highlights']);
-    });
   });
 
   describe('decodeJWT', () => {
@@ -557,8 +525,6 @@ describe('YouVersionAPIUsers', () => {
       // Assert that id_token is preserved (same as original)
       expect(result?.idToken).toBe(existingIdToken);
 
-      expect(result?.permissions).toEqual(['bibles', 'highlights']);
-
       // Verify the refresh token request was made correctly
       expect(mockFetch).toHaveBeenCalledTimes(1);
       expect(mockFetch).toHaveBeenCalledWith(

package/src/__tests__/bible.test.ts

@@ -75,8 +75,10 @@ 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('canon', 'ot');
+      expect(books.data[0]).toHaveProperty('canon', 'old_testament');
+      expect(books.data[0]?.chapters).toHaveLength(50);
     });
   });
 
@@ -91,7 +93,7 @@ describe('BibleClient', () => {
       expect(book).toHaveProperty('id', 'GEN');
       expect(book).toHaveProperty('title', 'Genesis');
       expect(book).toHaveProperty('abbreviation', 'Gen');
-      expect(book).toHaveProperty('canon', 'ot');
+      expect(book).toHaveProperty('canon', 'old_testament');
     });
 
     it('should throw an error for invalid inputs', async () => {
@@ -116,7 +118,6 @@ describe('BibleClient', () => {
 
       expect(chapters.data).toHaveLength(50);
       expect(chapters.data[0]).toHaveProperty('id', '1');
-      expect(chapters.data[0]).toHaveProperty('book_id', 'GEN');
       expect(chapters.data[0]).toHaveProperty('passage_id', 'GEN.1');
       expect(chapters.data[0]).toHaveProperty('title', '1');
       expect(chapters.data[0]?.verses).toHaveLength(31);
@@ -131,7 +132,6 @@ describe('BibleClient', () => {
       expect(success).toBe(true);
 
       expect(chapter).toHaveProperty('id', '1');
-      expect(chapter).toHaveProperty('book_id', 'GEN');
       expect(chapter).toHaveProperty('passage_id', 'GEN.1');
       expect(chapter).toHaveProperty('title', '1');
       expect(chapter.verses).toHaveLength(31);
@@ -154,11 +154,9 @@ describe('BibleClient', () => {
       const { success } = BibleVerseSchema.safeParse(verses.data[0]);
       expect(success).toBe(true);
 
-      expect(verses.data).toHaveLength(24);
+      expect(verses.data).toHaveLength(31);
       expect(verses.data[0]).toHaveProperty('id', '1');
-      expect(verses.data[0]).toHaveProperty('reference', 'Genesis 1:1');
-      expect(verses.data[0]).toHaveProperty('book_id', 'GEN');
-      expect(verses.data[0]).toHaveProperty('chapter_id', '1');
+      expect(verses.data[0]).toHaveProperty('title', '1');
       expect(verses.data[0]).toHaveProperty('passage_id', 'GEN.1.1');
     });
   });
@@ -171,9 +169,7 @@ describe('BibleClient', () => {
       expect(success).toBe(true);
 
       expect(verse).toHaveProperty('id', '1');
-      expect(verse).toHaveProperty('reference', 'Genesis 1:1');
-      expect(verse).toHaveProperty('book_id', 'GEN');
-      expect(verse).toHaveProperty('chapter_id', '1');
+      expect(verse).toHaveProperty('title', '1');
       expect(verse).toHaveProperty('passage_id', 'GEN.1.1');
     });
 
@@ -210,8 +206,7 @@ describe('BibleClient', () => {
         id: 'GEN.1.1',
         content:
           '<div><div class="pi"><span class="yv-v" v="1"></span><span class="yv-vlbl">1</span>In the beginning God created the heavens and the earth. </div></div>',
-        bible_id: 111,
-        human_reference: 'Genesis 1:1',
+        reference: 'Genesis 1:1',
       });
     });
 
@@ -222,8 +217,7 @@ describe('BibleClient', () => {
       expect(success).toBe(true);
 
       expect(passage).toHaveProperty('id', 'GEN.1');
-      expect(passage).toHaveProperty('bible_id', 111);
-      expect(passage).toHaveProperty('human_reference', 'Genesis 1');
+      expect(passage).toHaveProperty('reference', 'Genesis 1');
     });
 
     it('should fetch a passage with html format by default', async () => {
@@ -242,7 +236,6 @@ describe('BibleClient', () => {
       const passage = await bibleClient.getPassage(111, 'ROM.1', 'html', true);
 
       expect(passage.id).toBe('ROM.1');
-      expect(passage.bible_id).toBe(111);
       expect(passage.content).toContain('yv-h');
       expect(passage.content).not.toContain('yv-n');
     });
@@ -251,7 +244,6 @@ describe('BibleClient', () => {
       const passage = await bibleClient.getPassage(111, 'ROM.1', 'html', undefined, true);
 
       expect(passage.id).toBe('ROM.1');
-      expect(passage.bible_id).toBe(111);
       expect(passage.content).toContain('yv-n');
       expect(passage.content).not.toContain('yv-h');
     });
@@ -260,7 +252,6 @@ describe('BibleClient', () => {
       const passage = await bibleClient.getPassage(111, 'ROM.1', 'html', true, true);
 
       expect(passage.id).toBe('ROM.1');
-      expect(passage.bible_id).toBe(111);
       expect(passage.content).toContain('yv-n');
       expect(passage.content).toContain('yv-h');
     });

package/src/__tests__/client.test.ts

@@ -1,8 +1,17 @@
-import { describe, it, expect, beforeEach } from 'vitest';
+import { describe, it, expect, beforeEach, beforeAll, afterEach, afterAll } from 'vitest';
 import { ApiClient } from '../client';
 import { http, HttpResponse } from 'msw';
 import { server } from './setup';
 
+// We always want this test to hit msw since this is only testing
+// the setup of and ApiClient instance and not actually hitting
+// any real APIs.
+if (process.env.INTEGRATION_TESTS) {
+  beforeAll(() => server.listen());
+  afterEach(() => server.resetHandlers());
+  afterAll(() => server.close());
+}
+
 describe('ApiClient', () => {
   let apiClient: ApiClient;
 

package/src/__tests__/setup.ts

@@ -4,14 +4,17 @@ import { handlers } from './handlers';
 
 export const server = setupServer(...handlers);
 
-beforeAll(() => {
-  server.listen();
-});
+// Only setup MSW if INTEGRATION_TESTS env var is not set
+if (!process.env.INTEGRATION_TESTS) {
+  beforeAll(() => {
+    server.listen();
+  });
 
-afterEach(() => {
-  server.resetHandlers();
-});
+  afterEach(() => {
+    server.resetHandlers();
+  });
 
-afterAll(() => {
-  server.close();
-});
+  afterAll(() => {
+    server.close();
+  });
+}

package/src/bible.ts

@@ -81,7 +81,7 @@ export class BibleClient {
   /**
    * Fetches all books for a given Bible version.
    * @param versionId The version ID.
-   * @param canon Optional canon filter ('ot', 'nt', 'deuterocanon').
+   * @param canon Optional canon filter ("old_testament", 'new_testament', 'deuterocanon').
    * @returns An array of BibleBook objects.
    */
   async getBooks(versionId: number, canon?: CANON): Promise<Collection<BibleBook>> {

package/src/index.ts

@@ -11,7 +11,6 @@ export * from './Users';
 export * from './YouVersionUserInfo';
 export * from './SignInWithYouVersionResult';
 export * from './YouVersionAPI';
-export * from './URLBuilder';
 export * from './YouVersionPlatformConfiguration';
 export * from './types';
 export * from './utils/constants';

package/src/schemas/book.ts

@@ -1,11 +1,8 @@
 import { z } from 'zod';
 import { BOOK_IDS } from '../utils/constants';
+import { BibleChapterSchema } from './chapter';
 
-export const CanonSchema = z.enum([
-  'ot', // Old Testament
-  'nt', // New Testament
-  'dc', // Deuterocanon (Apocrypha)
-]);
+export const CanonSchema = z.enum(['old_testament', 'new_testament', 'deuterocanon']);
 export type Canon = z.infer<typeof CanonSchema>;
 
 // https://github.com/colinhacks/zod/discussions/4934#discussioncomment-13858053
@@ -20,14 +17,14 @@ export const BibleBookSchema = z.object({
   id: BookUsfmSchema,
   /** Book title (e.g., "Genesis") */
   title: z.string(),
+  /** Full Book title (e.g., "The First Book of Moses, Commonly Called Genesis") */
+  full_title: z.string(),
   /** Book abbreviation (e.g., "Gen") */
   abbreviation: z.string().optional(),
   /** Canonical section (new_testament, old_testament, deuterocanon) */
   canon: CanonSchema,
   /** Array of chapter identifiers (e.g., ["GEN.1", "GEN.2", "GEN.3"]) */
-  chapters: z
-    .array(z.string().regex(/^\w{3}\.\d+$/, { message: 'Chapter must be an integer string' }))
-    .optional(),
+  chapters: z.array(BibleChapterSchema).optional(),
 });
 
 export type BibleBook = z.infer<typeof BibleBookSchema>;

package/src/schemas/chapter.ts

@@ -1,24 +1,15 @@
 import { z } from 'zod';
-import { BookUsfmSchema } from './book';
+import { BibleVerseSchema } from './verse';
 
 export const BibleChapterSchema = z.object({
   /** Chapter identifier (e.g., "1") */
   id: z.string(),
-  /** Book identifier (e.g., "MAT") */
-  book_id: BookUsfmSchema,
   /** Passage identifier (e.g., "MAT.1") */
   passage_id: z.string(),
   /** Chapter title (e.g., "1") */
   title: z.string(),
-  /** Array of verse identifiers (e.g., ["1", "2", "3"]) */
-  verses: z
-    .array(
-      z
-        .string()
-        .regex(/^\d+$/, { message: 'Verse must be an integer string' })
-        .transform((val) => val as `${number}`),
-    )
-    .optional(),
+  /** Array of verses */
+  verses: z.array(BibleVerseSchema).optional(),
 });
 
 export type BibleChapter = z.infer<typeof BibleChapterSchema>;

package/src/schemas/passage.ts

@@ -5,10 +5,8 @@ export const BiblePassageSchema = z.object({
   id: z.string(),
   /** Passage content text */
   content: z.string(),
-  /** Bible version identifier */
-  bible_id: z.number().int().positive(),
   /** Human-readable reference (e.g., "Matthew 1:1") */
-  human_reference: z.string(),
+  reference: z.string(),
 });
 
 export type BiblePassage = z.infer<typeof BiblePassageSchema>;

package/src/schemas/verse.ts

@@ -1,17 +1,12 @@
 import { z } from 'zod';
-import { BookUsfmSchema } from './book';
 
 export const BibleVerseSchema = z.object({
   /** Verse identifier (e.g., "1") */
   id: z.string(),
-  /** Book identifier (e.g., "MAT") */
-  book_id: BookUsfmSchema,
-  /** Chapter identifier (e.g., "1") */
-  chapter_id: z.string(),
   /** Passage identifier (e.g., "MAT.1.1") */
   passage_id: z.string(),
-  /** Human-readable reference (e.g., "Matthew 1:1") */
-  reference: z.string(),
+  /** Verse Number (e.g., "1") */
+  title: z.string(),
 });
 
 export type BibleVerse = z.infer<typeof BibleVerseSchema>;

package/src/schemas/version.ts

@@ -17,9 +17,9 @@ export const BibleVersionSchema = z.object({
   /** Language tag (e.g., "en") */
   language_tag: z.string(),
   /** Localized abbreviation */
-  local_abbreviation: z.string(),
+  localized_abbreviation: z.string(),
   /** Localized title */
-  local_title: z.string(),
+  localized_title: z.string(),
   /** Organization ID of publisher */
   organization_id: z.string().nullable().optional(),
   /** Full title */

package/src/types/auth.ts

@@ -14,3 +14,5 @@ export interface AuthenticationState {
   result: SignInWithYouVersionResult | null;
   error: Error | null;
 }
+
+export type AuthenticationScopes = 'profile' | 'email';

package/src/types/index.ts

@@ -18,5 +18,9 @@ export type { Collection } from '../schemas/collection';
 
 // Re-export internal/non-API types
 export type { ApiConfig } from './api-config';
-export type { AuthenticationState, SignInWithYouVersionPermissionValues } from './auth';
+export type {
+  AuthenticationState,
+  SignInWithYouVersionPermissionValues,
+  AuthenticationScopes,
+} from './auth';
 export type { HighlightColor } from './highlight';