@youversion/platform-core 0.4.3 → 0.5.0

package/.env.example

@@ -1,5 +1,5 @@
 # Your application ID from YouVersion Platform
 YVP_APP_KEY="ADD_YOUR_APP_KEY_HERE"
 
-# This should be left untouched unless you're helping test YouVersion's backend APIs.
+# API host - defaults to production (api.youversion.com)
 YVP_API_HOST=api.youversion.com

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @youversion/platform-core@0.4.3 build /home/runner/work/platform-sdk-react/platform-sdk-react/packages/core
+> @youversion/platform-core@0.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 37.68 KB
+ESM dist/index.js 37.59 KB
 ESM ⚡️ Build success in 37ms
-CJS dist/index.cjs 39.67 KB
+CJS dist/index.cjs 39.59 KB
 CJS ⚡️ Build success in 37ms
 DTS Build start
-DTS ⚡️ Build success in 2374ms
+DTS ⚡️ Build success in 2331ms
 DTS dist/index.d.cts 34.08 KB
 DTS dist/index.d.ts  34.08 KB

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @youversion/platform-core
 
+## 0.5.0
+
+### Minor Changes
+
+- e07208d: feat(ui): add share button to verse of the day component
+
+## 0.4.4
+
+### Patch Changes
+
+- 8dee8f6: chore: allow setting apiHost from React code
+
 ## 0.4.3
 
 ### Patch Changes

package/dist/index.cjs

