waha-shared 1.0.308 → 1.0.309

package/dist/functions/bibles.js

@@ -0,0 +1,314 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OLD_TESTAMENT_BOOKS = exports.NEW_TESTAMENT_BOOKS = exports.OPTIONAL_CHAPTERS = void 0;
+exports.getBibleInfo = getBibleInfo;
+exports.replaceBibleWith = replaceBibleWith;
+exports.shouldConcatBibleWith = shouldConcatBibleWith;
+exports.getAllBibleIds = getAllBibleIds;
+exports.getAvailableChapters = getAvailableChapters;
+exports.getPercentage = getPercentage;
+exports.getBibleForPassage = getBibleForPassage;
+const bibleAudios_1 = require("../data/bibleAudios");
+const bibleChaptersList_1 = require("../data/bibleChaptersList");
+const bibleStatuses_1 = require("../data/bibleStatuses");
+const bibleTexts_1 = require("../data/bibleTexts");
+const languages_1 = require("../data/languages");
+const scripts_1 = require("../data/scripts");
+const bibleBooks_1 = require("./bibleBooks");
+const bibleInfoCache = new Map();
+function getBibleInfo(bibleId) {
+    const cached = bibleInfoCache.get(bibleId);
+    if (cached !== undefined)
+        return cached;
+    if (bibleInfoCache.has(bibleId))
+        return undefined;
+    const bibleStatus = bibleStatuses_1.bibleStatuses[bibleId];
+    if (!bibleStatus) {
+        bibleInfoCache.set(bibleId, undefined);
+        return undefined;
+    }
+    const bibleText = bibleTexts_1.bibleTexts.find((t) => t.bibleTextId === bibleId);
+    const bibleAudio = bibleAudios_1.bibleAudios.find((t) => t.bibleAudioId === bibleText?.audioId ||
+        t.bibleAudioId === bibleText?.bibleTextId);
+    const language = languages_1.languages.find((l) => l.languageId === bibleText?.languageId);
+    const script = scripts_1.scripts.find((s) => s.name === language?.script) ?? scripts_1.scripts[0];
+    if (!bibleText || !bibleAudio || !language)
+        return;
+    const availableChapters = getAvailableChapters(bibleText.bibleTextId);
+    const result = bibleText && bibleAudio && language
+        ? {
+            ...bibleText,
+            ...bibleAudio,
+            language,
+            script,
+            availableTextChapters: availableChapters.text,
+            availableAudioChapters: availableChapters.audio,
+            availableTimingsChapters: availableChapters.timings,
+            availableChapters: availableChapters.all,
+            bookNames: {
+                ...(bibleText.bookNameFallback
+                    ? (bibleStatuses_1.bibleStatuses[bibleText.bookNameFallback]?.bookNames ?? {})
+                    : {}),
+                ...bibleStatus.bookNames,
+            },
+            fullCopyright: (bibleText.copyright ?? '') + '\n\n' + (bibleAudio.copyright ?? ''),
+        }
+        : undefined;
+    bibleInfoCache.set(bibleId, result);
+    return result;
+}
+function replaceBibleWith({ modifiers, lessonCategory, passageId, }) {
+    for (const modifier of modifiers) {
+        if (modifier.action === 'concat')
+            continue;
+        /**
+         * If our modifier matches the lesson category or passage testament, then we
+         * want to replace the bible id.
+         */
+        if (modifier.scope === lessonCategory ||
+            modifier.scope === (0, bibleBooks_1.parseVerseRange)(passageId).testament)
+            return modifier.bibleId;
+    }
+    return undefined;
+}
+/** Determines whether a lesson/passage meet the requirements for concatenating. */
+function shouldConcatBibleWith({ modifier, lessonCategory, passageId, }) {
+    if (modifier.action === 'replace')
+        return false;
+    /**
+     * If our modifier matches the lesson category or passage testament, then we
+     * are good to concat.
+     */
+    if (modifier.scope === lessonCategory ||
+        modifier.scope === (0, bibleBooks_1.parseVerseRange)(passageId).testament)
+        return true;
+    else
+        return false;
+}
+/** Returns a deduplicated list of all bible IDs referenced by a language. */
+function getAllBibleIds(language) {
+    const ids = new Set();
+    if (typeof language.bible === 'object')
+        ids.add(language.bible.bibleTextId);
+    else if (language.bible)
+        ids.add(language.bible);
+    for (const fallback of language.bibleFallbacks ?? []) {
+        if (typeof fallback === 'object')
+            ids.add(fallback.bibleTextId);
+        else
+            ids.add(fallback);
+    }
+    for (const modifier of language.bibleModifiers ?? []) {
+        ids.add(modifier.bibleId);
+    }
+    return [...ids];
+}
+/**
+ * Chapters that can be missing without affecting book/testament completeness.
+ * MAL.4 is optional because the Hebrew Bible includes its content within
+ * MAL.3.
+ */
+exports.OPTIONAL_CHAPTERS = new Set(['MAL.4']);
+var bibleBooks_2 = require("./bibleBooks");
+Object.defineProperty(exports, "NEW_TESTAMENT_BOOKS", { enumerable: true, get: function () { return bibleBooks_2.NEW_TESTAMENT_BOOKS; } });
+Object.defineProperty(exports, "OLD_TESTAMENT_BOOKS", { enumerable: true, get: function () { return bibleBooks_2.OLD_TESTAMENT_BOOKS; } });
+const bookLengths = new Map([
+    ['GEN', 50],
+    ['EXO', 40],
+    ['LEV', 27],
+    ['NUM', 36],
+    ['DEU', 34],
+    ['JOS', 24],
+    ['JDG', 21],
+    ['RUT', 4],
+    ['1SA', 31],
+    ['2SA', 24],
+    ['1KI', 22],
+    ['2KI', 25],
+    ['1CH', 29],
+    ['2CH', 36],
+    ['EZR', 10],
+    ['NEH', 13],
+    ['EST', 10],
+    ['JOB', 42],
+    ['PSA', 150],
+    ['PRO', 31],
+    ['ECC', 12],
+    ['SNG', 8],
+    ['ISA', 66],
+    ['JER', 52],
+    ['LAM', 5],
+    ['EZK', 48],
+    ['DAN', 12],
+    ['HOS', 14],
+    ['JOL', 3],
+    ['AMO', 9],
+    ['OBA', 1],
+    ['JON', 4],
+    ['MIC', 7],
+    ['NAM', 3],
+    ['HAB', 3],
+    ['ZEP', 3],
+    ['HAG', 2],
+    ['ZEC', 14],
+    ['MAL', 3],
+    ['MAT', 28],
+    ['MRK', 16],
+    ['LUK', 24],
+    ['JHN', 21],
+    ['ACT', 28],
+    ['ROM', 16],
+    ['1CO', 16],
+    ['2CO', 13],
+    ['GAL', 6],
+    ['EPH', 6],
+    ['PHP', 4],
+    ['COL', 4],
+    ['1TH', 5],
+    ['2TH', 3],
+    ['1TI', 6],
+    ['2TI', 4],
+    ['TIT', 3],
+    ['PHM', 1],
+    ['HEB', 13],
+    ['JAS', 5],
+    ['1PE', 5],
+    ['2PE', 3],
+    ['1JN', 5],
+    ['2JN', 1],
+    ['3JN', 1],
+    ['JUD', 1],
+    ['REV', 22],
+]);
+/**
+ * Expands an optimized chapter list back to individual chapters for a single
+ * type. Converts book names (e.g., "GEN") back to all chapters (e.g., ["GEN.1",
+ * "GEN.2", ..."]). Converts testament names ("OT", "NT") back to all chapters
+ * in that testament. Leaves individual chapters unchanged.
+ *
+ * @param optimizedChapters - Array that may contain testament IDs, book IDs, or
+ *   chapter IDs
+ * @returns Array of individual chapter IDs in canonical order
+ */
+function expandOptimizedChapters(optimizedChapters) {
+    if (optimizedChapters.length === 0)
+        return [];
+    // Build a Set of included items for O(1) lookup
+    const includedSet = new Set(optimizedChapters);
+    // Check if we need OT/NT expansion
+    const hasOT = includedSet.has('OT');
+    const hasNT = includedSet.has('NT');
+    // If we have both OT and NT, return all chapters but exclude optional
+    // chapters unless they are explicitly listed in the optimized list
+    if (hasOT && hasNT) {
+        return bibleChaptersList_1.bibleChaptersList.filter((c) => !exports.OPTIONAL_CHAPTERS.has(c) || includedSet.has(c));
+    }
+    // Pre-calculate which books to include
+    const includedBooks = new Set();
+    if (hasOT) {
+        bibleBooks_1.OLD_TESTAMENT_BOOKS.forEach((book) => includedBooks.add(book));
+    }
+    if (hasNT) {
+        bibleBooks_1.NEW_TESTAMENT_BOOKS.forEach((book) => includedBooks.add(book));
+    }
+    // Add individual books from the optimized list
+    for (const entry of optimizedChapters) {
+        if (entry !== 'OT' && entry !== 'NT' && !entry.includes('.')) {
+            includedBooks.add(entry);
+        }
+    }
+    // Filter bibleChaptersList to only include relevant chapters
+    // This maintains canonical order without needing to sort
+    const result = [];
+    for (const chapter of bibleChaptersList_1.bibleChaptersList) {
+        // Check if this specific chapter is included
+        if (includedSet.has(chapter)) {
+            result.push(chapter);
+            continue;
+        }
+        // Skip optional chapters unless explicitly listed
+        if (exports.OPTIONAL_CHAPTERS.has(chapter))
+            continue;
+        // Check if this chapter's book is included
+        const bookId = chapter.split('.')[0];
+        if (includedBooks.has(bookId)) {
+            result.push(chapter);
+        }
+    }
+    return result;
+}
+/**
+ * Returns available chapters for all types (text, audio, timings) plus a
+ * combined `all` array.
+ *
+ * @param bibleId - The bible translation ID to look up
+ * @returns Object with expanded chapter arrays for each type and a combined
+ *   `all` array
+ */
+function getAvailableChapters(bibleId) {
+    const emptyReturn = { text: [], audio: [], timings: [], all: [] };
+    if (!bibleId)
+        return emptyReturn;
+    const status = bibleStatuses_1.bibleStatuses[bibleId];
+    if (!status)
+        return emptyReturn;
+    const text = expandOptimizedChapters(status.text ?? []);
+    const audio = expandOptimizedChapters(status.audio ?? []);
+    const timings = expandOptimizedChapters(status.timings ?? []);
+    const allSet = new Set([...text, ...audio, ...timings]);
+    const all = bibleChaptersList_1.bibleChaptersList.filter((c) => allSet.has(c));
+    return { text, audio, timings, all };
+}
+function getPercentage(bibleId, type) {
+    const optimizedChapters = bibleStatuses_1.bibleStatuses[bibleId]?.[type] || [];
+    let total = 0;
+    optimizedChapters.forEach((entry) => {
+        if (entry === 'OT') {
+            // All Old Testament books (excluding optional chapters like MAL.4)
+            total += 928;
+        }
+        else if (entry === 'NT') {
+            // All New Testament books
+            total += 260;
+        }
+        else if (entry.includes('.')) {
+            // It's already a chapter ID, count as 1
+            total += 1;
+        }
+        else {
+            // It's a book ID, add its chapter count
+            total += bookLengths.get(entry) || 0;
+        }
+    });
+    return (total / 1188) * 100;
+}
+/**
+ * Determines the appropriate bible for a given passage based on the language's
+ * bible, bible modifiers, and fallback bible.
+ */
+function getBibleForPassage({ languageInfo, lessonCategory, passageId, }) {
+    let bibleId = replaceBibleWith({
+        modifiers: languageInfo.bibleModifiers ?? [],
+        lessonCategory,
+        passageId,
+    }) ?? languageInfo.bible.bibleTextId;
+    const passageInfo = (0, bibleBooks_1.parseVerseRange)(passageId);
+    const bibleInfo = getBibleInfo(bibleId);
+    /**
+     * A bible can provide a passage either via full chapter audio (we'll extract
+     * the verse range using timings) or via a custom recording keyed by the exact
+     * passageId. The latter is essential for bibles like WAHA_QAK that have no
+     * chapter audio at all and only ship hand-recorded passages.
+     */
+    const hasPassage = (id, info) => info.availableAudioChapters.includes(passageInfo.chapterId) ||
+        bibleStatuses_1.bibleStatuses[id]?.customPassages?.[passageId] !== undefined;
+    if (bibleInfo && !hasPassage(bibleId, bibleInfo)) {
+        for (const fallback of languageInfo.bibleFallbacks) {
+            if (hasPassage(fallback.bibleTextId, fallback)) {
+                bibleId = fallback.bibleTextId;
+                break;
+            }
+        }
+    }
+    return bibleId;
+}

