@churchapps/content-providers 0.4.0 → 0.5.0

package/dist/index.d.cts

@@ -19,7 +19,8 @@ interface ContentProviderConfig {
     scopes: string[];
     supportsDeviceFlow?: boolean;
     deviceAuthEndpoint?: string;
-    endpoints: EndpointsConfig;
+    /** @deprecated URL templates now live in each provider; kept optional for type compatibility. */
+    endpoints?: EndpointsConfig;
 }
 interface DeviceAuthorizationResponse {
     device_code: string;
@@ -240,12 +241,54 @@ interface IProvider {
  */
 declare function navigateToPath(instructions: Instructions, path: string): InstructionItem | null;
 
+declare class OAuthHelper {
+    generateCodeVerifier(): string;
+    generateCodeChallenge(verifier: string): Promise<string>;
+    buildAuthUrl(config: ContentProviderConfig, codeVerifier: string, redirectUri: string, state?: string): Promise<{
+        url: string;
+        challengeMethod: string;
+    }>;
+    exchangeCodeForTokens(config: ContentProviderConfig, _providerId: string, code: string, codeVerifier: string, redirectUri: string): Promise<ContentProviderAuthData | null>;
+}
+
+/** Map a raw OAuth token response to ContentProviderAuthData, stamping created_at. */
+declare function toAuthData(data: Record<string, unknown>, fallbacks?: {
+    refreshToken?: string;
+    scope?: string;
+}): ContentProviderAuthData;
 declare class TokenHelper {
     isAuthValid(auth: ContentProviderAuthData | null | undefined): boolean;
     isTokenExpired(auth: ContentProviderAuthData): boolean;
     refreshToken(config: ContentProviderConfig, auth: ContentProviderAuthData): Promise<ContentProviderAuthData | null>;
 }
 
+declare class DeviceFlowHelper {
+    supportsDeviceFlow(config: ContentProviderConfig): boolean;
+    initiateDeviceFlow(config: ContentProviderConfig): Promise<DeviceAuthorizationResponse | null>;
+    pollDeviceFlowToken(config: ContentProviderConfig, deviceCode: string): Promise<DeviceFlowPollResult>;
+    calculatePollDelay(baseInterval?: number, slowDownCount?: number): number;
+}
+
+/**
+ * Shared base for providers: identity metadata, an authenticated fetch wrapper, and a
+ * config-driven supportsDeviceFlow. Auth-flow methods (initiateDeviceFlow, buildAuthUrl, ...)
+ * deliberately do NOT live here: consumers feature-detect them with `"method" in provider`,
+ * so they must exist only on the providers that actually support each flow.
+ */
+declare abstract class BaseProvider implements IProvider {
+    abstract readonly id: string;
+    abstract readonly name: string;
+    abstract readonly logos: ProviderLogos;
+    abstract readonly config: ContentProviderConfig;
+    abstract readonly requiresAuth: boolean;
+    abstract readonly authTypes: AuthType[];
+    abstract readonly capabilities: ProviderCapabilities;
+    private readonly apiHelper;
+    protected apiRequest<T>(path: string, auth?: ContentProviderAuthData | null, method?: "GET" | "POST", body?: unknown): Promise<T | null>;
+    abstract browse(path?: string | null, auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
+    supportsDeviceFlow(): boolean;
+}
+
 /**
  * APlay Provider
  *
@@ -256,9 +299,7 @@ declare class TokenHelper {
  *   /modules/{moduleId}/products/{productId}/{libraryId}  -> media files
  *   /modules/{moduleId}/libraries/{libraryId}             -> media files (if module has 0-1 products)
  */
-declare class APlayProvider implements IProvider {
-    private readonly apiHelper;
-    private apiRequest;
+declare class APlayProvider extends BaseProvider {
     readonly id = "aplay";
     readonly name = "APlay";
     readonly logos: ProviderLogos;
@@ -274,7 +315,6 @@ declare class APlayProvider implements IProvider {
     getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     checkMediaLicense(mediaId: string, auth?: ContentProviderAuthData | null): Promise<MediaLicenseResult | null>;
-    supportsDeviceFlow(): boolean;
 }
 
 /**
@@ -284,11 +324,9 @@ declare class APlayProvider implements IProvider {
  *   /playlists                    -> list playlists
  *   /playlists/{playlistId}       -> list messages (files)
  */
-declare class SignPresenterProvider implements IProvider {
-    private readonly apiHelper;
+declare class SignPresenterProvider extends BaseProvider {
     private readonly oauthHelper;
     private readonly deviceFlowHelper;
-    private apiRequest;
     readonly id = "signpresenter";
     readonly name = "SignPresenter";
     readonly logos: ProviderLogos;
@@ -297,11 +335,11 @@ declare class SignPresenterProvider implements IProvider {
     readonly authTypes: AuthType[];
     readonly capabilities: ProviderCapabilities;
     browse(path?: string | null, auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
+    private extractList;
     private getPlaylists;
     private getMessages;
     getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    supportsDeviceFlow(): boolean;
     generateCodeVerifier(): string;
     buildAuthUrl(codeVerifier: string, redirectUri: string, state?: string): Promise<{
         url: string;
@@ -326,7 +364,7 @@ declare class SignPresenterProvider implements IProvider {
  *   /addons/{category}                                  -> individual add-ons
  *   /addons/{category}/{addOnId}                        -> single add-on file
  */
-declare class LessonsChurchProvider implements IProvider {
+declare class LessonsChurchProvider extends BaseProvider {
     readonly id = "lessonschurch";
     readonly name = "Lessons.church";
     readonly logos: ProviderLogos;
@@ -347,14 +385,11 @@ declare class LessonsChurchProvider implements IProvider {
     private getAddOnCategories;
     private getAddOnsByCategory;
     getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    supportsDeviceFlow(): boolean;
 }
 
-declare class B1ChurchProvider implements IProvider {
-    private readonly apiHelper;
+declare class B1ChurchProvider extends BaseProvider {
     private readonly deviceFlowHelper;
     private readonly externalContentCache;
-    private apiRequest;
     readonly id = "b1church";
     readonly name = "B1.Church";
     readonly logos: ProviderLogos;
@@ -382,12 +417,10 @@ declare class B1ChurchProvider implements IProvider {
     private findItemByPath;
     private findPresentationByPath;
     getPlaylist(path: string, authData?: ContentProviderAuthData | null, resolution?: number): Promise<ContentFile[] | null>;
-    supportsDeviceFlow(): boolean;
 }
 
-declare class DropboxProvider implements IProvider {
+declare class DropboxProvider extends BaseProvider {
     private readonly oauthHelper;
-    private readonly apiHelper;
     readonly id = "dropbox";
     readonly name = "Dropbox";
     readonly logos: ProviderLogos;
@@ -403,9 +436,10 @@ declare class DropboxProvider implements IProvider {
     private resolveFileLinks;
     private checkIsLeaf;
     browse(path?: string | null, auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
+    /** Resolve a folder path to playable files (list + media filter + link resolution). */
+    private resolveMediaFiles;
     getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    supportsDeviceFlow(): boolean;
     generateCodeVerifier(): string;
     buildAuthUrl(codeVerifier: string, redirectUri: string, state?: string): Promise<{
         url: string;
@@ -424,14 +458,11 @@ declare class DropboxProvider implements IProvider {
  *   /serviceTypes/{serviceTypeId}            -> list plans
  *   /serviceTypes/{serviceTypeId}/{planId}   -> plan items (leaf)
  */
-declare class PlanningCenterProvider implements IProvider {
-    private readonly apiHelper;
-    private apiRequest;
+declare class PlanningCenterProvider extends BaseProvider {
     readonly id = "planningcenter";
     readonly name = "Planning Center";
     readonly logos: ProviderLogos;
     readonly config: ContentProviderConfig;
-    private readonly ONE_WEEK_MS;
     readonly requiresAuth = true;
     readonly authTypes: AuthType[];
     readonly capabilities: ProviderCapabilities;
@@ -439,7 +470,6 @@ declare class PlanningCenterProvider implements IProvider {
     private getServiceTypes;
     private getPlans;
     private getPlanItems;
-    supportsDeviceFlow(): boolean;
 }
 
 /**
@@ -450,23 +480,22 @@ declare class PlanningCenterProvider implements IProvider {
  *   /{collectionSlug}              -> list videos in collection
  *   /{collectionSlug}/{videoId}    -> single video
  */
-declare class BibleProjectProvider implements IProvider {
+declare class BibleProjectProvider extends BaseProvider {
     readonly id = "bibleproject";
     readonly name = "The Bible Project";
     readonly logos: ProviderLogos;
     readonly config: ContentProviderConfig;
-    private data;
-    private getMuxThumbnail;
     readonly requiresAuth = false;
     readonly authTypes: AuthType[];
     readonly capabilities: ProviderCapabilities;
+    private data;
+    private getMuxThumbnail;
+    private videoToFile;
+    /** Resolve a path to its collection and files: all videos at depth 1, a single video at depth 2. */
+    private resolve;
     browse(path?: string | null, _auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
-    private getCollections;
-    private getLessonFolders;
-    private getVideoFile;
     getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    supportsDeviceFlow(): boolean;
 }
 
 /**
@@ -478,7 +507,7 @@ declare class BibleProjectProvider implements IProvider {
  *   /{collectionSlug}/{studyId}                -> list lessons
  *   /{collectionSlug}/{studyId}/{lessonId}     -> lesson files (leaf)
  */
-declare class HighVoltageKidsProvider implements IProvider {
+declare class HighVoltageKidsProvider extends BaseProvider {
     readonly id = "highvoltagekids";
     readonly name = "High Voltage Kids";
     readonly logos: ProviderLogos;
@@ -490,7 +519,6 @@ declare class HighVoltageKidsProvider implements IProvider {
     browse(path?: string | null, _auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
     getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    supportsDeviceFlow(): boolean;
 }
 
 /**
@@ -504,7 +532,7 @@ declare class HighVoltageKidsProvider implements IProvider {
  *   /{category}/{id}                     -> single video (feature film) or container children (series/collection)
  *   /{category}/{...containerIds}/{id}   -> nested containers or single video (supports arbitrary depth)
  */
-declare class JesusFilmProvider implements IProvider {
+declare class JesusFilmProvider extends BaseProvider {
     readonly id = "jesusfilm";
     readonly name = "Jesus Film Project";
     readonly logos: ProviderLogos;
@@ -513,19 +541,19 @@ declare class JesusFilmProvider implements IProvider {
     readonly authTypes: AuthType[];
     readonly capabilities: ProviderCapabilities;
     private fetchApi;
+    private fetchCategoryComponents;
     browse(path?: string | null, _auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
     private getCategories;
     private getItemsInCategory;
     private getVideoFile;
     private getContainerChildren;
     private extractMuxPlaybackId;
-    getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     private fetchVideoFiles;
     private fetchContainerVideoFiles;
+    getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     private buildVideoInstructions;
     private buildContainerInstructions;
     getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    supportsDeviceFlow(): boolean;
 }
 
 /**
@@ -539,10 +567,8 @@ declare class JesusFilmProvider implements IProvider {
  *   /catalog/{courseId}            -> lesson folders (GET /catalog/{courseId})
  *   /catalog/{courseId}/{lessonId} -> video files   (GET /lesson-playlist/{lessonId})
  */
-declare class CbnProvider implements IProvider {
-    private readonly apiHelper;
+declare class CbnProvider extends BaseProvider {
     private readonly deviceFlowHelper;
-    private apiRequest;
     readonly id = "cbn";
     readonly name = "CBN";
     readonly logos: ProviderLogos;
@@ -551,13 +577,10 @@ declare class CbnProvider implements IProvider {
     readonly authTypes: AuthType[];
     readonly capabilities: ProviderCapabilities;
     browse(path?: string | null, auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
-    private getCourses;
-    private getLessons;
-    private getVideos;
-    private fetchPlaylist;
+    /** Resolve a leaf path (/catalog/{courseId}/{lessonId}) to its playlist files. */
+    private resolveFiles;
     getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    supportsDeviceFlow(): boolean;
     initiateDeviceFlow(): Promise<DeviceAuthorizationResponse | null>;
     pollDeviceFlowToken(deviceCode: string): Promise<DeviceFlowPollResult>;
 }
@@ -582,7 +605,7 @@ declare class CbnProvider implements IProvider {
  * range requests — plays in any standard mp4 player including
  * react-native-video.
  */
-declare class LifeChurchProvider implements IProvider {
+declare class LifeChurchProvider extends BaseProvider {
     readonly id = "lifechurch";
     readonly name = "Life.Church";
     readonly logos: ProviderLogos;
@@ -592,12 +615,12 @@ declare class LifeChurchProvider implements IProvider {
     readonly capabilities: ProviderCapabilities;
     private data;
     private findSeries;
-    private findUnit;
-    private findLesson;
     private findScheduled;
     /** Resolve a scheduled-lesson reference to the underlying lesson + unit + series. */
     private resolveScheduled;
     private lessonToFile;
+    /** Resolve a leaf-or-unit path to its files plus the name/section used for instructions. */
+    private resolve;
     browse(path?: string | null, _auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
     getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
@@ -605,7 +628,6 @@ declare class LifeChurchProvider implements IProvider {
      * Returns the most recent scheduled lesson from data.scheduledLessons.
      */
     getCurrentPlan(_auth?: ContentProviderAuthData | null): Promise<CurrentPlan | null>;
-    supportsDeviceFlow(): boolean;
 }
 
 declare function getProvider(providerId: string): IProvider | null;
@@ -629,4 +651,4 @@ declare function getAvailableProviders(ids?: string[]): ProviderInfo[];
  */
 declare const VERSION: string;
 
-export { APlayProvider, type AuthType, B1ChurchProvider, BibleProjectProvider, CbnProvider, type ContentFile, type ContentFolder, type ContentItem, type ContentProviderAuthData, type ContentProviderConfig, type CurrentPlan, type DeviceAuthorizationResponse, type DeviceFlowPollResult, type DeviceFlowState, DropboxProvider, type EndpointValue, type EndpointsConfig, type FeedActionInterface, type FeedFileInterface, type FeedSectionInterface, type FeedVenueInterface, HighVoltageKidsProvider, type IProvider, type InstructionItem, type Instructions, JesusFilmProvider, LessonsChurchProvider, LifeChurchProvider, type MediaLicenseResult, type MediaLicenseStatus, type MessageFileInterface, type Plan, type PlanPresentation, type PlanSection, type PlanTimelineItem, PlanningCenterProvider, type ProviderCapabilities, type ProviderInfo, type ProviderLogos, SignPresenterProvider, TokenHelper, VERSION, type VenueActionInterface, type VenueActionsResponseInterface, type VenueSectionActionsInterface, getAllProviders, getAvailableProviders, getProvider, getProviderConfig, isContentFile, isContentFolder, navigateToPath, registerProvider };
+export { APlayProvider, type AuthType, B1ChurchProvider, BaseProvider, BibleProjectProvider, CbnProvider, type ContentFile, type ContentFolder, type ContentItem, type ContentProviderAuthData, type ContentProviderConfig, type CurrentPlan, type DeviceAuthorizationResponse, DeviceFlowHelper, type DeviceFlowPollResult, type DeviceFlowState, DropboxProvider, type EndpointValue, type EndpointsConfig, type FeedActionInterface, type FeedFileInterface, type FeedSectionInterface, type FeedVenueInterface, HighVoltageKidsProvider, type IProvider, type InstructionItem, type Instructions, JesusFilmProvider, LessonsChurchProvider, LifeChurchProvider, type MediaLicenseResult, type MediaLicenseStatus, type MessageFileInterface, OAuthHelper, type Plan, type PlanPresentation, type PlanSection, type PlanTimelineItem, PlanningCenterProvider, type ProviderCapabilities, type ProviderInfo, type ProviderLogos, SignPresenterProvider, TokenHelper, VERSION, type VenueActionInterface, type VenueActionsResponseInterface, type VenueSectionActionsInterface, getAllProviders, getAvailableProviders, getProvider, getProviderConfig, isContentFile, isContentFolder, navigateToPath, registerProvider, toAuthData };

package/dist/index.d.ts

@@ -19,7 +19,8 @@ interface ContentProviderConfig {
     scopes: string[];
     supportsDeviceFlow?: boolean;
     deviceAuthEndpoint?: string;
-    endpoints: EndpointsConfig;
+    /** @deprecated URL templates now live in each provider; kept optional for type compatibility. */
+    endpoints?: EndpointsConfig;
 }
 interface DeviceAuthorizationResponse {
     device_code: string;
@@ -240,12 +241,54 @@ interface IProvider {
  */
 declare function navigateToPath(instructions: Instructions, path: string): InstructionItem | null;
 
+declare class OAuthHelper {
+    generateCodeVerifier(): string;
+    generateCodeChallenge(verifier: string): Promise<string>;
+    buildAuthUrl(config: ContentProviderConfig, codeVerifier: string, redirectUri: string, state?: string): Promise<{
+        url: string;
+        challengeMethod: string;
+    }>;
+    exchangeCodeForTokens(config: ContentProviderConfig, _providerId: string, code: string, codeVerifier: string, redirectUri: string): Promise<ContentProviderAuthData | null>;
+}
+
+/** Map a raw OAuth token response to ContentProviderAuthData, stamping created_at. */
+declare function toAuthData(data: Record<string, unknown>, fallbacks?: {
+    refreshToken?: string;
+    scope?: string;
+}): ContentProviderAuthData;
 declare class TokenHelper {
     isAuthValid(auth: ContentProviderAuthData | null | undefined): boolean;
     isTokenExpired(auth: ContentProviderAuthData): boolean;
     refreshToken(config: ContentProviderConfig, auth: ContentProviderAuthData): Promise<ContentProviderAuthData | null>;
 }
 
+declare class DeviceFlowHelper {
+    supportsDeviceFlow(config: ContentProviderConfig): boolean;
+    initiateDeviceFlow(config: ContentProviderConfig): Promise<DeviceAuthorizationResponse | null>;
+    pollDeviceFlowToken(config: ContentProviderConfig, deviceCode: string): Promise<DeviceFlowPollResult>;
+    calculatePollDelay(baseInterval?: number, slowDownCount?: number): number;
+}
+
+/**
+ * Shared base for providers: identity metadata, an authenticated fetch wrapper, and a
+ * config-driven supportsDeviceFlow. Auth-flow methods (initiateDeviceFlow, buildAuthUrl, ...)
+ * deliberately do NOT live here: consumers feature-detect them with `"method" in provider`,
+ * so they must exist only on the providers that actually support each flow.
+ */
+declare abstract class BaseProvider implements IProvider {
+    abstract readonly id: string;
+    abstract readonly name: string;
+    abstract readonly logos: ProviderLogos;
+    abstract readonly config: ContentProviderConfig;
+    abstract readonly requiresAuth: boolean;
+    abstract readonly authTypes: AuthType[];
+    abstract readonly capabilities: ProviderCapabilities;
+    private readonly apiHelper;
+    protected apiRequest<T>(path: string, auth?: ContentProviderAuthData | null, method?: "GET" | "POST", body?: unknown): Promise<T | null>;
+    abstract browse(path?: string | null, auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
+    supportsDeviceFlow(): boolean;
+}
+
 /**
  * APlay Provider
  *
@@ -256,9 +299,7 @@ declare class TokenHelper {
  *   /modules/{moduleId}/products/{productId}/{libraryId}  -> media files
  *   /modules/{moduleId}/libraries/{libraryId}             -> media files (if module has 0-1 products)
  */
-declare class APlayProvider implements IProvider {
-    private readonly apiHelper;
-    private apiRequest;
+declare class APlayProvider extends BaseProvider {
     readonly id = "aplay";
     readonly name = "APlay";
     readonly logos: ProviderLogos;
@@ -274,7 +315,6 @@ declare class APlayProvider implements IProvider {
     getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
     checkMediaLicense(mediaId: string, auth?: ContentProviderAuthData | null): Promise<MediaLicenseResult | null>;
-    supportsDeviceFlow(): boolean;
 }
 
 /**
@@ -284,11 +324,9 @@ declare class APlayProvider implements IProvider {
  *   /playlists                    -> list playlists
  *   /playlists/{playlistId}       -> list messages (files)
  */
-declare class SignPresenterProvider implements IProvider {
-    private readonly apiHelper;
+declare class SignPresenterProvider extends BaseProvider {
     private readonly oauthHelper;
     private readonly deviceFlowHelper;
-    private apiRequest;
     readonly id = "signpresenter";
     readonly name = "SignPresenter";
     readonly logos: ProviderLogos;
@@ -297,11 +335,11 @@ declare class SignPresenterProvider implements IProvider {
     readonly authTypes: AuthType[];
     readonly capabilities: ProviderCapabilities;
     browse(path?: string | null, auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
+    private extractList;
     private getPlaylists;
     private getMessages;
     getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    supportsDeviceFlow(): boolean;
     generateCodeVerifier(): string;
     buildAuthUrl(codeVerifier: string, redirectUri: string, state?: string): Promise<{
         url: string;
@@ -326,7 +364,7 @@ declare class SignPresenterProvider implements IProvider {
  *   /addons/{category}                                  -> individual add-ons
  *   /addons/{category}/{addOnId}                        -> single add-on file
  */
-declare class LessonsChurchProvider implements IProvider {
+declare class LessonsChurchProvider extends BaseProvider {
     readonly id = "lessonschurch";
     readonly name = "Lessons.church";
     readonly logos: ProviderLogos;
@@ -347,14 +385,11 @@ declare class LessonsChurchProvider implements IProvider {
     private getAddOnCategories;
     private getAddOnsByCategory;
     getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    supportsDeviceFlow(): boolean;
 }
 
-declare class B1ChurchProvider implements IProvider {
-    private readonly apiHelper;
+declare class B1ChurchProvider extends BaseProvider {
     private readonly deviceFlowHelper;
     private readonly externalContentCache;
-    private apiRequest;
     readonly id = "b1church";
     readonly name = "B1.Church";
     readonly logos: ProviderLogos;
@@ -382,12 +417,10 @@ declare class B1ChurchProvider implements IProvider {
     private findItemByPath;
     private findPresentationByPath;
     getPlaylist(path: string, authData?: ContentProviderAuthData | null, resolution?: number): Promise<ContentFile[] | null>;
-    supportsDeviceFlow(): boolean;
 }
 
-declare class DropboxProvider implements IProvider {
+declare class DropboxProvider extends BaseProvider {
     private readonly oauthHelper;
-    private readonly apiHelper;
     readonly id = "dropbox";
     readonly name = "Dropbox";
     readonly logos: ProviderLogos;
@@ -403,9 +436,10 @@ declare class DropboxProvider implements IProvider {
     private resolveFileLinks;
     private checkIsLeaf;
     browse(path?: string | null, auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
+    /** Resolve a folder path to playable files (list + media filter + link resolution). */
+    private resolveMediaFiles;
     getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    supportsDeviceFlow(): boolean;
     generateCodeVerifier(): string;
     buildAuthUrl(codeVerifier: string, redirectUri: string, state?: string): Promise<{
         url: string;
@@ -424,14 +458,11 @@ declare class DropboxProvider implements IProvider {
  *   /serviceTypes/{serviceTypeId}            -> list plans
  *   /serviceTypes/{serviceTypeId}/{planId}   -> plan items (leaf)
  */
-declare class PlanningCenterProvider implements IProvider {
-    private readonly apiHelper;
-    private apiRequest;
+declare class PlanningCenterProvider extends BaseProvider {
     readonly id = "planningcenter";
     readonly name = "Planning Center";
     readonly logos: ProviderLogos;
     readonly config: ContentProviderConfig;
-    private readonly ONE_WEEK_MS;
     readonly requiresAuth = true;
     readonly authTypes: AuthType[];
     readonly capabilities: ProviderCapabilities;
@@ -439,7 +470,6 @@ declare class PlanningCenterProvider implements IProvider {
     private getServiceTypes;
     private getPlans;
     private getPlanItems;
-    supportsDeviceFlow(): boolean;
 }
 
 /**
@@ -450,23 +480,22 @@ declare class PlanningCenterProvider implements IProvider {
  *   /{collectionSlug}              -> list videos in collection
  *   /{collectionSlug}/{videoId}    -> single video
  */
-declare class BibleProjectProvider implements IProvider {
+declare class BibleProjectProvider extends BaseProvider {
     readonly id = "bibleproject";
     readonly name = "The Bible Project";
     readonly logos: ProviderLogos;
     readonly config: ContentProviderConfig;
-    private data;
-    private getMuxThumbnail;
     readonly requiresAuth = false;
     readonly authTypes: AuthType[];
     readonly capabilities: ProviderCapabilities;
+    private data;
+    private getMuxThumbnail;
+    private videoToFile;
+    /** Resolve a path to its collection and files: all videos at depth 1, a single video at depth 2. */
+    private resolve;
     browse(path?: string | null, _auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
-    private getCollections;
-    private getLessonFolders;
-    private getVideoFile;
     getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    supportsDeviceFlow(): boolean;
 }
 
 /**
@@ -478,7 +507,7 @@ declare class BibleProjectProvider implements IProvider {
  *   /{collectionSlug}/{studyId}                -> list lessons
  *   /{collectionSlug}/{studyId}/{lessonId}     -> lesson files (leaf)
  */
-declare class HighVoltageKidsProvider implements IProvider {
+declare class HighVoltageKidsProvider extends BaseProvider {
     readonly id = "highvoltagekids";
     readonly name = "High Voltage Kids";
     readonly logos: ProviderLogos;
@@ -490,7 +519,6 @@ declare class HighVoltageKidsProvider implements IProvider {
     browse(path?: string | null, _auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
     getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    supportsDeviceFlow(): boolean;
 }
 
 /**
@@ -504,7 +532,7 @@ declare class HighVoltageKidsProvider implements IProvider {
  *   /{category}/{id}                     -> single video (feature film) or container children (series/collection)
  *   /{category}/{...containerIds}/{id}   -> nested containers or single video (supports arbitrary depth)
  */
-declare class JesusFilmProvider implements IProvider {
+declare class JesusFilmProvider extends BaseProvider {
     readonly id = "jesusfilm";
     readonly name = "Jesus Film Project";
     readonly logos: ProviderLogos;
@@ -513,19 +541,19 @@ declare class JesusFilmProvider implements IProvider {
     readonly authTypes: AuthType[];
     readonly capabilities: ProviderCapabilities;
     private fetchApi;
+    private fetchCategoryComponents;
     browse(path?: string | null, _auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
     private getCategories;
     private getItemsInCategory;
     private getVideoFile;
     private getContainerChildren;
     private extractMuxPlaybackId;
-    getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     private fetchVideoFiles;
     private fetchContainerVideoFiles;
+    getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     private buildVideoInstructions;
     private buildContainerInstructions;
     getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    supportsDeviceFlow(): boolean;
 }
 
 /**
@@ -539,10 +567,8 @@ declare class JesusFilmProvider implements IProvider {
  *   /catalog/{courseId}            -> lesson folders (GET /catalog/{courseId})
  *   /catalog/{courseId}/{lessonId} -> video files   (GET /lesson-playlist/{lessonId})
  */
-declare class CbnProvider implements IProvider {
-    private readonly apiHelper;
+declare class CbnProvider extends BaseProvider {
     private readonly deviceFlowHelper;
-    private apiRequest;
     readonly id = "cbn";
     readonly name = "CBN";
     readonly logos: ProviderLogos;
@@ -551,13 +577,10 @@ declare class CbnProvider implements IProvider {
     readonly authTypes: AuthType[];
     readonly capabilities: ProviderCapabilities;
     browse(path?: string | null, auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
-    private getCourses;
-    private getLessons;
-    private getVideos;
-    private fetchPlaylist;
+    /** Resolve a leaf path (/catalog/{courseId}/{lessonId}) to its playlist files. */
+    private resolveFiles;
     getPlaylist(path: string, auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
-    supportsDeviceFlow(): boolean;
     initiateDeviceFlow(): Promise<DeviceAuthorizationResponse | null>;
     pollDeviceFlowToken(deviceCode: string): Promise<DeviceFlowPollResult>;
 }
@@ -582,7 +605,7 @@ declare class CbnProvider implements IProvider {
  * range requests — plays in any standard mp4 player including
  * react-native-video.
  */
-declare class LifeChurchProvider implements IProvider {
+declare class LifeChurchProvider extends BaseProvider {
     readonly id = "lifechurch";
     readonly name = "Life.Church";
     readonly logos: ProviderLogos;
@@ -592,12 +615,12 @@ declare class LifeChurchProvider implements IProvider {
     readonly capabilities: ProviderCapabilities;
     private data;
     private findSeries;
-    private findUnit;
-    private findLesson;
     private findScheduled;
     /** Resolve a scheduled-lesson reference to the underlying lesson + unit + series. */
     private resolveScheduled;
     private lessonToFile;
+    /** Resolve a leaf-or-unit path to its files plus the name/section used for instructions. */
+    private resolve;
     browse(path?: string | null, _auth?: ContentProviderAuthData | null): Promise<ContentItem[]>;
     getPlaylist(path: string, _auth?: ContentProviderAuthData | null, _resolution?: number): Promise<ContentFile[] | null>;
     getInstructions(path: string, _auth?: ContentProviderAuthData | null): Promise<Instructions | null>;
@@ -605,7 +628,6 @@ declare class LifeChurchProvider implements IProvider {
      * Returns the most recent scheduled lesson from data.scheduledLessons.
      */
     getCurrentPlan(_auth?: ContentProviderAuthData | null): Promise<CurrentPlan | null>;
-    supportsDeviceFlow(): boolean;
 }
 
 declare function getProvider(providerId: string): IProvider | null;
@@ -629,4 +651,4 @@ declare function getAvailableProviders(ids?: string[]): ProviderInfo[];
  */
 declare const VERSION: string;
 
-export { APlayProvider, type AuthType, B1ChurchProvider, BibleProjectProvider, CbnProvider, type ContentFile, type ContentFolder, type ContentItem, type ContentProviderAuthData, type ContentProviderConfig, type CurrentPlan, type DeviceAuthorizationResponse, type DeviceFlowPollResult, type DeviceFlowState, DropboxProvider, type EndpointValue, type EndpointsConfig, type FeedActionInterface, type FeedFileInterface, type FeedSectionInterface, type FeedVenueInterface, HighVoltageKidsProvider, type IProvider, type InstructionItem, type Instructions, JesusFilmProvider, LessonsChurchProvider, LifeChurchProvider, type MediaLicenseResult, type MediaLicenseStatus, type MessageFileInterface, type Plan, type PlanPresentation, type PlanSection, type PlanTimelineItem, PlanningCenterProvider, type ProviderCapabilities, type ProviderInfo, type ProviderLogos, SignPresenterProvider, TokenHelper, VERSION, type VenueActionInterface, type VenueActionsResponseInterface, type VenueSectionActionsInterface, getAllProviders, getAvailableProviders, getProvider, getProviderConfig, isContentFile, isContentFolder, navigateToPath, registerProvider };
+export { APlayProvider, type AuthType, B1ChurchProvider, BaseProvider, BibleProjectProvider, CbnProvider, type ContentFile, type ContentFolder, type ContentItem, type ContentProviderAuthData, type ContentProviderConfig, type CurrentPlan, type DeviceAuthorizationResponse, DeviceFlowHelper, type DeviceFlowPollResult, type DeviceFlowState, DropboxProvider, type EndpointValue, type EndpointsConfig, type FeedActionInterface, type FeedFileInterface, type FeedSectionInterface, type FeedVenueInterface, HighVoltageKidsProvider, type IProvider, type InstructionItem, type Instructions, JesusFilmProvider, LessonsChurchProvider, LifeChurchProvider, type MediaLicenseResult, type MediaLicenseStatus, type MessageFileInterface, OAuthHelper, type Plan, type PlanPresentation, type PlanSection, type PlanTimelineItem, PlanningCenterProvider, type ProviderCapabilities, type ProviderInfo, type ProviderLogos, SignPresenterProvider, TokenHelper, VERSION, type VenueActionInterface, type VenueActionsResponseInterface, type VenueSectionActionsInterface, getAllProviders, getAvailableProviders, getProvider, getProviderConfig, isContentFile, isContentFolder, navigateToPath, registerProvider, toAuthData };