@@ -56,11 +56,9 @@ var ApiClient = class {
     this.config = {
       ...config
     };
-    const apiHost = config.apiHost ?? process.env.YVP_API_HOST ?? "api.youversion.com";
+    const apiHost = config.apiHost || "api.youversion.com";
     if (!apiHost) {
-      throw new Error(
-        "ApiClient requires a host name. Provide an apiHost in the config or set the YVP_API_HOST environment variable."
-      );
+      throw new Error("ApiClient requires a host name. Provide an apiHost in the config.");
     }
     this.baseURL = "https://" + apiHost;
     this.timeout = config.timeout || 1e4;

package/dist/index.js

@@ -13,11 +13,9 @@ var ApiClient = class {
     this.config = {
       ...config
     };
-    const apiHost = config.apiHost ?? process.env.YVP_API_HOST ?? "api.youversion.com";
+    const apiHost = config.apiHost || "api.youversion.com";
     if (!apiHost) {
-      throw new Error(
-        "ApiClient requires a host name. Provide an apiHost in the config or set the YVP_API_HOST environment variable."
-      );
+      throw new Error("ApiClient requires a host name. Provide an apiHost in the config.");
     }
     this.baseURL = "https://" + apiHost;
     this.timeout = config.timeout || 1e4;

package/package.json

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

package/src/__tests__/MockLangauges.ts

@@ -0,0 +1,95 @@
+import type { Language } from '../types';
+
+export const mockLanguages: Language[] = [
+  {
+    id: 'en',
+    language: 'en',
+    script: 'Latn',
+    script_name: 'Latin',
+    aliases: ['eng'],
+    display_names: { en: 'English' },
+    scripts: ['Latn'],
+    variants: [],
+    countries: ['US', 'GB', 'CA', 'AU'],
+    text_direction: 'ltr',
+    writing_population: 1500000000,
+    speaking_population: 1500000000,
+    default_bible_version_id: null,
+  },
+  {
+    id: 'es',
+    language: 'es',
+    script: 'Latn',
+    script_name: 'Latin',
+    aliases: ['spa'],
+    display_names: { en: 'Spanish', es: 'español' },
+    scripts: ['Latn'],
+    variants: [],
+    countries: ['ES', 'MX', 'AR', 'CO'],
+    text_direction: 'ltr',
+    writing_population: 500000000,
+    speaking_population: 500000000,
+    default_bible_version_id: null,
+  },
+  {
+    id: 'fr',
+    language: 'fr',
+    script: 'Latn',
+    script_name: 'Latin',
+    aliases: ['fra', 'fre'],
+    display_names: { en: 'French', fr: 'français' },
+    scripts: ['Latn'],
+    variants: [],
+    countries: ['FR', 'CA', 'BE', 'CH'],
+    text_direction: 'ltr',
+    writing_population: 300000000,
+    speaking_population: 300000000,
+    default_bible_version_id: null,
+  },
+  {
+    id: 'de',
+    language: 'de',
+    script: 'Latn',
+    script_name: 'Latin',
+    aliases: ['deu', 'ger'],
+    display_names: { en: 'German', de: 'Deutsch' },
+    scripts: ['Latn'],
+    variants: [],
+    countries: ['DE', 'AT', 'CH'],
+    text_direction: 'ltr',
+    writing_population: 100000000,
+    speaking_population: 100000000,
+    default_bible_version_id: null,
+  },
+  {
+    id: 'sr-Latn',
+    language: 'sr',
+    script: 'Latn',
+    script_name: 'latinica',
+    aliases: ['srp'],
+    display_names: { en: 'Serbian (Latin)', sr: 'srpski' },
+    scripts: ['Latn', 'Cyrl'],
+    variants: [],
+    countries: ['RS', 'BA', 'ME'],
+    text_direction: 'ltr',
+    writing_population: 8000000,
+    speaking_population: 8000000,
+    default_bible_version_id: null,
+  },
+  // Add more languages to reach 25 for default page size when filtering by 'US'
+  ...Array.from({ length: 24 }, (_, i) => ({
+    id: `lang${i + 1}`,
+    language: `lang${i + 1}`,
+    script: 'Latn',
+    script_name: null,
+    aliases: [],
+    display_names: {},
+    scripts: ['Latn'],
+    variants: [],
+    countries: ['US'],
+    text_direction: 'ltr' as const,
+    writing_population: 1000000,
+    speaking_population: 1000000,
+    default_bible_version_id: null,
+  })),
+];

package/src/__tests__/authentication.test.ts

@@ -14,6 +14,7 @@ describe('AuthClient', () => {
     global.fetch = vi.fn();
     apiClient = new ApiClient({
       appKey: 'test-app-key',
+      apiHost: process.env.YVP_API_HOST || '',
     });
     authClient = new AuthClient(apiClient);
   });

package/src/__tests__/bible.test.ts

@@ -16,6 +16,7 @@ describe('BibleClient', () => {
 
   beforeEach(() => {
     apiClient = new ApiClient({
+      apiHost: process.env.YVP_API_HOST || '',
       appKey: process.env.YVP_APP_KEY || '',
       installationId: 'test-installation',
     });

package/src/__tests__/handlers.ts

@@ -1,5 +1,6 @@
 import { http, HttpResponse } from 'msw';
-import type { Collection, Highlight } from '../types';
+import type { Collection, Highlight, Language } from '../types';
+import { mockLanguages } from './MockLangauges';
 
 const apiHost = process.env.YVP_API_HOST;
 if (!apiHost) {
@@ -7,6 +8,54 @@ if (!apiHost) {
 }
 
 export const handlers = [
+  // Languages endpoints
+  http.get(`https://${apiHost}/v1/languages/:languageId`, ({ params }) => {
+    const { languageId } = params;
+    const language = mockLanguages.find((lang) => lang.id === languageId);
+
+    if (!language) {
+      return new HttpResponse(null, { status: 404 });
+    }
+
+    return HttpResponse.json(language);
+  }),
+
+  http.get(`https://${apiHost}/v1/languages`, ({ request }) => {
+    const url = new URL(request.url);
+    const country = url.searchParams.get('country');
+    const pageSize = url.searchParams.get('page_size');
+    const pageToken = url.searchParams.get('page_token');
+
+    const filteredLanguages = country
+      ? mockLanguages.filter((lang) => lang.countries?.includes(country))
+      : mockLanguages;
+
+    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 paginatedLanguages = filteredLanguages.slice(start, end);
+    const hasMore = end < filteredLanguages.length;
+
+    const response: Collection<Language> = {
+      data: paginatedLanguages,
+      next_page_token: hasMore ? btoa(`{"start": ${end}}`) : null,
+      total_size: filteredLanguages.length,
+    };
+
+    return HttpResponse.json(response);
+  }),
+
   // Highlights endpoints
   http.get(`https://${apiHost}/v1/highlights`, ({ request }) => {
     const url = new URL(request.url);

package/src/__tests__/highlights.test.ts

@@ -9,6 +9,7 @@ describe('HighlightsClient', () => {
 
   beforeEach(() => {
     apiClient = new ApiClient({
+      apiHost: process.env.YVP_API_HOST || '',
       appKey: 'test-app',
       installationId: 'test-installation',
     });

package/src/__tests__/languages.test.ts

@@ -9,6 +9,7 @@ describe('LanguagesClient', () => {
 
   beforeEach(() => {
     apiClient = new ApiClient({
+      apiHost: process.env.YVP_API_HOST || '',
       appKey: process.env.YVP_APP_KEY || '',
       installationId: 'test-installation',
     });
@@ -34,23 +35,6 @@ describe('LanguagesClient', () => {
       expect(languages.next_page_token).toBe('eyJzdGFydCI6IDEwfQ==');
     });
 
-    it('should fetch languages with page_token option', async () => {
-      const languages = await languagesClient.getLanguages({
-        country: 'US',
-        page_token: 'eyJzdGFydCI6IDEwMH0=',
-      });
-
-      const { success } = LanguageSchema.safeParse(languages.data[0]);
-      expect(success).toBe(true);
-      expect(languages.data).toHaveLength(25);
-    });
-
-    it('should uppercase country code', async () => {
-      const languages = await languagesClient.getLanguages({ country: 'us' });
-
-      expect(languages.data[0]?.countries).toContain('US');
-    });
-
     it('should throw an error for invalid country code - empty string', async () => {
       await expect(languagesClient.getLanguages({ country: '' })).rejects.toThrow(
         'Country code must be a 2-character ISO 3166-1 alpha-2 code',
@@ -71,22 +55,6 @@ describe('LanguagesClient', () => {
         'Country code must be a 2-character ISO 3166-1 alpha-2 code',
       );
     });
-
-    it('should throw an error for invalid page_size - zero', async () => {
-      await expect(languagesClient.getLanguages({ country: 'US', page_size: 0 })).rejects.toThrow();
-    });
-
-    it('should throw an error for invalid page_size - negative', async () => {
-      await expect(
-        languagesClient.getLanguages({ country: 'US', page_size: -1 }),
-      ).rejects.toThrow();
-    });
-
-    it('should throw an error for invalid page_size - non-integer', async () => {
-      await expect(
-        languagesClient.getLanguages({ country: 'US', page_size: 1.5 }),
-      ).rejects.toThrow();
-    });
   });
 
   describe('getLanguage', () => {

package/src/client.ts

@@ -23,11 +23,9 @@ export class ApiClient {
     this.config = {
       ...config,
     };
-    const apiHost = config.apiHost ?? process.env.YVP_API_HOST ?? 'api.youversion.com';
+    const apiHost = config.apiHost || 'api.youversion.com';
     if (!apiHost) {
-      throw new Error(
-        'ApiClient requires a host name. Provide an apiHost in the config or set the YVP_API_HOST environment variable.',
-      );
+      throw new Error('ApiClient requires a host name. Provide an apiHost in the config.');
     }
     this.baseURL = 'https://' + apiHost;
     this.timeout = config.timeout || 10000;