package/dist/functions/languages.d.ts

@@ -1,16 +1,15 @@
-import type { Languages } from '../data/languages/languages.zod';
+import type { Language } from '../data/languages/languages.zod';
 import type { TranslationsApp } from '../data/translationsApp/translationsApp.zod';
-import type { BibleInfo, LanguageInfo, MeetTranslations } from '../types/languages';
-export declare function getBibleInfo(bibleId: string | undefined): BibleInfo | undefined;
+import type { LanguageInfo, MeetTranslations } from '../types/languages';
 export declare function getLanguageInfo(languageId: string, options?: {
     includeInProgressDmcSets?: boolean;
 }): LanguageInfo;
-export declare function getInitialAppInterfaceLanguage(userPhoneLanguages: Array<string | null>): Languages[number]['languageId'];
-export declare function isLanguageAvailable(status: Languages[number]['status'], isDev?: boolean): boolean;
-export declare function numerals(text: string, script: string): string;
+export declare function getInitialAppInterfaceLanguage(userPhoneLanguages: Array<string | null>): Language['languageId'];
+export declare function isLanguageAvailable(status: Language['status'], isDev?: boolean): boolean;
+export declare function numerals(text: string, scriptName: string): string;
 /**
  * These values are not the name of the font necessarily, but the identifier of
  * the font which can be found by inspecting the font in an app like Font Book.
  */
-export declare function getAppTranslations(appLanguageId?: string): TranslationsApp[string];
+export declare function getAppTranslations(appLanguageId: string): TranslationsApp[string];
 export declare function getMeetTranslations(meetLanguageInfo: LanguageInfo): MeetTranslations;

package/dist/functions/languages.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getBibleInfo = getBibleInfo;
 exports.getLanguageInfo = getLanguageInfo;
 exports.getInitialAppInterfaceLanguage = getInitialAppInterfaceLanguage;
 exports.isLanguageAvailable = isLanguageAvailable;
@@ -8,12 +7,13 @@ exports.numerals = numerals;
 exports.getAppTranslations = getAppTranslations;
 exports.getMeetTranslations = getMeetTranslations;
 const bibleAudios_1 = require("../data/bibleAudios");
-const bibleStatuses_1 = require("../data/bibleStatuses");
 const bibleTexts_1 = require("../data/bibleTexts");
 const curriculumFoundations_1 = require("../data/curriculumFoundations");
+const curriculumOnboarding_1 = require("../data/curriculumOnboarding");
 const curriculumQuestions_1 = require("../data/curriculumQuestions");
 const curriculumTopics_1 = require("../data/curriculumTopics");
 const languages_1 = require("../data/languages");
+const lessonPauses_1 = require("../data/lessonPauses");
 const numeralMaps_1 = require("../data/numeralMaps");
 const phoneLanguages_1 = require("../data/phoneLanguages");
 const scripts_1 = require("../data/scripts");
@@ -24,27 +24,7 @@ const translationsIntroduction_1 = require("../data/translationsIntroduction");
 const translationsQuestion_1 = require("../data/translationsQuestion");
 const translationsSet_1 = require("../data/translationsSet");
 const translationsSpokenQuestion_1 = require("../data/translationsSpokenQuestion");
-const bibleChapterUtils_1 = require("./bibleChapterUtils");
-function getBibleInfo(bibleId) {
-    const bibleText = bibleTexts_1.bibleTexts.find((t) => t.bibleTextId === bibleId);
-    const bibleAudio = bibleAudios_1.bibleAudios.find((t) => t.bibleAudioId === bibleText?.audioId ||
-        t.bibleAudioId === bibleText?.bibleTextId);
-    const language = languages_1.languages.find((l) => l.languageId === bibleText?.languageId) ??
-        languages_1.languages[0];
-    const script = scripts_1.scripts.find((s) => s.name === language?.script) ?? scripts_1.scripts[0];
-    return bibleText && bibleAudio
-        ? {
-            ...bibleText,
-            ...bibleAudio,
-            language,
-            script,
-            availableTextChapters: (0, bibleChapterUtils_1.getAvailableChapters)(bibleText.bibleTextId, 'text'),
-            availableAudioChapters: (0, bibleChapterUtils_1.getAvailableChapters)(bibleAudio.bibleAudioId, 'audio'),
-            bookNames: bibleStatuses_1.bibleStatuses[bibleText.bibleTextId]?.bookNames || {},
-            fullCopyright: (bibleText.copyright ?? '') + '\n\n' + (bibleAudio.copyright ?? ''),
-        }
-        : undefined;
-}
+const bibles_1 = require("./bibles");
 function getLanguageInfo(languageId, options) {
     const defaultReturn = {
         ...languages_1.languages[0],
@@ -55,14 +35,27 @@ function getLanguageInfo(languageId, options) {
             ...bibleAudios_1.bibleAudios[0],
             availableTextChapters: [],
             availableAudioChapters: [],
+            availableTimingsChapters: [],
+            availableChapters: [],
             language: languages_1.languages[0],
             fullCopyright: '',
             bookNames: {},
             script: scripts_1.scripts[0],
         },
-        bibleFallback: undefined,
-        trainingVideoLanguage: '',
+        bibleFallbacks: [],
+        contentLanguages: {
+            ftbs: 'eng',
+            intros: 'eng',
+            titles: 'eng',
+            trainingVideos: 'eng',
+            questionAudio: 'eng',
+            questionText: 'eng',
+            onboardingPassages: 'eng',
+        },
         script: scripts_1.scripts[0],
+        lessonPauses: lessonPauses_1.lessonPauses,
+        allBibleIds: [],
+        onboardingPassageIds: curriculumOnboarding_1.curriculumOnboarding[0].passages,
     };
     const language = languages_1.languages.find((language) => language.languageId === languageId);
     if (!language) {
@@ -77,34 +70,48 @@ function getLanguageInfo(languageId, options) {
     const questionsCurriculum = curriculumQuestions_1.curriculumQuestions.find((questionCurriculum) => questionCurriculum.curriculumId === language.curriculum.questions);
     const foundationsCurriculum = curriculumFoundations_1.curriculumFoundations.find((foundationsCurriculum) => foundationsCurriculum.curriculumId === language.curriculum.foundations);
     const topicsCurriculum = curriculumTopics_1.curriculumTopics.find((topicsCurriculum) => topicsCurriculum.curriculumId === language?.curriculum.topics);
-    let setIds = [];
+    const onboardingCurriculum = curriculumOnboarding_1.curriculumOnboarding.find((onboardingCurriculum) => onboardingCurriculum.curriculumId === language.curriculum.onboarding);
+    const setIds = [];
     if (foundationsCurriculum)
         setIds.push(...foundationsCurriculum.sets);
     if (topicsCurriculum)
         setIds.push(...topicsCurriculum.sets);
-    if (language.dmCourseStatus === 'launched' ||
-        language.dmCourseStatus === 'testing' ||
-        language.videoBridgeLanguage ||
-        (language.dmCourseStatus === 'inProgress' &&
+    if (language.status.trainingVideos === 'launched' ||
+        language.status.trainingVideos === 'testing' ||
+        language.bridgeLanguages?.trainingVideos ||
+        (language.status.trainingVideos === 'inProgress' &&
             options?.includeInProgressDmcSets))
         setIds.push(specialIds_1.specialIds.dmCourseSetId);
-    if (language.gdmcStatus === 'launched' ||
-        language.gdmcStatus === 'testing' ||
-        (language.gdmcStatus === 'inProgress' && options?.includeInProgressDmcSets)) {
+    if (language.status.gdmc === 'launched' ||
+        language.status.gdmc === 'testing' ||
+        (language.status.gdmc === 'inProgress' && options?.includeInProgressDmcSets)) {
         for (const gdmcSetId of specialIds_1.specialIds.growingAsDmcSetIds) {
             setIds.push(gdmcSetId);
         }
     }
-    if (language.unsupportedDbsSets)
-        setIds = setIds.filter((set) => !language.unsupportedDbsSets?.includes(set));
     const toReturn = {
         ...language,
         setIds: setIds,
         questionSets: questionsCurriculum?.questionSets ?? defaultReturn.questionSets,
-        bible: getBibleInfo(language.bible) || defaultReturn.bible,
-        bibleFallback: getBibleInfo(language.bibleFallback),
-        trainingVideoLanguage: language.videoBridgeLanguage ?? language.languageId,
+        bible: language.bible
+            ? (0, bibles_1.getBibleInfo)(language.bible) || defaultReturn.bible
+            : defaultReturn.bible,
+        bibleFallbacks: (language.bibleFallbacks ?? [])
+            .map(bibles_1.getBibleInfo)
+            .filter((b) => b != null),
+        contentLanguages: {
+            trainingVideos: language.bridgeLanguages?.trainingVideos ?? language.languageId,
+            ftbs: language.bridgeLanguages?.ftbs ?? language.languageId,
+            intros: language.bridgeLanguages?.intros ?? language.languageId,
+            titles: language.bridgeLanguages?.titles ?? language.languageId,
+            questionAudio: language.bridgeLanguages?.questionAudio ?? language.languageId,
+            questionText: language.bridgeLanguages?.questionText ?? language.languageId,
+            onboardingPassages: language.bridgeLanguages?.onboardingPassages ?? language.languageId,
+        },
         script,
+        lessonPauses: lessonPauses_1.lessonPauses,
+        allBibleIds: (0, bibles_1.getAllBibleIds)(language),
+        onboardingPassageIds: onboardingCurriculum?.passages ?? defaultReturn.onboardingPassageIds,
     };
     return toReturn;
 }
@@ -130,8 +137,8 @@ function getInitialAppInterfaceLanguage(userPhoneLanguages) {
 }
 function isLanguageAvailable(status, isDev) {
     return process.env.EXPO_PUBLIC_APP_ENV === 'language-testing' || isDev
-        ? status === 'launched' || status === 'testing'
-        : status === 'launched';
+        ? status.dbs === 'launched' || status.dbs === 'testing'
+        : status.dbs === 'launched';
 }
 const superscriptToRegular = {
     '⁰': '0',
@@ -145,9 +152,9 @@ const superscriptToRegular = {
     '⁸': '8',
     '⁹': '9',
 };
-function numerals(text, script) {
-    if (script in numeralMaps_1.numeralMaps) {
-        const map = numeralMaps_1.numeralMaps[script];
+function numerals(text, scriptName) {
+    if (scriptName in numeralMaps_1.numeralMaps) {
+        const map = numeralMaps_1.numeralMaps[scriptName];
         if (!map)
             return text;
         return text
@@ -167,20 +174,18 @@ function numerals(text, script) {
  * the font which can be found by inspecting the font in an app like Font Book.
  */
 function getAppTranslations(appLanguageId) {
-    return (translationsApp_1.translationsApp[appLanguageId ?? 'eng'] ??
-        translationsApp_1.translationsApp.eng);
+    return translationsApp_1.translationsApp[appLanguageId] ?? translationsApp_1.translationsApp.eng;
 }
 function getMeetTranslations(meetLanguageInfo) {
     return {
-        sets: translationsSet_1.translationsSet[meetLanguageInfo.titles ?? meetLanguageInfo.languageId] ??
+        sets: translationsSet_1.translationsSet[meetLanguageInfo.contentLanguages.titles] ??
             translationsSet_1.translationsSet.eng,
-        questions: translationsQuestion_1.translationsQuestion[meetLanguageInfo.languageId] ??
+        ftbs: translationsFtb_1.translationsFtb[meetLanguageInfo.contentLanguages.ftbs] ??
+            translationsFtb_1.translationsFtb.eng,
+        introductions: translationsIntroduction_1.translationsIntroduction[meetLanguageInfo.contentLanguages.intros] ??
+            translationsIntroduction_1.translationsIntroduction.eng,
+        questions: translationsQuestion_1.translationsQuestion[meetLanguageInfo.contentLanguages.questionText] ??
             translationsQuestion_1.translationsQuestion.eng,
-        questionsSpoken: translationsSpokenQuestion_1.translationsSpokenQuestion[meetLanguageInfo.languageId] ??
-            translationsSpokenQuestion_1.translationsSpokenQuestion.eng,
-        ftbs: translationsFtb_1.translationsFtb[meetLanguageInfo.languageId] ?? translationsFtb_1.translationsFtb.eng,
-        introductions: translationsIntroduction_1.translationsIntroduction[meetLanguageInfo.introBridge ??
-            meetLanguageInfo.titles ??
-            meetLanguageInfo.languageId] ?? translationsIntroduction_1.translationsIntroduction.eng,
+        questionsSpoken: translationsSpokenQuestion_1.translationsSpokenQuestion[meetLanguageInfo.contentLanguages.questionText] ?? translationsSpokenQuestion_1.translationsSpokenQuestion.eng,
     };
 }

package/dist/functions/scripturePassages.d.ts

@@ -1,29 +1,14 @@
-import { LessonPauses } from '../data/lessonPauses/lessonPauses.zod';
-import { BibleChapter, BibleChapters } from '../types/bibleChapters';
-import type { LanguageInfo } from '../types/languages';
+import { BibleChapter } from '../types/bibleChapters';
 import { ScripturePassage } from '../types/scripturePassages';
-import { DbsInfo, VideoInfo } from '../types/sets';
-export interface VerseRangeInfo {
-    startBook: string;
-    startChapter: string;
-    startVerse: string;
-    endBook: string;
-    endChapter: string;
-    endVerse: string;
-    startChapterId: string;
-    endChapterId: string;
-}
-/**
- * Parses a verse range string like "GEN.1.1-GEN.1.25" or "JHN.3.16" or "REV.22"
- * Returns the start and end verse IDs
- */
-export declare function parseVerseRange(passageId: string): VerseRangeInfo;
+import { DbsInfo, EnrichedSection, LessonInfo, Section, VideoInfo } from '../types/sets';
+export { parseVerseRange } from './bibleBooks';
+export type { VerseRangeInfo } from './bibleBooks';
 type GetChapterUrlParams = {
     bibleAudioId: string;
     passageId: string;
 } | {
-    startBook: string;
-    startChapter: string;
+    book: string;
+    chapter: string;
     bibleAudioId: string;
 };
 export declare function getChapterUrl(params: GetChapterUrlParams): string;
@@ -36,34 +21,50 @@ export declare function getChapterUrl(params: GetChapterUrlParams): string;
  *   ["GEN.1.1-GEN.1.25", "GEN.2.4-GEN.2.7", "EXO.3.3-EXO.3.25"] -> "Genesis 1: 1-25, 2: 4-7, Exodus 3: 3-25"
  *   ["JHN.1.1"] -> "John 1: 1"
  */
-export declare function getPassagesString(passageIds: string[] | undefined, language: LanguageInfo): string;
+export declare function getPassagesString(passages: Array<{
+    passageId: string;
+    bibleId: string;
+}>): string;
 export interface GetChapterParams {
     chapterId: string;
     bibleId: string;
+    noTextAvailableString: string;
 }
 export type GetChapter = (params: GetChapterParams) => Promise<BibleChapter | undefined>;
+/**
+ * Raw chapter fetcher — returns whatever the backing store has, with no
+ * placeholder synthesis or post-processing.
+ */
+export type RawChapterFetcher = (params: {
+    bibleId: string;
+    chapterId: string;
+}) => Promise<BibleChapter | undefined>;
+/**
+ * Wraps a raw chapter fetcher with placeholder logic shared across all
+ * backends:
+ *
+ * - If the chapter is not in `availableTextChapters` nor
+ *   `availableTimingsChapters`, synthesize a one-verse placeholder without
+ *   calling the underlying fetcher.
+ * - If a fetched chapter is timings-only (verses exist but none have text), patch
+ *   verse 1's text with `noTextAvailableString` so downstream consumers can
+ *   render something.
+ */
+export declare function withChapterPlaceholders(fetchRaw: RawChapterFetcher): GetChapter;
 interface GetScripturePassageParams {
     bibleId: string;
-    bibleFallbackId: string | undefined;
     passageId: string;
     getChapter: GetChapter;
-    languageInfo: LanguageInfo;
+    noTextAvailableString: string;
 }
 /** Gets a scripture passage by extracting verses from chapters documents. */
-export declare function getScripturePassage({ bibleId, bibleFallbackId, passageId, getChapter, languageInfo, }: GetScripturePassageParams): Promise<ScripturePassage | undefined>;
-interface GetLessonScriptureParams {
-    bibleId: string;
-    bibleFallbackId: string | undefined;
-    passageIds: string[];
+export declare function getScripturePassage({ bibleId, passageId, getChapter, noTextAvailableString, }: GetScripturePassageParams): Promise<ScripturePassage | undefined>;
+/** Gets all scripture passages for a lesson. */
+export declare function getLessonScripture({ getChapter, lessonInfo, noTextAvailableString, }: {
+    lessonInfo: LessonInfo;
     getChapter: (params: GetChapterParams) => Promise<BibleChapter | undefined>;
-    languageInfo: LanguageInfo;
-}
-/**
- * Gets multiple scripture passages efficiently (Future optimization: could
- * batch the chapter fetches)
- */
-export declare function getLessonScripture(params: GetLessonScriptureParams): Promise<Array<ScripturePassage | undefined>>;
-export declare function parseBibleSnapshot(snapshot: any, bible: string): BibleChapters;
+    noTextAvailableString: string;
+}): Promise<Array<ScripturePassage | undefined>>;
 /**
  * Converts a verse number to a superscript string. This is useful for
  * displaying verse numbers in a more visually appealing way. For example, "1"
@@ -73,18 +74,23 @@ export declare function parseBibleSnapshot(snapshot: any, bible: string): BibleC
  * @returns The superscript string representation of the verse number.
  */
 export declare function verseToSuperscript(num: string | undefined): string;
-/** Returns the correct lesson pauses for a given language. */
-export declare function getLessonPauses(languageId: string): LessonPauses;
 /**
- * Converts verse timings within each scripture passage from chapter-relative to
- * full-lesson relative. This includes accounting for question durations,
- * pauses, and from-the-book durations.
- *
- * Multi-chapter passages are split into per-chapter chunks internally, since
- * the audio is clipped from individual chapter files.
+ * Returns the FTB audio duration + afterFtb pause for a section, or 0 if the
+ * section has no FTB.
+ */
+export declare function getFtbDuration(section: Section, lessonInfo: DbsInfo | VideoInfo): number;
+/**
+ * Fills in `length` (for verse-timed story sections) and `startTime` (for all
+ * sections) by accumulating forward through the lesson. After this, every
+ * section has both fields set.
+ */
+export declare function enrichSections(lessonInfo: DbsInfo | VideoInfo, scripture: Array<ScripturePassage | undefined>): EnrichedSection[];
+/**
+ * Converts verse timings from chapter-relative to lesson-relative using each
+ * section's `startTime` (set by {@link enrichSections}).
  */
-export declare function normalizeVerseTimings({ lessonInfo, scripture, }: {
+export declare function normalizeVerseTimings({ enrichedSections, scripture, lessonInfo, }: {
+    enrichedSections: EnrichedSection[];
     scripture: Array<ScripturePassage | undefined>;
     lessonInfo: DbsInfo | VideoInfo;
 }): Array<ScripturePassage | undefined>;
-export {};